php 配置涉及 `php.ini` 和 `.user.ini` 两种文件。`php.ini` 是全局主配置文件，影响所有 php 脚本，且 php 运行时只读取一个主 `php.ini` 文件。而 `.user.ini` 允许在特定目录下覆盖主 `php.ini` 中的部分指令，其作用范围包括当前目录及其所有子目录，但仅在 php-fpm 或 fastcgi 模式下生效。理解两者的作用域和生效条件对于精细化管理 php 配置至关重要。
在 PHP 的运行环境中，配置文件的管理是确保应用程序正确运行和优化的关键一环。其中，php.ini 和 .user.ini 是两种主要的配置文件，它们各自扮演着不同的角色，并拥有不同的作用域和生效机制。
php.ini：全局主配置文件
php.ini 是 PHP 运行时的主配置文件。它是全局性的，一旦被加载，其配置项将影响服务器上所有运行的 PHP 脚本。PHP 在启动时只会读取一个主要的 php.ini 文件。这意味着，无论您的项目文件位于哪个目录，它们都将受到这个全局 php.ini 文件的约束。
核心特点：
- 全局性： 影响整个 PHP 环境。
- 唯一性： PHP 运行时只加载一个主 php.ini 文件。
- 基础配置： 通常包含 PHP 核心功能、扩展加载、资源限制等基础且重要的配置。
.user.ini：目录级覆盖配置文件
.user.ini 文件提供了一种在特定目录下覆盖或修改主 php.ini 中部分指令的能力。它允许开发者针对单个目录或特定应用程序进行更细粒度的配置管理，而无需修改全局的 php.ini。
立即学习“PHP免费学习笔记（深入）”；
核心特点：
- 目录级作用域： .user.ini 文件会影响其所在目录以及所有子目录下的 PHP 脚本。例如，如果 /home/user/public_html/ 目录下存在 .user.ini，那么 /home/user/public_html/ 和 /home/user/public_html/test/ 中的脚本都会受到其影响。
- 覆盖而非替换： 它不是一个独立的配置文件，而是对主 php.ini 中特定指令的覆盖。
- 默认文件名可配置： 默认情况下，PHP 会查找名为 .user.ini 的文件，但您可以通过主 php.ini 中的 user_ini.filename 选项来修改这个默认文件名。
- 生效条件： .user.ini 文件仅在 PHP-FPM 或使用 PHP FastCGI 模块时生效。如果您的 PHP 环境是作为 Apache 的 mod_php 模块运行，那么 .user.ini 文件将不会被解析和应用。
可覆盖的指令类型
并非所有 php.ini 中的指令都可以在 .user.ini 中被覆盖。只有那些被标记为 PHP_INI_PERDIR 或 PHP_INI_USER 的指令才允许在 .user.ini 中进行修改。这些标志可以在 PHP 官方文档的 ini.list.php 页面查阅。
- PHP_INI_PERDIR： 可以在 php.ini、.htaccess、httpd.conf 或 .user.ini 中设置。
- PHP_INI_USER： 可以在 php.ini、.user.ini 或运行时脚本中设置。
例如，display_errors (控制错误显示) 和 upload_max_filesize (最大上传文件大小) 通常是 PHP_INI_PERDIR 或 PHP_INI_USER 类型的，因此可以在 .user.ini 中进行设置。
示例代码
假设您希望在一个特定目录下将错误显示关闭，并将最大上传文件大小设置为 10MB。您可以在该目录（例如 /home/user/public_html/）下创建一个名为 .user.ini 的文件，内容如下：
; .user.ini 文件示例 display_errors = Off upload_max_filesize = 10M post_max_size = 12M
注意事项与最佳实践
-
安全性： 由于 .user.ini 文件通常包含敏感配置，为防止其内容被直接通过 Web 访问，强烈建议对其进行保护。例如，在 Apache 环境下，可以在 .htaccess 文件中添加规则来拒绝外部访问：
# .htaccess 示例：保护 .user.ini <Files ".user.ini"> Order allow,deny Deny from all </Files> PHP 运行模式： 再次强调，.user.ini 的生效依赖于 PHP-FPM 或 FastCGI 模式。在配置或排查问题时，务必确认您的 PHP 运行模式。
配置生效时间： .user.ini 文件中的更改通常不会立即生效，因为 PHP-FPM 进程会缓存这些配置。可能需要等待 user_ini.cache_ttl（默认 300 秒）过期，或者重启 PHP-FPM 服务才能使更改生效。
避免滥用： 尽管 .user.ini 提供了灵活性，但过度使用或在每个子目录都创建 .user.ini 可能会增加系统开销和管理复杂性。建议仅在确实需要局部覆盖配置时使用。
总结
php.ini 和 .user.ini 是 PHP 配置体系中互补的组成部分。php.ini 负责全局性的、基础的 PHP 环境设置，而 .user.ini 则提供了在特定目录下对部分指令进行精细化控制的能力。理解它们各自的作用域、生效条件（特别是 .user.ini 对 PHP-FPM 的依赖）以及可覆盖的指令类型，是高效管理 PHP 配置、确保应用程序稳定运行的关键。在实际应用中，合理利用这两种配置文件，并注意其安全性，将大大提升 PHP 环境的可维护性和灵活性。
