cvs: phpdoc-fr /reference/phar Phar.xml book.xml constants.xml creating.xml entities.Phar.xml fileformat.xml
| From: | Mickael PERRAUD | Date: | Mon, 05 Jan 2009 21:52:31 +0000 |
| Subject: | cvs: phpdoc-fr /reference/phar Phar.xml book.xml constants.xml creating.xml entities.Phar.xml fileformat.xml | ||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-6279@lists.php.net to get a copy of this message | ||
mikaelkael Mon Jan 5 21:52:31 2009 UTC
Removed files:
/phpdoc-fr/reference/phar entities.Phar.xml
Modified files:
/phpdoc-fr/reference/phar Phar.xml book.xml constants.xml
creating.xml fileformat.xml
Log:
review - change encoding and remove unnecessary file
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/Phar.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/phar/Phar.xml diff -u phpdoc-fr/reference/phar/Phar.xml:1.1 phpdoc-fr/reference/phar/Phar.xml:1.2 --- phpdoc-fr/reference/phar/Phar.xml:1.1 Mon Jan 5 18:16:01 2009 +++ phpdoc-fr/reference/phar/Phar.xml Mon Jan 5 21:52:30 2009 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.1 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.2 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> @@ -17,7 +17,7 @@ <section xml:id="Phar.intro"> &reftitle.intro; <para> - La classe Phar fournit une interface de haut niveau pour accéder et créer + La classe Phar fournit une interface de haut niveau pour accéder et créer des archives phar. </para> </section> @@ -50,12 +50,12 @@ </classsynopsisinfo> <!-- }}} --> - <classsynopsisinfo role="comment">Propriétés</classsynopsisinfo> + <classsynopsisinfo role="comment">Propriétés</classsynopsisinfo> - <classsynopsisinfo role="comment">Méthodes</classsynopsisinfo> + <classsynopsisinfo role="comment">Méthodes</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.Phar')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> -<!-- <classsynopsisinfo role="comment">Méthodes héritées</classsynopsisinfo> +<!-- <classsynopsisinfo role="comment">Méthodes héritées</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.DirectoryIterator')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> --> </classsynopsis> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/book.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/phar/book.xml diff -u phpdoc-fr/reference/phar/book.xml:1.1 phpdoc-fr/reference/phar/book.xml:1.2 --- phpdoc-fr/reference/phar/book.xml:1.1 Mon Jan 5 18:16:01 2009 +++ phpdoc-fr/reference/phar/book.xml Mon Jan 5 21:52:30 2009 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.1 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.2 $ --> <!-- Purpose: compression --> <!-- Membership: pecl --> <!-- EN-Revision: 1.7 Maintainer: gui Status: ready --> @@ -12,27 +12,27 @@ <preface xml:id="intro.phar"> &reftitle.intro; <para> - L'extension phar fournit un moyen de mettre une application PHP complète dans un fichier unique - appelé un "phar" (PHP Archive) pour une installation et une configuration aisées. + L'extension phar fournit un moyen de mettre une application PHP complète dans un fichier unique + appelé un "phar" (PHP Archive) pour une installation et une configuration aisées. En plus de ce service, l'extension fournit aussi une classe d'abstractiond e format de fichier - pour créer et manipuler des fichiers tar et zip à travers la classe + pour créer et manipuler des fichiers tar et zip à travers la classe <classname>PharData</classname>, tout comme - PDO fournit une interface unifiée pour accéder à des base de données différentes. Mais à l'inverse de PDO, - qui ne peut pas transposer les données d'une base à l'autre, Phar a la possbilité de convertir des fichiers tar, + PDO fournit une interface unifiée pour accéder à des base de données différentes. Mais à l'inverse de PDO, + qui ne peut pas transposer les données d'une base à l'autre, Phar a la possbilité de convertir des fichiers tar, zip et phar avec une simple ligne de code. Regardez <function>Phar::convertToExecutable</function> pour avoir un exemple. </para> <para> Qu'est-ce que phar? Les archives phar sont en fait un moyen pratique de grouper plusieurs fichiers en un seul. Ainsi, une archive phar permet de distribuer une - application PHP complète dans un fichier unique et de l'exécuter à partir de ce fichier - sans pour autant l'extraire sur le disque. De plus, des archives phar peuvent être exécutées + application PHP complète dans un fichier unique et de l'exécuter à partir de ce fichier + sans pour autant l'extraire sur le disque. De plus, des archives phar peuvent être exécutées par PHP aussi facilement que n'importe quel autre fichier, aussi bien en ligne de commande que via - un serveur web. Phar est une sorte de clé USB pour les applications PHP. + un serveur web. Phar est une sorte de clé USB pour les applications PHP. </para> <para> - Phar implémente cette fonctionalité via <link linkend="book.stream">un - flux</link>. Normalement, pour utiliser un fichier externe à partir d'un script PHP, vous + Phar implémente cette fonctionalité via <link linkend="book.stream">un + flux</link>. Normalement, pour utiliser un fichier externe à partir d'un script PHP, vous devez utiliser la fonction <function>include</function> </para> <para> @@ -48,16 +48,16 @@ </example> </para> <para> - On peut considérer que PHP traduit en fait + On peut considérer que PHP traduit en fait <literal>/chemin/vers/le/fichier/externe.php</literal> en un flux <literal>file:///chemin/vers/le/fichier/externe.php</literal>, et qu'il - utilise de façon cachée les fonctions de flux de fichiers plats pour accéder - à des fichiers locaux. + utilise de façon cachée les fonctions de flux de fichiers plats pour accéder + à des fichiers locaux. </para> <para> - Pour utiliser un fichier nommé <literal>fichier.php</literal> contenu dans une archive phar + Pour utiliser un fichier nommé <literal>fichier.php</literal> contenu dans une archive phar <literal>/chemin/vers/monphar.phar</literal>, - la syntaxe est quasi similaire à la syntaxe <literal>file://</literal> ci-dessus. + la syntaxe est quasi similaire à la syntaxe <literal>file://</literal> ci-dessus. </para> <para> <example> @@ -73,34 +73,34 @@ </para> <para> En fait, on peut traiter une archive phar comme s'il s'agissait d'un disque externe, en utilisant - n'importe laquelle des fonctions relatives à <function>fopen</function>, <function>opendir</function> et - <function>mkdir</function> pour lire, changer ou créer des nouveaux fichiers ou répertoires au sein de - l'archive phar. Celà permet à des applications PHP complètes d'être distribuées dans un seul fichier - et d'être exécutées à partir de celui-ci + n'importe laquelle des fonctions relatives à <function>fopen</function>, <function>opendir</function> et + <function>mkdir</function> pour lire, changer ou créer des nouveaux fichiers ou répertoires au sein de + l'archive phar. Celà permet à des applications PHP complètes d'être distribuées dans un seul fichier + et d'être exécutées à partir de celui-ci </para> <para> - L'utilisation la plus courant d'une archive phar est de distribuer une application complète + L'utilisation la plus courant d'une archive phar est de distribuer une application complète en un seul fichier. Par exemple, l'installeur PEAR qui est inclus avec les versions de PHP - est distribué grâce à une archive phar. pour utiliser l'archive phar ainsi distribuée, celle-ci - peut-être exécutée via la ligne de commande ou via un navigateur web. + est distribué grâce à une archive phar. pour utiliser l'archive phar ainsi distribuée, celle-ci + peut-être exécutée via la ligne de commande ou via un navigateur web. </para> <para> - Les archives phar peuvent être distribuées sous forme de fichiers <literal>tar</literal>, - de fichiers <literal>zip</literal> ou de fichiers <literal>phar</literal> spécialement conçus - pour l'extensions phar. Chaque format de fichier a ses avantages et ses inconvénients. Les fichiers - zip et tar peuvent être extraits par n'importe quel outil tiers qui peut lire le format, mais - requièrent l'extension phar pour être exécutés par PHP. Le format de fichier phar est unique et dédié - à l'extension phar et peut être créé uniquement par celle-ci ou par le paquet PEAR + Les archives phar peuvent être distribuées sous forme de fichiers <literal>tar</literal>, + de fichiers <literal>zip</literal> ou de fichiers <literal>phar</literal> spécialement conçus + pour l'extensions phar. Chaque format de fichier a ses avantages et ses inconvénients. Les fichiers + zip et tar peuvent être extraits par n'importe quel outil tiers qui peut lire le format, mais + requièrent l'extension phar pour être exécutés par PHP. Le format de fichier phar est unique et dédié + à l'extension phar et peut être créé uniquement par celle-ci ou par le paquet PEAR <link xlink:href="http://pear.php.net/PHP_Archive">PHP_Archive</link>, mais a l'avantage de ne pas - nécessiter l'installation de l'extension phar pour que l'application empaquetée puisse être exécutée. + nécessiter l'installation de l'extension phar pour que l'application empaquetée puisse être exécutée. </para> <para> - En d'autres mots, même avec l'extension phar désactivée, il est possible d'exécuter ou d'inclure - une archive basée sur phar. Accéder à des fichiers individuels au sein d'une archive phar n'est - possible qu'avec l'extension phar à moins quel'archive phar n'ait été créée par PHP_Archive. + En d'autres mots, même avec l'extension phar désactivée, il est possible d'exécuter ou d'inclure + une archive basée sur phar. Accéder à des fichiers individuels au sein d'une archive phar n'est + possible qu'avec l'extension phar à moins quel'archive phar n'ait été créée par PHP_Archive. </para> <para> - L'extension phar est aussi capable de convertir une archive phar à partir d'un tar vers un fichier zip + L'extension phar est aussi capable de convertir une archive phar à partir d'un tar vers un fichier zip ou phar en une seule commande : </para> <para> @@ -117,41 +117,41 @@ </example> </para> <para> - Phar peut compresser des fichiers individuels ou une archive entière en + Phar peut compresser des fichiers individuels ou une archive entière en utilisant la compression <link linkend="book.zlib">gzip</link> ou - <link linkend="book.bzip2">bzip2</link>, et peut vérifier l'intégrité de l'archive + <link linkend="book.bzip2">bzip2</link>, et peut vérifier l'intégrité de l'archive automatiquement en utilisant des fonctions de signature <function>md5</function>, <function>sha1</function>, <function>sha256</function>, ou <function>sha512</function>. </para> <para> - Enfin, l'extension phar est orientée sécurité, elle désactive par défaut les accès - en écriture sur les archives phar exécutables et requiert la désactivation au niveau système - du paramètre <literal>phar.readonly</literal> du php.ini pour créer ou modifier des archives phar. - Des archives tar et zip sans le marqueur exécutable peuvent toujours être créées ou modifiées + Enfin, l'extension phar est orientée sécurité, elle désactive par défaut les accès + en écriture sur les archives phar exécutables et requiert la désactivation au niveau système + du paramètre <literal>phar.readonly</literal> du php.ini pour créer ou modifier des archives phar. + Des archives tar et zip sans le marqueur exécutable peuvent toujours être créées ou modifiées en utilisant la classe <classname>PharData</classname>. </para> <para> - Si vous créez des applications dans le but de les distribuer, vous devriez lire - <link linkend="phar.creating">Comment créer des archives Phar</link>. Si vous voulez - davantage d'informations sur les différences entre les formats de fichier que phar supporte, + Si vous créez des applications dans le but de les distribuer, vous devriez lire + <link linkend="phar.creating">Comment créer des archives Phar</link>. Si vous voulez + davantage d'informations sur les différences entre les formats de fichier que phar supporte, vous devriez lire <link linkend="phar.fileformat">Phar, Tar et Zip</link>. </para> <para> - Si vous utilisez des applications phar, il y a des astuces très utiles dans + Si vous utilisez des applications phar, il y a des astuces très utiles dans <link linkend="phar.using">Comment utiliser des archives Phar</link> </para> <para> Le mot <literal>phar</literal> est la contraction de <literal>PHP</literal> et de - <literal>Archive</literal> et est grandement inspiré - du mot <literal>jar</literal> (Java Archive) familier aux développeurs Java. + <literal>Archive</literal> et est grandement inspiré + du mot <literal>jar</literal> (Java Archive) familier aux développeurs Java. </para> <para> - L'implémentation des archives Phar est basée sur le paquet PEAR + L'implémentation des archives Phar est basée sur le paquet PEAR <link xlink:href="http://pear.php.net/PHP_Archive">PHP_Archive</link>, et - les détails d'implémentations sont les mêmes, bien que l'extension Phar - soit plus puissante. En plus, celle-ci permet à la plupart des applications - PHP d'être exécutées sans modification alors que les archves basées sur PHP_Archive - requièrent souvent beaucoup de modification pour fonctionner. + les détails d'implémentations sont les mêmes, bien que l'extension Phar + soit plus puissante. En plus, celle-ci permet à la plupart des applications + PHP d'être exécutées sans modification alors que les archves basées sur PHP_Archive + requièrent souvent beaucoup de modification pour fonctionner. </para> </preface> <!-- }}} --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/constants.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/phar/constants.xml diff -u phpdoc-fr/reference/phar/constants.xml:1.1 phpdoc-fr/reference/phar/constants.xml:1.2 --- phpdoc-fr/reference/phar/constants.xml:1.1 Mon Jan 5 18:16:01 2009 +++ phpdoc-fr/reference/phar/constants.xml Mon Jan 5 21:52:30 2009 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.1 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.2 $ --> <!-- EN-Revision: 1.5 Maintainer: gui Status: ready --> <!-- Reviewed: no --> @@ -31,7 +31,7 @@ (<type>integer</type>) </entry> <entry>0x0000F000</entry> - <entry>masque de bits pouvant être utilisé avec les drapeaux de fichier pour déterminer si une compression est utilisée</entry> + <entry>masque de bits pouvant être utilisé avec les drapeaux de fichier pour déterminer si une compression est utilisée</entry> </row> <row> <entry> @@ -69,7 +69,7 @@ (<type>integer</type>) </entry> <entry>0</entry> - <entry>Conserve le même format de fichier</entry> + <entry>Conserve le même format de fichier</entry> </row> <row> <entry> @@ -147,14 +147,14 @@ (<type>integer</type>) </entry> <entry>0x0010</entry> - <entry>signature avec une paire de clé privée/publique OpenSSL. C'est une véritable - signature à clé asymétrique/</entry> + <entry>signature avec une paire de clé privée/publique OpenSSL. C'est une véritable + signature à clé asymétrique/</entry> </row> </tbody> </tgroup> </table> <table> - <title>Les constantes d'écrasement de mime Phar webPhar</title> + <title>Les constantes d'écrasement de mime Phar webPhar</title> <tgroup cols="3"> <thead> <row> @@ -170,9 +170,9 @@ (<type>integer</type>) </entry> <entry>1</entry> - <entry>utilisée pour renseigner le paramètre d'écrasement mime + <entry>utilisée pour renseigner le paramètre d'écrasement mime de <function>Phar::webPhar</function> et faire en sorte que l'extension - soit parsée comme un fichier PHP</entry> + soit parsée comme un fichier PHP</entry> </row> <row> <entry> @@ -180,9 +180,9 @@ (<type>integer</type>) </entry> <entry>2</entry> - <entry>utilisée pour renseigner le paramètre d'écrasement mime + <entry>utilisée pour renseigner le paramètre d'écrasement mime de <function>Phar::webPhar</function> et faire en sorte que l'extension - soit parsée comme un fichier PHP via <function>highlight_file</function></entry> + soit parsée comme un fichier PHP via <function>highlight_file</function></entry> </row> </tbody> </tgroup> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/creating.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/phar/creating.xml diff -u phpdoc-fr/reference/phar/creating.xml:1.1 phpdoc-fr/reference/phar/creating.xml:1.2 --- phpdoc-fr/reference/phar/creating.xml:1.1 Mon Jan 5 18:16:01 2009 +++ phpdoc-fr/reference/phar/creating.xml Mon Jan 5 21:52:30 2009 @@ -1,26 +1,26 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <chapter xml:id="phar.creating" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Créer des archives Phar</title> + <title>Créer des archives Phar</title> <section xml:id="phar.creating.intro" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Créer des archives Phar : Introduction</title> + <title>Créer des archives Phar : Introduction</title> <para> - Sera entièrement écrit plus tard. Avant de lire ceci, soyez sûr de lire + Sera entièrement écrit plus tard. Avant de lire ceci, soyez sûr de lire <link linkend="phar.using">Comment utiliser des archives Phar</link>. </para> <para> - Se documenter sur <function>Phar::buildFromIterator</function> et les spécificités des choix de - <link linkend="phar.fileformat">format de fichier</link> disponible pour les archives peut être - un bon début. Une bonne compréhension de ce qu'est et de ce que fait un conteneur (stub) est - cruciale pour la création d'archive phar, ce qui fait de <function>Phar::setStub</function> et - <function>Phar::createDefaultStub</function> également un bon point de départ. - Si vous distribuer des applications web, il est important de connaître - <function>Phar::webPhar</function> et la méthode associée - <function>Phar::mungServer</function>. Toute application qui accède à ses propres fichiers - devrait aussi considérer l'utilisation de <function>Phar::interceptFileFuncs</function>. + Se documenter sur <function>Phar::buildFromIterator</function> et les spécificités des choix de + <link linkend="phar.fileformat">format de fichier</link> disponible pour les archives peut être + un bon début. Une bonne compréhension de ce qu'est et de ce que fait un conteneur (stub) est + cruciale pour la création d'archive phar, ce qui fait de <function>Phar::setStub</function> et + <function>Phar::createDefaultStub</function> également un bon point de départ. + Si vous distribuer des applications web, il est important de connaître + <function>Phar::webPhar</function> et la méthode associée + <function>Phar::mungServer</function>. Toute application qui accède à ses propres fichiers + devrait aussi considérer l'utilisation de <function>Phar::interceptFileFuncs</function>. </para> </section> </chapter> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/fileformat.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/phar/fileformat.xml diff -u phpdoc-fr/reference/phar/fileformat.xml:1.1 phpdoc-fr/reference/phar/fileformat.xml:1.2 --- phpdoc-fr/reference/phar/fileformat.xml:1.1 Mon Jan 5 18:16:01 2009 +++ phpdoc-fr/reference/phar/fileformat.xml Mon Jan 5 21:52:30 2009 @@ -1,25 +1,25 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- EN-Revision: 1.13 Maintainer: gui Status: partial --> <!-- 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> <section xml:id="phar.fileformat.ingredients" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Les ingrédients de toutes les archives Phar, indépendemment du format de fichier</title> + <title>Les ingrédients de toutes les archives Phar, indépendemment du format de fichier</title> <para> - Toute les archives Phar contiennent de trois à quatre sections: + Toute les archives Phar contiennent de trois à quatre sections: <orderedlist> <listitem> <para>un conteneur</para> </listitem> <listitem> - <para>un manifest décrivant le contenu</para> + <para>un manifest décrivant le contenu</para> </listitem> <listitem> <para>Le contenu du fichier</para> </listitem> <listitem> - <para>une signature (factultative) pour vérifier l'intégrité (uniquement avec le format de fichier phar)</para> + <para>une signature (factultative) pour vérifier l'intégrité (uniquement avec le format de fichier phar)</para> </listitem> </orderedlist> </para> @@ -36,7 +36,7 @@ </para> <para> Un conteneur doit contenir au moins le jeton <literal>__HALT_COMPILER();</literal> en guise - de conclusion. Typiquement, un conteneur comportera les fonctionnalités de chargement suivantes : + de conclusion. Typiquement, un conteneur comportera les fonctionnalités de chargement suivantes : like so: </para> <para> @@ -50,34 +50,34 @@ </programlisting> </para> <para> - Il n'y a aucune restriction sur le contenu d'un conteneur Phar, si ce n'est le besoin d'être conclus - par <literal>__HALT_COMPILER();</literal>. Le tag fermant PHP <literal><![CDATA[?>]]></literal> peut être + Il n'y a aucune restriction sur le contenu d'un conteneur Phar, si ce n'est le besoin d'être conclus + par <literal>__HALT_COMPILER();</literal>. Le tag fermant PHP <literal><![CDATA[?>]]></literal> peut être inclus ou omis, mais il ne peut y avoir plus d'un espace entre le <literal>;</literal> et le tag fermant <literal><![CDATA[?>]]></literal> sans quoi l'extension phar ne sera pas capable de lire le manifeste de l'archive. </para> <para> - Dans une archive phar basée sur tar ou zip, le conteneur est stocké dans le fichier - <literal>.phar/stub.php</literal>. Le conteneur par défaut des archives Phar basées sur - phar contient approximativement 7k de code pour extraire le contenu du phar et l'exécuter. - Regardez la fonction <function>Phar::createDefaultStub</function> pour davantage de détails. + Dans une archive phar basée sur tar ou zip, le conteneur est stocké dans le fichier + <literal>.phar/stub.php</literal>. Le conteneur par défaut des archives Phar basées sur + phar contient approximativement 7k de code pour extraire le contenu du phar et l'exécuter. + Regardez la fonction <function>Phar::createDefaultStub</function> pour davantage de détails. </para> <para> - L'alias phar est stocké, dans le cas d'une archive phar basée sur tar ou zip, dans le fichier + L'alias phar est stocké, dans le cas d'une archive phar basée sur tar ou zip, dans le fichier <literal>.phar/alias.txt</literal> en tant que texte plein. </para> </section> <section xml:id="phar.fileformat.comparison" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Comparaison entre Phar, Tar et Zip</title> <para> - Quels sont les avantages et les inconvénients de chacun des trois formats supportés - par l'extension phar? Ce tableau tente de répondre à cette question. + Quels sont les avantages et les inconvénients de chacun des trois formats supportés + par l'extension phar? Ce tableau tente de répondre à cette question. <table> - <title>Tableau de fonctionnalités : Phar vs. Tar vs. Zip</title> + <title>Tableau de fonctionnalités : Phar vs. Tar vs. Zip</title> <tgroup cols="4"> <thead> <row> - <entry>Fonctionnalité</entry> + <entry>Fonctionnalité</entry> <entry>Phar</entry> <entry>Tar</entry> <entry>Zip</entry> @@ -91,7 +91,7 @@ <entry>Oui</entry> </row> <row> - <entry>Peut être exécuté sans l'extension Phar + <entry>Peut être exécuté sans l'extension Phar <link linkend="phar.fileformat.phartip">[1]</link> </entry> <entry>Oui</entry> @@ -117,25 +117,25 @@ <entry>Non</entry> </row> <row> - <entry>Support d'applications spécifiquement Web</entry> + <entry>Support d'applications spécifiquement Web</entry> <entry>Oui</entry> <entry>Oui</entry> <entry>Oui</entry> </row> <row> - <entry>Meta-données par fichier</entry> + <entry>Meta-données par fichier</entry> <entry>Oui</entry> <entry>Oui</entry> <entry>Oui</entry> </row> <row> - <entry>Meta-données pour toute l'archive</entry> + <entry>Meta-données pour toute l'archive</entry> <entry>Oui</entry> <entry>Oui</entry> <entry>Oui</entry> </row> <row> - <entry>Création/modification d'archive + <entry>Création/modification d'archive <link linkend="phar.fileformat.phartip2">[2]</link> </entry> <entry>Oui</entry> @@ -149,7 +149,7 @@ <entry>Oui</entry> </row> <row> - <entry>Peut être créée/modifiée même si phar.readonly=1 + <entry>Peut être créée/modifiée même si phar.readonly=1 <link linkend="phar.fileformat.phartip3">[3]</link> </entry> <entry>Non</entry> @@ -163,20 +163,20 @@ <para xml:id="phar.fileformat.phartip"> <tip> <para> - [1] PHP ne peut accéder directement au contenu d'une archive Phar sans que l'extension - Phar soit installée si elle utilise un <literal>conteneur</literal> + [1] PHP ne peut accéder directement au contenu d'une archive Phar sans que l'extension + Phar soit installée si elle utilise un <literal>conteneur</literal> qui extrait le contenu de l'archive phar. Le conteneur - créé par <function>Phar::createDefaultStub</function> extrait - l'archive phar et exécute son contenu à partir d'un répertoire temporaire si - aucune extension phar n'est trouvée. + créé par <function>Phar::createDefaultStub</function> extrait + l'archive phar et exécute son contenu à partir d'un répertoire temporaire si + aucune extension phar n'est trouvée. </para> </tip> </para> <para xml:id="phar.fileformat.phartip2"> <tip> <para> - [2] Toute les accès en écriture nécessite que <literal>phar.readonly</literal> soit - désactivé dans le php.ini ou directement via la ligne de commande. + [2] Toute les accès en écriture nécessite que <literal>phar.readonly</literal> soit + désactivé dans le php.ini ou directement via la ligne de commande. </para> </tip> </para> @@ -184,37 +184,37 @@ <tip> <para> [3] Seules les archives tar ou zip sans <literal>.phar</literal> dans leur - nom et sans conteneur exécutable <literal>.phar/stub.php</literal> - peuvent être créées si phar.readonly=1. + nom et sans conteneur exécutable <literal>.phar/stub.php</literal> + peuvent être créées si phar.readonly=1. </para> </tip> </para> </section> <section xml:id="phar.fileformat.tar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Les phars basés sur Tar</title> + <title>Les phars basés sur Tar</title> <para> - Les archives basés sur le format de fichier tar sont conforme au format moderne - USTAR. Le design des en-têtes du fichier tar le rend plus efficace que le format de fichier zip - et aussi efficace que le format de fichier phar quand il s'agit d'accéder aux données. - Les noms de fichiers sont limités à 255 octets, y compris le chemin complet au sein de l'archive phar - basée sur tar. Ces archives peuvent être intégralement compressées au format gzip ou bzip2 tout - en restant exécutable par l'extension Phar. + Les archives basés sur le format de fichier tar sont conforme au format moderne + USTAR. Le design des en-têtes du fichier tar le rend plus efficace que le format de fichier zip + et aussi efficace que le format de fichier phar quand il s'agit d'accéder aux données. + Les noms de fichiers sont limités à 255 octets, y compris le chemin complet au sein de l'archive phar + basée sur tar. Ces archives peuvent être intégralement compressées au format gzip ou bzip2 tout + en restant exécutable par l'extension Phar. </para> <para> - Pour compresser une archive entière, utilisez <function>Phar::compress</function>. - Pour décompresser une archive entière, utilisez <function>Phar::decompress</function>. + Pour compresser une archive entière, utilisez <function>Phar::compress</function>. + Pour décompresser une archive entière, utilisez <function>Phar::decompress</function>. </para> </section> <section xml:id="phar.fileformat.zip" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Les phars basés sur Zip</title> + <title>Les phars basés sur Zip</title> <para> - Les archives basés sur le format de fichier zip supportent de nombreuses fonctionnalités - incluses dans le format zip. Les méta-données par fichier ou sur toute l'archive sont stockées - dans les commentaires du fichier zip et de l'archive zip en tant que chaîne de caractères sérialisée. - Les commentaires zip déjà existants seront lus sans problème en tant que chaîne. Les lectures/écritures - compressées sont supportées par la compression zlib, et uniquement les lectures compressées par + Les archives basés sur le format de fichier zip supportent de nombreuses fonctionnalités + incluses dans le format zip. Les méta-données par fichier ou sur toute l'archive sont stockées + dans les commentaires du fichier zip et de l'archive zip en tant que chaîne de caractères sérialisée. + Les commentaires zip déjà existants seront lus sans problème en tant que chaîne. Les lectures/écritures + compressées sont supportées par la compression zlib, et uniquement les lectures compressées par la compression bzip2. Il n'y a pas de limite sur le nombre de fichiers au sein d'une archive phar - basée sur zip. Les répertoires vides sont stockés dans l'archive zip comme des fichiers avec un slash final, + basée sur zip. Les répertoires vides sont stockés dans l'archive zip comme des fichiers avec un slash final, comme <literal>mon/repertoire/</literal> </para> </section>
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/Phar.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/phar/Phar.xml diff -u phpdoc-fr/reference/phar/Phar.xml:1.1 phpdoc-fr/reference/phar/Phar.xml:1.2 --- phpdoc-fr/reference/phar/Phar.xml:1.1 Mon Jan 5 18:16:01 2009 +++ phpdoc-fr/reference/phar/Phar.xml Mon Jan 5 21:52:30 2009 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.1 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.2 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> @@ -17,7 +17,7 @@ <section xml:id="Phar.intro"> &reftitle.intro; <para> - La classe Phar fournit une interface de haut niveau pour accéder et créer + La classe Phar fournit une interface de haut niveau pour accéder et créer des archives phar. </para> </section> @@ -50,12 +50,12 @@ </classsynopsisinfo> <!-- }}} --> - <classsynopsisinfo role="comment">Propriétés</classsynopsisinfo> + <classsynopsisinfo role="comment">Propriétés</classsynopsisinfo> - <classsynopsisinfo role="comment">Méthodes</classsynopsisinfo> + <classsynopsisinfo role="comment">Méthodes</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.Phar')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> -<!-- <classsynopsisinfo role="comment">Méthodes héritées</classsynopsisinfo> +<!-- <classsynopsisinfo role="comment">Méthodes héritées</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.DirectoryIterator')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> --> </classsynopsis> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/book.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/phar/book.xml diff -u phpdoc-fr/reference/phar/book.xml:1.1 phpdoc-fr/reference/phar/book.xml:1.2 --- phpdoc-fr/reference/phar/book.xml:1.1 Mon Jan 5 18:16:01 2009 +++ phpdoc-fr/reference/phar/book.xml Mon Jan 5 21:52:30 2009 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.1 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.2 $ --> <!-- Purpose: compression --> <!-- Membership: pecl --> <!-- EN-Revision: 1.7 Maintainer: gui Status: ready --> @@ -12,27 +12,27 @@ <preface xml:id="intro.phar"> &reftitle.intro; <para> - L'extension phar fournit un moyen de mettre une application PHP complète dans un fichier unique - appelé un "phar" (PHP Archive) pour une installation et une configuration aisées. + L'extension phar fournit un moyen de mettre une application PHP complète dans un fichier unique + appelé un "phar" (PHP Archive) pour une installation et une configuration aisées. En plus de ce service, l'extension fournit aussi une classe d'abstractiond e format de fichier - pour créer et manipuler des fichiers tar et zip à travers la classe + pour créer et manipuler des fichiers tar et zip à travers la classe <classname>PharData</classname>, tout comme - PDO fournit une interface unifiée pour accéder à des base de données différentes. Mais à l'inverse de PDO, - qui ne peut pas transposer les données d'une base à l'autre, Phar a la possbilité de convertir des fichiers tar, + PDO fournit une interface unifiée pour accéder à des base de données différentes. Mais à l'inverse de PDO, + qui ne peut pas transposer les données d'une base à l'autre, Phar a la possbilité de convertir des fichiers tar, zip et phar avec une simple ligne de code. Regardez <function>Phar::convertToExecutable</function> pour avoir un exemple. </para> <para> Qu'est-ce que phar? Les archives phar sont en fait un moyen pratique de grouper plusieurs fichiers en un seul. Ainsi, une archive phar permet de distribuer une - application PHP complète dans un fichier unique et de l'exécuter à partir de ce fichier - sans pour autant l'extraire sur le disque. De plus, des archives phar peuvent être exécutées + application PHP complète dans un fichier unique et de l'exécuter à partir de ce fichier + sans pour autant l'extraire sur le disque. De plus, des archives phar peuvent être exécutées par PHP aussi facilement que n'importe quel autre fichier, aussi bien en ligne de commande que via - un serveur web. Phar est une sorte de clé USB pour les applications PHP. + un serveur web. Phar est une sorte de clé USB pour les applications PHP. </para> <para> - Phar implémente cette fonctionalité via <link linkend="book.stream">un - flux</link>. Normalement, pour utiliser un fichier externe à partir d'un script PHP, vous + Phar implémente cette fonctionalité via <link linkend="book.stream">un + flux</link>. Normalement, pour utiliser un fichier externe à partir d'un script PHP, vous devez utiliser la fonction <function>include</function> </para> <para> @@ -48,16 +48,16 @@ </example> </para> <para> - On peut considérer que PHP traduit en fait + On peut considérer que PHP traduit en fait <literal>/chemin/vers/le/fichier/externe.php</literal> en un flux <literal>file:///chemin/vers/le/fichier/externe.php</literal>, et qu'il - utilise de façon cachée les fonctions de flux de fichiers plats pour accéder - à des fichiers locaux. + utilise de façon cachée les fonctions de flux de fichiers plats pour accéder + à des fichiers locaux. </para> <para> - Pour utiliser un fichier nommé <literal>fichier.php</literal> contenu dans une archive phar + Pour utiliser un fichier nommé <literal>fichier.php</literal> contenu dans une archive phar <literal>/chemin/vers/monphar.phar</literal>, - la syntaxe est quasi similaire à la syntaxe <literal>file://</literal> ci-dessus. + la syntaxe est quasi similaire à la syntaxe <literal>file://</literal> ci-dessus. </para> <para> <example> @@ -73,34 +73,34 @@ </para> <para> En fait, on peut traiter une archive phar comme s'il s'agissait d'un disque externe, en utilisant - n'importe laquelle des fonctions relatives à <function>fopen</function>, <function>opendir</function> et - <function>mkdir</function> pour lire, changer ou créer des nouveaux fichiers ou répertoires au sein de - l'archive phar. Celà permet à des applications PHP complètes d'être distribuées dans un seul fichier - et d'être exécutées à partir de celui-ci + n'importe laquelle des fonctions relatives à <function>fopen</function>, <function>opendir</function> et + <function>mkdir</function> pour lire, changer ou créer des nouveaux fichiers ou répertoires au sein de + l'archive phar. Celà permet à des applications PHP complètes d'être distribuées dans un seul fichier + et d'être exécutées à partir de celui-ci </para> <para> - L'utilisation la plus courant d'une archive phar est de distribuer une application complète + L'utilisation la plus courant d'une archive phar est de distribuer une application complète en un seul fichier. Par exemple, l'installeur PEAR qui est inclus avec les versions de PHP - est distribué grâce à une archive phar. pour utiliser l'archive phar ainsi distribuée, celle-ci - peut-être exécutée via la ligne de commande ou via un navigateur web. + est distribué grâce à une archive phar. pour utiliser l'archive phar ainsi distribuée, celle-ci + peut-être exécutée via la ligne de commande ou via un navigateur web. </para> <para> - Les archives phar peuvent être distribuées sous forme de fichiers <literal>tar</literal>, - de fichiers <literal>zip</literal> ou de fichiers <literal>phar</literal> spécialement conçus - pour l'extensions phar. Chaque format de fichier a ses avantages et ses inconvénients. Les fichiers - zip et tar peuvent être extraits par n'importe quel outil tiers qui peut lire le format, mais - requièrent l'extension phar pour être exécutés par PHP. Le format de fichier phar est unique et dédié - à l'extension phar et peut être créé uniquement par celle-ci ou par le paquet PEAR + Les archives phar peuvent être distribuées sous forme de fichiers <literal>tar</literal>, + de fichiers <literal>zip</literal> ou de fichiers <literal>phar</literal> spécialement conçus + pour l'extensions phar. Chaque format de fichier a ses avantages et ses inconvénients. Les fichiers + zip et tar peuvent être extraits par n'importe quel outil tiers qui peut lire le format, mais + requièrent l'extension phar pour être exécutés par PHP. Le format de fichier phar est unique et dédié + à l'extension phar et peut être créé uniquement par celle-ci ou par le paquet PEAR <link xlink:href="http://pear.php.net/PHP_Archive">PHP_Archive</link>, mais a l'avantage de ne pas - nécessiter l'installation de l'extension phar pour que l'application empaquetée puisse être exécutée. + nécessiter l'installation de l'extension phar pour que l'application empaquetée puisse être exécutée. </para> <para> - En d'autres mots, même avec l'extension phar désactivée, il est possible d'exécuter ou d'inclure - une archive basée sur phar. Accéder à des fichiers individuels au sein d'une archive phar n'est - possible qu'avec l'extension phar à moins quel'archive phar n'ait été créée par PHP_Archive. + En d'autres mots, même avec l'extension phar désactivée, il est possible d'exécuter ou d'inclure + une archive basée sur phar. Accéder à des fichiers individuels au sein d'une archive phar n'est + possible qu'avec l'extension phar à moins quel'archive phar n'ait été créée par PHP_Archive. </para> <para> - L'extension phar est aussi capable de convertir une archive phar à partir d'un tar vers un fichier zip + L'extension phar est aussi capable de convertir une archive phar à partir d'un tar vers un fichier zip ou phar en une seule commande : </para> <para> @@ -117,41 +117,41 @@ </example> </para> <para> - Phar peut compresser des fichiers individuels ou une archive entière en + Phar peut compresser des fichiers individuels ou une archive entière en utilisant la compression <link linkend="book.zlib">gzip</link> ou - <link linkend="book.bzip2">bzip2</link>, et peut vérifier l'intégrité de l'archive + <link linkend="book.bzip2">bzip2</link>, et peut vérifier l'intégrité de l'archive automatiquement en utilisant des fonctions de signature <function>md5</function>, <function>sha1</function>, <function>sha256</function>, ou <function>sha512</function>. </para> <para> - Enfin, l'extension phar est orientée sécurité, elle désactive par défaut les accès - en écriture sur les archives phar exécutables et requiert la désactivation au niveau système - du paramètre <literal>phar.readonly</literal> du php.ini pour créer ou modifier des archives phar. - Des archives tar et zip sans le marqueur exécutable peuvent toujours être créées ou modifiées + Enfin, l'extension phar est orientée sécurité, elle désactive par défaut les accès + en écriture sur les archives phar exécutables et requiert la désactivation au niveau système + du paramètre <literal>phar.readonly</literal> du php.ini pour créer ou modifier des archives phar. + Des archives tar et zip sans le marqueur exécutable peuvent toujours être créées ou modifiées en utilisant la classe <classname>PharData</classname>. </para> <para> - Si vous créez des applications dans le but de les distribuer, vous devriez lire - <link linkend="phar.creating">Comment créer des archives Phar</link>. Si vous voulez - davantage d'informations sur les différences entre les formats de fichier que phar supporte, + Si vous créez des applications dans le but de les distribuer, vous devriez lire + <link linkend="phar.creating">Comment créer des archives Phar</link>. Si vous voulez + davantage d'informations sur les différences entre les formats de fichier que phar supporte, vous devriez lire <link linkend="phar.fileformat">Phar, Tar et Zip</link>. </para> <para> - Si vous utilisez des applications phar, il y a des astuces très utiles dans + Si vous utilisez des applications phar, il y a des astuces très utiles dans <link linkend="phar.using">Comment utiliser des archives Phar</link> </para> <para> Le mot <literal>phar</literal> est la contraction de <literal>PHP</literal> et de - <literal>Archive</literal> et est grandement inspiré - du mot <literal>jar</literal> (Java Archive) familier aux développeurs Java. + <literal>Archive</literal> et est grandement inspiré + du mot <literal>jar</literal> (Java Archive) familier aux développeurs Java. </para> <para> - L'implémentation des archives Phar est basée sur le paquet PEAR + L'implémentation des archives Phar est basée sur le paquet PEAR <link xlink:href="http://pear.php.net/PHP_Archive">PHP_Archive</link>, et - les détails d'implémentations sont les mêmes, bien que l'extension Phar - soit plus puissante. En plus, celle-ci permet à la plupart des applications - PHP d'être exécutées sans modification alors que les archves basées sur PHP_Archive - requièrent souvent beaucoup de modification pour fonctionner. + les détails d'implémentations sont les mêmes, bien que l'extension Phar + soit plus puissante. En plus, celle-ci permet à la plupart des applications + PHP d'être exécutées sans modification alors que les archves basées sur PHP_Archive + requièrent souvent beaucoup de modification pour fonctionner. </para> </preface> <!-- }}} --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/constants.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/phar/constants.xml diff -u phpdoc-fr/reference/phar/constants.xml:1.1 phpdoc-fr/reference/phar/constants.xml:1.2 --- phpdoc-fr/reference/phar/constants.xml:1.1 Mon Jan 5 18:16:01 2009 +++ phpdoc-fr/reference/phar/constants.xml Mon Jan 5 21:52:30 2009 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.1 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.2 $ --> <!-- EN-Revision: 1.5 Maintainer: gui Status: ready --> <!-- Reviewed: no --> @@ -31,7 +31,7 @@ (<type>integer</type>) </entry> <entry>0x0000F000</entry> - <entry>masque de bits pouvant être utilisé avec les drapeaux de fichier pour déterminer si une compression est utilisée</entry> + <entry>masque de bits pouvant être utilisé avec les drapeaux de fichier pour déterminer si une compression est utilisée</entry> </row> <row> <entry> @@ -69,7 +69,7 @@ (<type>integer</type>) </entry> <entry>0</entry> - <entry>Conserve le même format de fichier</entry> + <entry>Conserve le même format de fichier</entry> </row> <row> <entry> @@ -147,14 +147,14 @@ (<type>integer</type>) </entry> <entry>0x0010</entry> - <entry>signature avec une paire de clé privée/publique OpenSSL. C'est une véritable - signature à clé asymétrique/</entry> + <entry>signature avec une paire de clé privée/publique OpenSSL. C'est une véritable + signature à clé asymétrique/</entry> </row> </tbody> </tgroup> </table> <table> - <title>Les constantes d'écrasement de mime Phar webPhar</title> + <title>Les constantes d'écrasement de mime Phar webPhar</title> <tgroup cols="3"> <thead> <row> @@ -170,9 +170,9 @@ (<type>integer</type>) </entry> <entry>1</entry> - <entry>utilisée pour renseigner le paramètre d'écrasement mime + <entry>utilisée pour renseigner le paramètre d'écrasement mime de <function>Phar::webPhar</function> et faire en sorte que l'extension - soit parsée comme un fichier PHP</entry> + soit parsée comme un fichier PHP</entry> </row> <row> <entry> @@ -180,9 +180,9 @@ (<type>integer</type>) </entry> <entry>2</entry> - <entry>utilisée pour renseigner le paramètre d'écrasement mime + <entry>utilisée pour renseigner le paramètre d'écrasement mime de <function>Phar::webPhar</function> et faire en sorte que l'extension - soit parsée comme un fichier PHP via <function>highlight_file</function></entry> + soit parsée comme un fichier PHP via <function>highlight_file</function></entry> </row> </tbody> </tgroup> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/creating.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/phar/creating.xml diff -u phpdoc-fr/reference/phar/creating.xml:1.1 phpdoc-fr/reference/phar/creating.xml:1.2 --- phpdoc-fr/reference/phar/creating.xml:1.1 Mon Jan 5 18:16:01 2009 +++ phpdoc-fr/reference/phar/creating.xml Mon Jan 5 21:52:30 2009 @@ -1,26 +1,26 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <chapter xml:id="phar.creating" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Créer des archives Phar</title> + <title>Créer des archives Phar</title> <section xml:id="phar.creating.intro" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Créer des archives Phar : Introduction</title> + <title>Créer des archives Phar : Introduction</title> <para> - Sera entièrement écrit plus tard. Avant de lire ceci, soyez sûr de lire + Sera entièrement écrit plus tard. Avant de lire ceci, soyez sûr de lire <link linkend="phar.using">Comment utiliser des archives Phar</link>. </para> <para> - Se documenter sur <function>Phar::buildFromIterator</function> et les spécificités des choix de - <link linkend="phar.fileformat">format de fichier</link> disponible pour les archives peut être - un bon début. Une bonne compréhension de ce qu'est et de ce que fait un conteneur (stub) est - cruciale pour la création d'archive phar, ce qui fait de <function>Phar::setStub</function> et - <function>Phar::createDefaultStub</function> également un bon point de départ. - Si vous distribuer des applications web, il est important de connaître - <function>Phar::webPhar</function> et la méthode associée - <function>Phar::mungServer</function>. Toute application qui accède à ses propres fichiers - devrait aussi considérer l'utilisation de <function>Phar::interceptFileFuncs</function>. + Se documenter sur <function>Phar::buildFromIterator</function> et les spécificités des choix de + <link linkend="phar.fileformat">format de fichier</link> disponible pour les archives peut être + un bon début. Une bonne compréhension de ce qu'est et de ce que fait un conteneur (stub) est + cruciale pour la création d'archive phar, ce qui fait de <function>Phar::setStub</function> et + <function>Phar::createDefaultStub</function> également un bon point de départ. + Si vous distribuer des applications web, il est important de connaître + <function>Phar::webPhar</function> et la méthode associée + <function>Phar::mungServer</function>. Toute application qui accède à ses propres fichiers + devrait aussi considérer l'utilisation de <function>Phar::interceptFileFuncs</function>. </para> </section> </chapter> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/fileformat.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/phar/fileformat.xml diff -u phpdoc-fr/reference/phar/fileformat.xml:1.1 phpdoc-fr/reference/phar/fileformat.xml:1.2 --- phpdoc-fr/reference/phar/fileformat.xml:1.1 Mon Jan 5 18:16:01 2009 +++ phpdoc-fr/reference/phar/fileformat.xml Mon Jan 5 21:52:30 2009 @@ -1,25 +1,25 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- EN-Revision: 1.13 Maintainer: gui Status: partial --> <!-- 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> <section xml:id="phar.fileformat.ingredients" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Les ingrédients de toutes les archives Phar, indépendemment du format de fichier</title> + <title>Les ingrédients de toutes les archives Phar, indépendemment du format de fichier</title> <para> - Toute les archives Phar contiennent de trois à quatre sections: + Toute les archives Phar contiennent de trois à quatre sections: <orderedlist> <listitem> <para>un conteneur</para> </listitem> <listitem> - <para>un manifest décrivant le contenu</para> + <para>un manifest décrivant le contenu</para> </listitem> <listitem> <para>Le contenu du fichier</para> </listitem> <listitem> - <para>une signature (factultative) pour vérifier l'intégrité (uniquement avec le format de fichier phar)</para> + <para>une signature (factultative) pour vérifier l'intégrité (uniquement avec le format de fichier phar)</para> </listitem> </orderedlist> </para> @@ -36,7 +36,7 @@ </para> <para> Un conteneur doit contenir au moins le jeton <literal>__HALT_COMPILER();</literal> en guise - de conclusion. Typiquement, un conteneur comportera les fonctionnalités de chargement suivantes : + de conclusion. Typiquement, un conteneur comportera les fonctionnalités de chargement suivantes : like so: </para> <para> @@ -50,34 +50,34 @@ </programlisting> </para> <para> - Il n'y a aucune restriction sur le contenu d'un conteneur Phar, si ce n'est le besoin d'être conclus - par <literal>__HALT_COMPILER();</literal>. Le tag fermant PHP <literal><![CDATA[?>]]></literal> peut être + Il n'y a aucune restriction sur le contenu d'un conteneur Phar, si ce n'est le besoin d'être conclus + par <literal>__HALT_COMPILER();</literal>. Le tag fermant PHP <literal><![CDATA[?>]]></literal> peut être inclus ou omis, mais il ne peut y avoir plus d'un espace entre le <literal>;</literal> et le tag fermant <literal><![CDATA[?>]]></literal> sans quoi l'extension phar ne sera pas capable de lire le manifeste de l'archive. </para> <para> - Dans une archive phar basée sur tar ou zip, le conteneur est stocké dans le fichier - <literal>.phar/stub.php</literal>. Le conteneur par défaut des archives Phar basées sur - phar contient approximativement 7k de code pour extraire le contenu du phar et l'exécuter. - Regardez la fonction <function>Phar::createDefaultStub</function> pour davantage de détails. + Dans une archive phar basée sur tar ou zip, le conteneur est stocké dans le fichier + <literal>.phar/stub.php</literal>. Le conteneur par défaut des archives Phar basées sur + phar contient approximativement 7k de code pour extraire le contenu du phar et l'exécuter. + Regardez la fonction <function>Phar::createDefaultStub</function> pour davantage de détails. </para> <para> - L'alias phar est stocké, dans le cas d'une archive phar basée sur tar ou zip, dans le fichier + L'alias phar est stocké, dans le cas d'une archive phar basée sur tar ou zip, dans le fichier <literal>.phar/alias.txt</literal> en tant que texte plein. </para> </section> <section xml:id="phar.fileformat.comparison" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Comparaison entre Phar, Tar et Zip</title> <para> - Quels sont les avantages et les inconvénients de chacun des trois formats supportés - par l'extension phar? Ce tableau tente de répondre à cette question. + Quels sont les avantages et les inconvénients de chacun des trois formats supportés + par l'extension phar? Ce tableau tente de répondre à cette question. <table> - <title>Tableau de fonctionnalités : Phar vs. Tar vs. Zip</title> + <title>Tableau de fonctionnalités : Phar vs. Tar vs. Zip</title> <tgroup cols="4"> <thead> <row> - <entry>Fonctionnalité</entry> + <entry>Fonctionnalité</entry> <entry>Phar</entry> <entry>Tar</entry> <entry>Zip</entry> @@ -91,7 +91,7 @@ <entry>Oui</entry> </row> <row> - <entry>Peut être exécuté sans l'extension Phar + <entry>Peut être exécuté sans l'extension Phar <link linkend="phar.fileformat.phartip">[1]</link> </entry> <entry>Oui</entry> @@ -117,25 +117,25 @@ <entry>Non</entry> </row> <row> - <entry>Support d'applications spécifiquement Web</entry> + <entry>Support d'applications spécifiquement Web</entry> <entry>Oui</entry> <entry>Oui</entry> <entry>Oui</entry> </row> <row> - <entry>Meta-données par fichier</entry> + <entry>Meta-données par fichier</entry> <entry>Oui</entry> <entry>Oui</entry> <entry>Oui</entry> </row> <row> - <entry>Meta-données pour toute l'archive</entry> + <entry>Meta-données pour toute l'archive</entry> <entry>Oui</entry> <entry>Oui</entry> <entry>Oui</entry> </row> <row> - <entry>Création/modification d'archive + <entry>Création/modification d'archive <link linkend="phar.fileformat.phartip2">[2]</link> </entry> <entry>Oui</entry> @@ -149,7 +149,7 @@ <entry>Oui</entry> </row> <row> - <entry>Peut être créée/modifiée même si phar.readonly=1 + <entry>Peut être créée/modifiée même si phar.readonly=1 <link linkend="phar.fileformat.phartip3">[3]</link> </entry> <entry>Non</entry> @@ -163,20 +163,20 @@ <para xml:id="phar.fileformat.phartip"> <tip> <para> - [1] PHP ne peut accéder directement au contenu d'une archive Phar sans que l'extension - Phar soit installée si elle utilise un <literal>conteneur</literal> + [1] PHP ne peut accéder directement au contenu d'une archive Phar sans que l'extension + Phar soit installée si elle utilise un <literal>conteneur</literal> qui extrait le contenu de l'archive phar. Le conteneur - créé par <function>Phar::createDefaultStub</function> extrait - l'archive phar et exécute son contenu à partir d'un répertoire temporaire si - aucune extension phar n'est trouvée. + créé par <function>Phar::createDefaultStub</function> extrait + l'archive phar et exécute son contenu à partir d'un répertoire temporaire si + aucune extension phar n'est trouvée. </para> </tip> </para> <para xml:id="phar.fileformat.phartip2"> <tip> <para> - [2] Toute les accès en écriture nécessite que <literal>phar.readonly</literal> soit - désactivé dans le php.ini ou directement via la ligne de commande. + [2] Toute les accès en écriture nécessite que <literal>phar.readonly</literal> soit + désactivé dans le php.ini ou directement via la ligne de commande. </para> </tip> </para> @@ -184,37 +184,37 @@ <tip> <para> [3] Seules les archives tar ou zip sans <literal>.phar</literal> dans leur - nom et sans conteneur exécutable <literal>.phar/stub.php</literal> - peuvent être créées si phar.readonly=1. + nom et sans conteneur exécutable <literal>.phar/stub.php</literal> + peuvent être créées si phar.readonly=1. </para> </tip> </para> </section> <section xml:id="phar.fileformat.tar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Les phars basés sur Tar</title> + <title>Les phars basés sur Tar</title> <para> - Les archives basés sur le format de fichier tar sont conforme au format moderne - USTAR. Le design des en-têtes du fichier tar le rend plus efficace que le format de fichier zip - et aussi efficace que le format de fichier phar quand il s'agit d'accéder aux données. - Les noms de fichiers sont limités à 255 octets, y compris le chemin complet au sein de l'archive phar - basée sur tar. Ces archives peuvent être intégralement compressées au format gzip ou bzip2 tout - en restant exécutable par l'extension Phar. + Les archives basés sur le format de fichier tar sont conforme au format moderne + USTAR. Le design des en-têtes du fichier tar le rend plus efficace que le format de fichier zip + et aussi efficace que le format de fichier phar quand il s'agit d'accéder aux données. + Les noms de fichiers sont limités à 255 octets, y compris le chemin complet au sein de l'archive phar + basée sur tar. Ces archives peuvent être intégralement compressées au format gzip ou bzip2 tout + en restant exécutable par l'extension Phar. </para> <para> - Pour compresser une archive entière, utilisez <function>Phar::compress</function>. - Pour décompresser une archive entière, utilisez <function>Phar::decompress</function>. + Pour compresser une archive entière, utilisez <function>Phar::compress</function>. + Pour décompresser une archive entière, utilisez <function>Phar::decompress</function>. </para> </section> <section xml:id="phar.fileformat.zip" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Les phars basés sur Zip</title> + <title>Les phars basés sur Zip</title> <para> - Les archives basés sur le format de fichier zip supportent de nombreuses fonctionnalités - incluses dans le format zip. Les méta-données par fichier ou sur toute l'archive sont stockées - dans les commentaires du fichier zip et de l'archive zip en tant que chaîne de caractères sérialisée. - Les commentaires zip déjà existants seront lus sans problème en tant que chaîne. Les lectures/écritures - compressées sont supportées par la compression zlib, et uniquement les lectures compressées par + Les archives basés sur le format de fichier zip supportent de nombreuses fonctionnalités + incluses dans le format zip. Les méta-données par fichier ou sur toute l'archive sont stockées + dans les commentaires du fichier zip et de l'archive zip en tant que chaîne de caractères sérialisée. + Les commentaires zip déjà existants seront lus sans problème en tant que chaîne. Les lectures/écritures + compressées sont supportées par la compression zlib, et uniquement les lectures compressées par la compression bzip2. Il n'y a pas de limite sur le nombre de fichiers au sein d'une archive phar - basée sur zip. Les répertoires vides sont stockés dans l'archive zip comme des fichiers avec un slash final, + basée sur zip. Les répertoires vides sont stockés dans l'archive zip comme des fichiers avec un slash final, comme <literal>mon/repertoire/</literal> </para> </section>