שימוש ב-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 כל עוד משתמשים בו היטב ומפלטרים את התשובה שמקבלים.