curl_setopt

Popis

bool curl_setopt ( int ch, string 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.