cvs: phpdoc-fr /reference/network/functions fsockopen.xml header.xml inet-ntop.xml inet-pton.xml openlog.xml setcookie.xml syslog.xml
/reference/nsapi/functions nsapi-request-headers.xml /reference/oci8/functions oci-bind-by-name.xml /reference/openssl configure.xml
/reference/openssl/functions openssl-pkcs12-read.xml /reference/outcontrol book.xml /reference/outcontrol/functions ob-start.xml
/reference/ovrimos/functions ovrimos-field-len.xml /reference/pcre book.xml pattern.differences.xml pattern.modifiers.xml pattern.syntax.xml
pattern.xml /reference/pcre/functions preg-replace.xml
| From: | Yannick Torres | Date: | Sat, 27 Dec 2008 17:02:10 +0000 |
| Subject: | cvs: phpdoc-fr /reference/network/functions fsockopen.xml header.xml inet-ntop.xml inet-pton.xml openlog.xml setcookie.xml syslog.xml /reference/nsapi/functions nsapi-request-headers.xml /reference/oci8/functions oci-bind-by-name.xml /reference/openssl configure.xml /reference/openssl/functions openssl-pkcs12-read.xml /reference/outcontrol book.xml /reference/outcontrol/functions ob-start.xml /reference/ovrimos/functions ovrimos-field-len.xml /reference/pcre book.xml pattern.differences.xml pattern.modifiers.xml pattern.syntax.xml pattern.xml /reference/pcre/functions preg-replace.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-6177@lists.php.net to get a copy of this message | ||
yannick Sat Dec 27 17:02:10 2008 UTC
Added files:
/phpdoc-fr/reference/pcre pattern.differences.xml
Modified files:
/phpdoc-fr/reference/network/functions fsockopen.xml header.xml
inet-ntop.xml inet-pton.xml
openlog.xml setcookie.xml
syslog.xml
/phpdoc-fr/reference/nsapi/functions nsapi-request-headers.xml
/phpdoc-fr/reference/oci8/functions oci-bind-by-name.xml
/phpdoc-fr/reference/openssl/functions openssl-pkcs12-read.xml
/phpdoc-fr/reference/openssl configure.xml
/phpdoc-fr/reference/outcontrol/functions ob-start.xml
/phpdoc-fr/reference/outcontrol book.xml
/phpdoc-fr/reference/ovrimos/functions ovrimos-field-len.xml
/phpdoc-fr/reference/pcre/functions preg-replace.xml
/phpdoc-fr/reference/pcre book.xml pattern.modifiers.xml
pattern.syntax.xml pattern.xml
Log:
sync with EN
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/network/functions/fsockopen.xml?r1=1.21&r2=1.22&diff_format=u Index: phpdoc-fr/reference/network/functions/fsockopen.xml diff -u phpdoc-fr/reference/network/functions/fsockopen.xml:1.21 phpdoc-fr/reference/network/functions/fsockopen.xml:1.22 --- phpdoc-fr/reference/network/functions/fsockopen.xml:1.21 Tue May 13 11:34:33 2008 +++ phpdoc-fr/reference/network/functions/fsockopen.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> -<!-- EN-Revision: 1.23 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.22 $ --> +<!-- EN-Revision: 1.25 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fsockopen"> @@ -116,6 +116,14 @@ </para> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + <para> + Lance une alerte de type <constant>E_WARNING</constant> si le paramètre + <parameter>hostname</parameter> n'est pas un domaine valide. + </para> + </refsect1> + <refsect1 role="changelog"> &reftitle.changelog; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/network/functions/header.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-fr/reference/network/functions/header.xml diff -u phpdoc-fr/reference/network/functions/header.xml:1.7 phpdoc-fr/reference/network/functions/header.xml:1.8 --- phpdoc-fr/reference/network/functions/header.xml:1.7 Sun May 18 22:39:31 2008 +++ phpdoc-fr/reference/network/functions/header.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.header"> @@ -226,7 +226,7 @@ <![CDATA[ <?php header("Cache-Control: no-cache, must-revalidate"); // HTTP/1.1 -header("Expires: Mon, 26 Jul 1997 05:00:00 GMT"); // Date dans le passé +header("Expires: Sat, 26 Jul 1997 05:00:00 GMT"); // Date dans le passé ?> ]]> </programlisting> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/network/functions/inet-ntop.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/network/functions/inet-ntop.xml diff -u phpdoc-fr/reference/network/functions/inet-ntop.xml:1.10 phpdoc-fr/reference/network/functions/inet-ntop.xml:1.11 --- phpdoc-fr/reference/network/functions/inet-ntop.xml:1.10 Tue Jun 24 11:11:23 2008 +++ phpdoc-fr/reference/network/functions/inet-ntop.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.inet-ntop" xmlns="http://docbook.org/ns/docbook"> @@ -72,10 +72,6 @@ </para> </refsect1> - <refsect1 role="notes"> - &reftitle.notes; - </refsect1> - <refsect1 role="changelog"> &reftitle.changelog; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/network/functions/inet-pton.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/network/functions/inet-pton.xml diff -u phpdoc-fr/reference/network/functions/inet-pton.xml:1.11 phpdoc-fr/reference/network/functions/inet-pton.xml:1.12 --- phpdoc-fr/reference/network/functions/inet-pton.xml:1.11 Tue Jun 24 11:11:23 2008 +++ phpdoc-fr/reference/network/functions/inet-pton.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.inet-pton" xmlns="http://docbook.org/ns/docbook"> @@ -57,7 +57,6 @@ $in_addr = inet_pton('127.0.0.1'); $in6_addr = inet_pton('::1'); - ?> ]]> </programlisting> @@ -65,10 +64,6 @@ </para> </refsect1> - <refsect1 role="notes"> - &reftitle.notes; - </refsect1> - <refsect1 role="changelog"> &reftitle.changelog; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/network/functions/openlog.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/network/functions/openlog.xml diff -u phpdoc-fr/reference/network/functions/openlog.xml:1.14 phpdoc-fr/reference/network/functions/openlog.xml:1.15 --- phpdoc-fr/reference/network/functions/openlog.xml:1.14 Sun May 18 22:39:31 2008 +++ phpdoc-fr/reference/network/functions/openlog.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.openlog" xmlns="http://docbook.org/ns/docbook"> @@ -194,7 +194,6 @@ &reftitle.seealso; <para> <simplelist> - <member><function>define_syslog_variables</function></member> <member><function>syslog</function></member> <member><function>closelog</function></member> </simplelist> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/network/functions/setcookie.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/network/functions/setcookie.xml diff -u phpdoc-fr/reference/network/functions/setcookie.xml:1.11 phpdoc-fr/reference/network/functions/setcookie.xml:1.12 --- phpdoc-fr/reference/network/functions/setcookie.xml:1.11 Sat Jun 21 20:51:38 2008 +++ phpdoc-fr/reference/network/functions/setcookie.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.setcookie" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -31,13 +31,13 @@ </para> <para> Une fois que le cookie a été placé, il est accessible dans les variables globales - <link linkend="reserved.variables.cookies">$_COOKIE</link> ou bien + <varname>$_COOKIE</varname> ou bien <varname>$HTTP_COOKIE_VARS</varname> arrays. Notez que les <link linkend="language.variables.superglobals">superglobales</link> telles que <varname>$_COOKIE</varname> sont disponibles en PHP depuis la version 4.1.0. Les valeurs de cookies existent aussi dans la variable - <link linkend="reserved.variables.request">$_REQUEST</link>. + <varname>$_REQUEST</varname>. </para> </refsect1> @@ -146,7 +146,7 @@ sécurisée existe. La valeur par défaut est &false;. Côté serveur, c'est au développeur d'envoyer ce genre de cookie uniquement sur les connexions sécurisées (e.g. en utilisant la variable - <literal>$_SERVER["HTTPS"]</literal>). + <varname>$_SERVER["HTTPS"]</varname>). </para> </listitem> </varlistentry> @@ -280,6 +280,30 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.2.0</entry> + <entry> + Le paramètre <parameter>httponly</parameter> a été ajouté. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; <note> @@ -320,8 +344,10 @@ Les cookies doivent être effacés avec les mêmes paramètres que ceux utilisés lors de leur création. Si l'argument <parameter>value</parameter> est une chaîne vide ou vaut &false; et - quelques autres arguments sont exactement les mêmes que lors du + que ls autres arguments sont exactement les mêmes que lors du positionnement du cookie, alors le cookie sera effacé du client. + En interne, l'effacement est réalisé en positionnant la valeur à + 'deleted' et la date d'expiration à une année dans le passé. </simpara> </listitem> <listitem> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/network/functions/syslog.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/network/functions/syslog.xml diff -u phpdoc-fr/reference/network/functions/syslog.xml:1.18 phpdoc-fr/reference/network/functions/syslog.xml:1.19 --- phpdoc-fr/reference/network/functions/syslog.xml:1.18 Sun May 18 22:39:31 2008 +++ phpdoc-fr/reference/network/functions/syslog.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.syslog" xmlns="http://docbook.org/ns/docbook"> @@ -118,7 +118,6 @@ <programlisting role="php"> <![CDATA[ <?php -define_syslog_variables(); // ouverture de syslog, ajout du PID et envoi simultané du // message à la sortie standard et à un mécanisme // spécifique @@ -162,7 +161,6 @@ &reftitle.seealso; <para> <simplelist> - <member><function>define_syslog_variables</function></member> <member><function>openlog</function></member> <member><function>closelog</function></member> </simplelist> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/nsapi/functions/nsapi-request-headers.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/nsapi/functions/nsapi-request-headers.xml diff -u phpdoc-fr/reference/nsapi/functions/nsapi-request-headers.xml:1.13 phpdoc-fr/reference/nsapi/functions/nsapi-request-headers.xml:1.14 --- phpdoc-fr/reference/nsapi/functions/nsapi-request-headers.xml:1.13 Sat Jun 21 20:51:39 2008 +++ phpdoc-fr/reference/nsapi/functions/nsapi-request-headers.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.nsapi-request-headers" xmlns="http://docbook.org/ns/docbook"> @@ -32,7 +32,7 @@ <note> <para> Vous pouvez aussi obtenir une valeur des variables CGI communes en lisant - dans la variable <literal>$_SERVER</literal>, qui fonctionne + dans la variable <varname>$_SERVER</varname>, qui fonctionne si vous utilisez PHP en tant que module <productname>NSAPI</productname> ou non. </para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/oci8/functions/oci-bind-by-name.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/oci8/functions/oci-bind-by-name.xml diff -u phpdoc-fr/reference/oci8/functions/oci-bind-by-name.xml:1.16 phpdoc-fr/reference/oci8/functions/oci-bind-by-name.xml:1.17 --- phpdoc-fr/reference/oci8/functions/oci-bind-by-name.xml:1.16 Sat Jun 21 20:51:39 2008 +++ phpdoc-fr/reference/oci8/functions/oci-bind-by-name.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.16 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.oci-bind-by-name" xmlns="http://docbook.org/ns/docbook"> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/openssl/functions/openssl-pkcs12-read.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/openssl/functions/openssl-pkcs12-read.xml diff -u phpdoc-fr/reference/openssl/functions/openssl-pkcs12-read.xml:1.1 phpdoc-fr/reference/openssl/functions/openssl-pkcs12-read.xml:1.2 --- phpdoc-fr/reference/openssl/functions/openssl-pkcs12-read.xml:1.1 Sat Jun 7 07:44:21 2008 +++ phpdoc-fr/reference/openssl/functions/openssl-pkcs12-read.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-pkcs12-read"> @@ -13,13 +13,13 @@ &reftitle.description; <methodsynopsis> <type>bool</type><methodname>openssl_pkcs12_read</methodname> - <methodparam><type>mixed</type><parameter>PKCS12</parameter></methodparam> + <methodparam><type>string</type><parameter>pkcs12</parameter></methodparam> <methodparam><type>array</type><parameter role="reference">certs</parameter></methodparam> <methodparam><type>string</type><parameter>pass</parameter></methodparam> </methodsynopsis> <para> <function>openssl_pkcs12_read</function> lit le certificat PKCS#12 fourni par le - paramètre <parameter>PKCS12</parameter> dans un tableau nommé <parameter>certs</parameter>. + paramètre <parameter>pkcs12</parameter> dans un tableau nommé <parameter>certs</parameter>. </para> </refsect1> @@ -28,7 +28,7 @@ <para> <variablelist> <varlistentry> - <term><parameter>PKCS12</parameter></term> + <term><parameter>pkcs12</parameter></term> <listitem> <para> </para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/openssl/configure.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/openssl/configure.xml diff -u phpdoc-fr/reference/openssl/configure.xml:1.15 phpdoc-fr/reference/openssl/configure.xml:1.16 --- phpdoc-fr/reference/openssl/configure.xml:1.15 Sat Jun 21 20:51:40 2008 +++ phpdoc-fr/reference/openssl/configure.xml Sat Dec 27 17:02:09 2008 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <section xml:id="openssl.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.install; @@ -15,15 +15,22 @@ &ext.windows.path.dll; <filename>libeay32.dll</filename> </para> - <simpara> - De plus, si vous envisagez de générer des clés et de signer des messages, - vous devez installer un fichier <filename>openssl.cnf</filename> valide sur votre - système. Depuis PHP 4.3.0, une configuration simple est incluse dans le dossier - <filename>openssl</filename> de la distribution Windows. Si vous utilisez PHP - PHP 4.2.0 ou plus ancien, et que ces fichiers manquent, vous pouvez les - télécharger sur <link xlink:href="&url.openssl;">le site d'OpenSSL</link> ou en - téléchargeant les fichiers de configuration de PHP 4.3.0. - </simpara> + <para> + De plus, si vous avez prévu d'utiliser les fonctions relatives à la génération + de clés et aux certificats, vous devez installer un fichier + <filename>openssl.cnf</filename> valide sur votre système. Depuis PHP 4.3.0, + nous incluons un fichier de configuration de base dans les distributions + de PHP pour win32. PHP 4.3.x et 4.4.x ont ce fichier dans le dossier + <filename class="directory">openssl</filename>. PHP 5.x et 6.x ont ce fichier + dans le dossier <filename class="directory">extras/openssl</filename>. + Si vous utilisez PHP 4.2.x ou bien si le fichier n'est pas présent, vous + pouvez l'obtenir sur la page + <link xlink:href="&url.openssl.binaries;">des binaires OpenSSL</link> ou + en téléchargeant une version récente de PHP. Attention : Windows Explorer + cache par défaut les fichiers dont l'extension est + <filename>.cnf</filename> et indique que le type de fichier est + <literal>SpeedDial</literal>. + </para> <para> PHP va rechercher le fichier <filename>openssl.cnf</filename> suivant la tactique suivante : http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/outcontrol/functions/ob-start.xml?r1=1.30&r2=1.31&diff_format=u Index: phpdoc-fr/reference/outcontrol/functions/ob-start.xml diff -u phpdoc-fr/reference/outcontrol/functions/ob-start.xml:1.30 phpdoc-fr/reference/outcontrol/functions/ob-start.xml:1.31 --- phpdoc-fr/reference/outcontrol/functions/ob-start.xml:1.30 Thu Jun 26 18:19:49 2008 +++ phpdoc-fr/reference/outcontrol/functions/ob-start.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.30 $ --> -<!-- EN-Revision: 1.25 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.31 $ --> +<!-- EN-Revision: 1.26 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ob-start"> @@ -57,8 +57,10 @@ <para> Une fonction optionnelle de rappel peut être spécifiée. <function>ob_start</function> prend une chaîne comme paramètre, et - retourne une chaîne. Elle sera appelée par - <function>ob_end_flush</function> ou lorsque le tampon sera envoyé + retourne une chaîne. Elle sera appelée lorsque le tampon sera envoyé + ou supprimé (avec les fonctions <function>ob_flush</function>, + <function>ob_clean</function> ou des fonctions similaires) + ou lorsque le tampon sera envoyé au navigateur à la fin du script et recevra le contenu du tampon de sortie. Lorsque la fonction <parameter>output_callback</parameter> est appelée, elle doit retourner un nouveau contenu pour le tampon de sortie : http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/outcontrol/book.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/outcontrol/book.xml diff -u phpdoc-fr/reference/outcontrol/book.xml:1.3 phpdoc-fr/reference/outcontrol/book.xml:1.4 --- phpdoc-fr/reference/outcontrol/book.xml:1.3 Sat Jun 21 20:51:40 2008 +++ phpdoc-fr/reference/outcontrol/book.xml Sat Dec 27 17:02:10 2008 @@ -1,13 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <!-- Purpose: basic.php --> <!-- Membership: core --> <book xml:id="book.outcontrol" xmlns="http://docbook.org/ns/docbook"> <title>Bufferisation de sortie</title> - <title>Contrôle de l'affichage</title> + <titleabbrev>Contrôle de l'affichage</titleabbrev> <preface xml:id="intro.outcontrol"> &reftitle.intro; http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/ovrimos/functions/ovrimos-field-len.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/ovrimos/functions/ovrimos-field-len.xml diff -u phpdoc-fr/reference/ovrimos/functions/ovrimos-field-len.xml:1.11 phpdoc-fr/reference/ovrimos/functions/ovrimos-field-len.xml:1.12 --- phpdoc-fr/reference/ovrimos/functions/ovrimos-field-len.xml:1.11 Mon Jul 23 19:07:06 2007 +++ phpdoc-fr/reference/ovrimos/functions/ovrimos-field-len.xml Sat Dec 27 17:02:10 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.ovrimos-field-len" xmlns="http://docbook.org/ns/docbook"> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pcre/functions/preg-replace.xml?r1=1.27&r2=1.28&diff_format=u Index: phpdoc-fr/reference/pcre/functions/preg-replace.xml diff -u phpdoc-fr/reference/pcre/functions/preg-replace.xml:1.27 phpdoc-fr/reference/pcre/functions/preg-replace.xml:1.28 --- phpdoc-fr/reference/pcre/functions/preg-replace.xml:1.27 Sat Jun 21 20:51:41 2008 +++ phpdoc-fr/reference/pcre/functions/preg-replace.xml Sat Dec 27 17:02:10 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.27 $ --> -<!-- EN-Revision: 1.27 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.28 $ --> +<!-- EN-Revision: 1.29 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.preg-replace" xmlns="http://docbook.org/ns/docbook"> @@ -60,11 +60,13 @@ Si <parameter>replacement</parameter> à moins d'éléments que <parameter>pattern</parameter>, alors une chaîne vide est utilisée pour le reste des valeurs. + Pour utiliser les anti-slashes dans le masque, vous devez les doubler + (<literal>"\\\\"</literal>). </para> <para> <parameter>replacement</parameter> peut contenir des références de la forme <literal>\\<replaceable>n</replaceable></literal> ou, - (depuis PHP 4.0.4) <literal><replaceable>$n</replaceable></literal>. + (depuis PHP 4.0.4) <literal>$<replaceable>n</replaceable></literal>. Cette dernière forme est recommandée. Ces références seront remplacées par le texte capturé par la <replaceable>n</replaceable>-ième parenthèse capturante du masque. <replaceable>n</replaceable> peut prendre des http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pcre/book.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-fr/reference/pcre/book.xml diff -u phpdoc-fr/reference/pcre/book.xml:1.5 phpdoc-fr/reference/pcre/book.xml:1.6 --- phpdoc-fr/reference/pcre/book.xml:1.5 Sat May 31 12:36:01 2008 +++ phpdoc-fr/reference/pcre/book.xml Sat Dec 27 17:02:10 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <!-- Purpose: basic.text --> <!-- Membership: bundled --> @@ -45,6 +45,12 @@ Lisez <link xlink:href="&url.pcre.man;">&url.pcre.man;</link> pour plus de détails. </para> </warning> + <para> + La bibliothèque PCRE est un ensemble de fonctions qui implémentent les + expressions rationnelles en utilisant la même syntaxe et sémantique + que Perl 5 avec seulement quelques différence (voir plus bas). L'implémentation + courante correspond à Perl 5.005. + </para> </preface> &reference.pcre.setup; http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pcre/pattern.modifiers.xml?r1=1.23&r2=1.24&diff_format=u Index: phpdoc-fr/reference/pcre/pattern.modifiers.xml diff -u phpdoc-fr/reference/pcre/pattern.modifiers.xml:1.23 phpdoc-fr/reference/pcre/pattern.modifiers.xml:1.24 --- phpdoc-fr/reference/pcre/pattern.modifiers.xml:1.23 Sat Jun 21 20:51:40 2008 +++ phpdoc-fr/reference/pcre/pattern.modifiers.xml Sat Dec 27 17:02:10 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.23 $ --> -<!-- EN-Revision: 1.15 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.24 $ --> +<!-- EN-Revision: 1.16 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <article xml:id="reference.pcre.pattern.modifiers" xmlns="http://docbook.org/ns/docbook"> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pcre/pattern.syntax.xml?r1=1.37&r2=1.38&diff_format=u Index: phpdoc-fr/reference/pcre/pattern.syntax.xml diff -u phpdoc-fr/reference/pcre/pattern.syntax.xml:1.37 phpdoc-fr/reference/pcre/pattern.syntax.xml:1.38 --- phpdoc-fr/reference/pcre/pattern.syntax.xml:1.37 Wed May 21 18:17:52 2008 +++ phpdoc-fr/reference/pcre/pattern.syntax.xml Sat Dec 27 17:02:10 2008 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.37 $ --> -<!-- EN-Revision: 1.20 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.38 $ --> +<!-- EN-Revision: 1.23 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <chapter xml:id="reference.pcre.pattern.syntax" xmlns="http://docbook.org/ns/docbook"> - <title>syntaxe des masques</title> + <title>Syntaxe des masques</title> <titleabbrev>Fonctionnement des expressions rationnelles</titleabbrev> <section xml:id="pcre.pattern.syntax.description"> @@ -19,145 +19,6 @@ </simpara> </section> - <section xml:id="pcre.pattern.syntax.differences"> - <title>Différences avec Perl</title> - <para> - Les différences avec le Perl 5.005 sont présentées ici : - <orderedlist> - <listitem> - <simpara> - Par défaut, un caractère d'espacement correspond à - n'importe quel caractère que la fonction C <literal>isspace()</literal> reconnaît, - bien qu'il soit possible de recompiler la bibliothèque PCRE avec - d'autres tables de caractères. Normalement, <literal>isspace()</literal> retourne - &true; pour les espaces, les retours chariot, les - nouvelles lignes, les formfeed, les tabulations verticales et horizontales. - Le Perl 5 n'accepte plus la tabulation verticale comme caractère - d'espacement. La séquence \v qui était dans la documentation - Perl depuis longtemps n'a jamais été reconnue. Cependant, la - tabulation verticale elle-même était reconnue comme un - caractère d'espacement jusqu'à la version 5.002. Avec les - versions 5.004 et 5.005, l'option \s l'ignore. - </simpara> - </listitem> - <listitem> - <simpara> - PRCE ne tolère pas la répétition de quantificateurs - dans les expressions. Perl le permet, mais cela ne signifie pas ce que vous - pourriez penser. Par exemple, (?!a){3} ne s'interprète pas : les trois - caractères suivants ne sont pas des "a". En fait, cela - s'interprète comme : le caractère suivant n'est pas "a" trois fois. - </simpara> - </listitem> - <listitem> - <simpara> - Les occurrences de sous-masques qui interviennent dans des assertions - négatives sont comptées, mais elles ne sont pas - enregistrées dans le vecteur d'occurrences. Perl modifie ses - variables numériques pour toutes les occurrences de sous-masque, - avant que l'assertion ne vérifie le masque entier, et uniquement si - les sous-masques ne trouvent qu'une seule occurrence. - </simpara> - </listitem> - <listitem> - <simpara> - Bien que les caractères nul soient tolérés dans la - chaîne de recherche, ils ne sont pas acceptés dans le - masque, car le masque est utilisé comme une chaîne C - standard, terminée par le caractère nul. Il faut donc - utiliser la séquence d'échappement "\x00" dans le masque - pour rechercher les caractères nul. - </simpara> - </listitem> - <listitem> - <simpara> - Les séquences d'échappement suivantes ne sont pas - supportées par Perl : \l, \u, \L, \U. - En fait, elles sont implémentées par la gestion - intrinsèque de chaînes du Perl, et ne font pas partie - de ses caractères spéciaux. - </simpara> - </listitem> - <listitem> - <simpara> - L'assertion \G du Perl n'est pas supportée car elle n'est pas - pertinente pour faire des recherches avec des masques uniques. - </simpara> - </listitem> - <listitem> - <simpara> - De manière assez évidente, PCRE n'accepte pas la - construction <literal>(?{code})</literal> et <literal>(??{code})</literal>. - Cependant, les masques récursifs sont supportés. - </simpara> - </listitem> - <listitem> - <simpara> - Au moment de l'écriture de PCRE, Perl 5.005_02 avait quelques - comportements étranges avec la capture des chaînes - lorsqu'une partie du masque est redoublée. Par exemple, "aba" avec - le masque /^(a(b)?)+$/ va affecter à $2 la valeur "b", mais la - même manipulation avec "aabbaa" et /^(aa(bb)?)+$/ laissera $2 vide. - Cependant, si le masque est remplacé par /^(aa(b(b))?)+$/ alors $2 - (et d'ailleurs $3) seront correctement affectés. Avec le Perl - 5.004, $2 sera correctement affecté dans les deux cas, et c'est - aussi vrai avec PCRE. Si Perl évolue vers un autre comportement - cohérent, PCRE s'adaptera probablement. - </simpara> - </listitem> - <listitem> - <simpara> - Une autre différence encore non résolue est le fait qu'en - Perl 5.005_02 le masque /^(a)?(?(1)a|b)+$/ accepte la chaîne "a", - tandis que PCRE ne l'accepte pas. Cependant, que ce soit avec Perl ou - PCRE /^(a)?a/ et "a" laisseront $1 vide. - </simpara> - </listitem> - <listitem> - <para> - PCRE propose quelques extensions aux expressions rationnelles du Perl. - <orderedlist> - <listitem> - <simpara> - (a) Bien que les assertions arrières (<literal>lookbehind</literal>) soient obligées - de rechercher une chaîne de longueur fixe, toutes les assertions - arrières peuvent avoir une longueur différente. Perl 5.005 leur - impose d'avoir toutes la même longueur. - </simpara> - </listitem> - <listitem> - <simpara> - (b) Si <link linkend="reference.pcre.pattern.modifiers">PCRE_DOLLAR_ENDONLY</link> est - activé, et que <link linkend="reference.pcre.pattern.modifiers">PCRE_MULTILINE</link> - ne l'est pas, le métacaractère - <literal>$</literal> ne s'applique qu'à la fin - physique de la chaîne, et non pas avant les caractères - de nouvelle ligne. - </simpara> - </listitem> - <listitem> - <simpara> - (c) Si <link linkend="reference.pcre.pattern.modifiers">PCRE_EXTRA</link> est - activé, un antislash suivi d'une lettre sans signification - spéciale est considéré comme une erreur. - </simpara> - </listitem> - <listitem> - <simpara> - (d) Si <link linkend="reference.pcre.pattern.modifiers">PCRE_UNGREEDY</link> est - activé, la "gourmandise" des quantificateurs de - répétition est inversée, ce qui est rend non - gourmand par défaut, mais s'ils sont suivis de ?, il seront - gourmands. - </simpara> - </listitem> - </orderedlist> - </para> - </listitem> - </orderedlist> - </para> - </section> - <section xml:id="regexp.reference"> <title>Détails sur les expressions rationnelles</title> <section xml:id="regexp.introduction"> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pcre/pattern.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/pcre/pattern.xml diff -u phpdoc-fr/reference/pcre/pattern.xml:1.1 phpdoc-fr/reference/pcre/pattern.xml:1.2 --- phpdoc-fr/reference/pcre/pattern.xml:1.1 Sat Jun 7 07:44:21 2008 +++ phpdoc-fr/reference/pcre/pattern.xml Sat Dec 27 17:02:10 2008 @@ -1,12 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> -<!-- Reviewed: no --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- Reviewed: yes --> <part xml:id="pcre.pattern"> <title>Masques PCRE</title> &reference.pcre.pattern.modifiers; + &reference.pcre.pattern.differences; &reference.pcre.pattern.syntax; </part> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pcre/pattern.differences.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pcre/pattern.differences.xml +++ phpdoc-fr/reference/pcre/pattern.differences.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <article xml:id="reference.pcre.pattern.differences" xmlns="http://docbook.org/ns/docbook"> <title>Différences avec Perl</title> <titleabbrev>Différences avec Perl</titleabbrev> <para> Les différences avec Perl 5.005 sont présentées ici : <orderedlist> <listitem> <simpara> Par défaut, un caractère d'espacement correspond à n'importe quel caractère que la fonction C <literal>isspace()</literal> reconnaît, bien qu'il soit possible de recompiler la bibliothèque PCRE avec d'autres tables de caractères. Normalement, <literal>isspace()</literal> retourne &true; pour les espaces, les retours chariot, les nouvelles lignes, les formfeed, les tabulations verticales et horizontales. Perl 5 n'accepte plus la tabulation verticale comme caractère d'espacement. La séquence \v qui était dans la documentation Perl depuis longtemps n'a jamais été reconnue. Cependant, la tabulation verticale elle-même était reconnue comme un caractère d'espacement jusqu'à la version 5.002. Avec les versions 5.004 et 5.005, l'option \s l'ignore. </simpara> </listitem> <listitem> <simpara> PRCE ne tolère pas la répétition de quantificateurs dans les expressions. Perl le permet, mais cela ne signifie pas ce que vous pourriez penser. Par exemple, (?!a){3} ne s'interprète pas : les trois caractères suivants ne sont pas des "a". En fait, cela s'interprète comme : le caractère suivant n'est pas "a" trois fois. </simpara> </listitem> <listitem> <simpara> Les occurrences de sous-masques qui interviennent dans des assertions négatives sont comptées, mais elles ne sont pas enregistrées dans le vecteur d'occurrences. Perl modifie ses variables numériques pour toutes les occurrences de sous-masque, avant que l'assertion ne vérifie le masque entier, et uniquement si les sous-masques ne trouvent qu'une seule occurrence. </simpara> </listitem> <listitem> <simpara> Bien que les caractères nul soient tolérés dans la chaîne de recherche, ils ne sont pas acceptés dans le masque, car le masque est utilisé comme une chaîne C standard, terminée par le caractère nul. Il faut donc utiliser la séquence d'échappement "\x00" dans le masque pour rechercher les caractères nul. </simpara> </listitem> <listitem> <simpara> Les séquences d'échappement suivantes ne sont pas supportées par Perl : \l, \u, \L, \U. En fait, elles sont implémentées par la gestion intrinsèque de chaînes Perl, et ne font pas partie de ses caractères spéciaux. </simpara> </listitem> <listitem> <simpara> L'assertion \G du Perl n'est pas supportée car elle n'est pas pertinente pour faire des recherches avec des masques uniques. </simpara> </listitem> <listitem> <simpara> De manière assez évidente, PCRE n'accepte pas la construction <literal>(?{code})</literal> et <literal>(??{code})</literal>. Cependant, les masques récursifs sont supportés. </simpara> </listitem> <listitem> <simpara> Au moment de l'écriture de PCRE, Perl 5.005_02 avait quelques comportements étranges avec la capture des chaînes lorsqu'une partie du masque est redoublée. Par exemple, "aba" avec le masque /^(a(b)?)+$/ va affecter à $2 la valeur "b", mais la même manipulation avec "aabbaa" et /^(aa(bb)?)+$/ laissera $2 vide. Cependant, si le masque est remplacé par /^(aa(b(b))?)+$/ alors $2 (et d'ailleurs $3) seront correctement affectés. Avec le Perl 5.004, $2 sera correctement affecté dans les deux cas, et c'est aussi vrai avec PCRE. Si Perl évolue vers un autre comportement cohérent, PCRE s'adaptera probablement. </simpara> </listitem> <listitem> <simpara> Une autre différence encore non résolue est le fait qu'en Perl 5.005_02 le masque /^(a)?(?(1)a|b)+$/ accepte la chaîne "a", tandis que PCRE ne l'accepte pas. Cependant, que ce soit avec Perl ou PCRE /^(a)?a/ et "a" laisseront $1 vide. </simpara> </listitem> <listitem> <para> PCRE propose quelques extensions aux expressions rationnelles du Perl. <orderedlist> <listitem> <simpara> (a) Bien que les assertions arrières (<literal>lookbehind</literal>) soient obligées de rechercher une chaîne de longueur fixe, toutes les assertions arrières peuvent avoir une longueur différente. Perl 5.005 leur impose d'avoir toutes la même longueur. </simpara> </listitem> <listitem> <simpara> (b) Si <link linkend="reference.pcre.pattern.modifiers">PCRE_DOLLAR_ENDONLY</link> est activé, et que <link linkend="reference.pcre.pattern.modifiers">PCRE_MULTILINE</link> ne l'est pas, le métacaractère <literal>$</literal> ne s'applique qu'à la fin physique de la chaîne, et non pas avant les caractères de nouvelle ligne. </simpara> </listitem> <listitem> <simpara> (c) Si <link linkend="reference.pcre.pattern.modifiers">PCRE_EXTRA</link> est activé, un antislash suivi d'une lettre sans signification spéciale est considéré comme une erreur. </simpara> </listitem> <listitem> <simpara> (d) Si <link linkend="reference.pcre.pattern.modifiers">PCRE_UNGREEDY</link> est activé, la "gourmandise" des quantificateurs de répétition est inversée, ce qui est rend non gourmand par défaut, mais s'ils sont suivis de ?, il seront gourmands. </simpara> </listitem> </orderedlist> </para> </listitem> </orderedlist> </para> </article> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/network/functions/fsockopen.xml?r1=1.21&r2=1.22&diff_format=u Index: phpdoc-fr/reference/network/functions/fsockopen.xml diff -u phpdoc-fr/reference/network/functions/fsockopen.xml:1.21 phpdoc-fr/reference/network/functions/fsockopen.xml:1.22 --- phpdoc-fr/reference/network/functions/fsockopen.xml:1.21 Tue May 13 11:34:33 2008 +++ phpdoc-fr/reference/network/functions/fsockopen.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> -<!-- EN-Revision: 1.23 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.22 $ --> +<!-- EN-Revision: 1.25 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fsockopen"> @@ -116,6 +116,14 @@ </para> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + <para> + Lance une alerte de type <constant>E_WARNING</constant> si le paramètre + <parameter>hostname</parameter> n'est pas un domaine valide. + </para> + </refsect1> + <refsect1 role="changelog"> &reftitle.changelog; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/network/functions/header.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-fr/reference/network/functions/header.xml diff -u phpdoc-fr/reference/network/functions/header.xml:1.7 phpdoc-fr/reference/network/functions/header.xml:1.8 --- phpdoc-fr/reference/network/functions/header.xml:1.7 Sun May 18 22:39:31 2008 +++ phpdoc-fr/reference/network/functions/header.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.header"> @@ -226,7 +226,7 @@ <![CDATA[ <?php header("Cache-Control: no-cache, must-revalidate"); // HTTP/1.1 -header("Expires: Mon, 26 Jul 1997 05:00:00 GMT"); // Date dans le passé +header("Expires: Sat, 26 Jul 1997 05:00:00 GMT"); // Date dans le passé ?> ]]> </programlisting> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/network/functions/inet-ntop.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/network/functions/inet-ntop.xml diff -u phpdoc-fr/reference/network/functions/inet-ntop.xml:1.10 phpdoc-fr/reference/network/functions/inet-ntop.xml:1.11 --- phpdoc-fr/reference/network/functions/inet-ntop.xml:1.10 Tue Jun 24 11:11:23 2008 +++ phpdoc-fr/reference/network/functions/inet-ntop.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.inet-ntop" xmlns="http://docbook.org/ns/docbook"> @@ -72,10 +72,6 @@ </para> </refsect1> - <refsect1 role="notes"> - &reftitle.notes; - </refsect1> - <refsect1 role="changelog"> &reftitle.changelog; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/network/functions/inet-pton.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/network/functions/inet-pton.xml diff -u phpdoc-fr/reference/network/functions/inet-pton.xml:1.11 phpdoc-fr/reference/network/functions/inet-pton.xml:1.12 --- phpdoc-fr/reference/network/functions/inet-pton.xml:1.11 Tue Jun 24 11:11:23 2008 +++ phpdoc-fr/reference/network/functions/inet-pton.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.inet-pton" xmlns="http://docbook.org/ns/docbook"> @@ -57,7 +57,6 @@ $in_addr = inet_pton('127.0.0.1'); $in6_addr = inet_pton('::1'); - ?> ]]> </programlisting> @@ -65,10 +64,6 @@ </para> </refsect1> - <refsect1 role="notes"> - &reftitle.notes; - </refsect1> - <refsect1 role="changelog"> &reftitle.changelog; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/network/functions/openlog.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/network/functions/openlog.xml diff -u phpdoc-fr/reference/network/functions/openlog.xml:1.14 phpdoc-fr/reference/network/functions/openlog.xml:1.15 --- phpdoc-fr/reference/network/functions/openlog.xml:1.14 Sun May 18 22:39:31 2008 +++ phpdoc-fr/reference/network/functions/openlog.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.openlog" xmlns="http://docbook.org/ns/docbook"> @@ -194,7 +194,6 @@ &reftitle.seealso; <para> <simplelist> - <member><function>define_syslog_variables</function></member> <member><function>syslog</function></member> <member><function>closelog</function></member> </simplelist> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/network/functions/setcookie.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/network/functions/setcookie.xml diff -u phpdoc-fr/reference/network/functions/setcookie.xml:1.11 phpdoc-fr/reference/network/functions/setcookie.xml:1.12 --- phpdoc-fr/reference/network/functions/setcookie.xml:1.11 Sat Jun 21 20:51:38 2008 +++ phpdoc-fr/reference/network/functions/setcookie.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.setcookie" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -31,13 +31,13 @@ </para> <para> Une fois que le cookie a été placé, il est accessible dans les variables globales - <link linkend="reserved.variables.cookies">$_COOKIE</link> ou bien + <varname>$_COOKIE</varname> ou bien <varname>$HTTP_COOKIE_VARS</varname> arrays. Notez que les <link linkend="language.variables.superglobals">superglobales</link> telles que <varname>$_COOKIE</varname> sont disponibles en PHP depuis la version 4.1.0. Les valeurs de cookies existent aussi dans la variable - <link linkend="reserved.variables.request">$_REQUEST</link>. + <varname>$_REQUEST</varname>. </para> </refsect1> @@ -146,7 +146,7 @@ sécurisée existe. La valeur par défaut est &false;. Côté serveur, c'est au développeur d'envoyer ce genre de cookie uniquement sur les connexions sécurisées (e.g. en utilisant la variable - <literal>$_SERVER["HTTPS"]</literal>). + <varname>$_SERVER["HTTPS"]</varname>). </para> </listitem> </varlistentry> @@ -280,6 +280,30 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.2.0</entry> + <entry> + Le paramètre <parameter>httponly</parameter> a été ajouté. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; <note> @@ -320,8 +344,10 @@ Les cookies doivent être effacés avec les mêmes paramètres que ceux utilisés lors de leur création. Si l'argument <parameter>value</parameter> est une chaîne vide ou vaut &false; et - quelques autres arguments sont exactement les mêmes que lors du + que ls autres arguments sont exactement les mêmes que lors du positionnement du cookie, alors le cookie sera effacé du client. + En interne, l'effacement est réalisé en positionnant la valeur à + 'deleted' et la date d'expiration à une année dans le passé. </simpara> </listitem> <listitem> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/network/functions/syslog.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/network/functions/syslog.xml diff -u phpdoc-fr/reference/network/functions/syslog.xml:1.18 phpdoc-fr/reference/network/functions/syslog.xml:1.19 --- phpdoc-fr/reference/network/functions/syslog.xml:1.18 Sun May 18 22:39:31 2008 +++ phpdoc-fr/reference/network/functions/syslog.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.syslog" xmlns="http://docbook.org/ns/docbook"> @@ -118,7 +118,6 @@ <programlisting role="php"> <![CDATA[ <?php -define_syslog_variables(); // ouverture de syslog, ajout du PID et envoi simultané du // message à la sortie standard et à un mécanisme // spécifique @@ -162,7 +161,6 @@ &reftitle.seealso; <para> <simplelist> - <member><function>define_syslog_variables</function></member> <member><function>openlog</function></member> <member><function>closelog</function></member> </simplelist> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/nsapi/functions/nsapi-request-headers.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/nsapi/functions/nsapi-request-headers.xml diff -u phpdoc-fr/reference/nsapi/functions/nsapi-request-headers.xml:1.13 phpdoc-fr/reference/nsapi/functions/nsapi-request-headers.xml:1.14 --- phpdoc-fr/reference/nsapi/functions/nsapi-request-headers.xml:1.13 Sat Jun 21 20:51:39 2008 +++ phpdoc-fr/reference/nsapi/functions/nsapi-request-headers.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.nsapi-request-headers" xmlns="http://docbook.org/ns/docbook"> @@ -32,7 +32,7 @@ <note> <para> Vous pouvez aussi obtenir une valeur des variables CGI communes en lisant - dans la variable <literal>$_SERVER</literal>, qui fonctionne + dans la variable <varname>$_SERVER</varname>, qui fonctionne si vous utilisez PHP en tant que module <productname>NSAPI</productname> ou non. </para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/oci8/functions/oci-bind-by-name.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/oci8/functions/oci-bind-by-name.xml diff -u phpdoc-fr/reference/oci8/functions/oci-bind-by-name.xml:1.16 phpdoc-fr/reference/oci8/functions/oci-bind-by-name.xml:1.17 --- phpdoc-fr/reference/oci8/functions/oci-bind-by-name.xml:1.16 Sat Jun 21 20:51:39 2008 +++ phpdoc-fr/reference/oci8/functions/oci-bind-by-name.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.16 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.oci-bind-by-name" xmlns="http://docbook.org/ns/docbook"> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/openssl/functions/openssl-pkcs12-read.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/openssl/functions/openssl-pkcs12-read.xml diff -u phpdoc-fr/reference/openssl/functions/openssl-pkcs12-read.xml:1.1 phpdoc-fr/reference/openssl/functions/openssl-pkcs12-read.xml:1.2 --- phpdoc-fr/reference/openssl/functions/openssl-pkcs12-read.xml:1.1 Sat Jun 7 07:44:21 2008 +++ phpdoc-fr/reference/openssl/functions/openssl-pkcs12-read.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-pkcs12-read"> @@ -13,13 +13,13 @@ &reftitle.description; <methodsynopsis> <type>bool</type><methodname>openssl_pkcs12_read</methodname> - <methodparam><type>mixed</type><parameter>PKCS12</parameter></methodparam> + <methodparam><type>string</type><parameter>pkcs12</parameter></methodparam> <methodparam><type>array</type><parameter role="reference">certs</parameter></methodparam> <methodparam><type>string</type><parameter>pass</parameter></methodparam> </methodsynopsis> <para> <function>openssl_pkcs12_read</function> lit le certificat PKCS#12 fourni par le - paramètre <parameter>PKCS12</parameter> dans un tableau nommé <parameter>certs</parameter>. + paramètre <parameter>pkcs12</parameter> dans un tableau nommé <parameter>certs</parameter>. </para> </refsect1> @@ -28,7 +28,7 @@ <para> <variablelist> <varlistentry> - <term><parameter>PKCS12</parameter></term> + <term><parameter>pkcs12</parameter></term> <listitem> <para> </para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/openssl/configure.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/openssl/configure.xml diff -u phpdoc-fr/reference/openssl/configure.xml:1.15 phpdoc-fr/reference/openssl/configure.xml:1.16 --- phpdoc-fr/reference/openssl/configure.xml:1.15 Sat Jun 21 20:51:40 2008 +++ phpdoc-fr/reference/openssl/configure.xml Sat Dec 27 17:02:09 2008 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <section xml:id="openssl.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.install; @@ -15,15 +15,22 @@ &ext.windows.path.dll; <filename>libeay32.dll</filename> </para> - <simpara> - De plus, si vous envisagez de générer des clés et de signer des messages, - vous devez installer un fichier <filename>openssl.cnf</filename> valide sur votre - système. Depuis PHP 4.3.0, une configuration simple est incluse dans le dossier - <filename>openssl</filename> de la distribution Windows. Si vous utilisez PHP - PHP 4.2.0 ou plus ancien, et que ces fichiers manquent, vous pouvez les - télécharger sur <link xlink:href="&url.openssl;">le site d'OpenSSL</link> ou en - téléchargeant les fichiers de configuration de PHP 4.3.0. - </simpara> + <para> + De plus, si vous avez prévu d'utiliser les fonctions relatives à la génération + de clés et aux certificats, vous devez installer un fichier + <filename>openssl.cnf</filename> valide sur votre système. Depuis PHP 4.3.0, + nous incluons un fichier de configuration de base dans les distributions + de PHP pour win32. PHP 4.3.x et 4.4.x ont ce fichier dans le dossier + <filename class="directory">openssl</filename>. PHP 5.x et 6.x ont ce fichier + dans le dossier <filename class="directory">extras/openssl</filename>. + Si vous utilisez PHP 4.2.x ou bien si le fichier n'est pas présent, vous + pouvez l'obtenir sur la page + <link xlink:href="&url.openssl.binaries;">des binaires OpenSSL</link> ou + en téléchargeant une version récente de PHP. Attention : Windows Explorer + cache par défaut les fichiers dont l'extension est + <filename>.cnf</filename> et indique que le type de fichier est + <literal>SpeedDial</literal>. + </para> <para> PHP va rechercher le fichier <filename>openssl.cnf</filename> suivant la tactique suivante : http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/outcontrol/functions/ob-start.xml?r1=1.30&r2=1.31&diff_format=u Index: phpdoc-fr/reference/outcontrol/functions/ob-start.xml diff -u phpdoc-fr/reference/outcontrol/functions/ob-start.xml:1.30 phpdoc-fr/reference/outcontrol/functions/ob-start.xml:1.31 --- phpdoc-fr/reference/outcontrol/functions/ob-start.xml:1.30 Thu Jun 26 18:19:49 2008 +++ phpdoc-fr/reference/outcontrol/functions/ob-start.xml Sat Dec 27 17:02:09 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.30 $ --> -<!-- EN-Revision: 1.25 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.31 $ --> +<!-- EN-Revision: 1.26 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ob-start"> @@ -57,8 +57,10 @@ <para> Une fonction optionnelle de rappel peut être spécifiée. <function>ob_start</function> prend une chaîne comme paramètre, et - retourne une chaîne. Elle sera appelée par - <function>ob_end_flush</function> ou lorsque le tampon sera envoyé + retourne une chaîne. Elle sera appelée lorsque le tampon sera envoyé + ou supprimé (avec les fonctions <function>ob_flush</function>, + <function>ob_clean</function> ou des fonctions similaires) + ou lorsque le tampon sera envoyé au navigateur à la fin du script et recevra le contenu du tampon de sortie. Lorsque la fonction <parameter>output_callback</parameter> est appelée, elle doit retourner un nouveau contenu pour le tampon de sortie : http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/outcontrol/book.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/outcontrol/book.xml diff -u phpdoc-fr/reference/outcontrol/book.xml:1.3 phpdoc-fr/reference/outcontrol/book.xml:1.4 --- phpdoc-fr/reference/outcontrol/book.xml:1.3 Sat Jun 21 20:51:40 2008 +++ phpdoc-fr/reference/outcontrol/book.xml Sat Dec 27 17:02:10 2008 @@ -1,13 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <!-- Purpose: basic.php --> <!-- Membership: core --> <book xml:id="book.outcontrol" xmlns="http://docbook.org/ns/docbook"> <title>Bufferisation de sortie</title> - <title>Contrôle de l'affichage</title> + <titleabbrev>Contrôle de l'affichage</titleabbrev> <preface xml:id="intro.outcontrol"> &reftitle.intro; http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/ovrimos/functions/ovrimos-field-len.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/ovrimos/functions/ovrimos-field-len.xml diff -u phpdoc-fr/reference/ovrimos/functions/ovrimos-field-len.xml:1.11 phpdoc-fr/reference/ovrimos/functions/ovrimos-field-len.xml:1.12 --- phpdoc-fr/reference/ovrimos/functions/ovrimos-field-len.xml:1.11 Mon Jul 23 19:07:06 2007 +++ phpdoc-fr/reference/ovrimos/functions/ovrimos-field-len.xml Sat Dec 27 17:02:10 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.ovrimos-field-len" xmlns="http://docbook.org/ns/docbook"> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pcre/functions/preg-replace.xml?r1=1.27&r2=1.28&diff_format=u Index: phpdoc-fr/reference/pcre/functions/preg-replace.xml diff -u phpdoc-fr/reference/pcre/functions/preg-replace.xml:1.27 phpdoc-fr/reference/pcre/functions/preg-replace.xml:1.28 --- phpdoc-fr/reference/pcre/functions/preg-replace.xml:1.27 Sat Jun 21 20:51:41 2008 +++ phpdoc-fr/reference/pcre/functions/preg-replace.xml Sat Dec 27 17:02:10 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.27 $ --> -<!-- EN-Revision: 1.27 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.28 $ --> +<!-- EN-Revision: 1.29 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.preg-replace" xmlns="http://docbook.org/ns/docbook"> @@ -60,11 +60,13 @@ Si <parameter>replacement</parameter> à moins d'éléments que <parameter>pattern</parameter>, alors une chaîne vide est utilisée pour le reste des valeurs. + Pour utiliser les anti-slashes dans le masque, vous devez les doubler + (<literal>"\\\\"</literal>). </para> <para> <parameter>replacement</parameter> peut contenir des références de la forme <literal>\\<replaceable>n</replaceable></literal> ou, - (depuis PHP 4.0.4) <literal><replaceable>$n</replaceable></literal>. + (depuis PHP 4.0.4) <literal>$<replaceable>n</replaceable></literal>. Cette dernière forme est recommandée. Ces références seront remplacées par le texte capturé par la <replaceable>n</replaceable>-ième parenthèse capturante du masque. <replaceable>n</replaceable> peut prendre des http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pcre/book.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-fr/reference/pcre/book.xml diff -u phpdoc-fr/reference/pcre/book.xml:1.5 phpdoc-fr/reference/pcre/book.xml:1.6 --- phpdoc-fr/reference/pcre/book.xml:1.5 Sat May 31 12:36:01 2008 +++ phpdoc-fr/reference/pcre/book.xml Sat Dec 27 17:02:10 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <!-- Purpose: basic.text --> <!-- Membership: bundled --> @@ -45,6 +45,12 @@ Lisez <link xlink:href="&url.pcre.man;">&url.pcre.man;</link> pour plus de détails. </para> </warning> + <para> + La bibliothèque PCRE est un ensemble de fonctions qui implémentent les + expressions rationnelles en utilisant la même syntaxe et sémantique + que Perl 5 avec seulement quelques différence (voir plus bas). L'implémentation + courante correspond à Perl 5.005. + </para> </preface> &reference.pcre.setup; http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pcre/pattern.modifiers.xml?r1=1.23&r2=1.24&diff_format=u Index: phpdoc-fr/reference/pcre/pattern.modifiers.xml diff -u phpdoc-fr/reference/pcre/pattern.modifiers.xml:1.23 phpdoc-fr/reference/pcre/pattern.modifiers.xml:1.24 --- phpdoc-fr/reference/pcre/pattern.modifiers.xml:1.23 Sat Jun 21 20:51:40 2008 +++ phpdoc-fr/reference/pcre/pattern.modifiers.xml Sat Dec 27 17:02:10 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.23 $ --> -<!-- EN-Revision: 1.15 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.24 $ --> +<!-- EN-Revision: 1.16 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <article xml:id="reference.pcre.pattern.modifiers" xmlns="http://docbook.org/ns/docbook"> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pcre/pattern.syntax.xml?r1=1.37&r2=1.38&diff_format=u Index: phpdoc-fr/reference/pcre/pattern.syntax.xml diff -u phpdoc-fr/reference/pcre/pattern.syntax.xml:1.37 phpdoc-fr/reference/pcre/pattern.syntax.xml:1.38 --- phpdoc-fr/reference/pcre/pattern.syntax.xml:1.37 Wed May 21 18:17:52 2008 +++ phpdoc-fr/reference/pcre/pattern.syntax.xml Sat Dec 27 17:02:10 2008 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.37 $ --> -<!-- EN-Revision: 1.20 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.38 $ --> +<!-- EN-Revision: 1.23 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <chapter xml:id="reference.pcre.pattern.syntax" xmlns="http://docbook.org/ns/docbook"> - <title>syntaxe des masques</title> + <title>Syntaxe des masques</title> <titleabbrev>Fonctionnement des expressions rationnelles</titleabbrev> <section xml:id="pcre.pattern.syntax.description"> @@ -19,145 +19,6 @@ </simpara> </section> - <section xml:id="pcre.pattern.syntax.differences"> - <title>Différences avec Perl</title> - <para> - Les différences avec le Perl 5.005 sont présentées ici : - <orderedlist> - <listitem> - <simpara> - Par défaut, un caractère d'espacement correspond à - n'importe quel caractère que la fonction C <literal>isspace()</literal> reconnaît, - bien qu'il soit possible de recompiler la bibliothèque PCRE avec - d'autres tables de caractères. Normalement, <literal>isspace()</literal> retourne - &true; pour les espaces, les retours chariot, les - nouvelles lignes, les formfeed, les tabulations verticales et horizontales. - Le Perl 5 n'accepte plus la tabulation verticale comme caractère - d'espacement. La séquence \v qui était dans la documentation - Perl depuis longtemps n'a jamais été reconnue. Cependant, la - tabulation verticale elle-même était reconnue comme un - caractère d'espacement jusqu'à la version 5.002. Avec les - versions 5.004 et 5.005, l'option \s l'ignore. - </simpara> - </listitem> - <listitem> - <simpara> - PRCE ne tolère pas la répétition de quantificateurs - dans les expressions. Perl le permet, mais cela ne signifie pas ce que vous - pourriez penser. Par exemple, (?!a){3} ne s'interprète pas : les trois - caractères suivants ne sont pas des "a". En fait, cela - s'interprète comme : le caractère suivant n'est pas "a" trois fois. - </simpara> - </listitem> - <listitem> - <simpara> - Les occurrences de sous-masques qui interviennent dans des assertions - négatives sont comptées, mais elles ne sont pas - enregistrées dans le vecteur d'occurrences. Perl modifie ses - variables numériques pour toutes les occurrences de sous-masque, - avant que l'assertion ne vérifie le masque entier, et uniquement si - les sous-masques ne trouvent qu'une seule occurrence. - </simpara> - </listitem> - <listitem> - <simpara> - Bien que les caractères nul soient tolérés dans la - chaîne de recherche, ils ne sont pas acceptés dans le - masque, car le masque est utilisé comme une chaîne C - standard, terminée par le caractère nul. Il faut donc - utiliser la séquence d'échappement "\x00" dans le masque - pour rechercher les caractères nul. - </simpara> - </listitem> - <listitem> - <simpara> - Les séquences d'échappement suivantes ne sont pas - supportées par Perl : \l, \u, \L, \U. - En fait, elles sont implémentées par la gestion - intrinsèque de chaînes du Perl, et ne font pas partie - de ses caractères spéciaux. - </simpara> - </listitem> - <listitem> - <simpara> - L'assertion \G du Perl n'est pas supportée car elle n'est pas - pertinente pour faire des recherches avec des masques uniques. - </simpara> - </listitem> - <listitem> - <simpara> - De manière assez évidente, PCRE n'accepte pas la - construction <literal>(?{code})</literal> et <literal>(??{code})</literal>. - Cependant, les masques récursifs sont supportés. - </simpara> - </listitem> - <listitem> - <simpara> - Au moment de l'écriture de PCRE, Perl 5.005_02 avait quelques - comportements étranges avec la capture des chaînes - lorsqu'une partie du masque est redoublée. Par exemple, "aba" avec - le masque /^(a(b)?)+$/ va affecter à $2 la valeur "b", mais la - même manipulation avec "aabbaa" et /^(aa(bb)?)+$/ laissera $2 vide. - Cependant, si le masque est remplacé par /^(aa(b(b))?)+$/ alors $2 - (et d'ailleurs $3) seront correctement affectés. Avec le Perl - 5.004, $2 sera correctement affecté dans les deux cas, et c'est - aussi vrai avec PCRE. Si Perl évolue vers un autre comportement - cohérent, PCRE s'adaptera probablement. - </simpara> - </listitem> - <listitem> - <simpara> - Une autre différence encore non résolue est le fait qu'en - Perl 5.005_02 le masque /^(a)?(?(1)a|b)+$/ accepte la chaîne "a", - tandis que PCRE ne l'accepte pas. Cependant, que ce soit avec Perl ou - PCRE /^(a)?a/ et "a" laisseront $1 vide. - </simpara> - </listitem> - <listitem> - <para> - PCRE propose quelques extensions aux expressions rationnelles du Perl. - <orderedlist> - <listitem> - <simpara> - (a) Bien que les assertions arrières (<literal>lookbehind</literal>) soient obligées - de rechercher une chaîne de longueur fixe, toutes les assertions - arrières peuvent avoir une longueur différente. Perl 5.005 leur - impose d'avoir toutes la même longueur. - </simpara> - </listitem> - <listitem> - <simpara> - (b) Si <link linkend="reference.pcre.pattern.modifiers">PCRE_DOLLAR_ENDONLY</link> est - activé, et que <link linkend="reference.pcre.pattern.modifiers">PCRE_MULTILINE</link> - ne l'est pas, le métacaractère - <literal>$</literal> ne s'applique qu'à la fin - physique de la chaîne, et non pas avant les caractères - de nouvelle ligne. - </simpara> - </listitem> - <listitem> - <simpara> - (c) Si <link linkend="reference.pcre.pattern.modifiers">PCRE_EXTRA</link> est - activé, un antislash suivi d'une lettre sans signification - spéciale est considéré comme une erreur. - </simpara> - </listitem> - <listitem> - <simpara> - (d) Si <link linkend="reference.pcre.pattern.modifiers">PCRE_UNGREEDY</link> est - activé, la "gourmandise" des quantificateurs de - répétition est inversée, ce qui est rend non - gourmand par défaut, mais s'ils sont suivis de ?, il seront - gourmands. - </simpara> - </listitem> - </orderedlist> - </para> - </listitem> - </orderedlist> - </para> - </section> - <section xml:id="regexp.reference"> <title>Détails sur les expressions rationnelles</title> <section xml:id="regexp.introduction"> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pcre/pattern.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/pcre/pattern.xml diff -u phpdoc-fr/reference/pcre/pattern.xml:1.1 phpdoc-fr/reference/pcre/pattern.xml:1.2 --- phpdoc-fr/reference/pcre/pattern.xml:1.1 Sat Jun 7 07:44:21 2008 +++ phpdoc-fr/reference/pcre/pattern.xml Sat Dec 27 17:02:10 2008 @@ -1,12 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> -<!-- Reviewed: no --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- Reviewed: yes --> <part xml:id="pcre.pattern"> <title>Masques PCRE</title> &reference.pcre.pattern.modifiers; + &reference.pcre.pattern.differences; &reference.pcre.pattern.syntax; </part> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pcre/pattern.differences.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pcre/pattern.differences.xml +++ phpdoc-fr/reference/pcre/pattern.differences.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <article xml:id="reference.pcre.pattern.differences" xmlns="http://docbook.org/ns/docbook"> <title>Différences avec Perl</title> <titleabbrev>Différences avec Perl</titleabbrev> <para> Les différences avec Perl 5.005 sont présentées ici : <orderedlist> <listitem> <simpara> Par défaut, un caractère d'espacement correspond à n'importe quel caractère que la fonction C <literal>isspace()</literal> reconnaît, bien qu'il soit possible de recompiler la bibliothèque PCRE avec d'autres tables de caractères. Normalement, <literal>isspace()</literal> retourne &true; pour les espaces, les retours chariot, les nouvelles lignes, les formfeed, les tabulations verticales et horizontales. Perl 5 n'accepte plus la tabulation verticale comme caractère d'espacement. La séquence \v qui était dans la documentation Perl depuis longtemps n'a jamais été reconnue. Cependant, la tabulation verticale elle-même était reconnue comme un caractère d'espacement jusqu'à la version 5.002. Avec les versions 5.004 et 5.005, l'option \s l'ignore. </simpara> </listitem> <listitem> <simpara> PRCE ne tolère pas la répétition de quantificateurs dans les expressions. Perl le permet, mais cela ne signifie pas ce que vous pourriez penser. Par exemple, (?!a){3} ne s'interprète pas : les trois caractères suivants ne sont pas des "a". En fait, cela s'interprète comme : le caractère suivant n'est pas "a" trois fois. </simpara> </listitem> <listitem> <simpara> Les occurrences de sous-masques qui interviennent dans des assertions négatives sont comptées, mais elles ne sont pas enregistrées dans le vecteur d'occurrences. Perl modifie ses variables numériques pour toutes les occurrences de sous-masque, avant que l'assertion ne vérifie le masque entier, et uniquement si les sous-masques ne trouvent qu'une seule occurrence. </simpara> </listitem> <listitem> <simpara> Bien que les caractères nul soient tolérés dans la chaîne de recherche, ils ne sont pas acceptés dans le masque, car le masque est utilisé comme une chaîne C standard, terminée par le caractère nul. Il faut donc utiliser la séquence d'échappement "\x00" dans le masque pour rechercher les caractères nul. </simpara> </listitem> <listitem> <simpara> Les séquences d'échappement suivantes ne sont pas supportées par Perl : \l, \u, \L, \U. En fait, elles sont implémentées par la gestion intrinsèque de chaînes Perl, et ne font pas partie de ses caractères spéciaux. </simpara> </listitem> <listitem> <simpara> L'assertion \G du Perl n'est pas supportée car elle n'est pas pertinente pour faire des recherches avec des masques uniques. </simpara> </listitem> <listitem> <simpara> De manière assez évidente, PCRE n'accepte pas la construction <literal>(?{code})</literal> et <literal>(??{code})</literal>. Cependant, les masques récursifs sont supportés. </simpara> </listitem> <listitem> <simpara> Au moment de l'écriture de PCRE, Perl 5.005_02 avait quelques comportements étranges avec la capture des chaînes lorsqu'une partie du masque est redoublée. Par exemple, "aba" avec le masque /^(a(b)?)+$/ va affecter à $2 la valeur "b", mais la même manipulation avec "aabbaa" et /^(aa(bb)?)+$/ laissera $2 vide. Cependant, si le masque est remplacé par /^(aa(b(b))?)+$/ alors $2 (et d'ailleurs $3) seront correctement affectés. Avec le Perl 5.004, $2 sera correctement affecté dans les deux cas, et c'est aussi vrai avec PCRE. Si Perl évolue vers un autre comportement cohérent, PCRE s'adaptera probablement. </simpara> </listitem> <listitem> <simpara> Une autre différence encore non résolue est le fait qu'en Perl 5.005_02 le masque /^(a)?(?(1)a|b)+$/ accepte la chaîne "a", tandis que PCRE ne l'accepte pas. Cependant, que ce soit avec Perl ou PCRE /^(a)?a/ et "a" laisseront $1 vide. </simpara> </listitem> <listitem> <para> PCRE propose quelques extensions aux expressions rationnelles du Perl. <orderedlist> <listitem> <simpara> (a) Bien que les assertions arrières (<literal>lookbehind</literal>) soient obligées de rechercher une chaîne de longueur fixe, toutes les assertions arrières peuvent avoir une longueur différente. Perl 5.005 leur impose d'avoir toutes la même longueur. </simpara> </listitem> <listitem> <simpara> (b) Si <link linkend="reference.pcre.pattern.modifiers">PCRE_DOLLAR_ENDONLY</link> est activé, et que <link linkend="reference.pcre.pattern.modifiers">PCRE_MULTILINE</link> ne l'est pas, le métacaractère <literal>$</literal> ne s'applique qu'à la fin physique de la chaîne, et non pas avant les caractères de nouvelle ligne. </simpara> </listitem> <listitem> <simpara> (c) Si <link linkend="reference.pcre.pattern.modifiers">PCRE_EXTRA</link> est activé, un antislash suivi d'une lettre sans signification spéciale est considéré comme une erreur. </simpara> </listitem> <listitem> <simpara> (d) Si <link linkend="reference.pcre.pattern.modifiers">PCRE_UNGREEDY</link> est activé, la "gourmandise" des quantificateurs de répétition est inversée, ce qui est rend non gourmand par défaut, mais s'ils sont suivis de ?, il seront gourmands. </simpara> </listitem> </orderedlist> </para> </listitem> </orderedlist> </para> </article> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->