核心要點(diǎn)

• 使用抽象層將多個(gè)運(yùn)輸 API（UPS、FedEx、USPS）集成到您的電子商務(wù)平臺(tái)中，從而為各種運(yùn)輸操作提供統(tǒng)一的接口。
• 首先設(shè)置發(fā)貨人帳戶并獲取必要的 API 密鑰和文檔，確保符合發(fā)貨人的準(zhǔn)則和程序。
• 通過代碼中標(biāo)準(zhǔn)化的對(duì)象類（Shipment 和 Package）定義和管理貨物和包裹，這簡(jiǎn)化了不同運(yùn)輸參數(shù)和要求的處理。
• 實(shí)現(xiàn)發(fā)貨人插件以與特定的運(yùn)輸 API 交互，從而無需更改核心應(yīng)用程序代碼即可獲取費(fèi)率和創(chuàng)建運(yùn)輸標(biāo)簽。
• 從容地處理錯(cuò)誤并保護(hù)抽象層以保護(hù)敏感數(shù)據(jù)，確保您的電子商務(wù)平臺(tái)為客戶提供可靠且安全的運(yùn)輸選項(xiàng)。

您新的定制電子商務(wù)商店幾乎完成了。剩下的唯一事情是弄清楚如何計(jì)算客戶的運(yùn)費(fèi)。您不想對(duì)每個(gè)地址都使用標(biāo)準(zhǔn)的固定費(fèi)率，因?yàn)槟滥鷷?huì)向某些客戶收取過高的費(fèi)用，更重要的是，會(huì)向其他客戶收取過低的費(fèi)用。如果運(yùn)費(fèi)可以根據(jù)商品的重量/尺寸和目的地來計(jì)算，那不是很棒嗎？也許您甚至可以提供隔夜送貨的準(zhǔn)確價(jià)格報(bào)價(jià)！您有 UPS 帳戶，并且您已經(jīng)查看了他們的 API，但它看起來非常復(fù)雜。如果您將您的網(wǎng)站硬編碼為使用 API，那么如果您需要更改發(fā)貨人，您將需要做很多工作。您的表哥是 FedEx 的銷售代表，他發(fā)誓他可以用 FedEx 為您獲得更好的費(fèi)率。您的一些客戶只使用郵政信箱，因此這些物品必須通過郵局運(yùn)送。您該怎么辦？您可能聽說過數(shù)據(jù)庫(kù)抽象，這是一種允許您使用許多不同的數(shù)據(jù)庫(kù)和一組通用命令的實(shí)踐。這正是您在這里可以做的！為了解決所有這些問題，您可以將運(yùn)輸任務(wù)與代碼的其余部分分離，并構(gòu)建一個(gè)抽象層。完成后，無論您是通過 UPS、FedEx 還是 USPS 運(yùn)送包裹，都無關(guān)緊要。您的核心應(yīng)用程序?qū)⒄{(diào)用的函數(shù)將完全相同，這將使您的生活輕松得多！

UPS 入門

在本文中，我將重點(diǎn)介紹使用 UPS API，但是通過為不同的發(fā)貨人（例如 FedEx 或 USPS）編寫插件，您也可以訪問他們的服務(wù)，而對(duì)核心應(yīng)用程序代碼的更改可以忽略不計(jì)。為了開始使用 UPS，您需要使用您現(xiàn)有的發(fā)貨人編號(hào)在 www.ups.com 上注冊(cè)在線帳戶。確保選擇一個(gè)您愿意使用一段時(shí)間的用戶名和密碼，因?yàn)?API 每次調(diào)用都需要兩者。接下來，訪問 http://ipnx.cn/link/ebd74b9b3bfd11deb539e4242d95078b 并注冊(cè)以訪問 UPS API。您將在此處獲得您的 API 密鑰，并能夠下載不同 API 包的文檔。（注意：UPS 網(wǎng)站的這一部分存在已知問題，Chrome 有時(shí)會(huì)返回空白頁(yè)。您可能需要使用其他瀏覽器。）請(qǐng)記住，當(dāng)您使用 UPS API（或任何發(fā)貨人的 API）時(shí)，您同意遵守他們的規(guī)則和程序。請(qǐng)務(wù)必查看并遵守它們，尤其是在將您的代碼用于生產(chǎn)環(huán)境之前，請(qǐng)遵守他們的說明。接下來，從 GitHub 上的 github.com/alexfraundorf-com/ship 下載或克隆運(yùn)輸抽象層包，并將其上傳到運(yùn)行 PHP 5.3 或更高版本的服務(wù)器上。打開 includes/config.php 文件。您需要在此處輸入您的 UPS 詳細(xì)信息，字段名稱應(yīng)該都是不言自明的。請(qǐng)注意，UPS 發(fā)貨人地址必須與 UPS 帳戶中記錄的地址相符，否則會(huì)發(fā)生錯(cuò)誤。

