如何重命名Composer包命名空间？解决PrestaShop模块phpspreadsheet冲突

可以通过重命名命名空间隔离不同版本的库 #

完全可以修改命名空间来让两个模块各自使用独立版本的phpspreadsheet，彻底解决冲突问题，具体操作如下：

1. 修改库文件的命名空间声明 #

分别进入两个模块的vendor/phpoffice/phpspreadsheet/src目录，批量修改所有.php文件的命名空间：

• 针对myModuleA，把所有文件里的namespace PhpOffice\PhpSpreadsheet;替换为namespace MyModuleA\PhpOffice\PhpSpreadsheet;
• 针对myModuleB，替换为namespace MyModuleB\PhpOffice\PhpSpreadsheet;

2. 更新库内部的类引用 #

库内部存在大量跨类引用（比如use PhpOffice\PhpSpreadsheet\XXX;），需要同步替换为新命名空间：

• myModuleA内的引用替换为use MyModuleA\PhpOffice\PhpSpreadsheet\XXX;
• myModuleB内的引用替换为use MyModuleB\PhpOffice\PhpSpreadsheet\XXX;

3. 在模块代码中使用新命名空间 #

按照你期望的方式引入类即可：

// myModuleA/test.php 中
use MyModuleA\PhpOffice\PhpSpreadsheet\Spreadsheet;

$spreadsheet = new Spreadsheet();
// 正常调用方法

// myModuleB的业务代码中
use MyModuleB\PhpOffice\PhpSpreadsheet\Spreadsheet;

$spreadsheet = new Spreadsheet();

4. 用工具批量替换提高效率 #

手动修改文件效率太低，可通过命令行工具批量处理：

• Linux/macOS环境下，在vendor/phpoffice/phpspreadsheet/src目录执行：

# 替换命名空间声明
find . -type f -name "*.php" -exec sed -i 's/namespace PhpOffice\\PhpSpreadsheet;/namespace MyModuleA\\PhpOffice\\PhpSpreadsheet;/g' {} \;
# 替换内部类引用
find . -type f -name "*.php" -exec sed -i 's/use PhpOffice\\PhpSpreadsheet/use MyModuleA\\PhpOffice\\PhpSpreadsheet/g' {} \;

Windows环境可使用PowerShell批量替换功能或第三方文本替换工具完成相同操作。

额外注意事项 #

• 每次更新模块内的phpspreadsheet版本后，需重新执行命名空间替换操作，否则冲突会复现。
• 更新模块的composer自动加载配置，确保新命名空间能被正确识别。在模块根目录的composer.json中添加：

{
    "autoload": {
        "psr-4": {
            "MyModuleA\\PhpOffice\\PhpSpreadsheet\\": "vendor/phpoffice/phpspreadsheet/src/"
        }
    }
}

执行composer dump-autoload更新自动加载缓存。

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