English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

دليل PHP الأساسي

دليل PHP متقدم

PHP & MySQL

دليل PHP

استخدام وظيفة PHP curl_multi_setopt() ومثال

دليل مرجع PHP CURL

(PHP 5 >= 5.5.0)

curl_multi_setopt — إعداد خيار نقل CURL البatch.

شرح

bool curl_multi_setopt ( resource $mh , int $option , mixed $value )

إعداد خيار نقل CURL البatch.

المعامل

ch

هو معرف CURL الذي يعود منه curl_init().

خيار

الخيار CURLOPT_XXX المطلوب إعداده.

القيمة

سيتم تعيين القيمة الموجودة على خيار option.

بالنسبة لهذه الخيارات الاختيارية، يجب إعداد القيمة كقيمة من نوع bool:

خياراختياريالقيمةالقيمةملاحظات
CURLOPT_AUTOREFERERعندما يتم تحديدLocation:عندما يتم إعادة توجيه، يتم إعداد عنوان الـ header تلقائيًا.Referer:المعلومات.
CURLOPT_BINARYTRANSFERعندما يتم تشغيلهCURLOPT_RETURNTRANSFERعندما يتم تشغيله، يتم إرجاع الناتج الأصلي (الخام).
CURLOPT_COOKIESESSIONعندما يتم تشغيله، يقوم curl بمرور على session cookie فقط، ويتجاهل الكوكي الأخرى، في الوضع الافتراضي، يعيد CURL جميع الكوكي إلى الخادم. session cookie هي الكوكي التي توجد لتقييم صحة session على الخادم.
CURLOPT_CRLFعندما يتم تشغيله، يتم تحويل مسافات Unix إلى مسافات Enter+Return.
CURLOPT_DNS_USE_GLOBAL_CACHEعند التشغيل، سيتم تشغيل مخزن DNS عالمي، وهو آمن للتعامل مع الخيوط، ويتم تشغيله افتراضيًا.
CURLOPT_FAILONERRORسيتم عرض رمز حالة HTTP، والسلوك الافتراضي هو تجاهل معلومات HTTP ذات الرقم أقل أو يساوي 400.
CURLOPT_FILETIMEعند التشغيل، سيتم محاولة تعديل معلومات المستند البعيد. سيتم إصدار معلومات النتيجة من خلال دالة curl_getinfo()CURLINFO_FILETIMEخيار إعادة الرد.            curl_getinfo().
CURLOPT_FOLLOWLOCATIONعند التشغيل، سيتم إصدار"Location: "سيتم إعادة توجيهها مرة أخرى إلى الخادم في عنوان الرأس، باستخدامCURLOPT_MAXREDIRSيمكن تحديد عدد التتابعات المحددة.
CURLOPT_FORBID_REUSEبعد إكمال التفاعل، سيتم إجبار إنهاء الاتصال، وسيكون غير قابلة لإعادة الاستخدام.
CURLOPT_FRESH_CONNECTإجباريًا للحصول على اتصال جديد، بدلاً من الاستخدام من المخزن.
CURLOPT_FTP_USE_EPRTعند التشغيل، سيتم استخدام الأمر EPRT (أو LPRT) عند تنزيل FTP، وسيتم تعيينه إلىFALSEعند التشغيل، سيتم تعطيل EPRT وLPRT، واستخدام الأمر PORT            فقط.
CURLOPT_FTP_USE_EPSVعند التشغيل، سيتم محاولة أوامر EPSV قبل العودة إلى نمط PASV في عملية نقل FTP، وسيتم تعيينه إلىFALSEعند التشغيل، سيتم تعطيل أوامر EPSV.
CURLOPT_FTPAPPENDعند التشغيل، سيتم إضافة الكتابة إلى ملف بدلاً من استبداله.
CURLOPT_FTPASCIICURLOPT_TRANSFERTEXTاسم مستعار.
CURLOPT_FTPLISTONLYعند التشغيل، سيتم إصدار أسماء مجلدات FTP فقط.
CURLOPT_HEADERعند التشغيل، سيتم إصدار معلومات ملف الرأس كدفق بيانات.
CURLINFO_HEADER_OUTعند التشغيل، سيتم تتبع طلبات سلسلة الحالة.متاح من PHP 5.1.3 فصاعداً.CURLINFO_المدخل هو مقصود (عمداً).
CURLOPT_HTTPGETعند التشغيل، سيتم تعيين طريقة HTTP على GET، لأن GET هو افتراضي، لذا سيتم استخدامه فقط عند التغيير.
CURLOPT_HTTPPROXYTUNNELعند التشغيل، سيتم نقل البيانات عبر وكيل HTTP.
CURLOPT_MUTEعند التشغيل، سيتم استعادة جميع المعلمات المعدلة في دالة CURL إلى القيم الافتراضية.
CURLOPT_NETRCبعد إنشاء الاتصال، استخدم ملف ~.netrc للحصول على معلومات اسم المستخدم وكلمة المرور للاتصال بموقع بعيد.
CURLOPT_NOBODYعند التشغيل، لن يتم إصدار جزء BODY من HTML.
CURLOPT_NOPROGRESS

