PHP主|抽象運輸API

核心要點

• 使用抽象層將多個運輸 API（UPS、FedEx、USPS）集成到您的電子商務平台中，從而為各種運輸操作提供統一的接口。
• 首先設置發貨人帳戶並獲取必要的 API 密鑰和文檔，確保符合發貨人的準則和程序。
• 通過代碼中標準化的對像類（Shipment 和 Package）定義和管理貨物和包裹，這簡化了不同運輸參數和要求的處理。
• 實現發貨人插件以與特定的運輸 API 交互，從而無需更改核心應用程序代碼即可獲取費率和創建運輸標籤。
• 從容地處理錯誤並保護抽象層以保護敏感數據，確保您的電子商務平台為客戶提供可靠且安全的運輸選項。

您新的定制電子商務商店幾乎完成了。剩下的唯一事情是弄清楚如何計算客戶的運費。您不想對每個地址都使用標準的固定費率，因為您知道您會向某些客戶收取過高的費用，更重要的是，會向其他客戶收取過低的費用。如果運費可以根據商品的重量/尺寸和目的地來計算，那不是很棒嗎？也許您甚至可以提供隔夜送貨的準確價格報價！您有 UPS 帳戶，並且您已經查看了他們的 API，但它看起來非常複雜。如果您將您的網站硬編碼為使用 API，那麼如果您需要更改發貨人，您將需要做很多工作。您的表哥是 FedEx 的銷售代表，他發誓他可以用 FedEx 為您獲得更好的費率。您的一些客戶只使用郵政信箱，因此這些物品必須通過郵局運送。您該怎麼辦？您可能聽說過數據庫抽象，這是一種允許您使用許多不同的數據庫和一組通用命令的實踐。這正是您在這裡可以做的！為了解決所有這些問題，您可以將運輸任務與代碼的其餘部分分離，並構建一個抽象層。完成後，無論您是通過 UPS、FedEx 還是 USPS 運送包裹，都無關緊要。您的核心應用程序將調用的函數將完全相同，這將使您的生活輕鬆得多！

UPS 入門

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

定義貨物和包裹

現在定義一個 Shipment 對象。在實例化時，它將接受一個包含接收者信息的數組，如果與我們配置文件中的發貨人信息不同，則可以選擇一個發貨地址。

// 创建一个 Shipment 对象
$shipment = new ShipShipment($shipmentData);

接下來，我們需要一些關於我們正在運輸什麼的詳細信息。讓我們創建一個 Package 對象，它接受重量、包裹尺寸和一些基本選項的可選數組，例如說明、是否需要簽名以及保險金額。然後將新實例化的 Package(s) 添加到 Shipment 對像中。模擬生活的軟件很有意義：每個包裹都屬於一個貨物，每個貨物都必須至少包含一個包裹。

// 创建一个 Package 对象并将其添加到 Shipment（一个货物可以有多个包裹）

// 此包裹重 24 磅，尺寸为 10 x 6 x 12 英寸，保险价值为 274.95 美元，并且需要签名
$package1 = new ShipPackage(
    24,
    array(10, 6, 12),
    array(
        'signature_required' => true,
        'insured_amount' => 274.95
    )
);
$shipment->addPackage($package1);

// 重量和尺寸可以是整数或浮点数，
// 尽管 UPS 总是向上舍入到下一个整数。
// 此包裹重 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);

(以下內容是對原文中“Behind the Curtain”章節的精簡和改寫，避免重複冗餘信息，並保持關鍵信息的完整性)

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

Package 對象詳解: Awsp/Ship/Package.php 中的Package 對象存儲包裹重量、尺寸和可選參數，自動將尺寸按長寬高排序，併計算包裹尺寸（長周長） 。

發貨人插件: 插件（例如 ShipUps）實現 ShipperInterface 接口，提供統一的 getRate()（獲取運費）和 createLabel()（創建標籤）方法。

獲取運費: 通過調用 $ups->getRate() 獲取運費，並使用 try/catch 塊處理錯誤。結果以 RateResponse 對象返回，包含狀態和各個運輸選項的詳細信息。

創建運輸標籤: 調用 $ups->createLabel() 創建運輸標籤，結果以 LabelResponse 對象返回，包含狀態、總成本、跟踪號碼和 base-64 編碼的標籤圖像。

RateResponse 對象詳解: Awsp/Ship/RateResponse.php 中的 RateResponse 對像以標準化格式存儲運費數據，包含狀態、服務選項數組等。

LabelResponse 對象詳解: Awsp/Ship/LabelResponse.php 中的 LabelResponse 對像以標準化格式存儲標籤數據，包含狀態、總成本、標籤數組等。

UPS 發貨人插件詳解: Awsp/Ship/Ups.php 將標準化的Package 和Shipment 對象轉換為UPS API 可理解的格式，使用SOAP API 進行通信，並將響應轉換為標準化的RateResponse 或LabelResponse 對象。

總結: 通過抽象層，您可以輕鬆地使用 UPS API 或其他發貨人的 API，簡化了與不同 API 的交互，並降低了維護成本。 如果需要集成 USPS，建議使用 stamps.com 等經 USPS 批准的供應商，而不是直接使用 USPS 官方 API。

(原文FAQs部分已精簡，保留核心信息，避免重複)

常見問題 (FAQs)

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

以上是PHP主|抽象運輸API的詳細內容。更多資訊請關注PHP中文網其他相關文章！