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

Server Side Includes ( SSI )は、 World Wide Web専用にほぼ独占的に使用されている、シンプルな解釈型のサーバー側スクリプト言語です。 SSI は、ディレクティブを使用して、1 つ以上のファイルの内容をWeb サーバー上の Web ページ(下記参照)に取り込む場合に最も便利です。 これは通常、ページ ヘッダー、ページ フッター、ナビゲーション メニューなど、サイト全体で共通のコードの一部です。 SSI には、条件付き機能の制御ディレクティブや外部プログラムを呼び出すディレクティブも含まれています。 SSI は、Apache、LiteSpeed、nginx、IIS、およびW3Cの Jigsaw でサポートされています。^{[1] SSI のルーツは}NCSA HTTPdにあります。^[2]#include

ウェブサーバーがSSI対応HTMLファイルを認識し、これらの命令を実行するためには、ファイル名が特別な拡張子（デフォルトでは.shtml、、 ）で終わるか、サーバーがこれを許可するように構成されて.stmいる.shtm場合は、ファイルの実行ビットを設定する必要があります。^[3]

シンプルなプログラミング言語である SSI は、テキストという 1 つの型のみをサポートしています。制御フローはかなりシンプルで、選択がサポートされていますが、ループはネイティブではサポートされておらず、 include またはHTTP リダイレクトを使用した再帰によってのみ実行できます。^{[a]言語の設計がシンプルなため、ほとんどのサーバー側スクリプト言語よりも習得と使用が容易ですが、複雑なサーバー側処理は、}より機能が豊富なプログラミング言語の 1 つで行われることがよくあります。SSI はチューリング完全です。^[4]

SSI の構文は単純です: <!--#directive parameter=value parameter=value -->。ディレクティブは HTML コメント内に配置され、SSI が有効になっていない場合、ソースを見ない限り、ユーザーはページ上の SSI ディレクティブを見ることができません。構文では、先頭の "<!--" とディレクティブの間にスペースを入れることができないことに注意してください。SSI に関する Apache チュートリアルでは、要素を閉じる "-->" の前にスペース文字が必要であると規定されています。^[5]

日々の引用文を掲載した Web ページでは、次のコードを Web ページのファイルに配置することで引用文を含めることができます。

<!--#include 仮想="../quote.txt" -->

ファイルを 1 回変更するだけでquote.txt、そのファイルを含むすべてのページに最新の毎日の引用が表示されます。含められるのはファイルに限定されず、プログラムからのテキスト出力や、現在の時刻などのシステム変数の値も対象となります。

以下はNCSA HTTPd時代（1990年代）のSSIディレクティブです。^[2]一部の実装ではこれらすべてをサポートしていません。^[6]

制御ディレクティブは、後で SSI に追加されます。これには、一般的な if-elif-else-endif フロー制御と変数の書き込みのほか、一部の実装でのみ見られるループなどのより特殊な機能が含まれます。

• ESI (エッジサイドインクルード)

• 実装からの言語参照:
  • Apache: Apache mod_include リファレンス。ディレクティブ「要素」を呼び出します。
  • Nginx: モジュール ngx_http_ssi_module。ディレクティブ「commands」を呼び出します。
  • NCSA HTTPd : オリジナルの NCSA HTTPd SSI リファレンス。ディレクティブ「コマンド」を呼び出します。
  • W3C Jigsaw: サーバー側インクルード コマンド。ディレクティブ「要素」を呼び出します。サーブレット、JDBC、HTTP Cookie、ループで大幅に拡張されています。
• チュートリアル:
  • Apache SSI チュートリアル
  • SSI のわかりやすい英語ガイド
  • SSI-Developer、Apache サーバーサイドインクルード