شرح صفوف ومحتوى الفقرة
لا تُرجع الواجهات البرمجية الاحترافية الرمز 200 OK عند حدوث خطأ؛ بل تستخدم دالة http_response_code($code) لإرسال رمز الحالة الدقيق المعبر عن النتيجة.
- استخدم الرمز
200 OKلنجاح الجلب أو التحديث، والرمز201 Createdعند نجاح إنشاء سجل جديد في قاعدة البيانات. - استخدم
400لخطأ صياغة الطلب، و401لعدم تسجيل الدخول، و403لنقص الصلاحيات، و404لعدم وجود السجل. - استخدم الرمز
422 Unprocessable Contentعندما تكون صياغة JSON سليمة لكن قيم الحقول تخالف شروط التحقق.
يضبط استدعاء http_response_code(201) حالة الاستجابة إلى 201 Created، بينما يُرجع استدعاؤها بدون معاملات الرقم المضبوط حالياً.
PHP
<?php
function respondCreated(array $record): string {
http_response_code(201);
return json_encode([
'ok' => true,
'code' => http_response_code(),
'data' => $record,
]);
}
echo respondCreated(['id' => 91, 'slug' => 'php-rest-json-endpoints']) . "\n";