本文介绍如何使用 php 读取结构化文本文件（如 key="value" 格式），安全提取特定字段（如 name、email），并赋值给变量，涵盖基础解析、数据清洗与异常处理要点。
本文介绍如何使用 php 读取结构化文本文件（如 key="value" 格式），安全提取特定字段（如 name、email），并赋值给变量，涵盖基础解析、数据清洗与异常处理要点。
在 PHP 开发中，常需从纯文本配置文件（非标准 INI/JSON 格式）中提取特定字段，例如 source.txt 中以 key = "value" 形式存储的用户信息。这类文件虽简单，但直接用 file_get_contents() + echo 无法满足按需取值需求。下面提供一套健壮、可复用的解析方案。
✅ 推荐实现：逐行解析 + 键值映射
<?php
function parseConfigFile(string $filePath): array {
$config = [];
if (!is_file($filePath) || !is_readable($filePath)) {
throw new RuntimeException("配置文件不存在或不可读: {$filePath}");
}
$lines = file($filePath, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
foreach ($lines as $line) {
// 跳过注释行和空行（增强鲁棒性）
$line = trim($line);
if (empty($line) || str_starts_with($line, '#') || str_starts_with($line, ';')) {
continue;
}
// 匹配 key = "value" 或 key = 'value' 或 key = value（无引号）
if (preg_match('/^([^=]+)\s*=\s*(["\']?)(.*?)\2\s*$/u', $line, $matches)) {
$key = trim($matches[1]);
$value = trim($matches[3]);
// 去除 HTML 标签（如 Cloudflare 邮箱保护链接）
$value = strip_tags($value);
// 可选：自动去除首尾引号（若存在且成对）
if (strlen($value) >= 2 && $value[0] === $value[strlen($value)-1] && in_array($value[0], ['"', "'"])) {
$value = substr($value, 1, -1);
}
$config[$key] = $value;
}
}
return $config;
}
// 使用示例
try {
$config = parseConfigFile('./source.txt');
// 按需获取变量
$name = $config['Name'] ?? null;
$image = $config['image'] ?? null;
$email = $config['email'] ?? null;
echo "姓名: {$name}\n"; // 输出: 姓名: john
echo "头像路径: {$image}\n"; // 输出: 头像路径: /path
echo "邮箱: {$email}\n"; // 输出: 邮箱: [email protected]
} catch (Exception $e) {
error_log('解析配置文件失败: ' . $e->getMessage());
}
?>⚠️ 关键注意事项
- 安全性优先：避免 eval() 或 create_function() 等危险函数；本方案全程使用白名单式正则与 strip_tags() 清洗，防止 XSS 或代码注入。
- 引号兼容性：支持双引号 "、单引号 ' 及无引号值，自动剥离包裹符号。
- HTML 内容处理：针对 Cloudflare 邮箱保护等嵌入 标签的场景，strip_tags() 确保提取纯文本值。
- 错误防御：检查文件存在性、可读性，并跳过注释/空行，提升脚本稳定性。
- 编码兼容：正则中添加 /u 修饰符，支持 UTF-8 中文键名（如 姓名 = "张三"）。
✅ 替代方案对比（简要）
| 方法 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| parse_ini_file() | 原生高效、支持注释/分段 | 要求严格 INI 格式（key=value，不支持引号内等号） | 标准 INI 文件 |
| 正则 preg_match_all 一次性提取 | 代码简洁 | 难以处理多行值或嵌套结构 | 简单单行键值对 |
| 本方案（逐行 + 正则） | 灵活、安全、可扩展、易调试 | 略多几行代码 | 自定义格式文本配置 |
? 总结：对于非标准但结构清晰的 .txt 配置文件，推荐采用「逐行读取 + 安全正则解析 + 数据清洗」三步法。它兼顾可读性、健壮性与维护性，是生产环境中值得信赖的实践模式。
