PHP读取配置最常用parse_ini_file()解析INI（支持分组但不支持嵌套）和json_decode(file_get_contents())解析JSON（支持嵌套、数组及标准类型）；需注意类型转换、错误处理、缓存优化及敏感信息环境变量注入。
PHP 读取配置文件最常用的是 parse_ini_file() 解析 INI 格式，以及 json_decode(file_get_contents()) 解析 JSON 格式。两者语法简洁、结构清晰，适合不同复杂度的配置需求。
INI 配置文件解析（简单键值 + 分组）
INI 是 PHP 原生支持的轻量配置格式，适合基础配置项，如数据库连接、调试开关等。支持普通键值和分组（用方括号定义），但不支持嵌套或数组（除非手动处理）。
示例 config.ini：
debug = true
app_name = "MyApp"
[database]
host = "localhost"
port = 3306
username = "root"
password = "123456"
PHP 解析方式：
立即学习“PHP免费学习笔记（深入）”；
- 默认不解析分组：
$cfg = parse_ini_file('config.ini');→ 所有键扁平化（database.host不会自动产生） - 启用分组解析：
$cfg = parse_ini_file('config.ini', true);→ 返回二维数组，$cfg['database']['host']可直接访问 - 若需布尔/数字自动类型转换，加第三个参数：
parse_ini_file('config.ini', true, INI_SCANNER_TYPED)，此时debug = true会被识别为布尔值而非字符串
JSON 配置文件解析（支持嵌套与数组）
JSON 更适合结构较复杂的配置，比如多级路由规则、API 接口映射、权限列表等，天然支持对象、数组、嵌套和标准数据类型。
示例 config.json：
"debug": true,
"app_name": "MyApp",
"database": {
"host": "localhost",
"port": 3306,
"credentials": [
{"user": "admin", "pass": "a1b2c3"},
{"user": "guest", "pass": "read-only"}
]
}
}
PHP 解析方式：
立即学习“PHP免费学习笔记（深入）”；
- 基本读取：
$cfg = json_decode(file_get_contents('config.json'), true);—— 第二个参数true表示返回关联数组（推荐） - 务必检查解析结果：
if (json_last_error() !== JSON_ERROR_NONE) { throw new Exception('Invalid JSON config'); } - 路径安全建议：使用
__DIR__ . '/config.json'拼接绝对路径，避免相对路径导致的加载失败
配置文件加载的最佳实践
实际项目中，不应在每次请求时重复解析配置。应结合缓存与环境判断提升效率与安全性。
- 生产环境建议将解析结果写入 APCu 或 OPcache 缓存（如
apcu_store('app_config', $cfg, 3600)），避免重复 I/O 和解析开销 - 开发/测试环境可加文件修改监听（
filemtime()对比），实现热重载（仅调试用，勿用于线上） - 敏感配置（如密码、密钥）不要直接写在 INI/JSON 中，应通过环境变量注入：
$_ENV['DB_PASSWORD']或getenv('DB_PASSWORD') - 统一入口封装加载逻辑，例如
Config::load('database')，内部自动选择格式、合并环境专属配置（如config.prod.json）
基本上就这些。INI 简单直接，JSON 灵活强大，选哪个取决于配置复杂度和团队习惯。只要注意类型、错误处理和加载时机，就能稳稳用好。
