php yaml扩展安装需先编译安装libyaml≥0.2.5，再通过pecl或源码安装php-yaml；windows下还需将yaml.dll置于xampp根目录，且php.ini中启用extension=yaml。
PHP 的 yaml 扩展不能只靠 pecl install yaml 一步到位——它依赖系统级的 libyaml 库，漏掉这层，编译会直接失败，报错类似 configure: error: libyaml not found 或 undefined reference to yaml_*。
Linux 下必须先装 libyaml，再装 php-yaml 扩展
PECL 的 yaml 是 PHP 封装层，底层调用的是 C 实现的 libyaml。系统没装这个库，./configure 阶段就会卡住。
- 不要用
apt install libyaml-dev后就以为万事大吉——Debian/Ubuntu 的包版本太老（比如 Ubuntu 22.04 自带的是 libyaml-0.2.2），而 PHP YAML 扩展 2.2+ 要求 libyaml ≥ 0.2.5 - 推荐从源码编译安装：
git clone https://github.com/yaml/libyaml cd libyaml ./bootstrap ./configure --prefix=/usr/local make && sudo make install
- 确保
pkg-config --modversion yaml能输出 ≥ 0.2.5 的版本；如果不行，检查/usr/local/lib/pkgconfig/是否在PKG_CONFIG_PATH中
pecl install yaml 失败时，手动编译更可控
很多环境下 pecl install yaml 会跳过 libyaml 检查或用错路径，尤其当系统有多个 PHP 版本或自定义安装路径时。
- 先确认
php-config路径：which php-config或find /usr -name php-config 2>/dev/null - 下载对应 PHP 版本的扩展源码（例如 PHP 8.2）：
wget https://pecl.php.net/get/yaml-2.2.2.tgz - 解压后执行：
phpize ./configure --with-php-config=/usr/bin/php-config make && sudo make install
- 注意：如果
make install输出的.so路径不在extension_dir里，得手动复制到正确目录（php -i | grep extension_dir查看）
Windows XAMPP 环境下别漏掉 yaml.dll
Windows 不需要编译 libyaml，但容易忽略一个关键 DLL：除了 php_yaml.dll，XAMPP 还要求同名的 yaml.dll（C 运行时依赖）放在系统能加载到的位置。
- 从 PECL 下载的 ZIP 包里，有两个文件：
php_yaml.dll（PHP 扩展）和yaml.dll（libyaml 的 Windows 动态库） -
php_yaml.dll放进php\ext\目录（如C:\xampp\php\ext\） -
yaml.dll必须放进C:\xampp\根目录（不是php/子目录），否则 Apache 启动时报PHP Startup: Unable to load dynamic library 'php_yaml.dll' -
php.ini中写extension=yaml（不带.dll），不是extension=php_yaml.dll
最容易被忽略的点是：libyaml 和 PHP YAML 扩展的版本兼容性。比如 libyaml 0.2.5 + yaml 2.2.2 可以，但 libyaml 0.1.7 + yaml 2.2.x 几乎必挂——别图省事复用旧系统包，宁可自己编译一份干净的 libyaml。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
