搜尋
首頁後端開發php教程PHP主|抽象運輸API

PHP Master | Abstracting Shipping APIs

核心要點

  • 使用抽象層將多個運輸 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 將標準化的PackageShipment 對象轉換為UPS API 可理解的格式,使用SOAP API 進行通信,並將響應轉換為標準化的RateResponseLabelResponse 對象。

總結: 通過抽象層,您可以輕鬆地使用 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中文網其他相關文章!

陳述
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
您如何在PHP中創建和使用接口?您如何在PHP中創建和使用接口?Apr 30, 2025 pm 03:40 PM

本文解釋瞭如何創建,實施和使用PHP中的接口,重點關注其對代碼組織和可維護性的好處。

crypt()和password_hash()有什麼區別?crypt()和password_hash()有什麼區別?Apr 30, 2025 pm 03:39 PM

本文討論了PHP中的crypt()和password_hash()的差異,以進行密碼哈希,重點介紹其實施,安全性和對現代Web應用程序的適用性。

如何防止PHP中的跨站點腳本(XSS)?如何防止PHP中的跨站點腳本(XSS)?Apr 30, 2025 pm 03:38 PM

文章討論了通過輸入驗證,輸出編碼以及使用OWASP ESAPI和HTML淨化器之類的工具來防止PHP中的跨站點腳本(XSS)。

PHP中的自動加載是什麼?PHP中的自動加載是什麼?Apr 30, 2025 pm 03:37 PM

自動加載PHP會在需要時自動加載類文件,從而通過減少內存使用和增強代碼組織來提高性能。最佳實踐包括使用PSR-4和有效組織代碼。

什麼是PHP流?什麼是PHP流?Apr 30, 2025 pm 03:36 PM

PHP流通過一致的API來統一資源諸如文件,網絡插座和壓縮格式之類的處理,從而使復雜性抽象並增強代碼靈活性和效率。

可以使用PHP上傳的文件的最大大小是多少?可以使用PHP上傳的文件的最大大小是多少?Apr 30, 2025 pm 03:35 PM

本文討論了在PHP中管理文件上傳大小的管理,重點是2MB的默認限制以及如何通過修改PHP.INI設置來增加它。

PHP中的無效類型是什麼?PHP中的無效類型是什麼?Apr 30, 2025 pm 03:34 PM

本文討論了PHP 7.1中引入的PHP中的無效類型,允許變量或參數為指定類型或NULL。它突出顯示了諸如提高可讀性,類型安全性和明確意圖的好處,並解釋瞭如何聲明

unset()和unlink()函數之間有什麼區別?unset()和unlink()函數之間有什麼區別?Apr 30, 2025 pm 03:33 PM

本文討論了unset()和unlink()功能在編程中的差異,重點關注其目的和用例。 unset()從內存中刪除變量,而unlink()從文件系統中刪除文件。兩者都對效率至關重要

See all articles

熱AI工具

Undresser.AI Undress

Undresser.AI Undress

人工智慧驅動的應用程序,用於創建逼真的裸體照片

AI Clothes Remover

AI Clothes Remover

用於從照片中去除衣服的線上人工智慧工具。

Undress AI Tool

Undress AI Tool

免費脫衣圖片

Clothoff.io

Clothoff.io

AI脫衣器

Video Face Swap

Video Face Swap

使用我們完全免費的人工智慧換臉工具,輕鬆在任何影片中換臉!

熱工具

SublimeText3 Linux新版

SublimeText3 Linux新版

SublimeText3 Linux最新版

VSCode Windows 64位元 下載

VSCode Windows 64位元 下載

微軟推出的免費、功能強大的一款IDE編輯器

Dreamweaver CS6

Dreamweaver CS6

視覺化網頁開發工具

Dreamweaver Mac版

Dreamweaver Mac版

視覺化網頁開發工具

WebStorm Mac版

WebStorm Mac版

好用的JavaScript開發工具