restore_process_file_aliases_queue Class Reference

Try to restore aliases and references to external files. More...

Inheritance diagram for restore_process_file_aliases_queue:

Public Member Functions
	apply_date_offset ($value)
	Apply course startdate offset based in original course startdate and course_offset_startdate setting Note we are using one static cache here, but by restoreid, so it's ok for concurrence/multiple executions in the same request.
	decrypt ($value)
	Returns symmetric-key AES-256 decryption of base64 encoded contents.
	destroy ()
	Destroy all circular references.
	execute ()
	This function will perform all the actions necessary to achieve the execution of the plan/part/task.
	get_name ()
	log ($message, $level, $a=null, $depth=null, $display=false)
	This function will be responsible for handling the params, and to call to the corresponding logger->process() once all modifications in params have been performed.
	set_task ($task)

Protected Member Functions
	define_execution ()
	What to do when this step is executed.
	get_basepath ()
	get_courseid ()
	get_logger ()
	get_restoreid ()
	get_setting ($name)
	get_setting_value ($name)
	get_settings ()
	Protected API starts here.
	setting_exists ($name)

Protected Attributes
string	$name
	One simple name for identification purposes.
base_task null	$task
	Task this is part of.

Detailed Description

Try to restore aliases and references to external files.

The queue of these files was prepared for us in restore_dbops::send_files_to_pool(). We expect that all regular (non-alias) files have already been restored. Make sure there is no restore step executed after this one that would call send_files_to_pool() again.

You may notice we have hardcoded support for Server files, Legacy course files and user Private files here at the moment. This could be eventually replaced with a set of callbacks in the future if needed.

Copyright

2012 David Mudrak david.nosp@m.@moo.nosp@m.dle.c.nosp@m.om

License

http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Member Function Documentation

apply_date_offset()

restore_step::apply_date_offset ( $value )

inherited

Apply course startdate offset based in original course startdate and course_offset_startdate setting Note we are using one static cache here, but by restoreid, so it's ok for concurrence/multiple executions in the same request.

Note: The policy is to roll date only for configurations and not for user data. see MDL-9367.

Parameters

int

$value

Time value (seconds since epoch), or empty for nothing

Return values

int	Time value after applying the date offset, or empty for nothing

decrypt()

restore_step::decrypt ( $value )

inherited

Returns symmetric-key AES-256 decryption of base64 encoded contents.

This method is used in restore operations to decrypt contents encrypted with encrypted_final_element automatically decoding (base64) and decrypting contents using the key stored in backup_encryptkey config.

Requires openssl, cipher availability, and key existence (backup automatically sets it if missing). Integrity is provided via HMAC.

Parameters

string

$value

encrypted_final_element value to decode and decrypt.

Return values

string|null

decoded and decrypted value or null if the operation can not be performed.

define_execution()

restore_process_file_aliases_queue::define_execution ( )

protected

What to do when this step is executed.

Reimplemented from restore_execution_step.

destroy()

base_step::destroy ( )

inherited

Destroy all circular references.

It helps PHP 5.2 a lot!

execute()

restore_execution_step::execute ( )

inherited

This function will perform all the actions necessary to achieve the execution of the plan/part/task.

Implements executable.

log()

base_step::log ( $message, $level, $a = null, $depth = null, $display = false )

inherited

This function will be responsible for handling the params, and to call to the corresponding logger->process() once all modifications in params have been performed.

Implements loggable.

---

The documentation for this class was generated from the following file:

• backup/moodle2/restore_stepslib.php