PHP 7.4 实战：Nginx + PHP-CGI + Xdebug 调试一体化

前置知识

Windows 命令行基础（cmd / PowerShell）
知道什么是 Web 服务器、什么是 CGI
至少跑过一个 PHP 页面

为什么 2020 年还在用 PHP

2010 年代后期，Go / Node.js / Python Web 框架方兴未艾，唱衰 PHP 的声音不断——“性能差”、“语法老”、“现代特性缺”。但 PHP 7.4（2019-11 发布）做了一次关键升级：

PHP 7.0 vs 5.6 性能提升 2 倍（WordPress 主页 QPS 从 100 涨到 300+）
OPcache 集成（字节码缓存默认开启）
类型属性（class 属性可以声明 int、string）
箭头函数（fn($x) => $x * 2）
预加载（PHP 7.4 新特性，把框架文件预加载到 OPCache）

WordPress 占据全球 40%+ 的网站、Magento / Laravel 长期稳居主流——PHP 工程师的需求量在 2020 年依然巨大。学 PHP 7.4 是性价比最高的后端入门选择。

一、Windows 下 PHP 7.4 + Nginx 一体化搭建

1.1 下载三件套

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
# 1. Nginx 1.18
# 官网下载 stable 版
# https://nginx.org/en/download.html

# 2. PHP 7.4.6 (NTS, x64, VC15)
# https://windows.php.net/download/
# 选 php-7.4.6-nts-Win32-vc15-x64.zip

# 3. RunHiddenConsole.exe
# 一个 1KB 工具，让 nginx / php 以后台方式跑
# 网上搜 RunHiddenConsole 下载

1.2 目录规划

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
<PHP_SOFT_DIR>
├── nginx-1.18.0\
├── php-7.4.6\
│   ├── php.exe
│   ├── php.ini
│   ├── ext\
│   └── php-cgi.exe
├── RunHiddenConsole.exe
├── start.bat    # 一键启动
└── stop.bat     # 一键停止

1.3 PHP 7.4 配置（php.ini）

把 php.ini-development 复制一份改名为 php.ini：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
; 时区（中国）
date.timezone = Asia/Shanghai

; 扩展目录
extension_dir = "ext"

; 启用常用扩展
extension=curl
extension=fileinfo
extension=gd2
extension=mbstring
extension=mysqli
extension=openssl
extension=pdo_mysql
extension=xml
extension=zip

; CGI 相关
enable_dl = On
cgi.force_redirect = 0
fastcgi.impersonate = 1
cgi.rfc2616_headers = 1

; 上传文件大小
upload_max_filesize = 50M
post_max_size = 50M
memory_limit = 256M

1.4 Nginx 配置

编辑 nginx-1.18.0\conf\nginx.conf：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
worker_processes  1;
events {
    worker_connections  1024;
}

http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    keepalive_timeout  65;
    charset utf-8;  # 第 39 行去 # 改 utf-8

    server {
        listen       80;
        server_name  localhost;

        # 站点根目录
        root   D:/workspace/soft/nginx/www;
        index  index.php index.html;

        location / {
            try_files $uri $uri/ /index.php?$query_string;
        }

        # PHP 处理
        location ~ \.php$ {
            fastcgi_pass   127.0.0.1:9000;
            fastcgi_index  index.php;
            fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
            include        fastcgi_params;
        }
    }
}

1.5 启动脚本

start.bat（双击启动）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
@echo off
cd /d <PHP_SOFT_DIR>

REM 启动 PHP-CGI（监听 9000 端口）
start /b "php-cgi" "RunHiddenConsole.exe" "php-7.4.6\php-cgi.exe" -b 127.0.0.1:9000 -c "php-7.4.6\php.ini"

REM 启动 Nginx
start /b "nginx" "RunHiddenConsole.exe" "nginx-1.18.0\nginx.exe"

echo PHP-CGI and Nginx started in background.
pause

stop.bat：

1
2
3
4
5
@echo off
taskkill /F /IM nginx.exe
taskkill /F /IM php-cgi.exe
echo Stopped.
pause

