Flarum 캐시 자세히 알아보기 및 캐시 삭제 방법

Flarum 베타 버전의 캐시 문제는 이 포럼 프로그램에서 발생하는 여러 오류의 주요 원인입니다. 예를 들면 nojs, 관리자 페이지에서 스타일을 변경했지만 프론트엔드에 반영되지 않는 문제, 언어를 전환할 때 오류가 표시되며 xxx.xxx.xx로 나타나는 문제 등이 있습니다. 아래에서 Flarum의 캐시 메커니즘에 대해 자세히 설명하겠습니다.

Flarum의 캐시는 크게 세 부분으로 나뉩니다.

주요 캐시（대부분 nojs 페이지의 주요 원인）

소개: 포럼에서 생성되며 전체 Flarum 웹사이트의 JS와 CSS 병합 파일을 구성합니다. debug를 끄면（기본값）압축 상태가 되고, debug를 켜면 비압축 상태가 됩니다.

위치: /assets 디렉터리 아래의 admin-xxx.css, admin-xxx.js, forum-xxx.js, forum-xxx.css 및 rev-manifest.json입니다.

역할: 이름 그대로 admin으로 시작하는 두 파일은 관리자 페이지의 JS 및 CSS 파일을 나타내고, forum으로 시작하는 파일은 웹사이트 프론트엔드의 JS 및 CSS 파일을 나타냅니다. rev-manifest.json에는 이 네 파일의 이름이 기록되며, 웹사이트를 열 때 rev-manifest.json으로 요청을 보내 해당 CSS 및 JS 파일을 가져옵니다.

삭제: 공식적으로는 웹사이트 루트 디렉터리로 cd한 후 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은 여전히 매우 안정적입니다.