PHP-Funktion curl_setopt

PHP cURL-Referenzhandbuch

(PHP 4 >= 4.0.2, PHP 5)

curl_setopt — Legt eine cURL-Transferoption fest.

Beschreibung

bool curl_setopt ( resource $ch , int $option , mixed $value )

Setzt eine Option für das angegebene cURL-Sitzungshandle.

Parameters

ch

cURL-Handle, das von curl_init() zurückgegeben wird.

option

Die CURLOPT_XXX-Option, die gesetzt werden soll.

value

Der Wert, der für die Option festgelegt werden soll.

Für die folgenden optionalen Parameter für diese Optionen sollte value auf einen booleschen Wert gesetzt werden:

Für die folgenden optionalen Parameter für diese Optionen sollte der Wert auf einen ganzzahligen Wert gesetzt werden:

Für die folgenden Optionen sollte der Parameter value auf einen Zeichenfolgenwert gesetzt werden:

Für die folgenden Optionen sollte der value-Parameter auf ein Array gesetzt werden:

Für die folgenden Optionen sollte der value-Parameter auf eine Stream-Ressource gesetzt werden (z. B. mit fopen()):

Für die folgenden Optionen sollte der Wertparameter auf den Namen einer Callback-Funktion gesetzt werden:

Rückgabewerte

Gibt bei Erfolg TRUE zurück, bei Fehlschlag FALSE.

Änderungsprotokoll

Beispiele

Initialisieren Sie eine neue cURL-Sitzung und rufen Sie eine Webseite ab

<?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);
?>

Beispiel für einen Datei-Upload:

<?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);
?>

Das obige Beispiel gibt Folgendes aus:

Array
(
    [name] => Foo
)
Array
(
    [file] => Array
        (
            [name] => test.png
            [type] => image/png
            [tmp_name] => /tmp/phpcpjNeQ
            [error] => 0
            [size] => 279
        )

)

Hinweise

Wenn ein Array an CURLOPT_POSTFIELDS übergeben wird, veranlasst dies cURL, die Daten als multipart/form-data zu kodieren, während die Übergabe einer URL-kodierten Zeichenkette bewirkt, dass die Daten als application/x-www-form-urlencoded kodiert werden.

PHP-cURL-Referenz