문제 해결

• 목록
• 스크랩

문제 증상

CSS나 JS 파일을 수정하여 서버에 업로드했음에도 불구하고, 웹 브라우저에서 새로고침을 해도 변경된 내용이 적용되지 않는 현상이 발생합니다. 이는 브라우저가 이전에 로드했던 파일을 캐시(임시 저장)하고 있어 서버의 최신 파일을 불러오지 않기 때문입니다.

해결 방법: 버전 상수 갱신

그누보드 5.2.3 버전 이상에서는 extend/version.extend.php 파일을 통해 CSS와 JS의 버전을 관리합니다. 이 파일의 상수 값을 변경하면 브라우저가 파일을 새로 다운로드하도록 강제할 수 있습니다.

1. 작업 전 백업

설정 파일을 수정하기 전, 반드시 extend/version.extend.php 파일을 로컬 PC나 서버의 안전한 위치에 복사하여 백업해 두시기 바랍니다. 문제가 발생할 경우 백업본을 복원하여 이전 상태로 되돌릴 수 있습니다.

2. 버전 상수 수정

extend/version.extend.php 파일을 열어 아래와 같이 정의된 상수 값을 임의의 숫자나 날짜 형식으로 변경합니다.

define('G5_JS_VER', '20260912');
define('G5_CSS_VER', '20260912');

3. 파일 호출 경로에 버전 파라미터 추가

테마나 스킨 등 별도로 생성한 파일에 적용하려면 호출하는 경로 뒤에 버전 상수를 쿼리스트링으로 추가해야 합니다.

<!-- CSS 적용 예시 -->
<link rel="stylesheet" href="파일경로.css?ver=<?php echo G5_CSS_VER; ?>">

<!-- JS 적용 예시 -->
<script src="파일경로.js?ver=<?php echo G5_JS_VER; ?>"></script>

적용 후 점검

파일 수정 후 웹 브라우저에서 해당 페이지를 새로고침(F5)하여 변경사항이 정상적으로 반영되었는지 확인합니다. 버전 상수를 변경하면 방문자의 브라우저도 캐시된 파일을 버리고 서버의 최신 파일을 새로 받아오게 되어, CSS 깨짐 현상 등을 방지할 수 있습니다.