MDL-77186 core: Move cron_setup_user to namespaced class

lib/sessionlib.php

@@ -176,61 +176,20 @@ function get_moodle_cookie() {
  *                 value 'reset' means reset internal static caches.
  * @param stdClass $course full course record, null means $SITE
  * @param bool $leavepagealone If specified, stops it messing with global page object
+ * @deprecated since 4.2. Use \core\core::setup_user() instead.
  * @return void
  */
 function cron_setup_user($user = null, $course = null, $leavepagealone = false) {
-    global $CFG, $SITE, $PAGE;
-
-    if (!CLI_SCRIPT && !$leavepagealone) {
-        throw new coding_exception('Function cron_setup_user() cannot be used in normal requests!');
-    }
-
-    static $cronuser    = NULL;
-    static $cronsession = NULL;
+    debugging(
+        'The cron_setup_user() function is deprecated. ' .
+        'Please use \core\cron::setup_user() and reset_user_cache() as appropriate instead.',
+        DEBUG_DEVELOPER
+    );
 
     if ($user === 'reset') {
-        $cronuser = null;
-        $cronsession = null;
-        \core\session\manager::init_empty_session();
+        \core\cron::reset_user_cache();
         return;
     }
 
-    if (empty($cronuser)) {
-        /// ignore admins timezone, language and locale - use site default instead!
-        $cronuser = get_admin();
-        $cronuser->timezone = $CFG->timezone;
-        $cronuser->lang     = '';
-        $cronuser->theme    = '';
-        unset($cronuser->description);
-
-        $cronsession = new stdClass();
-    }
-
-    if (!$user) {
-        // Cached default cron user (==modified admin for now).
-        \core\session\manager::init_empty_session();
-        \core\session\manager::set_user($cronuser);
-        $GLOBALS['SESSION'] = $cronsession;
-
-    } else {
-        // Emulate real user session - needed for caps in cron.
-        if ($GLOBALS['USER']->id != $user->id) {
-            \core\session\manager::init_empty_session();
-            \core\session\manager::set_user($user);
-        }
-    }
-
-    // TODO MDL-19774 relying on global $PAGE in cron is a bad idea.
-    // Temporary hack so that cron does not give fatal errors.
-    if (!$leavepagealone) {
-        $PAGE = new moodle_page();
-        if ($course) {
-            $PAGE->set_course($course);
-        } else {
-            $PAGE->set_course($SITE);
-        }
-    }
-
-    // TODO: it should be possible to improve perf by caching some limited number of users here ;-)
-
+    \core\cron::setup_user($user, $course, $leavepagealone);
 }