看到这个标题,有人可能会想吐槽:

你他娘的写了这么久 PHP,怎么现在想起来搭建开发环境了?

呃,情况呢是这么个情况,我之前开发的那个 PHP 项目 (printempw/blessing-skin-server) 在两个月前发布 v3.5.0 版本后基本就已经告一段落了。虽然我本意是不再更新(弃坑的委婉说法),因为当前的版本已经足够完善,该有的东西都有了(而且说实话搞了这么久我也腻味,不仅是对这个程序,还有对国内 Minecraft 开发生态以及用户群体的失望)。

不过我的朋友 g-plane 说他愿意接坑,所以现在这个项目的后续开发都是他在搞。而我也乐得清闲,做个甩手掌柜 搞别的 去了。当我摸鱼正快活时,他过来联系我说准备发布 4.0.0-alpha 了,我才想起来这茬:「啊,我连新版本长啥样都还不知道呢!😂」于是急急忙忙 pull 了新代码准备 review 一下,却发现我的新笔电上甚至压根儿就没安装 PHP 开发环境,只能说是非常地真实。

因为 某些原因,我不想继续使用那些 PHP 一键包来搭建开发环境了,所以这次我打算全部自己来。本文记录了我手动安装配置 PHP + Nginx/Apache 开发环境的过程,希望能帮到后来人。

注意,本文中的配置适用于本地开发环境,应用至生产环境时要注意哦。

0x01 安装 Nginx / Apache

如果你用的是 Nginx:

  • 官网 下载 Windows 版的 Nginx(我下载的是 nginx-1.14.0.zip);
  • 解压至你喜欢的地方(我放在 E:\environment\nginx 里);
  • 直接双击运行 nginx.exe
  • 如果能正常访问 http://localhost:80,就可以进行下一步了。

推荐修改的 nginx.conf 配置如下:

# 可以适当调高,但不要超过 CPU 核心数量
worker_processes  4;

events {
    # 开发环境下不用太考虑 worker 最大并发连接数
    worker_connections  1024;
}

http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile      on;
    keepalive_timeout 65;

    # 启用 gzip
    gzip on;
    gzip_disable "MSIE [1-6].(?!.*SV1)";
    gzip_http_version 1.1;
    gzip_vary on;
    gzip_proxied any;
    gzip_min_length 1000;
    gzip_buffers 16 8k;
    gzip_comp_level 6;
    gzip_types text/plain text/css text/xml text/javascript application/json application/x-javascript application/xml application/xml+rss;

    # 这里面的内容等 0x03 再细说
    include vhosts.conf;
}

如果你用的是 Apache:

  • 因为 Apache 官网并不提供 Windows 版的构建下载,所以需要去 Apache Lounge 或者其他 官方推荐的站点 下载预编译二进制包(我下载的是 httpd-2.4.37-win64-VC15.zip,你愿意的话也可以自己编译);
  • 解压至你喜欢的地方(我放在 E:\environment\apache 里);
  • 直接双击运行 bin/httpd.exe
  • 如果能正常访问 http://localhost:80,就可以进行下一步了。

推荐修改的 httpd.conf 配置如下:

# 修改为你的安装目录
Define SRVROOT "E:\environment\apache"
ServerRoot "${SRVROOT}"

Listen 80
ServerName localhost

# 按需启用模块
LoadModule rewrite_module modules/mod_rewrite.so
LoadModule ...

# 推荐注释掉自带的 DocumentRoot 和 <Directory>
# 这里面的内容等 0x03 再细说
Include conf/extra/httpd-php.conf
Include conf/vhosts.conf

0x02 安装 PHP

Windows 版 PHP 下载地址:

https://windows.php.net/download

其中有 NTS(Non Thread Safe,非线程安全)和 TS(Thread Safe,线程安全)两种版本,简单来说就是 Nginx 用 NTS 版,Apache 通常用 TS 版(也可以用 NTS),它们之间的具体区别有兴趣的话可以自己去了解一下。

为了同时兼容 Nginx 与 Apache,本文将以 NTS 版为例进行配置。

  • 下载合适的版本(我下载的是 php-7.2.11-nts-Win32-VC15-x64.zip);
  • 解压至你喜欢的位置(我放在 E:\environment\php 里);
  • 复制一份 php.ini-development,重命名为 php.ini 并适当修改其中配置;
  • 直接双击运行 php.exe
  • 如果能正常打开 PHP Interactive Shell,就可以进入下一步了。

如果无法运行,请检查你是否安装了对应的 VC 运行库。

推荐修改的 php.ini 配置如下:

; 扩展所在的目录,自行修改
extension_dir = "E:\environment\php\ext"
; 按自己的需求启用扩展
extension=pdo_mysql
extension=...
; 各种缓存的位置
sys_temp_dir = "E:\environment\php\temp"
upload_tmp_dir = "E:\environment\php\temp"
session.save_path = "E:\environment\php\temp"
; 其他杂七杂八的
upload_max_filesize = 100M
date.timezone = Asia/Shanghai

