首页 / 技术 / Apache Tomcat服务器SSI(用来支持shtml)配置大全

Apache Tomcat服务器SSI(用来支持shtml)配置大全

技术 • 2009-10-08 10:52:06 • 阅读 5296

最近在配一台Apache Tomcat服务器，其中需要配置SSI功能，我从网上搜集了Apache Tomcat中SSI配置的详细方法，拿来做个备忘。

一、SSI简介

SSI全称（Server Side Includes）是在HTML静态页面中使用的指令，当页面在服务端执行的时候是可以进行服务端解析的。这种方式可以让我们在存在的HTML页面里面分块动态生成内容而不在整个执行了CGI等服务端技术的基础之上进行动态页面服务。在返回请求的页面(包含SSI指令)前，服务器会处理这些指令，并用处理的结果替换指令，然后把页面返回。我们使用Tomcat作为HTTP服务器的时候，我们需要使用SSI可以在Tomcat添加对SSI的支持。

Tomcat服务器的SSI支持的实现方式和Apache里面的SSI指令一样，在Tomcat里面实现SSI支持使用的是一个Servlet和一个Filter（Servlet和Filter的基本信息参考JSP教程），我们可以使用其中一种方式来进行SSI支持的配置，但是不需要两个同时配置，同时配置是否会产生冲突我不太清楚，一般情况下配置一个就可以了。

实现SSI支持的Servlet实现使用了org.apache.catalina.ssi.SSIServlet，另外需要在Servlet的路径解析里面添加映射规则【*.shtml】。

实现SSI支持的Filter使用了org.apache.calalina.ssi.SSIFilter。另外，在Filter路径解析里面也需要添加映射规则【*.shtml】，而且在Filter配置的时候需要在映射规则里面添加能够执行的mime type，contentType的初始化参数允许你执行服务器下边的资源。在Tomcat里面默认是禁用了SSI的。

注意：SSI指令执行Tomcat外部的JVM，如果我们使用Java的安全管理器需要在calalina.policy文件里面进行配置。若要使用SSI Servlet和SSI Filter，直接在服务器的路径$CATALINA_BASE/conf/web.xml文件里面将SSI的注释去掉。需要注意的是在Tomcat服务器里面仅仅只有标记了privileged的Context可以使用SSI功能。（当privileged设置为true的时候，才允许Tomcat的Web应用使用容器内的Servlet，Tomcat的文档里面讲了使用的lib的域，每个应用程序如果不设置这个属性，是不能访问容器内的Servlet的，这里应该指代的是全局的Servlet）

否则这里会遇到异常：

java.lang.SecurityException: Filter of class org.apache.catalina.ssi.SSIFilter(SSIServlet)is privileged and cannot be loaded by this web application

二、服务器配置属性

在配置SSI Servlet的时候需要用到的参数（init parameters）如下：

buffered：是需要将输入保存到缓冲区（0=false,1=true）默认是0（false）；

debue：配置调试日志的记录级别，默认0；

expires：SSI包含某个页面的超时配置，默认行为是所有的SSI指令在每一次请求中执行；

isVirtualWebappRelative：是针对Tomcat Context的根目录（虚拟目录）进行相对路径解析还是针对Tomcat的服务器目录进行相对路径解析（0=false,1=true）默认是0，不使用虚拟目录；

inputEncoding：如果资源不是自身的，资源来自于容器外部，可以针对外部资源进行编码的设置，以什么变法方式输入资源，默认使用的是资源所在平台使用的编码；

outputEncoding：SSI执行结果输出的编码方式，默认是UTF-8的。

配置SSI Filter的时候需要使用以下参数（init paramters）：

contextType：配置一个可以匹配的正则表达式规则提供给SSI执行使用，若自定义自己的匹配规则，需要在mime 类型里面配置下边的可选项：在form里面设置【mime/type;charset=set】默认的是【text/x-server-parsed-html(;.*)?】

debug：同上

expires：同上

isVirtualWebappRelative：同上

三、指令描述

SSI是被HTML文档内需要进行处理的包含部分的SSI Servlet调用的。这些指令是HTML文档的注释形式，这些指令在将内容发送到客户端之前进行内容的替换。标准格式如下：

这些指令包括：

config：设置日期格式一起被SSI处理的其他数据()

echo：将会被变量的值替换掉()

exec：用来执行服务器端的命令

include：包含某些内容()

flastmod：返回某个文件最后一次修改的时间()

fsize：返回某个文件的大小()

