SSIの使い方

SSI入門

他に何が設定できるのか ?

時刻書式をconfig で設定できることに加えて、更に二つconfig で設定することができます。通常、SSI ディレクティブで何かがうまくいかないときは、次のメッセージが出力されます。

[an error occurred while processing this directive]

このメッセージを他のものにしたい場合、config 要素のerrmsg 属性で変更することができます:

おそらく、エンドユーザはこのメッセージを決して見ることはありません。なぜなら、そのサイトが生きた状態になる前に SSI ディレクティブに関する全ての問題を解決しているはずだからです。(そうですよね?)

そして、config においてsizefmt 属性を使用することで、返されるファイルサイズの書式を設定することができます。バイト数にはbytes を、適当に Kb や Mb に短縮させるにはabbrev を指定することができます。

コマンドの実行

今後数ヶ月のうちに、小さな CGI プログラムと SSI を使用する記事を出したいと考えています。ここではそれとは別に、exec 要素によって行なうことができることを示します。

SSI にシェル (正確には/bin/sh。Win32 ならば DOS シェル) を使用してコマンドを実行させることができます。下記の例では、ディレクトリリスト出力を行ないます。

Windows 上では、

Windows上では、このディレクティブによっていくつかの奇妙な書式に気づくでしょう。なぜならdir の出力が文字列 ``<dir>'' を含み、ブラウザを混乱させるからです。

この機能は非常に危険であり、どんなコードでもexec タグに埋め込まれてしまえば実行することに注意してください。例えば `` ゲストブック '' のように、もし、ユーザがページの内容を編集できる状況にあるならば、この機能を確実に抑制してください。Options ディレクティブのIncludesNOEXEC 引数を指定することで、 SSI は許可するけれどexec 機能は許可しないようにすることができます。

高度な SSI テクニック

コンテンツを出力することに加え、Apache SSI は変数を設定し、そして比較と条件分岐にその変数を使用できる機能を提供しています。

警告

この記事で述べた大部分の機能は、Apache 1.2 以降を使用している場合のみ利用可能です。もちろん、もし Apache 1.2 以降を使用してない場合、直ちにアップグレードする必要があります。

変数を設定する

set ディレクティブを使用して、後で使用するために変数を設定することができます。これは後の説明で必要になるので、ここでそれについて述べています。文法は以下のとおりです:

このように単純に文字どおりに設定することに加え、環境変数や上記の変数(例えばLAST_MODIFIED のような) を含む他のあらゆる変数を値を設定するのに使用することができます。変数名の前にドル記号 ($) を使用することで、それがリテラル文字列ではなくて変数であることを示します。

ドル記号 ($) を文字として変数の値に入れるには、バックスラッシュによってドル記号をエスケープする必要があります。

最後になりますが、長い文字列の中に変数を置きたい場合で、変数名が他の文字とぶつかる可能性があり、それらの文字について混乱してしまう場合、この混乱を取り除くため、変数名を中括弧で囲むことができます (これについての良い例を示すのは難しいのですが、おそらく分かっていただけるでしょう)。

条件式

さて、変数を持っていて、それらの値を設定して比較することができるのですから、条件を表すためにそれらを使用することができます。これにより SSI はある種の小さなプログラミング言語になっています。mod_includeは条件を表現するためにif,elif,else,endif 構造を提供しています。

これによって、一つの実際のページから複数の論理ページを効果的に生成することができます。

条件構造は以下のとおりです:

test_condition はあらゆる種類の論理的比較をすることができます。値を比較したり、その値が ``真'' かどうかを評価します (空でないなら与えられた文字列は真です)。

利用可能な比較演算子の全てのリストについては、mod_include ドキュメンテーションを参照してください。

ここでは、この構造をどう使用するかの例をいくつか示します。

設定ファイルで次の行を記述します:

BrowserMatchNoCase macintosh Mac
BrowserMatchNoCase MSIE InternetExplorer

これはクライアントが Macintosh 上でインターネットエクスプローラが動いている場合、環境変数 ``Mac'' と ``InternetExplorer'' を真と設定します。

次に、SSI が可能になったドキュメントで以下を行ないます:

Apologetic text goes here

Cool JavaScript code goes here

Mac上のIEに対して何か思うところがあるわけでありません。

他では実行できているいくつかの JavaScript を Mac 上の IE で実行させるのに、先週数時間苦労したというだけのことです。上の例はその暫定的な対処方法です。

他のどんな変数 (あなたが定義するもの、または普通の環境変数のいずれか) も、条件文に使用することができます。 Apache はSetEnvIf ディレクティブや他の関連ディレクティブを使用して環境変数を設定することができます。この機能により、CGI に頼ることなくかなり複雑な動的なことをさせることができます。

終わりに

SSI は確かに CGI や動的なウェブページを生成する他の技術に代わるものではありません。しかし、たくさんの余分な作業をせずに、少量の動的なコンテンツを加えるにはすぐれた方法です。