1.6 验证

1
2
3
4
5
6
# 检查进程
tasklist | findstr "nginx"
tasklist | findstr "php-cgi"

# 浏览器访问
# http://localhost

新建 <PHP_SOFT_DIR>nginx\www\index.php：

1
2
<?php
    phpinfo();

看到 PHP 7.4.6 配置页 = 成功。

二、Xdebug 远程调试

Xdebug 是 PHP 调试的事实标准——和 Java 的 JDWP、Python 的 pdb 一样，可以在 IDE 里打断点、单步执行、查看变量。

2.1 下载 Xdebug

打开 https://xdebug.org/download，选对应 PHP 版本的 dll：

PHP 7.4 NTS x64 → php_xdebug-2.9.5-7.4-vc15-nts-x86_64.dll
PHP 7.4 TS x64 → php_xdebug-2.9.5-7.4-vc15-ts-x86_64.dll

⚠️ NTS / TS 一定要对（NTS = Non-Thread-Safe，TS = Thread-Safe）——错版本直接起不来。

放到 php-7.4.6\ext\ 目录下。

2.2 php.ini 启用 Xdebug

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
[xdebug]
zend_extension = <PHP_SOFT_DIR>php-7.4.6\ext\php_xdebug-2.9.5-7.4-vc15-nts-x86_64.dll

; 远程调试配置
xdebug.idekey = PHPXDEBUG
xdebug.remote_enable = 1
xdebug.remote_host = 127.0.0.1
xdebug.remote_port = 9001
xdebug.remote_handler = dbgp
xdebug.remote_autostart = 1

2.3 IDEA / PhpStorm 配置

Settings → PHP：

字段	值
PHP language level	7.4
CLI Interpreter	<PHP_SOFT_DIR>php-7.4.6\php.exe

Settings → PHP → Debug：

Xdebug
Debug port: 9001

Settings → PHP → Debug → DBGp Proxy：

IDE key: PHPXDEBUG
Host: 127.0.0.1
Port: 9000

Settings → PHP → Servers：

Name: php7.4 Server
Host: 127.0.0.1
Port: 80
Debugger: Xdebug

PHP → Debug → Start Listening（点电话图标变绿 = 监听中）。

2.4 Chrome / Postman 触发断点

方法 1：Chrome 装 Xdebug helper 插件

打开插件设置 → IDE key 选 PHPXDEBUG
访问 http://localhost/index.php → IDE 自动中断

方法 2：Postman 加 Cookie

1
Cookie: XDEBUG_SESSION=PHPXDEBUG

或加 query string：

1
GET /index.php?XDEBUG_SESSION_START=PHPXDEBUG

2.5 Xdebug 高级功能

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
; 性能分析（生成 cachegrind 文件，可用 KCacheGrind 看）
xdebug.profiler_enable = 0
xdebug.profiler_enable_trigger = 1
xdebug.profiler_output_dir = "D:\workspace\profiler"

; 代码覆盖率
xdebug.coverage_enable = 1

; 远程 trace（每行函数调用日志）
xdebug.remote_mode = jit
xdebug.trace_output_dir = "D:\workspace\trace"

三、常见错误速查

3.1 `Call to undefined function curl_init()`

1
2
3
4
; 在 php.ini 加
extension=curl

; 重启 php-cgi

Windows 下还要确认 php-7.4.6\ext\php_curl.dll 存在、<PHP_SOFT_DIR>php-7.4.6 目录里有 libeay32.dll ssleay32.dll（PHP 7.4 自带）。

3.2 `SQLSTATE[HY000] [2002] No connection could be made`

PDO / mysqli 连不上 MySQL。检查项：

MySQL 服务在跑（net start mysql）
localhost vs 127.0.0.1 —— MySQL 用 socket、127.0.0.1 用 TCP，新版 MySQL 默认走 socket，PDO 报 2002
端口（默认 3306）防火墙是否放行

1
$pdo = new PDO('mysql:host=127.0.0.1;port=3306;dbname=test', 'root', 'password');

3.3 `No input file specified.`

