CronCommandTest.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Scheduler\Tests\Unit\CronCommand;

/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */

use TYPO3\CMS\Scheduler\CronCommand\CronCommand;

class CronCommandTest extends \TYPO3\TestingFramework\Core\Unit\UnitTestCase
{
    const TIMESTAMP = 1262304000;

    protected $timezoneBackup = '';

    protected function setUp()
    {
        $this->timezoneBackup = date_default_timezone_get();
        date_default_timezone_set('UTC');
    }

    protected function tearDown()
    {
        date_default_timezone_set($this->timezoneBackup);
        parent::tearDown();
    }

    public function constructorSetsNormalizedCronCommandSections()
    {
        $instance = new CronCommand('2-3 * * * *');
        $this->assertSame(['2,3', '*', '*', '*', '*'], $instance->getCronCommandSections());
    }

    public function constructorThrowsExceptionForInvalidCronCommand()
    {
        $this->expectException(\InvalidArgumentException::class);
        $this->expectExceptionCode(1291470170);
        new CronCommand('61 * * * *');
    }

    public function constructorSetsTimestampToNowPlusOneMinuteRoundedDownToSixtySeconds()
    {
        $instance = new CronCommand('* * * * *');
        $currentTime = time();
        $expectedTime = $currentTime - ($currentTime % 60) + 60;
        $this->assertSame($expectedTime, $instance->getTimestamp());
    }

    public function constructorSetsTimestampToGivenTimestampPlusSixtySeconds()
    {
        $instance = new CronCommand('* * * * *', self::TIMESTAMP);
        $this->assertSame(self::TIMESTAMP + 60, $instance->getTimestamp());
    }

    public function constructorSetsTimestampToGiveTimestampRoundedDownToSixtySeconds()
    {
        $instance = new CronCommand('* * * * *', self::TIMESTAMP + 1);
        $this->assertSame(self::TIMESTAMP + 60, $instance->getTimestamp());
    }

    public static function expectedTimestampDataProvider()
    {
        return [
            'every minute' => [
                '* * * * *',
                self::TIMESTAMP,
                self::TIMESTAMP + 60,
                self::TIMESTAMP + 120
            ],
            'once an hour at 1' => [
                '1 * * * *',
                self::TIMESTAMP,
                self::TIMESTAMP + 60,
                self::TIMESTAMP + 60 + 60 * 60
            ],
            'once an hour at 0' => [
                '0 * * * *',
                self::TIMESTAMP,
                self::TIMESTAMP + 60 * 60,
                self::TIMESTAMP + 60 * 60 + 60 * 60
            ],
            'once a day at 1:00' => [
                '0 1 * * *',
                self::TIMESTAMP,
                self::TIMESTAMP + 60 * 60,
                self::TIMESTAMP + 60 * 60 + 60 * 60 * 24
            ],
            'once a day at 0:00' => [
                '0 0 * * *',
                self::TIMESTAMP,
                self::TIMESTAMP + 60 * 60 * 24,
                self::TIMESTAMP + 60 * 60 * 24 * 2
            ],
            'once a month' => [
                '0 0 4 * *',
                self::TIMESTAMP,
                self::TIMESTAMP + 60 * 60 * 24 * 3,
                self::TIMESTAMP + 60 * 60 * 24 * 3 + 60 * 60 * 24 * 31
            ],
            'once every Saturday' => [
                '0 0 * * sat',
                self::TIMESTAMP,
                self::TIMESTAMP + 60 * 60 * 24,
                self::TIMESTAMP + 60 * 60 * 24 + 60 * 60 * 24 * 7
            ],
            'once every day in February' => [
                '0 0 * feb *',
                self::TIMESTAMP,
                self::TIMESTAMP + 60 * 60 * 24 * 31,
                self::TIMESTAMP + 60 * 60 * 24 * 31 + 60 * 60 * 24
            ],
            'day of week and day of month restricted, next match in day of month field' => [
                '0 0 2 * sun',
                self::TIMESTAMP,
                self::TIMESTAMP + 60 * 60 * 24,
                self::TIMESTAMP + 60 * 60 * 24 + 60 * 60 * 24
            ],
            'day of week and day of month restricted, next match in day of week field' => [
                '0 0 3 * sat',
                self::TIMESTAMP,
                self::TIMESTAMP + 60 * 60 * 24,
                self::TIMESTAMP + 60 * 60 * 24 + 60 * 60 * 24
            ],
            'list of minutes' => [
                '2,4 * * * *',
                self::TIMESTAMP,
                self::TIMESTAMP + 120,
                self::TIMESTAMP + 240
            ],
            'list of hours' => [
                '0 2,4 * * *',
                self::TIMESTAMP,
                self::TIMESTAMP + 60 * 60 * 2,
                self::TIMESTAMP + 60 * 60 * 4
            ],
        ];
    }

