在Apiato/Porto架构中优雅地覆盖第三方类

// 原始第三方库类 (例如: vendor/package/src/ApiWrapper.php)
namespace OriginalVendor\Package;

class ApiWrapper
{
    public function fetchData(string $endpoint): array
    {
        // 模拟数据获取逻辑
        echo "Fetching data from: " . $endpoint . "...\n";
        return ['data' => 'original_data_from_' . $endpoint];
    }
}

// 在Apiato容器中创建自定义类 (例如: app/Containers/MyApiContainer/Classes/CustomApiWrapper.php)
namespace App\Containers\MyApiContainer\Classes;

use OriginalVendor\Package\ApiWrapper;

class CustomApiWrapper extends ApiWrapper
{
    private string $authToken;

    public function __construct(string $token)
    {
        $this->authToken = $token;
        // 如果父类有构造函数，并且需要调用，则调用 parent::__construct()
        // parent::__construct();
    }

    public function fetchData(string $endpoint): array
    {
        echo "Using auth token: " . $this->authToken . "\n";
        // 在调用父类方法之前或之后添加自定义逻辑
        $data = parent::fetchData($endpoint); // 调用父类的原始方法
        $data['processed_by_custom_wrapper'] = true;
        return $data;
    }

    public function customMethod(): string
    {
        return "This is a new custom method.";
    }
}

// 原始第三方库接口 (例如: vendor/package/src/LoggerInterface.php)
namespace OriginalVendor\Package;

interface LoggerInterface
{
    public function log(string $message, string $level = 'info'): void;
}

// 原始第三方库实现 (例如: vendor/package/src/FileLogger.php)
namespace OriginalVendor\Package;

class FileLogger implements LoggerInterface
{
    public function log(string $message, string $level = 'info'): void
    {
        echo "[FILE LOG - " . strtoupper($level) . "]: " . $message . "\n";
    }
}

// 在Apiato容器中创建自定义实现 (例如: app/Containers/MyLoggerContainer/Classes/DatabaseLogger.php)
namespace App\Containers\MyLoggerContainer\Classes;

use OriginalVendor\Package\LoggerInterface;

class DatabaseLogger implements LoggerInterface
{
    public function log(string $message, string $level = 'info'): void
    {
        // 实际场景中，这里会写入数据库
        echo "[DATABASE LOG - " . strtoupper($level) . "]: Storing message in DB: " . $message . "\n";
    }
}

// 1. 创建自定义类 (如上述 CustomApiWrapper 和 DatabaseLogger)

// 2. 在Apiato容器的服务提供者中进行绑定
// 例如: app/Containers/MyApiContainer/Providers/AppServiceProvider.php
namespace App\Containers\MyApiContainer\Providers;

use App\Containers\MyApiContainer\Classes\CustomApiWrapper;
use App\Containers\MyLoggerContainer\Classes\DatabaseLogger;
use Illuminate\Support\ServiceProvider;
use OriginalVendor\Package\ApiWrapper;
use OriginalVendor\Package\LoggerInterface;

class AppServiceProvider extends ServiceProvider
{
    public function register(): void
    {
        // 绑定具体类: 当应用程序请求 OriginalVendor\Package\ApiWrapper 时，提供 CustomApiWrapper 实例
        // 注意：如果 CustomApiWrapper 有构造函数依赖，Laravel IoC 会自动解析
        $this->app->bind(ApiWrapper::class, function ($app) {
            // 这里可以传入 CustomApiWrapper 构造函数所需的依赖
            return new CustomApiWrapper('your-secret-token-123');
        });

        // 绑定接口: 当应用程序请求 OriginalVendor\Package\LoggerInterface 时，提供 DatabaseLogger 实例
        $this->app->bind(LoggerInterface::class, DatabaseLogger::class);

        // 如果需要单例绑定 (每次都返回同一个实例):
        // $this->app->singleton(LoggerInterface::class, DatabaseLogger::class);
    }

    public function boot(): void
    {
        //
    }
}

// 在任何需要使用的地方 (例如: 控制器、任务、服务)
namespace App\Containers\MyApiContainer\UI\API\Controllers;

use App\Ship\Parents\Controllers\ApiController;
use OriginalVendor\Package\ApiWrapper; // 引用原始类，但实际会解析到 CustomApiWrapper
use OriginalVendor\Package\LoggerInterface; // 引用原始接口，但实际会解析到 DatabaseLogger

class MyController extends ApiController
{
    private ApiWrapper $apiWrapper;
    private LoggerInterface $logger;

    public function __construct(ApiWrapper $apiWrapper, LoggerInterface $logger)
    {
        $this->apiWrapper = $apiWrapper;
        $this->logger = $logger;
    }

    public function index(): array
    {
        $data = $this->apiWrapper->fetchData('users'); // 实际调用 CustomApiWrapper 的 fetchData
        $this->logger->log('Fetched user data.', 'debug'); // 实际调用 DatabaseLogger 的 log

        return [
            'message' => 'Data processed',
            'api_data' => $data
        ];
    }
}