cvs: phpdoc-fr / language-snippets.ent /appendices wrappers.xml /install ini.xml /language/oop5 overloading.xml /reference/apache/functions
apache-lookup-uri.xml /reference/curl configure.xml reference.xml /reference/curl/functions curl-close.xml curl-copy-handle.xml curl-errno.xml
curl-error.xml curl-exec.xml curl-getinfo.xml curl-init.xml curl-multi-add-handle.xml curl-multi-close.xml curl-multi-exec.xml
curl-multi-getcontent.xml curl-multi-info-read.xml curl-multi-init.xml curl-multi-remove-handle.xml curl-multi-select.xml curl-setopt-array.xml
curl-setopt.xml curl-version.xml /reference/datetime reference.xml /reference/datetime/functions date.xml strptime.xml /reference/dbm reference.xml

From: Date: Sun, 21 Jan 2007 09:17:44 +0000
Subject: cvs: phpdoc-fr / language-snippets.ent /appendices wrappers.xml /install ini.xml /language/oop5 overloading.xml /reference/apache/functions
apache-lookup-uri.xml /reference/curl configure.xml reference.xml /reference/curl/functions curl-close.xml curl-copy-handle.xml curl-errno.xml
curl-error.xml curl-exec.xml curl-getinfo.xml curl-init.xml curl-multi-add-handle.xml curl-multi-close.xml curl-multi-exec.xml
curl-multi-getcontent.xml curl-multi-info-read.xml curl-multi-init.xml curl-multi-remove-handle.xml curl-multi-select.xml curl-setopt-array.xml
curl-setopt.xml curl-version.xml /reference/datetime reference.xml /reference/datetime/functions date.xml strptime.xml /reference/dbm reference.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-5178@lists.php.net to get a copy of this message
yannick Sun Jan 21 09:17:44 2007 UTC Modified files: /phpdoc-fr/appendices wrappers.xml /phpdoc-fr/install ini.xml /phpdoc-fr/language/oop5 overloading.xml /phpdoc-fr language-snippets.ent /phpdoc-fr/reference/apache/functions apache-lookup-uri.xml /phpdoc-fr/reference/curl configure.xml reference.xml /phpdoc-fr/reference/curl/functions curl-close.xml curl-copy-handle.xml curl-errno.xml curl-error.xml curl-exec.xml curl-getinfo.xml curl-init.xml curl-multi-add-handle.xml curl-multi-close.xml curl-multi-exec.xml curl-multi-getcontent.xml curl-multi-info-read.xml curl-multi-init.xml curl-multi-remove-handle.xml curl-multi-select.xml curl-setopt-array.xml curl-setopt.xml curl-version.xml /phpdoc-fr/reference/datetime/functions date.xml strptime.xml /phpdoc-fr/reference/datetime reference.xml /phpdoc-fr/reference/dbm reference.xml Log: sync with EN

