cURL چیست؟ - قسمت اول

cURL کتابخانه ای از توابع است که توانایی اجرا روی طیف وسیعی از پروتکل ها را دارا بوده، و برای ارسال درخواست های Http جهت تبادل داده بین سایت ها، ارسال فایل، دریافت فایل و غیره کاربرد دارد.

ایجاد درخواست

برای شروع یک درخواست cURL از تابع curl_init استفاده می کنیم این تابع آدرسی را که درخواست cURL باید به آن ارسال شود، را به عنوان آرگومان می پذیرد. نتیجه خروجی آن یک منبع cURL است.

تنظیمات درخواست

مجموعه ای از پارامترهایی است که برای توصیف یک درخواست و یا کاری که یک درخواست باید انجام دهد مورد استفاده قرار می گیرند.

• CURLOPT_RETURNTRANSFER : پاسخ را به جای اینکه به صفحه نمایش بفرستد آن را به صورت رشته برمیگرداند.
• CURLOPT_CONNECTTIMEOUT : مدت زمان تلاش برای اتصال برحسب ثانیه
• CURLOPT_TIMEOUT : مدت زمان لازم اجرای درخواست cURL بر حسب ثانیه
• CURLOPT_USERAGENT : یک user-agent را ارسال می کند. User-agent عبارتی رشته ای که بین مرورگر و سرور مبادله می شود و شامل اطلاعاتی در مورد کاربر مانند سیستم عامل کاربر، مرورگر کاربر، زبان پیش فرض کاربر و ... می باشد.
• CURLOPT_URL : آدرسی که درخواست cURL باید به آن فرستاده شود را معین می کند.
• CURLOPT_POST : ارسال درخواست با متد POST
• CURLOPT_POSTFIELDS : آرایه ای از داده هایی که باید به روش POST ارسال شوند.
• CUROPT_FILE : نتیجه درخواست را در یک فایل ذخیره می کند.

برای اعمال تنظیمات از متد curl_setopt استفاده می شود. این متد سه پارامتر به عنوان آرگومان دریافت می کند. منبع cURL، نوع تنظیمات و مقدار تنظیمات. پس حال اگر بخواهیم آدرسی را که درخواست cURL باید به آن ارسال گردد، تعیین کنیم باید به روش زیر عمل کرد :

$curl = curl_init();

curl_setopt($curl, CURLOPT_URL, 'http://siteName.com/test.php');

 

این کار را هم می توان بدون استفاده از تنظیمات، هم انجام داد :

$curl = curl_init('http://siteName.com/test.php');

همچنین می توانیم با استفاده از آرایه، چندین نوع تنظیمات را یکباره روی درخواست اعمال کرد :

 

$curl = curl_init();

curl_setopt($curl,

array(CURLOPT_RETURNTRANSFER => 1,

CURLOPT_URL = > 'http://siteName.com/test.php')

);

 

ارسال درخواست

حال که درخواست را تعریف و تنظیمات لازم را اعمال کرده ایم، باید درخواست را ارسال کنیم، برای ارسال از تابع curl_exec که یک منبع از نوع cURL را به عنوان آرگومان می پذیرد، استفاده می کنیم :

 

$result = curl_exec($curl);

 

این تابع یکی از سه خروجی زیر را بر می گرداند :

false : خطایی رخ داده است.

true : درخواست بدون خطا اجرا شده – CURLOPT_RETURNTRANSFER برابر false تنظیم شده است.

نتیجه : درخواست بدون خطا اجرا شده - داده های را به صورت رشته، JSON و یا حتی ممکن است یک صفحه HTML را برگرداند - CURLOPT_RETURNTRANSFER برابر true تنظیم شده است.

 

در انتها بعد از اجرا و دریافت پاسخ، با استفاده از تابع curl_close باید درخواست را بسته و تمامی منابع درگیر، را آزاد کرد :

 

Curl_close($curl);