Nextcloudの「PHP OPcacheが正しく設定されていません」という警告を修正する

Nextcloudが「PHP OPcacheが正しく設定されていません」と報告した場合、古いフォーラムの投稿から大きなチューニングブロックを貼り付けるのが正しい解決策ではありません。まず、NextcloudがどのOPcacheの制限または設定に異議を唱えているのかを特定し、次にWebサーバーで実際に使用されているPHP設定を変更してください。

現在のNextcloud 35の管理ドキュメントでは、OPcacheは重要なPHPパフォーマンスレイヤーとして扱われています。Nextcloudによると、OPcacheのサイズ制限が割り当てられた容量の90%を超えると、管理パネルで関連する警告が表示されます。また、キャッシュされたコードコメントは保持される必要があります。PHPのマニュアルには、関連するディレクティブとそのデフォルト値が記載されています。これらの事実を踏まえると、OPcacheをより安全に調整する方法がわかります。つまり、制約のあるリソースのみを増やし、必要な動作を有効にしたままにし、特別な理由がない限り、アップグレードを複雑にする変更は避けるべきです。

NextcloudのOPcache警告が通常意味すること

OPcacheはコンパイル済みのPHPバイトコードを共有メモリに保存するため、PHPはリクエストごとに同じアプリケーションファイルを解析してコンパイルする必要がありません。Nextcloudはこの機能をパフォーマンス向上機能として説明しており、PHPはPHP 5.5以降、Zend OPcacheをコアに組み込んでいます。

警告が表示される理由は複数あります。最も一般的なケースは、OPcache の容量がほぼ満杯になっている場合、Web SAPI で OPcache が無効になっている場合、またはコメントの保持などの必須の動作が変更された場合です。Nextcloud の現在のチューニング ガイドでは、OPcache のサイズ制限が割り当ての 90% を超えるとサイズ警告が表示され、明示的に が必要であるとされていますopcache.save_comments = 1。

公式リファレンス: Nextcloud サーバーチューニングと OPcache ガイダンス、Nextcloud PHP 設定に関する注意事項、およびPHP OPcache ランタイム設定。

警告に基づいて修正方法を選択し、万能なブロックは使用しないでください。

PHPは現在、 のデフォルト値として 128 MB opcache.memory_consumption、 のデフォルト値として 8 MB opcache.interned_strings_buffer、 のデフォルト値として 10,000 MB を挙げていますopcache.max_accelerated_files。これらのデフォルト値はあくまで参考値であり、Nextcloudの普遍的な目標値ではありません。小規模な個人サーバーであればこれらの値に近い値でも問題ないかもしれませんが、多くのアプリケーションを搭載した大規模なインストールでは、より多くのメモリが必要になる場合があります。

ステップ1：Nextcloudが実際に使用しているPHP構成を確認する

これは、多くの修正失敗を防ぐための手順です。Nextcloud のドキュメントには、Web サーバーとコマンドライン PHP が異なる設定ファイルを読み込むことができると記載されています。Debian および Ubuntu スタイルのシステムでは、一般的なパスには/etc/php/<version>/fpm/php.ini、、、、/etc/php/<version>/apache2/php.iniが含まれます/etc/php/<version>/cli/php.ini。

実行してphp --iniCLIの設定を確認してください。ただし、PHP-FPMやApacheで使用されているファイルと同じであるとは限りません。Web SAPIの場合は、phpinfo()保護してすぐに削除できる場合にのみ一時ページを使用するか、PHP-FPMのプール/サービス設定とディストリビューション固有のモジュールファイルを確認してください。

推奨事項： NextcloudがNginxまたはPHP-FPMを使用するApacheの背後で動作している場合は、FPMのOPcache設定を変更してください。Apacheがmod_phpを使用している場合は、ApacheのPHP設定を変更してください。バックグラウンドジョブで同じ動作が必要な場合は、CLI設定を統一してください。ただし、ブラウザの警告はWebリクエストパスによって生成されることに注意してください。

ステップ2：問題を解決する最小限のOPcacheディレクティブセットを編集する

控えめなサーバーの保守的な例を以下に示します。数値はあくまでも出発点であり、保証値ではありません。

[opcache]
opcache.enable=1
opcache.memory_consumption=128
opcache.interned_strings_buffer=16
opcache.max_accelerated_files=10000
opcache.save_comments=1

NextcloudがOPcacheメモリがほぼ満杯だと具体的に警告する場合、サーバーに十分な空きRAMがあれば、128MBから256MBに増やすのは妥当な増分変更と言えるでしょう。警告がインターン化された文字列やキャッシュされたスクリプトを指している場合は、メモリだけでなく、それらの制限値も引き上げてください。メモリが制限されているVPSでは、いきなり512MBに増やすと、PHP-FPMワーカー、データベース、Redis、およびオペレーティングシステムで使用できるRAMが減少する可能性があります。

再検証設定についてはどうでしょうか？

Nextcloudの現在のチューニングガイドによると、PHPはデフォルトで2秒ごとにキャッシュされたスクリプトの変更をチェックしますが、このデフォルト設定を変更することは推奨されていません。この値を上げるとopcache.revalidate_freqファイルシステムのチェック回数を減らすことができますが、その代償として運用上の問題が発生します。アプリケーションのアップグレードや編集がconfig.php反映されるまでに時間がかかる場合があります。タイムスタンプ検証を完全に無効にすると、より積極的な設定となり、OPcacheを手動でクリアするかPHPを再起動するまで古いコードがアクティブなままになることがあります。

