WP Super Cache

説明

WP Super Cache プラグインは動的 WordPress ブログから静的 HTML ファイルを生成します。Web サーバーはユーザーからのリクエストがに対して時間のかかる WordPress PHP スクリプトを処理する代わりに生成された HTML ファイルを返します。

このプラグインはユーザーのうち、以下の大部分のユーザーに対して静的 HTML ファイルを返します。

• ログインしていないユーザー
• コメントを書き込んだことのないユーザー
• パスワード保護された投稿を表示していないユーザー

99% のユーザーに対して静的 HTML ファイルが返されるため、1つのキャッシュファイルは何千回も利用されます。他のユーザーに対してはアクセスに応じた個別のカスタムキャッシュファイルが返されます。ユーザーがログインしたり、コメントを残すと、プラグインはその表示と同時に内容をキャッシュします。

プラグインは3つの方法でキャッシュファイルを配信します (速い順):

1. エキスパート。最速の方法は、Apache の mod_rewrite (または Web サーバーがサポートする同様のモジュール) を使って「supercached」静的 HTML ファイルを配信することです。これは PHP を完全にバイパスするため非常に高速です。サーバーに大量のトラフィックが押し寄せても、リクエストが「軽い」ため耐えられる可能性が高くなります。ただし、Apache の mod_rewrite モジュール (カスタムパーマリンクを使用していればおそらくインストール済みです) と .htaccess ファイルの変更が必要です。この変更にはリスクがあり、誤って変更するとサイトがダウンする可能性があります。
2. シンプル。Supercache の静的ファイルを PHP で配信する方式で、このプラグインの推奨の使い方です。「supercached」ファイルが存在すればそれを配信し、mod_rewrite 方式とほぼ同じくらい高速です。.htaccess ファイルを変更する必要がないため、設定も簡単です。カスタムパーマリンクは引き続き必要です。このキャッシュモードでは、ページの一部を動的なままにできます。
3. WP-Cache キャッシング。これは主に、既知のユーザー、パラメーター付き URL、フィードのページをキャッシュするために使用されます。既知のユーザーとは、ログインしているユーザー、コメントを残した訪問者、ユーザーごとのカスタムデータを表示すべき訪問者のことです。最も柔軟なキャッシュ方法ですが、わずかに遅くなります。スーパーキャッシュが無効な場合は、未知のユーザーのアクセスも WP-Cache キャッシングがキャッシュします。このモードではページに動的な部分を含めることもできます。このモードは常に有効ですが、既知のユーザー、パラメーター付き URL、フィードのキャッシュは個別に無効にできます。WP-Cache キャッシングのみを使用したい場合は、wp-config.php で定数 “DISABLE_SUPERCACHE” を1に設定してください。

PHP ファイルの編集に慣れていない場合は、シンプルモードを使用してください。設定が簡単で、とても高速です。

推奨設定

1. シンプルなキャッシュ。
2. 固定ページの圧縮。
3. 既知のユーザー向けのページをキャッシュしない。
4. キャッシュの再構築。
5. CDN に対応。
6. ホームページの追加チェック。

「拒否するユーザーエージェント」テキストボックスの内容を削除して、検索エンジンがキャッシュファイルを生成できるようにすることも検討してください。

「拒否するユーザーエージェント」テキストボックスの内容を削除して、検索エンジンがキャッシュファイルを生成できるようにすることも検討してください。

できるだけ多くの投稿をプリロードし、「プリロードモード」を有効にしてください。古いキャッシュファイルのガベージコレクションは無効になります。サイドバーウィジェットが頻繁に更新されなくてもよい場合は、プリロード間隔を2880分 (2日) に設定すると、すべての投稿が頻繁に再キャッシュされなくなります。プリロードが実行されると、更新対象の投稿のキャッシュファイルが削除され、再生成されます。その後、古いファイル全体のガベージコレクションが実行され、古くなったキャッシュファイルが一掃されます。
プリロードモードが有効でも、投稿が変更されたり、コメントが投稿されたりするとキャッシュファイルは削除されます。

開発

• このプラグインの開発は GitHub 上で活発に行われています。
• プラグインの各言語への翻訳は翻訳ページで行われています。

ドキュメント

