phptcloud / is-day-off Goto Github PK

View Code? Open in Web Editor NEW

24.0 1.0 5.0 34 KB

PHP SDK for isdayoff.ru

Home Page: https://isdayoff.ru/

PHP 100.00%

isdayoff php sdk

is-day-off's Introduction

IsDayOf

PHP SDK for isdayof.ru

Instalation

composer require phptcloud/isdayoff-sdk

After install

You can check the work of the scripts in the "Examples" folder. ;)

Simple example

require_once __DIR__ . '/../vendor/autoload.php';

use isDayOff\Client\IsDayOff;

$client = new IsDayOff();

$date = new DateTime('now');
$result = $client->date()->isDayOff($date);

if($result) {
    echo 'is day off.';
} else {
    echo 'working day.';
}

Filters

// Countries
isDayOff\Filters\UkraineFilter
isDayOff\Filters\RussianFilter
isDayOff\Filters\KazakhstanFilter
isDayOff\Filters\BelorusFilter
isDayOff\Filters\UnitedStatesFilter
isDayOff\Filters\UzbekistanFilter
isDayOff\Filters\TurkeyFilter

// Additional
isDayOff\Filters\CovidFilter
isDayOff\Filters\PreHolidayFilter

Filters examples

/**
 * New filter collection
 */
$filters = new FiltersCollection();
$filters->addOne(new UkraineFilter());

$client->date()->setFilters($filters);
$date = new DateTime('2019/01/01');

$result = $client->date()->getDataPerMonth($date);

print_r($result);

is-day-off's People

Contributors

Stargazers

Watchers

Forkers

vermolaev deniskraev ivanfilatov alnidok pmjakporoo

is-day-off's Issues

Installation error

composer require phptcloud/isdayoff-sdk               
                                                                                                                                                            
  [InvalidArgumentException]                                                                                                                                               
  Could not find a version of package phptcloud/isdayoff-sdk matching your minimum-stability (stable). Require it with an explicit version constraint allowing its desire  
  d stability.

I think you need to add the tag to the repository

Ошибки после обновления до v1.0.1 на версиях php<7.4

Версия 1.0.1 предполагает использование типизированных свойств в классах (например), поддержка которых появилась в php7.4 - https://www.php.net/manual/ru/migration74.new-features.php#migration74.new-features.core.typed-properties.

Т.к. сейчас в composer.json нет ограничения на версию, значит после минорного обновления composer-пакета все, у кого версия php ниже, получат ошибки!

syntax error, unexpected 'DateService' (T_STRING), expecting function (T_FUNCTION) or const (T_CONST)

Собственно это начало происходить после того, как на https://packagist.org/packages/phptcloud/isdayoff-sdk версия пакета обновилась до 1.0.1 (2022-03-21 03:26 UTC), странно почему до сих пор не было issue :)

На будущее:

Изменения, ломающие обратную совместимость (в т.ч. переход на новые версии языка) должны происходить в мажорных версиях пакета, тогда стандартный "phptcloud/isdayoff-sdk": "^1.0", не будет обновлять до версий 2.0 и т.д. (подробнее).
Всегда указывать версию языка и все зависимости, необходимые для работы пакета, в composer.json (секция require). Тогда composer будет ругаться при попытке обновить пакет, если что-то не так. А сейчас все успешно установится, и о проблеме станет известно лишь по ParseError.

//configure dayOffService
$dayOffClient = new IsDayOff();
$filters = new FiltersCollection();
$filter = self::IS_DAY_OF_COUNTRY_FILTERS[$this->countryId] ?? self::IS_DAY_OF_DEFAULT_FILTER;
$filters->addOne(new $filter());
$dateTime = new \DateTime();

foreach ($data as $timeDay => $rowsData) {
  $dataHead['isDayOff'][$timeDay] = $dayOffClient->date()->isDayOff($dateTime->setTimestamp($timeDay));
}