警告を解消することだけを目的とするほとんどの管理者は、デプロイメントのワークフローを理解していない限りopcache.validate_timestamps、opcache.revalidate_freq通常の動作のままにしておくべきです。Nextcloudは、再検証が変更された場合、古いキャッシュされたコードが原因でアップグレード後に異常な動作が発生する可能性があると具体的に警告しています。

ステップ3：適切なPHPサービスを再起動します

INIファイルを変更した後は、NextcloudをホストしているPHPプロセスを再起動またはリロードしてください。典型的な例としては、systemctl restart php8.2-fpmPHP-FPMの場合や、mod_phpを使用している場合のApacheの再起動/リロードなどが挙げられます。バージョンとサービス名は、ご使用のシステムで実際に実行されているものに置き換えてください。

再検証動作を変更した場合は、この点がさらに重要になります。適切なサービスを再起動することで、新しいOPcache構成が確実にロードされ、古いバイトコードに関する曖昧さが解消されます。

ステップ4：値を確認するだけでなく、Web SAPIも確認します。

便利なコマンドラインチェックには以下が含まれます。

php --ini
php -i | grep -i opcache

これらのコマンドは、PHPがディレクティブを認識していることを確認できますが、CLI構成のみを証明するものです。Nextcloudの警告が消えない場合は、Web SAPIで読み込まれた構成とCLIの結果を比較してください。これは、個別のcli、、fpmおよびapache2INIツリーを保持しているシステムでは特に重要です。

ステップ5：管理画面 > 概要を再確認する

PHPサービスの再起動後、Nextcloud管理画面の概要を更新してください。警告が消えた場合は、設定が正しいSAPIによって読み込まれており、報告されたしきい値を超えていないことを意味します。

警告が解消されない場合は、値を無作為に増やし続けないでください。以下の4つの点を順番に確認してください。正しいINIファイルを編集したか、後から読み込まれた別のINIファイルが設定を上書きしていないか、関連するPHPサービスが再起動されたか、警告で指定されているOPcacheリソースが、実際に値を増やしたリソースと異なるか。

OPcacheメモリにはどれくらいの容量を割り当てるべきですか？

最適な値は一つではありません。適切な目標は、キャッシュが常に限界に近づかないように十分な余裕を持たせつつ、スタックの他の部分にリソースを不足させないようにすることです。小規模なVPSの場合は、控えめな値から始めてメモリ負荷を監視してください。アプリケーションが多いインスタンスやPHPコードのサイズが大きいインスタンスでは、実際のOPcacheの使用状況から128MBでは不十分だと判断された場合、256MB以上が妥当な値となる可能性があります。大規模なサーバーでは、メモリサイズはPHP-FPMワーカー数やその他の共有サービスと合わせて検討する必要があります。

実用的な比較は簡単です。OPcacheメモリを増やすとキャッシュの削除と再コンパイルを減らすことができますが、OPcacheメモリを減らすと、同時実行されるPHPワーカーやデータベースに使用できるRAMが増えます。サーバーが受け入れ可能な最大値ではなく、測定された使用状況とNextcloudが報告する警告に基づいて選択してください。

警告が消えない原因となるよくある間違い

• CLI PHPのみを編集する場合：ブラウザは引き続きPHP-FPMまたはmod_phpを使用します。
• 制限値を誤って引き上げる：メモリを増やしても、アクセラレーテッドファイルテーブルが満杯になった問題は解決しない。
• 再起動を忘れた場合：実行中のPHPプロセスには、古いINI値が残っている可能性があります。
• 無効化opcache.save_comments: Nextcloudではコメントの保存が必要です。
• 古いチューニング設定をコピーする：古いガイドでは、アップグレード時に問題を引き起こすような積極的な再検証設定を推奨している場合があります。

サーバーの種類に応じた推奨アプローチ

小規模な個人用Nextcloudサーバー：再検証のデフォルト設定を維持し、コメントを保持し、実際にしきい値を超える制限値のみを引き上げます。これにより、RAM使用量と運用上の予期せぬ問題を最小限に抑えます。

ビジーなマルチユーザーサーバー： OPcacheの使用状況を監視し、管理者警告で負荷が高いと示されている場合は、より多くの余裕を持たせる。OPcacheメモリをPHP-FPMワーカーのサイズ設定と連携させ、一方の最適化によってシステム全体でスワッピングが発生しないようにする。

マネージドホスティングまたはコンテナイメージの場合：まず、PHP設定をどこで上書きするかを特定します。一時的なコンテナ内のファイルを編集すると、再デプロイ後に設定が失われる可能性があります。また、プロバイダによっては、コントロールパネルや環境設定を通じてカスタムINI値を公開している場合があります。

最終確認

正しい修正方法は3つの要素から成ります。NextcloudのWeb PHPプロセスでOPcacheが有効になっていること、必要な動作がopcache.save_comments=1維持されていること、そして容量不足に陥っていた特定のOPcacheリソースに十分な余裕があることです。これらの条件が満たされ、PHPが再読み込みされると、過剰なメモリ割り当てや危険なキャッシュ検証の変更を行うことなく、警告は解消されるはずです。