调试 on Liangweidong's blog

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

Wed, 15 Apr 2020 00:00:00 +0800

前置知识

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

C++ 入门与 vim 开发环境搭建

Wed, 15 Sep 2010 00:00:00 +0800

前置知识

Linux/macOS 终端基础（cd、ls、grep、管道）
至少熟悉一种编程语言（Java/Python/Go 均可）
知道 gcc / g++ 是什么

为什么选 vim 写 C++

C++ 是少有的"几十年没退出主流"的语言——从 1985 年 Bjarne Stroustrup 发布第一个商用版本，到 2011 年的 C++11、2014 年的 C++14、2017 年的 C++17，模板元、RAII、移动语义、concept（20 概念）层层叠加，IDE 也跟着膨胀：Visual Studio 安装动辄 10GB+，CLion 启动慢、内存吃紧，Eclipse CDT 配置繁琐。

在很多 Linux 老兵眼里，vim + 一组插件就是写 C++ 的"瑞士军刀"——启动快、键盘流不离开主键区、ctags / cscope 跳转精准、配合 gdb 调试毫不输图形 IDE。2010 年代之前，Linux 内核、Hadoop、Chrome 等大型 C++ 项目的核心开发者都靠 vim 写代码。

但这条路有三个关键节点必须打通：语法高亮 → 编译环境 → 调试工具链 → 自动化构建。任何一个断了，体验就掉一档。

一、vim 基础：C++ 语法与缩进

1.1 系统自带的语法文件

1
2


# 多数 Linux 发行版已经自带
ls /usr/share/vim/vim*/syntax/cpp.vim

打开 ~/.vimrc，加一行让 vim 识别 .h .hpp .cc .cpp .cxx：

1
2
3
4


" C/C++ 文件类型识别
au BufRead,BufNewFile *.h,*.hpp,*.cc,*.cpp,*.cxx set filetype=cpp
syntax on
filetype indent on

效果：class template namespace auto 关键字高亮，注释块折叠，多行字符串着色。

1.2 缩进策略

C++ 缩进的核心矛盾是 public: / private: 该不该比 class 缩进一格、K&R 还是 Allman 花括号风格。vim 自带的 cpp 缩进文件已经能 cover 80%：

1
2
3
4
5
6
7
8


