아파치 투토리얼: Server Side Includes 소개

가능한 언어: en | - ja | - ko

- -

Server-side includes를 사용하여 HTML 문서에 동적인 내용을 -추가할 수 있다.

소개
SSI가 무엇인가?
SSI가 가능하도록 서버 설정하기
기본 SSI 지시어
추가 예제
이외에 설정할 수 있는 것은?
명령어 실행하기
고급 SSI 기법
결론

소개

관련된 모듈	관련된 지시어
`mod_include` `mod_cgi` `mod_expires`	`Options` `XBitHack` `AddType` `SetOutputFilter` `BrowserMatchNoCase`

- - -

이 글은 보통 SSI라고 부르는 Server Side Includes를 설명한다. - SSI가 가능하도록 서버를 설정하는 방법과 HTML 페이지에 동적인 - 내용을 추가하는 기본적인 SSI 사용법을 소개한다.

- -

이 글의 뒷부분은 SSI 지시어 조건문과 같은 고급기법을 - 설명한다.

- -

SSI가 무엇인가?

- -

SSI (Server Side Includes)는 HTML 페이지에 사용하는 지시어로, - 페이지를 서비스할때 서버가 처리한다. SSI를 사용하면 CGI - 프로그램이나 다른 동적인 기술로 페이지 전체를 만들어서 - 서비스하지 않고도 HTML 페이지에 동적으로 생성한 내용을 추가할 - 수 있다.

- -

SSI를 사용할지 아니면 프로그램으로 페이지 전체를 생성할지 - 결정은 페이지에서 정적인 부분이 많은지와 페이지를 서비스할 - 때마다 어느정도를 다시 계산해야할지에 달렸다. SSI는 현재 - 시간과 같이 적은 정보를 추가하는데 좋다. 그러나 페이지를 - 서비스할때 페이지의 대부분을 생성해야 한다면 다른 방법을 - 찾아봐야 한다.

SSI가 가능하도록 서버 설정하기

- - -

서버가 SSI를 처리하려면 httpd.conf 파일이나 - .htaccess 파일에서 다음 지시어를 사용해야 한다.

- Options +Includes -

- -

그러면 아파치는 파일에서 SSI 지시어를 처리한다. 설정에는 - 보통 여러 Options 지시어가 - 있고, 이 지시어들은 서로 덮어써서 무효로 만들다. 그래서 - 지시어를 맨마지막에 처리하기위해 보통 SSI를 원하는 특정 - 디렉토리에서 Options를 사용한다.

- -

모든 파일에서 SSI 지시어를 처리하는 것은 아니다. 아파치에게 - 어떤 파일을 처리할지 알려줘야 한다. 두가지 방법이 있다. - 하나는 다음과 같은 지시어로 .shtml과 같은 특정 - 파일 확장자를 가진 파일을 처리하는 방법이다.

- AddType text/html .shtml - AddOutputFilter INCLUDES .shtml -

- -

이 방법의 단점은 이미 있는 페이지에 SSI 지시어를 추가하는 - 경우 SSI 지시어를 처리하기위해 .shtml 확장자를 - 부여하기때문에 파일명과 이 페이지의 모든 링크를 변경해야 - 하는 점이다.

- -

다른 방법은 XBitHack - 지시어를 사용하는 방법이다.

- XBitHack on -

- -

XBitHack는 - 실행권한이 있는 파일에서 SSI 지시어를 처리한다. 그래서 이미 - 있는 페이지에 SSI 지시어를 추가한다면 파일명을 변경하지 - 않고 chmod로 파일에 실행권한을 주면 된다.

- chmod +x pagename.html -

- -

하지 말아야 할 것 하나. 가끔 .shtml 파일명에 - 골치를 앓지말고 모든 .html 파일을 SSI 처리하라고 - 충고하는 사람이 있다. 이 사람들은 아마도 XBitHack에 대해 모르는 - 것 같다. 명심할 점은 이렇게 하면 아파치는 파일에 SSI 지시어가 - 없더라도 클라이언트로 보내는 모든 파일을 살펴봐야 한다는 - 것이다. 성능이 매우 느려질 수 있으며, 좋은 생각이 아니다.

- -

물론 윈도우즈에서는 실행권한이란 것이 없기때문에 후자를 - 사용할 수 없다.

- -

내용이 동적이여서 계산하기 어렵기때문에 아파치 기본 설정은 - SSI 페이지의 최근수정일과 content length HTTP 헤더를 보내지 - 않는다. 그래서 문서를 캐쉬하지 못하고 클라이언트가 느끼는 - 성능이 떨어진다. 두가지 해결방법이 있다.

- -

XBitHack Full 설정은 사용한다. 그러면 - 아파치는 포함하는(include) 파일들의 수정일은 무시한체 - 원래 요청한 파일의 날짜만 보고 최근수정일을 알아낸다.
mod_expires에 있는 지시어를 사용하여 - 파일에 직접 만기일을 설정하면 브라우저와 프록시가 문서를 - 캐쉬할 수 있다.

