Rangka kerja PHP biasa untuk membina API RESTFUL termasuk Laravel, Lumen, dan Slim. 1. Pilih rangka kerja berdasarkan saiz projek. Sebagai contoh, Laravel sesuai untuk projek sederhana dan besar, Lumen adalah rangka kerja ringan dan berprestasi tinggi, dan Slim lebih sesuai untuk projek-projek kecil. 2. Tentukan struktur penghalaan yang mematuhi semantik sumber, seperti GET /pengguna untuk mendapatkan semua pengguna, dan mendapatkan /pengguna /1 untuk mendapatkan pengguna yang ditentukan. 3. Gunakan pengawal untuk memproses logik untuk memastikan kod itu kemas dan menentukan laluan melalui laluan :: Apiresource atau pendaftaran manual. 4. Unified mengembalikan format tindak balas JSON, termasuk kod status, mesej dan badan data, dan meningkatkan konsistensi antara muka. 5. Tambah pengesahan seperti JWT atau Laravel sanctum untuk memastikan keselamatan API. 6. Mengendalikan kesilapan pengecualian secara global untuk mengelakkan secara langsung mendedahkan maklumat ralat asal kepada pelanggan, dengan itu meningkatkan keteguhan sistem dan pengalaman pengguna.

Sudah tentu, membina API Restful adalah keperluan yang sangat biasa dalam pembangunan web moden. Sebagai bahasa backend lama, PHP mempunyai banyak kerangka matang untuk membantu anda menyelesaikan tugas ini dengan cekap. Berikut adalah beberapa rangka kerja PHP yang biasa dan cadangan operasi khusus.

1. Pilih rangka kerja PHP yang betul

Pada masa ini, rangka kerja PHP arus perdana seperti Laravel, Slim dan Lumen sangat sesuai untuk membangunkan API yang tenang.

• Laravel mempunyai fungsi yang komprehensif dan sesuai untuk projek sederhana dan besar. Ia dilengkapi dengan Orm, routing, middleware, dll.
• Lumen adalah versi mikro Laravel, ringan tetapi masih kuat, sesuai untuk senario API berprestasi tinggi.
• Slim lebih ringan dan lebih fleksibel, sesuai untuk projek kecil atau senario dengan keperluan prestasi tinggi.

Anda boleh memilih rangka kerja yang paling sesuai berdasarkan saiz projek dan timbunan teknologi.

2. Tentukan struktur penghalaan yang jelas

Salah satu teras API RESTful ialah reka bentuk URL mesti mematuhi prinsip semantik sumber. Contohnya:

 Dapatkan /Pengguna -> Dapatkan Semua Pengguna Dapatkan /Pengguna /1 -> Dapatkan Pos /Pengguna dengan ID 1 -> Buat Pengguna Baru Put /Pengguna /1 -> Kemas kini Maklumat Pengguna Padam /Pengguna /1 -> Padam Pengguna

Di Laravel, anda boleh menggunakan Route::resource() untuk dengan cepat menentukan penghalaan sumber. Dalam Slim atau Lumen, anda perlu mendaftarkan secara manual setiap kaedah dan laluan HTTP.

3. Gunakan pengawal untuk memproses logik dan pastikan kod bersih

Letakkan logik perniagaan API ke dalam pengawal dan bukannya menulis terus ke dalam penghala, yang menjadikannya lebih mudah untuk mengekalkan dan menguji.

Ambil Laravel sebagai contoh:

 // Laluan/Api.php
Route :: ApireSource ('Pengguna', UserController :: Class);

// app/http/controllers/usercontroller.php
Indeks Fungsi Awam ()
{
    kembali pengguna :: semua ();
}

Pertunjukan Fungsi Awam ($ ID)
{
    Pengguna kembali :: cari ($ id);
}

Kaedah ini memisahkan permintaan dari logik pemprosesan dan memudahkan pengembangan berikutnya.

4. Mengembalikan respons JSON format bersatu

API yang baik harus mengembalikan struktur data yang konsisten. Biasanya, kod status, mesej dan badan data dimasukkan. Contohnya:

 {
  "Status": "Kejayaan",
  "Mesej": "Pengguna diambil dengan jayanya",
  "data": {
    "Id": 1,
    "Nama": "John Doe"
  }
}

Atau tindak balas ralat:

 {
  "Status": "Ralat",
  "Mesej": "Pengguna tidak dijumpai"
}

Di Laravel, anda boleh menyatukan format output dengan merangkumi kelas Response atau menggunakan middleware.

5. Tambahkan Pengesahan dan Kawalan Kebenaran

Keselamatan API adalah penting, terutamanya untuk antara muka yang terdedah secara luaran. Laravel menyediakan mekanisme pengesahan seperti sanctum dan pasport, manakala Lumen dan Slim boleh dilaksanakan melalui JWT (JSON Web Token) dan kaedah lain.

Proses asas ialah:

• Log masuk pengguna untuk mendapatkan token
• Ambil token dengan permintaan berikutnya
• Pelayan mengesahkan token dan mengenal pasti pengguna
• Tentukan sama ada anda mempunyai kebenaran untuk mengakses sumber tertentu berdasarkan peranan

6. Mengendalikan kesilapan dan pengecualian

Jangan biarkan pengecualian yang tidak diketahui dikembalikan terus kepada pelanggan. Anda boleh menyediakan pengendali pengecualian global dalam rangka kerja untuk memintas ralat pangkalan data, kegagalan sumber, dan lain -lain, dan mengembalikan maklumat yang mesra.

Di Laravel, anda boleh mengubah fail App/Exceptions/Handler.php untuk menyesuaikan logik pengendalian pengecualian.

Pada dasarnya itu sahaja. Walaupun kaedah pelaksanaan spesifik rangka kerja yang berbeza sedikit berbeza, idea keseluruhan adalah sama: reka bentuk penghalaan yang baik, mengatur logik, menyatukan format tindak balas, dan memastikan keselamatan dan penyelenggaraan.

Atas ialah kandungan terperinci Bagaimana Membina API RESTful Menggunakan Rangka Kerja PHP?. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!