cvs: phpdoc-fr /reference/phar fileformat.xml ini.xml installation.xml

From: Date: Mon, 05 Jan 2009 22:38:19 +0000
Subject: cvs: phpdoc-fr /reference/phar fileformat.xml ini.xml installation.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-6280@lists.php.net to get a copy of this message
gui Mon Jan 5 22:38:19 2009 UTC Added files: /phpdoc-fr/reference/phar ini.xml installation.xml Modified files: /phpdoc-fr/reference/phar fileformat.xml Log: initial translation

http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/fileformat.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-fr/reference/phar/fileformat.xml diff -u phpdoc-fr/reference/phar/fileformat.xml:1.2 phpdoc-fr/reference/phar/fileformat.xml:1.3 --- phpdoc-fr/reference/phar/fileformat.xml:1.2 Mon Jan 5 21:52:30 2009 +++ phpdoc-fr/reference/phar/fileformat.xml Mon Jan 5 22:38:19 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.13 Maintainer: gui Status: partial --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.13 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <chapter xml:id="phar.fileformat" xmlns="http://docbook.org/ns/docbook"> <title>Qu'est-ce qui fait d'un phar un phar et pas un tar ou un zip?</title> @@ -219,73 +219,73 @@ </para> </section> <section xml:id="phar.fileformat.phar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Phar File Format</title> + <title>Le format de fichier Phar</title> <para> - The phar file format is literally laid out as stub/manifest/contents/signature, and - stores the crucial information of what is included in the phar archive in its - <literal>manifest</literal>. + Le format de fichier phar est composé de conteneur/manifeste/contenu/signature, et stocke + les informations cruciales de ce qui est contenu dans l'archive phar dans son + <literal>manifeste</literal>. </para> <para> - The Phar manifest is a highly optimized format that allows per-file - specification of file compression, file permissions, and even user-defined - meta-data such as file user or group. All values greater than 1 byte are stored - in little-endian byte order, with the exception of the API version, which - for historical reasons is stored as 3 nibbles in big-endian order. + Le manifeste Phar est un format hautement optimisé qui permet la spécification fichier par fichier + de la compression, des permissions et même des méta-données utilisateur tels que l'utilisateur ou le + groupe propriétaire. Toutes les valeurs de plus d'un octet sont stockées sous forme petit-boutiste, + à l'exception de la version de l'API qui est stockée pour des raisons historiques en 3 morceaux + grand-boutistes. </para> <para> - All unused flags are reserved for future use, and must not be used - to store custom information. Use the per-file meta-data facility - to store customized information about particular files. + Tous les drapeaux non utilisés sont réservés pour un usage futur et ne doivent pas être utilisés + pour stocker des informations personnalisées. Utilisez les méta-données par fichier pour stocker + des méta-données personnalisées sur des fichiers particuliers. </para> <para> - The basic file format of a Phar archive manifest is as follows: + Le format de fichier basique du manifeste d'une archive Phar est le suivant : </para> <para> <table> - <title>Global Phar manifest format</title> + <title>Format global du manifeste Phar</title> <tgroup cols="2"> <thead> <row> - <entry>Size in bytes</entry> + <entry>Taille en octets</entry> <entry>Description</entry> </row> </thead> <tbody> <row> - <entry>4 bytes</entry> - <entry>Length of manifest in bytes (1 MB limit)</entry> + <entry>4 octets</entry> + <entry>Longueur du manifeste en octets (limitée à 1 Mo)</entry> </row> <row> - <entry>4 bytes</entry> - <entry>Number of files in the Phar</entry> + <entry>4 octets</entry> + <entry>Nombre de fichiers dans le Phar</entry> </row> <row> - <entry>2 bytes</entry> - <entry>API version of the Phar manifest (currently 1.0.0)</entry> + <entry>2 octets</entry> + <entry>Version de l'API du manifest Phar (à ce jour 1.0.0)</entry> </row> <row> - <entry>4 bytes</entry> - <entry>Global Phar bitmapped flags</entry> + <entry>4 octets</entry> + <entry>Drapeaux "bitmappés" globaux du Phar</entry> </row> <row> - <entry>4 bytes</entry> - <entry>Length of Phar alias</entry> + <entry>4 octets</entry> + <entry>Longueur de l'alias Phar</entry> </row> <row> <entry>??</entry> - <entry>Phar alias (length based on previous)</entry> + <entry>L'alias Phar (longueur basée sur la valeur précédente)</entry> </row> <row> - <entry>4 bytes</entry> - <entry>Length of Phar metadata (<literal>0</literal> for none)</entry> + <entry>4 octets</entry> + <entry>Longueur des méta-données Phar (<literal>0</literal> si aucune)</entry> </row> <row> <entry>??</entry> - <entry>Serialized Phar Meta-data, stored in <function>serialize</function> format</entry> + <entry>Méta-données Phar sérialisées, stockées dans un format <function>serialize</function></entry> </row> <row> - <entry>at least 24 * number of entries bytes</entry> - <entry>entries for each file</entry> + <entry>au moins 24 * nombre d'octets des entrées</entry> + <entry>Entrées pour chaque fichier</entry> </row> </tbody> </tgroup> @@ -293,38 +293,38 @@ </para> </section> <section xml:id="phar.fileformat.flags" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Global Phar bitmapped flags</title> + <title>Drapeaux "bitmappés" globaux du Phar</title> <para> - Here are the bitmapped flags currently recognized by the Phar extension - for the global Phar flat bitmap: + Voici les drapeaux "bitmappés" actuellement reconnus par l'extension Phar + pour le bitmap plein global de Phar : </para> <para> <table> - <title>Bitmap values recognized</title> + <title>Valeurs de bitmap reconnues</title> <tgroup cols="2"> <thead> <row> - <entry>Value</entry> + <entry>Valeur</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry><literal>0x00010000</literal></entry> - <entry>If set, this Phar contains a verification signature</entry> + <entry>Si présent, le Phar contient une signature de vérification</entry> </row> <row> <entry><literal>0x00001000</literal></entry> <entry> - If set, this Phar contains at least 1 file that - is compressed with zlib compression + Si présent, le Phar contient au moins 1 fichier qui est + compressé grâce à zlib </entry> </row> <row> <entry><literal>0x00002000</literal></entry> <entry> - If set, this Phar contains at least 1 file that - is compressed with bzip compression + Si présent, le Phar contient au moins 1 fichier qui est + compressé grâce à bzip </entry> </row> </tbody> @@ -333,75 +333,75 @@ </para> </section> <section xml:id="phar.fileformat.manifestfile" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Phar manifest file entry definition</title> + <title>Définition des entrées du manifeste Phar</title> <para> - Each file in the manifest contains the following information: + Chaque fichier du manifeste contient les informations suivantes : </para> <para> <table> - <title>Phar Manifest file entry</title> + <title>Entrée du manifeste Phar</title> <tgroup cols="2"> <thead> <row> - <entry>Size in bytes</entry> + <entry>Taille en octets</entry> <entry>Description</entry> </row> </thead> <tbody> <row> - <entry>4 bytes</entry> - <entry>Filename length in bytes</entry> + <entry>4 octets</entry> + <entry>Longueur du nom de fichier en octets</entry> </row> <row> <entry>??</entry> - <entry>Filename (length specified in previous)</entry> + <entry>Nom de fichier (longueur basée sur la valeur précédente)</entry> </row> <row> - <entry>4 bytes</entry> - <entry>Un-compressed file size in bytes</entry> + <entry>4 octets</entry> + <entry>Taille du fichier décompressé en octets</entry> </row> <row> - <entry>4 bytes</entry> - <entry>Unix timestamp of file</entry> + <entry>4 octets</entry> + <entry>Timestamp Unix du fichier</entry> </row> <row> - <entry>4 bytes</entry> - <entry>Compressed file size in bytes</entry> + <entry>4 octets</entry> + <entry>Taille du fichier compressé en octets</entry> </row> <row> - <entry>4 bytes</entry> - <entry>CRC32 checksum of un-compressed file contents</entry> + <entry>4 octets</entry> + <entry>Somme de contrôle CRC32 du contenu décompressé du fichier</entry> </row> <row> - <entry>4 bytes</entry> - <entry>Bit-mapped File-specific flags</entry> + <entry>4 octets</entry> + <entry>Drapeaux bitmappés spécifiques au fichier</entry> </row> <row> - <entry>4 bytes</entry> - <entry>Serialized File Meta-data length (<literal>0</literal> for none)</entry> + <entry>4 octets</entry> + <entry>Longueur des méta-données du fichier sérialisées (<literal>0</literal> si aucune)</entry> </row> <row> <entry>??</entry> - <entry>Serialized File Meta-data, stored in <function>serialize</function> format</entry> + <entry>Méta-données du fichier sérialisées, stockées dans un format <function>serialize</function></entry> </row> </tbody> </tgroup> </table> </para> <para> - Note that as of API version 1.1.1, empty directories are stored as filenames - with a trailing slash like <literal>my/directory/</literal> + A noter qu'à partir de l'API 1.1.1, les répertoires vides sont stockés comme des noms de fichier + avec un slash final comme <literal>mon/repertoire/</literal> </para> <para> - The File-specific bitmap values recognized are: + Les valeur reconnues de drapeaux bitmappés spécifiques au fichier sont : </para> <para> <table> - <title>Bitmap values recognized</title> + <title>Valeurs reconnues de bitmap</title> <tgroup cols="2"> <thead> <row> - <entry>Value</entry> + <entry>Valeur</entry> <entry>Description</entry> </row> </thead> @@ -409,21 +409,21 @@ <row> <entry><literal>0x000001FF</literal></entry> <entry> - These bits are reserved for defining specific file permissions - of a file. Permissions are used for <function>fstat</function> - and can be used to recreate desired permissions upon extraction. + Ces bits sont réservés pour définir des permissions spécifiques au fichier. + Celles-ci sont utilisées pour <function>fstat</function> + et peuvent être utilisées pour recréer les permissions souhaitées en cas d'extraction. </entry> </row> <row> <entry><literal>0x00001000</literal></entry> <entry> - If set, this file is compressed with zlib compression + Si présent, le fichier est compressé grâce à zlib </entry> </row> <row> <entry><literal>0x00002000</literal></entry> <entry> - If set, this file is compressed with bzip compression + Si présent, le fichier est compressé grâce à bzip </entry> </row> </tbody> @@ -434,44 +434,43 @@ <section xml:id="phar.fileformat.signature" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Phar Signature format</title> <para> - Phars containing a signature always have the signature appended to the - end of the Phar archive after the loader, manifest, and file contents. - The two signature formats supported at this time are MD5 and SHA1. + Les Phar qui contiennent une signature ont toujours la signature ajoutée à la fin du Phar, + après le chargeur, le manifeste et le contenu. + Les deux types de signature supportés à ce jour sont MD5 et SHA1. </para> <para> <table> - <title>Signature format</title> + <title>Format de signature</title> <tgroup cols="2"> <thead> <row> - <entry>Length in bytes</entry> + <entry>Longueur en octets</entry> <entry>Description</entry> </row> </thead> <tbody> <row> - <entry>16 or 20 bytes</entry> + <entry>16 ou 20 octets</entry> <entry> - The actual signature, 20 bytes for an SHA1 signature, - 16 bytes for an MD5 signature, 32 bytes for an SHA256 signature, - and 64 bytes for an SHA512 signature. + La signature actuelle, 20 octets pour une SHA1, + 16 octets pour une MD5, 32 octets pour une SHA256, + et 64 octets pour une SHA512. </entry> </row> <row> - <entry>4 bytes</entry> + <entry>4 octets</entry> <entry> - Signature flags. <literal>0x0001</literal> is used to - define an MD5 signature, <literal>0x0002</literal> is used - to define an SHA1 signature, <literal>0x0004</literal> is used - to define an SHA256 signature, and <literal>0x0008</literal> is - used to define an SHA512 signature. The SHA256 and SHA512 signature - support was introduced with API version 1.1.0. + Les drapeaux de signature. <literal>0x0001</literal> est utilisé pour + définir une signature MD5, <literal>0x0002</literal> pour une SHA1, + <literal>0x0004</literal> pour une SHA256 et <literal>0x0008</literal> + pour une SHA512. Le support des signatures SHA256 et SHA512 a été introduit + avec l'API version 1.1.0. </entry> </row> <row> - <entry>4 bytes</entry> + <entry>4 octets</entry> <entry> - Magic <literal>GBMB</literal> used to define the presence of a signature. + <literal>GBMB</literal> magique utilisé pour définir la présence d'une signature. </entry> </row> </tbody> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/ini.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/ini.xml +++ phpdoc-fr/reference/phar/ini.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.9 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <section xml:id="phar.configuration" xmlns="http://docbook.org/ns/docbook"> &reftitle.runtime; &extension.runtime; <para> <table> <title>Options de configuration des flux et systèmes de fichiers</title> <tgroup cols="4"> <thead> <row> <entry>Nom</entry> <entry>Valeur par défaut</entry> <entry>Modifiable</entry> <entry>Journal des changements</entry> </row> </thead> <tbody> <row> <entry>phar.readonly</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> <entry></entry> </row> <row> <entry>phar.require_hash</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> <entry></entry> </row> <row> <entry>phar.extract_list</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> <entry>Disponible de phar 1.1.0 à 1.2.3, supprimé en 2.0.0.</entry> </row> <row> <entry>phar.cache_list</entry> <entry>""</entry> <entry>PHP_INI_SYSTEM</entry> <entry>Disponible à partir de phar 2.0.0.</entry> </row> </tbody> </tgroup> </table> </para> &ini.descriptions.title; <para> <variablelist> <varlistentry xml:id="ini.phar.readonly"> <term> <parameter>phar.readonly</parameter> <type>boolean</type> </term> <listitem> <para> Cette option désactive la création ou la modification des archives Phar en utilisant le flux <literal>phar</literal> ou le support en écriture sur les objets <classname>Phar</classname>. Ce paramètre devrait toujours être activé sur des machines de production, car le support en écriture sur les archives phar pourrait mener à la création de virus basés sur PHP en cas d'utilisation conjuguée avec des vulnérabilités communes. </para> <note> <para> Ce paramètre ne peut être désactivé que dans php.ini pour des raisons de sécurité. Si <literal>phar.readonly</literal> est désactivé dans php.ini, l'utilisateur peut activer <literal>phar.readonly</literal> dans un script ou le désactiver plus tard. Si <literal>phar.readonly</literal> est activé dans php.ini, un script pourrait &quot;réactiver&quot; sans danger la variable INI, mais ne pourrait pas la désactiver. </para> </note> </listitem> </varlistentry> <varlistentry xml:id="ini.phar.require-hash"> <term> <parameter>phar.require_hash</parameter> <type>boolean</type> </term> <listitem> <para> Cette option forcera toutes les archives Phar ouvertes à contenir un type de signature (à ce jour MD5, SHA1, SHA256 et SHA512 sont supportés), et toute archive Phar ne contenant pas de signature sera rejetée. </para> <note> <para> Ce paramètre ne peut être désactivé que dans php.ini pour des raisons de sécurité. Si <literal>phar.require_hash</literal> est désactivé dans php.ini, l'utilisateur peut activer <literal>phar.require_hash</literal> dans un script ou le désactiver plus tard. Si <literal>phar.require_hash</literal> est activé dans php.ini, un script pourrait &quot;réactiver&quot; sans danger la variable INI, mais ne pourrait pas la désactiver. </para> </note> </listitem> </varlistentry> <varlistentry xml:id="ini.phar.extract-list"> <term> <parameter>phar.extract_list</parameter> <type>string</type> </term> <listitem> <para> Ce paramètre INI a été supprimé en phar 2.0.0. </para> <para> Permet la correspondance entre le chemin complet d'une archive phar ou son alias et l'emplacement de ses fichiers extraits. Le format de ce paramètre est <literal>name=archive,name2=archive2</literal>. Cela permet l'extraction de fichiers phar sur le disque, et permet à phar d'agir comme une sorte de correspondance vers des fichiers extraits sur disque. C'est souvent utilisé pour des raisons de performance ou pour aider au débogage de phar. <example> <title>exemple d'utilisation de phar.extract_list</title> <programlisting role="php"> <![CDATA[ dans php.ini: phar.extract_list = archive=/chemin/complet/vers/archive/,arch2=/chemin/complet/vers/arch2 <?php include "phar://archive/content.php"; include "phar://arch2/foo.php"; ?> ]]> </programlisting> </example> </para> </listitem> </varlistentry> <varlistentry xml:id="ini.phar.cache-list"> <term> <parameter>phar.cache_list</parameter> <type>string</type> </term> <listitem> <para> Ce paramètre INI a été ajouté en phar 2.0.0 </para> <para> Permet aux correspondances d'archives phar d'être traitées au démarrage du serveur web, augmentant de ce fait les performance d'accès aux fichiers contenus dans une archive phar et les rendant très proche d'un accès à des fichiers d'une installation classique sur disque. <example> <title>exemple d'utilisation de phar.cache_list</title> <programlisting role="php"> <![CDATA[ dans php.ini (windows): phar.cache_list =C:\chemin\vers\phar1.phar;C:\chemin\vers\phar2.phar dans php.ini (unix): phar.cache_list =/chemin/vers/phar1.phar:/chemin/vers/phar2.phar ]]> </programlisting> </example> </para> </listitem> </varlistentry> </variablelist> </para> </section> <!-- 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/viewvc.cgi/phpdoc-fr/reference/phar/installation.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/installation.xml +++ phpdoc-fr/reference/phar/installation.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <section xml:id="phar.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.install; <simpara> &pecl.info; <link xlink:href="&url.pecl.package;phar">&url.pecl.package;phar</link>. </simpara> <simpara> Pour une installation sous Windows, suivez les extensions ci-dessus, modifiez votre php.ini et redémarrez votre serveur web. </simpara> <screen> <![CDATA[ extension_dir=c:/php5/exts/ extension=php_phar.dll ;; optional extensions extension=php_bz2.dll ]]> </screen> </section> <!-- 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 -->
« previous php.doc.fr (#6280) next »