cvs: phpdoc-fr /reference/phar/PharData compress.xml compressFiles.xml construct.xml convertToData.xml convertToExecutable.xml copy.xml

From: Date: Tue, 10 Feb 2009 16:50:12 +0000
Subject: cvs: phpdoc-fr /reference/phar/PharData compress.xml compressFiles.xml construct.xml convertToData.xml convertToExecutable.xml copy.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-6612@lists.php.net to get a copy of this message
gui Tue Feb 10 16:50:12 2009 UTC Added files: /phpdoc-fr/reference/phar/PharData compress.xml compressFiles.xml construct.xml convertToData.xml convertToExecutable.xml copy.xml Log: initial translation

http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/PharData/compress.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/compress.xml +++ phpdoc-fr/reference/phar/PharData/compress.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phardata.compress"> <refnamediv> <refname>PharData::compress</refname> <refpurpose>Compresse l'archive tar/zip complète en utilisant la compression Gzip ou Bzip2</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>object</type><methodname>PharData::compress</methodname> <methodparam><type>int</type><parameter>compression</parameter></methodparam> <methodparam><type>string</type><parameter>extension</parameter></methodparam> </methodsynopsis> <para> Pour les archives tar, cette méthode compresse l'archive entière en utilisant la compressions gzip ou bzip2. Le fichier qui en résulte peut être manipulé avec la commande gunzip/bunzip, ou être accédé directement et de façon transparente avec l'extension Phar. </para> <para> Pour les archives zip, cette méthode échoue en levant une exception. L'extension <link linkend="ref.zlib">zlib</link> doit être activée pour compresser avec gzip, l'extension <link linkend="ref.bzip2">bzip2</link> doit être activée pour compresser avec bzip2. </para> <para> De plus, cette méthode renomme automatiquement l'archive, en la suffixant par <literal>.gz</literal>, <literal>.bz2</literal> ou en enlevant l'extension si <literal>Phar::NONE</literal> est spécifié pour enlever la compression. Sinon, une extension de fichier peut être spécifiée avec le second paramètre. </para> <para> Un objet <classname>PharData</classname> est retourné. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>compression</parameter></term> <listitem> <para> La compression doit être <literal>Phar::GZ</literal> ou <literal>Phar::BZ2</literal> pour appliquer une compression, ou <literal>Phar::NONE</literal> pour l'enlever. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>extension</parameter></term> <listitem> <para> Par défaut, l'extension est <literal>.tar.gz</literal> ou <literal>.tar.bz2</literal> pour compresser un tar, et <literal>.tar</literal> pour décompresser. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>BadMethodCallException</classname> si l'extension <link linkend="ref.zlib">zlib</link> n'est pas disponible, ou si l'extension <link linkend="ref.bzip2">bzip2</link> n'est pas activée. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharData::compress</function></title> <programlisting role="php"> <![CDATA[ <?php $p = new PharData('/chemin/vers/mon.tar'); $p['monfichier.txt'] = 'salut'; $p['monfichier2.txt'] = 'salut'; $p1 = $p->compress(Phar::GZ); // copie vers /chemin/vers/mon.phar.gz $p2 = $p->compress(Phar::BZ2); // copie vers /chemin/vers/mon.phar.bz2 $p3 = $p2->compress(Phar::NONE); // exception: /chemin/vers/mon.phar existe déjà ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::compress</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/PharData/compressFiles.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/compressFiles.xml +++ phpdoc-fr/reference/phar/PharData/compressFiles.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phardata.compressfiles"> <refnamediv> <refname>PharData::compressFiles</refname> <refpurpose>Compresse tous les fichiers de l'archive tar/zip courante</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::compressFiles</methodname> <methodparam><type>int</type><parameter>compression</parameter></methodparam> </methodsynopsis> <para> Pour les archives basées sur tar, cette méthode soulève une exception <classname>BadMethodCallException</classname> car la compression individuelle des fichiers d'une archive tar n'est pas supportée par ce format de fichiers. Utilisez <function>PharData::compress</function> pour compresser une archive basée sur tar complète. </para> <para> Pour les archives basées sur Zip, cette méthode compresse tous les fichiers de l'archive en utilisant la compression spécifiée. Les extensions <link linkend="ref.zlib">zlib</link> ou <link linkend="ref.bzip2">bzip2</link> doivent être activées pour tirer parti de cette fonctionnalité. De plus, si au moins un fichier est déjà compressé en utilisant la compression bzip2/zlib, l'extension adéquate être activée pour décompresser les fichiers avant de les re-compresser. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>compression</parameter></term> <listitem> <para> La compression doit être <literal>Phar::GZ</literal> ou <literal>Phar::BZ2</literal> pour appliquer une compression, ou <literal>Phar::NONE</literal> pour l'enlever. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulè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.zlib">zlib</link> n'est pas disponible ou si au moins un fichier est compressé via bzip2 et que l'extension <link linkend="ref.bzip2">bzip2</link> n'est pas activée. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharData::compressFiles</function></title> <programlisting role="php"> <![CDATA[ <?php $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $p['monfichier2.txt'] = 'salut'; foreach ($p as $file) { var_dump($file->getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressed(Phar::BZ2)); var_dump($file->isCompressed(Phar::GZ)); } $p->compressFiles(Phar::GZ); foreach ($p as $file) { var_dump($file->getFileName()); var_dump($file->isCompressed()); var_dump($file->isCompressed(Phar::BZ2)); var_dump($file->isCompressed(Phar::GZ)); } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ string(14) "monfichier.txt" bool(false) bool(false) bool(false) string(15) "monfichier2.txt" bool(false) bool(false) bool(false) string(14) "monfichier.txt" int(4096) bool(false) bool(true) string(15) "monfichier2.txt" int(4096) bool(false) bool(true) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::getCompressedSize</function></member> <member><function>PharFileInfo::isCompressed</function></member> <member><function>PharFileInfo::compress</function></member> <member><function>PharFileInfo::decompress</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>PharData::decompressFiles</function></member> <member><function>Phar::getSupportedCompression</function></member> <member><function>PharData::compress</function></member> <member><function>PharData::decompress</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/PharData/construct.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/construct.xml +++ phpdoc-fr/reference/phar/PharData/construct.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="phardata.construct"> <refnamediv> <refname>PharData::__construct</refname> <refpurpose>Construit un objet d'archive tar ou zip non-exécutable</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>PharData::__construct</methodname> <methodparam><type>string</type><parameter>fname</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>fname</parameter></term> <listitem> <para> Chemin vers une archive tar/zip existante ou à créer </para> </listitem> </varlistentry> <varlistentry> <term><parameter>flags</parameter></term> <listitem> <para> drapeaux à passer à la classe parente <classname>Phar</classname> <classname>RecursiveDirectoryIterator</classname>. Regardez <link xlink:href="http://www.php.net/~helly/php/ext/spl/classRecursiveDirectoryIterator.html#be0e1176d512c66500e5c26f248c89c4">la documentation de SPL RecursiveDirectoryIterator</link> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception BadMethodCallException si appelée deux fois, une exception UnexpectedValueException si l'archive phar ne peut pas être ouverte. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharData::__construct</function></title> <para> <programlisting role="php"> <![CDATA[ <?php try { $p = new PharData('/chemin/vers/mon.tar', CURRENT_AS_FILEINFO | KEY_AS_FILENAME); } catch (UnexpectedValueException $e) { die('Ne peut pas ouvrir mon.tar'); } catch (BadMethodCallException $e) { echo 'techniquement, ça ne peut pas arriver'; } echo file_get_contents('phar:///chemin/vers/mon.tar/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/PharData/convertToData.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/convertToData.xml +++ phpdoc-fr/reference/phar/PharData/convertToData.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="phardata.converttodata" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::convertToData</refname> <refpurpose>Convertit une archive phar en une archive tar ou zip non-exécutable</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>PharData</type><methodname>PharData::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 utilisée pour convertir une archive non exécutable tar ou zip en un autre format non-exécutable. </para> <para> Si aucun changement n'est demandé, cette méthode, cette méthode soulève une exception <classname>BadMethodCallException</classname>. Cette méthode doit être utilisée pour convertir une archive tar au format zip et vice-versa. Bien qu'il soit possible de changer la compression d'une archive tar avec cette méthode, il est préférable d'utiliser la méthode <function>PharData::compress</function> pour rester cohérent au niveau de la logique. </para> <para> En cas de succès, cette méthode crée une nouvelle archive sur le disque et retourne un objet <classname>PharData</classname>. L'ancienne archive n'est pas effacée du disque, ceci devant être fait manuellement une fois le traitement terminé. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>format</parameter></term> <listitem> <para> Le format doit être <literal>Phar::TAR</literal> ou <literal>Phar::ZIP</literal>. S'il vaut &null;, le format de fichier actuel sera conservé. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>compression</parameter></term> <listitem> <para> La compression doit être <literal>Phar::NONE</literal> pour éviter la compression de l'archive complète, <literal>Phar::GZ</literal> pour la compression basée sur zlib, et <literal>Phar::BZ2</literal> pour la compression basée sur bzip. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>extension</parameter></term> <listitem> <para> Ce paramètre est utilisé pour écrase l'extension de fichier par défaut de l'archive convertie. Notez que <literal>.phar</literal> ne peut pas être utilisé n'importe où dans le nom de fichier d'une archive tar ou zip non-exécutable. </para> <para> En cas de conversion vers une archive phar 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 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> Cette méthode retourne un objet <classname>PharData</classname> en cas de succès et soulève une exception en cas d'échec. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Cette méthode soulève une exception <classname>BadMethodCallException</classname> quand elle est incapable de compresser, quand une méthode de compression inconnue a été spécifiée, quand l'archive demandée est mise en tampon avec <function>PharData::startBuffering</function> et qu'elle n'a pas été conclue avec <function>PharData::stopBuffering</function>, et soulève une exception <classname>PharException</classname> si un quelconque problème est rencontré lors de la création du phar. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharData::convertToData</function></title> <para> Utilisons PharData::convertToData(): </para> <programlisting role="php"> <![CDATA[ <?php try { $tarphar = new PharData('monphar.tar'); // notez que monphar.tar n'est *pas* effacé // le convertir au format tar non-exécutable // crée monphar.zip $zip = $tarphar->convertToData(Phar::ZIP); // crée monphar.tbz $tgz = $zip->convertToData(Phar::TAR, Phar::BZ2, '.tbz'); // crée monphar.phar.tgz $phar = $tarphar->convertToData(Phar::PHAR); // soulève une exceptions } catch (Exception $e) { // les erreurs sont traitées ici } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::convertToExecutable</function></member> <member><function>Phar::convertToData</function></member> <member><function>PharData::convertToExecutable</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/PharData/convertToExecutable.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/convertToExecutable.xml +++ phpdoc-fr/reference/phar/PharData/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="phardata.converttoexecutable" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::convertToExecutable</refname> <refpurpose>Convertit une archive tar/zip non-exécutable en une archive phar exécutable</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>Phar</type><methodname>PharData::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 convertit une archive tar ou zip non-exécutable en une archive phar exécutable. N'importe lequel des trois formats de fichier (phar, tar ou zip) peut être utilisé et la compression de l'archive complète est aussi possible. </para> <para> Si aucun changement n'est demandé, cette méthode soulève une exception <classname>BadMethodCallException</classname>. </para> <para> En cas de succès, cette méthode crée une nouvelle archive sur le disque et retourne un objet <classname>Phar</classname>. L'ancienne archive n'est pas effacée du disque, ceci devant être fait manuellement une fois le traitement terminé. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>format</parameter></term> <listitem> <para> Le format doit être <literal>Phar::PHAR</literal>, <literal>Phar::TAR</literal> ou <literal>Phar::ZIP</literal>. S'il vaut &null;, le format de fichier actuel sera conservé. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>compression</parameter></term> <listitem> <para> La compression doit être <literal>Phar::NONE</literal> pour éviter la compression de l'archive complète, <literal>Phar::GZ</literal> pour la compression basée sur zlib, et <literal>Phar::BZ2</literal> pour la compression basée sur bzip. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>extension</parameter></term> <listitem> <para> Ce paramètre est utilisé pour écrase l'extension de fichier par défaut de l'archive convertie. Notez que toute les archives basées sur tar et sur zip doivent contenir <literal>.phar</literal> dans leur extension de fichier pour pouvoir être traitées comme des archives phar. </para> <para> En cas de conversion 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> Cette méthode retourne un objet <classname>Phar</classname> en cas de succès et soulève une exception en cas d'échec. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Cette méthode soulève une exception <classname>BadMethodCallException</classname> quand elle est incapable de compresser, quand une méthode de compression inconnue a été spécifiée, quand l'archive demandée est mise en tampon avec <function>PharData::startBuffering</function> et qu'elle n'a pas été conclue avec <function>PharData::stopBuffering</function>, soulève une exception <classname>UnexpectedValueException</classname> si le support en écriture est désactivé, et soulève une exception <classname>PharException</classname> si des problèmes ont été rencontrés lors de la création du phar. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharData::convertToExecutable</function></title> <para> Utilisons PharData::convertToExecutable() : </para> <programlisting role="php"> <![CDATA[ <?php try { $tarphar = new PharData('monphar.tar'); // le convertit au format de fichier phar // notez que monphar.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 = $tarphar->convertToExecutable(Phar::TAR, Phar::GZ, '.phar.tgz'); } catch (Exception $e) { // les erreurs sont traitées ici } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::convertToExecutable</function></member> <member><function>Phar::convertToData</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/PharData/copy.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/copy.xml +++ phpdoc-fr/reference/phar/PharData/copy.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="phardata.copy" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::copy</refname> <refpurpose>Copie un fichier un fichier interne à l'archive phar vers un autre fichier au sein de la même archive</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::copy</methodname> <methodparam><type>string</type><parameter>oldfile</parameter></methodparam> <methodparam><type>string</type><parameter>newfile</parameter></methodparam> </methodsynopsis> <para> Copie un fichier interne à l'archive tar/zip vers un autre fichier au sein de la même archive. C'est une alternative orientée objet à l'utilisation de <function>copy</function> avec le gestionnaire de flux phar. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>oldfile</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>newfile</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> retourne &true; en cas de succès, mais il est plus sûr d'encadrer l'appel à la méthode dans un bloc try/catch est de considérer son succès si aucune exception n'est levée. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> lève une exception <classname>UnexpectedValueException</classname> si le fichier source n'existe pas, si le fichier de destination existe déjà, si le support en écriture est désactivé, si l'ouverture d'un des deux fichiers échoue ou si la lecture du fichier source échoue; ou lève une exception <classname>PharException</classname> si l'écriture des changements de l'archive phar échoue. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharData::copy</function></title> <para> Cet exemple montre l'utilisation de <function>PharData::copy</function> et de son équivalent en terme de gestionnaire de flux. La différence principale entre les deux façons de faire concerne la gestion des erreurs. Toutes les méthodes PharData soulèvent des exceptions, alors que le gestionnaire de flux utilise <function>trigger_error</function>. </para> <programlisting role="php"> <![CDATA[ <?php try { $phar = new PharData('monphar.tar'); $phar['a'] = 'salut'; $phar->copy('a', 'b'); echo $phar['b']; // affiche "salut" } catch (Exception $e) { // on traite les erreurs } // l'équivalent en terme de flux de l'exemple ci-dessus. // des E_WARNINGS sont lancés en cas d'erreur à la place d'exceptions. copy('phar://monphar.tar/a', 'phar//monphar.tar/c'); echo file_get_contents('phar://monphar.tar/c'); // affiche "salut" ?> ]]> </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 -->
« previous php.doc.fr (#6612) next »