Memanfaatkan $ _post untuk penciptaan sumber dalam API PHP RESTFul

Untuk membina API PHP yang mantap, jangan bergantung semata-mata pada $ _post, kerana ia hanya populasi dengan data yang dikodkan bentuk dan bukan JSON; 2. Semak tajuk jenis kandungan untuk menentukan sama ada input adalah JSON, kemudian baca php: // input dan ekodkannya menggunakan json_decode; 3. Jika jenis kandungan bukan JSON, kembali ke $ _post untuk data yang dikodkan bentuk; 4. Mengesahkan bidang yang diperlukan seperti nama dan e -mel, mengembalikan ralat 400 jika hilang; 5. Gunakan kenyataan yang disediakan dengan PDO untuk memasukkan data dengan selamat ke dalam pangkalan data; 6. Pada kejayaan, kembalikan status 201 yang dibuat dengan sumber baru dan jenis kandungan: aplikasi/header JSON; 7. Sentiasa sanitasi dan sahkan input, menyokong kod status HTTP yang betul, dan gunakan HTTPS untuk memastikan tingkah laku API yang patuh dengan piawaian yang selamat.

Apabila membina API PHP yang tenang, memanfaatkan $_POST untuk penciptaan sumber sejajar dengan amalan HTTP standard -khususnya, menggunakan kaedah POST untuk membuat sumber baru di pelayan. Walaupun $_POST mudah untuk mengendalikan data yang dikodkan borang, API REST yang mantap juga harus menyokong input JSON, yang lebih biasa dalam interaksi API moden. Berikut adalah cara untuk menggunakan $_POST dengan berkesan dan mengendalikan data permintaan dengan betul apabila membuat sumber.

Memahami bila menggunakan $_POST

Dalam konteks yang tenang:

• POST /users mencipta pengguna baru.
• Badan permintaan mengandungi data yang diperlukan untuk mencipta sumber.
• $_POST dalam PHP secara automatik memaparkan data yang dihantar dengan Content-Type: application/x-www-form-urlencoded , tetapi bukan untuk application/json .

Ini adalah titik kritikal: jika API anda menerima JSON (yang paling banyak dilakukan), $_POST akan kosong kecuali anda menghuraikan input mentah secara manual.

Mengendalikan input JSON bersama $_POST

Untuk menyokong kedua -dua borang data dan JSON, anda perlu membaca php://input dan menyahkodnya apabila sesuai:

 $ data = [];

// semak jenis kandungan
$ contentType = $ _server ['content_type'] ?? $ _Server ['http_content_type'] ?? '';

jika (strpos ($ contentType, 'aplikasi/json')! == false) {
    $ json = file_get_contents ('php: // input');
    $ data = json_decode ($ json, true);

    // Mengendalikan kesilapan json parse
    jika (json_last_error ()! == json_error_none) {
        http_response_code (400);
        echo json_encode (['error' => 'tidak sah json']);
        keluar;
    }
} else {
    // sandaran ke $ _post untuk data yang dikodkan borang
    $ data = $ _post;
}

Sekarang $data mengandungi input tanpa mengira format.

Mengesahkan dan mewujudkan sumber

Sebaik sahaja anda mempunyai data, sahkan medan yang diperlukan sebelum mencipta sumber:

 jika (kosong ($ data ['nama']) || kosong ($ data ['e -mel'])) {
    http_response_code (400);
    echo json_encode (['error' => 'nama dan e -mel diperlukan']);
    keluar;
}

// Contoh: masukkan ke pangkalan data
$ stmt = $ pdo-> siapkan ("masukkan ke pengguna (nama, e-mel) nilai (?,?)");
$ result = $ stmt-> Execute ([$ data ['name'], $ data ['e-mel']]);

jika ($ hasil) {
    $ id = $ pdo-> lastInserTid ();
    http_response_code (201);
    echo json_encode ([
        'id' => $ id,
        'nama' => $ data ['nama'],
        'e -mel' => $ data ['e -mel'],
        'Mesej' => 'Pengguna berjaya'
    ]);
} else {
    http_response_code (500);
    echo json_encode (['error' => 'gagal membuat pengguna']);
}

Amalan terbaik untuk reka bentuk yang tenang

• Gunakan kod status HTTP dengan betul :
  • 201 Created untuk penciptaan yang berjaya.
  • 400 Bad Request untuk input tidak sah.
  • 415 Unsupported Media Type jika jenis kandungan tidak disokong.
• Tetapkan tajuk tindak balas :

   header ('Kandungan-jenis: Aplikasi/JSON');

• Elakkan bergantung semata -mata pada $_POST -Selapa mempertimbangkan muatan JSON.
• Sanitize dan sahkan semua input -never Data klien amanah.
• Gunakan HTTPS untuk melindungi data sensitif semasa penghantaran.

Ringkasan

Walaupun $_POST berfungsi untuk penyerahan borang, API PHP RESTful yang betul mesti mengendalikan JSON melalui php://input . Dengan mengesan Content-Type , menghuraikan dengan sewajarnya, mengesahkan input, dan menggunakan semantik HTTP yang betul, anda boleh membuat sumber daya dengan cara yang selamat dan patuh.

Pada asasnya, jangan menganggap $_POST mempunyai data anda -eksplisit mengendalikan badan permintaan berdasarkan format yang masuk. Itulah kunci API yang fleksibel dan mantap.

Atas ialah kandungan terperinci Memanfaatkan $ _post untuk penciptaan sumber dalam API PHP RESTFul. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!