ناساندنی cURL لە PHP
کتێبخانەی cURL ئامرازێکی بەهێزە لە PHP بۆ ناردن و وەرگرتنی داتا لە ڕێگەی پرۆتۆکۆڵە جیاوازەکانەوە، بەتایبەتی HTTP. کاتێک دەمانەوێت داواکارییەک بۆ API بنێرین، cURL وەک پردێک کار دەکات کە پەیوەندی لە نێوان سێرڤەری ئێمە و سێرڤەری API-یەکەدا دروست دەکات.
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);بەکارهێنانی 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 زانیارییەکانی وەرگریت. پاشان ناوی بەکارهێنەرەکە و لینکەکەی لەسەر لاپەڕەکە بە شێوەیەکی جوان چاپ بکە.