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">
<?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">
<?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:
-->
