도아 :: 태터툴즈 1.x의 .htaccess 문제

를 방문했다가 이번에 버전업된 1.0.4의 경우 루트에 index.php 파일이 없는데 어떻게된 일인지를 묻는 질문을 보았다. 사실 대부분의 사람들은 루트에 당연히 index.php 파일이 있어야 하는 것으로 알고 있다.

사실 태터툴즈 의 index.php 파일을 삭제해도 태터툴즈는 정상적으로 동작한다. 그 이유는 바로 mod_rewrite 모듈때문이다. 이 모듈은 쉽게 말해서 요청된 URL 을 서버상에서 실시간으로 변경할 수 있는 모듈이다. 태터툴즈의 경우 하위 버전과의 호환성과 동작의 상당수를 이 모듈에 의존한다. 따라서 mod_rewrite 모듈을 지원하지 못하는 서버에는 1.x 버전을 깔 수 없다.

그러면 루트에 index.php 파일이 없어도 정상적으로 동작하는 이유는 무었일까? 조금 이상하게 생각할지 모르지만 그 핵심은 .htaccess 에 있다. .htaccess의 내용을 보면 다음과 같은 내용이 포함되어 있다.

RewriteRule ^$ blog/index.php [E=SURI:1,L] 아무것도 아닌 것 같지만 이 문장이 의미하는 바는 요청한 로컬 주소에 경로나 파일이 포함되어 있지 않으면 blog/index.php 파일을 호출하라는 의미이다. 여기서 ^는 정규식 에서 시작을 의미하며, $는 끝을 의미한다. 시작과 끝 사이에 아무런 문자도 존재하지 않기때문에 사용자가 http://offree.net/처럼 주소를 입력하면 루트의 index.php 파일이 아니라 blog/index.php 파일이 호출된다.

이 줄 바로 밑에는 다음과 같은 행이 포함되어 있는 것을 알 수 있다.

RewriteRule ^[0-9]+$ blog/item.php [E=SURI:1,L]

이 문장의 의미는 로컬 주소가 하나 이상의 숫자([0-9]+)로 구성되어 있으면 blog/item.php 파일을 호출하라는 의미이다. 즉, 주소가 http://offree.net/454 처럼되어 있으면 blog/item.php 파일이 호출된다는 의미이다. 태터툴즈 0.9 버전에서는 RSS 피드로서 /index.xml 파일을 사용했고, 1.x에서는 /rss를 사용한다. 그러나 어떤 주소를 입력해도 동일한 RSS 피드가 생성된다. 그 이유는 다음의 두 문장때문이다.

RewriteRule ^index\.xml$ blog/rss/index.php [E=SURI:1,L] RewriteRule ^(.+)$ blog//index.php [E=SURI:1,L]

첫번째 문장은 요청한 로컬 주소가 index.xml 파일인 경우 blog/rss/index.php를 호출하는 문장이며, 두번째 문장은 요청한 로컬 주소가 임의의 문자로 구성되어 있으면 blog/임의의 문자/index.php 파일을 실행하는 문장이다. 만약 예를 들어 rss를 요청한 경우 blog/rss/index.php를 호출하게된다. 따라서 주소에 index.xml를 입력하든 rss를 입력하던 동일한 결과를 얻게된다.

조금 혼란스러워 보이지만 이 모든 것은 Perl의 정규식 을 사용한 것(PHP 의 경우 PREG 함수)이다. Perl의 정규식에대해 알고 싶다면 필자의 CGI 강좌 중 문자열 일치와 대치와 변환을 참고하면 된다. 아울러 아파치의 mod_rewrite에 알고 싶다면 Apache mod_rewrite 와 바로 적용할 수 있는 예제로 가득찬 URL Rewriting Guide 를 참조하기 바란다.

얘기가 잠시 옆길로 샛다. 2004년부터 지금까지 블로그를 운영하면서 트래픽 초과가 발생한 일이 없었기때문에 400M의 트래픽도 충분할 것으로 알고 Cafe24.com