定義貨物和包裹

現(xiàn)在定義一個(gè) Shipment 對(duì)象。在實(shí)例化時(shí)，它將接受一個(gè)包含接收者信息的數(shù)組，如果與我們配置文件中的發(fā)貨人信息不同，則可以選擇一個(gè)發(fā)貨地址。

// 創(chuàng)建一個(gè) Shipment 對(duì)象
$shipment = new ShipShipment($shipmentData);

接下來，我們需要一些關(guān)于我們正在運(yùn)輸什么的詳細(xì)信息。讓我們創(chuàng)建一個(gè) Package 對(duì)象，它接受重量、包裹尺寸和一些基本選項(xiàng)的可選數(shù)組，例如說明、是否需要簽名以及保險(xiǎn)金額。然后將新實(shí)例化的 Package(s) 添加到 Shipment 對(duì)象中。模擬生活的軟件很有意義：每個(gè)包裹都屬于一個(gè)貨物，每個(gè)貨物都必須至少包含一個(gè)包裹。

// 創(chuàng)建一個(gè) Package 對(duì)象并將其添加到 Shipment（一個(gè)貨物可以有多個(gè)包裹）

// 此包裹重 24 磅，尺寸為 10 x 6 x 12 英寸，保險(xiǎn)價(jià)值為 274.95 美元，并且需要簽名
$package1 = new ShipPackage(
    24,
    array(10, 6, 12),
    array(
        'signature_required' => true,
        'insured_amount' => 274.95
    )
);
$shipment->addPackage($package1);

// 重量和尺寸可以是整數(shù)或浮點(diǎn)數(shù)，
// 盡管 UPS 總是向上舍入到下一個(gè)整數(shù)。
// 此包裹重 11.34 磅，尺寸為
// 14.2 x 16.8 x 26.34 英寸
$package2 = new ShipPackage(
    11.34,
    array(14.2, 16.8, 26.34)
);
$shipment->addPackage($package2);

(以下內(nèi)容是對(duì)原文中“Behind the Curtain”章節(jié)的精簡(jiǎn)和改寫，避免重復(fù)冗余信息，并保持關(guān)鍵信息的完整性)

Shipment 對(duì)象詳解: Awsp/Ship/Shipment.php 中的 Shipment 對(duì)象存儲(chǔ)接收方信息（以及可選的發(fā)貨方信息），包含 addPackage() 和 getPackages() 方法管理包裹。

Package 對(duì)象詳解: Awsp/Ship/Package.php 中的 Package 對(duì)象存儲(chǔ)包裹重量、尺寸和可選參數(shù)，自動(dòng)將尺寸按長(zhǎng)寬高排序，并計(jì)算包裹尺寸（長(zhǎng) 周長(zhǎng)）。

發(fā)貨人插件: 插件（例如 ShipUps）實(shí)現(xiàn) ShipperInterface 接口，提供統(tǒng)一的 getRate()（獲取運(yùn)費(fèi)）和 createLabel()（創(chuàng)建標(biāo)簽）方法。

獲取運(yùn)費(fèi): 通過調(diào)用 $ups->getRate() 獲取運(yùn)費(fèi)，并使用 try/catch 塊處理錯(cuò)誤。結(jié)果以 RateResponse 對(duì)象返回，包含狀態(tài)和各個(gè)運(yùn)輸選項(xiàng)的詳細(xì)信息。

