PHP Master | API Penghantaran Abstrak

mata teras

Gunakan lapisan abstraksi untuk mengintegrasikan pelbagai API pengangkutan (UPS, FedEx, USPS) ke dalam platform e-dagang anda, menyediakan antara muka bersatu untuk pelbagai operasi pengangkutan.
Mula -mula menubuhkan akaun Penyedia Perkapalan dan dapatkan kunci dan dokumentasi API yang diperlukan untuk memastikan pematuhan garis panduan dan prosedur pembekal penghantaran.
mentakrifkan dan menguruskan barang dan bungkusan melalui kelas objek (penghantaran dan pakej) yang diseragamkan dalam kod, yang memudahkan pengendalian parameter dan keperluan pengangkutan yang berlainan.
Melaksanakan pemalam pengirim untuk berinteraksi dengan API penghantaran tertentu, supaya kadar dan tag penghantaran diperoleh tanpa mengubah kod aplikasi teras.
Kesalahan kereta api dengan tenang dan melindungi lapisan abstraksi untuk melindungi data sensitif, memastikan platform e-dagang anda menyediakan pelanggan dengan pilihan penghantaran yang boleh dipercayai dan selamat.

kedai e-dagang adat baru anda hampir selesai. Satu -satunya perkara yang tersisa adalah memikirkan cara mengira yuran penghantaran pelanggan. Anda tidak mahu menggunakan kadar rata standard untuk setiap alamat kerana anda tahu anda akan mengenakan bayaran terlalu banyak pelanggan dan, lebih penting lagi, yuran terlalu rendah untuk orang lain. Bukankah lebih baik jika kos penghantaran dapat dikira berdasarkan berat/saiz dan destinasi item tersebut? Mungkin anda juga boleh menawarkan petikan harga yang tepat untuk penghantaran semalaman! Anda mempunyai akaun UPS dan anda telah memeriksa API mereka, tetapi ia kelihatan sangat rumit. Jika anda menghidupkan kod laman web anda untuk menggunakan API, anda perlu melakukan banyak kerja jika anda perlu menukar pengirim. Sepupu anda adalah wakil jualan untuk FedEx dan dia bersumpah dia boleh mendapatkan kadar yang lebih baik untuk anda dengan FedEx. Sesetengah pelanggan anda hanya menggunakan kotak PO, jadi barang -barang ini mesti dihantar melalui pejabat pos. Apa yang harus anda buat? Anda mungkin pernah mendengar abstraksi pangkalan data, amalan yang membolehkan anda menggunakan banyak pangkalan data yang berbeza dan satu set arahan biasa. Inilah yang boleh anda lakukan di sini! Untuk menyelesaikan semua masalah ini, anda boleh memisahkan tugas pengangkutan dari seluruh kod dan membina lapisan abstraksi. Setelah selesai, tidak kira sama ada anda menghantar pakej anda melalui UPS, FedEx atau USPS. Fungsi aplikasi teras anda akan dipanggil akan sama, yang akan menjadikan hidup anda lebih mudah!

ups bermula

Dalam artikel ini, saya akan memberi tumpuan kepada menggunakan API UPS, tetapi dengan menulis plugin untuk pengirim yang berbeza (seperti FedEx atau USPS), anda juga boleh mengakses perkhidmatan mereka, dan perubahan kepada kod aplikasi teras boleh diabaikan Jangan hitung. Untuk memulakan UPS, anda perlu mendaftarkan akaun dalam talian di www.ups.com menggunakan nombor pengirim sedia ada anda. Pastikan untuk memilih nama pengguna dan kata laluan yang anda bersedia gunakan untuk seketika, kerana API memerlukan kedua -duanya untuk setiap panggilan. Seterusnya, lawati https://www.php.cn/link/ebd74b9b3bfd11deb539e4242d95078b dan daftar untuk mengakses API UPS. Di sini anda akan mendapat kunci API anda dan dapat memuat turun dokumentasi untuk pakej API yang berbeza. (Nota: Terdapat masalah yang diketahui dengan bahagian laman web UPS ini, dan Chrome kadang -kadang mengembalikan halaman kosong. Anda mungkin perlu menggunakan penyemak imbas yang berbeza.) Ingatlah bahawa apabila anda menggunakan API UPS (atau mana -mana API penghantaran), anda Setuju untuk mematuhi peraturan dan prosedur mereka. Pastikan untuk mengkaji dan mematuhi mereka, terutamanya sebelum menggunakan kod anda untuk persekitaran pengeluaran, ikuti arahan mereka. Seterusnya, muat turun atau klon pakej lapisan abstraksi perkapalan dari github.com/alexfraundorf-com/ship pada github dan muat naik ke pelayan yang menjalankan Php 5.3 atau lebih baru. Buka fail termasuk/config.php. Anda perlu memasukkan butiran UPS anda di sini, dan nama lapangan harus jelas. Sila ambil perhatian bahawa alamat pengirim UPS mesti sepadan dengan alamat yang direkodkan dalam akaun UPS, jika tidak, ralat akan berlaku.

Tentukan barang dan bungkusan

Sekarang tentukan objek penghantaran. Pada instantiasi, ia akan menerima array yang mengandungi maklumat penerima, dan jika ia berbeza daripada maklumat pengirim dalam fail konfigurasi kami, anda boleh memilih alamat penghantaran.

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