以下より詳しい情報が必要な場合は、wiki や 開発者向けドキュメント をご覧ください。

プリロード

プリロードによって、サイトの投稿・カテゴリー・タグのキャッシュファイルを生成できます。プリロードは、他の訪問者と同じようにサイトの各ページにアクセスしながら、キャッシュページを順に生成していきます。この機能は逐次処理のため、投稿が多い場合はサイト全体のプリロードに時間がかかることがあります。
プリロードをより効果的にするには、古いキャッシュファイルが削除されないようにガベージコレクションを無効にすると便利です。これは設定で「プリロードモード」を有効にすることで行えます。ただし、ページはいずれ古くなること、また、コメントの投稿や投稿の編集による更新でキャッシュの一部がクリアされることに注意してください。

ガベージコレクション

キャッシュディレクトリは時間とともにいっぱいになり、サーバーの容量を消費します。容量が限られている場合や容量に応じて課金される場合、またはサイトのキャッシュページが古くなるのが心配な場合は、ガベージコレクションを行う必要があります。ガベージコレクションは定期的に実行され、キャッシュディレクトリ内の古いファイルを削除します。詳細設定ページでは以下を指定できます。
1. キャッシュタイムアウト。キャッシュファイルが新鮮とみなされる時間。この時間を過ぎると古くなり、削除できるようになります。
2. スケジューラー。ガベージコレクションを実行する頻度を設定します。
3. 通知メール。ガベージコレクションジョブの進行状況を受け取れます。
ガベージコレクションの設定に正解や不正解はありません。サイトによって異なります。
サイトが定期的に更新されたり、コメントが付いたりする場合は、タイムアウトを1800秒、タイマーを600秒に設定してください。
サイトがほぼ静的な場合は、タイムアウトに0を入力してガベージコレクションを無効にするか、非常に大きなタイムアウト値を使用してください。

キャッシュディレクトリ (通常は wp-content/cache/) は一時ファイル専用です。重要なファイルや、重要なファイル・ディレクトリへのシンボリックリンクを絶対にそこへ置かないでください。プラグインに書き込み権限があると削除されます。

CDN

コンテンツデリバリーネットワーク (CDN) は通常、世界中に配置されたコンピューターのネットワークで、訪問者に近いサーバーを利用してサイトのコンテンツをより高速に配信します。画像、JavaScript、CSS ファイルなどの静的ファイルをこのネットワークから配信することで、サイトの読み込みを高速化できます。また、自分のドメインのサブドメインから静的ファイルを配信する、いわば「簡易 CDN」を作ることもできます。

基本的な CDN サポートを提供するため、OSSDL CDN off-linker が WP Super Cache に統合されました。これは、サーバー上の wp-content と wp-includes にあるファイル (.php ファイルを除く) の URL を、別のホスト名を指すように書き換えることで動作します。多くの CDN はオリジンプルをサポートしています。これは、ファイルが最初にリクエストされたときに CDN がサーバーから自動的にダウンロードし、設定可能な期間はそのまま配信を続け、期間が過ぎると再びサーバーからダウンロードするという仕組みです。

プラグイン設定ページの「CDN」タブで設定します。これは高度なテクニックであり、Web サーバーや CDN の仕組みについての基本的な理解が必要です。CDN を設定したあとは、必ずファイルキャッシュをクリアしてください。

REST API

このプラグインの設定にアクセスするための REST API エンドポイントが追加されました。使用するには、設定ページを表示する権限を持つ管理者ユーザーとして認証を受ける必要があります。まだドキュメント化されていませんが、これを扱うコードはすべて「rest」ディレクトリにあります。

カスタムキャッシュ

add_cacheaction() 関数を使って、キャッシュ処理にフックできるようになりました。

利用できるフックは3つあります:

1. ‘wp_cache_get_cookies_values’ – WP Cache が使用するキーを変更します。
2. ‘add_cacheaction’ – phase2 で実行されます。プラグインが WordPress のフックを追加できるようにします。
3. ‘cache_admin_page’ – 管理ページで実行されます。新しい設定オプションを追加するなど、そのページを変更するために使用します。

通常の WordPress フィルターも1つあります。キャッシュ前に行われるチェックをカスタマイズするには、
「do_createsupercache」フィルターを使用してください。このフィルターはパラメーターを1つ受け取ります。
WP-Cache の wp_cache_get_cookies_values() 関数の出力です。

