Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.2.x will end 22 April 2024 (12 months).
  • Bug fixes for security issues in 4.2.x will end 7 October 2024 (18 months).
  • PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.1.x is supported too.
/admin/ -> cron.php (source)

Differences Between: [Versions 310 and 402] [Versions 311 and 402] [Versions 39 and 402] [Versions 400 and 402] [Versions 401 and 402]

   1  <?php
   2  // This file is part of Moodle - http://moodle.org/
   3  //
   4  // Moodle is free software: you can redistribute it and/or modify
   5  // it under the terms of the GNU General Public License as published by
   6  // the Free Software Foundation, either version 3 of the License, or
   7  // (at your option) any later version.
   8  //
   9  // Moodle is distributed in the hope that it will be useful,
  10  // but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  // GNU General Public License for more details.
  13  //
  14  // You should have received a copy of the GNU General Public License
  15  // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
  16  
  17  /**
  18   * Web cron
  19   *
  20   * This script looks through all the module directories for cron.php files
  21   * and runs them.  These files can contain cleanup functions, email functions
  22   * or anything that needs to be run on a regular basis.
  23   *
  24   * This file is best run from cron on the host system (ie outside PHP).
  25   * It is strongly recommended to add password protection via admin settings.
  26   *
  27   * eg   wget -q -O /dev/null 'http: *moodle.somewhere.edu/admin/cron.php?password=SeCreT666'
  28   *
  29   * It is also possible to use CLI script admin/cli/cron.php instead,
  30   * you can not call this script from command line any more.
  31   *
  32   * @package    core
  33   * @subpackage admin
  34   * @copyright  1999 onwards Martin Dougiamas  http://dougiamas.com
  35   * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  36   */
  37  
  38  // phpcs:ignoreFile moodle.Files.MoodleInternal.MoodleInternalGlobalState
  39  
  40  if (defined('STDIN')) {
  41      fwrite(STDERR, "ERROR: This script no longer supports CLI, please use admin/cli/cron.php instead\n");
  42      exit(1);
  43  }
  44  
  45  // This is a fake CLI script, it is a really ugly hack which emulates
  46  // CLI via web interface, please do not use this hack elsewhere
  47  define('CLI_SCRIPT', true);
  48  define('WEB_CRON_EMULATED_CLI', 'defined'); // ugly ugly hack, do not use elsewhere please
  49  define('NO_OUTPUT_BUFFERING', true);
  50  
  51  require('../config.php');
  52  require_once($CFG->libdir . '/clilib.php');
  53  
  54  // extra safety
  55  \core\session\manager::write_close();
  56  
  57  // check if execution allowed
  58  if (!empty($CFG->cronclionly)) {
  59      // This script can only be run via the cli.
  60      throw new \moodle_exception('cronerrorclionly', 'admin');
  61      exit;
  62  }
  63  // This script is being called via the web, so check the password if there is one.
  64  if (!empty($CFG->cronremotepassword)) {
  65      $pass = optional_param('password', '', PARAM_RAW);
  66      if ($pass != $CFG->cronremotepassword) {
  67          // wrong password.
  68          throw new \moodle_exception('cronerrorpassword', 'admin');
  69          exit;
  70      }
  71  }
  72  
  73  // Send mime type and encoding.
  74  @header('Content-Type: text/plain; charset=utf-8');
  75  
  76  // We do not want html markup in emulated CLI.
  77  @ini_set('html_errors', 'off');
  78  
  79  // Execute the cron, disabling keepalive.
  80  \core\cron::run_main_process(0);