Zend OPcacheの概要とインストール・設定:php.iniの値とJITの無効化

テスト環境 RHEL系AlmaLinux 9.8rootアカウント2026-10-16 確認

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がない場合とある場合のリクエスト処理
解説ダイアグラム
🧠 OPcache
📨 リクエスト
🧰 PHP-FPM ワーカー
ワーカー11回目のリクエスト
ワーカー22回目のリクエスト
ワーカー3待機
リクエストのたびに3段階1回目のリクエスト · 3段階実行のみ→
⚙️ PHPスクリプトの処理
ファイル読み込み省略
→
バイトコードのコンパイル省略
→
実行PHPの実行 · データベースの照会
共有メモリは使わない↓ バイトコードを保存↑ 共有メモリのバイトコードを使用
🧠 共有メモリ
バイトコード(コンパイル済みのPHPコード)
PHP-FPMのすべてのワーカーがいっしょに使用 · サイトが複数あっても共有メモリは1つ
OPcacheがないと、PHPスクリプトはリクエストが来るたびに、ファイルの読み込み、バイトコードへのコンパイル、実行という3つの段階を踏みます。
OPcacheがないと、同じファイルの2回目のリクエストでも、ファイルの読み込み、バイトコードへのコンパイル、実行という3つの段階をもう一度踏みます。
OPcacheが動作していると、1回目のリクエストは3つの段階を踏んだあと、バイトコードを共有メモリに保存します。
同じファイルの2回目のリクエストからは前の2つの段階が省かれて実行だけが残り、共有メモリはPHP-FPMのすべてのワーカーがいっしょに使います。

OPcacheが保存するのはコンパイル済みのPHPコードなので、ページを開くたびにPHPの実行とデータベースの照会はそのまま行われます。完成したHTMLを保存してPHPの実行そのものを省くのは、ページキャッシュの役割です。

2️⃣ PHP OPcacheのインストール確認

OPcacheがインストールされているかどうかは、[php -v]の出力の最後の行で確認します。

php -v
PHP 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-opcache

Remiリポジトリの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 --ini
Configuration 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.enable11OPcacheを使用
opcache.enable_cli01コマンドラインのPHP(wp-cliなど)でも使用
opcache.memory_consumption1281024バイトコードを保存する共有メモリ(MB)
opcache.interned_strings_buffer816同じ文字列を1回だけ保存するメモリ(MB)
opcache.max_accelerated_files1000010000キャッシュできるキーの数の上限(実際の上限はこの値以上の素数で、10000なら16229)
opcache.max_wasted_percentage510メモリが足りなくなり、無駄になった領域がこの割合を超えると、キャッシュを空にして最初からやり直す
opcache.validate_timestamps11ファイルが変更されたかどうかを確認
opcache.revalidate_freq260ファイルの変更を確認する間隔(秒)
opcache.jittracingdisableJITの方式(PHP 8.4からデフォルトはdisable)
opcache.jit_buffer_size00JIT用のメモリ。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=60

php.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=0

PHP 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 7.2で削除された設定なので、PHP 8ではphp.iniに残っていても動作に影響はありません。以前の設定を引き継いだサーバーなら、この行は削除してかまいません。

OPcacheはコンパイル済みのPHPコードを、Redisオブジェクトキャッシュはデータベースの照会結果を保存します。保存する対象が違うので、いっしょに使えます。

PHP-FPMでPHPを実行するサーバーは、OPcacheがPHP-FPMの中で動作するため、PHP-FPMだけを再起動します。Apacheモジュール(mod_php)でPHPを実行するサーバーなら、Apacheを再起動します。

ℹ️ 提携について
当サイトのコンテンツにはアフィリエイトリンクが含まれています。訪問者がこのリンクを通じて商品やサービスを購入すると、当サイトは販売元から手数料を受け取ります。この過程において、購入者が支払う金額(イベント割引適用で金額が下がります↓)は上昇しません。掲載されている価格・割引・在庫情報は作成時点のものであり、実際とは異なる場合がありますので、ご購入前に販売元にて最終確認をお願いいたします。商品の選定および評価は独自の基準に基づいて行われており、手数料の支払いの有無は紹介順や評価内容に影響を与えません。

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

人間であることを証明してください: 2   +   9   =