ThinkPHP框架使用工厂模式对接多个物流公司下单接口架构示例（php7.0及以上）

对接多个物流公司下单接口和获取物流支持目的地接口，用ThinkPHP框架使用工厂模式写了一个示例，包括如何创建目录及文件命名方式。

首先，我们需要定义一个物流公司的接口（Interface）：

// application/Interfaces/LogisticsCompany.php
namespace app\Interfaces;

interface LogisticsCompany
{
    public function placeOrder($orderInfo);
    public function getSupportedDestinations();
}
1
2
3
4
5
6
7
8

然后，为每个具体的物流公司实现这个接口：

// application/Service/Logistics/CompanyA.php
namespace app\Service\Logistics;

use app\Interfaces\LogisticsCompany;

class CompanyA implements LogisticsCompany
{
    // 实现下单方法
    public function placeOrder($orderInfo)
    {
        // 具体的下单逻辑...
    }

    // 实现获取支持目的地方法
    public function getSupportedDestinations()
    {
        // 具体的获取目的地逻辑...
    }
}

// 同样方式为其他物流公司创建类，例如：CompanyB, CompanyC 等

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

接下来，创建物流服务工厂：

// application/Service/LogisticsFactory.php
namespace app\Service;

class LogisticsFactory
{
    private static $companies = [
        'company_a' => '\\app\\Service\\Logistics\\CompanyA',
        'company_b' => '\\app\\Service\\Logistics\\CompanyB',
        // 更多物流公司...
    ];

    public static function create(string $name): LogisticsCompany
    {
        if (!isset(self::$companies[$name])) {
            throw new \InvalidArgumentException("Invalid logistics company: {$name}");
        }

        return new self::$companies[$name]();
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

最后，在控制器或其他需要调用的地方使用工厂：

// application/controller/YourController.php
namespace app\controller;

use app\Interfaces\LogisticsCompany;
use app\Service\LogisticsFactory;

class YourController
{
    public function placeOrderAction()
    {
        $logisticsCompany = LogisticsFactory::create('company_a');
        $orderInfo = []; // 假设这是订单信息
        $logisticsCompany->placeOrder($orderInfo);

        // 获取支持的目的地
        $destinations = $logisticsCompany->getSupportedDestinations();
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

关于目录及文件命名方式，以上代码已经体现出来了：

• 应用的核心接口存放于 application/Interfaces 目录下。
• 物流公司服务的具体实现位于 application/Service/Logistics 目录下，每个物流公司对应一个类文件，如 CompanyA.php、CompanyB.php 等。
• 工厂类 LogisticsFactory.php 放置于 application/Service 目录下。

为什么interface LogisticsCompany要分开目录？
将 LogisticsCompany 接口放在单独的目录（例如 application/Interfaces）中是为了更好地遵循单一职责原则（SRP）和高内聚低耦合的设计原则。这样做的好处包括：

1. 代码组织清晰：
   接口通常是定义公共契约的地方，它们代表了一组必须实现的方法，但并不涉及具体实现细节。将其与服务的具体实现分开放置，有助于提高代码的可读性和可维护性。
2. 更好的模块化：
   通过将接口单独抽离，可以方便地在不同的模块、层或包之间共享和复用这些接口，而无需关心具体的实现类。这对于大型项目尤其重要，可以减少不同组件之间的直接依赖。
3. 易于扩展和替换：
   当有新的物流公司加入时，只需创建一个新类去实现 LogisticsCompany 接口，并在工厂类中添加相应的映射即可。这使得系统更易于扩展，并且更容易进行单元测试。

当然，在实际项目中，根据项目的规模、团队规范和个人喜好，您完全可以选择将接口放在 Service 目录下，或者使用其他符合团队约定的结构组织代码。关键在于保持代码结构清晰，易读易维护。如果项目较小，接口数量不多，也可以考虑将接口文件置于同一目录，如 application/Service/Interfaces 下。