שימוש ב-curl לשליחת פרמטרים

curl היא פקודה שימושית בלינוקס, שניתן להשתמש בה גם ב-PHP ובאמצעותה ניתן לטעון דף אחד. למתי זה שימושי? זה שימושי מאד כאשר אנו רוצים בסקריפט ה-PHP שלנו לטעון דף משרת אחר ולשלוח אליו מידע. למשל כאשר אנו מבצעים סליקה אלקטרונית, התחברות ל-webservice כלשהו (שלא עובד עם SOAP) או כל טופס אחר.

אז איך עושים את זה? בשביל התבשיל אנחנו צריכים כמה מצרכים – שם הדף שאליו נשלח את הפרמטרים שלנו, הפרמטרים ולבסוף שם משתנה שאליו אנו מקבלים את התוצאה – שיכולה להיות דף HTML או כל דף אחר.

שם הדף והפרמטרים

שם הדף הוא פשוט, מדובר בכתובת דף אינטרנט כלשהי – הכתובת אליה אנו שולחים את הפרטים. זה יכול להיות דף אינטרנט באתר שלנו או באתר אחר.

הפרמטרים הם מעט יותר מורכבים. מדובר במחרוזת טקסט המכילה את שם הפרמטר והערך שלו כאשר מה שמפריד ביניהם הוא הסימן &. אנחנו יכולים לשלוח את הפרמטרים כ-GET ואז אנו נשלח אותם כחלק מה-URL או כ-POST. בדוגמא הזו אני שולח אותם בפורמט POST.

אז הנה שני משתנים – אחד מכיל את כתובת הדף והשני מכיל את הפרמטרים:


$host = 'https://www.example.com/example.cgi'

$params = 'param1=value1&param2=value2&param3';

הכנת קריאת ה-CURL

עכשיו מה שיש לנו לעשות זה ליצור קריאת curl באופן הבא:


$curl_connection = curl_init();
curl_setopt($curl_connection, CURLOPT_URL, $host);
curl_setopt($curl_connection, CURLOPT_POST, 1);
curl_setopt($curl_connection, CURLOPT_FAILONERROR, true);
curl_setopt($curl_connection, CURLOPT_POSTFIELDS, $poststring);
curl_setopt($curl_connection, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl_connection, CURLOPT_SSL_VERIFYPEER, 0);

הקוד הוא פשוט לחלוטין והוא משתמש בשני המשתנים שהכנו קודם לכן. הקוד הזה מכין בעצם את קריאת ה-curl והרפרנס אליה הוא המשתנה curl_connection.

שליחת הקריאה

אחרי שהכנו את הקריאה יש לשלוח אותה ואת זה עושים עם הקוד הבא:


$result = curl_exec($curl_connection);

מה שהקוד עושה זה לשלוח את הקריאה ולקבל את התוצאה אחר כך (מה שזו לא תהיה) באמצעות משתנה result.

טיפול בטעויות

לא תמיד שליחת מידע באמצעות curl עובדת. לעתים אנו נתקלים בתקלת 404 (דף חסר), לפעמים יש תקלה אחרת שנובעת משיבושים בשרת שלנו או בשרת השני (בדרך כלל בשרת שאליו נשלחת הבקשה). על מנת לדעת לדבג את העניין אנו נצרף לקוד גם קוד טיפול בטעויות שידפיס את השגיאות ובכך נוכל לטפל בהן. הקוד הוא:


// on error - exit with error message
$error = curl_error($curl_connection);
if(!empty($error)) {
	die($error);
}

סגירת הבקשה

לאחר ההכנות, השליחה וקבלת התוצאות או השגיאות, כדאי לנו לסגור את הבקשה ולשחרר זכרון. את זה עושים באמצעות הפקודה הבאה:


curl_close($curl_connection);

הנה הקוד במלואו למי שרוצה רק להעתיק ולהדביק.


<?php

$host = 'https://www.example.com/example.cgi'

$params = 'param1=value1&param2=value2&param3';

$curl_connection = curl_init();
curl_setopt($curl_connection, CURLOPT_URL, $host);
curl_setopt($curl_connection, CURLOPT_POST, 1);
curl_setopt($curl_connection, CURLOPT_FAILONERROR, true);
curl_setopt($curl_connection, CURLOPT_POSTFIELDS, $params);
curl_setopt($curl_connection, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl_connection, CURLOPT_SSL_VERIFYPEER, 0);

// actual curl execution perfom
$result = curl_exec($curl_connection);

// on error - exit with error message
$error = curl_error($curl_connection);
if(!empty($error)) {
	die($error);
}
curl_close($curl_connection);

מה שחשוב לזכור הוא שלא כל שרת מאפשר קריאת curl ויש לוודא עם ה-sysadmin שיפתח את הקריאה הזו. אין סיכון בטחוני ב-curl כל עוד משתמשים בו היטב ומפלטרים את התשובה שמקבלים.

כדאי תמיד להשאר מעודכנים! הרשמו לעדכונים של האתר במייל! - המייל יישלח כל יום ראשון בעשר בבוקר ויכיל אך ורק את המאמרים שהתפרסמו באינטרנט ישראל. ללא ספאם, ללא הצפות, ללא בלגנים. 🙂

אהבתם? לא אהבתם? דרגו!

לא אהבתי בכלללא אהבתיבסדראהבתיאהבתי מאוד (אין הצבעות)


אל תשארו מאחור! יש עוד מה ללמוד!

הצטרפו לעדכונים!

העדכונים נשלחים אך ורק כאשר האתר מתעדכן.

רן בר-זיק

רן בר-זיק כותב כל המאמרים באינטרנט ישראל, מפתח אינטרנט מנוסה במגוון שפות ופלטפורמות.
ניתן ליצור איתי קשר באמצעות:
כתובת המייל שלי: info@internet-israel.com.
פרופיל הלינקדאין שלי
הטוויטר שלי
פרופיל הפייסבוק שלי
אני תמיד שמח לייעץ ולעזור, אך בשל עומס הפניות הרב, אני לא תמיד מצליח לענות במהירות.