cvs: phpdoc-fr /appendices migration52.xml /chapters intro.xml /faq installation.xml /features remote-files.xml /install/unix apache2.xml
lighttpd-14.xml sun.xml /install/windows index.xml manual.xml sun.xml /language constants.xml control-structures.xml exceptions.xml expressions.xml
oop.xml oop5.xml operators.xml variables.xml

From: Date: Mon, 01 Dec 2008 16:24:37 +0000
Subject: cvs: phpdoc-fr /appendices migration52.xml /chapters intro.xml /faq installation.xml /features remote-files.xml /install/unix apache2.xml
lighttpd-14.xml sun.xml /install/windows index.xml manual.xml sun.xml /language constants.xml control-structures.xml exceptions.xml expressions.xml
oop.xml oop5.xml operators.xml variables.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-6131@lists.php.net to get a copy of this message
gui Mon Dec 1 16:24:37 2008 UTC Modified files: /phpdoc-fr/appendices migration52.xml /phpdoc-fr/chapters intro.xml /phpdoc-fr/faq installation.xml /phpdoc-fr/features remote-files.xml /phpdoc-fr/install/unix apache2.xml lighttpd-14.xml sun.xml /phpdoc-fr/install/windows index.xml manual.xml sun.xml /phpdoc-fr/language constants.xml control-structures.xml exceptions.xml expressions.xml oop.xml oop5.xml operators.xml variables.xml Log: sync with EN