WP Super Cache には、WordPress の大部分よりも先に読み込まれる独自のプラグインシステムがあります。独自のプラグインを追加するには、wp-content/plugins/wp-super-cache-plugins ディレクトリに配置するか、プラグインへのフルパスを指定して wpsc_add_plugin( $name ) を呼び出します。

「既知のユーザー」を識別するために使用する Cookie は、wpsc_add_cookie( $name ) と wpsc_delete_cookie( $name ) で変更できます。例として plugins/searchengine.php をご覧ください。

トラブルシューティング

プラグインをインストールしても動作しない場合は、以下の点を確認してください:

1. wp-content にウェブサーバーから書き込めますか ?
2. wp-content/wp-cache-config.php はありますか ? ない場合は、wp-super-cache/wp-cache-config-sample.php ファイルを wp-content/wp-cache-config.php にコピーし、WPCACHEHOME が正しい場所を指していることを確認してください。
3. wp-content/advanced-cache.php はありますか ? ない場合は、wp-super-cache/advanced-cache.php を wp-content/ にコピーする必要があります。コピーしたファイルを編集して、wp-super-cache フォルダーを指すようにパスを変更してください。
4. ページがまったくキャッシュされない場合は、wp-content/advanced-cache.php を削除し、上記の案内に従って作り直してください。

5. 次の行が wp-config.php にあり、「require_once(ABSPATH.’wp-settings.php’);」の行より必ず上にあることを確認してください:

   define( 'WP_CACHE', true );
   

6. 「設定」→「WP Super Cache」ページをもう一度開き、キャッシュを有効にしてください。
7. wp-content/cache/supercache/ を確認してください。そこにディレクトリやファイルはありますか ?
8. PHP の error_log に何か出力されていませんか ?
9. Super Cache のインストール後に、ブラウザーがファイルを保存するよう繰り返し求めてくる場合は、Super Cache の圧縮を無効にする必要があります。「設定」→「WP Super Cache」ページを開き、そこで無効にしてください。
10. 「failed to acquire key 0x152b: Permission denied in…」や「Page not cached by WP Super Cache. Could not get mutex lock.」のようなファイルロックのエラーは、ファイルロックを使用する必要があるかもしれないことを示しています。wp-content/wp-cache-config.php を編集して、「$use_flock = true」のコメントを解除するか、$sem_id を別の値に設定してください。最後の手段として、管理画面からファイルロックを無効にすることもできます。
11. 粗いファイルロックを使用している場合は、cache/wp_cache_mutex.lock がウェブサーバーから書き込み可能になっていることを確認してください。
12. キャッシュフォルダを NFS、Samba、NAS の共有上に置くことはできません。ローカルディスク上に置く必要があります。キャッシュフォルダがローカルマシン上にないと、ファイルのロックや期限切れファイルの削除が正しく動作しません。
13. WordPress が wp-cron.php を見つけられない場合、古いキャッシュファイルのガベージコレクションは動作しません。アクセスログ (access_logs) に wp-cron.php のエントリーがあるか、また、ホスト名がネットワークやインターネット上の他のサーバーが使用する外部 IP アドレスに解決されるかを確認してください。
14. supercache 経由で古いページが訪問者に配信されている場合は、Apache のモジュール (Apache を使っていない場合は、それに相当するもの) が不足している可能性があります。必要なモジュールは mod_mime、mod_headers、mod_expires の3つです。後者の2つは、サイト上の既存ページの新しいバージョンをブラウザーに確実に読み込ませるために、特に重要です。
15. 「WP Super Cache is installed but broken. The path to wp-cache-phase1.php in wp-content/advanced-cache.php must be fixed!」(WP Super Cache はインストールされていますが、正常に動作していません。wp-content/advanced-cache.php にある wp-cache-phase1.php のパスを修正する必要があります !) というエラーメッセージがすべてのページの末尾に表示されます。お好みのエディターで wp-content/advanced-cache.php ファイルを開いてください。wp-cache-phase1.php のパスは正しいですか ? このファイルは通常、wp-content/plugins/wp-super-cache/ にあります。パスが正しくない場合、キャッシュエンジンは読み込まれません。
16. キャッシュが機能しません。ブログを再読み込みするたびにタイムスタンプが変わります。.htaccess のルールに書かれているパスが、supercache ディレクトリの実際の場所と一致しているか確認してください。パスを直接書き込む必要があるかもしれません。supercache モードを無効にしてみてください。

