直接安装 ext-xmlwriter 扩展：CentOS/RHEL 运行 yum install php-xmlwriter（PHP 7.x）或 yum install php81-php-xmlwriter（PHP 8.1+）；Debian/Ubuntu 运行 sudo apt install php-xml；验证执行 php -r "var_dump(class_exists('XMLWriter'));" 输出 true 即成功。
composer install 报错 ext-xmlwriter 缺失怎么修
直接装扩展，别绕路。报错里明确写了 ext-xmlwriter 缺失，说明 PHP 解析 XML 或生成 Excel 类文件（比如 phpoffice/phpexcel）时硬依赖这个模块，跳过它只会让后续运行时报 Fatal error: Class 'XMLWriter' not found。
- CentOS/RHEL 系统：运行
yum install php-xmlwriter（PHP 7.x）或yum install php81-php-xmlwriter（PHP 8.1+，注意替换版本前缀） - Debian/Ubuntu 系统：运行
sudo apt install php-xml—— 注意不是单独装php-xmlwriter，因为 Debian 系把xmlwriter、dom、simplexml全打包在php-xml里 - 验证是否生效：
php -m | grep xmlwriter，有输出即成功；没输出就检查是否装错包名或 PHP CLI 配置文件路径不对（php --ini查加载的php.ini）
为什么 --ignore-platform-reqs 不是正解
加 --ignore-platform-reqs 能让 composer install 过去，但只是“假装有”，不解决真实缺失。一旦代码里调用 new XMLWriter()，PHP 直接崩溃，而且这种错误不会在安装阶段暴露，容易漏到测试甚至上线后才触发。
-
--ignore-platform-reqs绕过的是 Composer 的依赖校验，不是运行时环境补全 - 某些包（如旧版
phpexcel）会在require段声明"ext-xmlwriter": "*"，这是硬性运行时依赖，不是可选功能 - 如果项目用了
symfony/polyfill-xmlwriter替代，那得确认它真被加载了——polyfill 不会自动注册，得靠 autoloader 找到类，而类路径又依赖composer dump-autoload是否生成正确
xmlwriter 和 dom、simplexml 的关系要分清
这三个扩展常被混为一谈，但职责不同：xmlwriter 专注高效写 XML（流式生成），dom 用于 DOM 树操作，simplexml 是轻量解析。有些包只依赖其中一个，不能互相替代。
- 报错含
ext-xmlwriter就只装它对应模块，别顺手全装php-xml—— 虽然 Debian 下省事，但在容器或最小化部署里可能引入冗余 - Laravel 项目若用到了
maatwebsite/excel，它底层依赖phpoffice/phpspreadsheet，而后者在导出时默认走XmlWriter，所以xmlwriter是刚需，不是可选 - 检查
vendor/composer/autoload_classmap.php里有没有'XMLWriter' => ...映射 —— 如果没有，说明 polyfill 没生效，或者你装的是php-xml但没启用xmlwriter子模块（部分编译安装 PHP 会默认关掉）
文档解析组件配置容易漏的点
很多文档处理类库（如 phpspreadsheet、dompdf）在初始化时会探测可用扩展，优先用 xmlwriter， fallback 到 dom 或字符串拼接。但探测逻辑藏在 vendor 里，不报错也不提示，结果是性能下降或特殊字符处理出错。
- 不要只看
php -m输出，还要跑php -r "var_dump(class_exists('XMLWriter'));"确认类真能实例化 - CI 环境里常见问题：Dockerfile 里装了
php-xml，但没重启 PHP-FPM 或 CLI 进程，导致php -m看得到，实际运行时还是 missing - Windows 用户不用操心这个 —— 官方 Windows PHP 包默认启用
xmlwriter，除非你手动改过php.ini注释掉了extension=php_xmlwriter.dll
