curl_setopt

Popis

Funkcia curl_setopt() nastaví voľby pre CURL sedenie indetifikované parametrom ch . Parameter voľba je voľba, ktorú chcete nastaviť a hodnota je hodnota voľby daná parametrom voľba .

hodnota by mala byť long pre následujúce voľby (určené v parametri voľba ):

• CURLOPT_INFILESIZE : Keď uploadujete súbor na vzdialenú stránku, táto voľba by sa mala použiť, aby PHP povedala, aká bude očakávaná veľkosť súboru.
• CURLOPT_VERBOSE : Nastavete túto voľbu na nenulovú hodnotu, ak chcete, aby CURL hlásil všetko, čo sa deje.
• CURLOPT_HEADER : Nastavte túto voľbu na nenulovú hodnotu, ak chcete, aby bola hlavička zahrnutá vo výstupe.

• CURLOPT_NOPROGRESS : Nastavnte túto voľbu na nenulovú hodnotu, ak nechcete, aby PHP zobrazovalo merač priebehu pre CURL prenosy.

  Note: PHP túto voľbu automaticky nastaví na nenulový parameter, mala by sa meniť len z dôvodu ladenia.

• CURLOPT_NOBODY : Nastavte túto voľbu na nenulovú hodnotu, ak nechcete, aby bolo telo zahrnuté vo výstupe.
• CURLOPT_FAILONERROR : Nastavte túto voľbu na nenulovú hodnotu, ak chcete, aby PHP zlyhalo potichu, ak vrátený HTTP kód je väčší než 300. Východzie nastavenie je vrátiť stránku normálne, ignorujúc kód.
• CURLOPT_UPLOAD : Nastavte túto voľbu na nenulovú hodnotu, ak chcete, aby sa PHP pripravilo na uploadovanie.
• CURLOPT_POST : Nastavte túto voľbu na nenulovú hodnotu, ak chcete, aby PHP robilo pravidelný HTTP POST. Tento POST je normálny application/x-www-form-urlencoded druh, najbežnejšie používaný HTML formulármi.
• CURLOPT_FTPLISTONLY : Nastavte túto voľbu na nenulovú hodnotu a PHP urobí zoznam názvom FTP adresára.
• CURLOPT_FTPAPPEND : Nastavte túto voľbu na nenulovú hodnotu a PHP pripojí k vzdialenému súboru namiesto jeho prepísania.
• CURLOPT_NETRC : Nastavte túto voľbu na nenulovú hodnotu a PHP preskenuje váš ~./netrc súbor, aby našiel vaše užívateľské meno a heslo pre vzdialenú stránku, s ktorou vytvárate spojenie.
• CURLOPT_FOLLOWLOCATION : Nastavte túto voľbu na nenulovú hodnotu, aby sa sledovali všetky hlavičky "Location: ", ktoré server posiela ako časť HTTP hlavičky (toto je rekurzívne, PHP bude sledovať toľko hlavičiek "Location: ", koľko sa ich pošle.)
• CURLOPT_PUT : Nastavte túto voľbu na nenulovú hodnotu na súbor HTTP PUT. Súbor na PUT musí byť nastavený s CURLOPT_INFILE a CURLOPT_INFILESIZE.
• CURLOPT_MUTE : Nastavte túto voľbu na nenulovú hodnotu a PHP bude úplne potichu vzhľadom na CURL funkcie.
• CURLOPT_TIMEOUT : Vložte long ako parameter, ktorý obsahuje maximálny čas, v sekundách, čím povolíte CURL funkciám ich trvanie.
• CURLOPT_LOW_SPEED_LIMIT : Vložte long ako parameter, ktorý obsahuje rýchlosť prenosu v bytoch za sekundu, pod ktorým by mal byť počas CURLOPT_LOW_SPEED_TIME sekúnd, aby PHP usúdilo, že je príliš pomalá a ukončí ho.
• CURLOPT_LOW_SPEED_TIME : Vložte long ako parameter, ktorý obsahuje čas v sekundách, pod ktorým by prenos CURLOPT_LOW_SPEED_LIMIT mal byť, aby PHP usúdilo, že je príliš pomalá a ukončí ho.
• CURLOPT_RESUME_FROM : Vložte long ako parameter, ktorý obsahuje offset, v bytoch, od ktorého chcete, aby prenos začal.
• CURLOPT_SSLVERSION : Vložte long ako parameter, ktorý obsahuje SSL verziu (2 akebo 3), ktorá sa má použiť. Defaultne toto PHP vyskúša a určí samo, i keď v niektorých prípadoch to musíte nastaviť manuálne.
• CURLOPT_SSL_VERIFYHOST : Vložte long, ak by mal CURL skontrolovať Bežný názov peer certifikátu v nadviazaní spojenia SSL. Hodnota 1 znamená, že by sme mali zistiť existenciu bežného názvu, hodnota 2 znamená, že by sme mali uistiť, že sa zhoduje s poskytnutým názvom hostu.
• CURLOPT_TIMECONDITION : Vložte long ako parameter, ktorý určuje ako sa CURLOPT_TIMEVALUE spracuje. Tento parameter môžete nastaviť na TIMECOND_IFMODSINCE alebo TIMECOND_ISUNMODSINCE. Táto vlastnosť je iba pre HTTP.
• CURLOPT_TIMEVALUE : Vložte long ako parameter, ktorý je čas v sekundách od 1. januára 1970. Čas sa použije ako je určené voľbou CURLOPT_TIMEVALUE alebo sa defaultne použije TIMECOND_IFMODSINCE.
• CURLOPT_RETURNTRANSFER : Vložte nenulovú hodnotu, ak chcete, aby CURL priamo vracal prenos namiesto jeho priameho vytlačenia.

