在PHP开发中，配置管理往往是一个容易被忽视但影响深远的环节。数据库连接参数、缓存服务地址、第三方API密钥等信息如果直接硬编码在业务逻辑里，不仅会导致代码维护困难，在切换开发、测试和生产环境时还容易出错。将这类信息集中到独立的配置文件中，是更规范的做法。目前PHP项目常用的配置格式主要有两种：INI和YAML。INI格式历史久远，解析成本低，适合轻量级配置；YAML则以缩进和层级结构表达复杂数据，在现代化框架中非常流行。接下来分别介绍这两种格式的读取方法，并给出可复用的封装思路。
使用parse_ini_file读取INI配置文件
PHP内置的parse_ini_file函数是读取INI文件最直接的方式。它不需要安装任何额外扩展，在几乎所有的PHP环境中都可以使用。函数的基本签名是parse_ini_file(string $filename, bool $process_sections = false, int $scanner_mode = INI_SCANNER_NORMAL): array|false。第一个参数是INI文件的路径，第二个参数决定是否将文件中的方括号节识别为多维数组，第三个参数可以控制值的类型转换。从PHP 5.6.1开始，传入INI_SCANNER_TYPED可以让解析器把true、false、数字等字符串自动转换成对应的PHP类型。
下面是一个典型的config.ini文件：
; 数据库连接配置 [database] host = localhost port = 3306 username = root password = secret debug = false [app] name = "My App" items[] = "a" items[] = "b"
读取该文件的PHP代码如下。使用__DIR__拼接路径可以避免相对路径受当前工作目录影响。
<?php $config = parse_ini_file(__DIR__ . '/config.ini', true, INI_SCANNER_TYPED); print_r($config);
当第二个参数为true时，返回结果会按照节分组，例如$config['database']['host']。如果第三个参数使用了INI_SCANNER_TYPED，false会被解析为布尔值false而不是字符串“false”，port会变成整数3306。如果不传入第三个参数，所有值默认都是字符串，这在某些弱类型场景下可能引发比对异常。比如if ($config['database']['debug'] == false)在字符串“false”时可能不会按预期工作，因此建议统一使用INI_SCANNER_TYPED来获得更准确的类型。
INI文件也有一些限制需要留意。分号开头的行是注释，键名和值之间的空格会被忽略。键名不能包含方括号、等号等特殊字符，值中如果包含分号、换行符等特殊内容需要用双引号包裹。对于数组，可以使用items[]这种语法让解析结果成为索引数组，也可以使用assoc[key]创建关联数组。由于INI格式本身不区分复杂数据类型，如果需要表达多层嵌套或对象结构，YAML会更合适。
解析YAML配置：原生扩展与Symfony组件
YAML格式使用缩进表示层级关系，比INI更适合描述复杂配置。例如数据库配置可以写成嵌套结构，还可以轻松表达数组和布尔值。PHP并没有内置YAML解析函数，但有两种常见方案：安装PECL yaml扩展，或者通过Composer引入Symfony YAML组件。前者性能更好，但依赖服务器环境；后者是纯PHP实现，部署灵活，在框架中应用广泛。
先看一个config.yaml示例：
database:
host: localhost
port: 3306
username: root
password: secret
debug: false
app:
name: My App
items:
- a
- b
如果服务器已经安装了yaml扩展，可以直接调用yaml_parse_file函数：
<?php
if (function_exists('yaml_parse_file')) {
$config = yaml_parse_file(__DIR__ . '/config.yaml');
print_r($config);
} else {
echo 'yaml扩展未安装';
}
大多数共享主机或容器镜像默认不会安装yaml扩展。此时可以使用Composer安装symfony/yaml包。在项目根目录执行composer require symfony/yaml后，代码可以这样写：
<?php require __DIR__ . '/vendor/autoload.php'; use Symfony\Component\Yaml\Yaml; $config = Yaml::parseFile(__DIR__ . '/config.yaml'); print_r($config);
Symfony YAML组件提供了Yaml::parseFile静态方法，可以解析文件和字符串，还支持YAML的多种语法特性，包括锚点、引用和自定义标签。需要注意的是，YAML对缩进非常敏感，同一层级的键必须使用相同数量的空格缩进，不能混用Tab和空格。如果缩进错误，解析器会抛出ParseException异常。读取后得到的结构与INI类似，但数组表达更直观，布尔值、数字也由解析器自动识别。
选择INI还是YAML取决于项目复杂度。如果只是十几个键值对，INI完全够用；如果配置中包含列表、嵌套结构或需要注释说明层级关系，YAML的可读性和可维护性更强。另外YAML支持多行字符串，适合存放较长的模板或公钥内容。
封装配置读取类与最佳实践
直接在业务代码里到处调用parse_ini_file或Yaml::parseFile会导致文件被重复读取，也不利于统一处理错误和切换环境。建议封装一个简单的Config类，根据文件扩展名选择合适的解析器，并缓存已加载的配置，避免同一次请求中多次磁盘IO。
下面是一个基础封装示例：
<?php
class Config
{
private static array $cache = [];
public static function load(string $path): array
{
$path = realpath($path);
if ($path === false || !is_file($path)) {
throw new RuntimeException("配置文件不存在: {$path}");
}
if (isset(self::$cache[$path])) {
return self::$cache[$path];
}
$ext = pathinfo($path, PATHINFO_EXTENSION);
$config = match ($ext) {
'ini' => parse_ini_file($path, true, INI_SCANNER_TYPED),
'yaml', 'yml' => self::parseYaml($path),
default => throw new RuntimeException("不支持的配置格式: {$ext}"),
};
if ($config === false) {
throw new RuntimeException("配置文件解析失败: {$path}");
}
return self::$cache[$path] = $config;
}
private static function parseYaml(string $path): array
{
if (function_exists('yaml_parse_file')) {
return yaml_parse_file($path);
}
if (class_exists(\Symfony\Component\Yaml\Yaml::class)) {
return \Symfony\Component\Yaml\Yaml::parseFile($path);
}
throw new RuntimeException('请先安装yaml扩展或symfony/yaml组件');
}
}
$config = Config::load(__DIR__ . '/config.yaml');
print_r($config['database']['host']);
这个Config类使用静态属性保存已加载的配置，realpath确保路径有效，pathinfo识别扩展名。对于YAML，优先检测原生扩展，再回退到Symfony组件，兼顾性能与兼容性。如果文件解析失败，会抛出明确的异常信息，方便在框架的错误处理流程中捕获。
在实际项目中还需要注意几个细节。首先，配置文件不应放在Web可访问目录，避免被直接下载。其次，生产环境的敏感信息最好通过环境变量覆盖配置值，而不是把真实密码提交到代码仓库。再次，可以为不同环境准备不同文件，例如config.dev.ini和config.prod.ini，通过服务器环境变量APP_ENV决定加载哪个。最后，如果配置内容较大，可以考虑使用APCu等内存缓存减少重复解析开销，但要注意缓存失效策略。
配置文件是连接代码与部署环境的重要桥梁。掌握INI和YAML的读取方法，再配合合理的封装，能够让PHP项目的配置管理更加安全、灵活和高效。
