Cron management. More...

Collaboration diagram for ilCronManager:

Static Public Member Functions
static	runActiveJobs ()
	Run all active jobs. More...

static	runJobManual ($a_job_id)
	Run single job manually. More...

static	getJobInstanceById ($a_job_id)
	Get job instance (by job id) More...

static	getJobInstance ($a_id, $a_component, $a_class, $a_path=null)
	Get job instance (by job data) More...

static	createDefaultEntry (ilCronJob $a_job, $a_component, $a_class, $a_path)

static	updateFromXML ($a_component, $a_id, $a_class, $a_path=null)
	Process data from module.xml/service.xml. More...

static	clearFromXML ($a_component, array $a_xml_job_ids)
	Clear job data. More...

static	getPluginJobs ($a_only_active=false)

static	getCronJobData ($a_id=null, $a_include_inactive=true)
	Get cron job configuration/execution data. More...

static	resetJob (ilCronJob $a_job)
	Reset job. More...

static	activateJob (ilCronJob $a_job, $a_manual=false)
	Activate cron job. More...

static	deactivateJob (ilCronJob $a_job, $a_manual=false)
	Deactivate cron job. More...

static	isJobActive ($a_job_id)
	Check if given job is currently active. More...

static	isJobInactive ($a_job_id)
	Check if given job is currently inactive. More...

static	updateJobSchedule (ilCronJob $a_job, $a_schedule_type, $a_schedule_value)
	Update job schedule. More...

static	ping ($a_job_id)
	Keep cron job alive. More...

Static Protected Member Functions
static	runJob (ilCronJob $a_job, array $a_job_data=null, $a_manual=false)
	Run single cron job (internal) More...

static	sendNotification (ilCronJob $a_job, $a_message)
	Send notification to admin about job event(s) More...

static	updateJobResult (ilCronJob $a_job, ilCronJobResult $a_result, $a_manual=false)
	Save job result. More...

static	getMicrotime ()
	Get current microtime. More...

Detailed Description

Cron management.

Author: Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Definition at line 11 of file class.ilCronManager.php.

Member Function Documentation

◆ activateJob()

static ilCronManager::activateJob	(	ilCronJob	$a_job,
			$a_manual = `false`
	)

static

Activate cron job.

Parameters

ilCronJob	$a_job
bool	$a_manual

Definition at line 577 of file class.ilCronManager.php.

References $ilDB, $ilUser, ilCronJob\activationWasToggled(), ilCronJob\getId(), and time.

