From aae567b7834a4921cf326d05ac8c33a532bba0a5 Mon Sep 17 00:00:00 2001 From: Yoshiki Hayashi Date: Fri, 16 Feb 2001 02:02:45 +0000 Subject: [PATCH] New Japanese translation. Submitted by: Minoru Yamazato git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@88182 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/howto/ssi.html | 521 ------------------------------ docs/manual/howto/ssi.html.ja.jis | 501 ++++++++++++++++++++++++++++ 2 files changed, 501 insertions(+), 521 deletions(-) delete mode 100644 docs/manual/howto/ssi.html create mode 100644 docs/manual/howto/ssi.html.ja.jis diff --git a/docs/manual/howto/ssi.html b/docs/manual/howto/ssi.html deleted file mode 100644 index da17836b41..0000000000 --- a/docs/manual/howto/ssi.html +++ /dev/null @@ -1,521 +0,0 @@ - - - -Apache Tutorial: Introduction to Server Side Includes - - - - - -

Apache Tutorial: Introduction to Server Side -Includes

- - - - - - - -
-

Apache -Tutorial: Introduction to Server Side Includes

- - - - - - -
Related Modules
-
- mod_include
-mod_cgi
-mod_expires
-
Related Directives
-
- Options
-XBitHack
-AddType
-AddHandler
-BrowserMatchNoCase
- -
- -

