Manuál PHP | ||
---|---|---|
Předcházející | Další |
curl_setopt() nastavuje parametry CURL session
ch
. option
je parametr, který
chcete nastavit a value
je hodnota, na kterou se má
option
nastavit.
Argument value
by měl u následujících hodnot
argumentu option
obsahovat integer:
CURLOPT_INFILESIZE
: Tento parametr by měl u
uploadů obsahovat velikost uploadovaného souboru.
CURLOPT_VERBOSE
: Pokud chcete, aby CURL podávala
zprávy o všem co se děje, nastavte tento parametr na nenulovou hodnotu.
CURLOPT_HEADER
: Pokud chcete, aby výstup obsahoval
hlavičky, nastavte tento parametr na nenulovou hodnotu.
CURLOPT_NOPROGRESS
: Pokud PHP nemá zobrazit měřidlo
postupu CURL transferu, nastavte tento parametr na nenulovou hodnotu.
Poznámka: PHP tento parametr automaticky nastavuje na nenulovou hodnotu, změna je vhodná pouze pro účely ladění.
CURLOPT_NOBODY
: Pokud nechete, aby bylo ve výstupu
zahrnuto tělo výstupu, nastavte tento parametr na nenulovou hodnotu.
CURLOPT_FAILONERROR
: Pokud má PHP tiše ukončit
transfer po přijetí HTTP server kódu většího než 300, nastavte tento
parametr na nenulovou hodnotu. Defaultní chování je ignorovat návratový
kód a normálně vrátit stránku.
CURLOPT_UPLOAD
: Pokud chcete PHP připravit na
upload, nastavte tento parametr na nenulovou hodnotu.
CURLOPT_POST
: Pokud chcete, aby PHP provedl
běžný HTTP POST pořadavek, nastavte tento parametr na nenulovou hodnotu.
Jedná se o běžný application/x-www-from-urlencoded POST požadavek, který
se většinou používá u HTML formulářů.
CURLOPT_FTPLISTONLY
: Pokud chcete, aby PHP
vypsalo názvy souborů v FTP adresáři, nastavte tento parametr na
nenulovou hodnotu.
CURLOPT_FTPAPPEND
: Pokud chcete, aby PHP místo
přepsání vzdáleného souboru připojilo upload k jeho obsahu, nastavte
tento parametr na nenulovou hodnotu.
CURLOPT_NETRC
: Pokud má PHP ve vašem
~./netrc souboru hledat vaše uživatelské jméno a heslo pro server ke
kterému se připojujete.
CURLOPT_FOLLOWLOCATION
: Pokud má PHP provádět
přesměrování u případných "Location: " hlaviček vrácených serverem.
(Pozn.: rekurzivní, PHP provede přesměrování pro všechny "Location: "
hlavičky, které přijme.)
CURLOPT_PUT
: Pokud chcete uploadovat soubor pomocí
HTTP metody PUT, nastavte tento parametr na nenulovou hodnotu. Uploadovaný
soubor musí být určen parametry CURLOPT_INFILE a CURLOPT_INFILESIZE.
CURLOPT_MUTE
: Pokud má být PHP naprosto tiché
ohledně CURL funkcí, nastavte tento parametr na nenulovou hodnotu.
CURLOPT_TIMEOUT
: Integer určující maximální čas
ve vteřinách, který mohou CURL funkce zabrat.
CURLOPT_LOW_SPEED_LIMIT
: Integer určující minimální
rychlost přenosu v bytech za sekundu. Pokud rychlost přenosu klesne pod
tento limit po dobu CURLOPT_LOW_SPEED_TIME sekund, PHP ukončí transfer.
CURLOPT_LOW_SPEED_TIME
: Integer určující čas ve
vteřinách. Pokud rychlost přenosu klesne na tuto dobu pod
CURLOPT_LOW_SPEED_LIMIT, PHP zruší transfer.
CURLOPT_RESUME_FROM
: Integer určující offset v
bytech, na kterém má transfer začít.
CURLOPT_SSLVERSION
: Integer určující, jaká verze
SSL (2 nebo 3) se má použít. Defaultně se PHP pokusí určit verzi samo,
ale v některých případech je nutno verzi určit manuálně.
CURLOPT_TIMECONDITION
: Definující chování
CURLOPT_TIMEVALUE. Tento parametr může nabýt buď hodnoty
TIMECOND_IFMODSINCE nebo TIMECOND_ISUNMODSINCE. Funguje pouze u HTTP
přenosů.
CURLOPT_TIMEVALUE
: Integer určující počet vteřin
od 1. ledna 1970. Tento čas se použije podle intervalu CURLOPT_TIMEVALUE,
default je použití TIMECOND_IFMODSINCE.
Argument value
by měl u následujících hodnot
argumentu option
obsahovat řetězec:
CURLOPT_URL
: Toto je URL, kterou má PHP stáhnout.
Tento parametr můžete také nastavit při inicializaci CURL session pomocí
funkce curl_init().
CURLOPT_USERPWD
: Řetězec ve tvaru
[username]:[password] pro použití při spojení.
CURLOPT_PROXYUSERPWD
: Řetězec ve tvaru
[username]:[password] pro použití při spojení s HTTP proxy.
CURLOPT_RANGE
: Pass the specified range
you want. It should be in the "X-Y" format, where X or Y may
be left out. The HTTP transfers also support several
intervals, seperated with commas as in X-Y,N-M.
CURLOPT_POSTFIELDS
: Řetězec obsahující kompletní
data, která se mají odeslat v HTTP POST požadavku.
CURLOPT_REFERER
: Řetězec obsahující "referer"
hlavičku pro použití v HTTP požadavku.
CURLOPT_USERAGENT
: Řetězec obsahující "user-agent"
hlavičku pro použití v HTTP požadavku.
CURLOPT_FTPPORT
: Řetězec, na jehož základě se získá
IP adresa pro FTP "POST" instrukci. POST instrukce říká serveru, aby se
připojil na danou IP adresu. Tento řetězec může obsahovat IP adresu,
hostname, a network interface name (under UNIX) nebo '-' (použije se
defaultní IP adresa systému).
CURLOPT_COOKIE
: Řetězec obsahující cookie, který
se má poslat v HTTP hlavičce tohoto přenosu.
CURLOPT_SSLCERT
: Řetězec obsahující název souboru
PEM certifikátu.
CURLOPT_SSLCERTPASSWD
: Řetězec obsahující heslo
vyžadované pro použití CURLOPT_SSLCERT certifikátu.
CURLOPT_COOKIEFILE
: Řetězec obsahující název
souboru obsahujícího cookie data. Cookie soubor může být buď v Netscape
formátu nebo obsahovat HTTP hlavičky.
CURLOPT_CUSTOMREQUEST
: Řetězec, který se má v
HTTP požadavku použít místo GET nebo HEAD. Toto je užitečné při DELETE
či jiných, obskurnějších HTTP požadavcích.
Poznámka: Používejte pouze v případě, že váš server tento příkaz podporuje.
Následující parametry očekávají deskriptor vrácený funkcí fopen():
CURLOPT_FILE
: Soubor, do kterého se má umístit
výstup CURL transferu. Default je STDOUT.
CURLOPT_INFILE
: Soubor, který obsahuje vstup
CURL transferu.
CURLOPT_WRITEHEADER
: Soubor, do kterého se mají
zapsat hlavičky výstupu.
CURLOPT_STDERR
: Soubor, do kterého se mají
zapisovat chyby místo na STDERR.
Předcházející | Domů | Další |
curl_setopt_array | Nahoru | curl_version |