إذا تم تفعيله، سيتم إغلاق شريط التقدم في نقل CURL، والقيمة الافتراضية لهذا الخيار هي التفعيل.

ملاحظة:

يقوم PHP بتعيين هذا الخيار تلقائيًاTRUE، يجب تغيير هذا الخيار فقط لأغراض الت调试.


CURLOPT_NOSIGNALإذا تم تفعيله، سيتم تجاهل جميع الإشارات التي يتم نقلها من CURL إلى PHP. يتم تفعيل هذا الخيار افتراضيًا في نقل SAPI المتعدد بالthreads.تم إضافته إلى CURL 7.10.
CURLOPT_POSTإذا تم تفعيله، سيتم إرسال طلب POST عادي، من نوع:application/x-www-form-urlencoded، مثل تقديم استمارة.
CURLOPT_PUTإذا تم تفعيله، يسمح بإرسال ملف عبر HTTP، يجب تعيينهCURLOPT_INFILEوCURLOPT_INFILESIZE.
CURLOPT_RETURNTRANSFERباستخدام
CURLOPT_SSL_VERIFYPEERإذا تم تعطيله، سيقوم CURL بإنهاء التحقق من الخادم.CURLOPT_CAINFOيتم تعيين خيار استخدام الصور التأمينيةCURLOPT_CAPATHيتم تعيين خيار دليل الصور التأمينية            إذاCURLOPT_SSL_VERIFYPEER(القيمة الافتراضية هي 2) يتم تفعيله،CURLOPT_SSL_VERIFYHOSTيجب أن يتم تعيينهTRUEإلا إذا تم تعيينهFALSE.من CURL 7.10، يتم تعيينه افتراضيًاTRUE. من CURL 7.10، يتم تثبيت الاتصال افتراضيًا.
CURLOPT_TRANSFERTEXTإذا تم تفعيله، سيتم استخدام نمط ASCII للنقل عبر FTP. بالنسبة لـ LDAP، سيتم استرجاع معلومات النص النقي وليس HTML. على نظام التشغيل Windows، لن يفصل النظامSTDOUTيتم تعيينه كنمط ثنائي.
CURLOPT_UNRESTRICTED_AUTHعند استخدامCURLOPT_FOLLOWLOCATIONسيتم إضافة معلومات اسم المستخدم وكلمة المرور في المواقع المتعددة في عنوان المستند المولد، حتى إذا تغيرت النطاق.
CURLOPT_UPLOADإذا تم تفعيلها، يسمح بتحميل الملفات.
CURLOPT_VERBOSEإذا تم تفعيلها، سيتم إبلاغ جميع المعلومات، وتخزينها فيSTDERRأو المحددCURLOPT_STDERRفيها.

القيمة المعدة

يعود TRUE عند النجاح أو FALSE عند الفشل.

دليل مرجع PHP CURL