如何通过Composer升级PHP项目中的HTML Purifier版本

你检索到的新用户安装步骤不能直接用于存量旧版升级，存在版本号不符、命令语法错误两个问题，存量场景的正确操作流程如下：

• 先确认原有安装方式
  如果旧版本是通过Composer管理的，不需要手动删除旧文件，Composer会自动完成版本替换、依赖兼容校验；如果旧版本是手动下载源码部署、未接入Composer管理，先完整删除项目中残留的旧版HTML Purifier源码目录，避免后续出现多版本文件混用的问题。
• 修改依赖配置
  打开项目根目录下的composer.json文件，定位到require配置块：
  • 如果已经存在ezyang/htmlpurifier的依赖条目，直接把对应的版本值改为4.14.0即可，不要重复添加同个依赖的声明，避免配置解析冲突
  • 如果不存在该条目（对应之前手动安装的场景），再新增"ezyang/htmlpurifier": "4.14.0"的依赖声明
• 执行正确的升级命令
  你搜到的命令缺少update参数，无法正常执行，正确的命令为在项目根目录运行：
  composer update ezyang/htmlpurifier --with-dependencies
  命令执行过程中Composer会自动拉取对应版本的安装包、匹配兼容的关联依赖，完成旧版本文件的替换。
• 升级结果校验
  命令执行完成后，运行composer show ezyang/htmlpurifier，查看输出的版本字段是否为4.14.0，确认版本升级生效。如果项目内有基于HTML Purifier封装的自定义过滤逻辑，建议跑一遍核心业务场景的内容解析、XSS过滤用例，确认不存在版本兼容问题。

注意：升级前建议先提交一次当前项目的代码版本快照，避免升级失败无法快速回滚。

内容的提问来源于stack exchange，提问作者David Ray