Server Side Include

サーバサイドインクルード

サーバサイドインクルード機能はNCSA WWWサーバが最初に開発した機能で、ファイルがユーザに送信される前にHTMLファイルの中に記述された環境変数の値、スクリプトの実行結果、ファイルを含ませてから送信する機能です。例えば、アクセスした時の時刻を表示させたり、ログインしているユーザを表示させたりする場合に用いられます。

サーバサイドインクルードは、次の一般形式を持ちます。ちょうど、HTMLのコメントを拡張したものです。

<!--#コマンド タグ1="値1" タグ2="値2" -->

コマンドには次のようなものがあり、コマンドによってタグが決まります。

config
configコマンドは次のタグがあります。
- errmsgはエラーがあった場合にクライアントにメッセージを送り返します。なお、エラーがあった時に、サーバのエラーログに書き込まれます。
- timefmtは日付を送る場合に新しいフォーマットを与えます。これは、Unix の strftime関数と互換があります。
- sizefmtはファイルのサイズを表示する時に使われる単位を指定します。(bytes、kilobytes、megabytes)
include
別のファイル(書類)を挿入する際に使われます。
- virtualはWWWで使用されているDOCUMENT_ROOTパスを使用します。
- fileは現ディレクトリとの関係でパス名を指定します。このパス名の中に ../や、絶対パス名は使用できません。
下記にDOCUMENT_ROOTパスを使用した例を示します。
```

       
```
echo
echo はHTTPの環境変数を出力する際に使われます。以下のように記述すると、時刻と最新変更日時が表示されます。
```
The current date is 
Last modified: 
       
```
fsize
fsizeは指定したファイルのファイルサイズを出力します。 includeコマンドと同じタグが有効で、フォーマットは configコマンドのsizefmtで決められたものです。
```
This file is  bytes.
       
```
flastmod
flastmodは指定されたファイルの更新日時を出力します。
exec
execはシェルコマンドまたはCGIスクリプトを実行します。次のタグが使用できます。
- cmdは/bin/shを使って実行されます。
- cgiはCGIスクリプトを実行します。
```

       
```

また、次の環境変数が利用できます。

環境変数意味例

DOCUMENT_NAME 現ファイル

DOCUMENT_URI ファイルの仮想パス

QUERY_STRING_UNESCAPED デーコードできない文字列

DATE_LOCAL ローカルタイムゾーンの日時

DATE_GMT GMTの日時

LAST_MODIFIED 最後にファイルを変更した日時

環境変数	意味	例
`DOCUMENT_NAME`	現ファイル
`DOCUMENT_URI`	ファイルの仮想パス
`QUERY_STRING_UNESCAPED`	デーコードできない文字列
`DATE_LOCAL`	ローカルタイムゾーンの日時
`DATE_GMT`	GMTの日時
`LAST_MODIFIED`	最後にファイルを変更した日時

簡単な例として、次の例を見てみましょう。

Access Date: <STRONG><!--#exec command="date"--></STRONG><P>
<!--#include file="foo.txt"-->

foo.txtには次のファイルを書いておきます。

<H2>Test</H2>

This is a test.

こうすることによって、アクセスした時の日時とfoo.txt が自動的に読み込まれます。

サーバサイドインクルードの例

また、NCSA httpd では .shtmlという接尾辞のついたファイルは自動的にそのファイルがサーバサイドインクルード(SSI)として扱われます。例えば、以下のようなtraceroute.shtmlというファイルを作成しておきます。

<TITLE>Traceroute</TITLE>
<H2>How do I get from here to there?</H2>
<PRE>
<!--#exec cmd="/usr/sbin/traceroute $REMOTE_ADDR"-->
</PRE>

そして、このファイルへのアンカーを作成しておくと、そのアンカーをクリックすると、WWWサーバからクライアントに向かってtracerouteが実行され、サーバからクライアントまでの辿った経路をクライアント側が知る事ができます。

<A HREF="traceroute.shtml">ここからそこまでの経路?</A>

また、ページに対するアクセス回数をカウントするスクリプトは、サーバサイドインクルード(SSI)機能を使うと簡単に作成できます (下記のコードはファイルをロックしないため、同時アクセスが行われると問題が起こり、実用で使うには難があります)。

#!/usr/bin/perl
open (COUNT,"./countfile");     # カウンターファイルを開きます。
$counter = <COUNT>;             # カウンターファイルの値を読み込みます。
close (COUNT);
open (COUNT, "> ./countfile");  # 書き込みモードで開きます。
print COUNT +($counter+1);      # 1足してカウンターファイルに書き込みます。
close (COUNT);
print $counter;                 # ページに出力します。

そして、HTMLページは次のようにします。

アクセス回数 <!--#exec cmd="count.cgi"--> 回

デモ

SSI機能をサポートしていないCERN サーバでは、 George Burgyan氏と Gabe Schaffer氏が開発したssis と呼ばれるツールを使用することによって、疑似的に可能です。

[Up] [Next] [Previous]