0x03 配置 FastCGI 转发

接下来才是重头戏,我们要让 Web Server 与 PHP 能够互相通信以完成请求。

作为 Web Server 的后端时,PHP 主要有两种运行方式,一种是 独立进程、使用 FastCGI 协议 与 Web Server 通信(Nginx 用的就是这种),另外一种是 作为模块直接加载到 Web Server 中(比如 Apache 的 mod_php 模块,不过 Apache 也支持 FastCGI 方式)。详细的原理我就不介绍了,有兴趣的选手可以去了解一下。

为了能够同时兼容 Nginx 和 Apache,本文均使用 FastCGI 方式加载 PHP


首先我们需要配置一下 PHP 的 FastCGI 进程管理器。为什么呢?因为直接运行 PHP 的 FastCGI 进程(在 Windows 上就是 php-cgi.exe)有以下缺点:

  • 配置文件 php.ini 修改后无法平滑重载,需要重新启动 php-cgi 进程;
  • Windows 下 php-cgi 默认处理 500 个请求后就自动退出(PHP_FCGI_MAX_REQUESTS);
  • 如果因为其他原因造成 php-cgi 进程崩溃,就无法处理后续请求了。

所以我们需要一个类似守护进程的东西,来保证始终有一定数量的 php-cgi 进程在运行。PHP-FPM (PHP FastCGI Process Manager) 是 PHP 官方钦定的 FastCGI 进程管理器,但遗憾的是,它只适用于类 Unix 系统。在 Windows 上,我们可以使用这些替代品来实现类似的功能(Apache 用户不需要配置这些东西,因为它的 mod_fcgid 模块自带 FastCGI 进程管理功能):

本文将以 php-cgi-spawner 为例进行配置。

  • 这里 下载编译好的 php-cgi-spawner.exe

  • 放到 PHP 的安装目录下(本文为 E:\environment\php);

  • 打开 PowerShell 或者 CMD,运行命令:

    # 令 PHP FastCGI 处理程序监听在 9000 端口上
    # 至少开启 4 个 php-cgi 进程,高负载时最多可以开到 16 个
    .\php-cgi-spawner.exe "php-cgi.exe -c php.ini" 9000 4+16
    
  • 如果一切正常,你将可以在任务管理器中看到同时运行的多个 php-cgi 进程。

php-cgi-processes

接下来修改 Nginx 配置(即 0x01 中提到的 vhosts.conf 中的内容),通过 FastCGI 协议将请求转发给监听在 9000 端口上的 PHP 进行处理:

server {
    listen       80;
    server_name  localhost;
    root   E:/wwwroot;
    index  index.html index.htm index.php;

    location ~ [^/]\.php(/|$) {
        # 从 URI 中分离出 $fastcgi_script_name 和 $fastcgi_path_info 的值
        # 不推荐使用 php.ini 中的 cgi.fix_pathinfo 选项,这可能会造成安全隐患
        # 虽然我感觉 8012 年了应该没人用 PATH_INFO 了……不需要的话去掉即可
        fastcgi_split_path_info  ^(.+?\.php)(/.*)$;
        fastcgi_param  PATH_INFO  $fastcgi_path_info;

        # 当请求的 .php 文件不存在时直接返回 404
        # 不然交给 PHP 处理的话那边就会返回 No input file specified.
        if (!-f $document_root$fastcgi_script_name) {
            return 404;
        }

        fastcgi_pass   127.0.0.1:9000;
        fastcgi_index  index.php;
        # 自带的配置文件,里面设置了一大堆 CGI 协议中的变量
        include        fastcgi.conf;
    }
}

Apache 用户不需要手动配置 PHP FastCGI 进程管理器,相对简单一些:

  • 在上面提到的 Apache Lounge 上下载编译好的 mod_fcgid 模块;
  • 解压后,将 mod_fcgid.so 放入 Apache 的 modules 目录;
  • 编辑配置文件加载模块(即 0x01 中提到的 conf/extra/httpd-php.conf):
# 如果嫌麻烦的话这一段也可以直接放到 httpd.conf 里面去
LoadModule fcgid_module modules/mod_fcgid.so

<IfModule fcgid_module>
FcgidInitialEnv PHPRC "E:/environment/php/"
FcgidInitialEnv PHP_FCGI_MAX_REQUESTS 1000
AddHandler fcgid-script .php
FcgidWrapper "E:/environment/php/php-cgi.exe" .php
FcgidIOTimeout 384
FcgidConnectTimeout 360
FcgidOutputBufferSize 128
FcgidMaxRequestsPerProcess 1000
FcgidMinProcessesPerClass 0
FcgidMaxProcesses 16
FcgidMaxRequestLen 268435456
ProcessLifeTime 360
</IfModule>
  • 编辑 conf/vhosts.conf 允许运行 CGI 程序:
