cvs: phpdoc-fr / language-snippets.ent /language basic-syntax.xml constants.xml control-structures.xml expressions.xml functions.xml oop.xml
operators.xml references.xml types.xml variables.xml
| From: | Damien Seguy | Date: | Mon, 03 Feb 2003 12:27:12 +0000 |
| Subject: | cvs: phpdoc-fr / language-snippets.ent /language basic-syntax.xml constants.xml control-structures.xml expressions.xml functions.xml oop.xml operators.xml references.xml types.xml variables.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-192@lists.php.net to get a copy of this message | ||
dams Mon Feb 3 07:27:12 2003 EDT
Modified files:
/phpdoc-fr language-snippets.ent
/phpdoc-fr/language basic-syntax.xml constants.xml
control-structures.xml expressions.xml
functions.xml oop.xml operators.xml
references.xml types.xml variables.xml
Log:
keeping up for stability
Index: phpdoc-fr/language-snippets.ent diff -u phpdoc-fr/language-snippets.ent:1.32 phpdoc-fr/language-snippets.ent:1.33 --- phpdoc-fr/language-snippets.ent:1.32 Sat Jan 18 18:38:05 2003 +++ phpdoc-fr/language-snippets.ent Mon Feb 3 07:27:11 2003 @@ -1,13 +1,10 @@ -<!-- PHPDoc snippets $Id: language-snippets.ent,v 1.32 2003/01/18 23:38:05 dams Exp $ --> +<!-- PHPDoc snippets $Id: language-snippets.ent,v 1.33 2003/02/03 12:27:11 dams Exp $ --> <!ENTITY warn.experimental '<warning><simpara>Ce module est <emphasis>EXPERIMENTAL</emphasis>. Cela signifie que le comportement de ces fonctions, leurs noms et concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utiliser ce module à vos risques et périls.</simpara></warning>'> <!ENTITY warn.experimental.func '<warning><simpara>Cette fonction est <emphasis>EXPERIMENTALE</emphasis>. Cela signifie que le comportement de cette fonction, son nom et concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utilisez cette fonction à vos risques et périls.</simpara></warning>'> <!ENTITY warn.undocumented.func '<warning><simpara>Cette fonction n'est pas documentée, et seule la liste des arguments est disponible.</simpara></warning>'> -<!ENTITY warn.no-win32-fopen-wrapper '<warning><para>La version Windows -de <literal>PHP</literal> ne supporte pas l'accès aux fichiers distants -avec cette fonction, même si <link linkend="ini.allow-url-fopen">allow_url_fopen</link> est activé. -</para></warning>'> +<!ENTITY warn.no-win32-fopen-wrapper '<warning><para>La version Windows de <literal>PHP</literal> ne supporte pas l'accès aux fichiers distants avec cette fonction, même si <link linkend="ini.allow-url-fopen">allow_url_fopen</link> est activé. </para></warning>'> <!ENTITY tip.ob-capture '<tip><simpara>Comme pour toutes les fonctions qui affichent directement des résultats au navigateur, vous pouvez utiliser <link linkend="ref.outcontrol">les fonctions de gestion des sorties</link> pour capturer le contenu de cette fonction et le sauver, par exemple, dans une chaîne.</simpara></tip>'> @@ -16,6 +13,9 @@ <!ENTITY return.success 'Cette fonction retourne &true; en cas de succès, &false; en cas d'échec.'> <!ENTITY return.falseproblem '<warning><simpara>Cette fonction peut retourner &false;, mais elle peut aussi retourner une valeur équivalent à &false;, utilisable dans une condition if simple. Utilisez l'<link linkend="language.operators.comparison">opérateur ===</link> pour tester la valeur exacte de cette fonction.</simpara></warning>'> + +<!ENTITY warn.imaprecodeyaz '<warning><simpara>L'extension <link linkend="ref.imap">IMAP</link> ne peut être utilisée simultanément avec l'extension <link linkend="ref.recode">recode</link> ou l'extension <link linkend="ref.yaz">YAZ</link>. Ceci est dû au fait que ces deux librairies utilisent un symbole interne commun.</simpara></warning>'> + <!-- Notes variees --> <!ENTITY note.not-bin-safe '<warning><simpara>Cette fonction n'est pas capable de gérer les chaînes binaires!</simpara></warning>'> <!ENTITY note.bin-safe '<note><simpara>Cette fonction gère les chaînes binaires</simpara></note>'> Index: phpdoc-fr/language/basic-syntax.xml diff -u phpdoc-fr/language/basic-syntax.xml:1.11 phpdoc-fr/language/basic-syntax.xml:1.12 --- phpdoc-fr/language/basic-syntax.xml:1.11 Wed Dec 12 15:50:02 2001 +++ phpdoc-fr/language/basic-syntax.xml Mon Feb 3 07:27:11 2003 @@ -1,91 +1,127 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> +<!-- $Revision: 1.12 $ --> <chapter id="language.basic-syntax"> <title>La syntaxe de base</title> <sect1 id="language.basic-syntax.phpmode"> - <title>Le passage du HTML au PHP</title> + <title>Passer du HTML au PHP</title> <para> Lorsque PHP commence à traiter un fichier, il ne fait qu'afficher - le texte HTML qu'il rencontre. Si vous renommez un fichier .html - en .php, il s'affichera exactement comme avant. + le texte qu'il rencontre, jusqu'à ce qu'il rencontre une balise spéciale + qui lui indiquera qu'il peut interpréter le code qui suit. L'analyseur + PHP va alors exécuter ce code, jusqu'à ce qu'il rencontre une balise + de fin de code PHP. A ce moment là, il retourne en mode texte, et + il affiche simplement le contenu. C'est ce mécanisme qui vous permet + d'inclure du code PHP dans des pages HTML : tout ce qui est placé hors + des balises PHP est affiché sans modification, tandis que le contenu + est exécuté. </para> <para> - Si vous voulez insérer des commandes PHP dans votre fichier, vous - devez indiquer à PHP le début d'une telle séquence, - en passant en mode PHP. Il y a quatre moyens pour passer du mode HTML au - mode PHP : + Il y a quatre jeux de alises qui servent à délimiter des blocs + de code PHP. Seules deux d'entre elles sont toujours actives : + c'est <?php. . .?> et <script + language="php">. . .</script>). Tandis que les autres peuvent + être activées est désactivées depuis le fichier de configuration + &php.ini;. Les balises courtes et les balises ASP peuvent être pratiques, + mais elles ne sont pas aussi portables que les versions longues. De plus, + si vous envisagez d'inclure du PHP dans des fichiers + XML ou XHTML, vous devrez utiliser la forme <?php. . .?> pour vous conformer au XML. </para> <para> <example> <title>Le passage du HTML au PHP </title> <programlisting role="php"> -1. <? echo ("Ceci est un exemple d'affichage à l'écran en PHP, sous forme d'expression SGML.\n"); ?> - <?= expression ?> Raccourci de "<? echo expression ?>" -2. <?php echo("Si vous voulez afficher du XML ou du XHTML, faites comme ceci.\n"); ?> -3. <script language="php"> +<![CDATA[ +<?php +1. <?php echo("Si vous voulez afficher du XML ou du XHTML, faites comme ceci.\n"); ?> + +2. <? echo ("Ceci est un exemple d'affichage à l'écran en PHP, sous forme d'expression SGML.\n"); ?> + <?= expression ?> Raccourci de "<? echo expression ?>" + +3. <script language="php"> echo ("Certains éditeurs HTML (comme FrontPage) n'acceptent pas les expressions telles que celle-ci."); - </script> -4. <% echo ("Vous pouvez aussi utiliser le style ASP comme délimiteur."); %> - <%= $variable; # ceci est un raccourci pour "<%%echo .." %> + </script> + +4. <% echo ("Vous pouvez aussi utiliser le style ASP comme délimiteur."); %> + <%= $variable; # ceci est un raccourci pour "<%%echo .." %> +?> +]]> </programlisting> </example> </para> <para> - La deuxième méthode est généralement utilisée, + La première méthode est généralement utilisée, car elle permet une implémentation aisée de PHP avec la prochaine génération de XHTML. </para> <para> - La première possibilité n'est valable que si vous - l'avez activée. Soit en faisant appel à la fonction - short_tags() (NdT : semble avoir disparu), soit en utilisant l'option + La deuxième forme n'est valable que si vous l'avez activée. + Soit en faisant appel à la fonction + short_tags() (Uniquement en PHP 3), soit en utilisant l'option d'exécution <link linkend="ini.short-open-tag">short_open_tag</link> - dans le fichier de configuration, soit en utilisant l'option de - compilation <link linkend="install.configure.disable-short-tags">--enable-short-tags</link>. + dans le fichier de configuration &php.ini;, soit encore en utilisant + l'option de compilation + <link linkend="install.configure.disable-short-tags">--enable-short-tags</link>. + Même si les balises courtes sont activées dans le fichier de configuration + php.ini-dist, leur utilisation est déconseillée. </para> <para> - La quatrième possibilité est seulement disponible - si vous l'avez activée en utilisant soit l'option - d'exécution <link linkend="ini.asp-tags">asp_tags</link>, - soit en utilisant l'option de compilation --enable-asp-tags. + La quatrième forme est seulement disponible + si vous l'avez activée en utilisant l'option + d'exécution <link linkend="ini.asp-tags">asp_tags</link>. <note> <para> - Le support de la quatrième possibilité, - ASP-style, a été ajouté dans la - version 3.0.4. + Le support des balises ASP, a été ajouté en + PHP 3.0.4. </para> </note> </para> + <note> + <para> + L'utilisation des balises courtes doit être évitées lors + du développement d'application et de librairies destinées à être + distribuées ou déployées sur des serveurs qui sont hors de votre + contrôle, car ces balises ne seront pas forcément supportées + par le serveur de destination. Pour rendre vos scripts portables + et distribuables, évitez les balises courtes. + </para> + </note> <para> - La marque de fermeture d'un bloc (?>) comprend la nouvelle - ligne suivante, s'il y en a une. + La marque de fermeture d'un bloc (?>) comprend le caractère de nouvelle + ligne qui le suit immédiatement, s'il y en a un. De plus, la balise fermante + implique un point-virgule. Vous n'êtes pas obligés de mettre le point-virgule + à la fin d'un bloc de PHP. </para> <para> <!-- TODO: find a better place for this para --> PHP vous permet d'utiliser des structures telles que : <example> <title>Méthode avancée</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if ( expression-booléenne ) { -?> - <strong>Ceci est vrai.</strong> -<?php +?> + <strong>Ceci est vrai.</strong> +<?php } else { -?> -<strong>Ceci est faux.</strong> -<?php +?> +<strong>Ceci est faux.</strong> +<?php } -?> +?> +]]> </programlisting> </example> - Cela fonctionne comme on peut s'y attendre, car PHP traite le texte - entre ?> et <?php comme une fonction <function>echo</function>, - sans remplacer les variables éventuelles par leur valeur. + Cela fonctionne comme on peut s'y attendre, car PHP affiche le texte + entre les balises ?> et <?php sans modification. L'exemple ci-dessus + est très simple, mais c'est un bon système à garder en tête pour + afficher de grande quantité de texte : c'est même plus efficace que + d'utiliser les fonctions <function>echo</function> ou + <function>print</function>. </para> </sect1> <sect1 id="language.basic-syntax.instruction-separation"> - <title>Le séparateur d'instruction</title> + <title>Le séparateur d'instructions</title> <simpara> Les instructions sont séparées par un point virgule à chaque fin d'instruction, comme en langage C ou en Perl. @@ -94,60 +130,68 @@ La balise de fin (?>) implique la fin d'un instruction, et donc ajoute implicitement un point virgule. Les deux exemples suivants sont équivalents. - <informalexample> + <example> + <title>Le séparateur d'instructions</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo "Ceci est un test"; -?> -<?php echo "Ceci est un test" ?> - </programlisting> - </informalexample> +?> +<?php echo "Ceci est un test" ?> +]]> + </programlisting> + </example> </para> - </sect1> - <sect1 id="language.basic-syntax.comments"> - <title>Commentaires</title> - <para> + </sect1> + <sect1 id="language.basic-syntax.comments"> + <title>Commentaires</title> + <para> Le PHP supporte les commentaires comme en C, C++ et Shell Unix. Par exemple: <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo "Ceci est un test"; // Ceci est un commentaire sur une ligne comme en C++ /* Ceci est un commentaire sur plusieurs lignes, comme en C et C++ */ echo "Ceci est encore un test"; echo "Enfin, le test final"; # Ceci est un commentaire comme en Shell Unix -?> - </programlisting> +?> +]]> + </programlisting> </informalexample> </para> - <simpara> - Le premier type de commentaire ne commente que jusqu'à la - fin de la ligne ou bien jusqu'à la fin du bloc, cela - dépend du premier rencontré. - </simpara> <informalexample> <programlisting role="php"> -<h1>Ceci est un <?php echo "simple";?> exemple.</h1> -<p> +<![CDATA[ +<h1>Ceci est un <?php # echo "simple";?> exemple.</h1> +<p>L'entête ci-dessus affiche 'Ceci est un exemple'. +]]> </programlisting> </informalexample> <simpara> - La ligne du dessus affichera 'Ceci est un simple exemple'. - </simpara> - <simpara> - Faites attention à ne pas emboîter les - commentaires de type 'C', ce qui arrive de temps en temps - lorsque vous voulez commenter une grande partie de code. + Faites attention à ne pas emboîter les commentaires de type + langage C, ce qui arrive de temps en temps lorsque vous voulez commenter + une grande partie de code. </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php /* echo "Ceci est un test"; /* Ce commentaire va poser un problème */ */ -?> - </programlisting> +?> +]]> + </programlisting> </informalexample> + <simpara> + Les commentaires // commente jusqu'à la + fin de la ligne ou bien jusqu'à la fin du bloc (le premier + des deux). Cela signifie que du code HTML placé après + // ?> sera affiché, car PHP retourne alors en mode texte + juste après la balie ?>. + </simpara> </sect1> </chapter> <!-- Keep this comment at the end of the file Index: phpdoc-fr/language/constants.xml diff -u phpdoc-fr/language/constants.xml:1.16 phpdoc-fr/language/constants.xml:1.17 --- phpdoc-fr/language/constants.xml:1.16 Wed Dec 12 15:50:05 2001 +++ phpdoc-fr/language/constants.xml Mon Feb 3 07:27:11 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> +<!-- $Revision: 1.17 $ --> <chapter id="language.constants"> <title>Les constantes</title> <simpara> @@ -27,7 +27,8 @@ </simpara> </note> <simpara> - Les constantes sont accessibles de manière globale. + Les constantes sont accessibles de manière globale. Vous pouvez la définir + n'importe où, et y accèder depuis n'importe quelle fonction. </simpara> <sect1 id="language.constants.syntax"> <title>Syntaxe</title> @@ -39,16 +40,16 @@ <simpara> Seuls les types de données scalaires peuvent être placés dans une constante : c'est à dire les types booléen, entier, double et - chaîne de caractères (soit <type>boolean</type>, <type>integer</type>, - <type>double</type> et <type>string</type>). + chaîne de caractères (soit &boolean;, &integer;, + &double; et &string;). </simpara> <simpara> Vous povuez accéder à la valeur d'une constante en spécifiant simplement son nom. Contrairement aux variables, vous ne devez <emphasis>PAS</emphasis> préfixer le nom de la constante avec <literal>$</literal>. - Vous pouvez aussi utiliser la fonction <function>constant</function>, pour - lire dynamiquement la valeur d'une constante, si vous obtenez le nom - de cette constante dynamiquement (retour de fonction, par exemple). + Vous pouvez aussi utiliser la fonction <function>constant</function>, pour + lire dynamiquement la valeur d'une constante, dont vous obtenez le nom + dynamiquement (retour de fonction, par exemple). Utilisez la fonction <function>get_defined_constants</function> pour connaître la liste de toutes les fonctions définies. </simpara> @@ -62,8 +63,8 @@ </note> <simpara> Lorsque vous utilisez une constante non définie, PHP suppose que vous utilisez - le nom de la constante. Une - <link linkend="features.error-handling">note</link> sera générée. Utilisez la + le nom de la constante. Une <link linkend="ref.errorfunc">note</link> + sera générée. Utilisez la fonction <function>defined</function> pour savoir si une constante existe ou pas. </simpara> <para> @@ -71,19 +72,19 @@ <itemizedlist> <listitem> <simpara> - Les constantes ne commencent pas par le signe (<literal>$</literal>); + Les constantes ne commencent pas par le signe (<literal>$</literal>); </simpara> </listitem> <listitem> <simpara> - Les constantes sont définies et accessibles à tout endroit du code, - globalement. + Les constantes sont définies et accessibles à tout endroit du code, + globalement. </simpara> </listitem> <listitem> <simpara> - Les constantes ne peuvent pas être redéfinies ou indéfinies une fois qu'elles - ont été définies. + Les constantes ne peuvent pas être redéfinies ou indéfinies + une fois qu'elles ont été définies. </simpara> </listitem> <listitem> @@ -97,169 +98,31 @@ <example> <title>Definir une constante</title> <programlisting> -<?php +<![CDATA[ +<?php define("CONSTANTE", "Bonjour le monde."); echo CONSTANTE; // affiche "Bonjour le monde." echo Constante; // affiche "Constante" et une note. -?> +?> +]]> </programlisting> </example> </para> </sect1> <sect1 id="language.constants.predefined"> <title>Constantes prédéfinies</title> - <para> - Les constantes prédéfinies sont toujours disponibles. En voici la liste : - <variablelist> - <varlistentry> - <term>__FILE__ (insensible à la casse)</term> - <listitem> - <simpara> - Le nom du fichier qui est actuellement exécuté. - Si cette constante est utilisée dans le cadre d'un fichier - "inclus" (après utilisation de <function>require</function>), - alors le nom du fichier inclus est renvoyée, et non le nom - du fichier parent. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>__LINE__ (insensible à la casse)</term> - <listitem> - <simpara> - Le numéro de la ligne qui est actuellement exécutée. - Si cette constante est utilisée dans le cadre d'un fichier - "inclus" (après utilisation de <function>require</function>), - c'est la position dans le fichier inclus qui est renvoyé. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>PHP_VERSION</term> - <listitem> - <simpara> - La chaîne de caractères de présentation de la - version du PHP qui est actuellement utilisée. Par exemple '4.1.0'. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>PHP_OS</term> - <listitem> - <simpara> - Nom du système d'exploitation qui est utilisé par - la machine qui fait tourner le PHP. Parmi les valeurs possibles : - "AIX", "Darwin" (MacOS), "Linux", "SunOS", "WIN32", "WINNT". - Note : cette liste n'est pas exhaustive. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>&true;</term> - <listitem> - <simpara> - La valeur vraie booléenne, &true;. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>&false;</term> - <listitem> - <simpara> - La valeur faux booléenne, &false;. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>E_ERROR</term> - <listitem> - <simpara> - Dénote une erreur autre qu'une erreur d'analyse ("parse error") - qu'il n'est pas possible de corriger. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>E_WARNING</term> - <listitem> - <simpara> - Dénote un contexte dans lequel le PHP trouve que quelque chose - ne va pas. Mais l'exécution se poursuit tout de même. - Ces alertes-là peuvent être récupérées - par le script lui-même. Un exemple serait une expression - régulière (regexp) invalide dans la fonction - <function>ereg</function>. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>E_PARSE</term> - <listitem> - <simpara> - L'analyseur a rencontré une forme syntaxique invalide - dans le script. Correction de l'erreur impossible. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>E_NOTICE</term> - <listitem> - <simpara> - Quelque chose s'est produit, qui peut être ou non une erreur. - L'exécution continue. Par exemple, le cas de guillemets doubles (") - non refermés, ou bien la tentative d'accéder à - une variable qui n'est pas encore affectée. - </simpara> - </listitem> - </varlistentry> - </variablelist> - <variablelist> - <varlistentry> - <term>E_ALL</term> - <listitem> - <simpara> - Toutes les constantes E_* rassemblées en une seule. Si vous l'utilisez - avec <function>error_reporting</function>, toutes les erreurs et les - problèmes que PHP rencontrera seront notifiés. - </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> - <para> - Les constantes E_* sont généralement utilisées - avec la fonction <function>error_reporting</function>. - </para> - <para> - Vous pouvez définir d'autres constantes en utilisant la fonction - <function>define</function>. - </para> - <para> - Il est à noter que ce sont des constantes, et non pas des macros - comme en C. Seulement les données scalaires peuvent être - représentées par des constantes. - <example> - <title>Définition de constantes </title> - <programlisting role="php"> -<?php - define("CONSTANTE", "Bonjour le monde."); - echo CONSTANTE; -// affiche "Bonjour le monde." -?> - </programlisting> - </example> - <example> - <title>Utilisation des constantes __FILE__ et __LINE__ </title> - <programlisting role="php"> -<?php - function rapport_erreur($file, $line, $message) { - echo "Une erreur est survenue dans le fichier $file à la ligne $line: $message."; - } - rapport_erreur(__FILE__, __LINE__, "Il y a un problème!"); -?> - </programlisting> - </example> - </para> + <simpara> + PHP fournit un grand nombre de constantes prédéfinies. Certaines + constantes sont définies par différentes extensions, et ne seront + présentes que si ces extensions sont compilées avec &php;, ou bien + si l'extension a été chargée dynamiquement. + </simpara> + + <simpara> + Une liste des constantes prédéfinies est disponible dans la + section + <link linkend="reserved.constants">Constantes prédéfinies</link>. + </simpara> </sect1> </chapter> <!-- Keep this comment at the end of the file Index: phpdoc-fr/language/control-structures.xml diff -u phpdoc-fr/language/control-structures.xml:1.18 phpdoc-fr/language/control-structures.xml:1.19 --- phpdoc-fr/language/control-structures.xml:1.18 Tue Sep 10 22:17:20 2002 +++ phpdoc-fr/language/control-structures.xml Mon Feb 3 07:27:11 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> +<!-- $Revision: 1.19 $ --> <chapter id="control-structures"> <title>Les structures de contrôle</title> <simpara> @@ -33,11 +33,15 @@ </informalexample> </para> <simpara> - Comme nous l'avons vu dans le paragraphe consacré aux expressions, - <replaceable>expr</replaceable> est évaluée à - sa vraie valeur. Si l'expression <replaceable>expr</replaceable> est + Comme nous l'avons vu dans le paragraphe consacré aux + <link linkend="language.expressions">expressions</link>, + <replaceable>expr</replaceable> est convertie en sa valeur + booléenne. Si l'expression <replaceable>expr</replaceable> vaut &true;, PHP exécutera l'instruction et si elle - est &false;, l'instruction sera ignorée. + vaut &false;, l'instruction sera ignorée. + Plus de détails sur les vlaeurs qui valent &false; est disponbile dans + la section + <link linkend="language.types.boolean.casting">Conversion en booléen</link>. </simpara> <para> L'exemple suivant affiche la phrase <computeroutput>a est plus grand @@ -149,12 +153,14 @@ </informalexample> </para> <simpara> - Vous pouvez avoir plusieurs <literal>elseif</literal> qui s'imbriquent - les uns dans les autres, après un <literal>if</literal> initial. + Vous pouvez avoir plusieurs <literal>elseif</literal> qui se suivent + les uns après les autres, après un <literal>if</literal> initial. Le premier <literal>elseif</literal> qui sera évalué à &true; sera exécuté. En PHP, vous pouvez aussi écrire "else if" en deux mots et son comportement sera - identique à la version en un seul mot. + identique à la version en un seul mot. La sémantique des + deux expression est légèrement différente, mais au bout du compte, + le résultat sera exactement le même. </simpara> <simpara> L'expression <literal>elseif</literal> est exécutée @@ -181,13 +187,9 @@ <informalexample> <programlisting role="php"> <![CDATA[ -<?php - if ($a == 5): -?> - A vaut 5 -<?php - endif; - ?> +<?php if ($a == 5): ?> +A égal 5 +<?php endif; ?> ]]> </programlisting> </informalexample> @@ -577,41 +579,57 @@ <programlisting role="php"> <![CDATA[ <?php -/* exemple 1: valeurs seules */ +/* exemple foreach 1 : la valeur seulement */ + $a = array (1, 2, 3, 17); + foreach ($a as $v) { - print "Valeur courante de \$a: $v.\n"; + print "Current value of \$a: $v.\n"; } -/* exemple 2: valeurs (avec la clé correspondante) */ + +/* exemple foreach 2 : la valeur et sa clé d'index */ + $a = array (1, 2, 3, 17); -$i = 0; /* pour l'illustration uniquement */ + +$i = 0; /* uniquement pour l'illustration */ + foreach($a as $v) { print "\$a[$i] => $v.\n"; + $i++; } -/* exemple 3: clé et valeur */ + +/* exemple foreach 3 : la clé et la valeur */ + $a = array ( "un" => 1, "deux" => 2, "trois" => 3, "dix-sept" => 17 ); + foreach($a as $k => $v) { print "\$a[$k] => $v.\n"; } -/* exemple 4: tableaux multi-dimensionnels */ + +/* exemple foreach 4 : tableaux multi-dimensionnels */ + $a[0][0] = "a"; $a[0][1] = "b"; $a[1][0] = "y"; $a[1][1] = "z"; + foreach($a as $v1) { foreach ($v1 as $v2) { print "$v2\n"; } } -/* exemple 5: tableaux dynamique */ + +/* exemple foreach 5 : tableaux dynamiques */ + foreach(array(1, 2, 3, 4, 5) as $v) { print "$v\n"; } + ?> ]]> </programlisting> @@ -662,6 +680,7 @@ </informalexample> </para> </sect1> + <sect1 id="control-structures.continue"> <title><literal>continue</literal></title> <simpara> @@ -933,10 +952,10 @@ intervenir par tick. </para> <para> - <informalexample> + <example> + <title>Profile a section of PHP code</title> <programlisting role="php"> <![CDATA[ -<PRE> <?php // Un fonction qui enregistre l'heure à laquelle elle est appelée function profile($dump = FALSE){ @@ -949,32 +968,26 @@ } $profile[] = microtime (); } + // Enregistre un gestionnaire de tick register_tick_function("profile"); + // Initialise la fonction avant le bloc de déclaration profile(); + // Exécute un bloc de code, et appele un tick toutes les deux secondes declare (ticks=2) { for ($x = 1; $x < 50; ++$x) { echo similar_text(md5($x), md5($x*$x)), "<br>"; } } -?> -]]> - </programlisting> - </informalexample> - Pour voir le résultat : - <informalexample> - <programlisting role="php"> -<![CDATA[ -<?php + // Affiche les données de la variable $profile print_r(profile(TRUE)); ?> -</pre> ]]> </programlisting> - </informalexample> + </example> Cet exemple profile le code PHP dans le bloc de déclaration, et enregistre l'heure de chaque commande bas niveau. Cette information peut être réutilisée pour débusquer les segments @@ -993,76 +1006,73 @@ </simpara> </sect2> </sect1> + <sect1 id="function.return"> + <title>return</title> + <simpara> + Si appelé depuis une fonction, la commande <function>return</function> + termine immédiatement la fonction, et retourne l'argument qui lui + est passé. <function>return</function> interromp aussi l'exécution + de commande <function>eval</function> ou de scripts. + </simpara> + <simpara> + Si appelée depuis l'environnement global, l'exécution du script + est interrompue. Si le script courant était + <function>include</function> ou <function>require</function>, + alors le contrôle est rendu au script appelant, et la valeur + retournée sera utilisée comme résultat de la fonction + <function>include</function>. Si <function>return</function> est + appelé depuis le script principal, alors l'exécution du script + s'arrête. Si le script courant est + <link linkend="ini.auto-prepend-file">auto_prepend_file</link> ou + <link linkend="ini.auto-append-file">auto_append_file</link> + dans le fichier &php.ini;, alors l'exécution du script + s'arrête. + </simpara> + <simpara> + Pour plus d'informations, voyez + <link linkend="functions.returning-values">retourner des valeurs</link>. + </simpara> + <note> + <simpara> + Notez que puisque <function>return</function> est une structure de language + et non pas une fonction, les parenthèses <emphasis>ne sont pas</emphasis> requises : + en fait, il est classique de les ignorer, même si cela ne change rien. + </simpara> + </note> + </sect1> <sect1 id="function.require"> <title><function>require</function></title> <simpara> + <function>require</function> inclut et exécute un + fichier PHP. + </simpara> + <simpara> La commande <function>require</function> se remplace elle-même - par le contenu du fichier spécifié, comme les - préprocesseurs C le font avec la commande <literal>#include</literal>. + par le contenu du fichier spécifié, tel que + décrit dans la documentation de la fonction <function>include</function>. </simpara> <simpara> - Il est important de noter que lorsqu'un fichier est - <function>include</function> ou <function>require</function>, - les erreurs d'analyse apparaîtront en HTML tout au début - du fichier, et l'analyse du fichier parent ne sera pas interrompue. Pour - cette raison, le code qui est dans le fichier doit être placé - entre <link linkend="language.basic-syntax.phpmode">les balises habituelles - de PHP</link>. - </simpara> - <simpara> - <function>require</function> n'est pas vraiment une fonction PHP : - c'est plus une instruction du langage. Elle ne fonctionne pas comme - les fonctions standards. Par exemple, <function>require</function> - est indépendante des structures de contrôle (cela ne sert à rien - de la placer dans une condition, elle sera toujours exécutée). De plus, - elle ne retourne aucune valeur. Lire une valeur retournée par un - <function>require</function> retourne une erreur d'analyse. - </simpara> - <simpara> - Contrairement à <function>include</function>, - <function>require</function> va <emphasis>toujours</emphasis> lire dans - le fichier cible, même si la ligne n'est jamais - exécutée. Si vous souhaitez une inclusion - conditionnelle, utilisez <function>include</function>. La - condition ne va jamais affecter <function>require</function>. - Cependant, si la ligne de <function>require</function> - n'est jamais exécutée, le code du fichier ne - le sera jamais non plus. - </simpara> - <simpara> - Les boucles n'affectent pas le comportement de - <function>require</function>. Même si le code - contenu dans le fichier source est appelé dans la boucle, - <function>require</function> n'est exécuté qu'une - fois. - </simpara> - <para> - Cela signifie qu'on ne peut pas mettre un - <function>require</function> dans une boucle, et s'attendre - à ce qu'il inclue du code à chaque itération. - Pour cela, il faut utiliser <function>include</function>. - <informalexample> - <programlisting role="php"> -<![CDATA[ -<?php - require('header.inc'); -?> -]]> - </programlisting> - </informalexample> - </para> + <function>require</function> et <function>include</function> + sont identiques, sauf dans leur façon de gérer les erreurs. + <function>include</function> produite une + <link linkend="internal.e-warning">Alerte (warning)</link> tandis + que <function>require</function> génère une + <link linkend="internal.e-error">erreur fatale</link>. En + d'autres termes, n'hésitez pas à utiliser + <function>require</function> si vous voulez qu'un fichier + d'inclusion manquant interrompe votre script. + <function>include</function> ne se comporte pas de cette façon, + et le script continuera son exécution. Assurez vous d'avoir + bien configuré le <link linkend="ini.include-path">include_path</link> + aussi. + </simpara> <para> - Attention : <function>include</function> et - <function>require</function> ajoutent le contenu du fichier cible - dans le script lui-même. Elles n'utilisent pas le protocole - HTTP ou tout autre protocole. Toute variable qui est dans le - champs du script sera accessible dans le fichier d'inclusion, - et vice-versa. - <informalexample> + <example> + <title>Exemples avec <function>require</function></title> <programlisting role="php"> <![CDATA[ <?php - require ("file.inc?varone=1&vartwo=2"); + require ("file.inc?varone=1&vartwo=2"); /* Ne fonctionne pas. */ $varone = 1; $vartwo = 2; @@ -1071,31 +1081,127 @@ ?> ]]> </programlisting> - </informalexample> + </example> </para> <simpara> - Ne vous laissez pas abuser par le fait que vous pouvez - requérir ou inclure des fichiers via HTTP en - utilisant la fonctionnalité de - <link linkend="features.remote-files">gestion des fichiers distants</link> - ce qui est au dessus reste vrai. + Voyez la documentation de la fonction <function>include</function> pour plus + d'exemples. </simpara> + <note> + <simpara> + Avant PHP 4.0.2, ceci s'appliquait : <function>require</function> tentait + de lire le fichier cible, même si les lignes n'étaient pas utilisées. + Une condition if n'avait aucun effet sur <function>require</function>. Cependant, + si la ligne du <function>require</function> n'est jamais utilisée, + le code inclus ne le sera pas non plus. De même, les boucles n'ont pas + d'effet sur le comportement de <function>require</function>. Bien que le + code contenu dans le fichier subit la boucle, la fonction elle même + <function>require</function> n'est appelée qu'une fois. + </simpara> + </note> + &warn.no-win32-fopen-wrapper; <simpara> - En PHP 3, il est possible d'exécuter une commande - <literal>return</literal> depuis un fichier inclut, tant - que cette commande intervient au niveau global du fichier - inclus. Elle ne doit intervenir dans aucun bloc (entre accolade {}). - En PHP 4, cette possibilité a été - supprimée. Si vous en avez besoin, utilisez plutôt - <function>include</function>. + Voir aussi + <function>include</function>, + <function>require_once</function>, + <function>include_once</function>, + <function>eval</function>, + <function>file</function>, + <function>readfile</function>, + <function>virtual</function> et + <link linkend="ini.include-path">include_path</link>. </simpara> </sect1> <sect1 id="function.include"> <title><function>include</function></title> <simpara> - La fonction <function>include</function> inclus et évalue le - fichier spécifié en argument. + La fonction <function>include</function> inclus et éxécute + le fichier spécifié en argument. + </simpara> + <simpara> + Cette documentation s'applique aussi à la fonction + <function>require</function>. Les deux structures de + langage sont identiques, hormis dans leur gestion des + erreurs. + <function>include</function> produite une + <link linkend="internal.e-warning">Alerte (warning)</link> tandis + que <function>require</function> génère une + <link linkend="internal.e-error">erreur fatale</link>. En + d'autres termes, n'hésitez pas à utiliser + <function>require</function> si vous voulez qu'un fichier + d'inclusion manquant interrompe votre script. + <function>include</function> ne se comporte pas de cette façon, + et le script continuera son exécution. Assurez vous d'avoir + bien configuré le <link linkend="ini.include-path">include_path</link> + aussi. + </simpara> + <simpara> + Lorsqu'un fichier est inclus, le code qu'il contient hérite + des variables qui existent dans ce + <link linkend="language.variables.scope">contexte</link>. + Toute variable accessible à la ligne qui réalise l'exécution + est aussi accessible dans le fichier inclus. + </simpara> + <para> + <example> + <title>Exemple avec <function>include</function></title> + <programlisting role="php"> +<![CDATA[ +vars.php +<?php + +$couleur = 'verte'; +$fruit = 'pomme'; + +?> + +test.php +<?php + +echo "Une $couleur $fruit"; // Une + +include 'vars.php'; + +echo "Une $color $fruit"; // Une verte pomme + +?> +]]> + </programlisting> + </example> + </para> + <simpara> + Si l'inclusion intervient à l'intérieure d'une fonction, + le code inclus sera alors considéré comme faisant partie de la + fonction. Cela modifie donc le contexte de variables accessibles. </simpara> + <para> + <example> + <title>Inclusion de fichiers dans une fonction</title> + <programlisting role="php"> +<![CDATA[ +<?php + +function foo() { + global $couleur; + + include 'vars.php'; + + echo "Une $couleur $fruit"; +} + +/* vars.php est dans le contexte de foo() * + * donc $fruit n'est pas dispnibles hors de * + * cette fonction. $couleur l'est, car c'est * + * une variable globale */ + +foo(); // Une verte pomme +echo "Une $couleur $fruit"; // Une verte + +?> +]]> + </programlisting> + </example> + </para> <simpara> Il est important de noter que lorsqu'un fichier est <function>include</function> ou <function>require</function>, @@ -1106,189 +1212,163 @@ <link linkend="language.basic-syntax.phpmode">les balises habituelles de PHP</link>. </simpara> + <simpara> + Si les "<link linkend="ini.allow-url-fopen">URL fopen wrappers</link>" + sont activés dans &php; (ce qui est le cas par défaut), + vous pouvez localiser le fichier avec une URL (via HTTP ou + bien avec un gestionnaire adapté : voir <xref linkend="wrappers"/> + pour une liste des protocoles), au lieu d'un simple chemin + local. Si le serveur distant interprête le fichier comme du code + PHP, des variables peuvent être transmises au serveur distant + via l'URL et la méthode GET. Ce n'est pas, à strictement + parler, la même chose que d'hériter du contexte de variable. + Le fichier inclus est en fait un script exécuté à distance, + et son résultat est inclus dans le code courant. + </simpara> + &warn.no-win32-fopen-wrapper; <para> - Cela se produit à chaque fois que la fonction - <function>include</function> est rencontrée. Donc, vous - pouvez utiliser la fonction <function>include</function> - dans une boucle pour inclure un nombre infini de - fois un fichier, ou même des fichiers différents. - <informalexample> + <example> + <title>Utiliser <function>include</function> via HTTP</title> <programlisting role="php"> <![CDATA[ <?php -$files = array ('premier.inc', 'second.inc', 'troisieme.inc'); -for ($i = 0; $i < count($files); $i++) { - include $files[$i]; -} + +/* Cet exemple suppose que www.exemple.com est configur pour traiter + * les fichiers .php et non pas les fichiers .txt. De plus, + * 'Work' signifie ici que les variables + * $foo et $bar sont disponibles dans le fichier inclus + */ + +// Ne fonctionne pas : file.txt n'a pas été traité par www.exemple.com comme du PHP +include 'http://www.example.com/file.txt?foo=1&bar=2'; + +// Ne fonctionne pas : le script cherche un fichier nommé +// 'file.php?foo=1&bar=2' sur le système local +include 'file.php?foo=1&bar=2'; + +// Réussi +include 'http://www.example.com/file.php?foo=1&bar=2'; + +$foo = 1; +$bar = 2; +include 'file.txt'; // OK. +include 'file.php'; // OK. + ?> ]]> </programlisting> - </informalexample> + </example> + Voir aussi + <link linkend="features.remote-files">travailler avec les fichiers distants</link>, + <function>fopen</function> et + <function>file</function> pour des informations reliées. </para> <para> - <function>include</function> diffère de - <function>require</function> car le fichier inclus est - ré-évaluée à chaque fois que la - commande est exécutée, tandis que - <function>require</function> est remplacée - par le fichier cible lors de la première - exécution, que son contenu soit utilisé - ou non. De plus, cela se fait même s'il - est placé dans une structure conditionnelle, - comme dans un <link linkend="control-structures.if">if</link>). + Comme <function>include</function> et <function>require</function> + sont des structures du langages particulières, vous devez les + placer dans un bloc si ils sont placés dans un bloc conditionnel. </para> <para> - Parceque la fonction <function>include</function> nécessite - une construction particulière, vous devez l'inclure dans un - bloc si elle est incluse dans une structure conditionnelle. - <informalexample> + <example> + <title><function>include</function> et les conditions</title> <programlisting role="php"> <![CDATA[ <?php -/* Ceci est faux, et ne fonctionnera pas comme on l'attend. */ +// Ceci est FAUX et échouera if ($condition) - include($file); + include $file; else - include($other); -/* Ceci est CORRECT. */ + include $other; + + +// Ceci est CORRECT. if ($condition) { - include($file); + include $file; } else { - include($other); + include $other; } + ?> ]]> </programlisting> - </informalexample> + </example> </para> <simpara> - En PHP 3, il est possible d'exécuter une commande - <literal>return</literal> depuis un fichier inclus, tant - que cette commande intervient au niveau global du fichier - inclus. Elle ne doit intervenir dans aucun bloc (entre accolade - {}). En PHP 4, cette possibilité a été - supprimée. Cependant, PHP 4 vous autorise à - retourner des valeurs d'un fichier inclus. Vous pouvez - traiter <function>include</function> comme une fonction - normale, qui retourne une valeur. Mais cela génère - une erreur d'analyse en PHP 3. + Gestion du retour : il est possible d'éxécuter une commande + <function>return</function> dans un fichier inclus pour en + terminer le traitement et retourner au fichier appelant. De plus, + il est possible de retourner des valeurs des fichiers inclus. + vous pouvez prendre et traiter la valeur retournée par la + fonction, comme toute autre fonction. </simpara> - <example> - <title><function>include</function> en PHP 3 et PHP 4</title> - <para> - On suppose que le fichier <filename>test.inc</filename> existe, - et est placé dans le même dossier que le fichier - principal : - <programlisting role="php"> -<![CDATA[ -<?php -echo "Avant le retour<br>\n"; -if (1) { - return 27; -} -echo "Après le retour <br>\n"; -?> -]]> - </programlisting> - </para> - <para> - On suppose que le fichier <filename>main.html</filename> contient ceci : - <programlisting role="php"> + <note> + <simpara> + En PHP 3, le retourn n'est pas utilisable à moins que ce + ne soit dans un bloc de fonction, auquel cas le + <function>return</function> s'applique à une fonction et non + pas au fichier. + </simpara> + </note> + <para> + <example> + <title><function>include</function> et <function>return</function></title> + <programlisting role="php"> <![CDATA[ +return.php <?php -$retval = include ('test.inc'); -echo "Fichier inclus: '$retval'<br>\n"; + +$var = 'PHP'; + +return $var; + ?> -]]> - </programlisting> - </para> - <para> - Lorsque <filename>main.html</filename> est appelé en PHP 3, - il va générer une erreur d'analyse (parse error) - à la ligne 2; vous ne pouvez pas vous attendre à un - retour sur une fonction <function>include</function> en PHP 3. En - PHP 4, cependant,le résultat sera : - <screen> -Avant le retour -Ficher inclus : '27' - </screen> - </para> - <para> - Supposons maintenant que <filename>main.html</filename> a - été modifié et contient maintenant le - code suivant : - <programlisting role="php"> -<![CDATA[ + +noreturn.php <?php - include ('test.inc'); - echo "Retour dans le main.html<br>\n"; + +$var = 'PHP'; + ?> -]]> - </programlisting> - </para> - <para> - En PHP 4, l'affichage sera : - <screen> -Avant le retour -Retour dans le main.html - </screen> - Au contraire, PHP 3 affichera : - <screen> -Avant le retour -27Retour dans le main.html -Parse error: parse error in /home/torben/public_html/phptest/main.html on line 5 - </screen> - </para> - <para> - L'erreur d'analyse ci-dessus est le résultat du fait que la commande - <literal>return</literal> est dans un bloc qui n'est pas une fonction, dans - <filename>test.inc</filename>. Lorsque le return est sorti du bloc, - l'affichage devient : - <screen> -Avant le retour -27Retour dans le main.html - </screen> - </para> - <para> - Le '27' est du au fait que PHP 3 ne supporte pas le <literal>return</literal> - dans ces fichiers. - </para> - </example> - <para> - Il est important de noter que lorsqu'un fichier est <function>include</function> - ou <function>require</function>, les erreurs d'analyse apparaîtront en - HTML tout au début du fichier, et l'analyse du fichier parent ne sera - pas interrompue. Pour cette raison, le code qui est dans le fichier doit - être placé entre - <link linkend="language.basic-syntax.phpmode">les balises habituelles de PHP</link>. - <informalexample> - <programlisting role="php"> -<![CDATA[ + +testreturns.php <?php - include ("file.inc?varone=1&vartwo=2"); /* ne fonctionne pas. */ - $varone = 1; - $vartwo = 2; - include ("file.inc"); - /* $varone et $vartwo sont accessibles dans file.inc */ + +$foo = include 'return.php'; + +echo $foo; // prints 'PHP' + +$bar = include 'noreturn.php'; + +echo $bar; // prints 1 + ?> ]]> - </programlisting> - </informalexample> + </programlisting> + </example> </para> <simpara> - Ne vous laissez pas abuser par le fait que vous pouvez requérir - ou inclure des fichiers via HTTP en utilisant la fonctionnalité - de <link linkend="features.remote-files">gestion des fichiers distants - </link> ce qui est au dessus reste vrai. + <literal>$bar</literal> a la valeur de <literal>1</literal> car + l'inclusion était réussie. Notez la différence entre les deux + exemples ci-dessus. Le premier utilise la commande <function>return</function> + dans le fichier inclus, alors que le second ne le fait pas. + Un autre moyen d'inclure des fichiers dans des variables + est d'utiliser la fonction <function>fopen</function> ou + <function>file</function> ou d'utiliser + <function>include</function> avec les + <link linkend="ref.outcontrol">fonctions de contrôle de sortie</link>. </simpara> + <simpara> - Voir aussi + Voir aussi + <function>require</function>, + <function>require_once</function>, + <function>include_once</function>, <function>readfile</function>, - <function>require</function> et - <function>virtual</function>. + <function>virtual</function> et + <link linkend="ini.include-path">include_path</link>. </simpara> - </sect1> + </sect1> <sect1 id="function.require-once"> <title><function>require_once</function></title> <para> @@ -1302,138 +1382,51 @@ variables ou de fonctions, génératrices d'alertes. </para> <para> - Par exemple, si vous créez les deux fichiers d'inclusion - <literal>utils.inc</literal> et <literal>foolib.inc</literal> - <example> - <title>utils.inc</title> - <programlisting role="php"> -<![CDATA[ -<?php -define(PHPVERSION, floor(phpversion())); -echo "LES GLOBALES SONT SYMPAS\n"; -function goodTea() { - return "Le Earl Grey est délicieux!"; -} -?> -]]> - </programlisting> - </example> - <example> - <title>foolib.inc</title> - <programlisting role="php"> -<![CDATA[ -<?php -require ("utils.inc"); -function showVar($var) { - if (PHPVERSION == 4) { - print_r($var); - } else { - dump_var($var); - } -} -// Une série de fonctions -?> -]]> - </programlisting> - </example> - Puis, vous écrivez un script <literal>cause_error_require.php</literal> - <example> - <title>cause_error_require.php</title> - <programlisting role="php"> -<![CDATA[ -<?php - require("foolib.inc"); -/* Ceci génère une erreur*/ - require("utils.inc"); - $foo = array("1",array("complex","quaternion")); - echo "Ce code requiert utils.inc une deuxième fois, car il est requis \n"; - echo "dans foolib.inc\n"; - echo "Utilisation de GoodTea: ".goodTea()."\n"; - echo "Affichage de foo: \n"; - showvar($foo); -?> -]]> - </programlisting> - </example> - Lorsque vous exécutez le script ci-dessus, le - résultat sera (sous PHP 4.01pl2): - <informalexample> - <programlisting> -GLOBALS ARE NICE -GLOBALS ARE NICE -Fatal error: Cannot redeclare causeerror() in utils.inc on line 5 - </programlisting> - </informalexample> - En modifiant <literal>foolib.inc</literal> et - <literal>cause_errror_require.php</literal> - pour qu'elles utilisent <function>require_once</function> - au lieu de <function>require</function> et ne renommant pas le fichier - en <literal>avoid_error_require_once.php</literal>, on obtient : - <example> - <title>foolib.inc (corrigé)</title> - <programlisting role="php"> + <function>require_once</function> doit être utilisée dans les cas + où le même fichier risque d'être inclus et évaluée plusieurs fois + durant l'exécution d'un script. Vous serez alors sur be used in cases where + the same file might be included and evaluated more than once during a + particular execution of a script, and you want to be sure that it is + included exactly once to avoid problems with function redefinitions, + variable value reassignments, etc. + </para> + <para> + Pour des exemples avec <function>require_once</function> et + <function>include_once</function>, reportez-vous au code + <ulink url="&url.php.pear;">PEAR</ulink> inclut dans les + dernières distributions PHP. + </para> + <note> + <para> + <function>require_once</function> a été ajouté en PHP 4.0.1pl2 + </para> + </note> + <note> + <para> + Attention, <function>require_once</function> et + <function>include_once</function> sont sensibles à la casse + sous Windows. + <example> + <title><function>require_once</function> est sensible à la casse</title> + <programlisting role="php"> <![CDATA[ -<?php - require_once("utils.inc"); - function showVar($var) { -?> +require_once("a.php"); // ceci inclut le fichier a.php +require_once("A.php"); // ceci inclut encore le fichier a.php sous Windows! ]]> - </programlisting> - </example> - <example> - <title>avoid_error_require_once.php</title> - <programlisting role="php"> -<![CDATA[ -<?php - require_once("foolib.inc"); - require_once("utils.inc"); - $foo = array("1",array("complexe","quaternion")); -?> -]]> - </programlisting> - </example> - L'exécution de ce script, sous PHP 4.0.1pl2, donne : - <informalexample> - <programlisting> -LES GLOBALES SONT SYMPA -Ce code requiert utils.inc une deuxième fois, car il est requis -dans foolib.inc -Utilisation de GoodTea: Le Earl Grey est délicieux! -Affichage de foo: -Array -( - [0] => 1 - [1] => Array - ( - [0] => complexe - [1] => quaternion - ) -) - </programlisting> - </informalexample> - </para> - <para> - Notez aussi que, de la même manière que les - préprocesseurs traitent les <literal>#include</literal>, - cette commande est exécutée au moment de la - compilation, c'est-à-dire lorsque le script est - analysée, et avant qu'il soit exécuté, - et ne doit pas être utilisée pour insérer - des données dynamiques liées à - l'éxécution. Il vaut alors mieux utiliser - <function>include_once</function> ou <function>include</function>. - </para> - <para> - Pour plus d'exemples avec <function>require_once</function> et - <function>include_once</function>, jetez un oeil dans le code de PEAR - inclus dans la dernière distribution de PHP. - </para> + </programlisting> + </example> + </para> + </note> + &warn.no-win32-fopen-wrapper; <para> - Voir aussi : <function>require</function>, - <function>include</function>, <function>include_once</function>, + Voir aussi + <function>require</function>, + <function>include</function>, + <function>include_once</function>, <function>get_required_files</function>, - <function>get_included_files</function>, <function>readfile</function>, - et <function>virtual</function>. + <function>get_included_files</function>, + <function>readfile</function> et + <function>virtual</function>. </para> </sect1> <sect1 id="function.include-once"> Index: phpdoc-fr/language/expressions.xml diff -u phpdoc-fr/language/expressions.xml:1.8 phpdoc-fr/language/expressions.xml:1.9 --- phpdoc-fr/language/expressions.xml:1.8 Tue Aug 13 22:19:28 2002 +++ phpdoc-fr/language/expressions.xml Mon Feb 3 07:27:11 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <chapter id="language.expressions"> <title>Les expressions</title> <simpara> @@ -24,11 +24,13 @@ la fonction suivante : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function foo () { return 5; } -?> +?> +]]> </programlisting> </informalexample> </para> @@ -128,9 +130,11 @@ vueà-dire dans d'autre langage, l'opérateur conditionnel ternaire: <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $first ? $second : $third -?> +?> +]]> </programlisting> </informalexample> Si la valeur de la première sous-expression est vraie @@ -144,7 +148,8 @@ incrémentation et le concept des expressions en général: <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function double($i) { return $i*2; } @@ -162,7 +167,8 @@ $h = $g += 10; /* Tout d'abord, $g est incrémentée de 10, et donc $g vaut 24. Ensuite, la valeur de $g, (24) est assignée à la variable $h, qui vaut donc elle aussi 24. */ -?> +?> +]]> </programlisting> </informalexample> </para> Index: phpdoc-fr/language/functions.xml diff -u phpdoc-fr/language/functions.xml:1.11 phpdoc-fr/language/functions.xml:1.12 --- phpdoc-fr/language/functions.xml:1.11 Wed Dec 12 15:50:07 2001 +++ phpdoc-fr/language/functions.xml Mon Feb 3 07:27:11 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> - <chapter id="function"> +<!-- $Revision: 1.12 $ --> + <chapter id="functions"> <title>Les fonctions</title> <sect1 id="functions.user-defined"> <title>Les fonctions utilisateur</title> @@ -8,12 +8,14 @@ Une fonction peut être définie en utilisant la syntaxe suivante : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function foo ($arg_1, $arg_2, ..., $arg_n) { echo "Exemple de fonction.\n"; return $retval; } -?> +?> +]]> </programlisting> </informalexample> </para> @@ -62,11 +64,13 @@ un tableau comme argument : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function takes_array($input) { echo "$input[0] + $input[1] = ", $input[0]+$input[1]; } -?> +?> +]]> </programlisting> </informalexample> </para> @@ -87,14 +91,16 @@ devant l'argument dans la déclaration de la fonction : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function add_some_extra(&$string) { $string .= ', et un peu plus.'; } $str = 'Ceci est une chaîne'; add_some_extra($str); echo $str; // affiche 'Ceci est une chaîne, et un peu plus.' -?> +?> +]]> </programlisting> </informalexample> </para> @@ -105,7 +111,8 @@ devant l'argument dans l'appel de la fonction: <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function foo ($bar) { $bar .= ', et un peu plus.'; } @@ -114,7 +121,8 @@ echo $str; // affiche 'Ceci est une chaîne' foo (&$str); echo $str; // affiche 'Ceci est une chaîne, et un peu plus.' -?> +?> +]]> </programlisting> </informalexample> </para> @@ -126,13 +134,15 @@ défaut pour les arguments de type scalaire : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function servir_apero ($type = "ricard") { return "Servir un verre de $type.\n"; } echo servir_apero(); echo servir_apero("whisky"); -?> +?> +]]> </programlisting> </informalexample> </para> @@ -156,12 +166,14 @@ Considérons le code suivant : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function faireunyaourt ($type = "acidophilus", $flavour) { return "Préparer un bol de $type $flavour.\n"; } echo faireunyaourt ("framboise"); // ne fonctionne pas comme voulu -?> +?> +]]> </programlisting> </informalexample> </para> @@ -178,12 +190,14 @@ l'exemple suivant : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function faireunyaourt ($flavour, $type = "acidophilus") { return "Préparer un bol de $type $flavour.\n"; } echo faireunyaourt ("framboise"); // fonctionne comme voulu -?> +?> +]]> </programlisting> </informalexample> </para> @@ -218,12 +232,14 @@ peuvent être renvoyés, tableaux et objets compris. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function carre ($num) { return $num * $num; } echo carre (4); // affiche '16'. -?> +?> +]]> </programlisting> </informalexample> </para> @@ -233,12 +249,14 @@ en renvoyant un tableau. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function petit_nombre() { return array (0, 1, 2); } list ($zero, $one, $two) = petit_nombre(); -?> +?> +]]> </programlisting> </informalexample> </para> @@ -248,12 +266,14 @@ l'assignation de la valeur de retour. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function &retourne_reference() { return $uneref; } $newref =&retourne_reference(); -?> +?> +]]> </programlisting> </informalexample> </para> @@ -303,7 +323,8 @@ <example> <title>Exemple de fonction variable</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php function foo() { echo "dans foo()<br>\n"; } @@ -314,7 +335,8 @@ $func(); $func = 'bar'; $func( 'test' ); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/language/oop.xml diff -u phpdoc-fr/language/oop.xml:1.18 phpdoc-fr/language/oop.xml:1.19 --- phpdoc-fr/language/oop.xml:1.18 Tue Aug 13 22:19:28 2002 +++ phpdoc-fr/language/oop.xml Mon Feb 3 07:27:11 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> +<!-- $Revision: 1.19 $ --> <chapter id="language.oop"> <title>Les classes et les objets</title> <sect1 id="keyword.class"> @@ -10,24 +10,29 @@ en utilisant la syntaxe suivante : <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class Caddie { - var $items; // Eléments de notre panier - // Ajout de $num articles de type $artnr au panier +// Eléments de notre panier + var $items; + +// Ajout de $num articles de type $artnr au panier function add_item ($artnr, $num) { $this->items[$artnr] += $num; } - // Suppression de $num articles du type $artnr du panier + +// Suppression de $num articles du type $artnr du panier function remove_item ($artnr, $num) { - if ($this->items[$artnr] > $num) { + if ($this->items[$artnr] > $num) { $this->items[$artnr] -= $num; return &true;; } else { - return <literal>FALSE</literal>; + return FALSE; } } } -?> +?> +]]> </programlisting> </informalexample> </para> @@ -69,7 +74,8 @@ </simpara> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php /* Aucune de ces syntaxes ne fonctionnera en PHP 4 */ class Caddie { var $date_du_jour = date("d/m/Y"); @@ -89,7 +95,8 @@ /* etc... */ } } -?> +?> +]]> </programlisting> </informalexample> </note> @@ -99,12 +106,15 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php $cart = new Caddie; $cart->add_item("10", 1); $another_cart = new Cart; $another_cart->add_item("0815", 3); -?> +?> +]]> + </programlisting> </informalexample> <para> @@ -131,8 +141,9 @@ </para> <informalexample> <programlisting role="php"> -<?php -// correct, $ unique + <![CDATA[ +<?php +// correct, le signe $ est unique $cart->items = array("10" => 1); // incorrect, car $cart->$items devient $cart->"" $cart->$items = array("10" => 1); @@ -140,7 +151,8 @@ // $cart->$myvar devient $ncart->items $myvar = 'items'; $cart->$myvar = array("10" => 1); -?> +?> +]]> </programlisting> </informalexample> <para> @@ -174,34 +186,38 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class Caddie_nomme extends Caddie { var $owner; function set_owner ($name) { $this->owner = $name; } } -?> +?> +]]> </programlisting> </informalexample> <para> L'exemple ci-desssus définit la classe Caddie_nomme qui - possède les même variables que la classe Caddie et + possède les mêmes variables que la classe Caddie et la variable $owner en plus, ainsi que la fonction set_owner(). Vous créez un panier nominatif de la même manière que précédemment, et vous pouvez alors affecter un nom au panier ou en connaître le nom. Vous pouvez de - toutes les façons utiliser les même fonctions que sur un + toutes les façons utiliser les mêmes fonctions que sur un panier classique. </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php $ncart = new Caddie_nomme; // Création d'un panier nominatif $ncart->set_owner ("kris"); // Affectation du nom du panier print $ncart->owner; // Affichage du nom du panier $ncart->add_item ("10", 1); // (héritage des fonctions de la classe père) -?> +?> +]]> </programlisting> </informalexample> </sect1> @@ -221,19 +237,21 @@ le même nom que la classe. En PHP 3, une fonction devient le constructeur si elle porte le même nom que la classe. En PHP 4, une fonction devient un constructeur - si elle porte le même nom que la classe dans laquelle elle est définit. + si elle porte le même nom que la classe dans laquelle elle est définie. La différence est subtile, mais cruciale. </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class Auto_Caddie extends Caddie { function Auto_Caddie () { $this->add_item ("10", 1); } } // Cette syntaxe est valable en PHP 3 et 4 -?> +?> +]]> </programlisting> </informalexample> <para> @@ -249,7 +267,8 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php // Cette syntaxe est valable en PHP 3 et 4 class Constructor_Cart extends Cart { function Constructor_Cart ($item = "10", $num = 1) { @@ -260,7 +279,8 @@ $default_cart = new Constructor_Cart; // Création d'un vrai caddie $different_cart = new Constructor_Cart ("20", 17); -?> +?> +]]> </programlisting> </informalexample> <caution> @@ -272,25 +292,27 @@ </caution> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class A { function A() { - echo "Je suis le constructeur de A.<br>\n"; + echo "Je suis le constructeur de A.<br>\n"; } } class B extends A { function C() { - "Je suis une fonction standard.<br>\n"; + "Je suis une fonction standard.<br>\n"; } } // Aucun constructeur n'est appelé en PHP 3!! $b = new B; -?> +?> +]]> </programlisting> </informalexample> <para> En PHP 3, aucun constructeur ne sera appelé dans l'exemple ci-dessus. - La règle en PHP 3 est : 'Un constructeur est une fonction qui a le même nom + La règle en PHP 3 est : 'Un constructeur est une méthode qui a le même nom que la classe'. Le nom de la classe est B, et il n'y a pas de fonctions qui s'appelle B() dans la classe B. Rien ne se passe. </para> @@ -302,40 +324,42 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class A { function A() { - echo "Je suis le constructeur de A.<br>\n"; + echo "Je suis le constructeur de A.<br>\n"; } function B() { - echo "Je suis une fonction standard appelée B dans la classe A.<br>\n"; - echo "Je ne suis pas le constructeur de A.<br>\n"; + echo "Je suis une fonction standard appelée B dans la classe A.<br>\n"; + echo "Je ne suis pas le constructeur de A.<br>\n"; } } class B extends A { function C() { - echo "Je suis une fonction standard.<br>\n"; + echo "Je suis une fonction standard.<br>\n"; } } // Cette syntaxe va appeler B() comme constructeur. $b = new B; -?> +?> +]]> </programlisting> </informalexample> <para> En PHP 3, la fonction B() de la classe A va soudaiement devenir le constructeur de la classe B, bien qu'il n'ai pas été prévu pour. La règle de PHP 3 est 'Un constructeur est une - fonction qui a le même nom que la classe'. PHP 3 ne se soucie + méthode qui a le même nom que la classe'. PHP 3 ne se soucie guère si la fonction est définie dans la classe B ou si elle a été héritée. </para> <para> Ceci est corrigé en PHP 4, avec l'introduction d'une nouvelle règle : - 'Un constructeur est une classe de même nom, définit dans la - classe elle-même'. Donc, en PHP 4, la classe B n'a pas de constructeur + 'Un constructeur est une méthode de même nom que la classe, définie + dans la classe elle-même'. Donc, en PHP 4, la classe B n'a pas de constructeur par elle-même, et le constructeur de la classe A aura été appelé, affichant : 'Je suis le constructeur de A.<br>'. @@ -378,29 +402,31 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class A { function example() { - echo "Je suis la fonction originale A::example().<br>\n"; + echo "Je suis la fonction originale A::example().<br>\n"; } } class B extends A { function example() { - echo "Je suis la fonction redéfinie B::example().<br>\n"; + echo "Je suis la fonction redéfinie B::example().<br>\n"; A::example(); } } // Il n'y a pas d'objets de classe A. // L'affichage est : -// Je suis la fonction originale A::example().<br> +// Je suis la fonction originale A::example().<br> A::example(); // Création d'un objet de la classe B. $b = new B; // L'affichage est : -// Je suis la fonction redéfinie B::example().<br> -// Je suis la fonction originale A::example().<br> +// Je suis la fonction redéfinie B::example().<br> +// Je suis la fonction originale A::example().<br> $b->example(); -?> +?> +]]> </programlisting> </informalexample> <para> @@ -452,22 +478,24 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class A { function example() { - echo "Je suis A::example() et je fournis une fonctionnalité de base.<br>\n"; + echo "Je suis A::example() et je fournis une fonctionnalité de base.<br>\n"; } } class B extends A { function example() { - echo "Je suis B::example() et je fournis une fonctionnalité supplémentaire.<br>\n"; + echo "Je suis B::example() et je fournis une fonctionnalité supplémentaire.<br>\n"; parent::example(); } } $b = new B; // Cette syntaxe va appeler B::example(), qui, à sont tour, va appeler A::example(). $b->example(); -?> +?> +]]> </programlisting> </informalexample> </sect1> @@ -510,7 +538,8 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php classa.inc: class A { var $one = 1; @@ -518,9 +547,9 @@ echo $this->one; } } -?> +?> page1.php: -<?php +<?php include("classa.inc"); $a = new A; $s = serialize($a); @@ -528,16 +557,17 @@ $fp = fopen("store", "w"); fputs($fp, $s); fclose($fp); -?> +?> page2.php: -<?php +<?php // Ceci est nécessaire pour que unserialize() fonctionne correctement include("classa.inc"); $s = implode("", @file("store")); unserialize($s); // maintenant, utilisez la méthode show_one de l'objet $a. $a->show_one(); -?> +?> +]]> </programlisting> </informalexample> <para> @@ -590,7 +620,7 @@ variables qui n'ont pas été sauvées. </para> </sect1> - <sect1 id="keyword.newref"> + <sect1 id="language.oop.newref"> <title>Références dans un constructeur</title> <para> Créer des références dans un constructeur peut conduire à @@ -598,25 +628,27 @@ problèmes. <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class foo { function foo($name) { // crée une référence dans le tableau global $globalref global $globalref; - $globalref[] = &$this; + $globalref[] = &$this; // donne le nom de la variable - $this->setName($name); + $this->setName($name); // et l'affiche - $this->echoName(); + $this->echoName(); } function echoName() { - echo "<br>",$this->Name; + echo "<br>",$this->Name; } function setName($name) { - $this->Name = $name; + $this->Name = $name; } } -?> +?> +]]> </programlisting> </informalexample> </para> @@ -627,22 +659,24 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php $bar1 = new foo('crée dans le constructeur'); - $bar1->echoName(); - $globalref[0]->echoName(); + $bar1->echoName(); + $globalref[0]->echoName(); /* affiche : crée dans le constructeur crée dans le constructeur crée dans le constructeur */ $bar2 =&new foo('crée dans le constructeur'); - $bar2->echoName(); - $globalref[1]->echoName(); + $bar2->echoName(); + $globalref[1]->echoName(); /* affiche : crée dans le constructeur crée dans le constructeur crée dans le constructeur */ -?> +?> +]]> </programlisting> </informalexample> <para> @@ -666,69 +700,72 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php // maintenant, nous allons changer de nom. Qu'attendez-vous? // Vous pouvez vous attendre à ce que les deux variables $bar // et $globalref[0] changent de nom... - $bar1->setName('modifié'); + $bar1->setName('modifié'); // comme prédit, ce n'est pas le cas - $bar1->echoName(); - $globalref[0]->echoName(); + $bar1->echoName(); + $globalref[0]->echoName(); /* affiche : crée dans le constructeur modifié */ // quelle est la différence entre $bar2 et $globalref[1] - $bar2->setName('modifié'); + $bar2->setName('modifié'); // Heureusement, elles sont non seulement égales, mais // elles représentent la même variable. - // donc $bar2->Name et $globalref[1]->Name sont les mêmes - $bar2->echoName(); - $globalref[1]->echoName(); + // donc $bar2->Name et $globalref[1]->Name sont les mêmes + $bar2->echoName(); + $globalref[1]->echoName(); /* affiche : modifié modifié */ -?> +?> +]]> </programlisting> </informalexample> <para> Un dernier exemple pour bien comprendre. <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class a { function a($i) { - $this->value = $i; + $this->value = $i; // Essayez de comprendre on n'a pas besoin de // référence ici - $this->b = new b($this); + $this->b = new b($this); } function createRef() { - $this->c = new b($this); + $this->c = new b($this); } function echoValue() { - echo "<br>","class ",get_class($this),': ',$this->value; + echo "<br>","class ",get_class($this),': ',$this->value; } } class b { function b(&$a) { - $this->a = &$a; + $this->a = &$a; } function echoValue() { - echo "<br>","class ",get_class($this),': ',$this->a->value; + echo "<br>","class ",get_class($this),': ',$this->a->value; } } // Essayez de comprendre pourquoi une copie simple va // conduire à un résultat indésirable à // la ligne marquée d'une étoile $a =&new a(10); -$a->createRef(); -$a->echoValue(); -$a->b->echoValue(); -$a->c->echoValue(); -$a->value = 11; -$a->echoValue(); -$a->b->echoValue(); // * -$a->c->echoValue(); +$a->createRef(); +$a->echoValue(); +$a->b->echoValue(); +$a->c->echoValue(); +$a->value = 11; +$a->echoValue(); +$a->b->echoValue(); // * +$a->c->echoValue(); /* output: class a: 10 @@ -738,7 +775,9 @@ class b: 11 class b: 11 */ -?> +?> +]]> + </programlisting> </informalexample> </para> Index: phpdoc-fr/language/operators.xml diff -u phpdoc-fr/language/operators.xml:1.18 phpdoc-fr/language/operators.xml:1.19 --- phpdoc-fr/language/operators.xml:1.18 Fri Jun 28 13:36:36 2002 +++ phpdoc-fr/language/operators.xml Mon Feb 3 07:27:11 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> +<!-- $Revision: 1.19 $ --> <chapter id="language.operators"> <title>Les opérateurs</title> <simpara> @@ -112,6 +112,15 @@ </tgroup> </table> </para> + <note> + <para> + Bien que <literal>!</literal> soit prioritaire sur + <literal>=</literal>, &php; va tout de même exécuter des + expressions comme : <literal>if (!$a = foo())</literal>. + Dans cette situation, le résultat de <literal>foo()</literal> + sera placé dans la variable <varname>$a</varname>. + </para> + </note> </sect1> <sect1 id="language.operators.arithmetic"> <title>Les opérateurs arithmétiques</title> @@ -452,7 +461,7 @@ <![CDATA[ <?php $output = `ls -al`; - echo "<pre>$output</pre>"; + echo "<pre>$output</pre>"; ?> ]]> </programlisting> @@ -461,7 +470,7 @@ <note> <para> Cet opérateur est désactivé lorsque le - <link linkend="ini.safe-mode">safe mode</link> est activé. + &safemode; est activé. </para> </note> <para> @@ -514,27 +523,27 @@ </tgroup> </table> <para> - Voici un exempla simple + Voici un exemple simple <informalexample> <programlisting role="php"> <![CDATA[ <?php - echo "<h3>Post-incrémentation</h3>"; + echo "<h3>Post-incrémentation</h3>"; $a = 5; - echo "Devrait valoir 5: " . $a++ . "<br>\n"; - echo "Devrait valoir 6: " . $a . "<br>\n"; - echo "<h3>Pré-incrémentation</h3>"; + echo "Devrait valoir 5: " . $a++ . "<br>\n"; + echo "Devrait valoir 6: " . $a . "<br>\n"; + echo "<h3>Pré-incrémentation</h3>"; $a = 5; - echo "Devrait valoir 6: " . ++$a . "<br>\n"; - echo "Devrait valoir 6: " . $a . "<br>\n"; - echo "<h3>Post-décrémentation</h3>"; + echo "Devrait valoir 6: " . ++$a . "<br>\n"; + echo "Devrait valoir 6: " . $a . "<br>\n"; + echo "<h3>Post-décrémentation</h3>"; $a = 5; - echo "Devrait valoir 5: " . $a-- . "<br>\n"; - echo "Devrait valoir 4: " . $a . "<br>\n"; - echo "<h3>Pré-décrémentation</h3>"; + echo "Devrait valoir 5: " . $a-- . "<br>\n"; + echo "Devrait valoir 4: " . $a . "<br>\n"; + echo "<h3>Pré-décrémentation</h3>"; $a = 5; - echo "Devrait valoir 4: " . --$a . "<br>\n"; - echo "Devrait valoir 4: " . $a . "<br>\n"; + echo "Devrait valoir 4: " . --$a . "<br>\n"; + echo "Devrait valoir 4: " . $a . "<br>\n"; ?> ]]> </programlisting> @@ -602,8 +611,8 @@ est l'opérateur de concaténation ('.'), qui retourne la concaténation de ses deux arguments. Le second est l'opérateur d'assignation - concaténant ('.='). Reportez-vous à - <link linkend="language.operators.assignment">Opérateurs d'assignations</link> + concaténant (<literal>.=</literal>). Reportez-vous à + <link linkend="language.operators.assignment">opérateurs d'assignement</link> pour plus de détails. </simpara> <para> @@ -621,6 +630,43 @@ ]]> </programlisting> </informalexample> + </para> + </sect1> + <sect1 id="language.operators.array"> + <title>Opérateurs de tableaux</title> + <simpara> + Le seul opérateur en &php; pour les tableaux est l'opérateur + <literal>+</literal>. Cet opérateur ajoute le tableau de + droite au tableau de gauche. Les clés communes sont laissées + inchangées. + </simpara> + <para> + <example> + <title>Addition de tableaux</title> + <programlisting role="php"> +<![CDATA[ +$a = array("a" => "pomme", "b" => "banane"); +$b = array("a" =>"poire", "b" => "fraise", "c" => "cerise"); + +$c = $a + $b; + +var_dump($c); +]]> + </programlisting> + <screen role="php"> +<![CDATA[ +array(3) { + ["a"]=> + string(5) "pomme" + ["b"]=> + string(6) "banane" + ["c"]=> + string(6) "cerise" +} + +]]> + </screen> + </example> </para> </sect1> </chapter> Index: phpdoc-fr/language/references.xml diff -u phpdoc-fr/language/references.xml:1.8 phpdoc-fr/language/references.xml:1.9 --- phpdoc-fr/language/references.xml:1.8 Wed Dec 12 15:50:08 2001 +++ phpdoc-fr/language/references.xml Mon Feb 3 07:27:11 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <chapter id="language.references"> <title>Les références</title> <sect1 id="language.references.whatare"> @@ -26,9 +26,11 @@ vous faites : <informalexample> <programlisting role="php"> -<?php -$a =& $b -?> +<![CDATA[ +<?php +$a =& $b +?> +]]> </programlisting> </informalexample> cela signifie que <varname>$a</varname> et <varname>$b</varname> @@ -46,10 +48,12 @@ <literal>new</literal> (PHP 4.0.4 et plus récent): <informalexample> <programlisting role="php"> -<?php - $bar =& new fooclass(); - $foo =& find_var ($bar); -?> +<![CDATA[ +<?php + $bar =& new fooclass(); + $foo =& find_var ($bar); +?> +]]> </programlisting> </informalexample> </para> @@ -70,13 +74,15 @@ le contenu des variables de fonction. Exemple : <informalexample> <programlisting role="php"> -<?php - function foo(&$var) { +<![CDATA[ +<?php + function foo(&$var) { $var++; } $a=5; foo($a); -?> +?> +]]> </programlisting> </informalexample> <varname>$a</varname> vaut 6. Cela provient du fait que dans la fonction @@ -100,12 +106,14 @@ ce à quoi on peut s'attendre : <informalexample> <programlisting role="php"> -<?php - function foo(&$var) { - $var =& $GLOBALS["baz"]; +<![CDATA[ +<?php + function foo(&$var) { + $var =& $GLOBALS["baz"]; } foo($bar); -?> +?> +]]> </programlisting> </informalexample> </para> @@ -129,14 +137,16 @@ syntaxe est la suivante : <informalexample> <programlisting role="php"> -<?php - function foo(&$var) { +<![CDATA[ +<?php + function foo(&$var) { $var++; } $a=5; foo ($a); // $a vaut 6 maintenant -?> +?> +]]> </programlisting> </informalexample> Notez qu'il n'y a pas de signe de référence dans l'appel de la @@ -163,13 +173,15 @@ Une référence, retournée par une fonction : <informalexample> <programlisting role="php"> -<?php - function &bar() { +<![CDATA[ +<?php + function &bar() { $a = 5; return $a; } foo(bar()); -?> +?> +]]> </programlisting> </informalexample> Voir aussi des détails dans @@ -185,8 +197,9 @@ exemple, les passages par référence suivants sont invalides : <informalexample> <programlisting role="php"> -<?php - function bar() // Notez l'absence de & +<![CDATA[ +<?php + function bar() // Notez l'absence de & { $a = 5; return $a; @@ -194,7 +207,8 @@ foo(bar); foo($a = 5) // Expression, pas une variable foo(5) // Constante, pas une variable -?> +?> +]]> </programlisting> </informalexample> Ces fonctionnalités sont valables à partir de PHP 4.0.4. @@ -209,14 +223,16 @@ utilisez le code suivant <informalexample> <programlisting role="php"> -<?php - function &find_var($param) { +<![CDATA[ +<?php + function &find_var($param) { // ...code... return $found_var; } - $foo =& find_var ($bar); - $foo->x = 2; -?> + $foo =& find_var ($bar); + $foo->x = 2; +?> +]]> </programlisting> </informalexample> Dans cet exemple, la propriété de l'objet est retournée @@ -242,11 +258,13 @@ Cela ne signifie pas que le contenu est détruit. Par exemple, <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = 1; -$b =& $a; +$b =& $a; unset ($a); -?> +?> +]]> </programlisting> </informalexample> Cet exemple ne détruira pas <varname>$b</varname>, mais juste @@ -275,9 +293,11 @@ globale. Ce qui signifie que <informalexample> <programlisting role="php"> -<?php -$var =& $GLOBALS["var"]; -?> +<![CDATA[ +<?php +$var =& $GLOBALS["var"]; +?> +]]> </programlisting> </informalexample> </para> Index: phpdoc-fr/language/types.xml diff -u phpdoc-fr/language/types.xml:1.19 phpdoc-fr/language/types.xml:1.20 --- phpdoc-fr/language/types.xml:1.19 Tue Aug 13 22:19:28 2002 +++ phpdoc-fr/language/types.xml Mon Feb 3 07:27:11 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.19 $ --> +<!-- $Revision: 1.20 $ --> <chapter id="language.types"> <title>Les types</title> <sect1 id="language.types.intro"> @@ -104,46 +104,52 @@ <title>Booléens</title> <simpara> C'est le type le plus simple. Un booléen exprime les valeurs - de vrai &true; ou <literal>FALSE</literal>. + de vrai &true; ou &false;. </simpara> - <para> + <sect2 id="language.types.boolean.syntax"> + <title>Syntaxe</title> + <para> Vous pouvez utiliser les constantes '&true;' et - '<literal>FALSE</literal>' pour spécifier une valeur de type - <type>boolean</type>. Généralement, vous les créerez - avec un des <link linkend="language.operators">operateurs</link> + '&false;' pour spécifier une valeur de type + <type>boolean</type>. Ces constantes sont insensibles + à la casse. + <informalexample> + <programlisting role="php"> +<![CDATA[ +$foo = True; // assign the value TRUE to $foo +]]> + </programlisting> + </informalexample> + </para> + <para> + Généralement, vous les créerez + avec un des <link linkend="language.operators">opérateurs</link> qui retourne une valeur <type>boolean</type>, pour le passer - à une <link linkend="control-structures">structure de - contrôle</link>. + à une <link linkend="control-structures">structure de contrôle</link>. <informalexample> <programlisting role="php"> -<?php - if ($action == "show_version"){ -// == is an <link linkend="language.operators">operator</link> +<![CDATA[ +// == est un opérateur d'égalité // qui retourne un booléen - echo "La version est 1.23"; - } -// ceci n'est pas nécessaire - if ($show_separators == true){ - echo "<hr>\n"; - } -// ceci est plus pratique - if ($show_separators){ - echo "<hr>\n"; - } -?> +if ($action == "show_version") { + echo "La version est la 1.23"; +} + +// Ceci n'est pas nécessaire +if ($show_separators == TRUE) { + echo "<hr>\n"; +} + +// car vous pouvez simplement utiliser +if ($show_separators) { + echo "<hr>\n"; +} +]]> </programlisting> </informalexample> - </para> - <!-- TODO: example of this --> - <!-- TODO: example to show that if ( expr == TRUE ) is not really - necessary... (i've seen this construct numerous times) - --> - <!-- TODO: how others vars are converted to boolean --> - <note> - <simpara> - Le type booéen a été introduit en PHP 4. - </simpara> - </note> + </para> + </sect2> + <sect2 id="language.types.boolean.casting"> <title>Conversion en booléen</title> <simpara> @@ -153,7 +159,7 @@ </simpara> <para> Lors des conversions de valeurs de type <type>boolean</type>, les valeurs - suivantes sont considérées comme fausse (<literal>FALSE</literal>) : + suivantes sont considérées comme fausse (&false;) : <itemizedlist> <listitem> <simpara> @@ -216,33 +222,55 @@ éventuellement précédé du signe moins (<literal>-</literal>). </para> - <para> + <sect2 id="language.types.integer.syntax"> + <title>Syntax</title> + <simpara> + Les entiers peuvent être spécifié en base décimale (dite aussi + base 10), en héxadecimal (base 16) ou en octale (base 8). + Les entiers peuvent être optionnellement précédés par le signe + plus ou moins (- or +). + </simpara> + <para> Pour utiliser la notation octale, vous devez préfixer le nombre avec un zéro; pour utiliser la notation hexadécimale, vous devez préfixer le nombre avec <literal>0x</literal>. - <informalexample> - <programlisting role="php"> -<?php - $a = 1234; # nombre entier en base 10 - $a = -123; # nombre entier négatif - $a = 0123; # nombre entier en base 8, octale (équivalent à 83 en base 10) - $a = 0x12; # nombre entier en base 16, hexadécimale - # (équivalent à 18 en base 10) -?> - </programlisting> - </informalexample> - La taille des entiers dépend de la plate-forme de support, mais + <example> + <title>Integer literals</title> + <programlisting role="php"> +<![CDATA[ +$a = 1234; // nombre entier en base 10 +$a = -123; // nombre entier négatif +$a = 0123; // nombre entier en base 8, octale (équivalent à 83 en base 10) +$a = 0x1A; // nombre entier en base 16, hexadécimale + // (équivalent à 26 en base 10) +]]> + </programlisting> + </example> + Techniquement, la structure d'un entier suit les règles suivantes : + <example> + <title>Structure d'un entier</title> + <programlisting> +<![CDATA[ +decimal : [1-9][0-9]* + | 0 + +hexadecimal : 0[xX][0-9a-fA-F]+ + +octal : 0[0-7]+ + +integer : [+-]?decimal + | [+-]?hexadecimal + | [+-]?octal +]]> + </programlisting> + </example> + La taille des entiers dépend de la plate-forme de support, mais la valeur maximale est généralement de 2 milliards et des poussières (c'est un entier signé de 32 bits). PHP ne supporte pas les entiers non signés. - </para> - <note> - <simpara> - En PHP, il n'existe pas de type fraction. - <literal>1/2</literal> se transforme en nombre à virgule - flottante <literal>0.5</literal>. - </simpara> - </note> + </para> + </sect2> + <sect2 id="language.types.integer.overflow"> <title>Dépassement de capacité des entiers</title> <para> @@ -250,7 +278,8 @@ des entiers, il sera interprété comme un <type>float</type>. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $large_number = 2147483647; var_dump($large_number); // affiche : int(2147483647) @@ -260,7 +289,8 @@ var_dump( 25/7 ); // affiche : float(3.5714285714286) -?> +?> +]]> </programlisting> </informalexample> De même, si une fonction ou un opérateur retourne un entier qui @@ -268,12 +298,14 @@ automatiquement converti en <type>float</type>. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $million = 1000000; $large_number = 50000 * $million; var_dump($large_number); // affiche : float(50000000000) -?> +?> +]]> </programlisting> </informalexample> </para> @@ -298,7 +330,7 @@ <sect2 id="language.types.integer.casting"> <title>Conversion en entiers</title> <simpara> - Pour explicitement convertir une valeur en <type>integer</type>, + Pour explicitement convertir une valeur en &integer;, utilisez les opérateurs de transtypage <literal>(int)</literal> ou <literal>(integer)</literal>. Cependant, dans la plupart des situations, vous n'en aurez pas besoin, car une valeur sera @@ -352,14 +384,16 @@ peut conduire à des résultats irrationnels. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo (int) ( (0.1+0.7) * 10 ); // affiche 7! -?> +?> +]]> </programlisting> </informalexample> Pour plus d'informations, reportez-vous aux - <link linkend="language.types.float">alertes</link> liées + <link linkend="warn.float-precision">alertes</link> liées aux nombres à virgule flottante. </para> </warning> @@ -408,14 +442,16 @@ spécifiés en utilisant la syntaxe suivante: <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = 1.234; $a = 1.2e3; -?> +?> +]]> </programlisting> </informalexample> </para> - <warning> + <warning id="warn.float-precision"> <title>Précision des nombres à virgule flottante</title> <para> Il est fréquent que de simples fractions décimales telles que @@ -442,6 +478,18 @@ librairies <link linkend="ref.bc">BC</link> ou <link linkend="ref.gmp">GMP</link>. </para> </warning> + <sect2 id="language.types.float.casting"> + <title>Conversion d'un nombre à virgule flottante</title> + + <para> + Pour savoir quand et comment des chaînes sont converties en + nombre à virgule flottante, voyez la section + <link linkend="language.types.string.conversion">Conversion de chaînes de caractères</link>. + Pour les valeurs d'autres types, la conversion est la même + que si la valeur était d'abord convertie en entier, puis en + nombre décimal. Voyez la section <link linkend="language.types.integer.casting">Conversion d'un entier</link>. + </para> + </sect2> </sect1> <sect1 id="language.types.string"> <title>Les chaînes de caractères</title> @@ -511,7 +559,8 @@ </note> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo 'Ceci est une chaîne simple'; echo 'Vous pouvez inclure des nouvelles lignes dans une chaîne, comme ceci.'; @@ -523,7 +572,8 @@ // affiche : Etes vous sûr de vouloir effacer le dossier C:\*.*? echo 'Je suis en train de mettre une nouvelle ligne comme ceci : \n'; // affiche : Je suis en train de mettre une nouvelle ligne comme ceci : \n -?> +?> +]]> </programlisting> </informalexample> </para> @@ -649,8 +699,9 @@ <example> <title>Exemple de chaîne HereDoc</title> <programlisting role="php"> -<?php - $str = <<<EOD +<![CDATA[ +<?php + $str = <<<EOD Exemple de chaîne s'étalant sur plusieurs lignes @@ -661,18 +712,19 @@ var $foo; var $bar; function foo() { - $this->foo = 'Foo'; - $this->bar = array('Bar1', 'Bar2', 'Bar3'); + $this->foo = 'Foo'; + $this->bar = array('Bar1', 'Bar2', 'Bar3'); } } $foo = new foo(); $name = 'MonNom'; - echo <<<EOT + echo <<<EOT Mon nom est "$name". J'affiche des $foo->foo. - Maintenant, j'affiche un {$foo->bar[1]}. + Maintenant, j'affiche un {$foo->bar[1]}. Ceci se traduit par un 'A' majuscule: \x41 EOT; -?> +?> +]]> </programlisting> </example> </para> @@ -712,19 +764,22 @@ variable valide. Entourez le nom de la variable avec des accolades pour indiquer explicitement son nom. </simpara> - <informalexample> + <example> + <title>Utilisation des accolades {} dans les chaînes</title> <programlisting role="php"> -<?php + <![CDATA[ +<?php $boisson = 'vin'; echo "Du $boisson, du pain et du fromage!'; // OK, car "," n'est pas autorisé dans les noms de variables - echo "Il a goûté plusieurs $vins"; + echo "Il a goûté plusieurs $boisson"; // Pas OK, car 's' peut entrer dans un nom de variable, et PHP recherche $boissons - echo "Il a goûté plusieurs ${vin}s"; + echo "Il a goûté plusieurs ${boisson}s"; // OK -?> +?> +]]> </programlisting> - </informalexample> + </example> <simpara> Similairement, vous pouvez aussi utiliser un élément de tableau, ou un membre d'objet. Pour les éléments @@ -740,25 +795,24 @@ paying them enough or something?). --> </simpara> - <informalexample> + <example> + <title>Utilisation des accolades {} dans les chaînes pour les tableaux</title> <programlisting role="php"> + <![CDATA[ +<?php $fruits = array( 'fraise' => 'rouge' , 'banane' => 'jaune' ); echo "Une banane est $fruits[banane]."; // OK. Notez toutefois que pour cet exemple, cela fonctionne - // différemment. Voyez <link linkend="language.types.array.foo-bar"><literal>$foo[bar]</literal> hors des chaînes</link> - echo "Ce carré est large de $carre->largeur mètres."; + // différemment. Voyez <literal>$foo[bar]</literal> hors des chaînes + echo "Ce carré est large de $carre->largeur mètres."; // OK - echo "Ce carré est large de $carre->largeur00 mètres.."; + echo "Ce carré est large de $carre->largeur00 mètres.."; // pas OK - // pour résoudre ce problème, voyez <link linkend="language.types.string.parsing.complex">syntaxe complexe</link>. - <!-- XXX this won't work: - echo "This square is $square->{width}00 centimeters broad."; - // XXX: php developers: it would be consequent to make this work. - // XXX: like the $obj->{expr} syntax outside a string works, - // XXX: analogously to the ${expr} syntax for variable var's. - --> + // pour résoudre ce problème, voyez la syntaxe complexe. +?> +]]> </programlisting> - </informalexample> + </example> <simpara> Pour tout ce qui sera plus compliqué, voyez la syntaxe complexe. </simpara> @@ -783,7 +837,8 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $super = 'fantastique'; echo "C'est { $super}"; // ne fonctionne pas, @@ -791,13 +846,13 @@ echo "C'est {$super}"; // fonctionne, // affiche "C'est fantastique" - echo "Ce carré a {$square->width}00 centimètres de large."; + echo "Ce carré a {$square->width}00 centimètres de large."; echo "Ceci fonctionne : {$tableau[4][3]}"; echo "Ceci échoue : {$tableau[foo][3]}"; // pour la même raison que $tableau[bar] ne fonctionne pas hors d'une chaîne <!-- XXX see the still-to-write explaination in the arrays-section. --> echo "Essayez plutôt comme ceci : {$tableau['foo'][3]}"; - echo "Vous pouvez même écrire {$objet->valeurs[3]->nom}"; + echo "Vous pouvez même écrire {$objet->valeurs[3]->nom}"; echo "Voici la valeur de la variable nommée $name: {${$name}}"; <!-- <xxx> maybe it's better to leave this out?? --> // cela fonctionne, mais c'est vivement déconseillé. @@ -805,7 +860,8 @@ $inv = 'Bordeaux'; echo "Je reprendrai bien un verre de cet excellent {${ strrev('niv') }}, hips"; <!-- </xxx> --> -?> +?> +]]> </programlisting> </informalexample> </sect4> @@ -831,26 +887,28 @@ <!-- TODO: either move these examples to a example section, as with arrays, or distribute them under the applicable sections. --> -<?php +<![CDATA[ +<?php /* Affectation d'une chaîne. */ $str = "Ceci est une chaîne"; /* Concaténation. */ $str = $str . " avec un peu plus de texte"; /* Une autre méthode de concaténation. */ $str .= " et une nouvelle ligne à la fin.\n"; -/* Cette chaîne finira comme : '<p>Nombre: 9</p>' */ +/* Cette chaîne finira comme : '<p>Nombre: 9</p>' */ $num = 9; - $str = "<p>Nombre: $num</p>"; -/* Celle-ci sera '<p>Nombre: $num</p>' */ + $str = "<p>Nombre: $num</p>"; +/* Celle-ci sera '<p>Nombre: $num</p>' */ $num = 9; - $str = '<p>Nombre: $num</p>'; + $str = '<p>Nombre: $num</p>'; /* Premier caractère d'une chaîne */ $str = 'Ceci est un test.'; $first = $str{0}; /* Dernier caractère d'une chaîne. */ $str = 'This is still a test.'; $last = $str{strlen($str)-1}; -?> +?> +]]> </programlisting> </example> </para> @@ -884,8 +942,71 @@ fonctions de <link linkend="ref.ctype">types de caractères</link>. </simpara> </sect2> + <sect2 id="language.types.string.casting"> + <title>Conversion de chaîne de caractères</title> + + <para> + Vous pouvez convertir une valeur en chaîne en utilisant l'opérateur + <literal>(string)</literal>, ou bien la fonction <function>strval</function>. + La conversion en chaîne de caractères est automatiquement faite dans + toutes les situations qui nécessitent une chaîne de caractères. + Cela arrive lorsque vous utilisez des fonctions comme <function>echo</function> + ou <function>print</function>, ou encore lorsque vous comparez une valeur + avec une chaîne de caractères. + </para> + + <para> + Le booléen &true; est converti en la chaîne de caractères <literal>"1"</literal>, + et le booléen &false; est représenté par la chaîne de caractères vide + <literal>""</literal>. De cette façon, vous pouvez convertir des + booléens en chaîne de caractères et vice-versa. + </para> + <para> + Un entier ou un nombre à virgule flottante est converti en une + chaîne de caractères qui représente ce nombre en décimal (y compris + l'exposant des nombres à virgule flottante). + </para> + <para> + Les tableaux sont toujours convertis en la chaîne de caractères <literal>"Array"</literal>, + ce qui fait que vous ne pouvez pas afficher le contenu d'un tableau avec la fonction + <function>echo</function> ou <function>print</function>. Voyez + les informations ci-dessous pour plus de conseils. + </para> + <para> + Les objets sont automatiquement convertis en la chaîne de caractères + <literal>"Object"</literal>. Si vous souhaitez afficher le membre + d'un objet, lisez le paragraphe ci-dessous. Si vous voulez connaitre + le nom de la classe de cet objet, utilisez la fonction + <function>get_class</function>. + </para> + <para> + Les ressources sont toujours converties en chaîne de caractères + <literal>"Resource id #1"</literal> où <literal>1</literal> est + le nombre unique représentant la ressource, assigné par &php; au moment + de l'exécution. Si vous souhaitez connaître le type d'une ressource, + utilisez <function>get_resource_type</function>. + </para> + <para> + &null; est toujours converti en une chaîne de caractères vide. + </para> + + <para> + Comme vous pouvez le voir, afficher des tableaux, des objets ou des ressources + n'est pas pertinent par cette méthode. Reportez-vous aux fonctions + <function>print_r</function> et <function>var_dump</function> pour + avoir des outils plus pratiques. + </para> + + <para> + Vous pouvez aussi convertir des valeurs &php; en chaînes pour les + sauver dans un stockage. Cette méthode est appelée la linéarisation, + et peut être exploitée avec la fonction <function>serialize</function>. + Vous pouvez aussi linéariser des valeurs &php; en structure + XML si vous avez le support <link linkend="ref.wddx">WDDX</link>. + </para> + </sect2> <sect2 id="language.types.string.conversion"> - <title>Conversion de type</title> + <title>Conversion de chaînes de caractères</title> <simpara> Lorsqu'une chaîne de caractère est évaluée comme une valeur numérique, @@ -911,16 +1032,18 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $foo = 1 + "10.5"; // $foo est du type float (11.5) $foo = 1 + "-1.3e3"; // $foo est du type float (-1299) $foo = 1 + "bob-1.3e3"; // $foo est du type integer (1) $foo = 1 + "bob3"; // $foo est du type integer (1) - $foo = 1 + "10 Small Pigs"; // $foo est du type integer (11) - $foo = 1 + "10 Little Piggies"; // $foo est du type integer (11) - $foo = "10.0 pigs " + 1; // $foo est du type integer (11) - $foo = "10.0 pigs " + 1.0; // $foo est du type float (11) -?> + $foo = 1 + "10 petits cochons"; // $foo est du type integer (11) + $foo = 1 + "10 gros cochons"; // $foo est du type integer (11) + $foo = "10.0 cochons " + 1; // $foo est du type integer (11) + $foo = "10.0 cochons " + 1.0; // $foo est du type float (11) +?> +]]> </programlisting> </informalexample> <simpara> @@ -933,9 +1056,11 @@ pour voir comment il se comporte. <informalexample> <programlisting role="php"> -<?php - echo "\$foo==$foo; type is " . gettype( $foo ) . "<br>\n"; -?> +<![CDATA[ +<?php + echo "\$foo==$foo; type is " . gettype( $foo ) . "<br>\n"; +?> +]]> </programlisting> </informalexample> </para> @@ -966,7 +1091,7 @@ <para> Un tableau <type>array</type> peut être créé avec la fonction <function>array</function>. Cette fonction prend en argument - des structures <literal><replaceable>key</replaceable> => + des structures <literal><replaceable>key</replaceable> => <replaceable>value</replaceable></literal>, séparées par des virgules. </para> <para> @@ -991,9 +1116,17 @@ </para> <para> Une valeur peut être n'importe quoi. + <example> + <title>Création d'un tableau</title> + <programlisting role="php"> +<![CDATA[ +<?php + array("somearray" => array(6 => 5, 13 => 9, "a" => 43)); +?> +]]> + </programlisting> + </example> </para> - <sect4 id="language.types.array.omit-key"> - <title>Omettre des clés</title> <para> Si vous omettez une clé lors de la spécification d'un tableau, l'indice maximum + 1 sera utilisé comme clé par défaut. Si aucun @@ -1003,7 +1136,7 @@ </para> <para> <synopsis> -array( <optional><replaceable>key</replaceable> => </optional> +array( <optional><replaceable>key</replaceable> => </optional> <replaceable>value</replaceable> , ... ) @@ -1012,7 +1145,6 @@ // <replaceable>value</replaceable> peut être n'importe quoi </synopsis> </para> - </sect4> </sect3> <sect3 id="language.types.array.syntax.modifying"> <title>La syntaxe à crochets</title> @@ -1049,6 +1181,130 @@ revue simplement les valeurs d'un tableau. </para> </sect2> + <sect2 id="language.types.array.donts"> + <title>Attention aux tableaux</title> + <sect3 id="language.types.array.foo-bar"> + <title>Pourquoi est ce que <literal>$foo[bar]</literal> est invalide?</title> + <para> + Dans vos vieux scripts, vous pouvez avoir utilisé la syntaxe suivante : + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + $foo[bar] = 'ennemi'; + echo $foo[bar]; +?> +]]> + </programlisting> + </informalexample> + Cela est mauvais, mais ca marche. Pourquoi est-ce mauvais? La raison + est que PHP réclame une expression entre les crochets (comme + indiqué dans la section sur la + <link linkend="language.types.array.syntax">syntaxe</link> des tableaux). + Cela signifie que vous pouvez écrire quelque chose comme : + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + echo $arr[ foo(true) ]; +?> +]]> + </programlisting> + </informalexample> + Ceci est un exemple d'utilisation de retour de fonction dans un + index de tableau. PHP reconnait aussi les constantes, et vous + pouvez avoir déjà rencontré <literal>E_*</literal>. + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + $error_descriptions[E_ERROR] = "Une erreur fatale est survenue"; + $error_descriptions[E_WARNING] = "PHP a généré une alerte"; + $error_descriptions[E_NOTICE] = "Ceci est juste une note grâcieuse"; +?> +]]> + </programlisting> + </informalexample> + Notez que <literal>E_ERROR</literal> est aussi un identifiant + vlaide, tout comme <literal>bar</literal> dans le premier exemple. + Mais le dernier exemple revient à écrire : + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + $error_descriptions[1] = "Une erreur fatale est survenue"; + $error_descriptions[2] = "PHP a généré une alerte"; + $error_descriptions[8] = "Ceci est juste une note grâcieuse"; +?> +]]> + </programlisting> + </informalexample> + car <literal>E_ERROR</literal> égale <literal>1</literal>, etc. + </para> + <para> + Alors, comment se fait-t-il que <literal>$foo[bar]</literal> fonctionne? + C'est parce que <literal>bar</literal> est considéré comme une + constante. Cependant, dans ce cas, aucune constante n'a pour nom + <literal>bar</literal>. PHP suppose alors que vous voulez dire + <literal>bar</literal> littéralement, c'est-à-dire la + chaîne <literal>"bar"</literal>, mais que vous avez oublié les + guillements. + </para> + <para> + Dans le futur, l'équipe de développement peut vouloir ajouter une + nouvelle constante et vous vous retrouverez dans la panade. Par + exemple, vous ne pouvez déjà pas utiliser les constantes + <literal>empty</literal> et <literal>default</literal>, car ce + sont des mots reservés. + <!-- <jeroen>hmm... i'm doubting this myself. Finish it if you like</jeroen> + But probably + the most threatening + thing is yourself, or whoever will maintain the script. You'll + maybe get very strange behaviour, and + --> + </para> + <para> + Et, pour en mettre une autre couche, cette syntaxe est tout simplement + obsolète, et risque de ne plus fonctionner du tout un jour ou l'autre. + </para> + <note> + <simpara> + Lorsque vous activez le rapport d'erreur avec <function>error_reporting</function> + avec <literal>E_ALL</literal>, PHP générera des notes à chaque fois que cette + syntaxe est utilisée. Essayez donc <literal>error_reporting(E_ALL);</literal> + dans vos scripts, pour voir). + </simpara> + </note> + <note> + <simpara> + Dans une chaîne à guillements doubles, une autre syntaxe est + valide. Voyez la section sur + <link linkend="language.types.string.parsing">Traitement des variables + dans les chaînes</link> pour plus de détails. + </simpara> + </note> + </sect3> + </sect2> + <sect2 id="language.types.array.casting"> + <title>Conversion en tableau</title> + + <para> + Pour les types scalaires (integer, float, string, boolean et resource), + convertir une valeur en tableau retourne un tableau qui contient un + élément (à l'index 0) qui est la valeur originale. + </para> + + <para> + Si vous convertissez un tableau en objet, vous obtiendrez des propriétés + ou bien cet objet comme élements de tableau. Les clés créées sont les + noms des membres. + </para> + + <para> + Si vous convertissez la valeur &null; en tableau, vous obtiendrez un + taleau vide. + </para> + </sect2> <sect2 id="language.types.array.examples"> <title>Exemples</title> <para> @@ -1057,7 +1313,8 @@ <para> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php // ceci $a = array( 'couleur' => 'rouge' , 'gout' => 'sucre' @@ -1076,19 +1333,21 @@ $b[] = 'c'; // va créer le tableau array( 0 => 'a' , 1 => 'b' , 2 => 'c' ) // ou plus simplement array('a' , 'b' , 'c' ) -?< +?> +]]> </programlisting> </informalexample> </para> <example> <title>Utilisation de <function>array</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php // Array comme correspondance - $map = array( 'version' => 4 - , 'OS' => 'Linux' - , 'langue' => 'français' - , 'short_tags' => TRUE ); + $map = array( 'version' => 4 + , 'OS' => 'Linux' + , 'langue' => 'français' + , 'short_tags' => TRUE ); // valeur strictement numériques $array = array( 7 , 8 @@ -1096,15 +1355,15 @@ , 156 , -10 ); -// ceci est la même chose que array( 0 => 7, 1 => 8, ...) +// ceci est la même chose que array( 0 => 7, 1 => 8, ...) $switching = array( 10 // clé = 0 - , 5 => 6 - , 3 => 7 - , 'a' => 4 + , 5 => 6 + , 3 => 7 + , 'a' => 4 , 11 // clé = 6 (index maximum : 5) - , '8' => 2 // clé = 8 (entier!) - , '02' => 77 // clé = '02' - , 0 => 12 // la valeur de la clé 10 sera remplacée par 12 + , '8' => 2 // clé = 8 (entier!) + , '02' => 77 // clé = '02' + , 0 => 12 // la valeur de la clé 10 sera remplacée par 12 ); <!-- TODO example of - mixed keys @@ -1115,13 +1374,15 @@ --> // empty array $empty = array(); -?< +?> +]]> </programlisting> </example> <example id="language.types.array.examples.loop"> <title>Collection</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $couleurs = array('rouge','bleu','vert','jaune'); foreach ( $couleurs as $couleur ){ echo "Aimez-vous la couleur $couleur?\n"; @@ -1132,7 +1393,8 @@ Aimez-vous la couleur vert? Aimez-vous la couleur jaune? */ -?> +?> +]]> </programlisting> </example> <para> @@ -1147,7 +1409,8 @@ <example id="language.types.array.examples.changeloop"> <title>Collection</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php foreach( $couleurs as $cle => $couleur ){ // ne marche pas //$couleur = strtoupper($couleur); @@ -1164,7 +1427,8 @@ [3] => JAUNE ) */ -?> +?> +]]> </programlisting> </example> </para> @@ -1173,7 +1437,8 @@ <example> <title>Tableau en 1</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $firstquarter = array(1 => 'Janvier', 'Février', 'Mars'); print_r($firstquarter); /* Affiche: @@ -1184,21 +1449,24 @@ [3] => 'Mars' ) */ -?> +?> +]]> </programlisting> </example> </para> <example> <title>Remplissage d'un tableau</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php // remplis un tableau avec les noms de fichiers d'un dossier $handle = opendir('.'); while ( $file = readdir($handle) ){ $files[] = $file; } closedir($handle); -?> +?> +]]> </programlisting> </example> <para> @@ -1209,10 +1477,12 @@ <example> <title>Tri de tableaux</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php sort($files); print_r($files); -?> +?> +]]> </programlisting> </example> <para> @@ -1223,20 +1493,21 @@ <example> <title>Tableaux multi-dimensionnels, et récursifs</title> <programlisting role="php"> -<?php - $fruits = array ( "fruits" => array ( "a" => "orange" - , "b" => "banane" - , "c" => "pomme" +<![CDATA[ +<?php + $fruits = array ( "fruits" => array ( "a" => "orange" + , "b" => "banane" + , "c" => "pomme" ) - , "nombres" => array ( 1 + , "nombres" => array ( 1 , 2 , 3 , 4 , 5 , 6 ) - , "trous" => array ( "premier" - , 5 => "second" + , "trous" => array ( "premier" + , 5 => "second" , "troisième" ) ); @@ -1259,294 +1530,11 @@ ) ); --> -?> +?> +]]> </programlisting> </example> </sect2> - <sect2 id="language.types.array.donts"> - <title>Attention aux tableaux</title> - <sect3 id="language.types.array.foo-bar"> - <title>Pourquoi est ce que <literal>$foo[bar]</literal> est invalide?</title> - <para> - Dans vos vieux scripts, vous pouvez avoir utilisé la syntaxe suivante : - <informalexample> - <programlisting role="php"> -<?php - $foo[bar] = 'ennemi'; - echo $foo[bar]; -?> - </programlisting> - </informalexample> - Cela est mauvais, mais ca marche. Pourquoi est-ce mauvais? La raison - est que PHP réclame une expression entre les crochets (comme - indiqué dans la section sur la - <link linkend="language.types.array.syntax">syntaxe</link> des tableaux). - Cela signifie que vous pouvez écrire quelque chose comme : - <informalexample> - <programlisting role="php"> -<?php - echo $arr[ foo(true) ]; -?> - </programlisting> - </informalexample> - Ceci est un exemple d'utilisation de retour de fonction dans un - index de tableau. PHP reconnait aussi les constantes, et vous - pouvez avoir déjà rencontré <literal>E_*</literal>. - <informalexample> - <programlisting role="php"> -<?php - $error_descriptions[E_ERROR] = "Une erreur fatale est survenue"; - $error_descriptions[E_WARNING] = "PHP a généré une alerte"; - $error_descriptions[E_NOTICE] = "Ceci est juste une note grâcieuse"; -?> - </programlisting> - </informalexample> - Notez que <literal>E_ERROR</literal> est aussi un identifiant - vlaide, tout comme <literal>bar</literal> dans le premier exemple. - Mais le dernier exemple revient à écrire : - <informalexample> - <programlisting role="php"> -<?php - $error_descriptions[1] = "Une erreur fatale est survenue"; - $error_descriptions[2] = "PHP a généré une alerte"; - $error_descriptions[8] = "Ceci est juste une note grâcieuse"; -?> - </programlisting> - </informalexample> - car <literal>E_ERROR</literal> égale <literal>1</literal>, etc. - </para> - <para> - Alors, comment se fait-tile que <literal>$foo[bar]</literal> fonctionne? - C'est parce que <literal>bar</literal> est attendu comme une - constante. Cependant, dans ce cas, aucune constante n'a pour nom - <literal>bar</literal>. PHP suppose alors que vous voulez dire - <literal>bar</literal> littéralement, c'est-à-dire la - chaîne <literal>"bar"</literal>, mais que vous avez oublié les - guillements. - </para> - <sect4 id="language.types.array.foo-bar.why"> - <title>Alors, pourquoi est-ce mal?</title> - <para> - Dans le futur, l'équipe de développement peut vouloir ajouter une - nouvelle constante et vous vous retrouverez dans la panade. Par - exemple, vous ne pouvez déjà pas utiliser les constantes - <literal>empty</literal> et <literal>default</literal>, car ce - sont des mots reservés. - <!-- <jeroen>hmm... i'm doubting this myself. Finish it if you like</jeroen> - But probably - the most threatening - thing is yourself, or whoever will maintain the script. You'll - maybe get very strange behaviour, and - --> - </para> - <para> - Et, pour en mettre une autre couche, cette syntaxe est tout simplement - obsolète, et risque de ne plus fonctionner du tout un jour ou l'autre. - </para> - <note> - <simpara> - Lorsque vous activez le rapport d'erreur avec <function>error_reporting</function> - avec <literal>E_ALL</literal>, PHP générera des notes à chaque fois que cette - syntaxe est utilisée. Essayez donc <literal>error_reporting(E_ALL);</literal> - dans vos scripts, pour voir). - </simpara> - </note> - <note> - <simpara> - Dans une chaîne à guillements doubles, une autre syntaxe est - valide. Voyez la section sur - <link linkend="language.types.string.parsing">Traitement des variables - dans les chaînes</link> pour plus de détails. - </simpara> - </note> - </sect4> - </sect3> - </sect2> - <!-- TODO - - example multi-dim with $arr[bla][bla] syntax - - converting to array - - warning about references - - note that assigning is copy (usually...) - --> -<!-- there is no such thing as multi/singel dim arrays (at least in PHP4) - <sect2 id="language.types.array.single-dim"> - <title>Single Dimension Arrays</title> - <para> - PHP supports both scalar and associative arrays. In fact, there - is no difference between the two. You can create an array using -- the <function>list</function> or <function>array</function> - the - <function>list</function> - Nope - or <function>array</function> - functions, or you can explicitly set each array element value. - ++++++++++++++++++++++++++++++++++++++++++++ - <para> - Les tableaux ressemblent aux tableaux associatifs et - aux tableaux indexés (vecteurs).</para> - <sect2 id="language.types.array.single-dim"> - <title>Tableaux à une dimension</title> - <para> - PHP supporte les tableaux scalaires et les tableaux associatifs. - En fait, il n'y a aucune différence entre les deux. Vous - pouvez créer un tableau en utilisant les fonctions - <function>list</function> ou <function>array</function>, ou bien - en affectant explicitement chacune des valeurs. - <informalexample> - <programlisting role="php"> -<?php -$a[0] = "abc"; -$a[1] = "def"; -$b["foo"] = 13; -?> - </programlisting> - </informalexample> - </para> - <para> - Vous pouvez aussi créer un tableau en ajoutant - simplement les valeurs à ce tableau. - <informalexample> - <programlisting role="php"> -<?php -$a[] = "Bonjour"; // $a[2] == "Bonjour"; -$a[] = "Monde"; // $a[3] == "Monde"; -?> - </programlisting> - </informalexample> - </para> - <para> - Un tableau peut être trié en utilisant les fonctions - <function>asort</function>, - <function>arsort</function>, <function>ksort</function>, - <function>rsort</function>, <function>sort</function>, - <function>uasort</function>, <function>usort</function>, ou - <function>uksort</function> en fonction du type de classement que vous voulez. - </para> - <para> - Vous pouvez compter le nombre d'éléments qu'il y - a dans un tableau en utilisant la fonction <function>count</function>. - </para> - <para> - Vous pouvez-vous déplacer à l'intérieur d'un - tableau en utilisant les fonctions <function>next</function> et - <function>prev</function>. Un autre moyen de se déplacer - dans un tableau est d'utiliser la fonction <function>each</function>. - </para> - </sect2> - <sect2 id="language.types.array.multi-dim"> - <title>Tableaux à plusieurs dimensions</title> - <para> - Les tableaux à plusieurs dimensions sont extrêmement simples. - Pour chaque dimension du tableau, vous ajouter une nouvelle [clef] à - la fin: - <informalexample> - <programlisting role="php"> -<?php -$a[1] = $f; # tableau à une dimension -$a["foo"] = $f; -$a[1][0] = $f; # tableau à deux dimensions -$a["foo"][2] = $f; # vous pouvez mélanger les indices associatifs et numériques -$a[3]["bar"] = $f; # vous pouvez mélanger les indices associatifs et numériques -$a["foo"][4]["bar"][0] = $f; # tableau à quatre dimensions -?> - </programlisting> - </informalexample> - </para> - <para> - En PHP 3 il n'est pas possible de référencer un tableau - à l'intérieur d'une chaîne. Par exemple, ceci ne - fonctionne pas : - <informalexample> - <programlisting role="php"> -<?php -$a[3]['bar'] = 'Bob'; -echo "Cela ne marche pas : $a[3][bar]"; -?> - </programlisting> - </informalexample> - En PHP 3, l'exemple ci-dessus va afficher : - <computeroutput>Cela ne marche pas : Array[bar]</computeroutput>. - L'opérateur de concaténation, - peut être utilisé pour corriger cela : - <informalexample> - <programlisting role="php"> -<?php -$a[3]['bar'] = 'Bob'; -echo "Cela ne marche pas : " . $a[3][bar]; -?> - </programlisting> - </informalexample> - </para> - <para> - En PHP 4, cependant, le problème peut être contourné - en entourant le tableau par des accolades : - <informalexample> - <programlisting role="php"> -<?php -$a[3]['bar'] = 'Bob'; -echo "Cela marche : {$a[3][bar]}"; -?> - </programlisting> - </informalexample> - </para> - <para> - Vous pouvez remplir un tableau à plusieurs dimensions - par de nombreux moyens mais la méthode la plus simple - à comprendre est l'utilisation de la fonction - <function>array</function>. Les deux exemples suivants - montre comment remplir un tableau à une dimension: - <informalexample> - <programlisting role="php"> -<?php -# Exemple 1: -$a["couleur"] = "rouge"; -$a["saveur"] = "sucrée"; -$a["forme"] = "rond"; -$a["nom"] = "pomme"; -$a[3] = 4; -# Exemple 2: -$a = array( - "couleur" => "rouge", - "saveur" => "sucrée", - "forme" => "rond", - "nom" => "pomme", - 3 => 4 -); -?> - </programlisting> - </informalexample> - </para> - <para> - La fonction <function>array</function> peut être - emboîtée pour remplir un tableau à - plusieurs dimensions : - <informalexample> - <programlisting role="php"> -<?php -$a = array( - "pomme" => array( - "couleur" => "rouge", - "saveur" => "sucrée", - "forme" => "rond" - ), - "orange" => array( - "couleur" => "orange", - "saveur" => "amère", - "forme" => "rond" - ), - "banane" => array( - "couleur" => "jaune", - "saveur" => "paste-y", - "forme" => "bananoïde" - ) -); -echo $a["pomme"]["saveur"]; # va afficher "sucrée" -?> - </programlisting> - </informalexample> - </para>+ - </sect2> - --> </sect1> <sect1 id="language.types.object"> <title>Les objets</title> @@ -1557,15 +1545,38 @@ afin de créer linstance de l'objet. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php class foo { function faire_foo () { echo "Faisant foo."; } } $bar = new foo; - $bar->faire_foo(); -?> + $bar->faire_foo(); +?> +]]> + </programlisting> + </informalexample> + </para> + </sect2> + <sect2 id="language.types.object.casting"> + <title>Converting to object</title> + + <para> + Si un objet est converti en objet, il n'est pas modifié. Si une + valeur d'un autre type est convertie en objet, une nouvelle instance + de la classe <literal>stdClass</literal> sera créée. Si la valeur + était &null; la nouvelle instance sera vide. Pour les autres valeurs, + un membre de l'objet appelé <literal>scalar</literal> contiendra la valeur. + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + $obj = (object) 'au revoir'; + echo $obj->scalar; // affiche 'au revoir' +?> +]]> </programlisting> </informalexample> </para> @@ -1574,18 +1585,28 @@ <sect1 id="language.types.resource"> <title>Ressources</title> <para> - Une ressource (resource en anglais), est un type spécial, + Une ressource ("resource" en anglais), est un type spécial, qui représente une référence sur une ressource externe. Les ressources sont créées par des fonctions dédiées. Reportez - vous à l'annexe <link linkend="resources">ressource</link> + vous à l'annexe <link linkend="resource">Types des ressources PHP</link> pour une liste exhaustive des fonctions créant et utilisant ces ressources. </para> <note> <simpara> - Le type ressource a été introduit en PHP 4. + Le type de données "resource" a été introduit en PHP 4. </simpara> </note> + <sect2 id="language.types.resource.casting"> + <title>Conversion en ressource</title> + + <para> + Comme les ressources contiennent des valeurs très spéciales, + comme des fichiers ouverts, des connexions aux bases de données, + des images ou n'importe quoi d'autre, vous ne pouvez pas + convertir une valeur en ressource. + </para> + </sect2> <sect2 id="language.types.resource.self-destruct"> <title>Libérer des ressources</title> <para> @@ -1619,9 +1640,11 @@ <literal>NULL</literal>, insensible à la casse. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $var = Null; -?> +?> +]]> </programlisting> </informalexample> </para> @@ -1632,6 +1655,101 @@ </note> </sect2> </sect1> + <sect1 id="language.pseudo-types"> + <title>Pseudo-types used in this documentation</title> + + <sect2 id="language.types.mixed"> + <title>mixed</title> + <para> + <literal>mixed</literal> indique qu'un paramètre accepte + plusieurs types, mais pas forcément tous les types. + </para> + <para> + <function>gettype</function> par exemple, accepte tous les types de variables + &php;, mais <function>str_replace</function> n'accepte que des + &string; et des &array;. + </para> + </sect2> + + <sect2 id="language.types.number"> + <title>number</title> + <para> + <literal>number</literal> indique qu'un paramètre peut être du type + &integer; ou &float;. + </para> + </sect2> + + <sect2 id="language.types.callback"> + <title>callback</title> + <para> + Certaines fonctions comme par exemple <function>call_user_function</function> + ou <function>usort</function> accepte une fonction définie par + l'utilisateur comme fonction de callback. Les fonctions de + callback peuvent être des fonctions simples, mais aussi des + objets ou des méthodes statiques de classe. + </para> + <para> + Une fonction &php; est passée simplement en indiquant son nom, sous + forme de chaîne de caractères. Vous pouvez passer une fonction + intégrée au langage, ou une fonction définie par vos soins, à + l'exception de + <function>array</function>, + <function>echo</function>, + <function>empty</function>, + <function>eval</function>, + <function>exit</function>, + <function>isset</function>, + <function>list</function>, + <function>print</function> et + <function>unset</function>. + </para> + <para> + Une méthode d'un objet instancié est passée sous forme de &array;, + contenat un objet comme élément d'index 0, et un nom de méthode comme + élément 1. + </para> + <para> + Les méthodes statiques de classe peuvent aussi être passées dans l'objet + instancié, mais en passant le nom de la classe comme valeur de + l'index 0. + </para> + + <para> + <example> + <title> + Exemple de fonction de callback + </title> + <programlisting role="php"> +<![CDATA[ +<?php + +// simple callback example +function foobar() { + echo "hello world!"; +} +call_user_function("foobar"); + +// method callback examples +class foo { + function bar() { + echo "hello world!"; + } +} + +$foo = new foo; + +call_user_function(array($foo, "bar")); // object method call + +call_user_function(array("foo", "bar")); // static class method call + +?> +]]> + </programlisting> + </example> + </para> + </sect2> + </sect1> + <sect1 id="language.types.type-juggling"> <title>Définition du type</title> <simpara> @@ -1655,13 +1773,15 @@ sont évaluées. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $foo = "0"; // $foo est une chaîne de caractères (ASCII 48) $foo += 2; // $foo est maintenant du type entier (2) $foo = $foo + 1.3; // $foo est maintenant du type double (3.3) $foo = 5 + "10 Petits cochons"; // $foo est du type entier (15) $foo = 5 + "10 cochonnets"; // $foo est du type entier (15) -?> +?> +]]> <!-- TODO: explain ++/- - behaviour with strings examples: @@ -1699,9 +1819,11 @@ un copier/coller, et d'insérer les lignes dans un script PHP. <informalexample> <programlisting role="php"> -<?php - echo "\$foo==$foo; le type est " . gettype( $foo ) . "<br>\n"; -?> +<![CDATA[ +<?php + echo "\$foo==$foo; le type est " . gettype( $foo ) . "<br>\n"; +?> +]]> </programlisting> </informalexample> </para> @@ -1711,10 +1833,12 @@ indéfinie. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = 1; // $a est un entier $a[0] = "f"; // $a devient un tableau, et $a[0] contient "f" -?> +?> +]]> </programlisting> </informalexample> </para> @@ -1724,10 +1848,12 @@ est 'f', considérez l'exemple suivant : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = "1"; // $a est une chaîne $a[0] = "f"; // Qu'est ce qu'une position dans une chaîne ? que se passe t il? -?> +?> +]]> </programlisting> </informalexample> </para> @@ -1755,10 +1881,12 @@ à transtyper ("cast"). <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $foo = 10; // $foo est un entier $bar = (double) $foo; // $bar est un double -?> +?> +]]> </programlisting> </informalexample> </para> @@ -1791,10 +1919,12 @@ parenthèses, donc les lignes suivantes sont équivalentes: <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $foo = (int) $bar; $foo = ( int ) $bar; -?> +?> +]]> </programlisting> </informalexample> </para> @@ -1867,11 +1997,13 @@ élément du tableau. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $var = 'ciao'; $arr = (array) $var; echo $arr[0]; // affiche 'ciao' -?> +?> +]]> </programlisting> </informalexample> </para> @@ -1881,11 +2013,13 @@ l'objet. L'attribut s'appellera 'scalar': <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $var = 'ciao'; $obj = (object) $var; - echo $obj->scalar; // affiche 'ciao' -?> + echo $obj->scalar; // affiche 'ciao' +?> +]]> </programlisting> </informalexample> </para> Index: phpdoc-fr/language/variables.xml diff -u phpdoc-fr/language/variables.xml:1.33 phpdoc-fr/language/variables.xml:1.34 --- phpdoc-fr/language/variables.xml:1.33 Thu May 9 12:06:24 2002 +++ phpdoc-fr/language/variables.xml Mon Feb 3 07:27:12 2003 @@ -1,17 +1,17 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.33 $ --> +<!-- $Revision: 1.34 $ --> <chapter id="language.variables"> <title>Les variables</title> <sect1 id="language.variables.basics"> <title>Essentiel</title> <simpara> - En PHP, les variables sont représentées par un signe + En &php;, les variables sont représentées par un signe dollar "$" suivi du nom de la variable. Le nom est sensible à la casse (ie : $x != $X). </simpara> <para> Les noms de variables suivent les mêmes règles de nommage que - les autres entités PHP. Un nom de variable valide doit commencer par + les autres entités &php;. Un nom de variable valide doit commencer par une lettre ou un souligné (_), suivi de lettres, chiffres ou soulignés. Exprimé sous la forme d'une expression régulière, cela donne : @@ -25,21 +25,23 @@ </simpara> </note> <para> - <informalexample> + <example> <programlisting role="php"> -<?php -$var = "Jean"; -$Var = "Paul"; -echo "$var, $Var"; // affiche "Jean, Paul" -$4site = 'pas encore'; // invalide : commence par un nombre -$_4site = 'pas encore'; // valide : commence par un souligné -$maïs = 'jaune'; // valide; 'ï' est ASCII 239. -?> +<![CDATA[ +<?php + $var = "Jean"; + $Var = "Paul"; + echo "$var, $Var"; // affiche "Jean, Paul" + $4site = 'pas encore'; // invalide : commence par un nombre + $_4site = 'pas encore'; // valide : commence par un souligné + $maïs = 'jaune'; // valide; 'ï' est ASCII 239. +?> +]]> </programlisting> - </informalexample> + </example> </para> <para> - En PHP 3, les variables sont toujours assignées par valeur. + En &php; 3, les variables sont toujours assignées par valeur. C'est-à-dire, lorsque vous assignez une expression à une variable, la valeur de l'expression est recopiée dans la variable. Cela signifie, par exemple, qu'après avoir @@ -49,7 +51,7 @@ <link linkend="language.expressions">Expressions</link>. </para> <para> - PHP 4 permet aussi d'assigner les valeurs aux variables + &php; 4 permet aussi d'assigner les valeurs aux variables <emphasis>par référence</emphasis>. Cela signifie que la nouvelle variable ne fait que référencer (en d'autres terme, "devient un alias de", ou encore "pointe sur") la @@ -63,17 +65,20 @@ Pour assigner par référence, ajoutez simplement un & (ET commercial) au début de la variable qui est assignée (la variable source). Dans l'exemple suivant, - "<literal>Mon nom est Pierre</literal>" s'affichera deux + <literal>Mon nom est Pierre</literal> s'affichera deux fois : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $foo = 'Pierre'; // Assigne la valeur 'Pierre' à $foo -$bar = &$foo; // Référence $foo avec $bar. +$bar = &$foo; // Référence $foo avec $bar. $bar = "Mon nom est Pierre"; // Modifie $bar... echo $foo; // $foo est aussi modifiée echo $bar; -?> +?> +]]> + </programlisting> </informalexample> </para> @@ -82,15 +87,18 @@ nommées peuvent être assignées par référence. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $foo = 25; -$bar = &$foo; // assignation valide . -$bar = &(24 * 7); // assignation invalide : référence une expression sans nom +$bar = &$foo; // assignation valide . +$bar = &(24 * 7); // assignation invalide : référence une expression sans nom function test() { return 25; } -$bar = &test(); // assignation invalide. -?> +$bar = &test(); // assignation invalide. +?> +]]> + </programlisting> </informalexample> </para> @@ -98,49 +106,51 @@ <sect1 id="language.variables.predefined"> <title>Variables prédéfinies</title> <simpara> - PHP fourni un grand nombre de variables prédéfinies. + &php; fourni un grand nombre de variables prédéfinies. Cependant, beaucoup de ces variables ne peuvent pas être présentées ici, car elles dépendent du serveur sur lequel elles tournent, de la version du serveur, et de la configuration du serveur, ou encore d'autres facteurs. Certaines - de ces variables ne seront pas accessibles lorsque PHP fonctionne + de ces variables ne seront pas accessibles lorsque &php; fonctionne en exécutable. </simpara> <warning> <simpara> - En PHP 4.2.0 et plus récent, le jeu de variables prédéfinies qui sont + En &php; 4.2.0 et plus récent, le jeu de variables prédéfinies qui sont disponibles dans l'environnement global a changé. Les variables d'entrées et de serveurs ne sont plus <emphasis>par défaut</emphasis> placées dans le contexte d'exécution global. Elles sont placées dans les <link linkend="language.variables.superglobals">tableaux superglobaux</link>. </simpara> <simpara> - Vous pouvez toujours forcer l'ancien comportement de PHP en le configurant + Vous pouvez toujours forcer l'ancien comportement de &php; en le configurant avec <link linkend="ini.register-globals">register_globals</link> à <literal>On</literal> votre fichier &php.ini;. </simpara> <simpara> Pour plus d'informations et d'explications sur ce changement, voyez - <ulink url="&url.php.release4.1.0;">l'annonce de PHP 4.1.0</ulink> (en anglais). + <ulink url="&url.php.release4.1.0;">l'annonce de &php; 4.1.0</ulink> + et and <ulink url="&url.php.release4.2.0;">l'annonce de &php; 4.2.0</ulink> + (en anglais). </simpara> </warning> <simpara> - Depuis la version 4.1.0, PHP fourni un jeu de tableaux + Depuis la version 4.1.0, &php; fournit un jeu de tableaux prédéfinis, contenant les variables du serveur (si possible), les variables d'environnement et celle d'entrées. Ces nouveaux tableaux sont un peut particuliers, car ils ont automatiquement globaux : ils sont automatiquement disponibles dans tous les environnements d'exécution, sans avoir à utiliser le mot réservé <literal>global</literal>. Pour cette raison, ils sont dits 'auto-globaux' ou bien encore - 'superglobaux' (il n'y a pas de mécanisme PHP pour créer de telles + 'superglobaux' (il n'y a pas de mécanisme &php; pour créer de telles variables. Les superglobales sont listées ci-dessous. Cependant, pour connaître le détails de leur contenu, et une présentation approfondie - sur les variables prédéfinies PHP, et leur nature, reportez vous + sur les variables prédéfinies &php;, et leur nature, reportez vous à la section <link linkend="reserved.variables">variables prédefinies</link>. </simpara> <variablelist id="language.variables.superglobals"> - <title>Tableaux superglobaux de PHP</title> + <title>Tableaux superglobaux de &php;</title> <varlistentry> <term><link linkend="reserved.variables.globals">$GLOBALS</link></term> <listitem> @@ -226,7 +236,7 @@ <varname>$_SERVER</varname>. La présence et la valeur des entrées de ce tableau sont réglés par la directive <link linkend="ini.variables-order">variables_order</link>. Ce tableau - n'est l'évolution d'aucune variable d'avant PHP 4.1.0. + n'est l'évolution d'aucune variable d'avant &php; 4.1.0. </simpara> </listitem> </varlistentry> @@ -244,473 +254,25 @@ </varlistentry> </variablelist> </sect1> - - <sect1 id="language.variables.old"> - <title>Missing title</title> - <warning> - <simpara> - Cette section est la documentation qui avait cours jusqu'en PHP - version 4.1.2. Elle est laissée ici pour assurer la transition - avec les nouvelles versions, qui ont <emphasis>abandonné définitivement</emphasis> - leur usage. Nous recommandons vivement au lecteur la - <link linkend="language.variables.superglobals">section précédente</link>. - </simpara> - <simpara> - Pour assurer une meilleure compatibilité de vos scripts avec - les nouvelles versions de PHP, n'utilisez plus ces variables. - </simpara> - </warning> - <simpara> - Malgré ces données, voici une liste de variables - prédéfinies, qui seront accessibles avec une - installation ad hoc de PHP3, fonctionnant en module, sous - <ulink url="&url.apache;">Apache</ulink> 1.3.6. - </simpara> - <simpara> - Pour la liste complète des variables prédéfinies - (et d'autres informations pratiques) reportez-vous (et usez) de - <function>phpinfo</function>. - </simpara> - <note> - <simpara> - Cette liste n'est pas exhaustive et ne le sera pas. C'est simplement un - aperçu des variables prédéfinies qui - peuvent être accessibles dans les scripts. - </simpara> - </note> - <sect2 id="language.variables.predefined.apache"> - <title>Variables Apache</title> - <simpara> - Ces variables sont créées par le serveur - <ulink url="&url.apache;">Apache</ulink>. Si vous utilisez un autre - serveur web, il n'est pas sur que celui-ci vous fournira - les mêmes variables. Il peut ne pas les fournir, en - fournir d'autres. Cependant, un bon nombre de ces variables - font partie de l'interface <ulink url="&url.cgispec;">CGI 1.1</ulink>, - et on peut s'attendre à les retrouver. - </simpara> - <simpara> - Notez que peu d'entre elles seront accessibles lorsque PHP est appelé - en ligne de commande, (et elles n'auront alors peut être pas de sens) - </simpara> - <para> - <variablelist> - <varlistentry> - <term>$GATEWAY_INTERFACE</term> - <listitem> - <simpara> - Numéro de révision de l'interface CGI du serveur : - i.e. 'CGI/1.1'. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$SERVER_NAME</term> - <listitem> - <simpara> - Le nom du serveur hôte qui éxécute le script suivant. - Si le script est exécuté sur un hôte virtuel, ce sera - la valeur définie pour cet hôte virtuel. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$SERVER_SOFTWARE</term> - <listitem> - <simpara> - Chaîne d'identification du serveur, qui est donnée dans - les en-têtes lors de la réponse aux requêtes. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$SERVER_PROTOCOL</term> - <listitem> - <simpara> - Nom et révision du protocole de communication : i.e. 'HTTP/1.0'; - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$REQUEST_METHOD</term> - <listitem> - <simpara> - Méthode de requête utilisée pour accéder - à la page; i.e. 'GET', 'HEAD', 'POST', 'PUT'. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$QUERY_STRING</term> - <listitem> - <simpara> - La chaîne de requête, si elle existe, qui est - utilisée pour accéder à la page. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$DOCUMENT_ROOT</term> - <listitem> - <simpara> - La racine sous laquelle le script courant est exécuté, - comme défini dans la configuration du serveur. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_ACCEPT</term> - <listitem> - <simpara> - Contenu de l'en-tête <literal>Accept:</literal> de la - requête courante, s'il y en a une. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_ACCEPT_CHARSET</term> - <listitem> - <simpara> - Contenu de l'en-tête <literal>Accept-Charset:</literal> - de la requête courante, s'elle existe. Par exemple : - '<literal>iso-8859-1,*,utf-8</literal>'. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_ACCEPT_ENCODING</term> - <listitem> - <simpara> - Contenu de l'en-tête <literal>Accept-Encoding:</literal> - de la requête courante, si elle existe. Par exemple : 'gzip'. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_ACCEPT_LANGUAGE</term> - <listitem> - <simpara> - Contenu de l'en-tête <literal>Accept-Language:</literal> de - la requête courante, si elle existe. Par exemple : 'en'. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_CONNECTION</term> - <listitem> - <simpara> - Contenu de l'en-tête <literal>Connection:</literal> de la - requête courante, si elle existe. Par exemple : 'Keep-Alive'. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_HOST</term> - <listitem> - <simpara> - Contenu de l'en-tête <literal>Host:</literal> de la - requête courante, si elle existe. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_REFERER</term> - <listitem> - <simpara> - L'adresse de la page (si elle existe) qui a conduit le - client à la page courante. Cette valeur est - affectée par le client, et tous les clients ne le font pas. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_USER_AGENT</term> - <listitem> - <simpara> - Contenu de l'en-tête <literal>User_Agent:</literal> de - la requête courante, si elle existe. C'est une chaîne - qui décrit le client HTML utilisé pour voir - la page courante. Par exemple : - <computeroutput>Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586)</computeroutput>. - Entre autres choses, vous pouvez utiliser cette valeur avec - <function>get_browser</function> pour optimiser votre page - en fonction des capacités du client. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$REMOTE_ADDR</term> - <listitem> - <simpara> - L'adresse IP du client qui demande la page courante. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$REMOTE_PORT</term> - <listitem> - <simpara> - Le port utilisé par la machine cliente pour communiquer - avec le serveur web. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$SCRIPT_FILENAME</term> - <listitem> - <simpara> - Le chemin absolu jusqu'au script courant. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$SERVER_ADMIN</term> - <listitem> - <simpara> - La valeur donnée à la directive SERVER_ADMIN - (pour Apache), dans le fichier de configuration. Si le script - est exécuté par un hôte virtuel, ce sera la - valeur définie par l'hôte virtuel. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$SERVER_PORT</term> - <listitem> - <simpara> - Le port de la machine serveur utilisé pour les - communications. Par défaut, c'est '80'. En utilisant - SSL, par exemple, il sera remplacé par le numéro - de port HTTP sécurisé. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$SERVER_SIGNATURE</term> - <listitem> - <simpara> - Chaîne contenant le numéro de version du serveur - et le nom d'hôte virtuel, qui sont ajoutés aux - pages générées par le serveur, si cette - option est activée. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$PATH_TRANSLATED</term> - <listitem> - <simpara> - Chemin dans le système de fichier (pas le document root-) - jusqu'au script courant, une fois que le serveur a fait - une chemin traduction virtuel->réel. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$SCRIPT_NAME</term> - <listitem> - <simpara> - Contient le nom du script courant. Cela sert lorsque - les pages doivent s'appeler elles-mêmes. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$REQUEST_URI</term> - <listitem> - <simpara> - L'URI qui a été fourni pour accéder - à cette page. Par exemple : '/index.html'. - </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> - </sect2> - <sect2 id="language.variables.predefined.environment"> - <title>Variables d'environnement</title> - <simpara> - Ces variables sont importées dans l'espace de nom global - de PHP, depuis l'environnement sous lequel PHP fonctionne. Beaucoup - d'entre elles sont fournies par le shell qui exécute PHP et - différents systèmes étant susceptibles - de disposer de différents shells, une liste définitive - est impossible à établir. Reportez-vous à la - documentation de votre shell, pour connaître la liste des - variables d'environnement prédéfinies. - </simpara> - <simpara> - Les autres variables d'environment incluent les variables CGI, - placées ici, quelquefois la méthode - d'éxécution de PHP (CGI ou module). - </simpara> - </sect2> - <sect2 id="language.variables.predefined.php"> - <title>Variables PHP</title> - <simpara> - Ces variables sont créées par PHP lui_même. - Les variables <varname>$HTTP_*_VARS</varname> ne sont disponibles - que si l'option de configuration - <link linkend="ini.track-vars">track_vars</link> a - été activée. Lorsque c'est le cas, ces variables - existent toujours, même si ce sont des tableaux vides. Cela évite les - usurpations mal intentionnées de ces variables. - </simpara> - <note> - <para> - Depuis PHP 4.0.3, - <link linkend="ini.track-vars">track_vars</link> est toujours - activé, quelle que soit la configuration. - </para> - </note> - <para> - Si la directive - <link linkend="ini.register-globals">register_globals</link> est activée, - alors ces variables seront aussi disponibles comme variables - globales du script : c'est-à-dire, indépendamment des tableaux - <varname>$HTTP_*_VARS</varname>. Cette fonctionnalité - doit être utilisée avec précautions, et de - préférence, désactivée. - Si <varname>$HTTP_*_VARS</varname> est sécurisé, - les équivalents globaux peuvent être écrasés - par les données d'entrée de l'utilisateur, - avec des intrusions possibles. Si vous ne pouvez pas désactiver - <link linkend="ini.register-globals">register_globals</link>, vous - devez prendre toutes les dispositions possibles pour vous assurer - que les données utilisées sont sûres. - </para> - <para> - <variablelist> - <varlistentry> - <term>$argv</term> - <listitem> - <simpara> - Tableau des arguments passées au script. Lorsque le script - est appelé en ligne de commande, cela donne accès - aux arguments, comme en langage C. Lorsque le script est - appelé avec la méthode GET, ce tableau contiendra - la chaîne de requête. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$argc</term> - <listitem> - <simpara> - Contient le nombre de paramètres de la ligne de commande - passés au script (si le script fonctionne en ligne de commande). - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$PHP_SELF</term> - <listitem> - <simpara> - Le nom du fichier du script en cour d'éxécution, par - rapport au document root. Si PHP fonctionne en ligne de commande, - cette variable n'est pas disponible. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_COOKIE_VARS</term> - <listitem> - <simpara> - Un tableau associatif des variables passées au script - courant via les HTTP cookies. Uniquement possible si le suivi - des variables a été activé avec - la directive générale - <link linkend="ini.track-vars">track_vars</link> ou - avec la directive locale - <computeroutput><? php_track_vars ?></computeroutput>. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_GET_VARS</term> - <listitem> - <simpara> - Un tableau associatif des variables passées au script - courant via les HTTP GET. Uniquement possible si le suivi des - variables a été activé avec la directive - générale - <link linkend="ini.track-vars">track_vars</link> ou - avec la directive locale - <computeroutput><? php_track_vars ?></computeroutput>. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_POST_VARS</term> - <listitem> - <simpara> - Un tableau associatif des variables passées au script - courant via les HTTP POST. Uniquement possible si le suivi des - variables a été activé avec la directive - générale - <link linkend="ini.track-vars">track_vars</link> ou - avec la directive locale - <computeroutput><? php_track_vars ?></computeroutput>. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_POST_FILES</term> - <listitem> - <simpara> - Un tableau associatif contenant les informations sur les - fichiers téléchargés avec la méthode - HTTP POST. Reportez-vous au chapitre - <link linkend="features.file-upload.post-method"> - Téléchargement par méthode POST</link> - pour plus de détails sur le contenu de - <varname>$HTTP_POST_FILES</varname>. - </simpara> - <para> - <varname>$HTTP_POST_FILES</varname> n'est disponible que dans - les versions 4.0.0 et plus récentes de PHP. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_ENV_VARS</term> - <listitem> - <simpara> - Un tableau associatif des variables passées au script - par l'environnement parent. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_SERVER_VARS</term> - <listitem> - <simpara> - Un tableau associatif des variables passées au script - par le serveur HTTP. Ces variables sont analogues - aux variables décrites ci-dessus. - </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> - </sect2> - </sect1> <sect1 id="language.variables.scope"> <title>Portée des variables</title> <simpara> La portée d'une variable dépend du contexte dans lequel la variable est définie. Pour la majorité des variables, la portée concerne la totalité d'un script - PHP. Mais, lorsque vous définissez une fonction, la + &php;. Mais, lorsque vous définissez une fonction, la portée d'une variable définie dans cette fonction est locale à la fonction. Par exemple: </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = 1; include "b.inc"; -?> +?> +]]> + </programlisting> </informalexample> <simpara> @@ -723,13 +285,16 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = 1; /* portée globale */ function test() { echo $a; /* portée locale */ } test(); -?> +?> +]]> + </programlisting> </informalexample> <simpara> @@ -742,14 +307,15 @@ les fonctions, à moins d'être redéfinie localement dans la fonction. Cela peut poser des problèmes si vous redéfinissez des variables globales localement. - En PHP, une variable globale doit être + En &php;, une variable globale doit être déclarée à l'intérieur de chaque fonction afin de pouvoir être utilisée dans cette fonction. Par exemple: </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = 1; $b = 2; function somme() { @@ -758,10 +324,11 @@ } somme(); echo $b; +]]> </programlisting> </informalexample> <simpara> - Le script ci-dessus va afficher la valeur "3". + Le script ci-dessus va afficher la valeur <literal>3</literal>. En déclarant globales les variables $a et $b locales de la fonction somme(), toutes les références à ces variables concerneront les variables globales. Il n'y a @@ -777,15 +344,18 @@ </simpara> <informalexample> <programlisting role="php"> -<?php -$a = 1; -$b = 2; -function somme() { +<![CDATA[ +<?php + $a = 1; + $b = 2; + function somme() { $GLOBALS["b"] = $GLOBALS["a"] + $GLOBALS["b"]; -} -somme(); -echo $b; -?> + } + somme(); + echo $b; +?> +]]> + </programlisting> </informalexample> <simpara> @@ -801,13 +371,16 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function test() { $a = 0; echo $a; $a++; } -?> +?> +]]> + </programlisting> </informalexample> <simpara> @@ -822,13 +395,16 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function test() { static $a = 0; echo $a; $a++; } -?> +?> +]]> + </programlisting> </informalexample> <simpara> @@ -848,17 +424,20 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function test() { static $count = 0; $count++; echo $count; - if ($count < 10) { + if ($count < 10) { test(); } $count--; } -?> +?> +]]> + </programlisting> </informalexample> </sect1> @@ -872,9 +451,12 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = "bonjour"; -?> +?> +]]> + </programlisting> </informalexample> <simpara> @@ -886,21 +468,27 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $$a = "monde"; -?> +?> +]]> + </programlisting> </informalexample> <simpara> A ce niveau, deux variables ont été définies et - stockées dans l'arbre des symboles PHP: $a avec comme valeur + stockées dans l'arbre des symboles &php; : $a avec comme valeur "bonjour" et $bonjour avec comme valeur "monde". Alors, l'instruction </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo "$a ${$a}"; -?> +?> +]]> + </programlisting> </informalexample> <simpara> @@ -908,9 +496,12 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo "$a $bonjour"; -?> +?> +]]> + </programlisting> </informalexample> <simpara> @@ -927,11 +518,11 @@ </simpara> </sect1> <sect1 id="language.variables.external"> - <title>Variables externes à PHP</title> + <title>Variables externes à &php;</title> <sect2 id="language.variables.external.form"> <title>Formulaires HTML (GET et POST)</title> <simpara> - Lorsqu'un formulaire est envoyé à un script PHP, + Lorsqu'un formulaire est envoyé à un script &php;, toutes les variables du formulaire seront automatiquement disponibles dans le script. Par exemple, considérons le formulaire suivant: </simpara> @@ -939,15 +530,17 @@ <example> <title>Exemple avec un formulaire simple</title> <programlisting role="html"> -<form action="foo.php" method="post"> - Nom: <input type="text" name="nom"><br> - <input type="submit"> -</form> +<![CDATA[ +<form action="foo.php" method="post"> + Nom: <input type="text" name="nom"><BR> + <input type="submit"> +</form> +]]> </programlisting> </example> </para> <simpara> - Lorsque ce formulaire est envoyé, le PHP va créer la variable + Lorsque ce formulaire est envoyé, le &php; va créer la variable <computeroutput>$nom</computeroutput>, qui contiendra la valeur que vous avez entrée dans le champs <emphasis>Nom:</emphasis> du formulaire. @@ -967,7 +560,7 @@ </para> </note> <simpara> - Le PHP permet aussi l'utilisation des tableaux dans le contexte de + Le &php; permet aussi l'utilisation des tableaux dans le contexte de formulaire, mais seulement des tableaux à une seule dimension. Comme cela, vous pouvez rassembler des variables ou utiliser cette fonctionnalité pour récupérer les valeurs d'un choix @@ -977,17 +570,19 @@ <example> <title>Variables complexes de formulaire</title> <programlisting role="html"> -<form action="array.php" method="post"> - Name: <input type="text" name="personal[name]"><br> - Email: <input type="text" name="personal[email]"><br> - Beer: <br> - <select multiple name="vin[]"> - <option value="medoc">Médoc - <option value="chablis">Chablis - <option value="riesling">Riesling - </select> - <input type="submit"> -</form> +<![CDATA[ +<form action="array.php" method="post"> + Name: <input type="text" name="personal[name]"><br> + Email: <input type="text" name="personal[email]"><br> + Beer: <br> + <select multiple name="vin[]"> + <option value="medoc">Médoc + <option value="chablis">Chablis + <option value="riesling">Riesling + </select> + <input type="submit"> +</form> +]]> </programlisting> </example> </para> @@ -995,7 +590,11 @@ Si l'option "track_vars" est activée, soit par l'option de compilation <link linkend="ini.track-vars">track_vars</link>, soit par la directive de - configuration <computeroutput><? php_track_vars ?></computeroutput>, + configuration <computeroutput> +<![CDATA[ + <? php_track_vars ?> +]]> +</computeroutput>, les variables transmises par les méthodes POST et GET pourront aussi être trouvées dans le tableau associatif global $HTTP_POST_VARS ou $HTTP_GET_VARS @@ -1010,7 +609,9 @@ </simpara> <informalexample> <programlisting role="html"> -<input type=image src="image.gif" name="sub"> +<![CDATA[ + <input type=image src="image.gif" name="sub"> +]]> </programlisting> </informalexample> <simpara> @@ -1020,7 +621,7 @@ de l'endroit où l'utilisateur à cliqué. Les utilisateurs expérimentés remarqueront que les noms de variables sont transmis avec une virgule à la place du - caractère "_", mais le PHP fait la conversion + caractère "_", mais &php; fait la conversion automatiquement. </simpara> </sect3> @@ -1028,7 +629,7 @@ <sect2 id="language.variables.external.cookies"> <title>HTTP Cookies</title> <simpara> - Le PHP supporte les cookies HTTP de manière totalement + &php; supporte les cookies HTTP de manière totalement transparente, comme défini dans les <ulink url="&spec.cookies;">Netscape's Spec</ulink>. Les cookies sont un mécanisme permettant de stocker des données @@ -1051,9 +652,12 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php setcookie ("MonCookie[]", "test", time()+3600); -?> +?> +]]> + </programlisting> </informalexample> <simpara> @@ -1066,51 +670,30 @@ <example> <title>Exemple avec <function>setcookie</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $compte++; SetCookie ("Compte", $compte, time()+3600); SetCookie ("Caddie[$compte]", $item, time()+3600); -?> +?> +]]> + </programlisting> </example> </sect2> - <sect2 id="language.variables.external.environment"> - <title>Variables d'environnement </title> - <para> - Le PHP fait en sorte que les variables d'environnement soient accessibles - directement comme des variables PHP normales. - <informalexample> - <programlisting role="php"> -<?php -echo $HOME; /* Affiche la valeur de la variable d'environnement HOME, - si celle-ci est affectée. */ -?> - </programlisting> - </informalexample> - </para> - <para> - Même si le PHP crée les variables lors de l'utilisation - des méthodes GET, POST et cookie, il est de temps en temps - préférable de transmettre explicitement la valeur de - la variable afin d'être sûr de la valeur. - La fonction <function>getenv</function> peut être - utilisée pour récupérer la valeur - des variables d'environnement. Vous pouvez aussi affecter - une variable d'environnement grâce à la fonction - <function>putenv</function>. - </para> - </sect2> <sect2 id="language.variables.external.dot-in-names"> <title>Cas des points dans les noms de variables</title> <para> - Typiquement, PHP ne modifie pas les noms des variables lorsqu'elles + Typiquement, &php; ne modifie pas les noms des variables lorsqu'elles sont passées à un script. Cependant, il faut noter que les points (.) ne sont pas autorisés dans les noms de variables - PHP. Pour cette raison, jetez un oeil sur : + &php;. Pour cette raison, jetez un oeil sur : <programlisting role="php"> -<?php -$varname.ext; /* nom de variable invalide */ -?> +<![CDATA[ +<?php + $varname.ext; /* nom de variable invalide */ +?> +]]> </programlisting> Dans ce cas, l'analyseur croit voir la variable nommée $varname, suivie par l'opérateur de concaténation, @@ -1119,7 +702,7 @@ particulière). Visiblement, ce n'est pas ce qu'on attendait... </para> <para> - Pour cette raison, il est important de noter que PHP remplacera + Pour cette raison, il est important de noter que &php; remplacera automatiquement les points des noms de variables entrantes par des soulignés (underscore). </para> @@ -1127,10 +710,10 @@ <sect2 id="language.variables.determining-type-of"> <title>Détermination du type des variables</title> <para> - Parceque le PHP détermine le type des variables et + Parceque &php; détermine le type des variables et les convertit (généralement) comme il faut, ce n'est pas toujours le type de variable que vous souhaitez. - PHP inclut des fonctions permettant de déterminer le + &php; inclut des fonctions permettant de déterminer le type d'une variable : <function>gettype</function>, <function>is_long</function>,
Index: phpdoc-fr/language-snippets.ent diff -u phpdoc-fr/language-snippets.ent:1.32 phpdoc-fr/language-snippets.ent:1.33 --- phpdoc-fr/language-snippets.ent:1.32 Sat Jan 18 18:38:05 2003 +++ phpdoc-fr/language-snippets.ent Mon Feb 3 07:27:11 2003 @@ -1,13 +1,10 @@ -<!-- PHPDoc snippets $Id: language-snippets.ent,v 1.32 2003/01/18 23:38:05 dams Exp $ --> +<!-- PHPDoc snippets $Id: language-snippets.ent,v 1.33 2003/02/03 12:27:11 dams Exp $ --> <!ENTITY warn.experimental '<warning><simpara>Ce module est <emphasis>EXPERIMENTAL</emphasis>. Cela signifie que le comportement de ces fonctions, leurs noms et concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utiliser ce module à vos risques et périls.</simpara></warning>'> <!ENTITY warn.experimental.func '<warning><simpara>Cette fonction est <emphasis>EXPERIMENTALE</emphasis>. Cela signifie que le comportement de cette fonction, son nom et concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utilisez cette fonction à vos risques et périls.</simpara></warning>'> <!ENTITY warn.undocumented.func '<warning><simpara>Cette fonction n'est pas documentée, et seule la liste des arguments est disponible.</simpara></warning>'> -<!ENTITY warn.no-win32-fopen-wrapper '<warning><para>La version Windows -de <literal>PHP</literal> ne supporte pas l'accès aux fichiers distants -avec cette fonction, même si <link linkend="ini.allow-url-fopen">allow_url_fopen</link> est activé. -</para></warning>'> +<!ENTITY warn.no-win32-fopen-wrapper '<warning><para>La version Windows de <literal>PHP</literal> ne supporte pas l'accès aux fichiers distants avec cette fonction, même si <link linkend="ini.allow-url-fopen">allow_url_fopen</link> est activé. </para></warning>'> <!ENTITY tip.ob-capture '<tip><simpara>Comme pour toutes les fonctions qui affichent directement des résultats au navigateur, vous pouvez utiliser <link linkend="ref.outcontrol">les fonctions de gestion des sorties</link> pour capturer le contenu de cette fonction et le sauver, par exemple, dans une chaîne.</simpara></tip>'> @@ -16,6 +13,9 @@ <!ENTITY return.success 'Cette fonction retourne &true; en cas de succès, &false; en cas d'échec.'> <!ENTITY return.falseproblem '<warning><simpara>Cette fonction peut retourner &false;, mais elle peut aussi retourner une valeur équivalent à &false;, utilisable dans une condition if simple. Utilisez l'<link linkend="language.operators.comparison">opérateur ===</link> pour tester la valeur exacte de cette fonction.</simpara></warning>'> + +<!ENTITY warn.imaprecodeyaz '<warning><simpara>L'extension <link linkend="ref.imap">IMAP</link> ne peut être utilisée simultanément avec l'extension <link linkend="ref.recode">recode</link> ou l'extension <link linkend="ref.yaz">YAZ</link>. Ceci est dû au fait que ces deux librairies utilisent un symbole interne commun.</simpara></warning>'> + <!-- Notes variees --> <!ENTITY note.not-bin-safe '<warning><simpara>Cette fonction n'est pas capable de gérer les chaînes binaires!</simpara></warning>'> <!ENTITY note.bin-safe '<note><simpara>Cette fonction gère les chaînes binaires</simpara></note>'> Index: phpdoc-fr/language/basic-syntax.xml diff -u phpdoc-fr/language/basic-syntax.xml:1.11 phpdoc-fr/language/basic-syntax.xml:1.12 --- phpdoc-fr/language/basic-syntax.xml:1.11 Wed Dec 12 15:50:02 2001 +++ phpdoc-fr/language/basic-syntax.xml Mon Feb 3 07:27:11 2003 @@ -1,91 +1,127 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> +<!-- $Revision: 1.12 $ --> <chapter id="language.basic-syntax"> <title>La syntaxe de base</title> <sect1 id="language.basic-syntax.phpmode"> - <title>Le passage du HTML au PHP</title> + <title>Passer du HTML au PHP</title> <para> Lorsque PHP commence à traiter un fichier, il ne fait qu'afficher - le texte HTML qu'il rencontre. Si vous renommez un fichier .html - en .php, il s'affichera exactement comme avant. + le texte qu'il rencontre, jusqu'à ce qu'il rencontre une balise spéciale + qui lui indiquera qu'il peut interpréter le code qui suit. L'analyseur + PHP va alors exécuter ce code, jusqu'à ce qu'il rencontre une balise + de fin de code PHP. A ce moment là, il retourne en mode texte, et + il affiche simplement le contenu. C'est ce mécanisme qui vous permet + d'inclure du code PHP dans des pages HTML : tout ce qui est placé hors + des balises PHP est affiché sans modification, tandis que le contenu + est exécuté. </para> <para> - Si vous voulez insérer des commandes PHP dans votre fichier, vous - devez indiquer à PHP le début d'une telle séquence, - en passant en mode PHP. Il y a quatre moyens pour passer du mode HTML au - mode PHP : + Il y a quatre jeux de alises qui servent à délimiter des blocs + de code PHP. Seules deux d'entre elles sont toujours actives : + c'est <?php. . .?> et <script + language="php">. . .</script>). Tandis que les autres peuvent + être activées est désactivées depuis le fichier de configuration + &php.ini;. Les balises courtes et les balises ASP peuvent être pratiques, + mais elles ne sont pas aussi portables que les versions longues. De plus, + si vous envisagez d'inclure du PHP dans des fichiers + XML ou XHTML, vous devrez utiliser la forme <?php. . .?> pour vous conformer au XML. </para> <para> <example> <title>Le passage du HTML au PHP </title> <programlisting role="php"> -1. <? echo ("Ceci est un exemple d'affichage à l'écran en PHP, sous forme d'expression SGML.\n"); ?> - <?= expression ?> Raccourci de "<? echo expression ?>" -2. <?php echo("Si vous voulez afficher du XML ou du XHTML, faites comme ceci.\n"); ?> -3. <script language="php"> +<![CDATA[ +<?php +1. <?php echo("Si vous voulez afficher du XML ou du XHTML, faites comme ceci.\n"); ?> + +2. <? echo ("Ceci est un exemple d'affichage à l'écran en PHP, sous forme d'expression SGML.\n"); ?> + <?= expression ?> Raccourci de "<? echo expression ?>" + +3. <script language="php"> echo ("Certains éditeurs HTML (comme FrontPage) n'acceptent pas les expressions telles que celle-ci."); - </script> -4. <% echo ("Vous pouvez aussi utiliser le style ASP comme délimiteur."); %> - <%= $variable; # ceci est un raccourci pour "<%%echo .." %> + </script> + +4. <% echo ("Vous pouvez aussi utiliser le style ASP comme délimiteur."); %> + <%= $variable; # ceci est un raccourci pour "<%%echo .." %> +?> +]]> </programlisting> </example> </para> <para> - La deuxième méthode est généralement utilisée, + La première méthode est généralement utilisée, car elle permet une implémentation aisée de PHP avec la prochaine génération de XHTML. </para> <para> - La première possibilité n'est valable que si vous - l'avez activée. Soit en faisant appel à la fonction - short_tags() (NdT : semble avoir disparu), soit en utilisant l'option + La deuxième forme n'est valable que si vous l'avez activée. + Soit en faisant appel à la fonction + short_tags() (Uniquement en PHP 3), soit en utilisant l'option d'exécution <link linkend="ini.short-open-tag">short_open_tag</link> - dans le fichier de configuration, soit en utilisant l'option de - compilation <link linkend="install.configure.disable-short-tags">--enable-short-tags</link>. + dans le fichier de configuration &php.ini;, soit encore en utilisant + l'option de compilation + <link linkend="install.configure.disable-short-tags">--enable-short-tags</link>. + Même si les balises courtes sont activées dans le fichier de configuration + php.ini-dist, leur utilisation est déconseillée. </para> <para> - La quatrième possibilité est seulement disponible - si vous l'avez activée en utilisant soit l'option - d'exécution <link linkend="ini.asp-tags">asp_tags</link>, - soit en utilisant l'option de compilation --enable-asp-tags. + La quatrième forme est seulement disponible + si vous l'avez activée en utilisant l'option + d'exécution <link linkend="ini.asp-tags">asp_tags</link>. <note> <para> - Le support de la quatrième possibilité, - ASP-style, a été ajouté dans la - version 3.0.4. + Le support des balises ASP, a été ajouté en + PHP 3.0.4. </para> </note> </para> + <note> + <para> + L'utilisation des balises courtes doit être évitées lors + du développement d'application et de librairies destinées à être + distribuées ou déployées sur des serveurs qui sont hors de votre + contrôle, car ces balises ne seront pas forcément supportées + par le serveur de destination. Pour rendre vos scripts portables + et distribuables, évitez les balises courtes. + </para> + </note> <para> - La marque de fermeture d'un bloc (?>) comprend la nouvelle - ligne suivante, s'il y en a une. + La marque de fermeture d'un bloc (?>) comprend le caractère de nouvelle + ligne qui le suit immédiatement, s'il y en a un. De plus, la balise fermante + implique un point-virgule. Vous n'êtes pas obligés de mettre le point-virgule + à la fin d'un bloc de PHP. </para> <para> <!-- TODO: find a better place for this para --> PHP vous permet d'utiliser des structures telles que : <example> <title>Méthode avancée</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if ( expression-booléenne ) { -?> - <strong>Ceci est vrai.</strong> -<?php +?> + <strong>Ceci est vrai.</strong> +<?php } else { -?> -<strong>Ceci est faux.</strong> -<?php +?> +<strong>Ceci est faux.</strong> +<?php } -?> +?> +]]> </programlisting> </example> - Cela fonctionne comme on peut s'y attendre, car PHP traite le texte - entre ?> et <?php comme une fonction <function>echo</function>, - sans remplacer les variables éventuelles par leur valeur. + Cela fonctionne comme on peut s'y attendre, car PHP affiche le texte + entre les balises ?> et <?php sans modification. L'exemple ci-dessus + est très simple, mais c'est un bon système à garder en tête pour + afficher de grande quantité de texte : c'est même plus efficace que + d'utiliser les fonctions <function>echo</function> ou + <function>print</function>. </para> </sect1> <sect1 id="language.basic-syntax.instruction-separation"> - <title>Le séparateur d'instruction</title> + <title>Le séparateur d'instructions</title> <simpara> Les instructions sont séparées par un point virgule à chaque fin d'instruction, comme en langage C ou en Perl. @@ -94,60 +130,68 @@ La balise de fin (?>) implique la fin d'un instruction, et donc ajoute implicitement un point virgule. Les deux exemples suivants sont équivalents. - <informalexample> + <example> + <title>Le séparateur d'instructions</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo "Ceci est un test"; -?> -<?php echo "Ceci est un test" ?> - </programlisting> - </informalexample> +?> +<?php echo "Ceci est un test" ?> +]]> + </programlisting> + </example> </para> - </sect1> - <sect1 id="language.basic-syntax.comments"> - <title>Commentaires</title> - <para> + </sect1> + <sect1 id="language.basic-syntax.comments"> + <title>Commentaires</title> + <para> Le PHP supporte les commentaires comme en C, C++ et Shell Unix. Par exemple: <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo "Ceci est un test"; // Ceci est un commentaire sur une ligne comme en C++ /* Ceci est un commentaire sur plusieurs lignes, comme en C et C++ */ echo "Ceci est encore un test"; echo "Enfin, le test final"; # Ceci est un commentaire comme en Shell Unix -?> - </programlisting> +?> +]]> + </programlisting> </informalexample> </para> - <simpara> - Le premier type de commentaire ne commente que jusqu'à la - fin de la ligne ou bien jusqu'à la fin du bloc, cela - dépend du premier rencontré. - </simpara> <informalexample> <programlisting role="php"> -<h1>Ceci est un <?php echo "simple";?> exemple.</h1> -<p> +<![CDATA[ +<h1>Ceci est un <?php # echo "simple";?> exemple.</h1> +<p>L'entête ci-dessus affiche 'Ceci est un exemple'. +]]> </programlisting> </informalexample> <simpara> - La ligne du dessus affichera 'Ceci est un simple exemple'. - </simpara> - <simpara> - Faites attention à ne pas emboîter les - commentaires de type 'C', ce qui arrive de temps en temps - lorsque vous voulez commenter une grande partie de code. + Faites attention à ne pas emboîter les commentaires de type + langage C, ce qui arrive de temps en temps lorsque vous voulez commenter + une grande partie de code. </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php /* echo "Ceci est un test"; /* Ce commentaire va poser un problème */ */ -?> - </programlisting> +?> +]]> + </programlisting> </informalexample> + <simpara> + Les commentaires // commente jusqu'à la + fin de la ligne ou bien jusqu'à la fin du bloc (le premier + des deux). Cela signifie que du code HTML placé après + // ?> sera affiché, car PHP retourne alors en mode texte + juste après la balie ?>. + </simpara> </sect1> </chapter> <!-- Keep this comment at the end of the file Index: phpdoc-fr/language/constants.xml diff -u phpdoc-fr/language/constants.xml:1.16 phpdoc-fr/language/constants.xml:1.17 --- phpdoc-fr/language/constants.xml:1.16 Wed Dec 12 15:50:05 2001 +++ phpdoc-fr/language/constants.xml Mon Feb 3 07:27:11 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> +<!-- $Revision: 1.17 $ --> <chapter id="language.constants"> <title>Les constantes</title> <simpara> @@ -27,7 +27,8 @@ </simpara> </note> <simpara> - Les constantes sont accessibles de manière globale. + Les constantes sont accessibles de manière globale. Vous pouvez la définir + n'importe où, et y accèder depuis n'importe quelle fonction. </simpara> <sect1 id="language.constants.syntax"> <title>Syntaxe</title> @@ -39,16 +40,16 @@ <simpara> Seuls les types de données scalaires peuvent être placés dans une constante : c'est à dire les types booléen, entier, double et - chaîne de caractères (soit <type>boolean</type>, <type>integer</type>, - <type>double</type> et <type>string</type>). + chaîne de caractères (soit &boolean;, &integer;, + &double; et &string;). </simpara> <simpara> Vous povuez accéder à la valeur d'une constante en spécifiant simplement son nom. Contrairement aux variables, vous ne devez <emphasis>PAS</emphasis> préfixer le nom de la constante avec <literal>$</literal>. - Vous pouvez aussi utiliser la fonction <function>constant</function>, pour - lire dynamiquement la valeur d'une constante, si vous obtenez le nom - de cette constante dynamiquement (retour de fonction, par exemple). + Vous pouvez aussi utiliser la fonction <function>constant</function>, pour + lire dynamiquement la valeur d'une constante, dont vous obtenez le nom + dynamiquement (retour de fonction, par exemple). Utilisez la fonction <function>get_defined_constants</function> pour connaître la liste de toutes les fonctions définies. </simpara> @@ -62,8 +63,8 @@ </note> <simpara> Lorsque vous utilisez une constante non définie, PHP suppose que vous utilisez - le nom de la constante. Une - <link linkend="features.error-handling">note</link> sera générée. Utilisez la + le nom de la constante. Une <link linkend="ref.errorfunc">note</link> + sera générée. Utilisez la fonction <function>defined</function> pour savoir si une constante existe ou pas. </simpara> <para> @@ -71,19 +72,19 @@ <itemizedlist> <listitem> <simpara> - Les constantes ne commencent pas par le signe (<literal>$</literal>); + Les constantes ne commencent pas par le signe (<literal>$</literal>); </simpara> </listitem> <listitem> <simpara> - Les constantes sont définies et accessibles à tout endroit du code, - globalement. + Les constantes sont définies et accessibles à tout endroit du code, + globalement. </simpara> </listitem> <listitem> <simpara> - Les constantes ne peuvent pas être redéfinies ou indéfinies une fois qu'elles - ont été définies. + Les constantes ne peuvent pas être redéfinies ou indéfinies + une fois qu'elles ont été définies. </simpara> </listitem> <listitem> @@ -97,169 +98,31 @@ <example> <title>Definir une constante</title> <programlisting> -<?php +<![CDATA[ +<?php define("CONSTANTE", "Bonjour le monde."); echo CONSTANTE; // affiche "Bonjour le monde." echo Constante; // affiche "Constante" et une note. -?> +?> +]]> </programlisting> </example> </para> </sect1> <sect1 id="language.constants.predefined"> <title>Constantes prédéfinies</title> - <para> - Les constantes prédéfinies sont toujours disponibles. En voici la liste : - <variablelist> - <varlistentry> - <term>__FILE__ (insensible à la casse)</term> - <listitem> - <simpara> - Le nom du fichier qui est actuellement exécuté. - Si cette constante est utilisée dans le cadre d'un fichier - "inclus" (après utilisation de <function>require</function>), - alors le nom du fichier inclus est renvoyée, et non le nom - du fichier parent. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>__LINE__ (insensible à la casse)</term> - <listitem> - <simpara> - Le numéro de la ligne qui est actuellement exécutée. - Si cette constante est utilisée dans le cadre d'un fichier - "inclus" (après utilisation de <function>require</function>), - c'est la position dans le fichier inclus qui est renvoyé. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>PHP_VERSION</term> - <listitem> - <simpara> - La chaîne de caractères de présentation de la - version du PHP qui est actuellement utilisée. Par exemple '4.1.0'. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>PHP_OS</term> - <listitem> - <simpara> - Nom du système d'exploitation qui est utilisé par - la machine qui fait tourner le PHP. Parmi les valeurs possibles : - "AIX", "Darwin" (MacOS), "Linux", "SunOS", "WIN32", "WINNT". - Note : cette liste n'est pas exhaustive. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>&true;</term> - <listitem> - <simpara> - La valeur vraie booléenne, &true;. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>&false;</term> - <listitem> - <simpara> - La valeur faux booléenne, &false;. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>E_ERROR</term> - <listitem> - <simpara> - Dénote une erreur autre qu'une erreur d'analyse ("parse error") - qu'il n'est pas possible de corriger. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>E_WARNING</term> - <listitem> - <simpara> - Dénote un contexte dans lequel le PHP trouve que quelque chose - ne va pas. Mais l'exécution se poursuit tout de même. - Ces alertes-là peuvent être récupérées - par le script lui-même. Un exemple serait une expression - régulière (regexp) invalide dans la fonction - <function>ereg</function>. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>E_PARSE</term> - <listitem> - <simpara> - L'analyseur a rencontré une forme syntaxique invalide - dans le script. Correction de l'erreur impossible. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>E_NOTICE</term> - <listitem> - <simpara> - Quelque chose s'est produit, qui peut être ou non une erreur. - L'exécution continue. Par exemple, le cas de guillemets doubles (") - non refermés, ou bien la tentative d'accéder à - une variable qui n'est pas encore affectée. - </simpara> - </listitem> - </varlistentry> - </variablelist> - <variablelist> - <varlistentry> - <term>E_ALL</term> - <listitem> - <simpara> - Toutes les constantes E_* rassemblées en une seule. Si vous l'utilisez - avec <function>error_reporting</function>, toutes les erreurs et les - problèmes que PHP rencontrera seront notifiés. - </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> - <para> - Les constantes E_* sont généralement utilisées - avec la fonction <function>error_reporting</function>. - </para> - <para> - Vous pouvez définir d'autres constantes en utilisant la fonction - <function>define</function>. - </para> - <para> - Il est à noter que ce sont des constantes, et non pas des macros - comme en C. Seulement les données scalaires peuvent être - représentées par des constantes. - <example> - <title>Définition de constantes </title> - <programlisting role="php"> -<?php - define("CONSTANTE", "Bonjour le monde."); - echo CONSTANTE; -// affiche "Bonjour le monde." -?> - </programlisting> - </example> - <example> - <title>Utilisation des constantes __FILE__ et __LINE__ </title> - <programlisting role="php"> -<?php - function rapport_erreur($file, $line, $message) { - echo "Une erreur est survenue dans le fichier $file à la ligne $line: $message."; - } - rapport_erreur(__FILE__, __LINE__, "Il y a un problème!"); -?> - </programlisting> - </example> - </para> + <simpara> + PHP fournit un grand nombre de constantes prédéfinies. Certaines + constantes sont définies par différentes extensions, et ne seront + présentes que si ces extensions sont compilées avec &php;, ou bien + si l'extension a été chargée dynamiquement. + </simpara> + + <simpara> + Une liste des constantes prédéfinies est disponible dans la + section + <link linkend="reserved.constants">Constantes prédéfinies</link>. + </simpara> </sect1> </chapter> <!-- Keep this comment at the end of the file Index: phpdoc-fr/language/control-structures.xml diff -u phpdoc-fr/language/control-structures.xml:1.18 phpdoc-fr/language/control-structures.xml:1.19 --- phpdoc-fr/language/control-structures.xml:1.18 Tue Sep 10 22:17:20 2002 +++ phpdoc-fr/language/control-structures.xml Mon Feb 3 07:27:11 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> +<!-- $Revision: 1.19 $ --> <chapter id="control-structures"> <title>Les structures de contrôle</title> <simpara> @@ -33,11 +33,15 @@ </informalexample> </para> <simpara> - Comme nous l'avons vu dans le paragraphe consacré aux expressions, - <replaceable>expr</replaceable> est évaluée à - sa vraie valeur. Si l'expression <replaceable>expr</replaceable> est + Comme nous l'avons vu dans le paragraphe consacré aux + <link linkend="language.expressions">expressions</link>, + <replaceable>expr</replaceable> est convertie en sa valeur + booléenne. Si l'expression <replaceable>expr</replaceable> vaut &true;, PHP exécutera l'instruction et si elle - est &false;, l'instruction sera ignorée. + vaut &false;, l'instruction sera ignorée. + Plus de détails sur les vlaeurs qui valent &false; est disponbile dans + la section + <link linkend="language.types.boolean.casting">Conversion en booléen</link>. </simpara> <para> L'exemple suivant affiche la phrase <computeroutput>a est plus grand @@ -149,12 +153,14 @@ </informalexample> </para> <simpara> - Vous pouvez avoir plusieurs <literal>elseif</literal> qui s'imbriquent - les uns dans les autres, après un <literal>if</literal> initial. + Vous pouvez avoir plusieurs <literal>elseif</literal> qui se suivent + les uns après les autres, après un <literal>if</literal> initial. Le premier <literal>elseif</literal> qui sera évalué à &true; sera exécuté. En PHP, vous pouvez aussi écrire "else if" en deux mots et son comportement sera - identique à la version en un seul mot. + identique à la version en un seul mot. La sémantique des + deux expression est légèrement différente, mais au bout du compte, + le résultat sera exactement le même. </simpara> <simpara> L'expression <literal>elseif</literal> est exécutée @@ -181,13 +187,9 @@ <informalexample> <programlisting role="php"> <![CDATA[ -<?php - if ($a == 5): -?> - A vaut 5 -<?php - endif; - ?> +<?php if ($a == 5): ?> +A égal 5 +<?php endif; ?> ]]> </programlisting> </informalexample> @@ -577,41 +579,57 @@ <programlisting role="php"> <![CDATA[ <?php -/* exemple 1: valeurs seules */ +/* exemple foreach 1 : la valeur seulement */ + $a = array (1, 2, 3, 17); + foreach ($a as $v) { - print "Valeur courante de \$a: $v.\n"; + print "Current value of \$a: $v.\n"; } -/* exemple 2: valeurs (avec la clé correspondante) */ + +/* exemple foreach 2 : la valeur et sa clé d'index */ + $a = array (1, 2, 3, 17); -$i = 0; /* pour l'illustration uniquement */ + +$i = 0; /* uniquement pour l'illustration */ + foreach($a as $v) { print "\$a[$i] => $v.\n"; + $i++; } -/* exemple 3: clé et valeur */ + +/* exemple foreach 3 : la clé et la valeur */ + $a = array ( "un" => 1, "deux" => 2, "trois" => 3, "dix-sept" => 17 ); + foreach($a as $k => $v) { print "\$a[$k] => $v.\n"; } -/* exemple 4: tableaux multi-dimensionnels */ + +/* exemple foreach 4 : tableaux multi-dimensionnels */ + $a[0][0] = "a"; $a[0][1] = "b"; $a[1][0] = "y"; $a[1][1] = "z"; + foreach($a as $v1) { foreach ($v1 as $v2) { print "$v2\n"; } } -/* exemple 5: tableaux dynamique */ + +/* exemple foreach 5 : tableaux dynamiques */ + foreach(array(1, 2, 3, 4, 5) as $v) { print "$v\n"; } + ?> ]]> </programlisting> @@ -662,6 +680,7 @@ </informalexample> </para> </sect1> + <sect1 id="control-structures.continue"> <title><literal>continue</literal></title> <simpara> @@ -933,10 +952,10 @@ intervenir par tick. </para> <para> - <informalexample> + <example> + <title>Profile a section of PHP code</title> <programlisting role="php"> <![CDATA[ -<PRE> <?php // Un fonction qui enregistre l'heure à laquelle elle est appelée function profile($dump = FALSE){ @@ -949,32 +968,26 @@ } $profile[] = microtime (); } + // Enregistre un gestionnaire de tick register_tick_function("profile"); + // Initialise la fonction avant le bloc de déclaration profile(); + // Exécute un bloc de code, et appele un tick toutes les deux secondes declare (ticks=2) { for ($x = 1; $x < 50; ++$x) { echo similar_text(md5($x), md5($x*$x)), "<br>"; } } -?> -]]> - </programlisting> - </informalexample> - Pour voir le résultat : - <informalexample> - <programlisting role="php"> -<![CDATA[ -<?php + // Affiche les données de la variable $profile print_r(profile(TRUE)); ?> -</pre> ]]> </programlisting> - </informalexample> + </example> Cet exemple profile le code PHP dans le bloc de déclaration, et enregistre l'heure de chaque commande bas niveau. Cette information peut être réutilisée pour débusquer les segments @@ -993,76 +1006,73 @@ </simpara> </sect2> </sect1> + <sect1 id="function.return"> + <title>return</title> + <simpara> + Si appelé depuis une fonction, la commande <function>return</function> + termine immédiatement la fonction, et retourne l'argument qui lui + est passé. <function>return</function> interromp aussi l'exécution + de commande <function>eval</function> ou de scripts. + </simpara> + <simpara> + Si appelée depuis l'environnement global, l'exécution du script + est interrompue. Si le script courant était + <function>include</function> ou <function>require</function>, + alors le contrôle est rendu au script appelant, et la valeur + retournée sera utilisée comme résultat de la fonction + <function>include</function>. Si <function>return</function> est + appelé depuis le script principal, alors l'exécution du script + s'arrête. Si le script courant est + <link linkend="ini.auto-prepend-file">auto_prepend_file</link> ou + <link linkend="ini.auto-append-file">auto_append_file</link> + dans le fichier &php.ini;, alors l'exécution du script + s'arrête. + </simpara> + <simpara> + Pour plus d'informations, voyez + <link linkend="functions.returning-values">retourner des valeurs</link>. + </simpara> + <note> + <simpara> + Notez que puisque <function>return</function> est une structure de language + et non pas une fonction, les parenthèses <emphasis>ne sont pas</emphasis> requises : + en fait, il est classique de les ignorer, même si cela ne change rien. + </simpara> + </note> + </sect1> <sect1 id="function.require"> <title><function>require</function></title> <simpara> + <function>require</function> inclut et exécute un + fichier PHP. + </simpara> + <simpara> La commande <function>require</function> se remplace elle-même - par le contenu du fichier spécifié, comme les - préprocesseurs C le font avec la commande <literal>#include</literal>. + par le contenu du fichier spécifié, tel que + décrit dans la documentation de la fonction <function>include</function>. </simpara> <simpara> - Il est important de noter que lorsqu'un fichier est - <function>include</function> ou <function>require</function>, - les erreurs d'analyse apparaîtront en HTML tout au début - du fichier, et l'analyse du fichier parent ne sera pas interrompue. Pour - cette raison, le code qui est dans le fichier doit être placé - entre <link linkend="language.basic-syntax.phpmode">les balises habituelles - de PHP</link>. - </simpara> - <simpara> - <function>require</function> n'est pas vraiment une fonction PHP : - c'est plus une instruction du langage. Elle ne fonctionne pas comme - les fonctions standards. Par exemple, <function>require</function> - est indépendante des structures de contrôle (cela ne sert à rien - de la placer dans une condition, elle sera toujours exécutée). De plus, - elle ne retourne aucune valeur. Lire une valeur retournée par un - <function>require</function> retourne une erreur d'analyse. - </simpara> - <simpara> - Contrairement à <function>include</function>, - <function>require</function> va <emphasis>toujours</emphasis> lire dans - le fichier cible, même si la ligne n'est jamais - exécutée. Si vous souhaitez une inclusion - conditionnelle, utilisez <function>include</function>. La - condition ne va jamais affecter <function>require</function>. - Cependant, si la ligne de <function>require</function> - n'est jamais exécutée, le code du fichier ne - le sera jamais non plus. - </simpara> - <simpara> - Les boucles n'affectent pas le comportement de - <function>require</function>. Même si le code - contenu dans le fichier source est appelé dans la boucle, - <function>require</function> n'est exécuté qu'une - fois. - </simpara> - <para> - Cela signifie qu'on ne peut pas mettre un - <function>require</function> dans une boucle, et s'attendre - à ce qu'il inclue du code à chaque itération. - Pour cela, il faut utiliser <function>include</function>. - <informalexample> - <programlisting role="php"> -<![CDATA[ -<?php - require('header.inc'); -?> -]]> - </programlisting> - </informalexample> - </para> + <function>require</function> et <function>include</function> + sont identiques, sauf dans leur façon de gérer les erreurs. + <function>include</function> produite une + <link linkend="internal.e-warning">Alerte (warning)</link> tandis + que <function>require</function> génère une + <link linkend="internal.e-error">erreur fatale</link>. En + d'autres termes, n'hésitez pas à utiliser + <function>require</function> si vous voulez qu'un fichier + d'inclusion manquant interrompe votre script. + <function>include</function> ne se comporte pas de cette façon, + et le script continuera son exécution. Assurez vous d'avoir + bien configuré le <link linkend="ini.include-path">include_path</link> + aussi. + </simpara> <para> - Attention : <function>include</function> et - <function>require</function> ajoutent le contenu du fichier cible - dans le script lui-même. Elles n'utilisent pas le protocole - HTTP ou tout autre protocole. Toute variable qui est dans le - champs du script sera accessible dans le fichier d'inclusion, - et vice-versa. - <informalexample> + <example> + <title>Exemples avec <function>require</function></title> <programlisting role="php"> <![CDATA[ <?php - require ("file.inc?varone=1&vartwo=2"); + require ("file.inc?varone=1&vartwo=2"); /* Ne fonctionne pas. */ $varone = 1; $vartwo = 2; @@ -1071,31 +1081,127 @@ ?> ]]> </programlisting> - </informalexample> + </example> </para> <simpara> - Ne vous laissez pas abuser par le fait que vous pouvez - requérir ou inclure des fichiers via HTTP en - utilisant la fonctionnalité de - <link linkend="features.remote-files">gestion des fichiers distants</link> - ce qui est au dessus reste vrai. + Voyez la documentation de la fonction <function>include</function> pour plus + d'exemples. </simpara> + <note> + <simpara> + Avant PHP 4.0.2, ceci s'appliquait : <function>require</function> tentait + de lire le fichier cible, même si les lignes n'étaient pas utilisées. + Une condition if n'avait aucun effet sur <function>require</function>. Cependant, + si la ligne du <function>require</function> n'est jamais utilisée, + le code inclus ne le sera pas non plus. De même, les boucles n'ont pas + d'effet sur le comportement de <function>require</function>. Bien que le + code contenu dans le fichier subit la boucle, la fonction elle même + <function>require</function> n'est appelée qu'une fois. + </simpara> + </note> + &warn.no-win32-fopen-wrapper; <simpara> - En PHP 3, il est possible d'exécuter une commande - <literal>return</literal> depuis un fichier inclut, tant - que cette commande intervient au niveau global du fichier - inclus. Elle ne doit intervenir dans aucun bloc (entre accolade {}). - En PHP 4, cette possibilité a été - supprimée. Si vous en avez besoin, utilisez plutôt - <function>include</function>. + Voir aussi + <function>include</function>, + <function>require_once</function>, + <function>include_once</function>, + <function>eval</function>, + <function>file</function>, + <function>readfile</function>, + <function>virtual</function> et + <link linkend="ini.include-path">include_path</link>. </simpara> </sect1> <sect1 id="function.include"> <title><function>include</function></title> <simpara> - La fonction <function>include</function> inclus et évalue le - fichier spécifié en argument. + La fonction <function>include</function> inclus et éxécute + le fichier spécifié en argument. + </simpara> + <simpara> + Cette documentation s'applique aussi à la fonction + <function>require</function>. Les deux structures de + langage sont identiques, hormis dans leur gestion des + erreurs. + <function>include</function> produite une + <link linkend="internal.e-warning">Alerte (warning)</link> tandis + que <function>require</function> génère une + <link linkend="internal.e-error">erreur fatale</link>. En + d'autres termes, n'hésitez pas à utiliser + <function>require</function> si vous voulez qu'un fichier + d'inclusion manquant interrompe votre script. + <function>include</function> ne se comporte pas de cette façon, + et le script continuera son exécution. Assurez vous d'avoir + bien configuré le <link linkend="ini.include-path">include_path</link> + aussi. + </simpara> + <simpara> + Lorsqu'un fichier est inclus, le code qu'il contient hérite + des variables qui existent dans ce + <link linkend="language.variables.scope">contexte</link>. + Toute variable accessible à la ligne qui réalise l'exécution + est aussi accessible dans le fichier inclus. + </simpara> + <para> + <example> + <title>Exemple avec <function>include</function></title> + <programlisting role="php"> +<![CDATA[ +vars.php +<?php + +$couleur = 'verte'; +$fruit = 'pomme'; + +?> + +test.php +<?php + +echo "Une $couleur $fruit"; // Une + +include 'vars.php'; + +echo "Une $color $fruit"; // Une verte pomme + +?> +]]> + </programlisting> + </example> + </para> + <simpara> + Si l'inclusion intervient à l'intérieure d'une fonction, + le code inclus sera alors considéré comme faisant partie de la + fonction. Cela modifie donc le contexte de variables accessibles. </simpara> + <para> + <example> + <title>Inclusion de fichiers dans une fonction</title> + <programlisting role="php"> +<![CDATA[ +<?php + +function foo() { + global $couleur; + + include 'vars.php'; + + echo "Une $couleur $fruit"; +} + +/* vars.php est dans le contexte de foo() * + * donc $fruit n'est pas dispnibles hors de * + * cette fonction. $couleur l'est, car c'est * + * une variable globale */ + +foo(); // Une verte pomme +echo "Une $couleur $fruit"; // Une verte + +?> +]]> + </programlisting> + </example> + </para> <simpara> Il est important de noter que lorsqu'un fichier est <function>include</function> ou <function>require</function>, @@ -1106,189 +1212,163 @@ <link linkend="language.basic-syntax.phpmode">les balises habituelles de PHP</link>. </simpara> + <simpara> + Si les "<link linkend="ini.allow-url-fopen">URL fopen wrappers</link>" + sont activés dans &php; (ce qui est le cas par défaut), + vous pouvez localiser le fichier avec une URL (via HTTP ou + bien avec un gestionnaire adapté : voir <xref linkend="wrappers"/> + pour une liste des protocoles), au lieu d'un simple chemin + local. Si le serveur distant interprête le fichier comme du code + PHP, des variables peuvent être transmises au serveur distant + via l'URL et la méthode GET. Ce n'est pas, à strictement + parler, la même chose que d'hériter du contexte de variable. + Le fichier inclus est en fait un script exécuté à distance, + et son résultat est inclus dans le code courant. + </simpara> + &warn.no-win32-fopen-wrapper; <para> - Cela se produit à chaque fois que la fonction - <function>include</function> est rencontrée. Donc, vous - pouvez utiliser la fonction <function>include</function> - dans une boucle pour inclure un nombre infini de - fois un fichier, ou même des fichiers différents. - <informalexample> + <example> + <title>Utiliser <function>include</function> via HTTP</title> <programlisting role="php"> <![CDATA[ <?php -$files = array ('premier.inc', 'second.inc', 'troisieme.inc'); -for ($i = 0; $i < count($files); $i++) { - include $files[$i]; -} + +/* Cet exemple suppose que www.exemple.com est configur pour traiter + * les fichiers .php et non pas les fichiers .txt. De plus, + * 'Work' signifie ici que les variables + * $foo et $bar sont disponibles dans le fichier inclus + */ + +// Ne fonctionne pas : file.txt n'a pas été traité par www.exemple.com comme du PHP +include 'http://www.example.com/file.txt?foo=1&bar=2'; + +// Ne fonctionne pas : le script cherche un fichier nommé +// 'file.php?foo=1&bar=2' sur le système local +include 'file.php?foo=1&bar=2'; + +// Réussi +include 'http://www.example.com/file.php?foo=1&bar=2'; + +$foo = 1; +$bar = 2; +include 'file.txt'; // OK. +include 'file.php'; // OK. + ?> ]]> </programlisting> - </informalexample> + </example> + Voir aussi + <link linkend="features.remote-files">travailler avec les fichiers distants</link>, + <function>fopen</function> et + <function>file</function> pour des informations reliées. </para> <para> - <function>include</function> diffère de - <function>require</function> car le fichier inclus est - ré-évaluée à chaque fois que la - commande est exécutée, tandis que - <function>require</function> est remplacée - par le fichier cible lors de la première - exécution, que son contenu soit utilisé - ou non. De plus, cela se fait même s'il - est placé dans une structure conditionnelle, - comme dans un <link linkend="control-structures.if">if</link>). + Comme <function>include</function> et <function>require</function> + sont des structures du langages particulières, vous devez les + placer dans un bloc si ils sont placés dans un bloc conditionnel. </para> <para> - Parceque la fonction <function>include</function> nécessite - une construction particulière, vous devez l'inclure dans un - bloc si elle est incluse dans une structure conditionnelle. - <informalexample> + <example> + <title><function>include</function> et les conditions</title> <programlisting role="php"> <![CDATA[ <?php -/* Ceci est faux, et ne fonctionnera pas comme on l'attend. */ +// Ceci est FAUX et échouera if ($condition) - include($file); + include $file; else - include($other); -/* Ceci est CORRECT. */ + include $other; + + +// Ceci est CORRECT. if ($condition) { - include($file); + include $file; } else { - include($other); + include $other; } + ?> ]]> </programlisting> - </informalexample> + </example> </para> <simpara> - En PHP 3, il est possible d'exécuter une commande - <literal>return</literal> depuis un fichier inclus, tant - que cette commande intervient au niveau global du fichier - inclus. Elle ne doit intervenir dans aucun bloc (entre accolade - {}). En PHP 4, cette possibilité a été - supprimée. Cependant, PHP 4 vous autorise à - retourner des valeurs d'un fichier inclus. Vous pouvez - traiter <function>include</function> comme une fonction - normale, qui retourne une valeur. Mais cela génère - une erreur d'analyse en PHP 3. + Gestion du retour : il est possible d'éxécuter une commande + <function>return</function> dans un fichier inclus pour en + terminer le traitement et retourner au fichier appelant. De plus, + il est possible de retourner des valeurs des fichiers inclus. + vous pouvez prendre et traiter la valeur retournée par la + fonction, comme toute autre fonction. </simpara> - <example> - <title><function>include</function> en PHP 3 et PHP 4</title> - <para> - On suppose que le fichier <filename>test.inc</filename> existe, - et est placé dans le même dossier que le fichier - principal : - <programlisting role="php"> -<![CDATA[ -<?php -echo "Avant le retour<br>\n"; -if (1) { - return 27; -} -echo "Après le retour <br>\n"; -?> -]]> - </programlisting> - </para> - <para> - On suppose que le fichier <filename>main.html</filename> contient ceci : - <programlisting role="php"> + <note> + <simpara> + En PHP 3, le retourn n'est pas utilisable à moins que ce + ne soit dans un bloc de fonction, auquel cas le + <function>return</function> s'applique à une fonction et non + pas au fichier. + </simpara> + </note> + <para> + <example> + <title><function>include</function> et <function>return</function></title> + <programlisting role="php"> <![CDATA[ +return.php <?php -$retval = include ('test.inc'); -echo "Fichier inclus: '$retval'<br>\n"; + +$var = 'PHP'; + +return $var; + ?> -]]> - </programlisting> - </para> - <para> - Lorsque <filename>main.html</filename> est appelé en PHP 3, - il va générer une erreur d'analyse (parse error) - à la ligne 2; vous ne pouvez pas vous attendre à un - retour sur une fonction <function>include</function> en PHP 3. En - PHP 4, cependant,le résultat sera : - <screen> -Avant le retour -Ficher inclus : '27' - </screen> - </para> - <para> - Supposons maintenant que <filename>main.html</filename> a - été modifié et contient maintenant le - code suivant : - <programlisting role="php"> -<![CDATA[ + +noreturn.php <?php - include ('test.inc'); - echo "Retour dans le main.html<br>\n"; + +$var = 'PHP'; + ?> -]]> - </programlisting> - </para> - <para> - En PHP 4, l'affichage sera : - <screen> -Avant le retour -Retour dans le main.html - </screen> - Au contraire, PHP 3 affichera : - <screen> -Avant le retour -27Retour dans le main.html -Parse error: parse error in /home/torben/public_html/phptest/main.html on line 5 - </screen> - </para> - <para> - L'erreur d'analyse ci-dessus est le résultat du fait que la commande - <literal>return</literal> est dans un bloc qui n'est pas une fonction, dans - <filename>test.inc</filename>. Lorsque le return est sorti du bloc, - l'affichage devient : - <screen> -Avant le retour -27Retour dans le main.html - </screen> - </para> - <para> - Le '27' est du au fait que PHP 3 ne supporte pas le <literal>return</literal> - dans ces fichiers. - </para> - </example> - <para> - Il est important de noter que lorsqu'un fichier est <function>include</function> - ou <function>require</function>, les erreurs d'analyse apparaîtront en - HTML tout au début du fichier, et l'analyse du fichier parent ne sera - pas interrompue. Pour cette raison, le code qui est dans le fichier doit - être placé entre - <link linkend="language.basic-syntax.phpmode">les balises habituelles de PHP</link>. - <informalexample> - <programlisting role="php"> -<![CDATA[ + +testreturns.php <?php - include ("file.inc?varone=1&vartwo=2"); /* ne fonctionne pas. */ - $varone = 1; - $vartwo = 2; - include ("file.inc"); - /* $varone et $vartwo sont accessibles dans file.inc */ + +$foo = include 'return.php'; + +echo $foo; // prints 'PHP' + +$bar = include 'noreturn.php'; + +echo $bar; // prints 1 + ?> ]]> - </programlisting> - </informalexample> + </programlisting> + </example> </para> <simpara> - Ne vous laissez pas abuser par le fait que vous pouvez requérir - ou inclure des fichiers via HTTP en utilisant la fonctionnalité - de <link linkend="features.remote-files">gestion des fichiers distants - </link> ce qui est au dessus reste vrai. + <literal>$bar</literal> a la valeur de <literal>1</literal> car + l'inclusion était réussie. Notez la différence entre les deux + exemples ci-dessus. Le premier utilise la commande <function>return</function> + dans le fichier inclus, alors que le second ne le fait pas. + Un autre moyen d'inclure des fichiers dans des variables + est d'utiliser la fonction <function>fopen</function> ou + <function>file</function> ou d'utiliser + <function>include</function> avec les + <link linkend="ref.outcontrol">fonctions de contrôle de sortie</link>. </simpara> + <simpara> - Voir aussi + Voir aussi + <function>require</function>, + <function>require_once</function>, + <function>include_once</function>, <function>readfile</function>, - <function>require</function> et - <function>virtual</function>. + <function>virtual</function> et + <link linkend="ini.include-path">include_path</link>. </simpara> - </sect1> + </sect1> <sect1 id="function.require-once"> <title><function>require_once</function></title> <para> @@ -1302,138 +1382,51 @@ variables ou de fonctions, génératrices d'alertes. </para> <para> - Par exemple, si vous créez les deux fichiers d'inclusion - <literal>utils.inc</literal> et <literal>foolib.inc</literal> - <example> - <title>utils.inc</title> - <programlisting role="php"> -<![CDATA[ -<?php -define(PHPVERSION, floor(phpversion())); -echo "LES GLOBALES SONT SYMPAS\n"; -function goodTea() { - return "Le Earl Grey est délicieux!"; -} -?> -]]> - </programlisting> - </example> - <example> - <title>foolib.inc</title> - <programlisting role="php"> -<![CDATA[ -<?php -require ("utils.inc"); -function showVar($var) { - if (PHPVERSION == 4) { - print_r($var); - } else { - dump_var($var); - } -} -// Une série de fonctions -?> -]]> - </programlisting> - </example> - Puis, vous écrivez un script <literal>cause_error_require.php</literal> - <example> - <title>cause_error_require.php</title> - <programlisting role="php"> -<![CDATA[ -<?php - require("foolib.inc"); -/* Ceci génère une erreur*/ - require("utils.inc"); - $foo = array("1",array("complex","quaternion")); - echo "Ce code requiert utils.inc une deuxième fois, car il est requis \n"; - echo "dans foolib.inc\n"; - echo "Utilisation de GoodTea: ".goodTea()."\n"; - echo "Affichage de foo: \n"; - showvar($foo); -?> -]]> - </programlisting> - </example> - Lorsque vous exécutez le script ci-dessus, le - résultat sera (sous PHP 4.01pl2): - <informalexample> - <programlisting> -GLOBALS ARE NICE -GLOBALS ARE NICE -Fatal error: Cannot redeclare causeerror() in utils.inc on line 5 - </programlisting> - </informalexample> - En modifiant <literal>foolib.inc</literal> et - <literal>cause_errror_require.php</literal> - pour qu'elles utilisent <function>require_once</function> - au lieu de <function>require</function> et ne renommant pas le fichier - en <literal>avoid_error_require_once.php</literal>, on obtient : - <example> - <title>foolib.inc (corrigé)</title> - <programlisting role="php"> + <function>require_once</function> doit être utilisée dans les cas + où le même fichier risque d'être inclus et évaluée plusieurs fois + durant l'exécution d'un script. Vous serez alors sur be used in cases where + the same file might be included and evaluated more than once during a + particular execution of a script, and you want to be sure that it is + included exactly once to avoid problems with function redefinitions, + variable value reassignments, etc. + </para> + <para> + Pour des exemples avec <function>require_once</function> et + <function>include_once</function>, reportez-vous au code + <ulink url="&url.php.pear;">PEAR</ulink> inclut dans les + dernières distributions PHP. + </para> + <note> + <para> + <function>require_once</function> a été ajouté en PHP 4.0.1pl2 + </para> + </note> + <note> + <para> + Attention, <function>require_once</function> et + <function>include_once</function> sont sensibles à la casse + sous Windows. + <example> + <title><function>require_once</function> est sensible à la casse</title> + <programlisting role="php"> <![CDATA[ -<?php - require_once("utils.inc"); - function showVar($var) { -?> +require_once("a.php"); // ceci inclut le fichier a.php +require_once("A.php"); // ceci inclut encore le fichier a.php sous Windows! ]]> - </programlisting> - </example> - <example> - <title>avoid_error_require_once.php</title> - <programlisting role="php"> -<![CDATA[ -<?php - require_once("foolib.inc"); - require_once("utils.inc"); - $foo = array("1",array("complexe","quaternion")); -?> -]]> - </programlisting> - </example> - L'exécution de ce script, sous PHP 4.0.1pl2, donne : - <informalexample> - <programlisting> -LES GLOBALES SONT SYMPA -Ce code requiert utils.inc une deuxième fois, car il est requis -dans foolib.inc -Utilisation de GoodTea: Le Earl Grey est délicieux! -Affichage de foo: -Array -( - [0] => 1 - [1] => Array - ( - [0] => complexe - [1] => quaternion - ) -) - </programlisting> - </informalexample> - </para> - <para> - Notez aussi que, de la même manière que les - préprocesseurs traitent les <literal>#include</literal>, - cette commande est exécutée au moment de la - compilation, c'est-à-dire lorsque le script est - analysée, et avant qu'il soit exécuté, - et ne doit pas être utilisée pour insérer - des données dynamiques liées à - l'éxécution. Il vaut alors mieux utiliser - <function>include_once</function> ou <function>include</function>. - </para> - <para> - Pour plus d'exemples avec <function>require_once</function> et - <function>include_once</function>, jetez un oeil dans le code de PEAR - inclus dans la dernière distribution de PHP. - </para> + </programlisting> + </example> + </para> + </note> + &warn.no-win32-fopen-wrapper; <para> - Voir aussi : <function>require</function>, - <function>include</function>, <function>include_once</function>, + Voir aussi + <function>require</function>, + <function>include</function>, + <function>include_once</function>, <function>get_required_files</function>, - <function>get_included_files</function>, <function>readfile</function>, - et <function>virtual</function>. + <function>get_included_files</function>, + <function>readfile</function> et + <function>virtual</function>. </para> </sect1> <sect1 id="function.include-once"> Index: phpdoc-fr/language/expressions.xml diff -u phpdoc-fr/language/expressions.xml:1.8 phpdoc-fr/language/expressions.xml:1.9 --- phpdoc-fr/language/expressions.xml:1.8 Tue Aug 13 22:19:28 2002 +++ phpdoc-fr/language/expressions.xml Mon Feb 3 07:27:11 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <chapter id="language.expressions"> <title>Les expressions</title> <simpara> @@ -24,11 +24,13 @@ la fonction suivante : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function foo () { return 5; } -?> +?> +]]> </programlisting> </informalexample> </para> @@ -128,9 +130,11 @@ vueà-dire dans d'autre langage, l'opérateur conditionnel ternaire: <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $first ? $second : $third -?> +?> +]]> </programlisting> </informalexample> Si la valeur de la première sous-expression est vraie @@ -144,7 +148,8 @@ incrémentation et le concept des expressions en général: <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function double($i) { return $i*2; } @@ -162,7 +167,8 @@ $h = $g += 10; /* Tout d'abord, $g est incrémentée de 10, et donc $g vaut 24. Ensuite, la valeur de $g, (24) est assignée à la variable $h, qui vaut donc elle aussi 24. */ -?> +?> +]]> </programlisting> </informalexample> </para> Index: phpdoc-fr/language/functions.xml diff -u phpdoc-fr/language/functions.xml:1.11 phpdoc-fr/language/functions.xml:1.12 --- phpdoc-fr/language/functions.xml:1.11 Wed Dec 12 15:50:07 2001 +++ phpdoc-fr/language/functions.xml Mon Feb 3 07:27:11 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> - <chapter id="function"> +<!-- $Revision: 1.12 $ --> + <chapter id="functions"> <title>Les fonctions</title> <sect1 id="functions.user-defined"> <title>Les fonctions utilisateur</title> @@ -8,12 +8,14 @@ Une fonction peut être définie en utilisant la syntaxe suivante : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function foo ($arg_1, $arg_2, ..., $arg_n) { echo "Exemple de fonction.\n"; return $retval; } -?> +?> +]]> </programlisting> </informalexample> </para> @@ -62,11 +64,13 @@ un tableau comme argument : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function takes_array($input) { echo "$input[0] + $input[1] = ", $input[0]+$input[1]; } -?> +?> +]]> </programlisting> </informalexample> </para> @@ -87,14 +91,16 @@ devant l'argument dans la déclaration de la fonction : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function add_some_extra(&$string) { $string .= ', et un peu plus.'; } $str = 'Ceci est une chaîne'; add_some_extra($str); echo $str; // affiche 'Ceci est une chaîne, et un peu plus.' -?> +?> +]]> </programlisting> </informalexample> </para> @@ -105,7 +111,8 @@ devant l'argument dans l'appel de la fonction: <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function foo ($bar) { $bar .= ', et un peu plus.'; } @@ -114,7 +121,8 @@ echo $str; // affiche 'Ceci est une chaîne' foo (&$str); echo $str; // affiche 'Ceci est une chaîne, et un peu plus.' -?> +?> +]]> </programlisting> </informalexample> </para> @@ -126,13 +134,15 @@ défaut pour les arguments de type scalaire : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function servir_apero ($type = "ricard") { return "Servir un verre de $type.\n"; } echo servir_apero(); echo servir_apero("whisky"); -?> +?> +]]> </programlisting> </informalexample> </para> @@ -156,12 +166,14 @@ Considérons le code suivant : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function faireunyaourt ($type = "acidophilus", $flavour) { return "Préparer un bol de $type $flavour.\n"; } echo faireunyaourt ("framboise"); // ne fonctionne pas comme voulu -?> +?> +]]> </programlisting> </informalexample> </para> @@ -178,12 +190,14 @@ l'exemple suivant : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function faireunyaourt ($flavour, $type = "acidophilus") { return "Préparer un bol de $type $flavour.\n"; } echo faireunyaourt ("framboise"); // fonctionne comme voulu -?> +?> +]]> </programlisting> </informalexample> </para> @@ -218,12 +232,14 @@ peuvent être renvoyés, tableaux et objets compris. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function carre ($num) { return $num * $num; } echo carre (4); // affiche '16'. -?> +?> +]]> </programlisting> </informalexample> </para> @@ -233,12 +249,14 @@ en renvoyant un tableau. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function petit_nombre() { return array (0, 1, 2); } list ($zero, $one, $two) = petit_nombre(); -?> +?> +]]> </programlisting> </informalexample> </para> @@ -248,12 +266,14 @@ l'assignation de la valeur de retour. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function &retourne_reference() { return $uneref; } $newref =&retourne_reference(); -?> +?> +]]> </programlisting> </informalexample> </para> @@ -303,7 +323,8 @@ <example> <title>Exemple de fonction variable</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php function foo() { echo "dans foo()<br>\n"; } @@ -314,7 +335,8 @@ $func(); $func = 'bar'; $func( 'test' ); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/language/oop.xml diff -u phpdoc-fr/language/oop.xml:1.18 phpdoc-fr/language/oop.xml:1.19 --- phpdoc-fr/language/oop.xml:1.18 Tue Aug 13 22:19:28 2002 +++ phpdoc-fr/language/oop.xml Mon Feb 3 07:27:11 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> +<!-- $Revision: 1.19 $ --> <chapter id="language.oop"> <title>Les classes et les objets</title> <sect1 id="keyword.class"> @@ -10,24 +10,29 @@ en utilisant la syntaxe suivante : <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class Caddie { - var $items; // Eléments de notre panier - // Ajout de $num articles de type $artnr au panier +// Eléments de notre panier + var $items; + +// Ajout de $num articles de type $artnr au panier function add_item ($artnr, $num) { $this->items[$artnr] += $num; } - // Suppression de $num articles du type $artnr du panier + +// Suppression de $num articles du type $artnr du panier function remove_item ($artnr, $num) { - if ($this->items[$artnr] > $num) { + if ($this->items[$artnr] > $num) { $this->items[$artnr] -= $num; return &true;; } else { - return <literal>FALSE</literal>; + return FALSE; } } } -?> +?> +]]> </programlisting> </informalexample> </para> @@ -69,7 +74,8 @@ </simpara> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php /* Aucune de ces syntaxes ne fonctionnera en PHP 4 */ class Caddie { var $date_du_jour = date("d/m/Y"); @@ -89,7 +95,8 @@ /* etc... */ } } -?> +?> +]]> </programlisting> </informalexample> </note> @@ -99,12 +106,15 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php $cart = new Caddie; $cart->add_item("10", 1); $another_cart = new Cart; $another_cart->add_item("0815", 3); -?> +?> +]]> + </programlisting> </informalexample> <para> @@ -131,8 +141,9 @@ </para> <informalexample> <programlisting role="php"> -<?php -// correct, $ unique + <![CDATA[ +<?php +// correct, le signe $ est unique $cart->items = array("10" => 1); // incorrect, car $cart->$items devient $cart->"" $cart->$items = array("10" => 1); @@ -140,7 +151,8 @@ // $cart->$myvar devient $ncart->items $myvar = 'items'; $cart->$myvar = array("10" => 1); -?> +?> +]]> </programlisting> </informalexample> <para> @@ -174,34 +186,38 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class Caddie_nomme extends Caddie { var $owner; function set_owner ($name) { $this->owner = $name; } } -?> +?> +]]> </programlisting> </informalexample> <para> L'exemple ci-desssus définit la classe Caddie_nomme qui - possède les même variables que la classe Caddie et + possède les mêmes variables que la classe Caddie et la variable $owner en plus, ainsi que la fonction set_owner(). Vous créez un panier nominatif de la même manière que précédemment, et vous pouvez alors affecter un nom au panier ou en connaître le nom. Vous pouvez de - toutes les façons utiliser les même fonctions que sur un + toutes les façons utiliser les mêmes fonctions que sur un panier classique. </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php $ncart = new Caddie_nomme; // Création d'un panier nominatif $ncart->set_owner ("kris"); // Affectation du nom du panier print $ncart->owner; // Affichage du nom du panier $ncart->add_item ("10", 1); // (héritage des fonctions de la classe père) -?> +?> +]]> </programlisting> </informalexample> </sect1> @@ -221,19 +237,21 @@ le même nom que la classe. En PHP 3, une fonction devient le constructeur si elle porte le même nom que la classe. En PHP 4, une fonction devient un constructeur - si elle porte le même nom que la classe dans laquelle elle est définit. + si elle porte le même nom que la classe dans laquelle elle est définie. La différence est subtile, mais cruciale. </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class Auto_Caddie extends Caddie { function Auto_Caddie () { $this->add_item ("10", 1); } } // Cette syntaxe est valable en PHP 3 et 4 -?> +?> +]]> </programlisting> </informalexample> <para> @@ -249,7 +267,8 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php // Cette syntaxe est valable en PHP 3 et 4 class Constructor_Cart extends Cart { function Constructor_Cart ($item = "10", $num = 1) { @@ -260,7 +279,8 @@ $default_cart = new Constructor_Cart; // Création d'un vrai caddie $different_cart = new Constructor_Cart ("20", 17); -?> +?> +]]> </programlisting> </informalexample> <caution> @@ -272,25 +292,27 @@ </caution> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class A { function A() { - echo "Je suis le constructeur de A.<br>\n"; + echo "Je suis le constructeur de A.<br>\n"; } } class B extends A { function C() { - "Je suis une fonction standard.<br>\n"; + "Je suis une fonction standard.<br>\n"; } } // Aucun constructeur n'est appelé en PHP 3!! $b = new B; -?> +?> +]]> </programlisting> </informalexample> <para> En PHP 3, aucun constructeur ne sera appelé dans l'exemple ci-dessus. - La règle en PHP 3 est : 'Un constructeur est une fonction qui a le même nom + La règle en PHP 3 est : 'Un constructeur est une méthode qui a le même nom que la classe'. Le nom de la classe est B, et il n'y a pas de fonctions qui s'appelle B() dans la classe B. Rien ne se passe. </para> @@ -302,40 +324,42 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class A { function A() { - echo "Je suis le constructeur de A.<br>\n"; + echo "Je suis le constructeur de A.<br>\n"; } function B() { - echo "Je suis une fonction standard appelée B dans la classe A.<br>\n"; - echo "Je ne suis pas le constructeur de A.<br>\n"; + echo "Je suis une fonction standard appelée B dans la classe A.<br>\n"; + echo "Je ne suis pas le constructeur de A.<br>\n"; } } class B extends A { function C() { - echo "Je suis une fonction standard.<br>\n"; + echo "Je suis une fonction standard.<br>\n"; } } // Cette syntaxe va appeler B() comme constructeur. $b = new B; -?> +?> +]]> </programlisting> </informalexample> <para> En PHP 3, la fonction B() de la classe A va soudaiement devenir le constructeur de la classe B, bien qu'il n'ai pas été prévu pour. La règle de PHP 3 est 'Un constructeur est une - fonction qui a le même nom que la classe'. PHP 3 ne se soucie + méthode qui a le même nom que la classe'. PHP 3 ne se soucie guère si la fonction est définie dans la classe B ou si elle a été héritée. </para> <para> Ceci est corrigé en PHP 4, avec l'introduction d'une nouvelle règle : - 'Un constructeur est une classe de même nom, définit dans la - classe elle-même'. Donc, en PHP 4, la classe B n'a pas de constructeur + 'Un constructeur est une méthode de même nom que la classe, définie + dans la classe elle-même'. Donc, en PHP 4, la classe B n'a pas de constructeur par elle-même, et le constructeur de la classe A aura été appelé, affichant : 'Je suis le constructeur de A.<br>'. @@ -378,29 +402,31 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class A { function example() { - echo "Je suis la fonction originale A::example().<br>\n"; + echo "Je suis la fonction originale A::example().<br>\n"; } } class B extends A { function example() { - echo "Je suis la fonction redéfinie B::example().<br>\n"; + echo "Je suis la fonction redéfinie B::example().<br>\n"; A::example(); } } // Il n'y a pas d'objets de classe A. // L'affichage est : -// Je suis la fonction originale A::example().<br> +// Je suis la fonction originale A::example().<br> A::example(); // Création d'un objet de la classe B. $b = new B; // L'affichage est : -// Je suis la fonction redéfinie B::example().<br> -// Je suis la fonction originale A::example().<br> +// Je suis la fonction redéfinie B::example().<br> +// Je suis la fonction originale A::example().<br> $b->example(); -?> +?> +]]> </programlisting> </informalexample> <para> @@ -452,22 +478,24 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class A { function example() { - echo "Je suis A::example() et je fournis une fonctionnalité de base.<br>\n"; + echo "Je suis A::example() et je fournis une fonctionnalité de base.<br>\n"; } } class B extends A { function example() { - echo "Je suis B::example() et je fournis une fonctionnalité supplémentaire.<br>\n"; + echo "Je suis B::example() et je fournis une fonctionnalité supplémentaire.<br>\n"; parent::example(); } } $b = new B; // Cette syntaxe va appeler B::example(), qui, à sont tour, va appeler A::example(). $b->example(); -?> +?> +]]> </programlisting> </informalexample> </sect1> @@ -510,7 +538,8 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php classa.inc: class A { var $one = 1; @@ -518,9 +547,9 @@ echo $this->one; } } -?> +?> page1.php: -<?php +<?php include("classa.inc"); $a = new A; $s = serialize($a); @@ -528,16 +557,17 @@ $fp = fopen("store", "w"); fputs($fp, $s); fclose($fp); -?> +?> page2.php: -<?php +<?php // Ceci est nécessaire pour que unserialize() fonctionne correctement include("classa.inc"); $s = implode("", @file("store")); unserialize($s); // maintenant, utilisez la méthode show_one de l'objet $a. $a->show_one(); -?> +?> +]]> </programlisting> </informalexample> <para> @@ -590,7 +620,7 @@ variables qui n'ont pas été sauvées. </para> </sect1> - <sect1 id="keyword.newref"> + <sect1 id="language.oop.newref"> <title>Références dans un constructeur</title> <para> Créer des références dans un constructeur peut conduire à @@ -598,25 +628,27 @@ problèmes. <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class foo { function foo($name) { // crée une référence dans le tableau global $globalref global $globalref; - $globalref[] = &$this; + $globalref[] = &$this; // donne le nom de la variable - $this->setName($name); + $this->setName($name); // et l'affiche - $this->echoName(); + $this->echoName(); } function echoName() { - echo "<br>",$this->Name; + echo "<br>",$this->Name; } function setName($name) { - $this->Name = $name; + $this->Name = $name; } } -?> +?> +]]> </programlisting> </informalexample> </para> @@ -627,22 +659,24 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php $bar1 = new foo('crée dans le constructeur'); - $bar1->echoName(); - $globalref[0]->echoName(); + $bar1->echoName(); + $globalref[0]->echoName(); /* affiche : crée dans le constructeur crée dans le constructeur crée dans le constructeur */ $bar2 =&new foo('crée dans le constructeur'); - $bar2->echoName(); - $globalref[1]->echoName(); + $bar2->echoName(); + $globalref[1]->echoName(); /* affiche : crée dans le constructeur crée dans le constructeur crée dans le constructeur */ -?> +?> +]]> </programlisting> </informalexample> <para> @@ -666,69 +700,72 @@ </para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php // maintenant, nous allons changer de nom. Qu'attendez-vous? // Vous pouvez vous attendre à ce que les deux variables $bar // et $globalref[0] changent de nom... - $bar1->setName('modifié'); + $bar1->setName('modifié'); // comme prédit, ce n'est pas le cas - $bar1->echoName(); - $globalref[0]->echoName(); + $bar1->echoName(); + $globalref[0]->echoName(); /* affiche : crée dans le constructeur modifié */ // quelle est la différence entre $bar2 et $globalref[1] - $bar2->setName('modifié'); + $bar2->setName('modifié'); // Heureusement, elles sont non seulement égales, mais // elles représentent la même variable. - // donc $bar2->Name et $globalref[1]->Name sont les mêmes - $bar2->echoName(); - $globalref[1]->echoName(); + // donc $bar2->Name et $globalref[1]->Name sont les mêmes + $bar2->echoName(); + $globalref[1]->echoName(); /* affiche : modifié modifié */ -?> +?> +]]> </programlisting> </informalexample> <para> Un dernier exemple pour bien comprendre. <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php class a { function a($i) { - $this->value = $i; + $this->value = $i; // Essayez de comprendre on n'a pas besoin de // référence ici - $this->b = new b($this); + $this->b = new b($this); } function createRef() { - $this->c = new b($this); + $this->c = new b($this); } function echoValue() { - echo "<br>","class ",get_class($this),': ',$this->value; + echo "<br>","class ",get_class($this),': ',$this->value; } } class b { function b(&$a) { - $this->a = &$a; + $this->a = &$a; } function echoValue() { - echo "<br>","class ",get_class($this),': ',$this->a->value; + echo "<br>","class ",get_class($this),': ',$this->a->value; } } // Essayez de comprendre pourquoi une copie simple va // conduire à un résultat indésirable à // la ligne marquée d'une étoile $a =&new a(10); -$a->createRef(); -$a->echoValue(); -$a->b->echoValue(); -$a->c->echoValue(); -$a->value = 11; -$a->echoValue(); -$a->b->echoValue(); // * -$a->c->echoValue(); +$a->createRef(); +$a->echoValue(); +$a->b->echoValue(); +$a->c->echoValue(); +$a->value = 11; +$a->echoValue(); +$a->b->echoValue(); // * +$a->c->echoValue(); /* output: class a: 10 @@ -738,7 +775,9 @@ class b: 11 class b: 11 */ -?> +?> +]]> + </programlisting> </informalexample> </para> Index: phpdoc-fr/language/operators.xml diff -u phpdoc-fr/language/operators.xml:1.18 phpdoc-fr/language/operators.xml:1.19 --- phpdoc-fr/language/operators.xml:1.18 Fri Jun 28 13:36:36 2002 +++ phpdoc-fr/language/operators.xml Mon Feb 3 07:27:11 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> +<!-- $Revision: 1.19 $ --> <chapter id="language.operators"> <title>Les opérateurs</title> <simpara> @@ -112,6 +112,15 @@ </tgroup> </table> </para> + <note> + <para> + Bien que <literal>!</literal> soit prioritaire sur + <literal>=</literal>, &php; va tout de même exécuter des + expressions comme : <literal>if (!$a = foo())</literal>. + Dans cette situation, le résultat de <literal>foo()</literal> + sera placé dans la variable <varname>$a</varname>. + </para> + </note> </sect1> <sect1 id="language.operators.arithmetic"> <title>Les opérateurs arithmétiques</title> @@ -452,7 +461,7 @@ <![CDATA[ <?php $output = `ls -al`; - echo "<pre>$output</pre>"; + echo "<pre>$output</pre>"; ?> ]]> </programlisting> @@ -461,7 +470,7 @@ <note> <para> Cet opérateur est désactivé lorsque le - <link linkend="ini.safe-mode">safe mode</link> est activé. + &safemode; est activé. </para> </note> <para> @@ -514,27 +523,27 @@ </tgroup> </table> <para> - Voici un exempla simple + Voici un exemple simple <informalexample> <programlisting role="php"> <![CDATA[ <?php - echo "<h3>Post-incrémentation</h3>"; + echo "<h3>Post-incrémentation</h3>"; $a = 5; - echo "Devrait valoir 5: " . $a++ . "<br>\n"; - echo "Devrait valoir 6: " . $a . "<br>\n"; - echo "<h3>Pré-incrémentation</h3>"; + echo "Devrait valoir 5: " . $a++ . "<br>\n"; + echo "Devrait valoir 6: " . $a . "<br>\n"; + echo "<h3>Pré-incrémentation</h3>"; $a = 5; - echo "Devrait valoir 6: " . ++$a . "<br>\n"; - echo "Devrait valoir 6: " . $a . "<br>\n"; - echo "<h3>Post-décrémentation</h3>"; + echo "Devrait valoir 6: " . ++$a . "<br>\n"; + echo "Devrait valoir 6: " . $a . "<br>\n"; + echo "<h3>Post-décrémentation</h3>"; $a = 5; - echo "Devrait valoir 5: " . $a-- . "<br>\n"; - echo "Devrait valoir 4: " . $a . "<br>\n"; - echo "<h3>Pré-décrémentation</h3>"; + echo "Devrait valoir 5: " . $a-- . "<br>\n"; + echo "Devrait valoir 4: " . $a . "<br>\n"; + echo "<h3>Pré-décrémentation</h3>"; $a = 5; - echo "Devrait valoir 4: " . --$a . "<br>\n"; - echo "Devrait valoir 4: " . $a . "<br>\n"; + echo "Devrait valoir 4: " . --$a . "<br>\n"; + echo "Devrait valoir 4: " . $a . "<br>\n"; ?> ]]> </programlisting> @@ -602,8 +611,8 @@ est l'opérateur de concaténation ('.'), qui retourne la concaténation de ses deux arguments. Le second est l'opérateur d'assignation - concaténant ('.='). Reportez-vous à - <link linkend="language.operators.assignment">Opérateurs d'assignations</link> + concaténant (<literal>.=</literal>). Reportez-vous à + <link linkend="language.operators.assignment">opérateurs d'assignement</link> pour plus de détails. </simpara> <para> @@ -621,6 +630,43 @@ ]]> </programlisting> </informalexample> + </para> + </sect1> + <sect1 id="language.operators.array"> + <title>Opérateurs de tableaux</title> + <simpara> + Le seul opérateur en &php; pour les tableaux est l'opérateur + <literal>+</literal>. Cet opérateur ajoute le tableau de + droite au tableau de gauche. Les clés communes sont laissées + inchangées. + </simpara> + <para> + <example> + <title>Addition de tableaux</title> + <programlisting role="php"> +<![CDATA[ +$a = array("a" => "pomme", "b" => "banane"); +$b = array("a" =>"poire", "b" => "fraise", "c" => "cerise"); + +$c = $a + $b; + +var_dump($c); +]]> + </programlisting> + <screen role="php"> +<![CDATA[ +array(3) { + ["a"]=> + string(5) "pomme" + ["b"]=> + string(6) "banane" + ["c"]=> + string(6) "cerise" +} + +]]> + </screen> + </example> </para> </sect1> </chapter> Index: phpdoc-fr/language/references.xml diff -u phpdoc-fr/language/references.xml:1.8 phpdoc-fr/language/references.xml:1.9 --- phpdoc-fr/language/references.xml:1.8 Wed Dec 12 15:50:08 2001 +++ phpdoc-fr/language/references.xml Mon Feb 3 07:27:11 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <chapter id="language.references"> <title>Les références</title> <sect1 id="language.references.whatare"> @@ -26,9 +26,11 @@ vous faites : <informalexample> <programlisting role="php"> -<?php -$a =& $b -?> +<![CDATA[ +<?php +$a =& $b +?> +]]> </programlisting> </informalexample> cela signifie que <varname>$a</varname> et <varname>$b</varname> @@ -46,10 +48,12 @@ <literal>new</literal> (PHP 4.0.4 et plus récent): <informalexample> <programlisting role="php"> -<?php - $bar =& new fooclass(); - $foo =& find_var ($bar); -?> +<![CDATA[ +<?php + $bar =& new fooclass(); + $foo =& find_var ($bar); +?> +]]> </programlisting> </informalexample> </para> @@ -70,13 +74,15 @@ le contenu des variables de fonction. Exemple : <informalexample> <programlisting role="php"> -<?php - function foo(&$var) { +<![CDATA[ +<?php + function foo(&$var) { $var++; } $a=5; foo($a); -?> +?> +]]> </programlisting> </informalexample> <varname>$a</varname> vaut 6. Cela provient du fait que dans la fonction @@ -100,12 +106,14 @@ ce à quoi on peut s'attendre : <informalexample> <programlisting role="php"> -<?php - function foo(&$var) { - $var =& $GLOBALS["baz"]; +<![CDATA[ +<?php + function foo(&$var) { + $var =& $GLOBALS["baz"]; } foo($bar); -?> +?> +]]> </programlisting> </informalexample> </para> @@ -129,14 +137,16 @@ syntaxe est la suivante : <informalexample> <programlisting role="php"> -<?php - function foo(&$var) { +<![CDATA[ +<?php + function foo(&$var) { $var++; } $a=5; foo ($a); // $a vaut 6 maintenant -?> +?> +]]> </programlisting> </informalexample> Notez qu'il n'y a pas de signe de référence dans l'appel de la @@ -163,13 +173,15 @@ Une référence, retournée par une fonction : <informalexample> <programlisting role="php"> -<?php - function &bar() { +<![CDATA[ +<?php + function &bar() { $a = 5; return $a; } foo(bar()); -?> +?> +]]> </programlisting> </informalexample> Voir aussi des détails dans @@ -185,8 +197,9 @@ exemple, les passages par référence suivants sont invalides : <informalexample> <programlisting role="php"> -<?php - function bar() // Notez l'absence de & +<![CDATA[ +<?php + function bar() // Notez l'absence de & { $a = 5; return $a; @@ -194,7 +207,8 @@ foo(bar); foo($a = 5) // Expression, pas une variable foo(5) // Constante, pas une variable -?> +?> +]]> </programlisting> </informalexample> Ces fonctionnalités sont valables à partir de PHP 4.0.4. @@ -209,14 +223,16 @@ utilisez le code suivant <informalexample> <programlisting role="php"> -<?php - function &find_var($param) { +<![CDATA[ +<?php + function &find_var($param) { // ...code... return $found_var; } - $foo =& find_var ($bar); - $foo->x = 2; -?> + $foo =& find_var ($bar); + $foo->x = 2; +?> +]]> </programlisting> </informalexample> Dans cet exemple, la propriété de l'objet est retournée @@ -242,11 +258,13 @@ Cela ne signifie pas que le contenu est détruit. Par exemple, <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = 1; -$b =& $a; +$b =& $a; unset ($a); -?> +?> +]]> </programlisting> </informalexample> Cet exemple ne détruira pas <varname>$b</varname>, mais juste @@ -275,9 +293,11 @@ globale. Ce qui signifie que <informalexample> <programlisting role="php"> -<?php -$var =& $GLOBALS["var"]; -?> +<![CDATA[ +<?php +$var =& $GLOBALS["var"]; +?> +]]> </programlisting> </informalexample> </para> Index: phpdoc-fr/language/types.xml diff -u phpdoc-fr/language/types.xml:1.19 phpdoc-fr/language/types.xml:1.20 --- phpdoc-fr/language/types.xml:1.19 Tue Aug 13 22:19:28 2002 +++ phpdoc-fr/language/types.xml Mon Feb 3 07:27:11 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.19 $ --> +<!-- $Revision: 1.20 $ --> <chapter id="language.types"> <title>Les types</title> <sect1 id="language.types.intro"> @@ -104,46 +104,52 @@ <title>Booléens</title> <simpara> C'est le type le plus simple. Un booléen exprime les valeurs - de vrai &true; ou <literal>FALSE</literal>. + de vrai &true; ou &false;. </simpara> - <para> + <sect2 id="language.types.boolean.syntax"> + <title>Syntaxe</title> + <para> Vous pouvez utiliser les constantes '&true;' et - '<literal>FALSE</literal>' pour spécifier une valeur de type - <type>boolean</type>. Généralement, vous les créerez - avec un des <link linkend="language.operators">operateurs</link> + '&false;' pour spécifier une valeur de type + <type>boolean</type>. Ces constantes sont insensibles + à la casse. + <informalexample> + <programlisting role="php"> +<![CDATA[ +$foo = True; // assign the value TRUE to $foo +]]> + </programlisting> + </informalexample> + </para> + <para> + Généralement, vous les créerez + avec un des <link linkend="language.operators">opérateurs</link> qui retourne une valeur <type>boolean</type>, pour le passer - à une <link linkend="control-structures">structure de - contrôle</link>. + à une <link linkend="control-structures">structure de contrôle</link>. <informalexample> <programlisting role="php"> -<?php - if ($action == "show_version"){ -// == is an <link linkend="language.operators">operator</link> +<![CDATA[ +// == est un opérateur d'égalité // qui retourne un booléen - echo "La version est 1.23"; - } -// ceci n'est pas nécessaire - if ($show_separators == true){ - echo "<hr>\n"; - } -// ceci est plus pratique - if ($show_separators){ - echo "<hr>\n"; - } -?> +if ($action == "show_version") { + echo "La version est la 1.23"; +} + +// Ceci n'est pas nécessaire +if ($show_separators == TRUE) { + echo "<hr>\n"; +} + +// car vous pouvez simplement utiliser +if ($show_separators) { + echo "<hr>\n"; +} +]]> </programlisting> </informalexample> - </para> - <!-- TODO: example of this --> - <!-- TODO: example to show that if ( expr == TRUE ) is not really - necessary... (i've seen this construct numerous times) - --> - <!-- TODO: how others vars are converted to boolean --> - <note> - <simpara> - Le type booéen a été introduit en PHP 4. - </simpara> - </note> + </para> + </sect2> + <sect2 id="language.types.boolean.casting"> <title>Conversion en booléen</title> <simpara> @@ -153,7 +159,7 @@ </simpara> <para> Lors des conversions de valeurs de type <type>boolean</type>, les valeurs - suivantes sont considérées comme fausse (<literal>FALSE</literal>) : + suivantes sont considérées comme fausse (&false;) : <itemizedlist> <listitem> <simpara> @@ -216,33 +222,55 @@ éventuellement précédé du signe moins (<literal>-</literal>). </para> - <para> + <sect2 id="language.types.integer.syntax"> + <title>Syntax</title> + <simpara> + Les entiers peuvent être spécifié en base décimale (dite aussi + base 10), en héxadecimal (base 16) ou en octale (base 8). + Les entiers peuvent être optionnellement précédés par le signe + plus ou moins (- or +). + </simpara> + <para> Pour utiliser la notation octale, vous devez préfixer le nombre avec un zéro; pour utiliser la notation hexadécimale, vous devez préfixer le nombre avec <literal>0x</literal>. - <informalexample> - <programlisting role="php"> -<?php - $a = 1234; # nombre entier en base 10 - $a = -123; # nombre entier négatif - $a = 0123; # nombre entier en base 8, octale (équivalent à 83 en base 10) - $a = 0x12; # nombre entier en base 16, hexadécimale - # (équivalent à 18 en base 10) -?> - </programlisting> - </informalexample> - La taille des entiers dépend de la plate-forme de support, mais + <example> + <title>Integer literals</title> + <programlisting role="php"> +<![CDATA[ +$a = 1234; // nombre entier en base 10 +$a = -123; // nombre entier négatif +$a = 0123; // nombre entier en base 8, octale (équivalent à 83 en base 10) +$a = 0x1A; // nombre entier en base 16, hexadécimale + // (équivalent à 26 en base 10) +]]> + </programlisting> + </example> + Techniquement, la structure d'un entier suit les règles suivantes : + <example> + <title>Structure d'un entier</title> + <programlisting> +<![CDATA[ +decimal : [1-9][0-9]* + | 0 + +hexadecimal : 0[xX][0-9a-fA-F]+ + +octal : 0[0-7]+ + +integer : [+-]?decimal + | [+-]?hexadecimal + | [+-]?octal +]]> + </programlisting> + </example> + La taille des entiers dépend de la plate-forme de support, mais la valeur maximale est généralement de 2 milliards et des poussières (c'est un entier signé de 32 bits). PHP ne supporte pas les entiers non signés. - </para> - <note> - <simpara> - En PHP, il n'existe pas de type fraction. - <literal>1/2</literal> se transforme en nombre à virgule - flottante <literal>0.5</literal>. - </simpara> - </note> + </para> + </sect2> + <sect2 id="language.types.integer.overflow"> <title>Dépassement de capacité des entiers</title> <para> @@ -250,7 +278,8 @@ des entiers, il sera interprété comme un <type>float</type>. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $large_number = 2147483647; var_dump($large_number); // affiche : int(2147483647) @@ -260,7 +289,8 @@ var_dump( 25/7 ); // affiche : float(3.5714285714286) -?> +?> +]]> </programlisting> </informalexample> De même, si une fonction ou un opérateur retourne un entier qui @@ -268,12 +298,14 @@ automatiquement converti en <type>float</type>. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $million = 1000000; $large_number = 50000 * $million; var_dump($large_number); // affiche : float(50000000000) -?> +?> +]]> </programlisting> </informalexample> </para> @@ -298,7 +330,7 @@ <sect2 id="language.types.integer.casting"> <title>Conversion en entiers</title> <simpara> - Pour explicitement convertir une valeur en <type>integer</type>, + Pour explicitement convertir une valeur en &integer;, utilisez les opérateurs de transtypage <literal>(int)</literal> ou <literal>(integer)</literal>. Cependant, dans la plupart des situations, vous n'en aurez pas besoin, car une valeur sera @@ -352,14 +384,16 @@ peut conduire à des résultats irrationnels. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo (int) ( (0.1+0.7) * 10 ); // affiche 7! -?> +?> +]]> </programlisting> </informalexample> Pour plus d'informations, reportez-vous aux - <link linkend="language.types.float">alertes</link> liées + <link linkend="warn.float-precision">alertes</link> liées aux nombres à virgule flottante. </para> </warning> @@ -408,14 +442,16 @@ spécifiés en utilisant la syntaxe suivante: <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = 1.234; $a = 1.2e3; -?> +?> +]]> </programlisting> </informalexample> </para> - <warning> + <warning id="warn.float-precision"> <title>Précision des nombres à virgule flottante</title> <para> Il est fréquent que de simples fractions décimales telles que @@ -442,6 +478,18 @@ librairies <link linkend="ref.bc">BC</link> ou <link linkend="ref.gmp">GMP</link>. </para> </warning> + <sect2 id="language.types.float.casting"> + <title>Conversion d'un nombre à virgule flottante</title> + + <para> + Pour savoir quand et comment des chaînes sont converties en + nombre à virgule flottante, voyez la section + <link linkend="language.types.string.conversion">Conversion de chaînes de caractères</link>. + Pour les valeurs d'autres types, la conversion est la même + que si la valeur était d'abord convertie en entier, puis en + nombre décimal. Voyez la section <link linkend="language.types.integer.casting">Conversion d'un entier</link>. + </para> + </sect2> </sect1> <sect1 id="language.types.string"> <title>Les chaînes de caractères</title> @@ -511,7 +559,8 @@ </note> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo 'Ceci est une chaîne simple'; echo 'Vous pouvez inclure des nouvelles lignes dans une chaîne, comme ceci.'; @@ -523,7 +572,8 @@ // affiche : Etes vous sûr de vouloir effacer le dossier C:\*.*? echo 'Je suis en train de mettre une nouvelle ligne comme ceci : \n'; // affiche : Je suis en train de mettre une nouvelle ligne comme ceci : \n -?> +?> +]]> </programlisting> </informalexample> </para> @@ -649,8 +699,9 @@ <example> <title>Exemple de chaîne HereDoc</title> <programlisting role="php"> -<?php - $str = <<<EOD +<![CDATA[ +<?php + $str = <<<EOD Exemple de chaîne s'étalant sur plusieurs lignes @@ -661,18 +712,19 @@ var $foo; var $bar; function foo() { - $this->foo = 'Foo'; - $this->bar = array('Bar1', 'Bar2', 'Bar3'); + $this->foo = 'Foo'; + $this->bar = array('Bar1', 'Bar2', 'Bar3'); } } $foo = new foo(); $name = 'MonNom'; - echo <<<EOT + echo <<<EOT Mon nom est "$name". J'affiche des $foo->foo. - Maintenant, j'affiche un {$foo->bar[1]}. + Maintenant, j'affiche un {$foo->bar[1]}. Ceci se traduit par un 'A' majuscule: \x41 EOT; -?> +?> +]]> </programlisting> </example> </para> @@ -712,19 +764,22 @@ variable valide. Entourez le nom de la variable avec des accolades pour indiquer explicitement son nom. </simpara> - <informalexample> + <example> + <title>Utilisation des accolades {} dans les chaînes</title> <programlisting role="php"> -<?php + <![CDATA[ +<?php $boisson = 'vin'; echo "Du $boisson, du pain et du fromage!'; // OK, car "," n'est pas autorisé dans les noms de variables - echo "Il a goûté plusieurs $vins"; + echo "Il a goûté plusieurs $boisson"; // Pas OK, car 's' peut entrer dans un nom de variable, et PHP recherche $boissons - echo "Il a goûté plusieurs ${vin}s"; + echo "Il a goûté plusieurs ${boisson}s"; // OK -?> +?> +]]> </programlisting> - </informalexample> + </example> <simpara> Similairement, vous pouvez aussi utiliser un élément de tableau, ou un membre d'objet. Pour les éléments @@ -740,25 +795,24 @@ paying them enough or something?). --> </simpara> - <informalexample> + <example> + <title>Utilisation des accolades {} dans les chaînes pour les tableaux</title> <programlisting role="php"> + <![CDATA[ +<?php $fruits = array( 'fraise' => 'rouge' , 'banane' => 'jaune' ); echo "Une banane est $fruits[banane]."; // OK. Notez toutefois que pour cet exemple, cela fonctionne - // différemment. Voyez <link linkend="language.types.array.foo-bar"><literal>$foo[bar]</literal> hors des chaînes</link> - echo "Ce carré est large de $carre->largeur mètres."; + // différemment. Voyez <literal>$foo[bar]</literal> hors des chaînes + echo "Ce carré est large de $carre->largeur mètres."; // OK - echo "Ce carré est large de $carre->largeur00 mètres.."; + echo "Ce carré est large de $carre->largeur00 mètres.."; // pas OK - // pour résoudre ce problème, voyez <link linkend="language.types.string.parsing.complex">syntaxe complexe</link>. - <!-- XXX this won't work: - echo "This square is $square->{width}00 centimeters broad."; - // XXX: php developers: it would be consequent to make this work. - // XXX: like the $obj->{expr} syntax outside a string works, - // XXX: analogously to the ${expr} syntax for variable var's. - --> + // pour résoudre ce problème, voyez la syntaxe complexe. +?> +]]> </programlisting> - </informalexample> + </example> <simpara> Pour tout ce qui sera plus compliqué, voyez la syntaxe complexe. </simpara> @@ -783,7 +837,8 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $super = 'fantastique'; echo "C'est { $super}"; // ne fonctionne pas, @@ -791,13 +846,13 @@ echo "C'est {$super}"; // fonctionne, // affiche "C'est fantastique" - echo "Ce carré a {$square->width}00 centimètres de large."; + echo "Ce carré a {$square->width}00 centimètres de large."; echo "Ceci fonctionne : {$tableau[4][3]}"; echo "Ceci échoue : {$tableau[foo][3]}"; // pour la même raison que $tableau[bar] ne fonctionne pas hors d'une chaîne <!-- XXX see the still-to-write explaination in the arrays-section. --> echo "Essayez plutôt comme ceci : {$tableau['foo'][3]}"; - echo "Vous pouvez même écrire {$objet->valeurs[3]->nom}"; + echo "Vous pouvez même écrire {$objet->valeurs[3]->nom}"; echo "Voici la valeur de la variable nommée $name: {${$name}}"; <!-- <xxx> maybe it's better to leave this out?? --> // cela fonctionne, mais c'est vivement déconseillé. @@ -805,7 +860,8 @@ $inv = 'Bordeaux'; echo "Je reprendrai bien un verre de cet excellent {${ strrev('niv') }}, hips"; <!-- </xxx> --> -?> +?> +]]> </programlisting> </informalexample> </sect4> @@ -831,26 +887,28 @@ <!-- TODO: either move these examples to a example section, as with arrays, or distribute them under the applicable sections. --> -<?php +<![CDATA[ +<?php /* Affectation d'une chaîne. */ $str = "Ceci est une chaîne"; /* Concaténation. */ $str = $str . " avec un peu plus de texte"; /* Une autre méthode de concaténation. */ $str .= " et une nouvelle ligne à la fin.\n"; -/* Cette chaîne finira comme : '<p>Nombre: 9</p>' */ +/* Cette chaîne finira comme : '<p>Nombre: 9</p>' */ $num = 9; - $str = "<p>Nombre: $num</p>"; -/* Celle-ci sera '<p>Nombre: $num</p>' */ + $str = "<p>Nombre: $num</p>"; +/* Celle-ci sera '<p>Nombre: $num</p>' */ $num = 9; - $str = '<p>Nombre: $num</p>'; + $str = '<p>Nombre: $num</p>'; /* Premier caractère d'une chaîne */ $str = 'Ceci est un test.'; $first = $str{0}; /* Dernier caractère d'une chaîne. */ $str = 'This is still a test.'; $last = $str{strlen($str)-1}; -?> +?> +]]> </programlisting> </example> </para> @@ -884,8 +942,71 @@ fonctions de <link linkend="ref.ctype">types de caractères</link>. </simpara> </sect2> + <sect2 id="language.types.string.casting"> + <title>Conversion de chaîne de caractères</title> + + <para> + Vous pouvez convertir une valeur en chaîne en utilisant l'opérateur + <literal>(string)</literal>, ou bien la fonction <function>strval</function>. + La conversion en chaîne de caractères est automatiquement faite dans + toutes les situations qui nécessitent une chaîne de caractères. + Cela arrive lorsque vous utilisez des fonctions comme <function>echo</function> + ou <function>print</function>, ou encore lorsque vous comparez une valeur + avec une chaîne de caractères. + </para> + + <para> + Le booléen &true; est converti en la chaîne de caractères <literal>"1"</literal>, + et le booléen &false; est représenté par la chaîne de caractères vide + <literal>""</literal>. De cette façon, vous pouvez convertir des + booléens en chaîne de caractères et vice-versa. + </para> + <para> + Un entier ou un nombre à virgule flottante est converti en une + chaîne de caractères qui représente ce nombre en décimal (y compris + l'exposant des nombres à virgule flottante). + </para> + <para> + Les tableaux sont toujours convertis en la chaîne de caractères <literal>"Array"</literal>, + ce qui fait que vous ne pouvez pas afficher le contenu d'un tableau avec la fonction + <function>echo</function> ou <function>print</function>. Voyez + les informations ci-dessous pour plus de conseils. + </para> + <para> + Les objets sont automatiquement convertis en la chaîne de caractères + <literal>"Object"</literal>. Si vous souhaitez afficher le membre + d'un objet, lisez le paragraphe ci-dessous. Si vous voulez connaitre + le nom de la classe de cet objet, utilisez la fonction + <function>get_class</function>. + </para> + <para> + Les ressources sont toujours converties en chaîne de caractères + <literal>"Resource id #1"</literal> où <literal>1</literal> est + le nombre unique représentant la ressource, assigné par &php; au moment + de l'exécution. Si vous souhaitez connaître le type d'une ressource, + utilisez <function>get_resource_type</function>. + </para> + <para> + &null; est toujours converti en une chaîne de caractères vide. + </para> + + <para> + Comme vous pouvez le voir, afficher des tableaux, des objets ou des ressources + n'est pas pertinent par cette méthode. Reportez-vous aux fonctions + <function>print_r</function> et <function>var_dump</function> pour + avoir des outils plus pratiques. + </para> + + <para> + Vous pouvez aussi convertir des valeurs &php; en chaînes pour les + sauver dans un stockage. Cette méthode est appelée la linéarisation, + et peut être exploitée avec la fonction <function>serialize</function>. + Vous pouvez aussi linéariser des valeurs &php; en structure + XML si vous avez le support <link linkend="ref.wddx">WDDX</link>. + </para> + </sect2> <sect2 id="language.types.string.conversion"> - <title>Conversion de type</title> + <title>Conversion de chaînes de caractères</title> <simpara> Lorsqu'une chaîne de caractère est évaluée comme une valeur numérique, @@ -911,16 +1032,18 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $foo = 1 + "10.5"; // $foo est du type float (11.5) $foo = 1 + "-1.3e3"; // $foo est du type float (-1299) $foo = 1 + "bob-1.3e3"; // $foo est du type integer (1) $foo = 1 + "bob3"; // $foo est du type integer (1) - $foo = 1 + "10 Small Pigs"; // $foo est du type integer (11) - $foo = 1 + "10 Little Piggies"; // $foo est du type integer (11) - $foo = "10.0 pigs " + 1; // $foo est du type integer (11) - $foo = "10.0 pigs " + 1.0; // $foo est du type float (11) -?> + $foo = 1 + "10 petits cochons"; // $foo est du type integer (11) + $foo = 1 + "10 gros cochons"; // $foo est du type integer (11) + $foo = "10.0 cochons " + 1; // $foo est du type integer (11) + $foo = "10.0 cochons " + 1.0; // $foo est du type float (11) +?> +]]> </programlisting> </informalexample> <simpara> @@ -933,9 +1056,11 @@ pour voir comment il se comporte. <informalexample> <programlisting role="php"> -<?php - echo "\$foo==$foo; type is " . gettype( $foo ) . "<br>\n"; -?> +<![CDATA[ +<?php + echo "\$foo==$foo; type is " . gettype( $foo ) . "<br>\n"; +?> +]]> </programlisting> </informalexample> </para> @@ -966,7 +1091,7 @@ <para> Un tableau <type>array</type> peut être créé avec la fonction <function>array</function>. Cette fonction prend en argument - des structures <literal><replaceable>key</replaceable> => + des structures <literal><replaceable>key</replaceable> => <replaceable>value</replaceable></literal>, séparées par des virgules. </para> <para> @@ -991,9 +1116,17 @@ </para> <para> Une valeur peut être n'importe quoi. + <example> + <title>Création d'un tableau</title> + <programlisting role="php"> +<![CDATA[ +<?php + array("somearray" => array(6 => 5, 13 => 9, "a" => 43)); +?> +]]> + </programlisting> + </example> </para> - <sect4 id="language.types.array.omit-key"> - <title>Omettre des clés</title> <para> Si vous omettez une clé lors de la spécification d'un tableau, l'indice maximum + 1 sera utilisé comme clé par défaut. Si aucun @@ -1003,7 +1136,7 @@ </para> <para> <synopsis> -array( <optional><replaceable>key</replaceable> => </optional> +array( <optional><replaceable>key</replaceable> => </optional> <replaceable>value</replaceable> , ... ) @@ -1012,7 +1145,6 @@ // <replaceable>value</replaceable> peut être n'importe quoi </synopsis> </para> - </sect4> </sect3> <sect3 id="language.types.array.syntax.modifying"> <title>La syntaxe à crochets</title> @@ -1049,6 +1181,130 @@ revue simplement les valeurs d'un tableau. </para> </sect2> + <sect2 id="language.types.array.donts"> + <title>Attention aux tableaux</title> + <sect3 id="language.types.array.foo-bar"> + <title>Pourquoi est ce que <literal>$foo[bar]</literal> est invalide?</title> + <para> + Dans vos vieux scripts, vous pouvez avoir utilisé la syntaxe suivante : + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + $foo[bar] = 'ennemi'; + echo $foo[bar]; +?> +]]> + </programlisting> + </informalexample> + Cela est mauvais, mais ca marche. Pourquoi est-ce mauvais? La raison + est que PHP réclame une expression entre les crochets (comme + indiqué dans la section sur la + <link linkend="language.types.array.syntax">syntaxe</link> des tableaux). + Cela signifie que vous pouvez écrire quelque chose comme : + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + echo $arr[ foo(true) ]; +?> +]]> + </programlisting> + </informalexample> + Ceci est un exemple d'utilisation de retour de fonction dans un + index de tableau. PHP reconnait aussi les constantes, et vous + pouvez avoir déjà rencontré <literal>E_*</literal>. + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + $error_descriptions[E_ERROR] = "Une erreur fatale est survenue"; + $error_descriptions[E_WARNING] = "PHP a généré une alerte"; + $error_descriptions[E_NOTICE] = "Ceci est juste une note grâcieuse"; +?> +]]> + </programlisting> + </informalexample> + Notez que <literal>E_ERROR</literal> est aussi un identifiant + vlaide, tout comme <literal>bar</literal> dans le premier exemple. + Mais le dernier exemple revient à écrire : + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + $error_descriptions[1] = "Une erreur fatale est survenue"; + $error_descriptions[2] = "PHP a généré une alerte"; + $error_descriptions[8] = "Ceci est juste une note grâcieuse"; +?> +]]> + </programlisting> + </informalexample> + car <literal>E_ERROR</literal> égale <literal>1</literal>, etc. + </para> + <para> + Alors, comment se fait-t-il que <literal>$foo[bar]</literal> fonctionne? + C'est parce que <literal>bar</literal> est considéré comme une + constante. Cependant, dans ce cas, aucune constante n'a pour nom + <literal>bar</literal>. PHP suppose alors que vous voulez dire + <literal>bar</literal> littéralement, c'est-à-dire la + chaîne <literal>"bar"</literal>, mais que vous avez oublié les + guillements. + </para> + <para> + Dans le futur, l'équipe de développement peut vouloir ajouter une + nouvelle constante et vous vous retrouverez dans la panade. Par + exemple, vous ne pouvez déjà pas utiliser les constantes + <literal>empty</literal> et <literal>default</literal>, car ce + sont des mots reservés. + <!-- <jeroen>hmm... i'm doubting this myself. Finish it if you like</jeroen> + But probably + the most threatening + thing is yourself, or whoever will maintain the script. You'll + maybe get very strange behaviour, and + --> + </para> + <para> + Et, pour en mettre une autre couche, cette syntaxe est tout simplement + obsolète, et risque de ne plus fonctionner du tout un jour ou l'autre. + </para> + <note> + <simpara> + Lorsque vous activez le rapport d'erreur avec <function>error_reporting</function> + avec <literal>E_ALL</literal>, PHP générera des notes à chaque fois que cette + syntaxe est utilisée. Essayez donc <literal>error_reporting(E_ALL);</literal> + dans vos scripts, pour voir). + </simpara> + </note> + <note> + <simpara> + Dans une chaîne à guillements doubles, une autre syntaxe est + valide. Voyez la section sur + <link linkend="language.types.string.parsing">Traitement des variables + dans les chaînes</link> pour plus de détails. + </simpara> + </note> + </sect3> + </sect2> + <sect2 id="language.types.array.casting"> + <title>Conversion en tableau</title> + + <para> + Pour les types scalaires (integer, float, string, boolean et resource), + convertir une valeur en tableau retourne un tableau qui contient un + élément (à l'index 0) qui est la valeur originale. + </para> + + <para> + Si vous convertissez un tableau en objet, vous obtiendrez des propriétés + ou bien cet objet comme élements de tableau. Les clés créées sont les + noms des membres. + </para> + + <para> + Si vous convertissez la valeur &null; en tableau, vous obtiendrez un + taleau vide. + </para> + </sect2> <sect2 id="language.types.array.examples"> <title>Exemples</title> <para> @@ -1057,7 +1313,8 @@ <para> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php // ceci $a = array( 'couleur' => 'rouge' , 'gout' => 'sucre' @@ -1076,19 +1333,21 @@ $b[] = 'c'; // va créer le tableau array( 0 => 'a' , 1 => 'b' , 2 => 'c' ) // ou plus simplement array('a' , 'b' , 'c' ) -?< +?> +]]> </programlisting> </informalexample> </para> <example> <title>Utilisation de <function>array</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php // Array comme correspondance - $map = array( 'version' => 4 - , 'OS' => 'Linux' - , 'langue' => 'français' - , 'short_tags' => TRUE ); + $map = array( 'version' => 4 + , 'OS' => 'Linux' + , 'langue' => 'français' + , 'short_tags' => TRUE ); // valeur strictement numériques $array = array( 7 , 8 @@ -1096,15 +1355,15 @@ , 156 , -10 ); -// ceci est la même chose que array( 0 => 7, 1 => 8, ...) +// ceci est la même chose que array( 0 => 7, 1 => 8, ...) $switching = array( 10 // clé = 0 - , 5 => 6 - , 3 => 7 - , 'a' => 4 + , 5 => 6 + , 3 => 7 + , 'a' => 4 , 11 // clé = 6 (index maximum : 5) - , '8' => 2 // clé = 8 (entier!) - , '02' => 77 // clé = '02' - , 0 => 12 // la valeur de la clé 10 sera remplacée par 12 + , '8' => 2 // clé = 8 (entier!) + , '02' => 77 // clé = '02' + , 0 => 12 // la valeur de la clé 10 sera remplacée par 12 ); <!-- TODO example of - mixed keys @@ -1115,13 +1374,15 @@ --> // empty array $empty = array(); -?< +?> +]]> </programlisting> </example> <example id="language.types.array.examples.loop"> <title>Collection</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $couleurs = array('rouge','bleu','vert','jaune'); foreach ( $couleurs as $couleur ){ echo "Aimez-vous la couleur $couleur?\n"; @@ -1132,7 +1393,8 @@ Aimez-vous la couleur vert? Aimez-vous la couleur jaune? */ -?> +?> +]]> </programlisting> </example> <para> @@ -1147,7 +1409,8 @@ <example id="language.types.array.examples.changeloop"> <title>Collection</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php foreach( $couleurs as $cle => $couleur ){ // ne marche pas //$couleur = strtoupper($couleur); @@ -1164,7 +1427,8 @@ [3] => JAUNE ) */ -?> +?> +]]> </programlisting> </example> </para> @@ -1173,7 +1437,8 @@ <example> <title>Tableau en 1</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $firstquarter = array(1 => 'Janvier', 'Février', 'Mars'); print_r($firstquarter); /* Affiche: @@ -1184,21 +1449,24 @@ [3] => 'Mars' ) */ -?> +?> +]]> </programlisting> </example> </para> <example> <title>Remplissage d'un tableau</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php // remplis un tableau avec les noms de fichiers d'un dossier $handle = opendir('.'); while ( $file = readdir($handle) ){ $files[] = $file; } closedir($handle); -?> +?> +]]> </programlisting> </example> <para> @@ -1209,10 +1477,12 @@ <example> <title>Tri de tableaux</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php sort($files); print_r($files); -?> +?> +]]> </programlisting> </example> <para> @@ -1223,20 +1493,21 @@ <example> <title>Tableaux multi-dimensionnels, et récursifs</title> <programlisting role="php"> -<?php - $fruits = array ( "fruits" => array ( "a" => "orange" - , "b" => "banane" - , "c" => "pomme" +<![CDATA[ +<?php + $fruits = array ( "fruits" => array ( "a" => "orange" + , "b" => "banane" + , "c" => "pomme" ) - , "nombres" => array ( 1 + , "nombres" => array ( 1 , 2 , 3 , 4 , 5 , 6 ) - , "trous" => array ( "premier" - , 5 => "second" + , "trous" => array ( "premier" + , 5 => "second" , "troisième" ) ); @@ -1259,294 +1530,11 @@ ) ); --> -?> +?> +]]> </programlisting> </example> </sect2> - <sect2 id="language.types.array.donts"> - <title>Attention aux tableaux</title> - <sect3 id="language.types.array.foo-bar"> - <title>Pourquoi est ce que <literal>$foo[bar]</literal> est invalide?</title> - <para> - Dans vos vieux scripts, vous pouvez avoir utilisé la syntaxe suivante : - <informalexample> - <programlisting role="php"> -<?php - $foo[bar] = 'ennemi'; - echo $foo[bar]; -?> - </programlisting> - </informalexample> - Cela est mauvais, mais ca marche. Pourquoi est-ce mauvais? La raison - est que PHP réclame une expression entre les crochets (comme - indiqué dans la section sur la - <link linkend="language.types.array.syntax">syntaxe</link> des tableaux). - Cela signifie que vous pouvez écrire quelque chose comme : - <informalexample> - <programlisting role="php"> -<?php - echo $arr[ foo(true) ]; -?> - </programlisting> - </informalexample> - Ceci est un exemple d'utilisation de retour de fonction dans un - index de tableau. PHP reconnait aussi les constantes, et vous - pouvez avoir déjà rencontré <literal>E_*</literal>. - <informalexample> - <programlisting role="php"> -<?php - $error_descriptions[E_ERROR] = "Une erreur fatale est survenue"; - $error_descriptions[E_WARNING] = "PHP a généré une alerte"; - $error_descriptions[E_NOTICE] = "Ceci est juste une note grâcieuse"; -?> - </programlisting> - </informalexample> - Notez que <literal>E_ERROR</literal> est aussi un identifiant - vlaide, tout comme <literal>bar</literal> dans le premier exemple. - Mais le dernier exemple revient à écrire : - <informalexample> - <programlisting role="php"> -<?php - $error_descriptions[1] = "Une erreur fatale est survenue"; - $error_descriptions[2] = "PHP a généré une alerte"; - $error_descriptions[8] = "Ceci est juste une note grâcieuse"; -?> - </programlisting> - </informalexample> - car <literal>E_ERROR</literal> égale <literal>1</literal>, etc. - </para> - <para> - Alors, comment se fait-tile que <literal>$foo[bar]</literal> fonctionne? - C'est parce que <literal>bar</literal> est attendu comme une - constante. Cependant, dans ce cas, aucune constante n'a pour nom - <literal>bar</literal>. PHP suppose alors que vous voulez dire - <literal>bar</literal> littéralement, c'est-à-dire la - chaîne <literal>"bar"</literal>, mais que vous avez oublié les - guillements. - </para> - <sect4 id="language.types.array.foo-bar.why"> - <title>Alors, pourquoi est-ce mal?</title> - <para> - Dans le futur, l'équipe de développement peut vouloir ajouter une - nouvelle constante et vous vous retrouverez dans la panade. Par - exemple, vous ne pouvez déjà pas utiliser les constantes - <literal>empty</literal> et <literal>default</literal>, car ce - sont des mots reservés. - <!-- <jeroen>hmm... i'm doubting this myself. Finish it if you like</jeroen> - But probably - the most threatening - thing is yourself, or whoever will maintain the script. You'll - maybe get very strange behaviour, and - --> - </para> - <para> - Et, pour en mettre une autre couche, cette syntaxe est tout simplement - obsolète, et risque de ne plus fonctionner du tout un jour ou l'autre. - </para> - <note> - <simpara> - Lorsque vous activez le rapport d'erreur avec <function>error_reporting</function> - avec <literal>E_ALL</literal>, PHP générera des notes à chaque fois que cette - syntaxe est utilisée. Essayez donc <literal>error_reporting(E_ALL);</literal> - dans vos scripts, pour voir). - </simpara> - </note> - <note> - <simpara> - Dans une chaîne à guillements doubles, une autre syntaxe est - valide. Voyez la section sur - <link linkend="language.types.string.parsing">Traitement des variables - dans les chaînes</link> pour plus de détails. - </simpara> - </note> - </sect4> - </sect3> - </sect2> - <!-- TODO - - example multi-dim with $arr[bla][bla] syntax - - converting to array - - warning about references - - note that assigning is copy (usually...) - --> -<!-- there is no such thing as multi/singel dim arrays (at least in PHP4) - <sect2 id="language.types.array.single-dim"> - <title>Single Dimension Arrays</title> - <para> - PHP supports both scalar and associative arrays. In fact, there - is no difference between the two. You can create an array using -- the <function>list</function> or <function>array</function> - the - <function>list</function> - Nope - or <function>array</function> - functions, or you can explicitly set each array element value. - ++++++++++++++++++++++++++++++++++++++++++++ - <para> - Les tableaux ressemblent aux tableaux associatifs et - aux tableaux indexés (vecteurs).</para> - <sect2 id="language.types.array.single-dim"> - <title>Tableaux à une dimension</title> - <para> - PHP supporte les tableaux scalaires et les tableaux associatifs. - En fait, il n'y a aucune différence entre les deux. Vous - pouvez créer un tableau en utilisant les fonctions - <function>list</function> ou <function>array</function>, ou bien - en affectant explicitement chacune des valeurs. - <informalexample> - <programlisting role="php"> -<?php -$a[0] = "abc"; -$a[1] = "def"; -$b["foo"] = 13; -?> - </programlisting> - </informalexample> - </para> - <para> - Vous pouvez aussi créer un tableau en ajoutant - simplement les valeurs à ce tableau. - <informalexample> - <programlisting role="php"> -<?php -$a[] = "Bonjour"; // $a[2] == "Bonjour"; -$a[] = "Monde"; // $a[3] == "Monde"; -?> - </programlisting> - </informalexample> - </para> - <para> - Un tableau peut être trié en utilisant les fonctions - <function>asort</function>, - <function>arsort</function>, <function>ksort</function>, - <function>rsort</function>, <function>sort</function>, - <function>uasort</function>, <function>usort</function>, ou - <function>uksort</function> en fonction du type de classement que vous voulez. - </para> - <para> - Vous pouvez compter le nombre d'éléments qu'il y - a dans un tableau en utilisant la fonction <function>count</function>. - </para> - <para> - Vous pouvez-vous déplacer à l'intérieur d'un - tableau en utilisant les fonctions <function>next</function> et - <function>prev</function>. Un autre moyen de se déplacer - dans un tableau est d'utiliser la fonction <function>each</function>. - </para> - </sect2> - <sect2 id="language.types.array.multi-dim"> - <title>Tableaux à plusieurs dimensions</title> - <para> - Les tableaux à plusieurs dimensions sont extrêmement simples. - Pour chaque dimension du tableau, vous ajouter une nouvelle [clef] à - la fin: - <informalexample> - <programlisting role="php"> -<?php -$a[1] = $f; # tableau à une dimension -$a["foo"] = $f; -$a[1][0] = $f; # tableau à deux dimensions -$a["foo"][2] = $f; # vous pouvez mélanger les indices associatifs et numériques -$a[3]["bar"] = $f; # vous pouvez mélanger les indices associatifs et numériques -$a["foo"][4]["bar"][0] = $f; # tableau à quatre dimensions -?> - </programlisting> - </informalexample> - </para> - <para> - En PHP 3 il n'est pas possible de référencer un tableau - à l'intérieur d'une chaîne. Par exemple, ceci ne - fonctionne pas : - <informalexample> - <programlisting role="php"> -<?php -$a[3]['bar'] = 'Bob'; -echo "Cela ne marche pas : $a[3][bar]"; -?> - </programlisting> - </informalexample> - En PHP 3, l'exemple ci-dessus va afficher : - <computeroutput>Cela ne marche pas : Array[bar]</computeroutput>. - L'opérateur de concaténation, - peut être utilisé pour corriger cela : - <informalexample> - <programlisting role="php"> -<?php -$a[3]['bar'] = 'Bob'; -echo "Cela ne marche pas : " . $a[3][bar]; -?> - </programlisting> - </informalexample> - </para> - <para> - En PHP 4, cependant, le problème peut être contourné - en entourant le tableau par des accolades : - <informalexample> - <programlisting role="php"> -<?php -$a[3]['bar'] = 'Bob'; -echo "Cela marche : {$a[3][bar]}"; -?> - </programlisting> - </informalexample> - </para> - <para> - Vous pouvez remplir un tableau à plusieurs dimensions - par de nombreux moyens mais la méthode la plus simple - à comprendre est l'utilisation de la fonction - <function>array</function>. Les deux exemples suivants - montre comment remplir un tableau à une dimension: - <informalexample> - <programlisting role="php"> -<?php -# Exemple 1: -$a["couleur"] = "rouge"; -$a["saveur"] = "sucrée"; -$a["forme"] = "rond"; -$a["nom"] = "pomme"; -$a[3] = 4; -# Exemple 2: -$a = array( - "couleur" => "rouge", - "saveur" => "sucrée", - "forme" => "rond", - "nom" => "pomme", - 3 => 4 -); -?> - </programlisting> - </informalexample> - </para> - <para> - La fonction <function>array</function> peut être - emboîtée pour remplir un tableau à - plusieurs dimensions : - <informalexample> - <programlisting role="php"> -<?php -$a = array( - "pomme" => array( - "couleur" => "rouge", - "saveur" => "sucrée", - "forme" => "rond" - ), - "orange" => array( - "couleur" => "orange", - "saveur" => "amère", - "forme" => "rond" - ), - "banane" => array( - "couleur" => "jaune", - "saveur" => "paste-y", - "forme" => "bananoïde" - ) -); -echo $a["pomme"]["saveur"]; # va afficher "sucrée" -?> - </programlisting> - </informalexample> - </para>+ - </sect2> - --> </sect1> <sect1 id="language.types.object"> <title>Les objets</title> @@ -1557,15 +1545,38 @@ afin de créer linstance de l'objet. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php class foo { function faire_foo () { echo "Faisant foo."; } } $bar = new foo; - $bar->faire_foo(); -?> + $bar->faire_foo(); +?> +]]> + </programlisting> + </informalexample> + </para> + </sect2> + <sect2 id="language.types.object.casting"> + <title>Converting to object</title> + + <para> + Si un objet est converti en objet, il n'est pas modifié. Si une + valeur d'un autre type est convertie en objet, une nouvelle instance + de la classe <literal>stdClass</literal> sera créée. Si la valeur + était &null; la nouvelle instance sera vide. Pour les autres valeurs, + un membre de l'objet appelé <literal>scalar</literal> contiendra la valeur. + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + $obj = (object) 'au revoir'; + echo $obj->scalar; // affiche 'au revoir' +?> +]]> </programlisting> </informalexample> </para> @@ -1574,18 +1585,28 @@ <sect1 id="language.types.resource"> <title>Ressources</title> <para> - Une ressource (resource en anglais), est un type spécial, + Une ressource ("resource" en anglais), est un type spécial, qui représente une référence sur une ressource externe. Les ressources sont créées par des fonctions dédiées. Reportez - vous à l'annexe <link linkend="resources">ressource</link> + vous à l'annexe <link linkend="resource">Types des ressources PHP</link> pour une liste exhaustive des fonctions créant et utilisant ces ressources. </para> <note> <simpara> - Le type ressource a été introduit en PHP 4. + Le type de données "resource" a été introduit en PHP 4. </simpara> </note> + <sect2 id="language.types.resource.casting"> + <title>Conversion en ressource</title> + + <para> + Comme les ressources contiennent des valeurs très spéciales, + comme des fichiers ouverts, des connexions aux bases de données, + des images ou n'importe quoi d'autre, vous ne pouvez pas + convertir une valeur en ressource. + </para> + </sect2> <sect2 id="language.types.resource.self-destruct"> <title>Libérer des ressources</title> <para> @@ -1619,9 +1640,11 @@ <literal>NULL</literal>, insensible à la casse. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $var = Null; -?> +?> +]]> </programlisting> </informalexample> </para> @@ -1632,6 +1655,101 @@ </note> </sect2> </sect1> + <sect1 id="language.pseudo-types"> + <title>Pseudo-types used in this documentation</title> + + <sect2 id="language.types.mixed"> + <title>mixed</title> + <para> + <literal>mixed</literal> indique qu'un paramètre accepte + plusieurs types, mais pas forcément tous les types. + </para> + <para> + <function>gettype</function> par exemple, accepte tous les types de variables + &php;, mais <function>str_replace</function> n'accepte que des + &string; et des &array;. + </para> + </sect2> + + <sect2 id="language.types.number"> + <title>number</title> + <para> + <literal>number</literal> indique qu'un paramètre peut être du type + &integer; ou &float;. + </para> + </sect2> + + <sect2 id="language.types.callback"> + <title>callback</title> + <para> + Certaines fonctions comme par exemple <function>call_user_function</function> + ou <function>usort</function> accepte une fonction définie par + l'utilisateur comme fonction de callback. Les fonctions de + callback peuvent être des fonctions simples, mais aussi des + objets ou des méthodes statiques de classe. + </para> + <para> + Une fonction &php; est passée simplement en indiquant son nom, sous + forme de chaîne de caractères. Vous pouvez passer une fonction + intégrée au langage, ou une fonction définie par vos soins, à + l'exception de + <function>array</function>, + <function>echo</function>, + <function>empty</function>, + <function>eval</function>, + <function>exit</function>, + <function>isset</function>, + <function>list</function>, + <function>print</function> et + <function>unset</function>. + </para> + <para> + Une méthode d'un objet instancié est passée sous forme de &array;, + contenat un objet comme élément d'index 0, et un nom de méthode comme + élément 1. + </para> + <para> + Les méthodes statiques de classe peuvent aussi être passées dans l'objet + instancié, mais en passant le nom de la classe comme valeur de + l'index 0. + </para> + + <para> + <example> + <title> + Exemple de fonction de callback + </title> + <programlisting role="php"> +<![CDATA[ +<?php + +// simple callback example +function foobar() { + echo "hello world!"; +} +call_user_function("foobar"); + +// method callback examples +class foo { + function bar() { + echo "hello world!"; + } +} + +$foo = new foo; + +call_user_function(array($foo, "bar")); // object method call + +call_user_function(array("foo", "bar")); // static class method call + +?> +]]> + </programlisting> + </example> + </para> + </sect2> + </sect1> + <sect1 id="language.types.type-juggling"> <title>Définition du type</title> <simpara> @@ -1655,13 +1773,15 @@ sont évaluées. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $foo = "0"; // $foo est une chaîne de caractères (ASCII 48) $foo += 2; // $foo est maintenant du type entier (2) $foo = $foo + 1.3; // $foo est maintenant du type double (3.3) $foo = 5 + "10 Petits cochons"; // $foo est du type entier (15) $foo = 5 + "10 cochonnets"; // $foo est du type entier (15) -?> +?> +]]> <!-- TODO: explain ++/- - behaviour with strings examples: @@ -1699,9 +1819,11 @@ un copier/coller, et d'insérer les lignes dans un script PHP. <informalexample> <programlisting role="php"> -<?php - echo "\$foo==$foo; le type est " . gettype( $foo ) . "<br>\n"; -?> +<![CDATA[ +<?php + echo "\$foo==$foo; le type est " . gettype( $foo ) . "<br>\n"; +?> +]]> </programlisting> </informalexample> </para> @@ -1711,10 +1833,12 @@ indéfinie. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = 1; // $a est un entier $a[0] = "f"; // $a devient un tableau, et $a[0] contient "f" -?> +?> +]]> </programlisting> </informalexample> </para> @@ -1724,10 +1848,12 @@ est 'f', considérez l'exemple suivant : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = "1"; // $a est une chaîne $a[0] = "f"; // Qu'est ce qu'une position dans une chaîne ? que se passe t il? -?> +?> +]]> </programlisting> </informalexample> </para> @@ -1755,10 +1881,12 @@ à transtyper ("cast"). <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $foo = 10; // $foo est un entier $bar = (double) $foo; // $bar est un double -?> +?> +]]> </programlisting> </informalexample> </para> @@ -1791,10 +1919,12 @@ parenthèses, donc les lignes suivantes sont équivalentes: <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $foo = (int) $bar; $foo = ( int ) $bar; -?> +?> +]]> </programlisting> </informalexample> </para> @@ -1867,11 +1997,13 @@ élément du tableau. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $var = 'ciao'; $arr = (array) $var; echo $arr[0]; // affiche 'ciao' -?> +?> +]]> </programlisting> </informalexample> </para> @@ -1881,11 +2013,13 @@ l'objet. L'attribut s'appellera 'scalar': <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $var = 'ciao'; $obj = (object) $var; - echo $obj->scalar; // affiche 'ciao' -?> + echo $obj->scalar; // affiche 'ciao' +?> +]]> </programlisting> </informalexample> </para> Index: phpdoc-fr/language/variables.xml diff -u phpdoc-fr/language/variables.xml:1.33 phpdoc-fr/language/variables.xml:1.34 --- phpdoc-fr/language/variables.xml:1.33 Thu May 9 12:06:24 2002 +++ phpdoc-fr/language/variables.xml Mon Feb 3 07:27:12 2003 @@ -1,17 +1,17 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.33 $ --> +<!-- $Revision: 1.34 $ --> <chapter id="language.variables"> <title>Les variables</title> <sect1 id="language.variables.basics"> <title>Essentiel</title> <simpara> - En PHP, les variables sont représentées par un signe + En &php;, les variables sont représentées par un signe dollar "$" suivi du nom de la variable. Le nom est sensible à la casse (ie : $x != $X). </simpara> <para> Les noms de variables suivent les mêmes règles de nommage que - les autres entités PHP. Un nom de variable valide doit commencer par + les autres entités &php;. Un nom de variable valide doit commencer par une lettre ou un souligné (_), suivi de lettres, chiffres ou soulignés. Exprimé sous la forme d'une expression régulière, cela donne : @@ -25,21 +25,23 @@ </simpara> </note> <para> - <informalexample> + <example> <programlisting role="php"> -<?php -$var = "Jean"; -$Var = "Paul"; -echo "$var, $Var"; // affiche "Jean, Paul" -$4site = 'pas encore'; // invalide : commence par un nombre -$_4site = 'pas encore'; // valide : commence par un souligné -$maïs = 'jaune'; // valide; 'ï' est ASCII 239. -?> +<![CDATA[ +<?php + $var = "Jean"; + $Var = "Paul"; + echo "$var, $Var"; // affiche "Jean, Paul" + $4site = 'pas encore'; // invalide : commence par un nombre + $_4site = 'pas encore'; // valide : commence par un souligné + $maïs = 'jaune'; // valide; 'ï' est ASCII 239. +?> +]]> </programlisting> - </informalexample> + </example> </para> <para> - En PHP 3, les variables sont toujours assignées par valeur. + En &php; 3, les variables sont toujours assignées par valeur. C'est-à-dire, lorsque vous assignez une expression à une variable, la valeur de l'expression est recopiée dans la variable. Cela signifie, par exemple, qu'après avoir @@ -49,7 +51,7 @@ <link linkend="language.expressions">Expressions</link>. </para> <para> - PHP 4 permet aussi d'assigner les valeurs aux variables + &php; 4 permet aussi d'assigner les valeurs aux variables <emphasis>par référence</emphasis>. Cela signifie que la nouvelle variable ne fait que référencer (en d'autres terme, "devient un alias de", ou encore "pointe sur") la @@ -63,17 +65,20 @@ Pour assigner par référence, ajoutez simplement un & (ET commercial) au début de la variable qui est assignée (la variable source). Dans l'exemple suivant, - "<literal>Mon nom est Pierre</literal>" s'affichera deux + <literal>Mon nom est Pierre</literal> s'affichera deux fois : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $foo = 'Pierre'; // Assigne la valeur 'Pierre' à $foo -$bar = &$foo; // Référence $foo avec $bar. +$bar = &$foo; // Référence $foo avec $bar. $bar = "Mon nom est Pierre"; // Modifie $bar... echo $foo; // $foo est aussi modifiée echo $bar; -?> +?> +]]> + </programlisting> </informalexample> </para> @@ -82,15 +87,18 @@ nommées peuvent être assignées par référence. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $foo = 25; -$bar = &$foo; // assignation valide . -$bar = &(24 * 7); // assignation invalide : référence une expression sans nom +$bar = &$foo; // assignation valide . +$bar = &(24 * 7); // assignation invalide : référence une expression sans nom function test() { return 25; } -$bar = &test(); // assignation invalide. -?> +$bar = &test(); // assignation invalide. +?> +]]> + </programlisting> </informalexample> </para> @@ -98,49 +106,51 @@ <sect1 id="language.variables.predefined"> <title>Variables prédéfinies</title> <simpara> - PHP fourni un grand nombre de variables prédéfinies. + &php; fourni un grand nombre de variables prédéfinies. Cependant, beaucoup de ces variables ne peuvent pas être présentées ici, car elles dépendent du serveur sur lequel elles tournent, de la version du serveur, et de la configuration du serveur, ou encore d'autres facteurs. Certaines - de ces variables ne seront pas accessibles lorsque PHP fonctionne + de ces variables ne seront pas accessibles lorsque &php; fonctionne en exécutable. </simpara> <warning> <simpara> - En PHP 4.2.0 et plus récent, le jeu de variables prédéfinies qui sont + En &php; 4.2.0 et plus récent, le jeu de variables prédéfinies qui sont disponibles dans l'environnement global a changé. Les variables d'entrées et de serveurs ne sont plus <emphasis>par défaut</emphasis> placées dans le contexte d'exécution global. Elles sont placées dans les <link linkend="language.variables.superglobals">tableaux superglobaux</link>. </simpara> <simpara> - Vous pouvez toujours forcer l'ancien comportement de PHP en le configurant + Vous pouvez toujours forcer l'ancien comportement de &php; en le configurant avec <link linkend="ini.register-globals">register_globals</link> à <literal>On</literal> votre fichier &php.ini;. </simpara> <simpara> Pour plus d'informations et d'explications sur ce changement, voyez - <ulink url="&url.php.release4.1.0;">l'annonce de PHP 4.1.0</ulink> (en anglais). + <ulink url="&url.php.release4.1.0;">l'annonce de &php; 4.1.0</ulink> + et and <ulink url="&url.php.release4.2.0;">l'annonce de &php; 4.2.0</ulink> + (en anglais). </simpara> </warning> <simpara> - Depuis la version 4.1.0, PHP fourni un jeu de tableaux + Depuis la version 4.1.0, &php; fournit un jeu de tableaux prédéfinis, contenant les variables du serveur (si possible), les variables d'environnement et celle d'entrées. Ces nouveaux tableaux sont un peut particuliers, car ils ont automatiquement globaux : ils sont automatiquement disponibles dans tous les environnements d'exécution, sans avoir à utiliser le mot réservé <literal>global</literal>. Pour cette raison, ils sont dits 'auto-globaux' ou bien encore - 'superglobaux' (il n'y a pas de mécanisme PHP pour créer de telles + 'superglobaux' (il n'y a pas de mécanisme &php; pour créer de telles variables. Les superglobales sont listées ci-dessous. Cependant, pour connaître le détails de leur contenu, et une présentation approfondie - sur les variables prédéfinies PHP, et leur nature, reportez vous + sur les variables prédéfinies &php;, et leur nature, reportez vous à la section <link linkend="reserved.variables">variables prédefinies</link>. </simpara> <variablelist id="language.variables.superglobals"> - <title>Tableaux superglobaux de PHP</title> + <title>Tableaux superglobaux de &php;</title> <varlistentry> <term><link linkend="reserved.variables.globals">$GLOBALS</link></term> <listitem> @@ -226,7 +236,7 @@ <varname>$_SERVER</varname>. La présence et la valeur des entrées de ce tableau sont réglés par la directive <link linkend="ini.variables-order">variables_order</link>. Ce tableau - n'est l'évolution d'aucune variable d'avant PHP 4.1.0. + n'est l'évolution d'aucune variable d'avant &php; 4.1.0. </simpara> </listitem> </varlistentry> @@ -244,473 +254,25 @@ </varlistentry> </variablelist> </sect1> - - <sect1 id="language.variables.old"> - <title>Missing title</title> - <warning> - <simpara> - Cette section est la documentation qui avait cours jusqu'en PHP - version 4.1.2. Elle est laissée ici pour assurer la transition - avec les nouvelles versions, qui ont <emphasis>abandonné définitivement</emphasis> - leur usage. Nous recommandons vivement au lecteur la - <link linkend="language.variables.superglobals">section précédente</link>. - </simpara> - <simpara> - Pour assurer une meilleure compatibilité de vos scripts avec - les nouvelles versions de PHP, n'utilisez plus ces variables. - </simpara> - </warning> - <simpara> - Malgré ces données, voici une liste de variables - prédéfinies, qui seront accessibles avec une - installation ad hoc de PHP3, fonctionnant en module, sous - <ulink url="&url.apache;">Apache</ulink> 1.3.6. - </simpara> - <simpara> - Pour la liste complète des variables prédéfinies - (et d'autres informations pratiques) reportez-vous (et usez) de - <function>phpinfo</function>. - </simpara> - <note> - <simpara> - Cette liste n'est pas exhaustive et ne le sera pas. C'est simplement un - aperçu des variables prédéfinies qui - peuvent être accessibles dans les scripts. - </simpara> - </note> - <sect2 id="language.variables.predefined.apache"> - <title>Variables Apache</title> - <simpara> - Ces variables sont créées par le serveur - <ulink url="&url.apache;">Apache</ulink>. Si vous utilisez un autre - serveur web, il n'est pas sur que celui-ci vous fournira - les mêmes variables. Il peut ne pas les fournir, en - fournir d'autres. Cependant, un bon nombre de ces variables - font partie de l'interface <ulink url="&url.cgispec;">CGI 1.1</ulink>, - et on peut s'attendre à les retrouver. - </simpara> - <simpara> - Notez que peu d'entre elles seront accessibles lorsque PHP est appelé - en ligne de commande, (et elles n'auront alors peut être pas de sens) - </simpara> - <para> - <variablelist> - <varlistentry> - <term>$GATEWAY_INTERFACE</term> - <listitem> - <simpara> - Numéro de révision de l'interface CGI du serveur : - i.e. 'CGI/1.1'. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$SERVER_NAME</term> - <listitem> - <simpara> - Le nom du serveur hôte qui éxécute le script suivant. - Si le script est exécuté sur un hôte virtuel, ce sera - la valeur définie pour cet hôte virtuel. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$SERVER_SOFTWARE</term> - <listitem> - <simpara> - Chaîne d'identification du serveur, qui est donnée dans - les en-têtes lors de la réponse aux requêtes. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$SERVER_PROTOCOL</term> - <listitem> - <simpara> - Nom et révision du protocole de communication : i.e. 'HTTP/1.0'; - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$REQUEST_METHOD</term> - <listitem> - <simpara> - Méthode de requête utilisée pour accéder - à la page; i.e. 'GET', 'HEAD', 'POST', 'PUT'. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$QUERY_STRING</term> - <listitem> - <simpara> - La chaîne de requête, si elle existe, qui est - utilisée pour accéder à la page. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$DOCUMENT_ROOT</term> - <listitem> - <simpara> - La racine sous laquelle le script courant est exécuté, - comme défini dans la configuration du serveur. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_ACCEPT</term> - <listitem> - <simpara> - Contenu de l'en-tête <literal>Accept:</literal> de la - requête courante, s'il y en a une. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_ACCEPT_CHARSET</term> - <listitem> - <simpara> - Contenu de l'en-tête <literal>Accept-Charset:</literal> - de la requête courante, s'elle existe. Par exemple : - '<literal>iso-8859-1,*,utf-8</literal>'. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_ACCEPT_ENCODING</term> - <listitem> - <simpara> - Contenu de l'en-tête <literal>Accept-Encoding:</literal> - de la requête courante, si elle existe. Par exemple : 'gzip'. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_ACCEPT_LANGUAGE</term> - <listitem> - <simpara> - Contenu de l'en-tête <literal>Accept-Language:</literal> de - la requête courante, si elle existe. Par exemple : 'en'. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_CONNECTION</term> - <listitem> - <simpara> - Contenu de l'en-tête <literal>Connection:</literal> de la - requête courante, si elle existe. Par exemple : 'Keep-Alive'. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_HOST</term> - <listitem> - <simpara> - Contenu de l'en-tête <literal>Host:</literal> de la - requête courante, si elle existe. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_REFERER</term> - <listitem> - <simpara> - L'adresse de la page (si elle existe) qui a conduit le - client à la page courante. Cette valeur est - affectée par le client, et tous les clients ne le font pas. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_USER_AGENT</term> - <listitem> - <simpara> - Contenu de l'en-tête <literal>User_Agent:</literal> de - la requête courante, si elle existe. C'est une chaîne - qui décrit le client HTML utilisé pour voir - la page courante. Par exemple : - <computeroutput>Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586)</computeroutput>. - Entre autres choses, vous pouvez utiliser cette valeur avec - <function>get_browser</function> pour optimiser votre page - en fonction des capacités du client. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$REMOTE_ADDR</term> - <listitem> - <simpara> - L'adresse IP du client qui demande la page courante. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$REMOTE_PORT</term> - <listitem> - <simpara> - Le port utilisé par la machine cliente pour communiquer - avec le serveur web. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$SCRIPT_FILENAME</term> - <listitem> - <simpara> - Le chemin absolu jusqu'au script courant. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$SERVER_ADMIN</term> - <listitem> - <simpara> - La valeur donnée à la directive SERVER_ADMIN - (pour Apache), dans le fichier de configuration. Si le script - est exécuté par un hôte virtuel, ce sera la - valeur définie par l'hôte virtuel. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$SERVER_PORT</term> - <listitem> - <simpara> - Le port de la machine serveur utilisé pour les - communications. Par défaut, c'est '80'. En utilisant - SSL, par exemple, il sera remplacé par le numéro - de port HTTP sécurisé. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$SERVER_SIGNATURE</term> - <listitem> - <simpara> - Chaîne contenant le numéro de version du serveur - et le nom d'hôte virtuel, qui sont ajoutés aux - pages générées par le serveur, si cette - option est activée. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$PATH_TRANSLATED</term> - <listitem> - <simpara> - Chemin dans le système de fichier (pas le document root-) - jusqu'au script courant, une fois que le serveur a fait - une chemin traduction virtuel->réel. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$SCRIPT_NAME</term> - <listitem> - <simpara> - Contient le nom du script courant. Cela sert lorsque - les pages doivent s'appeler elles-mêmes. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$REQUEST_URI</term> - <listitem> - <simpara> - L'URI qui a été fourni pour accéder - à cette page. Par exemple : '/index.html'. - </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> - </sect2> - <sect2 id="language.variables.predefined.environment"> - <title>Variables d'environnement</title> - <simpara> - Ces variables sont importées dans l'espace de nom global - de PHP, depuis l'environnement sous lequel PHP fonctionne. Beaucoup - d'entre elles sont fournies par le shell qui exécute PHP et - différents systèmes étant susceptibles - de disposer de différents shells, une liste définitive - est impossible à établir. Reportez-vous à la - documentation de votre shell, pour connaître la liste des - variables d'environnement prédéfinies. - </simpara> - <simpara> - Les autres variables d'environment incluent les variables CGI, - placées ici, quelquefois la méthode - d'éxécution de PHP (CGI ou module). - </simpara> - </sect2> - <sect2 id="language.variables.predefined.php"> - <title>Variables PHP</title> - <simpara> - Ces variables sont créées par PHP lui_même. - Les variables <varname>$HTTP_*_VARS</varname> ne sont disponibles - que si l'option de configuration - <link linkend="ini.track-vars">track_vars</link> a - été activée. Lorsque c'est le cas, ces variables - existent toujours, même si ce sont des tableaux vides. Cela évite les - usurpations mal intentionnées de ces variables. - </simpara> - <note> - <para> - Depuis PHP 4.0.3, - <link linkend="ini.track-vars">track_vars</link> est toujours - activé, quelle que soit la configuration. - </para> - </note> - <para> - Si la directive - <link linkend="ini.register-globals">register_globals</link> est activée, - alors ces variables seront aussi disponibles comme variables - globales du script : c'est-à-dire, indépendamment des tableaux - <varname>$HTTP_*_VARS</varname>. Cette fonctionnalité - doit être utilisée avec précautions, et de - préférence, désactivée. - Si <varname>$HTTP_*_VARS</varname> est sécurisé, - les équivalents globaux peuvent être écrasés - par les données d'entrée de l'utilisateur, - avec des intrusions possibles. Si vous ne pouvez pas désactiver - <link linkend="ini.register-globals">register_globals</link>, vous - devez prendre toutes les dispositions possibles pour vous assurer - que les données utilisées sont sûres. - </para> - <para> - <variablelist> - <varlistentry> - <term>$argv</term> - <listitem> - <simpara> - Tableau des arguments passées au script. Lorsque le script - est appelé en ligne de commande, cela donne accès - aux arguments, comme en langage C. Lorsque le script est - appelé avec la méthode GET, ce tableau contiendra - la chaîne de requête. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$argc</term> - <listitem> - <simpara> - Contient le nombre de paramètres de la ligne de commande - passés au script (si le script fonctionne en ligne de commande). - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$PHP_SELF</term> - <listitem> - <simpara> - Le nom du fichier du script en cour d'éxécution, par - rapport au document root. Si PHP fonctionne en ligne de commande, - cette variable n'est pas disponible. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_COOKIE_VARS</term> - <listitem> - <simpara> - Un tableau associatif des variables passées au script - courant via les HTTP cookies. Uniquement possible si le suivi - des variables a été activé avec - la directive générale - <link linkend="ini.track-vars">track_vars</link> ou - avec la directive locale - <computeroutput><? php_track_vars ?></computeroutput>. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_GET_VARS</term> - <listitem> - <simpara> - Un tableau associatif des variables passées au script - courant via les HTTP GET. Uniquement possible si le suivi des - variables a été activé avec la directive - générale - <link linkend="ini.track-vars">track_vars</link> ou - avec la directive locale - <computeroutput><? php_track_vars ?></computeroutput>. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_POST_VARS</term> - <listitem> - <simpara> - Un tableau associatif des variables passées au script - courant via les HTTP POST. Uniquement possible si le suivi des - variables a été activé avec la directive - générale - <link linkend="ini.track-vars">track_vars</link> ou - avec la directive locale - <computeroutput><? php_track_vars ?></computeroutput>. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_POST_FILES</term> - <listitem> - <simpara> - Un tableau associatif contenant les informations sur les - fichiers téléchargés avec la méthode - HTTP POST. Reportez-vous au chapitre - <link linkend="features.file-upload.post-method"> - Téléchargement par méthode POST</link> - pour plus de détails sur le contenu de - <varname>$HTTP_POST_FILES</varname>. - </simpara> - <para> - <varname>$HTTP_POST_FILES</varname> n'est disponible que dans - les versions 4.0.0 et plus récentes de PHP. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_ENV_VARS</term> - <listitem> - <simpara> - Un tableau associatif des variables passées au script - par l'environnement parent. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>$HTTP_SERVER_VARS</term> - <listitem> - <simpara> - Un tableau associatif des variables passées au script - par le serveur HTTP. Ces variables sont analogues - aux variables décrites ci-dessus. - </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> - </sect2> - </sect1> <sect1 id="language.variables.scope"> <title>Portée des variables</title> <simpara> La portée d'une variable dépend du contexte dans lequel la variable est définie. Pour la majorité des variables, la portée concerne la totalité d'un script - PHP. Mais, lorsque vous définissez une fonction, la + &php;. Mais, lorsque vous définissez une fonction, la portée d'une variable définie dans cette fonction est locale à la fonction. Par exemple: </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = 1; include "b.inc"; -?> +?> +]]> + </programlisting> </informalexample> <simpara> @@ -723,13 +285,16 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = 1; /* portée globale */ function test() { echo $a; /* portée locale */ } test(); -?> +?> +]]> + </programlisting> </informalexample> <simpara> @@ -742,14 +307,15 @@ les fonctions, à moins d'être redéfinie localement dans la fonction. Cela peut poser des problèmes si vous redéfinissez des variables globales localement. - En PHP, une variable globale doit être + En &php;, une variable globale doit être déclarée à l'intérieur de chaque fonction afin de pouvoir être utilisée dans cette fonction. Par exemple: </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = 1; $b = 2; function somme() { @@ -758,10 +324,11 @@ } somme(); echo $b; +]]> </programlisting> </informalexample> <simpara> - Le script ci-dessus va afficher la valeur "3". + Le script ci-dessus va afficher la valeur <literal>3</literal>. En déclarant globales les variables $a et $b locales de la fonction somme(), toutes les références à ces variables concerneront les variables globales. Il n'y a @@ -777,15 +344,18 @@ </simpara> <informalexample> <programlisting role="php"> -<?php -$a = 1; -$b = 2; -function somme() { +<![CDATA[ +<?php + $a = 1; + $b = 2; + function somme() { $GLOBALS["b"] = $GLOBALS["a"] + $GLOBALS["b"]; -} -somme(); -echo $b; -?> + } + somme(); + echo $b; +?> +]]> + </programlisting> </informalexample> <simpara> @@ -801,13 +371,16 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function test() { $a = 0; echo $a; $a++; } -?> +?> +]]> + </programlisting> </informalexample> <simpara> @@ -822,13 +395,16 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function test() { static $a = 0; echo $a; $a++; } -?> +?> +]]> + </programlisting> </informalexample> <simpara> @@ -848,17 +424,20 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php function test() { static $count = 0; $count++; echo $count; - if ($count < 10) { + if ($count < 10) { test(); } $count--; } -?> +?> +]]> + </programlisting> </informalexample> </sect1> @@ -872,9 +451,12 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $a = "bonjour"; -?> +?> +]]> + </programlisting> </informalexample> <simpara> @@ -886,21 +468,27 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $$a = "monde"; -?> +?> +]]> + </programlisting> </informalexample> <simpara> A ce niveau, deux variables ont été définies et - stockées dans l'arbre des symboles PHP: $a avec comme valeur + stockées dans l'arbre des symboles &php; : $a avec comme valeur "bonjour" et $bonjour avec comme valeur "monde". Alors, l'instruction </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo "$a ${$a}"; -?> +?> +]]> + </programlisting> </informalexample> <simpara> @@ -908,9 +496,12 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo "$a $bonjour"; -?> +?> +]]> + </programlisting> </informalexample> <simpara> @@ -927,11 +518,11 @@ </simpara> </sect1> <sect1 id="language.variables.external"> - <title>Variables externes à PHP</title> + <title>Variables externes à &php;</title> <sect2 id="language.variables.external.form"> <title>Formulaires HTML (GET et POST)</title> <simpara> - Lorsqu'un formulaire est envoyé à un script PHP, + Lorsqu'un formulaire est envoyé à un script &php;, toutes les variables du formulaire seront automatiquement disponibles dans le script. Par exemple, considérons le formulaire suivant: </simpara> @@ -939,15 +530,17 @@ <example> <title>Exemple avec un formulaire simple</title> <programlisting role="html"> -<form action="foo.php" method="post"> - Nom: <input type="text" name="nom"><br> - <input type="submit"> -</form> +<![CDATA[ +<form action="foo.php" method="post"> + Nom: <input type="text" name="nom"><BR> + <input type="submit"> +</form> +]]> </programlisting> </example> </para> <simpara> - Lorsque ce formulaire est envoyé, le PHP va créer la variable + Lorsque ce formulaire est envoyé, le &php; va créer la variable <computeroutput>$nom</computeroutput>, qui contiendra la valeur que vous avez entrée dans le champs <emphasis>Nom:</emphasis> du formulaire. @@ -967,7 +560,7 @@ </para> </note> <simpara> - Le PHP permet aussi l'utilisation des tableaux dans le contexte de + Le &php; permet aussi l'utilisation des tableaux dans le contexte de formulaire, mais seulement des tableaux à une seule dimension. Comme cela, vous pouvez rassembler des variables ou utiliser cette fonctionnalité pour récupérer les valeurs d'un choix @@ -977,17 +570,19 @@ <example> <title>Variables complexes de formulaire</title> <programlisting role="html"> -<form action="array.php" method="post"> - Name: <input type="text" name="personal[name]"><br> - Email: <input type="text" name="personal[email]"><br> - Beer: <br> - <select multiple name="vin[]"> - <option value="medoc">Médoc - <option value="chablis">Chablis - <option value="riesling">Riesling - </select> - <input type="submit"> -</form> +<![CDATA[ +<form action="array.php" method="post"> + Name: <input type="text" name="personal[name]"><br> + Email: <input type="text" name="personal[email]"><br> + Beer: <br> + <select multiple name="vin[]"> + <option value="medoc">Médoc + <option value="chablis">Chablis + <option value="riesling">Riesling + </select> + <input type="submit"> +</form> +]]> </programlisting> </example> </para> @@ -995,7 +590,11 @@ Si l'option "track_vars" est activée, soit par l'option de compilation <link linkend="ini.track-vars">track_vars</link>, soit par la directive de - configuration <computeroutput><? php_track_vars ?></computeroutput>, + configuration <computeroutput> +<![CDATA[ + <? php_track_vars ?> +]]> +</computeroutput>, les variables transmises par les méthodes POST et GET pourront aussi être trouvées dans le tableau associatif global $HTTP_POST_VARS ou $HTTP_GET_VARS @@ -1010,7 +609,9 @@ </simpara> <informalexample> <programlisting role="html"> -<input type=image src="image.gif" name="sub"> +<![CDATA[ + <input type=image src="image.gif" name="sub"> +]]> </programlisting> </informalexample> <simpara> @@ -1020,7 +621,7 @@ de l'endroit où l'utilisateur à cliqué. Les utilisateurs expérimentés remarqueront que les noms de variables sont transmis avec une virgule à la place du - caractère "_", mais le PHP fait la conversion + caractère "_", mais &php; fait la conversion automatiquement. </simpara> </sect3> @@ -1028,7 +629,7 @@ <sect2 id="language.variables.external.cookies"> <title>HTTP Cookies</title> <simpara> - Le PHP supporte les cookies HTTP de manière totalement + &php; supporte les cookies HTTP de manière totalement transparente, comme défini dans les <ulink url="&spec.cookies;">Netscape's Spec</ulink>. Les cookies sont un mécanisme permettant de stocker des données @@ -1051,9 +652,12 @@ </simpara> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php setcookie ("MonCookie[]", "test", time()+3600); -?> +?> +]]> + </programlisting> </informalexample> <simpara> @@ -1066,51 +670,30 @@ <example> <title>Exemple avec <function>setcookie</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $compte++; SetCookie ("Compte", $compte, time()+3600); SetCookie ("Caddie[$compte]", $item, time()+3600); -?> +?> +]]> + </programlisting> </example> </sect2> - <sect2 id="language.variables.external.environment"> - <title>Variables d'environnement </title> - <para> - Le PHP fait en sorte que les variables d'environnement soient accessibles - directement comme des variables PHP normales. - <informalexample> - <programlisting role="php"> -<?php -echo $HOME; /* Affiche la valeur de la variable d'environnement HOME, - si celle-ci est affectée. */ -?> - </programlisting> - </informalexample> - </para> - <para> - Même si le PHP crée les variables lors de l'utilisation - des méthodes GET, POST et cookie, il est de temps en temps - préférable de transmettre explicitement la valeur de - la variable afin d'être sûr de la valeur. - La fonction <function>getenv</function> peut être - utilisée pour récupérer la valeur - des variables d'environnement. Vous pouvez aussi affecter - une variable d'environnement grâce à la fonction - <function>putenv</function>. - </para> - </sect2> <sect2 id="language.variables.external.dot-in-names"> <title>Cas des points dans les noms de variables</title> <para> - Typiquement, PHP ne modifie pas les noms des variables lorsqu'elles + Typiquement, &php; ne modifie pas les noms des variables lorsqu'elles sont passées à un script. Cependant, il faut noter que les points (.) ne sont pas autorisés dans les noms de variables - PHP. Pour cette raison, jetez un oeil sur : + &php;. Pour cette raison, jetez un oeil sur : <programlisting role="php"> -<?php -$varname.ext; /* nom de variable invalide */ -?> +<![CDATA[ +<?php + $varname.ext; /* nom de variable invalide */ +?> +]]> </programlisting> Dans ce cas, l'analyseur croit voir la variable nommée $varname, suivie par l'opérateur de concaténation, @@ -1119,7 +702,7 @@ particulière). Visiblement, ce n'est pas ce qu'on attendait... </para> <para> - Pour cette raison, il est important de noter que PHP remplacera + Pour cette raison, il est important de noter que &php; remplacera automatiquement les points des noms de variables entrantes par des soulignés (underscore). </para> @@ -1127,10 +710,10 @@ <sect2 id="language.variables.determining-type-of"> <title>Détermination du type des variables</title> <para> - Parceque le PHP détermine le type des variables et + Parceque &php; détermine le type des variables et les convertit (généralement) comme il faut, ce n'est pas toujours le type de variable que vous souhaitez. - PHP inclut des fonctions permettant de déterminer le + &php; inclut des fonctions permettant de déterminer le type d'une variable : <function>gettype</function>, <function>is_long</function>,