forked from rebillar/site-accueil-insa
144 lines
3.9 KiB
PHP
144 lines
3.9 KiB
PHP
<?php
|
|
/**
|
|
* Matomo - free/libre analytics platform
|
|
*
|
|
* @link https://matomo.org
|
|
* @license http://www.gnu.org/licenses/gpl-3.0.html GPL v3 or later
|
|
*
|
|
*/
|
|
|
|
namespace Piwik\Scheduler\Schedule;
|
|
|
|
use Exception;
|
|
|
|
/**
|
|
* Monthly class is used to schedule tasks every month.
|
|
*
|
|
* @see \Piwik\Scheduler\Task
|
|
*/
|
|
class Monthly extends Schedule
|
|
{
|
|
/**
|
|
* List of available week number strings used in setDayOfWeekFromString.
|
|
*/
|
|
private static $weekNumberStringToInt = array('first' => 0, 'second' => 1, 'third' => 2, 'fourth' => 3);
|
|
|
|
/**
|
|
* Day of the week for scheduled time.
|
|
*
|
|
* @var int
|
|
*/
|
|
private $dayOfWeek = null;
|
|
|
|
/**
|
|
* Week number for scheduled time.
|
|
*
|
|
* @var int
|
|
*/
|
|
private $week = null;
|
|
|
|
public function setDayOfWeekFromString($day)
|
|
{
|
|
@list($weekNumberString, $dayNumberString) = explode(' ', $day);
|
|
|
|
// get day number
|
|
$day = Weekly::getDayIntFromString($dayNumberString) % 7;
|
|
|
|
// get week number
|
|
$weekNumberString = strtolower($weekNumberString);
|
|
if (isset(self::$weekNumberStringToInt[$weekNumberString])) {
|
|
$week = self::$weekNumberStringToInt[$weekNumberString];
|
|
} else {
|
|
throw new Exception("Invalid week describer in Schedule\\Monthly::setDayOfWeekFromString: '$weekNumberString'. "
|
|
. "Supported values are 'first', 'second', 'third', 'fourth'.");
|
|
}
|
|
|
|
$this->setDayOfWeek($day, $week);
|
|
}
|
|
|
|
/**
|
|
* @return int
|
|
*/
|
|
public function getRescheduledTime()
|
|
{
|
|
$currentTime = $this->getTime();
|
|
|
|
// Adds one month
|
|
$rescheduledTime = mktime(date('H', $currentTime),
|
|
date('i', $currentTime),
|
|
date('s', $currentTime),
|
|
date('n', $currentTime) + 1,
|
|
1,
|
|
date('Y', $currentTime)
|
|
);
|
|
|
|
$nextMonthLength = date('t', $rescheduledTime);
|
|
|
|
// Sets scheduled day
|
|
$scheduledDay = date('j', $currentTime);
|
|
|
|
if ($this->day !== null) {
|
|
$scheduledDay = $this->day;
|
|
}
|
|
|
|
if ($this->dayOfWeek !== null
|
|
&& $this->week !== null
|
|
) {
|
|
$newTime = $rescheduledTime + $this->week * 7 * 86400;
|
|
while (date("w", $newTime) != $this->dayOfWeek % 7) {
|
|
// modulus for sanity check
|
|
|
|
$newTime += 86400;
|
|
}
|
|
$scheduledDay = ($newTime - $rescheduledTime) / 86400 + 1;
|
|
}
|
|
|
|
// Caps scheduled day
|
|
if ($scheduledDay > $nextMonthLength) {
|
|
$scheduledDay = $nextMonthLength;
|
|
}
|
|
|
|
// Adjusts the scheduled day
|
|
$rescheduledTime += ($scheduledDay - 1) * 86400;
|
|
|
|
// Adjusts the scheduled hour
|
|
$rescheduledTime = $this->adjustHour($rescheduledTime);
|
|
$rescheduledTime = $this->adjustTimezone($rescheduledTime);
|
|
|
|
return $rescheduledTime;
|
|
}
|
|
|
|
/**
|
|
* @param int $_day the day to set, has to be >= 1 and < 32
|
|
* @throws Exception if parameter _day is invalid
|
|
*/
|
|
public function setDay($_day)
|
|
{
|
|
if (!($_day >= 1 && $_day < 32)) {
|
|
throw new Exception("Invalid day parameter, must be >=1 and < 32");
|
|
}
|
|
|
|
$this->day = $_day;
|
|
}
|
|
|
|
/**
|
|
* Makes this scheduled time execute on a particular day of the week on each month.
|
|
*
|
|
* @param int $_day the day of the week to use, between 0-6 (inclusive). 0 -> Sunday
|
|
* @param int $_week the week to use, between 0-3 (inclusive)
|
|
* @throws Exception if either parameter is invalid
|
|
*/
|
|
public function setDayOfWeek($_day, $_week)
|
|
{
|
|
if (!($_day >= 0 && $_day < 7)) {
|
|
throw new Exception("Invalid day of week parameter, must be >= 0 & < 7");
|
|
}
|
|
|
|
if (!($_week >= 0 && $_week < 4)) {
|
|
throw new Exception("Invalid week number, must be >= 1 & < 4");
|
|
}
|
|
|
|
$this->dayOfWeek = $_day;
|
|
$this->week = $_week;
|
|
}
|
|
}
|