http://cvs.php.net/viewvc.cgi/phpdoc-fr/appendices/migration52.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/appendices/migration52.xml diff -u phpdoc-fr/appendices/migration52.xml:1.10 phpdoc-fr/appendices/migration52.xml:1.11 --- phpdoc-fr/appendices/migration52.xml:1.10 Sat Aug 23 16:21:02 2008 +++ phpdoc-fr/appendices/migration52.xml Mon Dec 1 16:24:37 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.36 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.37 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <appendix xml:id="migration52" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -1241,9 +1241,9 @@ <itemizedlist> <listitem> <simpara> - boolean XMLReader::setSchema(string filename) + boolean <function>XMLReader::setSchema</function> - Utilise le schéma W3C XSD pour valider le document tel qu'il est traité. - L'activation n'est possible qu'avant la première lecture avec <literal>Read()</literal>. + L'activation n'est possible qu'avant la première lecture avec <function>XMLReader::read</function> </simpara> </listitem> </itemizedlist> @@ -2012,4 +2012,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> \ No newline at end of file +--> http://cvs.php.net/viewvc.cgi/phpdoc-fr/chapters/intro.xml?r1=1.44&r2=1.45&diff_format=u Index: phpdoc-fr/chapters/intro.xml diff -u phpdoc-fr/chapters/intro.xml:1.44 phpdoc-fr/chapters/intro.xml:1.45 --- phpdoc-fr/chapters/intro.xml:1.44 Sun Jun 8 07:38:05 2008 +++ phpdoc-fr/chapters/intro.xml Mon Dec 1 16:24:37 2008 @@ -1,240 +1,240 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.44 $ --> -<!-- EN-Revision: 1.47 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.45 $ --> +<!-- EN-Revision: 1.49 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> + <chapter xml:id="introduction" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <info><title>Introduction</title></info> -<chapter xml:id="introduction" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - &reftitle.intro; - - <section xml:id="intro-whatis"> - <title>Qu'est ce que PHP?</title> - <para> - <acronym>PHP</acronym> (officiellement, ce sigle est un acronyme récursif pour - <literal>PHP: Hypertext Preprocessor</literal>) est un langage de scripts généraliste - et Open Source, spécialement conçu pour le développement d'applications - web. Il peut être intégré facilement au HTML. - </para> - <para> - Bien... mais qu'est ce que cela veut dire ? Un exemple : - </para> - <para> - <example> - <info><title>Exemple d'introduction</title></info> - <programlisting role="php"> + <section xml:id="intro-whatis"> + <info><title>Qu'est ce que PHP?</title></info> + <para> + <acronym>PHP</acronym> (officiellement, ce sigle est un acronyme récursif pour + <literal>PHP: Hypertext Preprocessor</literal>) est un langage de scripts généraliste + et Open Source, spécialement conçu pour le développement d'applications + web. Il peut être intégré facilement au HTML. + </para> + <para> + Bien... mais qu'est ce que cela veut dire ? Un exemple : + </para> + <para> + <example> + <info><title>Exemple d'introduction</title></info> + <programlisting role="php"> <![CDATA[ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> - <head> - <title>Exemple</title> - </head> - <body> + <head> + <title>Exemple</title> + </head> + <body> <?php echo "Bonjour, je suis un script PHP !"; ?> - </body> + </body> </html> ]]> - </programlisting> - </example> - </para> - <para> - Au lieu d'utiliser des tonnes de commande afin d'afficher du HTML (comme en - C ou en Perl), les pages PHP contiennent des fragments HTML dont du code - qui fait "quelque chose" (dans ce cas, il va afficher "Bonjour, je suis un script PHP !"). - Le code PHP est inclus entre - <link linkend="language.basic-syntax.phpmode">une balise de début - et une balise de fin</link> qui permettent au serveur web de passer en "mode PHP". - </para> - <para> - Ce qui distingue PHP des langages de script comme le Javascript, - est que le code est exécuté sur le serveur, générant ainsi le HTML, qui - sera ensuite envoyé au client. Le client ne reçoit que le - résultat du script, sans aucun moyen d'avoir accès au code - qui a produit ce résultat. Vous pouvez configurer votre serveur - web afin qu'il analyse tous vos fichiers HTML comme des fichiers PHP. - Ainsi, il n'y a aucun moyen de distinguer les pages qui sont produites - dynamiquement des pages statiques. - </para> - <para> - Le grand avantage de PHP est qu'il est extrêmement simple pour les - néophytes, mais offre des fonctionnalités avancées pour les - experts. Ne craignez pas de lire la longue liste de fonctionnalités - PHP. Vous pouvez vous plonger dans le code, et en quelques - instants, écrire des scripts simples. - </para> - <para> - Bien que le développement de PHP soit orienté vers la programmation - pour les sites web, vous pouvez en faire bien d'autres usages. - Lisez donc la section <link linkend="intro-whatcando">Que peut faire PHP ?</link> - ou bien le <link linkend="tutorial">tutoriel d'introduction</link> si vous êtes - uniquement intéressé dans la programmation web. - </para> - </section> - - <section xml:id="intro-whatcando"> - <title>Que peut faire PHP ?</title> - <para> - Tout. PHP est principalement conçu pour servir de - langage de script coté serveur, ce qui fait qu'il est capable - de réaliser tout ce qu'un script CGI quelconque peut faire, comme - collecter des données de formulaire, générer du contenu dynamique, - ou gérer des cookies. Mais PHP peut en faire bien plus. - </para> - <para> - Il y a trois domaines différents où PHP peut s'illustrer. - <itemizedlist> - <listitem> - <simpara> - Langage de script coté serveur. C'est l'utilisation la plus - traditionnelle, et aussi le principal objet de PHP. - Vous aurez besoin de trois composants pour l'exploiter : - un analyseur PHP (CGI ou module serveur), un serveur - web et un navigateur web. Vous devez exécuter le serveur - web en corrélation avec PHP. Vous pouvez accéder - au programme PHP avec l'aide du navigateur web. Tout ceci - peut fonctionner sur votre propre machine si vous êtes juste expérimenté - dans la programmation en PHP. Voyez - la section <link linkend="install">d'installation</link> - pour plus d'informations. - </simpara> - </listitem> - <listitem> - <simpara> - Langage de programmation en ligne de commande. Vous pouvez - écrire des scripts PHP et l'exécuter en ligne de commande, - sans l'aide du serveur web et d'un navigateur. Il vous suffit - de disposer de l'exécutable PHP. Cette utilisation est idéale - pour les scripts qui sont exécutés régulièrement (avec un cron - sous Unix ou Linux), ou un Task Scheduler (sous Windows). Ces scripts - peuvent aussi être utilisés pour réaliser des opérations sur des - fichiers texte. Voyez la section sur l'utilisation de PHP en - <link linkend="features.commandline">ligne de commande</link> - pour plus d'informations. - </simpara> - </listitem> - <listitem> - <simpara> - Ecrire des applications clientes graphiques. PHP n'est probablement - pas le meilleur langage pour écrire des applications clientes - graphiques, mais si vous connaissez bien PHP et que - vous souhaitez exploiter des fonctionnalités avancées - dans vos applications clientes, vous pouvez utiliser - PHP-GTK pour écrire de tels programmes. Vous avez aussi la - possibilité d'écrire des applications très portables - avec ce langage. PHP-GTK est une extension de PHP, qui - n'est pas fournie dans la distribution de base. Si vous êtes - intéressé par PHP-GTK, visitez - <link xlink:href="&url.php.gtk;">son site web</link>. - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - PHP est utilisable sur la majorité des systèmes d'exploitation, comme - Linux, de nombreuses variantes Unix (incluant HP-UX, Solaris et OpenBSD), - Microsoft Windows, Mac OS X, RISC OS et d'autres encore. - PHP supporte aussi la plupart des serveurs web actuels : - Apache, Microsoft Internet Information Server, - Personal Web Server, Netscape et iPlanet servers, Oreilly - Website Pro server, Caudium, Xitami, OmniHTTPd et beaucoup d'autres - encore. Pour la majorité des serveurs web, PHP fonctionne comme - module et, pour d'autres, il comme exécutable CGI. - </para> - <para> - Avec PHP vous avez le choix de votre système d'exploitation et - de votre serveur web. De plus, vous avez aussi le choix d'utiliser - la programmation procédurale ou objet, ou encore un mélange des - deux. Bien que le support de la couche objet ne soit pas très - standard en PHP 4, beaucoup de bibliothèques - et d'applications d'envergures (incluant la bibliothèque PEAR) ont été écrites en utilisant uniquement - du code orienté objet. PHP 5 a rectifié les faiblesses de la couche objet de PHP 4 et a introduit - un modèle objet complet. - </para> - <para> - Avec PHP, vous n'êtes pas limité à la production de code - HTML. Les capacités de PHP lui permettent de générer aussi - bien des images, des fichiers PDF, des animations Flash - (avec l'aide des bibliothèques libswf et Ming) générés à la - volée. Vous pouvez aussi générer facilement du texte, du code - XML ou XHTML. PHP génère tous ces fichiers et les sauve dans - le système de fichier, ou bien les envoie directement au navigateur - web. - </para> - <para> - Une des grandes forces de PHP est le support de nombreuses bases - de données. Ecrire une page web exploitant une base de données est - extrêmement simple. Les bases de données suivantes sont - toutes supportées par PHP : - <blockquote> - <simplelist columns="3"> - <member>Adabas D</member> - <member>dBase</member> - <member>Empress</member> - <member>FilePro (lecture seule)</member> - <member>Hyperwave</member> - <member>IBM DB2</member> - <member>Informix</member> - <member>Ingres</member> - <member>InterBase</member> - <member>FrontBase</member> - <member>mSQL</member> - <member>Direct MS-SQL</member> - <member>MySQL</member> - <member>ODBC</member> - <member>Oracle (OCI7 et OCI8)</member> - <member>Ovrimos</member> - <member>PostgreSQL</member> - <member>SQLite</member> - <member>Solid</member> - <member>Sybase</member> - <member>Velocis</member> - <member>Unix dbm</member> - </simplelist> - </blockquote> - Il existe aussi une couche d'abstraction de base de données (nommée PDO) - qui vous permettent de vous connecter de manière transparente à toute - base de données supportée par cette extension. De plus, PHP supporte - ODBC, ce qui vous permet de vous connecter à toute autre base de données - qui supporte ce standard. - </para> - <para> - PHP supporte de nombreux protocoles comme - LDAP, IMAP, SNMP, NNTP, POP3, HTTP, COM (sous Windows) et - encore d'autres. Vous pouvez ouvrir des sockets réseau, - et intéragir avec n'importe quel autre protocole. PHP supporte - le format complexe WDDX, qui permet de communiquer entre tous - les langages web. En terme d'interconnexion, PHP supporte aussi - les instanciations d'objets Java, et les utilise de manière transparente - comme objets intégrés. Vous pouvez aussi exploiter les objets - distants avec CORBA. - </para> - <para> - PHP dispose de fonctionnalités extrêmement utiles pour le - traitement de texte, allant des expressions rationnelles - POSIX étendues ou Perl aux traitements des fichiers XML, - avec les standards SAX et DOM (PHP 4). Vous pouvez utiliser les - transformations XSLT. PHP 5 standardise toutes les extensions XML - sur la base solide de libxml2 et en attendant les fonctionnalités en - ajoutant le support de SimpleXML et XMLReader. - </para> - <para> - Enfin, PHP dispose d'extensions très pratiques comme - le moteur de recherche mnoGoSearch, la passerelle avec - IRC, des outils de compression (gzip, bz2, zip) et de conversion - calendaire, de traduction... - </para> - <para> - Comme vous le voyez, cette page n'est pas assez grande pour lister - toutes les puissantes fonctionnalités de PHP. Lisez la section - sur <link linkend="install">l'installation de PHP</link> - et étudiez la <link linkend="funcref">liste de fonctions</link> - pour avoir plus de détails sur toutes ces technologies. - </para> - </section> -</chapter> + </programlisting> + </example> + </para> + <para> + Au lieu d'utiliser des tonnes de commande afin d'afficher du HTML (comme en + C ou en Perl), les pages PHP contiennent des fragments HTML dont du code + qui fait "quelque chose" (dans ce cas, il va afficher "Bonjour, je suis un script PHP !"). + Le code PHP est inclus entre + <link linkend="language.basic-syntax.phpmode">une balise de début + et une balise de fin</link> qui permettent au serveur web de passer en "mode PHP". + </para> + <para> + Ce qui distingue PHP des langages de script comme le Javascript, + est que le code est exécuté sur le serveur, générant ainsi le HTML, qui + sera ensuite envoyé au client. Le client ne reçoit que le + résultat du script, sans aucun moyen d'avoir accès au code + qui a produit ce résultat. Vous pouvez configurer votre serveur + web afin qu'il analyse tous vos fichiers HTML comme des fichiers PHP. + Ainsi, il n'y a aucun moyen de distinguer les pages qui sont produites + dynamiquement des pages statiques. + </para> + <para> + Le grand avantage de PHP est qu'il est extrêmement simple pour les + néophytes, mais offre des fonctionnalités avancées pour les + experts. Ne craignez pas de lire la longue liste de fonctionnalités + PHP. Vous pouvez vous plonger dans le code, et en quelques + instants, écrire des scripts simples. + </para> + <para> + Bien que le développement de PHP soit orienté vers la programmation + pour les sites web, vous pouvez en faire bien d'autres usages. + Lisez donc la section <link linkend="intro-whatcando">Que peut faire PHP ?</link> + ou bien le <link linkend="tutorial">tutoriel d'introduction</link> si vous êtes + uniquement intéressé dans la programmation web. + </para> + </section> + + <section xml:id="intro-whatcando"> + <title>Que peut faire PHP ?</title> + <para> + Tout. PHP est principalement conçu pour servir de + langage de script coté serveur, ce qui fait qu'il est capable + de réaliser tout ce qu'un script CGI quelconque peut faire, comme + collecter des données de formulaire, générer du contenu dynamique, + ou gérer des cookies. Mais PHP peut en faire bien plus. + </para> + <para> + Il y a trois domaines différents où PHP peut s'illustrer. + <itemizedlist> + <listitem> + <simpara> + Langage de script coté serveur. C'est l'utilisation la plus + traditionnelle, et aussi le principal objet de PHP. + Vous aurez besoin de trois composants pour l'exploiter : + un analyseur PHP (CGI ou module serveur), un serveur + web et un navigateur web. Vous devez exécuter le serveur + web en corrélation avec PHP. Vous pouvez accéder + au programme PHP avec l'aide du navigateur web. Tout ceci + peut fonctionner sur votre propre machine si vous êtes juste expérimenté + dans la programmation en PHP. Voyez + la section <link linkend="install">d'installation</link> + pour plus d'informations. + </simpara> + </listitem> + <listitem> + <simpara> + Langage de programmation en ligne de commande. Vous pouvez + écrire des scripts PHP et l'exécuter en ligne de commande, + sans l'aide du serveur web et d'un navigateur. Il vous suffit + de disposer de l'exécutable PHP. Cette utilisation est idéale + pour les scripts qui sont exécutés régulièrement (avec un cron + sous Unix ou Linux), ou un Task Scheduler (sous Windows). Ces scripts + peuvent aussi être utilisés pour réaliser des opérations sur des + fichiers texte. Voyez la section sur l'utilisation de PHP en + <link linkend="features.commandline">ligne de commande</link> + pour plus d'informations. + </simpara> + </listitem> + <listitem> + <simpara> + Ecrire des applications clientes graphiques. PHP n'est probablement + pas le meilleur langage pour écrire des applications clientes + graphiques, mais si vous connaissez bien PHP et que + vous souhaitez exploiter des fonctionnalités avancées + dans vos applications clientes, vous pouvez utiliser + PHP-GTK pour écrire de tels programmes. Vous avez aussi la + possibilité d'écrire des applications très portables + avec ce langage. PHP-GTK est une extension de PHP, qui + n'est pas fournie dans la distribution de base. Si vous êtes + intéressé par PHP-GTK, visitez + <link xlink:href="&url.php.gtk;">son site web</link>. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + PHP est utilisable sur la majorité des systèmes d'exploitation, comme + Linux, de nombreuses variantes Unix (incluant HP-UX, Solaris et OpenBSD), + Microsoft Windows, Mac OS X, RISC OS et d'autres encore. + PHP supporte aussi la plupart des serveurs web actuels : + Apache, Microsoft Internet Information Server, + Personal Web Server, Netscape et iPlanet servers, Oreilly + Website Pro server, Caudium, Xitami, OmniHTTPd et beaucoup d'autres + encore. Pour la majorité des serveurs web, PHP fonctionne comme + module et, pour d'autres, il comme exécutable CGI. + </para> + <para> + Avec PHP vous avez le choix de votre système d'exploitation et + de votre serveur web. De plus, vous avez aussi le choix d'utiliser + la programmation procédurale ou objet, ou encore un mélange des + deux. Bien que le support de la couche objet ne soit pas très + standard en PHP 4, beaucoup de bibliothèques + et d'applications d'envergures (incluant la bibliothèque PEAR) ont été écrites en utilisant uniquement + du code orienté objet. PHP 5 a rectifié les faiblesses de la couche objet de PHP 4 et a introduit + un modèle objet complet. + </para> + <para> + Avec PHP, vous n'êtes pas limité à la production de code + HTML. Les capacités de PHP lui permettent de générer aussi + bien des images, des fichiers PDF, des animations Flash + (avec l'aide des bibliothèques libswf et Ming) générés à la + volée. Vous pouvez aussi générer facilement du texte, du code + XML ou XHTML. PHP génère tous ces fichiers et les sauve dans + le système de fichier, ou bien les envoie directement au navigateur + web. + </para> + <para> + Une des grandes forces de PHP est le support de nombreuses bases + de données. Ecrire une page web exploitant une base de données est + extrêmement simple. Les bases de données suivantes sont + toutes supportées par PHP : + <blockquote> + <simplelist columns="3"> + <member>Adabas D</member> + <member>dBase</member> + <member>Empress</member> + <member>FilePro (lecture seule)</member> + <member>Hyperwave</member> + <member>IBM DB2</member> + <member>Informix</member> + <member>Ingres</member> + <member>InterBase</member> + <member>FrontBase</member> + <member>mSQL</member> + <member>Direct MS-SQL</member> + <member>MySQL</member> + <member>ODBC</member> + <member>Oracle (OCI7 et OCI8)</member> + <member>Ovrimos</member> + <member>PostgreSQL</member> + <member>SQLite</member> + <member>Solid</member> + <member>Sybase</member> + <member>Velocis</member> + <member>Unix dbm</member> + </simplelist> + </blockquote> + Il existe aussi une couche d'abstraction de base de données (nommée PDO) + qui vous permettent de vous connecter de manière transparente à toute + base de données supportée par cette extension. De plus, PHP supporte + ODBC, ce qui vous permet de vous connecter à toute autre base de données + qui supporte ce standard. + </para> + <para> + PHP supporte de nombreux protocoles comme + LDAP, IMAP, SNMP, NNTP, POP3, HTTP, COM (sous Windows) et + encore d'autres. Vous pouvez ouvrir des sockets réseau, + et intéragir avec n'importe quel autre protocole. PHP supporte + le format complexe WDDX, qui permet de communiquer entre tous + les langages web. En terme d'interconnexion, PHP supporte aussi + les instanciations d'objets Java, et les utilise de manière transparente + comme objets intégrés. Vous pouvez aussi exploiter les objets + distants avec CORBA. + </para> + <para> + PHP dispose de fonctionnalités extrêmement utiles pour le + traitement de texte, allant des expressions rationnelles + POSIX étendues ou Perl aux traitements des fichiers XML, + avec les standards SAX et DOM (PHP 4). Vous pouvez utiliser les + transformations XSLT. PHP 5 standardise toutes les extensions XML + sur la base solide de libxml2 et en attendant les fonctionnalités en + ajoutant le support de SimpleXML et XMLReader. + </para> + <para> + Enfin, PHP dispose d'extensions très pratiques comme + le moteur de recherche mnoGoSearch, la passerelle avec + IRC, des outils de compression (gzip, bz2, zip) et de conversion + calendaire, de traduction... + </para> + <para> + Comme vous le voyez, cette page n'est pas assez grande pour lister + toutes les puissantes fonctionnalités de PHP. Lisez la section + sur <link linkend="install">l'installation de PHP</link> + et étudiez la <link linkend="funcref">liste de fonctions</link> + pour avoir plus de détails sur toutes ces technologies. + </para> + </section> + + </chapter> <!-- Keep this comment at the end of the file Local variables: @@ -252,4 +252,7 @@ sgml-local-catalogs:nil sgml-local-ecat-files:nil End: ---> \ No newline at end of file +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc-fr/faq/installation.xml?r1=1.40&r2=1.41&diff_format=u Index: phpdoc-fr/faq/installation.xml diff -u phpdoc-fr/faq/installation.xml:1.40 phpdoc-fr/faq/installation.xml:1.41 --- phpdoc-fr/faq/installation.xml:1.40 Thu May 8 08:06:21 2008 +++ phpdoc-fr/faq/installation.xml Mon Dec 1 16:24:37 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.40 $ --> -<!-- EN-Revision: 1.52 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.41 $ --> +<!-- EN-Revision: 1.53 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <chapter xml:id="faq.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -160,7 +160,7 @@ </para> <para> Si votre script utilise les expressions rationnelles - (<function>ereg</function> et consorts), assurez-vous que PHP et + (<function>preg_match</function> et consorts), assurez-vous que PHP et Apache ont été compilés avec les même outils d'expression rationnelles. Cela doit être automatiquement le cas avec PHP et Apache 1.3.x. </para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/features/remote-files.xml?r1=1.21&r2=1.22&diff_format=u Index: phpdoc-fr/features/remote-files.xml diff -u phpdoc-fr/features/remote-files.xml:1.21 phpdoc-fr/features/remote-files.xml:1.22 --- phpdoc-fr/features/remote-files.xml:1.21 Tue Apr 15 18:25:25 2008 +++ phpdoc-fr/features/remote-files.xml Mon Dec 1 16:24:37 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> -<!-- EN-Revision: 1.29 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.22 $ --> +<!-- EN-Revision: 1.30 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <chapter xml:id="features.remote-files" xmlns="http://docbook.org/ns/docbook"> @@ -54,12 +54,12 @@ exit; } while (!feof ($file)) { - $line = fgets ($file, 1024); - /* Cela ne fonctionne que si les balises Title sont correctement utilisées */ - if (eregi ("<title>(.*)</title>", $line, $out)) { - $title = $out[1]; - break; - } + $line = fgets ($file, 1024); + /* Cela ne fonctionne que si les balises Title sont correctement utilisées */ + if (preg_match ("@\<title\>(.*)\</title\>@i", $line, $out)) { + $title = $out[1]; + break; + } } fclose($file); ?> @@ -132,4 +132,4 @@ sgml-local-catalogs:nil sgml-local-ecat-files:nil End: ---> \ No newline at end of file +--> http://cvs.php.net/viewvc.cgi/phpdoc-fr/install/unix/apache2.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/install/unix/apache2.xml diff -u phpdoc-fr/install/unix/apache2.xml:1.13 phpdoc-fr/install/unix/apache2.xml:1.14 --- phpdoc-fr/install/unix/apache2.xml:1.13 Sun Jun 8 15:10:24 2008 +++ phpdoc-fr/install/unix/apache2.xml Mon Dec 1 16:24:37 2008 @@ -1,38 +1,39 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - -<sect1 xml:id="install.unix.apache2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Apache 2.0 sur les systèmes Unix</title> - <para> - Cette section contient les notes et conseils d'installation de PHP avec le serveur - Apache 2.0 sur les systèmes Unix. - </para> - - &warn.apache2.compat; - - <para> - Il est vivement recommandé de lire la - <link xlink:href="&url.apache2.docs;">documentation Apache</link> pour avoir - une meilleure connaissance du serveur web Apache 2.0. - </para> - - &install.snippet.apache2.compat; - - <para> - Téléchargez la version la plus récente de <link xlink:href="&url.apache;">Apache 2.0</link> - et une version appropriée de PHP, tel que décrit ci-dessus. Ce guide rapide - couvre les manipulations de base, nécessaires à l'installation de Apache 2.0 - et PHP. Pour plus d'informations, lisez la - <link xlink:href="&url.apache2.docs;">documentation Apache</link>. - Les numéros de version sont omis ici, pour s'assurer que les instructions ne soient - pas incorrectes. Il faudra donc remplacer les séquences 'NN' avec les valeurs - correctes que vous utilisez. - </para> - <example> - <title>Instruction d'installation (Module partagé Apache 2)</title> - <screen> + <sect1 xml:id="install.unix.apache2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Apache 2.0 sur les systèmes Unix</title> + <para> + Cette section contient les notes et conseils d'installation de PHP avec le serveur + Apache 2.0 sur les systèmes Unix. + </para> + + &warn.apache2.compat; + + <para> + Il est vivement recommandé de lire la + <link xlink:href="&url.apache2.docs;">documentation Apache</link> pour avoir + une meilleure connaissance du serveur web Apache 2.0. + </para> + + &install.snippet.apache2.compat; + + <para> + Téléchargez la version la plus récente de <link xlink:href="&url.apache;">Apache 2.0</link> + et une version appropriée de PHP, tel que décrit ci-dessus. Ce guide rapide + couvre les manipulations de base, nécessaires à l'installation de Apache 2.0 + et PHP. Pour plus d'informations, lisez la + <link xlink:href="&url.apache2.docs;">documentation Apache</link>. + Les numéros de version sont omis ici, pour s'assurer que les instructions ne soient + pas incorrectes. Il faudra donc remplacer les séquences 'NN' avec les valeurs + correctes que vous utilisez. + </para> + <example> + <title> + Instruction d'installation (Module partagé Apache 2) + </title> + <screen> <![CDATA[ 1. gzip -d httpd-2_0_NN.tar.gz 2. tar xvf httpd-2_0_NN.tar @@ -50,7 +51,7 @@ et pour stopper le serveur, utilisez /usr/local/apache2/bin/apachectl stop. -9. cd ../php4-NN +9. cd ../php-NN 10. Maintenant, configurez votre PHP. C'est l'endroit où vous configurez PHP avec diverses options, comme les extensions qui seront activées. Lancez @@ -71,9 +72,9 @@ Notez que, à moins de l'avoir explicitement désactivé, 'make install' installera aussi PEAR, et des outils PHP tels que phpize, installera le CLI PHP, etc. - + 13. Configurez votre fichier php.ini : - + cp php.ini-dist /usr/local/lib/php.ini Vous pouvez éditer votre fichier .ini pour régler certaines options PHP. Si vous souhaitez @@ -88,66 +89,82 @@ Le make install lancé plus haut l'y aura certainement déjà déposé pour vous, mais assurez-vous en. Pour PHP 4 : - - LoadModule php4_module modules/libphp4.so - + + LoadModule php4_module modules/libphp4.so + Pour PHP 5: - - LoadModule php5_module modules/libphp5.so - + + LoadModule php5_module modules/libphp5.so + 15. Dites à Apache de faire parser certaines extensions par PHP. Par exemple, - faites parser l'extension .php par PHP. Vous pouvez ajouter n'importe quelle(s) + faites parser l'extension .php par PHP. Plutôt que de n'utiliser que la directive Apache AddType, + nous souhaitons éviter des téléversements dangereux ou que des fichiers créés tels que + exploit.php.jpg soient intérprétés par PHP. En suivant cet exemple, vous pouvez ajouter n'importe quelle(s) extension(s) à parser juste en l'(les)ajoutant à la suite, séparée(s) par un espace. Nous ajouterons .phtml dans notre exemple. - - AddType application/x-httpd-php .php .phtml - - Il est assez fréquent de configurer l'extension .phps comme code source PHP colorisé, - ce qui peut être fait ainsi : - - AddType application/x-httpd-php-source .phps + + <FilesMatch \.php$> + SetHandler application/x-httpd-php + </FilesMatch> + + Ou, si nous souhaitons premettre uniquement aux fichiers .php, .php2, .php3, .php4, .php5, .php6 et + .phtml d'être interprétés par PHP, et à aucun autre, nous utiliserons : + + <FilesMatch "\.ph(p[2-6]?|tml)$"> + SetHandler application/x-httpd-php + </FilesMatch> + + Et pour permettre aux fichiers .phps d'être traités comme du code source PHP colorisé, ajoutez ceci : + + <FilesMatch "\.phps$"> + SetHandler application/x-httpd-php-source + </FilesMatch> 16. Utilisez votre méthode habituelle pour démarrer le serveur Apache, e.g.: /usr/local/apache2/bin/apachectl start + - OU - + + service httpd restart + ]]> - </screen> - </example> - <para> - Suivez les étapes ci-dessus, et vous disposerez d'un serveur Apache 2.0 - avec le support de PHP module comme module <literal>SAPI</literal>. Bien sur, il y a - bien d'autres options de configuration disponibles pour les deux logiciels, - Apache et PHP. Pour plus de détails, utilisez la commande - <command>./configure --help</command> dans le dossier de sources approprié. - Si vous souhaitez compiler une version multithreadé de Apache 2.0 - vous devrez remplacer le module standard MPM <filename>prefork</filename> - avec <filename>worker</filename> ou <filename>perchild</filename>. - Pour ce faire, ajoutez à la ligne de configuration de l'étape 6, l'option - <option role="configure">--with-mpm=worker</option> ou - <option role="configure">--with-mpm=perchild</option>. Soyez conscient des - conséquences, et comprenez bien ce que vous faites. Pour plus de détails sur - ce sujet, lisez la documentation Apache sur - <link xlink:href="&url.apache2.mpm;">le module MPM</link>. - </para> - <note> - <para> - Si vous voulez utiliser la négociation sur le contenu, lisez la section - <link linkend="faq.installation.apache.multiviews">FAQ Apache - MultiViews</link>. - </para> - </note> - <note> - <para> - Pour compiler une version multithreadée d'Apache, votre système doit - supporter les threads. Cela implique aussi de compiler PHP avec le module - expérimental de Zend Thread Safety (ZTS). Par conséquent, toutes les extensions - ne seront pas disponibles. La configuration recommandée actuellement est celle - avec le module standard MPM <filename>prefork</filename>. - </para> - </note> -</sect1> + </screen> + </example> + <para> + Suivez les étapes ci-dessus, et vous disposerez d'un serveur Apache 2.0 + avec le support de PHP module comme module <literal>SAPI</literal>. Bien sur, il y a + bien d'autres options de configuration disponibles pour les deux logiciels, + Apache et PHP. Pour plus de détails, utilisez la commande + <command>./configure --help</command> dans le dossier de sources approprié. + Si vous souhaitez compiler une version multithreadée de Apache 2.0 + vous devrez remplacer le module standard MPM <filename>prefork</filename> + avec <filename>worker</filename> ou <filename>perchild</filename>. + Pour ce faire, ajoutez à la ligne de configuration de l'étape 6, l'option + <option role="configure">--with-mpm=worker</option> ou + <option role="configure">--with-mpm=perchild</option>. Avant de procéder, soyez conscient des + conséquences, et comprenez bien ce que vous faites. Pour plus de détails sur + ce sujet, lisez la documentation Apache sur + <link xlink:href="&url.apache2.mpm;">le module MPM</link>. + </para> + <note> + <para> + Si vous voulez utiliser la négociation sur le contenu, lisez la section + <link linkend="faq.installation.apache.multiviews">FAQ Apache + MultiViews</link>. + </para> + </note> + <note> + <para> + Pour compiler une version multithreadée d'Apache, votre système doit + supporter les threads. Cela implique aussi de compiler PHP avec le module + expérimental de Zend Thread Safety (ZTS). Par conséquent, toutes les extensions + ne seront pas disponibles. La configuration recommandée actuellement est celle + avec le module standard MPM <filename>prefork</filename>. + </para> + </note> + </sect1> <!-- Keep this comment at the end of the file Local variables: @@ -168,4 +185,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> \ No newline at end of file +--> http://cvs.php.net/viewvc.cgi/phpdoc-fr/install/unix/lighttpd-14.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-fr/install/unix/lighttpd-14.xml diff -u phpdoc-fr/install/unix/lighttpd-14.xml:1.2 phpdoc-fr/install/unix/lighttpd-14.xml:1.3 --- phpdoc-fr/install/unix/lighttpd-14.xml:1.2 Wed Jun 11 10:03:02 2008 +++ phpdoc-fr/install/unix/lighttpd-14.xml Mon Dec 1 16:24:37 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <sect1 xml:id="install.unix.lighttpd-14" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -15,7 +15,7 @@ Reportez-vous à <link xlink:href="&url.lighttpd.doc;">Lighttpd</link> pour une installation correcte de Lighttpd avant de continuer. </para> - + <para> Fastcgi est le SAPI préféré pour connecter PHP et Lighttpd. Fastcgi active automatiquement php-cgi depuis PHP 5.3.0, mais pour les versions antérieures, @@ -24,7 +24,7 @@ <literal>php -v</literal> doit contenir <literal>PHP 5.2.5 (cgi-fcgi)</literal>. Avant PHP 5.2.3, fastcgi était activé dans le binaire PHP (php-cgi n'existait pas). </para> - + <sect2 xml:id="install.unix.lighttpd-14.lighttpd-spawn"> <title>Appel de PHP par Lighttpd</title> @@ -47,7 +47,7 @@ "bin-environment" => ( "PHP_FCGI_CHILDREN" => "16", "PHP_FCGI_MAX_REQUESTS" => "10000" - ) + ), "min-procs" => 1, "max-procs" => 1, "idle-timeout" => 20 @@ -92,7 +92,7 @@ vie, en nombre de requêtes, de chaque fils. Voici un script bash simple qui permet d'aider les appels aux répondeurs PHP. </para> - + <example> <title>Appel des répondeurs FastCGI</title> <screen> @@ -131,6 +131,7 @@ Les instances Fastcgi peuvent être appelées sur plusieurs machines distantes afin de répartir les applications. </para> + <example> <title>Connexion à des instances distantes de php-fastcgi</title> <screen> http://cvs.php.net/viewvc.cgi/phpdoc-fr/install/unix/sun.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/install/unix/sun.xml diff -u phpdoc-fr/install/unix/sun.xml:1.16 phpdoc-fr/install/unix/sun.xml:1.17 --- phpdoc-fr/install/unix/sun.xml:1.16 Sun Jun 8 15:10:24 2008 +++ phpdoc-fr/install/unix/sun.xml Mon Dec 1 16:24:37 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <sect1 xml:id="install.unix.sun" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Installation sous Netscape et iPlanet Enterprise Serveur sur un système Sun Solaris</title> @@ -249,7 +249,7 @@ accéder à des variables comme <literal>PATH_INFO</literal>, <literal>HTTP_HOST</literal> etc., il n'est pas recommandé d'y accéder à l'ancienne manière de PHP, avec la fonction <function>getenv</function> ou une - autre méthode (register globals, <literal>$_ENV</literal>). + autre méthode (register globals, <varname>$_ENV</varname>). De cette manière, vous n'aurez que des valeurs d'environnement du serveur, et non pas des valeurs correctes pour le CGI. </para> @@ -269,8 +269,8 @@ </note> <para> Changez simplement vos scripts pour lire les variables CGI, en utilisant - le tableau superglobal <literal>$_SERVER</literal>. Si vous avez d'autres scripts qui - utilisent encore <literal>$HTTP_HOST</literal> et compagnie, + le tableau superglobal <varname>$_SERVER</varname>. Si vous avez d'autres scripts qui + utilisent encore <varname>$HTTP_HOST</varname> et compagnie, il est recommandé d'activer l'option <literal>register_globals</literal> dans le &php.ini; et de changer l'ordre des variables. IMPORTANT : supprimez le <literal>&quot;E&quot;</literal> dans cette option, car @@ -302,7 +302,7 @@ Si vous voulez utiliser une page pour toutes les erreurs qui existent, laissez le paramètre <literal>code</literal> vide. Votre script peut obtenir le code de statut HTTP dans la variable - <literal>$_SERVER['ERROR_TYPE']</literal>. + <varname>$_SERVER['ERROR_TYPE']</varname>. </para> <para> Une autre possibilité est de générer une liste de dossiers personnalisée. @@ -316,8 +316,8 @@ ]]> </programlisting> Pour ces deux points, l'URI originale et l'URI traduite sont - dans les variables <literal>$_SERVER['PATH_INFO']</literal> et - <literal>$_SERVER['PATH_TRANSLATED']</literal>. + dans les variables <varname>$_SERVER['PATH_INFO']</varname> et + <varname>$_SERVER['PATH_TRANSLATED']</varname>. </para> </sect2> http://cvs.php.net/viewvc.cgi/phpdoc-fr/install/windows/index.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/install/windows/index.xml diff -u phpdoc-fr/install/windows/index.xml:1.13 phpdoc-fr/install/windows/index.xml:1.14 --- phpdoc-fr/install/windows/index.xml:1.13 Sun Jun 8 15:10:25 2008 +++ phpdoc-fr/install/windows/index.xml Mon Dec 1 16:24:37 2008 @@ -1,42 +1,52 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.21 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> -<chapter xml:id="install.windows" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Installation sur les système Windows</title> - <para> - Cette section est applicable à Windows 98/ME et Windows NT/2000/XP/2003. - PHP devrait fonctionner sur les plates-formes 16 bits comme Windows 3.1 et - parfois, on décrira les plates-formes supportées sous le nom de Win32. - Windows 95 n'est plus supporté à partir de la version 4.3.0 de PHP. - </para> - <para> - Il y a deux méthodes principales pour installer PHP sous Windows : - soit <link linkend="install.windows.manual">manuellement</link>, - soit avec <link linkend="install.windows.installer">l'installeur</link>. - </para> - <para> - Si vous avez Microsoft Visual Studio, vous pouvez aussi - <link linkend="install.windows.building">compiler</link> - PHP à partir des sources. - </para> - <para> - Une fois que PHP est installé sur votre Windows, vous pouvez aussi - ajouter diverses - <link linkend="install.windows.extensions">extensions</link>. - </para> - <warning> - <para> - Il y a beaucoup d'installeurs "tout en un" sur Internet, - mais aucun n'est approuvé par Php.net, car nous pensons que l'utilisation - d'un des paquets officiels pour Windows depuis - <link xlink:href="&url.php.downloads;">&url.php.downloads;</link> - reste le meilleur choix et vous assurera d'avoir un système sécurisé et - optimisé. - </para> - </warning> - + <chapter xml:id="install.windows" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Installation sur les système Windows</title> + <para> + Cette section est applicable à Windows 98/ME et Windows NT/2000/XP/2003. + PHP devrait fonctionner sur les plates-formes 16 bits comme Windows 3.1 et + parfois, on décrira les plates-formes supportées sous le nom de Win32. + Windows 95 n'est plus supporté à partir de la version 4.3.0 de PHP. + </para> + <note> + <para> + Windows 98/ME/NT4 n'est plus supporté depuis PHP 5.3.0. + </para> + </note> + <note> + <para> + Windows 95 n'est plus supporté depuis PHP 4.3.0. + </para> + </note> + <para> + Il y a deux méthodes principales pour installer PHP sous Windows : + soit <link linkend="install.windows.manual">manuellement</link>, + soit avec <link linkend="install.windows.installer">l'installeur</link>. + </para> + <para> + Si vous avez Microsoft Visual Studio, vous pouvez aussi + <link linkend="install.windows.building">compiler</link> + PHP à partir des sources. + </para> + <para> + Une fois que PHP est installé sur votre Windows, vous pouvez aussi + ajouter diverses + <link linkend="install.windows.extensions">extensions</link>. + </para> + <warning> + <para> + Il y a beaucoup d'installeurs "tout en un" sur Internet, + mais aucun n'est approuvé par Php.net, car nous pensons que l'utilisation + d'un des paquets officiels pour Windows depuis + <link xlink:href="&url.php.downloads;">&url.php.downloads;</link> + reste le meilleur choix et vous assurera d'avoir un système sécurisé et + optimisé. + </para> + </warning> + &install.windows.installermsi; &install.windows.installer; &install.windows.manual; @@ -50,8 +60,7 @@ &install.windows.xitami; &install.windows.building; &install.windows.extensions; - -</chapter> + </chapter> <!-- Keep this comment at the end of the file Local variables: @@ -72,4 +81,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> \ No newline at end of file +--> http://cvs.php.net/viewvc.cgi/phpdoc-fr/install/windows/manual.xml?r1=1.22&r2=1.23&diff_format=u Index: phpdoc-fr/install/windows/manual.xml diff -u phpdoc-fr/install/windows/manual.xml:1.22 phpdoc-fr/install/windows/manual.xml:1.23 --- phpdoc-fr/install/windows/manual.xml:1.22 Sun Jun 8 15:10:25 2008 +++ phpdoc-fr/install/windows/manual.xml Mon Dec 1 16:24:37 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.22 $ --> -<!-- EN-Revision: 1.22 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.23 $ --> +<!-- EN-Revision: 1.23 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <sect1 xml:id="install.windows.manual" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -97,7 +97,7 @@ | | | |-php_cpdf.dll | | - | |-.. + | |-... | +--mibs -- fichiers de support de SNMP | @@ -111,18 +111,18 @@ | | | |-php4apache2.dll | | - | |-.. + | |-... | +--PEAR -- copie initiale de PEAR | | |-go-pear.bat -- script de configuration de PEAR | - |-.. + |-... | |-php.exe -- exécutable CGI | - |-.. + |-... | |-php.ini-dist -- paramètres par défaut du php.ini | @@ -155,7 +155,7 @@ | | | |-php_cpdf.dll | | - | |-.. + | |-... | +--extras | | @@ -174,7 +174,7 @@ | |-fdftk.dll | - |-.. + |-... | |-php-cgi.exe -- exécutable CGI | @@ -182,7 +182,7 @@ | |-php.exe -- exécutable CLI - UNIQUEMENT pour du script en ligne de commande | - |-.. + |-... | |-php.ini-dist -- paramètres par défaut du php.ini | @@ -194,10 +194,10 @@ | |-php5apache2.dll | - |-.. + |-... | |-php5ts.dll -- DLL principale - | + | |-... ]]> @@ -423,4 +423,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> \ No newline at end of file +--> http://cvs.php.net/viewvc.cgi/phpdoc-fr/install/windows/sun.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/install/windows/sun.xml diff -u phpdoc-fr/install/windows/sun.xml:1.13 phpdoc-fr/install/windows/sun.xml:1.14 --- phpdoc-fr/install/windows/sun.xml:1.13 Sun Jun 8 15:10:25 2008 +++ phpdoc-fr/install/windows/sun.xml Mon Dec 1 16:24:37 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <sect1 xml:id="install.windows.sun" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -217,8 +217,8 @@ </note> <para> Changez simplement vos scripts pour lire les variables CGI, en utilisant - le tableau superglobal <literal>$_SERVER</literal>. Si vous avez d'autres scripts qui - utilisent encore <literal>$HTTP_HOST</literal> et compagnie, + le tableau superglobal <varname>$_SERVER</varname>. Si vous avez d'autres scripts qui + utilisent encore <varname>$HTTP_HOST</varname> et compagnie, il est recommandé d'activer l'option <literal>register_globals</literal> dans le &php.ini; et de changer l'ordre des variables. IMPORTANT : supprimez le <literal>&quot;E&quot;</literal> dans cette option, car @@ -250,7 +250,7 @@ Si vous voulez utiliser une page pour toutes les erreurs qui existent, laissez le paramètre <literal>code</literal> vide. Votre script peut obtenir le code de statut HTTP dans la variable - <literal>$_SERVER['ERROR_TYPE']</literal>. + <varname>$_SERVER['ERROR_TYPE']</varname>. </para> <para> Une autre possibilité est de générer une liste de dossiers personnalisée. @@ -264,11 +264,11 @@ ]]> </programlisting> Pour ces deux points, l'URI originale et l'URI traduite sont - dans les variables <literal>$_SERVER['PATH_INFO']</literal> et - <literal>$_SERVER['PATH_TRANSLATED']</literal>. + dans les variables <varname>$_SERVER['PATH_INFO']</varname> et + <varname>$_SERVER['PATH_TRANSLATED']</varname>. </para> </sect2> - + <sect2 xml:id="install.windows.sun.notes"> <title>Note au sujet de <function>nsapi_virtual</function> et des requêtes (PHP &gt;= 4.3.3)</title> <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/constants.xml?r1=1.52&r2=1.53&diff_format=u Index: phpdoc-fr/language/constants.xml diff -u phpdoc-fr/language/constants.xml:1.52 phpdoc-fr/language/constants.xml:1.53 --- phpdoc-fr/language/constants.xml:1.52 Wed Jun 18 16:16:59 2008 +++ phpdoc-fr/language/constants.xml Mon Dec 1 16:24:37 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.52 $ --> -<!-- EN-Revision: 1.52 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.53 $ --> +<!-- EN-Revision: 1.53 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <chapter xml:id="language.constants" xmlns="http://docbook.org/ns/docbook"> @@ -68,7 +68,9 @@ <title>Syntaxe</title> <simpara> Vous pouvez définir une constante en utilisant la fonction - <function>define</function>. Une fois qu'une constante est définie, + <function>define</function> ou en utilisant le mot-clé + <literal>const</literal> en dehors d'une définition de classe à partir + de PHP 5.3.0. Une fois qu'une constante est définie, elle ne peut jamais être modifiée, ou détruite. </simpara> <simpara> @@ -109,31 +111,38 @@ </simpara> <para> Il y a des différences entre les constantes et les variables : - <itemizedlist> - <listitem> - <simpara> - Les constantes ne commencent pas par le signe (<literal>$</literal>); + <itemizedlist> + <listitem> + <simpara> + Les constantes ne commencent pas par le signe (<literal>$</literal>). + </simpara> + </listitem> + <listitem> + <simpara> + Les constantes ne peuvent être définies qu'en utilisant la fonction + <function>define</function>, pas par simple assignement. + </simpara> + </listitem> + <listitem> + <simpara> + 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. + </simpara> + </listitem> + <listitem> + <simpara> + Les constantes ne peuvent contenir que des scalaires. </simpara> - </listitem> - <listitem> - <simpara> - 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. - </simpara> - </listitem> - <listitem> - <simpara> - Les constantes ne peuvent contenir que des scalaires. - </simpara> - </listitem> - </itemizedlist> - </para> + </listitem> + </itemizedlist> + </para> + <para> <example> <title>Définir une constante</title> @@ -148,12 +157,29 @@ </programlisting> </example> </para> + + <para> + <example> + <title>Definir des constantes en utilisant le mot-clé <literal>const</literal></title> + <programlisting role="php"> +<![CDATA[ +<?php +// Fonctionne depuis PHP 5.3.0. +const CONSTANT = 'Hello World'; + +echo CONSTANT; +?> +]]> + </programlisting> + </example> + </para> + <simpara> Voir aussi les <link linkend="language.oop5.constants">constantes de classe</link>. </simpara> </sect1> - + <sect1 xml:id="language.constants.predefined"> <title>Constantes magiques</title> <simpara> @@ -171,7 +197,6 @@ de la ligne où vous l'utilisez dans votre script. Ces constantes spéciales sont insensibles à la casse. </para> - <para> <table> <title>Quelques constantes PHP magiques</title> @@ -254,20 +279,24 @@ </para> </sect1> </chapter> - <!-- Keep this comment at the end of the file - Local variables: - mode: sgml - sgml-omittag:t - sgml-shorttag:t - sgml-minimize-attributes:nil - sgml-always-quote-attributes:t - sgml-indent-step:1 - sgml-indent-data:t + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t indent-tabs-mode:nil - sgml-parent-document:nil - sgml-default-dtd-file:"../../manual.ced" - sgml-exposed-tags:nil - sgml-local-catalogs:nil - sgml-local-ecat-files:nil - End: - --> +sgml-parent-document:nil +sgml-default-dtd-file:"../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/control-structures.xml?r1=1.100&r2=1.101&diff_format=u Index: phpdoc-fr/language/control-structures.xml diff -u phpdoc-fr/language/control-structures.xml:1.100 phpdoc-fr/language/control-structures.xml:1.101 --- phpdoc-fr/language/control-structures.xml:1.100 Wed Jun 18 16:16:59 2008 +++ phpdoc-fr/language/control-structures.xml Mon Dec 1 16:24:37 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.100 $ --> -<!-- EN-Revision: 1.161 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.101 $ --> +<!-- EN-Revision: 1.173 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <chapter xml:id="language.control-structures" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -8,18 +8,17 @@ <sect1 xml:id="control-structures.intro"> <title>Introduction</title> - - <simpara> - Tous les scripts PHP sont une suite d'instructions. Une instruction - peut être une assignation, un appel de fonction, une instruction - conditionnelle ou bien une instruction qui ne fait rien (une instruction - vide). Une instruction se termine habituellement par un point virgule - ("<literal>;</literal>"). De plus, plusieurs instructions peuvent être - regroupées en bloc, délimité par des - accolades ("<literal>{}</literal>"). Un bloc est considéré - comme une instruction. Les différents types d'instructions sont - décrits dans ce chapitre. - </simpara> + <simpara> + Tous les scripts PHP sont une suite d'instructions. Une instruction + peut être une assignation, un appel de fonction, une instruction + conditionnelle ou bien une instruction qui ne fait rien (une instruction + vide). Une instruction se termine habituellement par un point virgule + ("<literal>;</literal>"). De plus, plusieurs instructions peuvent être + regroupées en bloc, délimité par des + accolades ("<literal>{}</literal>"). Un bloc est considéré + comme une instruction. Les différents types d'instructions sont + décrits dans ce chapitre. + </simpara> </sect1> <sect1 xml:id="control-structures.if"> @@ -30,15 +29,14 @@ l'exécution conditionnelle d'une partie de code. Les fonctionnalités de l'instruction <literal>if</literal> sont les mêmes en PHP qu'en C : - <example> - <title>Instruction if () </title> + <informalexample> <programlisting> - <![CDATA[ +<![CDATA[ if (expression) commandes ]]> </programlisting> - </example> + </informalexample> </para> <simpara> Comme nous l'avons vu dans le paragraphe consacré aux @@ -54,17 +52,16 @@ L'exemple suivant affiche la phrase <computeroutput>a est plus grand que b</computeroutput> si <varname>$a</varname> est plus grand que <varname>$b</varname> : - <example> - <title>Instruction if () (2)</title> + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php if ($a > $b) print "a est plus grand que b"; ?> ]]> </programlisting> - </example> + </informalexample> </para> <para> Souvent, vous voulez que plusieurs instructions soient @@ -76,19 +73,18 @@ est plus grand que b</computeroutput>, et assigne la valeur de la variable <varname>$a</varname> à la variable <varname>$b</varname> : - <example> - <title>Instruction if () et bloc</title> + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php if ($a > $b) { - echo "a est plus grand que b"; - $b = $a; + echo "a est plus grand que b"; + $b = $a; } ?> ]]> </programlisting> - </example> + </informalexample> </para> <simpara> Vous pouvez imbriquer indéfiniment des instructions @@ -112,10 +108,9 @@ variable <varname>$a</varname> est plus grande que la variable <varname>$a</varname>, et <computeroutput>a est plus petit que b</computeroutput> sinon : - <example> - <title>Instruction <literal>if () else</literal></title> + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php if ($a > $b) { echo "a est plus grand que b"; @@ -125,7 +120,7 @@ ?> ]]> </programlisting> - </example> + </informalexample> Les instructions après le <literal>else</literal> ne sont exécutées que si l'expression du <literal>if</literal> @@ -137,7 +132,7 @@ </sect1> <sect1 xml:id="control-structures.elseif"> - <title><literal>elseif</literal></title> + <title><literal>elseif</literal>/<literal>else if</literal></title> <para> <literal>elseif</literal>, comme son nom l'indique, est une combinaison de <literal>if</literal> et de <literal>else</literal>. Comme l'expression @@ -151,10 +146,9 @@ <computeroutput>a est plus grand que b</computeroutput>, <computeroutput>a est égal à b</computeroutput> ou <computeroutput>a est plus petit que b</computeroutput> : - <example> - <title>Instruction <literal>elseif</literal></title> + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php if ($a > $b) { echo "a est plus grand que b"; @@ -166,7 +160,7 @@ ?> ]]> </programlisting> - </example> + </informalexample> </para> <simpara> Vous pouvez avoir plusieurs <literal>elseif</literal> qui se suivent @@ -187,6 +181,44 @@ votre <literal>elseif</literal> est évalué à &true;. </simpara> + <note> + <simpara> + A noter que <literal>elseif</literal> et <literal>else if</literal> + sont traités de la même façon seulement quand des accolades sont utilisées, + comme dans l'exemple ci-dessus. Quand vous utilisez ":" pour définir votre condition + <literal>if</literal>/<literal>elseif</literal>, vous ne devez + pas séparer <literal>else if</literal> en deux mots, sans quoi PHP soulèvera + une erreur d'interprétation. + </simpara> + </note> + <para> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + +/* Mauvaise méthode : */ +if($a > $b): + echo $a." est plus grand que ".$b; +else if($a == $b): // ne compilera pas + echo "La ligne ci-dessus provoque une erreur d'interprétation"; +endif; + + +/* Bonne méthode : */ +if($a > $b): + echo $a." est plus grand que ".$b; +elseif($a == $b): // Les deux mots sont collés + echo $a." égal ".$b; +else: + echo $a." est plus grand ou égal à ".$b; +endif; + +?> +]]> + </programlisting> + </informalexample> + </para> </sect1> <sect1 xml:id="control-structures.alternative-syntax"> @@ -202,16 +234,15 @@ et l'accolade de fermeture par, respectivement, <literal>endif;</literal>, <literal>endwhile;</literal>, <literal>endfor;</literal> ou <literal>endswitch;</literal>. - <example> - <title>Instruction alternative <literal>if()</literal></title> + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php if ($a == 5): ?> A égal 5 <?php endif; ?> ]]> </programlisting> - </example> + </informalexample> </para> <simpara> Dans l'exemple ci-dessus, le bloc HTML "A égal 5" est inclus @@ -224,19 +255,15 @@ <literal>elseif</literal>. L'exemple suivant montre une structure avec un <literal>if</literal>, un <literal>elsif</literal> et un <literal>else</literal> utilisant cette autre syntaxe : - <example> - <title> - Instruction alternative <literal>if() elseif()</literal> et - <literal>else</literal> - </title> + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php if ($a == 5): - echo "a égale 5"; + echo "a égal 5"; echo "..."; elseif ($a == 6): - echo "a égale 6"; + echo "a égal 6"; echo "!!!"; else: echo "a ne vaut ni 5 ni 6"; @@ -244,7 +271,7 @@ ?> ]]> </programlisting> - </example> + </informalexample> </para> <para> Voir aussi @@ -262,15 +289,14 @@ se comporte de la même manière qu'en C. L'exemple le plus simple d'une boucle <literal>while</literal> est le suivant : - <example> - <title>Instruction <literal>while</literal></title> + <informalexample> <programlisting> - <![CDATA[ +<![CDATA[ while (expression) commandes ]]> </programlisting> - </example> + </informalexample> </para> <simpara> La signification d'une boucle <literal>while</literal> est @@ -292,25 +318,23 @@ plusieurs instructions dans la même boucle <literal>while</literal> en les regroupant à l'intérieur de parenthèses ou en utilisant la syntaxe suivante : - <example> - <title>Instruction <literal>while</literal> avec bloc</title> + <informalexample> <programlisting> - <![CDATA[ +<![CDATA[ while (expression): - commandes - ... + commandes + ... endwhile; ]]> </programlisting> - </example> + </informalexample> </para> <para> Les exemples suivants sont identiques et affichent tous les nombres de 1 jusqu'à 10 : - <example> - <title>Exemple avec <literal>while</literal></title> + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php /* exemple 1 */ @@ -330,7 +354,7 @@ ?> ]]> </programlisting> - </example> + </informalexample> </para> </sect1> @@ -352,10 +376,9 @@ <para> Il n'y a qu'une syntaxe possible pour les boucles <literal>do-while</literal> : - <example> - <title>Instruction <literal>do-while</literal></title> + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php $i = 0; do { @@ -364,14 +387,14 @@ ?> ]]> </programlisting> - </example> + </informalexample> </para> <simpara> - La boucle ci-dessus ne va être exécutée - qu'une seule fois, car lorsque l'expression est - évaluée, elle vaut &false; (car - la variable <varname>$i</varname> n'est pas plus grande que 0) et l'exécution - de la boucle s'arrête. + La boucle ci-dessus ne va être exécutée + qu'une seule fois, car lorsque l'expression est + évaluée, elle vaut &false; (car + la variable <varname>$i</varname> n'est pas plus grande que 0) et l'exécution + de la boucle s'arrête. </simpara> <para> Les utilisateurs familiers du C sont habitués à @@ -381,10 +404,9 @@ l'encapsulant dans un <literal>do-while</literal>(0) la fonction <link linkend="control-structures.break"><literal>break</literal></link>. Le code suivant montre une utilisation possible : - <example> - <title>Instruction <literal>while</literal> et <literal>break</literal></title> + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php do { if ($i < 5) { @@ -403,7 +425,7 @@ ?> ]]> </programlisting> - </example> + </informalexample> </para> <simpara> Ne vous inquiétez pas si vous ne comprenez @@ -419,15 +441,14 @@ Les boucles <literal>for</literal> sont les boucles les plus complexes en PHP. Elles fonctionnent comme les boucles <literal>for</literal> du langage C. La syntaxe des boucles <literal>for</literal> est la suivante : - <example> - <title>Instruction <literal>for</literal> </title> + <informalexample> <programlisting> - <![CDATA[ +<![CDATA[ for (expr1; expr2; expr3) commandes ]]> </programlisting> - </example> + </informalexample> </para> <simpara> La première expression (<varname>expr1</varname>) est @@ -462,8 +483,7 @@ <para> Considérons les exemples suivants. Tous affichent les chiffres de 1 jusqu'à 10 : - <example> - <title>Exemple de boucles</title> + <informalexample> <programlisting role="php"> <![CDATA[ <?php @@ -499,7 +519,7 @@ ?> ]]> </programlisting> - </example> + </informalexample> </para> <simpara> Bien évidemment, le premier exemple est le plus simple @@ -510,17 +530,69 @@ <para> PHP supporte aussi la syntaxe alternative suivante pour les boucles <literal>for</literal> : - <example> - <title>Instruction <literal>for</literal> alternative</title> + <informalexample> <programlisting> <![CDATA[ for (expr1; expr2; expr3): - commandes; - ...; + commandes + ... endfor; ]]> </programlisting> - </example> + </informalexample> + </para> + <simpara> + Beaucoup de personnes ont l'habitude d'itérer grâce à des tableaux, comme dans + l'exemple ci dessous. + </simpara> + <para> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +/* + * Ceci est un tableau avec des données que nous voulons modifier + * au long de la boucle + */ +$people = Array( + Array('name' => 'Kalle', 'salt' => 856412), + Array('name' => 'Pierre', 'salt' => 215863) + ); + +for($i = 0; $i < sizeof($people); ++$i) +{ + $people[$i]['salt'] = rand(000000, 999999); +} +?> +]]> + </programlisting> + </informalexample> + </para> + <simpara> + Le problème se situe dans le deuxième argument de l'expression for. Ce code peut être lent + parce qu'il doit caclculer la taille du tableau à chaque itération. + Etant donné que la taille ne change jamais, il peut facilement être optimisé en utilisant + une variable intermédiaire pour stocker la taille et en l'utilisant dans la boucle à la place + de sizeof. L'exemple ci-dessous illustre ce cas : + </simpara> + <para> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +$people = Array( + Array('name' => 'Kalle', 'salt' => 856412), + Array('name' => 'Pierre', 'salt' => 215863) + ); + +for($i = 0, $size = sizeof($people); $i < $size; ++$i) +{ + $people[$i]['salt'] = rand(000000, 999999); +} +?> +]]> + </programlisting> + </informalexample> </para> </sect1> @@ -529,19 +601,20 @@ <para> PHP 4 introduit une commande <literal>foreach</literal>, comme en Perl ou d'autres langages. C'est un moyen simple de passer - en revue un tableau. Il y a deux syntaxes possibles : la seconde est + en revue un tableau. <literal>foreach</literal> fonctionne uniquement sur les tableaux, et + retournera une erreur si vous tentez de l'utiliser sur une variable d'un autre type ou non initialisée. + Il y a deux syntaxes possibles : la seconde est une extension mineure mais pratique de la première. - <example> - <title>Instruction <literal>foreach</literal></title> + <informalexample> <programlisting> - <![CDATA[ -foreach(array_expression as $value) - commandes -foreach(array_expression as $key => $value) - commandes +<![CDATA[ +foreach (array_expression as $value) + commandes +foreach (array_expression as $key => $value) + commandes ]]> </programlisting> - </example> + </informalexample> </para> <simpara> La première forme passe en revue le tableau @@ -598,10 +671,10 @@ unset($value); // Stop la référence sur le dernier élément ?> ]]> - </programlisting> - </informalexample> - Ceci n'est possible que si le tableau itéré peut être référencé (i.e. est une variable). - </para> + </programlisting> + </informalexample> + Ceci n'est possible que si le tableau itéré peut être référencé (i.e. est une variable). + </para> <warning> <para> La référence de <literal>$value</literal> et le dernier élément du tableau @@ -620,8 +693,7 @@ <para> Vous pouvez remarquer que les exemples suivants fonctionnent de manière identique : - <example> - <title>Instruction <literal>foreach</literal> et <literal>while</literal></title> + <informalexample> <programlisting role="php"> <![CDATA[ <?php @@ -636,13 +708,12 @@ } ?> ]]> - </programlisting> - </example> - Les exemples suivants sont aussi fonctionnellement identiques : - <example> - <title>Instruction <literal>foreach</literal>et <literal>while</literal>(2)</title> - <programlisting role="php"> - <![CDATA[ + </programlisting> + </informalexample> + Les exemples suivants sont aussi fonctionnellement identiques : + <informalexample> + <programlisting role="php"> +<![CDATA[ <?php $arr = array("un", "deux", "trois"); reset($arr); @@ -655,14 +726,13 @@ } ?> ]]> - </programlisting> - </example> - </para> - <para> - Voici quelques exemples de plus : - <example> - <title>Instruction <literal>foreach</literal> et <literal>while</literal>(3)</title> - <programlisting role="php"> + </programlisting> + </informalexample> + </para> + <para> + Voici quelques exemples de plus : + <informalexample> + <programlisting role="php"> <![CDATA[ <?php /* exemple foreach 1 : la valeur seulement */ @@ -686,7 +756,7 @@ /* exemple foreach 3 : la clé et la valeur */ -$a = array ( +$a = array( "un" => 1, "deux" => 2, "trois" => 3, @@ -698,7 +768,6 @@ } /* exemple foreach 4 : tableaux multi-dimensionnels */ - $a = array(); $a[0][0] = "a"; $a[0][1] = "b"; @@ -716,13 +785,12 @@ foreach (array(1, 2, 3, 4, 5) as $v) { echo "$v\n"; } - ?> ]]> - </programlisting> - </example> - </para> - </sect1> + </programlisting> + </informalexample> + </para> + </sect1> <sect1 xml:id="control-structures.break"> <title><literal>break</literal></title> @@ -738,8 +806,7 @@ été interrompues. </simpara> <para> - <example> - <title>Instruction break </title> + <informalexample> <programlisting role="php"> <![CDATA[ <?php @@ -769,7 +836,7 @@ ?> ]]> </programlisting> - </example> + </informalexample> </para> </sect1> @@ -794,8 +861,7 @@ emboîtées ont été ignorées. </simpara> <para> - <example> - <title>Instruction continue</title> + <informalexample> <programlisting role="php"> <![CDATA[ <?php @@ -822,19 +888,18 @@ ?> ]]> </programlisting> - </example> + </informalexample> </para> <para> Oublier le point virgule après <literal>continue</literal> peut porter à confusion. Voici un exemple de ce que vous ne devez pas faire : </para> <para> - <example> - <title>N'oubliez pas le point-virgule après continue</title> + <informalexample> <programlisting role="php"> <![CDATA[ <?php -for ($i = 0; $i < 5; ++$i) { + for ($i = 0; $i < 5; ++$i) { if ($i == 2) continue print "$i\n"; @@ -866,7 +931,7 @@ est <literal>int(1)</literal>, et cela se comportera alors comme si on avait fournit l'argument optionnel mentionné plus haut. </para> - </example> + </informalexample> </para> </sect1> @@ -910,22 +975,22 @@ <![CDATA[ <?php if ($i == 0) { - echo "i égale 0"; + echo "i égal 0"; } elseif ($i == 1) { - echo "i égale 1"; + echo "i égal 1"; } elseif ($i == 2) { - echo "i égale 2"; + echo "i égal 2"; } switch ($i) { case 0: - echo "i égale 0"; + echo "i égal 0"; break; case 1: - echo "i égale 1"; + echo "i égal 1"; break; case 2: - echo "i égale 2"; + echo "i égal 2"; break; } ?> @@ -968,23 +1033,22 @@ <literal>break</literal> à la fin de l'instruction <literal>case</literal>, PHP continuera à exécuter toutes les instructions qui suivent. Par exemple : - <example> - <title>Instruction <literal>switch</literal> et <literal>fall through</literal></title> + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php switch ($i) { -case 0 : - echo "i égale 0"; -case 1 : - echo "i égale 1"; -case 2 : - echo "i égale 2"; +case 0: + echo "i égal 0"; +case 1: + echo "i égal 1"; +case 2: + echo "i égal 2"; } ?> ]]> </programlisting> - </example> + </informalexample> </para> <simpara> Dans cet exemple, si <varname>$i</varname> est égal à 0, PHP va @@ -1011,10 +1075,9 @@ La liste de commandes d'un <literal>case</literal> peut être vide, auquel cas PHP utilisera la liste de commandes du cas suivant. - <example> - <title>Instruction <literal>switch</literal> et cas vide</title> + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php switch ($i) { case 0: @@ -1022,31 +1085,30 @@ case 2: echo "i est plus petit que 3 mais n'est pas négatif"; break; -case 3 : - echo "i égale 3"; +case 3: + echo "i égal 3"; } ?> ]]> </programlisting> - </example> + </informalexample> </para> <para> Un cas spécial est <literal>default</literal>. Ce cas est utilisé lorsque tous les autres cas ont échoués. Par exemple : - <example> - <title>Instruction <literal>switch</literal> et <literal>default</literal></title> + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php switch ($i) { case 0: - echo "i égale 0"; + echo "i égal 0"; break; case 1: - echo "i égale 1"; + echo "i égal 1"; break; case 2: - echo "i égale 2"; + echo "i égal 2"; break; default: echo "i n'est ni égal à 2, ni à 1, ni à 0."; @@ -1054,7 +1116,7 @@ ?> ]]> </programlisting> - </example> + </informalexample> </para> <para> Une autre chose à mentionner est que la valeur du @@ -1067,20 +1129,19 @@ La syntaxe alternative pour cette structure de contrôle est la suivante : (pour plus d'informations, voir <link linkend="control-structures.alternative-syntax">syntaxes alternatives</link>). - <example> - <title>Instruction <literal>switch</literal> alternative</title> + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php switch ($i): case 0: - echo "i égale 0"; + echo "i égal 0"; break; case 1: - echo "i égale 1"; + echo "i égal 1"; break; case 2: - echo "i égale 2"; + echo "i égal 2"; break; default: echo "i n'est ni égal à 2, ni à 1, ni à 0"; @@ -1088,7 +1149,29 @@ ?> ]]> </programlisting> - </example> + </informalexample> + </para> + <para> + Il est possible d'utiliser un point-virgule plutôt que deux points après un case, comme ceci : + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +switch($biere) +{ + case 'leffe'; + case 'grimbergen'; + case 'guinness'; + echo 'Bon choix'; + break; + default; + echo 'Merci de faire un choix...'; + break; +} +?> +]]> + </programlisting> + </informalexample> </para> </sect1> @@ -1099,22 +1182,32 @@ directives d'exécutions dans un bloc de code. La syntaxe de <literal>declare</literal> est similaire à la syntaxe des autres fonctions de contrôle : - <example> - <title>Instruction <literal>directive</literal></title> + <informalexample> <programlisting> - <![CDATA[ +<![CDATA[ declare (directive) - commandes + commandes ]]> </programlisting> - </example> + </informalexample> </para> <para> - L'expression <literal>directive</literal> permet de contrôler l'intervention - du bloc <literal>declare</literal>. Actuellement, une seule directive - est reconnue : la directive <literal>ticks</literal> (Voir plus bas pour plus - de détails) sur les <link linkend="control-structures.declare.ticks">ticks</link>). + L'expression <literal>directive</literal> permet de contrôler + l'intervention du bloc <literal>declare</literal>. + Actuellement, seulement deux directives sont reconnues : la directive + <literal>ticks</literal> (Voir plus bas pour plus + de détails sur les + <link linkend="control-structures.declare.ticks">ticks</link> + ) et la directive d'encodage <literal>encoding</literal> (Voir plus bas pour plus + de détails sur la directive + <link linkend="control-structures.declare.encoding">encoding</link> + ). </para> + <note> + <simpara> + La directive <literal>encoding</literal> a été ajoutée en PHP 5.3.0. + </simpara> + </note> <para> L'expression <literal>commandes</literal> du bloc de <literal>declare</literal> sera exécutée. Comment elle sera exécutée, @@ -1123,9 +1216,10 @@ </para> <para> La structure <literal>declare</literal> peut aussi être utilisée - dans le contexte global. Elle affecte alors tout le code qui la suit : - <example> - <title>Instruction <literal>directive</literal> en contexte global</title> + dans le contexte global. Elle affecte alors tout le code qui la suit (même si le fichier avec + <literal>declare</literal> a été inclus après, ça n'affecte pas le fichier + parent). + <informalexample> <programlisting role="php"> <![CDATA[ <?php @@ -1142,40 +1236,49 @@ ?> ]]> </programlisting> - </example> + </informalexample> </para> <sect2 xml:id="control-structures.declare.ticks"> <title>Ticks</title> - <para> - Un tick est un événement qui intervient toutes les - <varname>N</varname> commandes bas niveau, exécutées par l'analyseur - dans le bloc de <literal>declare</literal>. - La valeur de <varname>N</varname> est spécifiée avec la syntaxe - <literal>ticks=N</literal> - dans le bloc de directive <literal>declare</literal>. - </para> - <para> - Un événement qui intervient à chaque tick est spécifié avec la fonction - <function>register_tick_function</function>. Reportez-vous à l'exemple - ci-dessous pour plus de détails. Notez que plus d'un événement peut - intervenir par tick. - </para> - <para> - <example> - <title>Profiler une section de code PHP</title> - <programlisting role="php"> + <caution> + <simpara> + A partir de PHP 5.3.0, les ticks sont dépréciés et seront supprimés + en PHP 6.0.0. + </simpara> + </caution> + <para>Un tick est un événement qui intervient toutes les + <varname>N</varname> commandes bas niveau, exécutées par l'analyseur + dans le bloc de <literal>declare</literal>. + La valeur de <varname>N</varname> est spécifiée avec la syntaxe + <code>ticks=<varname>N</varname></code> + dans le bloc de directive + <literal>declare</literal>. + </para> + <para> + Un événement qui intervient à chaque tick est spécifié avec la fonction + <function>register_tick_function</function>. Reportez-vous à l'exemple + ci-dessous pour plus de détails. Notez que plus d'un événement peut + intervenir par tick. + </para> + <para> + <example> + <title>Profiler une section de code PHP</title> + <programlisting role="php"> <![CDATA[ <?php -// Un fonction qui enregistre l'heure à laquelle elle est appelée -function profile($dump = FALSE){ +// Une fonction qui enregistre l'heure à laquelle elle est appelée +function profile($dump = FALSE) +{ static $profile; + // Retourne les horaires stockés dans le profile, et l'efface if ($dump) { $temp = $profile; unset($profile); return $temp; } - $profile[] = microtime (); + + $profile[] = microtime(); } // Enregistre un gestionnaire de tick @@ -1185,9 +1288,9 @@ profile(); // Exécute un bloc de code, et appele un tick toutes les deux secondes -declare (ticks=2) { +declare(ticks=2) { for ($x = 1; $x < 50; ++$x) { - echo similar_text(md5($x), md5($x*$x)), "<br />"; + echo similar_text(md5($x), md5($x*$x)), "<br />;"; } } @@ -1195,13 +1298,13 @@ print_r(profile(TRUE)); ?> ]]> - </programlisting> - </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 - de code lents. Vous pouvez implémenter d'autres méthodes, mais - les ticks sont plus rapides et plus efficaces. + </programlisting> + </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 + de code lents. Vous pouvez implémenter d'autres méthodes, mais + les ticks sont plus rapides et plus efficaces. </para> <simpara> Les ticks sont bien pratiques pour déboguer, pour implémenter un @@ -1209,15 +1312,46 @@ fond, ou bien d'autres choses, avec PHP. </simpara> <simpara> - Voir aussi - <function>register_tick_function</function> et + Voir aussi <function>register_tick_function</function> et <function>unregister_tick_function</function>. </simpara> </sect2> + <sect2 xml:id="control-structures.declare.encoding"> + <title>L'encodage: encoding</title> + <para> + L'encodage d'un script peut être spécifié par script en utilisant la directive <literal>encoding</literal>. + <example> + <title>Déclaration d'un encodage pour un script</title> + <programlisting role="php"> +<![CDATA[ +<?php +declare(encoding='ISO-8859-1'); +// le code +?> +]]> + </programlisting> + </example> + </para> + + <caution> + <simpara> + Combinée avec les espaces de nommage, la seule syntaxe valable pour declare + est <literal>declare(encoding='...');</literal> où <literal>...</literal> + est la valeur de l'encodage. <literal>declare(encoding='...') {}</literal> + soulèvera une erreur d'interprétation dans le cas des espaces de nommage. + </simpara> + </caution> + <para> + La valeur d'encodage est ignorée en PHP 5.3 à moins que PHP soit compilé avec + <literal>--enable-zend-multibyte</literal>. En PHP 6.0, la directive <literal>encoding</literal> + sera utilisée pour dire au scanner dans quel encodage le fichier a été créé. Les valeurs + valables sont des noms d'encodage tels que <literal>UTF-8</literal>. + </para> + </sect2> </sect1> <sect1 xml:id="function.return"> - <title><function>return</function></title> + <title>return</title> <simpara> Si appelée depuis une fonction, la commande <function>return</function> termine immédiatement la fonction, et retourne l'argument qui lui @@ -1264,7 +1398,8 @@ </para> </sect1> - <sect1 xml:id="function.require"> + + <sect1 xml:id="function.require"> <title><function>require</function></title> <simpara> @@ -1306,7 +1441,7 @@ ?> ]]> </programlisting> - </example> + </example> </para> <simpara> Voyez la documentation de la fonction <function>include</function> pour plus @@ -1344,7 +1479,7 @@ </simpara> </sect1> - <sect1 xml:id="function.include"> + <sect1 xml:id="function.include"> <title><function>include</function></title> <simpara> La fonction <function>include</function> inclut et exécute @@ -1428,13 +1563,14 @@ par l'analyseur avant que l'inclusion n'intervienne. </simpara> <para> - <example> - <title>Inclusion de fichiers dans une fonction</title> + <example> + <title>Inclusion de fichiers dans une fonction</title> <programlisting role="php"> <![CDATA[ <?php -function foo() { +function foo() +{ global $couleur; include 'vars.php'; @@ -1506,6 +1642,7 @@ $bar = 2; include 'file.txt'; // OK. include 'file.php'; // OK. + ?> ]]> </programlisting> @@ -1628,25 +1765,25 @@ <para> <example> <title>Utilisation de la sortie du buffer pour inclure un fichier PHP dans une chaîne</title> - <programlisting role="php"> + <programlisting role="php"> <![CDATA[ <?php $string = get_include_contents('somefile.php'); function get_include_contents($filename) { - if (is_file($filename)) { - ob_start(); - include $filename; - $contents = ob_get_contents(); - ob_end_clean(); - return $contents; - } - return false; + if (is_file($filename)) { + ob_start(); + include $filename; + $contents = ob_get_contents(); + ob_end_clean(); + return $contents; + } + return false; } ?> ]]> - </programlisting> + </programlisting> </example> </para> <para> @@ -1669,9 +1806,9 @@ <function>virtual</function> et <link linkend="ini.include-path">include_path</link>. </simpara> - </sect1> + </sect1> - <sect1 xml:id="function.require-once"> + <sect1 xml:id="function.require-once"> <title><function>require_once</function></title> <para> La commande <function>require_once</function> se remplace elle-même @@ -1717,10 +1854,12 @@ <title><function>require_once</function> est insensible à la casse sur Windows</title> <programlisting role="php"> <![CDATA[ +<?php require_once "a.php"; // ceci inclut le fichier a.php require_once "A.php"; // ceci inclut encore le fichier a.php sous Windows! (uniquement en PHP 4) +?> ]]> - </programlisting> + </programlisting> </example> Ce comportement a changé en PHP 5 - le chemin est normalisé d'abord, donc, le fichier <filename>C:\PROGRA~1\A.php</filename> est reconnu @@ -1743,7 +1882,7 @@ </para> </sect1> - <sect1 xml:id="function.include-once"> + <sect1 xml:id="function.include-once"> <title><function>include_once</function></title> <para> La commande <function>include_once</function> inclut et @@ -1779,15 +1918,13 @@ </note> </para> <para> - <note> + <note> <para> Attention, <function>require_once</function> et <function>include_once</function> sont insensibles à la casse sous les systèmes comme Windows. <example> - <title> - <function>include_once</function> est insensible à la casse sous Windows - </title> + <title><function>include_once</function> est insensible à la casse sous Windows</title> <programlisting role="php"> <![CDATA[ <?php @@ -1795,7 +1932,7 @@ include_once "A.php"; // ceci inclut encore le fichier a.php sous Windows! (uniquement en PHP 4) ?> ]]> - </programlisting> + </programlisting> </example> Ce comportement a changé en PHP 5 - le chemin est normalisé d'abord, donc, le fichier <filename>C:\PROGRA~1\A.php</filename> est reconnu @@ -1817,23 +1954,26 @@ <function>virtual</function>. </para> </sect1> - + </chapter> - <!-- Keep this comment at the end of the file - Local variables: - mode: sgml - sgml-omittag:t - sgml-shorttag:t - sgml-minimize-attributes:nil - sgml-always-quote-attributes:t - sgml-indent-step:1 - sgml-indent-data:t +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t indent-tabs-mode:nil - sgml-parent-document:nil - sgml-default-dtd-file:"../../manual.ced" - sgml-exposed-tags:nil - sgml-local-catalogs:nil - sgml-local-ecat-files:nil - End: - --> +sgml-parent-document:nil +sgml-default-dtd-file:"../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/exceptions.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/language/exceptions.xml diff -u phpdoc-fr/language/exceptions.xml:1.14 phpdoc-fr/language/exceptions.xml:1.15 --- phpdoc-fr/language/exceptions.xml:1.14 Wed Jun 18 16:16:59 2008 +++ phpdoc-fr/language/exceptions.xml Mon Dec 1 16:24:37 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <chapter xml:id="language.exceptions" xmlns="http://docbook.org/ns/docbook"> @@ -29,6 +29,21 @@ moins qu'un gestionnaire ne soit défini avec la fonction <function>set_exception_handler</function>. </para> + <note> + <para> + Les fonctions internes de PHP utilisent principalement l' + <link linkend="ini.error-reporting">Error reporting</link>, seules les extensions + <link linkend="language.oop5">orientées objet</link> + utilisent les exceptions. Quoiqu'il en soit, des erreurs peuvent facilement être traduites en + exceptions avec <link linkend="class.errorexception">ErrorException</link>. + </para> + </note> + <tip> + <para> + La <link linkend="intro.spl">bibliothèque standard PHP (SPL)</link> fournit + un bon nombre d'exceptions en dur. + </para> + </tip> <example> <title>Lancer une exception</title> <programlisting role="php"> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/expressions.xml?r1=1.33&r2=1.34&diff_format=u Index: phpdoc-fr/language/expressions.xml diff -u phpdoc-fr/language/expressions.xml:1.33 phpdoc-fr/language/expressions.xml:1.34 --- phpdoc-fr/language/expressions.xml:1.33 Sun Jun 8 18:44:27 2008 +++ phpdoc-fr/language/expressions.xml Mon Dec 1 16:24:37 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.33 $ --> -<!-- EN-Revision: 1.31 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.34 $ --> +<!-- EN-Revision: 1.32 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <chapter xml:id="language.expressions" xmlns="http://docbook.org/ns/docbook"> @@ -27,18 +27,18 @@ <para> Un exemple plus complexe concerne les fonctions. Par exemple, considérons la fonction suivante : - <example> - <title>Affectation d'expressions</title> + <informalexample> <programlisting role="php"> <![CDATA[ <?php -function foo () { +function foo () +{ return 5; } ?> ]]> </programlisting> - </example> + </informalexample> </para> <simpara> En supposant que vous êtes familiers avec le concept de fonction, @@ -109,7 +109,8 @@ avoir lu sa valeur, d'où le nom de post-incrémentation). </simpara> <simpara> - Un type d'expression très commun est l'expression de comparaison. Ces + Un type d'expression très commun est <link + linkend="language.operators.comparison">l'expression de comparaison</link>. Ces expressions sont évaluées à 0 ou 1, autrement dit &false; ou &true;, respectivement. PHP supporte les opérateurs de comparaison &gt; (plus grand que), =&gt; (plus grand ou égal), == (égal à), &lt; (plus petit que), @@ -150,16 +151,15 @@ vue dans d'autres langages, l'opérateur conditionnel ternaire : </para> <para> - <example> - <title>L'opérateur conditionnel ternaire</title> + <informalexample> <programlisting role="php"> <![CDATA[ <?php - $first ? $second : $third +$first ? $second : $third ?> ]]> - </programlisting> - </example> + </programlisting> + </informalexample> </para> <para> Si la valeur de la première sous-expression est vraie @@ -174,12 +174,12 @@ et le concept des expressions en général : </para> <para> - <example> - <title>Pré et post-incrémentation : exemples</title> + <informalexample> <programlisting role="php"> <![CDATA[ <?php -function double($i) { +function double($i) +{ return $i*2; } @@ -199,7 +199,7 @@ ?> ]]> </programlisting> - </example> + </informalexample> </para> <simpara> Au début de ce chapitre, nous avons dit que nous allions décrire les @@ -235,20 +235,24 @@ <literal>expr</literal> pour indiquer toute expression PHP valide. </simpara> </chapter> - <!-- Keep this comment at the end of the file - Local variables: - mode: sgml - sgml-omittag:t - sgml-shorttag:t - sgml-minimize-attributes:nil - sgml-always-quote-attributes:t - sgml-indent-step:1 - sgml-indent-data:t + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t indent-tabs-mode:nil - sgml-parent-document:nil - sgml-default-dtd-file:"../manual.ced" - sgml-exposed-tags:nil - sgml-local-catalogs:nil - sgml-local-ecat-files:nil - End: - --> +sgml-parent-document:nil +sgml-default-dtd-file:"../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/oop.xml?r1=1.72&r2=1.73&diff_format=u Index: phpdoc-fr/language/oop.xml diff -u phpdoc-fr/language/oop.xml:1.72 phpdoc-fr/language/oop.xml:1.73 --- phpdoc-fr/language/oop.xml:1.72 Wed Jun 18 16:16:59 2008 +++ phpdoc-fr/language/oop.xml Mon Dec 1 16:24:37 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.72 $ --> -<!-- EN-Revision: 1.70 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.73 $ --> +<!-- EN-Revision: 1.71 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <chapter xml:id="language.oop" xmlns="http://docbook.org/ns/docbook"> @@ -9,16 +9,16 @@ <sect1 xml:id="keyword.class"> <title>Les classes : <literal>class</literal></title> <para> - Une classe est une collection de variables et de fonctions qui - fonctionnent avec ces variables. Les variables sont définies par - l'élément <literal>var</literal> et les fonctions par - <literal>function</literal>. Une classe est définie - en utilisant la syntaxe suivante : + Une classe est une collection de variables et de fonctions qui + fonctionnent avec ces variables. Les variables sont définies par + l'élément <literal>var</literal> et les fonctions par + <literal>function</literal>. Une classe est définie + en utilisant la syntaxe suivante : </para> <para> <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php class Panier { // Eléments de notre panier @@ -26,7 +26,7 @@ // Ajout de $num articles de type $artnr au panier - function add_item ($artnr, $num) { + function add_item($artnr, $num) { $this->items[$artnr] += $num; } @@ -49,12 +49,14 @@ </programlisting> </informalexample> </para> + <para> L'exemple ci-dessus définit la classe Panier qui est composée d'un tableau associatif contenant les articles du panier et de deux fonctions, une pour ajouter et une pour enlever des éléments au panier. </para> + <warning> <simpara> Vous <emphasis>NE POUVEZ PAS</emphasis> couper la définition d'une @@ -72,7 +74,7 @@ ?> <?php function test() { - echo 'OK'; + print 'OK'; } } ?> @@ -92,7 +94,7 @@ function test() { ?> <?php - print 'Ok'; + print 'OK'; } } ?> @@ -112,7 +114,7 @@ une classe <literal>stdClass</literal> en PHP. </simpara> </caution> - + <caution> <simpara> Les noms de fonctions <literal>__sleep</literal> et @@ -121,7 +123,7 @@ que vous ne souhaitiez utiliser la magie qui y est associée. </simpara> </caution> - + <caution> <simpara> PHP se réserve l'usage de tous les noms de fonctions @@ -132,15 +134,15 @@ </simpara> </caution> - <simpara> - En PHP 4, seuls les initialiseurs constants pour les variables - <literal>var</literal> sont autorisés. Utilisez les - constructeurs pour les initialisations variables, ou utilisant - des expressions. - </simpara> - <informalexample> - <programlisting role="php"> - <![CDATA[ + <simpara> + En PHP 4, seuls les initialiseurs constants pour les variables + <literal>var</literal> sont autorisés. Utilisez les + constructeurs pour les initialisations variables, ou utilisant + des expressions. + </simpara> + <informalexample> + <programlisting role="php"> +<![CDATA[ <?php /* Aucune de ces syntaxes ne fonctionnera en PHP 4 */ class Panier { @@ -163,25 +165,28 @@ } ?> ]]> - </programlisting> - </informalexample> + </programlisting> + </informalexample> + <para> Les classes forment un type de variable. Pour créer une variable du type désiré, vous devez utiliser l'opérateur <literal>new</literal>. </para> + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php - $cart = new Panier; - $cart->add_item("10", 1); - $another_cart = new Panier; - $another_cart->add_item("0815", 3); +$cart = new Panier; +$cart->add_item("10", 1); + +$another_cart = new Panier; +$another_cart->add_item("0815", 3); ?> ]]> - </programlisting> </informalexample> + <para> L'instruction ci-dessus crée l'objet <varname>$cart</varname> de la classe <classname>Panier</classname>. @@ -189,6 +194,7 @@ l'article numéro 10 dans le panier. Trois articles numéro 0815 sont ajoutés au panier <varname>$another_cart</varname>. </para> + <para> <varname>$cart</varname> et <varname>$another_cart</varname> disposent des fonctions <literal>add_item()</literal>, <literal>remove_item()</literal> @@ -211,16 +217,18 @@ <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php // correct, le signe $ est unique $cart->items = array("10" => 1); + // incorrect, car $cart->$items devient $cart->"" $cart->$items = array("10" => 1); + // correct, mais risque de ne pas se comporter comme prévu // $cart->$myvar devient $cart->items $myvar = 'items'; -$cart->$myvar = array("10" => 1); +$cart->$myvar = array("10" => 1); ?> ]]> </programlisting> @@ -257,24 +265,24 @@ <?php class A { - function foo() - { - if (isset($this)) { - echo '$this est défini ('; - echo get_class($this); - echo ")\n"; - } else { - echo "\$this n'est pas défini.\n"; + function foo() + { + if (isset($this)) { + echo '$this est défini ('; + echo get_class($this); + echo ")\n"; + } else { + echo "\$this n'est pas défini.\n"; + } } - } } class B { - function bar() - { - A::foo(); - } + function bar() + { + A::foo(); + } } $a = new A(); @@ -284,7 +292,7 @@ $b->bar(); B::bar(); ?> -]]> +]]> </programlisting> &example.outputs; <screen> @@ -307,9 +315,10 @@ </para> </note> </sect1> - + <sect1 xml:id="keyword.extends"> <title><literal>extends</literal> : héritage</title> + <para> Souvent, vous aurez besoin d'une classe avec des méthodes et fonctions similaires à une autre classe. En fait, il est bon @@ -324,13 +333,14 @@ multiple n'est pas supporté. Les héritages se font avec le mot clé '<literal>extends</literal>'. </para> - + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php class Panier_nomme extends Panier { var $owner; + function set_owner ($name) { $this->owner = $name; } @@ -339,24 +349,26 @@ ]]> </programlisting> </informalexample> + <para> - L'exemple ci-dessus définit la classe <classname>Panier_nomme</classname> - qui possède les mêmes variables que la classe Panier et - la variable <varname>$owner</varname> en plus, ainsi que la fonction - <literal>set_owner()</literal>. - 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êmes fonctions que sur un - panier classique. + L'exemple ci-dessus définit la classe <classname>Panier_nomme</classname> + qui possède les mêmes variables que la classe Panier et + la variable <varname>$owner</varname> en plus, ainsi que la fonction + <literal>set_owner()</literal>. + 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êmes fonctions que sur un + panier classique. </para> + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php $ncart = new Panier_nomme; // Création d'un panier nominatif $ncart->set_owner ("kris"); // Affectation du nom du panier -echo $ncart->owner; // Affichage 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) ?> ]]> @@ -397,10 +409,10 @@ même nom que la classe. Si une classe n'a pas de constructeur, le constructeur de la classe de base sera appelé, s'il existe. </para> - <example> - <title>Constructeur de classe</title> + + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php class Auto_Panier extends Panier { function Auto_Panier () { @@ -410,70 +422,82 @@ ?> ]]> </programlisting> - </example> - <para> - L'exemple ci-dessus définit la classe <classname>Auto_Panier</classname> - qui hérite de la classe Panier et définit le constructeur - de la classe. Ce dernier initialise le panier avec 1 article de - type numéro 10 dès que l'instruction <literal>new</literal> est - appelée. La fonction constructeur peut prendre ou non - des paramètres optionnels, ce qui la rend beaucoup plus - pratique. Pour pouvoir utiliser cette classe sans paramètre, - tous les paramètres du constructeurs devraient être optionnels, - en fournissant une valeur par défaut, comme ci-dessous. - </para> - <example> - <title>Constructeur de classe à argument optionnel</title> + </informalexample> + + <para> + L'exemple ci-dessus définit la classe <classname>Auto_Panier</classname> + qui hérite de la classe Panier et définit le constructeur + de la classe. Ce dernier initialise le panier avec 1 article de + type numéro 10 dès que l'instruction <literal>new</literal> est + appelée. La fonction constructeur peut prendre ou non + des paramètres optionnels, ce qui la rend beaucoup plus + pratique. Pour pouvoir utiliser cette classe sans paramètre, + tous les paramètres du constructeurs devraient être optionnels, + en fournissant une valeur par défaut, comme ci-dessous. + </para> + + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php class Constructor_Cart extends Cart { - function Constructor_Cart ($item = "10", $num = 1) { + function Constructor_Cart($item = "10", $num = 1) { $this->add_item ($item, $num); } } + // Création du Panier -$default_cart = new Constructor_Cart; +$default_cart = new Constructor_Cart; + // Création d'un vrai Panier -$different_cart = new Constructor_Cart ("20", 17); +$different_cart = new Constructor_Cart("20", 17); ?> ]]> </programlisting> - </example> + </informalexample> + <para> Vous pouvez également utiliser l'opérateur <literal>@</literal> pour <emphasis>empêcher</emphasis> les erreurs survenant dans le constructeur de s'afficher, e.g. <literal>@new</literal>. </para> - <example> - <title>Constructeur de classe</title> + + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php -class A { - function A() { - 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"; - } +class A +{ + function A() + { + 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"; + } } -class B extends A { +class B extends A +{ } + // Cette syntaxe va appeler B() comme constructeur. $b = new B; ?> ]]> </programlisting> - </example> + </informalexample> + <para> La fonction B() de la classe A va soudainement devenir le constructeur de la classe B, bien qu'il n'ait pas été prévu pour. PHP 4 ne se soucie guère si la fonction est définie dans la classe B ou si elle a été héritée. </para> + <caution> <simpara> PHP 4 n'appelle pas automatiquement le constructeur de @@ -482,6 +506,7 @@ l'appel des constructeurs. </simpara> </caution> + <para> Les destructeurs sont des fonctions qui sont appelées lorsqu'un objet est détruit, soit avec la fonction <function>unset</function> @@ -491,13 +516,16 @@ à la place pour simuler la plupart des effets des destructeurs. </para> </sect1> - <sect1 xml:id="keyword.paamayim-nekudotayim"> + + <sect1 xml:id="keyword.paamayim-nekudotayim"><!-- :-) --> <title>Opérateur de contexte de classe (<literal>::</literal>)</title> + <caution> <simpara> La documentation suivante n'est valable que pour PHP 4 et plus récent. </simpara> </caution> + <para> Parfois, il est pratique de faire référence aux fonctions et variables d'une classe de base, ou bien d'utiliser @@ -505,28 +533,32 @@ créés. L'opérateur <literal>::</literal> est là pour ces situations. </para> - <example> - <title>Exemples avec l'opérateur <literal>::</literal></title> + + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php class A { - function example() { - echo "Je suis la fonction originale A::example().<br />\n"; - } + function example() { + 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"; - A::example(); - } + function example() { + 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 /> 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 /> @@ -534,7 +566,8 @@ ?> ]]> </programlisting> - </example> + </informalexample> + <para> Les exemples ci-dessus appellent la fonction <literal>example()</literal> dans la classe A, mais il n'y a pas encore d'objet de classe A, alors il @@ -542,6 +575,7 @@ la fonction <literal>example()</literal> comme une fonction de classe, c'est-à-dire avec le nom de la classe elle-même, et sans objet. </para> + <para> Il y a des fonctions de classe, mais pas de variables de classe. En fait, il n'y a aucun objet au moment de l'appel de la fonction. @@ -549,6 +583,7 @@ (mais elle peut accéder aux variables locales et globales). Il faut proscrire l'utilisation de <varname>$this</varname>. </para> + <para> Dans l'exemple ci-dessus, la classe B redéfinit la fonction <literal>example()</literal>. La définition originale dans la classe A est remplacée par celle de @@ -558,20 +593,25 @@ il faudrait écrire <literal>parent::example()</literal>, comme expliqué dans la section suivante). </para> + <para> Dans ce contexte, il y a un objet courant, qui peut avoir d'autres variables objets. De ce fait, lorsqu'il est utilisé depuis une méthode d'un objet, vous pouvez utiliser <varname>$this.</varname> </para> + </sect1> + <sect1 xml:id="keyword.parent"> - <title><literal>parent</literal></title> + <title><literal>parent</literal></title> + <para> Il arrive que vous ayez à écrire du code qui faire référence aux variables et fonctions des classes de base. C'est particulièrement vrai si votre classe dérivée est une spécialisation de votre classe de base. </para> + <para> Au lieu d'utiliser le nom littéral de votre classe de base dans votre code, vous pouvez utiliser le mot réservé @@ -583,32 +623,37 @@ le nom de la classe dans la déclaration <literal>extends</literal> de votre classe. </para> - <example> - <title>Exemples avec l'opérateur <literal>parent</literal></title> + + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php class A { - function example() { - echo "Je suis A::example() et je fournis une fonctionnalité de base.<br />\n"; - } + function example() { + 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"; - parent::example(); - } + function example() { + 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> - </example> + </informalexample> </sect1> + <sect1 xml:id="language.oop.serialization"> <title>Sauvegarde d'objets - cas des sessions</title> + <para> <function>serialize</function> retourne une chaîne représentant une valeur qui peut être stockée dans les sessions de PHP, ou une @@ -617,6 +662,7 @@ va sauver toutes les variables d'un objet. Le nom de la classe sera sauvé mais par les méthodes de cet objet. </para> + <para> Pour permettre à <function>unserialize</function> de lire un objet, la classe de cet objet doit être définie. C'est-à-dire, si vous avez @@ -632,43 +678,47 @@ fichier séparé, et en l'incluant dans les deux pages <filename>page1.php</filename> et <filename>page2.php</filename>. </para> - <example> - <title> - La classe d'un objet doit être définie avant sa délinéarisation - </title> + + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php -classa.inc: +// classa.inc: + class A { - var $one = 1; - function show_one() { - echo $this->one; - } + var $one = 1; + + function show_one() { + echo $this->one; + } } -?> -page1.php: -<?php + +// page1.php: + include("classa.inc"); + $a = new A; $s = serialize($a); // enregistrez $s où la page2.php pourra la trouver. $fp = fopen("store", "w"); - fputs($fp, $s); + fwrite($fp, $s); fclose($fp); -?> -page2.php: -<?php + +// page2.php: + // Ceci est nécessaire pour que unserialize() fonctionne correctement include("classa.inc"); + $s = implode("", @file("store")); - unserialize($s); + $a = unserialize($s); + // maintenant, utilisez la méthode show_one de l'objet $a. $a->show_one(); ?> ]]> </programlisting> - </example> + </informalexample> + <para> Si vous utilisez les sessions et la fonction <function>session_register</function> pour sauver des objets, ces objets seront linéarisés automatiquement @@ -677,14 +727,16 @@ script. Cela signifie que ces objets peuvent apparaître dans n'importe quelle page qui utilise vos sessions. </para> + <para> Il est vivement recommandé d'inclure la définition de classe dans toutes vos pages, même si vous n'utilisez pas ces classes dans toutes vos pages. Si vous l'oubliez et qu'un tel objet est présent, il perdra sa classe, et deviendra un objet de classe - <literal>stdClass</literal> sans aucune fonction et, donc, plutôt + <classname>__PHP_Incomplete_Class_Name</classname> sans aucune fonction et, donc, plutôt inutile. </para> + <para> Si, dans l'exemple ci-dessus, <varname>$a</varname> devient un objet de session avec l'utilisation de <literal>session_register("a")</literal>, vous @@ -704,35 +756,39 @@ Si la méthode ne retourne rien, alors &null; est linéarisé et une alerte de type E_NOTICE sera émise. </para> + <para> Le but avoué de <literal>__sleep</literal> est de valider les données en attente ou d'effectuer des opérations de nettoyage. Cette fonction est aussi pratique si vous avez de très grands objets qui n'ont pas besoin d'être sauvés entièrement. </para> + <para> À l'inverse, <function>unserialize</function> s'assure de la présence de la fonction magique <literal>__wakeup</literal>. Si elle existe, cette fonction reconstruit toutes les ressources d'un objet. </para> + <para> Le but de cette fonction <literal>__wakeup</literal> est de rétablir toutes les connexions aux bases de données, et de recréer les variables qui n'ont pas été sauvées. </para> </sect1> + <sect1 xml:id="language.oop.newref"> - <title>Références dans un constructeur</title> - <para> - Créer des références dans un constructeur peut conduire à des résultats - étranges. Ce tutoriel vous guide pour éviter ces problèmes. - <example> - <title>Références dans un constructeur</title> - <programlisting role="php"> - <![CDATA[ + <title>Références dans un constructeur</title> + <para> + Créer des références dans un constructeur peut conduire à des résultats + étranges. Ce tutoriel vous guide pour éviter ces problèmes. + + <informalexample> + <programlisting role="php"> +<![CDATA[ <?php -class foo { - function foo($name) { +class Foo { + function Foo($name) { // crée une référence dans le tableau global $globalref global $globalref; $globalref[] = &$this; @@ -741,31 +797,33 @@ // et l'affiche $this->echoName(); } + function echoName() { - echo "<br />",$this->Name; + echo "<br />", $this->name; } - function setName($name) { - $this->Name = $name; + + function setName($name) { + $this->name = $name; } } ?> ]]> </programlisting> - </example> - </para> + </informalexample> + </para> + <para> Vérifions maintenant qu'il y a une différence entre <varname>$bar1</varname> qui a été créé avec <literal>=</literal> et <varname>$bar2</varname> qui a été créé avec l'opérateur de référence <literal>=&amp;</literal> : - </para> - <example> - <title>Références dans un constructeur (2)</title> + + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php -$bar1 = new foo('crée dans le constructeur'); +$bar1 = new Foo('crée dans le constructeur'); $bar1->echoName(); $globalref[0]->echoName(); @@ -777,14 +835,16 @@ $bar2 =&new foo('crée dans le constructeur'); $bar2->echoName(); $globalref[1]->echoName(); + /* affiche : crée dans le constructeur crée dans le constructeur crée dans le constructeur */ ?> ]]> - </programlisting> - </example> + </programlisting> + </informalexample> + </para> <para> Apparemment, il n'y a pas de différence, mais en fait, il y en a une significative : <varname>$bar1</varname> et <varname>$globalref[0]</varname> @@ -805,11 +865,10 @@ </simpara> </note> Pour prouver ceci, regardez le code suivant : - </para> - <example> - <title>Références et constructeurs</title> + + <informalexample> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php // maintenant, nous allons changer de nom. Qu'attendez-vous ? // Vous pouvez vous attendre à ce que les deux variables $bar @@ -839,46 +898,55 @@ modifié */ ?> ]]> - </programlisting> - </example> + </programlisting> + </informalexample> + </para> <para> Un dernier exemple pour bien comprendre. - <example> - <title>Références dans un constructeur (3)</title> - <programlisting role="php"> - <![CDATA[ + + <informalexample> + <programlisting role="php"> +<![CDATA[ <?php -class a { - function a($i) { +class A { + function A($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; } } -class b { - function b(&$a) { + + +class B { + function B(&$a) { $this->a = &$a; } - function echoValue() { + + function echoValue() { 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(); @@ -897,9 +965,10 @@ class B: 11 ]]> </screen> - </example> + </informalexample> </para> </sect1> + <sect1 xml:id="language.oop.object-comparison"> <title>Comparer des objets</title> <para> @@ -916,7 +985,6 @@ <programlisting role='php'> <![CDATA[ <?php - function bool2str($bool) { if ($bool === false) { return 'FALSE'; @@ -965,13 +1033,12 @@ echo "\nCompare une instance d'un parent avec celle d'une sous-classe\n"; compareObjects($o, $r); - ?> ]]> </programlisting> - &example.outputs; - <screen> -<![CDATA[ + &example.outputs; + <screen> +<![CDATA[ Compare des instances créées avec les mêmes paramètres o1 == o2 : TRUE o1 != o2 : FALSE @@ -990,8 +1057,8 @@ o1 === o2 : FALSE o1 !== o2 : TRUE ]]> - </screen> - </example> + </screen> + </example> Ce qui est le résultat que nous attendions, au vu des règles édictées. Seules deux instances avec les mêmes valeurs d'attributs, et issues de la même classe, sont considérées comme égales. @@ -1002,10 +1069,9 @@ conteneur, qui stocke un tableau associatif <classname>Flag</classname>. <example> <title>Comparaison d'objets composés en PHP 4</title> - <programlisting role="php"> + <programlisting role='php'> <![CDATA[ <?php - class FlagSet { var $set; @@ -1036,8 +1102,7 @@ echo "\nu(o,p) et w(q)\n"; compareObjects($u, $w); - -?> +?> ]]> </programlisting> &example.outputs; @@ -1059,21 +1124,25 @@ </example> </para> </sect1> -</chapter> - <!-- Keep this comment at the end of the file - Local variables: - mode: sgml - sgml-omittag:t - sgml-shorttag:t - sgml-minimize-attributes:nil - sgml-always-quote-attributes:t - sgml-indent-step:1 - sgml-indent-data:t + </chapter> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t indent-tabs-mode:nil - sgml-parent-document:nil - sgml-default-dtd-file:"../../manual.ced" - sgml-exposed-tags:nil - sgml-local-catalogs:nil - sgml-local-ecat-files:nil - End: - --> +sgml-parent-document:nil +sgml-default-dtd-file:"../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/oop5.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc-fr/language/oop5.xml diff -u phpdoc-fr/language/oop5.xml:1.17 phpdoc-fr/language/oop5.xml:1.18 --- phpdoc-fr/language/oop5.xml:1.17 Sun Jun 8 18:44:27 2008 +++ phpdoc-fr/language/oop5.xml Mon Dec 1 16:24:37 2008 @@ -1,42 +1,43 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.15 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> -<chapter xml:id="language.oop5" xmlns="http://docbook.org/ns/docbook"> - <title>Les classes et les objets (PHP 5)</title> + <chapter xml:id="language.oop5" xmlns="http://docbook.org/ns/docbook"> + <title>Les classes et les objets (PHP 5)</title> - <sect1 xml:id="op5.intro"> - &reftitle.intro; - <para> - En PHP 5, il y a un tout nouveau modèle objet. La gestion des objets en PHP - a été complètement réécrite, permettant de meilleurs performances ainsi - que plus de fonctionnalités. - </para> - &tip.userlandnaming; - </sect1> + <sect1 xml:id="op5.intro"> + <title>Introduction</title> + <para> + En PHP 5, il y a un tout nouveau modèle objet. La gestion des objets en PHP + a été complètement réécrite, permettant de meilleurs performances ainsi + que plus de fonctionnalités. + </para> + &tip.userlandnaming; + </sect1> - &language.oop5.basic; - &language.oop5.autoload; - &language.oop5.decon; - &language.oop5.visibility; - &language.oop5.paamayim-nekudotayim; - &language.oop5.static; - &language.oop5.constants; - &language.oop5.abstract; - &language.oop5.interfaces; - &language.oop5.overloading; - &language.oop5.iterations; - &language.oop5.patterns; - &language.oop5.magic; - &language.oop5.final; - &language.oop5.cloning; - &language.oop5.object-comparison; - &language.oop5.reflection; - &language.oop5.typehinting; - &language.oop5.late-static-bindings; + &language.oop5.basic; + &language.oop5.autoload; + &language.oop5.decon; + &language.oop5.visibility; + &language.oop5.paamayim-nekudotayim; + &language.oop5.static; + &language.oop5.constants; + &language.oop5.abstract; + &language.oop5.interfaces; + &language.oop5.overloading; + &language.oop5.iterations; + &language.oop5.patterns; + &language.oop5.magic; + &language.oop5.final; + &language.oop5.cloning; + &language.oop5.object-comparison; + &language.oop5.reflection; + &language.oop5.typehinting; + &language.oop5.late-static-bindings; + &language.oop5.references; </chapter> - + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -56,4 +57,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> \ No newline at end of file +--> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/operators.xml?r1=1.105&r2=1.106&diff_format=u Index: phpdoc-fr/language/operators.xml diff -u phpdoc-fr/language/operators.xml:1.105 phpdoc-fr/language/operators.xml:1.106 --- phpdoc-fr/language/operators.xml:1.105 Wed Jun 18 16:16:59 2008 +++ phpdoc-fr/language/operators.xml Mon Dec 1 16:24:37 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.105 $ --> -<!-- EN-Revision: 1.125 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.106 $ --> +<!-- EN-Revision: 1.127 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <chapter xml:id="language.operators" xmlns="http://docbook.org/ns/docbook"> @@ -59,8 +59,8 @@ <tbody> <row> <entry>non-associative</entry> - <entry>new</entry> - <entry><link linkend="language.oop5.basic.new">new</link></entry> + <entry>clone new</entry> + <entry><link linkend="language.oop5.cloning">clone</link> et <link linkend="language.oop5.basic.new">new</link></entry> </row> <row> <entry>gauche</entry> @@ -791,7 +791,7 @@ <link linkend="ini.track-errors"><option>track_errors</option></link> est activée, les messages d'erreurs générés par une expression seront sauvés dans la variable globale - <link linkend="reserved.variables.phperrormsg"><varname>$php_errormsg</varname></link>. + <varname>$php_errormsg</varname>. Cette variable sera écrasée à chaque erreur. Il faut alors la surveiller souvent pour pouvoir l'utiliser. </simpara> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/variables.xml?r1=1.89&r2=1.90&diff_format=u Index: phpdoc-fr/language/variables.xml diff -u phpdoc-fr/language/variables.xml:1.89 phpdoc-fr/language/variables.xml:1.90 --- phpdoc-fr/language/variables.xml:1.89 Sun Jun 8 18:44:27 2008 +++ phpdoc-fr/language/variables.xml Mon Dec 1 16:24:37 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.89 $ --> -<!-- EN-Revision: 1.100 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.90 $ --> +<!-- EN-Revision: 1.107 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <chapter xml:id="language.variables" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -26,9 +26,8 @@ <note> <simpara> - Dans nos propos, une lettre peut être une des lettres minuscules - (a à z) ou majuscules (A à Z) et les caractères - ASCII de 127 à 255 (<literal>0x7f-0xff</literal>). + Dans nos propos, une lettre peut être a-z, A-Z, et les octets + de 127 à 255 (0x7f-0xff). </simpara> </note> @@ -122,7 +121,6 @@ $bar = &test(); // assignation invalide. ?> ]]> - </programlisting> </example> </para> @@ -130,7 +128,9 @@ <para> Il n'est pas nécessaire d'initialiser les variables en PHP, cependant, cela reste une excellente pratique. Les variables non initialisées ont une valeur par défaut - selon leur type - &false;, zéro, chaîne vide ou un tableau vide. + selon leur type - &false; pour les booléens, zéro pour les entiers et les réels, chaîne vide + pour les chaînes de caractères (comme utilisée avec <function>echo</function>) ou un tableau vide + pour les tableaux. </para> <para> <example> @@ -138,10 +138,32 @@ <programlisting role="php"> <![CDATA[ <?php -echo ($unset_bool ? "true" : "false"); // false +// Une variable non initialisée et non référencée (pas de contexte d'utilisation); retourne NULL +var_dump($unset_var); + +// L'utilisation d'un booléen; retourne 'false' (Voir l'opérateur ternaire pour comprendre cette syntaxe) +echo($unset_bool ? "true\n" : "false\n"); + +// Utilisation d'une chaîne de caractères; retourne 'string(3) "abc"' +$unset_str .= 'abc'; +var_dump($unset_str); + +// Utilisation d'un entier; retourne 'int(25)' $unset_int += 25; // 0 + 25 => 25 -echo $unset_string . "abc"; // "" . "abc" => "abc" -$unset_array[3] = "def"; // array() + array(3 => "def") => array(3 => "def") +var_dump($unset_int); + +// Utilisation d'un entier/double; retourne 'float(1.25)' +$unset_float += 1.25; +var_dump($unset_float); + +// Utilisation d'un tableau : retourne array(1) { [3]=> string(3) "def" } +$unset_arr[3] = "def"; // array() + array(3 => "def") => array(3 => "def") +var_dump($unset_arr); + +// Utilisation d'un objet; crée un nouvel objet stdClass (voir http://www.php.net/manual/fr/reserved.classes.php) +// Retourne : object(stdClass)#1 (1) { ["foo"]=> string(3) "bar" } +$unset_obj->foo = 'bar'; +var_dump($unset_obj); ?> ]]> </programlisting> @@ -245,9 +267,9 @@ <link linkend="ini.variables-order"><option>variables_order</option></link> ne sont pas définies, leur tableau pré-défini PHP correspondant est laissé vide. </para> - </sect1> + <sect1 xml:id="language.variables.scope"> <title>Portée des variables</title> @@ -279,22 +301,23 @@ par définition, locale. Par exemple : </simpara> - <example> - <title>Les variables sont locales à la fonction (2)</title> + <informalexample> <programlisting role="php"> <![CDATA[ <?php $a = 1; /* portée globale */ -function test() { +function test() +{ echo $a; /* portée locale */ } + test(); ?> ]]> - </programlisting> - </example> + </informalexample> + <simpara> Le script n'affichera rien à l'écran car l'instruction <function>echo</function> utilise la variable locale <varname>$a</varname>, @@ -422,7 +445,7 @@ <programlisting role="php"> <![CDATA[ <?php -function Test() +function test() { $a = 0; echo $a; @@ -449,19 +472,19 @@ <programlisting role="php"> <![CDATA[ <?php -function Test() { +function test() +{ static $a = 0; echo $a; $a++; } ?> ]]> - </programlisting> </example> </para> <simpara> - Maintenant, à chaque fois que la fonction Test() est + Maintenant, à chaque fois que la fonction test() est appelée, elle affichera une valeur de <varname>$a</varname> incrémentée de 1. </simpara> @@ -482,13 +505,14 @@ <programlisting role="php"> <![CDATA[ <?php -function Test() +function test() { static $count = 0; + $count++; echo $count; if ($count < 10) { - Test(); + test(); } $count--; } @@ -807,7 +831,7 @@ <literal>http://www.example.com/test.php?id=3</literal> contient les données de GET, qui sont accessibles via <varname>$_GET['id']</varname>. Voyez aussi - <link linkend="reserved.variables.request">$_REQUEST</link> et + <varname>$_REQUEST</varname> et <function>import_request_variables</function>. </para> @@ -1034,20 +1058,24 @@ </sect1> </chapter> - <!-- Keep this comment at the end of the file - Local variables: - mode: sgml - sgml-omittag:t - sgml-shorttag:t - sgml-minimize-attributes:nil - sgml-always-quote-attributes:t - sgml-indent-step:1 - sgml-indent-data:t + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t indent-tabs-mode:nil - sgml-parent-document:nil - sgml-default-dtd-file:"../../manual.ced" - sgml-exposed-tags:nil - sgml-local-catalogs:nil - sgml-local-ecat-files:nil - End: - --> +sgml-parent-document:nil +sgml-default-dtd-file:"../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +-->
« previous php.doc.fr (#6131) next »