PHP读取配置最常用parse_ini_file()解析INI(支持分组但不支持嵌套)和json_decode(file_get_contents())解析JSON(支持嵌套、数组及标准类型);需注意类型转换、错误处理、缓存优化及敏感信息环境变量注入。
PHP 读取配置文件最常用的是 parse_ini_file() 解析 INI 格式,以及 json_decode(file_get_contents()) 解析 JSON 格式。两者语法简洁、结构清晰,适合不同复杂度的配置需求。
INI 是 PHP 原生支持的轻量配置格式,适合基础配置项,如数据库连接、调试开关等。支持普通键值和分组(用方括号定义),但不支持嵌套或数组(除非手动处理)。
示例 config.ini:
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 更适合结构较复杂的配置,比如多级路由规则、API 接口映射、权限列表等,天然支持对象、数组、嵌套和标准数据类型。
示例 config.json:
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_store('app_config', $cfg, 3600)),避免重复 I/O 和解析开销filemtime() 对比),实现热重载(仅调试用,勿用于线上)$_ENV['DB_PASSWORD'] 或 getenv('DB_PASSWORD')
Config::load('database'),内部自动选择格式、合并环境专属配置(如 config.prod.json)基本上就这些。INI 简单直接,JSON 灵活强大,选哪个取决于配置复杂度和团队习惯。只要注意类型、错误处理和加载时机,就能稳稳用好。