創(chuàng)建運(yùn)輸標(biāo)簽: 調(diào)用 $ups->createLabel() 創(chuàng)建運(yùn)輸標(biāo)簽，結(jié)果以 LabelResponse 對(duì)象返回，包含狀態(tài)、總成本、跟蹤號(hào)碼和 base-64 編碼的標(biāo)簽圖像。

RateResponse 對(duì)象詳解: Awsp/Ship/RateResponse.php 中的 RateResponse 對(duì)象以標(biāo)準(zhǔn)化格式存儲(chǔ)運(yùn)費(fèi)數(shù)據(jù)，包含狀態(tài)、服務(wù)選項(xiàng)數(shù)組等。

LabelResponse 對(duì)象詳解: Awsp/Ship/LabelResponse.php 中的 LabelResponse 對(duì)象以標(biāo)準(zhǔn)化格式存儲(chǔ)標(biāo)簽數(shù)據(jù)，包含狀態(tài)、總成本、標(biāo)簽數(shù)組等。

UPS 發(fā)貨人插件詳解: Awsp/Ship/Ups.php 將標(biāo)準(zhǔn)化的 Package 和 Shipment 對(duì)象轉(zhuǎn)換為 UPS API 可理解的格式，使用 SOAP API 進(jìn)行通信，并將響應(yīng)轉(zhuǎn)換為標(biāo)準(zhǔn)化的 RateResponse 或 LabelResponse 對(duì)象。

總結(jié): 通過抽象層，您可以輕松地使用 UPS API 或其他發(fā)貨人的 API，簡(jiǎn)化了與不同 API 的交互，并降低了維護(hù)成本。 如果需要集成 USPS，建議使用 stamps.com 等經(jīng) USPS 批準(zhǔn)的供應(yīng)商，而不是直接使用 USPS 官方 API。

(原文FAQs部分已精簡(jiǎn)，保留核心信息，避免重復(fù))

常見問題 (FAQs)

• 抽象運(yùn)輸 API 的目的是什么？ 簡(jiǎn)化將各種運(yùn)輸服務(wù)集成到單個(gè)應(yīng)用程序中的過程，提供統(tǒng)一接口，降低復(fù)雜性。
• 抽象運(yùn)輸 API 如何使企業(yè)受益？ 無縫集成多種運(yùn)輸選項(xiàng)，提高客戶滿意度，簡(jiǎn)化運(yùn)營(yíng)，自動(dòng)化流程，減少錯(cuò)誤。
• 抽象運(yùn)輸 API 的挑戰(zhàn)是什么？ 不同 API 的結(jié)構(gòu)、功能和文檔差異，需要設(shè)計(jì)靈活且強(qiáng)大的抽象層，并需要持續(xù)維護(hù)以應(yīng)對(duì) API 更新。
• 如何處理抽象運(yùn)輸 API 中的錯(cuò)誤？ 實(shí)現(xiàn)健壯的錯(cuò)誤處理機(jī)制，驗(yàn)證 API 響應(yīng)，捕獲異常，提供有意義的錯(cuò)誤消息。
• 可以使用第三方庫(kù)來抽象運(yùn)輸 API 嗎？ 可以，但需要仔細(xì)評(píng)估以確保滿足特定需求并得到積極維護(hù)。
• 如何測(cè)試抽象層？ 編寫單元測(cè)試和集成測(cè)試，并使用模擬 API 進(jìn)行測(cè)試。
• 如何處理抽象運(yùn)輸 API 中的速率限制？ 實(shí)現(xiàn)機(jī)制來處理速率限制，例如重試請(qǐng)求或降低請(qǐng)求速率。
• 如何保護(hù)抽象層？ 實(shí)施安全措施，例如加密敏感數(shù)據(jù)，使用安全通信協(xié)議，定期更新以修復(fù)安全漏洞。
• 如何處理抽象運(yùn)輸 API 中的版本控制？ 設(shè)計(jì)抽象層以處理不同 API 版本，例如使用版本特定的端點(diǎn)或參數(shù)。
• 如何使抽象層與運(yùn)輸 API 的更改保持同步？ 定期監(jiān)控運(yùn)輸 API 的更改，訂閱 API 更新，并快速測(cè)試和部署更新。

以上是PHP主|抽象運(yùn)輸API的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！