Zend OPcacheの概要とインストール・設定:php.iniの値とJITの無効化
Zend OPcacheは、PHPスクリプトをバイトコードにコンパイルして共有メモリに保存し、同じファイルをもう一度実行するときにコンパイルを省略させるPHP拡張です。PHP 8.3を使うWordPressサーバーでJITを有効にしたところ全ページで500エラーが出たため、OPcacheはそのままにしてJITだけを無効にして復旧しました。
PHP 5.5以降、OPcacheはPHPに標準で含まれて配布されています。
1️⃣ Zend OPcacheの概要:バイトコードのキャッシュ
PHPスクリプトは、リクエストが来るたびに、ファイルの読み込み、バイトコードへのコンパイル、実行という3つの段階を踏みます。OPcacheが動作していると、同じファイルの2回目のリクエストからは前の2つの段階が省かれ、実行だけが残ります。
OPcacheがバイトコードを保存する共有メモリは、PHP-FPMのすべてのワーカーがいっしょに使います。同じPHP-FPMにつながっているサイトが複数ある場合は、それらのサイトのスクリプトも1つの共有メモリに保存されます。
OPcacheが保存するのはコンパイル済みのPHPコードなので、ページを開くたびにPHPの実行とデータベースの照会はそのまま行われます。完成したHTMLを保存してPHPの実行そのものを省くのは、ページキャッシュの役割です。
2️⃣ PHP OPcacheのインストール確認
OPcacheがインストールされているかどうかは、[php -v]の出力の最後の行で確認します。
php -vPHP 8.3.22 (cli) (built: Jun 3 2025 17:17:57) (NTS gcc x86_64)
Copyright (c) The PHP Group
Zend Engine v4.3.22, Copyright (c) Zend Technologies
with Zend OPcache v8.3.22, Copyright (c), by Zend Technologies最後の行がない場合は、dnfでインストールします。パッケージ名はたいていphp-opcacheで、Remiリポジトリで複数のPHPバージョンをまとめてインストールしている場合は、php83-php-opcacheのようにバージョンが付きます。
dnf -y install php-opcacheRemiリポジトリのphp-opcacheパッケージは、[/etc/php.d/10-opcache.ini]の[zend_extension=opcache]の行で拡張を読み込みます。インストールしたあとでPHP-FPMを再起動すると、WebリクエストにもOPcacheが適用されます。
3️⃣ OPcacheの設定:php.iniの値
OPcacheの設定は、[/etc/php.ini]の[opcache]の部分と[/etc/php.d/10-opcache.ini]の2か所に書けます。
php --iniConfiguration File (php.ini) Path: /etc
Loaded Configuration File: /etc/php.ini
Scan for additional .ini files in: /etc/php.d
Additional .ini files parsed: /etc/php.d/10-opcache.ini,php.dフォルダーのファイルはphp.iniのあとに読み込まれるため、同じ項目を2か所に書いた場合はphp.d側の値が適用されます。
下の表は、PHP 8.3のデフォルト値と、確認したWordPressサーバーに適用されている値です。
| 項目 | PHP 8.3のデフォルト値 | 適用値 | 意味 |
|---|---|---|---|
| opcache.enable | 1 | 1 | OPcacheを使用 |
| opcache.enable_cli | 0 | 1 | コマンドラインのPHP(wp-cliなど)でも使用 |
| opcache.memory_consumption | 128 | 1024 | バイトコードを保存する共有メモリ(MB) |
| opcache.interned_strings_buffer | 8 | 16 | 同じ文字列を1回だけ保存するメモリ(MB) |
| opcache.max_accelerated_files | 10000 | 10000 | キャッシュできるキーの数の上限(実際の上限はこの値以上の素数で、10000なら16229) |
| opcache.max_wasted_percentage | 5 | 10 | メモリが足りなくなり、無駄になった領域がこの割合を超えると、キャッシュを空にして最初からやり直す |
| opcache.validate_timestamps | 1 | 1 | ファイルが変更されたかどうかを確認 |
| opcache.revalidate_freq | 2 | 60 | ファイルの変更を確認する間隔(秒) |
| opcache.jit | tracing | disable | JITの方式(PHP 8.4からデフォルトはdisable) |
| opcache.jit_buffer_size | 0 | 0 | JIT用のメモリ。0ならJITは動作しない(PHP 8.4からデフォルトは64M) |
[/etc/php.ini]の[opcache]の部分に入れた値は次のとおりです。メモリのサイズはサーバーのメモリに、[opcache.max_accelerated_files]はWordPressのファイル数に合わせて決めます。
[opcache]
opcache.enable=1
opcache.enable_cli=1
opcache.memory_consumption=1024
opcache.interned_strings_buffer=16
opcache.max_accelerated_files=10000
opcache.max_wasted_percentage=10
opcache.validate_timestamps=1
opcache.revalidate_freq=60php.iniに[zend_extension]の行をもう一度入れると、拡張が2回読み込まれ、[Cannot load Zend OPcache]という警告が出力されます。
[opcache.revalidate_freq]が60だと、PHPファイルを修正してから最大60秒間は古いコードが実行されることがあります。
PHPファイルが頻繁に変わるWordPressサーバーでは、[opcache.validate_timestamps]を1にして、ファイルの変更を確認させます。Symfonyのドキュメントが本番サーバーに勧めている0は、新しいバージョンをデプロイするときだけPHPファイルが変わるサーバーに合う値です。
[opcache.validate_timestamps]を0にしても、管理画面から更新すれば、WordPressが変更されたファイルのキャッシュを自分で消去します。ただし、wp-cliで更新したりSSHでファイルを修正したりすると、PHP-FPMを再起動するまで古いコードが実行されます。
4️⃣ OPcacheのJITを無効にする
PHP 8のJITはCPU演算の多い処理を速くする機能なので、WordPressのようにWebリクエストを処理するアプリケーションでは効果が小さくなります。PHP JIT RFCに載っているWordPressの測定でも、JITを有効にした側は毎秒326件、無効にした側は315件でした。
PHP 8.3.22を使うWordPressサーバーで、[opcache.jit=tracing]と[opcache.jit_buffer_size=128M]によりJITを有効にしました。3日後、リクエストが集中してPHP-FPMのワーカーが何度も再起動した日に、全ページで500エラーが発生しました。
エラーログには[Allowed memory size of 1073741824 bytes exhausted]というメッセージが残りました。その後ろに付いている[tried to allocate 4295229440 bytes]は、PHPのメモリ上限1GBに対して4GBを一度に割り当てようとした記録です。JITを無効にすると、同じリクエストが正常に処理されました。
JITは、[/etc/php.d/10-opcache.ini]に次の2行を入れて無効にします。[/etc/php.ini]にJITの設定が残っていても、このファイルの値が適用されます。
opcache.jit=disable
opcache.jit_buffer_size=0PHP 8.3では[opcache.jit_buffer_size]のデフォルト値が0なので、別に設定しなければJITは動作しません。PHP 8.4からは[opcache.jit]のデフォルト値もdisableです。
5️⃣ 設定の反映と確認
変更した設定は、PHP-FPMを再起動してはじめて適用されます。
systemctl restart php-fpm再起動すると、OPcacheの共有メモリが空になり、新しい設定で割り当て直されます。
php -i | grep -E '^opcache\.(enable|memory_consumption|revalidate_freq|validate_timestamps|jit) 'opcache.enable => On => On
opcache.jit => disable => disable
opcache.memory_consumption => 1024 => 1024
opcache.revalidate_freq => 60 => 60
opcache.validate_timestamps => On => On[php -i]が出力する値はコマンドラインのPHPの設定です。RHEL系ではPHP-FPMも同じ[/etc/php.ini]と[/etc/php.d]のファイルを読み込むため、値は同じになります。
コマンドラインで[opcache_get_status()]を呼び出すと、キャッシュされたスクリプトは0個と表示されます。コマンドラインのPHPは実行のたびに共有メモリを新しく作るので、PHP-FPMの使用量は、下のファイルをWebのドキュメントフォルダーに置いてブラウザーで確認します。
<?php
header('Content-Type: text/plain');
$s = opcache_get_status(false);
print_r($s['memory_usage']);
print_r($s['opcache_statistics']);
print_r($s['interned_strings_usage']);
var_dump($s['cache_full']);[cache_full]がtrueなら、共有メモリかキーがいっぱいになっている状態です。確認したあとは、このファイルをすぐに削除します。
WordPressサイト3つが同じPHP-FPMを使うサーバーでは、共有メモリ1024MBのうち317MBが使われていました。キャッシュされたスクリプトはサイトごとに3,366〜4,222個で、合計11,358個でした。
OPcacheはスクリプトを実際のパスで保存し、相対パスで読み込んだファイルには作業ディレクトリを付けたキーをもう1つ作るため、キーの数がスクリプトの数より多くなります。スクリプト11,358個に対してキーは上限の16,229個が埋まり、文字列バッファの16MBにも空きがありませんでした。
キーがいっぱいになると、新しいスクリプトはキャッシュされず、リクエストのたびにコンパイルされます。5分21秒の間にキャッシュミスは18,408件から36,027件に増えましたが、キャッシュされたスクリプトの数は11,358個のままでした。
WordPressを複数運営しているサーバーやプラグインが多いサーバーでは、キーの上限が埋まらないよう[opcache.max_accelerated_files]を余裕をもって決めます。20000にすると、実際のキーの上限は32,531個になります。文字列バッファがいっぱいなら、[opcache.interned_strings_buffer]もあわせて増やします。
🔢 FAQ & おすすめコンテンツ
キャッシュ
キャッシュ:定義とキャッシングが使われるすべての分野
コンパイル済みのPHPコードを保存するOPcacheと、完成したHTMLを保存するページキャッシュを含め、キャッシュが使われる分野を分けた記事です。
PHP-FPM
php-fpm max_children 警告:ワーカーを増やす前にログで原因を突き止める
OPcacheの共有メモリをいっしょに使うPHP-FPMのワーカーがすべて埋まったときに出る警告の原因を、ログで見分ける記事です。
PHP-FPM
PHP-FPMとは | PHP-FPMのインストールと設定
OPcacheが中で動作するPHP-FPMのインストールとwww.confのプール設定、再起動の方法を扱った記事です。
ℹ️ 提携について
当サイトのコンテンツにはアフィリエイトリンクが含まれています。訪問者がこのリンクを通じて商品やサービスを購入すると、当サイトは販売元から手数料を受け取ります。この過程において、購入者が支払う金額(イベント割引適用で金額が下がります↓)は上昇しません。掲載されている価格・割引・在庫情報は作成時点のものであり、実際とは異なる場合がありますので、ご購入前に販売元にて最終確認をお願いいたします。商品の選定および評価は独自の基準に基づいて行われており、手数料の支払いの有無は紹介順や評価内容に影響を与えません。