先执行 php -m | grep xsl 验证是否加载；若无输出或报错，则需手动在 php.ini 中添加 extension=xsl，并确保系统已安装 libxslt-devel 和 libxml2-devel，最后重新用 phpenv 安装对应 php 版本。
phpenv 下怎么确认 XSL 是否已编译进当前 PHP
XSL 扩展依赖 libxslt 和 libxml2，但 php-build 默认配置里 --with-xsl 是开启的（见知识库中 default_configure_options 示例），所以用 phpenv 安装的 PHP 多数自带 XSL 支持——但不等于已启用。必须验证是否真的被加载。
执行以下命令检查：
php -m | grep xsl
如果无输出，说明未启用；如果报错 PHP Warning: PHP Startup: Unable to load dynamic library 'xsl'，说明扩展文件缺失或路径错误。
常见误区：以为只要编译时加了 --with-xsl 就自动生效。其实它只是让 PHP 具备调用 libxslt 的能力，仍需在运行时显式加载 xsl.so 模块。
手动启用 XSL 扩展（适用于 phpenv 管理的任意版本）
phpenv 不会自动写入 extension=xsl 到 php.ini，得自己加。步骤很直接：
- 找到当前版本的 php.ini 路径：
php --ini→ 看Loaded Configuration File行 - 编辑该文件，在末尾添加一行：
extension=xsl（PHP 7.4+ 推荐写法；旧版可写extension=php_xsl.dllWindows 或extension=xsl.soLinux/macOS） - 确认
extension_dir指向正确位置，例如：extension_dir = "/home/you/.phpenv/versions/8.2.12/lib/php/extensions/no-debug-non-zts-20220829"（路径中的20220829是 ABI 版本号，不同 PHP 小版本可能不同） - 保存后重启 PHP-FPM 或 Web 服务器（如用 Apache，执行
sudo systemctl restart apache2；如纯 CLI 测试，无需重启）
如果 php -m | grep xsl 报“找不到 so 文件”，怎么办
这说明 phpenv 编译时虽然启用了 --with-xsl，但系统缺少 libxslt 开发头文件，导致编译跳过 XSL 模块（静默失败）。典型现象是 configure 输出里有 checking for libxslt support... no。
解决方法取决于系统：
- Ubuntu/Debian：
sudo apt install libxslt1-dev libxml2-dev - CentOS/RHEL/Fedora：
sudo yum install libxslt-devel libxml2-devel或sudo dnf install libxslt-devel libxml2-devel - macOS（Homebrew）：
brew install libxslt libxml2，并确保 pkg-config 可用
装完依赖后，**必须重新安装 PHP 版本**：phpenv uninstall 8.2.12 && phpenv install 8.2.12。不能只重装扩展——XSL 是编译期决定的内置模块，不是独立 .so。
验证 XSL 是否真正可用（不只是加载成功）
加载成功 ≠ 功能正常。XSLT 转换还依赖底层 libxslt 的运行时行为，比如是否支持 EXSLT、是否启用安全限制等。
最简验证脚本：
<?php $xsl = new DOMDocument();
$xsl->loadXML('<stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"><template match="/">OK</template></stylesheet>');
$proc = new XSLTProcessor();
$proc->importStylesheet($xsl);
echo $proc->transformToXml(new DOMDocument());
?>
如果输出 OK，说明 XSL 引擎工作正常；如果报 Call to undefined function xslt_create()（老式 API）或 XSLTProcessor not found，说明扩展根本没加载；如果报 DOMDocument::loadXML(): Empty string supplied as input，说明 XML 字符串拼错了——注意引号嵌套和命名空间。
容易被忽略的一点：某些 phpenv + php-build 组合在 macOS 上会因 libxslt 版本太新而触发 libxslt security framework 限制，导致 transformToXml 返回空。此时需在 XSLTProcessor 上调用 $proc->setSecurityPrefs(0)（仅开发环境），或改用更保守的 libxslt 版本编译。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