<VirtualHost localhost:80>
  DocumentRoot "E:\wwwroot"
  <Directory "E:\wwwroot">
    DirectoryIndex index.html index.php
    # 注意这里的 +ExecCGI,不加的话会 403
    Options -Indexes -FollowSymLinks +ExecCGI
    AllowOverride All
    Order allow,deny
    Allow from all
    Require all granted
  </Directory>
</VirtualHost>

如果一切配置正确,你应该就能正常访问 PHP 网页了。

nginx-php-works

0x04 编写启停脚本

虽然整个系统是跑起来了,但总不能每次启动都得开一大堆控制台窗口吧?弄个小工具管理 Nginx/Apache 和 PHP 的进程还是很有必要的。各种一键包中一般都自带了方便好用的界面来管理这些进程,不过既然我们选择了手动配置,那这一块也得我们自己搞定了。因为图方便,我选择使用 Windows 的批处理脚本(Batch File)来完成这项需求,保存为 .bat 文件双击运行就完事儿了。

启动 Nginx 和 PHP:

@ECHO OFF
set nginx_home=..\nginx
set php_home=..\php

ECHO Starting PHP FastCGI...
.\RunHiddenConsole.exe %php_home%\php-cgi-spawner.exe "%php_home%\php-cgi.exe -c %php_home%\php.ini" 9000 4+16

ECHO Starting Nginx...
.\RunHiddenConsole.exe %nginx_home%\nginx.exe -p %nginx_home%

停止 Nginx 和 PHP:

@ECHO OFF

ECHO Stopping nginx...
taskkill /F /IM nginx.exe > nul

ECHO Stopping PHP FastCGI...
taskkill /F /IM php-cgi-spawner.exe > nul
taskkill /F /IM php-cgi.exe > nul

重载 Nginx 配置:

@ECHO OFF
set nginx_home=..\nginx

ECHO Reloading Nginx...
%nginx_home%\nginx.exe -s reload

启动 Apache(Apache 会帮我们启动 PHP 的):

@ECHO OFF
set apache_home=..\apache

ECHO Starting Apache Httpd...
.\RunHiddenConsole.exe %apache_home%\bin\httpd.exe

停止 Apache:

@ECHO OFF

ECHO Stopping Apache Httpd...
taskkill /F /IM httpd.exe > nul

这些脚本我放在 E:\environment\scripts 目录中,如果你需要放在其他地方,请适当修改脚本中的可执行文件路径。另外,脚本中用到了 RunHiddenConsole.exe 来隐藏命令行窗口,你可以在 这里 下载到这个小工具。

wnmp-all-processes

0x05 后记

配置完成后的目录结构大概是这样的(有省略):

E:\environment> tree
.
├── apache
│   ├── bin
│   ├── cgi-bin
│   ├── conf
│   │   ├── extra
│   │   ├── original
│   │   ├── charset.conv
│   │   ├── httpd.conf *
│   │   ├── magic
│   │   ├── mime.types
│   │   ├── openssl.cnf
│   │   └── vhosts.conf *
│   ├── include
│   ├── lib
│   ├── logs
│   └── modules
├── mysql
│   ├── bin
│   ├── data
│   ├── include
│   ├── lib
│   └── share
├── nginx
│   ├── conf
│   │   ├── fastcgi.conf
│   │   ├── fastcgi_params
│   │   ├── koi-utf
│   │   ├── koi-win
│   │   ├── mime.types
│   │   ├── nginx.conf *
│   │   ├── scgi_params
│   │   ├── uwsgi_params
│   │   ├── vhosts.conf *
│   │   └── win-utf
│   ├── contrib
│   ├── logs
│   └── nginx.exe
├── php
│   ├── dev
│   ├── ext
│   ├── extras
│   ├── lib
│   ├── sasl2
│   ├── temp
│   ├── ...
│   ├── php7.dll
│   ├── php-cgi.exe
│   ├── php-cgi-spawner.exe *
│   ├── php.exe
│   └── php.ini *
└── scripts
    ├── reload-nginx.bat
    ├── restart-nginx.bat
    ├── RunHiddenConsole.exe
    ├── start-all.bat
    ├── start-apache.bat
    ├── start-mysql.bat
    ├── start-nginx.bat
    ├── stop-all.bat
    ├── stop-apache.bat
    ├── stop-mysql.bat
    └── stop-nginx.bat

非常清爽,有种一切尽在掌控中的感觉,我喜欢。

如果你是一名 PHP 开发者,却从来没有手动配置过 PHP 环境的话,那我建议你尝试一下。虽然生产环境上一般都是采用成熟的一键包,不过手动配置一下这一套东西可以更深入地了解 PHP 与 Web Server 的协作机制,这对于编写上层应用以及运维也是很有好处的。

本来想顺带凑齐一套 WNMP,但是 MySQL 的安装配置相对比较简单,而且也不像 PHP 与 Web Server 那样耦合紧密,所以这里就按下不表。

以上。

除另有声明外,本博客文章均采用 知识共享(Creative Commons) 署名-非商业性使用-相同方式共享 3.0 中国大陆许可协议 进行许可。