maximaster/production-calendar

Работа с производственным календарём, встроено получение данных с basicdata.ru

Production Calendar

Предоставляет возможность проверить является ли день выходным|праздничным|рабочим. Данные предоставлены basicdata.ru, однако, библиотека позволяет подключить любой источник данных., _(*1)

Установка

composer require maximaster/production-calendar

Примеры использования

Для полного списка доступных функций обратитесь к phpDoc пубичных методов класса Calendar., _(*2)

isFree($day)

Проверяет, является ли день "свободным", т.е. либо праздником, либо рядовым выходным, _(*3)

use Maximaster\ProductionCalendar\Calendar;
use Maximaster\ProductionCalendar\RulesProvider\BasicdataProvider;

$calendar = Calendar::fromProvider(new BasicdataProvider);
if ($calendar->isFreeDay('01.01.2017')) {

isDay($day, $types)

Проверяет, относится ли день к определённому типу (или одному из типов, если передан массив). Доступные типы см. константы класса Rules, _(*4)

use Maximaster\ProductionCalendar\Rules;
if ($calendar->isDay('01.01.2017', [Rules::HOLIDAY, Rules::PRE_HOLIDAY])) {

getDayType($day)

Возвращает тип дня, _(*5)

$calendar->getDayType('01.01.2017'); // Rules::REGULAR_REST

getMonthWorkDaysCount($year, $month)

getMonthWorkDaysCount($dayOfMonth)

Возвращает количество рабочих дней в указанном месяце, _(*6)

$calendar->getMonthWorkDaysCount(2017, 6); // 21

Кеширование

Позволяет кешировать результаты любого источника с помощью CacheProvider, в том числе встроенного. Пример:, _(*7)

Calendar::fromProvider(new CacheProvider(new BasicdataProvider));

Для использования необходимо подключить пакет desarrolla2/cache, _(*8)

Использование как сервиса в Symfony (2.8)

app/config/services.yml, _(*9)

  app.calendar.basicdata_provider:
    public: false
    class: Maximaster\ProductionCalendar\RulesProvider\BasicdataProvider

  app.calendar.cached_basicdata_provider:
    public: false
    class: Maximaster\ProductionCalendar\RulesProvider\CacheProvider
    arguments: ["@app.calendar.basicdata_provider"]

  app.calendar:
    class: Maximaster\ProductionCalendar\Calendar
    factory: ['Maximaster\ProductionCalendar\Calendar', fromProvider]
    arguments: ["@app.calendar.cached_basicdata_provider"]

любой код с доступом к контейнеру, _(*10)

$calendar = $this->getContainer()->get('app.calendar');