You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
264 lines
11 KiB
264 lines
11 KiB
<?php
|
|
|
|
// This file is part of Moodle - http://moodle.org/
|
|
//
|
|
// Moodle is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU General Public License as published by
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
// (at your option) any later version.
|
|
//
|
|
// Moodle is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU General Public License
|
|
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
/**
|
|
* @package moodlecore
|
|
* @subpackage backup-plan
|
|
* @copyright 2010 onwards Eloy Lafuente (stronk7) {@link http://stronk7.com}
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
|
|
/**
|
|
* Abstract class defining the needed stuff to backup one @backup_structure
|
|
*
|
|
* TODO: Finish phpdocs
|
|
*/
|
|
abstract class backup_structure_step extends backup_step {
|
|
|
|
protected $filename; // Name of the file to be generated
|
|
protected $contenttransformer; // xml content transformer being used
|
|
// (need it here, apart from xml_writer,
|
|
// thanks to serialized data to process -
|
|
// say thanks to blocks!)
|
|
|
|
/**
|
|
* Constructor - instantiates one object of this class
|
|
*/
|
|
public function __construct($name, $filename, $task = null) {
|
|
if (!is_null($task) && !($task instanceof backup_task)) {
|
|
throw new backup_step_exception('wrong_backup_task_specified');
|
|
}
|
|
$this->filename = $filename;
|
|
$this->contenttransformer = null;
|
|
parent::__construct($name, $task);
|
|
}
|
|
|
|
public function execute() {
|
|
|
|
if (!$this->execute_condition()) { // Check any condition to execute this
|
|
return;
|
|
}
|
|
|
|
$fullpath = $this->task->get_taskbasepath();
|
|
|
|
// We MUST have one fullpath here, else, error
|
|
if (empty($fullpath)) {
|
|
throw new backup_step_exception('backup_structure_step_undefined_fullpath');
|
|
}
|
|
|
|
// Append the filename to the fullpath
|
|
$fullpath = rtrim($fullpath, '/') . '/' . $this->filename;
|
|
|
|
// Create output, transformer, writer, processor
|
|
$xo = new file_xml_output($fullpath);
|
|
$xt = null;
|
|
if (class_exists('backup_xml_transformer')) {
|
|
$xt = new backup_xml_transformer($this->get_courseid());
|
|
$this->contenttransformer = $xt; // Save the reference to the transformer
|
|
// as far as we are going to need it out
|
|
// from xml_writer (blame serialized data!)
|
|
}
|
|
$xw = new xml_writer($xo, $xt);
|
|
$progress = $this->task->get_progress();
|
|
$progress->start_progress($this->get_name());
|
|
$pr = new backup_structure_processor($xw, $progress);
|
|
|
|
// Set processor variables from settings
|
|
foreach ($this->get_settings() as $setting) {
|
|
$pr->set_var($setting->get_name(), $setting->get_value());
|
|
}
|
|
// Add backupid as one more var for processor
|
|
$pr->set_var(backup::VAR_BACKUPID, $this->get_backupid());
|
|
|
|
// Get structure definition
|
|
$structure = $this->define_structure();
|
|
if (! $structure instanceof backup_nested_element) {
|
|
throw new backup_step_exception('backup_structure_step_wrong_structure');
|
|
}
|
|
|
|
// Start writer
|
|
$xw->start();
|
|
|
|
// Process structure definition
|
|
$structure->process($pr);
|
|
|
|
// Get the results from the nested elements
|
|
$results = $structure->get_results();
|
|
|
|
// Get the log messages to append to the log
|
|
$logs = $structure->get_logs();
|
|
foreach ($logs as $log) {
|
|
$this->log($log->message, $log->level, $log->a, $log->depth, $log->display);
|
|
}
|
|
|
|
// Close everything
|
|
$xw->stop();
|
|
$progress->end_progress();
|
|
|
|
// Destroy the structure. It helps PHP 5.2 memory a lot!
|
|
$structure->destroy();
|
|
|
|
return $results;
|
|
}
|
|
|
|
/**
|
|
* As far as backup structure steps are implementing backup_plugin stuff, they need to
|
|
* have the parent task available for wrapping purposes (get course/context....)
|
|
*/
|
|
public function get_task() {
|
|
return $this->task;
|
|
}
|
|
|
|
// Protected API starts here
|
|
|
|
/**
|
|
* Add plugin structure to any element in the structure backup tree
|
|
*
|
|
* @param string $plugintype type of plugin as defined by core_component::get_plugin_types()
|
|
* @param backup_nested_element $element element in the structure backup tree that
|
|
* we are going to add plugin information to
|
|
* @param bool $multiple to define if multiple plugins can produce information
|
|
* for each instance of $element (true) or no (false)
|
|
*/
|
|
protected function add_plugin_structure($plugintype, $element, $multiple) {
|
|
|
|
global $CFG;
|
|
|
|
// Check the requested plugintype is a valid one
|
|
if (!array_key_exists($plugintype, core_component::get_plugin_types($plugintype))) {
|
|
throw new backup_step_exception('incorrect_plugin_type', $plugintype);
|
|
}
|
|
|
|
// Arrived here, plugin is correct, let's create the optigroup
|
|
$optigroupname = $plugintype . '_' . $element->get_name() . '_plugin';
|
|
$optigroup = new backup_optigroup($optigroupname, null, $multiple);
|
|
$element->add_child($optigroup); // Add optigroup to stay connected since beginning
|
|
|
|
// Get all the optigroup_elements, looking across all the plugin dirs
|
|
$pluginsdirs = core_component::get_plugin_list($plugintype);
|
|
foreach ($pluginsdirs as $name => $plugindir) {
|
|
$classname = 'backup_' . $plugintype . '_' . $name . '_plugin';
|
|
$backupfile = $plugindir . '/backup/moodle2/' . $classname . '.class.php';
|
|
if (file_exists($backupfile)) {
|
|
require_once($backupfile);
|
|
$backupplugin = new $classname($plugintype, $name, $optigroup, $this);
|
|
// Add plugin returned structure to optigroup
|
|
$backupplugin->define_plugin_structure($element->get_name());
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Add subplugin structure for a given plugin to any element in the structure backup tree.
|
|
*
|
|
* This method allows the injection of subplugins (of a specified plugin) data to any
|
|
* element in any backup structure.
|
|
*
|
|
* NOTE: Initially subplugins were only available for activities (mod), so only the
|
|
* {@link backup_activity_structure_step} class had support for them, always
|
|
* looking for /mod/modulenanme subplugins. This new method is a generalization of the
|
|
* existing one for activities, supporting all subplugins injecting information everywhere.
|
|
*
|
|
* @param string $subplugintype type of subplugin as defined in plugin's db/subplugins.php.
|
|
* @param backup_nested_element $element element in the backup tree (anywhere) that
|
|
* we are going to add subplugin information to.
|
|
* @param bool $multiple to define if multiple subplugins can produce information
|
|
* for each instance of $element (true) or no (false).
|
|
* @param string $plugintype type of the plugin.
|
|
* @param string $pluginname name of the plugin.
|
|
* @return void
|
|
*/
|
|
protected function add_subplugin_structure($subplugintype, $element, $multiple, $plugintype = null, $pluginname = null) {
|
|
global $CFG;
|
|
// This global declaration is required, because where we do require_once($backupfile);
|
|
// That file may in turn try to do require_once($CFG->dirroot ...).
|
|
// That worked in the past, we should keep it working.
|
|
|
|
// Verify if this is a BC call for an activity backup. See NOTE above for this special case.
|
|
if ($plugintype === null and $pluginname === null) {
|
|
$plugintype = 'mod';
|
|
$pluginname = $this->task->get_modulename();
|
|
// TODO: Once all the calls have been changed to add both not null plugintype and pluginname, add a debugging here.
|
|
}
|
|
|
|
// Check the requested plugintype is a valid one.
|
|
if (!array_key_exists($plugintype, core_component::get_plugin_types())) {
|
|
throw new backup_step_exception('incorrect_plugin_type', $plugintype);
|
|
}
|
|
|
|
// Check the requested pluginname, for the specified plugintype, is a valid one.
|
|
if (!array_key_exists($pluginname, core_component::get_plugin_list($plugintype))) {
|
|
throw new backup_step_exception('incorrect_plugin_name', array($plugintype, $pluginname));
|
|
}
|
|
|
|
// Check the requested subplugintype is a valid one.
|
|
$subpluginsfile = core_component::get_component_directory($plugintype . '_' . $pluginname) . '/db/subplugins.php';
|
|
if (!file_exists($subpluginsfile)) {
|
|
throw new backup_step_exception('plugin_missing_subplugins_php_file', array($plugintype, $pluginname));
|
|
}
|
|
include($subpluginsfile);
|
|
if (!array_key_exists($subplugintype, $subplugins)) {
|
|
throw new backup_step_exception('incorrect_subplugin_type', $subplugintype);
|
|
}
|
|
|
|
// Arrived here, subplugin is correct, let's create the optigroup.
|
|
$optigroupname = $subplugintype . '_' . $element->get_name() . '_subplugin';
|
|
$optigroup = new backup_optigroup($optigroupname, null, $multiple);
|
|
$element->add_child($optigroup); // Add optigroup to stay connected since beginning.
|
|
|
|
// Every subplugin optionally can have a common/parent subplugin
|
|
// class for shared stuff.
|
|
$parentclass = 'backup_' . $plugintype . '_' . $pluginname . '_' . $subplugintype . '_subplugin';
|
|
$parentfile = core_component::get_component_directory($plugintype . '_' . $pluginname) .
|
|
'/backup/moodle2/' . $parentclass . '.class.php';
|
|
if (file_exists($parentfile)) {
|
|
require_once($parentfile);
|
|
}
|
|
|
|
// Get all the optigroup_elements, looking over all the subplugin dirs.
|
|
$subpluginsdirs = core_component::get_plugin_list($subplugintype);
|
|
foreach ($subpluginsdirs as $name => $subpluginsdir) {
|
|
$classname = 'backup_' . $subplugintype . '_' . $name . '_subplugin';
|
|
$backupfile = $subpluginsdir . '/backup/moodle2/' . $classname . '.class.php';
|
|
if (file_exists($backupfile)) {
|
|
require_once($backupfile);
|
|
$backupsubplugin = new $classname($subplugintype, $name, $optigroup, $this);
|
|
// Add subplugin returned structure to optigroup.
|
|
$backupsubplugin->define_subplugin_structure($element->get_name());
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* To conditionally decide if one step will be executed or no
|
|
*
|
|
* For steps needing to be executed conditionally, based in dynamic
|
|
* conditions (at execution time vs at declaration time) you must
|
|
* override this function. It will return true if the step must be
|
|
* executed and false if not
|
|
*/
|
|
protected function execute_condition() {
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Define the structure to be processed by this backup step.
|
|
*
|
|
* @return backup_nested_element
|
|
*/
|
|
abstract protected function define_structure();
|
|
}
|
|
|