cvs: phpdoc-fr /reference/mhash/functions mhash-count.xml mhash-get-block-size.xml mhash-get-hash-name.xml mhash-keygen-s2k.xml mhash.xml
/reference/mime_magic/functions mime-content-type.xml /reference/misc/functions usleep.xml /reference/muscat reference.xml
/reference/mysql/functions mysql-query.xml mysql-real-escape-string.xml /reference/mysqli/functions mysqli-affected-rows.xml
/reference/network/functions syslog.xml /reference/outcontrol/functions output-add-rewrite-var.xml /reference/overload/functions overload.xml
/reference/ovrimos reference.xml /reference/pdo_mysql reference.xml
| From: | Yannick Torres | Date: | Tue, 23 Jan 2007 19:58:21 +0000 |
| Subject: | cvs: phpdoc-fr /reference/mhash/functions mhash-count.xml mhash-get-block-size.xml mhash-get-hash-name.xml mhash-keygen-s2k.xml mhash.xml /reference/mime_magic/functions mime-content-type.xml /reference/misc/functions usleep.xml /reference/muscat reference.xml /reference/mysql/functions mysql-query.xml mysql-real-escape-string.xml /reference/mysqli/functions mysqli-affected-rows.xml /reference/network/functions syslog.xml /reference/outcontrol/functions output-add-rewrite-var.xml /reference/overload/functions overload.xml /reference/ovrimos reference.xml /reference/pdo_mysql reference.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-5186@lists.php.net to get a copy of this message | ||
yannick Tue Jan 23 19:58:21 2007 UTC
Modified files:
/phpdoc-fr/reference/mhash/functions mhash-count.xml
mhash-get-block-size.xml
mhash-get-hash-name.xml
mhash-keygen-s2k.xml mhash.xml
/phpdoc-fr/reference/mime_magic/functions mime-content-type.xml
/phpdoc-fr/reference/misc/functions usleep.xml
/phpdoc-fr/reference/muscat reference.xml
/phpdoc-fr/reference/mysql/functions mysql-query.xml
mysql-real-escape-string.xml
/phpdoc-fr/reference/mysqli/functions mysqli-affected-rows.xml
/phpdoc-fr/reference/network/functions syslog.xml
/phpdoc-fr/reference/outcontrol/functions
output-add-rewrite-var.xml
/phpdoc-fr/reference/overload/functions overload.xml
/phpdoc-fr/reference/ovrimos reference.xml
/phpdoc-fr/reference/pdo_mysql reference.xml
Log:
sync with EN
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/mhash/functions/mhash-count.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/mhash/functions/mhash-count.xml diff -u phpdoc-fr/reference/mhash/functions/mhash-count.xml:1.8 phpdoc-fr/reference/mhash/functions/mhash-count.xml:1.9 --- phpdoc-fr/reference/mhash/functions/mhash-count.xml:1.8 Tue Nov 16 21:55:51 2004 +++ phpdoc-fr/reference/mhash/functions/mhash-count.xml Tue Jan 23 19:58:21 2007 @@ -1,43 +1,56 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> - <refentry id="function.mhash-count"> - <refnamediv> - <refname>mhash_count</refname> - <refpurpose>retourne l'identifiant maximal de hash</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>mhash_count</methodname> - <void/> - </methodsynopsis> - <para> - <function>mhash_count</function> retourne l'identifiant de hash maximal. - Les hashs sont numérotés de 0 jusqu'à cet identifiant. - </para> - <para> - <example> - <title>Parcourir la liste des hash</title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> + +<refentry id="function.mhash-count"> + <refnamediv> + <refname>mhash_count</refname> + <refpurpose>Récupère l'identifiant maximal de hash</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>mhash_count</methodname> + <void/> + </methodsynopsis> + <para> + Récupère l'identifiant maximal de hash. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne l'identifiant de hash maximal. + Les hashs sont numérotés de 0 jusqu'à cet identifiant. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Parcourir la liste des hash</title> + <programlisting role="php"> <![CDATA[ <?php $nr = mhash_count(); for ($i = 0; $i <= $nr; $i++) { - echo sprintf ("La taille de bloc de %s est %d\n", + echo sprintf("La taille de bloc de %s est %d\n", mhash_get_hash_name($i), mhash_get_block_size($i)); } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -58,4 +71,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/mhash/functions/mhash-get-block-size.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/mhash/functions/mhash-get-block-size.xml diff -u phpdoc-fr/reference/mhash/functions/mhash-get-block-size.xml:1.8 phpdoc-fr/reference/mhash/functions/mhash-get-block-size.xml:1.9 --- phpdoc-fr/reference/mhash/functions/mhash-get-block-size.xml:1.8 Tue Nov 16 21:55:51 2004 +++ phpdoc-fr/reference/mhash/functions/mhash-get-block-size.xml Tue Jan 23 19:58:21 2007 @@ -1,29 +1,66 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> - <refentry id="function.mhash-get-block-size"> - <refnamediv> - <refname>mhash_get_block_size</refname> - <refpurpose>Retourne la taille de bloc du hash</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>mhash_get_block_size</methodname> - <methodparam><type>int</type><parameter>hash</parameter></methodparam> - </methodsynopsis> - <para> - <function>mhash_get_block_size</function> sert à connaître la - taille de bloc du hash spécifié <parameter>hash</parameter>. - </para> - <para> - <function>mhash_get_block_size</function> prend un seul argument : le - <parameter>hash</parameter> et retourne la taille en octets, ou bien &false; - si le <parameter>hash</parameter> n'existe pas. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> + +<refentry id="function.mhash-get-block-size"> + <refnamediv> + <refname>mhash_get_block_size</refname> + <refpurpose>Retourne la taille de bloc du hash</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>mhash_get_block_size</methodname> + <methodparam><type>int</type><parameter>hash</parameter></methodparam> + </methodsynopsis> + <para> + Retourne la taille de bloc du hash spécifié. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>hash</parameter></term> + <listitem> + <para> + L'identifiant du hash. Une des constantes <literal>MHASH_XXX</literal>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne la taille, en octets, ou &false; si le hash n'existe pas. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>mhash_get_block_size</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +echo mhash_get_block_size(MHASH_MD5); // 16 + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -44,4 +81,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/mhash/functions/mhash-get-hash-name.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/mhash/functions/mhash-get-hash-name.xml diff -u phpdoc-fr/reference/mhash/functions/mhash-get-hash-name.xml:1.10 phpdoc-fr/reference/mhash/functions/mhash-get-hash-name.xml:1.11 --- phpdoc-fr/reference/mhash/functions/mhash-get-hash-name.xml:1.10 Fri May 27 17:42:58 2005 +++ phpdoc-fr/reference/mhash/functions/mhash-get-hash-name.xml Tue Jan 23 19:58:21 2007 @@ -1,48 +1,66 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> - <refentry id="function.mhash-get-hash-name"> - <refnamediv> - <refname>mhash_get_hash_name</refname> - <refpurpose>Retourne le nom du hash</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>mhash_get_hash_name</methodname> - <methodparam><type>int</type><parameter>hash</parameter></methodparam> - </methodsynopsis> - <para> - <function>mhash_get_hash_name</function> sert à connaître le - nom d'un hash. - </para> - <para> - <function>mhash_get_hash_name</function> prend un numero d'identifiant de - hash, et retourne son nom ou &false; si le hash n'existe pas, ou si - une erreur est survenue. - </para> - <para> - <example> - <title>Exemple avec <function>mhash_get_hash_name</function></title> - <programlisting role="php"> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> + +<refentry id="function.mhash-get-hash-name"> + <refnamediv> + <refname>mhash_get_hash_name</refname> + <refpurpose>Retourne le nom du hash</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>mhash_get_hash_name</methodname> + <methodparam><type>int</type><parameter>hash</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le nom du hash spécifié. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>hash</parameter></term> + <listitem> + <para> + L'identifiant du hash. Une des constantes <literal>MHASH_XXX</literal>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom du hash ou &false; si le hash n'existe pas. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>mhash_get_hash_name</function></title> + <programlisting role="php"> <![CDATA[ <?php - $hash = MHASH_MD5; - print mhash_get_hash_name($hash); + +echo mhash_get_hash_name(MHASH_MD5); // MD5 + ?> ]]> - </programlisting> - &example.outputs; - <screen> -<![CDATA[ -MD5 -]]> - </screen> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/mhash/functions/mhash-keygen-s2k.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/mhash/functions/mhash-keygen-s2k.xml diff -u phpdoc-fr/reference/mhash/functions/mhash-keygen-s2k.xml:1.8 phpdoc-fr/reference/mhash/functions/mhash-keygen-s2k.xml:1.9 --- phpdoc-fr/reference/mhash/functions/mhash-keygen-s2k.xml:1.8 Tue Nov 16 21:55:51 2004 +++ phpdoc-fr/reference/mhash/functions/mhash-keygen-s2k.xml Tue Jan 23 19:58:21 2007 @@ -1,49 +1,97 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> - <refentry id="function.mhash-keygen-s2k"> - <refnamediv> - <refname>mhash_keygen_s2k</refname> - <refpurpose>Génère une clé</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>mhash_keygen_s2k</methodname> - <methodparam><type>int</type><parameter>hash</parameter></methodparam> - <methodparam><type>string</type><parameter>password</parameter></methodparam> - <methodparam><type>string</type><parameter>salt</parameter></methodparam> - <methodparam><type>int</type><parameter>bytes</parameter></methodparam> - </methodsynopsis> - <para> - <function>mhash_keygen_s2k</function> génère une clé de - <parameter>bytes</parameter> octets de long, à partir d'un mot de - passe. Cette fonction utilise l'algorithme Salted S2K, spécifié - dans OpenPGP (RFC 2440). Cet algorithme va utiliser l'algorithme de - hashage <parameter>hash</parameter> pour créer la clé. - Le paramètre <parameter>salt</parameter> doit être différent - et suffisamment aléatoire pour chaque clé que vous - génèrez, afin d'en créer des - différentes. Ce grain de sel ("salt") reservira lorsque vous vérifierez - les clés : c'est alors une bonne idée que de l'ajouter - à la fin de la clé générée. - <parameter>salt</parameter> doit avoir la longueur de 8 octets, et - sera complété par des 0 si vous ne fournissez - par suffisamment de données. - </para> - <para> - N'oubliez pas que les mots de passe - fournis par les utilisateurs ne sont pas conseillés pour faire des - clés cryptographiques, étant donné que les - utilisateurs normaux retiennent des mots de passe qu'ils peuvent - saisir au clavier. Ces mots de passe utilisent uniquement 6 à - 7 des 8 bits d'un caractère (voire moins). Il est vivement - recommandé d'appliquer une fonction de transformation (comme celle-ci), - à un mot de passe utilisateur. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> + +<refentry id="function.mhash-keygen-s2k"> + <refnamediv> + <refname>mhash_keygen_s2k</refname> + <refpurpose>Génère une clé</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>mhash_keygen_s2k</methodname> + <methodparam><type>int</type><parameter>hash</parameter></methodparam> + <methodparam><type>string</type><parameter>password</parameter></methodparam> + <methodparam><type>string</type><parameter>salt</parameter></methodparam> + <methodparam><type>int</type><parameter>bytes</parameter></methodparam> + </methodsynopsis> + <para> + Génère une clé de <parameter>bytes</parameter> + octets de long, à partir d'un mot de passe. + </para> + <para> + Cette fonction utilise l'algorithme Salted S2K, spécifié + dans OpenPGP (<ulink url="&url.rfc;2440">RFC 2440</ulink>). + </para> + <para> + N'oubliez pas que les mots de passe fournis par les utilisateurs + ne sont pas conseillés pour faire des clés cryptographiques, + étant donné que les utilisateurs normaux retiennent des mots + de passe qu'ils peuvent saisir au clavier. Ces mots de passe + utilisent uniquement 6 à 7 des 8 bits d'un caractère (voire moins). + Il est vivement recommandé d'appliquer une fonction de transformation + (comme celle-ci), à un mot de passe utilisateur. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>hash</parameter></term> + <listitem> + <para> + L'identifiant du hash utilisé pour créer la clé. + Une parmis les constantes <literal>MHASH_XXX</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>password</parameter></term> + <listitem> + <para> + Mot de passe fourni par l'utilisateur. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>salt</parameter></term> + <listitem> + <para> + Doit être différent et suffisamment aléatoire pour chaque + clé que vous génèrez, afin d'en créer des différentes. + Ce grain de sel ("salt") reservira lorsque vous vérifierez + les clés : c'est alors une bonne idée que de l'ajouter à la + fin de la clé générée. <parameter>salt</parameter> + doit avoir la longueur de 8 octets, et sera complété par + des 0 si vous ne fournissez par suffisamment de données. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>bytes</parameter></term> + <listitem> + <para> + La longueur de la clé, en octets. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne la clé générée, sous la forme d'une &string;, ou + &false; si une erreur survient. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -64,4 +112,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/mhash/functions/mhash.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/mhash/functions/mhash.xml diff -u phpdoc-fr/reference/mhash/functions/mhash.xml:1.8 phpdoc-fr/reference/mhash/functions/mhash.xml:1.9 --- phpdoc-fr/reference/mhash/functions/mhash.xml:1.8 Tue Nov 16 21:55:51 2004 +++ phpdoc-fr/reference/mhash/functions/mhash.xml Tue Jan 23 19:58:21 2007 @@ -1,32 +1,72 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> - <refentry id="function.mhash"> - <refnamediv> - <refname>mhash</refname> - <refpurpose>Calcule un hash</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>mhash</methodname> - <methodparam><type>int</type><parameter>hash</parameter></methodparam> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>key</parameter></methodparam> - </methodsynopsis> - <para> - <function>mhash</function> applique la fonction de hash - <parameter>hash</parameter> aux données <parameter>data</parameter> - et retourne le résultat. Si le paramètre <parameter>key</parameter> - est spécifié, il retournera le HMAC résultant. HMAC est un hash indexé - utilisé pour l'identification de message, ou bien un simple rapport de - message, suivant la clé spécifiée. Certains algorithmes supportés dans - mhash ne sont pas compatibles avec le mode HMAC. En cas d'erreur, la fonction - retourne &false;. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> + +<refentry id="function.mhash"> + <refnamediv> + <refname>mhash</refname> + <refpurpose>Calcule un hash</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>mhash</methodname> + <methodparam><type>int</type><parameter>hash</parameter></methodparam> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>key</parameter></methodparam> + </methodsynopsis> + <para> + <function>mhash</function> applique la fonction de hash + <parameter>hash</parameter> aux données <parameter>data</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>hash</parameter></term> + <listitem> + <para> + L'identifiant du hash. Une parmis les constantes + <literal>MHASH_XXX</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>data</parameter></term> + <listitem> + <para> + L'entrée utilisateur, sous la forme d'une &string;. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>key</parameter></term> + <listitem> + <para> + Spécifié, la fonction retournera le HMAC résultant. HMAC est un hash indexé + utilisé pour l'identification de message, ou bien un simple rapport de + message, suivant la clé spécifiée. Certains algorithmes supportés dans + mhash ne sont pas compatibles avec le mode HMAC. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le hash résultant (appelé aussi "digest") ou HMAC, sous la + forme d'une &string; ou &false; si une erreur survient. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -47,4 +87,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/mime_magic/functions/mime-content-type.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/mime_magic/functions/mime-content-type.xml diff -u phpdoc-fr/reference/mime_magic/functions/mime-content-type.xml:1.8 phpdoc-fr/reference/mime_magic/functions/mime-content-type.xml:1.9 --- phpdoc-fr/reference/mime_magic/functions/mime-content-type.xml:1.8 Fri May 27 17:42:58 2005 +++ phpdoc-fr/reference/mime_magic/functions/mime-content-type.xml Tue Jan 23 19:58:21 2007 @@ -1,47 +1,98 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> - <refentry id="function.mime-content-type"> - <refnamediv> - <refname>mime_content_type</refname> - <refpurpose>Détecte le type MIME d'un fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>mime_content_type</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>mime_content_type</function> retourne le type MIME du fichier - <parameter>filename</parameter> en se basant sur les informations - présentes dans le fichier <filename>magic.mime</filename>. - Le type est retourné au format MIME, comme <literal>text/plain</literal> - ou encore <literal>application/octet-stream</literal>. - </para> - <para> - <example> - <title>Exemple avec <function>mime_content_type</function></title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> + +<refentry id="function.mime-content-type"> + <refnamediv> + <refname>mime_content_type</refname> + <refpurpose>Détecte le type MIME d'un fichier (obsolète)</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>mime_content_type</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le type MIME du fichier <parameter>filename</parameter> + en se basant sur les informations présentes dans le fichier + <filename>magic.mime</filename>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + Chemin vers le fichier testé. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourn le type de contenu MIME, comme <literal>text/plain</literal> + ou encore <literal>application/octet-stream</literal>. + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <warning> + <para> + Cette fonction est devenue obsolète car l'extension PECL + <link linkend="ref.fileinfo">Fileinfo</link> fournit + la même fonctionnalité (et bien plus) d'une façon plus + propre. + </para> + </warning> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>mime_content_type</function></title> + <programlisting role="php"> <![CDATA[ <?php echo mime_content_type('php.gif') . "\n"; echo mime_content_type('test.php'); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ image/gif text/plain ]]> - </screen> - </example> - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member> + <link linkend="ref.fileinfo">Fileinfo</link> pour un remplacement + </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/misc/functions/usleep.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/misc/functions/usleep.xml diff -u phpdoc-fr/reference/misc/functions/usleep.xml:1.11 phpdoc-fr/reference/misc/functions/usleep.xml:1.12 --- phpdoc-fr/reference/misc/functions/usleep.xml:1.11 Tue Nov 16 21:55:54 2004 +++ phpdoc-fr/reference/misc/functions/usleep.xml Tue Jan 23 19:58:21 2007 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.7 Maintainer: dams Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> + <refentry id="function.usleep"> <refnamediv> <refname>usleep</refname> @@ -77,4 +78,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/muscat/reference.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-fr/reference/muscat/reference.xml diff -u phpdoc-fr/reference/muscat/reference.xml:1.7 phpdoc-fr/reference/muscat/reference.xml:1.8 --- phpdoc-fr/reference/muscat/reference.xml:1.7 Mon Sep 5 16:11:01 2005 +++ phpdoc-fr/reference/muscat/reference.xml Tue Jan 23 19:58:21 2007 @@ -1,26 +1,35 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.7 Maintainer: didou Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Purpose: basic.session --> <!-- Membership: pecl, external --> <!-- State: experimental --> -<!-- Reviewed: yes --> +<!-- Reviewed: no --> <reference id="ref.muscat"> - <title>Fonctions Muscat</title> - <titleabbrev>Muscat</titleabbrev> + <title>Fonctions muscat</title> + <titleabbrev>muscat</titleabbrev> <partintro> <section id="muscat.intro"> &reftitle.intro; + <para> + Cette extension fournit une interface au système de recherche Muscat 3.6. + Muscat n'existe plus, mais le projet <ulink + url="&url.muscat.xapian;">Xapian</ulink> peut vous fournir + une bonne alternative. + </para> &warn.experimental; </section> + &reference.muscat.configure; + </partintro> - &reference.muscat.functions; +&reference.muscat.functions; </reference> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -40,5 +49,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/mysql/functions/mysql-query.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/mysql/functions/mysql-query.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-query.xml:1.14 phpdoc-fr/reference/mysql/functions/mysql-query.xml:1.15 --- phpdoc-fr/reference/mysql/functions/mysql-query.xml:1.14 Fri Jan 6 04:30:30 2006 +++ phpdoc-fr/reference/mysql/functions/mysql-query.xml Tue Jan 23 19:58:21 2007 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.15 Maintainer: dams Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.16 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> + <refentry id="function.mysql-query"> <refnamediv> <refname>mysql_query</refname> @@ -16,9 +17,10 @@ <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <para> - <function>mysql_query</function> envoie une requête (au serveur MySQL - actuellement actif sur le serveur associé avec le - <parameter>link_identifier</parameter> spécifié). + <function>mysql_query</function> envoie une seule requête (les + requêtes multiples ne sont pas supportées) à la base de données + courante sur le serveur associé avec le <parameter>link_identifier</parameter> + spécifié. </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/mysql/functions/mysql-real-escape-string.xml?r1=1.22&r2=1.23&diff_format=u Index: phpdoc-fr/reference/mysql/functions/mysql-real-escape-string.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-real-escape-string.xml:1.22 phpdoc-fr/reference/mysql/functions/mysql-real-escape-string.xml:1.23 --- phpdoc-fr/reference/mysql/functions/mysql-real-escape-string.xml:1.22 Sun Mar 12 11:35:10 2006 +++ phpdoc-fr/reference/mysql/functions/mysql-real-escape-string.xml Tue Jan 23 19:58:21 2007 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.22 $ --> -<!-- EN-Revision: 1.26 Maintainer: dams Status: ready --> +<!-- $Revision: 1.23 $ --> +<!-- EN-Revision: 1.27 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> + <refentry id="function.mysql-real-escape-string"> <refnamediv> <refname>mysql_real_escape_string</refname> @@ -126,30 +127,42 @@ <programlisting role="php"> <![CDATA[ <?php -// Protège la variable -function quote_smart($value) -{ - // Stripslashes - if (get_magic_quotes_gpc()) { - $value = stripslashes($value); - } - // Protection si ce n'est pas une valeur numérique ou une chaîne numérique - if (!is_numeric($value)) { - $value = "'" . mysql_real_escape_string($value) . "'"; - } - return $value; -} -// Connexion -$link = mysql_connect('mysql_host', 'mysql_user', 'mysql_password') -OR die(mysql_error()); +if (isset($_POST['product_name']) && isset($_POST['product_description']) && isset($_POST['user_id'])) { + // Connect -// Fabrication d'une requête sécurisée -$query = sprintf("SELECT * FROM users WHERE user=%s AND password=%s", -quote_smart($_POST['username']), -quote_smart($_POST['password'])); + $link = mysql_connect('mysql_host', 'mysql_user', 'mysql_password'); -mysql_query($query); + if(!is_resource($link)) { + + echo "Échec de la connexion au serveur\n"; + // ... historisation de l'erreur + + } else { + + if(get_magic_quotes_gpc()) { + $product_name = stripslashes($_POST['product_name']); + $product_description = stripslashes($_POST['product_description']); + } else { + $product_name = $_POST['product_name']; + $product_description = $_POST['product_description']; + } + + // Faire une requête sécurisée + $query = sprintf("INSERT INTO products (`name`, `description`, `user_id`) VALUES ('%s', '%s', '%d')", + mysql_real_escape_string($product_name, $link), + mysql_real_escape_string($product_description, $link), + $_POST['user_id']); + + mysql_query($query, $link); + + if (mysql_affected_rows($link) > 0) { + echo "Produit inséré\n"; + } + } +} else { + echo "Remplissez le formulaire proprement\n"; +} ?> ]]> </programlisting> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml?r1=1.20&r2=1.21&diff_format=u Index: phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml diff -u phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml:1.20 phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml:1.21 --- phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml:1.20 Wed Sep 6 19:42:09 2006 +++ phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml Tue Jan 23 19:58:21 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.20 $ --> -<!-- EN-Revision: 1.20 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.21 $ --> +<!-- EN-Revision: 1.21 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry id="function.mysqli-affected-rows"> @@ -31,12 +31,6 @@ Si la dernière requête était invalide, cette fonction retournera -1. </para> - <note> - <para> - Pour les requêtes de type SELECT, <function>mysqli_affected_rows</function> - est identique à la fonction <function>mysqli_num_rows</function>. - </para> - </note> <para> La fonction <function>mysqli_affected_rows</function> ne fonctionne que pour les requêtes qui modifient une table. Pour connaître le http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/network/functions/syslog.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/network/functions/syslog.xml diff -u phpdoc-fr/reference/network/functions/syslog.xml:1.12 phpdoc-fr/reference/network/functions/syslog.xml:1.13 --- phpdoc-fr/reference/network/functions/syslog.xml:1.12 Sat Jun 25 22:17:20 2005 +++ phpdoc-fr/reference/network/functions/syslog.xml Tue Jan 23 19:58:21 2007 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> + <refentry id="function.syslog"> <refnamediv> <refname>syslog</refname> @@ -93,7 +94,7 @@ // client non autorisé! // notation de la tentative $access = date("Y/m/d H:i:s"); - syslog(LOG_WARNING, "Client non autorisé: $access $_SERVER[REMOTE_ADDR] ($_SERVER[HTTP_USER_AGENT])"); + syslog(LOG_WARNING, "Client non autorisé: $access {$_SERVER['REMOTE_ADDR']} ({$_SERVER['HTTP_USER_AGENT']})"); } closelog(); @@ -148,4 +149,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/outcontrol/functions/output-add-rewrite-var.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/outcontrol/functions/output-add-rewrite-var.xml diff -u phpdoc-fr/reference/outcontrol/functions/output-add-rewrite-var.xml:1.10 phpdoc-fr/reference/outcontrol/functions/output-add-rewrite-var.xml:1.11 --- phpdoc-fr/reference/outcontrol/functions/output-add-rewrite-var.xml:1.10 Wed Apr 19 20:40:03 2006 +++ phpdoc-fr/reference/outcontrol/functions/output-add-rewrite-var.xml Tue Jan 23 19:58:21 2007 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry id="function.output-add-rewrite-var"> <refnamediv> @@ -23,6 +23,7 @@ (en tant que champs cachés) de la même façon que pour les identifiants de session lorsque la réécriture d'URL est activée avec <link linkend="ini.session.use-trans-sid">session.use_trans_sid</link>. + Notez que les URLs absolues (http://example.com/..) ne sont pas réécrites. </para> <para> Ce comportement est contrôlé par l'option @@ -42,8 +43,9 @@ <?php output_add_rewrite_var('var', 'value'); -// un lien -echo '<a href="file.php">link</a>'; +// Quelques liens +echo '<a href="file.php">lien</a> +<a href="http://example.com">lien 2</a>'; // un formulaire echo '<form action="script.php" method="post"> @@ -57,7 +59,8 @@ &example.outputs; <screen> <![CDATA[ -<a href="file.php?var=value">link</a> +<a href="file.php?var=value">lien</a> +<a href="http://example.com">lien 2</a> <form action="script.php" method="post"> <input type="hidden" name="var" value="value" /> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/overload/functions/overload.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/overload/functions/overload.xml diff -u phpdoc-fr/reference/overload/functions/overload.xml:1.8 phpdoc-fr/reference/overload/functions/overload.xml:1.9 --- phpdoc-fr/reference/overload/functions/overload.xml:1.8 Sun Feb 20 14:46:01 2005 +++ phpdoc-fr/reference/overload/functions/overload.xml Tue Jan 23 19:58:21 2007 @@ -1,26 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> -<!-- Reviewed: yes --> - <refentry id="function.overload"> - <refnamediv> - <refname>overload</refname> - <refpurpose>Active la couche de contrôle des membres et méthodes</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>void</type><methodname>overload</methodname> - <methodparam choice="opt"><type>string</type><parameter>class_name</parameter></methodparam> - </methodsynopsis> - <para> - <function>overload</function> active le contrôle des - accesseurs et appels de méthodes pour la classe <parameter>class_name</parameter>. - <link linkend="overload.examples">Voir un exemple dans l'introduction - de ce chapitre</link>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> + +<refentry id="function.overload"> + <refnamediv> + <refname>overload</refname> + <refpurpose>Active la couche de contrôle des membres et méthodes</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>overload</methodname> + <methodparam><type>string</type><parameter>class_name</parameter></methodparam> + </methodsynopsis> + <para> + <function>overload</function> active le contrôle des + accesseurs et appels de méthodes pour la classe + <parameter>class_name</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>class_name</parameter></term> + <listitem> + <para> + Le nom de la classe surchargée, sous la forme d'une &string; + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + Voir un <link linkend="overload.examples">exemple</link> dans la + section d'introduction de cette partie. + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -41,4 +73,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/ovrimos/reference.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/ovrimos/reference.xml diff -u phpdoc-fr/reference/ovrimos/reference.xml:1.12 phpdoc-fr/reference/ovrimos/reference.xml:1.13 --- phpdoc-fr/reference/ovrimos/reference.xml:1.12 Mon Sep 5 16:11:08 2005 +++ phpdoc-fr/reference/ovrimos/reference.xml Tue Jan 23 19:58:21 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Purpose: database.vendors --> <!-- Membership: pecl, external --> <!-- Reviewed: yes --> @@ -18,7 +18,7 @@ </para> <note> <para> - &pecl.moved-ver;5.1.0. + &pecl.moved-ver;4.4.5 et &php; 5.1.0. </para> </note> ¬e.no-windows.extension; http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo_mysql/reference.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/pdo_mysql/reference.xml diff -u phpdoc-fr/reference/pdo_mysql/reference.xml:1.4 phpdoc-fr/reference/pdo_mysql/reference.xml:1.5 --- phpdoc-fr/reference/pdo_mysql/reference.xml:1.4 Tue Dec 13 22:11:05 2005 +++ phpdoc-fr/reference/pdo_mysql/reference.xml Tue Jan 23 19:58:21 2007 @@ -1,6 +1,6 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.8 Maintainer: jsgoupil Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.9 Maintainer: jsgoupil Status: ready --> <!-- Purpose: database.vendors --> <!-- Membership: bundled, external, pecl --> <!-- Reviewed: no --> @@ -15,7 +15,7 @@ <para> PDO_MYSQL est un pilote qui implémente l'<link linkend="ref.pdo">interface de &php; Data Objects (PDO)</link> pour - autoriser l'accès de &php; aux bases de données de MySQL 3.x et 4.x. + autoriser l'accès de &php; aux bases de données de MySQL 3.x, 4.x. et 5.x. </para> <para> PDO_MYSQL prendra avantage des requêtes natives préparées présentes dans
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/mhash/functions/mhash-count.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/mhash/functions/mhash-count.xml diff -u phpdoc-fr/reference/mhash/functions/mhash-count.xml:1.8 phpdoc-fr/reference/mhash/functions/mhash-count.xml:1.9 --- phpdoc-fr/reference/mhash/functions/mhash-count.xml:1.8 Tue Nov 16 21:55:51 2004 +++ phpdoc-fr/reference/mhash/functions/mhash-count.xml Tue Jan 23 19:58:21 2007 @@ -1,43 +1,56 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> - <refentry id="function.mhash-count"> - <refnamediv> - <refname>mhash_count</refname> - <refpurpose>retourne l'identifiant maximal de hash</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>mhash_count</methodname> - <void/> - </methodsynopsis> - <para> - <function>mhash_count</function> retourne l'identifiant de hash maximal. - Les hashs sont numérotés de 0 jusqu'à cet identifiant. - </para> - <para> - <example> - <title>Parcourir la liste des hash</title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> + +<refentry id="function.mhash-count"> + <refnamediv> + <refname>mhash_count</refname> + <refpurpose>Récupère l'identifiant maximal de hash</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>mhash_count</methodname> + <void/> + </methodsynopsis> + <para> + Récupère l'identifiant maximal de hash. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne l'identifiant de hash maximal. + Les hashs sont numérotés de 0 jusqu'à cet identifiant. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Parcourir la liste des hash</title> + <programlisting role="php"> <![CDATA[ <?php $nr = mhash_count(); for ($i = 0; $i <= $nr; $i++) { - echo sprintf ("La taille de bloc de %s est %d\n", + echo sprintf("La taille de bloc de %s est %d\n", mhash_get_hash_name($i), mhash_get_block_size($i)); } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -58,4 +71,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/mhash/functions/mhash-get-block-size.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/mhash/functions/mhash-get-block-size.xml diff -u phpdoc-fr/reference/mhash/functions/mhash-get-block-size.xml:1.8 phpdoc-fr/reference/mhash/functions/mhash-get-block-size.xml:1.9 --- phpdoc-fr/reference/mhash/functions/mhash-get-block-size.xml:1.8 Tue Nov 16 21:55:51 2004 +++ phpdoc-fr/reference/mhash/functions/mhash-get-block-size.xml Tue Jan 23 19:58:21 2007 @@ -1,29 +1,66 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> - <refentry id="function.mhash-get-block-size"> - <refnamediv> - <refname>mhash_get_block_size</refname> - <refpurpose>Retourne la taille de bloc du hash</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>mhash_get_block_size</methodname> - <methodparam><type>int</type><parameter>hash</parameter></methodparam> - </methodsynopsis> - <para> - <function>mhash_get_block_size</function> sert à connaître la - taille de bloc du hash spécifié <parameter>hash</parameter>. - </para> - <para> - <function>mhash_get_block_size</function> prend un seul argument : le - <parameter>hash</parameter> et retourne la taille en octets, ou bien &false; - si le <parameter>hash</parameter> n'existe pas. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> + +<refentry id="function.mhash-get-block-size"> + <refnamediv> + <refname>mhash_get_block_size</refname> + <refpurpose>Retourne la taille de bloc du hash</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>mhash_get_block_size</methodname> + <methodparam><type>int</type><parameter>hash</parameter></methodparam> + </methodsynopsis> + <para> + Retourne la taille de bloc du hash spécifié. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>hash</parameter></term> + <listitem> + <para> + L'identifiant du hash. Une des constantes <literal>MHASH_XXX</literal>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne la taille, en octets, ou &false; si le hash n'existe pas. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>mhash_get_block_size</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +echo mhash_get_block_size(MHASH_MD5); // 16 + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -44,4 +81,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/mhash/functions/mhash-get-hash-name.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/mhash/functions/mhash-get-hash-name.xml diff -u phpdoc-fr/reference/mhash/functions/mhash-get-hash-name.xml:1.10 phpdoc-fr/reference/mhash/functions/mhash-get-hash-name.xml:1.11 --- phpdoc-fr/reference/mhash/functions/mhash-get-hash-name.xml:1.10 Fri May 27 17:42:58 2005 +++ phpdoc-fr/reference/mhash/functions/mhash-get-hash-name.xml Tue Jan 23 19:58:21 2007 @@ -1,48 +1,66 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> - <refentry id="function.mhash-get-hash-name"> - <refnamediv> - <refname>mhash_get_hash_name</refname> - <refpurpose>Retourne le nom du hash</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>mhash_get_hash_name</methodname> - <methodparam><type>int</type><parameter>hash</parameter></methodparam> - </methodsynopsis> - <para> - <function>mhash_get_hash_name</function> sert à connaître le - nom d'un hash. - </para> - <para> - <function>mhash_get_hash_name</function> prend un numero d'identifiant de - hash, et retourne son nom ou &false; si le hash n'existe pas, ou si - une erreur est survenue. - </para> - <para> - <example> - <title>Exemple avec <function>mhash_get_hash_name</function></title> - <programlisting role="php"> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> + +<refentry id="function.mhash-get-hash-name"> + <refnamediv> + <refname>mhash_get_hash_name</refname> + <refpurpose>Retourne le nom du hash</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>mhash_get_hash_name</methodname> + <methodparam><type>int</type><parameter>hash</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le nom du hash spécifié. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>hash</parameter></term> + <listitem> + <para> + L'identifiant du hash. Une des constantes <literal>MHASH_XXX</literal>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom du hash ou &false; si le hash n'existe pas. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>mhash_get_hash_name</function></title> + <programlisting role="php"> <![CDATA[ <?php - $hash = MHASH_MD5; - print mhash_get_hash_name($hash); + +echo mhash_get_hash_name(MHASH_MD5); // MD5 + ?> ]]> - </programlisting> - &example.outputs; - <screen> -<![CDATA[ -MD5 -]]> - </screen> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/mhash/functions/mhash-keygen-s2k.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/mhash/functions/mhash-keygen-s2k.xml diff -u phpdoc-fr/reference/mhash/functions/mhash-keygen-s2k.xml:1.8 phpdoc-fr/reference/mhash/functions/mhash-keygen-s2k.xml:1.9 --- phpdoc-fr/reference/mhash/functions/mhash-keygen-s2k.xml:1.8 Tue Nov 16 21:55:51 2004 +++ phpdoc-fr/reference/mhash/functions/mhash-keygen-s2k.xml Tue Jan 23 19:58:21 2007 @@ -1,49 +1,97 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> - <refentry id="function.mhash-keygen-s2k"> - <refnamediv> - <refname>mhash_keygen_s2k</refname> - <refpurpose>Génère une clé</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>mhash_keygen_s2k</methodname> - <methodparam><type>int</type><parameter>hash</parameter></methodparam> - <methodparam><type>string</type><parameter>password</parameter></methodparam> - <methodparam><type>string</type><parameter>salt</parameter></methodparam> - <methodparam><type>int</type><parameter>bytes</parameter></methodparam> - </methodsynopsis> - <para> - <function>mhash_keygen_s2k</function> génère une clé de - <parameter>bytes</parameter> octets de long, à partir d'un mot de - passe. Cette fonction utilise l'algorithme Salted S2K, spécifié - dans OpenPGP (RFC 2440). Cet algorithme va utiliser l'algorithme de - hashage <parameter>hash</parameter> pour créer la clé. - Le paramètre <parameter>salt</parameter> doit être différent - et suffisamment aléatoire pour chaque clé que vous - génèrez, afin d'en créer des - différentes. Ce grain de sel ("salt") reservira lorsque vous vérifierez - les clés : c'est alors une bonne idée que de l'ajouter - à la fin de la clé générée. - <parameter>salt</parameter> doit avoir la longueur de 8 octets, et - sera complété par des 0 si vous ne fournissez - par suffisamment de données. - </para> - <para> - N'oubliez pas que les mots de passe - fournis par les utilisateurs ne sont pas conseillés pour faire des - clés cryptographiques, étant donné que les - utilisateurs normaux retiennent des mots de passe qu'ils peuvent - saisir au clavier. Ces mots de passe utilisent uniquement 6 à - 7 des 8 bits d'un caractère (voire moins). Il est vivement - recommandé d'appliquer une fonction de transformation (comme celle-ci), - à un mot de passe utilisateur. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> + +<refentry id="function.mhash-keygen-s2k"> + <refnamediv> + <refname>mhash_keygen_s2k</refname> + <refpurpose>Génère une clé</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>mhash_keygen_s2k</methodname> + <methodparam><type>int</type><parameter>hash</parameter></methodparam> + <methodparam><type>string</type><parameter>password</parameter></methodparam> + <methodparam><type>string</type><parameter>salt</parameter></methodparam> + <methodparam><type>int</type><parameter>bytes</parameter></methodparam> + </methodsynopsis> + <para> + Génère une clé de <parameter>bytes</parameter> + octets de long, à partir d'un mot de passe. + </para> + <para> + Cette fonction utilise l'algorithme Salted S2K, spécifié + dans OpenPGP (<ulink url="&url.rfc;2440">RFC 2440</ulink>). + </para> + <para> + N'oubliez pas que les mots de passe fournis par les utilisateurs + ne sont pas conseillés pour faire des clés cryptographiques, + étant donné que les utilisateurs normaux retiennent des mots + de passe qu'ils peuvent saisir au clavier. Ces mots de passe + utilisent uniquement 6 à 7 des 8 bits d'un caractère (voire moins). + Il est vivement recommandé d'appliquer une fonction de transformation + (comme celle-ci), à un mot de passe utilisateur. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>hash</parameter></term> + <listitem> + <para> + L'identifiant du hash utilisé pour créer la clé. + Une parmis les constantes <literal>MHASH_XXX</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>password</parameter></term> + <listitem> + <para> + Mot de passe fourni par l'utilisateur. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>salt</parameter></term> + <listitem> + <para> + Doit être différent et suffisamment aléatoire pour chaque + clé que vous génèrez, afin d'en créer des différentes. + Ce grain de sel ("salt") reservira lorsque vous vérifierez + les clés : c'est alors une bonne idée que de l'ajouter à la + fin de la clé générée. <parameter>salt</parameter> + doit avoir la longueur de 8 octets, et sera complété par + des 0 si vous ne fournissez par suffisamment de données. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>bytes</parameter></term> + <listitem> + <para> + La longueur de la clé, en octets. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne la clé générée, sous la forme d'une &string;, ou + &false; si une erreur survient. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -64,4 +112,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/mhash/functions/mhash.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/mhash/functions/mhash.xml diff -u phpdoc-fr/reference/mhash/functions/mhash.xml:1.8 phpdoc-fr/reference/mhash/functions/mhash.xml:1.9 --- phpdoc-fr/reference/mhash/functions/mhash.xml:1.8 Tue Nov 16 21:55:51 2004 +++ phpdoc-fr/reference/mhash/functions/mhash.xml Tue Jan 23 19:58:21 2007 @@ -1,32 +1,72 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> - <refentry id="function.mhash"> - <refnamediv> - <refname>mhash</refname> - <refpurpose>Calcule un hash</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>mhash</methodname> - <methodparam><type>int</type><parameter>hash</parameter></methodparam> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>key</parameter></methodparam> - </methodsynopsis> - <para> - <function>mhash</function> applique la fonction de hash - <parameter>hash</parameter> aux données <parameter>data</parameter> - et retourne le résultat. Si le paramètre <parameter>key</parameter> - est spécifié, il retournera le HMAC résultant. HMAC est un hash indexé - utilisé pour l'identification de message, ou bien un simple rapport de - message, suivant la clé spécifiée. Certains algorithmes supportés dans - mhash ne sont pas compatibles avec le mode HMAC. En cas d'erreur, la fonction - retourne &false;. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> + +<refentry id="function.mhash"> + <refnamediv> + <refname>mhash</refname> + <refpurpose>Calcule un hash</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>mhash</methodname> + <methodparam><type>int</type><parameter>hash</parameter></methodparam> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>key</parameter></methodparam> + </methodsynopsis> + <para> + <function>mhash</function> applique la fonction de hash + <parameter>hash</parameter> aux données <parameter>data</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>hash</parameter></term> + <listitem> + <para> + L'identifiant du hash. Une parmis les constantes + <literal>MHASH_XXX</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>data</parameter></term> + <listitem> + <para> + L'entrée utilisateur, sous la forme d'une &string;. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>key</parameter></term> + <listitem> + <para> + Spécifié, la fonction retournera le HMAC résultant. HMAC est un hash indexé + utilisé pour l'identification de message, ou bien un simple rapport de + message, suivant la clé spécifiée. Certains algorithmes supportés dans + mhash ne sont pas compatibles avec le mode HMAC. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le hash résultant (appelé aussi "digest") ou HMAC, sous la + forme d'une &string; ou &false; si une erreur survient. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -47,4 +87,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/mime_magic/functions/mime-content-type.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/mime_magic/functions/mime-content-type.xml diff -u phpdoc-fr/reference/mime_magic/functions/mime-content-type.xml:1.8 phpdoc-fr/reference/mime_magic/functions/mime-content-type.xml:1.9 --- phpdoc-fr/reference/mime_magic/functions/mime-content-type.xml:1.8 Fri May 27 17:42:58 2005 +++ phpdoc-fr/reference/mime_magic/functions/mime-content-type.xml Tue Jan 23 19:58:21 2007 @@ -1,47 +1,98 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> - <refentry id="function.mime-content-type"> - <refnamediv> - <refname>mime_content_type</refname> - <refpurpose>Détecte le type MIME d'un fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>mime_content_type</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>mime_content_type</function> retourne le type MIME du fichier - <parameter>filename</parameter> en se basant sur les informations - présentes dans le fichier <filename>magic.mime</filename>. - Le type est retourné au format MIME, comme <literal>text/plain</literal> - ou encore <literal>application/octet-stream</literal>. - </para> - <para> - <example> - <title>Exemple avec <function>mime_content_type</function></title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> + +<refentry id="function.mime-content-type"> + <refnamediv> + <refname>mime_content_type</refname> + <refpurpose>Détecte le type MIME d'un fichier (obsolète)</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>mime_content_type</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le type MIME du fichier <parameter>filename</parameter> + en se basant sur les informations présentes dans le fichier + <filename>magic.mime</filename>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + Chemin vers le fichier testé. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourn le type de contenu MIME, comme <literal>text/plain</literal> + ou encore <literal>application/octet-stream</literal>. + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <warning> + <para> + Cette fonction est devenue obsolète car l'extension PECL + <link linkend="ref.fileinfo">Fileinfo</link> fournit + la même fonctionnalité (et bien plus) d'une façon plus + propre. + </para> + </warning> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>mime_content_type</function></title> + <programlisting role="php"> <![CDATA[ <?php echo mime_content_type('php.gif') . "\n"; echo mime_content_type('test.php'); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ image/gif text/plain ]]> - </screen> - </example> - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member> + <link linkend="ref.fileinfo">Fileinfo</link> pour un remplacement + </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/misc/functions/usleep.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/misc/functions/usleep.xml diff -u phpdoc-fr/reference/misc/functions/usleep.xml:1.11 phpdoc-fr/reference/misc/functions/usleep.xml:1.12 --- phpdoc-fr/reference/misc/functions/usleep.xml:1.11 Tue Nov 16 21:55:54 2004 +++ phpdoc-fr/reference/misc/functions/usleep.xml Tue Jan 23 19:58:21 2007 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.7 Maintainer: dams Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> + <refentry id="function.usleep"> <refnamediv> <refname>usleep</refname> @@ -77,4 +78,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/muscat/reference.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-fr/reference/muscat/reference.xml diff -u phpdoc-fr/reference/muscat/reference.xml:1.7 phpdoc-fr/reference/muscat/reference.xml:1.8 --- phpdoc-fr/reference/muscat/reference.xml:1.7 Mon Sep 5 16:11:01 2005 +++ phpdoc-fr/reference/muscat/reference.xml Tue Jan 23 19:58:21 2007 @@ -1,26 +1,35 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.7 Maintainer: didou Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Purpose: basic.session --> <!-- Membership: pecl, external --> <!-- State: experimental --> -<!-- Reviewed: yes --> +<!-- Reviewed: no --> <reference id="ref.muscat"> - <title>Fonctions Muscat</title> - <titleabbrev>Muscat</titleabbrev> + <title>Fonctions muscat</title> + <titleabbrev>muscat</titleabbrev> <partintro> <section id="muscat.intro"> &reftitle.intro; + <para> + Cette extension fournit une interface au système de recherche Muscat 3.6. + Muscat n'existe plus, mais le projet <ulink + url="&url.muscat.xapian;">Xapian</ulink> peut vous fournir + une bonne alternative. + </para> &warn.experimental; </section> + &reference.muscat.configure; + </partintro> - &reference.muscat.functions; +&reference.muscat.functions; </reference> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -40,5 +49,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/mysql/functions/mysql-query.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/mysql/functions/mysql-query.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-query.xml:1.14 phpdoc-fr/reference/mysql/functions/mysql-query.xml:1.15 --- phpdoc-fr/reference/mysql/functions/mysql-query.xml:1.14 Fri Jan 6 04:30:30 2006 +++ phpdoc-fr/reference/mysql/functions/mysql-query.xml Tue Jan 23 19:58:21 2007 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.15 Maintainer: dams Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.16 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> + <refentry id="function.mysql-query"> <refnamediv> <refname>mysql_query</refname> @@ -16,9 +17,10 @@ <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam> </methodsynopsis> <para> - <function>mysql_query</function> envoie une requête (au serveur MySQL - actuellement actif sur le serveur associé avec le - <parameter>link_identifier</parameter> spécifié). + <function>mysql_query</function> envoie une seule requête (les + requêtes multiples ne sont pas supportées) à la base de données + courante sur le serveur associé avec le <parameter>link_identifier</parameter> + spécifié. </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/mysql/functions/mysql-real-escape-string.xml?r1=1.22&r2=1.23&diff_format=u Index: phpdoc-fr/reference/mysql/functions/mysql-real-escape-string.xml diff -u phpdoc-fr/reference/mysql/functions/mysql-real-escape-string.xml:1.22 phpdoc-fr/reference/mysql/functions/mysql-real-escape-string.xml:1.23 --- phpdoc-fr/reference/mysql/functions/mysql-real-escape-string.xml:1.22 Sun Mar 12 11:35:10 2006 +++ phpdoc-fr/reference/mysql/functions/mysql-real-escape-string.xml Tue Jan 23 19:58:21 2007 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.22 $ --> -<!-- EN-Revision: 1.26 Maintainer: dams Status: ready --> +<!-- $Revision: 1.23 $ --> +<!-- EN-Revision: 1.27 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> + <refentry id="function.mysql-real-escape-string"> <refnamediv> <refname>mysql_real_escape_string</refname> @@ -126,30 +127,42 @@ <programlisting role="php"> <![CDATA[ <?php -// Protège la variable -function quote_smart($value) -{ - // Stripslashes - if (get_magic_quotes_gpc()) { - $value = stripslashes($value); - } - // Protection si ce n'est pas une valeur numérique ou une chaîne numérique - if (!is_numeric($value)) { - $value = "'" . mysql_real_escape_string($value) . "'"; - } - return $value; -} -// Connexion -$link = mysql_connect('mysql_host', 'mysql_user', 'mysql_password') -OR die(mysql_error()); +if (isset($_POST['product_name']) && isset($_POST['product_description']) && isset($_POST['user_id'])) { + // Connect -// Fabrication d'une requête sécurisée -$query = sprintf("SELECT * FROM users WHERE user=%s AND password=%s", -quote_smart($_POST['username']), -quote_smart($_POST['password'])); + $link = mysql_connect('mysql_host', 'mysql_user', 'mysql_password'); -mysql_query($query); + if(!is_resource($link)) { + + echo "Échec de la connexion au serveur\n"; + // ... historisation de l'erreur + + } else { + + if(get_magic_quotes_gpc()) { + $product_name = stripslashes($_POST['product_name']); + $product_description = stripslashes($_POST['product_description']); + } else { + $product_name = $_POST['product_name']; + $product_description = $_POST['product_description']; + } + + // Faire une requête sécurisée + $query = sprintf("INSERT INTO products (`name`, `description`, `user_id`) VALUES ('%s', '%s', '%d')", + mysql_real_escape_string($product_name, $link), + mysql_real_escape_string($product_description, $link), + $_POST['user_id']); + + mysql_query($query, $link); + + if (mysql_affected_rows($link) > 0) { + echo "Produit inséré\n"; + } + } +} else { + echo "Remplissez le formulaire proprement\n"; +} ?> ]]> </programlisting> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml?r1=1.20&r2=1.21&diff_format=u Index: phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml diff -u phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml:1.20 phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml:1.21 --- phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml:1.20 Wed Sep 6 19:42:09 2006 +++ phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml Tue Jan 23 19:58:21 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.20 $ --> -<!-- EN-Revision: 1.20 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.21 $ --> +<!-- EN-Revision: 1.21 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry id="function.mysqli-affected-rows"> @@ -31,12 +31,6 @@ Si la dernière requête était invalide, cette fonction retournera -1. </para> - <note> - <para> - Pour les requêtes de type SELECT, <function>mysqli_affected_rows</function> - est identique à la fonction <function>mysqli_num_rows</function>. - </para> - </note> <para> La fonction <function>mysqli_affected_rows</function> ne fonctionne que pour les requêtes qui modifient une table. Pour connaître le http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/network/functions/syslog.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/network/functions/syslog.xml diff -u phpdoc-fr/reference/network/functions/syslog.xml:1.12 phpdoc-fr/reference/network/functions/syslog.xml:1.13 --- phpdoc-fr/reference/network/functions/syslog.xml:1.12 Sat Jun 25 22:17:20 2005 +++ phpdoc-fr/reference/network/functions/syslog.xml Tue Jan 23 19:58:21 2007 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> + <refentry id="function.syslog"> <refnamediv> <refname>syslog</refname> @@ -93,7 +94,7 @@ // client non autorisé! // notation de la tentative $access = date("Y/m/d H:i:s"); - syslog(LOG_WARNING, "Client non autorisé: $access $_SERVER[REMOTE_ADDR] ($_SERVER[HTTP_USER_AGENT])"); + syslog(LOG_WARNING, "Client non autorisé: $access {$_SERVER['REMOTE_ADDR']} ({$_SERVER['HTTP_USER_AGENT']})"); } closelog(); @@ -148,4 +149,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/outcontrol/functions/output-add-rewrite-var.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/outcontrol/functions/output-add-rewrite-var.xml diff -u phpdoc-fr/reference/outcontrol/functions/output-add-rewrite-var.xml:1.10 phpdoc-fr/reference/outcontrol/functions/output-add-rewrite-var.xml:1.11 --- phpdoc-fr/reference/outcontrol/functions/output-add-rewrite-var.xml:1.10 Wed Apr 19 20:40:03 2006 +++ phpdoc-fr/reference/outcontrol/functions/output-add-rewrite-var.xml Tue Jan 23 19:58:21 2007 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> <refentry id="function.output-add-rewrite-var"> <refnamediv> @@ -23,6 +23,7 @@ (en tant que champs cachés) de la même façon que pour les identifiants de session lorsque la réécriture d'URL est activée avec <link linkend="ini.session.use-trans-sid">session.use_trans_sid</link>. + Notez que les URLs absolues (http://example.com/..) ne sont pas réécrites. </para> <para> Ce comportement est contrôlé par l'option @@ -42,8 +43,9 @@ <?php output_add_rewrite_var('var', 'value'); -// un lien -echo '<a href="file.php">link</a>'; +// Quelques liens +echo '<a href="file.php">lien</a> +<a href="http://example.com">lien 2</a>'; // un formulaire echo '<form action="script.php" method="post"> @@ -57,7 +59,8 @@ &example.outputs; <screen> <![CDATA[ -<a href="file.php?var=value">link</a> +<a href="file.php?var=value">lien</a> +<a href="http://example.com">lien 2</a> <form action="script.php" method="post"> <input type="hidden" name="var" value="value" /> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/overload/functions/overload.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/overload/functions/overload.xml diff -u phpdoc-fr/reference/overload/functions/overload.xml:1.8 phpdoc-fr/reference/overload/functions/overload.xml:1.9 --- phpdoc-fr/reference/overload/functions/overload.xml:1.8 Sun Feb 20 14:46:01 2005 +++ phpdoc-fr/reference/overload/functions/overload.xml Tue Jan 23 19:58:21 2007 @@ -1,26 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> -<!-- Reviewed: yes --> - <refentry id="function.overload"> - <refnamediv> - <refname>overload</refname> - <refpurpose>Active la couche de contrôle des membres et méthodes</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>void</type><methodname>overload</methodname> - <methodparam choice="opt"><type>string</type><parameter>class_name</parameter></methodparam> - </methodsynopsis> - <para> - <function>overload</function> active le contrôle des - accesseurs et appels de méthodes pour la classe <parameter>class_name</parameter>. - <link linkend="overload.examples">Voir un exemple dans l'introduction - de ce chapitre</link>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> + +<refentry id="function.overload"> + <refnamediv> + <refname>overload</refname> + <refpurpose>Active la couche de contrôle des membres et méthodes</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>overload</methodname> + <methodparam><type>string</type><parameter>class_name</parameter></methodparam> + </methodsynopsis> + <para> + <function>overload</function> active le contrôle des + accesseurs et appels de méthodes pour la classe + <parameter>class_name</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>class_name</parameter></term> + <listitem> + <para> + Le nom de la classe surchargée, sous la forme d'une &string; + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + Voir un <link linkend="overload.examples">exemple</link> dans la + section d'introduction de cette partie. + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -41,4 +73,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/ovrimos/reference.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/ovrimos/reference.xml diff -u phpdoc-fr/reference/ovrimos/reference.xml:1.12 phpdoc-fr/reference/ovrimos/reference.xml:1.13 --- phpdoc-fr/reference/ovrimos/reference.xml:1.12 Mon Sep 5 16:11:08 2005 +++ phpdoc-fr/reference/ovrimos/reference.xml Tue Jan 23 19:58:21 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Purpose: database.vendors --> <!-- Membership: pecl, external --> <!-- Reviewed: yes --> @@ -18,7 +18,7 @@ </para> <note> <para> - &pecl.moved-ver;5.1.0. + &pecl.moved-ver;4.4.5 et &php; 5.1.0. </para> </note> ¬e.no-windows.extension; http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo_mysql/reference.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/pdo_mysql/reference.xml diff -u phpdoc-fr/reference/pdo_mysql/reference.xml:1.4 phpdoc-fr/reference/pdo_mysql/reference.xml:1.5 --- phpdoc-fr/reference/pdo_mysql/reference.xml:1.4 Tue Dec 13 22:11:05 2005 +++ phpdoc-fr/reference/pdo_mysql/reference.xml Tue Jan 23 19:58:21 2007 @@ -1,6 +1,6 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.8 Maintainer: jsgoupil Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.9 Maintainer: jsgoupil Status: ready --> <!-- Purpose: database.vendors --> <!-- Membership: bundled, external, pecl --> <!-- Reviewed: no --> @@ -15,7 +15,7 @@ <para> PDO_MYSQL est un pilote qui implémente l'<link linkend="ref.pdo">interface de &php; Data Objects (PDO)</link> pour - autoriser l'accès de &php; aux bases de données de MySQL 3.x et 4.x. + autoriser l'accès de &php; aux bases de données de MySQL 3.x, 4.x. et 5.x. </para> <para> PDO_MYSQL prendra avantage des requêtes natives préparées présentes dans