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。
