Home / PHP / Fix OPcache Memory Exhaustion and Cache Full Warning

PHP

Fix OPcache Memory Exhaustion and Cache Full Warning

Fix PHP OPcache memory exhaustion by configuring opcache.memory_consumption, monitoring cache usage, tuning max accelerated files, handling cache invalidation, and preventing cache thrashing.

Published: Apr 22, 20265 min readBy FixWikiHub Editorial Team

Illustration of PHP development diagnostics.

Introduction

PHP OPcache stores precompiled script bytecode in shared memory to avoid parsing and compiling PHP files on every request. When the shared memory pool fills up (opcache.memory_consumption default is 128MB), OPcache stops caching new files and logs OPcache cache is full warnings. This means frequently accessed files are not cached, causing performance degradation. The fix requires sizing the OPcache memory pool based on the total size of compiled PHP files, monitoring cache usage to identify when tuning is needed, and configuring proper cache invalidation for deployments.

Symptoms

PHP error log:

bash

[09-Apr-2026 10:00:00 UTC] PHP Warning:  OPcache cache is full in Unknown on line 0

Or performance degradation:

bash

# Before cache full: average response time 50ms
# After cache full: average response time 200ms
# Because PHP files are being re-compiled on every request

Cache status:

php

$status = opcache_get_status();
echo "Memory used: " . $status['memory_usage']['used_memory'] . "\n";
echo "Memory free: " . $status['memory_usage']['free_memory'] . "\n";
echo "Cached scripts: " . $status['opcache_statistics']['num_cached_scripts'] . "\n";
// free_memory = 0, cache is full

Common Causes

opcache.memory_consumption too small: Default 128MB insufficient for large codebase
Too many files cached: Large framework with many files exceeds cache capacity
opcache.max_accelerated_files too low: Default 10000 files not enough
Frequent deployments: Cache reset on every deploy, never reaching optimal state
Development mode enabled: opcache.validate_timestamps=1 causes unnecessary revalidation
String intern buffer full: Large number of unique strings in cached scripts

Step-by-Step Fix

Step 1: Configure OPcache for production

```ini ; php.ini or /etc/php/8.2/fpm/conf.d/10-opcache.ini opcache.enable=1 opcache.enable_cli=1

; Increase memory based on your codebase size opcache.memory_consumption=512 ; MB - increase from default 128

; Maximum number of files to cache opcache.max_accelerated_files=20000 ; Increase from default 10000

; Revalidation settings opcache.validate_timestamps=0 ; 0 for production (manual reset only) opcache.revalidate_freq=0 ; Not used when validate_timestamps=0

; String optimization opcache.interned_strings_buffer=32 ; MB for string deduplication opcache.save_comments=1 ; Keep docblock annotations (needed for frameworks)

; Optimization opcache.fast_shutdown=1 opcache.enable_file_override=0 ; Enable only if validate_timestamps=0 opcache.optimization_level=0x7FFFBFFF ```

Step 2: Monitor OPcache usage

```php <?php // opcache-status.php - protected admin endpoint $status = opcache_get_status(false); $memory = $status['memory_usage']; $stats = $status['opcache_statistics'];

$usagePercent = ($memory['total_memory'] > 0) ? ($memory['used_memory'] / $memory['total_memory'] * 100) : 0;

echo json_encode([ 'memory_used_mb' => round($memory['used_memory'] / 1024 / 1024, 1), 'memory_total_mb' => round($memory['total_memory'] / 1024 / 1024, 1), 'memory_usage_percent' => round($usagePercent, 1), 'cached_scripts' => $stats['num_cached_scripts'], 'max_cached_scripts' => ini_get('opcache.max_accelerated_files'), 'hits' => $stats['hits'], 'misses' => $stats['misses'], 'hit_rate' => round($stats['opcache_hit_rate'], 2) . '%', ]); ```

Step 3: Reset cache after deployment

```bash #!/bin/bash # deploy.sh - reset OPcache after deploying new code

# Deploy new code git pull origin main

# Reset OPcache (must be done via PHP-FPM) # Option 1: Restart PHP-FPM (simplest) systemctl reload php8.2-fpm

# Option 2: Use opcache_reset() via PHP CLI (PHP 7.0+) php -r 'if (function_exists("opcache_reset")) { opcache_reset(); echo "OPcache reset\n"; }'

# Verify cache is rebuilding sleep 5 curl -s http://localhost/opcache-status.php ```

Prevention

Size opcache.memory_consumption to exceed total compiled PHP file size
Set opcache.max_accelerated_files to exceed total PHP files in project
Disable opcache.validate_timestamps in production for maximum performance
Reset OPcache after every code deployment
Monitor cache hit rate -- should be above 99% in production
Use opcache_compile_file() in warmup scripts to pre-populate cache
Add OPcache status monitoring to your application health checks

Verification

After configuring OPcache, verify settings are correct:

```bash # Check OPcache configuration php -i | grep opcache

# Check current cache status php -r "print_r(opcache_get_status());"

# Verify memory consumption is adequate php -r " \$status = opcache_get_status(); \$mem = \$status['memory_usage']; \$usage = (\$mem['used_memory'] / (\$mem['used_memory'] + \$mem['free_memory'])) * 100; echo 'Memory usage: ' . round(\$usage, 1) . \"%\n\"; echo 'Cached scripts: ' . \$status['opcache_statistics']['num_cached_scripts'] . \"\n\"; echo 'Hit rate: ' . round(\$status['opcache_statistics']['opcache_hit_rate'], 2) . \"%\n\"; " ```

