add piwik installation

www/analytics/core/ScheduledTime/Monthly.php

@@ -0,0 +1,145 @@
+<?php
+/**
+ * Piwik - Open source web analytics
+ *
+ * @link http://piwik.org
+ * @license http://www.gnu.org/licenses/gpl-3.0.html GPL v3 or later
+ *
+ */
+namespace Piwik\ScheduledTime;
+
+use Exception;
+use Piwik\ScheduledTime;
+
+/**
+ * Monthly class is used to schedule tasks every month.
+ *
+ * @see ScheduledTask
+ *
+ */
+class Monthly extends ScheduledTime
+{
+    /**
+     * 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
+        $week = false;
+        $weekNumberString = strtolower($weekNumberString);
+        if (isset(self::$weekNumberStringToInt[$weekNumberString])) {
+            $week = self::$weekNumberStringToInt[$weekNumberString];
+        } else {
+            throw new Exception("Invalid week describer in ScheduledTime\\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;
+    }
+}