Учитывать непраздничные дни недели

В соответствии с моим предложением использовать относительные форматы для наблюдаемых праздников. Я добавил возможность использовать callables и периоды интервалов дат для более сложных дат. Я также включил пасху как праздник в качестве варианта использования, используя функцию easter_date из расширения PHP calendar.

Я также предлагаю сегментировать даты по годам и хранить их в статическом свойстве, чтобы определить, были ли они уже загружены, чтобы предотвратить их повторную загрузку при нескольких итерациях.

Пример: https://3v4l.org/fnj67

(Демонстрирует использование файла include)

class Holiday
{            

    /**
     * holidays in [YYYY => [YYYY-MM-DD]] format
     * array|string[][]
     */
    private static $observableHolidays = [];

    //....

    /**
     * Is submitted date a holiday?
     *
     * @param DateTime $date
     * @return bool
     */
    public static function isHoliday(\DateTimeInterface $date): bool
    {
        $holidays = self::getHolidays($date);

        return \array_key_exists($date->format('Y-m-d'), array_flip($holidays[$date->format('Y')]));
    }

    /**
     * @see https://www.php.net/manual/en/function.easter-date.php
     * @param \DateTimeInterface $date
     * @return \DateTimeImmutable
     */
    private static function getEaster(\DateTimeInterface $date): \DateTimeImmutable
    {
        return (new \DateTimeImmutable())->setTimestamp(\easter_date($date->format('Y')));
    }

    /**
     * Returns an array of strings representing holidays in format 'Y-m-d'
     *
     * @return array|string[][]
     */
    public static function getHolidays(\DateTimeInterface $start): array
    {
        //static prevents redeclaring the variable
        static $relativeHolidays = [
            'new years day' => 'first day of January',
            'easter' => [__CLASS__, 'getEaster'],
            'memorial day' => 'second Monday of May',
            'independence day' => 'July 4th',
            'labor day' => 'first Monday of September',
            'thanksgiving' => 'fourth Thursday of November',
            'black friday' => 'fourth Thursday of November + 1 day',
            'christmas' => 'December 25th',
            'new years eve' => 'last day of December',

            //... add others like Veterans Day, MLK, Columbus Day, etc
        ];
        if (!$start instanceof \DateTimeImmutable) {
            //force using DateTimeImmutable
            $start = \DateTimeImmutable::createFromMutable($start);
        }
        //build the holidays to the specified year
        $start = $start->modify('first day of this year');

        //always generate an entire years worth of holidays
        $period = new \DatePeriod($start, new \DateInterval('P1Y'), 0);
        foreach ($period as $date) {
            $year = $date->format('Y');
            if (array_key_exists($year, self::$observableHolidays)) {
                continue;
            }
            self::$observableHolidays[$year] = [];
            foreach (self::$relativeHolidays as $relativeHoliday) {
                 if (\is_callable($relativeHoliday)) {
                    $holidayDate = $relativeHoliday($date);
                } elseif (0 === \strpos($relativeHoliday, 'P')) {
                    $holidayDate = $date->add(new \DateInterval($relativeHoliday));
                } else {
                    $holidayDate = $date->modify($relativeHoliday);
                }
                self::$observableHolidays[$year][] = $holidayDate->format('Y-m-d');
            }
        }

        return self::$observableHolidays;
    }
}

$holidays = Holiday::getHolidays(new \DateTime('2017-08-28'));

Результаты:

array (
  2017 => 
  array (
    0 => '2017-01-01',
    1 => '2017-04-16',
    2 => '2017-05-08',
    3 => '2017-07-04',
    4 => '2017-09-04',
    5 => '2017-11-23',
    6 => '2017-11-24',
    7 => '2017-12-25',
    8 => '2017-12-31',
  ),
)

Конкретные даты закрытия для вашей организации, которые не могут быть сохранены в относительном формате, желательно хранить в СУБД, такой как MySQL или SQLite. Которые затем можно получить после стандартных наблюдаемых праздников, когда встречаются эти годы.

Однако при отсутствии базы данных вы можете использовать включаемый файл, как это делает Symfony в своих объявлениях службы контейнеров, что также выигрывает от использования OPcache. В качестве альтернативы вы можете использовать компонент Сериализатор Symfony для создания, загрузки и сохранения не относительных данных в желаемом формате (JSON, CSV, XML, YAML).

Вот пример использования словаря включаемого файла с вашим текущим классом.

class Holiday
{
    public const CLOSURES_FILE = '/tmp/closures.php';

    //...

    public static function getHolidays(\DateTimeInterface $date): array
    {
        //...

        $holidays = self::$observableHolidays;
        if (\is_file(self::CLOSURES_FILE)) {
           foreach (include self::CLOSURES_FILE as $year => $dates) {
                if (!\array_key_exists($year, $holidays)) {
                    $holidays[$year] = [];
                }
                $holidays[$year] = array_merge($holidays[$year], $dates);
            }
        }

        return $holidays;
    }
}

$date = new \DateTime('2017-08-28');
var_export(Holiday::getHolidays($date));
var_dump(Holiday::isHoliday($date));

Результаты:

array (
  2017 => 
  array (
    0 => '2017-01-01',
    1 => '2017-04-16',
    2 => '2017-05-08',
    3 => '2017-07-04',
    4 => '2017-09-04',
    5 => '2017-11-23',
    6 => '2017-11-24',
    7 => '2017-12-25',
    8 => '2017-12-31',
    9 => '2017-08-28',
    10 => '2017-08-29',
    11 => '2017-08-30',
    12 => '2017-08-31',
    13 => '2017-09-01',
  ),
)
bool(true)

Чтобы сохранить словарь включаемого файла, вы можете загружать и сохранять эти значения в своем приложении так, как вам нравится, например, с помощью простой формы значений $_POST.

$dictionary_array = ['year' => ['date1', 'date2']];
file_put_contents(Holiday::CLOSURES_FILE, '<?php return ' . var_export($dictionary_array) . ';');

Поскольку ваше приложение контролируется версиями, используйте или задайте путь к нужному файлу словаря, который игнорируется в вашем файле .gitignore, например var/holidays/holiday_dates.php.

В моем проекте Symfony я добавляю относительные и неотносительные значения даты известный в качестве параметров из конфигураций в свой сервис Holiday, например 2001-09-11. Затем я использую службу запросов для ввода неотносительных дат неизвестный из базы данных в класс Holiday, таких как закрытие ваших ураганов. Сервис My Holiday используется во всем приложении только с использованием DI, в том числе внутри функций Twig, в отличие от вызовов методов static, но это можно сделать с помощью КомпиляторПасс в статическом методе для установки дат.

Since you are using static methods to directly access the results, it would require a major application refactor to any service that uses a Holiday static method in favor of using it as a Symfony service.