コアポイント

• 抽象化レイヤーを使用して、複數(shù)のトランスポートAPI（UPS、FedEx、USPS）をeコマースプラットフォームに統(tǒng)合し、さまざまな輸送操作に統(tǒng)一されたインターフェイスを提供します。
• 最初に配送プロバイダーアカウントを設(shè)定し、必要なAPIキーとドキュメントを取得して、配送プロバイダーのガイドラインと手順を確実に遵守します。
• コードに標(biāo)準(zhǔn)化されたオブジェクトクラス（出荷とパッケージ）を介して商品と小包を定義および管理するため、さまざまな輸送パラメーターと要件の処理が簡(jiǎn)素化されます。
• Shipperプラグインを?qū)g裝して特定の配送APIと対話するため、コアアプリケーションコードを変更せずに料金と出荷タグが取得されます。
• エラーを冷靜にトレーニングし、抽象化レイヤーを保護(hù)して機(jī)密データを保護(hù)し、eコマースプラットフォームが信頼できる安全な配送オプションを顧客に提供するようにします。

新しいカスタムeコマースストアはほぼ完成しています。殘っている唯一のことは、顧客の送料を計(jì)算する方法を理解することです。一部の顧客に請(qǐng)求しすぎて、さらに重要なことには他の料金が低すぎることを知っているため、各住所に標(biāo)準(zhǔn)の定額料金を使用したくありません。アイテムの重量/サイズと目的地に基づいて送料を計(jì)算できる場(chǎng)合、それは素晴らしいことではないでしょうか？たぶん、あなたは一晩の配達(dá)のために正確な価格の見(jiàn)積もりを提供することさえできます！ UPSアカウントがあり、APIをチェックしましたが、非常に複雑に見(jiàn)えます。 WebサイトをハードコードしてAPIを使用する場(chǎng)合は、荷送人を変更する必要がある場(chǎng)合は、多くの作業(yè)を行う必要があります。あなたのいとこはFedExの営業(yè)擔(dān)當(dāng)者であり、彼はFedExでより良い料金を得ることができると誓います。一部の顧客はPOボックスのみを使用しているため、これらのアイテムは郵便局を介して出荷する必要があります。何をすべきですか？データベースの抽象化について聞いたことがあるかもしれません。これは、多くの異なるデータベースと共通のコマンドセットを使用できるプラクティスです。これはまさにここでできることです！これらの問(wèn)題をすべて解決するために、トランスポートタスクを殘りのコードから分離し、抽象化レイヤーを構(gòu)築できます。完了したら、UPS、FedEx、またはUSPSを介してパッケージを出荷するかどうかは関係ありません。コアアプリケーションが呼び出す関數(shù)はまったく同じであり、これによりあなたの人生がはるかに楽になります！

upsは開(kāi)始

この記事では、UPS APIの使用に焦點(diǎn)を當(dāng)てますが、さまざまなシッパー（FedExやUSPSなど）のプラグインを作成することで、サービスにアクセスすることもできます。また、コアアプリケーションコードの変更は無(wú)視できますカウント。 UPSを開(kāi)始するには、既存のShipper番號(hào)を使用してwww.ups.comでオンラインアカウントを登録する必要があります。 APIは通話ごとに両方を必要とするため、しばらく使用するユーザー名とパスワードを必ず選択してください。次に、

http://m.miracleart.cn/link/ebd74b9b3bfd11deb539e4242d95078bにアクセスし、登録してUPS APIにアクセスします。ここでは、APIキーを取得し、さまざまなAPIパッケージのドキュメントをダウンロードできます。 （注：UPS Webサイトのこのセクションには既知の問(wèn)題があり、Chromeは空白ページを返すことがあります。別のブラウザを使用する必要がある場(chǎng)合があります。）UPS API（または配送API）を使用する場(chǎng)合、あなたは覚えておいてください。彼らの規(guī)則と手順を順守することに同意します。特に生産環(huán)境にコードを使用する前に、必ずそれらを確認(rèn)して従ってください。指示に従ってください。次に、github.com/alexfraundorf-com/shipからgithub.com/alexfraundorf-com/shipから配送抽象化レイヤーパッケージをダウンロードまたはクローンし、それをPHP 5.3以降を?qū)g行しているサーバーにアップロードします。 include/config.phpファイルを開(kāi)きます。ここにUPSの詳細(xì)を入力する必要があり、フィールド名は自明である必要があります。 UPSシッパーアドレスは、UPSアカウントに記録されたアドレスと一致する必要があることに注意してください。そうしないと、エラーが発生します。

商品と區(qū)畫(huà)を定義します

出荷オブジェクトを定義します。インスタンス化すると、受信者情報(bào)を含む配列を受け入れ、構(gòu)成ファイルの荷主情報(bào)とは異なる場(chǎng)合は、配送先住所を選択できます。

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

次に、出荷しているものについての詳細(xì)が必要です。重量、パッケージサイズ、説明、署名が必要かどうか、保険金額などのいくつかの基本的なオプションを受け入れるパッケージオブジェクトを作成しましょう。次に、新しくインスタンス化されたパッケージを出荷オブジェクトに追加します。生命をシミュレートするソフトウェアは理にかなっています。各小包は貨物に屬し、各貨物には少なくとも1つの小包が含まれている必要があります。

