Laravel 10 安装时 XML 扩展缺失会导致 composer create-project 或 laravel new 直接报错退出，因其是硬性依赖：Blade 编译、配置加载、日志 XML 输出及 phpunit 等 dev 依赖均需 dom/xml 扩展；须通过 php -m 验证 CLI 环境已启用 xml、dom、simplexml，并安装对应版本扩展包（如 Ubuntu 的 php8.1-xml）。
Laravel 10 安装时提示 xml 扩展缺失，是因为它属于框架启动的硬性依赖——不是“建议安装”，而是“缺一个就卡死”。XML 扩展参与 Laravel 核心多个关键环节，一旦未启用，composer create-project 或 laravel new 都会在早期直接报错退出，常见错误如：
• Class 'DOMDocument' not found
• ext-xml does not exist
• 或更隐蔽的 RuntimeException（实际是 DOM/XML 底层调用失败）
XML 扩展为什么必须启用
Laravel 10 并不只在处理 RSS 或 SOAP 时才用到 XML，它已深度集成进以下基础功能：
-
Blade 编译器：解析模板中的 XML/HTML 结构，比如
@include、@yield的嵌套逻辑依赖 DOM 扩展（DOM 是 XML 扩展的一部分） -
配置加载：部分配置文件（如
phpunit.xml、phpstan.neon关联的 XML 解析）由测试和分析工具触发，而这些是 Laravel 开箱即用的 dev 依赖 -
日志系统：当配置为
stack+xmlchannel 时，底层使用XmlWriter输出日志 -
第三方包联动：例如
phpunit/phpunit（Laravel 默认测试套件）明确声明ext-dom和ext-xml为必需依赖
怎么确认 XML 扩展真没开
别只看浏览器里的 phpinfo() —— Web 环境和 CLI（命令行）可能加载不同配置。Laravel 安装全程走 CLI，所以必须验证终端中是否生效：
- 运行
php -m | grep -i xml，应输出xml、dom、simplexml至少三项 - 运行
php --ini查看 CLI 模式加载的php.ini路径，确保该文件里没有注释掉extension=xml（Linux/macOS）或extension=php_xml.dll（Windows） - 注意：某些系统（如 Ubuntu）需安装对应 PHP 版本的完整扩展包，例如 PHP 8.1 需
php8.1-xml，而非笼统的php-xml
不同系统快速启用方法
✅ Ubuntu/Debian（PHP 8.1 示例）：
sudo apt update<br>sudo apt install php8.1-xml<br>sudo systemctl restart apache2 # 或 php-fpm
✅ CentOS/RHEL/AlmaLinux（PHP 8.1）：
sudo dnf install php-xml<br># 或指定版本：<br>sudo dnf install php81-php-xml
✅ Windows（WAMP/XAMPP）：
- 打开
php.ini（CLI 模式路径见php --ini） - 取消注释：
extension=php_xml.dll和extension=php_dom.dll - 重启命令行终端（重要！环境变量缓存可能导致旧配置残留）
装完还报错？再检查两件事
• Composer 缓存可能误判：运行 composer clear-cache 后重试
• 多 PHP 版本共存时，CLI 默认可能不是你认为的那个版本：执行 which php 和 php -v 确认，必要时用全路径调用，例如 /usr/bin/php8.1 composer create-project laravel/laravel
