phpEnv配置Nginx多站点 phpEnv Nginx配置详解

酷晨姑娘_2313

酷晨姑娘_2313

2026-04-26

416人浏览

原创

phpEnv多站点需直接编辑主nginx.conf添加server块,用正斜杠路径、fastcgi_pass 127.0.0.1:9000、hosts绑定域名,并通过nginx -t验证后重启控制面板。

phpenv配置nginx多站点 phpenv nginx配置详解

phpEnv 是一个 Windows 下的 PHP 环境集成包(类似 XAMPP、WAMP),它自带 Nginx、PHP、MySQL,面向本地开发。但它的默认配置不支持开箱即用的多站点——你得手动改 Nginx 配置,且要注意它和标准 Linux Nginx 的路径、权限、进程模型差异很大。

phpEnv 中 Nginx 多站点必须改 nginx.conf,不能只靠 sites-enabled

phpEnv 的 Nginx 配置是扁平化的:它没有 /etc/nginx/sites-available 或 sites-enabled 机制,所有虚拟主机都写在主配置文件里(通常是 D:\phpEnv\nginx\conf\nginx.conf 或 D:\phpEnv\server\nginx\conf\nginx.conf,取决于安装路径)。
你如果照搬 Linux 教程去建 conf.d/ 子目录再 include,大概率会失败——因为默认配置里根本没这行 include。

  • 必须直接编辑 nginx.conf,在 http 块内添加多个 server 块
  • 每个 server 块开头就写清 listen 80; 和 server_name site1.test site1.local;
  • 不要省略 root,比如 root D:/phpEnv/www/site1; —— 注意 Windows 路径用正斜杠或双反斜杠,单反斜杠会解析失败
  • index 推荐写全:index index.php index.html;,否则 .php 文件可能不触发 PHP-FPM

PHP-FPM 在 phpEnv 里是全局共用的,但每个站点要配对正确的 fastcgi_pass

phpEnv 默认只启一个 PHP-FPM 实例(监听 127.0.0.1:9000 或 tcp://127.0.0.1:9000),所有站点都走这个端口。所以你不用为每个站点建独立 FPM 池——但必须确保每个 server 块里的 PHP location 都指向它:

  • 正确写法:fastcgi_pass 127.0.0.1:9000;
  • 错误写法:fastcgi_pass unix:/run/php/php8.1-fpm.sock;(这是 Linux 路径,Windows 下不存在)
  • 如果你改过 PHP-FPM 监听方式(比如改成命名管道),fastcgi_pass 必须同步改,否则 502

常见错误现象:

  • 所有站点首页能打开,但点链接进子页面就 404 → location / 里漏了 try_files $uri $uri/ /index.php?$query_string;(尤其 Laravel、ThinkPHP 类框架必需)
  • 访问 PHP 文件显示源码 → location ~ .php$ 块没生效,检查是否被前面的 location / 覆盖,或正则写成了 .php$(少转义)

hosts 文件必须手动加条目,DNS 不起作用

phpEnv 是本地环境,没有公网 DNS 解析。浏览器发请求时 Host 头就是你输的域名(如 site1.test),Nginx 靠这个匹配 server_name。但系统得先知道这个域名指向哪台机器。

Nginx Hosting
Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式,无需登录、无需令牌、无需用户操作。

下载
  • 编辑 C:\Windows\System32\drivers\etc\hosts(需管理员权限)
  • 加一行:127.0.0.1 site1.test site2.test admin.site1.test
  • 别写 localhost 当 server_name —— 它会被第一个 server 块捕获,后续站点全失效
  • 大小写不敏感,但建议全小写统一管理

修改后必须用 nginx -t + 重启 phpEnv 控制面板

phpEnv 的 Nginx 不响应 systemctl 或 service 命令。每次改完配置:

  • 打开命令行,cd 到 D:\phpEnv\nginx\(或你的实际路径)
  • 运行:nginx -t —— 看是否输出 nginx: configuration file nginx.conf test is successful
  • 如果报错,重点看行号和关键词:invalid number of arguments in "root" directive(root 后多空格)、unknown directive "include"(用了未启用的 include)
  • 测试通过后,在 phpEnv 控制面板里点「重启 Nginx」,不是「重载」—— 它的重载功能经常不生效

Windows 路径分隔符、PHP-FPM 通信方式、缺少 systemd 管理、以及 hosts 绑定强依赖,这四点是 phpEnv 多站点最常卡住的地方。别套 Linux 经验,先确认你改的是哪个 nginx.conf,再逐行验证。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

phpenv php nginx

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

11844

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

6801

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2195

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

4328

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

5034

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3971

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

5717

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

4482

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12362

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
使用phpenv集成环境安装极致CMS
使用phpenv集成环境安装极致CMS

共2课时 | 302人学习

phpEnv手册
phpEnv手册

共0课时 | 0人学习