17. supercache のキャッシュファイルが生成されているのに配信されない場合は、wp-content/cache/supercache フォルダーすべて (および wp-content 内の cache フォルダーと supercache フォルダーそれぞれ) と、wp-content/cache/.htaccess のパーミッションを確認してください。PHP が Apache とは別のユーザーで実行されていて、パーミッションが厳しく設定されていると、Apache が PHP が生成したキャッシュファイルを読み取れないことがあります。これを修正するには、wp-config.php に次の行を追加する必要があります (WP_CACHE の定義より上に追加してください)。その後、キャッシュを消去してください。

    umask( 0022 );
    

18. プラグインで圧縮を有効にしたあと、ブラウザーに文字化けしたデータが表示される場合は、Web サーバー側ですでに圧縮が有効になっている可能性があります。Apache では mod_deflate を無効にする必要があります。PHP では zlib 圧縮が有効になっている場合があり、これは3つの方法で無効にできます。root アクセス権がある場合は、php.ini を編集して zlib.output_compression 設定を探し、「Off」になっていることを確認するか、.htaccess に次の行を追加してください:

    php_flag zlib.output_compression off
    

    それでも動作しない場合は、wp-config.php に次の行を追加してください。

    ini_set('zlib.output_compression', 0);
    

19. アンインストール後、WordPress の mod_rewrite ルールも削除した場合は、パーマリンクが機能しなくなることがあります。その場合は、「設定」→「パーマリンク」ページを開き、フォームをもう一度保存してルールを再生成してください。
20. ブログが読み込めない場合は、wp-config.php が正しいか確認してください。PHP の開始タグまたは終了タグが抜けていませんか ?
21. フロントページは正常なのに、投稿や固定ページが404になりますか ? 「設定」->「パーマリンク」に移動し、カスタムパーマリンク構造を選択してから「保存」をクリックしてください。.htaccess ファイルを手動で更新する必要があるかもしれません。

22. サイトで特定の文字が正しく表示されない場合、サーバーが正しく設定されていない可能性があります。使用している文字セットを訪問者に伝える必要があります。「設定」->「表示設定」に移動し、「ページとフィードの文字コード」の値をコピーしてください。Supercache と WordPress のすべてのリライトルールが書かれた .htaccess ファイルを編集して先頭に以下を追加し、CHARSET をコピーした値 (例: ‘UTF-8’) に置き換えてください。

    AddDefaultCharset CHARSET
    

23. 「WP Super Cache is installed but broken. The constant WPCACHEHOME must be set in the file wp-config.php and point at the WP Super Cache plugin directory.」というエラーメッセージがすべてのページの末尾に表示されます。wp-content/advanced-cache.php を削除してプラグイン設定ページを再読み込みするか、wp-config.php を編集して WPCACHEHOME を探し、wp-super-cache フォルダーを指していることを確認してください。通常は wp-content/plugins/wp-super-cache/ ですが、そのファイルへのフルパスが必要になることが多いでしょう (そのため、設定ページに修正させる方が簡単です)。これが正しくないと、キャッシュエンジンは読み込まれません。
24. プラグインが使用するセマフォの数が原因でサーバーに問題が起きている場合、それは一部のユーザーがファイルロックを使用しているためです。ファイルロックは推奨されません (ただし、ごく少数のユーザーには必要です)。定数 WPSC_DISABLE_LOCKING を定義すると、ファイルロックをグローバルに無効化できます。また、定数 WPSC_REMOVE_SEMAPHORE を定義すると、各ページのキャッシュ後に sem_remove() が呼び出されますが、これは同じセマフォを要求する他のプロセスで問題を起こすようです。無効にするのが最善です。
25. プラグインが間違ったディレクトリで .htaccess ファイルを探している場合は、wp-config.php または wp-cache-config.php で変数 $htaccess_path にグローバルの .htaccess のパスを設定してください。これは WordPress を特殊な方法でインストールしている場合に起こることがあります。