README

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

CloudCastle Opcache

Объектная обёртка над расширением Zend OPcache: сброс, инвалидация, прогрев кэша байткода, чтение состояния и конфигурации — с типобезопасными value-объектами вместо «сырых» ассоциативных массивов.

Установка

composer require cloud-castle/opcache

Требуется PHP 8.1+ и расширение Zend OPcache.

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

<?php

use CloudCastle\Opcache\Opcache;

$opcache = new Opcache();

if ($opcache->isEnabled()) {
    $status = $opcache->status();
    echo $status->cachedScripts();   // число закэшированных скриптов
    echo $status->hitRate();         // доля попаданий, %

    $opcache->compile('/app/src/Kernel.php');   // прогрев кэша
    $opcache->invalidate('/app/src/Kernel.php', force: true);
    $opcache->reset();               // полный сброс кэша байткода
}

echo $opcache->configuration()->memoryConsumption();   // МБ под кэш

Возможности

• isEnabled() — включён ли OPcache в текущем процессе.
• reset() — полный сброс кэша байткода.
• invalidate($file, $force) — инвалидация конкретного скрипта.
• compile($file) — компиляция файла в кэш (прогрев).
• isCached($file) — закэширован ли скрипт.
• status() — снимок состояния (Status): память, число скриптов, попадания/промахи, доля попаданий.
• configuration() — ключевые директивы (Configuration): объём памяти, лимит файлов, частота ревалидации, версия.

Неудачные операции и выключенный OPcache сигнализируются исключением OpcacheException — без «тихих» false.

Разработка

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

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

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

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

Лицензия

MIT © CloudCastle (alex-4-17@yandex.ru)

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