Seterusnya, kita memerlukan beberapa butiran mengenai apa yang kita perkapalan. Mari buat objek pakej yang menerima array pilihan berat, saiz pakej, dan beberapa pilihan asas seperti keterangan, sama ada tandatangan diperlukan, dan jumlah insurans. Kemudian tambahkan pakej yang baru diterapkan ke objek penghantaran. Perisian yang mensimulasikan kehidupan masuk akal: setiap bungkusan milik kargo, dan setiap kargo mesti mengandungi sekurang -kurangnya satu bungkusan.

// 创建一个 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);

(Kandungan berikut adalah penyederhanaan dan penulisan semula bab "Behind the Curtain" dalam teks asal, mengelakkan pertindihan maklumat yang berlebihan dan mengekalkan integriti maklumat utama)

Butiran Objek Penghantaran:

objek dalam menyimpan maklumat penerima (dan maklumat pengirim pilihan) dan termasuk kaedah Awsp/Ship/Shipment.php dan Shipment untuk menguruskan pakej. addPackage() Butiran Objek Pakej Butiran Objek: getPackages() Objek dalam

menyimpan berat pakej, saiz dan parameter pilihan, secara automatik menyusun dimensi dengan panjang, lebar dan ketinggian, dan mengira saiz pakej (panjang, perimeter) .

Plugin Shipman Plugin:

Plugin (mis. ) melaksanakan antara muka , menyediakan kaedah bersatu ShipUps (mendapatkan barang) dan ShipperInterface (membuat tag). getRate() createLabel()

Dapatkan penghantaran:

Dapatkan penghantaran dengan memanggil dan gunakan blok untuk mengendalikan ralat. Hasilnya dikembalikan sebagai objek $ups->getRate(), yang mengandungi status dan butiran setiap pilihan penghantaran. try/catch RateResponse

Buat tag penghantaran:

Panggil Buat tag penghantaran, dan hasilnya dikembalikan sebagai objek , yang mengandungi status, jumlah kos, nombor penjejakan, dan asas-64- Imej tag yang dikodkan. $ups->createLabel() LabelResponse

Penjelasan terperinci mengenai objek Rateresponse:

objek dalam menyimpan data barang dalam format piawai, termasuk status, tatasusunan pilihan perkhidmatan, dll. Awsp/Ship/RateResponse.php RateResponse

Penjelasan terperinci Objek LabelResponse:

objek dalam menyimpan data label dalam format piawai, termasuk status, jumlah kos, array label, dll. Awsp/Ship/LabelResponse.php LabelResponse

Penjelasan terperinci mengenai Plugin Penghantaran UPS:

Objek standard atau . Awsp/Ship/Ups.php Ringkasan: Package Dengan lapisan abstraksi, anda boleh menggunakan API UPS dengan mudah atau API pengirim lain, memudahkan interaksi dengan API yang berbeza dan mengurangkan kos penyelenggaraan. Sekiranya anda perlu mengintegrasikan USPS, disarankan untuk menggunakan vendor yang diluluskan oleh USPS seperti Stamps.com dan bukannya secara langsung menggunakan API USPS rasmi. Shipment RateResponse LabelResponse (bahagian FAQ asal telah diselaraskan, mengekalkan maklumat teras dan mengelakkan pertindihan)

FAQs (FAQs)

• Apakah tujuan API Pengangkutan Abstrak? memudahkan proses mengintegrasikan pelbagai perkhidmatan pengangkutan ke dalam satu aplikasi, menyediakan antara muka bersatu dan mengurangkan kerumitan.
• Bagaimanakah API Pengangkutan Abstrak memberi manfaat kepada perniagaan anda? dengan lancar mengintegrasikan pelbagai pilihan penghantaran untuk meningkatkan kepuasan pelanggan, memudahkan operasi, mengautomasikan proses, dan mengurangkan kesilapan.
• Apakah cabaran API Pengangkutan Abstrak? Perbezaan struktur, fungsi dan dokumentasi API yang berbeza memerlukan lapisan abstraksi yang fleksibel dan berkuasa dan memerlukan penyelenggaraan berterusan untuk mengatasi kemas kini API.
• Bagaimana menangani kesilapan dalam API Pengangkutan Abstrak? Melaksanakan mekanisme pengendalian ralat yang mantap, sahkan respons API, penangkapan penangkapan, dan memberikan mesej ralat yang bermakna.
• Bolehkah anda menggunakan perpustakaan pihak ketiga untuk abstrak API penghantaran? Ya, tetapi memerlukan penilaian yang teliti untuk memastikan keperluan khusus dipenuhi dan dikekalkan secara aktif.
• Bagaimana untuk menguji lapisan abstraksi? Tulis ujian unit dan ujian integrasi dan gunakan API mock untuk menguji.
• Bagaimana menangani kadar yang mengehadkan dalam API Pengangkutan Abstrak? Melaksanakan mekanisme untuk mengendalikan had kadar, seperti mencuba semula permintaan atau mengurangkan kadar permintaan.
• Bagaimana untuk melindungi lapisan abstrak? Melaksanakan langkah -langkah keselamatan seperti menyulitkan data sensitif, menggunakan protokol komunikasi yang selamat, dan kemas kini secara berkala untuk memperbaiki kelemahan keselamatan.
• Bagaimana menangani kawalan versi dalam API Pengangkutan Abstrak? Lapisan abstraksi reka bentuk untuk mengendalikan versi API yang berbeza, seperti menggunakan titik akhir atau parameter khusus versi.
• Bagaimana untuk menyimpan lapisan abstraksi selari dengan perubahan dalam API penghantaran? kerap memantau perubahan API penghantaran, melanggan kemas kini API, dan cepat menguji dan menggunakan kemas kini.

Atas ialah kandungan terperinci PHP Master | API Penghantaran Abstrak. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!