最可靠的方法是运行php --ini（命令行）或phpinfo()（web环境）查看实际加载的php.ini路径；loaded configuration file行显示当前生效文件，若为none则使用内置默认值。
确认PHP实际加载的php.ini路径是否正确
宝塔面板里看到的「配置修改」页面，不一定是网站运行时真正读取的php.ini。FPM和CLI可能用不同配置，而网站走的是FPM模式。光改面板里的配置，如果没落到正确的ini文件里，模块照样不生效。
执行这个命令查真实路径：/www/server/php/80/bin/php-fpm -i | grep "Loaded Configuration File"。注意必须用php-fpm，不是php——后者查的是CLI环境。
常见错误现象：
- 在面板php.ini里加了
extension=redis.so，但phpinfo()里搜不到redis -
php -m能看见模块，但网页报“Class 'Redis' not found”
原因往往是：你改的是CLI的php.ini（比如/www/server/php/80/etc/php.ini），而FPM读的是/www/server/php/80/etc/php-fpm.d/www.conf里指定的php_admin_value[php_ini]，或者根本没设，就 fallback 到默认位置。
检查so文件是否放在PHP扩展目录且API版本匹配
PHP每个版本对应一个内部API编号（如PHP 8.0对应20200930），这个编号会出现在扩展目录名里：/www/server/php/80/lib/php/extensions/no-debug-non-zts-20200930/。如果目录名里的数字和当前PHP的PHP_API_VERSION对不上，extension=xxx.so就会静默失败。
验证方式：
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 执行
/www/server/php/80/bin/php-config --php-api，输出就是当前API编号 - 进目录
ls /www/server/php/80/lib/php/extensions/，看是否存在对应编号的子目录 - 确认
.so文件确实在该目录下，且权限是755（chmod 755 /path/to/xxx.so）
容易踩的坑：手动编译扩展后，把.so丢进了no-debug-zts-20200930（带zts）目录，但你的PHP是NTS版（宝塔默认），目录名必须是no-debug-non-zts-20200930。
zend_extension和extension不能混用，顺序也不能错
ionCube、opcache这类Zend引擎级扩展，必须用zend_extension指令加载；而redis、bcmath这类用户空间扩展，只能用extension。两者写反或混在一起，会导致后续所有扩展加载中断。
实操建议：
- 打开真实生效的php.ini（上一步查到的那个），搜索
zend_extension - 确保所有
zend_extension行都在extension行之前 - 删掉任何形如
extension=ioncube_loader_lin_8.0.so的行——它必须是zend_extension=... -
extension行只写文件名，不要写绝对路径：extension=redis.so✅，extension=/www/.../redis.so❌（宝塔PHP会忽略带路径的写法）
改完配置后必须重启PHP服务，不是重载
宝塔面板里点「重载配置」只让Nginx或Apache重新读配置，PHP-FPM进程本身不会重建，已加载的模块也不会刷新。只有「重启PHP服务」才会杀掉旧进程、拉起新进程，从而真正触发extension=的加载逻辑。
验证是否生效的最小闭环：
- 改php.ini → 保存
- 在面板中点击对应PHP版本的【重启】按钮（不是重载）
- 创建
info.php，内容为<?php phpinfo(); ?>，浏览器访问，搜索模块名 - 别信
php -m，它查的是CLI，要查FPM用/www/server/php/80/bin/php-fpm -i | grep -A 5 -B 5 redis
最常被忽略的一点：PHP 8.0的扩展目录名、API编号、NTS/TS模式、php.ini路径、FPM vs CLI差异——这五者只要有一处对不上，模块就等于没装。问题往往不出在“没装”，而出在“装了但根本没被找见”。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