This HOWTO first appeared in Apache Today -(http://www.apachetoday.com/) as a series of three articles. They -appear here by arrangement with ApacheToday and Internet.com.

- -

This article deals with Server Side Includes, usually called simply -SSI. In this article, I'll talk about configuring your server to permit -SSI, and introduce some basic SSI techniques for adding dynamic content -to your existing HTML pages.

- -

In the latter part of the article, we'll talk about some of the -somewhat more advanced things that can be done with SSI, such as -conditional statements in your SSI directives.

- -
-

What are SSI?

- -

SSI (Server Side Includes) are directives that are placed in HTML -pages, and evaluated on the server while the pages are being served. -They let you add dynamically generated content to an existing HTML -page, without having to serve the entire page via a CGI program, or -other dynamic technology.

- -

The decision of when to use SSI, and when to have your page entirely -generated by some program, is usually a matter of how much of the page -is static, and how much needs to be recalculated every time the page is -served. SSI is a great way to add small pieces of information, such as -the current time. But if a majority of your page is being generated at -the time that it is served, you need to look for some other -solution.

- -
-

Configuring your -server to permit SSI

- -

To permit SSI on your server, you must have the following directive -either in your httpd.conf file, or in a -.htaccess file:

- -
-        Options +Includes
-
- -

This tells Apache that you want to permit files to be parsed for SSI -directives.

- -

Not just any file is parsed for SSI directives. You have to tell -Apache which files should be parsed. There are two ways to do this. You -can tell Apache to parse any file with a particular file extension, -such as .shtml, with the following directives:

- -
-        AddType text/html .shtml
-        <FilesMatch "\.shtml[.$]">
-          SetOutputFilter INCLUDES
- </FilesMatch> -
- -

One disadvantage to this approach is that if you wanted to add SSI -directives to an existing page, you would have to change the name of -that page, and all links to that page, in order to give it a -.shtml extension, so that those directives would be -executed.

- -

The other method is to use the XBitHack directive:

- -
-        XBitHack on
-
- -

XBitHack tells Apache to parse files for SSI directives -if they have the execute bit set. So, to add SSI directives to an -existing page, rather than having to change the file name, you would -just need to make the file executable using chmod.

- -
-        chmod +x pagename.html
-
- -

A brief comment about what not to do. You'll occasionally see people -recommending that you just tell Apache to parse all .html -files for SSI, so that you don't have to mess with .shtml -file names. These folks have perhaps not heard about -XBitHack. The thing to keep in mind is that, by doing -this, you're requiring that Apache read through every single file that -it sends out to clients, even if they don't contain any SSI directives. -This can slow things down quite a bit, and is not a good idea.

- -

Of course, on Windows, there is no such thing as an execute bit to -set, so that limits your options a little.

- -

In its default configuration, Apache does not send the last modified -date or content length HTTP headers on SSI pages, because these values are -difficult to calculate for dynamic content. This can prevent your -document from being cached, and result in slower perceived client -performance. There are two ways to solve this:

- -
    - -
  1. Use the XBitHack Full configuration. This tells -Apache to determine the last modified date by looking only at the date -of the originally requested file, ignoring the modification date of -any included files.
  2. - -
  3. Use the directives provided by mod_expires to set an explicit -expiration time on your files, thereby letting browsers and proxies -know that it is acceptable to cache them.
  4. - -
- - -
-

Basic SSI directives

- -

SSI directives have the following syntax:

- -
-        <!--#element attribute=value attribute=value ... -->
-
- -

It is formatted like an HTML comment, so if you don't have SSI -correctly enabled, the browser will ignore it, but it will still be -visible in the HTML source. If you have SSI correctly configured, the -directive will be replaced with its results.

- -

The element can be one of a number of things, and we'll talk some -more about most of these in the next installment of this series. For -now, here are some examples of what you can do with SSI

- -

Today's date

- -
-        <!--#echo var="DATE_LOCAL" -->
-
- -

The echo element just spits out the value of a -variable. There are a number of standard variables, which include the -whole set of environment variables that are available to CGI programs. -Also, you can define your own variables with the set -element.

- -

If you don't like the format in which the date gets printed, you can -use the config element, with a timefmt -attribute, to modify that formatting.

- -
-        <!--#config timefmt="%A %B %d, %Y" -->
-        Today is <!--#echo var="DATE_LOCAL" -->
-
- -

Modification date of the -file

- -
-        This document last modified <!--#flastmod file="index.html" -->
-
- -

This element is also subject to timefmt format -configurations.

- -

Including the -results of a CGI program

- -

This is one of the more common uses of SSI - to output the results -of a CGI program, such as everybody's favorite, a ``hit counter.''

- -
-        <!--#include virtual="/cgi-bin/counter.pl" -->
-
- -
-

Additional examples

- -

Following are some specific examples of things you can do in your -HTML documents with SSI.

- -
-

When was this document -modified?

- -

Earlier, we mentioned that you could use SSI to inform the user when -the document was most recently modified. However, the actual method for -doing that was left somewhat in question. The following code, placed in -your HTML document, will put such a time stamp on your page. Of course, -you will have to have SSI correctly enabled, as discussed above.

- -
-        <!--#config timefmt="%A %B %d, %Y" -->
-        This file last modified <!--#flastmod file="ssi.shtml" -->
-
- -

Of course, you will need to replace the ssi.shtml with -the actual name of the file that you're referring to. This can be -inconvenient if you're just looking for a generic piece of code that -you can paste into any file, so you probably want to use the -LAST_MODIFIED variable instead:

- -
-        <!--#config timefmt="%D" -->
-        This file last modified <!--#echo var="LAST_MODIFIED" -->
-
- -

For more details on the timefmt format, go to your -favorite search site and look for ctime. The syntax is the -same.

- -
-

Including a standard -footer

- -

If you are managing any site that is more than a few pages, you may -find that making changes to all those pages can be a real pain, -particularly if you are trying to maintain some kind of standard look -across all those pages.

- -

Using an include file for a header and/or a footer can reduce the -burden of these updates. You just have to make one footer file, and -then include it into each page with the include SSI -command. The include element can determine what file to -include with either the file attribute, or the -virtual attribute. The file attribute is a -file path, relative to the current directory. That means that -it cannot be an absolute file path (starting with /), nor can it -contain ../ as part of that path. The virtual attribute is -probably more useful, and should specify a URL relative to the document -being served. It can start with a /, but must be on the same server as -the file being served.

- -
-        <!--#include virtual="/footer.html" -->
-
- -

I'll frequently combine the last two things, putting a -LAST_MODIFIED directive inside a footer file to be -included. SSI directives can be contained in the included file, and -includes can be nested - that is, the included file can include another -file, and so on.

- -
-

What else can I config?

- -

In addition to being able to config the time format, -you can also config two other things.

- -

Usually, when something goes wrong with your SSI directive, you get -the message

- -
-        [an error occurred while processing this directive]
-
- -

If you want to change that message to something else, you can do so -with the errmsg attribute to the config -element:

- -
-        <!--#config errmsg="[It appears that you don't know how to use SSI]" -->
-
- -

Hopefully, end users will never see this message, because you will -have resolved all the problems with your SSI directives before your -site goes live. (Right?)

- -

And you can config the format in which file sizes are -returned with the sizefmt attribute. You can specify -bytes for a full count in bytes, or abbrev -for an abbreviated number in Kb or Mb, as appropriate.

- -
-

Executing commands

- -

I expect that I'll have an article some time in the coming months -about using SSI with small CGI programs. For now, here's something else -that you can do with the exec element. You can actually -have SSI execute a command using the shell (/bin/sh, to be -precise - or the DOS shell, if you're on Win32). The following, for -example, will give you a directory listing.

- -
-        <pre>
-        <!--#exec cmd="ls" -->
-        </pre>
-
- -

or, on Windows

- -
-        <pre>
-        <!--#exec cmd="dir" -->
-        </pre>
-
- -

You might notice some strange formatting with this directive on -Windows, because the output from dir contains the string -``<dir>'' in it, which confuses browsers.

- -

Note that this feature is exceedingly dangerous, as it will execute -whatever code happens to be embedded in the exec tag. If -you have any situation where users can edit content on your web pages, -such as with a ``guestbook'', for example, make sure that you have this -feature disabled. You can allow SSI, but not the exec -feature, with the IncludesNOEXEC argument to the -Options directive.

- -
-

Advanced SSI techniques

- -

In addition to spitting out content, Apache SSI gives you the option -of setting variables, and using those variables in comparisons and -conditionals.

- -

Caveat

- -

Most of the features discussed in this article are only available to -you if you are running Apache 1.2 or later. Of course, if you are not -running Apache 1.2 or later, you need to upgrade immediately, if not -sooner. Go on. Do it now. We'll wait.

- -
-

Setting variables

- -

Using the set directive, you can set variables for -later use. We'll need this later in the discussion, so we'll talk about -it here. The syntax of this is as follows:

- -
-        <!--#set var="name" value="Rich" -->
-
- -

In addition to merely setting values literally like that, you can -use any other variable, including, for example, environment variables, -or some of the variables we discussed in the last article (like -LAST_MODIFIED, for example) to give values to your -variables. You will specify that something is a variable, rather than a -literal string, by using the dollar sign ($) before the name of the -variable.

- -
-        <!--#set var="modified" value="$LAST_MODIFIED" -->
-
- -

To put a literal dollar sign into the value of your variable, you -need to escape the dollar sign with a backslash.

- -
-        <!--#set var="cost" value="\$100" -->
-
- -

Finally, if you want to put a variable in the midst of a longer -string, and there's a chance that the name of the variable will run up -against some other characters, and thus be confused with those -characters, you can place the name of the variable in braces, to remove -this confusion. (It's hard to come up with a really good example of -this, but hopefully you'll get the point.)

- -
-        <!--#set var="date" value="${DATE_LOCAL}_${DATE_GMT}" -->
-
- -
-

Conditional expressions

- -

Now that we have variables, and are able to set and compare their -values, we can use them to express conditionals. This lets SSI be a -tiny programming language of sorts. mod_include provides -an if, elif, else, -endif structure for building conditional statements. This -allows you to effectively generate multiple logical pages out of one -actual page.

- -

The structure of this conditional construct is:

- -
-        <!--#if expr="test_condition" -->
-    <!--#elif expr="test_condition" -->
-    <!--#else -->
-    <!--#endif -->
-
- -

A test_condition can be any sort of logical comparison - -either comparing values to one another, or testing the ``truth'' of a -particular value. (A given string is true if it is nonempty.) For a -full list of the comparison operators available to you, see the -mod_include documentation. Here are some examples of how -one might use this construct.

- -

In your configuration file, you could put the following line:

- -
-        BrowserMatchNoCase macintosh Mac
-        BrowserMatchNoCase MSIE InternetExplorer
-
- -

This will set environment variables ``Mac'' and ``InternetExplorer'' -to true, if the client is running Internet Explorer on a Macintosh.

- -

Then, in your SSI-enabled document, you might do the following:

- -
-        <!--#if expr="${Mac} && ${InternetExplorer}" -->
-        Apologetic text goes here
-        <!--#else -->
-        Cool JavaScript code goes here
-        <!--#endif -->
-
- -

Not that I have anything against IE on Macs - I just struggled for a -few hours last week trying to get some JavaScript working on IE on a -Mac, when it was working everywhere else. The above was the interim -workaround.

- -

Any other variable (either ones that you define, or normal -environment variables) can be used in conditional statements. With -Apache's ability to set environment variables with the -SetEnvIf directives, and other related directives, this -functionality can let you do some pretty involved dynamic stuff without -ever resorting to CGI.

- -
-

Conclusion

- -

SSI is certainly not a replacement for CGI, or other technologies -used for generating dynamic web pages. But it is a great way to add -small amounts of dynamic content to pages, without doing a lot of extra -work.

- - - diff --git a/docs/manual/howto/ssi.html.ja.jis b/docs/manual/howto/ssi.html.ja.jis new file mode 100644 index 0000000000..eafa3150b7 --- /dev/null +++ b/docs/manual/howto/ssi.html.ja.jis @@ -0,0 +1,501 @@ + + + +Apache チュートリアル: Server Side Includes 入門 + + + + + + +

Apache チュートリアル: Server Side Includes 入門

+ + + + + + + +
+

Apache +チュートリアル: Server Side Includes 入門

+ + + + + + +
関連モジュール
+
+ mod_include
+mod_cgi
+mod_expires
+
関連ディレクティブ
+
+ Options
+XBitHack
+AddType
+AddHandler
+BrowserMatchNoCase
+ +
+ +

この文書は最初、Apache Today (http://www.apachetoday.com/) に三回の連載記事として掲載されました。 +ここでは、ApcheToday と Internet.com との協定により載せています。

+ +

この記事は、通常は単に SSI と呼ばれる Server Side Includes を +扱います。この記事においては、サーバでの SSI を許可するための設定と、 +現在の HTML ページに動的なコンテンツを加えるためのいくつかの基本的な +SSI 技術を紹介します。

+ +

記事の後半では、SSI ディレクティブで +SSI と共に実行することができる条件文のような幾分高度な事柄に +ついて述べています。

+ +
+

SSI とは?

+ +

SSI (Server Side Includes) は、HTML ページ中に配置されるディレクティブであり、 +サーバでページを提供する時に評価されます。 +SSI は、CGI プログラムやその他の動的な技術で全てのページを提供 +せずに、動的に生成されたコンテンツを現在の HTML ページに +加えます。

+ +

どういう場合に SSI を使い、どういう場合にプログラムでページを完全に生成するか +は、ページのうちどの程度が静的であり、ページが提供されるたびに +再計算する必要がどの程度あるかで通常は決定します。SSI は現在時刻のような +小さい情報を加えるにはうってつけの方法です。 +しかし、そのページのほとんどの部分が提供時に生成される場合は、 +他の方法を探す必要があります。

+ +
+

SSI を許可するための +サーバの設定

+ +

サーバで SSI 許可するには、httpd.conf ファイル +または .htaccess ファイルに次のディレクティブを指定する必要があります:

+ +
+        Options +Includes
+
+ +

この指定は、ファイルを SSI ディレクティブで解析させることを許可する +ということを Apache に伝えます。

+ +

全てのファイルが SSI ディレクティブで解析されるというわけではありません。 +どのファイルが解析されるかを Apache に伝える必要があります。これを +行なうには二つ方法があります。次のディレクティブを使うことで、 +例えば .shtml のような特別なファイル拡張子を持つファイルを +解析するよう Apache に伝えることができます:

+ +
+        AddType text/html .shtml
+        AddHandler server-parsed .shtml
+
+ +

この方法の欠点は、もし現在のページに SSI +ディレクティブを加えたい場合、それらのディレクティブが実行される +ように .shtml 拡張子にするため、そのページの名前と、 +そのページへの全てのリンクを変更しなければならないことです。

+ +

もう一つの方法は、XBitHack ディレクティブを使用することです:

+ +
+        XBitHack on
+
+ +

XBitHack は、ファイルの実行ビットが立っている場合、 +SSI ディレクティブにより解析することを Apache に伝えます。従って、 +SSI ディレクティブを現在のページに加えるためには、ファイル名を変更しなくてもよく、 +単に chmod を使用してファイルを実行可能にする +だけで済みます。

+ +
+        chmod +x pagename.html
+
+ +

行なうべきではないことに関する短いコメント。時々誰かが、 +全ての .html ファイルを SSI で解析するよう Apache に伝えれば、 +わざわざ .shtml というファイル名にする必要がないといって +薦めるのを見ることでしょう。こういう人たちは、おそらく XBitHack +について聞いたことがないのでしょう。この方法について注意することは、 +たとえ SSI ディレクティブを全く含まない場合でも、Apache がクライアントに +送る全てのファイルを最後まで読み込ませることになります。 +この方法はかなり処理を遅くするものであり、良くないアイデアです。

+ +

もちろん、Windows ではそのような実行ビットをセットするようなものは +ありませんのでオプションが少し制限されています。

+ +

デフォルトの設定では、Apache は SSI ページについて最終変更時刻や +コンテンツの長さを HTTP ヘッダに送りません。 +動的なコンテンツであるため、それらの値を計算するのが難しいからです。 +このためドキュメントが +キャッシュされなくなり、結果としてクライアントの性能が +遅くなったように感じさせることになります。 +これを解決する方法が二つあります:

+ +
    + +
  1. XBitHack Full 設定を使用する。この設定により、もともと要求された +ファイルの時刻を参照し、読み込まれるファイルの変更時刻を +無視して最終変更時刻を決定するよう Apache に伝えます。
  2. + +
  3. mod_expires で提供されているディレクティブを使用して、 +ファイルが無効になる時刻を明示します。 +これにより、ブラウザとプロキシにキャッシュが有効であることを通知します。
  4. + +
+ +
+

基本的な SSI ディレクティブ

+ +

SSI ディレクティブは以下の文法で記述します:

+ +
+        <!--#element attribute=value attribute=value ... -->
+
+ +

HTML のコメントのような書式をしているので、もし SSI を +正しく動作可能にしなければ、ブラウザはそれを無視するでしょう。しかし、 +HTML ソース中では見えます。もし SSI を正しく設定したなら、 +ディレクティブはその結果と置き換えられます。

+ +

element はたくさんあるものから一つ指定することができます。 +指定できるものの大多数については、次回もう少し詳しく説明します。 +ここでは、SSI で行なうことができる例をいくつか示します。

+ +

今日の日付

+ +
+        <!--#echo var="DATE_LOCAL" -->
+
+ +

echo 要素は単に変数の値を出力します。CGI プログラムに +利用可能な環境変数の全てのセットを含む多くの標準変数があります。 +また、set 要素を用いることで、独自の変数を定義することが +できます。

+ +

出力される日付の書式が好きではない場合、その書式を +修正するために、config 要素に timefmt 属性を +使用することができます。

+ +
+        <!--#config timefmt="%A %B %d, %Y" -->
+        Today is <!--#echo var="DATE_LOCAL" -->
+
+ +

ファイルの変更日

+ +
+        This document last modified <!--#flastmod file="index.html" -->
+
+ +

この要素も timefmt フォーマットの設定に従います。

+ +

CGI プログラムの結果を取り込む +

+ +

これは、全ての人のお気に入りである ``ヒットカウンタ'' のような CGI プログラムの +結果を出力する SSI のより一般的な使用のうちの一つです。

+ +
+        <!--#include virtual="/cgi-bin/counter.pl" -->
+
+ +
+

追加の例

+ +

以下は、SSI を使用して HTML ドキュメントにおいてできることの +いくつかの特別な例です。

+ +
+

いつこのドキュメントは修正されたのか? +

+ +

先に、ドキュメントが最後に変更されたのはいつかをユーザに通知するために SSI を使用することができることを +述べました。しかしながら、実際の方法は、いくぶん問題のままにしておきました。 +HTML ドキュメントに配置された次のコードは、ページに +そのようなタイムスタンプを入れるでしょう。もちろん、上述の +ように、SSI を正しく動作可能にしておく必要があります。

+ +
+        <!--#config timefmt="%A %B %d, %Y" -->
+        This file last modified <!--#flastmod file="ssi.shtml" -->
+
+ +

もちろん、ssi.shtml の部分を実際の当該ファイル名と +置き換える必要があります。もし、あらゆるファイルに張ることが +できる一般的なコードを探しているなら、これは不便であるかもしれません。 +おそらくその場合は、そうする代わりに変数 LAST_MODIFIED +を使用したいと考えるでしょう:

+ +
+        <!--#config timefmt="%D" -->
+        This file last modified <!--#echo var="LAST_MODIFIED" -->
+
+ +

timefmt 書式についてのより詳細については、 +お好みの検索サイトに行き、ctime で検索してみてください。文法は同じです。

+ +
+

標準のフッタを挿入する

+ +

もし数ページを超えるページを持つサイトを管理しているならば、 +全ページに対して変項を行なうことが本当に苦痛となり得ることが分かるでしょう。 +全てのページに渡ってある種の標準的な外観を維持しようと +しているならば特にそうでしょう。

+ +

ヘッダやフッタ用の挿入用ファイルを使用することで、このような +更新にかかる負担を減らすことができます。一つのフッタファイルを +作成し、それを include SSI コマンドで各ページに +入れるだけで済みます。include 要素は、file 属性 +または virtual 属性のいずれかを使用してどのファイルを挿入するかを +決めることができます。file 属性は、カレントディレクトリからの +相対パスで示されたファイルパスです。それは +/ で始まる絶対ファイルパスにはできず、また、そのパスの一部に ../ を +含むことができないことを意味します。virtual 属性は、おそらく +より便利だと思いますが、提供するドキュメントからの相対 URL で指定すべきです。 +それは / で始めることができますが、提供するファイルと同じサーバ上に +存在しなくてはなりません。

+ +
+        <!--#include virtual="/footer.html" -->
+
+ +

私は最後の二つを組み合わせて、LAST_MODIFIED ディレクティブを +フッタファイルの中に置くことがよくあります。 +SSI ディレクティブは、挿入用のファイルに含ませたり、 +挿入ファイルのネストをしたりすることができます。すなわち、 +挿入用のファイルは他のファイルを再帰的に挿入することができます。

+ +
+

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

+ +

時刻書式を config で設定できることに加えて、 +更に二つ config で設定することができます。

+ +

通常、SSI ディレクティブで何かがうまくいかないときは、次のメッセージが +出力されます。

+ +
+        [an error occurred while processing this directive]
+
+ +

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

+ +

+        <!--#config errmsg="[It appears that you don't know how to use SSI]" -->
+
+ +

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

+ +

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

+ +
+

コマンドの実行

+ +

今後数ヶ月の内に、小さな CGI プログラムと SSI を使用する +記事を出したいと考えています。ここではそれとは別に、 +exec 要素によって行なうことができることを示します。 +SSI にシェル (正確には /bin/sh。Win32 ならば DOS シェル) +を使用してコマンドを実行させることができます。下記の例では、ディレクトリ +リスト出力を行ないます。

+ +
+        <pre>
+        <!--#exec cmd="ls" -->
+        </pre>
+
+ +

Windows 上では、

+ +
+        <pre>
+        <!--#exec cmd="dir" -->
+        </pre>
+
+ +

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

+ +

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

+ +
+

高度な SSI テクニック

+ +

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

+ +

警告

+ +

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

+ +
+

変数を設定する

+ +

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

+ +
+        <!--#set var="name" value="Rich" -->
+
+ +

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

+ +
+        <!--#set var="modified" value="$LAST_MODIFIED" -->
+
+ +

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

+ +
+        <!--#set var="cost" value="\$100" -->
+
+ +

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

+ +
+        <!--#set var="date" value="${DATE_LOCAL}_${DATE_GMT}" -->
+
+ +
+

条件式

+ +

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

+ +

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

+ +
+        <!--#if expr="test_condition" -->
+        <!--#elif expr="test_condition" -->
+        <!--#else -->
+        <!--#endif -->
+
+ +

test_condition はあらゆる種類の論理的比較をすることができます。 +値を比較したり、その値が ``真'' かどうかを評価します (空でないなら +与えられた文字列は真です)。利用可能な比較演算子の全てのリストについては、 +mod_include ドキュメンテーションを参照してください。 +ここでは、この構造をどう使用するかの例をいくつか示します。

+ +

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

+ +
+        BrowserMatchNoCase macintosh Mac
+        BrowserMatchNoCase MSIE InternetExplorer
+
+ +

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

+ +

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

+ +
+        <!--#if expr="${Mac} && ${InternetExplorer}" -->
+        Apologetic text goes here
+        <!--#else -->
+        Cool JavaScript code goes here
+        <!--#endif -->
+
+ +

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

+ +

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

+ +
+

終わりに

+ +

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

+ + + -- 2.50.1