cvs: phpdoc /cs/functions curl.xml

From: Date: Mon, 05 Feb 2001 12:41:51 +0000
Subject: cvs: phpdoc /cs/functions curl.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969334169@lists.php.net to get a copy of this message
cynic Mon Feb 5 04:41:51 2001 EDT Added files: /phpdoc/cs/functions curl.xml Log: should be completely translated

Index: phpdoc/cs/functions/curl.xml +++ phpdoc/cs/functions/curl.xml <reference id="ref.curl"> <title>Funkce pro práci s CURL, Client URL Library </title> <titleabbrev>CURL</titleabbrev> <partintro id="curl.partintro"> <para> PHP podporuje libcurl, knihovnu vytvoøenou Danielem Stenbergem, která umo¾òuje spojení a komunikaci s mnoha rùznými typy serverù v mnoha rùzných typech protokolù. libcurl v souèasné dobì podporuje http, https, ftp, gopher, telnet, dict, file a ldap protokoly. libcurl také podporuje HTTPS certifikáty, HTTP POST, HTTP PUT, FTP uploady (toto umo¾òuje i ftp extenze PHP), HTTP formuláøové uploady, proxy, cookies a user+password autentikaci. </para> <para> Pokud chcete pou¾ívat CURL funkce, musíte nainstalovat <ulink url="&url.curl;">CURL</ulink>. PHP vy¾aduje pou¾ití CURL 7.0.2-beta nebo vy¹¹í. S verzemi CURL star¹ími ne¾ 7.0.2-beta PHP nebude pracovat. </para> <para> Dále musíte PHP zkompilovat s <option role="configure">--with-curl[=DIR]</option>, kde DIR je umístìní adresáøe obsahujícího lib a include adresáøe. V "include" adresáøi by mìl být adresáø pojmenovaný "curl", který by mìl obsahovat soubory easy.h and curl.h. V adresáøi "lib" by mìl být soubor pojmenovaný "libcurl.a". </para> <para> Tyto funkce byly pøidány v PHP 4.0.2. </para> <para> Pokud máte PHP zkompilované s podporou CURL, mù¾ete zaèít pou¾ívat CURL funkce. Základní principem tìchto funkcí je, ¾e pomocí <function>curl_init</function> inicializujete CURL session, potom pomocí <function>curl_exec</function> nastavíte hodnoty pøenosu a nakonec session zavøete pomocí <function>curl_close</function>. Následuje ukázka, která vyu¾íva CURL funkce ke sta¾ení homepage PHP do souboru: <example> <title>Pou¾ití CURL extenze ke sta¾ení homepage PHP</title> <programlisting role="php"> &lt;?php $ch = curl_init ("http://www.php.net/"); $fp = fopen ("php_homepage.txt", "w"); curl_setopt ($ch, CURLOPT_FILE, $fp); curl_setopt ($ch, CURLOPT_HEADER, 0); curl_exec ($ch); curl_close ($ch); fclose ($fp); ?> </programlisting> </example> </para> </partintro> <refentry id="function.curl-init"> <refnamediv> <refname>curl_init</refname> <refpurpose>Inicializovat CURL session</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>curl_init</function></funcdef> <paramdef>string <parameter><optional>url</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>curl_init</function> inicializuje novou session a vrací CURL handle pro pou¾ití s funkcemi <function>curl_setopt</function>, <function>curl_exec</function> a <function>curl_close</function>. Pokud je pøítomen volitelný argument <parameter>url</parameter>, CURLOPT_URL se nastaví na hodnotu tohoto argumentu. Mù¾ete to udìlat i ruènì, pomocí funkce <function>curl_setopt</function>. <example> <title> Inicializace nové CURL session a sta¾ení webové stránky </title> <programlisting role="php"> &lt;?php $ch = curl_init(); curl_setopt ($ch, CURLOPT_URL, "http://www.zend.com/"); curl_setopt ($ch, CURLOPT_HEADER, 0); curl_exec ($ch); curl_close ($ch); ?> </programlisting> </example> </para> <para> Viz také: <function>curl_close</function>, <function>curl_setopt</function> </para> </refsect1> </refentry> <refentry id="function.curl-setopt"> <refnamediv> <refname>curl_setopt</refname> <refpurpose>Nastavit parametr CURL transferu</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>bool <function>curl_setopt</function></funcdef> <paramdef>int <parameter>ch</parameter></paramdef> <paramdef>string <parameter>option</parameter></paramdef> <paramdef>mixed <parameter>value</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>curl_setopt</function> nastavuje parametry CURL session <parameter>ch</parameter>. <parameter>option</parameter> je parametr, který chcete nastavit a <parameter>value</parameter> je hodnota, na kterou se má <parameter>option</parameter> nastavit. </para> <para> Argument <parameter>value</parameter> by mìl u následujících hodnot argumentu <parameter>option</parameter> obsahovat integer: <itemizedlist> <listitem> <simpara> <parameter>CURLOPT_INFILESIZE</parameter>: Tento parametr by mìl u uploadù obsahovat velikost uploadovaného souboru. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_VERBOSE</parameter>: Pokud chcete, aby CURL podávala zprávy o v¹em co se dìje, nastavte tento parametr na nenulovou hodnotu. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_HEADER</parameter>: Pokud chcete, aby výstup obsahoval hlavièky, nastavte tento parametr na nenulovou hodnotu. </simpara> </listitem> <listitem> <para> <parameter>CURLOPT_NOPROGRESS</parameter>: Pokud PHP nemá zobrazit mìøidlo postupu CURL transferu, nastavte tento parametr na nenulovou hodnotu. <note> <simpara> PHP tento parametr automaticky nastavuje na nenulovou hodnotu, zmìna je vhodná pouze pro úèely ladìní. </simpara> </note> </para> </listitem> <listitem> <simpara> <parameter>CURLOPT_NOBODY</parameter>: Pokud nechete, aby bylo ve výstupu zahrnuto tìlo výstupu, nastavte tento parametr na nenulovou hodnotu. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_FAILONERROR</parameter>: 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. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_UPLOAD</parameter>: Pokud chcete PHP pøipravit na upload, nastavte tento parametr na nenulovou hodnotu. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_POST</parameter>: 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áøù. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_FTPLISTONLY</parameter>: Pokud chcete, aby PHP vypsalo názvy souborù v FTP adresáøi, nastavte tento parametr na nenulovou hodnotu. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_FTPAPPEND</parameter>: 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. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_NETRC</parameter>: 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. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_FOLLOWLOCATION</parameter>: 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.) </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_PUT</parameter>: 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. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_MUTE</parameter>: Pokud má být PHP naprosto tiché ohlednì CURL funkcí, nastavte tento parametr na nenulovou hodnotu. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_TIMEOUT</parameter>: Integer urèující maximální èas ve vteøinách, který mohou CURL funkce zabrat. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_LOW_SPEED_LIMIT</parameter>: 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. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_LOW_SPEED_TIME</parameter>: 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. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_RESUME_FROM</parameter>: Integer urèující offset v bytech, na kterém má transfer zaèít. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_SSLVERSION</parameter>: 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ì. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_TIMECONDITION</parameter>: 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ù. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_TIMEVALUE</parameter>: 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. </simpara> </listitem> </itemizedlist> </para> <para> Argument <parameter>value</parameter> by mìl u následujících hodnot argumentu <parameter>option</parameter> obsahovat øetìzec: <itemizedlist> <listitem> <simpara> <parameter>CURLOPT_URL</parameter>: Toto je URL, kterou má PHP stáhnout. Tento parametr mù¾ete také nastavit pøi inicializaci CURL session pomocí funkce <function>curl_init</function>. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_USERPWD</parameter>: Øetìzec ve tvaru [username]:[password] pro pou¾ití pøi spojení. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_PROXYUSERPWD</parameter>: Øetìzec ve tvaru [username]:[password] pro pou¾ití pøi spojení s HTTP proxy. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_RANGE</parameter>: 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. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_POSTFIELDS</parameter>: Øetìzec obsahující kompletní data, která se mají odeslat v HTTP POST po¾adavku. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_REFERER</parameter>: Øetìzec obsahující "referer" hlavièku pro pou¾ití v HTTP po¾adavku. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_USERAGENT</parameter>: Øetìzec obsahující "user-agent" hlavièku pro pou¾ití v HTTP po¾adavku. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_FTPPORT</parameter>: Ø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). </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_COOKIE</parameter>: Øetìzec obsahující cookie, který se má poslat v HTTP hlavièce tohoto pøenosu. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_SSLCERT</parameter>: Øetìzec obsahující název souboru PEM certifikátu. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_SSLCERTPASSWD</parameter>: Øetìzec obsahující heslo vy¾adované pro pou¾ití CURLOPT_SSLCERT certifikátu. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_COOKIEFILE</parameter>: Ø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. </simpara> </listitem> <listitem> <para> <parameter>CURLOPT_CUSTOMREQUEST</parameter>: Ø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. <note> <simpara> Pou¾ívejte pouze v pøípadì, ¾e vá¹ server tento pøíkaz podporuje. </simpara> </note> </para> </listitem> </itemizedlist> </para> <para> Následující parametry oèekávají deskriptor vrácený funkcí <function>fopen</function>: <itemizedlist> <listitem> <simpara> <parameter>CURLOPT_FILE</parameter>: Soubor, do kterého se má umístit výstup CURL transferu. Default je STDOUT. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_INFILE</parameter>: Soubor, který obsahuje vstup CURL transferu. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_WRITEHEADER</parameter>: Soubor, do kterého se mají zapsat hlavièky výstupu. </simpara> </listitem> <listitem> <simpara> <parameter>CURLOPT_STDERR</parameter>: Soubor, do kterého se mají zapisovat chyby místo na STDERR. </simpara> </listitem> </itemizedlist> </para> </refsect1> </refentry> <refentry id="function.curl-exec"> <refnamediv> <refname>curl_exec</refname> <refpurpose>Provést CURL session</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>bool <function>curl_exec</function></funcdef> <paramdef>int <parameter>ch</parameter></paramdef> </funcprototype> </funcsynopsis> <para> Tuto funkci byste mìli zavolat po inicializaci CURL session a nastavení v¹ech jejích parametrù. Jejím úèelem je provést pøeddefinovanou CURL session (urèenou argumentem <parameter>ch</parameter>). </para> </refsect1> </refentry> <refentry id="function.curl-close"> <refnamediv> <refname>curl_close</refname> <refpurpose>Zavøít CURL session</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>void <function>curl_close</function> </funcdef> <paramdef>int <parameter>ch</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> Tato funkce zavøe CURL session a uvolní v¹echny zdroje. CURL handle, <parameter>ch</parameter>, se také sma¾e. </para> </refsect1> </refentry> <refentry id="function.curl-version"> <refnamediv> <refname>curl_version</refname> <refpurpose>Vrátit verzi CURL</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>string <function>curl_version</function> </funcdef> <void/> </funcprototype> </funcsynopsis> <para> <function>curl_version</function> vrací øetìzec obsahující pou¾itou verzi CURL. </para> </refsect1> </refentry> </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: -->
« previous php.doc (#969334169) next »