Nginx 配置的 root 路径和 PHP 文件实际路径不一致。

1
2
3
4
5
6
7
location ~ \.php$ {
    root           D:/workspace/soft/nginx/www;  # ← 必须用 / 不要用 \
    fastcgi_pass   127.0.0.1:9000;
    fastcgi_index  index.php;
    fastcgi_param  SCRIPT_FILENAME  D:/workspace/soft/nginx/www$fastcgi_script_name;
    include        fastcgi_params;
}

$document_root 和 fastcgi_param SCRIPT_FILENAME 路径要完全一致。

3.4 `500 Internal Server Error`

打开 php.ini 错误显示：

1
2
3
4
5
display_errors = On
display_startup_errors = On
error_reporting = E_ALL
log_errors = On
error_log = <PHP_SOFT_DIR>php-7.4.6\logs\php_error.log

重启 php-cgi，看浏览器错误 + log 文件。

3.5 502 Bad Gateway

Nginx 收不到 PHP-CGI 的响应——PHP-CGI 没启动或挂了：

1
2
3
tasklist | findstr php-cgi
# 没结果 → 重启 start.bat
# 有结果但 502 → 检查 php-cgi -b 参数端口是不是 9000

四、生产环境建议

本地调试用 php-cgi.exe + Nginx 够用，但生产绝不能用这套——php-cgi 是单进程、崩溃不会自启、并发上不去。

4.1 用 PHP-FPM 替代

Linux 上一律用 PHP-FPM（FastCGI Process Manager）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
# Ubuntu
apt install php7.4-fpm
systemctl start php7.4-fpm

# nginx 配置
location ~ \.php$ {
    fastcgi_pass   unix:/var/run/php/php7.4-fpm.sock;  # 走 Unix Socket 比 TCP 快
    fastcgi_index  index.php;
    fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
    include        fastcgi_params;
}

4.2 用 Docker 跑 PHP

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# docker-compose.yml
version: '3'
services:
  php:
    image: php:7.4-fpm-alpine
    volumes:
      - ./www:/var/www/html
    networks:
      - backend

  nginx:
    image: nginx:1.18-alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
      - ./www:/var/www/html
    depends_on:
      - php
    networks:
      - backend

networks:
  backend:

4.3 性能调优清单

项	默认	建议
`opcache.enable`	1	保持开启
`opcache.memory_consumption`	128	256
`opcache.max_accelerated_files`	10000	20000
`pm.max_children` (FPM)	5	`nproc × 2`
`pm.start_servers`	2	`nproc × 1`
`request_terminate_timeout`	0	30s（防止慢请求占资源）

五、2024 视角：PHP 8.3 升级与 EOL 提醒

⚠️ 重要时间线：PHP 7.4 已于 2022-11-28 正式 EOL（End Of Life），不再收到任何安全更新。本文 2020 年写于 7.4 时代，今天（2024+）继续使用 7.4 = 裸奔。强烈建议升级到 PHP 8.3（2023-11 发布，当前 active branch）。

5.1 PHP 7.4 → 8.x 升级成本

好消息：8.0/8.1/8.2/8.3 都是渐进式升级，几乎没有 breaking change：

版本	发布	EOL	升级成本
7.4	2019-11	2022-11（已 EOL）	—
8.0	2020-11	2023-11	低（Named Args、Match、Attributes）
8.1	2021-12	2025-12	中（Enums、Fibers、Readonly Properties）
8.2	2022-12	2026-12	低（DNF Types、Constants in Traits）
8.3	2023-11	2027-12	低（Typed Class Constants、`#[\Override]`）

5.2 PHP 8.x 关键新特性（精选 6 个）

1. 命名参数（Named Arguments）—— 8.0

1
2
3
4
5
// 之前：靠顺序
htmlspecialchars($str, ENT_QUOTES | ENT_HTML5, 'UTF-8', false);

// 现在：跳着填
htmlspecialchars($str, double_encode: false);

2. Match 表达式 —— 8.0

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
// 之前
switch ($status) {
    case 200: $msg = 'OK'; break;
    case 404: $msg = 'Not Found'; break;
    default: $msg = 'Unknown';
}

