홈페이지 만들기

SERVER SIDE INCLUDE

SSI(Server Side Include)란 그 단어 자체에서 의미 하듯이 Client(브라우저)보다는 Server에 관련된 문법이다. 또한 여러 HTML tag들과도 많은 차이가 있다.
일반적으로 서버의 역할은 브라우저에서 요구한 파일을 전송하여 주기만 하는 것이다. 따라서 대부분의 tag들을 번역하고 처리하는 것은 Client의 몫이다. 그러나, SSI의 경우는 Server(HTTPd)에서 tag을 처리하게 된다. 아래의 예를 보면 그 과정을 이해할 수 있다.

실제 파일 소스 코드 브라우저에서 받은 코드

<h2>SSI의 예</H2>  <p>End of Contents <h2>SSI의 예</H2> <B>다른 파일</B> "include.html" was included! <p>End of Contents

include.html의 내용

<B>다른 파일</B>

        "include.html" was included!

브라우저에서는 를 단지 주석문으로 처리하고 출력하지 않는다. 그런데 위의 예와 같이 특정한 형태로 사용된 경우에는 서버에서 파일의 내용을 그대로 브라우저로 보내지 않고, 서버의 문법에 따라 그 내용을 일단 가공한 다음 보내게 된다. 위의 경우는 지정된 다른 파일을 삽입하여 브라우저에 보내게 된다.

모든 서버들이 SSI를 지원하는 것은 아니다. 또한 서버의 종류와 버전에 따라 그 문법이 다를 수 있다. 따라서 자신이 사용하는 HTTPd의 SSI 문법에 적합하게 만들어야 한다. 그러나 서버마다 그 문법이 크게 다르지는 않다. 여기서는 NCSA HTTPD (버전 1.4이상)을 기준으로 설명한다.
SSI를 사용하기 위해서는 HTTPd의 conf 파일을 수정하여야 한다. access.conf의 Options directive에서 Includes 또는 IncludesNOEXEC를 지정하여야 한다. 그리고 srm.conf에 AddType directive를 사용하여 다음과 같이 MIME type을 등록하여야 한다.
AddType text/x-server-parsed-html .shtml
이렇게 하면 SSI를 사용하고자 하는 파일의 확장자를 .shtml로 제한하게 된다. 만약 모든 HTML 문서에서 SSI를 사용하고자 한다면 다음과 같이 하여야 한다.
AddType text/x-server-parsed-html .html

SSI에서 사용되는 형태는 다음과 같으며, 이때 대소문자를 구별하여야 한다.

SSI 출력형식에 관한 형식을 지정/변경한다.

errmsg SSI 처리과정에서 에러가 발생한 경우(예를 들면, include할 파일이 존재하지 않는다거나)에 출력될 에러 메시지의 내용을 지정한다.

timefmt  등과 같은 시간 출력에 새 형식을 지정한다. 이때 그 형식은 C library 함수인 strftime의 specifiers와 같다.
sizefmt 에서 파일 크기 출력형식을 정한다. "bytes"는 byte 단위, "abbrev"는 Kbyte단위로 출력한다. 기본값(default)은 "abbrev"이다.

errmsg	SSI 처리과정에서 에러가 발생한 경우(예를 들면, include할 파일이 존재하지 않는다거나)에 출력될 에러 메시지의 내용을 지정한다.
timefmt	<!--#flastmod ... --> 등과 같은 시간 출력에 새 형식을 지정한다. 이때 그 형식은 C library 함수인 strftime의 specifiers와 같다.
sizefmt	<!--#fsize ... -->에서 파일 크기 출력형식을 정한다. "bytes"는 byte 단위, "abbrev"는 Kbyte단위로 출력한다. 기본값(default)은 "abbrev"이다.

지정된 파일을 삽입한다.

virtual virtual path; anchor에서 지정하는 path와 같다. "/index.html" , "/~someone/intro.html"과 같은 절대 path로 지정한다.
file 현재 문서에 대한 상대 path로 지정된다. 단, 상위디렉토리(../filename.html)는 지정할 수 없다.

