nc/nextcloud/cron.php

<?php

declare(strict_types=1);

/**
 * @copyright Copyright (c) 2016, ownCloud, Inc.
 *
 * @author Artem Sidorenko <artem@posteo.de>
 * @author Christopher Schäpers <kondou@ts.unde.re>
 * @author Christoph Wurst <christoph@winzerhof-wurst.at>
 * @author Côme Chilliet <come.chilliet@nextcloud.com>
 * @author Daniel Kesselberg <mail@danielkesselberg.de>
 * @author hoellen <dev@hoellen.eu>
 * @author J0WI <J0WI@users.noreply.github.com>
 * @author Jakob Sack <mail@jakobsack.de>
 * @author Joas Schilling <coding@schilljs.com>
 * @author Jörn Friedrich Dreyer <jfd@butonic.de>
 * @author Ko- <k.stoffelen@cs.ru.nl>
 * @author Michael Kuhn <michael@ikkoku.de>
 * @author Morris Jobke <hey@morrisjobke.de>
 * @author Oliver Kohl D.Sc. <oliver@kohl.bz>
 * @author Robin Appelman <robin@icewind.nl>
 * @author Roeland Jago Douma <roeland@famdouma.nl>
 * @author Steffen Lindner <mail@steffen-lindner.de>
 * @author Thomas Müller <thomas.mueller@tmit.eu>
 * @author Vincent Petry <vincent@nextcloud.com>
 * @author Stephen Michel <git@smichel.me>
 *
 * @license AGPL-3.0
 *
 * This code is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License, version 3,
 * as published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License, version 3,
 * along with this program. If not, see <http://www.gnu.org/licenses/>
 *
 */

require_once __DIR__ . '/lib/versioncheck.php';

use OCP\App\IAppManager;
use OCP\BackgroundJob\IJobList;
use OCP\IAppConfig;
use OCP\IConfig;
use OCP\ISession;
use OCP\ITempManager;
use OCP\Server;
use OCP\Util;
use Psr\Log\LoggerInterface;

