cvs: phpdoc-fr /reference/phar PharData.xml PharException.xml PharFileInfo.xml book.xml setup.xml using.xml
| From: | Guillaume Plessis | Date: | Tue, 06 Jan 2009 12:29:32 +0000 |
| Subject: | cvs: phpdoc-fr /reference/phar PharData.xml PharException.xml PharFileInfo.xml book.xml setup.xml using.xml | ||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-6283@lists.php.net to get a copy of this message | ||
gui Tue Jan 6 12:29:32 2009 UTC
Added files:
/phpdoc-fr/reference/phar PharData.xml PharException.xml
PharFileInfo.xml setup.xml using.xml
Modified files:
/phpdoc-fr/reference/phar book.xml
Log:
initial translation + typo
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/book.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-fr/reference/phar/book.xml diff -u phpdoc-fr/reference/phar/book.xml:1.2 phpdoc-fr/reference/phar/book.xml:1.3 --- phpdoc-fr/reference/phar/book.xml:1.2 Mon Jan 5 21:52:30 2009 +++ phpdoc-fr/reference/phar/book.xml Tue Jan 6 12:29:32 2009 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- Purpose: compression --> <!-- Membership: pecl --> <!-- EN-Revision: 1.7 Maintainer: gui Status: ready --> @@ -14,7 +14,7 @@ <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. - En plus de ce service, l'extension fournit aussi une classe d'abstractiond e format de fichier + En plus de ce service, l'extension fournit aussi une classe d'abstraction de format de fichier 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, http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/PharData.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData.xml +++ phpdoc-fr/reference/phar/PharData.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.PharData" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> <title>La classe PharData</title> <titleabbrev>PharData</titleabbrev> <partintro> <!-- {{{ Phar intro --> <section xml:id="PharData.intro"> &reftitle.intro; <para> La classe PharData fournit une interface de haut niveau pour accéder et créer des archives tar et zip non exécutables. Du fait que ces archives ne contiennent pas de conteneur et qu'elles ne puissent être exécutées par l'extension phar, il est possible de créer et de manipuler des fichiers zip et tar normaux en utilisant la classe PharData même si le paramètre <literal>phar.readonly</literal> du php.ini est à <literal>1</literal>. </para> </section> <!-- }}} --> <section xml:id="PharData.synopsis"> &reftitle.classsynopsis; <!-- {{{ Synopsis --> <classsynopsis> <ooclass><classname>PharData</classname></ooclass> <!-- {{{ Class synopsis --> <classsynopsisinfo> <ooclass> <classname>PharData</classname> </ooclass> <ooclass> <modifier>extends</modifier> <classname>Phar</classname> </ooclass> </classsynopsisinfo> <!-- }}} --> <classsynopsisinfo role="comment">Propriétés</classsynopsisinfo> <classsynopsisinfo role="comment">Méthodes</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.PharData')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> <classsynopsisinfo role="comment">Méthodes héritées</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])" /> </classsynopsis> <!-- }}} --> </section> </partintro> &reference.phar.entities.PharData; </phpdoc:classref> <!-- 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/PharException.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharException.xml +++ phpdoc-fr/reference/phar/PharException.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <phpdoc:exceptionref xml:id="class.PharException" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:phpdoc="http://php.net/ns/phpdoc"> <title>La classe PharException</title> <titleabbrev>PharException</titleabbrev> <partintro> <!-- {{{ Phar intro --> <section xml:id="PharException.intro"> &reftitle.intro; <para> La classe PharException fournit une classe d'exception spécifique à phar pour essayer/attraper des blocs. </para> </section> <!-- }}} --> <section xml:id="PharException.synopsis"> &reftitle.classsynopsis; <!-- {{{ Synopsis --> <classsynopsis> <ooclass><classname>PharException</classname></ooclass> <!-- {{{ Class synopsis --> <classsynopsisinfo> <ooclass> <classname>PharException</classname> </ooclass> <ooclass> <modifier>extends</modifier> <classname>Exception</classname> </ooclass> </classsynopsisinfo> <!-- }}} --> <classsynopsisinfo role="comment">Propriétés</classsynopsisinfo> <!-- <classsynopsisinfo role="comment">Méthodes héritées</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.Exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> --> </classsynopsis> <!-- }}} --> </section> </partintro> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="PharException.intro.unused"> <refnamediv> <refname>PharException</refname> <refpurpose> La classe PharException fournit une classe d'exception spécifique à phar pour essayer/attraper des blocs.</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> </para> </refsect1> </refentry> </phpdoc:exceptionref> <!-- 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/PharFileInfo.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo.xml +++ phpdoc-fr/reference/phar/PharFileInfo.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.PharFileInfo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> <title>La classe PharFileInfo</title> <titleabbrev>PharFileInfo</titleabbrev> <partintro> <!-- {{{ Phar intro --> <section xml:id="PharFileInfo.intro"> &reftitle.intro; <para> La classe PharFileInfo fournit une interface de haut niveau pour accéder au contenu et aux attributs d'un fichier contenu dans une archive phar. </para> </section> <!-- }}} --> <section xml:id="PharFileInfo.synopsis"> &reftitle.classsynopsis; <!-- {{{ Synopsis --> <classsynopsis> <ooclass><classname>PharFileInfo</classname></ooclass> <!-- {{{ Class synopsis --> <classsynopsisinfo> <ooclass> <classname>PharFileInfo</classname> </ooclass> <ooclass> <modifier>extends</modifier> <classname>SplFileInfo</classname> </ooclass> </classsynopsisinfo> <!-- }}} --> <classsynopsisinfo role="comment">Propriétés</classsynopsisinfo> <classsynopsisinfo role="comment">Méthodes</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.PharFileInfo')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> <!-- <classsynopsisinfo role="comment">Méthodes héritées</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.SplFileInfo')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> --> </classsynopsis> <!-- }}} --> </section> </partintro> &reference.phar.entities.PharFileInfo; </phpdoc:classref> <!-- 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/setup.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/setup.xml +++ phpdoc-fr/reference/phar/setup.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <chapter xml:id="phar.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="phar.requirements"> &reftitle.required; <para> Phar requiert PHP 5.2.0 ou plus récent. Des fonctionnalités supplémentaires requièrent l'extension <link linkend="book.spl">SPL</link> pour tirer parti de l'itération et de l'accès sous forme de tableau au contenu d'un fichier Phar. Le flux <literal>phar</literal> ne requiert aucune extension supplémentaire pour fonctionner. </para> <para> Vous pouvez éventuellement souhaiter activer les extensions <link linkend="book.zlib" >zlib</link> et <link linkend="book.bzip2" >bzip2</link> pour tirer parti du support phar compressé. De plus, pour exploiter les signatures OpenSSL, l'extension <link linkend="book.openssl">OpenSSL</link> doit être activée. </para> <para> A noter qu'un bogue dans le filtre de flux <link linkend="filters.compression">zlib.deflate</link> corrigé en PHP 5.2.6 et plus récent pourrait causer la troncature des archives phar compressées en gzip ou bzip2. </para> </section> <!-- }}} --> <!-- {{{ Installation --> &reference.phar.installation; <!-- }}} --> <!-- {{{ Configuration --> &reference.phar.ini; <!-- }}} --> <!-- {{{ Resources --> <section xml:id="phar.resources"> &reftitle.resources; <para> L'extension Phar fournit le flux <literal>phar</literal>, qui permet l'accès de façon transparente aux fichiers contenus dans un phar. Le format de fichier d'un Phar est décrit <link linkend="phar.fileformat">ici</link> </para> </section> <!-- }}} --> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: 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/using.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/using.xml +++ phpdoc-fr/reference/phar/using.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.14 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <chapter xml:id="phar.using" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Utiliser les archives Phar</title> <section xml:id="phar.using.intro" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Utiliser les archives Phar : Introduction</title> <para> Les archives Phar sont identiques dans le concept aux archives JAR de Java, mais sont conçues plus spécifiquement pour les besoins et la flexibilité des applications PHP. Une archive Phar est utilisée pour distribuer une application PHP complète ou une bibliothèque sous forme d'un fichier unique. A l'inverse de Java, aucun outil externe n'est requis pour manipuler ou exécuter une archive Phar PHP. Une application sous forme d'archive Phar est utilisée exactement de la même façon que n'importe quelle autre application PHP : </para> <screen> <![CDATA[ php applicationsympa.phar ]]> </screen> <para> L'utilisation d'une bibliothèque sous forme d'archive Phar est la même que n'importe quelle autre bibliothèque PHP : </para> <para> <informalexample> <programlisting role="php"> <![CDATA[ <?php include 'bibliothequesympa.phar'; ?> ]]> </programlisting> </informalexample> </para> <para> Le flux <literal>phar</literal> fournit le coeur de l'extension phar, et est décrit en détails <link linkend="phar.using.stream">ici</link>. Le flux phar permet l'accès aux fichiers contenus dans une archive phar via les fonctions standards de fichier <function>fopen</function>, <function>opendir</function>, et toute autre fonctionnant sur des fichiers normaux. Le flux <literal>phar</literal> supporte toutes les opérations de lecture/écriture à al fois su les fichiers et sur les répertoires. </para> <para> <informalexample> <programlisting role="php"> <![CDATA[ <?php include 'phar://bibliothequesympa.phar/fichier/interne.php'; header('Content-type: image/jpeg'); // les phars peuvent être atteint via le chemin complet ou via des alias echo file_get_contents('phar:///chemin/complet/vers/bibliothequesympa.phar/images/wow.jpg'); ?> ]]> </programlisting> </informalexample> </para> <para> La classe <classname>Phar</classname> implémente des fonctionnalités avancées pour accéder aux fichiers et créer des archives phar. La classe Phar est décrite en détails <link linkend="phar.using.object">ici</link>. </para> <para> <informalexample> <programlisting role="php"> <![CDATA[ <?php try { // ouvre un phar existant $p = new Phar('bibliothequesympa.phar', 0); // Phar étend la classe DirectoryIterator de SPL foreach (new RecursiveIteratorIterator($p) as $file) { // $file est une classe PharFileInfo et hérité de SplFileInfo echo $file->getFileName() . "\n"; echo file_get_contents($file->getPathName()) . "\n"; // affiche le contenu; } if (isset($p['fichier/interne.php'])) { var_dump($p['fichier/interne.php']->getMetaData()); } // crée un nouveau phar - phar.readonly doit être à 0 dans php.ini // phar.readonly est activé par défaut pour des raisons de sécurité. // Sur des serveurs de production, les Phars n'ont pas besoin d'être créés, // juste d'être exécutés. if (Phar::canWrite()) { $p = new Phar('nouveauphar.tar.phar', 0, 'nouveauphar.tar.phar'); // On crée une archive Phar basée sur tar, compressée par gzip (.tar.gz) $p = $p->convertToExecutable(Phar::TAR, Phar::GZ); // crée une transaction - rien n'est écrit dans nouveauphar.phar // jusqu'à ce que stopBuffering() ne soit appelé, bien qu'un stockage temporaire soit requis $p->startBuffering(); // ajoute tous les fichier de /chemin/vers/leprojet dans le phar avec le préfixe "projet" $p->buildFromIterator(new RecursiveIteratorIterator(new DirectoryIterator('/chemin/vers/leprojet')), '/chemin/vers/'); // ajoute un nouveau fichier en utilisant l'API d'accès par tableau $p['fichier1.txt'] = 'Information'; $fp = fopen('grosfichier.dat', 'rb'); // copie toutes les données du flux $p['data/grosfichier.dat'] = $fp; if (Phar::canCompress(Phar::GZ)) { $p['data/grosfichier.dat']->compress(Phar::GZ); } $p['images/wow.jpg'] = file_get_contents('images/wow.jpg'); // toute valeur peut être sauvegardée comme méta-donnée spécifique au fichier $p['images/wow.jpg']->setMetaData(array('mime-type' => 'image/jpeg')); $p['index.php'] = file_get_contents('index.php'); $p->setMetaData(array('bootstrap' => 'index.php')); // sauvegarde l'archive phar sur le disque $p->stopBuffering(); } } catch (Exception $e) { echo 'N\'a pas pu ouvrir le Phar: ', $e; } ?> ]]> </programlisting> </informalexample> </para> <para> D'autre part, la vérification du contenu du fichier phar peut être faite en utilisant un des algorithme de signature symétrique (MD5, SHA1, SHA256 et SHA512 si ext/hash est activée) et en utilisant la signature asymétrique par clé publique/privée de OpenSSL (nouveauté de Phar 2.0.0). Pour tirer parti de la signature OpenSSL, vous devez générer une paire de clés publique/privée et utiliser la clé privée pour signer avec <function>Phar::setSignatureAlgorithm</function>. En plus, la clé publique, extraite en utilisant ce code : <programlisting role="php"> <![CDATA[ $public = openssl_get_publickey(file_get_contents('private.pem')); $pkey = ''; openssl_pkey_export($public, $pkey); ]]> </programlisting> doit être sauvegardée à part de l'archive phar qu'elle vérifie. Si l'archive phar est sauvegardée en tant que <literal>/chemin/vers/mon.phar</literal>, la clé publique doit être sauvegardée en tant que <literal>/chemin/vers/mon.phar.pubkey</literal>, sans quoi phar ne sera pas capable de verifier la signature OpenSSL. </para> <para> Depuis la version 2.0.0, la classe <classname>Phar</classname> fournit aussi trois méthodes statiques, <function>Phar::webPhar</function>, <function>Phar::mungServer</function> et <function>Phar::interceptFileFuncs</function> qui sont cruciales pour empaqueter des applications PHP visant à être utilisée sur un système de fichier classique ou en tant qu'application web. <function>Phar::webPhar</function> implémente un contrôleur qui route les appels HTTP vers le bon endroit de l'archive phar. <function>Phar::mungServer</function> est utilisé pour modifier les valeurs du tableau <varname>$_SERVER</varname> pour dire aux applications d'utiliser ces valeurs. <function>Phar::interceptFileFuncs</function> dit à Phar d'intercepter les appels à <function>fopen</function>, <function>file_get_contents</function>, <function>opendir</function>, et à toutes les fonctions basées sur stat (<function>file_exists</function>, <function>is_readable</function>, etc) et route tous les chemins relatif vers les bons endroits de l'archive phar. </para> <para> Par exemple, empaqueter une version de la célèbre application phpMyAdmin dans une archive phar nécessite juste ce simple script et, dès lors, <literal>phpMyAdmin.phar.tar.php</literal> peut être accédé comme un fichier classique à partir de votre serveur web, après avoir modifié le couple utilisateur/motdepasse : </para> <para> <informalexample> <programlisting role="php"> <![CDATA[ <?php @unlink('phpMyAdmin.phar.tar.php'); copy('phpMyAdmin-2.11.3-english.tar.gz', 'phpMyAdmin.phar.tar.php'); $a = new Phar('phpMyAdmin.phar.tar.php'); $a->startBuffering(); $a["phpMyAdmin-2.11.3-english/config.inc.php"] = '<?php /* Servers configuration */ $i = 0; /* Server localhost (config:root) [1] */ $i++; $cfg[\'Servers\'][$i][\'host\'] = \'localhost\'; $cfg[\'Servers\'][$i][\'extension\'] = \'mysqli\'; $cfg[\'Servers\'][$i][\'connect_type\'] = \'tcp\'; $cfg[\'Servers\'][$i][\'compress\'] = false; $cfg[\'Servers\'][$i][\'auth_type\'] = \'config\'; $cfg[\'Servers\'][$i][\'user\'] = \'root\'; $cfg[\'Servers\'][$i][\'password\'] = \'\'; /* End of servers configuration */ if (strpos(PHP_OS, \'WIN\') !== false) { $cfg[\'UploadDir\'] = getcwd(); } else { $cfg[\'UploadDir\'] = \'/tmp/pharphpmyadmin\'; @mkdir(\'/tmp/pharphpmyadmin\'); @chmod(\'/tmp/pharphpmyadmin\', 0777); }'; $a->setStub('<?php Phar::interceptFileFuncs(); Phar::webPhar("phpMyAdmin.phar", "phpMyAdmin-2.11.3-english/index.php"); echo "phpMyAdmin is intended to be executed from a web browser\n"; exit -1; __HALT_COMPILER(); '); $a->stopBuffering(); ?> ]]> </programlisting> </informalexample> </para> </section> <section xml:id="phar.using.stream" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Utiliser les archives Phar : le flux phar</title> <para> Le flux Phar supporte totalement <function>fopen</function> pour les lectures, écritures, concaténations, <function>unlink</function>, <function>stat</function>, <function>fstat</function>, <function>fseek</function>, <function>rename</function> et le opérations de flux sur les répertoires <function>opendir</function> et depuis la version 2.0.0, <function>rmdir</function> et <function>mkdir</function>. </para> <para> La compression et les méta-données individuelles par fichier peuvent aussi être manipulées au sein de l'archive Phar en utilisant les contextes de flux : </para> <para> <informalexample> <programlisting role="php"> <![CDATA[ <?php $context = stream_context_create(array('phar' => array('compress' => Phar::GZ)), array('metadata' => array('user' => 'cellog'))); file_put_contents('phar://mon.phar/unfichier.php', 0, $context); ?> ]]> </programlisting> </informalexample> </para> <para> Le flux <literal>phar</literal> n'agit pas sur les fichiers distants et ne peut pas considérer les fichiers distants, etc... même si les options INI <link linkend="ini.allow-url-fopen">allow_url_fopen</link> et <link linkend="ini.allow-url-include">allow_url_include</link> sont désactivées. </para> <para> Bien qu'il soit possible de créer des archives phar de zéro en utilisant juste les opérations sur les flux, il est préférable d'utiliser la fonctionnalité incluse dans la classe Phar. Le flux est mieux utilisé pour les opérations de lecture. </para> </section> <section xml:id="phar.using.object" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Utiliser les archives Phar : les classes Phar et PharData</title> <para> La classe <classname>Phar</classname> supporte la lecture et la manipulation des archives Phar, ainsi que l'itération à travers la fonctionnalité héritée de la classe <link xlink:href="http://www.php.net/~helly/php/ext/spl/classRecursiveDirectoryIterator.html"><classname>RecursiveDirectoryIterator</classname></link>. Avec le support de l'interface <classname>ArrayAccess</classname>, les fichiers contenus dans une archive Phar peuvent être accédés comme s'ils étaient membres d'un tableau associatif. </para> <para> La classe <classname>PharData</classname> étend la classe <classname>Phar</classname>, et permet la création et la modification d'archives tar et zip non exécutables (données) même si <literal>phar.readonly</literal>=1 dans php.ini. Ainsi, <function>PharData::setAlias</function> et <function>PharData::setStub</function> sont toutes deux désactivées car les concepts d'alias et de conteneur sont restreints aux archives phar exécutables. </para> <para> Il est important de noter que quand une archive Phar est créée, le chemin complet doit être passé au constructeur de l'objet <classname>Phar</classname>. Un chemin relatif empêcherait l'initialisation. </para> <para> En supposant que <literal>$p</literal> est un objet initialisé de cette façon : </para> <para> <informalexample> <programlisting role="php"> <![CDATA[ <?php $p = new Phar('/chemin/vers/monphar.phar', 0, 'monphar.phar'); ?> ]]> </programlisting> </informalexample> </para> <para> Une archive Phar vide sera créée en tant que <literal>/chemin/vers/monphar.phar</literal>, ou si <literal>/chemin/vers/monphar.phar</literal> existe déjà, il sera ouvert de nouveau. Le terme <literal>monphar.phar</literal> démontre le concept d'un alias qui peut être utilisé pour référencer <literal>/chemin/vers/monphar.phar</literal> dans des URL comme ceci : </para> <para> <informalexample> <programlisting role="php"> <![CDATA[ <?php // ces deux appels à file_get_contents() sont équivalents si // /chemin/vers/monphar.phar a un alias explicite de "monphar.phar" // dans son mainfeste, ou si le phar a été initialisé avec l'instantiation de // l'objet Phar de l'exemple précedent $f = file_get_contents('phar:///chemin/vers/monphar.phar/nimportequoi.txt'); $f = file_get_contents('phar://monphar.phar/nimportequoi.txt'); ?> ]]> </programlisting> </informalexample> </para> <para> Avec l'objet <classname>Phar</classname> <literal>$p</literal> nouvellement créé, les choses suivantes sont possibles : <itemizedlist> <listitem> <simpara> <literal>$a = $p['fichier.php']</literal> crée une <classname>PharFileInfo</classname> qui réfère au contenu de <literal>phar://monphar.phar/fichier.php</literal> </simpara> </listitem> <listitem> <simpara> <literal>$p['fichier.php'] = $v</literal> crée un nouveau fichier (<literal>phar://monphar.phar/fichier.php</literal>), ou écrase un fichier existat au sein de <literal>monphar.phar</literal>. <literal>$v</literal> peut être soit une chaîne ou un pointeur vers un fichier ouvert, dans quel cas le contenu du fchier sera utilisé pour créer le nouveau fichier. Notez que <literal>$p->addFromString('fichier.php', $v)</literal> est équivalent en terme de fonctionnalité au cas ci-dessus. Il est aussi possible d'ajouter le contenu d'un fichier avec <literal>$p->addFile('/chemin/vers/fichier.php', 'fichier.php')</literal>. Enfin, un répertoire vide peut être créé avec <literal>$p->addEmptyDir('vide')</literal>. </simpara> </listitem> <listitem> <simpara> <literal>isset($p['fichier.php'])</literal> peut être utilisé pour déterminer si <literal>phar://monphar.phar/fichier.php</literal> existe au sein de <literal>monphar.phar</literal>. </simpara> </listitem> <listitem> <simpara> <literal>unset($p['fichier.php'])</literal> efface <literal>phar://monphar.phar/fichier.php</literal> de <literal>monphar.phar</literal>. </simpara> </listitem> </itemizedlist> </para> <para> De plus, l'object <classname>Phar</classname> est le seul moyen d'accéder aux méta-données spécifiques à Phar, via <function>Phar::getMetaData</function>, et c'est aussi le seul moyen de régler ou de récupérer le conteneur du chargeur de l'archive Phar via <function>Phar::getStub</function> et <function>Phar::setStub</function>. De plus, la compression pour l'archive Phar entière peut être manipulée seulement via la classe <classname>Phar</classname>. </para> <para> La liste complète des fonctionnalités de l'objet <classname>Phar</classname> est documentée ci-dessous. </para> <para> La classe <classname>PharFileInfo</classname> étend la classe <link xlink:href="http://www.php.net/~helly/php/ext/spl/classSplFileInfo.html"><classname>SplFileInfo</classname></link> et ajoute plusieurs méthodes pour manipuler les méta-données spécifiques à Phar d'un fichier contenu dans un Phar, telles que manipuler la compresssion ou les méta-données. </para> </section> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: 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/book.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-fr/reference/phar/book.xml diff -u phpdoc-fr/reference/phar/book.xml:1.2 phpdoc-fr/reference/phar/book.xml:1.3 --- phpdoc-fr/reference/phar/book.xml:1.2 Mon Jan 5 21:52:30 2009 +++ phpdoc-fr/reference/phar/book.xml Tue Jan 6 12:29:32 2009 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- Purpose: compression --> <!-- Membership: pecl --> <!-- EN-Revision: 1.7 Maintainer: gui Status: ready --> @@ -14,7 +14,7 @@ <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. - En plus de ce service, l'extension fournit aussi une classe d'abstractiond e format de fichier + En plus de ce service, l'extension fournit aussi une classe d'abstraction de format de fichier 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, http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/PharData.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData.xml +++ phpdoc-fr/reference/phar/PharData.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.PharData" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> <title>La classe PharData</title> <titleabbrev>PharData</titleabbrev> <partintro> <!-- {{{ Phar intro --> <section xml:id="PharData.intro"> &reftitle.intro; <para> La classe PharData fournit une interface de haut niveau pour accéder et créer des archives tar et zip non exécutables. Du fait que ces archives ne contiennent pas de conteneur et qu'elles ne puissent être exécutées par l'extension phar, il est possible de créer et de manipuler des fichiers zip et tar normaux en utilisant la classe PharData même si le paramètre <literal>phar.readonly</literal> du php.ini est à <literal>1</literal>. </para> </section> <!-- }}} --> <section xml:id="PharData.synopsis"> &reftitle.classsynopsis; <!-- {{{ Synopsis --> <classsynopsis> <ooclass><classname>PharData</classname></ooclass> <!-- {{{ Class synopsis --> <classsynopsisinfo> <ooclass> <classname>PharData</classname> </ooclass> <ooclass> <modifier>extends</modifier> <classname>Phar</classname> </ooclass> </classsynopsisinfo> <!-- }}} --> <classsynopsisinfo role="comment">Propriétés</classsynopsisinfo> <classsynopsisinfo role="comment">Méthodes</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.PharData')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> <classsynopsisinfo role="comment">Méthodes héritées</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])" /> </classsynopsis> <!-- }}} --> </section> </partintro> &reference.phar.entities.PharData; </phpdoc:classref> <!-- 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/PharException.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharException.xml +++ phpdoc-fr/reference/phar/PharException.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <phpdoc:exceptionref xml:id="class.PharException" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:phpdoc="http://php.net/ns/phpdoc"> <title>La classe PharException</title> <titleabbrev>PharException</titleabbrev> <partintro> <!-- {{{ Phar intro --> <section xml:id="PharException.intro"> &reftitle.intro; <para> La classe PharException fournit une classe d'exception spécifique à phar pour essayer/attraper des blocs. </para> </section> <!-- }}} --> <section xml:id="PharException.synopsis"> &reftitle.classsynopsis; <!-- {{{ Synopsis --> <classsynopsis> <ooclass><classname>PharException</classname></ooclass> <!-- {{{ Class synopsis --> <classsynopsisinfo> <ooclass> <classname>PharException</classname> </ooclass> <ooclass> <modifier>extends</modifier> <classname>Exception</classname> </ooclass> </classsynopsisinfo> <!-- }}} --> <classsynopsisinfo role="comment">Propriétés</classsynopsisinfo> <!-- <classsynopsisinfo role="comment">Méthodes héritées</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.Exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> --> </classsynopsis> <!-- }}} --> </section> </partintro> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="PharException.intro.unused"> <refnamediv> <refname>PharException</refname> <refpurpose> La classe PharException fournit une classe d'exception spécifique à phar pour essayer/attraper des blocs.</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> </para> </refsect1> </refentry> </phpdoc:exceptionref> <!-- 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/PharFileInfo.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo.xml +++ phpdoc-fr/reference/phar/PharFileInfo.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.PharFileInfo" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> <title>La classe PharFileInfo</title> <titleabbrev>PharFileInfo</titleabbrev> <partintro> <!-- {{{ Phar intro --> <section xml:id="PharFileInfo.intro"> &reftitle.intro; <para> La classe PharFileInfo fournit une interface de haut niveau pour accéder au contenu et aux attributs d'un fichier contenu dans une archive phar. </para> </section> <!-- }}} --> <section xml:id="PharFileInfo.synopsis"> &reftitle.classsynopsis; <!-- {{{ Synopsis --> <classsynopsis> <ooclass><classname>PharFileInfo</classname></ooclass> <!-- {{{ Class synopsis --> <classsynopsisinfo> <ooclass> <classname>PharFileInfo</classname> </ooclass> <ooclass> <modifier>extends</modifier> <classname>SplFileInfo</classname> </ooclass> </classsynopsisinfo> <!-- }}} --> <classsynopsisinfo role="comment">Propriétés</classsynopsisinfo> <classsynopsisinfo role="comment">Méthodes</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.PharFileInfo')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> <!-- <classsynopsisinfo role="comment">Méthodes héritées</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.SplFileInfo')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> --> </classsynopsis> <!-- }}} --> </section> </partintro> &reference.phar.entities.PharFileInfo; </phpdoc:classref> <!-- 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/setup.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/setup.xml +++ phpdoc-fr/reference/phar/setup.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <chapter xml:id="phar.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="phar.requirements"> &reftitle.required; <para> Phar requiert PHP 5.2.0 ou plus récent. Des fonctionnalités supplémentaires requièrent l'extension <link linkend="book.spl">SPL</link> pour tirer parti de l'itération et de l'accès sous forme de tableau au contenu d'un fichier Phar. Le flux <literal>phar</literal> ne requiert aucune extension supplémentaire pour fonctionner. </para> <para> Vous pouvez éventuellement souhaiter activer les extensions <link linkend="book.zlib" >zlib</link> et <link linkend="book.bzip2" >bzip2</link> pour tirer parti du support phar compressé. De plus, pour exploiter les signatures OpenSSL, l'extension <link linkend="book.openssl">OpenSSL</link> doit être activée. </para> <para> A noter qu'un bogue dans le filtre de flux <link linkend="filters.compression">zlib.deflate</link> corrigé en PHP 5.2.6 et plus récent pourrait causer la troncature des archives phar compressées en gzip ou bzip2. </para> </section> <!-- }}} --> <!-- {{{ Installation --> &reference.phar.installation; <!-- }}} --> <!-- {{{ Configuration --> &reference.phar.ini; <!-- }}} --> <!-- {{{ Resources --> <section xml:id="phar.resources"> &reftitle.resources; <para> L'extension Phar fournit le flux <literal>phar</literal>, qui permet l'accès de façon transparente aux fichiers contenus dans un phar. Le format de fichier d'un Phar est décrit <link linkend="phar.fileformat">ici</link> </para> </section> <!-- }}} --> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: 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/using.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/using.xml +++ phpdoc-fr/reference/phar/using.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.14 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <chapter xml:id="phar.using" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Utiliser les archives Phar</title> <section xml:id="phar.using.intro" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Utiliser les archives Phar : Introduction</title> <para> Les archives Phar sont identiques dans le concept aux archives JAR de Java, mais sont conçues plus spécifiquement pour les besoins et la flexibilité des applications PHP. Une archive Phar est utilisée pour distribuer une application PHP complète ou une bibliothèque sous forme d'un fichier unique. A l'inverse de Java, aucun outil externe n'est requis pour manipuler ou exécuter une archive Phar PHP. Une application sous forme d'archive Phar est utilisée exactement de la même façon que n'importe quelle autre application PHP : </para> <screen> <![CDATA[ php applicationsympa.phar ]]> </screen> <para> L'utilisation d'une bibliothèque sous forme d'archive Phar est la même que n'importe quelle autre bibliothèque PHP : </para> <para> <informalexample> <programlisting role="php"> <![CDATA[ <?php include 'bibliothequesympa.phar'; ?> ]]> </programlisting> </informalexample> </para> <para> Le flux <literal>phar</literal> fournit le coeur de l'extension phar, et est décrit en détails <link linkend="phar.using.stream">ici</link>. Le flux phar permet l'accès aux fichiers contenus dans une archive phar via les fonctions standards de fichier <function>fopen</function>, <function>opendir</function>, et toute autre fonctionnant sur des fichiers normaux. Le flux <literal>phar</literal> supporte toutes les opérations de lecture/écriture à al fois su les fichiers et sur les répertoires. </para> <para> <informalexample> <programlisting role="php"> <![CDATA[ <?php include 'phar://bibliothequesympa.phar/fichier/interne.php'; header('Content-type: image/jpeg'); // les phars peuvent être atteint via le chemin complet ou via des alias echo file_get_contents('phar:///chemin/complet/vers/bibliothequesympa.phar/images/wow.jpg'); ?> ]]> </programlisting> </informalexample> </para> <para> La classe <classname>Phar</classname> implémente des fonctionnalités avancées pour accéder aux fichiers et créer des archives phar. La classe Phar est décrite en détails <link linkend="phar.using.object">ici</link>. </para> <para> <informalexample> <programlisting role="php"> <![CDATA[ <?php try { // ouvre un phar existant $p = new Phar('bibliothequesympa.phar', 0); // Phar étend la classe DirectoryIterator de SPL foreach (new RecursiveIteratorIterator($p) as $file) { // $file est une classe PharFileInfo et hérité de SplFileInfo echo $file->getFileName() . "\n"; echo file_get_contents($file->getPathName()) . "\n"; // affiche le contenu; } if (isset($p['fichier/interne.php'])) { var_dump($p['fichier/interne.php']->getMetaData()); } // crée un nouveau phar - phar.readonly doit être à 0 dans php.ini // phar.readonly est activé par défaut pour des raisons de sécurité. // Sur des serveurs de production, les Phars n'ont pas besoin d'être créés, // juste d'être exécutés. if (Phar::canWrite()) { $p = new Phar('nouveauphar.tar.phar', 0, 'nouveauphar.tar.phar'); // On crée une archive Phar basée sur tar, compressée par gzip (.tar.gz) $p = $p->convertToExecutable(Phar::TAR, Phar::GZ); // crée une transaction - rien n'est écrit dans nouveauphar.phar // jusqu'à ce que stopBuffering() ne soit appelé, bien qu'un stockage temporaire soit requis $p->startBuffering(); // ajoute tous les fichier de /chemin/vers/leprojet dans le phar avec le préfixe "projet" $p->buildFromIterator(new RecursiveIteratorIterator(new DirectoryIterator('/chemin/vers/leprojet')), '/chemin/vers/'); // ajoute un nouveau fichier en utilisant l'API d'accès par tableau $p['fichier1.txt'] = 'Information'; $fp = fopen('grosfichier.dat', 'rb'); // copie toutes les données du flux $p['data/grosfichier.dat'] = $fp; if (Phar::canCompress(Phar::GZ)) { $p['data/grosfichier.dat']->compress(Phar::GZ); } $p['images/wow.jpg'] = file_get_contents('images/wow.jpg'); // toute valeur peut être sauvegardée comme méta-donnée spécifique au fichier $p['images/wow.jpg']->setMetaData(array('mime-type' => 'image/jpeg')); $p['index.php'] = file_get_contents('index.php'); $p->setMetaData(array('bootstrap' => 'index.php')); // sauvegarde l'archive phar sur le disque $p->stopBuffering(); } } catch (Exception $e) { echo 'N\'a pas pu ouvrir le Phar: ', $e; } ?> ]]> </programlisting> </informalexample> </para> <para> D'autre part, la vérification du contenu du fichier phar peut être faite en utilisant un des algorithme de signature symétrique (MD5, SHA1, SHA256 et SHA512 si ext/hash est activée) et en utilisant la signature asymétrique par clé publique/privée de OpenSSL (nouveauté de Phar 2.0.0). Pour tirer parti de la signature OpenSSL, vous devez générer une paire de clés publique/privée et utiliser la clé privée pour signer avec <function>Phar::setSignatureAlgorithm</function>. En plus, la clé publique, extraite en utilisant ce code : <programlisting role="php"> <![CDATA[ $public = openssl_get_publickey(file_get_contents('private.pem')); $pkey = ''; openssl_pkey_export($public, $pkey); ]]> </programlisting> doit être sauvegardée à part de l'archive phar qu'elle vérifie. Si l'archive phar est sauvegardée en tant que <literal>/chemin/vers/mon.phar</literal>, la clé publique doit être sauvegardée en tant que <literal>/chemin/vers/mon.phar.pubkey</literal>, sans quoi phar ne sera pas capable de verifier la signature OpenSSL. </para> <para> Depuis la version 2.0.0, la classe <classname>Phar</classname> fournit aussi trois méthodes statiques, <function>Phar::webPhar</function>, <function>Phar::mungServer</function> et <function>Phar::interceptFileFuncs</function> qui sont cruciales pour empaqueter des applications PHP visant à être utilisée sur un système de fichier classique ou en tant qu'application web. <function>Phar::webPhar</function> implémente un contrôleur qui route les appels HTTP vers le bon endroit de l'archive phar. <function>Phar::mungServer</function> est utilisé pour modifier les valeurs du tableau <varname>$_SERVER</varname> pour dire aux applications d'utiliser ces valeurs. <function>Phar::interceptFileFuncs</function> dit à Phar d'intercepter les appels à <function>fopen</function>, <function>file_get_contents</function>, <function>opendir</function>, et à toutes les fonctions basées sur stat (<function>file_exists</function>, <function>is_readable</function>, etc) et route tous les chemins relatif vers les bons endroits de l'archive phar. </para> <para> Par exemple, empaqueter une version de la célèbre application phpMyAdmin dans une archive phar nécessite juste ce simple script et, dès lors, <literal>phpMyAdmin.phar.tar.php</literal> peut être accédé comme un fichier classique à partir de votre serveur web, après avoir modifié le couple utilisateur/motdepasse : </para> <para> <informalexample> <programlisting role="php"> <![CDATA[ <?php @unlink('phpMyAdmin.phar.tar.php'); copy('phpMyAdmin-2.11.3-english.tar.gz', 'phpMyAdmin.phar.tar.php'); $a = new Phar('phpMyAdmin.phar.tar.php'); $a->startBuffering(); $a["phpMyAdmin-2.11.3-english/config.inc.php"] = '<?php /* Servers configuration */ $i = 0; /* Server localhost (config:root) [1] */ $i++; $cfg[\'Servers\'][$i][\'host\'] = \'localhost\'; $cfg[\'Servers\'][$i][\'extension\'] = \'mysqli\'; $cfg[\'Servers\'][$i][\'connect_type\'] = \'tcp\'; $cfg[\'Servers\'][$i][\'compress\'] = false; $cfg[\'Servers\'][$i][\'auth_type\'] = \'config\'; $cfg[\'Servers\'][$i][\'user\'] = \'root\'; $cfg[\'Servers\'][$i][\'password\'] = \'\'; /* End of servers configuration */ if (strpos(PHP_OS, \'WIN\') !== false) { $cfg[\'UploadDir\'] = getcwd(); } else { $cfg[\'UploadDir\'] = \'/tmp/pharphpmyadmin\'; @mkdir(\'/tmp/pharphpmyadmin\'); @chmod(\'/tmp/pharphpmyadmin\', 0777); }'; $a->setStub('<?php Phar::interceptFileFuncs(); Phar::webPhar("phpMyAdmin.phar", "phpMyAdmin-2.11.3-english/index.php"); echo "phpMyAdmin is intended to be executed from a web browser\n"; exit -1; __HALT_COMPILER(); '); $a->stopBuffering(); ?> ]]> </programlisting> </informalexample> </para> </section> <section xml:id="phar.using.stream" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Utiliser les archives Phar : le flux phar</title> <para> Le flux Phar supporte totalement <function>fopen</function> pour les lectures, écritures, concaténations, <function>unlink</function>, <function>stat</function>, <function>fstat</function>, <function>fseek</function>, <function>rename</function> et le opérations de flux sur les répertoires <function>opendir</function> et depuis la version 2.0.0, <function>rmdir</function> et <function>mkdir</function>. </para> <para> La compression et les méta-données individuelles par fichier peuvent aussi être manipulées au sein de l'archive Phar en utilisant les contextes de flux : </para> <para> <informalexample> <programlisting role="php"> <![CDATA[ <?php $context = stream_context_create(array('phar' => array('compress' => Phar::GZ)), array('metadata' => array('user' => 'cellog'))); file_put_contents('phar://mon.phar/unfichier.php', 0, $context); ?> ]]> </programlisting> </informalexample> </para> <para> Le flux <literal>phar</literal> n'agit pas sur les fichiers distants et ne peut pas considérer les fichiers distants, etc... même si les options INI <link linkend="ini.allow-url-fopen">allow_url_fopen</link> et <link linkend="ini.allow-url-include">allow_url_include</link> sont désactivées. </para> <para> Bien qu'il soit possible de créer des archives phar de zéro en utilisant juste les opérations sur les flux, il est préférable d'utiliser la fonctionnalité incluse dans la classe Phar. Le flux est mieux utilisé pour les opérations de lecture. </para> </section> <section xml:id="phar.using.object" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Utiliser les archives Phar : les classes Phar et PharData</title> <para> La classe <classname>Phar</classname> supporte la lecture et la manipulation des archives Phar, ainsi que l'itération à travers la fonctionnalité héritée de la classe <link xlink:href="http://www.php.net/~helly/php/ext/spl/classRecursiveDirectoryIterator.html"><classname>RecursiveDirectoryIterator</classname></link>. Avec le support de l'interface <classname>ArrayAccess</classname>, les fichiers contenus dans une archive Phar peuvent être accédés comme s'ils étaient membres d'un tableau associatif. </para> <para> La classe <classname>PharData</classname> étend la classe <classname>Phar</classname>, et permet la création et la modification d'archives tar et zip non exécutables (données) même si <literal>phar.readonly</literal>=1 dans php.ini. Ainsi, <function>PharData::setAlias</function> et <function>PharData::setStub</function> sont toutes deux désactivées car les concepts d'alias et de conteneur sont restreints aux archives phar exécutables. </para> <para> Il est important de noter que quand une archive Phar est créée, le chemin complet doit être passé au constructeur de l'objet <classname>Phar</classname>. Un chemin relatif empêcherait l'initialisation. </para> <para> En supposant que <literal>$p</literal> est un objet initialisé de cette façon : </para> <para> <informalexample> <programlisting role="php"> <![CDATA[ <?php $p = new Phar('/chemin/vers/monphar.phar', 0, 'monphar.phar'); ?> ]]> </programlisting> </informalexample> </para> <para> Une archive Phar vide sera créée en tant que <literal>/chemin/vers/monphar.phar</literal>, ou si <literal>/chemin/vers/monphar.phar</literal> existe déjà, il sera ouvert de nouveau. Le terme <literal>monphar.phar</literal> démontre le concept d'un alias qui peut être utilisé pour référencer <literal>/chemin/vers/monphar.phar</literal> dans des URL comme ceci : </para> <para> <informalexample> <programlisting role="php"> <![CDATA[ <?php // ces deux appels à file_get_contents() sont équivalents si // /chemin/vers/monphar.phar a un alias explicite de "monphar.phar" // dans son mainfeste, ou si le phar a été initialisé avec l'instantiation de // l'objet Phar de l'exemple précedent $f = file_get_contents('phar:///chemin/vers/monphar.phar/nimportequoi.txt'); $f = file_get_contents('phar://monphar.phar/nimportequoi.txt'); ?> ]]> </programlisting> </informalexample> </para> <para> Avec l'objet <classname>Phar</classname> <literal>$p</literal> nouvellement créé, les choses suivantes sont possibles : <itemizedlist> <listitem> <simpara> <literal>$a = $p['fichier.php']</literal> crée une <classname>PharFileInfo</classname> qui réfère au contenu de <literal>phar://monphar.phar/fichier.php</literal> </simpara> </listitem> <listitem> <simpara> <literal>$p['fichier.php'] = $v</literal> crée un nouveau fichier (<literal>phar://monphar.phar/fichier.php</literal>), ou écrase un fichier existat au sein de <literal>monphar.phar</literal>. <literal>$v</literal> peut être soit une chaîne ou un pointeur vers un fichier ouvert, dans quel cas le contenu du fchier sera utilisé pour créer le nouveau fichier. Notez que <literal>$p->addFromString('fichier.php', $v)</literal> est équivalent en terme de fonctionnalité au cas ci-dessus. Il est aussi possible d'ajouter le contenu d'un fichier avec <literal>$p->addFile('/chemin/vers/fichier.php', 'fichier.php')</literal>. Enfin, un répertoire vide peut être créé avec <literal>$p->addEmptyDir('vide')</literal>. </simpara> </listitem> <listitem> <simpara> <literal>isset($p['fichier.php'])</literal> peut être utilisé pour déterminer si <literal>phar://monphar.phar/fichier.php</literal> existe au sein de <literal>monphar.phar</literal>. </simpara> </listitem> <listitem> <simpara> <literal>unset($p['fichier.php'])</literal> efface <literal>phar://monphar.phar/fichier.php</literal> de <literal>monphar.phar</literal>. </simpara> </listitem> </itemizedlist> </para> <para> De plus, l'object <classname>Phar</classname> est le seul moyen d'accéder aux méta-données spécifiques à Phar, via <function>Phar::getMetaData</function>, et c'est aussi le seul moyen de régler ou de récupérer le conteneur du chargeur de l'archive Phar via <function>Phar::getStub</function> et <function>Phar::setStub</function>. De plus, la compression pour l'archive Phar entière peut être manipulée seulement via la classe <classname>Phar</classname>. </para> <para> La liste complète des fonctionnalités de l'objet <classname>Phar</classname> est documentée ci-dessous. </para> <para> La classe <classname>PharFileInfo</classname> étend la classe <link xlink:href="http://www.php.net/~helly/php/ext/spl/classSplFileInfo.html"><classname>SplFileInfo</classname></link> et ajoute plusieurs méthodes pour manipuler les méta-données spécifiques à Phar d'un fichier contenu dans un Phar, telles que manipuler la compresssion ou les méta-données. </para> </section> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->