" 缩进宽度 4 空格、tab 转空格
set tabstop=4
set shiftwidth=4
set expandtab
set autoindent
" C/C++ 缩进风格
set cindent
set cinoptions=:0,g0,t0,(0

:0 让 public: 不缩进、g0 让 C 风格作用域内成员缩进、t0 让函数返回值类型不强制换行——配合 :set cinoptions+=L1 还可以让 case 不缩进。

二、编译工具链：gcc / g++ / clang

2.1 gcc 与 g++ 的区别

gcc 是 GNU C Compiler，g++ 是 GNU C++ Compiler——后者的本质是 gcc -xc++ -lstdc++ -shared-libgcc。C++ 项目一律用 g++，混用 gcc 会在链接 stdc++ 时报一堆 undefined reference。

1
2
3


# 验证版本（C++17 已经是 2017 标准，g++ 7+ 完整支持）
g++ --version
# g++ (Ubuntu 9.4.0-1ubuntu1~20.04.2) 9.4.0

2.2 经典编译命令

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 单文件
g++ -std=c++17 -Wall -Wextra -O2 -o hello hello.cpp

# 多文件
g++ -std=c++17 -Wall -O2 main.cpp foo.cpp bar.cpp -o myapp

# 分两步：先 -c 生成 .o，再链接
g++ -std=c++17 -Wall -O2 -c main.cpp -o main.o
g++ -std=c++17 -Wall -O2 -c foo.cpp -o foo.o
g++ main.o foo.o -o myapp

-Wall -Wextra 开启几乎所有警告——零警告是 C++ 老兵的第一铁律。

2.3 clang 替代

macOS 默认编译器就是 clang++，Linux 上也能装——编译错误信息比 gcc 友好、静态分析更强：

1
2
3
4


# Ubuntu 安装
sudo apt install clang
clang++ --version
# clang version 10.0.0

很多大项目（Chrome、LLVM 本身）默认用 clang++，编译器版本切换可以用 update-alternatives：

1
2


sudo update-alternatives --config c++
# 出现菜单：g++ / clang++ 选其一

三、调试：gdb 基础

3.1 编译时开调试

1
2
3


g++ -std=c++17 -Wall -g -O0 -o debug_demo demo.cpp
# -g 生成调试信息（GNU debug 格式：DWARF）
# -O0 关闭优化，gdb 单步能看到每行

生产构建用 -O2、调试构建用 -O0 -g——-O2 会让变量被寄存器化、循环被展开，单步断点跳得很乱。

3.2 gdb 常用命令

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


gdb ./debug_demo

(gdb) break main # 在 main 打断点
(gdb) run # 启动
(gdb) next # 单步（不进入函数）
(gdb) step # 单步（进入函数）
(gdb) print var # 打印变量
(gdb) info locals # 打印所有局部变量
(gdb) backtrace # 函数调用栈
(gdb) continue # 继续执行
(gdb) quit

3.3 段错误定位

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# core dump 开启
ulimit -c unlimited
echo "/tmp/core.%e.%p" | sudo tee /proc/sys/kernel/core_pattern

# 编译
g++ -g -o bug bug.cpp
./bug
# Segmentation fault (core dumped)

gdb ./bug /tmp/core.bug.12345
(gdb) backtrace

vim + gdb 联动：装 clewn 或 vimgdb，可以在 vim 里直接 F8 调出 gdb 控制台、跳转到对应行。

四、Makefile：从源码到产物

裸 g++ 命令一多就乱——头文件改一个，整个项目得全部重编。make 是 C/C++ 项目最朴素的构建系统。

4.1 一个 Makefile 模板

 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


# 编译器
CXX = g++
CXXFLAGS = -std=c++17 -Wall -Wextra -O2 -g
LDFLAGS =

# 源文件、目标文件
SRCS = $(wildcard src/*.cpp)
OBJS = $(SRCS:.cpp=.o)
TARGET = bin/myapp

# 默认目标
all: $(TARGET)

$(TARGET): $(OBJS)
	@mkdir -p bin
	$(CXX) $(OBJS) -o $@ $(LDFLAGS)

%.o: %.cpp
	$(CXX) $(CXXFLAGS) -c $< -o $@

# 头文件依赖
deps:
	$(CXX) -MMD -MP $(CXXFLAGS) $(SRCS) > /dev/null

# 包含自动生成的 .d 文件
-include $(OBJS:.o=.d)

clean:
	rm -f src/*.o src/*.d
	rm -rf bin

.PHONY: all clean deps

关键技巧：

wildcard src/*.cpp 自动收集源文件，新增文件不用改 Makefile
%.o: %.cpp 模式规则，每个 .cpp 对应一个 .o
-MMD -MP 自动追踪头文件依赖：改 foo.h 自动重编 bar.cpp
bin/ 目录 @mkdir -p 懒创建

4.2 并行编译

1
2


make -j$(nproc) # Linux
make -j$(sysctl -n hw.ncpu) # macOS

多核 CPU 能让构建时间从分钟级压到秒级。

五、CMake：跨平台构建

make 写多了会失控——一个项目几百个源文件、不同平台编译器不同、依赖第三方库路径各异。CMake 是事实标准：写一份 CMakeLists.txt，生成 Makefile / Ninja / Xcode / Visual Studio 工程。

5.1 最简单的 CMakeLists

1
2
3
4
5
6
7


cmake_minimum_required(VERSION 3.10)
project(myapp CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

add_executable(myapp main.cpp foo.cpp bar.cpp)

1
2
3


mkdir build && cd build
cmake .. # 生成 Makefile
make -j$(nproc) # 编译

5.2 找第三方库

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


find_package(Boost REQUIRED COMPONENTS filesystem system)
find_package(OpenCV REQUIRED)
find_package(PkgConfig REQUIRED)
pkg_check_modules(SQLITE3 REQUIRED sqlite3)

add_executable(myapp main.cpp)
target_include_directories(myapp PRIVATE ${Boost_INCLUDE_DIRS})
target_link_libraries(myapp
 PRIVATE
 Boost::filesystem
 Boost::system
 ${OpenCV_LIBS}
 ${SQLITE3_LIBRARIES}
)

5.3 现代化 CMake（3.5+ 推荐）

老派 CMake 用全局 include_directories / link_libraries 会污染所有 target，新写法是 target_* + PRIVATE/PUBLIC/INTERFACE 限定作用域：

1
2
3
4
5
6


add_library(mylib STATIC src/foo.cpp)
target_include_directories(mylib PUBLIC include)
target_compile_features(mylib PUBLIC cxx_std_17)

add_executable(myapp main.cpp)
target_link_libraries(myapp PRIVATE mylib)

六、常见坑

坑	现象	解法
`undefined reference to std::cout`	用了 gcc 编译 .cpp	改用 `g++`
模板类找不到	linker 报缺失符号	把模板实现放 `.hpp`（同文件），或显式实例化
`multiple definition of ...`	头文件有非 inline 函数/变量	函数加 `inline`、变量加 `inline`（C++17）或 `extern`
段错误	数组越界 / 空指针 / 栈溢出	`gdb` + `valgrind --tool=memcheck ./myapp`
编译极慢	单个翻译单元 1 万+ 行	用 `#include` 拆分、前向声明、Pimpl 模式
链接 .so 报 `cannot find -lxxx`	库不在标准路径	`-L/path/to/lib -lxxx` 或 `LD_LIBRARY_PATH`

七、下一步

工具链进阶：clangd + clang-tidy 静态分析、include-what-you-use 删无用头文件
构建系统：Ninja 比 make 增量构建快 30%+，cmake -G Ninja ..
包管理：vcpkg（微软）、Conan（C++ 生态最主流）安装第三方库
测试：GoogleTest（gtest）+ gcovr 看覆盖率
现代 C++：C++20 的 concept / coroutine / module，C++23 的 expected / flat_map

参考资料

Bjarne Stroustrup. The C++ Programming Language（第 4 版，2013）
CMake 官方文档：https://cmake.org/cmake/help/latest/
GCC 手册：https://gcc.gnu.org/onlinedocs/
GDB 手册：https://sourceware.org/gdb/current/onlinedocs/
vim 帮助：:help cindent、:help syntax

2024+ 视角：C++20 / 23 / 26 与现代工具链

C++ 标准演进（2024 视角）

标准	发布时间	状态	编译器支持（2024）
C++17	2017	主流	GCC 7+ / Clang 5+ / MSVC 19.14+
C++20	2020	生产可用	GCC 10+ / Clang 13+ / MSVC 19.28+
C++23	2024-02	新晋主流	GCC 12+ / Clang 16+ / MSVC 19.34+
C++26	2026（计划）	起草中	实验分支

C++20 必学特性

Concepts：模板约束，写法 template<std::integral T>
Modules（import std;）：告别头文件包含地狱——大型项目编译时间降 50%+
Coroutines（co_await / co_return）：异步代码同步写法
Ranges（<ranges>）：管道式数据处理 nums \| std::views::filter([](int x){ return x%2==0; })
std::span：非拥有式数组视图，零拷贝传递
std::format：类型安全的字符串格式化（Python f-string 风格）

1
2
3
4
5
6
7
8
9


// C++20 concept 示例
#include <concepts>

template<std::integral T>
T add(T a, T b) { return a + b; }

// 使用
int x = add(1, 2); // OK
// double y = add(1.0, 2.0); // 编译错误：double 不是 integral

C++23 必学特性

std::expected<T, E>：替代异常或错误码的"成功或失败"类型
std::flat_map / std::flat_set：基于连续内存的 map/set——缓存友好，比红黑树快 2-3 倍
std::mdspan：多维数组视图——机器学习 / 图像处理天然支持
std::print / std::println：类型安全的 print 替代 std::cout <<
deducing this（显式对象形参）：CRTP 不再需要复杂模板

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18


// C++23 std::expected
#include <expected>
#include <string>

std::expected<int, std::string> parseInt(std::string_view s) {
 try {
 return std::stoi(std::string(s));
 } catch (...) {
 return std::unexpected("parse failed: " + std::string(s));
 }
}

auto result = parseInt("42");
if (result) {
 std::println("got: {}", *result);
} else {
 std::println("error: {}", result.error());
}

C++26 路线图（草案）

Reflection（静态反射）：编译器生成枚举字符串、字段列表
Contracts（契约）：[[expects: x > 0]] / [[ensures: result > 0]]
std::execution（P2300）：标准化的异步执行器，senders/receivers
Pattern Matching（inspect）：函数式语言风格的模式匹配

编译工具链的 2024+ 演进

GCC 14 / Clang 18 / MSVC 19.40+：

GCC 14：完整 C++23 支持
Clang 18：默认 C++17，可选 C++20/23
MSVC：与 LLVM 社区代码同步，差异越来越小

跨平台推荐：

1
2
3
4
5
6
7


# Ubuntu 24.04 LTS 默认装 GCC 13
sudo apt install g++-14 # 装 GCC 14

# macOS
brew install llvm@18 # 装 Clang 18

# Windows：MSYS2 / vcpkg / WSL2

构建系统的 2024+ 现状

工具	状态	2024+ 推荐
CMake 3.28+	主流	首选（Presets 3.27+ 增强）
Ninja 1.12+	主流	比 Make 快 30%+，CMake `-G Ninja`
Bazel 7.x	Google 系 / 跨语言	大型项目 + 远程缓存
Meson 1.5+	Python 写	简单 / 中型项目
xmake	Lua 写	国内友好（tboox 维护）
Make	老派	维护遗留项目

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


# CMakePresets.json（2024+ 标准做法）
{
 "version": 6,
 "configurePresets": [
 {
 "name": "base",
 "generator": "Ninja",
 "binaryDir": "${sourceDir}/build/${presetName}",
 "cacheVariables": {
 "CMAKE_CXX_STANDARD": "23",
 "CMAKE_EXPORT_COMPILE_COMMANDS": "ON"
 }
 },
 {
 "name": "debug",
 "inherits": "base",
 "cacheVariables": {
 "CMAKE_BUILD_TYPE": "Debug"
 }
 }
 ]
}

1
2
3


# 一行配置
cmake --preset debug
cmake --build build/debug

包管理的 2024+ 现状

工具	特点	2024+
vcpkg（微软）	3000+ 包，跨平台	生产首选
Conan 2.x	C++ 生态最成熟	复杂项目 + 二进制分发
Spack	HPC / 科研	学术 / 超级计算
CPM.cmake	CMake 内置	简单项目（`FetchContent` 替代）
xrepo（xmake 系）	跨平台	国内项目

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# vcpkg 集成（2024+）
# vcpkg.json
{
 "name": "my-project",
 "version-string": "1.0.0",
 "dependencies": [
 "fmt", "spdlog", "boost-system", "boost-filesystem",
 { "name": "qt", "features": ["webengine"] }
 ]
}

调试工具的 2024+ 现状

gdb 14+：原生支持 C++20 coroutine 调试
lldb 18+：Clang 配套，符号信息更准
rr（Mozilla 录制回放）：5.x 稳定——重现 bug 一把好手
AddressSanitizer / UBSan / ThreadSanitizer：编译器内置，2024+ 必开
Valgrind 3.23+：老牌但仍可用
Visual Studio Code + CodeLLDB：调试 C++ 的"轻量 IDE"

IDE 的 2024+ 推荐

CLion 2024.2+：JetBrains 系，对 CMake / vcpkg 集成最好（付费）
Visual Studio 2022 17.10+：Windows + C++23 支持最完整
VS Code + CMake Tools + clangd：免费 + 轻量，Linux/macOS 首选
Qt Creator 13+：跨平台 + Qt 项目专用
Zed：2024 出现的新编辑器，Rust 写的，启动极快

2024+ 静态分析工具链

工具	用途	2024+
clang-tidy 18+	风格 + bug 模式	必装
cppcheck	基础静态分析	CI 必跑
include-what-you-use	检查无用 #include	大型项目用
SonarQube 10+	企业级代码质量平台	中大型
PVS-Studio	商业深度分析	金融 / 嵌入式

2024+ 推荐组合（跨平台 C++ 项目）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


现代 C++ 项目（C++20/23）
├── 编译器：GCC 14 / Clang 18 / MSVC 19.40
├── 标准：C++20（生产）/ C++23（新项目）
├── 构建：CMake 3.28 + Ninja 1.12 + CMakePresets
├── 包管理：vcpkg（首选）/ Conan 2.x
├── 测试：GoogleTest + gcovr / LLVM-cov
├── 静态分析：clang-tidy + cppcheck
├── 格式化：clang-format 18
├── 调试：gdb 14 / lldb 18 + rr
├── IDE：VS Code + clangd / CLion
├── 编译选项：-Wall -Wextra -Wpedantic -fsanitize=address,undefined
└── CI：GitHub Actions / GitLab CI

调试 on Liangweidong's blog

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

前置知识

为什么 2020 年还在用 PHP

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

1.1 下载三件套

1.2 目录规划

1.3 PHP 7.4 配置（php.ini）

1.4 Nginx 配置

1.5 启动脚本

1.6 验证

二、Xdebug 远程调试

2.1 下载 Xdebug

2.2 php.ini 启用 Xdebug

2.3 IDEA / PhpStorm 配置

2.4 Chrome / Postman 触发断点

2.5 Xdebug 高级功能

三、常见错误速查

3.1 Call to undefined function curl_init()

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

3.3 No input file specified.

3.4 500 Internal Server Error

3.5 502 Bad Gateway

四、生产环境建议

4.1 用 PHP-FPM 替代

4.2 用 Docker 跑 PHP

4.3 性能调优清单

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

5.1 PHP 7.4 → 8.x 升级成本

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

5.3 PHP 8.x 性能

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

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

六、下一步

参考资料

C++ 入门与 vim 开发环境搭建

前置知识

为什么选 vim 写 C++

一、vim 基础：C++ 语法与缩进

1.1 系统自带的语法文件

1.2 缩进策略

二、编译工具链：gcc / g++ / clang

2.1 gcc 与 g++ 的区别

2.2 经典编译命令

2.3 clang 替代

三、调试：gdb 基础

3.1 编译时开调试

3.2 gdb 常用命令

3.3 段错误定位

四、Makefile：从源码到产物

4.1 一个 Makefile 模板

4.2 并行编译

五、CMake：跨平台构建

5.1 最简单的 CMakeLists

5.2 找第三方库

5.3 现代化 CMake（3.5+ 推荐）

六、常见坑

七、下一步

参考资料

2024+ 视角：C++20 / 23 / 26 与现代工具链

C++ 标准演进（2024 视角）

C++20 必学特性

C++23 必学特性

C++26 路线图（草案）

编译工具链的 2024+ 演进

构建系统的 2024+ 现状

包管理的 2024+ 现状

调试工具的 2024+ 现状

IDE 的 2024+ 推荐

2024+ 静态分析工具链

2024+ 推荐组合（跨平台 C++ 项目）

3.1 `Call to undefined function curl_init()`

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

3.3 `No input file specified.`

3.4 `500 Internal Server Error`