Parameter hodnota by mal byať reťazec pre následujúce hodnoty parametra voľba :

• CURLOPT_URL : Toto je URL, ktorú chete, aby PHP stiahlo. Túto voľbu môžete tiež nastaviť pri inicializácii sedenia pomocou funkcie curl_init().
• CURLOPT_USERPWD : Vložte reťazec formátovaný spôsobom [username]:[password], ktorý má PHP použiť pre spojenie.
• CURLOPT_PROXYUSERPWD : Vložte reťazec vo formáte [username]:[password] pre spojenie na HTTP proxy.
• CURLOPT_RANGE : Vložte špecifikovaný rozsah, aký chcete. Mal byť vo formáte "X-Y", kde sa X alebo Y može vynechať. HTTP prenosy tiež podporujú niekoľko intervalov, oddelené čiarkami ako v X-Y,N-M.
• CURLOPT_POSTFIELDS : Vložte reťazec obsahujúci plné dáta na poslanie v HTTP "POST" operácii.
• CURLOPT_REFERER : Vložte reťazec obsahujúci hlavičku "referer", ktorá sa má použiť v HTTP požiadavke.
• CURLOPT_USERAGENT : Vložte reťazec obsahujúci hlavičku "user-agent", ktorá sa má použiť v HTTP požiadavke.
• CURLOPT_FTPPORT : Vložte reťazec obsahujúci hodnotu, ktorá sa použije na získanie IP adresy na použie pre ftp "POST" inštrikciu. POST inštrikcia hovorí vzdialenému serveru, aby sa pripojil na našu špecifickú IP adresu. Reťazec môže byť planá IP adresa, názov hostu, názov rozhrania siete (pod UNIXom) alebo len '-' na použitie východzej IP adresy systému.
• CURLOPT_COOKIE : Vložte reťazec obsahujúci obsah cookie, ktorý sa má nastaviť v HTTP hlavičke.
• CURLOPT_SSLCERT : Vložte reťazec obsahujúci názvo súboru formatovaného PEM certifikátu.
• CURLOPT_SSLCERTPASSWD : Vložte reťazec obsahujúci helso požadované na použitie CURLOPT_SSLCERT certifikátu.
• CURLOPT_COOKIEFILE : Vložte reťazec obsahujúci názov súboru obsahujúci cookie dáta. Cookie súbor môže byť formátu Netscape alebo len plané hlavičky HTTP štýlu zapísané do súboru.

• CURLOPT_CUSTOMREQUEST : Vložte reťazec, ktorý sa má použiť miesto GET alebo HEAD pri vykonávaní HTTP požiadavky. Je to užitočné pre DELETE alebo iných, neznámejších HTTP požiadaviek. Pletné hodnoty sú veci ako GET, POST atď; napr. nezadávajte sem celý riadok HTTP požiadavky. Napr. zadanie 'GET /index.html HTTP/1.0\r\n\r\n' by bolo nesprávne.

  Note: Nerobnte to bez predošlého uistenia sa, že váš server príkaz podporuje.

• CURLOPT_PROXY : Zadajte názov HTTP proxy na pretunelovanie požiadavky.

• CURLOPT_INTERFACE : Vložte názov odchádzajúceho rozhranie siete na použitie. To môže byť názov rozhrania, IP adresa alebo názov hostu.

• CURLOPT_KRB4LEVEL : Vložte KRB4 (Kerberos 4) stupeň ochrany. Hocktorý z následujúcich reťazcov (v poradí od najslepšieho k najsilnejšiemu): 'clear', 'safe', 'confidential', 'private'. Ak sa reťazec nezhoduje s jedným z týchto, potom sa použije 'private'. Ak ho nastavíte na NULL, KRB47 ochrana sa zamietne. KRB4 ochrana momentálne pracuje iba s FTP transakciami.

• CURLOPT_HTTPHEADER : Vložte pole HTTP polí hlavičiek, ktoré sa majú nastaviť.

• CURLOPT_QUOTE : Vložte pole FTP príkazov na vykonanie na serveri pred FTP požiadavkou.

• CURLOPT_POSTQUOTE : Vložte pole FTP príkazov na vykonanie na serveri, po tom, čo FTP požiadavka bola vykonaná.

Následujúce voľby vyžadujú kľúčové slovo súboru, ktorá sa získa pomocou funkcie fopen():

• CURLOPT_FILE : Súbor, kde by sa mal uložiť výstup vášho prenosu, default je STDOUT.
• CURLOPT_INFILE : Súbor, od kiaľ vstup prichádza vstup vášho prenosu.
• CURLOPT_WRITEHEADER : Súbor, do ktorého sa zapíše časť s hlavičkou výstupu.
• CURLOPT_STDERR : Súbor, do ktorého sa zapíšu chyby namiesto stderr.