如何通过PSR-4自动加载实现Composer Vendor包类的可扩展重写？

方案1：Laravel服务容器绑定（推荐） #

这是Laravel原生支持的标准实现，不用修改自动加载逻辑，也不破坏PSR-4规范：

1. 在自研包的服务提供者中注册可重写类
   在你包的服务提供者register方法中统一绑定需要支持用户重写的类，优先判断App命名空间下的对应类是否存在：

<?php

namespace MyVendorName\MyApplicationName;

use Illuminate\Support\ServiceProvider;

class MyApplicationServiceProvider extends ServiceProvider
{
    public function register()
    {
        // 批量注册可重写类
        $this->bindOverrideableClass('Mapper\BaseMapper');
        $this->bindOverrideableClass('Controller\BaseController');
        // 其他需要支持重写的类都可以按这个格式添加
    }

    protected function bindOverrideableClass(string $classRelativePath)
    {
        $packageNamespace = 'MyVendorName\MyApplicationName\\';
        $appNamespace = 'App\MyApplicationName\\';
        
        $packageClass = $packageNamespace . $classRelativePath;
        $appClass = $appNamespace . $classRelativePath;

        // 绑定到容器，单例场景把bind改成singleton即可
        $this->app->bind($packageClass, function () use ($appClass, $packageClass) {
            return class_exists($appClass) ? new $appClass() : new $packageClass();
        });
    }
}

记得把你的服务提供者注册到包的composer.json的extra.laravel.providers数组中，Laravel会自动发现加载：

"extra": {
    "laravel": {
        "providers": [
            "MyVendorName\\MyApplicationName\\MyApplicationServiceProvider"
        ]
    }
}

2. 包内所有实例化类的逻辑替换为容器解析
   所有原来直接new类的地方，都改成通过Laravel容器解析：

// 原来的写法
// $mapper = new \MyVendorName\MyApplicationName\Mapper\BaseMapper();
// 现在的写法
$mapper = app(\MyVendorName\MyApplicationName\Mapper\BaseMapper::class);

只要用户在App目录下定义了对应重写类，容器会自动返回重写后的实例，不需要在每个实例化位置加判断，也不会出现遗漏。

方案2：自定义自动加载（不推荐） #

如果你确实不想依赖Laravel容器功能，可以实现自定义自动加载器，注意要把自动加载器的优先级设为高于Composer默认加载器，避免提前加载包内的同名类：
在你包的服务提供者register方法中添加以下代码：

spl_autoload_register(function (string $className) {
    // 只处理你自研包的命名空间
    if (!str_starts_with($className, 'MyVendorName\\MyApplicationName\\')) {
        return;
    }

    // 转换为App目录下的对应类名
    $appClassName = str_replace(
        'MyVendorName\\MyApplicationName',
        'App\\MyApplicationName',
        $className
    );

    // 拼接App目录下的类文件路径
    $appClassPath = base_path(str_replace('\\', DIRECTORY_SEPARATOR, $appClassName) . '.php');

    // 如果App下的类文件存在则优先加载
    if (file_exists($appClassPath)) {
        require_once $appClassPath;
    }
}, prepend: true); // prepend参数设为true，将该加载器放到自动加载队列最前面

这个方案的缺点是不符合PSR-4规范，相同命名空间对应两份类文件，容易出现类加载冲突，后续维护成本更高。

你之前尝试的直接修改Composer的PSR-4配置的方式不可行，因为PSR-4要求同一个命名空间前缀下的类只能对应唯一的目录位置，多个目录的话只会按顺序加载第一个找到的类，不会支持子类继承父类的重写场景。

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