// 现在
$msg = match (true) {
    $status >= 200 && $status < 300 => 'OK',
    $status === 404 => 'Not Found',
    default => 'Unknown',
};

3. 枚举（Enums） —— 8.1

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
enum Status: string
{
    case Active = 'active';
    case Banned = 'banned';
    case Pending = 'pending';

    public function label(): string
    {
        return match ($this) {
            self::Active => '活跃',
            self::Banned => '封禁',
            self::Pending => '待审',
        };
    }
}

4. 只读属性（Readonly Properties） —— 8.1

1
2
3
4
5
6
7
class Money
{
    public function __construct(
        public readonly int $amount,
        public readonly string $currency,
    ) {}
}

5. 纤程（Fibers） —— 8.1（类似 Go goroutine 的简化版）

1
2
3
4
5
6
7
$fiber = new Fiber(function (): void {
    $value = Fiber::suspend('fiber suspended');
    echo "Resumed with: $value\n";
});

$value = $fiber->start();   // "fiber suspended"
$fiber->resume('test');     // "Resumed with: test"

实战意义：让 PHP 能写真正的协程，AmPHP 3 / Revolt / ReactPHP 都基于 Fibers 重写了事件循环。

6. 类型化类常量（Typed Class Constants） —— 8.3

1
2
3
4
5
class HttpStatus
{
    public const int OK = 200;          // 8.3 前是 mixed
    public const string NOT_FOUND = '404 is wrong here';  // 编译期就会报错
}

5.3 PHP 8.x 性能

指标	7.4	8.0	8.3
WordPress 主页 QPS	300	350	420+
Symfony Welcome 页 QPS	1.2k	1.5k	1.9k
内存峰值（典型 Web 请求）	12 MB	11 MB	9 MB
JIT 编译器	无	tracing JIT（可选）	function JIT（默认更智能）

8.3 的 JIT 对纯计算密集型任务（图像处理、数值计算、规则引擎）能再涨 1.5~3 倍。

5.4 7.4 → 8.3 升级路径（最短 4 步）

PHPCompatibility 静态扫描：composer require --dev phpcompatibility/phpcompatibility
修 deprecation：{ 改为 {$var}、each() 改 foreach
CI 跑通：把 7.4 跑过的测试在 8.3 跑一遍
生产灰度：金丝雀 5% → 25% → 50% → 100%

参考工具：PHPStan 静态分析、Psalm、Rector（自动重构 7.4 → 8.x 代码）。

5.5 如果还在用 PHP 5.x / 7.0/7.1/7.2/7.3

危险——这些版本都 EOL：

版本	EOL 时间	风险
5.6	2019-01	已知多个未修复漏洞
7.0	2019-01	同上
7.1	2019-12	同上
7.2	2020-11	同上
7.3	2021-12	同上
7.4	2022-11	最新 EOL，建议立即升级
8.0	2023-11	需升级到 8.1+
8.3	2027-12	当前推荐版本

结论：2024+ 新项目直接用 PHP 8.3；老项目至少升级到 8.1+（还有 1 年多支持），最迟 2025 年前完成 8.2/8.3 升级。

六、下一步

PHP 8.3 现代特性（命名参数、Enums、Fibers、Readonly）：PHP 8 迁移指南
框架：Laravel 11 / Symfony 7 / ThinkPHP 8——Laravel 仍是事实标准
Composer：PHP 包管理——composer require vendor/package
测试：PHPUnit 11 + Mockery + Pest（PHPUnit 之上的现代语法糖）
静态分析：PHPStan / Psalm（类似 TypeScript 的 tsc）
协程：基于 Fibers 的 AmPHP 3 / Revolt

参考资料

PHP 官方文档：https://www.php.net/docs.php
Xdebug 官方文档：https://xdebug.org/docs/
Nginx 官方文档：https://nginx.org/en/docs/
PHP The Right Way（社区最佳实践）：https://phptherightway.com/
PHP 8.3 发布公告：https://www.php.net/releases/8.3/zh.php