printenv：返回所有定义的变量()

set：用来为定义的变量赋值()

if elif endif else：创建条件分支语句

>>附件：Apache SSI官方文档

四、SSI Servlet里面的变量

AUTH_TYPE——针对用户的认证授权方式：BASIC，FORM，etc.和Tomcat内的认证方式同步

CONTENT_LENGTH——从服务器表单传过来的数据长度，字符数目或者数据的字节数

CONTENT_TYPE——服务器访问呢数据的MIME类型，比如【text/html】

DATE_GMT——目前的时间格式方式使用GMT

DATE_LOCAL——目前的时间格式方式设置成为本地时间格式

DOCUMENT_NAME——当前上下文环境的文件地址

DOCUMENT_URI——虚拟路径定义的文件地址

GATEWAY_INTERFACE——CGI的版本定义：【CGI/1.1】

HTTP_ACCEPT——一个客户端可以接受的MIME类型列表

HTTP_ACCEPT_ENCODING——客户端可以接受的压缩文件类型的列表

HTTP_ACCEPT_LANGUAGE——客户端可以支持的语言列表

HTTP_CONNECTION——管理客户端的连接：是【Close】还是【Keep-Alive】

HTTP_HOST——客户端请求的站点地址

HTTP_REFERER——客户端请求之前所在的URL地址

HTTP_USER_AGENT——客户使用的浏览器端的请求结果

LAST_MODIFIED——当前页面上一次访问和修改的时间

PATH_INFO——访问此Servlet的路径信息

PATH_TRANSLATED——PATH_INFO提供的translated版本

QUERY_STRING——在URL地址?之后的请求参数列表

QUERY_STRING_UNESCAPED——没有经过编码过的请求参数

REMOTE_ADDR——用户请求客户端IP地址

REMOTE_HOST——用户发送请求的主机名

REMOTE_PORT——用户发送请求的端口号

REMOTE_USER——认证授权需要的发送请求的用户名

REQUEST_METHOD——请求使用方法：GET或者POST

REQUEST_URI——客户端原来访问请求的Web页面的URI地址

SCRIPT_FILENAME——在服务器上当前页面的地址

SCRIPT_NAME——当前页面的名称

SERVER_ADDR——服务器所在的IP地址

SERVER_NAME——服务器的主机名或者IP地址

SERVER_PORT——服务器接受请求的端口号

SERVER_PROTOCOL——服务器处理请求的协议：【HTTP/1.1】

SERVER_SOFTWARE——服务器响应客户端请求的名称和版本号

UNIQUE_ID——一旦创建链接过后每一次会话由服务器分配的唯一会话标识（是不是SessionID？我不敢肯定，因为没有做过验证，有可能是有可能不是，不过有一点，此属性和直接和会话相关的。）

五、配置过程

1、先保证Tomcat可以运行，即能够正常启动

2、（5.x版本）服务器根目录下边$TOMCAT_HOME(或者$CATALINA_HOME)/server/lib/目录下边有一个文件：

servlets-ssi.renametojar，将这个文件名更名为一个jar后缀，当然最方便的方法是直接改掉文件后缀，按照Tomcat扫描jar路径类的原理来讲，直接更名为jar应该也是可以的，不过我没尝试过，一般网上最常用的方法是改成：servlets-ssi.jar。（6.x版本）服务器不需要去寻找jar文件了，直接进入下一步操作都可以。

3、找到文件：$TOMCAT_HOME(或者$CATALINA_HOME)/conf/web.xml，这里面不需要我们自己写入SSI Servlet和SSI Filter的配置，首先我们要选择使用哪种方式来配置：

Servlet配置：

在这个文件里面，找到以下注释代码段，将注释代码段去掉：

Servlet配置

<!--

<servlet>

    <servlet-name>ssi</servlet-name>

    <servlet-class>

      org.apache.catalina.ssi.SSIServlet

    </servlet-class>

    <init-param>

      <param-name>buffered</param-name>

      <param-value>1</param-value>

    </init-param>

    <init-param>

      <param-name>debug</param-name>

      <param-value>0</param-value>

    </init-param>

    <init-param>

      <param-name>expires</param-name>

      <param-value>666</param-value>

    </init-param>

    <init-param>

      <param-name>isVirtualWebappRelative</param-name>

      <param-value>0</param-value>

    </init-param>

    <load-on-startup>4</load-on-startup>

</servlet>

-->

ServletMapping配置

<!--