// 創(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)容は、元のテキストの「カーテンの背後」の章の単純化と書(shū)き換えであり、冗長(zhǎng)な情報(bào)の重複を回避し、主要な情報(bào)の完全性を維持することを避けています）

出荷オブジェクトの詳細(xì)：オブジェクトのオブジェクトは、受信者情報(bào)（およびオプションの荷送人情報(bào)）を保存し、パッケージを管理するAwsp/Ship/Shipment.phpおよびShipmentメソッドを含みます。 addPackage() getPackages()

パッケージオブジェクトの詳細(xì)：

オブジェクトのオブジェクトは、パッケージの重み、サイズ、オプションのパラメーターを保存し、寸法を長(zhǎng)さ、幅、高さで自動(dòng)的に並べ替え、パッケージサイズ（長(zhǎng)さ、境界）を計(jì)算します。 。

Shipmanプラグイン：プラグイン（例えばShipUps）は、ShipperInterfaceインターフェイスを?qū)g裝し、統(tǒng)一されたgetRate()（貨物を取得）およびcreateLabel()（タグの作成）メソッドを提供します。

出荷の取得：$ups->getRate()を呼び出して送料を取得し、try/catchブロックを使用してエラーを処理します。結(jié)果は、各配送オプションのステータスと詳細(xì)が含まれているRateResponseオブジェクトとして返されます。

配送タグを作成します：コール$ups->createLabel()配送タグを作成すると、結(jié)果はステータス、総コスト、追跡番號(hào)、およびベース64-を含むLabelResponseオブジェクトとして返されます。エンコードされたタグ畫(huà)像。

rateresponseオブジェクトの詳細(xì)な説明：Awsp/Ship/RateResponse.phpオブジェクトは、ステータス、サービスオプション配列などを含む標(biāo)準(zhǔn)化された形式で貨物データを保存します。 RateResponse

labelResponseオブジェクトの詳細(xì)な説明：オブジェクトは、ステータス、総コスト、ラベル配列などを含む標(biāo)準(zhǔn)化された形式でラベルデータを保存します。 Awsp/Ship/LabelResponse.php UPS出荷裝置プラグインの詳細(xì)な説明：LabelResponse

標(biāo)準(zhǔn)化された

およびオブジェクトをUPS APIで理解できるフォーマットに変換し、SOAP APIと通信し、応答をに変換します。標(biāo)準(zhǔn)化されたまたはAwsp/Ship/Ups.phpオブジェクト。 Package ShipmentRateResponse概要：LabelResponse

（元のFAQの部分は合理化されており、コア情報(bào)を保持し、重複を回避します）

FAQ（FAQ）

抽象輸送APIの目的は何ですか？ さまざまな輸送サービスを単一のアプリケーションに統(tǒng)合し、統(tǒng)一されたインターフェイスを提供し、複雑さを減らすプロセスを簡(jiǎn)素化します。

抽象輸送APIはあなたのビジネスにどのように利益をもたらしますか？ 複數(shù)の配送オプションをシームレスに統(tǒng)合して、顧客満足度を向上させ、操作を簡(jiǎn)素化し、プロセスを自動(dòng)化し、エラーを削減します。

抽象輸送APIの課題は何ですか？ 異なるAPIの構(gòu)造的、機(jī)能的、ドキュメントの違いは、柔軟で強(qiáng)力な抽象化レイヤーを必要とし、API更新に対処するために継続的なメンテナンスが必要です。

抽象輸送APIのエラーを処理する方法は？ 堅(jiān)牢なエラー処理メカニズムを?qū)g裝し、API応答を検証し、例外をキャッチし、意味のあるエラーメッセージを提供します。

サードパーティライブラリを使用して配送APIを抽象化できますか？ はい。ただし、特定のニーズが満たされ、積極的に維持されるように慎重に評(píng)価する必要があります。

抽象化レイヤーをテストする方法は？ ユニットテストと統(tǒng)合テストを作成し、モックAPIを使用してテストします。

抽象輸送APIでのレート制限にどのように対処するか？ 要求の再試行や要求レートの削減など、レート制限を処理するメカニズムを?qū)g裝します。

抽象的なレイヤーを保護(hù)する方法は？ 機(jī)密データの暗號(hào)化、安全な通信プロトコルを使用したセキュリティ対策、およびセキュリティの脆弱性を修正するための定期的な更新などのセキュリティ対策を?qū)g裝します。

抽象輸送APIでバージョンコントロールを処理する方法は？ バージョン固有のエンドポイントやパラメーターを使用するなど、さまざまなAPIバージョンを処理するための抽象化レイヤーを設(shè)計(jì)します。

抽象化レイヤーを配送APIの変更と同期させる方法は？ 配送APIの変更を定期的に監(jiān)視し、APIの更新を購(gòu)読し、更新をすばやくテストおよび展開(kāi)します。

以上がPHPマスター| APIの配送を抽象化しますの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國(guó)語(yǔ) Web サイトの他の関連記事を參照してください。