PHP原生不支持YAML解析，必须安装yaml扩展（依赖libyaml库）才能安全使用yaml_parse_file()等函数正确处理缩进、类型推断等规则，手动解析字符串会导致类型错误或解析失败。
PHP 本身不原生支持 YAML 解析，必须依赖扩展或第三方库。直接用 file_get_contents() 读出字符串再手动解析是错的——YAML 有缩进、锚点、类型推断等规则，不能当普通文本切。
必须安装 yaml 扩展才能安全读写
PHP 的 yaml 扩展基于 libyaml，是唯一能正确处理 YAML 1.1 规范的方案。没有它，yaml_parse() 和 yaml_emit() 都不可用。
- Linux（如 CentOS/Alpine）需先装
libyaml-devel（CentOS）或libyaml-dev（Debian/Ubuntu），再编译安装 PHP yaml 扩展 - Docker 中推荐在
Dockerfile里加：pecl install yaml && docker-php-ext-enable yaml - Windows 用户需下载对应 PHP 版本的
php_yaml.dll，并在php.ini中启用extension=php_yaml.dll - 用
php -m | grep yaml验证是否加载成功；没输出就说明扩展未生效
读取 YML 文件：用 yaml_parse_file()，别手写 json_decode(file_get_contents())
yaml_parse_file() 会完整处理嵌套结构、布尔值（true/false）、null（~ 或 null）、时间戳、多行字面量（|）等。手写解析器极易漏掉类型转换，比如把 yes 当字符串而非布尔 true。
- 文件路径必须是绝对路径或确保当前工作目录正确，相对路径容易因 CLI/web server 工作目录不同而失败
- 遇到解析失败时，
yaml_parse_file()返回false，应配合yaml_last_error()和yaml_last_error_message()查具体错误 - 示例：
$config = yaml_parse_file(__DIR__ . '/config.yml');，返回的是 PHP 数组，可直接用$config['database']['host'] - 不要用
file_get_contents()+yaml_parse()组合——多一次内存拷贝，且出错时堆栈更难定位
写入 YML 文件：用 yaml_emit() 控制格式，避免手动拼接
yaml_emit() 默认输出紧凑格式（无多余空行、键排序按插入顺序），但可通过参数调整。手动字符串拼接 YAML 极易破坏缩进层级或引号规则，导致其他语言（如 Python、Go）或工具（如 Docker Compose）无法识别。
立即学习“PHP免费学习笔记（深入）”；
- 关键参数：
yaml_emit($data, YAML_UTF8_ENCODING, 2, YAML_LITERALS)—— 第二个参数控制缩进空格数，第三个参数开启字面量块（|）支持多行字符串 - 写入前务必检查
$data中是否含非 UTF-8 字符，否则yaml_emit()可能静默失败或输出乱码 - 敏感字段（如密码、密钥）绝不能写入 YML 文件，应改用环境变量 +
getenv()动态注入 - 示例：
file_put_contents('output.yml', yaml_emit($config));，注意权限问题，确保 PHP 进程有写入目录的权限
YAML 的缩进是语义的一部分，不是装饰。哪怕只差一个空格，yaml_parse_file() 就会返回 false 且不报具体哪行错——这是最常被忽略的调试盲区。
