PHP拓展安装失败主因是环境不匹配，需确认phpize/php-config路径、PHP版本与拓展ABI一致、依赖库完整、SELinux/SIP限制及php.ini加载位置正确。
PHP拓展装不上，先看phpize和php-config是不是对的
很多情况下不是拓展本身有问题，而是编译环境没对齐。比如你用的是 Homebrew 装的 PHP 8.2，但系统 PATH 里默认是 macOS 自带的旧版 phpize，一运行就报 configure: error: Cannot find php-config 或直接卡在 make 阶段。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 运行
which phpize和which php-config，确认路径是否指向你实际用的 PHP 版本（如/opt/homebrew/bin/phpize） - 如果不对，临时改 PATH：
export PATH="/opt/homebrew/bin:$PATH"（macOS M1/M2）或export PATH="/usr/local/bin:$PATH"（Linux / Intel Mac） - 进拓展源码目录后，别直接
./configure，要显式指定：./configure --with-php-config=/opt/homebrew/bin/php-config - 注意：不同 PHP 大版本（7.4 / 8.0 / 8.2）的 ABI 不兼容，拓展必须用对应版本编译，否则即使.so生成成功，加载时也会崩溃
拓展装好了但网页 500，优先查error_log和php -m
500 错误本身不说明问题，关键看日志。Apache/Nginx 的错误日志往往只写“Premature end of script headers”，真正原因藏在 PHP 自己的日志里。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先命令行验证拓展能否加载：
php -m | grep redis（把redis换成你要查的拓展名），如果没输出，说明没加载成功 - 检查
php.ini是否真加了那行：extension=redis.so（Linux/macOS）或extension=php_redis.dll（Windows）；注意路径是否写错，比如写成extension=/usr/lib/php/redis.so但实际在/opt/homebrew/lib/php/pecl/20220829/ - 打开 PHP 错误日志：在
php.ini中确认error_log = /var/log/php-error.log（路径按实际调整），然后访问页面，立刻tail -f /var/log/php-error.log - 常见报错示例：
PHP Warning: PHP Startup: Unable to load dynamic library 'redis.so' (tried: /usr/lib/php/redis.so (dlopen(/usr/lib/php/redis.so, 0x0009): tried: '/usr/lib/php/redis.so' (mach-o file, but is an incompatible architecture))—— 这是 arm64 和 x86_64 混了
extension=xxx.so 写对了还 500？检查依赖库和 SELinux / sandbox
有些拓展（如 imagick、grpc、pdo_pgsql）不是纯 PHP 代码，它依赖系统级动态库（libmagickwand、libgrpc、libpq）。这些库缺失或版本不匹配，会导致 PHP 进程启动时直接 segfault，Nginx/Apache 就返回 500。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- Linux 下用
ldd /path/to/xxx.so看有没有not found的依赖；macOS 用otool -L /path/to/xxx.so - Ubuntu/Debian 装 imagick 时，除了
php-imagick包，还得装libmagickwand-6.q16-6（版本号必须严格匹配） - CentOS/RHEL 8+ 默认开启 SELinux，可能拦截 PHP 加载外部 so 文件，临时关掉测试：
setenforce 0；若恢复正常，需加策略：audit2allow -a -M phpext && semodule -i phpext.pp - Mac 上用 Homebrew 装的 PHP，有时会因 SIP 限制无法加载非标准路径的 so，建议统一用
brew install php-redis这类封装好的公式，而非手动编译
用 Docker 或多版本 PHP 时，php.ini 容易配错位置
一个典型陷阱：你在宿主机改了 /etc/php/8.2/apache2/php.ini，但容器里跑的是 Alpine + PHP 8.1 CLI，或者 Nginx 用的是 FPM，而 FPM 的配置文件在 /etc/php/8.1/fpm/php.ini，压根没读你改的那个。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 不要猜路径，直接让 PHP 告诉你：
php --ini显示加载顺序，php -r "echo php_ini_loaded_file();"显示最终生效的 ini 文件 - Docker 中，如果用
docker exec -it xxx php -m能看到拓展，但网页 500，大概率是 Web 服务（Apache/Nginx/FPM）用的不是同一个 PHP SAPI，查它的进程启动命令：ps aux | grep php-fpm或httpd -V | grep -i "server config" - 多版本共存时（如 phpbrew、asdf），确保
php --version和 Web 服务调用的php是同一份 —— 有时候 Apache mod_php 绑定的是系统默认 PHP，而终端里用的是 asdf 切换的版本