    public static function expectedCalculatedTimestampDataProvider()
    {
        return [
            'every first day of month' => [
                '0 0 1 * *',
                self::TIMESTAMP,
                '01-02-2010',
                '01-03-2010',
            ],
            'once every February' => [
                '0 0 1 feb *',
                self::TIMESTAMP,
                '01-02-2010',
                '01-02-2011',
            ],
            'once every Friday February' => [
                '0 0 * feb fri',
                self::TIMESTAMP,
                '05-02-2010',
                '12-02-2010',
            ],
            'first day in February and every Friday' => [
                '0 0 1 feb fri',
                self::TIMESTAMP,
                '01-02-2010',
                '05-02-2010',
            ],
            '29th February leap year' => [
                '0 0 29 feb *',
                self::TIMESTAMP,
                '29-02-2012',
                '29-02-2016',
            ],
            'list of days in month' => [
                '0 0 2,4 * *',
                self::TIMESTAMP,
                '02-01-2010',
                '04-01-2010',
            ],
            'list of month' => [
                '0 0 1 2,3 *',
                self::TIMESTAMP,
                '01-02-2010',
                '01-03-2010',
            ],
            'list of days of weeks' => [
                '0 0 * * 2,4',
                self::TIMESTAMP,
                '05-01-2010',
                '07-01-2010',
            ]
        ];
    }

    public function calculateNextValueDeterminesCorrectNextTimestamp($cronCommand, $startTimestamp, $expectedTimestamp)
    {
        $instance = new CronCommand($cronCommand, $startTimestamp);
        $instance->calculateNextValue();
        $this->assertSame($expectedTimestamp, $instance->getTimestamp());
    }

    public function calculateNextValueDeterminesCorrectNextCalculatedTimestamp($cronCommand, $startTimestamp, $expectedTimestamp)
    {
        $instance = new CronCommand($cronCommand, $startTimestamp);
        $instance->calculateNextValue();
        $this->assertSame(strtotime($expectedTimestamp), $instance->getTimestamp());
    }

    public function calculateNextValueDeterminesCorrectNextTimestampOnConsecutiveCall($cronCommand, $startTimestamp, $firstTimestamp, $secondTimestamp)
    {
        $instance = new CronCommand($cronCommand, $firstTimestamp);
        $instance->calculateNextValue();
        $this->assertSame($secondTimestamp, $instance->getTimestamp());
    }

    public function calculateNextValueDeterminesCorrectNextCalculatedTimestampOnConsecutiveCall($cronCommand, $startTimestamp, $firstTimestamp, $secondTimestamp)
    {
        $instance = new CronCommand($cronCommand, strtotime($firstTimestamp));
        $instance->calculateNextValue();
        $this->assertSame(strtotime($secondTimestamp), $instance->getTimestamp());
    }

    public function calculateNextValueDeterminesCorrectNextTimestampOnChangeToSummertime()
    {
        $backupTimezone = date_default_timezone_get();
        date_default_timezone_set('Europe/Berlin');
        $instance = new CronCommand('* 3 28 mar *', self::TIMESTAMP);
        $instance->calculateNextValue();
        date_default_timezone_set($backupTimezone);
        $this->assertSame(1269741600, $instance->getTimestamp());
    }

    public function calculateNextValueThrowsExceptionWithImpossibleCronCommand()
    {
        $this->expectException(\RuntimeException::class);
        $this->expectExceptionCode(1291501280);
        $instance = new CronCommand('* * 31 apr *', self::TIMESTAMP);
        $instance->calculateNextValue();
    }

    public function getTimestampReturnsInteger()
    {
        $instance = new CronCommand('* * * * *');
        $this->assertInternalType(\PHPUnit\Framework\Constraint\IsType::TYPE_INT, $instance->getTimestamp());
    }

    public function getCronCommandSectionsReturnsArray()
    {
        $instance = new CronCommand('* * * * *');
        $this->assertInternalType(\PHPUnit\Framework\Constraint\IsType::TYPE_ARRAY, $instance->getCronCommandSections());
    }
}