服务器端包含(Server Side Includes)，通常简称为SSI，是HTML页面中的指令，在页面被提供时由服务器进行运算，以对现有HTML页面增加动态生成的内容，而无须通过CGI程序提供其整个页面，或者使用其他动态技术。
。将服务器信息添加到一个 HTML 文档。包括以下的形式：
|Whether or not you can use SSI on your site depends on your provider. Ask your favourite support person if you can use SSI, what server software is used and if there are any special techniques, conditions or rules. For example, on my site I can only use SSI in files that have an .shtml extension instead of the normal .html one. You also have to ask what path to files to use.
Unfortunately, not all includes explained here work for all servers. For example, the #hide and #show includes are specific to WebStar. With Apache server software, you can achieve the same things by using #if and #endif.
Before starting to use server side includes, you need to configure a number of things. For starters, choose a format for date and time you like (the #echo command is explained later in this chapter).
<!–#config timefmt=”%A, %d %B %Y at %H:%M:%S”–>
Below is a table of many of the options you can use. You can also include things like colons, commas and slashes as well as bits of text and HTML. You can mix the elements below at will.
Here are some more examples of different formats:
<!–#config timefmt=”Week %U of %y”–>
<!–#config timefmt=”%d/%m/%y, day %j of the year”–>
<!–#config timefmt=”%I:%S %p”–>
The last format you have set will remain valid throughout the rest of the page. However, unless you want to use the default format (which usually is something like 98/07/12:16:45:34) you will have to set your favourite time format in every page that uses server side includes that have to do with time.
You can also specify the way file sizes are displayed.
The #fsize include is explained later in this chapter. You can see that the “bytes” option gives the size in full in bytes, the “abbrev” option gives the size in kilobytes.
You can change the default error message to anything you want. Here is an example of changing the error message and then trying to include the non-existent file “nosuchfile.html”:
<!–#config errmsg=”Sorry, an error occurred. Please mail your complaints to email@example.com”–>
There is only one error message available. However, you can change the error message more than once in a single html file:
<!–#config errmsg=”Sorry, an error occurred including nosuchfile.html. Please mail your complaints to firstname.lastname@example.org”–>
<!–#config errmsg=”Sorry, an error occurred including nosuchfileagain.html. Please mail your complaints to email@example.com”–>
Specifying your own error messages will make it easier for you to spot and solve problems. If you want to use more than one error message, you have to make sure that you change the error message before the command it refers to.
The include command allows you to dynamically insert other HTML files into the current HTML file. Use it like this:
What path to use, again, depends on your provider. Normally it will be a path that is local to the server, so it will not include http://etc. The most sensible use of this command is to take standard bits of your pages such as headers and footer and put them in a separate file. On all of your pages you use the include command to include that file. That way, in order to change the footer on all pages, you only need to change one file. For example, you could make a simple text file that contains:
<P ALIGN=”center”>Copyright 1998 Tom, Dick and Harry<BR>
You save this file as ssifooter.html and include it in your other files by using:
The files you include can be plain text files or can include HTML. You don’t need to give them <HEAD> and <BODY> tags, just put in whatever you want to insert. In these files you can use whatever HTML you want and you can make links, etc.
With the Hide and Show commands you can avoid that your reader sees certain parts of the document:
<P>Now you see me, <!–#hide–> This text is not shown. <!–#show–> now you don’t.</P
Show and Hide can be used to temporary exclude parts of your document. Hide and Show only work under WebStar, so I cannot show you an example here.
The next example shows how to display bits of HTML only after certain days. Comparisons like this always use the default time format of 1998/07/24:17:34:45 no matter what you have done with the timefmt option.
Or you can show and hide things on specific days using a combination of ‘hide after’ and ‘show after’:
As you can see, you do not have to specify a full date and time but only what is relevant for you. If you would want to show something during 1998 you could use: during=”1998″.
Here is an example of how to show a bit of text only to a user of Netscape’s Navigator:
As you can see in this example, the output of Webstar is by default on. That’s why you start any of these examples by switching the output of (#hide) and then switching it on again if the appropriate condition is fulfilled. At the end of the example you switch the output on again with a #show include. Again, show and hide do not work under Apache so I cannot show you the result here.
Show and Hide can also be used at random:
If you do a couple of reloads, you should see the text change. Of course you can use the same thing to show and hide images or any other HTML. The number that is used by Webstar is a random number ranging from 1 to 99 inclusive. Here is an example for three random texts:
In fact you can show and hide text at will using any of the environment variables (see the section on Echo below). This example shows a bit of text to a user with IP address 22.214.171.124:
If you have friends with fixed IP addresses you can leave messages especially for them in the same manner. Finally, you should know which operators are available:
Because this server runs Apache I could not show the examples of #hide and #show. I can, however, demonstrate the #if and #endif includes (if and endif, in turn, do not work under Webstar):
Hang in there, it’s almost weekend Have a nice weekend Have a good day
The first thing you will notice is that the #if include, opposite to the #hide and #show, does use the date as formatted with timefmt. This has some clear advantages. You can also see that this example is a bit easier to understand the #show and #hide spaghetti that WebStar seems to need. Note that the #if and #endif are obligatory, the #elif and #else are optional. This example uses date_gmt which is London time -ignoring summertime- rather than date_local which depends on where the server is.
The following operators are available:
you can use the #if include to show different information to different browsers. Each browser sets the environment variable http_user_agent differently. This is how Netscape Navigator 4.04, Microsoft Internet Exploder and Apple’s Cyberdog respectively do it:
Mozilla/4.04 (Macintosh; I; PPC, Nav)
As you can see these are all the Macintosh versions. By the way, this is what your own browser makes of http_user_agent: . So this is how to show different information to different browsers:
<!–#if expr=”$HTTP_USER_AGENT=/MSIE/ ” –>
Fight the Microsoft Monopoly. Get Netscape! Welcome Netscape Navigator user! Welcome Apple Cyberdog user! Welcome! So what browser are you using?
Note that the /Nav/ I am looking for here is produced by Netscape Navigator, which is Communicator without the news, mail and webeditor modules. The above is obviously not an exhaustive list of browsers, which is why there is also an #else include for all the browsers that are not covered.
The two slashes around MSIE, Nav and Cyberdog in the example above means that the second string is interpreted as a regular expression, commonly used under Unix. In this case it checks if http_user_agent contains that string.
The #set include can be used to create your own variables and assign them a value. Variables can be printed or can be used in #if statements:
<!–#set var=”carmodel” value=”Mercedes” –>
The $ sign in the #if include is needed to ensure that “carmodel” is interpreted as a variable, not as a string.
ECHO can be used to insert information from the browser and the server into your document, the so-called environment variables. The following possibilities are available:
Document Name: <!–#echo var=”document_name”–>
Not all ECHO commands always result in information being printed. This can depend on the server, on your browser and on the way you reached this page. The #echo include works both under WebStar and Apache.
If you want to print the entire environment, you do not need to use a whole list of #echo includes. Instead you can use this shortcut.
<PRE> <!–#printenv –> </PRE>
Note that the environment includes the variable “carmodel” that was defined in an earlier example.
You can use a server side include to run a script. This is what I use on my homepage:
The CGI script (which is in Perl 5) opens a file with a dozen quotes, selects one at random and prints it to the page. The script, by the way, is courtesy of Matt Wright who offers a brilliant collection of scripts.
You can insert the size of a file in this way:
This inserts the size of the file top.gif (the logo at the top of this page). As explained earlier in this chapter, you can determine if the size is displayed in full bytes or abbreviated in kilobytes or megabytes.
You can insert the date of a file in this way:
This inserts the date and the time the file top.gif (the logo at the top of this page) was last modified. The format of the date and time can be customized by you as explained earlier in this chapter.