기본 SSI 지시어

- -

SSI 지시어의 사용법은 다음과 같다.

-  -

- -

HTML 주석같이 생겼기때문에 SSI 기능을 가동하지 않아도 - HTML 소스에는 나오지만 브라우저는 무시한다. SSI를 올바로 - 설정하면 지시어를 결과값으로 바꾼다.

- -

element는 다음중 하나다. 다음 회에 더 자세히 설명할 것이다. - 지금은 SSI로 할 수 있는 몇가지 예를 보인다

- -

오늘 날짜

- -

-  -

- -

echo element는 변수값을 그대로 출력한다. - CGI 프로그램에 제공하는 환경변수들 외에도 여러 표준 변수가 - 있다. 또, set element를 사용하여 직접 변수를 - 정의할 수도 있다.

- -

날짜 출력 형식이 마음에 들지 않는다면, 다음과 같이 - config element의 timefmt attribute를 - 사용한다.

- -

-  - Today is  -

- - -

파일의 수정일

- -

- 이 문서는 에 마지막으로 수정되었다 -

- -

이 element도 timefmt 형식 설정에 달렸다.

- - -

CGI 프로그램 결과를 포함하기

- -

일반적인 SSI 사용법중 하나로, 많이들 애용하는 ``방문수 - 카운터'' 같은 CGI 프로그램 결과를 출력한다.

- -

-  -

- - -

추가 예제

- - -

다음은 HTML 문서에 사용할 수 있는 몇가지 SSI 예제다.

- -

이 문서가 언제 마지막으로 -수정되었나?

- -

앞에서 SSI를 사용하여 사용자에게 문서의 최근수정일을 - 알릴 수 있다고 말했다. 그러나 실제 방법은 알려주지 않았다. - 다음 코드를 HTML 문서에 사용하면 페이지에 시간 기록을 남긴다. - 물론 위에서 설명한대로 SSI가 올바로 작동해야 한다.

-  - 이 문서는 에 마지막으로 수정되었다; -

- -

물론 ssi.shtml대신 원하는 실제 파일명을 - 사용한다. 아무 페이지에라도 붙여넣을 수 있는 범용코드를 - 원한다면, 파일명 대신 LAST_MODIFIED 변수를 - 사용한다.

-  - This file last modified  -

- -

timefmt 형식에 대한 자세한 정보는 검색엔진에서 - strftime을 찾아봐라. 문법은 같다.

- - -

표준 페이지 하단을 포함하기

- - -

여러 페이지가 있는 사이트를 관리한다면 페이지 전체를 - 수정하는 것은, 특히 페이지들이 표준 외관을 가지도록 수정하는 - 것은 정말로 괴롭다.

- -

페이지 상단(header)과 하단(footer)을 파일로 포함하여 - 이런 수정의 부담을 덜 수 있다. 모든 페이지에서 - include SSI 명령어를 사용하여 페이지 하단 파일 - 하나를 포함하면 된다. include element의 - file attribute나 virtual attribute로 - 포함할 파일을 지정한다. file attribute는 현재 - 디렉토리에 상대적인 파일경로다. 즉, (/로 시작하는) - 절대파일경로나 경로 안에 ../를 사용할 수 없다. 아마도 서비스하는 - 문서의 상대 URL을 지정할 수 있는 virtual attribute가 - 더 유용할 것이다. 경로를 /로 시작할 수 있지만, 포함하려는 - 파일이 서비스하는 파일과 같은 서버에 있어야 한다.

-  -

- -

나는 보통 이 두가지를 합쳐서 포함할 페이지 하단 파일에 - LAST_MODIFIED 지시어를 넣는다. 포함하려는 파일에도 - SSI 지시어가 나올 수 있으며, 이렇게 포함한 파일이 다른 파일을 - 포함하는 식으로 여러번 계속 포함할 수도 있다.

- - -

이외에 설정할 수 있는 것은?

- - -

시간 형식 config(설정) 외에 두가지를 더 - config(설정)할 수 있다.

- -

보통 SSI 지시어가 잘못되면 다음과 같은 문구가 나온다

- [an error occurred while processing this directive] -

- -

이 문구를 변경하고 싶다면 config element의 - errmsg attribute를 사용하여 변경한다.

-  -

- -

사이트를 서비스하기 전에 모든 SSI 지시어 문제를 해결하여 - 사용자가 이런 문구를 보지 않길 바란다. (그렇지?)

- -

그리고 sizefmt attribute가 반환하는 파일크기 - 형식을 config(설정)할 수 있다. 바이트로 크기를 - 보여주려면 bytes, 적절히 Kb나 Mb로 크기를 - 보여주려면 abbrev를 사용한다.

명령어 실행하기

- - -

