◆ SSIコマンド形式

SSIコマンドは単純ですが、SSIコマンドを組み立てる際の構文は注意するようにしてください。サーバはファイルを先頭から順に読んで、うまく SSIコマンドを認識しなければならないので、SSIコマンドは構文どおりに書かなければいけないのです。

正確でないと、サーバは通常の HTMLコードと、SSIコマンドを分離することができません。

■ SSIコマンドの書き方

SSIコマンドの構文は、通常の HTMLの構文の一部を使用しています。具体的には、SSIコマンドは、HTMLのコメントを拡張した構文になっています。

これは単なる偶然の誤りでなく、こうすることで SSIを含む HTML文書を他のサーバに設置した場合、そのサーバがSSIをサポートしていなくても、SSIコマンドはコメントであると判断され、無視されることで安全に運用することができます。

具体的な SSIコマンドの書式は以下のとおりです。

 <!--#コマンド名 引数名="引数値" -->

このように。<!-- と、--> の間で SSIコマンドを記述します。サーバが SSI機能を有していれば、この書式を解釈して、結果をユーザに返すことができるのです。

SSIコマンドを組み立てるときは、以下の規則に従うことで、大きな問題に出くわさずに処理することができます。

• 正しいファイル識別子 (拡張子) を持つファイルの中だけに SSIコマンドを書くことができる。（SSIを含んだサーバ解析HTMLファイルに標準的なファイル識別子は .shtml ですが、識別子はサーバ管理者が自由に決めることができます。前ページの SSI設定 の節で説明したとおり、srm.confファイルを見れば、識別子が何であるかが理解できるでしょう。）

• SSIコマンドは、必ずコメント形式 「<!--#コマンド名」で始めます。この冒頭の部分のハッシュマーク「＃」の前にはスペースが含まれてはいけません。

• 引数値を示す記述の最後の部分「"引数値" -->」の部分には、必ずスペースを１つ置きます。このスペースの置き忘れはよくある間違いですので、十分注意してください。

• パス名に「../」を含むコマンドやファイルへのパス名は、決して SSIで使用してはいけません。SSIコマンドは、サーバルートで始めるパス名か、SSIファイルが置かれているディレクトリのサブディレクトリであるパス名しか受け付けません。これについては十分確認してください。

  （いくつかのコマンドは、「"引数値"」の内容としてシステムのパス名を指定できます、念のため）

• 引数値を記述する際には、必ず "引数値" と、引用符で囲まなければなりません。

SSIを利用する上で守らなければならない規則は以上の５つです。そしてこのルールに従った SSIコマンドは、以下の表のとおりです。各コマンドは、それぞれ異なる種類の引数値を取ります。

SSIコマンドは、大文字と小文字を厳格に区別します。SSIコマンドを記述する際には、何もかも小文字で記述するように心がけてください。

ここで掲げた SSIコマンドは、次節より詳しく解説します。

PageTop / Home / Index / Next

最新更新日 2003年11月9日   最新更新日 2004年4月11日

Copyright(C) 2002〜2004 banban@scollabo.com