报“No package 'xxx' found”错误是因为缺少对应开发包（如sqlite3对应libsqlite3-dev），而非运行时库；需安装-dev/-devel包，并检查PKG_CONFIG_PATH是否包含其.pc文件路径。
configure 阶段报 “No package 'xxx' found” 怎么办
这是最常卡住的第一步，./configure 检测依赖失败时不会直接告诉你缺哪个开发头文件，而是用 pkg-config 的报错格式模糊提示，比如 No package 'sqlite3' found 或 Package requirements (oniguruma >= 6.0) were not met。
根本原因不是没装 sqlite3 命令，而是缺 sqlite-devel（CentOS）或 libsqlite3-dev（Ubuntu）这类 *-devel / *-dev 包——它们提供编译所需的 .h 头文件和静态库。
- 常见对应关系：
libxml2→libxml2-devel；openssl→openssl-devel；oniguruma→oniguruma-devel；curl→curl-devel - 查缺补漏命令：
yum search devel | grep -E "(sqlite|onig|xml|curl|png|jpeg|freetype)"，再yum install -y xxx-devel - 如果已装但 configure 仍找不到，可能是 pkg-config 路径未覆盖：临时加
export PKG_CONFIG_PATH="/usr/lib64/pkgconfig:/usr/share/pkgconfig"再重试
PHP 8.2+ 编译必须显式启用的扩展项
PHP 8.2 开始，--enable-opcache 和 --with-mysqlnd 不再默认开启，且部分扩展（如 mbstring、gd）若未明确指定依赖路径，即使装了 libpng-devel 也可能静默禁用。
尤其注意以下三项不写就大概率失效：
立即学习“PHP免费学习笔记（深入）”；
-
--enable-opcache：不加则opcache.enable=1在 php.ini 里也无效 -
--with-mysqlnd：否则mysqli和PDO MySQL无法启用，--with-mysqli=mysqlnd和--with-pdo-mysql=mysqlnd才真正生效 -
--with-gd：必须搭配--with-jpeg-dir=/usr、--with-png-dir=/usr、--with-freetype-dir=/usr，否则 GD 模块编译失败或缺失 JPEG/PNG 支持
PHP-FPM 用户与权限配置容易被忽略的细节
很多人把 --with-fpm-user 和 --with-fpm-group 设成 nginx，却忘了系统里未必真有这个用户；或者设成 www，但 Nginx 实际跑在 nginx 用户下，导致 socket 权限拒绝。
实操建议：
- 先确认 Web 服务运行用户：
ps aux | grep nginx | head -1 | awk '{print $1}'或grep "user" /etc/nginx/nginx.conf - 若用
nginx用户，确保该用户存在：id nginx，不存在则useradd -r -s /sbin/nologin nginx -
www.conf中listen.mode = 0660更安全，但必须保证 Nginx worker 进程属组包含nginx，且listen.owner和listen.group与之匹配 - 不要用
127.0.0.1:9000—— TCP 端口受防火墙/SELinux 干扰多，优先用 Unix socket：listen = /var/run/php-fpm.sock
make 编译慢或内存溢出怎么办
make 默认单线程编译，PHP 8.x 源码动辄 10 分钟以上；更糟的是，小内存机器（≤2GB）可能在 gcc 阶段因 OOM 被 kill，日志只显示 Killed 无具体错误。
解决方式很直接：
- 提速：
make -j$(nproc)启用全部 CPU 核心，并行编译（CentOS 7 默认 make 版本支持） - 防 OOM：编译前临时关闭 swap 无关紧要，但务必加
ulimit -v 2097152（限制虚拟内存 2GB），或改用make -j2保守并行 - 若中途失败，别急着
make clean—— 先看最后几行报错，90% 是某个扩展（如ldap、snmp）缺依赖，补完后直接make续编，无需重来
实际部署中，最难缠的往往不是某条命令执行失败，而是 configure 成功、make 成功、php -v 正常，但 PHP-FPM 启动后立刻 segfault，或者 gd 图像函数返回空——这类问题基本都出在 configure 参数与系统库版本不兼容，比如用了新版 freetype 但 configure 没加 --with-freetype-dir，或 oniguruma 版本低于 PHP 要求。动手前先查清系统已有库版本，比盲目堆参数更省时间。
