ناساندنی cURL لە PHP

کتێبخانەی cURL ئامرازێکی بەهێزە لە PHP بۆ ناردن و وەرگرتنی داتا لە ڕێگەی پرۆتۆکۆڵە جیاوازەکانەوە، بەتایبەتی HTTP. کاتێک دەمانەوێت داواکارییەک بۆ API بنێرین، cURL وەک پردێک کار دەکات کە پەیوەندی لە نێوان سێرڤەری ئێمە و سێرڤەری API-یەکەدا دروست دەکات.

تێبینی: پێش بەکارهێنانی cURL، دڵنیابە کە extension-ی cURL لە سێرڤەرەکەتدا چالاک کراوە. دەتوانیت بە فەرمانی php -m لە terminal-دا ئەمە بپشکنیت.

هەنگاوەکانی بەکارهێنانی cURL

بۆ ئەنجامدانی هەر داواکارییەک بە cURL، پێویستە چوار هەنگاوی سەرەکی جێبەجێ بکەین: کردنەوەی پەیوەندی، دیاریکردنی ڕێکخستنەکان (options)، جێبەجێکردنی داواکارییەکە، و لە کۆتاییدا داخستنی پەیوەندییەکە.

نموونەی یەکەم: وەرگرتنی داتا بە GET

لێرەدا سادەترین شێوەی وەرگرتنی داتا لە API-یەک دەبینین:

<?php
$url = "https://jsonplaceholder.typicode.com/posts/1";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

لە کۆدی سەرەوەدا، CURLOPT_RETURNTRANSFER زۆر گرنگە؛ چونکە بەبێ ئەو، داتاکە ڕاستەوخۆ چاپ دەبێت لەجیاتی ئەوەی بگەڕێتەوە بۆ ناو گۆڕاوەکەی ئێمە.

مامەڵەکردن لەگەڵ وەڵامی API

زۆربەی API-یەکان داتا بە شێوازی JSON دەگەڕێننەوە. دوای ئەوەی داتاکەمان وەرگرت، پێویستە بەکاری بهێنین بۆ ئەوەی بیکەین بە array یان object لە PHP-دا:

$data = json_decode($response, true);
echo "Title: " . $data['title'];

هەڵەی باو: زۆر جار فێرخوازان لەبیر دەکەن json_decode بەکاربهێنن و هەوڵ دەدەن وەک array مامەڵە لەگەڵ string-ی raw بکەن، کە ئەمەش دەبێتە هۆی دەرکەوتنی هەڵە.

ناردنی زانیاری بە POST

هەندێک جار پێویستە داتا بنێرین بۆ API-یەکە، بۆ نموونە بۆ تۆمارکردنی بەکارهێنەرێک. بۆ ئەمە CURLOPT_POST بەکاردەهێنین:

$ch = curl_init("https://api.example.com/create");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(['name' => 'Ali', 'email' => 'ali@test.com']));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$result = curl_exec($ch);
curl_close($ch);
ئاگاداری: هەمیشە دڵنیابە لەوەی کە header-ی پێویستت بۆ API-یەکە ناردووە، بەتایبەتی کاتێک کار لەگەڵ API key دەکەیت، چونکە بێ ئەوان ڕەنگە داواکارییەکەت ڕەت بکرێتەوە.

بەکارهێنانی Headers

زۆربەی API-یەکان بۆ پاراستنی داتا، داوای API key دەکەن لە ڕێگەی HTTP Headers-ەوە. دەتوانیت بەم شێوەیە زیادەی بکەیت:

curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
]);

ئەرکی پراکتیکی

هەوڵ بدە API-یەکی خۆڕایی وەک https://api.github.com/users/octocat بەکاربهێنیت و بە cURL زانیارییەکانی وەرگریت. پاشان ناوی بەکارهێنەرەکە و لینکەکەی لەسەر لاپەڕەکە بە شێوەیەکی جوان چاپ بکە.