cvs: phpdoc-fr /appendices filters.xml license.xml reserved.xml tokens.xml

From: Date: Wed, 07 Apr 2004 13:18:46 +0000
Subject: cvs: phpdoc-fr /appendices filters.xml license.xml reserved.xml tokens.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-2137@lists.php.net to get a copy of this message
dams Wed Apr 7 09:18:46 2004 EDT Added files: /phpdoc-fr/appendices filters.xml license.xml Modified files: /phpdoc-fr/appendices reserved.xml tokens.xml Log: initial translation

http://cvs.php.net/diff.php/phpdoc-fr/appendices/reserved.xml?r1=1.24&r2=1.25&ty=u Index: phpdoc-fr/appendices/reserved.xml diff -u phpdoc-fr/appendices/reserved.xml:1.24 phpdoc-fr/appendices/reserved.xml:1.25 --- phpdoc-fr/appendices/reserved.xml:1.24 Fri Feb 27 09:32:21 2004 +++ phpdoc-fr/appendices/reserved.xml Wed Apr 7 09:18:45 2004 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.24 $ --> +<!-- $Revision: 1.25 $ --> <!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> <appendix id="reserved"> - <title>Mots réservés en PHP</title> + <title>Mots réservés en &php;</title> <para> - Cette annexes est une liste d'identifiant prédéfinis en PHP. Aucun + Cette annexes est une liste d'identifiant prédéfinis en &php;. Aucun des identifiants utilisés ici ne doit être repris comme nom de variable ou de fonction dans vos scripts. Ces identifiants incluent des mots clés, des constantes, des classes, et es variables @@ -24,7 +24,7 @@ </para> <para> <table> - <title>PHP Keywords</title> + <title>Mots réservés en &php;</title> <tgroup cols="5"> <tbody> <row> @@ -271,7 +271,7 @@ </simpara> <simpara> - Si la directive <link linkend="ini.register-globals">register_globals</link> + Si la directive <link linkend="ini.register-globals">register_globals</link> est active, alors ces variables seront aussi rendues directement accessible dans le contexte d'exécution global. C'est à dire séparément des tableaux <varname>$_SERVER</varname> et <varname>$HTTP_SERVER_VARS</varname>. @@ -281,9 +281,10 @@ </simpara> <simpara> - You may or may not find any of the following elements in - $_SERVER. Note that few, if any, of these will be available (or - indeed have any meaning) if running PHP on the command line. + Vous pouvez éventuellement trouver les éléments suivants + dans la variable <var>$_SERVER</var>. Notez que certains, + n'auront pas de sens si vous utilisez &php; en ligne + de commande. </simpara> <para> @@ -293,13 +294,13 @@ <listitem> <simpara> Le nom du fichier du script en cours d'exécution, par - rapport au document root. + rapport à la racine web. Par exemple, <varname>$_SERVER['PHP_SELF']</varname> dans le script situé à l'adresse <filename>http://www.monsite.com/test.php/foo.bar</filename> sera <filename>/test.php/foo.bar</filename>. </simpara> <simpara> - Si PHP fonctionne en ligne de commande, + Si &php; fonctionne en ligne de commande, cette variable n'est pas disponible. </simpara> </listitem> @@ -620,9 +621,9 @@ </note> <simpara> - Cette variable est importée dans l'espace de nom global de PHP, - depuis l'environnement dans lequel l'exécutable PHP fonctionne. - De nombreuses valeur sont fournies par le shell qui exécute PHP, + Cette variable est importée dans l'espace de nom global de &php;, + depuis l'environnement dans lequel l'exécutable &php; fonctionne. + De nombreuses valeur sont fournies par le shell qui exécute &php;, et différents systèmes pouvant disposer de différents shell, même un début de liste serait ici impossible. Reportez vous à la documentation de votre shell pour connaître une liste de variables prédéfinies. @@ -630,7 +631,7 @@ <simpara> Les autres variables d'environnement incluent les variables CGI, - placées ici, indépendemment du fait que PHP fonctionne en tant + placées ici, indépendemment du fait que &php; fonctionne en tant que CGI ou bien que module du serveur. </simpara> @@ -902,11 +903,11 @@ </sect2> <sect2 id="reserved.variables.globals"> - <title>Variables globales: <varname>$GLOBALS</varname></title> + <title>Variables globales : <varname>$GLOBALS</varname></title> <note> <simpara> - <varname>$GLOBALS</varname> est disponible depuis PHP 3.0.0. + <varname>$GLOBALS</varname> est disponible depuis &php; 3.0.0. </simpara> </note> @@ -930,7 +931,7 @@ <title>Le dernier message d'erreur : <varname>$php_errormsg</varname></title> <simpara> <varname>$php_errormsg</varname> est une variable qui contient le texte - de la dernière erreur générée par PHP. Cette variable sera uniquement + de la dernière erreur générée par &php;. Cette variable sera uniquement accessible dans le même contexte d'exécution que celui de la ligne qui a généré l'erreur, et uniquement si la directive de configuration <link linkend="ini.track-errors">track_errors</link> est activée (elle est @@ -948,7 +949,7 @@ <simpara> Ces classes sont définies dans le jeu de classe standard - de PHP, inclus dans toute version de PHP. + de &php;, inclus dans toutes les versions de &php;. </simpara> <variablelist> http://cvs.php.net/diff.php/phpdoc-fr/appendices/tokens.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc-fr/appendices/tokens.xml diff -u phpdoc-fr/appendices/tokens.xml:1.7 phpdoc-fr/appendices/tokens.xml:1.8 --- phpdoc-fr/appendices/tokens.xml:1.7 Wed Feb 25 09:11:45 2004 +++ phpdoc-fr/appendices/tokens.xml Wed Apr 7 09:18:45 2004 @@ -1,19 +1,20 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> <appendix id="tokens"> <title>Liste des token de l'analyseur</title> <para> - De nombreuses parties du langage PHP sont représentées en interne par des - trucs (NDT : litéralement) comme T_SR. PHP affiche des identifiants - comme celui-ci dans les erreurs d'analyse, comme par exemple : + De nombreuses parties du langage &php; sont représentées en interne par des + tokens. Litéralement, ce sont des trucs, ou jetons. Ici, des briques de base, + comme T_SR. &php; affiche des identifiants comme celui-ci + dans les erreurs d'analyse, comme par exemple : <literal>unexpected T_SR, expecting ',' or ';' in script.php on line 10.</literal>. </para> <para> - Vous êtes suppposé savoir ce que T_SR signifie. Pour ceux qui ne le savent pas, - voici une liste de ces identifiant, la syntaxe PHP attenante, et les références - appropriées au manuel. + Vous êtes suppposés savoir ce que T_SR signifie. Pour ceux qui ne le savent pas, + voici une liste de ces identifiant, la syntaxe &php; correspondante, et + les références appropriées au manuel. </para> <table> <title>Tokens</title> http://cvs.php.net/co.php/phpdoc-fr/appendices/filters.xml?r=1.1&p=1 Index: phpdoc-fr/appendices/filters.xml +++ phpdoc-fr/appendices/filters.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <appendix id="filters"> <title>Liste des filtres standards</title> <para> Cette section contient la liste des filtres de flux, à utiliser avec <function>stream_filter_append</function>. Votre version de &php; peut avoir des filtres supplémentaires, ou manquants par rapport à cette liste. </para> <para> Il est bon de noter une légère différence entre <function>stream_filter_append</function> et <function>stream_filter_prepend</function>. Tous les flux &php; disposent d'un petit <emphasis>buffer de lecture</emphasis>, où ils stockent des blocs de données lues dans le système de fichiers, ou dans d'autres sources, afin de les traiter plus efficacement. Aussitôt que les données sont lues depuis la ressource dans le buffer interne, les données sont immédiatement passées au filtre, même si l'application &php; n'est pas prête pour lire ces données. Si des données sont déjà en attente dans le buffer lorsqu'un filtre est ajouté au flux, ces données seront immédiatement passées au filtre, pour que la modification soit transparente. Mais si vous ajoutez un filtre avec prepend, les données <emphasis>NE seront PAS</emphasis> filtrées. Elles attendront que le prochain bloc arrive de la ressource. </para> <para> Pour avoir la liste complète des filtres de votre version de &php;, utilisez la fonction <function>stream_get_filters</function>. </para> <section id="filters.string"> <title>String Filters</title> <simpara> Chaque filtre fait ce que son nom implique, et correspond au comportement de la fonction &php; correspondante. Pour plus de détails sur un filtre, reportez vous au manuel de la fonction correspondante. </simpara> <para> <table> <title> Filtres de chaînes de caractères </title> <tgroup cols="4"> <thead> <row> <entry>Nom</entry> <entry>Fonction &php; équivalente</entry> <entry>Version</entry> <entry>Paramètres</entry> </row> </thead> <tbody> <row> <entry><literal>string.rot13</literal></entry> <entry> <function>str_rot13</function> </entry> <entry><literal>PHP 4.3.0</literal></entry> <entry>Aucun</entry> </row> <row> <entry><literal>string.toupper</literal></entry> <entry> <function>strtoupper</function> </entry> <entry><literal>PHP 5.0.0</literal></entry> <entry>Aucun</entry> </row> <row> <entry><literal>string.tolower</literal></entry> <entry> <function>strtolower</function> </entry> <entry><literal>PHP 5.0.0</literal></entry> <entry>Aucun</entry> </row> <row> <entry><literal>string.strip_tags</literal></entry> <entry> <function>strip_tags</function> </entry> <entry><literal>PHP 5.0.0</literal></entry> <entry> Une chaîne contenant les balises autorisées, similairement au second paramètre de function>strip_tags</function>. Peut aussi être un tableau contenant une liste de balises, sans les symboles &lt;&gt;. </entry> </row> </tbody> </tgroup> </table> </para> </section> <section id="filters.convert"> <title>Filtres de conversion</title> <simpara> Comme pour les filtres de chaînes, les filtres de conversion font ce que leur nom indique. Pour plus d'informations, voyez le manuel de la fonction correspondante. </simpara> <para> <table> <title>Filtres de conversion</title> <tgroup cols="4"> <thead> <row> <entry>Nom</entry> <entry>Fonction &php; équivalente</entry> <entry>Version</entry> <entry>Paramètres</entry> </row> </thead> <tbody> <row> <entry><literal>convert.base64-encode</literal></entry> <entry> <function>base64_encode</function> </entry> <entry><literal>PHP 5.0.0</literal></entry> <entry> Si les paramètres sont fournis sous forme de tableau, <literal>convert.base64-encode</literal> va insérer la valeur de <literal>$parameters['line-break-chars']</literal> tous les <literal>$parameters['line-length']</literal> caractères du texte base64. Cela permet le formatage automatique du résultat, qui peut être fait avec <function>chunk_split</function>. </entry> </row> <row> <entry><literal>convert.base64-decode</literal></entry> <entry> <function>base64_decode</function> </entry> <entry><literal>PHP 5.0.0</literal></entry> <entry>None</entry> </row> <row> <entry><literal>convert.quoted-printable-encode</literal></entry> <entry> None. C'est le contraire du filtre quoted-printable-decode. </entry> <entry><literal>PHP 5.0.0</literal></entry> <entry> <literal>line-break-chars</literal> et <literal>line-length</literal> sont supportés de la même façon que pour <literal>convert.base64-encode</literal>. En plus, les index <literal>binary</literal> et <literal>force-encode-first</literal> sont supportés, avec comme valeur par défaut &false;. </entry> </row> <row> <entry><literal>convert.quoted-printable-decode</literal></entry> <entry> <function>quoted_printable_decode</function> </entry> <entry><literal>PHP 5.0.0</literal></entry> <entry> Si <literal>line-break-chars</literal> est spécifié durant le processus d'encodage, il faut l'indiquer à nouveau ici pour qu'il soit correctement supprimé lors du décodage. </entry> </row> </tbody> </tgroup> </table> </para> </section> </appendix> <!-- 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: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-fr/appendices/license.xml?r=1.1&p=1 Index: phpdoc-fr/appendices/license.xml +++ phpdoc-fr/appendices/license.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <appendix id="opl.license"> <title>Open Publication License</title> La documentation &php; est publiée sous licence <literal>Open Publication License</literal>. Voici le texte de la licence. <simpara>v1.0, 8 June 1999</simpara> <section id="opl.require"> <title>I. REQUIREMENTS ON BOTH UNMODIFIED AND MODIFIED VERSIONS</title> <simpara> The Open Publication works may be reproduced and distributed in whole or in part, in any medium physical or electronic, provided that the terms of this license are adhered to, and that this license or an incorporation of it by reference (with any options elected by the author(s) and/or publisher) is displayed in the reproduction. </simpara> <simpara> Proper form for an incorporation by reference is as follows: </simpara> <para> Copyright (c) &lt;year&gt; by &lt;author's name or designee&gt;. This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, vX.Y or later (the latest version is presently available at <ulink url="&url.opl;">&url.opl;</ulink> </para> <simpara> The reference must be immediately followed with any options elected by the author(s) and/or publisher of the document (see section VI). Commercial redistribution of Open Publication-licensed material is permitted. Any publication in standard (paper) book form shall require the citation of the original publisher and author. The publisher and author's names shall appear on all outer surfaces of the book. On all outer surfaces of the book the original publisher's name shall be as large as the title of the work and cited as possessive with respect to the title. </simpara> </section> <section id="opl.copyright"> <title>II. COPYRIGHT</title> <simpara> The copyright to each Open Publication is owned by its author(s) or designee. </simpara> </section> <section id="opl.scope"> <title>III. SCOPE OF LICENSE</title> <simpara> The following license terms apply to all Open Publication works, unless otherwise explicitly stated in the document. </simpara> <simpara> Mere aggregation of Open Publication works or a portion of an Open Publication work with other works or programs on the same media shall not cause this license to apply to those other works. The aggregate work shall contain a notice specifying the inclusion of the Open Publication material and appropriate copyright notice. </simpara> <simpara> SEVERABILITY. If any part of this license is found to be unenforceable in any jurisdiction, the remaining portions of the license remain in force. </simpara> <simpara> NO WARRANTY. Open Publication works are licensed and provided "as is" without warranty of any kind, express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose or a warranty of non-infringement. </simpara> </section> <section id="opl.modified.works"> <title>IV. REQUIREMENTS ON MODIFIED WORKS</title> <para> All modified versions of documents covered by this license, including translations, anthologies, compilations and partial documents, must meet the following requirements: </para> <para> <orderedlist> <listitem> <simpara> The modified version must be labeled as such. </simpara> </listitem> <listitem> <simpara> The person making the modifications must be identified and the modifications dated. </simpara> </listitem> <listitem> <simpara> Acknowledgement of the original author and publisher if applicable must be retained according to normal academic citation practices. </simpara> </listitem> <listitem> <simpara> The location of the original unmodified document must be identified. </simpara> </listitem> <listitem> <simpara> The original author's (or authors') name(s) may not be used to assert or imply endorsement of the resulting document without the original author's (or authors') permission. </simpara> </listitem> </orderedlist> </para> </section> <section id="opl.good-practice"> <title>V. GOOD-PRACTICE RECOMMENDATIONS</title> <simpara> In addition to the requirements of this license, it is requested from and strongly recommended of redistributors that: </simpara> <para> <orderedlist> <listitem> <simpara> If you are distributing Open Publication works on hardcopy or CD-ROM, you provide email notification to the authors of your intent to redistribute at least thirty days before your manuscript or media freeze, to give the authors time to provide updated documents. This notification should describe modifications, if any, made to the document. </simpara> </listitem> <listitem> <simpara> All substantive modifications (including deletions) be either clearly marked up in the document or else described in an attachment to the document. </simpara> </listitem> <listitem> <simpara> Finally, while it is not mandatory under this license, it is considered good form to offer a free copy of any hardcopy and CD-ROM expression of an Open Publication-licensed work to its author(s). </simpara> </listitem> </orderedlist> </para> </section> <section id="opl.options"> <title>VI. LICENSE OPTIONS</title> <simpara> The author(s) and/or publisher of an Open Publication-licensed document may elect certain options by appending language to the reference to or copy of the license. These options are considered part of the license instance and must be included with the license (or its incorporation by reference) in derived works. </simpara> <simpara> A. To prohibit distribution of substantively modified versions without the explicit permission of the author(s). "Substantive modification" is defined as a change to the semantic content of the document, and excludes mere changes in format or typographical corrections. </simpara> <simpara> To accomplish this, add the phrase `Distribution of substantively modified versions of this document is prohibited without the explicit permission of the copyright holder.' to the license reference or copy. </simpara> <simpara> B. To prohibit any publication of this work or derivative works in whole or in part in standard (paper) book form for commercial purposes is prohibited unless prior permission is obtained from the copyright holder. </simpara> <simpara> To accomplish this, add the phrase 'Distribution of the work or derivative of the work in any standard (paper) book form is prohibited unless prior permission is obtained from the copyright holder.' to the license reference or copy. </simpara> </section> </appendix>
« previous php.doc.fr (#2137) next »