cvs: phpdoc-fr /reference/phar/Phar construct.xml convertToData.xml convertToExecutable.xml

From: Date: Fri, 09 Jan 2009 17:37:14 +0000
Subject: cvs: phpdoc-fr /reference/phar/Phar construct.xml convertToData.xml convertToExecutable.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-6314@lists.php.net to get a copy of this message
gui Fri Jan 9 17:37:14 2009 UTC Added files: /phpdoc-fr/reference/phar/Phar construct.xml convertToData.xml convertToExecutable.xml Log: initial translation

http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/Phar/construct.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/construct.xml +++ phpdoc-fr/reference/phar/Phar/construct.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="phar.construct"> <refnamediv> <refname>Phar::__construct</refname> <refpurpose>Construit un objet d'archive Phar</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>Phar::__construct</methodname> <methodparam><type>string</type><parameter>fname</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>alias</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>fname</parameter></term> <listitem> <para> Le chemin vers une archive Phar existante ou à créer </para> </listitem> </varlistentry> <varlistentry> <term><parameter>flags</parameter></term> <listitem> <para> Les drapeaux à passer à la classe parente <classname>RecursiveDirectoryIterator</classname>. Regardez <link xlink:href="http://www.php.net/~helly/php/ext/spl/classRecursiveDirectoryIterator.html#be0e1176d512c66500e5c26f248c89c4">la documentation des SPL RecursiveDirectoryIterator</link> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>alias</parameter></term> <listitem> <para> Alias avec lequel on doit faire référence à l'archive lors de l'appels aux fonctionnalités de flux. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Lève une exception BadMethodCallException si la méthode est appelée deux fois, ou UnexpectedValueException si l'archive ne peut pas être ouverte. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::__construct</function></title> <para> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemon/vers/mon.phar', CURRENT_AS_FILEINFO | KEY_AS_FILENAME, 'mon.phar'); } catch (UnexpectedValueException $e) { die('Ne peut pas ouvrir mon.phar'); } catch (BadMethodCallException $e) { echo 'techniquement, ça ne peut pas arriver'; } // ça fonctionne maintenant echo file_get_contents('phar://mon.phar/exemple.txt'); // et ça fonctionne comme si nous avions tapé echo file_get_contents('phar:///chemin/vers/mon.phar/exemple.txt'); ?> ]]> </programlisting> </para> </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/convertToData.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/convertToData.xml +++ phpdoc-fr/reference/phar/Phar/convertToData.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xml:id="phar.converttodata" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Phar::convertToData</refname> <refpurpose>Convertit une archive phar vers un fichier tar ou zip non exécutable</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>PharData</type><methodname>Phar::convertToData</methodname> <methodparam choice="opt"><type>int</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>compression</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>extension</parameter></methodparam> </methodsynopsis> <para> Cette méthode est utlisée pour convertir une archive phar exécutable vers un fichier tar ou zip. Pour rendre le tar ou le zip non exécutable, le conteneur phar et l'alias phar sont supprimés de l'archive nouvellement créée. </para> <para> Si aucun changement n'est spécifié, cette méthode lève une exception <classname>BadMethodCallException</classname> si l'archive est dans le format de fichier phar. Pour les archives basées sur tar ou zip, cette méthode convertit l'archive en une archive non exécutable. </para> <para> En cas de succès, la méthode crée une nouvelle archive sur le disque et retourne un objet <classname>Phar</classname>. L'ancienne archive n'est pas supprimée du disque, ce qui devrait être fait manuellement à la fin du procédé. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>format</parameter></term> <listitem> <para> Ce doit être l'un des formats <literal>Phar::TAR</literal> ou <literal>Phar::ZIP</literal>. Si ce paramètre est &null;, le format de fichier actuel sera conservé. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>compression</parameter></term> <listitem> <para> Ce doit être <literal>Phar::NONE</literal> pour aucune compression globale, <literal>Phar::GZ</literal> la une compression basée sur zlib et <literal>Phar::BZ2</literal> pour une compression basée sur bzip2. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>extension</parameter></term> <listitem> <para> Ce paramètre est utilisée pour écraser l'extension par défaut d'une archive convertie. A noter que <literal>.phar</literal> ne peut pas être utilisé dans le nom de fichier d'une archive tar ou zip non exécutable. </para> <para> Si on convertit vers une archive basée sur tar, les extensions par défaut sont <literal>.tar</literal>, <literal>.tar.gz</literal>, et <literal>.tar.bz2</literal> selon la compression spécifiée. Pour les archives phar basées sur zip, l'extension par défaut est <literal>.zip</literal>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La méthode retourne un objet <classname>Phar</classname> en cas de succès et lève une exception en cas d'échec. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Cette méthode lève une exception <classname>BadMethodCallException</classname> si elle n'est pas capable de compresser, si une méthode de compression inconnue a été spécifiée ou si l'archive demandée a été mise en tampon avec <function>Phar::startBuffering</function> sans être conclue avec <function>Phar::stopBuffering</function>, et lève une exception <classname>PharException</classname> si un quelconque problème a été rencontré pendant la phase de création de l'archive. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::convertToData</function></title> <para> Utilisons Phar::convertToData(): </para> <programlisting role="php"> <![CDATA[ <?php try { $tarphar = new Phar('monphar.phar.tar'); // notez bien que monphar.phar.tar n'est *pas* effacé // on convertit vers le format de fichier tar non exéctuable // crée monphar.tar $tar = $tarphar->convertToData(); // on convertit vers le format de fichier zip non exéctuable et crée monphar.zip $zip = $tarphar->convertToData(Phar::ZIP); // crée monphar.tbz $tgz = $tarphar->convertToData(Phar::TAR, Phar::BZ2, '.tbz'); // crée monphar.phar.tgz $phar = $tarphar->convertToData(Phar::PHAR); // lève une exception } catch (Exception $e) { // on traite les erreurs ici } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::convertToExecutable</function></member> <member><function>PharData::convertToExecutable</function></member> <member><function>PharData::convertToData</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/convertToExecutable.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/convertToExecutable.xml +++ phpdoc-fr/reference/phar/Phar/convertToExecutable.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.converttoexecutable" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Phar::convertToExecutable</refname> <refpurpose>Convertit une archive phar vers un autre format de fichier d'archive phar exécutable</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>Phar</type><methodname>Phar::convertToExecutable</methodname> <methodparam choice="opt"><type>int</type><parameter>format</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>compression</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>extension</parameter></methodparam> </methodsynopsis> &phar.write; <para> Cette méthode est utilisée pour convertir une archive phar vers un autre format de fichier. Par exemple, elle peut être utilisée pour créer une archive phar basée sur tar en partant d'une archive phar basée sur zip ou à partir d'une archive phar exécutable basée sur le format de fichier phar. De plus, elle peut aussi être utilisée pour appliquer une compression globale à une archive basée sur tar ou sur phar. </para> <para> Si aucun changement n'est précisé, cette méthode lève une exception <classname>BadMethodCallException</classname>. </para> <para> En cas de succès, la méthode crée une nouvelle archive sur le disque et retourne un objet <classname>Phar</classname>. L'ancienne archive n'est pas supprimée du disque, ce qui devrait être fait manuellement à la fin du procédé. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>format</parameter></term> <listitem> <para> Ce doit être l'un des formats <literal>Phar::PHAR</literal>, <literal>Phar::TAR</literal>, ou <literal>Phar::ZIP</literal>. Si ce paramètre est &null;, le format de fichier actuel sera conservé. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>compression</parameter></term> <listitem> <para> Ce doit être <literal>Phar::NONE</literal> pour aucune compression globale, <literal>Phar::GZ</literal> la une compression basée sur zlib et <literal>Phar::BZ2</literal> pour une compression basée sur bzip2. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>extension</parameter></term> <listitem> <para> Ce paramètre est utilisée pour écraser l'extension par défaut d'une archive convertie. A noter que toutes les archives phar basée sur zip ou sur tar doivent comporter <literal>.phar</literal> dans leur extension pour être traitées comme une archive phar. </para> <para> Si on convertit vers une archive basée sur phar, les extensions par défaut sont <literal>.phar</literal>, <literal>.phar.gz</literal>, ou <literal>.phar.bz2</literal> selon la compression spécifiée. Pour les archives phar basées sur tar, les extensions par défaut sont <literal>.phar.tar</literal>, <literal>.phar.tar.gz</literal>, et <literal>.phar.tar.bz2</literal>. Pour les archives phar basées sur zip, l'extension par défaut est <literal>.phar.zip</literal>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La méthode retourne un objet <classname>Phar</classname> en cas de succès et lève une exception en cas d'échec. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Cette méthode lève une exception <classname>BadMethodCallException</classname> si elle n'est pas capable de compresser, si une méthode de compression inconnue a été spécifiée ou si l'archive demandée a été mise en tampon avec <function>Phar::startBuffering</function> sans être conclue avec <function>Phar::stopBuffering</function>, lève une exception <classname>UnexpectedValueException</classname> si le support en écriture a été désactivé et lève une exception <classname>PharException</classname> si un quelconque problème a été rencontré pendant la phase de création de l'archive. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::convertToExecutable</function></title> <para> Utilisons Phar::convertToExecutable() : </para> <programlisting role="php"> <![CDATA[ <?php try { $tarphar = new Phar('monphar.phar.tar'); // on le convertit vers le format de fichier phar // notez bien que monphar.phar.tar n'est *pas* effacé $phar = $tarphar->convertToExecutable(Phar::PHAR); // crée monphar.phar $phar->setStub($phar->createDefaultStub('cli.php', 'web/index.php')); // crée monphar.phar.tgz $compressed = $phar->convertToExecutable(Phar::TAR, Phar::GZ, '.phar.tgz'); } catch (Exception $e) { // on traite les erreurs ici } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::convertToData</function></member> <member><function>PharData::convertToExecutable</function></member> <member><function>PharData::convertToData</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 -->
« previous php.doc.fr (#6314) next »