在我们的电商平台开发过程中，我们遇到了一个棘手的问题：如何高效地与 CDEK 物流服务进行集成。我们需要获取物流信息、计算运输成本，但频繁的 API 调用导致系统性能下降，配置复杂且难以管理。经过一番探索，我们找到了 dicr/yii2-cdek 这个 Composer 包，它为我们提供了解决方案。
dicr/yii2-cdek 是一个专门为 Yii2 框架设计的 CDEK API 库。它实现了 CDEK 的 JSON 数据交换协议版本 1.5，并通过 CachingClient 提供了请求缓存功能，显著减少了对 CDEK 服务器的请求次数，从而提升了系统的性能。
首先，我们需要通过 Composer 安装这个包：
<code class="bash">composer require dicr/yii2-cdek</code>
然后，我们在应用配置中设置 CdekApi 组件：
<code class="php">return [
'components' => [
'cdek' => [
'class' => dicr\cdek\CdekApi::class,
'baseUrl' => dicr\cdek\CdekApi::URL_INTEGRATION_TEST,
'login' => dicr\cdek\CdekApi::LOGIN_TEST,
'password' => dicr\cdek\CdekApi::PASSWORD_TEST,
'calcRequestConfig' => [
'senderCityPostCode' => 614087, // 例如，设置为 Perm
'tariffList' => [
['id' => dicr\cdek\CdekApi::TARIF_POST_S_S],
['id' => dicr\cdek\CdekApi::TARIF_POST_S_D],
['id' => dicr\cdek\CdekApi::TARIF_ECOPOST_S_D],
['id' => dicr\cdek\CdekApi::TARIF_ECOPOST_S_S]
],
]
]
]
];</code>配置好后，我们可以使用 CdekApi 组件来发送各种请求，例如获取区域列表、城市列表、取货点列表，以及计算运输成本：
<code class="php">/** @var dicr\cdek\CdekApi $api */
$api = Yii::$app->get('cdek');
// 获取区域列表
$regions = $api->regionRequest()->send();
// 获取城市列表
$cities = $api->cityRequest([
'countryCode' => 'ru'
])->send();
// 获取取货点列表
$pvz = $api->cityRequest([
'citypostcode' => 614087
])->send();
// 计算运输成本
$result = $api->calcRequest([
'receiverCityId' => 44, // 例如，Moscow
'modeId' => dicr\cdek\CdekApi::DELIVERY_SKLAD_DOOR,
'goods' => [
['weight' => 0.24, 'volume' => 0.001]
]
])->send();</code>通过使用 dicr/yii2-cdek 库，我们不仅简化了 CDEK API 的集成过程，还通过缓存机制显著提高了系统性能。配置文件的集中管理也使得维护和调整变得更加方便。
总的来说，dicr/yii2-cdek 通过 Composer 的引入，解决了我们在 CDEK 物流 API 集成中遇到的性能和配置问题。它不仅提高了我们的开发效率，还确保了系统的稳定运行。如果你也在面对类似的挑战，不妨尝试使用这个库来简化你的工作流程。