의 64bit 광절약형을 선택했다. 그런데 어제 트래픽 초과가 발생하는 것을 보고 태터툴즈 플러그인

중 트래픽을 표시해주는 플러그

인을 설치했다. 플러그인이 정상적으로 동작하는지 확인하기위해 블로그

에 접속하자 그림과 같은 오류 메시지가 나타나는 것이었다.

물론 오류 메시지처럼 경로가 틀려서 발생한 문제일 수도 있다. 그러나 필자의 경우 블로그 주소가 http://offree.net/이므로 트래픽 주소는 http://offree.net/throttle-me가 맞다. 사실 오류는 주소가 틀려서 발생한 것이 아니라 태터툴즈에서 .htaccess 파일을 생성하면서 트래픽에대한 부분을 고려하지 않았기때문에 발생한 현상이다. 이러한 현상이 발생하게된 원인은 다음 문장이다.

RewriteCond %{REQUEST_FILENAME} -d RewriteRule ^(.+[^/])$ / [L]

이 문장은 요청한 파일 이름이 디렉토리이면 자동적으로 파일 이름에 /를 붙여주는 문장이다. /throttle-me는 서버의 설정에따라 다소 달라지겠지만 링크된 디렉토리로 간주된다. 따라서 /throttle-me를 요청하면 주소는 자동적으로 /throttle-me/ 로 변경된다. 실제 이 주소를 입력해보면 알 수 있지만 이 주소를 입력하는 경우 서버에 따라 404 File not found 메시지가 나타난다. 따라서 이 문제를 고치려면 .htaccess 파일을 다음처럼 수정하면 된다.

RewriteEngine On RewriteCond %{REQUEST_FILENAME} /throttle-me RewriteRule (.*) - [L] RewriteCond %{REQUEST_FILENAME} /twatch RewriteRule (.*) - [L] RewriteCond %{ENV:REDIRECT_SURI} !^$ RewriteRule (.*) - [L] RewriteCond %{REQUEST_FILENAME} -d RewriteRule ^(.+[^/])$ / [L] RewriteRule ^$ blog/index.php [E=SURI:1,L] RewriteRule ^[0-9]+$ blog/item.php [E=SURI:1,L] RewriteRule ^favicon\.ico$ blog/favicon.ico.php [E=SURI:1,L] RewriteRule ^index\.gif$ blog/index.gif.php [E=SURI:1,L] RewriteCond %{QUERY_STRING} (^|&)pl=([0-9]+) RewriteRule ^index\.php$ %2 [NE,L] RewriteRule ^index\.php$ blog/index.php [E=SURI:1,L] RewriteRule ^index\.xml$ blog/rss/index.php [E=SURI:1,L] RewriteCond %{REQUEST_FILENAME} -f [OR] RewriteCond %{REQUEST_FILENAME} -d RewriteRule !^(blog|cache)/ - [L] RewriteRule ^(entry|attachment|category|keylog|tag|search|plugin)/? blog//index.php [E=SURI:1,L] RewriteRule ^(.+)/[0-9]+$ blog//item.php [E=SURI:1,L] RewriteRule ^(.+)$ blog//index.php [E=SURI:1,L]

여기서

RewriteCond %{REQUEST_FILENAME} /twatch RewriteRule (.*) - [L]

는 필자가 TraceWatch를 웹 통계 프로그램으로 사용하기 때문에 삽입한 부분이다. 만약 TraceWatch를 웹 통계 프로그램으로 사용하지 않는 경우에는 이 두줄을 삭제하면된다. 이 코드를 삽입한 이유는 웹 통계 보기 주소에 해당하는 http://offree.net/twatch를 입력하면 그림처럼 페이지가 비정상적으로 표시되며, 꼭 twatch/처럼 /를 입력해야 정상적으로 표시되기 때문이다.