cvs: phpdoc-fr /reference/phar/PharData decompress.xml decompressFiles.xml delMetadata.xml delete.xml extractTo.xml isWritable.xml offsetSet.xml
offsetUnset.xml setAlias.xml setDefaultStub.xml setMetadata.xml setSignatureAlgorithm.xml setStub.xml
| From: | Guillaume Plessis | Date: | Wed, 11 Feb 2009 22:52:28 +0000 |
| Subject: | cvs: phpdoc-fr /reference/phar/PharData decompress.xml decompressFiles.xml delMetadata.xml delete.xml extractTo.xml isWritable.xml offsetSet.xml offsetUnset.xml setAlias.xml setDefaultStub.xml setMetadata.xml setSignatureAlgorithm.xml setStub.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-6637@lists.php.net to get a copy of this message | ||
gui Wed Feb 11 22:52:28 2009 UTC
Added files:
/phpdoc-fr/reference/phar/PharData decompress.xml
decompressFiles.xml
delMetadata.xml delete.xml
extractTo.xml isWritable.xml
offsetSet.xml offsetUnset.xml
setAlias.xml setDefaultStub.xml
setMetadata.xml
setSignatureAlgorithm.xml
setStub.xml
Log:
initial translation
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/PharData/decompress.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/decompress.xml +++ phpdoc-fr/reference/phar/PharData/decompress.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.decompress"> <refnamediv> <refname>PharData::decompress</refname> <refpurpose>Décompresse l'archive Phar entière</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>object</type><methodname>PharData::decompress</methodname> <methodparam choice="opt"><type>string</type><parameter>extension</parameter></methodparam> </methodsynopsis> <para> Pour les archives basées sur tar, cette méthode décompresse l'archive entière. </para> <para> Pour les archives basées sur Zip, cette méthode échoue et soulève une exception. L'extension <link linkend="ref.zlib">zlib</link> edoit être activée pour décompresser une archive compressée avec gzip et l'extension <link linkend="ref.bzip2">bzip2</link> doit être disponible pour décompresser une archive compressée avec bzip2. </para> <para> De plus, cette méthode renomme automatiquement l'extension de fichier de l'archive, <literal>.tar</literal> par défaut. 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>extension</parameter></term> <listitem> <para> Pour décompresser, l'extension par défaut est <literal>.phar.tar</literal>. Utilisez ce paramètre pour spécifier une autre extension de fichier. Gardez à l'esprit que les archives non-exécutables ne peuvent pas contenir <literal>.phar</literal> dans leur nom de fichier. </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::decompress</function></title> <programlisting role="php"> <![CDATA[ <?php $p = new PharData('/chemin/vers/mon.tar', 0, 'mon.tar.gz'); $p['monfichier.txt'] = 'salut'; $p['monfichier2.txt'] = 'salut'; $p3 = $p2->decompress(); // crée /chemin/vers/mon.tar ?> ]]> </programlisting> </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>PharData::compress</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>PharData::compress</function></member> <member><function>Phar::getSupportedCompression</function></member> <member><function>PharData::compressFiles</function></member> <member><function>PharData::decompressFiles</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/decompressFiles.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/decompressFiles.xml +++ phpdoc-fr/reference/phar/PharData/decompressFiles.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.decompressfiles"> <refnamediv> <refname>PharData::decompressFiles</refname> <refpurpose>Décompresse tous les fichier de l'archive zip courante</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::decompressFiles</methodname> <void /> </methodsynopsis> &phar.write; <para> Pour les archives basées sur tar, cette méthode soulève une exception <classname>BadMethodCallException</classname>, car la compression individuelle des fichiers au sein d'une archive tar n'est pas supportée par le format de fichier. 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 décompresse tous les fichiers de l'archive. 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é si au moins un des fichiers est compressé avec bzip2/zlib. </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 au moins un des fichiers est compressé avec 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::decompressFiles</function></title> <programlisting role="php"> <![CDATA[ <?php $p = new PharData('/chemin/vers/mon.zip'); $p['monfichier.txt'] = 'salut'; $p['monfichier2.txt'] = 'salut'; $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)); } $p->decompressFiles(); 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" int(4096) bool(false) bool(true) string(15) "monfichier2.txt" int(4096) bool(false) bool(true) string(14) "monfichier.txt" bool(false) bool(false) bool(false) string(15) "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::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::compressFiles</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/delMetadata.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/delMetadata.xml +++ phpdoc-fr/reference/phar/PharData/delMetadata.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.delmetadata" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::delMetadata</refname> <refpurpose>Efface les méta-données globales d'une archive zip</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>PharData::delMetadata</methodname> <void/> </methodsynopsis> &phar.write; <para> Efface les méta-données globales de l'archive zip </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> retourne &true; en cas de succès, mais il est préférable de vérifier les exception soulevées et de considérer le succès si aucune ne l'est. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> si des erreurs sont rencontrés lors de l'écriture des changements sur le disque. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharData::delMetaData</function></title> <programlisting role="php"> <![CDATA[ <?php try { $phar = new PharData('monphar.zip'); var_dump($phar->getMetadata()); $phar->setMetadata("salut"); var_dump($phar->getMetadata()); $phar->delMetadata(); var_dump($phar->getMetadata()); } catch (Exception $e) { // on traite les erreurs } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ NULL string(5) "salut" NULL ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::delMetadata</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/delete.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/delete.xml +++ phpdoc-fr/reference/phar/PharData/delete.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.delete" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::delete</refname> <refpurpose>Efface un fichier au sein de l'archive tar/zip</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>PharData::delete</methodname> <methodparam><type>string</type><parameter>entry</parameter></methodparam> </methodsynopsis> <para> Efface un fichier au sein de l'archive. C'est l'équivalent fonctionnel de l'appel à <function>unlink</function> à l'aide du gestionnaire de flux phar, comme montré dans l'exemple ci-dessous. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>entry</parameter></term> <listitem> <para> Chemin du fichier à effacer au sein de l'archive. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> retourne &true; en cas de succès, mais il est préférable de vérifier les exception soulevées et de considérer le succès si aucune ne l'est. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> si des erreurs sont rencontrés lors de l'écriture des changements sur le disque. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharData::delete</function></title> <programlisting role="php"> <![CDATA[ <?php try { $phar = new PharData('monphar.zip'); $phar->delete('efface/moi.php'); // c'est l'équivalent de : unlink('phar://monphar.phar/efface/mon.php'); } catch (Exception $e) { // on traite les erreurs } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::delete</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/extractTo.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/extractTo.xml +++ phpdoc-fr/reference/phar/PharData/extractTo.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.extractto" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::extractTo</refname> <refpurpose>Extrait le contenu d'une archive tar/zip vers un répertoire</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>PharData::extractTo</methodname> <methodparam><type>string</type><parameter>pathto</parameter></methodparam> <methodparam choice="opt"><type>string|array</type><parameter>files</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>overwrite</parameter></methodparam> </methodsynopsis> <para> Extrait tous les fichiers d'une archive tar/zip vers le disque. Les fichiers et les répertoires extraits conservent les permissions telles qu'au sein de l'archive. Les paramètres optionnels permettent un éventuel contrôle sur quels fichiers seront extraits et si les fichiers déjà présents sur le disque peuvent être écrasés. Le second paramètre <literal>files</literal> peut être le nom d'un fichier ou d'un répertoire à extraire, ou tableau de nom de fichiers et de répertoires à extraire. Par défaut, cette méthode n'écrasera aucun fichier déjà existant, à moins que le troisième paramètre soit à true. Cette méthode est identique à <function>ZipArchive::extractTo</function>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>pathto</parameter></term> <listitem> <para> Chemin au sein de l'archive des fichiers à effacer. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>files</parameter></term> <listitem> <para> Le nom d'un fichier ou d'un répertoire à extraire, ou un tableau de fichiers/répertoires à extraire </para> </listitem> </varlistentry> <varlistentry> <term><parameter>overwrite</parameter></term> <listitem> <para> &false; par défaut, passez le à &true; pour activer l'écrasement des fichiers déjà existants </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> retourne &true; en cas de succès, mais il est préférable de vérifier les exception soulevées et de considérer le succès si aucune ne l'est. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> si des erreurs sont rencontrés lors de l'écriture des changements sur le disque. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharData::extractTo</function></title> <programlisting role="php"> <![CDATA[ <?php try { $phar = new PharData('monphar.tar'); $phar->extractTo('/chemin/complet'); // extrait tous les fichiers $phar->extractTo('/un/autre/chemin', 'fichier.txt'); // extrait seulement fichier.txt $phar->extractTo('/ce/chemin', array('fichier1.txt', 'fichier2.txt')); // extrait seulement 2 fichiers $phar->extractTo('/troisieme/chemin', null, true); // extrait tous les fichiers, en écrasant } catch (Exception $e) { // on traite les erreurs } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::extractTo</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/isWritable.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/isWritable.xml +++ phpdoc-fr/reference/phar/PharData/isWritable.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.iswritable" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::isWritable</refname> <refpurpose>Retourne true si l'archive tar/zip peut être modifiée</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::isWritable</methodname> <void/> </methodsynopsis> <para> Cette méthode retourne &true; si l'archive tar/zip sur le disque n'est pas en lecture seule. Contrairement à <function>Phar::isWritable</function>, les archives tar/zip de données peuvent être modifiées même si <literal>phar.readonly</literal> est à <literal>1</literal>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> Aucun paramètre. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne &true; si l'archive tar/zip peut être modifiée </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::canWrite</function></member> <member><function>Phar::isWritable</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/offsetSet.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/offsetSet.xml +++ phpdoc-fr/reference/phar/PharData/offsetSet.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.offsetset"> <refnamediv> <refname>PharData::offsetSet</refname> <refpurpose>remplit un fichier au sein de l'archive tar/zip avec le contenu d'un fichier externe ou d'une chaîne de caractères</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>PharData::offsetSet</methodname> <methodparam><type>string</type><parameter>offset</parameter></methodparam> <methodparam><type>string</type><parameter>value</parameter></methodparam> </methodsynopsis> <para> C'est une implémentation de l'interface <interfacename>ArrayAccess</interfacename> permettant la manipulation directe du contenu d'une archive tar/zip en utilisant les crochets, opérateurs d'accès au tableau. offsetSet est utilisé pour modifier un fichier existant ou pour ajouter un nouveau fichier à l'archive tar/zip. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> Le chemin (relatif) du fichier à modifier au sein de l'archive tar ou zip. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>value</parameter></term> <listitem> <para> Contenu du fichier. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Aucune valeur de retour. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> si des problèmes ont été rencontrés lors de l'écriture sur le disque des changements de l'archive tar/zip. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharData::offsetSet</function></title> <para> offsetSet ne doit pas être accédé directement, mais plutôt utilisé via l'opérateur <literal>[]</literal>. </para> <programlisting role="php"> <![CDATA[ <?php $p = new PharData('/chemin/vers/mon.tar'); try { // appelle offsetSet $p['fichier.txt'] = 'Salut'; } catch (Exception $e) { echo 'Ne peut pas modifier fichier.txt:', $e; } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::offsetSet</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/offsetUnset.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/offsetUnset.xml +++ phpdoc-fr/reference/phar/PharData/offsetUnset.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.offsetunset"> <refnamediv> <refname>PharData::offsetUnset</refname> <refpurpose>efface un fichier d'une archive tar/zip</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::offsetUnset</methodname> <methodparam><type>string</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para> C'est une implémentation de l'interface <interfacename>ArrayAccess</interfacename> permettant la manipulation directe du contenu d'une archive tar/zip en utilisant les crochets, opérateurs d'accès au tableau. offsetUnset est utilisé pour effacer un fichier existant et est appelé par la construction de langage <function>unset</function>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> Le chemin (relatif) du fichier à modifier au sein de l'archive tar ou zip. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> si des problèmes ont été rencontrés lors de l'écriture sur le disque des changements de l'archive tar/zip. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharData::offsetUnset</function></title> <programlisting role="php"> <![CDATA[ <?php $p = new PharData('/chemin/vers/mon.zip'); try { // efface fichier.txt de mon.zip en appelant offsetUnset unset($p['fichier.txt']); } catch (Exception $e) { echo 'Ne peut pas effacer fichier.txt: ', $e; } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <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/PharData/setAlias.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/setAlias.xml +++ phpdoc-fr/reference/phar/PharData/setAlias.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.setalias" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::setAlias</refname> <refpurpose>fonction inutile (Phar::setAlias n'est pas valide pour PharData)</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::setAlias</methodname> <methodparam><type>string</type><parameter>alias</parameter></methodparam> </methodsynopsis> <para> Les archives tar/zip non exécutables ne peuvent pas avoir d'alias, donc cette méthode ne fait que soulever une exception. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>alias</parameter></term> <listitem> <para> Une courte chaîne de caractère à laquelle se référer pour faire appel à l'archive via le gestionnaire de flux phar. Ce paramètre est ignoré. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> lors de l'appel à la méthode </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::setAlias</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/setDefaultStub.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/setDefaultStub.xml +++ phpdoc-fr/reference/phar/PharData/setDefaultStub.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.setdefaultstub"> <refnamediv> <refname>PharData::setDefaultStub</refname> <refpurpose>fonction inutile (Phar::setDefaultStub n'est pas valide pour PharData)</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>PharData::setDefaultStub</methodname> <methodparam choice="opt"><type>string</type><parameter>index</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>webindex</parameter></methodparam> </methodsynopsis> <para> Les archives tar/zip non-exécutables ne peuvent pas avoir de conteneur de chargement, donc cette méthode ne fait que soulever une exception. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>index</parameter></term> <listitem> <para> Chemin relatif au sein de l'archive phar à exécuter en cas d'accès à partir de la ligne de commande </para> </listitem> </varlistentry> <varlistentry> <term><parameter>webindex</parameter></term> <listitem> <para> Chemin relatif au sein de l'archive phar à exécuter en cas d'accès à partir d'un navigateur </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> lors de l'appel à la méthode </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::setDefaultStub</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/setMetadata.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/setMetadata.xml +++ phpdoc-fr/reference/phar/PharData/setMetadata.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.setmetadata"> <refnamediv> <refname>Phar::setMetadata</refname> <refpurpose>Fixe les méta-données de l'archive</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>Phar::setMetadata</methodname> <methodparam><type>mixed</type><parameter>metadata</parameter></methodparam> </methodsynopsis> &phar.write; <para> <function>Phar::setMetadata</function> doit être utilisé pour stocker des méta-données personnalisées qui décrivent quelque chose à propos de l'archive phar en tant qu'entité complète. <function>PharFileInfo::setMetadata</function> doit être utilisé pour les méta-données spécifiques aux fichiers. Les méta-données peuvent dégrader les performances de chargement d'une archive phar si les données sont trop lourdes. </para> <para> Les méta-données peuvent être utilisées pour spécifier quel fichier au sein de l'archive doit être utilisé pour charger l'archive ou l'emplacement d'un fichier de manifeste comme le fichier package.xml de <link xlink:href="http://pear.php.net">PEAR</link>. De manière générale, n'importe quelle données utile décrivant l'archive phar peut être stockée. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>metadata</parameter></term> <listitem> <para> N'importe quelle variable PHP contenant de l'information à stocker pour décrire l'archive phar </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::setMetadata</function></title> <para> </para> <programlisting role="php"> <![CDATA[ <?php // on s'assure que le phar n'existe pas @unlink('nouveauphar.phar'); try { $p = new Phar(dirname(__FILE__) . '/nouveauphar.phar', 0, 'nouveauphar.phar'); $p['fichier.php'] = '<?php echo "salut"'; $p->setMetadata(array('chargement' => 'fichier.php')); var_dump($p->getMetadata()); } catch (Exception $e) { echo 'Ne peut pas créer/modifier le phar:', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array(1) { ["chargement"]=> string(11) "fichier.php" } ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::getMetadata</function></member> <member><function>Phar::delMetadata</function></member> <member><function>Phar::hasMetadata</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/setSignatureAlgorithm.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/setSignatureAlgorithm.xml +++ phpdoc-fr/reference/phar/PharData/setSignatureAlgorithm.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="phardata.setsignaturealgorithm" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Phar::setSignatureAlgorithm</refname> <refpurpose>fixe l'algorithme de signature d'un phar et l'applique.</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>Phar::setSignatureAlgorithm</methodname> <methodparam><type>int</type><parameter>sigtype</parameter></methodparam> </methodsynopsis> &phar.write; <para> fixe l'algorithme de signature d'un phar et l'applique. L'agorithme de signature doit être <literal>Phar::MD5</literal>, <literal>Phar::SHA1</literal>, <literal>Phar::SHA256</literal>, <literal>Phar::SHA512</literal>, ou <literal>Phar::PGP</literal> (pgp n'est pas encore supporté et implique SHA-1). </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>sigtype</parameter></term> <listitem> <para> Un algorithme parmi <literal>Phar::MD5</literal>, <literal>Phar::SHA1</literal>, <literal>Phar::SHA256</literal>, <literal>Phar::SHA512</literal>, or <literal>Phar::PGP</literal> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>UnexpectedValueException</classname> pour beaucoup d'erreurs, une exception <classname>BadMethodCallException</classname> si l'appel est fait pour une archive phar basée sur tar ou sur zip, une exception <classname>PharException</classname> si des problèmes sont rencontrés lors de l'écriture des changements sur le disque. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::getSupportedSignatures</function></member> <member><function>Phar::getSignature</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/setStub.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/setStub.xml +++ phpdoc-fr/reference/phar/PharData/setStub.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.setstub"> <refnamediv> <refname>PharData::setStub</refname> <refpurpose>fonction inutile (Phar::setStub n'est pas valide pour PharData)</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>PharData::setStub</methodname> <methodparam><type>string</type><parameter>stub</parameter></methodparam> </methodsynopsis> <para> Les archives tar/zip non-exécutables ne peuvent pas avoir de conteneur de chargement, donc cette méthode ne fait que soulever une exception. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>stub</parameter></term> <listitem> <para> Une chaîne de caractères ou un gestionnaire de flux ouvert à utiliser en tant que conteneur de chargement exécutable pour l'archive phar. Ce paramètre est ignoré. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> lors de tout appel à la méthode </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::setStub</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/decompress.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/decompress.xml +++ phpdoc-fr/reference/phar/PharData/decompress.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.decompress"> <refnamediv> <refname>PharData::decompress</refname> <refpurpose>Décompresse l'archive Phar entière</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>object</type><methodname>PharData::decompress</methodname> <methodparam choice="opt"><type>string</type><parameter>extension</parameter></methodparam> </methodsynopsis> <para> Pour les archives basées sur tar, cette méthode décompresse l'archive entière. </para> <para> Pour les archives basées sur Zip, cette méthode échoue et soulève une exception. L'extension <link linkend="ref.zlib">zlib</link> edoit être activée pour décompresser une archive compressée avec gzip et l'extension <link linkend="ref.bzip2">bzip2</link> doit être disponible pour décompresser une archive compressée avec bzip2. </para> <para> De plus, cette méthode renomme automatiquement l'extension de fichier de l'archive, <literal>.tar</literal> par défaut. 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>extension</parameter></term> <listitem> <para> Pour décompresser, l'extension par défaut est <literal>.phar.tar</literal>. Utilisez ce paramètre pour spécifier une autre extension de fichier. Gardez à l'esprit que les archives non-exécutables ne peuvent pas contenir <literal>.phar</literal> dans leur nom de fichier. </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::decompress</function></title> <programlisting role="php"> <![CDATA[ <?php $p = new PharData('/chemin/vers/mon.tar', 0, 'mon.tar.gz'); $p['monfichier.txt'] = 'salut'; $p['monfichier2.txt'] = 'salut'; $p3 = $p2->decompress(); // crée /chemin/vers/mon.tar ?> ]]> </programlisting> </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>PharData::compress</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>PharData::compress</function></member> <member><function>Phar::getSupportedCompression</function></member> <member><function>PharData::compressFiles</function></member> <member><function>PharData::decompressFiles</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/decompressFiles.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/decompressFiles.xml +++ phpdoc-fr/reference/phar/PharData/decompressFiles.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.decompressfiles"> <refnamediv> <refname>PharData::decompressFiles</refname> <refpurpose>Décompresse tous les fichier de l'archive zip courante</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::decompressFiles</methodname> <void /> </methodsynopsis> &phar.write; <para> Pour les archives basées sur tar, cette méthode soulève une exception <classname>BadMethodCallException</classname>, car la compression individuelle des fichiers au sein d'une archive tar n'est pas supportée par le format de fichier. 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 décompresse tous les fichiers de l'archive. 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é si au moins un des fichiers est compressé avec bzip2/zlib. </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 au moins un des fichiers est compressé avec 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::decompressFiles</function></title> <programlisting role="php"> <![CDATA[ <?php $p = new PharData('/chemin/vers/mon.zip'); $p['monfichier.txt'] = 'salut'; $p['monfichier2.txt'] = 'salut'; $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)); } $p->decompressFiles(); 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" int(4096) bool(false) bool(true) string(15) "monfichier2.txt" int(4096) bool(false) bool(true) string(14) "monfichier.txt" bool(false) bool(false) bool(false) string(15) "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::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::compressFiles</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/delMetadata.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/delMetadata.xml +++ phpdoc-fr/reference/phar/PharData/delMetadata.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.delmetadata" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::delMetadata</refname> <refpurpose>Efface les méta-données globales d'une archive zip</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>PharData::delMetadata</methodname> <void/> </methodsynopsis> &phar.write; <para> Efface les méta-données globales de l'archive zip </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> retourne &true; en cas de succès, mais il est préférable de vérifier les exception soulevées et de considérer le succès si aucune ne l'est. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> si des erreurs sont rencontrés lors de l'écriture des changements sur le disque. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharData::delMetaData</function></title> <programlisting role="php"> <![CDATA[ <?php try { $phar = new PharData('monphar.zip'); var_dump($phar->getMetadata()); $phar->setMetadata("salut"); var_dump($phar->getMetadata()); $phar->delMetadata(); var_dump($phar->getMetadata()); } catch (Exception $e) { // on traite les erreurs } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ NULL string(5) "salut" NULL ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::delMetadata</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/delete.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/delete.xml +++ phpdoc-fr/reference/phar/PharData/delete.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.delete" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::delete</refname> <refpurpose>Efface un fichier au sein de l'archive tar/zip</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>PharData::delete</methodname> <methodparam><type>string</type><parameter>entry</parameter></methodparam> </methodsynopsis> <para> Efface un fichier au sein de l'archive. C'est l'équivalent fonctionnel de l'appel à <function>unlink</function> à l'aide du gestionnaire de flux phar, comme montré dans l'exemple ci-dessous. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>entry</parameter></term> <listitem> <para> Chemin du fichier à effacer au sein de l'archive. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> retourne &true; en cas de succès, mais il est préférable de vérifier les exception soulevées et de considérer le succès si aucune ne l'est. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> si des erreurs sont rencontrés lors de l'écriture des changements sur le disque. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharData::delete</function></title> <programlisting role="php"> <![CDATA[ <?php try { $phar = new PharData('monphar.zip'); $phar->delete('efface/moi.php'); // c'est l'équivalent de : unlink('phar://monphar.phar/efface/mon.php'); } catch (Exception $e) { // on traite les erreurs } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::delete</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/extractTo.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/extractTo.xml +++ phpdoc-fr/reference/phar/PharData/extractTo.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.extractto" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::extractTo</refname> <refpurpose>Extrait le contenu d'une archive tar/zip vers un répertoire</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>PharData::extractTo</methodname> <methodparam><type>string</type><parameter>pathto</parameter></methodparam> <methodparam choice="opt"><type>string|array</type><parameter>files</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>overwrite</parameter></methodparam> </methodsynopsis> <para> Extrait tous les fichiers d'une archive tar/zip vers le disque. Les fichiers et les répertoires extraits conservent les permissions telles qu'au sein de l'archive. Les paramètres optionnels permettent un éventuel contrôle sur quels fichiers seront extraits et si les fichiers déjà présents sur le disque peuvent être écrasés. Le second paramètre <literal>files</literal> peut être le nom d'un fichier ou d'un répertoire à extraire, ou tableau de nom de fichiers et de répertoires à extraire. Par défaut, cette méthode n'écrasera aucun fichier déjà existant, à moins que le troisième paramètre soit à true. Cette méthode est identique à <function>ZipArchive::extractTo</function>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>pathto</parameter></term> <listitem> <para> Chemin au sein de l'archive des fichiers à effacer. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>files</parameter></term> <listitem> <para> Le nom d'un fichier ou d'un répertoire à extraire, ou un tableau de fichiers/répertoires à extraire </para> </listitem> </varlistentry> <varlistentry> <term><parameter>overwrite</parameter></term> <listitem> <para> &false; par défaut, passez le à &true; pour activer l'écrasement des fichiers déjà existants </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> retourne &true; en cas de succès, mais il est préférable de vérifier les exception soulevées et de considérer le succès si aucune ne l'est. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> si des erreurs sont rencontrés lors de l'écriture des changements sur le disque. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharData::extractTo</function></title> <programlisting role="php"> <![CDATA[ <?php try { $phar = new PharData('monphar.tar'); $phar->extractTo('/chemin/complet'); // extrait tous les fichiers $phar->extractTo('/un/autre/chemin', 'fichier.txt'); // extrait seulement fichier.txt $phar->extractTo('/ce/chemin', array('fichier1.txt', 'fichier2.txt')); // extrait seulement 2 fichiers $phar->extractTo('/troisieme/chemin', null, true); // extrait tous les fichiers, en écrasant } catch (Exception $e) { // on traite les erreurs } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::extractTo</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/isWritable.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/isWritable.xml +++ phpdoc-fr/reference/phar/PharData/isWritable.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.iswritable" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::isWritable</refname> <refpurpose>Retourne true si l'archive tar/zip peut être modifiée</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::isWritable</methodname> <void/> </methodsynopsis> <para> Cette méthode retourne &true; si l'archive tar/zip sur le disque n'est pas en lecture seule. Contrairement à <function>Phar::isWritable</function>, les archives tar/zip de données peuvent être modifiées même si <literal>phar.readonly</literal> est à <literal>1</literal>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> Aucun paramètre. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne &true; si l'archive tar/zip peut être modifiée </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::canWrite</function></member> <member><function>Phar::isWritable</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/offsetSet.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/offsetSet.xml +++ phpdoc-fr/reference/phar/PharData/offsetSet.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.offsetset"> <refnamediv> <refname>PharData::offsetSet</refname> <refpurpose>remplit un fichier au sein de l'archive tar/zip avec le contenu d'un fichier externe ou d'une chaîne de caractères</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>PharData::offsetSet</methodname> <methodparam><type>string</type><parameter>offset</parameter></methodparam> <methodparam><type>string</type><parameter>value</parameter></methodparam> </methodsynopsis> <para> C'est une implémentation de l'interface <interfacename>ArrayAccess</interfacename> permettant la manipulation directe du contenu d'une archive tar/zip en utilisant les crochets, opérateurs d'accès au tableau. offsetSet est utilisé pour modifier un fichier existant ou pour ajouter un nouveau fichier à l'archive tar/zip. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> Le chemin (relatif) du fichier à modifier au sein de l'archive tar ou zip. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>value</parameter></term> <listitem> <para> Contenu du fichier. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Aucune valeur de retour. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> si des problèmes ont été rencontrés lors de l'écriture sur le disque des changements de l'archive tar/zip. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharData::offsetSet</function></title> <para> offsetSet ne doit pas être accédé directement, mais plutôt utilisé via l'opérateur <literal>[]</literal>. </para> <programlisting role="php"> <![CDATA[ <?php $p = new PharData('/chemin/vers/mon.tar'); try { // appelle offsetSet $p['fichier.txt'] = 'Salut'; } catch (Exception $e) { echo 'Ne peut pas modifier fichier.txt:', $e; } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::offsetSet</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/offsetUnset.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/offsetUnset.xml +++ phpdoc-fr/reference/phar/PharData/offsetUnset.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.offsetunset"> <refnamediv> <refname>PharData::offsetUnset</refname> <refpurpose>efface un fichier d'une archive tar/zip</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::offsetUnset</methodname> <methodparam><type>string</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para> C'est une implémentation de l'interface <interfacename>ArrayAccess</interfacename> permettant la manipulation directe du contenu d'une archive tar/zip en utilisant les crochets, opérateurs d'accès au tableau. offsetUnset est utilisé pour effacer un fichier existant et est appelé par la construction de langage <function>unset</function>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> Le chemin (relatif) du fichier à modifier au sein de l'archive tar ou zip. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> si des problèmes ont été rencontrés lors de l'écriture sur le disque des changements de l'archive tar/zip. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharData::offsetUnset</function></title> <programlisting role="php"> <![CDATA[ <?php $p = new PharData('/chemin/vers/mon.zip'); try { // efface fichier.txt de mon.zip en appelant offsetUnset unset($p['fichier.txt']); } catch (Exception $e) { echo 'Ne peut pas effacer fichier.txt: ', $e; } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <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/PharData/setAlias.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/setAlias.xml +++ phpdoc-fr/reference/phar/PharData/setAlias.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.setalias" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharData::setAlias</refname> <refpurpose>fonction inutile (Phar::setAlias n'est pas valide pour PharData)</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharData::setAlias</methodname> <methodparam><type>string</type><parameter>alias</parameter></methodparam> </methodsynopsis> <para> Les archives tar/zip non exécutables ne peuvent pas avoir d'alias, donc cette méthode ne fait que soulever une exception. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>alias</parameter></term> <listitem> <para> Une courte chaîne de caractère à laquelle se référer pour faire appel à l'archive via le gestionnaire de flux phar. Ce paramètre est ignoré. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> lors de l'appel à la méthode </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::setAlias</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/setDefaultStub.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/setDefaultStub.xml +++ phpdoc-fr/reference/phar/PharData/setDefaultStub.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.setdefaultstub"> <refnamediv> <refname>PharData::setDefaultStub</refname> <refpurpose>fonction inutile (Phar::setDefaultStub n'est pas valide pour PharData)</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>PharData::setDefaultStub</methodname> <methodparam choice="opt"><type>string</type><parameter>index</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>webindex</parameter></methodparam> </methodsynopsis> <para> Les archives tar/zip non-exécutables ne peuvent pas avoir de conteneur de chargement, donc cette méthode ne fait que soulever une exception. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>index</parameter></term> <listitem> <para> Chemin relatif au sein de l'archive phar à exécuter en cas d'accès à partir de la ligne de commande </para> </listitem> </varlistentry> <varlistentry> <term><parameter>webindex</parameter></term> <listitem> <para> Chemin relatif au sein de l'archive phar à exécuter en cas d'accès à partir d'un navigateur </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> lors de l'appel à la méthode </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::setDefaultStub</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/setMetadata.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/setMetadata.xml +++ phpdoc-fr/reference/phar/PharData/setMetadata.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.setmetadata"> <refnamediv> <refname>Phar::setMetadata</refname> <refpurpose>Fixe les méta-données de l'archive</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>Phar::setMetadata</methodname> <methodparam><type>mixed</type><parameter>metadata</parameter></methodparam> </methodsynopsis> &phar.write; <para> <function>Phar::setMetadata</function> doit être utilisé pour stocker des méta-données personnalisées qui décrivent quelque chose à propos de l'archive phar en tant qu'entité complète. <function>PharFileInfo::setMetadata</function> doit être utilisé pour les méta-données spécifiques aux fichiers. Les méta-données peuvent dégrader les performances de chargement d'une archive phar si les données sont trop lourdes. </para> <para> Les méta-données peuvent être utilisées pour spécifier quel fichier au sein de l'archive doit être utilisé pour charger l'archive ou l'emplacement d'un fichier de manifeste comme le fichier package.xml de <link xlink:href="http://pear.php.net">PEAR</link>. De manière générale, n'importe quelle données utile décrivant l'archive phar peut être stockée. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>metadata</parameter></term> <listitem> <para> N'importe quelle variable PHP contenant de l'information à stocker pour décrire l'archive phar </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::setMetadata</function></title> <para> </para> <programlisting role="php"> <![CDATA[ <?php // on s'assure que le phar n'existe pas @unlink('nouveauphar.phar'); try { $p = new Phar(dirname(__FILE__) . '/nouveauphar.phar', 0, 'nouveauphar.phar'); $p['fichier.php'] = '<?php echo "salut"'; $p->setMetadata(array('chargement' => 'fichier.php')); var_dump($p->getMetadata()); } catch (Exception $e) { echo 'Ne peut pas créer/modifier le phar:', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array(1) { ["chargement"]=> string(11) "fichier.php" } ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::getMetadata</function></member> <member><function>Phar::delMetadata</function></member> <member><function>Phar::hasMetadata</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/setSignatureAlgorithm.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/setSignatureAlgorithm.xml +++ phpdoc-fr/reference/phar/PharData/setSignatureAlgorithm.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="phardata.setsignaturealgorithm" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Phar::setSignatureAlgorithm</refname> <refpurpose>fixe l'algorithme de signature d'un phar et l'applique.</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>Phar::setSignatureAlgorithm</methodname> <methodparam><type>int</type><parameter>sigtype</parameter></methodparam> </methodsynopsis> &phar.write; <para> fixe l'algorithme de signature d'un phar et l'applique. L'agorithme de signature doit être <literal>Phar::MD5</literal>, <literal>Phar::SHA1</literal>, <literal>Phar::SHA256</literal>, <literal>Phar::SHA512</literal>, ou <literal>Phar::PGP</literal> (pgp n'est pas encore supporté et implique SHA-1). </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>sigtype</parameter></term> <listitem> <para> Un algorithme parmi <literal>Phar::MD5</literal>, <literal>Phar::SHA1</literal>, <literal>Phar::SHA256</literal>, <literal>Phar::SHA512</literal>, or <literal>Phar::PGP</literal> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>UnexpectedValueException</classname> pour beaucoup d'erreurs, une exception <classname>BadMethodCallException</classname> si l'appel est fait pour une archive phar basée sur tar ou sur zip, une exception <classname>PharException</classname> si des problèmes sont rencontrés lors de l'écriture des changements sur le disque. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::getSupportedSignatures</function></member> <member><function>Phar::getSignature</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/setStub.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharData/setStub.xml +++ phpdoc-fr/reference/phar/PharData/setStub.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.setstub"> <refnamediv> <refname>PharData::setStub</refname> <refpurpose>fonction inutile (Phar::setStub n'est pas valide pour PharData)</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>PharData::setStub</methodname> <methodparam><type>string</type><parameter>stub</parameter></methodparam> </methodsynopsis> <para> Les archives tar/zip non-exécutables ne peuvent pas avoir de conteneur de chargement, donc cette méthode ne fait que soulever une exception. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>stub</parameter></term> <listitem> <para> Une chaîne de caractères ou un gestionnaire de flux ouvert à utiliser en tant que conteneur de chargement exécutable pour l'archive phar. Ce paramètre est ignoré. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> lors de tout appel à la méthode </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::setStub</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 -->