cURL وHTTP POST في PHP: دليل 2025 مع أمثلة كود

تعلم Python بسهولة دون إرهاق نظري. حل مهام عملية مع التحقق التلقائي واكتب الكود مباشرة في المتصفح.

PHP وcURL وHTTP POST في 2025: من النظرية إلى الكود العملي

تخيل أن سكريبت PHP الخاص بك يحتاج إلى إرسال بيانات إلى خادم آخر: تسجيل مستخدم في CRM، دفع طلب عبر بوابة دفع، أو ببساطة حفظ ملاحظة في API سحابي. كيف تفعل ذلك بدون متصفح، باستخدام كود خالص؟ الإجابة هي cURL. هذه المكتبة ظلت لسنوات عديدة المعيار الفعلي لطلبات HTTP في PHP، ولم يكن عام 2025 استثناءً.

سؤال «PHP, cURL, and HTTP POST example?» على Stack Overflow حصد آلاف المشاهدات، مما يعني أنه حتى المطورين ذوي الخبرة يعودون أحيانًا إلى الأساسيات. في هذه المقالة، سنشرح ليس مجرد مثال جاف، بل أفضل الممارسات التي ستوفر لك ساعات من التصحيح. ستتعلم كيفية إرسال طلب POST، ومعالجة الاستجابة بشكل صحيح، والعمل مع JSON، وتجنب الأخطاء الشائعة.

ما هو cURL ولماذا تحتاجه في PHP؟

cURL (Client URL) هي مكتبة قوية تسمح لسكريبت PHP الخاص بك بالتواصل مع خوادم أخرى عبر بروتوكولات HTTP وHTTPS وFTP وغيرها. إذا كان الكود الخاص بك هو العميل، فإن cURL هو ساعي البريد العالمي الخاص به، الذي يوصل الطلبات ويحضر الردود.

في عام 2025، عندما أصبحت الخدمات المصغرة وREST API أساس تطوير الويب، فإن القدرة على العمل بكفاءة مع cURL ليست مجرد ميزة إضافية في السيرة الذاتية، بل ضرورة. بدونها، من المستحيل دمج الموقع مع الخدمات الخارجية: من إرسال البريد الإلكتروني عبر Mailgun إلى تحميل الملفات إلى تخزين S3.

متى تستخدم HTTP POST؟

تُستخدم طلبات POST لإرسال البيانات إلى الخادم التي تغير حالته. السيناريوهات النموذجية:

تسجيل المستخدم (إرسال اسم المستخدم وكلمة المرور);
إنشاء مورد (إضافة منتج جديد عبر API);
إرسال نموذج دون إعادة تحميل الصفحة (AJAX).

مثال كلاسيكي: PHP cURL وHTTP POST

لنبدأ بأبسط مثال يجيب على سؤال «PHP, cURL, and HTTP POST example?». سنرسل طلب POST إلى خادم اختباري ونعرض الرد.

<?php// الرابط الذي نرسل إليه الطلب$url = 'https://httpbin.org/post';

// البيانات المراد إرسالها (مصفوفة ترابطية)$data = [    'name' => 'إيفان بيتروف',    'email' => 'ivan@example.com',    'message' => 'مرحبًا بالعالم!'];

// تهيئة جلسة cURL$ch = curl_init($url);

// ضبط الخياراتcurl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // إرجاع النتيجة كسلسلة نصيةcurl_setopt($ch, CURLOPT_POST, true);            // استخدام طريقة POSTcurl_setopt($ch, CURLOPT_POSTFIELDS, $data);     // تمرير البيانات

// تنفيذ الطلب$response = curl_exec($ch);

// التحقق من الأخطاءif (curl_errno($ch)) {    echo 'خطأ cURL: ' . curl_error($ch);} else {    // فك تشفير استجابة JSON للتوضيح    $decoded = json_decode($response, true);    echo '<pre>' . print_r($decoded, true) . '</pre>';}

// إغلاق الجلسةcurl_close($ch);?>

تحليل النقاط الرئيسية: