CodeIgniter4通过Composer安装PhpSpreadsheet失败如何解决

PhpSpreadsheet 1.24.0及以上版本强依赖PHP的gd图形扩展，当前XAMPP环境的PHP CLI运行模式未启用该扩展，Composer依赖校验不通过，因此安装流程自动终止并回滚了配置文件改动。

• 确认CLI模式加载的PHP配置文件路径
  打开终端执行以下命令，查看Composer实际调用的PHP对应的ini配置位置，避免改错Apache运行时用的配置文件：
  php --ini
  XAMPP默认环境下该路径通常为C:\Program Files\xampp\php\php.ini，和报错提示一致。
• 开启gd扩展配置
  用文本编辑器打开上述php.ini文件，搜索配置项：
  高版本PHP（7.4+）对应行是;extension=gd，旧版本可能是;extension=php_gd2.dll
  删掉行首的注释分号;，修改为extension=gd后保存文件。
• 校验扩展启用状态
  终端执行以下命令，确认gd扩展已经正常加载：
  php -m | findstr gd
  命令返回结果包含gd字段即为启用成功。
  如果提示扩展不存在，先检查XAMPP安装目录下php/ext文件夹内是否存在php_gd.dll文件，文件缺失的话可以重新安装对应版本的XAMPP完整组件，或单独下载匹配PHP版本的gd扩展文件放入ext目录。
• 重新执行安装命令
  回到CodeIgniter 4项目根目录，重新运行安装命令即可完成PhpSpreadsheet引入：
  composer require phpoffice/phpspreadsheet

如果暂时不需要用到单元格图片生成、格式渲染等依赖gd的能力，可以在安装时追加参数跳过平台扩展校验，强制完成安装，但后续调用相关功能时会出现运行错误：
composer require phpoffice/phpspreadsheet --ignore-platform-req=ext-gd

内容的提问来源于stack exchange，提问作者Lidia K.