cache_pilot

Cache Pilot provides command-line tools to clear APCu and OPcache caches via FastCGI, essential for deployments using PHP-FPM. This module ensures reliable cache management without relying on web requests, making it ideal for CLI workflows.

Features

• Cache Clearing: Clear APCu and Zend OPcache caches via Drush commands (cache-pilot:apcu:clear and cache-pilot:opcache:clear), UI, or programmatically using a dedicated service.
• Deployment-Friendly: Designed for use in deployment scripts where PHP-FPM runs separately from CLI.
• Flexible Connections: Configure FastCGI via TCP (e.g., tcp://127.0.0.1:9000) or Unix domain sockets (e.g., unix:///var/run/php/php-fpm.sock).
• Cache Statistics Report: Provides a new Report page with APCu and/or Zend OPcache statistics.

Use this module to ensure PHP opcode caches are reliably reset during deployments, avoiding stale code or cached data issues.

Post-Installation

1. Navigate to Configuration > Performance > Cache Pilot Settings.
2. Configure the Connection DSN:
   • TCP: Connects using the '[host]:[port]' information, for example: tcp://127.0.0.1:9000 or tcp://php:9000.
   • Unix Domain Socket: Connects using a unix socket to which you provide a path, for example: unix:///var/run/php/php-fpm.sock
3. Use Drush commands in deployment scripts (recommended before drush deploy).

To disable in specific environments, override the configuration in settings.php:

$config['cache_pilot.settings']['connection_dsn'] = NULL;