try {
    require_once __DIR__ . '/lib/base.php';

    if (Util::needUpgrade()) {
        Server::get(LoggerInterface::class)->debug('Update required, skipping cron', ['app' => 'cron']);
        exit;
    }

    $config = Server::get(IConfig::class);

    if ($config->getSystemValueBool('maintenance', false)) {
        Server::get(LoggerInterface::class)->debug('We are in maintenance mode, skipping cron', ['app' => 'cron']);
        exit;
    }

    // Don't do anything if Nextcloud has not been installed
    if (!$config->getSystemValueBool('installed', false)) {
        exit(0);
    }

    // load all apps to get all api routes properly setup
    Server::get(IAppManager::class)->loadApps();

    Server::get(ISession::class)->close();

    // initialize a dummy memory session
    $session = new \OC\Session\Memory();
    $cryptoWrapper = \OC::$server->getSessionCryptoWrapper();
    $session = $cryptoWrapper->wrapSession($session);
    \OC::$server->setSession($session);

    $logger = Server::get(LoggerInterface::class);
    $appConfig = Server::get(IAppConfig::class);
    $tempManager = Server::get(ITempManager::class);

    $tempManager->cleanOld();

    // Exit if background jobs are disabled!
    $appMode = $appConfig->getValueString('core', 'backgroundjobs_mode', 'ajax');
    if ($appMode === 'none') {
        if (OC::$CLI) {
            echo 'Background Jobs are disabled!' . PHP_EOL;
        } else {
            OC_JSON::error(['data' => ['message' => 'Background jobs disabled!']]);
        }
        exit(1);
    }

    if (OC::$CLI) {
        // set to run indefinitely if needed
        if (strpos(@ini_get('disable_functions'), 'set_time_limit') === false) {
            @set_time_limit(0);
        }

        // the cron job must be executed with the right user
        if (!function_exists('posix_getuid')) {
            echo "The posix extensions are required - see https://www.php.net/manual/en/book.posix.php" . PHP_EOL;
            exit(1);
        }

        $user = posix_getuid();
        $configUser = fileowner(OC::$configDir . 'config.php');
        if ($user !== $configUser) {
            echo "Console has to be executed with the user that owns the file config/config.php" . PHP_EOL;
            echo "Current user id: " . $user . PHP_EOL;
            echo "Owner id of config.php: " . $configUser . PHP_EOL;
            exit(1);
        }


        // We call Nextcloud from the CLI (aka cron)
        if ($appMode !== 'cron') {
            $appConfig->setValueString('core', 'backgroundjobs_mode', 'cron');
        }

        // Low-load hours
        $onlyTimeSensitive = false;
        $startHour = $config->getSystemValueInt('maintenance_window_start', 100);
        if ($startHour <= 23) {
            $date = new \DateTime('now', new \DateTimeZone('UTC'));
            $currentHour = (int) $date->format('G');
            $endHour = $startHour + 4;

            if ($startHour <= 20) {
                // Start time: 01:00
                // End time: 05:00
                // Only run sensitive tasks when it's before the start or after the end
                $onlyTimeSensitive = $currentHour < $startHour || $currentHour > $endHour;
            } else {
                // Start time: 23:00
                // End time: 03:00
                $endHour -= 24; // Correct the end time from 27:00 to 03:00
                // Only run sensitive tasks when it's after the end and before the start
                $onlyTimeSensitive = $currentHour > $endHour && $currentHour < $startHour;
            }
        }

        // Work
        $jobList = Server::get(IJobList::class);

        // We only ask for jobs for 14 minutes, because after 5 minutes the next
        // system cron task should spawn and we want to have at most three
        // cron jobs running in parallel.
        $endTime = time() + 14 * 60;

        $executedJobs = [];
        while ($job = $jobList->getNext($onlyTimeSensitive)) {
            if (isset($executedJobs[$job->getId()])) {
                $jobList->unlockJob($job);
                break;
            }

            $jobDetails = get_class($job) . ' (id: ' . $job->getId() . ', arguments: ' . json_encode($job->getArgument()) . ')';
            $logger->debug('CLI cron call has selected job ' . $jobDetails, ['app' => 'cron']);

            $timeBefore = time();
            $memoryBefore = memory_get_usage();
            $memoryPeakBefore = memory_get_peak_usage();

            /** @psalm-suppress DeprecatedMethod Calling execute until it is removed, then will switch to start */
            $job->execute($jobList);

            $timeAfter = time();
            $memoryAfter = memory_get_usage();
            $memoryPeakAfter = memory_get_peak_usage();

            $cronInterval = 5 * 60;
            $timeSpent = $timeAfter - $timeBefore;
            if ($timeSpent > $cronInterval) {
                $logLevel = match (true) {
                    $timeSpent > $cronInterval * 128 => \OCP\ILogger::FATAL,
                    $timeSpent > $cronInterval * 64 => \OCP\ILogger::ERROR,
                    $timeSpent > $cronInterval * 16 => \OCP\ILogger::WARN,
                    $timeSpent > $cronInterval * 8 => \OCP\ILogger::INFO,
                    default => \OCP\ILogger::DEBUG,
                };
                $logger->log(
                    $logLevel,
                    'Background job ' . $jobDetails . ' ran for ' . $timeSpent . ' seconds',
                    ['app' => 'cron']
                );
            }

            if ($memoryAfter - $memoryBefore > 50_000_000) {
                $logger->warning('Used memory grew by more than 50 MB when executing job ' . $jobDetails . ': ' . Util::humanFileSize($memoryAfter). ' (before: ' . Util::humanFileSize($memoryBefore) . ')', ['app' => 'cron']);
            }
            if ($memoryPeakAfter > 300_000_000 && $memoryPeakBefore <= 300_000_000) {
                $logger->warning('Cron job used more than 300 MB of ram after executing job ' . $jobDetails . ': ' . Util::humanFileSize($memoryPeakAfter) . ' (before: ' . Util::humanFileSize($memoryPeakBefore) . ')', ['app' => 'cron']);
            }

            // clean up after unclean jobs
            Server::get(\OC\Files\SetupManager::class)->tearDown();
            $tempManager->clean();

            $jobList->setLastJob($job);
            $executedJobs[$job->getId()] = true;
            unset($job);

            if ($timeAfter > $endTime) {
                break;
            }
        }
    } else {
        // We call cron.php from some website
        if ($appMode === 'cron') {
            // Cron is cron :-P
            OC_JSON::error(['data' => ['message' => 'Backgroundjobs are using system cron!']]);
        } else {
            // Work and success :-)
            $jobList = Server::get(IJobList::class);
            $job = $jobList->getNext();
            if ($job != null) {
                $logger->debug('WebCron call has selected job with ID ' . strval($job->getId()), ['app' => 'cron']);
                /** @psalm-suppress DeprecatedMethod Calling execute until it is removed, then will switch to start */
                $job->execute($jobList);
                $jobList->setLastJob($job);
            }
            OC_JSON::success();
        }
    }

    // Log the successful cron execution
    $appConfig->setValueInt('core', 'lastcron', time());
    exit();
} catch (Exception $ex) {
    Server::get(LoggerInterface::class)->error(
        $ex->getMessage(),
        ['app' => 'cron', 'exception' => $ex]
    );
    echo $ex . PHP_EOL;
    exit(1);
} catch (Error $ex) {
    Server::get(LoggerInterface::class)->error(
        $ex->getMessage(),
        ['app' => 'cron', 'exception' => $ex]
    );
    echo $ex . PHP_EOL;
    exit(1);
}