<servlet-mapping>

    <servlet-name>ssi</servlet-name>

    <url-pattern>*.shtml</url-pattern>

</servlet-mapping>

-->

Filter配置：

Filter的相关配置

<!--

<filter>

    <filter-name>ssi</filter-name>

    <filter-class>

      org.apache.catalina.ssi.SSIFilter

    </filter-class>

    <init-param>

      <param-name>contentType</param-name>

      <param-value>text/x-server-parsed-html(;.*)?</param-value>

    </init-param>

    <init-param>

      <param-name>debug</param-name>

      <param-value>0</param-value>

    </init-param>

    <init-param>

      <param-name>expires</param-name>

      <param-value>666</param-value>

    </init-param>

    <init-param>

      <param-name>isVirtualWebappRelative</param-name>

      <param-value>0</param-value>

    </init-param>

</filter>

-->

FilterMapping相关配置

<!--

<filter-mapping>

    <filter-name>ssi</filter-name>

    <url-pattern>*.shtml</url-pattern>

</filter-mapping>

-->

只是Filter配置里面还需要取消另外一个注释，下边的MIME TYPE的服务器支持相关注释

<!--

<mime-mapping>

    <extension>shtml</extension>

    <mime-type>text/x-server-parsed-html</mime-type>

</mime-mapping>

-->

上边的注释取消过后，配置就基本好了，在Tomcat 5.x的版本中配置的时候，到这个地步就结束了，但是在Tomcat 6.x版本中可能还会出现下边的异常：

java.lang.SecurityException: Filter of class org.apache.catalina.ssi.SSIFilter(SSIServlet) is privileged and cannot be loaded by this web application

4、所以正对这点6.x还有一个步骤，在$TOMCAT_HOME(或者$CATALINA_HOME)/conf/context.xml文件中在<Context>结点添加一个属性privileged="true"，然后再启动就不会抛出上边的异常了。

5、若要解决乱码问题，根据上边文档需要修改SSI中的启动参数，添加如下代码：

<init-param>

    <param-name>inputEncoding</param-name>

    <param-value>utf-8</param-value>

</init-param>

<init-param>

    <param-name>outputEncoding</param-name>

    <param-value>utf-8</param-value>

</init-param>

以上代码中的参数请看上面服务器配置属性。

主机

您可能感兴趣的

解决PDF.js只显示英文界面，不能显示中文的方法

PDF.js是一个开源的PDF在线预览js库，兼容性好，界面十分友好，还支持多语言，但是今天把项目传到IIS上发现只有英文，不会像PDF.js官网demo里那样自动显示中文，研究了一番原来PDF.js的语言包后缀名是.properties，显然IIS默认不会识别出这个语言包，所以需要添加一个MIME...

技术 • 5年前 • 阅读 4207

解决Redhat7（Linux）配置了启动脚本/etc/rc.d/rc.local后不执行的问题

Redhat7（Linux）的启动脚本文件是/etc/rc.d/rc.local，但是今天配置了一台服务器，发现启动后并不执行这个文件，研究了半天是权限问题...

技术 • 5年前 • 阅读 2167

解决VMware vSphere Client (HTML5) 网页端安装操作系统无法加载本地ISO镜像文件的方法

我们在用VMwarevSphereClient(HTML5)Web控制台来安装操作系统时，不能加载本地ISO文件，只能加载数据存储中的ISO文件，得先把ISO文件上传到服务器的数据存储中，有点麻烦。...

技术 • 6年前 • 阅读 2471

VMware vCenter 6.7上传文件到数据存储提示操作失败，此问题是由于浏览器不信任证书引起的解决方法

今天用VMwarevCenter6.7上传ISO文件到数据存储，提示说操作失败，此问题是由于浏览器不信任证书引起的，错误的原因是浏览器对VMwarevCenter的私有SSL证书不信任导致。...

技术 • 6年前 • 阅读 3856

解决VMware vSphere 6.7Web控制台中鼠标不显示的方法

今天在VMwarevSphereClient6.7中使用Web控制台或是使用VMwareRemoteConsole(VMRC)打开虚拟机操作系统，看不到鼠标指针，只能使用键盘操作，非常麻烦，研究了一番终于找到了解决方法，拿来分享。...

技术 • 6年前 • 阅读 5562

Windows Server 2012 R2下IIS8.5伪静态插件下载

WindowsServer2012R2默认情况下是不支持IISURLRewrite模块的，需要去微软官方下载，下面给出下载地址。...

下载 • 7年前 • 阅读 1546