나는 다음 달에 작은 CGI 프로그램과 SSI를 같이 사용하는 - 글을 쓸 예정이다. 지금은 exec element로 할 - 수 있는 다른 것들을 설명할 것이다. SSI는 실제 쉘을 (정확히는 - /bin/sh나 Win32를 사용한다면 DOS 쉘) 사용하여 - 명령어를 실행한다. 예를 들어, 다음은 디렉토리 목록을 보여준다.

- <pre> -  - </pre> -

- -

or, on Windows

- <pre> -  - </pre> -

- -

dir 출력에 브라우저가 혼동할 - ``<dir>'' 문자열이 포함되있기때문에, - 윈도우즈에서 이 지시어를 사용하면 결과가 조금 이상할 것이다.

- -

이 기능은 exec 태그에 사용한 어떤 명령어라도 - 실행할 수 있기때문에 매우 위험하다. ``방명록''과 같이 사용자가 - 웹페이지 내용을 수정할 수 있는 환경이라면, 이 기능을 절대로 - 사용해선 안된다. Options 지시어에 - IncludesNOEXEC 아규먼트를 사용하여 SSI를 허용하지만 - exec 기능을 막을 수 있다.

고급 SSI 기법

- - -

내용을 출력하는 기능 외에 아파치 SSI는 변수 설정이 가능하고, - 비교문과 조건문에 이 변수를 사용할 수 있다.

- -

경고

- -

이 글에서 설명하는 대부분의 기능은 아파치 1.2 이후부터 - 사용할 수 있다. 물론, 아파치 1.2 이상을 사용하지 않는다면 - 아마도 빨리 업그레이드해야 한다. 해라. 지금 해라. 기다릴 - 것이다.

- - -

변수 설정

- -

set 지시어를 사용하여 나중에 사용할 변수를 - 설정할 수 있다. 앞으로 변수가 필요하기때문에 먼저 설명한다. - 문법은 다음과 같다.

-  -

- -

다음과 같이 값을 문자그대로 설정하지 않고 환경변수나 위에서 설명한 변수(예를 - 들어, LAST_MODIFIED)와 같이 다른 변수를 사용하여 - 변수값을 설정할 수도 있다. 이때 변수명 앞에 달러 표시($)를 - 붙여서 문자열이 아닌 변수임을 표시한다.

- -

 -

- -

변수값에 달러 문자를 그대로 입력하려면 달러 표시 앞에 - 백슬래쉬를 사용한다.

-  -

- -

마지막으로 긴 문자열 중간에 변수를 사용하는데 뒤에 있는 - 문자도 변수명으로 오인하여 혼동되는 경우, 변수명을 대괄호로 - 묶어서 확실히 한다. (좋은 예를 찾기 힘들지만, 무슨 말인지 - 이해하길 바란다.)

-  -

- - -

조건 표현식

- - -

변수를 설정하고 비교할 수 있으니 조건문이 가능하다. 이제 - SSI가 일종의 간단한 프로그래밍언어가 된다. - mod_include는 조건문을 만드는 if, - elif, else, endif - 구조를 제공한다. 실제 한 페이지로 여러 논리적인 페이지를 - 만들 수 있다.

- -

조건문 구조는 다음과 같다.

-  -  -  -  -

- -

test_condition에는 어떤 논리비교라도 사용할 - 수 있다. 값을 다른 값과 비교하거나, 특정 값이 ``참''인지 - 검사한다. (문자열이 비어있지 않으면 참이다.) 사용가능한 - 비교 연산자를 모두 보려면, mod_include - 문서를 참고하라. 다음은 조건문을 사용한 몇가지 예제다.

- -

설정파일에 다음 줄을 추가한다.

- BrowserMatchNoCase macintosh Mac - BrowserMatchNoCase MSIE InternetExplorer -

- -

클라이언트가 맥킨토시에서 실행하는 Internet Explorer라면 - 환경변수 ``Mac''과 ``InternetExplorer'' 모두 참으로 설정한다.

- -

그리고 SSI 문서에 다음과 같이 적는다.

-  - 여기에 사과문가 나온다 -  - 여기에 멋진 JavaScript 코드가 나온다 -  -

- -

내가 매킨토시 IE에 반감이 있는 것은 아니다. 나는 단지 - 저번주에 다른 곳에서는 문제가 없는 JavaScript 코드가 매킨토시 - IE에서는 동작하지 않아서 몇시간을 고생했다. 위는 임시 - 해결책이다.

- -

(직접 정의하였건 일반 환경변수이건) 어떤 변수라도 조건문에 - 사용할 수 있다. 아라치는 SetEnvIf나 다른 관련 - 지시어로 환경변수를 설정할 수 있기때문에 CGI 없이도 멋지게 - 동적인 내용을 만들 수 있다.

- -

결론

- -

SSI는 확실히 CGI나 동적인 웹페이지를 생성하는 다른 기술을 - 대체할 수 없다. 그러나 많은 추가 작업없이 페이지에 동적인 - 내용을 조금 추가하기에는 훌륭한 방법이다.