virtual	virtual path; anchor에서 지정하는 path와 같다. "/index.html" , "/~someone/intro.html"과 같은 절대 path로 지정한다.
file	현재 문서에 대한 상대 path로 지정된다. 단, 상위디렉토리(../filename.html)는 지정할 수 없다.

환경변수(enviroment variable)의 값을 출력한다. CGI환경 변수 및 다음 변수들을 사용할 수 있다.

DOCUMENT_NAME 현재 파일의 이름
DOCUMENT_URI 현재 파일의 virtual path
QUERY_STRING_UNESCAPED The unescaped version of any search query the client sent, with all shell-special characters escaped with \.
DATE_LOCAL 현지 시각 (config의 timefmt가 지정되면 그 형식으로 출력)
DATE_GMT GMT 표준 시각 (cofng의 timefmt가 지정되면 그 형식으로 출력)
LAST_MODIFIED 현재 파일의 내용이 최근 변경된 시간 (cofng의 timefmt가 지정되면 그 형식으로 출력)

파일의 크기를 출력. virtual과 file은 include에서와 동일하게 사용된다. config의 sizefmt에 따른다.

파일의 최근 변경 시각 출력. virtual과 file은 include에서와 동일하게 사용된다. config의 timefmt에 따른다.

커맨드나 CGI script를 실행하여 그 결과를 출력한다. 이때 커맨드에 인수(argument)를 전달할 수는 있으나, CGI에 쿼리(query)를 전달할 수는 없다.

 ○
 ×

[사용예]

[서버의 소스코드]

<title>SSI Ex</title>
<h1 align=center>Server Side Include</h1>

<p>configurating time format
<!--#config timefmt="The time is %A. %I:%M %p %Z"-->

<P>file size<br>
<!--#fsize file="ssi.html"-->
<!--#config sizefmt="bytes"-->
<!--#fsize file="ssi.html"-->

<p>last modified time<br>
<!--#flastmod file="ssi.html"-->
<br>/index.html <!--#flastmod virtual="/index.html"-->
<br>/~gang/index.html <!--#flastmod virtual="/~gang/index.html"-->

<p>execution<br>
<!--#exec cmd="who am i"-->

<p>echo document name<br>
<!--#echo var="DOCUMENT_NAME"-->

[브라우저에서 받은 소스코드]

<title>SSI Ex</title>
<h1 align=center>Server Side Include</h1>

<p>configurating time format


<P>file size<br>
   1K

540

<p>last modified time<br>
The time is Thursday. 09:52 AM KST
<br>/index.html The time is Tuesday. 05:08 PM KST
<br>/~gang/index.html The time is Friday. 10:32 PM KST

<p>execution<br>
nobody   tty??   Mar  7 09:52


<p>echo document name<br>
ssiex.html

참고한 페이지들

NCSA HTTPd Tutorial:Server Side Includes (SSI): http://hoohoo.ncsa.uiuc.edu/docs/tutorials/includes.html
Server-Side-Includes Tutorial: http://web.sau.edu/~mkruse/www/info/ssi.html

DOCUMENT_NAME	현재 파일의 이름
DOCUMENT_URI	현재 파일의 virtual path
QUERY_STRING_UNESCAPED	The unescaped version of any search query the client sent, with all shell-special characters escaped with \.
DATE_LOCAL	현지 시각 (config의 timefmt가 지정되면 그 형식으로 출력)
DATE_GMT	GMT 표준 시각 (cofng의 timefmt가 지정되면 그 형식으로 출력)
LAST_MODIFIED	현재 파일의 내용이 최근 변경된 시간 (cofng의 timefmt가 지정되면 그 형식으로 출력)

<!--#exec cmd="finger gang@phya.yonsei.ac.kr"-->	○
<!--#exec cgi="/cgi-bin/finger?gang@phya.yonsei.ac.kr"-->	×