cvs: phpdoc-fr /appendices migration51.xml

From: Date: Tue, 10 Feb 2009 23:51:47 +0000
Subject: cvs: phpdoc-fr /appendices migration51.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-6615@lists.php.net to get a copy of this message
yannick Tue Feb 10 23:51:47 2009 UTC Modified files: /phpdoc-fr/appendices migration51.xml Log: correct some errors

http://cvs.php.net/viewvc.cgi/phpdoc-fr/appendices/migration51.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/appendices/migration51.xml diff -u phpdoc-fr/appendices/migration51.xml:1.8 phpdoc-fr/appendices/migration51.xml:1.9 --- phpdoc-fr/appendices/migration51.xml:1.8 Thu Aug 21 23:01:26 2008 +++ phpdoc-fr/appendices/migration51.xml Tue Feb 10 23:51:47 2009 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> @@ -124,8 +124,8 @@ Zend a été modifié pour reconnaître les cas où une valeur ne doit pas être utilisée par référence. La valeur réelle est maintenant utilisée dans ces cas, et une alerte est émise. Cette alerte prend la forme d'un - message E_NOTICE en PHP 4.4.0 et plus récent, et E_STRICT en PHP 5.0.4 et - plus récent. + message <constant>E_NOTICE</constant> en PHP 4.4.0 et plus récent, et + <constant>E_STRICT</constant> en PHP 5.0.4 et plus récent. </para> <para> Du code qui pouvait produire des corruptions de mémoire ne peut plus le faire. Cependant, certains codes anciens peuvent fonctionner de manière @@ -186,16 +186,17 @@ </screen> </informalexample> <para> - Ceci est dû au fait que func() effectue une assignation par valeur. La - valeur de $y est réassignée, et que la liaison par référence avec $z est - préservée. La tentative de liaison avec une valeur temporaire est la cause + Ceci est dû au fait que <literal>func()</literal> effectue une assignation + par valeur. La valeur de <varname>$y</varname> est réassignée, et que la + liaison par référence avec <varname>$z</varname> est préservée. + La tentative de liaison avec une valeur temporaire est la cause de la corruption de la mémoire. </para> <para> Ce code peut être réparé pour fonctionner à l'identique avec des versions - pré et post-correction. La signature de func() peut être modifiée pour - retourner les valeurs par référence, ou bien l'affectation par référence - peut être supprimée du résultat de func(). + pré et post-correction. La signature de <literal>func()</literal> peut être + modifiée pour retourner les valeurs par référence, ou bien l'affectation + par référence peut être supprimée du résultat de <literal>func()</literal>. </para> <informalexample> <programlisting role="php"> @@ -214,10 +215,10 @@ </programlisting> </informalexample> <para> - En PHP 4.3 $x vaudrait 'original value', alors qu'après le changement, il + En PHP 4.3, <varname>$x</varname> vaudrait 'original value', alors qu'après le changement, il vaudrait 'function return' : n'oubliez pas que la fonction ne retourne plus par référence, et que la référence est convertie en affectation par valeur. - Encore une fois, cela peut être corrigé en forçant func() à retourner par + Encore une fois, cela peut être corrigé en forçant <literal>func()</literal> à retourner par référence, ou bien en éliminant l'affectation par référence. </para> </section> @@ -248,11 +249,12 @@ </programlisting> </informalexample> <para> - En PHP 5.0.3, $bar vaut NULL au lieu de l'objet attendu. Cela arrive car - getThis() retourne une valeur, mais que la valeur est assignée par - référence. Même si cela fonctionne désormais comme attendu, ce code est en - fait invalide, et émettra une alerte E_NOTICE sous PHP 4.4 ou - E_STRICT en PHP 5.0.4 et plus récent. + En PHP 5.0.3, <varname>$bar</varname> vaut <constant>NULL</constant> au + lieu de l'objet attendu. Cela arrive car <literal>getThis()</literal> + retourne une valeur, mais que la valeur est assignée par référence. + Même si cela fonctionne désormais comme attendu, ce code est en + fait invalide, et émettra une alerte <constant>E_NOTICE</constant> sous + PHP 4.4 ou <constant>E_STRICT</constant> en PHP 5.0.4 et plus récent. </para> </section> @@ -276,10 +278,11 @@ ]]> </programlisting> <para> - En PHP 4.3 le troisième appel à var_dump() produit NULL, à cause d'une - correction de la mémoire, causée par le retour d'une valeur non initialisée - par référence. C'est du code valide en PHP 5.0.4 et plus récent, mais il - produit une erreur dans les versions plus anciennes. + En PHP 4.3, le troisième appel à <function>var_dump</function> produit + <constant>NULL</constant>, à cause d'une correction de la mémoire, causée + par le retour d'une valeur non initialisée par référence. C'est du code + valide en PHP 5.0.4 et plus récent, mais il produit une erreur dans les + versions plus anciennes. </para> </informalexample> <informalexample> @@ -305,10 +308,11 @@ Il y a quelques cas de bogues rapportés en PHP PHP 5.0 avant la correction de ce bogue qui 'refonctionnent'. Cependant, dans tous les cas, des erreurs sont émises en PHP 5.1.x, car le code est invalide. Retourner des références - avec self:: fonctionne maintenant, mais émet une alerte E_STRICT, et même - si votre expérience est différente lors de l'assignation d'un objet par - référence, vous verrez toujours une erreur E_ERROR lorsque vous tentez cela - même si l'assignation semble fonctionner. + avec <literal>self::</literal> fonctionne maintenant, mais émet une alerte + <constant>E_STRICT</constant>, et même si votre expérience est différente + lors de l'assignation d'un objet par référence, vous verrez toujours une + erreur <constant>E_ERROR</constant> lorsque vous tentez cela même si + l'assignation semble fonctionner. </para> </section> @@ -317,7 +321,8 @@ <para> Des appels imbriqués à des fonctions retournant des valeurs par référence sont valides en PHP 4.3.x et PHP 5.1.x, mais ils émettent des erreurs - E_NOTICE et E_STRICT dans les nouvelles versions de PHP. + <constant>E_NOTICE</constant> et <constant>E_STRICT</constant> dans les + nouvelles versions de PHP. </para> <informalexample> <programlisting role="php"> @@ -339,7 +344,8 @@ </programlisting> </informalexample> </section> - </section><!-- end of migration51.references --> + </section> + <section xml:id="migration51.reading"> <title>Lecture de []</title> <informalexample> @@ -369,9 +375,9 @@ </programlisting> </informalexample> <para> - Ce code va toujours émettre une alerte fatale E_ERROR, car l'opérateur [] - ne peut pas être utilisé pour lire des données. C'est du code invalide - depuis PHP 4.4.2 et PHP 5.0.5. + Ce code va toujours émettre une alerte fatale <constant>E_ERROR</constant>, + car l'opérateur [] ne peut pas être utilisé pour lire des données. C'est du + code invalide depuis PHP 4.4.2 et PHP 5.0.5. </para> </section> @@ -385,7 +391,7 @@ accepter des chaînes telles que " 123" et "123 ", et elles ne les refuseront plus comme c'était le cas en PHP 5.0.x. Toutefois, pour faire la promotion de la sécurité et de la validation, les fonctions PHP vont désormais émettre - des alertes E_NOTICE lorsque de tels arguments sont donnés. + des alertes <constant>E_NOTICE</constant> lorsque de tels arguments sont donnés. </para> </section> @@ -394,8 +400,9 @@ <itemizedlist> <listitem> <para> - <link linkend="migration51.oop-functions">instanceof, is_a(), - is_subclass_of() et catch</link> + <link linkend="migration51.oop-functions"><literal>instanceof</literal>, + <literal>is_a()</literal>, <literal>is_subclass_of()</literal> et + <literal>catch</literal></link> </para> </listitem> <listitem> @@ -421,19 +428,23 @@ </itemizedlist> <section xml:id="migration51.oop-functions"> - <title>instanceof, is_a(), is_subclass_of() et catch</title> + <title><literal>instanceof</literal>, <literal>is_a()</literal>, + <literal>is_subclass_of()</literal> et <literal>catch</literal></title> <para> - En PHP 5.0, is_a() a été rendu abandonné et remplacé par l'opérateur - "instanceof". Il y a eu des problèmes dans les premières implantations - de "instanceof", qui se base sur __autoload() pour rechercher les classes - non définies. Si la classe n'est pas définie, "instanceof" émettait une - erreur fatale E_ERROR, après l'échec de __autoload(). Le même comportement - apparaissait avec l'opérateur "catch" et la fonction is_subclass_of(). - </para> - <para> - Aucune de ces instructions n'appelle plus __autoload() en PHP 5.1.x, et - les palliatifs à base de class_exists() utilisé dans le code écrit en - PHP 5.0.x ne sont plus nécessaires. + En PHP 5.0, <literal>is_a()</literal> a été rendu abandonné et remplacé + par l'opérateur <literal>instanceof</literal>. Il y a eu des problèmes + dans les premières implantations + de <literal>instanceof</literal>, qui se base sur <literal>__autoload()</literal> + pour rechercher les classes non définies. Si la classe n'est pas définie, + <literal>instanceof</literal> émettait une erreur fatale + <constant>E_ERROR</constant>, après l'échec de <literal>__autoload()</literal>. + Le même comportement apparaissait avec l'opérateur <literal>catch</literal> + et la fonction <literal>is_subclass_of()</literal>. + </para> + <para> + Aucune de ces instructions n'appelle plus <literal>__autoload()</literal> + en PHP 5.1.x, et les palliatifs à base de <literal>class_exists()</literal> + utilisé dans le code écrit en PHP 5.0.x ne sont plus nécessaires. </para> </section> @@ -441,8 +452,8 @@ <title>Méthodes privées abstraites</title> <para> Les méthodes privées abstraites sont supportées en PHP entre 5.0.0 et - et 5.0.4, mais elles ont été abandonnées car 'private' et 'abstract' sont - mutuellement exclusif. + et 5.0.4, mais elles ont été abandonnées car <literal>private</literal> + et <literal>abstract</literal> sont mutuellement exclusif. </para> </section> @@ -452,13 +463,14 @@ Avec PHP 5.0, les déclarations de fonctions dans les interfaces sont traitées exactement de la même manière que pour les déclarations de fonctions dans les classes. Ce n'est plus le cas depuis octobre 2004, - au moment où seuls l'option d'accès 'public' a été autorisée dans - les déclarations d'interface. Depuis avril 2005, ce qui est antérieur - à PHP 5.0b1, l'option 'static' a aussi été autorisée. Mais les options - 'protected' et 'private' émettent désormais une erreur E_ERROR, tout - comme 'abstract'. Notez que cette modification ne va pas affecter votre - code existant, car aucune de ces options n'a de sens dans le cadre - d'une interface. + au moment où seuls l'option d'accès <literal>public</literal> a été + autorisée dans les déclarations d'interface. Depuis avril 2005, ce qui + est antérieur à PHP 5.0b1, l'option <literal>static</literal> a aussi + été autorisée. Mais les options <literal>protected</literal> + and <literal>private</literal> émettent désormais une erreur + <constant>E_ERROR</constant>, tout comme <literal>abstract</literal>. + Notez que cette modification ne va pas affecter votre code existant, + car aucune de ces options n'a de sens dans le cadre d'une interface. </para> </section> @@ -471,7 +483,8 @@ </para> <informalexample> <para> - Ce code va émettre une erreur E_STRICT si utilisé avec PHP 5.1.x. + Ce code va émettre une erreur <constant>E_STRICT</constant> si utilisé + avec PHP 5.1.x. </para> <programlisting role="php"> <![CDATA[ @@ -502,7 +515,7 @@ <informalexample> <para> En PHP 5.1.x, la redéfinition d'une constante de classe émet une - erreur fatale E_ERROR. + erreur fatale <constant>E_ERROR</constant>. </para> <programlisting role="php"> <![CDATA[ @@ -642,8 +655,8 @@ <link linkend="intro.pdo">PDO</link>, <link linkend="book.xmlreader">XMLReader</link> et <link linkend="ref.datetime">date</link>, dispose de constantes au format - <literal>PDO::CLASS_CONSTANT</literal> plutôt qu'au format C de type - <literal>PDO_CLASS_CONSTANT</literal> afin de réduire la pollution des + <constant>PDO::CLASS_CONSTANT</constant> plutôt qu'au format C de type + <constant>PDO_CLASS_CONSTANT</constant> afin de réduire la pollution des espaces de noms globaux de PHP. </para> </section> @@ -681,8 +694,10 @@ </itemizedlist> <informalexample> <para> - Pour s'assurer de la précision, et éviter les alertes E_STRICT, vous devez - définir votre fuseau horaire dans le fichier php.ini avec ce format : + Pour s'assurer de la précision, et éviter les alertes + <constant>E_STRICT</constant>, vous devez + définir votre fuseau horaire dans le fichier + <filename>php.ini</filename> avec ce format : </para> <para> date.timezone = Europe/Paris @@ -808,7 +823,7 @@ <informalexample> <para> Si vous n'avez qu'un seul script à vérifier, vous pouvez identifier les - erreurs E_STRICT en utilisant PHP en ligne de commande : + erreurs <constant>E_STRICT</constant> en utilisant PHP en ligne de commande : </para> <programlisting role="shell"> php -d error_reporting=4095 -l script_to_check.php @@ -880,5 +895,4 @@ vim600: syn=xml fen fdm=syntax ft=docbkphp fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> - +--> \ No newline at end of file
« previous php.doc.fr (#6615) next »