Flarumのキャッシュの詳細とキャッシュの削除方法

Flarumベータ版のキャッシュ問題は、このフォーラムプログラムで発生するさまざまなエラーの主な原因です。たとえば、nojs、管理画面でスタイルを変更したのにフロントエンドに反映されない、言語を切り替えるとエラー表示になり、xxx.xxx.xx と表示される、といった問題です。以下では、Flarumのキャッシュの仕組みについて詳しく説明します。

Flarumのキャッシュは大きく3つの部分に分かれます。

メインキャッシュ（大部分の nojs ページの主な原因）

概要：フォーラムによって生成され、Flarumサイト全体を支えるJSとCSSの結合ファイルです。debugを無効（デフォルト）にすると圧縮された状態になり、debugを有効にすると非圧縮の状態になります。

場所：/assets ディレクトリ内の admin-xxx.css、admin-xxx.js、forum-xxx.js、forum-xxx.css、および rev-manifest.json。

役割：その名のとおり、adminで始まる2つのファイルは管理画面のJSおよびCSSファイルを表し、forumで始まるファイルはサイトのフロントエンドのJSおよびCSSファイルを表します。rev-manifest.json にはこれら4つのファイル名が記録され、サイトを開く際に rev-manifest.json にリクエストを送信して、対応するCSSおよびJSファイルを取得します。

削除：公式では、サイトのルートディレクトリに移動し、php flarum cache:clear と入力して削除することを推奨しています。ただし、この削除では rev-manifest.json は削除されないため、一部のプラグインでは削除後に rev-manifest.json ファイルを手動で削除する必要があります。

ストレージキャッシュ（一部の nojs ページの主な原因）

概要：Flarumが最初に生成するキャッシュファイルです（システムやプラグインからJS、CSSなどを抽出し、ルートディレクトリの /storage 以下に分散して保存します）。その後、CSSとJSを上記のメインキャッシュに結合します。

場所：/storage ディレクトリ内の cache、formatter、less、locale、tmp、views などのフォルダー。

役割：

• cache：通常のキャッシュです。フォーラムで使用されるさまざまなキャッシュ内容が分散して圧縮されています。プラグインを有効にした後に反映されない、または nojs になり、メインキャッシュを削除しても効果がない場合は、このフォルダー内のすべてのファイルを削除してください。通常はこれで解決できます。
• formatter：BBCodeのキャッシュです。カスタムBBCodeを追加した場合（オンライン動画の flarum-ext-mediaembed プラグインを追加または編集した場合を含む）は、必ずこのフォルダー内のファイルを手動で削除してください。
• less：その名のとおり、フォーラムで使用されるすべてのLessキャッシュです（Lessは簡単に言えば、高度なCSS言語であり、FlarumのCSSはすべてLessから生成されます）。プラグインの切り替え後にスタイルエラーが発生した場合は、このフォルダー内のすべてのファイルを削除することを検討してください。
• locale：中国語に切り替えた後、タイトルやボタンなどがすべてxx.xxxx.xxxxと表示される場合は、迷わずこのフォルダー内のファイルをすべて削除してください。ここには言語ファイルがキャッシュされています。
• tmp：フォーラムの一時キャッシュです。通常は自動的に削除されます。
• views：ビューキャッシュです。キャッシュされたCSS、HTMLなどの内容が含まれます。

ブラウザーキャッシュ

これはあまり説明する必要はありません。基本的に、キャッシュを削除するたびに Ctrl + F5 でブラウザーのページを更新する必要があります。Flarumは変更後にブラウザーキャッシュを同期して更新しないためです。

まとめ：Flarumでこれほど多くの問題が発生する主な原因は、やはりFlarumのキャッシュの仕組みにあります。キャッシュされる場所が多く、さらに複数のキャッシュがさまざまな問題によって同期して更新されないことがあります。もちろん、フォーラムをインストールした後に管理画面の設定（特にプラグインの有効化・無効化やプラグイン設定）を変更しなければ、Flarumは依然として非常に安定しています。