phpEnv是一款集成了多种开发环境的本地服务套件,默认包含Nginx、PHP、MySQL等组件,同时支持集成Tomcat运行Java项目。通过配置可以让Nginx处理静态资源,将Java动态请求转发给Tomcat,实现动静分离的效果,提升本地开发环境的运行效率。

前期准备
首先确保已经安装好phpEnv,并且已经下载了对应版本的Tomcat压缩包,解压到本地任意目录,记住Tomcat的解压路径。同时确认phpEnv中的Nginx组件处于可正常启动状态,PHP版本可以根据自身需求选择,不影响Tomcat的配置。
启动Tomcat服务
进入Tomcat解压目录的bin文件夹,根据系统选择启动脚本:Windows系统双击startup.bat,Linux或macOS系统在终端执行startup.sh。启动后打开浏览器访问http://127.0.0.1:8080,如果看到Tomcat的默认欢迎页面,说明Tomcat已经正常启动。
如果启动失败,可以检查8080端口是否被占用,若被占用可以修改Tomcat的conf/server.xml文件中的端口配置,示例如下:
<!-- 修改Connector节点的port属性为其他未被占用的端口,比如8090 -->
<Connector port="8090" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />
配置phpEnv的Nginx实现反向代理
打开phpEnv的管理面板,找到Nginx的配置文件入口,一般是在站点管理或者Nginx配置选项中,选择需要配置动静分离的站点,或者新建一个站点配置。
在Nginx的站点配置中添加反向代理规则,将后缀为.jsp、.do等Java动态请求转发到Tomcat的端口,静态资源则由Nginx直接处理。示例配置如下:
server {
# 监听端口,根据phpEnv站点配置调整
listen 80;
# 站点域名,本地可以设置为test.local
server_name test.local;
# 静态资源根目录,存放css、js、图片等静态文件
root /www/wwwroot/test_static;
index index.html index.htm;
# 静态资源匹配规则,由Nginx直接处理
location ~ .*.(gif|jpg|jpeg|png|bmp|swf|css|js|html)$ {
expires 30d;
}
# Java动态请求转发到Tomcat
location ~ .*.(jsp|do|action)$ {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
# 其他请求默认也转发到Tomcat,可根据需求调整
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
配置完成后保存,在phpEnv面板中重启Nginx服务,让配置生效。
验证动静分离效果
首先在Nginx配置的静态资源根目录下新建一个test.html文件,内容如下:
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>静态页面测试</title>
</head>
<body>
<h1>这是Nginx处理的静态页面</h1>
</body>
</html>
然后在Tomcat的webapps/ROOT目录下新建一个test.jsp文件,内容如下:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>动态页面测试</title>
</head>
<body>
<h1>这是Tomcat处理的动态JSP页面</h1>
<p>当前时间:<%= new java.util.Date() %></p>
</body>
</html>
打开浏览器分别访问http://test.local/test.html和http://test.local/test.jsp,如果静态页面正常显示,动态JSP页面也能正确输出时间,说明动静分离配置成功。
常见问题排查
- 如果访问动态请求返回404,检查Nginx的
proxy_pass地址和端口是否和Tomcat的实际端口一致,确认Tomcat服务正常运行。 - 如果静态资源无法加载,检查Nginx的
root路径是否正确,静态文件的权限是否允许Nginx读取。 - 如果修改配置后不生效,确认是否在phpEnv中正确重启了Nginx服务,也可以检查Nginx的配置文件语法是否有误,在phpEnv的Nginx配置页面一般有语法检查功能。