cvs: phpdoc /fr/functions curl.xml
| From: | Damien Seguy | Date: | Wed, 25 Jul 2001 19:34:33 +0000 |
| Subject: | cvs: phpdoc /fr/functions curl.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336501@lists.php.net to get a copy of this message | ||
dams Wed Jul 25 15:34:33 2001 EDT
Modified files:
/phpdoc/fr/functions curl.xml
Log:
Added &true;
Index: phpdoc/fr/functions/curl.xml diff -u phpdoc/fr/functions/curl.xml:1.5 phpdoc/fr/functions/curl.xml:1.6 --- phpdoc/fr/functions/curl.xml:1.5 Mon Mar 19 12:01:14 2001 +++ phpdoc/fr/functions/curl.xml Wed Jul 25 15:34:32 2001 @@ -1,46 +1,47 @@ - <reference id="ref.curl"> - <title>CURL</title> - <titleabbrev>CURL</titleabbrev> - <partintro id="curl.partintro"> - <para> - PHP supporte libcurl, une librairie créée par Daniel Stenberg, - qui vous permet de vous connecter de commniquer avec de nombreux serveurs, - grâce à de nombreux protocoles. libcurl supporte actuellement - les protocoles suivants : http, https, ftp, gopher, telnet, dict, file, et - ldap. libcurl supporte aussi les certificats HTTPS, les POST HTTP, PUT HTTP, - le chargement par FTP (ce qui peut être fait par l'extension FTP), - les chargement par formulaire HTTP, les proxies, les cookies et - l'autentification par mot de passe et nom de compte. - </para> - <para> - Pour pouvoir utiliser les fonctions CURL, vous devez installer le - package <ulink url="&url.curl;">CURL</ulink>. PHP requiert la version - CURL 7.0.2-beta ou plus récente. PHP ne fonctionnera pas avec - une version inférieure à la version 7.0.2-beta. - </para> - <para> - Pour utiliser CURL depuis les scripts PHP, vous devez aussi compiler PHP - avec l'option <option role="configure">--with-curl[=DIR]</option> - où DIR est le chemin jusqu'au dossier contenant les dossier - <filename>lib</filename> et <filename>include</filename>. Dans le - dossier <filename>include</filename> il doit se trouver un dossier - appelé <filename>curl</filename>, qui contient notamment les - fichiers <filename>easy.h</filename> et <filename>curl.h</filename>. - Il doit aussi se trouver un fichier nommé - <filename>libcurl.a</filename> dans le dossier <filename>lib</filename>. - </para> - <para> - Une fois que vous avez compilé PHP avec le support CURL, vous - pouvez commencer à l'exploiter avec vos scripts PHP. Le principe - de fonctionnement est d'initialiser une session CURL avec - <function>curl_init</function>, puis de choisir toutes vos options - de transfert avec <function>curl_exec</function> et de finir votre - session avec <function>curl_close</function>. Voici un exemple - d'utilisation des fonctions CURL, qui récupère la - page principale de PHP : - <example> - <title>Utilisation de CURL et PHP pour récupérer une page</title> - <programlisting role="php"> +<reference id="ref.curl"> + <title>CURL</title> + <titleabbrev>CURL</titleabbrev> + <partintro id="curl.partintro"> + <title>Introduction à CURL</title> + <para> + PHP supporte libcurl, une librairie créée par Daniel Stenberg, + qui vous permet de vous connecter de communiquer avec de nombreux serveurs, + grâce à de nombreux protocoles. libcurl supporte actuellement + les protocoles suivants : http, https, ftp, gopher, telnet, dict, file, et + ldap. libcurl supporte aussi les certificats HTTPS, les POST HTTP, PUT HTTP, + le chargement par FTP (ce qui peut être fait par l'extension FTP), + les chargement par formulaire HTTP, les proxies, les cookies et + l'authentification par mot de passe et nom de compte. + </para> + <para> + Pour pouvoir utiliser les fonctions CURL, vous devez installer le + package <ulink url="&url.curl;">CURL</ulink>. PHP requiert la version + CURL 7.0.2-beta ou plus récente. PHP ne fonctionnera pas avec + une version inférieure à la version 7.0.2-beta. + </para> + <para> + Pour utiliser CURL depuis les scripts PHP, vous devez aussi compiler PHP + avec l'option <link linkend="install.configure.with-curl"><option role="configure">--with-curl[=DIR]</option></link> + où DIR est le chemin jusqu'au dossier contenant les dossiers + <filename>lib</filename> et <filename>include</filename>. Dans le + dossier <filename>include</filename> il doit se trouver un dossier + appelé <filename>curl</filename>, qui contient notamment les + fichiers <filename>easy.h</filename> et <filename>curl.h</filename>. + Il doit aussi se trouver un fichier nommé + <filename>libcurl.a</filename> dans le dossier <filename>lib</filename>. + </para> + <para> + Une fois que vous avez compilé PHP avec le support CURL, vous + pouvez commencer à l'exploiter avec vos scripts PHP. Le principe + de fonctionnement est d'initialiser une session CURL avec + <function>curl_init</function>, puis de choisir toutes vos options + de transfert avec <function>curl_exec</function> et de finir votre + session avec <function>curl_close</function>. Voici un exemple + d'utilisation des fonctions CURL, qui récupère la + page principale de PHP : + <example> + <title>Utilisation de CURL et PHP pour récupérer une page</title> + <programlisting role="php"> <?php $ch = curl_init ("http://www.php.net/"); $fp = fopen ("php_homepage.txt", "w"); @@ -50,42 +51,42 @@ curl_close ($ch); fclose ($fp); ?> - </programlisting> - </example> - </para> - </partintro> - <refentry id="function.curl-init"> - <refnamediv> - <refname>curl_init</refname> - <refpurpose>Initialise une session CURL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>resource - <function>curl_init</function> - </funcdef> - <paramdef>string - <parameter> - <optional>url</optional> - </parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>curl_init</function> initialise une nouvelle session et retourne un - identifiant de session CURL, à utiliser avec les fonctions - <function>curl_setopt</function>, <function>curl_exec</function> - et <function>curl_close</function>. Si le paramètre optionnel - <parameter>url</parameter> est fourni, alors CURLOPT_URL prendra cette - valeur. Vous pouvez manuellement fixer cette valeur avec la fonction - <function>curl_setopt</function>. - <example> - <title> - Initialiser une sessions CURL et récupèration d'une page web. - </title> - <programlisting role="php"> + </programlisting> + </example> + </para> + </partintro> + <refentry id="function.curl-init"> + <refnamediv> + <refname>curl_init</refname> + <refpurpose>Initialise une session CURL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource + <function>curl_init</function> + </funcdef> + <paramdef>string + <parameter> + <optional>url</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>curl_init</function> initialise une nouvelle session et retourne un + identifiant de session CURL, à utiliser avec les fonctions + <function>curl_setopt</function>, <function>curl_exec</function> + et <function>curl_close</function>. Si le paramètre optionnel + <parameter>url</parameter> est fourni, alors CURLOPT_URL prendra cette + valeur. Vous pouvez manuellement fixer cette valeur avec la fonction + <function>curl_setopt</function>. + <example> + <title> + Initialiser une session CURL et récupèration d'une page web. + </title> + <programlisting role="php"> <?php $ch = curl_init(); curl_setopt ($ch, CURLOPT_URL, "http://www.zend.com/"); @@ -93,424 +94,423 @@ curl_exec ($ch); curl_close ($ch); ?> - </programlisting> - </example> - </para> - <para> - Voir aussi : <function>curl_close</function>, <function>curl_setopt</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.curl-setopt"> - <refnamediv> - <refname>curl_init</refname> - <refpurpose>Modifie une option de transfert CURL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool - <function>curl_setopt</function> - </funcdef> - <paramdef>resource - <parameter>ch</parameter> - </paramdef> - <paramdef>string - <parameter>option</parameter> - </paramdef> - <paramdef>mixed - <parameter>value</parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>curl_setopt</function> fixe les options de transfert de la - session CURL identifiée par <parameter>ch</parameter>. - <parameter>option</parameter> est le nom de l'option à fixer, - et <parameter>value</parameter> est sa valeur. - </para> - <para> - <parameter>value</parameter> doit être de type "long" pour - les options suivantes (specifiée par <parameter>option</parameter>) : - <itemizedlist> - <listitem> - <simpara> - <parameter>CURLOPT_INFILESIZE</parameter>: Lorsque vous - téléchargez un fichier sur un site distant, cette - option sert à indiquer à PHP la taille maximale du - fichier attendu. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_VERBOSE</parameter>: Choississez une valeur non nulle - pour que CURL vous affiche tous les événements. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_HEADER</parameter>: Choississez une valeur non nulle - pour que CURL inclus l'entête dans la valeur de retour. - </simpara> - </listitem> - <listitem> - <para> - <parameter>CURLOPT_NOPROGRESS</parameter>: Choississez une valeur non nulle - pour que PHP n'affiche pas l'état des transferts CURL. - <note> - <simpara> - PHP choisit automatiquement une valeur non nulle. Ne changez cette valeur - que le temps du débuggage. - </simpara> - </note> - </para> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_NOBODY</parameter>: Choississez une valeur non nulle - pour que le corps du transfert ne soit pas inclus dans la valeur de retour. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FAILONERROR</parameter>: Choississez une valeur non nulle - pour que PHP traite silencieusement les codes HTTP supérieurs - à 300. Le comportement par défaut est de retourner la - page normalement, en ignorant ce code. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_UPLOAD</parameter>: Choississez une valeur non nulle - pour que PHP prépare un chargement. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_POST</parameter>: Choississez une valeur non nulle - pour que PHP fasse un HTTP POST. Un POST est un encodage normal - "application/x-www-from-url", utilisé couramment par les formulaires - HTML. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FTPLISTONLY</parameter>: Choississez une valeur non nulle - pour que PHP ne fasse que lister les noms d'un dossier FTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FTPAPPEND</parameter>: Choississez une valeur non nulle - pour que PHP concatène le fichier distant, plutôt que de - l'écraser. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_NETRC</parameter>: Choississez une valeur non nulle - pour que PHP scanne votre fichier ~./netrc et utilise votre nom de - compte et mot de passe sur le site distant que vous souhaitez contacter. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FOLLOWLOCATION</parameter>: Choississez une valeur - non nulle pour suivre toutes les entêtes "Location: " que le - serveur envoie dans les entêtes HTTP (notez que cette fonction - est récursive, et que PHP suivra toutes les entêtes - "Location: " qu'il trouvera). - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_PUT</parameter>: Choississez une valeur non nulle - pour que pour chargement se fasse par HTTP PUT. Le fichier à - charger doit être fixé avec les options CURLOPT_INFILE - et CURLOPT_INFILESIZE. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_MUTE</parameter>: Choississez une valeur non nulle - pour que PHP soit totalement silencieux concernant toutes les fonctions - CURL. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_TIMEOUT</parameter>: Passez un entier "long" comme - paramètre qui représente le temps maximum d'exécution - de la fonction CURL. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_LOW_SPEED_LIMIT</parameter>: Passez un entier long - qui représente la vitesse minimale en octets par secondes en - dessous de laquelle, et pendant CURLOPT_LOW_SPEED secondes, PHP - considèrera qu'elle est trop lente, et annulera le transfert. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_LOW_SPEED_TIME</parameter>: Passez un entier "long" - qui représente le temps en secondes, qui, si la vitesse de - transfert reste en dessous de CURLOPT_LOW_SPEED_LIMIT, PHP - considèrera que la connexion est trop lente, et l'annulera. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_RESUME_FROM</parameter>: Passez un entier "long", - qui représente l'offset, en octets, à partir duquel vous voulez - commencer le transfert. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_SSLVERSION</parameter>: Passez un entier "long" - qui contient la version de SSL (2 ou 3) à utiliser. Par - défaut, PHP essaiera de le déterminer par - lui-même, bien que dans certains cas, il vous faudra - le faire manuellement. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_TIMECONDITION</parameter>: Passez un entier "long" - qui définit comment CURLOPT_TIMEVALUE est utilisé. - Vous pouvez choisir entre les valeurs TIMECOND_IFMODSINCE ou - TIMECOND_ISUNMODSINCE. C'est une fonctionnalité HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_TIMEVALUE</parameter>: Passez un entier "long" - qui représente le temps en secondes depuis le 1er janvier 1970. - Cette valeur sera utilisée comme spécifié dans - l'option CURLOPT_TIMEVALUE. Par défaut, TIMECOND_IFMODSINCE - sera utilisé. - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - <parameter>value</parameter> doit être une chaîne de - caractères pour les valeurs suivantes de <parameter>option</parameter> - <itemizedlist> - <listitem> - <simpara> - <parameter>CURLOPT_URL</parameter>: L'URL que PHP va récupérer. - Vous pouvez aussi choisir cette v aleur lors de l'appel à - <function>curl_init</function>. - function. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_USERPWD</parameter>: Passez une chaîne de - caractères au format [nom]:[mot de passe], pour que PHP - l'utilise lors de la connexion. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_PROXYUSERPWD</parameter>: Passez une chaîne - de caractères au format [nom]:[mot de passe ], pour que PHP - l'utilise lors de la connexion à un proxy HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_RANGE</parameter>: Passez une chaîne de - caractères qui représente la plage de valeur que - vous désirez. Elle est au format "X-Y", où les - valeurs de X ou Y peuvent être omises. Le transfert HTTP - supporte aussi plusieurs intervalles, séparé par - des virgules : X-Y,N-M. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_POSTFIELDS</parameter>: Passez une chaîne - de caractères qui contient toutes les données à - passer lors d'une opération de HTTP POST. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_REFERER</parameter>: Passez une chaîne de - caractères qui contient l'entête de "REFERER", - utilisé lors d'une requête HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_USERAGENT</parameter>: Passez une chaîne - de caractères qui contient l'entête "user-agent" - utilisé dans une requête HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FTPPORT</parameter>: Passez une chaîne de - caractères qui désignera l'adresse IP utilisée - pour l'instruction FTP "PORT". L'instruction POST indique au serveur - distant de se connecter cette adresse IP. La chaîne peut - être une adresse IP, un nom d'hôte, un nom d'interface - réseau (sous UNIX), ou juste '-', pour utiliser les IP par - défaut du système. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_COOKIE</parameter>: Passez une chaîne de - caractères qui contiendra le contenu du cookie, à - transmettre dans l'entête HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_SSLCERT</parameter>: Passez une chaîne de - caractères qui contiendra le nom de fichier du certificat, - au format PEM. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_SSLCERTPASSWD</parameter>: Passez une chaîne - de caractères qui contient le mot de passe nécessaire - pour utiliser le certificat CURLOPT_SSLCERT. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_COOKIEFILE</parameter>: Passez une chaîne de - caractères qui contiendra le nom du fichier contenant les - données de cookie. Le fichier de cookie peut être au - format Netscape, ou simplement des entêtes HTTP écrites - dans un fichier. - </simpara> - </listitem> - <listitem> - <para> - <parameter>CURLOPT_CUSTOMREQUEST</parameter>: Passez une chaîne - de caractères qui sera utilisé à la place de GET - ou HEAD lors des requêtes HTTP. Cette commande est pratique pour - effectuer un DELETE, ou une autre commande HTTP exotique. - <note> - <simpara> - N'utilisez pas cette commande sans vous assurer que le serveur l'accepte. - </simpara> - </note> - </para> - </listitem> - </itemizedlist> - </para> - <para> - Les options suivantes requièrent un pointeur de fichier, qui est - obtenu avec la fonction <function>fopen</function> : - <itemizedlist> - <listitem> - <simpara> - <parameter>CURLOPT_FILE</parameter>: Le fichier de sortie de votre transfert. - Par défaut, STDOUT. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_INFILE</parameter>: Le fichier d'entrée de - votre transfert. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_WRITEHEADER</parameter>: Le fichier de destination - de l'entête de la sortie du transfert. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_STDERR</parameter>: Le fichier d'erreurs. - </simpara> - </listitem> - </itemizedlist> - </para> - </refsect1> - </refentry> - <refentry id="function.curl-exec"> - <refnamediv> - <refname>curl_exec</refname> - <refpurpose>Excécute une session CURL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool - <function>curl_exec</function> - </funcdef> - <paramdef>resource - <parameter>ch</parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - Cette fonction doit être appelée après - l'initialisation et le paramètrage d'une session CURL. - Son but est simplement d'éxécuter la session - <parameter>ch</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.curl-close"> - <refnamediv> - <refname>curl_close</refname> - <refpurpose>Ferme une session CURL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void - <function>curl_close</function> - </funcdef> - <paramdef>int - <parameter>ch</parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>curl_close</function> ferme une session CURL et libère - toutes les ressources reservées. L'identifiant CURL, - <parameter>ch</parameter>, est aussi effacé. - </para> - </refsect1> - </refentry> - <refentry id="function.curl-version"> - <refnamediv> - <refname>curl_version</refname> - <refpurpose>Retourne la version courante de CURL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string - <function>curl_version</function> - </funcdef> - <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>curl_version</function> retourne une chaîne - avec la version courante de la librairie CURL. - </para> - </refsect1> - </refentry> - </reference> + </programlisting> + </example> + </para> + <para> + Voir aussi : <function>curl_close</function>, <function>curl_setopt</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.curl-setopt"> + <refnamediv> + <refname>curl_init</refname> + <refpurpose>Modifie une option de transfert CURL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean + <function>curl_setopt</function> + </funcdef> + <paramdef>resource + <parameter>ch</parameter> + </paramdef> + <paramdef>string + <parameter>option</parameter> + </paramdef> + <paramdef>mixed + <parameter>value</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>curl_setopt</function> fixe les options de transfert de la + session CURL identifiée par <parameter>ch</parameter>. + <parameter>option</parameter> est le nom de l'option à fixer, + et <parameter>value</parameter> est sa valeur. + </para> + <para> + <parameter>value</parameter> doit être de type "long" pour + les options suivantes (spécifiée par <parameter>option</parameter>) : + <itemizedlist> + <listitem> + <simpara> + <parameter>CURLOPT_INFILESIZE</parameter>: Lorsque vous + téléchargez un fichier sur un site distant, cette + option sert à indiquer à PHP la taille maximale du + fichier attendu. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_VERBOSE</parameter>: Choisissez une valeur non nulle + pour que CURL vous affiche tous les événements. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_HEADER</parameter>: Choisissez une valeur non nulle + pour que CURL inclut l'en-tête dans la valeur de retour. + </simpara> + </listitem> + <listitem> + <para> + <parameter>CURLOPT_NOPROGRESS</parameter>: Choisissez une valeur non nulle + pour que PHP n'affiche pas l'état des transferts CURL. + <note> + <simpara> + PHP choisit automatiquement une valeur non nulle. Ne changez cette valeur + que le temps du débuggage. + </simpara> + </note> + </para> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_NOBODY</parameter>: Choisissez une valeur non nulle + pour que le corps du transfert ne soit pas inclus dans la valeur de retour. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_FAILONERROR</parameter>: Choisissez une valeur non nulle + pour que PHP traite silencieusement les codes HTTP supérieurs + à 300. Le comportement par défaut est de retourner la + page normalement, en ignorant ce code. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_UPLOAD</parameter>: Choisissez une valeur non nulle + pour que PHP prépare un chargement. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_POST</parameter>: Choisissez une valeur non nulle + pour que PHP fasse un HTTP POST. Un POST est un encodage normal + "application/x-www-from-url", utilisé couramment par les formulaires + HTML. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_FTPLISTONLY</parameter>: Choisissez une valeur non nulle + pour que PHP ne fasse que lister les noms d'un dossier FTP. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_FTPAPPEND</parameter>: Choisissez une valeur non nulle + pour que PHP concatène le fichier distant, plutôt que de + l'écraser. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_NETRC</parameter>: Choisissez une valeur non nulle + pour que PHP scanne votre fichier ~./netrc et utilise votre nom de + compte et mot de passe sur le site distant que vous souhaitez contacter. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_FOLLOWLOCATION</parameter>: Choisissez une valeur + non nulle pour suivre toutes les en-têtes "Location: " que le + serveur envoie dans les en-têtes HTTP (notez que cette fonction + est récursive, et que PHP suivra toutes les en-têtes + "Location: " qu'il trouvera). + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_PUT</parameter>: Choisissez une valeur non nulle + pour que pour chargement se fasse par HTTP PUT. Le fichier à + charger doit être fixé avec les options CURLOPT_INFILE + et CURLOPT_INFILESIZE. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_MUTE</parameter>: Choisissez une valeur non nulle + pour que PHP soit totalement silencieux concernant toutes les fonctions + CURL. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_TIMEOUT</parameter>: Passez un entier "long" comme + paramètre qui représente le temps maximum d'exécution + de la fonction CURL. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_LOW_SPEED_LIMIT</parameter>: Passez un entier long + qui représente la vitesse minimale en octets par secondes en + dessous de laquelle, et pendant CURLOPT_LOW_SPEED secondes, PHP + considèrera qu'elle est trop lente, et annulera le transfert. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_LOW_SPEED_TIME</parameter>: Passez un entier "long" + qui représente le temps en secondes, qui, si la vitesse de + transfert reste en dessous de CURLOPT_LOW_SPEED_LIMIT, PHP + considèrera que la connexion est trop lente, et l'annulera. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_RESUME_FROM</parameter>: Passez un entier "long", + qui représente l'offset, en octets, à partir duquel vous voulez + commencer le transfert. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_SSLVERSION</parameter>: Passez un entier "long" + qui contient la version de SSL (2 ou 3) à utiliser. Par + défaut, PHP essaiera de le déterminer par + lui-même, bien que dans certains cas, il vous faudra + le faire manuellement. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_TIMECONDITION</parameter>: Passez un entier "long" + qui définit comment CURLOPT_TIMEVALUE est utilisé. + Vous pouvez choisir entre les valeurs TIMECOND_IFMODSINCE ou + TIMECOND_ISUNMODSINCE. C'est une fonctionnalité HTTP. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_TIMEVALUE</parameter>: Passez un entier "long" + qui représente le temps en secondes depuis le 1er janvier 1970. + Cette valeur sera utilisée comme spécifié dans + l'option CURLOPT_TIMEVALUE. Par défaut, TIMECOND_IFMODSINCE + sera utilisé. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + <parameter>value</parameter> doit être une chaîne de + caractères pour les valeurs suivantes de <parameter>option</parameter> + <itemizedlist> + <listitem> + <simpara> + <parameter>CURLOPT_URL</parameter>: L'URL que PHP va récupérer. + Vous pouvez aussi choisir cette valeur lors de l'appel à + <function>curl_init</function>. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_USERPWD</parameter>: Passez une chaîne de + caractères au format [nom]:[mot de passe], pour que PHP + l'utilise lors de la connexion. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_PROXYUSERPWD</parameter>: Passez une chaîne + de caractères au format [nom]:[mot de passe ], pour que PHP + l'utilise lors de la connexion à un proxy HTTP. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_RANGE</parameter>: Passez une chaîne de + caractères qui représente la plage de valeur que + vous désirez. Elle est au format "X-Y", où les + valeurs de X ou Y peuvent être omises. Le transfert HTTP + supporte aussi plusieurs intervalles, séparé par + des virgules : X-Y,N-M. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_POSTFIELDS</parameter>: Passez une chaîne + de caractères qui contient toutes les données à + passer lors d'une opération de HTTP POST. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_REFERER</parameter>: Passez une chaîne de + caractères qui contient l'en-tête de "REFERER", + utilisé lors d'une requête HTTP. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_USERAGENT</parameter>: Passez une chaîne + de caractères qui contient l'en-tête "user-agent" + utilisé dans une requête HTTP. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_FTPPORT</parameter>: Passez une chaîne de + caractères qui désignera l'adresse IP utilisée + pour l'instruction FTP "PORT". L'instruction POST indique au serveur + distant de se connecter cette adresse IP. La chaîne peut + être une adresse IP, un nom d'hôte, un nom d'interface + réseau (sous UNIX), ou juste '-', pour utiliser les IP par + défaut du système. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_COOKIE</parameter>: Passez une chaîne de + caractères qui contiendra le contenu du cookie, à + transmettre dans l'en-tête HTTP. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_SSLCERT</parameter>: Passez une chaîne de + caractères qui contiendra le nom de fichier du certificat, + au format PEM. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_SSLCERTPASSWD</parameter>: Passez une chaîne + de caractères qui contient le mot de passe nécessaire + pour utiliser le certificat CURLOPT_SSLCERT. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_COOKIEFILE</parameter>: Passez une chaîne de + caractères qui contiendra le nom du fichier contenant les + données de cookie. Le fichier de cookie peut être au + format Netscape, ou simplement des en-têtes HTTP écrites + dans un fichier. + </simpara> + </listitem> + <listitem> + <para> + <parameter>CURLOPT_CUSTOMREQUEST</parameter>: Passez une chaîne + de caractères qui sera utilisé à la place de GET + ou HEAD lors des requêtes HTTP. Cette commande est pratique pour + effectuer un DELETE, ou une autre commande HTTP exotique. + <note> + <simpara> + N'utilisez pas cette commande sans vous assurer que le serveur l'accepte. + </simpara> + </note> + </para> + </listitem> + </itemizedlist> + </para> + <para> + Les options suivantes requièrent un pointeur de fichier, qui est + obtenu avec la fonction <function>fopen</function> : + <itemizedlist> + <listitem> + <simpara> + <parameter>CURLOPT_FILE</parameter>: Le fichier de sortie de votre transfert. + Par défaut, STDOUT. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_INFILE</parameter>: Le fichier d'entrée de + votre transfert. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_WRITEHEADER</parameter>: Le fichier de destination + de l'en-tête de la sortie du transfert. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_STDERR</parameter>: Le fichier d'erreurs. + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> + </refentry> + <refentry id="function.curl-exec"> + <refnamediv> + <refname>curl_exec</refname> + <refpurpose>Exécute une session CURL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean + <function>curl_exec</function> + </funcdef> + <paramdef>resource + <parameter>ch</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Cette fonction doit être appelée après + l'initialisation et le paramètrage d'une session CURL. + Son but est simplement d'éxécuter la session + <parameter>ch</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.curl-close"> + <refnamediv> + <refname>curl_close</refname> + <refpurpose>Ferme une session CURL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void + <function>curl_close</function> + </funcdef> + <paramdef>int + <parameter>ch</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>curl_close</function> ferme une session CURL et libère + toutes les ressources réservées. L'identifiant CURL, + <parameter>ch</parameter>, est aussi effacé. + </para> + </refsect1> + </refentry> + <refentry id="function.curl-version"> + <refnamediv> + <refname>curl_version</refname> + <refpurpose>Retourne la version courante de CURL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string + <function>curl_version</function> + </funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>curl_version</function> retourne une chaîne + avec la version courante de la librairie CURL. + </para> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml
Index: phpdoc/fr/functions/curl.xml diff -u phpdoc/fr/functions/curl.xml:1.5 phpdoc/fr/functions/curl.xml:1.6 --- phpdoc/fr/functions/curl.xml:1.5 Mon Mar 19 12:01:14 2001 +++ phpdoc/fr/functions/curl.xml Wed Jul 25 15:34:32 2001 @@ -1,46 +1,47 @@ - <reference id="ref.curl"> - <title>CURL</title> - <titleabbrev>CURL</titleabbrev> - <partintro id="curl.partintro"> - <para> - PHP supporte libcurl, une librairie créée par Daniel Stenberg, - qui vous permet de vous connecter de commniquer avec de nombreux serveurs, - grâce à de nombreux protocoles. libcurl supporte actuellement - les protocoles suivants : http, https, ftp, gopher, telnet, dict, file, et - ldap. libcurl supporte aussi les certificats HTTPS, les POST HTTP, PUT HTTP, - le chargement par FTP (ce qui peut être fait par l'extension FTP), - les chargement par formulaire HTTP, les proxies, les cookies et - l'autentification par mot de passe et nom de compte. - </para> - <para> - Pour pouvoir utiliser les fonctions CURL, vous devez installer le - package <ulink url="&url.curl;">CURL</ulink>. PHP requiert la version - CURL 7.0.2-beta ou plus récente. PHP ne fonctionnera pas avec - une version inférieure à la version 7.0.2-beta. - </para> - <para> - Pour utiliser CURL depuis les scripts PHP, vous devez aussi compiler PHP - avec l'option <option role="configure">--with-curl[=DIR]</option> - où DIR est le chemin jusqu'au dossier contenant les dossier - <filename>lib</filename> et <filename>include</filename>. Dans le - dossier <filename>include</filename> il doit se trouver un dossier - appelé <filename>curl</filename>, qui contient notamment les - fichiers <filename>easy.h</filename> et <filename>curl.h</filename>. - Il doit aussi se trouver un fichier nommé - <filename>libcurl.a</filename> dans le dossier <filename>lib</filename>. - </para> - <para> - Une fois que vous avez compilé PHP avec le support CURL, vous - pouvez commencer à l'exploiter avec vos scripts PHP. Le principe - de fonctionnement est d'initialiser une session CURL avec - <function>curl_init</function>, puis de choisir toutes vos options - de transfert avec <function>curl_exec</function> et de finir votre - session avec <function>curl_close</function>. Voici un exemple - d'utilisation des fonctions CURL, qui récupère la - page principale de PHP : - <example> - <title>Utilisation de CURL et PHP pour récupérer une page</title> - <programlisting role="php"> +<reference id="ref.curl"> + <title>CURL</title> + <titleabbrev>CURL</titleabbrev> + <partintro id="curl.partintro"> + <title>Introduction à CURL</title> + <para> + PHP supporte libcurl, une librairie créée par Daniel Stenberg, + qui vous permet de vous connecter de communiquer avec de nombreux serveurs, + grâce à de nombreux protocoles. libcurl supporte actuellement + les protocoles suivants : http, https, ftp, gopher, telnet, dict, file, et + ldap. libcurl supporte aussi les certificats HTTPS, les POST HTTP, PUT HTTP, + le chargement par FTP (ce qui peut être fait par l'extension FTP), + les chargement par formulaire HTTP, les proxies, les cookies et + l'authentification par mot de passe et nom de compte. + </para> + <para> + Pour pouvoir utiliser les fonctions CURL, vous devez installer le + package <ulink url="&url.curl;">CURL</ulink>. PHP requiert la version + CURL 7.0.2-beta ou plus récente. PHP ne fonctionnera pas avec + une version inférieure à la version 7.0.2-beta. + </para> + <para> + Pour utiliser CURL depuis les scripts PHP, vous devez aussi compiler PHP + avec l'option <link linkend="install.configure.with-curl"><option role="configure">--with-curl[=DIR]</option></link> + où DIR est le chemin jusqu'au dossier contenant les dossiers + <filename>lib</filename> et <filename>include</filename>. Dans le + dossier <filename>include</filename> il doit se trouver un dossier + appelé <filename>curl</filename>, qui contient notamment les + fichiers <filename>easy.h</filename> et <filename>curl.h</filename>. + Il doit aussi se trouver un fichier nommé + <filename>libcurl.a</filename> dans le dossier <filename>lib</filename>. + </para> + <para> + Une fois que vous avez compilé PHP avec le support CURL, vous + pouvez commencer à l'exploiter avec vos scripts PHP. Le principe + de fonctionnement est d'initialiser une session CURL avec + <function>curl_init</function>, puis de choisir toutes vos options + de transfert avec <function>curl_exec</function> et de finir votre + session avec <function>curl_close</function>. Voici un exemple + d'utilisation des fonctions CURL, qui récupère la + page principale de PHP : + <example> + <title>Utilisation de CURL et PHP pour récupérer une page</title> + <programlisting role="php"> <?php $ch = curl_init ("http://www.php.net/"); $fp = fopen ("php_homepage.txt", "w"); @@ -50,42 +51,42 @@ curl_close ($ch); fclose ($fp); ?> - </programlisting> - </example> - </para> - </partintro> - <refentry id="function.curl-init"> - <refnamediv> - <refname>curl_init</refname> - <refpurpose>Initialise une session CURL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>resource - <function>curl_init</function> - </funcdef> - <paramdef>string - <parameter> - <optional>url</optional> - </parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>curl_init</function> initialise une nouvelle session et retourne un - identifiant de session CURL, à utiliser avec les fonctions - <function>curl_setopt</function>, <function>curl_exec</function> - et <function>curl_close</function>. Si le paramètre optionnel - <parameter>url</parameter> est fourni, alors CURLOPT_URL prendra cette - valeur. Vous pouvez manuellement fixer cette valeur avec la fonction - <function>curl_setopt</function>. - <example> - <title> - Initialiser une sessions CURL et récupèration d'une page web. - </title> - <programlisting role="php"> + </programlisting> + </example> + </para> + </partintro> + <refentry id="function.curl-init"> + <refnamediv> + <refname>curl_init</refname> + <refpurpose>Initialise une session CURL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource + <function>curl_init</function> + </funcdef> + <paramdef>string + <parameter> + <optional>url</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>curl_init</function> initialise une nouvelle session et retourne un + identifiant de session CURL, à utiliser avec les fonctions + <function>curl_setopt</function>, <function>curl_exec</function> + et <function>curl_close</function>. Si le paramètre optionnel + <parameter>url</parameter> est fourni, alors CURLOPT_URL prendra cette + valeur. Vous pouvez manuellement fixer cette valeur avec la fonction + <function>curl_setopt</function>. + <example> + <title> + Initialiser une session CURL et récupèration d'une page web. + </title> + <programlisting role="php"> <?php $ch = curl_init(); curl_setopt ($ch, CURLOPT_URL, "http://www.zend.com/"); @@ -93,424 +94,423 @@ curl_exec ($ch); curl_close ($ch); ?> - </programlisting> - </example> - </para> - <para> - Voir aussi : <function>curl_close</function>, <function>curl_setopt</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.curl-setopt"> - <refnamediv> - <refname>curl_init</refname> - <refpurpose>Modifie une option de transfert CURL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool - <function>curl_setopt</function> - </funcdef> - <paramdef>resource - <parameter>ch</parameter> - </paramdef> - <paramdef>string - <parameter>option</parameter> - </paramdef> - <paramdef>mixed - <parameter>value</parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>curl_setopt</function> fixe les options de transfert de la - session CURL identifiée par <parameter>ch</parameter>. - <parameter>option</parameter> est le nom de l'option à fixer, - et <parameter>value</parameter> est sa valeur. - </para> - <para> - <parameter>value</parameter> doit être de type "long" pour - les options suivantes (specifiée par <parameter>option</parameter>) : - <itemizedlist> - <listitem> - <simpara> - <parameter>CURLOPT_INFILESIZE</parameter>: Lorsque vous - téléchargez un fichier sur un site distant, cette - option sert à indiquer à PHP la taille maximale du - fichier attendu. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_VERBOSE</parameter>: Choississez une valeur non nulle - pour que CURL vous affiche tous les événements. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_HEADER</parameter>: Choississez une valeur non nulle - pour que CURL inclus l'entête dans la valeur de retour. - </simpara> - </listitem> - <listitem> - <para> - <parameter>CURLOPT_NOPROGRESS</parameter>: Choississez une valeur non nulle - pour que PHP n'affiche pas l'état des transferts CURL. - <note> - <simpara> - PHP choisit automatiquement une valeur non nulle. Ne changez cette valeur - que le temps du débuggage. - </simpara> - </note> - </para> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_NOBODY</parameter>: Choississez une valeur non nulle - pour que le corps du transfert ne soit pas inclus dans la valeur de retour. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FAILONERROR</parameter>: Choississez une valeur non nulle - pour que PHP traite silencieusement les codes HTTP supérieurs - à 300. Le comportement par défaut est de retourner la - page normalement, en ignorant ce code. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_UPLOAD</parameter>: Choississez une valeur non nulle - pour que PHP prépare un chargement. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_POST</parameter>: Choississez une valeur non nulle - pour que PHP fasse un HTTP POST. Un POST est un encodage normal - "application/x-www-from-url", utilisé couramment par les formulaires - HTML. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FTPLISTONLY</parameter>: Choississez une valeur non nulle - pour que PHP ne fasse que lister les noms d'un dossier FTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FTPAPPEND</parameter>: Choississez une valeur non nulle - pour que PHP concatène le fichier distant, plutôt que de - l'écraser. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_NETRC</parameter>: Choississez une valeur non nulle - pour que PHP scanne votre fichier ~./netrc et utilise votre nom de - compte et mot de passe sur le site distant que vous souhaitez contacter. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FOLLOWLOCATION</parameter>: Choississez une valeur - non nulle pour suivre toutes les entêtes "Location: " que le - serveur envoie dans les entêtes HTTP (notez que cette fonction - est récursive, et que PHP suivra toutes les entêtes - "Location: " qu'il trouvera). - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_PUT</parameter>: Choississez une valeur non nulle - pour que pour chargement se fasse par HTTP PUT. Le fichier à - charger doit être fixé avec les options CURLOPT_INFILE - et CURLOPT_INFILESIZE. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_MUTE</parameter>: Choississez une valeur non nulle - pour que PHP soit totalement silencieux concernant toutes les fonctions - CURL. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_TIMEOUT</parameter>: Passez un entier "long" comme - paramètre qui représente le temps maximum d'exécution - de la fonction CURL. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_LOW_SPEED_LIMIT</parameter>: Passez un entier long - qui représente la vitesse minimale en octets par secondes en - dessous de laquelle, et pendant CURLOPT_LOW_SPEED secondes, PHP - considèrera qu'elle est trop lente, et annulera le transfert. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_LOW_SPEED_TIME</parameter>: Passez un entier "long" - qui représente le temps en secondes, qui, si la vitesse de - transfert reste en dessous de CURLOPT_LOW_SPEED_LIMIT, PHP - considèrera que la connexion est trop lente, et l'annulera. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_RESUME_FROM</parameter>: Passez un entier "long", - qui représente l'offset, en octets, à partir duquel vous voulez - commencer le transfert. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_SSLVERSION</parameter>: Passez un entier "long" - qui contient la version de SSL (2 ou 3) à utiliser. Par - défaut, PHP essaiera de le déterminer par - lui-même, bien que dans certains cas, il vous faudra - le faire manuellement. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_TIMECONDITION</parameter>: Passez un entier "long" - qui définit comment CURLOPT_TIMEVALUE est utilisé. - Vous pouvez choisir entre les valeurs TIMECOND_IFMODSINCE ou - TIMECOND_ISUNMODSINCE. C'est une fonctionnalité HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_TIMEVALUE</parameter>: Passez un entier "long" - qui représente le temps en secondes depuis le 1er janvier 1970. - Cette valeur sera utilisée comme spécifié dans - l'option CURLOPT_TIMEVALUE. Par défaut, TIMECOND_IFMODSINCE - sera utilisé. - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - <parameter>value</parameter> doit être une chaîne de - caractères pour les valeurs suivantes de <parameter>option</parameter> - <itemizedlist> - <listitem> - <simpara> - <parameter>CURLOPT_URL</parameter>: L'URL que PHP va récupérer. - Vous pouvez aussi choisir cette v aleur lors de l'appel à - <function>curl_init</function>. - function. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_USERPWD</parameter>: Passez une chaîne de - caractères au format [nom]:[mot de passe], pour que PHP - l'utilise lors de la connexion. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_PROXYUSERPWD</parameter>: Passez une chaîne - de caractères au format [nom]:[mot de passe ], pour que PHP - l'utilise lors de la connexion à un proxy HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_RANGE</parameter>: Passez une chaîne de - caractères qui représente la plage de valeur que - vous désirez. Elle est au format "X-Y", où les - valeurs de X ou Y peuvent être omises. Le transfert HTTP - supporte aussi plusieurs intervalles, séparé par - des virgules : X-Y,N-M. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_POSTFIELDS</parameter>: Passez une chaîne - de caractères qui contient toutes les données à - passer lors d'une opération de HTTP POST. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_REFERER</parameter>: Passez une chaîne de - caractères qui contient l'entête de "REFERER", - utilisé lors d'une requête HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_USERAGENT</parameter>: Passez une chaîne - de caractères qui contient l'entête "user-agent" - utilisé dans une requête HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FTPPORT</parameter>: Passez une chaîne de - caractères qui désignera l'adresse IP utilisée - pour l'instruction FTP "PORT". L'instruction POST indique au serveur - distant de se connecter cette adresse IP. La chaîne peut - être une adresse IP, un nom d'hôte, un nom d'interface - réseau (sous UNIX), ou juste '-', pour utiliser les IP par - défaut du système. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_COOKIE</parameter>: Passez une chaîne de - caractères qui contiendra le contenu du cookie, à - transmettre dans l'entête HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_SSLCERT</parameter>: Passez une chaîne de - caractères qui contiendra le nom de fichier du certificat, - au format PEM. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_SSLCERTPASSWD</parameter>: Passez une chaîne - de caractères qui contient le mot de passe nécessaire - pour utiliser le certificat CURLOPT_SSLCERT. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_COOKIEFILE</parameter>: Passez une chaîne de - caractères qui contiendra le nom du fichier contenant les - données de cookie. Le fichier de cookie peut être au - format Netscape, ou simplement des entêtes HTTP écrites - dans un fichier. - </simpara> - </listitem> - <listitem> - <para> - <parameter>CURLOPT_CUSTOMREQUEST</parameter>: Passez une chaîne - de caractères qui sera utilisé à la place de GET - ou HEAD lors des requêtes HTTP. Cette commande est pratique pour - effectuer un DELETE, ou une autre commande HTTP exotique. - <note> - <simpara> - N'utilisez pas cette commande sans vous assurer que le serveur l'accepte. - </simpara> - </note> - </para> - </listitem> - </itemizedlist> - </para> - <para> - Les options suivantes requièrent un pointeur de fichier, qui est - obtenu avec la fonction <function>fopen</function> : - <itemizedlist> - <listitem> - <simpara> - <parameter>CURLOPT_FILE</parameter>: Le fichier de sortie de votre transfert. - Par défaut, STDOUT. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_INFILE</parameter>: Le fichier d'entrée de - votre transfert. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_WRITEHEADER</parameter>: Le fichier de destination - de l'entête de la sortie du transfert. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_STDERR</parameter>: Le fichier d'erreurs. - </simpara> - </listitem> - </itemizedlist> - </para> - </refsect1> - </refentry> - <refentry id="function.curl-exec"> - <refnamediv> - <refname>curl_exec</refname> - <refpurpose>Excécute une session CURL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool - <function>curl_exec</function> - </funcdef> - <paramdef>resource - <parameter>ch</parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - Cette fonction doit être appelée après - l'initialisation et le paramètrage d'une session CURL. - Son but est simplement d'éxécuter la session - <parameter>ch</parameter>. - </para> - </refsect1> - </refentry> - <refentry id="function.curl-close"> - <refnamediv> - <refname>curl_close</refname> - <refpurpose>Ferme une session CURL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void - <function>curl_close</function> - </funcdef> - <paramdef>int - <parameter>ch</parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>curl_close</function> ferme une session CURL et libère - toutes les ressources reservées. L'identifiant CURL, - <parameter>ch</parameter>, est aussi effacé. - </para> - </refsect1> - </refentry> - <refentry id="function.curl-version"> - <refnamediv> - <refname>curl_version</refname> - <refpurpose>Retourne la version courante de CURL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string - <function>curl_version</function> - </funcdef> - <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>curl_version</function> retourne une chaîne - avec la version courante de la librairie CURL. - </para> - </refsect1> - </refentry> - </reference> + </programlisting> + </example> + </para> + <para> + Voir aussi : <function>curl_close</function>, <function>curl_setopt</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.curl-setopt"> + <refnamediv> + <refname>curl_init</refname> + <refpurpose>Modifie une option de transfert CURL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean + <function>curl_setopt</function> + </funcdef> + <paramdef>resource + <parameter>ch</parameter> + </paramdef> + <paramdef>string + <parameter>option</parameter> + </paramdef> + <paramdef>mixed + <parameter>value</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>curl_setopt</function> fixe les options de transfert de la + session CURL identifiée par <parameter>ch</parameter>. + <parameter>option</parameter> est le nom de l'option à fixer, + et <parameter>value</parameter> est sa valeur. + </para> + <para> + <parameter>value</parameter> doit être de type "long" pour + les options suivantes (spécifiée par <parameter>option</parameter>) : + <itemizedlist> + <listitem> + <simpara> + <parameter>CURLOPT_INFILESIZE</parameter>: Lorsque vous + téléchargez un fichier sur un site distant, cette + option sert à indiquer à PHP la taille maximale du + fichier attendu. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_VERBOSE</parameter>: Choisissez une valeur non nulle + pour que CURL vous affiche tous les événements. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_HEADER</parameter>: Choisissez une valeur non nulle + pour que CURL inclut l'en-tête dans la valeur de retour. + </simpara> + </listitem> + <listitem> + <para> + <parameter>CURLOPT_NOPROGRESS</parameter>: Choisissez une valeur non nulle + pour que PHP n'affiche pas l'état des transferts CURL. + <note> + <simpara> + PHP choisit automatiquement une valeur non nulle. Ne changez cette valeur + que le temps du débuggage. + </simpara> + </note> + </para> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_NOBODY</parameter>: Choisissez une valeur non nulle + pour que le corps du transfert ne soit pas inclus dans la valeur de retour. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_FAILONERROR</parameter>: Choisissez une valeur non nulle + pour que PHP traite silencieusement les codes HTTP supérieurs + à 300. Le comportement par défaut est de retourner la + page normalement, en ignorant ce code. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_UPLOAD</parameter>: Choisissez une valeur non nulle + pour que PHP prépare un chargement. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_POST</parameter>: Choisissez une valeur non nulle + pour que PHP fasse un HTTP POST. Un POST est un encodage normal + "application/x-www-from-url", utilisé couramment par les formulaires + HTML. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_FTPLISTONLY</parameter>: Choisissez une valeur non nulle + pour que PHP ne fasse que lister les noms d'un dossier FTP. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_FTPAPPEND</parameter>: Choisissez une valeur non nulle + pour que PHP concatène le fichier distant, plutôt que de + l'écraser. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_NETRC</parameter>: Choisissez une valeur non nulle + pour que PHP scanne votre fichier ~./netrc et utilise votre nom de + compte et mot de passe sur le site distant que vous souhaitez contacter. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_FOLLOWLOCATION</parameter>: Choisissez une valeur + non nulle pour suivre toutes les en-têtes "Location: " que le + serveur envoie dans les en-têtes HTTP (notez que cette fonction + est récursive, et que PHP suivra toutes les en-têtes + "Location: " qu'il trouvera). + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_PUT</parameter>: Choisissez une valeur non nulle + pour que pour chargement se fasse par HTTP PUT. Le fichier à + charger doit être fixé avec les options CURLOPT_INFILE + et CURLOPT_INFILESIZE. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_MUTE</parameter>: Choisissez une valeur non nulle + pour que PHP soit totalement silencieux concernant toutes les fonctions + CURL. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_TIMEOUT</parameter>: Passez un entier "long" comme + paramètre qui représente le temps maximum d'exécution + de la fonction CURL. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_LOW_SPEED_LIMIT</parameter>: Passez un entier long + qui représente la vitesse minimale en octets par secondes en + dessous de laquelle, et pendant CURLOPT_LOW_SPEED secondes, PHP + considèrera qu'elle est trop lente, et annulera le transfert. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_LOW_SPEED_TIME</parameter>: Passez un entier "long" + qui représente le temps en secondes, qui, si la vitesse de + transfert reste en dessous de CURLOPT_LOW_SPEED_LIMIT, PHP + considèrera que la connexion est trop lente, et l'annulera. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_RESUME_FROM</parameter>: Passez un entier "long", + qui représente l'offset, en octets, à partir duquel vous voulez + commencer le transfert. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_SSLVERSION</parameter>: Passez un entier "long" + qui contient la version de SSL (2 ou 3) à utiliser. Par + défaut, PHP essaiera de le déterminer par + lui-même, bien que dans certains cas, il vous faudra + le faire manuellement. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_TIMECONDITION</parameter>: Passez un entier "long" + qui définit comment CURLOPT_TIMEVALUE est utilisé. + Vous pouvez choisir entre les valeurs TIMECOND_IFMODSINCE ou + TIMECOND_ISUNMODSINCE. C'est une fonctionnalité HTTP. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_TIMEVALUE</parameter>: Passez un entier "long" + qui représente le temps en secondes depuis le 1er janvier 1970. + Cette valeur sera utilisée comme spécifié dans + l'option CURLOPT_TIMEVALUE. Par défaut, TIMECOND_IFMODSINCE + sera utilisé. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + <parameter>value</parameter> doit être une chaîne de + caractères pour les valeurs suivantes de <parameter>option</parameter> + <itemizedlist> + <listitem> + <simpara> + <parameter>CURLOPT_URL</parameter>: L'URL que PHP va récupérer. + Vous pouvez aussi choisir cette valeur lors de l'appel à + <function>curl_init</function>. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_USERPWD</parameter>: Passez une chaîne de + caractères au format [nom]:[mot de passe], pour que PHP + l'utilise lors de la connexion. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_PROXYUSERPWD</parameter>: Passez une chaîne + de caractères au format [nom]:[mot de passe ], pour que PHP + l'utilise lors de la connexion à un proxy HTTP. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_RANGE</parameter>: Passez une chaîne de + caractères qui représente la plage de valeur que + vous désirez. Elle est au format "X-Y", où les + valeurs de X ou Y peuvent être omises. Le transfert HTTP + supporte aussi plusieurs intervalles, séparé par + des virgules : X-Y,N-M. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_POSTFIELDS</parameter>: Passez une chaîne + de caractères qui contient toutes les données à + passer lors d'une opération de HTTP POST. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_REFERER</parameter>: Passez une chaîne de + caractères qui contient l'en-tête de "REFERER", + utilisé lors d'une requête HTTP. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_USERAGENT</parameter>: Passez une chaîne + de caractères qui contient l'en-tête "user-agent" + utilisé dans une requête HTTP. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_FTPPORT</parameter>: Passez une chaîne de + caractères qui désignera l'adresse IP utilisée + pour l'instruction FTP "PORT". L'instruction POST indique au serveur + distant de se connecter cette adresse IP. La chaîne peut + être une adresse IP, un nom d'hôte, un nom d'interface + réseau (sous UNIX), ou juste '-', pour utiliser les IP par + défaut du système. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_COOKIE</parameter>: Passez une chaîne de + caractères qui contiendra le contenu du cookie, à + transmettre dans l'en-tête HTTP. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_SSLCERT</parameter>: Passez une chaîne de + caractères qui contiendra le nom de fichier du certificat, + au format PEM. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_SSLCERTPASSWD</parameter>: Passez une chaîne + de caractères qui contient le mot de passe nécessaire + pour utiliser le certificat CURLOPT_SSLCERT. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_COOKIEFILE</parameter>: Passez une chaîne de + caractères qui contiendra le nom du fichier contenant les + données de cookie. Le fichier de cookie peut être au + format Netscape, ou simplement des en-têtes HTTP écrites + dans un fichier. + </simpara> + </listitem> + <listitem> + <para> + <parameter>CURLOPT_CUSTOMREQUEST</parameter>: Passez une chaîne + de caractères qui sera utilisé à la place de GET + ou HEAD lors des requêtes HTTP. Cette commande est pratique pour + effectuer un DELETE, ou une autre commande HTTP exotique. + <note> + <simpara> + N'utilisez pas cette commande sans vous assurer que le serveur l'accepte. + </simpara> + </note> + </para> + </listitem> + </itemizedlist> + </para> + <para> + Les options suivantes requièrent un pointeur de fichier, qui est + obtenu avec la fonction <function>fopen</function> : + <itemizedlist> + <listitem> + <simpara> + <parameter>CURLOPT_FILE</parameter>: Le fichier de sortie de votre transfert. + Par défaut, STDOUT. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_INFILE</parameter>: Le fichier d'entrée de + votre transfert. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_WRITEHEADER</parameter>: Le fichier de destination + de l'en-tête de la sortie du transfert. + </simpara> + </listitem> + <listitem> + <simpara> + <parameter>CURLOPT_STDERR</parameter>: Le fichier d'erreurs. + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> + </refentry> + <refentry id="function.curl-exec"> + <refnamediv> + <refname>curl_exec</refname> + <refpurpose>Exécute une session CURL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean + <function>curl_exec</function> + </funcdef> + <paramdef>resource + <parameter>ch</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Cette fonction doit être appelée après + l'initialisation et le paramètrage d'une session CURL. + Son but est simplement d'éxécuter la session + <parameter>ch</parameter>. + </para> + </refsect1> + </refentry> + <refentry id="function.curl-close"> + <refnamediv> + <refname>curl_close</refname> + <refpurpose>Ferme une session CURL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void + <function>curl_close</function> + </funcdef> + <paramdef>int + <parameter>ch</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>curl_close</function> ferme une session CURL et libère + toutes les ressources réservées. L'identifiant CURL, + <parameter>ch</parameter>, est aussi effacé. + </para> + </refsect1> + </refentry> + <refentry id="function.curl-version"> + <refnamediv> + <refname>curl_version</refname> + <refpurpose>Retourne la version courante de CURL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string + <function>curl_version</function> + </funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>curl_version</function> retourne une chaîne + avec la version courante de la librairie CURL. + </para> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml