Manuál PHP | ||
---|---|---|
Předcházející | Další |
curl_setopt
Popis
bool curl_setopt ( resource ch, int option, mixed value )
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 |