cvs: phpdoc-fr /reference/phar/Phar running.xml startBuffering.xml stopBuffering.xml uncompressAllFiles.xml unlinkArchive.xml webPhar.xml
| From: | Guillaume Plessis | Date: | Tue, 20 Jan 2009 21:49:53 +0000 |
| Subject: | cvs: phpdoc-fr /reference/phar/Phar running.xml startBuffering.xml stopBuffering.xml uncompressAllFiles.xml unlinkArchive.xml webPhar.xml | ||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-6384@lists.php.net to get a copy of this message | ||
gui Tue Jan 20 21:49:53 2009 UTC
Added files:
/phpdoc-fr/reference/phar/Phar running.xml startBuffering.xml
stopBuffering.xml
uncompressAllFiles.xml
unlinkArchive.xml webPhar.xml
Log:
initial translation
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/Phar/running.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/running.xml +++ phpdoc-fr/reference/phar/Phar/running.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xml:id="phar.running" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Phar::running</refname> <refpurpose>Retourne le chemin complet sur le disque ou l'URL phar complète de l'archive phar couramment exécutée</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>Phar::running</methodname> <methodparam choice="opt"><type>bool</type><parameter>retphar</parameter><initializer>true</initializer></methodparam> </methodsynopsis> <para> Retourne le chemin complet de l'archive phar exécutée. C'est bien entendu utilisé un peu comme la constante magique <literal>__FILE__</literal> et a des effets uniquement au sein d'une archive phar en train d'être exécutée. </para> <para> Dans le conteneur de chargement d'une archive, <function>Phar::running</function> retourne <literal>""</literal>. Utilisez simplement <constant>__FILE__</constant> pour accéder au ohar courant au sein d'un conteneur de chargement. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>retphar</parameter></term> <listitem> <para> &true; Par défaut. si &false;, le chemin complet sur le disque vers le phar est retourné. Si &true; (valeur par défaut), une URL phar complète est retournée. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne le chemin de fichier si valide, sinon une chaîne vide. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::running</function></title> <para> Pour l'exemple suivant, on suppose que le fichier est au sein de l'archive phar <literal>/chemin/vers/mon.phar</literal> et qu'il y est nommé <literal>mon/fichier.txt</literal>. </para> <programlisting role="php"> <![CDATA[ <?php $a = Phar::running(); // $a vaut "phar:///chemin/vers/mon.phar" $b = Phar::running(false); // $b vaut "/chemin/vers/mon.phar" ?> ]]> </programlisting> </example> </para> </refsect1> </refentry> <!-- 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/Phar/startBuffering.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/startBuffering.xml +++ phpdoc-fr/reference/phar/Phar/startBuffering.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.startbuffering"> <refnamediv> <refname>Phar::startBuffering</refname> <refpurpose>Démarre la mise en tampon de écritures Phar, ne modifie pas l'objet Phar sur le disque</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>Phar::startBuffering</methodname> <void/> </methodsynopsis> <para> Bien que techniquement inutile, la méthode <function>startBuffering</function> peut fournir un gain de performance lors de la création ou la modification d'une archive Phar avec un grand nombre de fichiers. D'ordinaire, chaque fois qu'un fichier au sein de l'archive Phar est créé ou modifié, l'archive Phar entière et recréée en incluant les changements. De cette manière, l'archive sera toujours à jour vis à vis des opération qui y sont appliquées. </para> <para> Alors que ceci peut paraître inutile lors de la création d'un archive Phar simple, ça prend tout son sens lors de l'écriture en une fois de l'archive Phar entière. De même, il est souvent nécessaire de faire une série de changements et de s'assurer qu'ils sont tous possibles avant d'écrire sur le disque, un peu comme les transactions des base de données relationnelles. Les fonctions <function>startBuffering</function>/<function>stopBuffering</function> sont disponibles dans ce but. </para> <para> La mise en tampon Phar s'effectue par archive, le tampon actif pour l'archive Phar <literal>foo.phar</literal> n'affecte pas les changements faits à l'archive Phar <literal>bar.phar</literal>. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::startBuffering</function></title> <para> </para> <programlisting role="php"> <![CDATA[ <?php // on s'assure que le phar n'existe pas déjà @unlink('nouveau.phar'); try { $p = new Phar(dirname(__FILE__) . '/nouveau.phar', 0, 'nouveau.phar'); } catch (Exception $e) { echo 'Ne peut pas créer le phar:', $e; } echo 'Le nouveau phar a ' . $p->count() . " entrées\n"; $p->startBuffering(); $p['fichier.txt'] = 'salut'; $p['fichier2.txt'] = 'jolie'; $p['fichier2.txt']->setCompressedGZ(); $p['fichier3.txt'] = 'môme'; $p['fichier3.txt']->setMetaData(42); $p->setStub("<?php function __autoload($class) { include 'phar://monphar.phar/' . str_replace('_', '/', $class) . '.php'; } Phar::mapPhar('monphar.phar'); include 'phar://monphar.phar/demarrage.php'; __HALT_COMPILER();"); $p->stopBuffering(); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::stopBuffering</function></member> <member><function>Phar::isBuffering</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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/Phar/stopBuffering.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/stopBuffering.xml +++ phpdoc-fr/reference/phar/Phar/stopBuffering.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.stopbuffering"> <refnamediv> <refname>Phar::stopBuffering</refname> <refpurpose>Arrête la mise en tampon des écritures Phar et provoque l'écriture que le disque</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>Phar::stopBuffering</methodname> <void/> </methodsynopsis> <para> <function>stopBuffering</function> est utilisée en conjonction avec la méthode <function>startBuffering</function>. <function>startBuffering</function> peut fournir un gain de performance lors de la création ou la modification d'une archive Phar avec un grand nombre de fichiers. D'ordinaire, chaque fois qu'un fichier au sein de l'archive Phar est créé ou modifié, l'archive Phar entière et recréée en incluant les changements. De cette manière, l'archive sera toujours à jour vis à vis des opération qui y sont appliquées. </para> <para> Alors que ceci peut paraître inutile lors de la création d'un archive Phar simple, ça prend tout son sens lors de l'écriture en une fois de l'archive Phar entière. De même, il est souvent nécessaire de faire une série de changements et de s'assurer qu'ils sont tous possibles avant d'écrire sur le disque, un peu comme les transactions des base de données relationnelles. Les fonctions <function>startBuffering</function>/<function>stopBuffering</function> sont disponibles dans ce but. </para> <para> La mise en tampon Phar s'effectue par archive, le tampon actif pour l'archive Phar <literal>foo.phar</literal> n'affecte pas les changements faits à l'archive Phar <literal>bar.phar</literal>. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Une exception <classname>PharException</classname> est levée si des problèmes sont rencontrés lors de l'écriture des changements sur le disque. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple <function>Phar::stopBuffering</function></title> <para> </para> <programlisting role="php"> <![CDATA[ <?php $p = new Phar(dirname(__FILE__) . '/nouveau.phar', 0, 'nouveau.phar'); $p['fichier1.txt'] = 'salut'; $p->startBuffering(); var_dump($p->getStub()); $p->setStub("<?php function __autoload(\$class) { include 'phar://nouveau.phar/' . str_replace('_', '/', \$class) . '.php'; } Phar::mapPhar('nouveau.phar'); include 'phar://nouveau.phar/demarrage.php'; __HALT_COMPILER();"); $p->stopBuffering(); var_dump($p->getStub()); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ string(24) "<?php __HALT_COMPILER();" string(195) "<?php function __autoload($class) { include 'phar://' . str_replace('_', '/', $class); } Phar::mapPhar('nouveau.phar'); include 'phar://nouveau.phar/demarrage.php'; __HALT_COMPILER();" ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::startBuffering</function></member> <member><function>Phar::isBuffering</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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/Phar/uncompressAllFiles.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/uncompressAllFiles.xml +++ phpdoc-fr/reference/phar/Phar/uncompressAllFiles.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.uncompressallfiles"> <refnamediv> <refname>Phar::uncompressAllFiles</refname> <refpurpose>Décompresse tous les fichiers de l'archive Phar courante</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>Phar::uncompressAllFiles</methodname> <void/> </methodsynopsis> &phar.removed.pharcompress; &phar.write; <para> Cette méthode décompresser tous les fichier de l'archive Phar. Si un des fichiers est déjà compressé en utilisant la compression gzip, l'extension <link linkend="ref.zlib">zlib</link> doit être activée pour décompresser le fichier, et si un des fichiers est déjà compressé en utilisant la compression bzip2, l'extension <link linkend="ref.bzip2">bzip2</link> doit être activée pour décompresser le fichier. Comme avec toutes les fonctionnalités qui modifient le contenu d'un As with all functionality that modifies the contents of phar, la variable INI <link linkend="ini.phar.readonly">phar.readonly</link> doit être à off pour que ça fonctionne. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Lève une exception <classname>BadMethodCallException</classname> si la variable INI <link linkend="ini.phar.readonly">phar.readonly</link> est à on, si l'extension <link linkend="ref.bzip2">bzip2</link> n'est pas activée alors qu'au moins un fichier est compressé avec la compression bzip2 ou si au moins un des fichiers est compressé avec la compression gzip et que l'extension <link linkend="ref.zlib">zlib</link> n'est pas activée. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::uncompressAllFiles</function></title> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $p['monfichier2.txt'] = 'salut'; $p->compressAllFilesGZ(); foreach ($p as $file) { var_dump($file->getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressedBZIP2()); var_dump($file->isCompressedGZ()); } $p->uncompressAllFiles(); foreach ($p as $file) { var_dump($file->getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressedBZIP2()); var_dump($file->isCompressedGZ()); } } catch (Exception $e) { echo 'Les opération d'écriture sur mon.phar ont échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ string(10) "monfichiere.txt" bool(true) bool(false) bool(true) string(11) "monfichier2.txt" bool(true) bool(false) bool(true) string(10) "monfichier.txt" bool(false) bool(false) bool(false) string(11) "monfichier2.txt" bool(false) bool(false) bool(false) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::getCompressedSize</function></member> <member><function>PharFileInfo::isCompressedBZIP2</function></member> <member><function>PharFileInfo::isCompressed</function></member> <member><function>PharFileInfo::isCompressedGZ</function></member> <member><function>PharFileInfo::setCompressedBZIP2</function></member> <member><function>PharFileInfo::setUncompressed</function></member> <member><function>PharFileInfo::setCompressedGZ</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compressAllFilesBZIP2</function></member> <member><function>Phar::compressAllFilesGZ</function></member> <member><function>Phar::getSupportedCompression</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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/Phar/unlinkArchive.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/unlinkArchive.xml +++ phpdoc-fr/reference/phar/Phar/unlinkArchive.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xml:id="phar.unlinkarchive" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Phar::unlinkArchive</refname> <refpurpose>Efface complètement une archive phar du disque et de la mémoire</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>Phar::unlinkArchive</methodname> <methodparam><type>string</type><parameter>archive</parameter></methodparam> </methodsynopsis> <para> </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>archive</parameter></term> <listitem> <para> Le chemin sur le disque vers l'archive phar. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne &true; si l'archive est effacée du disque avec succès. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Une exception <classname>PharException</classname> est levée si des pointeurs sont ouverts vers des fichiers de l'archive phar, ou si des objets <classname>Phar</classname>, <classname>PharData</classname>, ou <classname>PharFileInfo</classname> réfèrent à l'archive phar. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::unlinkArchive</function></title> <programlisting role="php"> <![CDATA[ <?php // utilisation simple Phar::unlinkArchive('/chemin/vers/mon.phar'); // un exemple plus commun : $p = new Phar('mon.phar'); $fp = fopen('phar://mon.phar/fichier.txt', 'r'); // cela crée 'mon.phar.gz' $gp = $p->compress(Phar::GZ); // enlève toutes les références à l'archive unset($p); fclose($fp); // efface maintenant toute trace de l'archive Phar::unlinkArchive('mon.phar'); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::delete</function></member> <member><function>Phar::offsetUnset</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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/Phar/webPhar.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/webPhar.xml +++ phpdoc-fr/reference/phar/Phar/webPhar.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xml:id="phar.webphar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Phar::webPhar</refname> <refpurpose>mapPhar pour les phars orientés web. Contrôleur pour les applications web</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>Phar::webPhar</methodname> <methodparam choice="opt"><type>string</type><parameter>alias</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>index</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>f404</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>mimetypes</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>rewrites</parameter></methodparam> </methodsynopsis> <para> <function>Phar::mapPhar</function> pour les phars orientés web. Cette méthode parse <varname>$_SERVER['REQUEST_URI']</varname> et route les requêtes d'un navigateur vers un fichier interne à l'archive. Dans le principe, cela simule un serveur web, en routant des requêtes vers le bon fichier, en envoyant les bons en-têtes et parsant le fichier PHP comme il convient. Cette méthode puissante permet de convertir facilement des applications PHP en archive phar. Combinée avec <function>Phar::mungServer</function> et <function>Phar::interceptFileFuncs</function>, n'importe quelle application web peut être utilisée sans changement à partir de l'archive phar. </para> <para> <function>Phar::webPhar</function> doit être appelé uniquement à partir du conteneur de chargement d'une archive phar (lisez <link linkend="phar.fileformat.stub">ceci</link> pour en savoir davantage sur les conteneurs). </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>alias</parameter></term> <listitem> <para> L'alias qui peut être utilisé dans l'URL <literal>phar://</literal> pour se référer à l'archive, plutôt que son chemin complet. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>index</parameter></term> <listitem> <para> L'emplacement au sein de l'archive de l'index de répertoire, par défaut <literal>index.php</literal>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>f404</parameter></term> <listitem> <para> L'emplacement du script à exécuter quand un fichier n'est pas trouvé. Ce script doit envoyer des en-têtes HTTP 404 corrects. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>mimetypes</parameter></term> <listitem> <para> Un tableau faisant correspondre des extensions de fichier supplémentaires à des types MIME. Par défaut, ces correspondances sont les suivantes : <programlisting role="php"> <![CDATA[ $mimes = array( 'phps' => 2, // passage vers highlight_file() 'c' => 'text/plain', 'cc' => 'text/plain', 'cpp' => 'text/plain', 'c++' => 'text/plain', 'dtd' => 'text/plain', 'h' => 'text/plain', 'log' => 'text/plain', 'rng' => 'text/plain', 'txt' => 'text/plain', 'xsd' => 'text/plain', 'php' => 1, // parse en tant que PHP 'inc' => 1, // parse en tant que PHP 'avi' => 'video/avi', 'bmp' => 'image/bmp', 'css' => 'text/css', 'gif' => 'image/gif', 'htm' => 'text/html', 'html' => 'text/html', 'htmls' => 'text/html', 'ico' => 'image/x-ico', 'jpe' => 'image/jpeg', 'jpg' => 'image/jpeg', 'jpeg' => 'image/jpeg', 'js' => 'application/x-javascript', 'midi' => 'audio/midi', 'mid' => 'audio/midi', 'mod' => 'audio/mod', 'mov' => 'movie/quicktime', 'mp3' => 'audio/mp3', 'mpg' => 'video/mpeg', 'mpeg' => 'video/mpeg', 'pdf' => 'application/pdf', 'png' => 'image/png', 'swf' => 'application/shockwave-flash', 'tif' => 'image/tiff', 'tiff' => 'image/tiff', 'wav' => 'audio/wav', 'xbm' => 'image/xbm', 'xml' => 'text/xml', ); ]]> </programlisting> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>rewrites</parameter></term> <listitem> <para> Un tableau faisant correspondre des URI à des fichiers internes, simulant le mod_rewrite de apache. Par exemple: <programlisting role="php"> <![CDATA[ array( 'moninfo' => 'moninfo.php' ); ]]> </programlisting> routera les appels à <literal>http://<hôte>/monphar.phar/moninfo</literal> vers le fichier <literal>phar:///chemin/vers/monphar.phar/moninfo.php</literal>, en préservant les GET/POST. Ca ne fonctionne pas tout à fait comme mod_rewrite car ça ne fera pas correspondre <literal>http://<hôte>/monphar.phar/moninfo/unautre</literal>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Pas de valeur de retour </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Lève une exception <classname>PharException</classname> quand le fichier interne ne peut pas être ouvert ou si l'appel est fait en dehors d'un conteneur. Si un valeur de tableau non valide est passée dans <parameter>mimetypes</parameter> ou dans <parameter>rewrites</parameter>, une exception <classname>UnexpectedValueException</classname> est levée. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::webPhar</function></title> <para> Dans l'exemple ci-dessous, le phar créé affichera <literal>Salut tout le monde</literal> si quelqu'un appelle <literal>/monphar.phar/index.php</literal> ou <literal>/monphar.phar</literal>, et affichera la source de <literal>index.phps</literal> si <literal>/monphar.phar/index.phps</literal> est appelé. </para> <programlisting role="php"> <![CDATA[ <?php // l'archive phar est créée : try { $phar = new Phar('monphar.phar'); $phar['index.php'] = '<?php echo "Salut tout le monde"; ?>'; $phar['index.phps'] = '<?php echo "Salut tout le monde"; ?>'; $phar->setStub('<?php Phar::webPhar(); __HALT_COMPILER(); ?>'); } catch (Exception $e) { // on traite les erreurs ici } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::mungServer</function></member> <member><function>Phar::interceptFileFuncs</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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/Phar/running.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/running.xml +++ phpdoc-fr/reference/phar/Phar/running.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xml:id="phar.running" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Phar::running</refname> <refpurpose>Retourne le chemin complet sur le disque ou l'URL phar complète de l'archive phar couramment exécutée</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>Phar::running</methodname> <methodparam choice="opt"><type>bool</type><parameter>retphar</parameter><initializer>true</initializer></methodparam> </methodsynopsis> <para> Retourne le chemin complet de l'archive phar exécutée. C'est bien entendu utilisé un peu comme la constante magique <literal>__FILE__</literal> et a des effets uniquement au sein d'une archive phar en train d'être exécutée. </para> <para> Dans le conteneur de chargement d'une archive, <function>Phar::running</function> retourne <literal>""</literal>. Utilisez simplement <constant>__FILE__</constant> pour accéder au ohar courant au sein d'un conteneur de chargement. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>retphar</parameter></term> <listitem> <para> &true; Par défaut. si &false;, le chemin complet sur le disque vers le phar est retourné. Si &true; (valeur par défaut), une URL phar complète est retournée. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne le chemin de fichier si valide, sinon une chaîne vide. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::running</function></title> <para> Pour l'exemple suivant, on suppose que le fichier est au sein de l'archive phar <literal>/chemin/vers/mon.phar</literal> et qu'il y est nommé <literal>mon/fichier.txt</literal>. </para> <programlisting role="php"> <![CDATA[ <?php $a = Phar::running(); // $a vaut "phar:///chemin/vers/mon.phar" $b = Phar::running(false); // $b vaut "/chemin/vers/mon.phar" ?> ]]> </programlisting> </example> </para> </refsect1> </refentry> <!-- 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/Phar/startBuffering.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/startBuffering.xml +++ phpdoc-fr/reference/phar/Phar/startBuffering.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.startbuffering"> <refnamediv> <refname>Phar::startBuffering</refname> <refpurpose>Démarre la mise en tampon de écritures Phar, ne modifie pas l'objet Phar sur le disque</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>Phar::startBuffering</methodname> <void/> </methodsynopsis> <para> Bien que techniquement inutile, la méthode <function>startBuffering</function> peut fournir un gain de performance lors de la création ou la modification d'une archive Phar avec un grand nombre de fichiers. D'ordinaire, chaque fois qu'un fichier au sein de l'archive Phar est créé ou modifié, l'archive Phar entière et recréée en incluant les changements. De cette manière, l'archive sera toujours à jour vis à vis des opération qui y sont appliquées. </para> <para> Alors que ceci peut paraître inutile lors de la création d'un archive Phar simple, ça prend tout son sens lors de l'écriture en une fois de l'archive Phar entière. De même, il est souvent nécessaire de faire une série de changements et de s'assurer qu'ils sont tous possibles avant d'écrire sur le disque, un peu comme les transactions des base de données relationnelles. Les fonctions <function>startBuffering</function>/<function>stopBuffering</function> sont disponibles dans ce but. </para> <para> La mise en tampon Phar s'effectue par archive, le tampon actif pour l'archive Phar <literal>foo.phar</literal> n'affecte pas les changements faits à l'archive Phar <literal>bar.phar</literal>. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::startBuffering</function></title> <para> </para> <programlisting role="php"> <![CDATA[ <?php // on s'assure que le phar n'existe pas déjà @unlink('nouveau.phar'); try { $p = new Phar(dirname(__FILE__) . '/nouveau.phar', 0, 'nouveau.phar'); } catch (Exception $e) { echo 'Ne peut pas créer le phar:', $e; } echo 'Le nouveau phar a ' . $p->count() . " entrées\n"; $p->startBuffering(); $p['fichier.txt'] = 'salut'; $p['fichier2.txt'] = 'jolie'; $p['fichier2.txt']->setCompressedGZ(); $p['fichier3.txt'] = 'môme'; $p['fichier3.txt']->setMetaData(42); $p->setStub("<?php function __autoload($class) { include 'phar://monphar.phar/' . str_replace('_', '/', $class) . '.php'; } Phar::mapPhar('monphar.phar'); include 'phar://monphar.phar/demarrage.php'; __HALT_COMPILER();"); $p->stopBuffering(); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::stopBuffering</function></member> <member><function>Phar::isBuffering</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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/Phar/stopBuffering.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/stopBuffering.xml +++ phpdoc-fr/reference/phar/Phar/stopBuffering.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.stopbuffering"> <refnamediv> <refname>Phar::stopBuffering</refname> <refpurpose>Arrête la mise en tampon des écritures Phar et provoque l'écriture que le disque</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>Phar::stopBuffering</methodname> <void/> </methodsynopsis> <para> <function>stopBuffering</function> est utilisée en conjonction avec la méthode <function>startBuffering</function>. <function>startBuffering</function> peut fournir un gain de performance lors de la création ou la modification d'une archive Phar avec un grand nombre de fichiers. D'ordinaire, chaque fois qu'un fichier au sein de l'archive Phar est créé ou modifié, l'archive Phar entière et recréée en incluant les changements. De cette manière, l'archive sera toujours à jour vis à vis des opération qui y sont appliquées. </para> <para> Alors que ceci peut paraître inutile lors de la création d'un archive Phar simple, ça prend tout son sens lors de l'écriture en une fois de l'archive Phar entière. De même, il est souvent nécessaire de faire une série de changements et de s'assurer qu'ils sont tous possibles avant d'écrire sur le disque, un peu comme les transactions des base de données relationnelles. Les fonctions <function>startBuffering</function>/<function>stopBuffering</function> sont disponibles dans ce but. </para> <para> La mise en tampon Phar s'effectue par archive, le tampon actif pour l'archive Phar <literal>foo.phar</literal> n'affecte pas les changements faits à l'archive Phar <literal>bar.phar</literal>. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Une exception <classname>PharException</classname> est levée si des problèmes sont rencontrés lors de l'écriture des changements sur le disque. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple <function>Phar::stopBuffering</function></title> <para> </para> <programlisting role="php"> <![CDATA[ <?php $p = new Phar(dirname(__FILE__) . '/nouveau.phar', 0, 'nouveau.phar'); $p['fichier1.txt'] = 'salut'; $p->startBuffering(); var_dump($p->getStub()); $p->setStub("<?php function __autoload(\$class) { include 'phar://nouveau.phar/' . str_replace('_', '/', \$class) . '.php'; } Phar::mapPhar('nouveau.phar'); include 'phar://nouveau.phar/demarrage.php'; __HALT_COMPILER();"); $p->stopBuffering(); var_dump($p->getStub()); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ string(24) "<?php __HALT_COMPILER();" string(195) "<?php function __autoload($class) { include 'phar://' . str_replace('_', '/', $class); } Phar::mapPhar('nouveau.phar'); include 'phar://nouveau.phar/demarrage.php'; __HALT_COMPILER();" ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::startBuffering</function></member> <member><function>Phar::isBuffering</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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/Phar/uncompressAllFiles.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/uncompressAllFiles.xml +++ phpdoc-fr/reference/phar/Phar/uncompressAllFiles.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.uncompressallfiles"> <refnamediv> <refname>Phar::uncompressAllFiles</refname> <refpurpose>Décompresse tous les fichiers de l'archive Phar courante</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>Phar::uncompressAllFiles</methodname> <void/> </methodsynopsis> &phar.removed.pharcompress; &phar.write; <para> Cette méthode décompresser tous les fichier de l'archive Phar. Si un des fichiers est déjà compressé en utilisant la compression gzip, l'extension <link linkend="ref.zlib">zlib</link> doit être activée pour décompresser le fichier, et si un des fichiers est déjà compressé en utilisant la compression bzip2, l'extension <link linkend="ref.bzip2">bzip2</link> doit être activée pour décompresser le fichier. Comme avec toutes les fonctionnalités qui modifient le contenu d'un As with all functionality that modifies the contents of phar, la variable INI <link linkend="ini.phar.readonly">phar.readonly</link> doit être à off pour que ça fonctionne. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Lève une exception <classname>BadMethodCallException</classname> si la variable INI <link linkend="ini.phar.readonly">phar.readonly</link> est à on, si l'extension <link linkend="ref.bzip2">bzip2</link> n'est pas activée alors qu'au moins un fichier est compressé avec la compression bzip2 ou si au moins un des fichiers est compressé avec la compression gzip et que l'extension <link linkend="ref.zlib">zlib</link> n'est pas activée. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::uncompressAllFiles</function></title> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $p['monfichier2.txt'] = 'salut'; $p->compressAllFilesGZ(); foreach ($p as $file) { var_dump($file->getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressedBZIP2()); var_dump($file->isCompressedGZ()); } $p->uncompressAllFiles(); foreach ($p as $file) { var_dump($file->getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressedBZIP2()); var_dump($file->isCompressedGZ()); } } catch (Exception $e) { echo 'Les opération d'écriture sur mon.phar ont échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ string(10) "monfichiere.txt" bool(true) bool(false) bool(true) string(11) "monfichier2.txt" bool(true) bool(false) bool(true) string(10) "monfichier.txt" bool(false) bool(false) bool(false) string(11) "monfichier2.txt" bool(false) bool(false) bool(false) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::getCompressedSize</function></member> <member><function>PharFileInfo::isCompressedBZIP2</function></member> <member><function>PharFileInfo::isCompressed</function></member> <member><function>PharFileInfo::isCompressedGZ</function></member> <member><function>PharFileInfo::setCompressedBZIP2</function></member> <member><function>PharFileInfo::setUncompressed</function></member> <member><function>PharFileInfo::setCompressedGZ</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compressAllFilesBZIP2</function></member> <member><function>Phar::compressAllFilesGZ</function></member> <member><function>Phar::getSupportedCompression</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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/Phar/unlinkArchive.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/unlinkArchive.xml +++ phpdoc-fr/reference/phar/Phar/unlinkArchive.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xml:id="phar.unlinkarchive" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Phar::unlinkArchive</refname> <refpurpose>Efface complètement une archive phar du disque et de la mémoire</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>Phar::unlinkArchive</methodname> <methodparam><type>string</type><parameter>archive</parameter></methodparam> </methodsynopsis> <para> </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>archive</parameter></term> <listitem> <para> Le chemin sur le disque vers l'archive phar. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne &true; si l'archive est effacée du disque avec succès. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Une exception <classname>PharException</classname> est levée si des pointeurs sont ouverts vers des fichiers de l'archive phar, ou si des objets <classname>Phar</classname>, <classname>PharData</classname>, ou <classname>PharFileInfo</classname> réfèrent à l'archive phar. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::unlinkArchive</function></title> <programlisting role="php"> <![CDATA[ <?php // utilisation simple Phar::unlinkArchive('/chemin/vers/mon.phar'); // un exemple plus commun : $p = new Phar('mon.phar'); $fp = fopen('phar://mon.phar/fichier.txt', 'r'); // cela crée 'mon.phar.gz' $gp = $p->compress(Phar::GZ); // enlève toutes les références à l'archive unset($p); fclose($fp); // efface maintenant toute trace de l'archive Phar::unlinkArchive('mon.phar'); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::delete</function></member> <member><function>Phar::offsetUnset</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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/Phar/webPhar.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/webPhar.xml +++ phpdoc-fr/reference/phar/Phar/webPhar.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xml:id="phar.webphar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Phar::webPhar</refname> <refpurpose>mapPhar pour les phars orientés web. Contrôleur pour les applications web</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>Phar::webPhar</methodname> <methodparam choice="opt"><type>string</type><parameter>alias</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>index</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>f404</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>mimetypes</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>rewrites</parameter></methodparam> </methodsynopsis> <para> <function>Phar::mapPhar</function> pour les phars orientés web. Cette méthode parse <varname>$_SERVER['REQUEST_URI']</varname> et route les requêtes d'un navigateur vers un fichier interne à l'archive. Dans le principe, cela simule un serveur web, en routant des requêtes vers le bon fichier, en envoyant les bons en-têtes et parsant le fichier PHP comme il convient. Cette méthode puissante permet de convertir facilement des applications PHP en archive phar. Combinée avec <function>Phar::mungServer</function> et <function>Phar::interceptFileFuncs</function>, n'importe quelle application web peut être utilisée sans changement à partir de l'archive phar. </para> <para> <function>Phar::webPhar</function> doit être appelé uniquement à partir du conteneur de chargement d'une archive phar (lisez <link linkend="phar.fileformat.stub">ceci</link> pour en savoir davantage sur les conteneurs). </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>alias</parameter></term> <listitem> <para> L'alias qui peut être utilisé dans l'URL <literal>phar://</literal> pour se référer à l'archive, plutôt que son chemin complet. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>index</parameter></term> <listitem> <para> L'emplacement au sein de l'archive de l'index de répertoire, par défaut <literal>index.php</literal>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>f404</parameter></term> <listitem> <para> L'emplacement du script à exécuter quand un fichier n'est pas trouvé. Ce script doit envoyer des en-têtes HTTP 404 corrects. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>mimetypes</parameter></term> <listitem> <para> Un tableau faisant correspondre des extensions de fichier supplémentaires à des types MIME. Par défaut, ces correspondances sont les suivantes : <programlisting role="php"> <![CDATA[ $mimes = array( 'phps' => 2, // passage vers highlight_file() 'c' => 'text/plain', 'cc' => 'text/plain', 'cpp' => 'text/plain', 'c++' => 'text/plain', 'dtd' => 'text/plain', 'h' => 'text/plain', 'log' => 'text/plain', 'rng' => 'text/plain', 'txt' => 'text/plain', 'xsd' => 'text/plain', 'php' => 1, // parse en tant que PHP 'inc' => 1, // parse en tant que PHP 'avi' => 'video/avi', 'bmp' => 'image/bmp', 'css' => 'text/css', 'gif' => 'image/gif', 'htm' => 'text/html', 'html' => 'text/html', 'htmls' => 'text/html', 'ico' => 'image/x-ico', 'jpe' => 'image/jpeg', 'jpg' => 'image/jpeg', 'jpeg' => 'image/jpeg', 'js' => 'application/x-javascript', 'midi' => 'audio/midi', 'mid' => 'audio/midi', 'mod' => 'audio/mod', 'mov' => 'movie/quicktime', 'mp3' => 'audio/mp3', 'mpg' => 'video/mpeg', 'mpeg' => 'video/mpeg', 'pdf' => 'application/pdf', 'png' => 'image/png', 'swf' => 'application/shockwave-flash', 'tif' => 'image/tiff', 'tiff' => 'image/tiff', 'wav' => 'audio/wav', 'xbm' => 'image/xbm', 'xml' => 'text/xml', ); ]]> </programlisting> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>rewrites</parameter></term> <listitem> <para> Un tableau faisant correspondre des URI à des fichiers internes, simulant le mod_rewrite de apache. Par exemple: <programlisting role="php"> <![CDATA[ array( 'moninfo' => 'moninfo.php' ); ]]> </programlisting> routera les appels à <literal>http://<hôte>/monphar.phar/moninfo</literal> vers le fichier <literal>phar:///chemin/vers/monphar.phar/moninfo.php</literal>, en préservant les GET/POST. Ca ne fonctionne pas tout à fait comme mod_rewrite car ça ne fera pas correspondre <literal>http://<hôte>/monphar.phar/moninfo/unautre</literal>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Pas de valeur de retour </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Lève une exception <classname>PharException</classname> quand le fichier interne ne peut pas être ouvert ou si l'appel est fait en dehors d'un conteneur. Si un valeur de tableau non valide est passée dans <parameter>mimetypes</parameter> ou dans <parameter>rewrites</parameter>, une exception <classname>UnexpectedValueException</classname> est levée. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::webPhar</function></title> <para> Dans l'exemple ci-dessous, le phar créé affichera <literal>Salut tout le monde</literal> si quelqu'un appelle <literal>/monphar.phar/index.php</literal> ou <literal>/monphar.phar</literal>, et affichera la source de <literal>index.phps</literal> si <literal>/monphar.phar/index.phps</literal> est appelé. </para> <programlisting role="php"> <![CDATA[ <?php // l'archive phar est créée : try { $phar = new Phar('monphar.phar'); $phar['index.php'] = '<?php echo "Salut tout le monde"; ?>'; $phar['index.phps'] = '<?php echo "Salut tout le monde"; ?>'; $phar->setStub('<?php Phar::webPhar(); __HALT_COMPILER(); ?>'); } catch (Exception $e) { // on traite les erreurs ici } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::mungServer</function></member> <member><function>Phar::interceptFileFuncs</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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 -->