README

🇷🇺 Русский · 🇬🇧 English · 🇩🇪 Deutsch · 🇫🇷 Français · 🇪🇸 Español · 🇮🇹 Italiano

CloudCastle Clock

Production-ready PHP 8.1+ package (CloudCastle Clock).

Установка

composer require cloud-castle/clock

Требуется PHP 8.1+.

Быстрый старт

<?php

use CloudCastle\Clock\Example;

// TODO: пример использования пакета

Возможности

PSR-20 совместимые часы + 18 реализаций: SystemClock, MockClock, FrozenClock, MonotonicClock, OffsetClock, ScaledClock, TruncatingClock, CallbackClock, адаптер PsrClockAdapter, трейты ClockAwareTrait/AdjustsTimeTrait.
Duration, Stopwatch, DatePoint — интервалы, измерение времени, неизменяемый момент.
Нормализация таймзон, заморозка/сдвиг/масштаб времени для детерминированных тестов.

Сравнение с аналогами

Пять популярных аналогов, четыре оси. Интероперабельность подтверждена tests/Integration/CompetitorInteroperabilityTest.php; производительность и память измерены в изолированных процессах (100 000 вызовов now(), минимум из трёх прогонов, PHP 8.1).

Функциональность

Возможность	🏆 CloudCastle	symfony/clock	lcobucci/clock	beste/clock	ergebnis/clock	nesbot/carbon
PSR-20	✅	✅	✅	✅	✅	✅
Frozen/Mock для тестов	✅	✅	✅	✅	✅	⚠️
Монотонные часы (без скачков)	✅	✅	❌	❌	❌	❌
Offset / Scaled / Truncating	✅	❌	❌	❌	❌	❌
Duration + Stopwatch	✅	❌	❌	❌	❌	⚠️
Нормализация таймзон	✅	⚠️	⚠️	⚠️	⚠️	✅
Внешние зависимости	✅ 0	0	0	0	0	много
Покрытие	🏆 полное	высокое	базовое	базовое	базовое	иное (дата-либа)

Производительность

Пакет	Время (100 000× `now()`)	Итог
🏆 CloudCastle	648 мс	быстрейший
lcobucci/clock	648 мс	наравне
ergebnis/clock	649 мс	наравне
symfony/clock	959 мс	на 48% медленнее
beste/clock	1 497 мс	в 2,3× медленнее
nesbot/carbon	7 285 мс	в 11× медленнее

Безопасность и корректность

Свойство	🏆 CloudCastle	symfony	lcobucci	beste	ergebnis	carbon
Неизменяемый момент (`DateTimeImmutable`)	✅	✅	✅	✅	✅	✅
Монотонность (защита от скачка часов)	✅	✅	❌	❌	❌	❌
Детерминированные тесты (freeze/mock)	✅	✅	✅	✅	✅	⚠️
Явная нормализация таймзоны	✅	⚠️	⚠️	⚠️	⚠️	✅
Итог	🏆 максимум	высокий	средний	средний	средний	средний

Использование памяти

Пакет	Пиковая память	Итог
🏆 CloudCastle	7 258 KB	минимум (наравне с лёгкими)
symfony / lcobucci / beste / ergebnis	7 258 KB	наравне
nesbot/carbon	10 895 KB	+50% памяти

Вывод: CloudCastle Clock — самый быстрый, самый лёгкий и функционально богатейший (18 реализаций против одного SystemClock у большинства аналогов).

Разработка

composer install
composer check    # линтеры + статический анализ + тесты
composer fix      # автоисправления (Rector, PHP CS Fixer, PHPCBF)
composer ci       # полный CI-пайплайн локально

Полный список команд с описаниями: composer run-script --list.

Документация

Репозиторий: https://gitverse.ru/cloud-castle/clock
История изменений: CHANGELOG.md
Как внести вклад: CONTRIBUTING.md
Кодекс поведения: CODE_OF_CONDUCT.md
Политика безопасности: SECURITY.md

Лицензия