SHTML 簡潔なチュートリアル

SHTMLとASPは似ています。SHTMLという名前のファイルでは、SSIの命令がASPの命令と同じように使用されます。SSI命令をSHTMLファイルに記述できます。クライアントがこれらのSHTMLファイルにアクセスすると、
サーバーはこれらの SHTML ファイルを読み取って解釈し、SHTML ファイルに含まれる SSI 命令を解釈します。たとえば、SHTML ファイル内の SSI 命令を使用して他の HTML ファイルを参照できます (#include)。サーバーからクライアントに送信されるファイルは、SSI 命令のない解釈された SHTML です。 HTML にはない機能、つまり HTML の進化形ともいえる動的な SHTML を実現できます。 Sina のニュースシステムはこんな感じです。ニュースの内容は固定ですが、その上の広告やメニューは #include を使って参照しています。
現在、主に以下のような用途があります。
1. サーバー側の環境変数を表示する <#echo>
2. テキストコンテンツをドキュメントに直接挿入する <#include>
3. WEB ドキュメント関連情報を表示します <#flastmod><#fsize> (ファイル作成日/サイズなど)
4. サーバー上のさまざまなプログラムを直接実行する <#exec> (CGI やその他の実行可能プログラムなど)
5. SSI情報の表示形式を設定する <#config> (ファイル作成日/サイズの表示方法など)
高度な SSI <XSSI> は、if 条件文を使用して変数を設定できます。

SSIの使用
SSI は、WEB サーバー向けに提供されるコマンドのセットです。これらのコマンドは、HTML ドキュメントのコメントコンテンツに直接埋め込むことができます。のように：
<#include ファイル="info.htm"-->
これは、"info.htm" の内容を現在のページにコピーする SSI 命令です。訪問者がこのページを閲覧すると、他の HTML ドキュメントと同様に info.htm の内容が表示されます。
その他の SSI 命令の使用方法は、基本的に先ほどの例と同じです。SSI の使用方法は、少しコードを挿入するだけであり、使用方法は非常に簡単であることがわかります。
もちろん、Web サーバーが SSI をサポートしていない場合は、単にコメント情報として扱われ、コンテンツはスキップされます。ブラウザーもこの情報を無視します。

Web サーバーで SSI 機能を構成するにはどうすればよいですか?
一部の WEB サーバー (IIS 4.0/SAMBAR 4.2 など) では、#include ディレクティブを含むファイルは、SSI インタープリターにマップされた拡張子を使用する必要があります。そうしないと、Web サーバーは SSI ディレクティブを処理しません。デフォルトでは、拡張子 .stm、.shtm、および .shtml がインタープリター (Ssinc.dll) にマップされます。
Apache は設定に依存します。srm.conf を次のように変更します。
AddType text/x-server-parsed-html .shtml は、.shtml 拡張子を持つファイルの SSI ディレクティブのみを解析します。
AddType text/x-server-parsed-html .htmlは、すべてのHTML文書のSSIディレクティブを解析します。
Netscape WEB サーバーは、管理サーバーを使用して SSI 機能を直接有効にすることができます。
ウェブサイトはサーバー管理プログラムのマッピングタグを使用し、拡張機能はコンテンツタイプを追加します: wwwserver/html-ssi
CERN サーバーは SSI をサポートしていません。SSI 詐欺の方法を使用して、http://sw.cse.bris.ac.uk/WebTools/fakessi.html から PERL スクリプトをダウンロードし、CERN サーバーで SSI 命令を使用するようにすることができます。 (exec ディレクティブはサポートされていません。)

SSI命令の基本フォーマット
SSI 命令の基本形式は次のとおりです。
プログラムコード:

<!-– コマンド名="コマンドパラメータ">
<!-– コマンド名="コマンドパラメータ">
プログラムコードなど:

<#include ファイル="info.htm"-->
<#include ファイル="info.htm"-->
例:
1.  は HTML 構文のコメントです。WEB サーバーが SSI をサポートしていない場合、この情報は無視されます。
2. #include は SSI ディレクティブの 1 つです。
3. file は include のパラメータであり、info.htm はパラメータ値であり、この命令に含まれるドキュメントの名前を参照します。

知らせ：

1. 


このドキュメントの名前: プログラムコード:



現在の時刻: プログラムコード:



あなたの IP アドレスはプログラムコードです:




#include デモ関数:
テキストファイルの内容をドキュメントページに直接挿入します。
文法：
プログラムコード:

<#include file="ファイル名"-->
<#include virtual="ファイル名"-->
<#include file="ファイル名"-->
<#include virtual="ファイル名"-->
ファイルファイル名は、#include ディレクティブを使用するドキュメントが配置されているディレクトリを基準とした相対パスです。インクルードファイルは同じディレクトリまたはそのサブディレクトリに存在できますが、前のディレクトリには存在できません。たとえば、現在のディレクトリ内の nav_head.htm ドキュメントを意味する場合は、file="nav_head.htm" となります。
仮想ファイル名は、Web サイト上の仮想ディレクトリへの完全なパスです。たとえば、サーバーのドキュメントルートディレクトリの下のhoyiディレクトリにあるnav_head.htmファイルを意味する場合は、file="/hoyi/nav_head.htm"となります。
パラメータ:
ファイルは、このドキュメントに対するインクルードファイルの場所を指定します。
virtual は、サーバーのドキュメントルートからの相対的な場所を指定します。注:
1. ファイル名には拡張子が必要です。
2. インクルードファイルの拡張子は任意です。.htm 拡張子を直接使用するのが最も便利だと思います。Microsoft では、.inc 拡張子の使用を推奨しています (好みに応じて異なります)。

例：
プログラムコード:

<#include file="nav_head.htm"-->ヘッダーファイルを現在のページに挿入します
<#include file="nav_foot.htm"-->現在のページにフッターファイルを挿入します
<#include file="nav_head.htm"-->ヘッダーファイルを現在のページに挿入します
<#include file="nav_foot.htm"-->現在のページにフッターファイルを挿入します

#flastmod と #fsize のデモンストレーション: #flastmod ファイルが最後に更新された日付
#fsize ファイルの長さの構文:
プログラムコード:





パラメータ:
ファイルは、このドキュメントを基準としたインクルードファイルの場所を指定します。たとえば、info.txt は現在のディレクトリにある info.txt ドキュメントを意味します。
virtual は、/hoyi/info.txt などのサーバードキュメントルートディレクトリからの相対的な場所を指定します。注:
ファイル名には拡張子が必要です。
例：
プログラムコード:



現在のディレクトリにある news.htm ファイルの最終更新日を現在のページのプログラムコードに挿入します。



現在のディレクトリにあるnews.htmのファイルサイズを現在のページに入力します
#exec デモ関数:
外部プログラムの出力をページに挿入します。 cmd 引数または cgi 引数のどちらが使用されているかに応じて、CGI プログラムまたは通常のアプリケーションに挿入できます。
文法：
プログラムコード:





パラメータ:
cmd 一般的なアプリケーション
cgi CGI スクリプトプログラムの例:
プログラムコード:

パスワードファイルが表示されます
 は現在のディレクトリのファイルリストを表示します
 は CGI プログラム gb.cgi を実行します。
 は CGI プログラム access_log.cgi を実行します。
パスワードファイルが表示されます
 は現在のディレクトリのファイルリストを表示します
 は CGI プログラム gb.cgi を実行します。
 は CGI プログラム access_log.cgi を実行します。
知らせ：
上記の例からわかるように、この命令は非常に便利ですが、セキュリティ上の問題もあります。
禁止されている方法:
． Apache の場合、access.conf の「Options Includes ExecCGI」行を削除します。
． IIS で #exec コマンドを無効にするには、SSIExecDisable メタベースを変更します。
#設定
目的: クライアントブラウザーに返されるエラーメッセージ、日付、およびファイルサイズの形式を指定します。
文法：
プログラムコード:







パラメータ:
errmsg SSI 実行エラーメッセージを任意の方法でカスタマイズします。
sizefmt ファイルサイズ表示モード。デフォルトはバイト ("bytes") ですが、キロバイト ("abbrev") に変更できます。
timefmt 時間表示モード。最も柔軟な構成属性です。
例: 存在しないファイルのサイズを表示するプログラムコード:





ファイルサイズをキロバイトで表示

プログラムコード:





特定の時間形式で時間プログラムコードを表示します。


 今日の曜日、月、タイムゾーンを表示します



 今日の曜日、月、タイムゾーンを表示します



スリーエスアイ
XSSI (Extended SSI) は、Apache 1.2 以降の mod-include モジュールに組み込まれた高度な SSI 命令のセットです。
利用可能なコマンドは次のとおりです。
#printenv
＃セット
＃もし
#printenv
機能: WEB サーバー環境に現在存在するすべての環境変数を表示します。
構文: プログラムコード:



パラメータ: なし例:
プログラムコード:




＃セット
機能: 後続の if ステートメントで使用するために変数に値を割り当てることができます。
構文: プログラムコード:



パラメータ: なし例: プログラムコード:




＃もし
目的: if ステートメントを使用するときに、計算要件に基づいて表示されるデータを変更できるページを作成します。
構文: プログラムコード:


コンテンツを表示

コンテンツを表示

コンテンツを表示


コンテンツを表示

コンテンツを表示

コンテンツを表示

例：
プログラムコード:


サーバーセキュリティディスカッションエリア http://www.31896.net/ へようこそ。

Fineacer コンピュータネットワークセキュリティオンライン (http://www.fineacer.org/) へようこそ。

サーバーセキュリティフォーラムへようこそ!


サーバーセキュリティディスカッションエリア http://www.31896.net/ へようこそ。

Fineacer コンピュータネットワークセキュリティオンライン (http://www.fineacer.org/) へようこそ。

サーバーセキュリティフォーラムへようこそ!

注: 前のディレクティブで使用されたバックスラッシュは、式の終了として解釈されないように、内部引用符を置き換えるために使用されます。省略できません。

1. 設定コマンド

Config コマンドは主に SSI のデフォルト設定を変更するために使用されます。で：

Errmsg: デフォルトのエラーメッセージを設定します。ユーザーが設定したエラーメッセージを正常に返すには、HTML ファイル内の他の SSI コマンドの前に Errmsg パラメータを配置する必要があります。そうしないと、クライアントはユーザーが設定したカスタムメッセージではなく、デフォルトのエラーメッセージのみを表示できます。



Timefmt: 日付と時刻に使用する形式を定義します。 echo コマンドの前に timefmt パラメータを使用する必要があります。




結果は次のとおりです。

2000年4月12日水曜日

おそらく、ユーザーは上記の例で使用されている %A %B %d に馴染みがないかもしれません。以下に、SSI でよく使用される日付と時刻の形式の一部を表の形式でまとめます。

Sizefmt: ファイルサイズをバイト、キロバイト、メガバイトのいずれで表すかを決定します。バイトを使用する場合、値は「バイト」になります。キロバイトとメガバイトの略語を使用できます。同様に、sizefmt パラメータは、使用する fsize コマンドの前に配置する必要があります。




2. コマンドを含める

Include コマンドを使用すると、現在解析中のドキュメントに他のドキュメントのテキストまたは画像を挿入できます。これが SSI 全体のキーとなります。 Include コマンドを使用すると、1 つのファイルを変更するだけでサイト全体を即座に更新できます。

Include コマンドには 2 つの異なるパラメーターがあります。

仮想: サーバー上のドキュメントへの仮想パスを指定します。例えば：

<#include virtual="/includes/header.html" -->

ファイル: 現在のディレクトリへの相対パスを指定します。「../」または絶対パスは使用できません。例えば：

<#include ファイル="header.html" -->

これには、各ディレクトリに header.html ファイルが含まれている必要があります。

3. エコーコマンド

echo コマンドは次の環境変数を表示できます。

DOCUMENT_NAME: 現在のドキュメントの名前を表示します。



結果は次のとおりです。

インデックス.html

DOCUMENT_URI: 現在のドキュメントの仮想パスを表示します。例えば：



結果は次のとおりです。

/あなたのディレクトリ/あなたのファイル名.html

ウェブサイトが成長し続けると、URL がどんどん長くなり、間違いなく頭痛の種になります。 SSI を使用すれば、これらすべてが解決されます。ウェブサイトのドメイン名と SSI コマンドを組み合わせて完全な URL を表示できるため、次のようになります。

http://yourdomain%3c!--/#echo var="& ... uot; -->

QUERY_STRING_UNESCAPED: エスケープ処理なしでクライアントから送信されたクエリ文字列を表示します。すべての特殊文字の前にエスケープ文字 "" が付きます。例えば：



DATE_LOCAL: サーバーの設定されたタイムゾーンで日付と時刻を表示します。ユーザーは、config コマンドの timefmt パラメータを組み合わせることで出力情報をカスタマイズできます。例えば：




結果は次のとおりです。

2000年4月15日土曜日

DATE_GMT: 返される日付がグリニッジ標準時に基づく点を除いて、DATE_LOCAL と同じ機能です。例えば：



LAST_MODIFIED: 現在のドキュメントの最終更新時刻を表示します。同様に、これは SSI で非常に実用的な機能です。HTML ドキュメントに次の簡単なテキスト行を追加するだけで、ページに更新時刻が動的に表示されます。



CGI 環境変数

SSI 環境変数に加えて、echo コマンドは次の CGI 環境変数も表示できます。

SERVER_SOFTWARE: サーバーソフトウェアの名前とバージョンを表示します。例えば：

SERVER_NAME: サーバーのホスト名、DNS エイリアス、または IP アドレスを表示します。例えば：

SERVER_PROTOCOL: HTTP/1.0 など、クライアント要求で使用されるプロトコル名とバージョンを表示します。例えば：

SERVER_PORT: サーバーの応答ポートを表示します。例えば：

REQUEST_METHOD: GET、HEAD、POST など、クライアントのドキュメント要求メソッドを表示します。例えば：

REMOTE_HOST: 要求情報を発行したクライアントのホスト名を表示します。

REMOTE_ADDR: 要求情報を発行したクライアントの IP アドレスを表示します。

AUTH_TYPE: ユーザーの認証方法を表示します。

REMOTE_USER: 保護されたページにアクセスするユーザーが使用するアカウント名を表示します。


4. Fsize: 指定したファイルのサイズを表示します。config コマンドの sizefmt パラメータを組み合わせることで出力形式をカスタマイズできます。



5. Flastmod: 指定されたファイルの最終変更日を表示します。出力形式は、config コマンドの timefmt パラメータを組み合わせて制御できます。




ここでは、flastmod パラメータを使用して、ページ上のすべてのリンクされたページの更新日を表示できます。方法は次のとおりです。


<A HREF="/directory/file.html">ファイル</A>

<A HREF="/another_directory/another_file.html">別のファイル</A>

結果は次のとおりです。
ファイル 2000年4月19日
もう一つのファイル 2000年1月8日

6. 実行

Exec コマンドは、CGI スクリプトまたはシェルコマンドを実行できます。使い方は次のとおりです:

Cmd: 指定された文字列を実行するには、/bin/sh を使用します。 SSI で IncludesNOEXEC オプションを使用すると、このコマンドはブロックされます。

Cgi: CGI スクリプトを実行するために使用できます。たとえば、次の例では、サーバーの cgi-bin ディレクトリにある counter.pl スクリプトを使用して、各ページにカウンターを配置します。

<<: Apache ストレステストツールのインストールと使用

>>: MySQL のロック待機とデッドロック問題の分析