--- /dev/null
+<?PHP //$Id$
+ //This file contains all the function needed in the backup utility
+ //except the mod-related funtions that are into every backuplib.php inside
+ //every mod directory
+
+ //Insert necessary category ids to backup_ids table
+ function insert_category_ids ($course,$backup_unique_code) {
+ global $CFG;
+ $status = true;
+ $status = execute_sql("INSERT INTO {$CFG->prefix}backup_ids
+ (backup_code, table_name, old_id)
+ SELECT DISTINCT '$backup_unique_code','quiz_categories',t.category
+ FROM {$CFG->prefix}quiz_questions t,
+ {$CFG->prefix}quiz_question_grades g,
+ {$CFG->prefix}quiz q
+ WHERE q.course = '$course' AND
+ g.quiz = q.id AND
+ g.question = t.id",false);
+ return $status;
+ }
+
+ //Delete category ids from backup_ids table
+ function delete_category_ids ($backup_unique_code) {
+ global $CFG;
+ $status = true;
+ $status = execute_sql("DELETE FROM {$CFG->prefix}backup_ids
+ WHERE backup_code = '$backup_unique_code'",false);
+ return $status;
+ }
+
+ //Calculate the number of users to backup and put their ids in backup_ids
+ //Return an array of info (name,value)
+ function user_check_backup($course,$backup_unique_code,$backup_users) {
+ //$backup_users=0-->all
+ // 1-->course
+ // 2-->needed-->NOT IMPLEMEMTED
+
+ global $CFG;
+ global $db;
+
+ $count_users = 0;
+
+ //Select all users from user
+ $users = get_records ("user");
+ //Iterate over users putting their roles
+ foreach ($users as $user) {
+ $user->info = "";
+ //Is Admin in tables (not is_admin()) !!
+ if (record_exists("user_admins","userid",$user->id)) {
+ $user->info .= "admin";
+ $user->role_admin = true;
+ }
+ //Is Course Creator in tables (not is_coursecreator()) !!
+ if (record_exists("user_coursecreators","userid",$user->id)) {
+ $user->info .= "coursecreator";
+ $user->role_coursecreator = true;
+ }
+ //Is Teacher in tables (not is_teacher()) !!
+ if (record_exists("user_teachers","course",$course,"userid",$user->id)) {
+ $user->info .= "teacher";
+ $user->role_teacher = true;
+ }
+ //Is Student in tables (not is_student()) !!
+ if (record_exists("user_students","course",$course,"userid",$user->id)) {
+ $user->info .= "student";
+ $user->role_student = true;
+ }
+ //Now create the backup_id record
+ $backupids_rec->backup_code = $backup_unique_code;
+ $backupids_rec->table_name = "user";
+ $backupids_rec->old_id = $user->id;
+ $backupids_rec->info = $user->info;
+
+ //Insert the record id. backup_users decide it.
+ //When all users
+ if ($backup_users == 0) {
+ $status = insert_record("backup_ids",$backupids_rec,false);
+ $count_users++;
+ //When course users
+ } else if ($backup_users == 1) {
+ //Only if user has any role
+ if ($backupids_rec->info) {
+ $status = insert_record("backup_ids",$backupids_rec,false);
+ $count_users++;
+ }
+ }
+ }
+
+ //Prepare Info
+ //Gets the user data
+ $info[0][0] = get_string("users");
+ $info[0][1] = $count_users;
+
+ return $info;
+ }
+
+ //Calculate the number of log entries to backup
+ //Return an array of info (name,value)
+ function log_check_backup($course) {
+
+ global $CFG;
+
+ //Execute the insert
+ $status = execute_sql($sql_insert,false);
+
+ //Now execute the select
+ $ids = get_records_sql("SELECT DISTINCT l.id,l.course
+ FROM {$CFG->prefix}log l
+ WHERE l.course = '$course'");
+ //Gets the user data
+ $info[0][0] = get_string("logs");
+ if ($ids) {
+ $info[0][1] = count($ids);
+ } else {
+ $info[0][1] = 0;
+ }
+
+ return $info;
+ }
+
+ //Calculate the number of user files to backup
+ //Under $CFG->dataroot/users
+ //and put them (their path) in backup_ids
+ //Return an array of info (name,value)
+ function user_files_check_backup($course,$backup_unique_code) {
+
+ global $CFG;
+
+ $rootdir = $CFG->dataroot."/users";
+ //Check if directory exists
+ if (is_dir($rootdir)) {
+ $coursedirs = get_directory_list($rootdir);
+ foreach ($coursedirs as $dir) {
+ //Extracts user id from file path
+ $tok = strtok($dir,"/");
+ if ($tok) {
+ $userid = $tok;
+ } else {
+ $tok = "";
+ }
+ //Insert them into backup_files
+ $status = execute_sql("INSERT INTO {$CFG->prefix}backup_files
+ (backup_code, file_type, path, old_id)
+ VALUES
+ ('$backup_unique_code','user','$dir','$userid')",false);
+ }
+ }
+
+ //Now execute the select
+ $ids = get_records_sql("SELECT DISTINCT b.path, b.old_id
+ FROM {$CFG->prefix}backup_files b
+ WHERE backup_code = '$backup_unique_code' AND
+ file_type = 'user'");
+ //Gets the user data
+ $info[0][0] = get_string("files");
+ if ($ids) {
+ $info[0][1] = count($ids);
+ } else {
+ $info[0][1] = 0;
+ }
+
+ return $info;
+ }
+
+ //Calculate the number of course files to backup
+ //under $CFG->dataroot/$course, except $CFG->moddata, and get_string("backupdir)
+ //and put them (their path) in backup_ids
+ //Return an array of info (name,value)
+ function course_files_check_backup($course,$backup_unique_code) {
+
+ global $CFG;
+
+ $rootdir = $CFG->dataroot."/$course";
+ //Check if directory exists
+ if (is_dir($rootdir)) {
+ $coursedirs = get_directory_list($rootdir,$CFG->moddata);
+ $backupdir = get_string("backupdir");
+ foreach ($coursedirs as $dir) {
+ //Check it isn't backupdir
+ if (strpos($dir,$backupdir)!==0) {
+ //Insert them into backup_files
+ $status = execute_sql("INSERT INTO {$CFG->prefix}backup_files
+ (backup_code, file_type, path)
+ VALUES
+ ('$backup_unique_code','course','$dir')",false);
+ }
+ }
+ }
+
+ //Now execute the select
+ $ids = get_records_sql("SELECT DISTINCT b.path, b.old_id
+ FROM {$CFG->prefix}backup_files b
+ WHERE backup_code = '$backup_unique_code' AND
+ file_type = 'course'");
+ //Gets the user data
+ $info[0][0] = get_string("files");
+ if ($ids) {
+ $info[0][1] = count($ids);
+ } else {
+ $info[0][1] = 0;
+ }
+
+ return $info;
+ }
+
+ //Function to check and create the needed moddata dir to
+ //save all the mod backup files. We always name it moddata
+ //to be able to restore it, but in restore we check for
+ //$CFG->moddata !!
+ function check_and_create_moddata_dir($backup_unique_code) {
+
+ global $CFG;
+
+ $status = check_dir_exists($CFG->dataroot."/temp/backup/".$backup_unique_code."/moddata",true);
+
+ return $status;
+ }
+
+ //Function to check and create the "user_files" dir to
+ //save all the user files we need from "users" dir
+ function check_and_create_user_files_dir($backup_unique_code) {
+
+ global $CFG;
+
+ $status = check_dir_exists($CFG->dataroot."/temp/backup/".$backup_unique_code."/user_files",true);
+
+ return $status;
+ }
+
+ //Function to check and create the "course_files" dir to
+ //save all the course files we need from "CFG->datadir/course" dir
+ function check_and_create_course_files_dir($backup_unique_code) {
+
+ global $CFG;
+
+ $status = check_dir_exists($CFG->dataroot."/temp/backup/".$backup_unique_code."/course_files",true);
+
+ return $status;
+ }
+
+ //Function to create, open and write header of the xml file
+ function backup_open_xml($backup_unique_code) {
+
+ global $CFG;
+
+ $status = true;
+
+ //Open for writing
+
+ $file = $CFG->dataroot."/temp/backup/".$backup_unique_code."/moodle.xml";
+ $backup_file = fopen($file,"w");
+ //Writes the header
+ $status = fwrite ($backup_file,"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n");
+ if ($status) {
+ $status = fwrite ($backup_file,start_tag("MOODLE_BACKUP",0,true));
+ }
+ if ($status) {
+ return $backup_file;
+ } else {
+ return false;
+ }
+ }
+
+ //Close the file
+ function backup_close_xml($backup_file) {
+ $status = fwrite ($backup_file,end_tag("MOODLE_BACKUP",0,true));
+ return fclose($backup_file);
+ }
+
+ //Return the xml start tag
+ function start_tag($tag,$level=0,$endline=false) {
+ if ($endline) {
+ $endchar = "\n";
+ } else {
+ $endchar = "";
+ }
+ return str_repeat(" ",$level*2)."<".strtoupper($tag).">".$endchar;
+ }
+
+ //Return the xml end tag
+ function end_tag($tag,$level=0,$endline=true) {
+ if ($endline) {
+ $endchar = "\n";
+ } else {
+ $endchar = "";
+ }
+ return str_repeat(" ",$level*2)."</".strtoupper($tag).">".$endchar;
+ }
+
+ //Return the start tag, the contents and the end tag
+ function full_tag($tag,$level=0,$endline=true,$content,$to_utf=true) {
+ $st = start_tag($tag,$level,$endline);
+ $co="";
+ if ($to_utf) {
+ $co = utf8_encode(htmlspecialchars($content));
+ } else {
+ $co = htmlspecialchars($content);
+ }
+ $et = end_tag($tag,0,true);
+ return $st.$co.$et;
+ }
+
+ //Prints General info about the course
+ //name, moodle_version (internal and release), backup_version, date, info in file...
+ function backup_general_info ($bf,$preferences) {
+
+ global $CFG;
+
+ fwrite ($bf,start_tag("INFO",1,true));
+
+ //The name of the backup
+ fwrite ($bf,full_tag("NAME",2,false,$preferences->backup_name));
+ //The moodle_version
+ fwrite ($bf,full_tag("MOODLE_VERSION",2,false,$preferences->moodle_version));
+ fwrite ($bf,full_tag("MOODLE_RELEASE",2,false,$preferences->moodle_release));
+ //The backup_version
+ fwrite ($bf,full_tag("BACKUP_VERSION",2,false,$preferences->backup_version));
+ fwrite ($bf,full_tag("BACKUP_RELEASE",2,false,$preferences->backup_release));
+ //The date
+ fwrite ($bf,full_tag("DATE",2,false,$preferences->backup_unique_code));
+ //Te includes tag
+ fwrite ($bf,start_tag("DETAILS",2,true));
+ //Now, go to mod element of preferences to print its status
+ foreach ($preferences->mods as $element) {
+ //Calculate info
+ $included = "false";
+ $userinfo = "false";
+ if ($element->backup) {
+ $included = "true";
+ if ($element->userinfo) {
+ $userinfo = "true";
+ }
+ }
+ //Prints the mod start
+ fwrite ($bf,start_tag("MOD",3,true));
+ fwrite ($bf,full_tag("NAME",4,false,$element->name));
+ fwrite ($bf,full_tag("INCLUDED",4,false,$included));
+ fwrite ($bf,full_tag("USERINFO",4,false,$userinfo));
+
+ //Print the end
+ fwrite ($bf,end_tag("MOD",3,true));
+ }
+ //The user in backup
+ if ($preferences->backup_users == 1) {
+ fwrite ($bf,full_tag("USERS",3,false,"course"));
+ } else {
+ fwrite ($bf,full_tag("USERS",3,false,"all"));
+ }
+ //The logs in backup
+ if ($preferences->backup_logs == 1) {
+ fwrite ($bf,full_tag("LOGS",3,false,"true"));
+ } else {
+ fwrite ($bf,full_tag("LOGS",3,false,"false"));
+ }
+ //The user files
+ if ($preferences->backup_user_files == 1) {
+ fwrite ($bf,full_tag("USERFILES",3,false,"true"));
+ } else {
+ fwrite ($bf,full_tag("USERFILES",3,false,"false"));
+ }
+ //The course files
+ if ($preferences->backup_course_files == 1) {
+ fwrite ($bf,full_tag("COURSEFILES",3,false,"true"));
+ } else {
+ fwrite ($bf,full_tag("COURSEFILES",3,false,"false"));
+ }
+
+ fwrite ($bf,end_tag("DETAILS",2,true));
+
+
+ $status = fwrite ($bf,end_tag("INFO",1,true));
+
+ return $status;
+ }
+
+ //Prints course's general info (table course)
+ function backup_course_start ($bf,$preferences) {
+
+ global $CFG;
+
+ $status = true;
+
+ //Course open tag
+ fwrite ($bf,start_tag("COURSE",1,true));
+
+ //Get info from course
+ $course=false;
+ if ($courses = get_records("course","id",$preferences->backup_course)) {
+ $course = $courses[$preferences->backup_course];
+ }
+ if ($course) {
+ //Prints course info
+ fwrite ($bf,full_tag("ID",2,false,$course->id));
+ //Obtain the category
+ $category = false;
+ if ($categories = get_records("course_categories","id","$course->category")) {
+ $category = $categories[$course->category];
+ }
+ if ($category) {
+ //Prints category info
+ fwrite ($bf,start_tag("CATEGORY",2,true));
+ fwrite ($bf,full_tag("ID",3,false,$course->category));
+ fwrite ($bf,full_tag("NAME",3,false,$category->name));
+ fwrite ($bf,end_tag("CATEGORY",2,true));
+ }
+ //Continues with the course
+ fwrite ($bf,full_tag("PASSWORD",2,false,$course->password));
+ fwrite ($bf,full_tag("FULLNAME",2,false,$course->fullname));
+ fwrite ($bf,full_tag("SHORTNAME",2,false,$course->shortname));
+ fwrite ($bf,full_tag("SUMMARY",2,false,$course->summary));
+ fwrite ($bf,full_tag("FORMAT",2,false,$course->format));
+ fwrite ($bf,full_tag("NEWSITEMS",2,false,$course->newsitems));
+ fwrite ($bf,full_tag("TEACHER",2,false,$course->teacher));
+ fwrite ($bf,full_tag("TEACHERS",2,false,$course->teachers));
+ fwrite ($bf,full_tag("STUDENT",2,false,$course->student));
+ fwrite ($bf,full_tag("STUDENTS",2,false,$course->students));
+ fwrite ($bf,full_tag("GUEST",2,false,$course->guest));
+ fwrite ($bf,full_tag("STARDATE",2,false,$course->stardate));
+ fwrite ($bf,full_tag("NUMSECTIONS",2,false,$course->numsections));
+ fwrite ($bf,full_tag("SHOWRECENT",2,false,$course->showrecent));
+ fwrite ($bf,full_tag("MARKER",2,false,$course->marker));
+ fwrite ($bf,full_tag("TIMECREATED",2,false,$course->timecreated));
+ $status = fwrite ($bf,full_tag("TIMEMODIFIED",2,false,$course->timemodified));
+ } else {
+ $status = false;
+ }
+
+ return $status;
+ }
+
+ //Prints course's end tag
+ function backup_course_end ($bf,$preferences) {
+
+ //Course end tag
+ $status = fwrite ($bf,end_tag("COURSE",1,true));
+
+ return $status;
+
+ }
+
+ //Prints course's sections info (table course_sections)
+ function backup_course_sections ($bf,$preferences) {
+
+ global $CFG;
+
+ $status = true;
+
+
+ //Get info from sections
+ $section=false;
+ if ($sections = get_records("course_sections","course",$preferences->backup_course,"section")) {
+ //Section open tag
+ fwrite ($bf,start_tag("SECTIONS",2,true));
+ //Iterate over every section (ordered by section)
+ foreach ($sections as $section) {
+ //Begin Section
+ fwrite ($bf,start_tag("SECTION",3,true));
+ fwrite ($bf,full_tag("ID",4,false,$section->id));
+ fwrite ($bf,full_tag("NUMBER",4,false,$section->section));
+ fwrite ($bf,full_tag("SUMMARY",4,false,$section->summary));
+ fwrite ($bf,full_tag("VISIBLE",4,false,$section->visible));
+ //Now print the mods in section
+ backup_course_modules ($bf,$preferences,$section);
+ //End section
+ fwrite ($bf,end_tag("SECTION",3,true));
+ }
+ //Section close tag
+ $status = fwrite ($bf,end_tag("SECTIONS",2,true));
+ }
+
+ return $status;
+
+ }
+
+ //Prints course's modules info (table course_modules)
+ //Only for selected mods in preferences
+ function backup_course_modules ($bf,$preferences,$section) {
+
+ global $CFG;
+
+ $status = true;
+
+ $first_record = true;
+
+ //Now print the mods in section
+ //Extracts mod id from sequence
+ $tok = strtok($section->sequence,",");
+ while ($tok) {
+ //Get module's type
+ $moduletype = get_module_type ($preferences->backup_course,$tok);
+ //Check if we've selected to backup that type
+ if ($moduletype and $preferences->mods[$moduletype]->backup) {
+ $selected = true;
+ } else {
+ $selected = false;
+ }
+
+ if ($selected) {
+ //Gets course_module data from db
+ $course_module = get_records ("course_modules","id",$tok);
+ //If it's the first, pring MODS tag
+ if ($first_record) {
+ fwrite ($bf,start_tag("MODS",4,true));
+ $first_record = false;
+ }
+ //Print mod info from course_modules
+ fwrite ($bf,start_tag("MOD",5,true));
+ //Save neccesary info to backup_ids
+ fwrite ($bf,full_tag("ID",6,false,$tok));
+ fwrite ($bf,full_tag("TYPE",6,false,$moduletype));
+ fwrite ($bf,full_tag("INSTANCE",6,false,$course_module[$tok]->instance));
+ fwrite ($bf,full_tag("DELETED",6,false,$course_module[$tok]->deleted));
+ fwrite ($bf,full_tag("SCORE",6,false,$course_module[$tok]->score));
+ fwrite ($bf,full_tag("VISIBLE",6,false,$course_module[$tok]->visible));
+ fwrite ($bf,end_tag("MOD",5,true));
+ }
+ //check for next
+ $tok = strtok(",");
+ }
+
+ //Si ha habido modulos, final de MODS
+ if (!$first_record) {
+ $status =fwrite ($bf,end_tag("MODS",4,true));
+ }
+
+ return $status;
+ }
+
+ //Print users to xml
+ //Only users previously calculated in backup_ids will output
+ //
+ function backup_user_info ($bf,$preferences) {
+
+ global $CFG;
+
+ $status = true;
+
+ $users = get_records_sql("SELECT u.old_id, u.table_name,u.info
+ FROM {$CFG->prefix}backup_ids u
+ WHERE u.backup_code = '$preferences->backup_unique_code' AND
+ u.table_name = 'user'");
+
+ //If we have users to backup
+ if ($users) {
+ //Begin Users tag
+ fwrite ($bf,start_tag("USERS",2,true));
+ //With every user
+ foreach ($users as $user) {
+ //Get user data from table
+ $user_data = get_record("user","id",$user->old_id);
+ //Begin User tag
+ fwrite ($bf,start_tag("USER",3,true));
+ //Output all user data
+ fwrite ($bf,full_tag("ID",4,false,$user_data->id));
+ fwrite ($bf,full_tag("CONFIRMED",4,false,$user_data->confirmed));
+ fwrite ($bf,full_tag("DELETED",4,false,$user_data->deleted));
+ fwrite ($bf,full_tag("USERNAME",4,false,$user_data->username));
+ fwrite ($bf,full_tag("PASSWORD",4,false,$user_data->password));
+ fwrite ($bf,full_tag("IDNUMBER",4,false,$user_data->idnumber));
+ fwrite ($bf,full_tag("FIRSTNAME",4,false,$user_data->firsname));
+ fwrite ($bf,full_tag("LASTNAME",4,false,$user_data->lastname));
+ fwrite ($bf,full_tag("EMAIL",4,false,$user_data->email));
+ fwrite ($bf,full_tag("ICQ",4,false,$user_data->icq));
+ fwrite ($bf,full_tag("PHONE1",4,false,$user_data->phone1));
+ fwrite ($bf,full_tag("PHONE2",4,false,$user_data->phone2));
+ fwrite ($bf,full_tag("INSTITUTION",4,false,$user_data->institution));
+ fwrite ($bf,full_tag("DEPARTMENT",4,false,$user_data->department));
+ fwrite ($bf,full_tag("ADDRESS",4,false,$user_data->address));
+ fwrite ($bf,full_tag("CITY",4,false,$user_data->city));
+ fwrite ($bf,full_tag("COUNTRY",4,false,$user_data->country));
+ fwrite ($bf,full_tag("LANG",4,false,$user_data->lang));
+ fwrite ($bf,full_tag("TIMEZONE",4,false,$user_data->timezone));
+ fwrite ($bf,full_tag("FIRSTACCESS",4,false,$user_data->firstaccess));
+ fwrite ($bf,full_tag("LASTACCESS",4,false,$user_data->lastaccess));
+ fwrite ($bf,full_tag("LASTLOGIN",4,false,$user_data->lastlogin));
+ fwrite ($bf,full_tag("CURRENTLOGIN",4,false,$user_data->currentlogin));
+ fwrite ($bf,full_tag("LASTIP",4,false,$user_data->lastIP));
+ fwrite ($bf,full_tag("SECRET",4,false,$user_data->secret));
+ fwrite ($bf,full_tag("PICTURE",4,false,$user_data->picture));
+ fwrite ($bf,full_tag("URL",4,false,$user_data->url));
+ fwrite ($bf,full_tag("DESCRIPTION",4,false,$user_data->description));
+ fwrite ($bf,full_tag("MAILFORMAT",4,false,$user_data->mailformat));
+ fwrite ($bf,full_tag("MAILDISPLAY",4,false,$user_data->maildisplay));
+ fwrite ($bf,full_tag("HTMLEDITOR",4,false,$user_data->htmleditor));
+ fwrite ($bf,full_tag("TIMEMODIFIED",4,false,$user_data->timemodified));
+
+ //Output every user role (with its associated info)
+ $user->isadmin = strpos($user->info,"admin");
+ $user->iscoursecreator = strpos($user->info,"coursecreator");
+ $user->isteacher = strpos($user->info,"teacher");
+ $user->isstudent = strpos($user->info,"student");
+ if ($user->isadmin!==false or
+ $user->iscoursecreator!==false or
+ $user->isteacher!==false or
+ $user->isstudent!==false) {
+ //Begin ROLES tag
+ fwrite ($bf,start_tag("ROLES",4,true));
+ //PRINT ROLE INFO
+ //Admins
+ if ($user->isadmin!==false) {
+ //Print ROLE start
+ fwrite ($bf,start_tag("ROLE",5,true));
+ //Print Role info
+ fwrite ($bf,full_tag("TYPE",6,false,"admin"));
+ //Print ROLE end
+ fwrite ($bf,end_tag("ROLE",5,true));
+ }
+ //CourseCreator
+ if ($user->iscoursecreator!==false) {
+ //Print ROLE start
+ fwrite ($bf,start_tag("ROLE",5,true));
+ //Print Role info
+ fwrite ($bf,full_tag("TYPE",6,false,"coursecreator"));
+ //Print ROLE end
+ fwrite ($bf,end_tag("ROLE",5,true));
+ }
+ //Teacher
+ if ($user->isteacher!==false) {
+ //Print ROLE start
+ fwrite ($bf,start_tag("ROLE",5,true));
+ //Print Role info
+ fwrite ($bf,full_tag("TYPE",6,false,"teacher"));
+ //Get specific info for teachers
+ $tea = get_record("user_teachers","userid",$user->old_id,"course",$preferences->backup_course);
+ fwrite ($bf,full_tag("AUTHORITY",6,false,$tea->authority));
+ fwrite ($bf,full_tag("TEA_ROLE",6,false,$tea->role));
+ //Print ROLE end
+ fwrite ($bf,end_tag("ROLE",5,true));
+ }
+ //Student
+ if ($user->isstudent!==false) {
+ //Print ROLE start
+ fwrite ($bf,start_tag("ROLE",5,true));
+ //Print Role info
+ fwrite ($bf,full_tag("TYPE",6,false,"student"));
+ //Get specific info for students
+ $stu = get_record("user_students","userid",$user->old_id,"course",$preferences->backup_course);
+ fwrite ($bf,full_tag("TIMESTART",6,false,$stu->timestart));
+ fwrite ($bf,full_tag("TIMEEND",6,false,$stu->timeend));
+ fwrite ($bf,full_tag("TIME",6,false,$stu->time));
+ //Print ROLE end
+ fwrite ($bf,end_tag("ROLE",5,true));
+ }
+
+
+ //End ROLES tag
+ fwrite ($bf,end_tag("ROLES",4,true));
+ }
+ //End User tag
+ fwrite ($bf,end_tag("USER",3,true));
+ }
+ //End Users tag
+ fwrite ($bf,end_tag("USERS",2,true));
+ } else {
+ //There isn't users. Impossible !!
+ $status = false;
+ }
+
+ return $status;
+ }
+
+ //Backup log info (time ordered)
+ function backup_log_info($bf,$preferences) {
+
+ global $CFG;
+
+ $status = true;
+
+ $logs = get_records ("log","course",$preferences->backup_course,"time");
+
+ //We have logs
+ if ($logs) {
+ //Pring logs header
+ fwrite ($bf,start_tag("LOGS",2,true));
+ //Iterate
+ foreach ($logs as $log) {
+ //See if it is a valid module to backup
+ if ($log->module == "course" or
+ $log->module == "user" or
+ $preferences->mods[$log->module]->backup == 1) {
+ //Begin log tag
+ fwrite ($bf,start_tag("LOG",3,true));
+
+ //Output log tag
+ fwrite ($bf,full_tag("ID",4,false,$log->id));
+ fwrite ($bf,full_tag("TIME",4,false,$log->time));
+ fwrite ($bf,full_tag("USERID",4,false,$log->userid));
+ fwrite ($bf,full_tag("IP",4,false,$log->ip));
+ fwrite ($bf,full_tag("MODULE",4,false,$log->module));
+ fwrite ($bf,full_tag("ACTION",4,false,$log->action));
+ fwrite ($bf,full_tag("URL",4,false,$log->url));
+ fwrite ($bf,full_tag("INFO",4,false,$log->info));
+
+ //End log tag
+ fwrite ($bf,end_tag("LOG",3,true));
+ }
+ }
+ //End logs tag
+ $status = fwrite ($bf,end_tag("LOGS",2,true));
+ }
+ return $status;
+ }
+
+ //Start the modules tag
+ function backup_modules_start ($bf,$preferences) {
+
+ return fwrite ($bf,start_tag("MODULES",2,true));
+ }
+
+ //End the modules tag
+ function backup_modules_end ($bf,$preferences) {
+
+ return fwrite ($bf,end_tag("MODULES",2,true));
+ }
+
+ //This function makes all the necesary calls to every mod
+ //to export itself and its files !!!
+ function backup_module($bf,$preferences,$module) {
+
+ global $CFG;
+
+ $status = true;
+
+ //First, re-check if necessary functions exists
+ $modbackup = $module."_backup_mods";
+ if (function_exists($modbackup)) {
+ //Call the function
+ $status = $modbackup($bf,$preferences);
+ } else {
+ //Something was wrong. Function should exist.
+ $status = false;
+ }
+
+ return $status;
+
+ }
+
+ //This function copies all the needed files under the "users" directory to the "user_files"
+ //directory under temp/backup
+ function backup_copy_user_files ($preferences) {
+
+ global $CFG;
+
+ $status = true;
+
+ //First we check to "user_files" exists and create it as necessary
+ //in temp/backup/$backup_code dir
+ $status = check_and_create_user_files_dir($preferences->backup_unique_code);
+
+ //Now iterate over directories under "users" to check if that user must be
+ //copied to backup
+
+ $rootdir = $CFG->dataroot."/users";
+ //Check if directory exists
+ if (is_dir($rootdir)) {
+ $list = list_directories ($rootdir);
+ if ($list) {
+ //Iterate
+ foreach ($list as $dir) {
+ //Look for dir like username in backup_ids
+ $data = get_record ("backup_ids","backup_code",$preferences->backup_unique_code,
+ "table_name","user",
+ "old_id",$dir);
+ //If exists, copy it
+ if ($data) {
+ $status = backup_copy_file($rootdir."/".$dir,
+ $CFG->dataroot."/temp/backup/".$preferences->backup_unique_code."/user_files/".$dir);
+ }
+ }
+ }
+ }
+ return $status;
+ }
+
+ //This function copies all the course files under the course directory (except the moddata
+ //directory to the "course_files" directory under temp/backup
+ function backup_copy_course_files ($preferences) {
+
+ global $CFG;
+
+ $status = true;
+
+ //First we check to "course_files" exists and create it as necessary
+ //in temp/backup/$backup_code dir
+ $status = check_and_create_course_files_dir($preferences->backup_unique_code);
+
+ //Now iterate over files and directories except $CFG->moddata and get_string("backupdir") to be
+ //copied to backup
+
+ $rootdir = $CFG->dataroot."/".$preferences->backup_course;
+
+ $name_moddata = $CFG->moddata;
+ $name_backupdata = get_string("backupdir");
+ //Check if directory exists
+ if (is_dir($rootdir)) {
+ $list = list_directories_and_files ($rootdir);
+ if ($list) {
+ //Iterate
+ foreach ($list as $dir) {
+ if ($dir !== $name_moddata and $dir !== $name_backupdata) {
+ $status = backup_copy_file($rootdir."/".$dir,
+ $CFG->dataroot."/temp/backup/".$preferences->backup_unique_code."/course_files/".$dir);
+ }
+ }
+ }
+ }
+ return $status;
+ }
+
+ //This function creates the zip file containing all the backup info
+ //moodle.xml, moddata, user_files, course_files.
+ //The zipped file is created in the backup directory and named with
+ //the "oficial" name of the backup
+ //It uses "pclzip" if available or system "zip" (unix only)
+ function backup_zip ($preferences,$moodle_home) {
+
+ global $CFG;
+
+ $status = true;
+
+ //Base dir where everything happens
+ $basedir = $CFG->dataroot."/temp/backup/".$preferences->backup_unique_code;
+ //Backup zip file name
+ $name = $preferences->backup_name;
+ //List base_dir files and directories
+ $filelist = list_directories_and_files ($basedir);
+
+ if (empty($CFG->zip)) { // Use built-in php-based zip function
+ $files = array();
+ foreach ($filelist as $file) {
+ //If directory, append "/"
+ if (is_dir($basedir."/".$file)) {
+ $file = $file."/";
+ }
+ //Include into array
+ $files[] = $basedir."/".$file;
+ }
+ include_once($moodle_home."/lib/pclzip/pclzip.lib.php");
+ $archive = new PclZip("$basedir/$name");
+ if (($list = $archive->create($files,PCLZIP_OPT_REMOVE_PATH,$basedir)) == 0) {
+ error($archive->errorInfo(true));
+ $status = false;
+ }
+ //Debug zip contents
+ //true->do it, false->don't do it. To debug if necessary.
+ if (false) {
+ echo "<br>";
+ $list = $archive->listContent();
+ for ($i=0; $i<sizeof($list); $i++) {
+ for(reset($list[$i]); $key = key($list[$i]); next($list[$i])) {
+ echo "File $i / [$key] = ".$list[$i][$key]."<br>";
+ }
+ echo "<br>";
+ }
+ }
+ } else { // Use external zip program
+ $files = "";
+ foreach ($filelist as $file) {
+ $files .= basename($file);
+ $files .= " ";
+ }
+ $command = "cd $basedir ; $CFG->zip -r $name $files";
+ $status = Exec($command);
+ }
+
+ return $status;
+
+ }
+
+ //This function copies the final zip to the course dir
+ function copy_zip_to_course_dir ($preferences) {
+
+ global $CFG;
+
+ //Backup zip file name
+ $from_zip_file = $CFG->dataroot."/temp/backup/".$preferences->backup_unique_code."/".$preferences->backup_name;
+ $to_zip_file = $CFG->dataroot."/".$preferences->backup_course."/".get_string("backupdir")."/".$preferences->backup_name;
+
+ //Check to directory
+ $status = check_dir_exists(dirname($to_zip_file),true);
+
+ //Copy zip file
+ if ($status) {
+ $status = backup_copy_file ($from_zip_file,$to_zip_file);
+ }
+
+ return $status;
+ }
+?>
projects / moodle.git / commitdiff