```php // Health check endpoint to verify OPcache is working function opcache_health_check(): array { $status = opcache_get_status(false);

if (!$status) { return ['status' => 'error', 'message' => 'OPcache not enabled']; }

$mem = $status['memory_usage']; $stats = $status['opcache_statistics'];

$memUsage = $mem['used_memory'] / ($mem['used_memory'] + $mem['free_memory']);

return [ 'status' => $memUsage < 0.9 ? 'healthy' : 'warning', 'memory_usage_percent' => round($memUsage * 100, 1), 'cached_scripts' => $stats['num_cached_scripts'], 'hit_rate_percent' => round($stats['opcache_hit_rate'], 2), 'recommendations' => $memUsage > 0.8 ? ['Increase opcache.memory_consumption'] : [], ]; } ```

[Technical troubleshooting: Fix Composer Autoload Classmap Not Updating After ](composer-autoload-classmap-not-updating-after-new-class)
[Technical troubleshooting: Fix Php Composer Platform Php Version Mismatch Fix](php-composer-platform-php-version-mismatch-fix)
[Technical troubleshooting: Fix composer platform requirement php version mism](composer-platform-requirement-php-version-mismatch-fix)
[Fix Curl SSL Certificate Problem Unable To Get Local Issuer Issue in PHP](curl-ssl-certificate-problem-unable-to-get-local-issuer)
[Fix Drupal Module Update Failed Breaking Site](fix-drupal-module-update-failed)

Was this guide helpful?

Related search paths

People also search for

If the symptom is close but not identical, these search paths usually surface the right neighboring fixes faster than scrolling the full archive.

OPcache Memory Exhaustion and Cache Full Warning OPcache Memory Exhaustion and Cache Full Warning PHP OPcache Memory Exhaustion and Cache Full Warning troubleshooting OPcache Memory Exhaustion and Cache Full Warning fix Fix PHP OPcache memory exhaustion by configuring opcache PHP Fix PHP OPcache memory exhaustion by configuring opcache

Explore Related Topics

Browse Guides from Other Categories

Discover troubleshooting guides from related categories to expand your knowledge.

FAQ

PHP Troubleshooting FAQs

Common questions about troubleshooting and preventing similar issues

How do I know if this php-errors troubleshooting guide applies to my situation?

This guide is designed for php-errors issues. If you're experiencing similar symptoms described in the article, follow the step-by-step instructions. Start with the most common causes and work through the diagnostic process.

Is it safe to follow these php-errors troubleshooting steps?

Yes, all steps are designed to be safe and non-destructive. We recommend creating backups before making significant changes and testing each step before proceeding to the next.

How long does it typically take to resolve this type of php-errors issue?

Most php-errors issues can be resolved within 30 minutes to 2 hours, depending on the complexity and root cause. Follow the troubleshooting flow to identify and fix the problem efficiently.

How can I prevent this php-errors issue from happening again?

Regular maintenance, monitoring, and following best practices for php-errors configuration can help prevent recurrence. Consider implementing automated checks and alerts for early detection.

Written by

FixWikiHub Editorial Team

Our editorial team consists of experienced DevOps engineers, systems administrators, and cloud architects with hands-on experience in production environments across AWS, Azure, GCP, and on-premises infrastructure.

Every guide undergoes technical review for accuracy and is updated when software versions, commands, or best practices change.

Last updated: Apr 22, 2026

About our team

Important Notice

Disclaimer & Safety Guidelines

The troubleshooting steps in this guide are provided for educational and informational purposes. Before applying any changes to production systems:

Test in a staging environment first — Always verify commands and configurations in a non-production environment before deploying to live systems.
Create backups — Ensure you have current backups of databases, configurations, and critical files before making changes.
Understand the impact — Review how each step may affect your specific environment, dependencies, and users.
Consult official documentation — This guide supplements, but does not replace, official vendor documentation and best practices.

FixWikiHub is not responsible for any damages arising from the use of this content. See our Terms of Use for more information.

Resources

Official Documentation & Further Reading

For authoritative information, consult the official documentation for the technologies discussed in this guide. Our troubleshooting content supplements, but does not replace, vendor documentation.

AWS Documentation — Official Amazon Web Services guides and API references
Kubernetes Documentation — Official Kubernetes documentation
Nginx Documentation — Official Nginx web server documentation
Apache Documentation — Official Apache HTTP Server documentation
Docker Documentation — Official Docker container documentation

Fix OPcache Memory Exhaustion and Cache Full Warning

Introduction

Symptoms

Common Causes

Step-by-Step Fix

Step 1: Configure OPcache for production

Step 2: Monitor OPcache usage

Step 3: Reset cache after deployment

Prevention

Verification

People also search for

Browse Guides from Other Categories

WordPress

SSL

DNS

PHP Troubleshooting FAQs

FixWikiHub Editorial Team

Disclaimer & Safety Guidelines

Official Documentation & Further Reading

Fix OPcache Memory Exhaustion and Cache Full Warning

Introduction

Symptoms

Common Causes

Step-by-Step Fix

Step 1: Configure OPcache for production

Step 2: Monitor OPcache usage

Step 3: Reset cache after deployment

Prevention

Verification

Related Articles

People also search for

Share this guide

More PHP Troubleshooting Guides

Browse Guides from Other Categories

PHP Troubleshooting FAQs

FixWikiHub Editorial Team

Disclaimer & Safety Guidelines

Official Documentation & Further Reading