如何高效管理电商项目的区域和税收规则？commerceguys/zone(或其继任者)助你简化复杂地理逻辑

<code class="bash">composer require commerceguys/zone</code>

<pre class="brush:php;toolbar:false;">use CommerceGuys\Addressing\Address;
use CommerceGuys\Zone\Model\Zone;
use CommerceGuys\Zone\Model\ZoneMemberCountry;

// 1. 创建一个 Zone 实例
$germanVatZone = new Zone();
$germanVatZone->setId('german_vat');
$germanVatZone->setName('German VAT Zone');
$germanVatZone->setScope('tax'); // 定义区域作用域为税收

// 2. 添加德国作为区域成员
$germanyMember = new ZoneMemberCountry();
$germanyMember->setCountryCode('DE'); // 指定国家代码为德国
$germanVatZone->addMember($germanyMember);

// 3. 添加奥地利特定邮政编码作为区域成员
$austriaMember = new ZoneMemberCountry();
$austriaMember->setCountryCode('AT'); // 指定国家代码为奥地利
// 设置包含的邮政编码：支持单个、逗号分隔和范围（start:end）
$austriaMember->setIncludedPostalCodes('6691, 6991:6993');
$germanVatZone->addMember($austriaMember);

// 4. 现在，我们可以检查一个地址是否匹配这个区域
$austrianAddress = new Address();
$austrianAddress = $austrianAddress
    ->withCountryCode('AT')
    ->withPostalCode('6692'); // 邮政编码 6692 在 6991:6993 范围内

// 检查地址是否匹配该区域
if ($germanVatZone->match($austrianAddress)) {
    echo "奥地利地址 (6692) 匹配 'German VAT Zone'。\n"; // 输出：匹配
} else {
    echo "奥地利地址 (6692) 不匹配 'German VAT Zone'。\n";
}

$germanAddress = new Address();
$germanAddress = $germanAddress
    ->withCountryCode('DE')
    ->withPostalCode('10115'); // 德国柏林的邮政编码

if ($germanVatZone->match($germanAddress)) {
    echo "德国地址 (10115) 匹配 'German VAT Zone'。\n"; // 输出：匹配
} else {
    echo "德国地址 (10115) 不匹配 'German VAT Zone'。\n";
}

$otherAustrianAddress = new Address();
$otherAustrianAddress = $otherAustrianAddress
    ->withCountryCode('AT')
    ->withPostalCode('1010'); // 奥地利维也纳的邮政编码，不在指定范围内

if ($germanVatZone->match($otherAustrianAddress)) {
    echo "奥地利地址 (1010) 匹配 'German VAT Zone'。\n";
} else {
    echo "奥地利地址 (1010) 不匹配 'German VAT Zone'。\n"; // 输出：不匹配
}

<pre class="brush:php;toolbar:false;">use CommerceGuys\Addressing\Address;
use CommerceGuys\Zone\Matcher\ZoneMatcher;
use CommerceGuys\Zone\Repository\ZoneRepository;
use CommerceGuys\Zone\Model\Zone;
use CommerceGuys\Zone\Model\ZoneMemberCountry;

// 假设我们有一个简单的内存仓库来存储区域，实际中可能从数据库或文件加载
$germanVatZone = new Zone();
$germanVatZone->setId('german_vat');
$germanVatZone->setName('German VAT Zone');
$germanVatZone->setScope('tax');
$germanyMember = new ZoneMemberCountry();
$germanyMember->setCountryCode('DE');
$germanVatZone->addMember($germanyMember);
$austriaMember = new ZoneMemberCountry();
$austriaMember->setCountryCode('AT');
$austriaMember->setIncludedPostalCodes('6691, 6991:6993');
$germanVatZone->addMember($austriaMember);

$allZones = [$germanVatZone]; // 假设这是我们系统中的所有区域

// 使用匿名类模拟 ZoneRepository，实际中会从持久化存储加载
$repository = new class($allZones) extends ZoneRepository {
    private $zones;
    public function __construct(array $zones) {
        $this->zones = $zones;
    }
    public function getAll(?string $scope = null): array {
        if ($scope === null) {
            return $this->zones;
        }
        return array_filter($this->zones, fn($zone) => $zone->getScope() === $scope);
    }
    public function get(string $id): ?\CommerceGuys\Zone\Model\ZoneInterface {
        foreach ($this->zones as $zone) {
            if ($zone->getId() === $id) {
                return $zone;
            }
        }
        return null;
    }
};

$matcher = new ZoneMatcher($repository);

$austrianAddress = new Address();
$austrianAddress = $austrianAddress
    ->withCountryCode('AT')
    ->withPostalCode('6692');

echo "--- 匹配所有区域 ---\n";
// 获取所有匹配的区域
$matchingZones = $matcher->matchAll($austrianAddress, 'tax');
echo "匹配 'tax' 作用域的区域：\n";
foreach ($matchingZones as $zone) {
    echo "- " . $zone->getName() . "\n";
}

echo "--- 最佳匹配区域 ---\n";
// 获取最佳匹配区域
$bestMatchingZone = $matcher->match($austrianAddress, 'tax');
if ($bestMatchingZone) {
    echo "最佳匹配区域 ('tax' 作用域)：" . $bestMatchingZone->getName() . "\n";
} else {
    echo "没有找到匹配 'tax' 作用域的区域。\n";
}