cvs: phpdoc-fr /reference/misc/functions connection-aborted.xml connection-status.xml connection-timeout.xml define.xml defined.xml eval.xml exit.xml
get-browser.xml highlight-file.xml show-source.xml uniqid.xml
| From: | Damien Seguy | Date: | Fri, 07 Feb 2003 18:09:01 +0000 |
| Subject: | cvs: phpdoc-fr /reference/misc/functions connection-aborted.xml connection-status.xml connection-timeout.xml define.xml defined.xml eval.xml exit.xml get-browser.xml highlight-file.xml show-source.xml uniqid.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-238@lists.php.net to get a copy of this message | ||
dams Fri Feb 7 13:09:01 2003 EDT
Modified files:
/phpdoc-fr/reference/misc/functions connection-aborted.xml
connection-status.xml
connection-timeout.xml
define.xml defined.xml eval.xml
exit.xml get-browser.xml
highlight-file.xml
show-source.xml uniqid.xml
Log:
Keeping up
Index: phpdoc-fr/reference/misc/functions/connection-aborted.xml diff -u phpdoc-fr/reference/misc/functions/connection-aborted.xml:1.2 phpdoc-fr/reference/misc/functions/connection-aborted.xml:1.3 --- phpdoc-fr/reference/misc/functions/connection-aborted.xml:1.2 Wed Jan 8 17:50:49 2003 +++ phpdoc-fr/reference/misc/functions/connection-aborted.xml Fri Feb 7 13:09:01 2003 @@ -4,13 +4,13 @@ <refentry id="function.connection-aborted"> <refnamediv> <refname>connection_aborted</refname> - <refpurpose>Indique si le client a abandonné la connexion</refpurpose> + <refpurpose>Indique si l'internaute a abandonné la connexion</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>connection_aborted</methodname> - <methodparam><type>void</type><parameter/></methodparam> + <type>int</type><methodname>connection_aborted</methodname> + <void/> </methodsynopsis> <simpara> <function>connection_aborted</function> retourne &true; Index: phpdoc-fr/reference/misc/functions/connection-status.xml diff -u phpdoc-fr/reference/misc/functions/connection-status.xml:1.2 phpdoc-fr/reference/misc/functions/connection-status.xml:1.3 --- phpdoc-fr/reference/misc/functions/connection-status.xml:1.2 Wed Jan 8 17:50:50 2003 +++ phpdoc-fr/reference/misc/functions/connection-status.xml Fri Feb 7 13:09:01 2003 @@ -8,11 +8,11 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>connection_status</methodname> - <methodparam><type>void</type><parameter/></methodparam> + <methodsynopsis> + <type>int</type><methodname>connection_status</methodname> + <void/> </methodsynopsis> - <simpara> + <simpara> <function>connection_status</function> retourne les bits de statut de la connexion. Reportez-vous à la section <link linkend="features.connection-handling">gestion des connexions</link> Index: phpdoc-fr/reference/misc/functions/connection-timeout.xml diff -u phpdoc-fr/reference/misc/functions/connection-timeout.xml:1.2 phpdoc-fr/reference/misc/functions/connection-timeout.xml:1.3 --- phpdoc-fr/reference/misc/functions/connection-timeout.xml:1.2 Wed Jan 8 17:50:50 2003 +++ phpdoc-fr/reference/misc/functions/connection-timeout.xml Fri Feb 7 13:09:01 2003 @@ -9,13 +9,29 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>bool</type><methodname>connection_timeout</methodname> - <methodparam><type>void</type><parameter/></methodparam> + <type>bool</type><methodname>connection_timeout</methodname> + <void/> </methodsynopsis> <simpara> <function>connection_timeout</function> retourne &true; si le script a expiré. Reportez-vous à la section <link linkend="features.connection-handling">gestion des connexions</link> + pour plus de détails. + </simpara> + <warning> + <title>Deprecated</title> + <simpara> + This function is deprecated, and doesn't even exist anymore + as of 4.0.5. + </simpara> + <!-- so it's quite late to declare it 'deprecated' by now :) + TODO: correct connection handling. Any volunteers? + --> + </warning> + <simpara> + Voyez la section sur la + <link linkend="features.connection-handling">Gestion de la connexion</link> + dans la section <link linkend="features">Caractéristiques</link> pour plus de détails. </simpara> </refsect1> Index: phpdoc-fr/reference/misc/functions/define.xml diff -u phpdoc-fr/reference/misc/functions/define.xml:1.4 phpdoc-fr/reference/misc/functions/define.xml:1.5 --- phpdoc-fr/reference/misc/functions/define.xml:1.4 Wed Jan 8 17:50:50 2003 +++ phpdoc-fr/reference/misc/functions/define.xml Fri Feb 7 13:09:01 2003 @@ -9,38 +9,16 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>define</methodname> - <methodparam><type>string</type><parameter>name</parameter></methodparam> - <methodparam><type>mixed</type><parameter>value</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>case_insensitive</parameter></methodparam> + <type>bool</type><methodname>define</methodname> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + <methodparam><type>mixed</type><parameter>value</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>case_insensitive</parameter></methodparam> </methodsynopsis> <para> - <function>define</function> définit une constante, de la même - façon qu'une variable, sauf que : - <itemizedlist> - <listitem> - <simpara> - Les constantes ne commencent pas par le signe '$' - </simpara> - </listitem> - <listitem> - <simpara> - Les constantes sont accessibles partout, de manière globale. - </simpara> - </listitem> - <listitem> - <simpara> - Les constantes ne peuvent pas être redéfinies, ou - indéfinies, une fois qu'elles ont été définies. - </simpara> - </listitem> - <listitem> - <simpara> - Les constantes ne représentent que des valeurs scalaires : - il n'est pas possible de définir des tableaux ou des objets. - </simpara> - </listitem> - </itemizedlist> + <function>define</function> définit la constante de nom <parameter>name</parameter> + et de valeur<parameter>value</parameter>. Voyez la + <link linkend="language.constants">section sur les constantes</link> + pour plus de détails sur les constantes. </para> <para> Le nom de la constante est donné par le paramètre @@ -62,16 +40,20 @@ <programlisting role="php"> <![CDATA[ <?php - define("CONSTANTE", "Bonjour le monde."); - echo CONSTANTE; - // affiche "Bonjour le monde." -?> -]]> +define ("CONSTANT", "Bonjour à tous."); +echo CONSTANT; // affiche "Bonjour à tous." +echo Constant; // affiche "Constant" et une alerte + +define ("BONJOUR", "Salut toi.",TRUE); +echo BONJOUR; // affiche "Salut toi." +echo Bonjour; // affiche "Salut toi." + +?>]]> </programlisting> </example> </para> <para> - <function>define</function> retoune &true; en cas de succès et &false; sinon. + &return.success; </para> <para> Voir aussi Index: phpdoc-fr/reference/misc/functions/defined.xml diff -u phpdoc-fr/reference/misc/functions/defined.xml:1.2 phpdoc-fr/reference/misc/functions/defined.xml:1.3 --- phpdoc-fr/reference/misc/functions/defined.xml:1.2 Thu Feb 6 18:30:45 2003 +++ phpdoc-fr/reference/misc/functions/defined.xml Fri Feb 7 13:09:01 2003 @@ -4,9 +4,7 @@ <refentry id="function.defined"> <refnamediv> <refname>defined</refname> - <refpurpose> - Vérifie qu'une constante existe. - </refpurpose> + <refpurpose>Vérifie l'existence d'une fonction</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -18,10 +16,26 @@ <function>defined</function> retourne &true; si la constante nommée <parameter>name</parameter> a été définie, et &false; sinon. + <example> + <title>Vérifier la présence de constantes avec <function>defined</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +if (defined("CONSTANT")){ +// Notez que le nom de la constante est entre guillemets + echo CONSTANT; + } +?> +]]> + </programlisting> + </example> </para> <para> Voir aussi - <function>define</function> et la section sur les + <function>define</function>, + <function>constant</function>, + <function>get_defined_constants</function> et + la section sur les <link linkend="language.constants">constantes</link>. </para> </refsect1> Index: phpdoc-fr/reference/misc/functions/eval.xml diff -u phpdoc-fr/reference/misc/functions/eval.xml:1.4 phpdoc-fr/reference/misc/functions/eval.xml:1.5 --- phpdoc-fr/reference/misc/functions/eval.xml:1.4 Thu Feb 6 18:30:45 2003 +++ phpdoc-fr/reference/misc/functions/eval.xml Fri Feb 7 13:09:01 2003 @@ -4,13 +4,13 @@ <refentry id="function.eval"> <refnamediv> <refname>eval</refname> - <refpurpose>Evalue une chaîne comme un script PHP</refpurpose> + <refpurpose>Exécute une chaîne comme un script &php;</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>void</type><methodname>eval</methodname> - <methodparam><type>string</type><parameter>code_str</parameter></methodparam> + <type>mixed</type><methodname>eval</methodname> + <methodparam><type>string</type><parameter>code_str</parameter></methodparam> </methodsynopsis> <simpara> <function>eval</function> évalue la chaîne @@ -56,10 +56,12 @@ </para> <para> L'exemple ci-dessus devrait afficher : - <computeroutput> + <screen> +<![CDATA[ Ceci est une $string avec mon $name dedans. Ceci est une tasse avec mon café dedans. - </computeroutput> +]]> + </screen> </para> &tip.ob-capture; </refsect1> Index: phpdoc-fr/reference/misc/functions/exit.xml diff -u phpdoc-fr/reference/misc/functions/exit.xml:1.3 phpdoc-fr/reference/misc/functions/exit.xml:1.4 --- phpdoc-fr/reference/misc/functions/exit.xml:1.3 Wed Jan 8 17:50:50 2003 +++ phpdoc-fr/reference/misc/functions/exit.xml Fri Feb 7 13:09:01 2003 @@ -9,13 +9,13 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>void</type><methodname>exit</methodname> - <methodparam><type>string</type><parameter>status</parameter></methodparam> + <type>void</type><methodname>exit</methodname> + <methodparam choice="opt"><type>string</type><parameter>status</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>exit</methodname> + <methodparam><type>int</type><parameter>status</parameter></methodparam> </methodsynopsis> - <methodsynopsis> - <type>void</type><methodname>exit</methodname> - <methodparam><type>int</type><parameter>status</parameter></methodparam> - </methodsynopsis> <note> <simpara> <function>exit</function> n'est pas une véritable fonction, Index: phpdoc-fr/reference/misc/functions/get-browser.xml diff -u phpdoc-fr/reference/misc/functions/get-browser.xml:1.3 phpdoc-fr/reference/misc/functions/get-browser.xml:1.4 --- phpdoc-fr/reference/misc/functions/get-browser.xml:1.3 Wed Jan 8 17:50:50 2003 +++ phpdoc-fr/reference/misc/functions/get-browser.xml Fri Feb 7 13:09:01 2003 @@ -61,44 +61,59 @@ <simpara> L'affichage devrait ressembler à ceci : </simpara> - <literallayout> - <computeroutput> -Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586)<hr> -<B>browser_name_pattern:</B> Mozilla/4\.5.*<br> -<B>parent:</B> Netscape 4.0<br> -<B>platform:</B> Unknown<br> -<B>majorver:</B> 4<br> -<B>minorver:</B> 5<br> -<B>browser:</B> Netscape<br> -<B>version:</B> 4<br> -<B>frames:</B> 1<br> -<B>tables:</B> 1<br> -<B>cookies:</B> 1<br> -<B>backgroundsounds:</B> <br> -<B>vbscript:</B> <br> -<B>javascript:</B> 1<br> -<B>javaapplets:</B> 1<br> -<B>activexcontrols:</B> <br> -<B>beta:</B> <br> -<B>crawler:</B> <br> -<B>authenticodeupdate:</B> <br> -<B>msn:</B> <br> - </computeroutput> - </literallayout> + <programlisting> +<![CDATA[ +Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586)<hr /> +<b>browser_name_pattern:</b> Mozilla/4\.5.*<br /> +<b>parent:</b> Netscape 4.0<br /> +<b>platform:</b> Linux<br /> +<b>majorver:</b> 4<br /> +<b>minorver:</b> 5<br /> +<b>browser:</b> Netscape<br /> +<b>version:</b> 4<br /> +<b>frames:</b> 1<br /> +<b>tables:</b> 1<br /> +<b>cookies:</b> 1<br /> +<b>backgroundsounds:</b> <br /> +<b>vbscript:</b> <br /> +<b>javascript:</b> 1<br /> +<b>javaapplets:</b> 1<br /> +<b>activexcontrols:</b> <br /> +<b>beta:</b> <br /> +<b>crawler:</b> <br /> +<b>authenticodeupdate:</b> <br /> +<b>msn:</b> <br /> +]]> + </programlisting> <simpara> Pour fonctionner, votre configuration <link linkend="ini.browscap">browscap</link> - doit mener au fichier <filename>browscap.ini</filename>. - </simpara> - <simpara> - Pour plus d'informations, (y compris pour les endroits où - charger le fichier - <filename>browscap.ini</filename>), suivez la FAQ PHP à - <ulink url="&url.php.faq;">http://www.php.net/FAQ.html</ulink>. + dans le &php.ini; doit pointer sur le fichier + <filename>browscap.ini</filename> de votre système. + <filename>browscap.ini</filename> n'est pas fourni avec &php; mais + vous pouvez trouver une version à jour + <ulink url="&url.browscap.download;">sur ce site</ulink>. Par + défaut, la directive <link linkend="ini.browscap">browscap</link> + est inactivée. </simpara> <note> <simpara> - Browscap a été ajouté en PHP 3.0b2. + La valeur <literal>cookies</literal> indique simplement que le + navigateur est capable d'accepter les cookies, et n'indique pas + si l'utilisateur les a activé sur son navigateur. Le seul moyen + de tester l'activation des cookies est d'en poser un avec + la fonction <function>setcookie</function>, de recharger la page + et de vérifier que le cookie existe toujours. + </simpara> + </note> + <note> + <simpara> + Sur les versions de &php; plus ancienne que la 4.0.6, vous devez + passer le nom du naviageteur comme troisième paramètre optionnel + <parameter>user_agent</parameter>, et si la directive + <link linkend="ini.register-globals">register_globals</link> vaut + <literal>off</literal>. Dans ce cas, vous devrez utiliser + <varname>$HTTP_SERVER_VARS['HTTP_USER_AGENT']</varname>. </simpara> </note> </refsect1> Index: phpdoc-fr/reference/misc/functions/highlight-file.xml diff -u phpdoc-fr/reference/misc/functions/highlight-file.xml:1.2 phpdoc-fr/reference/misc/functions/highlight-file.xml:1.3 --- phpdoc-fr/reference/misc/functions/highlight-file.xml:1.2 Sun Sep 8 10:52:00 2002 +++ phpdoc-fr/reference/misc/functions/highlight-file.xml Fri Feb 7 13:09:01 2003 @@ -9,7 +9,7 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>highlight_file</methodname> + <type>bool</type><methodname>highlight_file</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> <simpara> Index: phpdoc-fr/reference/misc/functions/show-source.xml diff -u phpdoc-fr/reference/misc/functions/show-source.xml:1.1 phpdoc-fr/reference/misc/functions/show-source.xml:1.2 --- phpdoc-fr/reference/misc/functions/show-source.xml:1.1 Sun Apr 14 20:33:28 2002 +++ phpdoc-fr/reference/misc/functions/show-source.xml Fri Feb 7 13:09:01 2003 @@ -4,24 +4,18 @@ <refentry id="function.show-source"> <refnamediv> <refname>show_source</refname> - <refpurpose>Colorisation de la syntaxe d'un fichier</refpurpose> + <refpurpose>Génère la syntaxe colorisée d'un fichier &php;</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>void</type><methodname>show_source</methodname> + <type>bool</type><methodname>show_source</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>return</parameter></methodparam> </methodsynopsis> - <simpara> - <function>show_source</function> affiche la syntaxe colorisée du - fichier <parameter>filename</parameter>, en utilisant les couleurs - définies dans le moteur interne de PHP. - </simpara> - <note> <simpara> - <function>show_source</function> est un alias de <function>highlight_file</function> + <function>show_source</function> est un alias de <function>highlight_file</function>. </simpara> - </note> <simpara> Voir aussi <function>highlight_string</function> et Index: phpdoc-fr/reference/misc/functions/uniqid.xml diff -u phpdoc-fr/reference/misc/functions/uniqid.xml:1.4 phpdoc-fr/reference/misc/functions/uniqid.xml:1.5 --- phpdoc-fr/reference/misc/functions/uniqid.xml:1.4 Thu Feb 6 18:30:45 2003 +++ phpdoc-fr/reference/misc/functions/uniqid.xml Fri Feb 7 13:09:01 2003 @@ -9,9 +9,9 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>uniqid</methodname> - <methodparam><type>string</type><parameter>prefix</parameter></methodparam> - <methodparam choice="opt"><type>boolean</type><parameter>lcg</parameter></methodparam> + <type>string</type><methodname>uniqid</methodname> + <methodparam><type>string</type><parameter>prefix</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>lcg</parameter></methodparam> </methodsynopsis> <simpara> <function>uniqid</function> retourne un identifiant
Index: phpdoc-fr/reference/misc/functions/connection-aborted.xml diff -u phpdoc-fr/reference/misc/functions/connection-aborted.xml:1.2 phpdoc-fr/reference/misc/functions/connection-aborted.xml:1.3 --- phpdoc-fr/reference/misc/functions/connection-aborted.xml:1.2 Wed Jan 8 17:50:49 2003 +++ phpdoc-fr/reference/misc/functions/connection-aborted.xml Fri Feb 7 13:09:01 2003 @@ -4,13 +4,13 @@ <refentry id="function.connection-aborted"> <refnamediv> <refname>connection_aborted</refname> - <refpurpose>Indique si le client a abandonné la connexion</refpurpose> + <refpurpose>Indique si l'internaute a abandonné la connexion</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>connection_aborted</methodname> - <methodparam><type>void</type><parameter/></methodparam> + <type>int</type><methodname>connection_aborted</methodname> + <void/> </methodsynopsis> <simpara> <function>connection_aborted</function> retourne &true; Index: phpdoc-fr/reference/misc/functions/connection-status.xml diff -u phpdoc-fr/reference/misc/functions/connection-status.xml:1.2 phpdoc-fr/reference/misc/functions/connection-status.xml:1.3 --- phpdoc-fr/reference/misc/functions/connection-status.xml:1.2 Wed Jan 8 17:50:50 2003 +++ phpdoc-fr/reference/misc/functions/connection-status.xml Fri Feb 7 13:09:01 2003 @@ -8,11 +8,11 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>connection_status</methodname> - <methodparam><type>void</type><parameter/></methodparam> + <methodsynopsis> + <type>int</type><methodname>connection_status</methodname> + <void/> </methodsynopsis> - <simpara> + <simpara> <function>connection_status</function> retourne les bits de statut de la connexion. Reportez-vous à la section <link linkend="features.connection-handling">gestion des connexions</link> Index: phpdoc-fr/reference/misc/functions/connection-timeout.xml diff -u phpdoc-fr/reference/misc/functions/connection-timeout.xml:1.2 phpdoc-fr/reference/misc/functions/connection-timeout.xml:1.3 --- phpdoc-fr/reference/misc/functions/connection-timeout.xml:1.2 Wed Jan 8 17:50:50 2003 +++ phpdoc-fr/reference/misc/functions/connection-timeout.xml Fri Feb 7 13:09:01 2003 @@ -9,13 +9,29 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>bool</type><methodname>connection_timeout</methodname> - <methodparam><type>void</type><parameter/></methodparam> + <type>bool</type><methodname>connection_timeout</methodname> + <void/> </methodsynopsis> <simpara> <function>connection_timeout</function> retourne &true; si le script a expiré. Reportez-vous à la section <link linkend="features.connection-handling">gestion des connexions</link> + pour plus de détails. + </simpara> + <warning> + <title>Deprecated</title> + <simpara> + This function is deprecated, and doesn't even exist anymore + as of 4.0.5. + </simpara> + <!-- so it's quite late to declare it 'deprecated' by now :) + TODO: correct connection handling. Any volunteers? + --> + </warning> + <simpara> + Voyez la section sur la + <link linkend="features.connection-handling">Gestion de la connexion</link> + dans la section <link linkend="features">Caractéristiques</link> pour plus de détails. </simpara> </refsect1> Index: phpdoc-fr/reference/misc/functions/define.xml diff -u phpdoc-fr/reference/misc/functions/define.xml:1.4 phpdoc-fr/reference/misc/functions/define.xml:1.5 --- phpdoc-fr/reference/misc/functions/define.xml:1.4 Wed Jan 8 17:50:50 2003 +++ phpdoc-fr/reference/misc/functions/define.xml Fri Feb 7 13:09:01 2003 @@ -9,38 +9,16 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>define</methodname> - <methodparam><type>string</type><parameter>name</parameter></methodparam> - <methodparam><type>mixed</type><parameter>value</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>case_insensitive</parameter></methodparam> + <type>bool</type><methodname>define</methodname> + <methodparam><type>string</type><parameter>name</parameter></methodparam> + <methodparam><type>mixed</type><parameter>value</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>case_insensitive</parameter></methodparam> </methodsynopsis> <para> - <function>define</function> définit une constante, de la même - façon qu'une variable, sauf que : - <itemizedlist> - <listitem> - <simpara> - Les constantes ne commencent pas par le signe '$' - </simpara> - </listitem> - <listitem> - <simpara> - Les constantes sont accessibles partout, de manière globale. - </simpara> - </listitem> - <listitem> - <simpara> - Les constantes ne peuvent pas être redéfinies, ou - indéfinies, une fois qu'elles ont été définies. - </simpara> - </listitem> - <listitem> - <simpara> - Les constantes ne représentent que des valeurs scalaires : - il n'est pas possible de définir des tableaux ou des objets. - </simpara> - </listitem> - </itemizedlist> + <function>define</function> définit la constante de nom <parameter>name</parameter> + et de valeur<parameter>value</parameter>. Voyez la + <link linkend="language.constants">section sur les constantes</link> + pour plus de détails sur les constantes. </para> <para> Le nom de la constante est donné par le paramètre @@ -62,16 +40,20 @@ <programlisting role="php"> <![CDATA[ <?php - define("CONSTANTE", "Bonjour le monde."); - echo CONSTANTE; - // affiche "Bonjour le monde." -?> -]]> +define ("CONSTANT", "Bonjour à tous."); +echo CONSTANT; // affiche "Bonjour à tous." +echo Constant; // affiche "Constant" et une alerte + +define ("BONJOUR", "Salut toi.",TRUE); +echo BONJOUR; // affiche "Salut toi." +echo Bonjour; // affiche "Salut toi." + +?>]]> </programlisting> </example> </para> <para> - <function>define</function> retoune &true; en cas de succès et &false; sinon. + &return.success; </para> <para> Voir aussi Index: phpdoc-fr/reference/misc/functions/defined.xml diff -u phpdoc-fr/reference/misc/functions/defined.xml:1.2 phpdoc-fr/reference/misc/functions/defined.xml:1.3 --- phpdoc-fr/reference/misc/functions/defined.xml:1.2 Thu Feb 6 18:30:45 2003 +++ phpdoc-fr/reference/misc/functions/defined.xml Fri Feb 7 13:09:01 2003 @@ -4,9 +4,7 @@ <refentry id="function.defined"> <refnamediv> <refname>defined</refname> - <refpurpose> - Vérifie qu'une constante existe. - </refpurpose> + <refpurpose>Vérifie l'existence d'une fonction</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -18,10 +16,26 @@ <function>defined</function> retourne &true; si la constante nommée <parameter>name</parameter> a été définie, et &false; sinon. + <example> + <title>Vérifier la présence de constantes avec <function>defined</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +if (defined("CONSTANT")){ +// Notez que le nom de la constante est entre guillemets + echo CONSTANT; + } +?> +]]> + </programlisting> + </example> </para> <para> Voir aussi - <function>define</function> et la section sur les + <function>define</function>, + <function>constant</function>, + <function>get_defined_constants</function> et + la section sur les <link linkend="language.constants">constantes</link>. </para> </refsect1> Index: phpdoc-fr/reference/misc/functions/eval.xml diff -u phpdoc-fr/reference/misc/functions/eval.xml:1.4 phpdoc-fr/reference/misc/functions/eval.xml:1.5 --- phpdoc-fr/reference/misc/functions/eval.xml:1.4 Thu Feb 6 18:30:45 2003 +++ phpdoc-fr/reference/misc/functions/eval.xml Fri Feb 7 13:09:01 2003 @@ -4,13 +4,13 @@ <refentry id="function.eval"> <refnamediv> <refname>eval</refname> - <refpurpose>Evalue une chaîne comme un script PHP</refpurpose> + <refpurpose>Exécute une chaîne comme un script &php;</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>void</type><methodname>eval</methodname> - <methodparam><type>string</type><parameter>code_str</parameter></methodparam> + <type>mixed</type><methodname>eval</methodname> + <methodparam><type>string</type><parameter>code_str</parameter></methodparam> </methodsynopsis> <simpara> <function>eval</function> évalue la chaîne @@ -56,10 +56,12 @@ </para> <para> L'exemple ci-dessus devrait afficher : - <computeroutput> + <screen> +<![CDATA[ Ceci est une $string avec mon $name dedans. Ceci est une tasse avec mon café dedans. - </computeroutput> +]]> + </screen> </para> &tip.ob-capture; </refsect1> Index: phpdoc-fr/reference/misc/functions/exit.xml diff -u phpdoc-fr/reference/misc/functions/exit.xml:1.3 phpdoc-fr/reference/misc/functions/exit.xml:1.4 --- phpdoc-fr/reference/misc/functions/exit.xml:1.3 Wed Jan 8 17:50:50 2003 +++ phpdoc-fr/reference/misc/functions/exit.xml Fri Feb 7 13:09:01 2003 @@ -9,13 +9,13 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>void</type><methodname>exit</methodname> - <methodparam><type>string</type><parameter>status</parameter></methodparam> + <type>void</type><methodname>exit</methodname> + <methodparam choice="opt"><type>string</type><parameter>status</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>exit</methodname> + <methodparam><type>int</type><parameter>status</parameter></methodparam> </methodsynopsis> - <methodsynopsis> - <type>void</type><methodname>exit</methodname> - <methodparam><type>int</type><parameter>status</parameter></methodparam> - </methodsynopsis> <note> <simpara> <function>exit</function> n'est pas une véritable fonction, Index: phpdoc-fr/reference/misc/functions/get-browser.xml diff -u phpdoc-fr/reference/misc/functions/get-browser.xml:1.3 phpdoc-fr/reference/misc/functions/get-browser.xml:1.4 --- phpdoc-fr/reference/misc/functions/get-browser.xml:1.3 Wed Jan 8 17:50:50 2003 +++ phpdoc-fr/reference/misc/functions/get-browser.xml Fri Feb 7 13:09:01 2003 @@ -61,44 +61,59 @@ <simpara> L'affichage devrait ressembler à ceci : </simpara> - <literallayout> - <computeroutput> -Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586)<hr> -<B>browser_name_pattern:</B> Mozilla/4\.5.*<br> -<B>parent:</B> Netscape 4.0<br> -<B>platform:</B> Unknown<br> -<B>majorver:</B> 4<br> -<B>minorver:</B> 5<br> -<B>browser:</B> Netscape<br> -<B>version:</B> 4<br> -<B>frames:</B> 1<br> -<B>tables:</B> 1<br> -<B>cookies:</B> 1<br> -<B>backgroundsounds:</B> <br> -<B>vbscript:</B> <br> -<B>javascript:</B> 1<br> -<B>javaapplets:</B> 1<br> -<B>activexcontrols:</B> <br> -<B>beta:</B> <br> -<B>crawler:</B> <br> -<B>authenticodeupdate:</B> <br> -<B>msn:</B> <br> - </computeroutput> - </literallayout> + <programlisting> +<![CDATA[ +Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586)<hr /> +<b>browser_name_pattern:</b> Mozilla/4\.5.*<br /> +<b>parent:</b> Netscape 4.0<br /> +<b>platform:</b> Linux<br /> +<b>majorver:</b> 4<br /> +<b>minorver:</b> 5<br /> +<b>browser:</b> Netscape<br /> +<b>version:</b> 4<br /> +<b>frames:</b> 1<br /> +<b>tables:</b> 1<br /> +<b>cookies:</b> 1<br /> +<b>backgroundsounds:</b> <br /> +<b>vbscript:</b> <br /> +<b>javascript:</b> 1<br /> +<b>javaapplets:</b> 1<br /> +<b>activexcontrols:</b> <br /> +<b>beta:</b> <br /> +<b>crawler:</b> <br /> +<b>authenticodeupdate:</b> <br /> +<b>msn:</b> <br /> +]]> + </programlisting> <simpara> Pour fonctionner, votre configuration <link linkend="ini.browscap">browscap</link> - doit mener au fichier <filename>browscap.ini</filename>. - </simpara> - <simpara> - Pour plus d'informations, (y compris pour les endroits où - charger le fichier - <filename>browscap.ini</filename>), suivez la FAQ PHP à - <ulink url="&url.php.faq;">http://www.php.net/FAQ.html</ulink>. + dans le &php.ini; doit pointer sur le fichier + <filename>browscap.ini</filename> de votre système. + <filename>browscap.ini</filename> n'est pas fourni avec &php; mais + vous pouvez trouver une version à jour + <ulink url="&url.browscap.download;">sur ce site</ulink>. Par + défaut, la directive <link linkend="ini.browscap">browscap</link> + est inactivée. </simpara> <note> <simpara> - Browscap a été ajouté en PHP 3.0b2. + La valeur <literal>cookies</literal> indique simplement que le + navigateur est capable d'accepter les cookies, et n'indique pas + si l'utilisateur les a activé sur son navigateur. Le seul moyen + de tester l'activation des cookies est d'en poser un avec + la fonction <function>setcookie</function>, de recharger la page + et de vérifier que le cookie existe toujours. + </simpara> + </note> + <note> + <simpara> + Sur les versions de &php; plus ancienne que la 4.0.6, vous devez + passer le nom du naviageteur comme troisième paramètre optionnel + <parameter>user_agent</parameter>, et si la directive + <link linkend="ini.register-globals">register_globals</link> vaut + <literal>off</literal>. Dans ce cas, vous devrez utiliser + <varname>$HTTP_SERVER_VARS['HTTP_USER_AGENT']</varname>. </simpara> </note> </refsect1> Index: phpdoc-fr/reference/misc/functions/highlight-file.xml diff -u phpdoc-fr/reference/misc/functions/highlight-file.xml:1.2 phpdoc-fr/reference/misc/functions/highlight-file.xml:1.3 --- phpdoc-fr/reference/misc/functions/highlight-file.xml:1.2 Sun Sep 8 10:52:00 2002 +++ phpdoc-fr/reference/misc/functions/highlight-file.xml Fri Feb 7 13:09:01 2003 @@ -9,7 +9,7 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>highlight_file</methodname> + <type>bool</type><methodname>highlight_file</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> <simpara> Index: phpdoc-fr/reference/misc/functions/show-source.xml diff -u phpdoc-fr/reference/misc/functions/show-source.xml:1.1 phpdoc-fr/reference/misc/functions/show-source.xml:1.2 --- phpdoc-fr/reference/misc/functions/show-source.xml:1.1 Sun Apr 14 20:33:28 2002 +++ phpdoc-fr/reference/misc/functions/show-source.xml Fri Feb 7 13:09:01 2003 @@ -4,24 +4,18 @@ <refentry id="function.show-source"> <refnamediv> <refname>show_source</refname> - <refpurpose>Colorisation de la syntaxe d'un fichier</refpurpose> + <refpurpose>Génère la syntaxe colorisée d'un fichier &php;</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>void</type><methodname>show_source</methodname> + <type>bool</type><methodname>show_source</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>return</parameter></methodparam> </methodsynopsis> - <simpara> - <function>show_source</function> affiche la syntaxe colorisée du - fichier <parameter>filename</parameter>, en utilisant les couleurs - définies dans le moteur interne de PHP. - </simpara> - <note> <simpara> - <function>show_source</function> est un alias de <function>highlight_file</function> + <function>show_source</function> est un alias de <function>highlight_file</function>. </simpara> - </note> <simpara> Voir aussi <function>highlight_string</function> et Index: phpdoc-fr/reference/misc/functions/uniqid.xml diff -u phpdoc-fr/reference/misc/functions/uniqid.xml:1.4 phpdoc-fr/reference/misc/functions/uniqid.xml:1.5 --- phpdoc-fr/reference/misc/functions/uniqid.xml:1.4 Thu Feb 6 18:30:45 2003 +++ phpdoc-fr/reference/misc/functions/uniqid.xml Fri Feb 7 13:09:01 2003 @@ -9,9 +9,9 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>int</type><methodname>uniqid</methodname> - <methodparam><type>string</type><parameter>prefix</parameter></methodparam> - <methodparam choice="opt"><type>boolean</type><parameter>lcg</parameter></methodparam> + <type>string</type><methodname>uniqid</methodname> + <methodparam><type>string</type><parameter>prefix</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>lcg</parameter></methodparam> </methodsynopsis> <simpara> <function>uniqid</function> retourne un identifiant