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