PHP وظيفة curl_setopt
PHP وظيفة curl_setopt
(PHP 4> = 4.0.2، PHP 5)
curl_setopt - تعيين خيارات نقل حليقة.
تفسير
bool curl_setopt ( resource $ch , int $option , mixed $value )
مجموعة معينة مقبض جلسة الضفيرة خيارا.
المعلمات
الفصل
من curl_init) إرجاع (مقبض الضفيرة.
خيار
لا بد من تعيين خيارات CURLOPT_XXX.
قيمة
تعيين قيمة الخيار على الخيارات.
للمعلمات الاختيارية التالية من هذه الخيار، يجب تعيين القيمة إلى قيمة من نوع منطقي:
خيارات | قيمة قيمة اختيارية | تعليق |
---|---|---|
CURLOPT_AUTOREFERER | وعندما وفقا المكان: توجيه تلقائيا تعيين رأس في التحويلية: المعلومات. | |
CURLOPT_BINARYTRANSFER | CURLOPT_RETURNTRANSFER عندما مكن، والعودة الأصلي (الخام) الانتاج. | |
CURLOPT_COOKIESESSION | عندما حليقة تمكين سيمر فقط الكعكة الدورة، تجاهل الكعكة الآخرين، والضفيرة الوضع الافتراضي عودة كل ملف تعريف الارتباط إلى الخادم. ملف تعريف ارتباط جلسة هي تلك التي تستخدم لتحديد صلاحية الدورة من جانب الخادم موجود الكعكة. | |
CURLOPT_CRLF | عند تمكين السطر يونكس إلى إرجاع. | |
CURLOPT_DNS_USE_GLOBAL_CACHE | تمكين تمكين مخبأ DNS العالمي، تمكين هذا الموضوع آمنة، والافتراضية. | |
CURLOPT_FAILONERROR | رمز الحالة عرض HTTP، السلوك الافتراضي هو تجاهل عدد 400 أو أقل من المعلومات HTTP. | |
CURLOPT_FILETIME | انها ستحاول تعديل يتم تمكين المعلومات عن بعد في الوثيقة. عودة معلومة النتائج هو () وظيفة الخيار CURLINFO_FILETIME من خلال curl_getinfo. curl_getinfo (). | |
CURLOPT_FOLLOWLOCATION | عندما يعود الخادم والخادم تمكين "الموقع:" رأس على الإعادة مرة أخرى إلى الخادم، يمكنك استخدام CURLOPT_MAXREDIRS محددة بشكل متكرر عودة عدد. | |
CURLOPT_FORBID_REUSE | قطع اضطر بعد الانتهاء من التفاعل لا يمكن إعادة استخدامها. | |
CURLOPT_FRESH_CONNECT | اضطر للحصول على اتصال جديد، يحل محل الاتصال ذاكرة التخزين المؤقت. | |
CURLOPT_FTP_USE_EPRT | عندما مكن تنزيل بروتوكول نقل الملفات، استخدم فريق إعادة إعمار المحافظات الأوامر (أو LPRT). تعطيل فريق إعادة إعمار المحافظات وLPRT عند تعيينها إلى FALSE، استخدم الأمر PORT فقط. | |
CURLOPT_FTP_USE_EPSV | عندما مكن، ردا على عملية نقل وضع بروتوكول نقل الملفات PASV قبل أول الأمر محاولة EPSV. عند تعيينها إلى FALSE لتعطيل القيادة EPSV. | |
CURLOPT_FTPAPPEND | ملف الكتابة إضافي بدلا من الكتابة أنها مكنت. | |
CURLOPT_FTPASCII | الاسم المستعار CURLOPT_TRANSFERTEXT. | |
CURLOPT_FTPLISTONLY | يتم تمكين القائمة فقط اسم دليل FTP. | |
CURLOPT_HEADER | عند تمكين رأس الرسالة سوف يكون الناتج ك دفق البيانات. | |
CURLINFO_HEADER_OUT | تتبع تمكين سلسلة طلب المقبض. | متاحة منذ PHP 5.1.3. بادئة CURLINFO_ هي متعمدة (مقصودة). |
CURLOPT_HTTPGET | والإعداد تمكين طريقة HTTP هو الحصول، منذ GET هو الافتراضي، وذلك باستخدام فقط في حالة التعرض للتعديل. | |
CURLOPT_HTTPPROXYTUNNEL | سيتم نقلها من خلال تمكين وكيل HTTP. | |
CURLOPT_MUTE | وظيفة الضفيرة تعديل جميع المعلمات لاستعادة القيمة الافتراضية تمكين. | |
CURLOPT_NETRC | بعد تأسيس الاتصال، ملف وصول ~ / .netrc للحصول على اسم المستخدم وكلمة المرور المعلومات للاتصال مواقع نائية. | |
CURLOPT_NOBODY | لن يتم تمكين جزء من الانتاج هيئة HTML. | |
CURLOPT_NOPROGRESS | تمكين إغلاق شريط حليقة التقدم الإرسال، يتم تمكين هذا افتراضيا.
| |
CURLOPT_NOSIGNAL | تجاهل كل من إشارة يتم تمريرها إلى حليقة فب تمكين يؤديها. يتم تمكين هذا افتراضيا عندما SAPI نقل مؤشرات. | الضفيرة 7.10 عندما المضافة. |
CURLOPT_POST | عندما يرسل تمكين طلب POST العادي، اكتب: التطبيق / x-شبكة الاتصالات العالمية شكل -urlencoded، تماما مثل تقديم النموذج. | |
CURLOPT_PUT | السماح HTTP إرسال ملف، يجب عليك تعيين CURLOPT_INFILE وCURLOPT_INFILESIZE تمكين في وقت واحد. | |
CURLOPT_RETURNTRANSFER | وcurl_exec () إرجاع المعلومات التي تم الحصول عليها في شكل تيار الملف، بدلا من أن تكون المخرجات. | |
CURLOPT_SSL_VERIFYPEER | وبعد أن أنهى الضفيرة تعطيل من خادم للتحقق. شهادات خيار استخدام CURLOPT_CAINFO CURLOPT_CAPATH شهادات الخيار كتالوج إذا تم تمكين CURLOPT_SSL_VERIFYPEER (2 افتراضيا)، CURLOPT_SSL_VERIFYHOST يحتاج لتعيين TRUE، وإلا يتم تعيينها إلى FALSE. | الضفيرة 7.10 منذ بداية الافتراضية هي الحقيقة. من بداية الافتراضية ملزمة تثبيت الضفيرة 7.10. |
CURLOPT_TRANSFERTEXT | استخدام وضع ASCII لنقل بروتوكول نقل الملفات. لLDAP، فإنه يسترد المعلومات في نص عادي بدلا من HTML. على أنظمة ويندوز، فإن النظام لن يحدد STDOUT إلى الوضع الثنائي. | |
CURLOPT_UNRESTRICTED_AUTH | باستخدام CURLOPT_FOLLOWLOCATION ولدت رأس مواقع متعددة إلحاق باستمرار اسم المستخدم وكلمة المرور المعلومات، حتى لو تم تغيير اسم المجال. | |
CURLOPT_UPLOAD | عندما مكن يسمح تحميل الملفات. | |
CURLOPT_VERBOSE | وتقرير تمكين جميع المعلومات المخزنة في STDERR أو المعينة CURLOPT_STDERR في. |
للمعلمات الاختيارية التالية من هذه الخيار، يجب تعيين القيمة إلى قيمة من نوع عدد صحيح:
خيارات | قيمة قيمة اختيارية | تعليق |
---|---|---|
CURLOPT_BUFFERSIZE | قراءة كل البيانات التي حصل عليها إلى حجم ذاكرة التخزين المؤقت، ولكن لا يضمن التي سيتم شغلها قيمة كل منها. | تم إضافته في الضفيرة 7.10. |
CURLOPT_CLOSEPOLICY | لا CURLCLOSEPOLICY_LEAST_RECENTLY_USED هو CURLCLOSEPOLICY_OLDEST، هناك ثلاثة CURLCLOSEPOLICY البعض، ولكن لا يتم اعتماد الضفيرة حتى الان. | |
CURLOPT_CONNECTTIMEOUT | قبل الشروع في اتصال وقت الانتظار، إذا تم تعيين إلى 0، ثم الانتظار إلى أجل غير مسمى. | |
CURLOPT_CONNECTTIMEOUT_MS | محاولة الاتصال وقت للانتظار، في ميلي ثانية. إذا تم تعيين إلى 0، ثم الانتظار إلى أجل غير مسمى. | وأضاف 7.16.2 الضفيرة في. متاحة منذ PHP 5.2.3. |
CURLOPT_DNS_CACHE_TIMEOUT | تعيين معلومات DNS المخزنة في ذاكرة الوقت، الافتراضي هو 120 ثانية. | |
CURLOPT_FTPSSLAUTH | المصادقة FTP: CURLFTPAUTH_SSL (أول محاولة SSL)، CURLFTPAUTH_TLS (أول محاولة TLS) أو CURLFTPAUTH_DEFAULT (السماح الضفيرة تحدد تلقائيا). | وأضاف 7.12.2 الضفيرة في. |
CURLOPT_HTTP_VERSION | CURL_HTTP_VERSION_NONE (القيمة الافتراضية، لذلك حليقة أن تقرر لنفسها أي إصدار لاستخدام)، CURL_HTTP_VERSION_1_0 (إلزامية استخدام HTTP / 1.0) أو CURL_HTTP_VERSION_1_1 (إلزامية استخدام HTTP / 1.1). | |
CURLOPT_INFILESIZE | تعيين الحد الأقصى لحجم ملف التحميل من بايت وحدة (بايت). | |
CURLOPT_LOW_SPEED_LIMIT | عندما يكون معدل نقل أقل من الوقت CURLOPT_LOW_SPEED_LIMIT (بايت / ثانية)، CURLOPT_LOW_SPEED_TIME مقرها PHP لتحديد ما إذا تم إلغاء نقل بسبب بطيئة جدا. | |
CURLOPT_LOW_SPEED_TIME | عندما يكون معدل نقل أقل من الوقت CURLOPT_LOW_SPEED_LIMIT (بايت / ثانية)، CURLOPT_LOW_SPEED_TIME مقرها PHP لتحديد ما إذا تم إلغاء نقل بسبب بطيئة جدا. | |
CURLOPT_MAXCONNECTS | الحد الأقصى لعدد الاتصالات للسماح، من خلال CURLOPT_CLOSEPOLICY سيحدد التي يجب أن تتوقف الاتصالات. | |
CURLOPT_MAXREDIRS | يحدد الحد الأقصى لعدد الموجهات HTTP، وCURLOPT_FOLLOWLOCATION يستخدم هذا الخيار معا. | |
CURLOPT_PORT | فهو يستخدم لتحديد منفذ الاتصال. (اختياري) | |
CURLOPT_PROTOCOLS | CURLPROTO_ * حقل بت يعني. إذا تم تمكين هذا، سوف تحدد قيمة حقل بت التي البروتوكولات يمكن استخدام يبكورل هناك أثناء الإرسال. هذا سيسمح لك لدعم عدد من البروتوكولات عند ترجمة يبكورل، ولكن يسمح للحدود إلا أنها لاستخدام مجموعة فرعية. سوف يبكورل الافتراضي استخدام كل من بروتوكولاتها المعتمدة. راجع خيارات بروتوكول CURLOPT_REDIR_PROTOCOLS المتاحة ل: CURLPROTO_HTTP، CURLPROTO_HTTPS، CURLPROTO_FTP، CURLPROTO_FTPS ، CURLPROTO_SCP، CURLPROTO_SFTP، CURLPROTO_TELNET، CURLPROTO_LDAP، CURLPROTO_LDAPS، CURLPROTO_DICT، CURLPROTO_FILE، CURLPROTO_TFTP، CURLPROTO_ALL | وأضاف 7.19.4 الضفيرة في. |
CURLOPT_PROTOCOLS | CURLPROTO_ * حقل بت يعني. إذا تم تمكين هذا، سوف تحدد قيمة حقل بت التي البروتوكولات يمكن استخدام يبكورل هناك أثناء الإرسال. هذا سيسمح لك لدعم عدد من البروتوكولات عند ترجمة يبكورل، ولكن يسمح للحدود إلا أنها لاستخدام مجموعة فرعية. سوف يبكورل الافتراضي استخدام كل من بروتوكولاتها المعتمدة. راجع خيارات بروتوكول CURLOPT_REDIR_PROTOCOLS المتاحة ل: CURLPROTO_HTTP، CURLPROTO_HTTPS، CURLPROTO_FTP، CURLPROTO_FTPS ، CURLPROTO_SCP، CURLPROTO_SFTP، CURLPROTO_TELNET، CURLPROTO_LDAP، CURLPROTO_LDAPS، CURLPROTO_DICT، CURLPROTO_FILE، CURLPROTO_TFTP، CURLPROTO_ALL | وأضاف 7.19.4 الضفيرة في. |
CURLOPT_PROXYAUTH | HTTP وكيل اتصال المصادقة. استخدام CURLOPT_HTTPAUTH العلم bitfield لتحديد الخيارات المناسبة. لمصادقة الوكيل فقط CURLAUTH_BASIC وCURLAUTH_NTLM المعتمدة حاليا. | وأضاف 7.10.7 الضفيرة في. |
CURLOPT_PROXYPORT | منفذ الخادم الوكيل. ويمكن أيضا أن يتم تعيين الموانئ في CURLOPT_PROXY. | |
CURLOPT_PROXYTYPE | لا CURLPROXY_HTTP (القيمة الافتراضية) هو CURLPROXY_SOCKS5. | تم إضافته في الضفيرة 7.10. |
CURLOPT_REDIR_PROTOCOLS | * CURLPROTO_ قيمة حقل بت. إذا تم تمكين هذا، سوف تحد من قيمة حقل بت بروتوكول نقل التي يجب اتباعها عند موضوع معيد التوجيه عندما CURLOPT_FOLLOWLOCATION بدوره يمكن استخدامها. هذا وسوف تحولك إلى أقصى حد يسمح المواضيع نقل وبروتوكولات فرعية يبكورل الافتراضية تسمح لجميع البروتوكولات باستثناء FILE والدائمة. هذا النوع من إصدار ما قبل النشر 7.19.4 ودون قيد أو شرط اتباع جميع البروتوكولات المعتمدة هناك بعض الاختلافات. حول ثوابت بروتوكول، يرجى الرجوع CURLOPT_PROTOCOLS. | وأضاف 7.19.4 الضفيرة في. |
CURLOPT_RESUME_FROM | تمرير الإزاحة عند استعادة انتقال (للHTTP). | |
CURLOPT_SSL_VERIFYHOST | إذا كان هناك اسم شائع (الاسم الشائع) 1 التحقق من شهادة الخادم SSL. ملاحظة المترجم: الاسم الشائع (الاسم الشائع) بشكل عام، سوف تحتاج إلى تطبيق هو ملء نطاق شهادة SSL (المجال) أو فرعي (المجال الفرعي). 2 التحقق من وجود الاسم الشائع، وإذا كان يتطابق مع اسم المضيف قدم. | |
CURLOPT_SSLVERSION | استخدام SSL إصدار (2 أو 3). افتراضيا سوف PHP كشف هذه القيمة نفسها، على الرغم من أن تحتاج إلى تعيين يدويا في بعض الحالات. | |
CURLOPT_TIMECONDITION | إذا كنت تقوم بتحرير في المستقبل في CURLOPT_TIMEVALUE زمنية محددة للغاية، واستخدام العائد CURL_TIMECOND_IFMODSINCE إلى الصفحة، إذا لم تعدل، وCURLOPT_HEADER هو الصحيح، تقوم بإرجاع "لم يتم تعديل 304" في الرأس، CURLOPT_HEADER كاذبة، ثم استخدم CURL_TIMECOND_IFUNMODSINCE، والتقصير CURL_TIMECOND_IFUNMODSINCE قيمة. | |
CURLOPT_TIMEOUT | تعيين الحد الأقصى لعدد ثانية للسماح الضفيرة تنفيذها. | |
CURLOPT_TIMEOUT_MS | الضفيرة وضع يسمح لتنفيذ أكبر عدد ممكن من ميلي ثانية. | وأضاف 7.16.2 الضفيرة في. من PHP 5.2.3 فصاعدا يمكن استخدامها. |
CURLOPT_TIMEVALUE | وضع الطابع الزمني CURLOPT_TIMECONDITION تستخدم افتراضيا باستخدام CURL_TIMECOND_IFMODSINCE. |
للخيار التالية من هذه المعلمات الاختيارية، يجب تعيين القيمة إلى القيمة من نوع سلسلة:
خيارات | قيمة قيمة اختيارية | تعليق |
---|---|---|
CURLOPT_CAINFO | أنه يحمل واحدة أو عدد وافر من الخادم المستخدم للسماح بالتحقق من اسم ملف الشهادة. هذه المعلمة هي ذات معنى فقط عندما تستخدم جنبا إلى جنب وCURLOPT_SSL_VERIFYPEER. . | |
CURLOPT_CAPATH | حاصل على تعدد CA دليل الشهادات. يستخدم هذا الخيار مع CURLOPT_SSL_VERIFYPEER. | |
CURLOPT_COOKIE | وضع طلب HTTP "كوكي:" جزء من محتويات. كوكي متعددة مفصولة بفاصلة منقوطة مع مسافة بعد منقوطة (على سبيل المثال، "فاكهة التفاح =؛ اللون = أحمر"). | |
CURLOPT_COOKIEFILE | اسم الملف يحتوي على تنسيق البيانات ملف كوكي كوكي يمكن أن يكون في شكل نتسكيب، أو معلومات رأس HTTP عادي فقط في ملف. | |
CURLOPT_COOKIEJAR | حفظ معلومات ملف تعريف الارتباط بعد نهاية الاتصال. | |
CURLOPT_CUSTOMREQUEST | استخدام المعلومات طلب مخصص بدلا من "GET" أو "الرأس"، كما طلب HTTP. هذا هو تنفيذ "حذف" أو غيرها من طلبات HTTP أكثر غموضا. القيم الصالحة مثل "GET"، "POST"، "الاتصال" وهلم جرا. وبعبارة أخرى، لا تدخل هنا طلب HTTP كله. على سبيل المثال، أدخل "GET /index.html HTTP / 1.0 \ ص \ ن \ ص \ ن" غير صحيحة.
| |
CURLOPT_EGDSOCKET | CURLOPT_RANDOM_FILE مماثلة، بالإضافة إلى مأخذ الانتروبيا جمع الشيطان. | |
CURLOPT_ENCODING | طلب HTTP "تحمل ترميز:" قيمة. بدعم ترميز "الهوية"، "يدحض"، و "غزيب". إذا سلسلة فارغة ""، سيتم إرسال الطلب الأول لجميع أنواع الترميز المعتمدة. | تم إضافته في الضفيرة 7.10. |
CURLOPT_FTPPORT | وسوف تستخدم هذه القيمة للحصول على عنوان IP لتعليم بروتوكول نقل الملفات "POST" الحاجة. "POST" تعليمات يحكي الملقم البعيد للاتصال عنوان IP محدد لدينا. هذه السلسلة يمكن أن يكون عادي عنوان IP النص، اسم المضيف، اسم واجهة الشبكة (يونيكس تحت) أو مجرد '-' لاستخدام عنوان IP الافتراضي. | |
CURLOPT_INTERFACE | يمكن أن يكون صافي إرسال اسم واجهة اسم الواجهة، وعنوان IP أو اسم المضيف. | |
CURLOPT_KRB4LEVEL | مستوى الأمان KRB4 (Kerberos 4). أي من القيم التالية هي صالحة (من الأعلى إلى مرتبة عالية): "واضح"، "آمنة "، "سرية"، "خاصة" .. إذا لم تتطابق سلسلة وسوف تستخدم هذه "الخاص". تم تعيين هذا الخيار إلى NULL سيتم تعطيل شهادة السلامة KRB4. حاليا شهادة السلامة KRB4 يمكن أن تستخدم إلا لنقل FTP. | |
CURLOPT_POSTFIELDS | جميع البيانات باستخدام بروتوكول HTTP في العملية "POST" لإرسال. لإرسال ملف أمام اسم الملف مع @ البادئة واستخدام المسار الكامل. هذه المعلمة يمكن أن يكون مماثلا من سلسلة urlencoded بعد "para1 = VAL1 وpara2 = VAL2 و... ' أو باستخدام اسم حقل المفتاح والقيم مجموعة البيانات الميدانية. إذا كانت القيمة صفيف، نوع المحتوى رأس سيتم تعيين لمتعددة / استمارة البيانات. | |
CURLOPT_PROXY | قناة وكيل HTTP. | |
CURLOPT_PROXYUSERPWD | سلاسل التنسيق: واحد للاتصال بالوكالة "[كلمة المرور] [اسم المستخدم]" . | |
CURLOPT_RANDOM_FILE | يستخدم SSL لإنشاء اسم ملف المصنف رقم عشوائي. | |
CURLOPT_RANGE | في "XY" النموذج، حيث X و Y هما اختياري نطاق الحصول على البيانات، في بايت. يدعم المواضيع نقل HTTP أيضا العديد من هذه إدخالات مكررة المتوسطة مفصولة بفواصل، مثل "XY، NM". | |
CURLOPT_REFERER | المحتوى: في طلب رأس HTTP "التحويلية". | |
CURLOPT_SSL_CIPHER_LIST | قائمة خوارزميات التشفير SSL. مثل RC4-SHA وTLSv1 هي قائمة التشفير المتوفرة. | |
CURLOPT_SSLCERT | اسم الملف الذي يحتوي على شهادة شكل بيم. | |
CURLOPT_SSLCERTPASSWD | باستخدام كلمات السر شهادة CURLOPT_SSLCERT المطلوبة. | |
CURLOPT_SSLCERTTYPE | نوع الشهادة. التنسيقات المعتمدة هي "بيم" (القيمة الافتراضية)، "DER"، و "المهندس". | انضم في الضفيرة 7.9.3. |
CURLOPT_SSLENGINE | في CURLOPT_SSLKEY المستخدمة لتحديد المتغيرات محرك تشفير المفتاح الخاص SSL. | |
CURLOPT_SSLENGINE_DEFAULT | المتغيرات المستخدمة لعمليات التشفير غير المتماثلة. | |
CURLOPT_SSLKEY | يحتوي على اسم ملف المفتاح الخاص SSL. | |
CURLOPT_SSLKEYPASSWD | كلمة CURLOPT_SSLKEY المحدد في المفتاح الخاص SSL.
| |
CURLOPT_SSLKEYTYPE | أنواع التشفير المفتاح الخاص المحدد في CURLOPT_SSLKEY، بدعم نوع المفتاح هو "بيم" (القيمة الافتراضية)، "DER"، و "المهندس". | |
CURLOPT_URL | عنوان URL في حاجة للحصول على وظيفة يتم التخلص curl_init (). | |
CURLOPT_USERAGENT | في طلب HTTP يتضمن "عامل المستخدم:" سلسلة الرأس. | |
CURLOPT_USERPWD | يمر اتصال يتطلب اسم المستخدم وكلمة المرور في شكل: "[اسم المستخدم]: [كلمة ]". |
هذه الخيار للمعلمات الاختيارية التالية، يجب تعيين قيمة كما صفيف:
خيارات | قيمة قيمة اختيارية | تعليق |
---|---|---|
CURLOPT_HTTP200ALIASES | استجابة 200 مجموعة رمز، ومجموعة من استجابة يعتبر الإجابة الصحيحة، وإلا فإنه يعتبر خطأ. | وأضاف 7.10.3 حليقة في. |
CURLOPT_HTTPHEADER | لوضع مجموعة من حقول رأس HTTP. استخدام مجموعة من الإعدادات التالية: مجموعة ( 'المحتوى من نوع: نص / عادي'، 'المحتوى طول: 100') | |
CURLOPT_POSTQUOTE | بعد إعدام هو طلبات بروتوكول نقل الملفات كاملة على الملقم لتنفيذ مجموعة من الأوامر FTP. | |
CURLOPT_QUOTE | وهناك مجموعة من بروتوكول نقل الملفات الأوامر المنفذة على الخادم مسبق لطلب FTP. |
للمعلمات الاختيارية التالية من هذه الخيار، يجب تعيين قيمة لتدفق الموارد (على سبيل المثال، وذلك باستخدام الدالة fopen ()):
خيارات | قيمة قيمة اختيارية |
---|---|
CURLOPT_FILE | تعيين موقع ملف الإخراج، القيمة هي نوع من الموارد، الافتراضي هو STDOUT (المتصفح). |
CURLOPT_INFILE | ملف عنوان عند تحميل ملف إلى أن يقرأ، وقيمة من نوع الموارد. |
CURLOPT_STDERR | تعيين قيمة عنوان الخطأ الناتج هو نوع من الموارد، بدلا من STDERR الافتراضية. |
CURLOPT_WRITEHEADER | وضع رأس الكتابة جزء من محتويات الملف عنوان، القيمة هي نوع من الموارد. |
للخيار التالية من هذه المعلمات الاختيارية، يجب تعيين القيمة إلى اسم الدالة رد:
خيارات | قيمة قيمة اختيارية |
---|---|
CURLOPT_HEADERFUNCTION | إنشاء دالة رد يأخذ حجتين، الأول هو التعامل مع الموارد حليقة، وبيانات رأس الثاني هو الإخراج. يجب أن تعتمد البيانات رأس الإخراج على وظيفة وترجع تمت كتابة حجم البيانات. |
CURLOPT_PASSWDFUNCTION | وضع دالة رد يستغرق ثلاث حجج، الأول هو التعامل مع الموارد حليقة، والثاني هو موجه كلمة المرور، المعلمة الثالثة هي الحد الأقصى لطول كلمة المرور المسموح بها. إرجاع قيمة كلمة المرور. |
CURLOPT_PROGRESSFUNCTION | وضع دالة رد يستغرق ثلاث حجج، الأول هو التعامل مع الموارد حليقة، والثاني هو ملف مورد واصف، والثالث هو طول. تقوم بإرجاع البيانات التي يحتوي عليها. |
CURLOPT_READFUNCTION | اسم الدالة الاستدعاء. هذه الدالة تأخذ يجب أن تكون المعلمات الثلاث. الأول هو الموارد حليقة، والثاني هو خيار تمرير الضفيرة CURLOPT_INFILE الموارد تيار، المعلمة الثالثة هي الحد الأقصى لعدد يمكن قراءة البيانات. وظيفة رد الاتصال يجب أن يعود طول سلسلة أقل من أو يساوي كمية البيانات المطلوبة (المعلمة الثالث). قراءة عامة من المورد تيار واردة. بإرجاع سلسلة فارغة كما EOF (نهاية الملف) الإشارات. |
CURLOPT_WRITEFUNCTION | اسم الدالة الاستدعاء. وظيفة يجب أن يقبل حجتين. الأول هو الموارد حليقة، والثاني هو سلسلة من البيانات المراد كتابتها. يجب أن يتم تخزين البيانات في وظيفة. وظيفة يجب أن يعود العدد الدقيق للبايت المراد كتابتها إلى البيانات الواردة، وإلا سيتم مقاطعة نقل عن خطأ. |
عودة القيمة
عودة ناجحة الحقيقة، أو على فشل وإرجاع FALSE.
تحديث دخول
إطلاق | تفسير |
---|---|
5.2.10 | إدخال CURLOPT_PROTOCOLS ، و CURLOPT_REDIR_PROTOCOLS . |
5.1.0 | إدخال CURLOPT_AUTOREFERER ، CURLOPT_BINARYTRANSFER ، CURLOPT_FTPSSLAUTH ، CURLOPT_PROXYAUTH ، و CURLOPT_TIMECONDITION . |
5.0.0 | إدخال CURLOPT_FTP_USE_EPRT ، CURLOPT_NOSIGNAL ، CURLOPT_UNRESTRICTED_AUTH ، CURLOPT_BUFFERSIZE ، CURLOPT_HTTPAUTH ، CURLOPT_PROXYPORT ، CURLOPT_PROXYTYPE ، CURLOPT_SSLCERTTYPE ، و CURLOPT_HTTP200ALIASES . |
أمثلة
تهيئة جلسة الضفيرة الجديدة والحصول على صفحة ويب
<?php // 创建一个新cURL资源 $ch = curl_init(); // 设置URL和相应的选项 curl_setopt($ch, CURLOPT_URL, "http://www.example.com/"); curl_setopt($ch, CURLOPT_HEADER, false); // 抓取URL并把它传递给浏览器 curl_exec($ch); //关闭cURL资源,并且释放系统资源 curl_close($ch); ?>
تحميل ملف مثال:
<?php /* http://localhost/upload.php: print_r($_POST); print_r($_FILES); */ $ch = curl_init(); $data = array('name' => 'Foo', 'file' => '@/home/user/test.png'); curl_setopt($ch, CURLOPT_URL, 'http://localhost/upload.php'); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $data); curl_exec($ch); ?>
أمثلة على نتائج الإخراج المذكورة أعلاه هي على النحو التالي:
Array ( [name] => Foo ) Array ( [file] => Array ( [name] => test.png [type] => image/png [tmp_name] => /tmp/phpcpjNeQ [error] => 0 [size] => 279 ) )
مذكرة
تمرير صفيف CURLOPT_POSTFIELDS، سيتم ترميز البيانات حليقة إلى / شكل بيانات متعددة الأجزاء، ومن ثم تمرير سلسلة ترميز URL، يتم ترميز البيانات كما urlencoded س-وو-شكل التطبيق /.