/** this function will restore an entire backup.zip into the specified course
* using standard moodle backup/restore functions, but silently.
* @param string $pathtofile the absolute path to the backup file.
* @param int $destinationcourse the course id to restore to.
* @param boolean $emptyfirst whether to delete all coursedata first.
* @param boolean $userdata whether to include any userdata that may be in the backup file.
* @param array $preferences optional, 0 will be used. Can contain:
* metacourse
* logs
* course_files
* messages
*/
function import_backup_file_silently($pathtofile, $destinationcourse, $emptyfirst = false, $userdata = false, $preferences = array())
{
global $CFG, $SESSION, $USER, $DB;
// is there such a thing on cron? I guess so..
global $restore;
// ick
if (!defined('RESTORE_SILENTLY')) {
define('RESTORE_SILENTLY', true);
// don't output all the stuff to us.
}
$debuginfo = 'import_backup_file_silently: ';
$cleanupafter = false;
$errorstr = '';
// passed by reference to restore_precheck to get errors from.
if (!($course = $DB->get_record('course', array('id' => $destinationcourse)))) {
mtrace($debuginfo . 'Course with id $destinationcourse was not a valid course!');
return false;
}
// first check we have a valid file.
if (!file_exists($pathtofile) || !is_readable($pathtofile)) {
mtrace($debuginfo . 'File ' . $pathtofile . ' either didn\'t exist or wasn\'t readable');
return false;
}
// now make sure it's a zip file
require_once $CFG->dirroot . '/lib/filelib.php';
$filename = substr($pathtofile, strrpos($pathtofile, '/') + 1);
$mimetype = mimeinfo("type", $filename);
if ($mimetype != 'application/zip') {
mtrace($debuginfo . 'File ' . $pathtofile . ' was of wrong mimetype (' . $mimetype . ')');
return false;
}
// restore_precheck wants this within dataroot, so lets put it there if it's not already..
if (strstr($pathtofile, $CFG->dataroot) === false) {
// first try and actually move it..
if (!check_dir_exists($CFG->dataroot . '/temp/backup/', true)) {
mtrace($debuginfo . 'File ' . $pathtofile . ' outside of dataroot and couldn\'t move it! ');
return false;
}
if (!copy($pathtofile, $CFG->dataroot . '/temp/backup/' . $filename)) {
mtrace($debuginfo . 'File ' . $pathtofile . ' outside of dataroot and couldn\'t move it! ');
return false;
} else {
$pathtofile = 'temp/backup/' . $filename;
$cleanupafter = true;
}
} else {
// it is within dataroot, so take it off the path for restore_precheck.
$pathtofile = substr($pathtofile, strlen($CFG->dataroot . '/'));
}
if (!backup_required_functions()) {
mtrace($debuginfo . 'Required function check failed (see backup_required_functions)');
return false;
}
@ini_set("max_execution_time", "3000");
if (empty($CFG->extramemorylimit)) {
raise_memory_limit('128M');
} else {
raise_memory_limit($CFG->extramemorylimit);
}
if (!($backup_unique_code = restore_precheck($destinationcourse, $pathtofile, $errorstr, true))) {
mtrace($debuginfo . 'Failed restore_precheck (error was ' . $errorstr . ')');
return false;
}
$SESSION->restore = new StdClass();
// add on some extra stuff we need...
$SESSION->restore->metacourse = $restore->metacourse = isset($preferences['restore_metacourse']) ? $preferences['restore_metacourse'] : 0;
$SESSION->restore->restoreto = $restore->restoreto = 1;
$SESSION->restore->users = $restore->users = $userdata;
$SESSION->restore->groups = $restore->groups = isset($preferences['restore_groups']) ? $preferences['restore_groups'] : RESTORE_GROUPS_NONE;
$SESSION->restore->logs = $restore->logs = isset($preferences['restore_logs']) ? $preferences['restore_logs'] : 0;
$SESSION->restore->user_files = $restore->user_files = $userdata;
$SESSION->restore->messages = $restore->messages = isset($preferences['restore_messages']) ? $preferences['restore_messages'] : 0;
$SESSION->restore->blogs = $restore->blogs = isset($preferences['restore_blogs']) ? $preferences['restore_blogs'] : 0;
$SESSION->restore->course_id = $restore->course_id = $destinationcourse;
$SESSION->restore->restoreto = 1;
$SESSION->restore->course_id = $destinationcourse;
$SESSION->restore->deleting = $emptyfirst;
$SESSION->restore->restore_course_files = $restore->course_files = isset($preferences['restore_course_files']) ? $preferences['restore_course_files'] : 0;
$SESSION->restore->restore_site_files = $restore->site_files = isset($preferences['restore_site_files']) ? $preferences['restore_site_files'] : 0;
$SESSION->restore->backup_version = $SESSION->info->backup_backup_version;
$SESSION->restore->course_startdateoffset = $course->startdate - $SESSION->course_header->course_startdate;
restore_setup_for_check($SESSION->restore, $backup_unique_code);
// maybe we need users (defaults to 2 in restore_setup_for_check)
if (!empty($userdata)) {
$SESSION->restore->users = 1;
}
// we also need modules...
if ($allmods = $DB->get_records("modules")) {
foreach ($allmods as $mod) {
$modname = $mod->name;
//Now check that we have that module info in the backup file
if (isset($SESSION->info->mods[$modname]) && $SESSION->info->mods[$modname]->backup == "true") {
$SESSION->restore->mods[$modname]->restore = true;
$SESSION->restore->mods[$modname]->userinfo = $userdata;
} else {
// avoid warnings
$SESSION->restore->mods[$modname]->restore = false;
$SESSION->restore->mods[$modname]->userinfo = false;
}
}
}
$restore = clone $SESSION->restore;
if (!restore_execute($SESSION->restore, $SESSION->info, $SESSION->course_header, $errorstr)) {
mtrace($debuginfo . 'Failed restore_execute (error was ' . $errorstr . ')');
return false;
}
return true;
}
/** this function will restore an entire backup.zip into the specified course
* using standard moodle backup/restore functions, but silently.
* @param string $pathtofile the absolute path to the backup file.
* @param int $destinationcourse the course id to restore to.
* @param boolean $emptyfirst whether to delete all coursedata first.
* @param boolean $userdata whether to include any userdata that may be in the backup file.
*/
function import_backup_file_silently($pathtofile, $destinationcourse, $emptyfirst = false, $userdata = false)
{
global $CFG, $SESSION, $USER;
// is there such a thing on cron? I guess so..
if (empty($USER)) {
$USER = get_admin();
$USER->admin = 1;
// not sure why, but this doesn't get set
}
define('RESTORE_SILENTLY', true);
// don't output all the stuff to us.
$debuginfo = 'import_backup_file_silently: ';
$cleanupafter = false;
$errorstr = '';
// passed by reference to restore_precheck to get errors from.
if (!($course = get_record('course', 'id', $destinationcourse))) {
mtrace($debuginfo . 'Course with id $destinationcourse was not a valid course!');
return false;
}
// first check we have a valid file.
if (!file_exists($pathtofile) || !is_readable($pathtofile)) {
mtrace($debuginfo . 'File ' . $pathtofile . ' either didn\'t exist or wasn\'t readable');
return false;
}
// now make sure it's a zip file
require_once $CFG->dirroot . '/lib/filelib.php';
$filename = substr($pathtofile, strrpos($pathtofile, '/') + 1);
$mimetype = mimeinfo("type", $filename);
if ($mimetype != 'application/zip') {
mtrace($debuginfo . 'File ' . $pathtofile . ' was of wrong mimetype (' . $mimetype . ')');
return false;
}
// restore_precheck wants this within dataroot, so lets put it there if it's not already..
if (strstr($pathtofile, $CFG->dataroot) === false) {
// first try and actually move it..
if (!check_dir_exists($CFG->dataroot . '/temp/backup/', true)) {
mtrace($debuginfo . 'File ' . $pathtofile . ' outside of dataroot and couldn\'t move it! ');
return false;
}
if (!copy($pathtofile, $CFG->dataroot . '/temp/backup/' . $filename)) {
mtrace($debuginfo . 'File ' . $pathtofile . ' outside of dataroot and couldn\'t move it! ');
return false;
} else {
$pathtofile = 'temp/backup/' . $filename;
$cleanupafter = true;
}
} else {
// it is within dataroot, so take it off the path for restore_precheck.
$pathtofile = substr($pathtofile, strlen($CFG->dataroot . '/'));
}
if (!backup_required_functions()) {
mtrace($debuginfo . 'Required function check failed (see backup_required_functions)');
return false;
}
@ini_set("max_execution_time", "3000");
raise_memory_limit("192M");
if (!($backup_unique_code = restore_precheck($destinationcourse, $pathtofile, $errorstr, true))) {
mtrace($debuginfo . 'Failed restore_precheck (error was ' . $errorstr . ')');
return false;
}
restore_setup_for_check($SESSION->restore, $backup_unique_code);
// add on some extra stuff we need...
$SESSION->restore->restoreto = 1;
$SESSION->restore->course_id = $destinationcourse;
$SESSION->restore->deleting = $emptyfirst;
// maybe we need users (defaults to 2 in restore_setup_for_check)
if (!empty($userdata)) {
$SESSION->restore->users = 1;
}
// we also need modules...
if ($allmods = get_records("modules")) {
foreach ($allmods as $mod) {
$modname = $mod->name;
//Now check that we have that module info in the backup file
if (isset($SESSION->info->mods[$modname]) && $SESSION->info->mods[$modname]->backup == "true") {
$SESSION->restore->mods[$modname]->restore = true;
$SESSION->restore->mods[$modname]->userinfo = $userdata;
}
}
}
if (!restore_execute($SESSION->restore, $SESSION->info, $SESSION->course_header, $errorstr)) {
mtrace($debuginfo . 'Failed restore_execute (error was ' . $errorstr . ')');
return false;
}
return true;
}
/** this function will restore an entire backup.zip into the specified course
* using standard moodle backup/restore functions, but silently.
* @param string $pathtofile the absolute path to the backup file.
* @param int $destinationcourse the course id to restore to.
* @param boolean $emptyfirst whether to delete all coursedata first.
* @param boolean $userdata whether to include any userdata that may be in the backup file.
* @param array $preferences optional, 0 will be used. Can contain:
* metacourse
* logs
* course_files
* messages
*/
function import_backup_file_silently($pathtofile, $destinationcourse, $emptyfirst = false, $userdata = false, $preferences = array())
{
global $CFG, $SESSION, $USER;
// is there such a thing on cron? I guess so..
if (!defined('RESTORE_SILENTLY')) {
define('RESTORE_SILENTLY', true);
// don't output all the stuff to us.
}
$debuginfo = 'import_backup_file_silently: ';
$cleanupafter = false;
$errorstr = '';
// passed by reference to restore_precheck to get errors from.
$course = null;
if ($destinationcourse && !($course = get_record('course', 'id', $destinationcourse))) {
mtrace($debuginfo . 'Course with id $destinationcourse was not a valid course!');
return false;
}
// first check we have a valid file.
if (!file_exists($pathtofile) || !is_readable($pathtofile)) {
mtrace($debuginfo . 'File ' . $pathtofile . ' either didn\'t exist or wasn\'t readable');
return false;
}
// now make sure it's a zip file
require_once $CFG->dirroot . '/lib/filelib.php';
$filename = substr($pathtofile, strrpos($pathtofile, '/') + 1);
$mimetype = mimeinfo("type", $filename);
if ($mimetype != 'application/zip') {
mtrace($debuginfo . 'File ' . $pathtofile . ' was of wrong mimetype (' . $mimetype . ')');
return false;
}
// restore_precheck wants this within dataroot, so lets put it there if it's not already..
if (strstr($pathtofile, $CFG->dataroot) === false) {
// first try and actually move it..
if (!check_dir_exists($CFG->dataroot . '/temp/backup/', true)) {
mtrace($debuginfo . 'File ' . $pathtofile . ' outside of dataroot and couldn\'t move it! ');
return false;
}
if (!copy($pathtofile, $CFG->dataroot . '/temp/backup/' . $filename)) {
mtrace($debuginfo . 'File ' . $pathtofile . ' outside of dataroot and couldn\'t move it! ');
return false;
} else {
$pathtofile = 'temp/backup/' . $filename;
$cleanupafter = true;
}
} else {
// it is within dataroot, so take it off the path for restore_precheck.
$pathtofile = substr($pathtofile, strlen($CFG->dataroot . '/'));
}
if (!backup_required_functions()) {
mtrace($debuginfo . 'Required function check failed (see backup_required_functions)');
return false;
}
@ini_set("max_execution_time", "3000");
if (empty($CFG->extramemorylimit)) {
raise_memory_limit('128M');
} else {
raise_memory_limit($CFG->extramemorylimit);
}
if (!($backup_unique_code = restore_precheck($destinationcourse, $pathtofile, $errorstr, true))) {
mtrace($debuginfo . 'Failed restore_precheck (error was ' . $errorstr . ')');
return false;
}
global $restore;
// ick
$restore = new StdClass();
// copy back over the stuff that gets set in restore_precheck
$restore->course_header = $SESSION->course_header;
$restore->info = $SESSION->info;
$xmlfile = "{$CFG->dataroot}/temp/backup/{$backup_unique_code}/moodle.xml";
$info = restore_read_xml_roles($xmlfile);
$restore->rolesmapping = array();
if (isset($info->roles) && is_array($info->roles)) {
foreach ($info->roles as $id => $info) {
if ($newroleid = get_field('role', 'id', 'shortname', $info->shortname)) {
$restore->rolesmapping[$id] = $newroleid;
}
}
}
// add on some extra stuff we need...
$restore->metacourse = isset($preferences['restore_metacourse']) ? $preferences['restore_metacourse'] : 0;
$restore->course_id = $destinationcourse;
if ($destinationcourse) {
$restore->restoreto = RESTORETO_CURRENT_ADDING;
$restore->course_startdateoffset = $course->startdate - $restore->course_header->course_startdate;
} else {
$restore->restoreto = RESTORETO_NEW_COURSE;
$restore->restore_restorecatto = 0;
// let this be handled by the headers
$restore->course_startdateoffset = 0;
}
$restore->users = $userdata;
$restore->user_files = $userdata;
$restore->deleting = $emptyfirst;
$restore->groups = isset($preferences['restore_groups']) ? $preferences['restore_groups'] : RESTORE_GROUPS_NONE;
$restore->logs = isset($preferences['restore_logs']) ? $preferences['restore_logs'] : 0;
$restore->messages = isset($preferences['restore_messages']) ? $preferences['restore_messages'] : 0;
$restore->blogs = isset($preferences['restore_blogs']) ? $preferences['restore_blogs'] : 0;
$restore->course_files = isset($preferences['restore_course_files']) ? $preferences['restore_course_files'] : 0;
$restore->site_files = isset($preferences['restore_site_files']) ? $preferences['restore_site_files'] : 0;
$restore->backup_version = $restore->info->backup_backup_version;
$restore->original_wwwroot = $restore->info->original_wwwroot;
// now copy what we have over to the session
// this needs to happen before restore_setup_for_check
// which for some reason reads the session
$SESSION->restore =& $restore;
// rename the things that are called differently
$SESSION->restore->restore_course_files = $restore->course_files;
$SESSION->restore->restore_site_files = $restore->site_files;
$SESSION->restore->backup_version = $restore->info->backup_backup_version;
restore_setup_for_check($restore, $backup_unique_code);
// maybe we need users (defaults to 2 (none) in restore_setup_for_check)
// so set this again here
if (!empty($userdata)) {
$restore->users = 1;
}
// we also need modules...
if ($allmods = get_records("modules")) {
foreach ($allmods as $mod) {
$modname = $mod->name;
//Now check that we have that module info in the backup file
if (isset($restore->info->mods[$modname]) && $restore->info->mods[$modname]->backup == "true") {
$restore->mods[$modname]->restore = true;
$restore->mods[$modname]->userinfo = $userdata;
} else {
// avoid warnings
$restore->mods[$modname]->restore = false;
$restore->mods[$modname]->userinfo = false;
}
}
}
if (!($status = restore_execute($restore, $restore->info, $restore->course_header, $errorstr))) {
mtrace($debuginfo . 'Failed restore_execute (error was ' . $errorstr . ')');
return false;
}
// now get out the new courseid and return that
if ($restore->restoreto = RESTORETO_NEW_COURSE) {
if (!empty($SESSION->restore->course_id)) {
return $SESSION->restore->course_id;
}
return false;
}
return true;
}
error("File not specified");
}
//Check login
require_login();
//Check admin
if (!empty($id)) {
if (!has_capability('moodle/site:restore', get_context_instance(CONTEXT_COURSE, $id))) {
if (empty($to)) {
error("You need to be a teacher or admin user to use this page.", "{$CFG->wwwroot}/login/index.php");
} else {
if (!has_capability('moodle/site:restore', get_context_instance(CONTEXT_COURSE, $to)) && !has_capability('moodle/site:import', get_context_instance(CONTEXT_COURSE, $to))) {
error("You need to be a teacher or admin user to use this page.", "{$CFG->wwwroot}/login/index.php");
}
}
}
} else {
if (!has_capability('moodle/site:restore', get_context_instance(CONTEXT_SYSTEM, SITEID))) {
error("You need to be an admin user to use this page.", "{$CFG->wwwroot}/login/index.php");
}
}
//Check site
if (!($site = get_site())) {
error("Site not found!");
}
$errorstr = '';
define('RESTORE_SILENTLY', 1);
$backup_unique_code = restore_precheck($id, $file, $errorstr, true);
$SESSION->restore->section = $section;
if (!$backup_unique_code) {
error("An error occured " . $errorstr);
}