Referenced by ilCronManagerGUI\confirmedActivate().

         {
                 global $ilDB, $ilUser;
                 
                 $user_id = $a_manual ? $ilUser->getId() : 0;
                 
                 $sql = "UPDATE cron_job SET ".
                         " job_status = ".$ilDB->quote(1, "integer").
                         " , job_status_user_id = ".$ilDB->quote($user_id, "integer").
                         " , job_status_type = ".$ilDB->quote($a_manual, "integer").
                         " , job_status_ts = ".$ilDB->quote(time(), "integer"). 
                         " WHERE job_id = ".$ilDB->quote($a_job->getId(), "text");               
                 $ilDB->manipulate($sql);
                 
                 $a_job->activationWasToggled(true);             
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ clearFromXML()

static ilCronManager::clearFromXML	(		$a_component,
		array	$a_xml_job_ids
	)

static

Clear job data.

Parameters

string	$a_component
array	$a_xml_job_ids

Definition at line 416 of file class.ilCronManager.php.

References $ilDB, $ilLog, $row, and array.

Referenced by ilObjDefReader\handlerEndTag().

         {
                 global $ilDB, $ilLog;   
                 
                 if(!$ilDB->tableExists("cron_job"))
                 {
                         return;
                 }
                 
                 // gather existing jobs
                 $all_jobs = array();
                 $sql = "SELECT job_id FROM cron_job".
                         " WHERE component = ".$ilDB->quote($a_component, "text");
                 $set = $ilDB->query($sql);
                 while($row = $ilDB->fetchAssoc($set))
                 {
                         $all_jobs[] = $row["job_id"];
                 }
                 
                 if(sizeof($all_jobs))
                 {
                         if(sizeof($a_xml_job_ids))
                         {
                                 // delete obsolete job data
                                 foreach($all_jobs as $job_id)
                                 {
                                         if(!in_array($job_id, $a_xml_job_ids))
                                         {                               
                                                 $ilDB->manipulate("DELETE FROM cron_job".
                                                         " WHERE component = ".$ilDB->quote($a_component, "text").
                                                         " AND job_id = ".$ilDB->quote($job_id, "text"));        
 
                                                 $ilLog->write("Cron XML - Job ".$job_id." in class ".$a_component.
                                                                 " deleted.");
                                         }
                                 }               
                         }
                         else
                         {               
                                 $ilDB->manipulate("DELETE FROM cron_job".
                                         " WHERE component = ".$ilDB->quote($a_component, "text"));                      
 
                                 $ilLog->write("Cron XML - All jobs deleted for ".$a_component." as component is inactive.");
                         }
                 }
         }

Here is the caller graph for this function:

◆ createDefaultEntry()

static ilCronManager::createDefaultEntry	(	ilCronJob	$a_job,
			$a_component,
			$a_class,
			$a_path
	)

static

Definition at line 323 of file class.ilCronManager.php.

References $ilDB, $ilLog, $ilSetting, $row, ilCronJob\activationWasToggled(), ilCronJob\getDefaultScheduleType(), ilCronJob\getDefaultScheduleValue(), ilCronJob\getId(), ilCronJob\hasAutoActivation(), and ilCronJob\hasFlexibleSchedule().

Referenced by getJobInstanceById(), and getPluginJobs().

         {
                 global $ilDB, $ilLog, $ilSetting;
                 
                 // already exists?                      
                 $sql = "SELECT job_id, schedule_type FROM cron_job".
                         " WHERE component = ".$ilDB->quote($a_component, "text").
                         " AND job_id = ".$ilDB->quote($a_job->getId(), "text");
                 $set = $ilDB->query($sql);
                 $row = $ilDB->fetchAssoc($set);
                 $job_exists = ($row["job_id"] == $a_job->getId());
                 $schedule_type = $row["schedule_type"];
 
                 // new job
                 if(!$job_exists)
                 {                                                       
                         $sql = "INSERT INTO cron_job (job_id, component, class, path)".
                                 " VALUES (".$ilDB->quote($a_job->getId(), "text").", ".
                                 $ilDB->quote($a_component, "text").", ".
                                 $ilDB->quote($a_class, "text").", ".
                                 $ilDB->quote($a_path, "text").")";
                         $ilDB->manipulate($sql);
                         
                         $ilLog->write("Cron XML - Job ".$a_job->getId()." in class ".$a_class.
                                 " added.");
 
                         // only if flexible
                         self::updateJobSchedule($a_job,  
                                 $a_job->getDefaultScheduleType(),
                                 $a_job->getDefaultScheduleValue());
                         
                         // #12221
                         if(!is_object($ilSetting))
                         {
                                 include_once "Services/Administration/classes/class.ilSetting.php";
                                 $ilSetting = new ilSetting();
                         }
 
                         if($a_job->hasAutoActivation())
                         {
                                 self::activateJob($a_job);                                                      
                         }               
                         else            
                         {
                                 // to overwrite dependent settings
                                 $a_job->activationWasToggled(false);    
                         }
                 }       
                 // existing job - but schedule is flexible now
                 else if($a_job->hasFlexibleSchedule() && !$schedule_type)
                 {
                         self::updateJobSchedule($a_job,  
                                 $a_job->getDefaultScheduleType(),
                                 $a_job->getDefaultScheduleValue());
                 }
                 // existing job - but schedule is static now
                 else if(!$a_job->hasFlexibleSchedule() && $schedule_type)
                 {
                         self::updateJobSchedule($a_job, null, null);
                 }               
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deactivateJob()

static ilCronManager::deactivateJob	(	ilCronJob	$a_job,
			$a_manual = `false`
	)

static

Deactivate cron job.

Parameters

ilCronJob	$a_job
bool	$a_manual

Definition at line 600 of file class.ilCronManager.php.

References $ilDB, $ilUser, ilCronJob\activationWasToggled(), ilCronJob\getId(), and time.

Referenced by ilCronManagerGUI\confirmedDeactivate().

         {
                 global $ilDB, $ilUser;
                 
                 $user_id = $a_manual ? $ilUser->getId() : 0;
                 
                 $sql = "UPDATE cron_job SET ".
                         " job_status = ".$ilDB->quote(0, "integer").
                         " , job_status_user_id = ".$ilDB->quote($user_id, "integer").
                         " , job_status_type = ".$ilDB->quote($a_manual, "integer").
                         " , job_status_ts = ".$ilDB->quote(time(), "integer"). 
                         " WHERE job_id = ".$ilDB->quote($a_job->getId(), "text");
                 $ilDB->manipulate($sql);
                                 
                 $a_job->activationWasToggled(false);                            
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getCronJobData()

static ilCronManager::getCronJobData	(	$a_id = `null`,
		$a_include_inactive = `true`
	)

static

Get cron job configuration/execution data.

Parameters

array \| string	$a_id
array	$a_include_inactive

Returns: array

Definition at line 503 of file class.ilCronManager.php.

References $ilDB, $res, $row, array, and IL_COMP_PLUGIN.

Referenced by ilCronManagerGUI\addToExternalSettingsForm(), ilCronDeleteInactiveUserAccounts\calculateDeletionData(), ilCronManagerTableGUI\getItems(), getJobInstanceById(), getPluginJobs(), and ilCronManagerGUI\initEditForm().

         {
                 global $ilDB;
                 
                 $res = array();
                 
                 if($a_id && !is_array($a_id))
                 {
                         $a_id = array($a_id);
                 }       
                 
                 $sql = "SELECT * FROM cron_job";
                 
                 $where = array();
                 if($a_id)
                 {
                         $where[] = $ilDB->in("job_id", $a_id, "", "text");
                 }
                 else
                 {
                         $where[] = "class <> ".$ilDB->quote(IL_COMP_PLUGIN, "text");
                 }
                 if(!$a_include_inactive)
                 {
                         $where[] = "job_status = ".$ilDB->quote(1, "integer");
                 }
                 if(sizeof($where))
                 {
                         $sql .= " WHERE ".implode(" AND ", $where);                     
                 }
                 
                 // :TODO: discuss job execution order
                 $sql .= " ORDER BY job_id";
                 
                 $set = $ilDB->query($sql);
                 while($row = $ilDB->fetchAssoc($set))
                 {
                         $res[] = $row;
                 }
                 
                 return $res;
         }

Here is the caller graph for this function:

◆ getJobInstance()

static ilCronManager::getJobInstance	(	$a_id,
		$a_component,
		$a_class,
		$a_path = `null`
	)

static

Get job instance (by job data)

Parameters

string	$a_component
string	$a_class
string	$a_path

Returns: ilCronJob

Definition at line 267 of file class.ilCronManager.php.

References $ilLog.

Referenced by ilCronManagerGUI\addToExternalSettingsForm(), and ilCronManagerTableGUI\getItems().

         {
                 global $ilLog;
                 
                 if(!$a_path)
                 {
                         $a_path = $a_component."/classes/";
                 }               
                 $class_file = $a_path."class.".$a_class.".php";                                                 
                 if(file_exists($class_file))
                 {                                                                               
                         include_once $class_file;
                         if(class_exists($a_class))
                         {                               
                                 $job = new $a_class();                          
                                 if($job instanceof ilCronJob)
                                 {
                                         if($job->getId() == $a_id)
                                         {
                                                 return $job;
                                         }
                                         else
                                         {
                                                 $mess .= " - job id mismatch";
                                         }
                                 }
                                 else
                                 {
                                         $mess .= " - does not extend ilCronJob";
                                 }
                         }
                         else
                         {
                                 $mess = "- class not found in file";
                         }
                 }
                 else
                 {
                         $mess = " - class file not found";
                 }
                 
                 $ilLog->write("Cron XML - Job ".$a_id." in class ".$a_class." (".
                         $class_file.") is invalid.".$mess);
         }

Here is the caller graph for this function:

◆ getJobInstanceById()

static ilCronManager::getJobInstanceById ( $a_job_id )

static

Get job instance (by job id)

Parameters

string $a_job_id

Returns: ilCronJob

Definition at line 216 of file class.ilCronManager.php.

References $ilLog, createDefaultEntry(), getCronJobData(), IL_COMP_PLUGIN, and IL_COMP_SERVICE.

Referenced by ilCronManagerGUI\getMultiActionData(), ilCronManagerGUI\initEditForm(), and ilCronManagerGUI\update().

         {
                 global $ilLog, $ilPluginAdmin;
                                 
                 // plugin
                 if(substr($a_job_id, 0, 4) == "pl__")
                 {
                         $parts = explode("__", $a_job_id);
                         $pl_name = $parts[1];
                         $job_id = $parts[2];                    
                         if($ilPluginAdmin->isActive(IL_COMP_SERVICE, "Cron", "crnhk", $pl_name))
                         {
                 $plugin_obj = $ilPluginAdmin->getPluginObject(IL_COMP_SERVICE, 
                                         "Cron", "crnhk", $pl_name);                     
                                 $job = $plugin_obj->getCronJobInstance($job_id);
                                 if($job instanceof ilCronJob)
                                 {
                                         // should never happen but who knows...
                                         if(!sizeof(ilCronManager::getCronJobData($job_id)))
                                         {                                               
                                                 // as job is not "imported" from xml
                                                 ilCronManager::createDefaultEntry($job, $pl_name, IL_COMP_PLUGIN, "");
                                         }                                       
                                         return $job;
                                 }                               
                         }
                         
                         return null;
                 }
                 // system
                 else
                 {
                         $job_data = array_pop(self::getCronJobData($a_job_id));
                         if($job_data["job_id"] == $a_job_id)
                         {
                                 return self::getJobInstance($job_data["job_id"], $job_data["component"], 
                                         $job_data["class"], $job_data["path"]);                         
                         }
                 }
                 
                 $ilLog->write("CRON - job ".$a_job_id." seems invalid or is inactive");         
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getMicrotime()

static ilCronManager::getMicrotime ( )

staticprotected

Get current microtime.

Returns: float

Definition at line 702 of file class.ilCronManager.php.

         {       
                 list($usec, $sec) = explode(" ", microtime());
                 return ((float)$usec + (float)$sec);
         }

◆ getPluginJobs()

static ilCronManager::getPluginJobs ( $a_only_active = false )

static

Definition at line 463 of file class.ilCronManager.php.

References $res, array, createDefaultEntry(), getCronJobData(), IL_COMP_PLUGIN, and IL_COMP_SERVICE.

Referenced by ilCronManagerTableGUI\getItems().

         {
                 global $ilPluginAdmin;
                 
                 $res = array();
                 
                 foreach($ilPluginAdmin->getActivePluginsForSlot(IL_COMP_SERVICE, "Cron", "crnhk") as $pl_name)
                 {
                         $plugin_obj = $ilPluginAdmin->getPluginObject(IL_COMP_SERVICE, "Cron", "crnhk", $pl_name);
                                                                 
                         foreach((array)$plugin_obj->getCronJobInstances() as $job)
                         {                               
                                 $item = array_pop(ilCronManager::getCronJobData($job->getId()));                                        
                                 if(!sizeof($item))
                                 {                                               
                                         // as job is not "imported" from xml
                                         ilCronManager::createDefaultEntry($job, $pl_name, IL_COMP_PLUGIN, "");
                                 }               
                                 
                                 $item = array_pop(ilCronManager::getCronJobData($job->getId()));        
                                 
                                 // #17941
                                 if(!$a_only_active ||
                                         $item["job_status"] == 1)
                                 {
                                         $res[$job->getId()] = array($job, $item);       
                                 }
                         }                       
                 }
                 
                 return $res;
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isJobActive()

static ilCronManager::isJobActive ( $a_job_id )

static

Check if given job is currently active.

Parameters

string $a_job_id

Returns: boolean

Definition at line 623 of file class.ilCronManager.php.

Referenced by ilCronManagerGUI\confirmedDeactivate(), ilCronManagerGUI\confirmedReset(), ilObjForumAdministrationGUI\editSettings(), ilObjForumAdministrationGUI\getSettingsForm(), ilObjContentObjectGUI\linkChecker(), and ilLPObjectStatisticsGUI\showCronJobInfo().

         {
                 $job = self::getCronJobData($a_job_id);
                 if((bool)$job[0]["job_status"])
                 {
                         return true;
                 }
                 return false;
         }

Here is the caller graph for this function:

◆ isJobInactive()

static ilCronManager::isJobInactive ( $a_job_id )

static

Check if given job is currently inactive.

Parameters

string $a_job_id

Returns: boolean

Definition at line 639 of file class.ilCronManager.php.

Referenced by ilCronManagerGUI\confirmedActivate().

         {
                 $job = self::getCronJobData($a_job_id);
                 if(!(bool)$job[0]["job_status"])
                 {
                         return true;
                 }
                 return false;
         }

Here is the caller graph for this function:

◆ ping()

static ilCronManager::ping ( $a_job_id )

static

Keep cron job alive.

Parameters

string $a_job_id

Definition at line 713 of file class.ilCronManager.php.

References $ilDB, and time.

Referenced by ilLPCronObjectStatistics\gatherCourseLPData(), ilLPCronObjectStatistics\gatherTypesData(), ilLPCronObjectStatistics\gatherUserData(), ilForumCronNotification\keepAlive(), ilMembershipCronNotifications\run(), and ilLDAPCronSynchronization\run().

         {
                 global $ilDB;
                 
                 $ilDB->manipulate("UPDATE cron_job SET ".
                         " alive_ts = ".$ilDB->quote(time(), "integer").
                         " WHERE job_id = ".$ilDB->quote($a_job_id, "text"));
         }

Here is the caller graph for this function:

◆ resetJob()

static ilCronManager::resetJob ( ilCronJob $a_job )

static

Reset job.

Parameters

ilCronJob $a_job

Definition at line 551 of file class.ilCronManager.php.

References $ilDB, $result, ilCronJobResult\CODE_MANUAL_RESET, ilCronJob\getId(), and ilCronJobResult\STATUS_RESET.

Referenced by ilCronManagerGUI\confirmedActivate(), and ilCronManagerGUI\confirmedReset().

         {
                 global $ilDB;
                 
                 include_once "Services/Cron/classes/class.ilCronJobResult.php";
                 $result = new ilCronJobResult();
                 $result->setStatus(ilCronJobResult::STATUS_RESET);
                 $result->setCode(ilCronJobResult::CODE_MANUAL_RESET);
                 $result->setMessage("Cron job re-activated by admin");          
                 self::updateJobResult($a_job, $result, true);
                                 
                 $ilDB->manipulate("UPDATE cron_job".
                         " SET running_ts = ".$ilDB->quote(0, "integer").
                         " , alive_ts = ".$ilDB->quote(0, "integer").
                         " , job_result_ts = ".$ilDB->quote(0, "integer").
                         " WHERE job_id = ".$ilDB->quote($a_job->getId(), "text"));              
                 
                 self::activateJob($a_job, true);
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ runActiveJobs()

static ilCronManager::runActiveJobs ( )

static

Run all active jobs.

Definition at line 16 of file class.ilCronManager.php.

References $ilLog, $ilSetting, $row, ilUtil\_getHttpPath(), defined, and time.

         {
                 global $ilLog, $ilSetting;
                 
                 // separate log for cron
                 // $this->log->setFilename($_COOKIE["ilClientId"]."_cron.txt");
                 
                 $ilLog->write("CRON - batch start");
                 
                 $ilSetting->set("last_cronjob_start_ts", time());
                 
                 // ilLink::_getStaticLink() should work in crons
                 if(!defined("ILIAS_HTTP_PATH"))
                 {
                         define("ILIAS_HTTP_PATH", ilUtil::_getHttpPath());
                 }
                 
                 // system
                 foreach(self::getCronJobData(null, false) as $row)
                 {                                       
                         $job = self::getJobInstanceById($row["job_id"]);
                         if($job)
                         {
                                 // #18411 - we are NOT using the initial job data as it might be outdated at this point
                                 self::runJob($job);
                         }
                 }
                 
                 // plugins
                 foreach(self::getPluginJobs(true) as $item)
                 {
                         self::runJob($item[0], $item[1]);
                 }               
                 
                 $ilLog->write("CRON - batch end");
         }

Here is the call graph for this function:

◆ runJob()

static ilCronManager::runJob	(	ilCronJob	$a_job,
		array	$a_job_data = `null`,
			$a_manual = `false`
	)

staticprotected

Run single cron job (internal)

Parameters

ilCronJob	$a_job
array	$a_job_data
bool	$a_manual

Returns: boolean

Definition at line 97 of file class.ilCronManager.php.

References $ilDB, $ilLog, $result, ilCronJobResult\CODE_NO_RESULT, ilCronJobResult\CODE_SUPPOSED_CRASH, ilCronJob\getId(), ilCronJob\isActive(), ilCronJob\run(), ilCronJobResult\STATUS_CRASHED, ilCronJobResult\STATUS_INVALID_CONFIGURATION, and time.

         {
                 global $ilLog, $ilDB;
                 
                 $did_run = false;                               
                                 
                 include_once "Services/Cron/classes/class.ilCronJobResult.php";         
                 
                 if($a_job_data === null)
                 {
                         // aquire "fresh" job (status) data
                         $a_job_data = array_pop(self::getCronJobData($a_job->getId()));
                 }
 
                 // already running?
                 if($a_job_data["alive_ts"])
                 {
                         $ilLog->write("CRON - job ".$a_job_data["job_id"]." still running");
 
                         $cut = 60*60*3; // 3h                           
 
                         // is running (and has not pinged) for 3 hours straight, we assume it crashed
                         if(time()-$a_job_data["alive_ts"] > $cut)
                         {
                                 $ilDB->manipulate("UPDATE cron_job SET".
                                         " running_ts = ".$ilDB->quote(0, "integer").
                                         " , alive_ts = ".$ilDB->quote(0, "integer").                                                    
                                         " WHERE job_id = ".$ilDB->quote($a_job_data["job_id"], "text"));
 
                                 self::deactivateJob($a_job); // #13082
 
                                 $result = new ilCronJobResult();
                                 $result->setStatus(ilCronJobResult::STATUS_CRASHED);
                                 $result->setCode(ilCronJobResult::CODE_SUPPOSED_CRASH);
                                 $result->setMessage("Cron job deactivated because it has been inactive for 3 hours");
 
                                 if(!$a_manual)
                                 {
                                         self::sendNotification($a_job, $result);
                                 }
 
                                 self::updateJobResult($a_job, $result, $a_manual);                                                      
 
                                 $ilLog->write("CRON - job ".$a_job_data["job_id"]." deactivated (assumed crash)");
                         }               
                 }
                 // initiate run?
                 else if($a_job->isActive($a_job_data["job_result_ts"], 
                         $a_job_data["schedule_type"], $a_job_data["schedule_value"], $a_manual))
                 {
                         $ilLog->write("CRON - job ".$a_job_data["job_id"]." started");
 
                         $ilDB->manipulate("UPDATE cron_job SET".
                                 " running_ts = ".$ilDB->quote(time(), "integer").
                                 " , alive_ts = ".$ilDB->quote(time(), "integer").
                                 " WHERE job_id = ".$ilDB->quote($a_job_data["job_id"], "text"));
 
                         $ts_in = self::getMicrotime();                                  
                         $result = $a_job->run();
                         $ts_dur = self::getMicrotime()-$ts_in;
 
                         // no proper result 
                         if(!$result instanceof ilCronJobResult)
                         {
                                 $result = new ilCronJobResult();
                                 $result->setStatus(ilCronJobResult::STATUS_CRASHED);
                                 $result->setCode(ilCronJobResult::CODE_NO_RESULT);
                                 $result->setMessage("Cron job did not return a proper result");
 
                                 if(!$a_manual)
                                 {
                                         self::sendNotification($a_job, $result);
                                 }
 
                                 $ilLog->write("CRON - job ".$a_job_data["job_id"]." no result");
                         }
                         // no valid configuration, job won't work
                         else if($result->getStatus() == ilCronJobResult::STATUS_INVALID_CONFIGURATION)
                         {
                                 self::deactivateJob($a_job);
 
                                 if(!$a_manual)
                                 {
                                         self::sendNotification($a_job, $result);        
                                 }
 
                                 $ilLog->write("CRON - job ".$a_job_data["job_id"]." invalid configuration");
                         }
                         // success!
                         else
                         {
                                 $did_run = true;
                         }
 
                         $result->setDuration($ts_dur);
 
                         self::updateJobResult($a_job, $result, $a_manual);
 
                         $ilDB->manipulate("UPDATE cron_job SET".
                                 " running_ts = ".$ilDB->quote(0, "integer").
                                 " , alive_ts = ".$ilDB->quote(0, "integer").
                                 " WHERE job_id = ".$ilDB->quote($a_job_data["job_id"], "text"));                
 
                         $ilLog->write("CRON - job ".$a_job_data["job_id"]." finished");
                 }
                 else
                 {
                         $ilLog->write("CRON - job ".$a_job_data["job_id"]." returned status inactive");
                 }                               
                 
                 return $did_run;
         }

Here is the call graph for this function:

◆ runJobManual()

static ilCronManager::runJobManual ( $a_job_id )

static

Run single job manually.

Parameters

string $a_job_id

Returns: bool

Definition at line 59 of file class.ilCronManager.php.

References $ilLog, and $result.

Referenced by ilCronManagerGUI\confirmedRun().

         {
                 global $ilLog;
                 
                 $result = false;
                 
                 $ilLog->write("CRON - manual start (".$a_job_id.")");
                 
                 $job = self::getJobInstanceById($a_job_id);             
                 if($job)
                 {                       
                         if($job->isManuallyExecutable())
                         {                               
                                 $result = self::runJob($job, null, true);
                         }
                         else
                         {
                                 $ilLog->write("CRON - job ".$a_job_id." is not intended to be executed manually");
                         }
                 }
                 else
                 {
                         $ilLog->write("CRON - job ".$a_job_id." seems invalid or is inactive");
                 }
                 
                 $ilLog->write("CRON - manual end (".$a_job_id.")");
                 
                 return $result;
         }

Here is the caller graph for this function:

◆ sendNotification()

static ilCronManager::sendNotification	(	ilCronJob	$a_job,
			$a_message
	)

staticprotected

Send notification to admin about job event(s)

Parameters

ilCronJob	$a_job
string	$a_message

Definition at line 318 of file class.ilCronManager.php.

         {
                 // :TODO:
         }       

◆ updateFromXML()

static ilCronManager::updateFromXML	(	$a_component,
		$a_id,
		$a_class,
		$a_path = `null`
	)

static

Process data from module.xml/service.xml.

Parameters

string	$a_component
string	$a_id
string	$a_class
string	$_path

Definition at line 393 of file class.ilCronManager.php.

References $ilDB.

Referenced by ilObjDefReader\handlerBeginTag().

         {               
                 global $ilDB;
                 
                 if(!$ilDB->tableExists("cron_job"))
                 {
                         return;
                 }
                 
                 // only if job seems valid
                 $job = self::getJobInstance($a_id, $a_component, $a_class, $a_path);
                 if($job)
                 {       
                         self::createDefaultEntry($job, $a_component, $a_class, $a_path);
                 }                                                                                               
         }

Here is the caller graph for this function:

◆ updateJobResult()

static ilCronManager::updateJobResult	(	ilCronJob	$a_job,
		ilCronJobResult	$a_result,
			$a_manual = `false`
	)

staticprotected

Save job result.

Parameters

ilCronJob	$a_job
ilCronJobResult	$a_result
bool	$a_manual

Definition at line 656 of file class.ilCronManager.php.

References $ilDB, $ilUser, ilCronJobResult\getCode(), ilCronJobResult\getDuration(), ilCronJob\getId(), ilCronJobResult\getMessage(), ilCronJobResult\getStatus(), and time.

         {
                 global $ilDB, $ilUser;
                 
                 $user_id = $a_manual ? $ilUser->getId() : 0;
                 
                 $sql = "UPDATE cron_job SET ".
                         " job_result_status = ".$ilDB->quote($a_result->getStatus(), "integer").
                         " , job_result_user_id = ".$ilDB->quote($user_id, "integer").
                         " , job_result_code = ".$ilDB->quote($a_result->getCode(), "text").
                         " , job_result_message = ".$ilDB->quote($a_result->getMessage(), "text"). 
                         " , job_result_type = ".$ilDB->quote($a_manual, "integer"). 
                         " , job_result_ts = ".$ilDB->quote(time(), "integer"). 
                         " , job_result_dur = ".$ilDB->quote($a_result->getDuration()*1000, "integer").
                         " WHERE job_id = ".$ilDB->quote($a_job->getId(), "text");               
                 $ilDB->manipulate($sql);
         }

Here is the call graph for this function:

◆ updateJobSchedule()

static ilCronManager::updateJobSchedule	(	ilCronJob	$a_job,
			$a_schedule_type,
			$a_schedule_value
	)

static

Update job schedule.

Parameters

ilCronJob	$a_job
int	$a_schedule_type
int	$a_schedule_value

Definition at line 681 of file class.ilCronManager.php.

References $ilDB, ilCronJob\getId(), ilCronJob\getValidScheduleTypes(), and ilCronJob\hasFlexibleSchedule().

Referenced by ilCronManagerTableGUI\parseJobToData(), and ilCronManagerGUI\update().

         {
                 global $ilDB;
                 
                 if($a_schedule_type === null ||
                         ($a_job->hasFlexibleSchedule() && 
                                 in_array($a_schedule_type, $a_job->getValidScheduleTypes())))
                 {
                         $sql = "UPDATE cron_job SET ".
                                 " schedule_type = ".$ilDB->quote($a_schedule_type, "integer").
                                 " , schedule_value = ".$ilDB->quote($a_schedule_value, "integer").
                                 " WHERE job_id = ".$ilDB->quote($a_job->getId(), "text");
                         $ilDB->manipulate($sql);
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

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

Services/Cron/classes/class.ilCronManager.php

Static Public Member Functions

Static Protected Member Functions

Detailed Description

Member Function Documentation

◆ activateJob()

◆ clearFromXML()

◆ createDefaultEntry()

◆ deactivateJob()

◆ getCronJobData()

◆ getJobInstance()

◆ getJobInstanceById()

◆ getMicrotime()

◆ getPluginJobs()

◆ isJobActive()

◆ isJobInactive()

◆ ping()

◆ resetJob()

◆ runActiveJobs()

◆ runJob()

◆ runJobManual()

◆ sendNotification()

◆ updateFromXML()

◆ updateJobResult()

◆ updateJobSchedule()