http://cvs.php.net/viewvc.cgi/phpdoc-fr/appendices/wrappers.xml?r1=1.39&r2=1.40&diff_format=u Index: phpdoc-fr/appendices/wrappers.xml diff -u phpdoc-fr/appendices/wrappers.xml:1.39 phpdoc-fr/appendices/wrappers.xml:1.40 --- phpdoc-fr/appendices/wrappers.xml:1.39 Thu Dec 21 17:29:40 2006 +++ phpdoc-fr/appendices/wrappers.xml Sun Jan 21 09:17:43 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.39 $ --> -<!-- EN-Revision: 1.67 Maintainer: dams Status: ready --> +<!-- $Revision: 1.40 $ --> +<!-- EN-Revision: 1.68 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <appendix id="wrappers"> @@ -388,15 +388,11 @@ <entry>20</entry> </row> <row> - <entry><literal>request_fulluri</literal></entry> + <entry><literal>protocol_version</literal></entry> <entry> - Lorsque cette option vaut &true;, l'URI entière sera utilisée lors - de la construction de la requête. (i.e. - <literal>GET http://www.example.com/path/to/file.html HTTP/1.0</literal>). - Même si ce n'est pas la méthode standard, certains - proxies le requièrent. + Version du protocole HTTP. Ajouté en &php; 5.1.0. </entry> - <entry>&false;</entry> + <entry>1.0</entry> </row> </tbody> </tgroup> http://cvs.php.net/viewvc.cgi/phpdoc-fr/install/ini.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/install/ini.xml diff -u phpdoc-fr/install/ini.xml:1.12 phpdoc-fr/install/ini.xml:1.13 --- phpdoc-fr/install/ini.xml:1.12 Fri Dec 8 08:48:33 2006 +++ phpdoc-fr/install/ini.xml Sun Jan 21 09:17:43 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.15 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <chapter id="configuration"> @@ -37,6 +37,15 @@ </listitem> <listitem> <para> + Depuis &php; 5.2.0, les clés de registre suivantes sont cherchées dans cet ordre : + <literal>HKEY_LOCAL_MACHINE\SOFTWARE\PHP\IniFilePath\x.y.z</literal>, + <literal>HKEY_LOCAL_MACHINE\SOFTWARE\PHP\IniFilePath\x.y</literal> et + <literal>HKEY_LOCAL_MACHINE\SOFTWARE\PHP\IniFilePath\x</literal>, où + x, y et z signifie les versions majeurs, mineurs et normales. + </para> + </listitem> + <listitem> + <para> <literal>HKEY_LOCAL_MACHINE\SOFTWARE\PHP\IniFilePath</literal> (Registre Windows) </para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/oop5/overloading.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc-fr/language/oop5/overloading.xml diff -u phpdoc-fr/language/oop5/overloading.xml:1.17 phpdoc-fr/language/oop5/overloading.xml:1.18 --- phpdoc-fr/language/oop5/overloading.xml:1.17 Fri Jan 12 16:52:07 2007 +++ phpdoc-fr/language/oop5/overloading.xml Sun Jan 21 09:17:43 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.15 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <sect1 id="language.oop5.overloading"> @@ -171,14 +171,14 @@ </methodsynopsis> <para> - Les méthodes d'une classe peuvent être surchargées pour exécuter un code - spécial contenu dans votre méthode <function>__call</function>. - Le paramètre <varname>$name</varname> utilisé est le nom de la fonction - que l'on souhaite utiliser. Les arguments qui étaient passés à la fonction - sont récupérés dans un tableau contenu dans le paramètre - <varname>$arguments</varname>. - La valeur retournée par la méthode <function>__call</function> sera celle - retournée au point d'appel de la méthode d'origine. + La méthode magique __call() permet de capture l'appel à des méthodes + non existantes. De cette façon, __call() peut être utilisée pour implémenter + un gestionnaire de méthodes défini par l'utilisateur qui dépend du nom de + la méthode actuellement appelée. Ceci est particulièrement pratique + pour implémenter un proxy, par exemple. Les arguments qui sont passés + à la fonction devront être définis dans un tableau via le paramètre + <varname>$arguments</varname>. La valeur retournée de la méthode __call() + sera retournée à la méthode appelante. </para> <example> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language-snippets.ent?r1=1.157&r2=1.158&diff_format=u Index: phpdoc-fr/language-snippets.ent diff -u phpdoc-fr/language-snippets.ent:1.157 phpdoc-fr/language-snippets.ent:1.158 --- phpdoc-fr/language-snippets.ent:1.157 Sun Jan 14 08:10:49 2007 +++ phpdoc-fr/language-snippets.ent Sun Jan 21 09:17:43 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.157 $ --> -<!-- EN-Revision: 1.181 Maintainer: dams Status: ready --> +<!-- $Revision: 1.158 $ --> +<!-- EN-Revision: 1.184 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <!-- @@ -258,6 +258,28 @@ dbm_identifier</parameter></term><listitem><para>L&#39;identifiant de lien DBM, retourné par la fonction <function>dbmopen</function>.</para></listitem></varlistentry>'> +<!-- cURL notes --> + +<!ENTITY curl.ch.description '<varlistentry><term><parameter>ch</parameter> +</term><listitem><para>Un gestionnaire cURL retourné par la fonction +<function>curl_init</function>.</para></listitem></varlistentry>'> + +<!ENTITY curl.mh.description '<varlistentry><term><parameter>mh</parameter> +</term><listitem><para>Un gestionnaire cURL multiple retourné par la fonction +<function>curl_multi_init</function>.</para></listitem></varlistentry>'> + +<!-- IMAP notes --> + +<!ENTITY imap.imap-stream.description '<varlistentry><term><parameter> +imap_stream</parameter></term><listitem><para>Un flux IMPA retourné par la fonction +<function>imap_open</function>.</para></listitem></varlistentry>'> + +<!-- MCVE notes --> + +<!ENTITY mcve.conn.description '<varlistentry><term><parameter> +conn</parameter></term><listitem><para>Une ressource MCVE_CONN retournée par la fonction +<function>m_initengine</function>.</para></listitem></varlistentry>'> + <!-- Date and time entities --> <!ENTITY date.timezone.errors.description '<para> Chaque appel à une fonction date/heure génèrera un message de type http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/apache/functions/apache-lookup-uri.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/apache/functions/apache-lookup-uri.xml diff -u phpdoc-fr/reference/apache/functions/apache-lookup-uri.xml:1.10 phpdoc-fr/reference/apache/functions/apache-lookup-uri.xml:1.11 --- phpdoc-fr/reference/apache/functions/apache-lookup-uri.xml:1.10 Thu Nov 9 16:03:28 2006 +++ phpdoc-fr/reference/apache/functions/apache-lookup-uri.xml Sun Jan 21 09:17:44 2007 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.7 Maintainer: jsgoupil Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.8 Maintainer: jsgoupil Status: ready --> <!-- Reviewed: yes --> + <refentry id="function.apache-lookup-uri"> <refnamediv> <refname>apache_lookup_uri</refname> @@ -33,7 +34,7 @@ <term><parameter>filename</parameter></term> <listitem> <para> - Le nom du fichier (URI) qui sera demandé ou &false; en cas d'échec. + Le nom du fichier (URI) qui sera demandé. </para> </listitem> </varlistentry> @@ -141,4 +142,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/configure.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/curl/configure.xml diff -u phpdoc-fr/reference/curl/configure.xml:1.11 phpdoc-fr/reference/curl/configure.xml:1.12 --- phpdoc-fr/reference/curl/configure.xml:1.11 Sun Aug 27 20:47:29 2006 +++ phpdoc-fr/reference/curl/configure.xml Sun Jan 21 09:17:44 2007 @@ -1,36 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.8 Maintainer: didou Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <section id="curl.installation"> - &reftitle.install; - <para> - Pour utiliser CURL depuis les scripts &php;, vous devez compiler celui-ci - avec l'option <option role="configure">--with-curl[=DIR]</option> - 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>. - À partir de &php; 4.3.0, vous pouvez aussi configurer &php; pour qu'il - utilise curl comme gestionnaire d'URL avec l'option - <option role="configure">--with-curlwrappers</option>. - </para> - <note> - <title>Note aux utilisateurs Win32</title> - <simpara> - Afin d'activer ce module dans l'environnement Windows, - <filename>libeay32.dll</filename> et <filename>ssleay32.dll</filename> - doivent être présents dans votre PATH. - </simpara> - <simpara> - Vous n'avez pas besoin de <filename>libcurl.dll</filename> du site CURL. - </simpara> - </note> - </section> +<section id="curl.installation"> + &reftitle.install; + <para> + Pour utiliser cURL depuis les scripts &php;, vous devez compiler celui-ci + avec l'option <option role="configure">--with-curl[=DIR]</option> + 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>. + À partir de &php; 4.3.0, vous pouvez aussi configurer &php; pour qu'il + utilise cURL comme gestionnaire d'URL avec l'option + <option role="configure">--with-curlwrappers</option>. + </para> + <note> + <title>Note aux utilisateurs Win32</title> + <simpara> + Afin d'activer ce module dans l'environnement Windows, + <filename>libeay32.dll</filename> et <filename>ssleay32.dll</filename> + doivent être présents dans votre PATH. + </simpara> + <simpara> + Vous n'avez pas besoin de <filename>libcurl.dll</filename> du site cURL. + </simpara> + </note> +</section> <!-- Keep this comment at the end of the file Local variables: @@ -51,4 +51,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/reference.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/curl/reference.xml diff -u phpdoc-fr/reference/curl/reference.xml:1.16 phpdoc-fr/reference/curl/reference.xml:1.17 --- phpdoc-fr/reference/curl/reference.xml:1.16 Sun Aug 27 20:47:29 2006 +++ phpdoc-fr/reference/curl/reference.xml Sun Jan 21 09:17:44 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.14 Maintainer: didou Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.15 Maintainer: yannick Status: ready --> <!-- Purpose: remote.other --> <!-- Membership: bundled, external --> <!-- Reviewed: no --> @@ -31,7 +31,7 @@ <section id="curl.requirements"> &reftitle.required; <para> - Pour pouvoir utiliser les fonctions de &php; CURL, vous devez installer le + Pour pouvoir utiliser les fonctions de &php; cURL, vous devez installer le paquetage <ulink url="&url.curl;">libcurl</ulink>. &php; requiert la version libcurl 7.0.2-beta ou plus récente. En &php; 4.2.3, vous aurez besoin de libcurl version 7.9.0 ou plus. À partir de &php; @@ -48,17 +48,17 @@ <section id="curl.examples"> &reftitle.examples; <para> - Une fois que vous avez compilé &php; avec le support CURL, vous + 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 + de fonctionnement est d'initialiser une session cURL avec <function>curl_init</function>, puis de choisir toutes vos options de transfert avec <function>curl_setopt</function>, puis d'exécuter la session 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 + d'utilisation des fonctions cURL, qui récupère la page principale de example.com dans un fichier : <example> - <title>Utilisation de CURL pour récupérer une page</title> + <title>Utilisation de cURL pour récupérer une page</title> <programlisting role="php"> <![CDATA[ <?php http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-close.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-close.xml diff -u phpdoc-fr/reference/curl/functions/curl-close.xml:1.8 phpdoc-fr/reference/curl/functions/curl-close.xml:1.9 --- phpdoc-fr/reference/curl/functions/curl-close.xml:1.8 Sun Aug 27 20:47:29 2006 +++ phpdoc-fr/reference/curl/functions/curl-close.xml Sun Jan 21 09:17:44 2007 @@ -1,33 +1,52 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.7 Maintainer: didou Status: ready --> <!-- Reviewed: no --> - <refentry id="function.curl-close"> - <refnamediv> - <refname>curl_close</refname> - <refpurpose>Ferme une session CURL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>void</type><methodname>curl_close</methodname> - <methodparam><type>resource</type><parameter>ch</parameter></methodparam> - </methodsynopsis> - <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> - <para> - <example> - <title> - Initialise une session CURL et récupère une page web - </title> - <programlisting role="php"> +<refentry id="function.curl-close"> + <refnamediv> + <refname>curl_close</refname> + <refpurpose>Ferme une session CURL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>curl_close</methodname> + <methodparam><type>resource</type><parameter>ch</parameter></methodparam> + </methodsynopsis> + <para> + Ferme une session cURL et libère toutes les ressources + réservées. L'identifiant cURL <parameter>ch</parameter> + est aussi effacé. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &curl.ch.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Initialise une session cURL et récupère une page web</title> + <programlisting role="php"> <![CDATA[ <?php -// création d'une nouvelle ressource CURL +// création d'une nouvelle ressource cURL $ch = curl_init(); // configuration de l'URL et d'autres options @@ -37,18 +56,25 @@ // récupération de l'URL et affichage sur le naviguateur curl_exec($ch); -// fermeture de la session curl +// fermeture de la session cURL curl_close($ch); ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi <function>curl_init</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>curl_init</function></member> + <member><function>curl_multi_close</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -69,4 +95,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-copy-handle.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-copy-handle.xml diff -u phpdoc-fr/reference/curl/functions/curl-copy-handle.xml:1.4 phpdoc-fr/reference/curl/functions/curl-copy-handle.xml:1.5 --- phpdoc-fr/reference/curl/functions/curl-copy-handle.xml:1.4 Sun Aug 27 20:47:30 2006 +++ phpdoc-fr/reference/curl/functions/curl-copy-handle.xml Sun Jan 21 09:17:44 2007 @@ -1,32 +1,51 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: jsgoupil Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.6 Maintainer: jsgoupil Status: ready --> <!-- Reviewed: no --> <refentry id="function.curl-copy-handle"> <refnamediv> <refname>curl_copy_handle</refname> - <refpurpose> - Copie une ressource cURL avec toutes ses préférences - </refpurpose> + <refpurpose>Copie une ressource cURL avec toutes ses préférences</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>resource</type><methodname>curl_copy_handle</methodname> <methodparam><type>resource</type><parameter>ch</parameter></methodparam> </methodsynopsis> <para> - Cette fonction copie une ressource cURL, retournant une nouvelle ressource + Copie une ressource cURL, retournant une nouvelle ressource cURL avec les mêmes préférences. </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &curl.ch.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne une nouvelle ressource cURL. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title>Copie d'une ressource cURL</title> <programlisting role="php"> <![CDATA[ <?php -// crée une nouvelle ressource curl +// crée une nouvelle ressource cURL $ch = curl_init(); // assigne URL et autres options appropriées @@ -69,4 +88,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-errno.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-errno.xml diff -u phpdoc-fr/reference/curl/functions/curl-errno.xml:1.8 phpdoc-fr/reference/curl/functions/curl-errno.xml:1.9 --- phpdoc-fr/reference/curl/functions/curl-errno.xml:1.8 Sun Aug 27 20:47:30 2006 +++ phpdoc-fr/reference/curl/functions/curl-errno.xml Sun Jan 21 09:17:44 2007 @@ -1,33 +1,52 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.7 Maintainer: didou Status: ready --> <!-- Reviewed: no --> - <refentry id="function.curl-errno"> - <refnamediv> - <refname>curl_errno</refname> - <refpurpose> - Retourne un entier représentant le dernier message d'erreur CURL - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>curl_errno</methodname> - <methodparam><type>resource</type><parameter>ch</parameter></methodparam> - </methodsynopsis> - <para> - <function>curl_errno</function> retourne le numéro d'erreur - de la dernière opération cURL, avec la ressource - <parameter>ch</parameter>, ou &zero; (zéro) si - aucune erreur n'est survenue. - </para> - <para> - Voir aussi <function>curl_error</function> et - <ulink url="&url.curl.error;">les codes erreur cURL</ulink>. - </para> - </refsect1> - </refentry> +<refentry id='function.curl-errno'> + <refnamediv> + <refname>curl_errno</refname> + <refpurpose>Retourne le dernier message d'erreur cURL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>curl_errno</methodname> + <methodparam><type>resource</type><parameter>ch</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le numéro d'erreur de la dernière opération cURL. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &curl.ch.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le numéro de l'erreur ou &zero; si aucune erreur n'est survenue. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>curl_error</function></member> + <member><ulink url="&url.curl.error;">les codes erreurs cURL</ulink></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -48,4 +67,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-error.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-error.xml diff -u phpdoc-fr/reference/curl/functions/curl-error.xml:1.7 phpdoc-fr/reference/curl/functions/curl-error.xml:1.8 --- phpdoc-fr/reference/curl/functions/curl-error.xml:1.7 Sun Aug 27 20:47:30 2006 +++ phpdoc-fr/reference/curl/functions/curl-error.xml Sun Jan 21 09:17:44 2007 @@ -1,32 +1,53 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.7 Maintainer: didou Status: ready --> <!-- Reviewed: no --> - <refentry id="function.curl-error"> - <refnamediv> - <refname>curl_error</refname> - <refpurpose> - Retourne une chaîne contenant le dernier message d'erreur CURL - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>curl_error</methodname> - <methodparam><type>resource</type><parameter>ch</parameter></methodparam> - </methodsynopsis> - <para> - <function>curl_error</function> retourne un message clair représentant - la dernière erreur qui est survenue avec la ressource <parameter>ch</parameter> - ou <literal>''</literal> (la chaîne vide) si aucune erreur n'est survenue. - </para> - <para> - Voir aussi <function>curl_errno</function> et - <ulink url="&url.curl.error;">les codes erreur cURL</ulink>.. - </para> - </refsect1> - </refentry> +<refentry id='function.curl-error'> + <refnamediv> + <refname>curl_error</refname> + <refpurpose>Retourne une chaîne contenant le dernier message d'erreur cURL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>curl_error</methodname> + <methodparam><type>resource</type><parameter>ch</parameter></methodparam> + </methodsynopsis> + <para> + Retourne un message clair représentant la dernière erreur cURL. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &curl.ch.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le message d'erreur ou <literal>''</literal> (chaîne vide) si aucune + erreur n'est survenue. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>curl_errno</function></member> + <member><ulink url="&url.curl.error;">Curl error codes</ulink></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -47,4 +68,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-exec.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-exec.xml diff -u phpdoc-fr/reference/curl/functions/curl-exec.xml:1.10 phpdoc-fr/reference/curl/functions/curl-exec.xml:1.11 --- phpdoc-fr/reference/curl/functions/curl-exec.xml:1.10 Sat Sep 9 10:00:54 2006 +++ phpdoc-fr/reference/curl/functions/curl-exec.xml Sun Jan 21 09:17:44 2007 @@ -1,14 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.6 Maintainer: didou Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.8 Maintainer: didou Status: ready --> <!-- Reviewed: no --> <refentry id="function.curl-exec"> <refnamediv> <refname>curl_exec</refname> - <refpurpose>Exécute une session CURL</refpurpose> + <refpurpose>Exécute une session cURL</refpurpose> </refnamediv> - + <refsect1 role="description"> &reftitle.description; <methodsynopsis> @@ -16,13 +16,23 @@ <methodparam><type>resource</type><parameter>ch</parameter></methodparam> </methodsynopsis> <para> - <function>curl_exec</function> doit être appelée après - l'initialisation et le paramétrage d'une session cURL. - Son but est simplement d'exécuter la session cURL définie par - <parameter>ch</parameter>. + Exécute la session cURL fournie. + </para> + <para> + Cette fonction doit être appelée après l'initialisation et le + paramétrage d'une session cURL. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &curl.ch.description; + </variablelist> </para> </refsect1> - + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> @@ -30,18 +40,16 @@ la fonction retournera le résultat en cas de succès, et &false; si une erreur survient. </para> </refsect1> - + <refsect1 role="examples"> &reftitle.examples; <para> <example> - <title> - Initialise une session CURL et récupère une page web - </title> + <title>Récupère une page web</title> <programlisting role="php"> <![CDATA[ <?php -// Création d'une nouvelle ressource CURL +// Création d'une nouvelle ressource cURL $ch = curl_init(); // Configuration de l'URL et d'autres options @@ -51,7 +59,7 @@ // Récupération de l'URL et affichage sur le naviguateur curl_exec($ch); -// Fermeture de la session curl +// Fermeture de la session cURL curl_close($ch); ?> ]]> @@ -59,6 +67,16 @@ </example> </para> </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>curl_multi_exec</function></member> + </simplelist> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-getinfo.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-getinfo.xml diff -u phpdoc-fr/reference/curl/functions/curl-getinfo.xml:1.11 phpdoc-fr/reference/curl/functions/curl-getinfo.xml:1.12 --- phpdoc-fr/reference/curl/functions/curl-getinfo.xml:1.11 Sun Aug 27 20:47:30 2006 +++ phpdoc-fr/reference/curl/functions/curl-getinfo.xml Sun Jan 21 09:17:44 2007 @@ -1,16 +1,15 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry id='function.curl-getinfo'> <refnamediv> <refname>curl_getinfo</refname> - <refpurpose> - Lit les informations détaillant un transfert CURL - </refpurpose> + <refpurpose>Lit les informations détaillant un transfert cURL</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>mixed</type><methodname>curl_getinfo</methodname> @@ -18,233 +17,237 @@ <methodparam choice="opt"><type>int</type><parameter>opt</parameter></methodparam> </methodsynopsis> <para> - <function>curl_getinfo</function> lit les informations détaillant le - transfert identifié par la ressource <parameter>ch</parameter>. - Le paramètre <parameter>opt</parameter> peut prendre l'une des valeurs suivantes : - <itemizedlist> - <listitem> - <simpara> - <constant>CURLINFO_EFFECTIVE_URL</constant> - Dernière URL réelle - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_HTTP_CODE</constant> - Dernier code HTTP reçu - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_FILETIME</constant> - Date distante du document, et -1 si la date du - document distant est inconnue. - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_TOTAL_TIME</constant> - Durée de la transaction en - secondes pour le dernier transfert - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_NAMELOOKUP_TIME</constant> - Durée de résolution du - nom de domaine en secondes - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_CONNECT_TIME</constant> - Durée d'établissement - de la connexion en secondes - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_PRETRANSFER_TIME</constant> - Durée en secondes, entre le début - de la transaction et de début du transfert de fichiers - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_STARTTRANSFER_TIME</constant> - Durée en secondes jusqu'à ce - que le premier octet soit sur le point d'être transféré - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_REDIRECT_TIME</constant> - Durée en secondes de toutes les - étapes de redirection avant que la transaction finale ne soit débutée - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_SIZE_UPLOAD</constant> - Nombre total d'octets - envoyés - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_SIZE_DOWNLOAD</constant> - Nombre total d'octets - téléchargés - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_SPEED_DOWNLOAD</constant> - Vitesse moyenne de - téléchargement - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_SPEED_UPLOAD</constant> - Vitesse moyenne d'envoi - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_HEADER_SIZE</constant> - Taille des en-têtes reçus - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_HEADER_OUT</constant> - La chaîne de demande envoyée. Disponible - depuis &php; 6.0.0 - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_REQUEST_SIZE</constant> - Taille totale des requêtes - envoyées. Actuellement, uniquement pour les requêtes HTTP - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_SSL_VERIFYRESULT</constant> - Résultat de - la vérification de la certification SSL demandée par - <constant>CURLOPT_SSL_VERIFYPEER</constant> - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_CONTENT_LENGTH_DOWNLOAD</constant> - Taille du corps - du téléchargement, lu dans l'en-tête - <literal>Content-Length:</literal> - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_CONTENT_LENGTH_UPLOAD</constant> - Taille spécifiée - de l'envoi. - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CURLINFO_CONTENT_TYPE</constant> - <literal>Content-Type:</literal> du - fichier téléchargé. &null; indique que le serveur n'a pas envoyé d'en-tête - <literal>Content-Type:</literal> - </simpara> - </listitem> - </itemizedlist> + Lit les informations détaillant le dernier transfert. </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &curl.ch.description; + <varlistentry> + <term><parameter>opt</parameter></term> + <listitem> + <para> + Ce paramètre peut prendre l'une des valeurs suivantes : + <itemizedlist> + <listitem> + <simpara> + "CURLINFO_EFFECTIVE_URL" - Dernière URL réelle + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_HTTP_CODE" - Dernier code HTTP reçu + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_FILETIME" - Date distante du document, et -1 si la date du document distant est inconnue. + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_TOTAL_TIME" - Durée de la transaction en secondes pour le dernier transfert + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_NAMELOOKUP_TIME" - Durée de résolution du nom de domaine en secondes + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_CONNECT_TIME" - Durée d'établissement de la connexion en secondes + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_PRETRANSFER_TIME" - Durée en secondes, entre le début de la transaction et de début du transfert de fichiers + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_STARTTRANSFER_TIME" - Durée en secondes jusqu'à ce que le premier octet soit sur le point d'être transféré + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_REDIRECT_TIME" - Durée en secondes de toutes les étapes de redirection avant que la transaction finale ne soit débutée + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_SIZE_UPLOAD" - Nombre total d'octets envoyés + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_SIZE_DOWNLOAD" - Nombre total d'octets téléchargés + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_SPEED_DOWNLOAD" - Vitesse moyenne de téléchargement + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_SPEED_UPLOAD" - Vitesse moyenne d'envoi + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_HEADER_SIZE" - Taille des en-têtes reçus + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_HEADER_OUT" - La chaîne de demande envoyée. Disponible depuis &php; 6.0.0 + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_REQUEST_SIZE" - Taille totale des requêtes envoyées. Actuellement, uniquement pour les requêtes HTTP + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_SSL_VERIFYRESULT" - Résultat de la vérification de la certification SSL demandée par + <constant>CURLOPT_SSL_VERIFYPEER</constant> + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_CONTENT_LENGTH_DOWNLOAD" - Taille du corps du téléchargement, lu dans l'en-tête + <literal>Content-Length:</literal> + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_CONTENT_LENGTH_UPLOAD" - Taille spécifiée de l'envoi. + </simpara> + </listitem> + <listitem> + <simpara> + "CURLINFO_CONTENT_TYPE" - <literal>Content-Type:</literal> du fichier téléchargé. &null; indique que le serveur + n'a pas envoyé d'en-tête <literal>Content-Type:</literal> + </simpara> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> - Lorsqu'elle est appelée sans le paramètre <parameter>opt</parameter>, un tableau - associatif est retourné avec les éléments suivants : + Si <parameter>opt</parameter> est fourni, la valeur retournée sera une chaîne. + Sinon, ce sera un tableau associatif contenant les éléments suivants : + (qui correspond à <parameter>opt</parameter>): <itemizedlist> <listitem> <simpara> - <literal>url</literal> + "url" </simpara> </listitem> <listitem> <simpara> - <literal>content_type</literal> + "content_type" </simpara> </listitem> <listitem> <simpara> - <literal>http_code</literal> + "http_code" </simpara> </listitem> <listitem> <simpara> - <literal>header_size</literal> + "header_size" </simpara> </listitem> <listitem> <simpara> - <literal>request_size</literal> + "request_size" </simpara> </listitem> <listitem> <simpara> - <literal>filetime</literal> + "filetime" </simpara> </listitem> <listitem> <simpara> - <literal>ssl_verify_result</literal> + "ssl_verify_result" </simpara> </listitem> <listitem> <simpara> - <literal>redirect_count</literal> + "redirect_count" </simpara> </listitem> <listitem> <simpara> - <literal>total_time</literal> + "total_time" </simpara> </listitem> <listitem> <simpara> - <literal>namelookup_time</literal> + "namelookup_time" </simpara> </listitem> <listitem> <simpara> - <literal>connect_time</literal> + "connect_time" </simpara> </listitem> <listitem> <simpara> - <literal>pretransfer_time</literal> + "pretransfer_time" </simpara> </listitem> <listitem> <simpara> - <literal>size_upload</literal> + "size_upload" </simpara> </listitem> <listitem> <simpara> - <literal>size_download</literal> + "size_download" </simpara> </listitem> <listitem> <simpara> - <literal>speed_download</literal> + "speed_download" </simpara> </listitem> <listitem> <simpara> - <literal>speed_upload</literal> + "speed_upload" </simpara> </listitem> <listitem> <simpara> - <literal>download_content_length</literal> + "download_content_length" </simpara> </listitem> <listitem> <simpara> - <literal>upload_content_length</literal> + "upload_content_length" </simpara> </listitem> <listitem> <simpara> - <literal>starttransfer_time</literal> + "starttransfer_time" </simpara> </listitem> <listitem> <simpara> - <literal>redirect_time</literal> + "redirect_time" </simpara> </listitem> </itemizedlist> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-init.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-init.xml diff -u phpdoc-fr/reference/curl/functions/curl-init.xml:1.10 phpdoc-fr/reference/curl/functions/curl-init.xml:1.11 --- phpdoc-fr/reference/curl/functions/curl-init.xml:1.10 Sun Aug 27 20:47:30 2006 +++ phpdoc-fr/reference/curl/functions/curl-init.xml Sun Jan 21 09:17:44 2007 @@ -1,33 +1,60 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.7 Maintainer: didou Status: ready --> <!-- Reviewed: no --> - <refentry id="function.curl-init"> - <refnamediv> - <refname>curl_init</refname> - <refpurpose>Initialise une session CURL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>curl_init</methodname> - <methodparam choice="opt"><type>string</type><parameter>url</parameter></methodparam> - </methodsynopsis> - <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 <constant>CURLOPT_URL</constant> 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érer une page web - </title> - <programlisting role="php"> +<refentry id="function.curl-init"> + <refnamediv> + <refname>curl_init</refname> + <refpurpose>Initialise une session cURL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>curl_init</methodname> + <methodparam choice="opt"><type>string</type><parameter>url</parameter></methodparam> + </methodsynopsis> + <para> + 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>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>url</parameter></term> + <listitem> + <para> + Si fourni, alors <constant>CURLOPT_URL</constant> prendra + cette valeur. Vous pouvez manuellement fixer cette valeur avec la + fonction <function>curl_setopt</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne une session cURL en cas de succès, &false; si une erreur survient. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title> + Initialiser une session cURL et récupérer une page web + </title> + <programlisting role="php"> <![CDATA[ <?php // initialisation de la session @@ -44,16 +71,22 @@ curl_close($ch); ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>curl_close</function> et - <function>curl_setopt</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>curl_close</function></member> + <member><function>curl_multi_init</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -74,4 +107,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-multi-add-handle.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-multi-add-handle.xml diff -u phpdoc-fr/reference/curl/functions/curl-multi-add-handle.xml:1.6 phpdoc-fr/reference/curl/functions/curl-multi-add-handle.xml:1.7 --- phpdoc-fr/reference/curl/functions/curl-multi-add-handle.xml:1.6 Sun Aug 27 20:47:30 2006 +++ phpdoc-fr/reference/curl/functions/curl-multi-add-handle.xml Sun Jan 21 09:17:44 2007 @@ -1,33 +1,57 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: didou Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> <!-- Reviewed: no --> - <refentry id="function.curl-multi-add-handle"> - <refnamediv> - <refname>curl_multi_add_handle</refname> - <refpurpose> - Ajoute une ressource cURL à un cURL multiple - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>curl_multi_add_handle</methodname> - <methodparam><type>resource</type><parameter>mh</parameter></methodparam> - <methodparam><type>resource</type><parameter>ch</parameter></methodparam> - </methodsynopsis> - - &warn.undocumented.func; - - <simpara> - Voir aussi - <function>curl_multi_init</function>, - <function>curl_init</function> et - <function>curl_multi_remove_handle</function>. - </simpara> - </refsect1> - </refentry> +<refentry id="function.curl-multi-add-handle"> + <refnamediv> + <refname>curl_multi_add_handle</refname> + <refpurpose>Ajoute une ressource cURL à un cURL multiple</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>curl_multi_add_handle</methodname> + <methodparam><type>resource</type><parameter>mh</parameter></methodparam> + <methodparam><type>resource</type><parameter>ch</parameter></methodparam> + </methodsynopsis> + <para> + Ajoute la session <parameter>ch</parameter> au gestionnaire multiple + <parameter>mh</parameter> + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &curl.mh.description; + &curl.ch.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &zero; en cas de succès, ou un des codes erreurs + <constant>CURLM_XXX</constant>. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>curl_multi_remove_handle</function></member> + <member><function>curl_multi_init</function></member> + <member><function>curl_init</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -48,4 +72,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-multi-close.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-multi-close.xml diff -u phpdoc-fr/reference/curl/functions/curl-multi-close.xml:1.5 phpdoc-fr/reference/curl/functions/curl-multi-close.xml:1.6 --- phpdoc-fr/reference/curl/functions/curl-multi-close.xml:1.5 Sun Aug 27 20:47:30 2006 +++ phpdoc-fr/reference/curl/functions/curl-multi-close.xml Sun Jan 21 09:17:44 2007 @@ -1,31 +1,52 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: didou Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> <!-- Reviewed: no --> - <refentry id="function.curl-multi-close"> - <refnamediv> - <refname>curl_multi_close</refname> - <refpurpose> - Termine un jeu de sessions cURL - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>void</type><methodname>curl_multi_close</methodname> - <methodparam><type>resource</type><parameter>mh</parameter></methodparam> - </methodsynopsis> - - &warn.undocumented.func; - - <simpara> - Voir aussi - <function>curl_multi_init</function> et - <function>curl_close</function>. - </simpara> - </refsect1> - </refentry> +<refentry id="function.curl-multi-close"> + <refnamediv> + <refname>curl_multi_close</refname> + <refpurpose>Termine un jeu de sessions cURL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>curl_multi_close</methodname> + <methodparam><type>resource</type><parameter>mh</parameter></methodparam> + </methodsynopsis> + <para> + Ferme un jeu de gestionnaires cURL. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &curl.mh.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>curl_multi_init</function></member> + <member><function>curl_close</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -46,4 +67,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-multi-exec.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-multi-exec.xml diff -u phpdoc-fr/reference/curl/functions/curl-multi-exec.xml:1.8 phpdoc-fr/reference/curl/functions/curl-multi-exec.xml:1.9 --- phpdoc-fr/reference/curl/functions/curl-multi-exec.xml:1.8 Sun Aug 27 20:47:30 2006 +++ phpdoc-fr/reference/curl/functions/curl-multi-exec.xml Sun Jan 21 09:17:44 2007 @@ -1,32 +1,53 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> <!-- Reviewed: no --> - <refentry id="function.curl-multi-exec"> - <refnamediv> - <refname>curl_multi_exec</refname> - <refpurpose> - Exécute les sous-requêtes de la session cURL - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>curl_multi_exec</methodname> - <methodparam><type>resource</type><parameter>mh</parameter></methodparam> - <methodparam><type>int</type><parameter role="reference">still_running</parameter></methodparam> - </methodsynopsis> - - &warn.undocumented.func; - - <simpara> - Voir aussi - <function>curl_multi_init</function> et - <function>curl_exec</function>. - </simpara> - </refsect1> - </refentry> +<refentry id="function.curl-multi-exec"> + <refnamediv> + <refname>curl_multi_exec</refname> + <refpurpose>Exécute les sous-requêtes de la session cURL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>curl_multi_exec</methodname> + <methodparam><type>resource</type><parameter>mh</parameter></methodparam> + <methodparam><type>int</type><parameter role="reference">still_running</parameter></methodparam> + </methodsynopsis> + + &warn.undocumented.func; + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &curl.mh.description; + <varlistentry> + <term><parameter>still_running</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>curl_multi_init</function></member> + <member><function>curl_exec</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -47,4 +68,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-multi-getcontent.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-multi-getcontent.xml diff -u phpdoc-fr/reference/curl/functions/curl-multi-getcontent.xml:1.5 phpdoc-fr/reference/curl/functions/curl-multi-getcontent.xml:1.6 --- phpdoc-fr/reference/curl/functions/curl-multi-getcontent.xml:1.5 Sun Aug 27 20:47:30 2006 +++ phpdoc-fr/reference/curl/functions/curl-multi-getcontent.xml Sun Jan 21 09:17:44 2007 @@ -1,30 +1,44 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: didou Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> <!-- Reviewed: no --> - <refentry id="function.curl-multi-getcontent"> - <refnamediv> - <refname>curl_multi_getcontent</refname> - <refpurpose> - Retourne le contenu obtenu avec l'option <constant>CURLOPT_RETURNTRANSFER</constant> - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>curl_multi_getcontent</methodname> - <methodparam><type>resource</type><parameter>ch</parameter></methodparam> - </methodsynopsis> - - &warn.undocumented.func; - - <simpara> - Voir aussi - <function>curl_multi_init</function>. - </simpara> - </refsect1> - </refentry> +<refentry id="function.curl-multi-getcontent"> + <refnamediv> + <refname>curl_multi_getcontent</refname> + <refpurpose>Retourne le contenu obtenu avec l'option <constant>CURLOPT_RETURNTRANSFER</constant></refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>curl_multi_getcontent</methodname> + <methodparam><type>resource</type><parameter>ch</parameter></methodparam> + </methodsynopsis> + + &warn.undocumented.func; + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &curl.ch.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>curl_multi_init</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -45,4 +59,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-multi-info-read.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-multi-info-read.xml diff -u phpdoc-fr/reference/curl/functions/curl-multi-info-read.xml:1.5 phpdoc-fr/reference/curl/functions/curl-multi-info-read.xml:1.6 --- phpdoc-fr/reference/curl/functions/curl-multi-info-read.xml:1.5 Sun Aug 27 20:47:30 2006 +++ phpdoc-fr/reference/curl/functions/curl-multi-info-read.xml Sun Jan 21 09:17:44 2007 @@ -1,30 +1,44 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: didou Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> <!-- Reviewed: no --> - <refentry id="function.curl-multi-info-read"> - <refnamediv> - <refname>curl_multi_info_read</refname> - <refpurpose> - Lit les informations sur les transferts actuels - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>curl_multi_info_read</methodname> - <methodparam><type>resource</type><parameter>mh</parameter></methodparam> - </methodsynopsis> - - &warn.undocumented.func; - - <simpara> - Voir aussi - <function>curl_multi_init</function>. - </simpara> - </refsect1> - </refentry> +<refentry id="function.curl-multi-info-read"> + <refnamediv> + <refname>curl_multi_info_read</refname> + <refpurpose>Lit les informations sur les transferts actuels</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>curl_multi_info_read</methodname> + <methodparam><type>resource</type><parameter>mh</parameter></methodparam> + </methodsynopsis> + + &warn.undocumented.func; + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &curl.mh.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>curl_multi_init</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -45,4 +59,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-multi-init.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-multi-init.xml diff -u phpdoc-fr/reference/curl/functions/curl-multi-init.xml:1.5 phpdoc-fr/reference/curl/functions/curl-multi-init.xml:1.6 --- phpdoc-fr/reference/curl/functions/curl-multi-init.xml:1.5 Sun Aug 27 20:47:30 2006 +++ phpdoc-fr/reference/curl/functions/curl-multi-init.xml Sun Jan 21 09:17:44 2007 @@ -1,31 +1,45 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: didou Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> <!-- Reviewed: no --> - <refentry id="function.curl-multi-init"> - <refnamediv> - <refname>curl_multi_init</refname> - <refpurpose> - Retourne un nouveau cURL multiple - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>curl_multi_init</methodname> - <void /> - </methodsynopsis> - - &warn.undocumented.func; - - <simpara> - Voir aussi - <function>curl_init</function> et - <function>curl_multi_close</function>. - </simpara> - </refsect1> - </refentry> +<refentry id="function.curl-multi-init"> + <refnamediv> + <refname>curl_multi_init</refname> + <refpurpose>Retourne un nouveau cURL multiple</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>curl_multi_init</methodname> + <void /> + </methodsynopsis> + + &warn.undocumented.func; + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &curl.mh.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>curl_init</function></member> + <member><function>curl_multi_close</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -46,4 +60,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-multi-remove-handle.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-multi-remove-handle.xml diff -u phpdoc-fr/reference/curl/functions/curl-multi-remove-handle.xml:1.5 phpdoc-fr/reference/curl/functions/curl-multi-remove-handle.xml:1.6 --- phpdoc-fr/reference/curl/functions/curl-multi-remove-handle.xml:1.5 Sun Aug 27 20:47:30 2006 +++ phpdoc-fr/reference/curl/functions/curl-multi-remove-handle.xml Sun Jan 21 09:17:44 2007 @@ -1,33 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: didou Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> <!-- Reviewed: no --> - <refentry id="function.curl-multi-remove-handle"> - <refnamediv> - <refname>curl_multi_remove_handle</refname> - <refpurpose> - Retire un cURL multiple d'un jeu de cURL - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>curl_multi_remove_handle</methodname> - <methodparam><type>resource</type><parameter>mh</parameter></methodparam> - <methodparam><type>resource</type><parameter>ch</parameter></methodparam> - </methodsynopsis> - - &warn.undocumented.func; - - <simpara> - Voir aussi - <function>curl_multi_init</function>, - <function>curl_init</function> et - <function>curl_multi_add_handle</function>. - </simpara> - </refsect1> - </refentry> +<refentry id="function.curl-multi-remove-handle"> + <refnamediv> + <refname>curl_multi_remove_handle</refname> + <refpurpose>Retire un cURL multiple d'un jeu de cURL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>curl_multi_remove_handle</methodname> + <methodparam><type>resource</type><parameter>mh</parameter></methodparam> + <methodparam><type>resource</type><parameter>ch</parameter></methodparam> + </methodsynopsis> + + &warn.undocumented.func; + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &curl.mh.description; + &curl.ch.description; + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>curl_init</function></member> + <member><function>curl_multi_init</function></member> + <member><function>curl_multi_add_handle</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -48,4 +63,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-multi-select.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-multi-select.xml diff -u phpdoc-fr/reference/curl/functions/curl-multi-select.xml:1.6 phpdoc-fr/reference/curl/functions/curl-multi-select.xml:1.7 --- phpdoc-fr/reference/curl/functions/curl-multi-select.xml:1.6 Sun Aug 27 20:47:30 2006 +++ phpdoc-fr/reference/curl/functions/curl-multi-select.xml Sun Jan 21 09:17:44 2007 @@ -1,31 +1,52 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: didou Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> <!-- Reviewed: no --> - <refentry id="function.curl-multi-select"> - <refnamediv> - <refname>curl_multi_select</refname> - <refpurpose> - Retourne les sockets associées à cURL, pour utilisation - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>curl_multi_select</methodname> - <methodparam><type>resource</type><parameter>mh</parameter></methodparam> - <methodparam choice="opt"><type>float</type><parameter>timeout</parameter></methodparam> - </methodsynopsis> - - &warn.undocumented.func; - - <simpara> - Voir aussi - <function>curl_multi_init</function>. - </simpara> - </refsect1> - </refentry> +<refentry id="function.curl-multi-select"> + <refnamediv> + <refname>curl_multi_select</refname> + <refpurpose>Retourne les sockets associées à cURL, pour utilisation</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>curl_multi_select</methodname> + <methodparam><type>resource</type><parameter>mh</parameter></methodparam> + <methodparam choice="opt"><type>float</type><parameter>timeout</parameter></methodparam> + </methodsynopsis> + + &warn.undocumented.func; + + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &curl.mh.description; + <varlistentry> + <term><parameter>timeout</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>curl_multi_init</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -46,4 +67,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-setopt-array.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-setopt-array.xml diff -u phpdoc-fr/reference/curl/functions/curl-setopt-array.xml:1.1 phpdoc-fr/reference/curl/functions/curl-setopt-array.xml:1.2 --- phpdoc-fr/reference/curl/functions/curl-setopt-array.xml:1.1 Sat May 6 19:17:59 2006 +++ phpdoc-fr/reference/curl/functions/curl-setopt-array.xml Sun Jan 21 09:17:44 2007 @@ -1,11 +1,12 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.1 Maintainer: jsgoupil Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.2 Maintainer: jsgoupil Status: ready --> <!-- Reviewed: no --> + <refentry id="function.curl-setopt-array"> <refnamediv> <refname>curl_setopt_array</refname> - <refpurpose>Fixe plusieurs options pour un transfert CURL</refpurpose> + <refpurpose>Fixe plusieurs options pour un transfert cURL</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; @@ -15,23 +16,17 @@ <methodparam><type>array</type><parameter>options</parameter></methodparam> </methodsynopsis> <para> - Fixe plusieurs options pour une session CURL. Cette fonction est utile pour - configurer un grand nombre d'options CURL sans appeler à chaque fois + Fixe plusieurs options pour une session cURL. Cette fonction est utile pour + configurer un grand nombre d'options cURL sans appeler à chaque fois <function>curl_setopt</function>. </para> </refsect1> + <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> - <varlistentry> - <term><parameter>ch</parameter></term> - <listitem> - <para> - La session CURL où les options devraient être fixées. - </para> - </listitem> - </varlistentry> + &curl.ch.description; <varlistentry> <term><parameter>options</parameter></term> <listitem> @@ -45,6 +40,7 @@ </variablelist> </para> </refsect1> + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> @@ -54,17 +50,18 @@ <parameter>options</parameter>. </para> </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> <example> <title> - Initialisation d'une nouvelle session CURL et récupération d'une page web + Initialisation d'une nouvelle session cURL et récupération d'une page web </title> <programlisting role="php"> <![CDATA[ <?php -// crée une nouvelle ressource CURL +// crée une nouvelle ressource cURL $ch = curl_init(); // fixe l'URL et les autres options appropriées @@ -77,14 +74,40 @@ // attrape l'URL et la passe au navigateur curl_exec($ch); -// ferme la ressource CURL et libère les ressources systèmes +// ferme la ressource cURL et libère les ressources systèmes curl_close($ch); ?> ]]> </programlisting> </example> </para> + <para> + Avant &php; 5.1.4, vous pouvez simuler cette fonction avec : + </para> + <para> + <example> + <title>Notre propre implémentation de la fonction <function>curl_setopt_array</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +if (!function_exists('curl_setopt_array')) { + function curl_setopt_array(&$ch, $curl_options) + { + foreach ($curl_options as $option => $value) { + if (!curl_setopt($ch, $option, $value)) { + return false; + } + } + return true; + } +} +?> +]]> + </programlisting> + </example> + </para> </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> @@ -114,4 +137,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-setopt.xml?r1=1.34&r2=1.35&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-setopt.xml diff -u phpdoc-fr/reference/curl/functions/curl-setopt.xml:1.34 phpdoc-fr/reference/curl/functions/curl-setopt.xml:1.35 --- phpdoc-fr/reference/curl/functions/curl-setopt.xml:1.34 Sun Aug 27 20:47:30 2006 +++ phpdoc-fr/reference/curl/functions/curl-setopt.xml Sun Jan 21 09:17:44 2007 @@ -1,1132 +1,1163 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.34 $ --> -<!-- EN-Revision: 1.21 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.35 $ --> +<!-- EN-Revision: 1.23 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.curl-setopt"> - <refnamediv> - <refname>curl_setopt</refname> - <refpurpose>Modifie une option de transfert CURL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>curl_setopt</methodname> - <methodparam><type>resource</type><parameter>ch</parameter></methodparam> - <methodparam><type>int</type><parameter>option</parameter></methodparam> - <methodparam><type>mixed</type><parameter>value</parameter></methodparam> - </methodsynopsis> - <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 un booléen pour les valeurs suivantes - du paramètres <parameter>option</parameter> : - <informaltable> - <tgroup cols="3"> - <thead> - <row> - <entry>Option</entry> - <entry>Définissez le paramètre <parameter>value</parameter> à</entry> - <entry>Notes</entry> - </row> - </thead> - <tbody> - <row> - <entry><constant>CURLOPT_AUTOREFERER</constant></entry> - <entry> - &true; pour fixer automatiquement le champ - <literal>Referer:</literal> dans les requêtes où une redirection - <literal>Location:</literal> suit. - </entry> - <entry> - Disponible depuis &php; 5.1.0. - </entry> - </row> - <row> - <entry><constant>CURLOPT_BINARYTRANSFER</constant></entry> - <entry> - &true; pour retourner la ligne affichée lorsque - <constant>CURLOPT_RETURNTRANSFER</constant> est utilisé. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_COOKIESESSION</constant></entry> - <entry> - &true; pour marquer ceci comme un nouveau cookie "session". Cela - forcera libcurl à ignorer tous les cookies qui sont prêts à être - chargés qui sont des "cookies de session" provenant des sessions - antérieures. Par défaut, libcurl enregistre et charge toujours tous - les cookies, indépendamment s'ils sont des cookies de session ou - pas. Les cookies de session sont des cookies sans date d'expiration - et existeront que pour cette "session" seulement. - </entry> - <entry> - Disponible depuis &php; 5.1.0. - </entry> - </row> - <row> - <entry><constant>CURLOPT_CRLF</constant></entry> - <entry> - &true; pour convertir les nouvelles lignes Unix en nouvelles lignes CRLF pendant le transfert. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_DNS_USE_GLOBAL_CACHE</constant></entry> - <entry> - &true; pour utiliser un cache DNS global. Cette option n'est pas thread-safe - et est activée par défaut. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_FAILONERROR</constant></entry> - <entry> - &true; pour que &php; traite silencieusement les codes HTTP supérieurs - ou égaux à 400. Le comportement par défaut est de retourner la - page normalement, en ignorant ce code. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_FILETIME</constant></entry> - <entry> - &true; pour tenter de récupérer la date de modification - du document distant. Vous pouvez également retrouver cette valeur en utilisant - l'option <parameter>CURLINFO_FILETIME</parameter> avec - <function>curl_getinfo</function>. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_FOLLOWLOCATION</constant></entry> - <entry> - &true; pour suivre toutes les en-têtes <literal>"Location: "</literal> 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 - <literal>"Location: "</literal> qu'il trouvera à moins que - <constant>CURLOPT_MAXREDIRS</constant> ne soit définie). - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_FORBID_REUSE</constant></entry> - <entry> - &true; pour forcer la connexion à se fermer - explicitement lorsque le processus est terminé et ne sera pas mise en cache pour être - réutilisée. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_FRESH_CONNECT</constant></entry> - <entry> - &true; pour forcer à utiliser une - nouvelle connexion au lieu de celle en cache. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_FTP_USE_EPRT</constant></entry> - <entry> - &true; pour utiliser EPRT (et LPRT) - lors de l'activation des téléchargements FTP. - Utilisez &false; pour désactiver EPRT et LPRT et ainsi, n'utiliser que PORT. - </entry> - <entry> - Ajouté en &php; 5.0.0. - </entry> - </row> - <row> - <entry><constant>CURLOPT_FTP_USE_EPSV</constant></entry> - <entry> - &true; pour tenter tout d'abord une commande - EPSV pour les transferts FTP avant de revenir à une commande PASV. Définissez cette - option à &false; pour désactiver EPSV. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_FTPAPPEND</constant></entry> - <entry> - &true; pour que &php; concatène le fichier distant, plutôt que de - l'écraser. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_FTPASCII</constant></entry> - <entry> - Un alias de - <constant>CURLOPT_TRANSFERTEXT</constant>. Utilisez celui-là à la place. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_FTPLISTONLY</constant></entry> - <entry> - &true; pour ne lister que les noms d'un dossier FTP. - directory. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_HEADER</constant></entry> - <entry> - &true; pour inclure l'en-tête dans la valeur de retour. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_HTTPGET</constant></entry> - <entry> - &true; pour réinitialiser la méthode de requête HTTP - à POST. Sachant que GET est la valeur par défaut, cela n'est uniquement nécessaire - que si la méthode de requête a été changée. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_HTTPPROXYTUNNEL</constant></entry> - <entry> - &true; pour effectuer un tunnel à travers un proxy HTTP. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_MUTE</constant></entry> - <entry> - &true; pour que &php; soit totalement silencieux concernant toutes les fonctions - CURL. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_NETRC</constant></entry> - <entry> - &true; pour que &php; analyse votre fichier <filename>~./netrc</filename> - et utilise votre nom de compte et mot de passe sur le site distant - que vous souhaitez contacter. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_NOBODY</constant></entry> - <entry> - &true; pour que le corps du transfert ne soit pas inclus dans la valeur de retour. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_NOPROGRESS</constant></entry> - <entry> - &true; pour désactiver la barre de progression des transferts CURL. - transfers. - <note> - <para> - &php; choisit automatiquement une valeur non nulle. Ne changez cette valeur - que le temps du débogage. - </para> - </note> - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_NOSIGNAL</constant></entry> - <entry> - &true; pour ignorer toutes les fonctions - CURL qui cause l'envoi d'un signal au processus &php;. Activé par défaut dans - les SAPIs multi-threadés, les options de timeout peut toujours être utilisées. - </entry> - <entry> - Ajouté dans CURL 7.10 et &php; 5.0.0. - </entry> - </row> - <row> - <entry><constant>CURLOPT_POST</constant></entry> - <entry> - &true; pour que &php; fasse un HTTP POST. Un POST est un encodage normal - "application/x-www-from-urlencoded", utilisé couramment par les formulaires - HTML. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_PUT</constant></entry> - <entry> - &true; pour que le chargement se fasse par HTTP PUT. Le fichier à - charger doit être fixé avec les options - <constant>CURLOPT_INFILE</constant> et <constant>CURLOPT_INFILESIZE</constant>. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_RETURNTRANSFER</constant></entry> - <entry> - &true; retourne directement le transfert sous forme de chaîne - de la valeur retournée par <function>curl_exec</function> au lieu - de l'afficher directement. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_SSL_VERIFYPEER</constant></entry> - <entry> - &false; pour arrêter CURL de vérifier le certificat. - Les certificats alternatifs peuvent être spécifiés avec l'option - <parameter>CURLOPT_CAINFO</parameter> (ajouté dans CURL 7.9.8) ou - un répertoire de certificat peut être spécifié avec l'option - <parameter>CURLOPT_CAPATH</parameter>. Tout comme CURL 7.10, CURL installe - un paquet par défaut. <parameter>CURLOPT_SSL_VERIFYHOST</parameter> - doit aussi être positionnée à 1 ou 0 si <parameter>CURLOPT_SSL_VERIFYPEER - </parameter> est désactivée (par défaut à 2). - </entry> - <entry> - &true; par défaut dpuis CURL 7.10. Paquet installé par défaut depuis CURL 7.10. - </entry> - </row> - <row> - <entry><constant>CURLOPT_TRANSFERTEXT</constant></entry> - <entry> - &true; pour utiliser le mode ASCII - pour les transferts FTP. Pour LDAP, il récupère les données en texte plein au lieu - d'Html. Sur les systèmes WIndows, <literal>STDOUT</literal> ne sera pas définie - en mode binaire. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_UNRESTRICTED_AUTH</constant></entry> - <entry> - &true; pour garder l'envoi du nom - de l'utilisateur ainsi que le mot de passe lorsque l'on suit les chemins - (en utilisant <parameter>CURLOPT_FOLLOWLOCATION</parameter>), - même si le nom d'hôte change. - </entry> - <entry> - Ajouté en &php; 5.0.0. - </entry> - </row> - <row> - <entry><constant>CURLOPT_UPLOAD</constant></entry> - <entry> - &true; pour que &php; prépare un chargement. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_VERBOSE</constant></entry> - <entry> - &true; pour afficher tous les événements. - Ecrit la sortie sur stderr ou dans le fichier spécifié en utilisant - <parameter>CURLOPT_STDERR</parameter>. - </entry> - <entry> - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - <para> - <parameter>value</parameter> doit être un entier pour les valeurs suivantes - du paramètres <parameter>option</parameter> : - <informaltable> - <tgroup cols="3"> - <thead> - <row> - <entry>Option</entry> - <entry>Définissez le paramètre <parameter>value</parameter> à</entry> - <entry>Notes</entry> - </row> - </thead> - <tbody> - <row> - <entry><constant>CURLOPT_BUFFERSIZE</constant></entry> - <entry> - La taille du buffer à utiliser pour chaque lecture. - Cependant, il n'y a aucune garantie que cette requête soit accomplie. - </entry> - <entry> - Ajouté en CURL 7.10 et &php; 5.0.0. - </entry> - </row> - <row> - <entry><constant>CURLOPT_CLOSEPOLICY</constant></entry> - <entry> - Soit <parameter>CURLCLOSEPOLICY_LEAST_RECENTLY_USED</parameter>, soit - <parameter>CURLCLOSEPOLICY_OLDEST</parameter>. - Il y a trois autres constantes <parameter>CURLCLOSEPOLICY_</parameter> - mais CURL ne les supporte pas encore. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_CONNECTTIMEOUT</constant></entry> - <entry> - Le nombre de secondes à attendre durant - la tentative de connexion. Utilisez une valeur de &zero; pour attendre indéfiniment. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_DNS_CACHE_TIMEOUT</constant></entry> - <entry> - Le temps en seconde que CURL doit - conserver les entrées DNS en mémoire. Cette option est définie à 120 (2minutes) - par défaut. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_FTPSSLAUTH</constant></entry> - <entry> - La méthode d'identification FTP, lorsqu'elle est activée : - <literal>CURLFTPAUTH_SSL</literal> (tente SSL en premier), - <literal>CURLFTPAUTH_TLS</literal> (tente TLS en premier) ou - <literal>CURLFTPAUTH_DEFAULT</literal> (laisse CURL décider). - </entry> - <entry> - Ajouté en CURL 7.12.2 et &php; 5.1.0. - </entry> - </row> - <row> - <entry><constant>CURLOPT_HTTP_VERSION</constant></entry> - <entry> - <parameter>CURL_HTTP_VERSION_NONE</parameter> (défaut, laisse CURL - décider la version à utiliser), - <parameter>CURL_HTTP_VERSION_1_0</parameter> (force HTTP/1.0), - ou <parameter>CURL_HTTP_VERSION_1_1</parameter> (force HTTP/1.1). - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_HTTPAUTH</constant></entry> - <entry> - <para> - La méthode d'identification HTTP à utiliser. Ces options sont : - <parameter>CURLAUTH_BASIC</parameter>, - <parameter>CURLAUTH_DIGEST</parameter>, - <parameter>CURLAUTH_GSSNEGOTIATE</parameter>, - <parameter>CURLAUTH_NTLM</parameter>, - <parameter>CURLAUTH_ANY</parameter> et - <parameter>CURLAUTH_ANYSAFE</parameter>. - </para> - <para> - Vous pouvez utiliser le séparateur <literal>|</literal> ou un opérateur - pour combiner plus d'une méthode. Si vous faites cela, CURL interrogera - le serveur pour voir quelles sont les méthodes supportées et prendra - la meilleur. - </para> - <para> - <parameter>CURLAUTH_ANY</parameter> est un alias pour - <literal>CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>. - </para> - <para> - <parameter>CURLAUTH_ANYSAFE</parameter> est un alias pour - <literal>CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>. - </para> - </entry> - <entry> - Ajouté en &php; 5.0.0. - </entry> - </row> - <row> - <entry><constant>CURLOPT_INFILESIZE</constant></entry> - <entry> - La taille attendue, en octets, du fichier lors du téléchargement d'un fichier - depuis un site distant. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_LOW_SPEED_LIMIT</constant></entry> - <entry> - La vitesse de transfert minimale en octets par secondes en - dessous de laquelle, et pendant <constant>CURLOPT_LOW_SPEED_TIME</constant> - secondes, &php; considérera qu'elle est trop lente, et - annulera le transfert. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_LOW_SPEED_TIME</constant></entry> - <entry> - Le temps en secondes, qui, si la vitesse de - transfert reste en dessous de <constant>CURLOPT_LOW_SPEED_LIMIT</constant>, - &php; considèrera que la connexion est trop lente, et l'annulera. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_MAXCONNECTS</constant></entry> - <entry> - Le nombre maximal de connexions persistantes autorisées. - Lorsque la limite est atteinte, l'option - <parameter>CURLOPT_CLOSEPOLICY</parameter> - est utilisé pour afficher les connexions fermées. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_MAXREDIRS</constant></entry> - <entry> - Le nombre maximal de redirections HTTP à suivre. - Utilisez cette option avec l'option - <parameter>CURLOPT_FOLLOWLOCATION</parameter>. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_PORT</constant></entry> - <entry> - Le numéro du port de connexion, à la place - de la valeur par défaut utilisée par le protocole. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_PROXYAUTH</constant></entry> - <entry> - La méthode d'identification HTTP à utiliser pour la connexion à un proxy. - Utilisez la même méthode que celle décrite dans - <constant>CURLOPT_HTTPAUTH</constant>. - Pour une identification avec un proxy, seuls - <parameter>CURLAUTH_BASIC</parameter> et - <parameter>CURLAUTH_NTLM</parameter> sont actuellement supportés. - </entry> - <entry> - Ajouté en CURL 7.10.7 et &php; 5.1.0. - </entry> - </row> - <row> - <entry><constant>CURLOPT_PROXYPORT</constant></entry> - <entry> - Le numéro du port du proxy à utiliser - pour la connexion. Ce numéro de port peut également être défini - dans l'option <parameter>CURLOPT_PROXY</parameter>. - </entry> - <entry> - Ajouté en &php; 5.0.0. - </entry> - </row> - <row> - <entry><constant>CURLOPT_PROXYTYPE</constant></entry> - <entry> - Soit <parameter>CURLPROXY_HTTP</parameter> (par défaut), soit - <parameter>CURLPROXY_SOCKS5</parameter>. - </entry> - <entry> - Ajouté en CURL 7.10 et &php; 5.0.0. - </entry> - </row> - <row> - <entry><constant>CURLOPT_RESUME_FROM</constant></entry> - <entry> - L'offset, en octets, à partir duquel vous voulez - commencer le transfert. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_SSL_VERIFYHOST</constant></entry> - <entry> - 1 pour vérifier l'existence d'un nom commun dans le certificat - SSL. 2 pour vérifier l'existence d'un nom commun et vérifier qu'il - correspond avec le nom d'hôte fourni. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_SSLVERSION</constant></entry> - <entry> - La version de SSL (2 ou 3) à utiliser. Par - défaut, &php; essayera de le déterminer - lui-même, bien que dans certains cas, il vous faudra - le faire manuellement. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_TIMECONDITION</constant></entry> - <entry> - Comment <constant>CURLOPT_TIMEVALUE</constant> - est traité. Utilisez <parameter>CURL_TIMECOND_IFMODSINCE</parameter> - pour retourner la page uniquement si elle a été modifiée depuis le temps spécifié - par <constant>CURLOPT_TIMEVALUE</constant>. Si elle n'a pas été modifiée, - un en-tête HTTP <literal>"304 Not Modified"</literal> sera retourné en - supposant que <constant>CURLOPT_HEADER</constant> vaut &true;. - Utilisez <parameter>CURL_TIMECOND_ISUNMODSINCE</parameter> pour faire - l'inverse. <parameter>CURL_TIMECOND_IFMODSINCE</parameter> est par défaut. - </entry> - <entry> - Ajouté en &php; 5.1.0. - </entry> - </row> - <row> - <entry><constant>CURLOPT_TIMEOUT</constant></entry> - <entry> - Le temps maximum d'exécution de la fonction CURL. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_TIMEVALUE</constant></entry> - <entry> - Le temps en secondes depuis le 1er janvier 1970. - Cette valeur sera utilisée comme spécifié dans - l'option <constant>CURLOPT_TIMECONDITION</constant>. Par défaut, - <constant>CURL_TIMECOND_IFMODSINCE</constant> - sera utilisée. - </entry> - <entry> - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - <para> - <parameter>value</parameter> doit être une chaîne pour les valeurs suivantes - du paramètres <parameter>option</parameter> : - <informaltable> - <tgroup cols="3"> - <thead> - <row> - <entry>Option</entry> - <entry>Définissez le paramètre <parameter>value</parameter> à</entry> - <entry>Notes</entry> - </row> - </thead> - <tbody> - <row> - <entry><constant>CURLOPT_CAINFO</constant></entry> - <entry> - Le nom d'un fichier contenant un ou plusieurs certificats pour vérifier la concordance. - Cela n'a de sens que si vous l'utilisez en combinaison de l'option - <parameter>CURLOPT_SSL_VERIFYPEER</parameter>. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_CAPATH</constant></entry> - <entry> - Un dossier qui contient les certificats CA. Utilisez cette option - avec l'option <parameter>CURLOPT_SSL_VERIFYPEER</parameter>. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_COOKIE</constant></entry> - <entry> - Le contenu de l'en-tête <literal>"Set-Cookie: "</literal>, à - transmettre dans l'en-tête HTTP. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_COOKIEFILE</constant></entry> - <entry> - 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 écrits - dans un fichier. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_COOKIEJAR</constant></entry> - <entry> - Le nom de fichier pour y sauvegarder tous les cookies internes lorsque - la connexion se ferme. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_CUSTOMREQUEST</constant></entry> - <entry> - Une méthode de requête qui sera utilisée à la place de <literal>"GET"</literal> - ou <literal>"HEAD"</literal> lors des requêtes HTTP. Cette commande est pratique pour - effectuer un <literal>"DELETE"</literal> ou une autre commande HTTP exotique. - Les valeurs valides sont <literal>"GET"</literal>, <literal>"POST"</literal>, - <literal>"CONNECT"</literal> et plus ; - i.e. n'entrez pas une requête HTTP ici. Pour le moment, - entrez <literal>"GET /index.html HTTP/1.0\r\n\r\n"</literal> serait incorrect. - <note> - <para> - N'utilisez pas cette commande sans vous assurer que le serveur l'accepte. - </para> - </note> - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_EGBSOCKET</constant></entry> - <entry> - Comme - <parameter>CURLOPT_RANDOM_FILE</parameter> excepté que vous passez - une chaîne qui contient un nom de fichier vers le socket - <literal>Entropy Gathering Daemon</literal>. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_ENCODING</constant></entry> - <entry> - Le contenu des en-têtes <literal>"Accept-Encoding: "</literal> - et active le décodage de la réponse. Les encodages supportés sont - <literal>"identity"</literal>, <literal>"deflate"</literal> et - <literal>"gzip"</literal>. Si une chaîne vide &emptystring; est utilisé, - un en-tête contenant tous les types d'encodage supportés est envoyé. - </entry> - <entry> - Ajouté en CURL 7.10. - </entry> - </row> - <row> - <entry><constant>CURLOPT_FTPPORT</constant></entry> - <entry> - La valeur qui sera utilisée pour récupérer 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. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_INTERFACE</constant></entry> - <entry> - Le nom de l'interface à utiliser. - Cela peut être le nom d'une interface, une adresse IP ou - encore le nom de l'hôte. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_KRB4LEVEL</constant></entry> - <entry> - Le degré de sécurité - KRB4 (Kerberos 4). Chacune des valeurs (dans l'ordre du plus petit au plus grand) - suivantes sont valides : - <literal>"clear"</literal>, - <literal>"safe"</literal>, - <literal>"confidential"</literal>, - <literal>"private".</literal>. - Si la chaîne passée ne correspond pas à une de ces valeurs, la valeur <literal>"private"</literal> - sera définie. Positionner cette valeur à &null; revient à désactiver - la sécurité KRB4. Actuellement, la sécurité KRB4 fonctionne uniquement - avec les transaction FTP. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_POSTFIELDS</constant></entry> - <entry> - Toutes les données à passer lors d'une opération de HTTP POST. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_PROXY</constant></entry> - <entry> - Le nom du proxy HTTP au tunnel qui le demande. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_PROXYUSERPWD</constant></entry> - <entry> - Un nom d'utilisateur et un mot de passe formattés sous la forme - <literal>"[username]:[password]"</literal> à utiliser - pour la connexion avec le proxy. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_RANDOM_FILE</constant></entry> - <entry> - Un nom de fichier à utiliser pour interroger le générateur de nombre aléatoire pour SSL. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_RANGE</constant></entry> - <entry> - la plage de valeurs à récupérer sous la forme <literal>"X-Y"</literal>, où les - valeurs de X ou Y peuvent être omises. Le transfert HTTP - supporte aussi plusieurs intervalles, séparés par - des virgules : <literal>"X-Y,N-M"</literal>. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_REFERER</constant></entry> - <entry> - Le contenu de l'en-tête <literal>"Referer: "</literal> à utiliser - dans une requête HTTP. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_SSL_CIPHER_LIST</constant></entry> - <entry> - Une liste de ciphers à utiliser avec SSL. Par exemple, - <literal>RC4-SHA</literal> et <literal>TLSv1</literal> sont des listes - valides de cipher. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_SSLCERT</constant></entry> - <entry> - Le nom de fichier du certificat, au format PEM. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_SSLCERTPASSWD</constant></entry> - <entry> - Le mot de passe nécessaire - pour utiliser le certificat <constant>CURLOPT_SSLCERT</constant>. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_SSLCERTTYPE</constant></entry> - <entry> - Le format de votre certificat. Les formats supportés sont - <literal>"PEM"</literal> (default), <literal>"DER"</literal>, - et <literal>"ENG"</literal>. - </entry> - <entry> - Ajouté en CURL 7.9.3 et &php; 5.0.0. - </entry> - </row> - <row> - <entry><constant>CURLOPT_SSLENGINE</constant></entry> - <entry> - L'identifiant pour le moteur de cryptage de votre clé privée spécifié dans - <constant>CURLOPT_SSLKEY</constant>. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_SSLENGINE_DEFAULT</constant></entry> - <entry> - L'identifiant pour le moteur de cryptage utilisé pour les opérations - de cryptage asymétrique. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_SSLKEY</constant></entry> - <entry> - Un nom de fichier contenant votre clé privée SSL. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_SSLKEYPASSWD</constant></entry> - <entry> - Le mot de passe secret utilisé par votre clé SSL privée spécifié dans - <constant>CURLOPT_SSLKEY</constant>. - <note> - <para> - Du fait que cette option contient un mot de passe sensible, souvenez-vous - de conserver le script &php; qui le contient en toute sécurité. - </para> - </note> - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_SSLKEYTYPE</constant></entry> - <entry> - Le type de votre clé SSL privée spécifié dans <constant>CURLOPT_SSLKEY</constant>. - Les types de clés supportés sont <literal>"PEM"</literal> (défaut), <literal>"DER"</literal>, - et <literal>"ENG"</literal>. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_URL</constant></entry> - <entry> - L'URL àrécupérer. - Vous pouvez aussi choisir cette valeur lors de l'appel à - <function>curl_init</function>. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_USERAGENT</constant></entry> - <entry> - Le contenu de l'en-tête <literal>"User-Agent: "</literal> à utiliser - dans une requête HTTP. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_USERPWD</constant></entry> - <entry> - Un nom d'utilisateur et un mot de passe formattés sous la forme - <literal>"[username]:[password]"</literal> à utiliser pour la connexion. - </entry> - <entry> - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - <para> - <parameter>value</parameter> doit être un tableau pour les valeurs suivantes - du paramètres <parameter>option</parameter>: - <informaltable> - <tgroup cols="3"> - <thead> - <row> - <entry>Option</entry> - <entry>Définissez le paramètre <parameter>value</parameter> à</entry> - <entry>Notes</entry> - </row> - </thead> - <tbody> - <row> - <entry><constant>CURLOPT_HTTP200ALIASES</constant></entry> - <entry> - Un tableau de réponses HTTP 200 qui sera traité comme réponses valides et - non comme des erreurs. - </entry> - <entry> - Ajouté en CURL 7.10.3 et &php; 5.0.0. - </entry> - </row> - <row> - <entry><constant>CURLOPT_HTTPHEADER</constant></entry> - <entry> - Un tableau de champs d'en-têtes HTTP à définir. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_POSTQUOTE</constant></entry> - <entry> - Un tableau de commandes FTP à exécuter sur le serveur après - que la requête FTP se soit exécutée. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_QUOTE</constant></entry> - <entry> - Un tableau de commande FTP à exécuter sur le serveur avant la requête FTP. - </entry> - <entry> - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - <para> - <parameter>value</parameter> doit être une ressource (utilisant - <function>fopen</function>, par exemple) pour les valeurs suivantes - du paramètres <parameter>option</parameter>: - <informaltable> - <tgroup cols="3"> - <thead> - <row> - <entry>Option</entry> - <entry>Définissez le paramètre <parameter>value</parameter> à</entry> - <entry>Notes</entry> - </row> - </thead> - <tbody> - <row> - <entry><constant>CURLOPT_FILE</constant></entry> - <entry> - Le fichier où sera écrit le transfert. Par défaut, - <literal>STDOUT</literal> (la fenêtre du navigateur). - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_INFILE</constant></entry> - <entry> - Le fichier lu par le transfert lors du chargement. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_STDERR</constant></entry> - <entry> - Un chemin alternatif à utiliser pour afficher les erreurs au lieu de - <literal>STDERR</literal>. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_WRITEHEADER</constant></entry> - <entry> - Le fichier où sera écrit les parties d'en-tête du transfert. - </entry> - <entry> - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - <para> - <parameter>value</parameter> doit être une chaîne de caractères qui sera un nom valide - de fonction de callback pour les valeurs suivantes +<refentry id="function.curl-setopt"> + <refnamediv> + <refname>curl_setopt</refname> + <refpurpose>Définit une option de transfert cURL</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>curl_setopt</methodname> + <methodparam><type>resource</type><parameter>ch</parameter></methodparam> + <methodparam><type>int</type><parameter>option</parameter></methodparam> + <methodparam><type>mixed</type><parameter>value</parameter></methodparam> + </methodsynopsis> + <para> + Définit une option de transfert cURL. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &curl.ch.description; + <varlistentry> + <term><parameter>option</parameter></term> + <listitem> + <para> + L'option <literal>CURLOPT_XXX</literal> que vous voulez définir + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>value</parameter></term> + <listitem> + <para> + La valeur à définir pour <parameter>option</parameter>. + </para> + <para> + <parameter>value</parameter> doit être un booléen pour les valeurs suivantes + du paramètres <parameter>option</parameter> : + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Définissez le paramètre <parameter>value</parameter> à</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_AUTOREFERER</constant></entry> + <entry> + &true; pour fixer automatiquement le champ + <literal>Referer:</literal> dans les requêtes où une redirection + <literal>Location:</literal> suit. + </entry> + <entry> + Disponible depuis &php; 5.1.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_BINARYTRANSFER</constant></entry> + <entry> + &true; pour retourner la ligne affichée lorsque + <constant>CURLOPT_RETURNTRANSFER</constant> est utilisé. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_COOKIESESSION</constant></entry> + <entry> + &true; pour marquer ceci comme un nouveau cookie "session". Cela + forcera libcurl à ignorer tous les cookies qui sont prêts à être + chargés qui sont des "cookies de session" provenant des sessions + antérieures. Par défaut, libcurl enregistre et charge toujours tous + les cookies, indépendamment s'ils sont des cookies de session ou + pas. Les cookies de session sont des cookies sans date d'expiration + et existeront que pour cette "session" seulement. + </entry> + <entry> + Disponible depuis &php; 5.1.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_CRLF</constant></entry> + <entry> + &true; pour convertir les nouvelles lignes Unix en nouvelles lignes CRLF pendant le transfert. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_DNS_USE_GLOBAL_CACHE</constant></entry> + <entry> + &true; pour utiliser un cache DNS global. Cette option n'est pas thread-safe + et est activée par défaut. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FAILONERROR</constant></entry> + <entry> + &true; pour que &php; traite silencieusement les codes HTTP supérieurs + ou égaux à 400. Le comportement par défaut est de retourner la + page normalement, en ignorant ce code. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FILETIME</constant></entry> + <entry> + &true; pour tenter de récupérer la date de modification + du document distant. Vous pouvez également retrouver cette valeur en utilisant + l'option <parameter>CURLINFO_FILETIME</parameter> avec + <function>curl_getinfo</function>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FOLLOWLOCATION</constant></entry> + <entry> + &true; pour suivre toutes les en-têtes <literal>"Location: "</literal> 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 + <literal>"Location: "</literal> qu'il trouvera à moins que + <constant>CURLOPT_MAXREDIRS</constant> ne soit définie). + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FORBID_REUSE</constant></entry> + <entry> + &true; pour forcer la connexion à se fermer + explicitement lorsque le processus est terminé et ne sera pas mise en cache pour être + réutilisée. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FRESH_CONNECT</constant></entry> + <entry> + &true; pour forcer à utiliser une + nouvelle connexion au lieu de celle en cache. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTP_USE_EPRT</constant></entry> + <entry> + &true; pour utiliser EPRT (et LPRT) + lors de l'activation des téléchargements FTP. + Utilisez &false; pour désactiver EPRT et LPRT et ainsi, n'utiliser que PORT. + </entry> + <entry> + Ajouté en &php; 5.0.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTP_USE_EPSV</constant></entry> + <entry> + &true; pour tenter tout d'abord une commande + EPSV pour les transferts FTP avant de revenir à une commande PASV. Définissez cette + option à &false; pour désactiver EPSV. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTPAPPEND</constant></entry> + <entry> + &true; pour que &php; concatène le fichier distant, plutôt que de + l'écraser. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTPASCII</constant></entry> + <entry> + Un alias de + <constant>CURLOPT_TRANSFERTEXT</constant>. Utilisez celui-là à la place. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTPLISTONLY</constant></entry> + <entry> + &true; pour ne lister que les noms d'un dossier FTP. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_HEADER</constant></entry> + <entry> + &true; pour inclure l'en-tête dans la valeur de retour. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_HTTPGET</constant></entry> + <entry> + &true; pour réinitialiser la méthode de requête HTTP + à POST. Sachant que GET est la valeur par défaut, cela n'est uniquement nécessaire + que si la méthode de requête a été changée. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_HTTPPROXYTUNNEL</constant></entry> + <entry> + &true; pour effectuer un tunnel à travers un proxy HTTP. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_MUTE</constant></entry> + <entry> + &true; pour que &php; soit totalement silencieux concernant toutes les fonctions + cURL. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_NETRC</constant></entry> + <entry> + &true; pour que &php; analyse votre fichier <filename>~./netrc</filename> + et utilise votre nom de compte et mot de passe sur le site distant + que vous souhaitez contacter. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_NOBODY</constant></entry> + <entry> + &true; pour que le corps du transfert ne soit pas inclus dans la valeur de retour. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_NOPROGRESS</constant></entry> + <entry> + &true; pour désactiver la barre de progression des transferts cURL. + transfers. + <note> + <para> + &php; choisit automatiquement une valeur non nulle. Ne changez cette valeur + que le temps du débogage. + </para> + </note> + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_NOSIGNAL</constant></entry> + <entry> + &true; pour ignorer toutes les fonctions + cURL qui cause l'envoi d'un signal au processus &php;. Activé par défaut dans + les SAPIs multi-threadés, les options de timeout peut toujours être utilisées. + </entry> + <entry> + Ajouté dans cURL 7.10 et &php; 5.0.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_POST</constant></entry> + <entry> + &true; pour que &php; fasse un HTTP POST. Un POST est un encodage normal + <literal>application/x-www-from-urlencoded</literal>, utilisé couramment par les formulaires + HTML. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PUT</constant></entry> + <entry> + &true; pour que le chargement se fasse par HTTP PUT. Le fichier à + charger doit être fixé avec les options + <constant>CURLOPT_INFILE</constant> et <constant>CURLOPT_INFILESIZE</constant>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_RETURNTRANSFER</constant></entry> + <entry> + &true; retourne directement le transfert sous forme de chaîne + de la valeur retournée par <function>curl_exec</function> au lieu + de l'afficher directement. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSL_VERIFYPEER</constant></entry> + <entry> + &false; pour arrêter CURL de vérifier le certificat. + Les certificats alternatifs peuvent être spécifiés avec l'option + <parameter>CURLOPT_CAINFO</parameter> (ajouté dans CURL 7.9.8) ou + un répertoire de certificat peut être spécifié avec l'option + <parameter>CURLOPT_CAPATH</parameter>. Tout comme CURL 7.10, CURL installe + un paquet par défaut. <parameter>CURLOPT_SSL_VERIFYHOST</parameter> + doit aussi être positionnée à 1 ou 0 si <parameter>CURLOPT_SSL_VERIFYPEER + </parameter> est désactivée (par défaut à 2). + </entry> + <entry> + &true; par défaut dpuis cURL 7.10. Paquet installé par défaut depuis cURL 7.10. + </entry> + </row> + <row> + <entry><constant>CURLOPT_TRANSFERTEXT</constant></entry> + <entry> + &true; pour utiliser le mode ASCII + pour les transferts FTP. Pour LDAP, il récupère les données en texte plein au lieu + d'Html. Sur les systèmes WIndows, <literal>STDOUT</literal> ne sera pas définie + en mode binaire. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_UNRESTRICTED_AUTH</constant></entry> + <entry> + &true; pour garder l'envoi du nom + de l'utilisateur ainsi que le mot de passe lorsque l'on suit les chemins + (en utilisant <parameter>CURLOPT_FOLLOWLOCATION</parameter>), + même si le nom d'hôte change. + </entry> + <entry> + Ajouté en &php; 5.0.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_UPLOAD</constant></entry> + <entry> + &true; pour que &php; prépare un chargement. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_VERBOSE</constant></entry> + <entry> + &true; pour afficher tous les événements. + Écrit la sortie sur stderr ou dans le fichier spécifié en utilisant + <parameter>CURLOPT_STDERR</parameter>. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + <parameter>value</parameter> doit être un entier pour les valeurs suivantes + du paramètres <parameter>option</parameter> : + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Définissez le paramètre <parameter>value</parameter> à</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_BUFFERSIZE</constant></entry> + <entry> + La taille du buffer à utiliser pour chaque lecture. + Cependant, il n'y a aucune garantie que cette requête soit accomplie. + </entry> + <entry> + Ajouté en cURL 7.10 et &php; 5.0.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_CLOSEPOLICY</constant></entry> + <entry> + Soit <parameter>CURLCLOSEPOLICY_LEAST_RECENTLY_USED</parameter>, soit + <parameter>CURLCLOSEPOLICY_OLDEST</parameter>. + Il y a trois autres constantes <parameter>CURLCLOSEPOLICY_</parameter> + mais CURL ne les supporte pas encore. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_CONNECTTIMEOUT</constant></entry> + <entry> + Le nombre de secondes à attendre durant + la tentative de connexion. Utilisez une valeur de &zero; pour attendre indéfiniment. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_DNS_CACHE_TIMEOUT</constant></entry> + <entry> + Le temps en seconde que CURL doit + conserver les entrées DNS en mémoire. Cette option est définie à 120 (2minutes) + par défaut. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTPSSLAUTH</constant></entry> + <entry> + La méthode d'identification FTP, lorsqu'elle est activée : + <literal>CURLFTPAUTH_SSL</literal> (tente SSL en premier), + <literal>CURLFTPAUTH_TLS</literal> (tente TLS en premier) ou + <literal>CURLFTPAUTH_DEFAULT</literal> (laisse cURL décider). + </entry> + <entry> + Ajouté en cURL 7.12.2 et &php; 5.1.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_HTTP_VERSION</constant></entry> + <entry> + <parameter>CURL_HTTP_VERSION_NONE</parameter> (défaut, laisse cURL + décider la version à utiliser), + <parameter>CURL_HTTP_VERSION_1_0</parameter> (force HTTP/1.0), + ou <parameter>CURL_HTTP_VERSION_1_1</parameter> (force HTTP/1.1). + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_HTTPAUTH</constant></entry> + <entry> + <para> + La méthode d'identification HTTP à utiliser. Ces options sont : + <parameter>CURLAUTH_BASIC</parameter>, + <parameter>CURLAUTH_DIGEST</parameter>, + <parameter>CURLAUTH_GSSNEGOTIATE</parameter>, + <parameter>CURLAUTH_NTLM</parameter>, + <parameter>CURLAUTH_ANY</parameter> et + <parameter>CURLAUTH_ANYSAFE</parameter>. + </para> + <para> + Vous pouvez utiliser le séparateur <literal>|</literal> ou un opérateur + pour combiner plus d'une méthode. Si vous faites cela, CURL interrogera + le serveur pour voir quelles sont les méthodes supportées et prendra + la meilleur. + </para> + <para> + <parameter>CURLAUTH_ANY</parameter> est un alias pour + <literal>CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>. + </para> + <para> + <parameter>CURLAUTH_ANYSAFE</parameter> est un alias pour + <literal>CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>. + </para> + </entry> + <entry> + Ajouté en &php; 5.0.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_INFILESIZE</constant></entry> + <entry> + La taille attendue, en octets, du fichier lors du téléchargement d'un fichier + depuis un site distant. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_LOW_SPEED_LIMIT</constant></entry> + <entry> + La vitesse de transfert minimale en octets par secondes en + dessous de laquelle, et pendant <constant>CURLOPT_LOW_SPEED_TIME</constant> + secondes, &php; considérera qu'elle est trop lente, et + annulera le transfert. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_LOW_SPEED_TIME</constant></entry> + <entry> + Le temps en secondes, qui, si la vitesse de + transfert reste en dessous de <constant>CURLOPT_LOW_SPEED_LIMIT</constant>, + &php; considèrera que la connexion est trop lente, et l'annulera. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_MAXCONNECTS</constant></entry> + <entry> + Le nombre maximal de connexions persistantes autorisées. + Lorsque la limite est atteinte, l'option + <parameter>CURLOPT_CLOSEPOLICY</parameter> + est utilisé pour afficher les connexions fermées. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_MAXREDIRS</constant></entry> + <entry> + Le nombre maximal de redirections HTTP à suivre. + Utilisez cette option avec l'option + <parameter>CURLOPT_FOLLOWLOCATION</parameter>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PORT</constant></entry> + <entry> + Le numéro du port de connexion, à la place + de la valeur par défaut utilisée par le protocole. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PROXYAUTH</constant></entry> + <entry> + La méthode d'identification HTTP à utiliser pour la connexion à un proxy. + Utilisez la même méthode que celle décrite dans + <constant>CURLOPT_HTTPAUTH</constant>. + Pour une identification avec un proxy, seuls + <parameter>CURLAUTH_BASIC</parameter> et + <parameter>CURLAUTH_NTLM</parameter> sont actuellement supportés. + </entry> + <entry> + Ajouté en CURL 7.10.7 et &php; 5.1.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_PROXYPORT</constant></entry> + <entry> + Le numéro du port du proxy à utiliser + pour la connexion. Ce numéro de port peut également être défini + dans l'option <parameter>CURLOPT_PROXY</parameter>. + </entry> + <entry> + Ajouté en &php; 5.0.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_PROXYTYPE</constant></entry> + <entry> + Soit <parameter>CURLPROXY_HTTP</parameter> (par défaut), soit + <parameter>CURLPROXY_SOCKS5</parameter>. + </entry> + <entry> + Ajouté en cURL 7.10 et &php; 5.0.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_RESUME_FROM</constant></entry> + <entry> + L'offset, en octets, à partir duquel vous voulez + commencer le transfert. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSL_VERIFYHOST</constant></entry> + <entry> + 1 pour vérifier l'existence d'un nom commun dans le certificat + SSL. 2 pour vérifier l'existence d'un nom commun et vérifier qu'il + correspond avec le nom d'hôte fourni. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLVERSION</constant></entry> + <entry> + La version de SSL (2 ou 3) à utiliser. Par défaut, &php; essayera de le déterminer + lui-même, bien que dans certains cas, il vous faudra + le faire manuellement. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_TIMECONDITION</constant></entry> + <entry> + Comment <constant>CURLOPT_TIMEVALUE</constant> + est traité. Utilisez <parameter>CURL_TIMECOND_IFMODSINCE</parameter> + pour retourner la page uniquement si elle a été modifiée depuis le temps spécifié + par <constant>CURLOPT_TIMEVALUE</constant>. Si elle n'a pas été modifiée, + un en-tête HTTP <literal>"304 Not Modified"</literal> sera retourné en + supposant que <constant>CURLOPT_HEADER</constant> vaut &true;. + Utilisez <parameter>CURL_TIMECOND_ISUNMODSINCE</parameter> pour faire + l'inverse. <parameter>CURL_TIMECOND_IFMODSINCE</parameter> est par défaut. + </entry> + <entry> + Ajouté en &php; 5.1.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_TIMEOUT</constant></entry> + <entry> + Le temps maximum d'exécution de la fonction cURL. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_TIMEVALUE</constant></entry> + <entry> + Le temps en secondes depuis le 1er janvier 1970. + Cette valeur sera utilisée comme spécifié dans + l'option <constant>CURLOPT_TIMECONDITION</constant>. Par défaut, + <constant>CURL_TIMECOND_IFMODSINCE</constant> + sera utilisée. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + <parameter>value</parameter> doit être une chaîne pour les valeurs suivantes + du paramètres <parameter>option</parameter> : + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Définissez le paramètre <parameter>value</parameter> à</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_CAINFO</constant></entry> + <entry> + Le nom d'un fichier contenant un ou plusieurs certificats pour vérifier la concordance. + Cela n'a de sens que si vous l'utilisez en combinaison de l'option + <parameter>CURLOPT_SSL_VERIFYPEER</parameter>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_CAPATH</constant></entry> + <entry> + Un dossier qui contient les certificats CA. Utilisez cette option + avec l'option <parameter>CURLOPT_SSL_VERIFYPEER</parameter>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_COOKIE</constant></entry> + <entry> + Le contenu de l'en-tête <literal>"Set-Cookie: "</literal>, à + transmettre dans l'en-tête HTTP. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_COOKIEFILE</constant></entry> + <entry> + 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 écrits + dans un fichier. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_COOKIEJAR</constant></entry> + <entry> + Le nom de fichier pour y sauvegarder tous les cookies internes lorsque + la connexion se ferme. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_CUSTOMREQUEST</constant></entry> + <entry> + Une méthode de requête qui sera utilisée à la place de <literal>"GET"</literal> + ou <literal>"HEAD"</literal> lors des requêtes HTTP. Cette commande est pratique pour + effectuer un <literal>"DELETE"</literal> ou une autre commande HTTP exotique. + Les valeurs valides sont <literal>"GET"</literal>, <literal>"POST"</literal>, + <literal>"CONNECT"</literal> et plus ; + i.e. n'entrez pas une requête HTTP ici. Pour le moment, + entrez <literal>"GET /index.html HTTP/1.0\r\n\r\n"</literal> serait incorrect. + <note> + <para> + N'utilisez pas cette commande sans vous assurer que le serveur l'accepte. + </para> + </note> + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_EGBSOCKET</constant></entry> + <entry> + Comme <parameter>CURLOPT_RANDOM_FILE</parameter> excepté + que vous passez une chaîne qui contient un nom de fichier vers le socket + <literal>Entropy Gathering Daemon</literal>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_ENCODING</constant></entry> + <entry> + Le contenu des en-têtes <literal>"Accept-Encoding: "</literal> + et active le décodage de la réponse. Les encodages supportés sont + <literal>"identity"</literal>, <literal>"deflate"</literal> et + <literal>"gzip"</literal>. Si une chaîne vide &emptystring; est utilisé, + un en-tête contenant tous les types d'encodage supportés est envoyé. + </entry> + <entry> + Ajouté en cURL 7.10. + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTPPORT</constant></entry> + <entry> + La valeur qui sera utilisée pour récupérer 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. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_INTERFACE</constant></entry> + <entry> + Le nom de l'interface à utiliser. + Cela peut être le nom d'une interface, une adresse IP ou + encore le nom de l'hôte. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_KRB4LEVEL</constant></entry> + <entry> + Le degré de sécurité + KRB4 (Kerberos 4). Chacune des valeurs (dans l'ordre du plus petit au plus grand) + suivantes sont valides : + <literal>"clear"</literal>, + <literal>"safe"</literal>, + <literal>"confidential"</literal>, + <literal>"private".</literal>. + Si la chaîne passée ne correspond pas à une de ces valeurs, la valeur <literal>"private"</literal> + sera définie. Positionner cette valeur à &null; revient à désactiver + la sécurité KRB4. Actuellement, la sécurité KRB4 fonctionne uniquement + avec les transaction FTP. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_POSTFIELDS</constant></entry> + <entry> + Toutes les données à passer lors d'une opération de HTTP POST. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PROXY</constant></entry> + <entry> + Le nom du proxy HTTP au tunnel qui le demande. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PROXYUSERPWD</constant></entry> + <entry> + Un nom d'utilisateur et un mot de passe formattés sous la forme + <literal>"[username]:[password]"</literal> à utiliser + pour la connexion avec le proxy. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_RANDOM_FILE</constant></entry> + <entry> + Un nom de fichier à utiliser pour interroger le générateur de nombre aléatoire pour SSL. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_RANGE</constant></entry> + <entry> + La plage de valeurs à récupérer sous la forme <literal>"X-Y"</literal>, où les + valeurs de X ou Y peuvent être omises. Le transfert HTTP + supporte aussi plusieurs intervalles, séparés par + des virgules : <literal>"X-Y,N-M"</literal>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_REFERER</constant></entry> + <entry> + Le contenu de l'en-tête <literal>"Referer: "</literal> à utiliser + dans une requête HTTP. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSL_CIPHER_LIST</constant></entry> + <entry> + Une liste de ciphers à utiliser avec SSL. Par exemple, + <literal>RC4-SHA</literal> et <literal>TLSv1</literal> sont des listes + valides de cipher. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLCERT</constant></entry> + <entry> + Le nom de fichier du certificat, au format PEM. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLCERTPASSWD</constant></entry> + <entry> + Le mot de passe nécessaire + pour utiliser le certificat <constant>CURLOPT_SSLCERT</constant>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLCERTTYPE</constant></entry> + <entry> + Le format de votre certificat. Les formats supportés sont + <literal>"PEM"</literal> (default), <literal>"DER"</literal>, + et <literal>"ENG"</literal>. + </entry> + <entry> + Ajouté en cURL 7.9.3 et &php; 5.0.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLENGINE</constant></entry> + <entry> + L'identifiant pour le moteur de cryptage de votre clé privée spécifié dans + <constant>CURLOPT_SSLKEY</constant>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLENGINE_DEFAULT</constant></entry> + <entry> + L'identifiant pour le moteur de cryptage utilisé pour les opérations + de cryptage asymétrique. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLKEY</constant></entry> + <entry> + Un nom de fichier contenant votre clé privée SSL. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLKEYPASSWD</constant></entry> + <entry> + Le mot de passe secret utilisé par votre clé SSL privée spécifié dans + <constant>CURLOPT_SSLKEY</constant>. + <note> + <para> + Du fait que cette option contient un mot de passe sensible, souvenez-vous + de conserver le script &php; qui le contient en toute sécurité. + </para> + </note> + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLKEYTYPE</constant></entry> + <entry> + Le type de votre clé SSL privée spécifié dans <constant>CURLOPT_SSLKEY</constant>. + Les types de clés supportés sont <literal>"PEM"</literal> (défaut), <literal>"DER"</literal>, + et <literal>"ENG"</literal>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_URL</constant></entry> + <entry> + L'URL àrécupérer. + Vous pouvez aussi choisir cette valeur lors de l'appel à + <function>curl_init</function>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_USERAGENT</constant></entry> + <entry> + Le contenu de l'en-tête <literal>"User-Agent: "</literal> à utiliser + dans une requête HTTP. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_USERPWD</constant></entry> + <entry> + Un nom d'utilisateur et un mot de passe formattés sous la forme + <literal>"[username]:[password]"</literal> à utiliser pour la connexion. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + <parameter>value</parameter> doit être un tableau pour les valeurs suivantes du paramètres <parameter>option</parameter> : - <informaltable> - <tgroup cols="3"> - <thead> - <row> - <entry>Option</entry> - <entry>Définissez le paramètre <parameter>value</parameter> à</entry> - <entry>Notes</entry> - </row> - </thead> - <tbody> - <row> - <entry><constant>CURLOPT_HEADERFUNCTION</constant></entry> - <entry> - Le nom d'une fonction de callback où la fonction de callback prend deux paramètres. - Le premier est la ressource CURL, le seond, une chaîne contenant les données de - l'en-tête à écrire. En utilisant cette fonction de callback, il en devient - de votre responsabilité de l'écriture des données de l'en-tête. Retourne le nombre - d'octets écris. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_PASSWDFUNCTION</constant></entry> - <entry> - Le nom d'une fonction de callback où la fonction de callback prend trois paramètres. - Le premier est la ressource CURL, le second, une chaîne contenant un - mot de passe de prompt et le troisième, est la longueur maximale du mot de passe. - Retourne une chaîne contenant le mot de passe. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_READFUNCTION</constant></entry> - <entry> - Le nom d'une fonction de callback où la fonction de callback prend deux paramètres. - Le premier est la ressource CURL et le second, une chaîne contenant - les données à lire. En utilisant cette fonction de callback, il devient - de votre responsabilité de lire les données. Retourne le nombre d'octets lus. - Retourne 0 à un signal <literal>EOF</literal>. - </entry> - <entry> - </entry> - </row> - <row> - <entry><constant>CURLOPT_WRITEFUNCTION</constant></entry> - <entry> - Le nom d'une fonction de callback où la fonction de callback prend deux paramètres. - Le premier est la ressource CURL et le second, une chaîne contenant - les données à écrire. En utilisant cette fonction de callback, il devient - de votre responsabilité d'écrire les données. Doit retourner le nombre exact d'octets écris - ou il échoura. - </entry> - <entry> - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - <para> - <example> - <title> - Initialisation d'une nouvelle session CURL et recherche d'une page Web - </title> - <programlisting role="php"> + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Définissez le paramètre <parameter>value</parameter> à</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_HTTP200ALIASES</constant></entry> + <entry> + Un tableau de réponses HTTP 200 qui sera traité comme réponses valides et + non comme des erreurs. + </entry> + <entry> + Ajouté en CURL 7.10.3 et &php; 5.0.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_HTTPHEADER</constant></entry> + <entry> + Un tableau de champs d'en-têtes HTTP à définir. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_POSTQUOTE</constant></entry> + <entry> + Un tableau de commandes FTP à exécuter sur le serveur après + que la requête FTP se soit exécutée. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_QUOTE</constant></entry> + <entry> + Un tableau de commande FTP à exécuter sur le serveur avant la requête FTP. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + <parameter>value</parameter> doit être une ressource (utilisant + <function>fopen</function>, par exemple) pour les valeurs suivantes + du paramètres <parameter>option</parameter> : + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Définissez le paramètre <parameter>value</parameter> à</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_FILE</constant></entry> + <entry> + Le fichier où sera écrit le transfert. Par défaut, + <literal>STDOUT</literal> (la fenêtre du navigateur). + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_INFILE</constant></entry> + <entry> + Le fichier lu par le transfert lors du chargement. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_STDERR</constant></entry> + <entry> + Un chemin alternatif à utiliser pour afficher les erreurs au lieu de + <literal>STDERR</literal>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_WRITEHEADER</constant></entry> + <entry> + Le fichier où sera écrit les parties d'en-tête du transfert. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + <parameter>value</parameter> doit être une chaîne de caractères qui sera un nom valide + de fonction de callback pour les valeurs suivantes + du paramètres <parameter>option</parameter> : + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Définissez le paramètre <parameter>value</parameter> à</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_HEADERFUNCTION</constant></entry> + <entry> + Le nom d'une fonction de callback où la fonction de callback prend deux paramètres. + Le premier est la ressource CURL, le seond, une chaîne contenant les données de + l'en-tête à écrire. En utilisant cette fonction de callback, il en devient + de votre responsabilité de l'écriture des données de l'en-tête. Retourne le nombre + d'octets écris. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PASSWDFUNCTION</constant></entry> + <entry> + Le nom d'une fonction de callback où la fonction de callback prend trois paramètres. + Le premier est la ressource CURL, le second, une chaîne contenant un + mot de passe de prompt et le troisième, est la longueur maximale du mot de passe. + Retourne une chaîne contenant le mot de passe. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_READFUNCTION</constant></entry> + <entry> + Le nom d'une fonction de callback où la fonction de callback prend deux paramètres. + Le premier est la ressource CURL et le second, une chaîne contenant + les données à lire. En utilisant cette fonction de callback, il devient + de votre responsabilité de lire les données. Retourne le nombre d'octets lus. + Retourne 0 à un signal <literal>EOF</literal>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_WRITEFUNCTION</constant></entry> + <entry> + Le nom d'une fonction de callback où la fonction de callback prend deux paramètres. + Le premier est la ressource CURL et le second, une chaîne contenant + les données à écrire. En utilisant cette fonction de callback, il devient + de votre responsabilité d'écrire les données. Doit retourner le nombre exact d'octets écris + ou il échoura. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title> + Initialisation d'une nouvelle session CURL et recherche d'une page Web + </title> + <programlisting role="php"> <![CDATA[ <?php -// Création d'une ressource CURL +// Création d'une ressource cURL $ch = curl_init(); // Définition de l'URL et autres options appropriées @@ -1136,15 +1167,25 @@ // Récupération de l'URL et passage au navigateur curl_exec($ch); -// Fermeture de la ressource CURL et libération des ressources systèmes +// Fermeture de la ressource cURL et libération des ressources systèmes curl_close($ch); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>curl_setopt_array</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -1165,4 +1206,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/curl/functions/curl-version.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/curl/functions/curl-version.xml diff -u phpdoc-fr/reference/curl/functions/curl-version.xml:1.10 phpdoc-fr/reference/curl/functions/curl-version.xml:1.11 --- phpdoc-fr/reference/curl/functions/curl-version.xml:1.10 Sun Aug 27 20:47:30 2006 +++ phpdoc-fr/reference/curl/functions/curl-version.xml Sun Jan 21 09:17:44 2007 @@ -1,25 +1,89 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry id="function.curl-version"> <refnamediv> <refname>curl_version</refname> - <refpurpose>Retourne la version courante de CURL</refpurpose> + <refpurpose>Retourne la version courante de cURL</refpurpose> </refnamediv> - <refsect1> + + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>curl_version</methodname> - <methodparam choice="opt"><type>int</type><parameter>version</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>age</parameter></methodparam> </methodsynopsis> <para> - <function>curl_version</function> retourne une chaîne - avec la version courante de la bibliothèque CURL. + Retourne des informations sur la version cURL. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>age</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau associatif contenant les éléments suivants : + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry>version_number</entry> + <entry>numéro de version cURL 24 bit</entry> + </row> + <row> + <entry>version</entry> + <entry>numéro de version cURL, sous la forme d'une chaîne de caractères</entry> + </row> + <row> + <entry>ssl_version_number</entry> + <entry>numéro de version OpenSSL 24 bit</entry> + </row> + <row> + <entry>ssl_version</entry> + <entry>numéro de version OpenSSL, sous la forme d'une chaîne de caractères</entry> + </row> + <row> + <entry>libz_version</entry> + <entry>numéro de version zlib, sous la forme d'une chaîne de caractères</entry> + </row> + <row> + <entry>host</entry> + <entry>Informations sur l'hôte sur lequel cURL a été construit</entry> + </row> + <row> + <entry>age</entry> + <entry></entry> + </row> + <row> + <entry>features</entry> + <entry>Un masque de constantes <literal>CURL_VERSION_XXX</literal></entry> + </row> + <row> + <entry>protocols</entry> + <entry>Un tanleau de noms de protocoles supportés par cURL</entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> </refsect1> - </refentry> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -40,4 +104,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/date.xml?r1=1.38&r2=1.39&diff_format=u Index: phpdoc-fr/reference/datetime/functions/date.xml diff -u phpdoc-fr/reference/datetime/functions/date.xml:1.38 phpdoc-fr/reference/datetime/functions/date.xml:1.39 --- phpdoc-fr/reference/datetime/functions/date.xml:1.38 Sun Jan 7 12:41:33 2007 +++ phpdoc-fr/reference/datetime/functions/date.xml Sun Jan 21 09:17:44 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.38 $ --> -<!-- EN-Revision: 1.36 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.39 $ --> +<!-- EN-Revision: 1.37 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry id="function.date"> @@ -245,7 +245,7 @@ </row> <row> <entry><literal>T</literal></entry> - <entry>Fuseau horaire du serveur</entry> + <entry>Abréviation du fuseau horaire</entry> <entry>Exemples : <literal>EST</literal>, <literal>MDT</literal> ...</entry> </row> <row> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/functions/strptime.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/datetime/functions/strptime.xml diff -u phpdoc-fr/reference/datetime/functions/strptime.xml:1.4 phpdoc-fr/reference/datetime/functions/strptime.xml:1.5 --- phpdoc-fr/reference/datetime/functions/strptime.xml:1.4 Sun Aug 27 20:47:30 2006 +++ phpdoc-fr/reference/datetime/functions/strptime.xml Sun Jan 21 09:17:44 2007 @@ -1,129 +1,129 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.strptime"> - <refnamediv> - <refname>strptime</refname> - <refpurpose> - Analyse une date générée par <function>strftime</function> - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>strptime</methodname> - <methodparam><type>string</type><parameter>date</parameter></methodparam> - <methodparam><type>string</type><parameter>format</parameter></methodparam> - </methodsynopsis> - <para> - <function>strptime</function> retourne un tableau après avoir - analysé <parameter>date</parameter>, ou &false; en cas d'erreur. - </para> - <para> - Les noms des mois et jours de la semaine dépendent de la configuration - locale, choisie avec <function>setlocale</function> (LC_TIME). - </para> - &note.no-windows; - </refsect1> - - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter>date</parameter> (<type>string</type>)</term> - <listitem> - <para> - La chaîne à analyser (e.g. retourné par <function>strftime</function>) - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>format</parameter> (<type>string</type>)</term> - <listitem> - <para> - Le format utilisé par <parameter>date</parameter> (e.g. le - même que celui qui a été utilisé par <function>strftime</function>). - </para> - <para> - Pour plus d'informations sur les spécificateurs de formats, voyez - la fonction <function>strftime</function>. - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - Retourne un tableau, ou &false; en cas d'erreur. - </para> - - <para> - <table> - <title>Les paramètres suivants sont retournés dans le tableau</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Paramètre</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>tm_sec</entry> - <entry>Secondes après la minute (0-61)</entry> - </row> - <row> - <entry>tm_min</entry> - <entry>Minutes après l'heure (0-59)</entry> - </row> - <row> - <entry>tm_hour</entry> - <entry>Heure depuis minuit (0-23)</entry> - </row> - <row> - <entry>tm_mday</entry> - <entry>Jour du mois (1-31)</entry> - </row> - <row> - <entry>tm_mon</entry> - <entry>Mois depuis janvier (0-11)</entry> - </row> - <row> - <entry>tm_year</entry> - <entry>Années depuis 1900</entry> - </row> - <row> - <entry>tm_wday</entry> - <entry>Jours depuis dimanche (0-6)</entry> - </row> - <row> - <entry>tm_yday</entry> - <entry>Jours depuis le 1er janvier (0-365)</entry> - </row> - <row> - <entry>unparsed</entry> - <entry>La partie de <parameter>date</parameter> qui n'a pas été - reconnue par l'analyseur avec le <parameter>format</parameter> - spécifié.</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title>Exemple avec <function>strptime</function></title> - <programlisting role="php"> +<refentry id="function.strptime"> + <refnamediv> + <refname>strptime</refname> + <refpurpose> + Analyse une date générée par <function>strftime</function> + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>strptime</methodname> + <methodparam><type>string</type><parameter>date</parameter></methodparam> + <methodparam><type>string</type><parameter>format</parameter></methodparam> + </methodsynopsis> + <para> + <function>strptime</function> retourne un tableau après avoir + analysé <parameter>date</parameter>, ou &false; en cas d'erreur. + </para> + <para> + Les noms des mois et jours de la semaine dépendent de la configuration + locale, choisie avec <function>setlocale</function> (LC_TIME). + </para> + &note.no-windows; + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>date</parameter> (<type>string</type>)</term> + <listitem> + <para> + La chaîne à analyser (e.g. retourné par <function>strftime</function>) + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>format</parameter> (<type>string</type>)</term> + <listitem> + <para> + Le format utilisé par <parameter>date</parameter> (e.g. le + même que celui qui a été utilisé par <function>strftime</function>). + </para> + <para> + Pour plus d'informations sur les spécificateurs de formats, voyez + la fonction <function>strftime</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> +</refsect1> + +<refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau, ou &false; en cas d'erreur. + </para> + + <para> + <table> + <title>Les paramètres suivants sont retournés dans le tableau</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Paramètre</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>tm_sec</entry> + <entry>Secondes après la minute (0-61)</entry> + </row> + <row> + <entry>tm_min</entry> + <entry>Minutes après l'heure (0-59)</entry> + </row> + <row> + <entry>tm_hour</entry> + <entry>Heure depuis minuit (0-23)</entry> + </row> + <row> + <entry>tm_mday</entry> + <entry>Jour du mois (1-31)</entry> + </row> + <row> + <entry>tm_mon</entry> + <entry>Mois depuis janvier (0-11)</entry> + </row> + <row> + <entry>tm_year</entry> + <entry>Années depuis 1900</entry> + </row> + <row> + <entry>tm_wday</entry> + <entry>Jours depuis dimanche (0-6)</entry> + </row> + <row> + <entry>tm_yday</entry> + <entry>Jours depuis le 1er janvier (0-365)</entry> + </row> + <row> + <entry>unparsed</entry> + <entry>La partie de <parameter>date</parameter> qui n'a pas été + reconnue par l'analyseur avec le <parameter>format</parameter> + spécifié.</entry> + </row> + </tbody> + </tgroup> + </table> + </para> +</refsect1> + +<refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>strptime</function></title> + <programlisting role="php"> <![CDATA[ <?php $format = '%d/%m/%Y %H:%M:%S'; @@ -134,9 +134,9 @@ print_r(strptime($strf, $format)); ?> ]]> - </programlisting> - &example.outputs.similar; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ 03/10/2004 15:54:19 @@ -153,20 +153,20 @@ [unparsed] => ) ]]> - </screen> - </example> - </para> - </refsect1> + </screen> + </example> + </para> + </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>strftime</function></member> - </simplelist> - </para> - </refsect1> - </refentry> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strftime</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/datetime/reference.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/datetime/reference.xml diff -u phpdoc-fr/reference/datetime/reference.xml:1.15 phpdoc-fr/reference/datetime/reference.xml:1.16 --- phpdoc-fr/reference/datetime/reference.xml:1.15 Sat Sep 9 10:00:55 2006 +++ phpdoc-fr/reference/datetime/reference.xml Sun Jan 21 09:17:44 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> <!-- Purpose: calendar --> <!-- Membership: core --> <!-- Reviewed: no --> @@ -56,11 +56,6 @@ </note> </section> - <section id="datetime.runtime"> - &reftitle.runtime; - &no.config; - </section> - &reference.datetime.ini; <section id="datetime.resources"> @@ -72,10 +67,10 @@ </partintro> - &reference.datetime.functions; </reference> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -92,5 +87,4 @@ sgml-local-catalogs:nil sgml-local-ecat-files:nil End: ---> - +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/dbm/reference.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc-fr/reference/dbm/reference.xml diff -u phpdoc-fr/reference/dbm/reference.xml:1.17 phpdoc-fr/reference/dbm/reference.xml:1.18 --- phpdoc-fr/reference/dbm/reference.xml:1.17 Sun Jan 14 08:10:50 2007 +++ phpdoc-fr/reference/dbm/reference.xml Sun Jan 21 09:17:44 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- EN-Revision: 1.13 Maintainer: dams Status: ready --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> <!-- State: deprecated --> <!-- Reviewed: no --> @@ -23,7 +23,7 @@ <note> <para> Le support DBM est obsolète et il est fortement recommandé d'utiliser - l'extension <link linkend="ref.pdo">PDO</link> à la place. + l'extension <link linkend="ref.dba">DBA</link> à la place. </para> </note> <note>
« previous php.doc.fr (#5178) next »