php.ini配置不生效的首要原因是配置项被分号注释，必须取消注释；其次须确认修改的是PHP实际加载的文件（通过phpinfo()查Loaded Configuration File路径）；再重启对应服务（如php-fpm或apache2）；最后排查php-fpm池、Apache指令或ini_set()等高优先级覆盖。
php.ini 中的配置项被分号 ; 注释掉，是导致设置不生效最常见、也最容易被忽略的原因。不是“改了没用”，而是根本没被 PHP 读取——它把那行当成了注释，直接跳过。
确认当前生效的 php.ini 文件位置
别凭经验或路径猜测，必须用 PHP 自己说的为准：
- 新建一个
info.php文件，内容只有一行：<?php phpinfo(); ?>，放在 Web 可访问目录下（如 Nginx 的/var/www/html/或 Apache 的/var/www/） - 浏览器访问
http://你的域名/info.php - 在页面中搜索 Loaded Configuration File，找到它指向的完整路径（例如
/etc/php/8.2/fpm/php.ini） - 这个路径才是你真正需要编辑的文件——其他同名文件（如 CLI 的
/etc/php/8.2/cli/php.ini）不会影响 Web 请求
检查并取消注释目标配置项
用 root 或对应权限用户打开上一步确认的 php.ini 文件：
- 查找你要启用的配置，比如
display_errors = On、upload_max_filesize = 64M、extension=mysqli - 如果该行开头有分号 ;（例如
;display_errors = Off或;extension=mysqli），说明它被注释，PHP 完全忽略 - 删掉行首的 ;，保留空格和等号格式，改成
display_errors = On或extension=mysqli - 注意：有些扩展名前带
zend_extension=（如 OPcache），不能写成extension=opcache，否则会报错
验证语法并重启对应服务
改完不重启 = 白改；重启错服务 = 还是白改：
立即学习“PHP免费学习笔记（深入）”；
- 命令行验证语法是否正确（替换为你实际路径）：
php -c /etc/php/8.2/fpm/php.ini -m 2>/dev/null || echo "配置有误"
无报错即通过 - 根据你的 PHP 运行模式选择重启方式：
– 若用 PHP-FPM（绝大多数 Linux 生产环境）：sudo systemctl restart php8.2-fpm
– 若用 Apache 模块（libphp）：sudo systemctl restart apache2
– 若用宝塔面板：在面板中「PHP 管理」里点击「重载配置」或「重启」，不要只点「保存」 - 重启后，重新刷新
info.php页面，搜索你修改的配置项，确认 Local Value 和 Master Value 一致且已更新
排除覆盖干扰（尤其容易被忽略）
即使 php.ini 改对了、也重启了，仍可能被更高优先级配置覆盖：
- 检查 PHP-FPM 的池配置（如
/etc/php/8.2/fpm/pool.d/www.conf），是否有php_value[xxx]或php_admin_value[xxx]行——它们会强制覆盖 php.ini 中同名设置 - 检查 Apache 的虚拟主机或主配置中是否含
php_flag或php_value指令（如php_flag display_errors on） - 检查代码中是否调用
ini_set()（如ini_set('display_errors', '0')），这会在运行时覆盖所有配置，优先级最高
