cvs: phpdoc-fr /reference/phar/PharFileInfo hasMetadata.xml isCRCChecked.xml isCompressed.xml isCompressedBZIP2.xml isCompressedGZ.xml
setCompressedBZIP2.xml setCompressedGZ.xml setMetadata.xml setUncompressed.xml
| From: | Guillaume Plessis | Date: | Fri, 13 Feb 2009 10:51:57 +0000 |
| Subject: | cvs: phpdoc-fr /reference/phar/PharFileInfo hasMetadata.xml isCRCChecked.xml isCompressed.xml isCompressedBZIP2.xml isCompressedGZ.xml setCompressedBZIP2.xml setCompressedGZ.xml setMetadata.xml setUncompressed.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-6671@lists.php.net to get a copy of this message | ||
gui Fri Feb 13 10:51:57 2009 UTC
Added files:
/phpdoc-fr/reference/phar/PharFileInfo hasMetadata.xml
isCRCChecked.xml
isCompressed.xml
isCompressedBZIP2.xml
isCompressedGZ.xml
setCompressedBZIP2.xml
setCompressedGZ.xml
setMetadata.xml
setUncompressed.xml
Log:
initial translation
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/PharFileInfo/hasMetadata.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/hasMetadata.xml +++ phpdoc-fr/reference/phar/PharFileInfo/hasMetadata.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xml:id="pharfileinfo.hasmetadata" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharFileInfo::hasMetadata</refname> <refpurpose>Retourne les méta-données de l'entrée</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::hasMetadata</methodname> <void/> </methodsynopsis> <para> Retourne les méta-données d'un fichier au sein d'une archive Phar. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> Aucun paramètre. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne &false; si aucune méta-donnée n'est présente ou vaut &null;, &true; si les méta-données ne valent pas &null; </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::setMetadata</function></member> <member><function>PharFileInfo::getMetadata</function></member> <member><function>PharFileInfo::delMetadata</function></member> <member><function>Phar::setMetadata</function></member> <member><function>Phar::hasMetadata</function></member> <member><function>Phar::getMetadata</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/PharFileInfo/isCRCChecked.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/isCRCChecked.xml +++ phpdoc-fr/reference/phar/PharFileInfo/isCRCChecked.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="pharfileinfo.iscrcchecked"> <refnamediv> <refname>PharFileInfo::isCRCChecked</refname> <refpurpose>Détermine si le fichier a un CRC vérifié</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::isCRCChecked</methodname> <void/> </methodsynopsis> <para> Cette méthode détermine si un fichier au sein d'une archive Phar a un CRC vérifié. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &true; si le fichier a un CRC vérifié, &false; sinon. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::isCRCChecked</function></title> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $file = $p['monfichier.txt']; var_dump($file->isCRCChecked()); } catch (Exception $e) { echo 'La création/modification de mon.phar a échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ bool(true) ]]> </screen> </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/PharFileInfo/isCompressed.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/isCompressed.xml +++ phpdoc-fr/reference/phar/PharFileInfo/isCompressed.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="pharfileinfo.iscompressed"> <refnamediv> <refname>PharFileInfo::isCompressed</refname> <refpurpose>Retourne si l'entrée est compressée</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::isCompressed</methodname> <methodparam choice="opt"><type>int</type><parameter>compression_type</parameter><initializer>9021976</initializer></methodparam> </methodsynopsis> <para> Cette méthode détermine si un fichier au sein d'une archive Phar est compressé avec une des compression Gzip o Bzip2. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>compression_type</parameter></term> <listitem> <para> Une des compressions <constant>Phar::GZ</constant> ou <constant>Phar::BZ2</constant>, aucune compression par défaut. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &true; si le fichier au sein de l'archive est compressé, &false; sinon. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::isCompressed</function></title> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $p['monfichier2.txt'] = 'salut'; $p['monfichier2.txt']->setCompressedGZ(); $file = $p['monfichier.txt']; $file2 = $p['monfichier2.txt']; var_dump($file->isCompressed()); var_dump($file2->isCompressed()); } catch (Exception $e) { echo 'La création/modification de mon.phar a échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ bool(false) bool(true) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::getCompressedSize</function></member> <member><function>PharFileInfo::decompress</function></member> <member><function>PharFileInfo::compress</function></member> <member><function>Phar::decompress</function></member> <member><function>Phar::compress</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::getSupportedCompression</function></member> <member><function>Phar::decompressFiles</function></member> <member><function>Phar::compressFiles</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/PharFileInfo/isCompressedBZIP2.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/isCompressedBZIP2.xml +++ phpdoc-fr/reference/phar/PharFileInfo/isCompressedBZIP2.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="pharfileinfo.iscompressedbzip2"> <refnamediv> <refname>PharFileInfo::isCompressedBZIP2</refname> <refpurpose>Détermine si l'entrée est compressée avec bzip2</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::isCompressedBZIP2</methodname> <void/> </methodsynopsis> &phar.removed.pharfileinfocompress; <para> Cetté méthode détermine si le fichier au sein de l'archive Phar est compressé avec Bzip2. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &true; si le fichier au sein de l'archive Phar est compressé avec Bzip2, &false; sinon. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::isCompressedBZIP2</function></title> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $p['monfichier2.txt'] = 'salut'; $p['monfichier3.txt'] = 'salut'; $p['monfichier2.txt']->setCompressedGZ(); $p['monfichier3.txt']->setCompressedBZIP2(); $file = $p['monfichier.txt']; $file2 = $p['monfichier2.txt']; $file3 = $p['monfichier3.txt']; var_dump($file->isCompressedBZIP2()); var_dump($file2->isCompressedBZIP2()); var_dump($file3->isCompressedBZIP2()); } catch (Exception $e) { echo 'La création/modification de mon.phar a échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ bool(false) 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::isCompressedGZ</function></member> <member><function>PharFileInfo::setCompressedBZIP2</function></member> <member><function>PharFileInfo::setUncompressed</function></member> <member><function>PharFileInfo::setCompressedGZ</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compressAllFilesBZIP2</function></member> <member><function>Phar::compressAllFilesGZ</function></member> <member><function>Phar::getSupportedCompression</function></member> <member><function>Phar::uncompressAllFiles</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/PharFileInfo/isCompressedGZ.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/isCompressedGZ.xml +++ phpdoc-fr/reference/phar/PharFileInfo/isCompressedGZ.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="pharfileinfo.iscompressedgz"> <refnamediv> <refname>PharFileInfo::isCompressedGZ</refname> <refpurpose>Détermine si l'entrée est compressée avec gzip</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::isCompressedGZ</methodname> <void/> </methodsynopsis> &phar.removed.pharfileinfocompress; <para> Cette méthode détermine si un fichier au sein de l'archive Phar est compressé avec Gzip. with Gzip compression. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &true; si le fichier au sein de l'archive Phar est compressé avec Gzip, &false; sinon. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::isCompressedGZ</function></title> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $p['monfichier2.txt'] = 'salut'; $p['monfichier3.txt'] = 'salut'; $p['monfichier2.txt']->setCompressedGZ(); $p['monfichier3.txt']->setCompressedBZIP2(); $file = $p['monfichier.txt']; $file2 = $p['monfichier2.txt']; $file3 = $p['monfichier3.txt']; var_dump($file->isCompressedGZ()); var_dump($file2->isCompressedGZ()); var_dump($file3->isCompressedGZ()); } catch (Exception $e) { echo 'La création/modification de mon.phar a échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ bool(false) bool(true) bool(false) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::getCompressedSize</function></member> <member><function>PharFileInfo::isCompressedBZIP2</function></member> <member><function>PharFileInfo::isCompressed</function></member> <member><function>PharFileInfo::setCompressedBZIP2</function></member> <member><function>PharFileInfo::setUncompressed</function></member> <member><function>PharFileInfo::setCompressedGZ</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compressAllFilesBZIP2</function></member> <member><function>Phar::compressAllFilesGZ</function></member> <member><function>Phar::getSupportedCompression</function></member> <member><function>Phar::uncompressAllFiles</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/PharFileInfo/setCompressedBZIP2.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/setCompressedBZIP2.xml +++ phpdoc-fr/reference/phar/PharFileInfo/setCompressedBZIP2.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="pharfileinfo.setcompressedbzip2"> <refnamediv> <refname>PharFileInfo::setCompressedBZIP2</refname> <refpurpose>Compresse l'entrée Phar courante au sein du phar avec Bzip2</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::setCompressedBZIP2</methodname> <void/> </methodsynopsis> &phar.removed.pharfileinfocompress; <para> Cette méthode compresse le fichier au sein de l'archive Phar en utilisant bzip2. L'extension <link linkend="ref.bzip2">bzip2</link> doit être activée doit être activée pour tirer parti de cette fonctionnalité. De plus, si au moins un fichier est déjà compressé avec gzip, l'extension <link linkend="ref.zlib">zlib</link> doit être activée pour décompresser le fichier. Comme avec toutes les fonctionnalités qui modifient le contenu du phar, la variable INI <link linkend="ini.phar.readonly">phar.readonly</link> doit être à off pour réussir. </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, ou si l'extension <link linkend="ref.bzip2">bzip2</link> n'est pas disponible. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::setCompressedBZIP2</function></title> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $file = $p['monfichier.txt']; var_dump($file->isCompressedBZIP2()); $p['monfichier.txt']->setCompressedBZIP2(); var_dump($file->isCompressedBZIP2()); } catch (Exception $e) { echo 'La création/modification de mon.phar a échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ bool(false) bool(true) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::getCompressedSize</function></member> <member><function>PharFileInfo::isCompressedBZIP2</function></member> <member><function>PharFileInfo::isCompressed</function></member> <member><function>PharFileInfo::isCompressedGZ</function></member> <member><function>PharFileInfo::setUncompressed</function></member> <member><function>PharFileInfo::setCompressedGZ</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compressAllFilesBZIP2</function></member> <member><function>Phar::compressAllFilesGZ</function></member> <member><function>Phar::getSupportedCompression</function></member> <member><function>Phar::uncompressAllFiles</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/PharFileInfo/setCompressedGZ.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/setCompressedGZ.xml +++ phpdoc-fr/reference/phar/PharFileInfo/setCompressedGZ.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="pharfileinfo.setcompressedgz"> <refnamediv> <refname>PharFileInfo::setCompressedGZ</refname> <refpurpose>Compresse l'entrée Phar courante au sein du phar avec gzip</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::setCompressedGZ</methodname> <void/> </methodsynopsis> &phar.removed.pharfileinfocompress; <para> Cette méthode compresse le fichier au sein de l'archive Phar en utilisant gzip. L'extension <link linkend="ref.zlib">zlib</link> doit être activée doit être activée pour tirer parti de cette fonctionnalité. De plus, si au moins un fichier est déjà compressé avec bzip2, l'extension <link linkend="ref.bzip2">bzip2</link> doit être activée pour décompresser le fichier. Comme avec toutes les fonctionnalités qui modifient le contenu du phar, la variable INI <link linkend="ini.phar.readonly">phar.readonly</link> doit être à off pour réussir. </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, ou si l'extension <link linkend="ref.zlib">zlib</link> n'est pas disponible. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::setCompressedGZ</function></title> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $file = $p['monfichier.txt']; var_dump($file->isCompressedGZ()); $p['monfichier.txt']->setCompressedGZ(); var_dump($file->isCompressedGZ()); } catch (Exception $e) { echo 'La création/modification de mon.phar a échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ bool(false) bool(true) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::getCompressedSize</function></member> <member><function>PharFileInfo::isCompressedBZIP2</function></member> <member><function>PharFileInfo::isCompressed</function></member> <member><function>PharFileInfo::isCompressedGZ</function></member> <member><function>PharFileInfo::setCompressedBZIP2</function></member> <member><function>PharFileInfo::setUncompressed</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compressAllFilesBZIP2</function></member> <member><function>Phar::compressAllFilesGZ</function></member> <member><function>Phar::getSupportedCompression</function></member> <member><function>Phar::uncompressAllFiles</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/PharFileInfo/setMetadata.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/setMetadata.xml +++ phpdoc-fr/reference/phar/PharFileInfo/setMetadata.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="pharfileinfo.setmetadata"> <refnamediv> <refname>PharFileInfo::setMetaData</refname> <refpurpose>Fixe les méta-données spécifiques à un fichier</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>PharFileInfo::setMetaData</methodname> <methodparam><type>mixed</type><parameter>metadata</parameter></methodparam> </methodsynopsis> <para> <function>PharFileInfo::setMetaData</function> ne doit être utilisée que pour stocker des données personnalisées dans un fichier qui ne peuvent pas l'être avec des informations normalement stockées avec le fichier. Les méta-données peuvent dégrader les performances de chargement d'une archive phar si les données sont trop lourdes ou s'il y a beaucoup de fichiers avec des méta-données. Il est important de noter que les permissions de fichiers sont supportées nativement dans un phar; il est possible de les fixer avec la méthode <function>PharFileInfo::chmod</function>. Comme avec toutes les fonctionnalités qui modifient le contenu du phar, la variable INI <link linkend="ini.phar.readonly">phar.readonly</link> doit être à off pour réussir si le fchier est au seint d'une archive <classname>Phar</classname>. Les fichiers au sein d'archives <classname>PharData</classname> n'ont pas cette restriction. </para> <para> Une utilisation possible des méta-données est le passage d'un utilisateur/groupe qui devrait être utilisé quand un fichier est extrait du phar vers le disque. On peut aussi spécifier un type MIME à retourner. De manière générale, on peut stocker toute donnée utile qui décrit un fichier mais qui ne peut pas y être inscrite directement. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>metadata</parameter></term> <listitem> <para> Toute variable PHP contenant des informations à stocker à part du fichier </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::setMetaData</function></title> <para> </para> <programlisting role="php"> <![CDATA[ <?php // on s'assure que le phar n'existe pas déjà @unlink('nouveauphar.phar'); try { $p = new Phar(dirname(__FILE__) . '/nouveauphar.phar', 0, 'nouveauphar.phar'); $p['fichier.txt'] = 'salut'; $p['fichier.txt']->setMetaData(array('utilisateur' => 'Yannick', 'mime-type' => 'text/plain')); var_dump($p['fichier.txt']->getMetaData()); } catch (Exception $e) { echo 'Ne peut pas créer/modifier le phar : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array(2) { ["utilisateur"]=> string(7) "Yannick" ["mime-type"]=> string(10) "text/plain" } ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::hasMetadata</function></member> <member><function>PharFileInfo::getMetadata</function></member> <member><function>PharFileInfo::delMetadata</function></member> <member><function>Phar::setMetadata</function></member> <member><function>Phar::hasMetadata</function></member> <member><function>Phar::getMetadata</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/PharFileInfo/setUncompressed.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/setUncompressed.xml +++ phpdoc-fr/reference/phar/PharFileInfo/setUncompressed.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="pharfileinfo.setuncompressed"> <refnamediv> <refname>PharFileInfo::setUncompressed</refname> <refpurpose>Décompresse l'entrée Phar courante au sein du phar s'il y a lieu</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::setUncompressed</methodname> <void/> </methodsynopsis> &phar.removed.pharfileinfocompress; <para> Cette méthode décompresse le fichier au sein de l'archive Phar. Selon la façon dont le fichier est compressé, les extensions <link linkend="ref.bzip2">bzip2</link> ou <link linkend="ref.zlib">zlib</link> doivent être activées pour tirer parti de cette fonctionnalité. Comme avec toutes les fonctionnalités qui modifient le contenu du phar, la variable INI <link linkend="ini.phar.readonly">phar.readonly</link> doit être à off pour réussir. </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, ou si l'extension <link linkend="ref.bzip2">bzip2</link>/<link linkend="ref.zlib">zlib</link> n'est pas disponible. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::setUncompressed</function></title> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $file = $p['monfichier.txt']; $file->setCompressedGZ(); var_dump($file->isCompressed()); $p['monfichier.txt']->setUncompressed(); var_dump($file->isCompressed()); } catch (Exception $e) { echo 'La création/modification de mon.phar a échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ bool(true) bool(false) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::getCompressedSize</function></member> <member><function>PharFileInfo::isCompressedBZIP2</function></member> <member><function>PharFileInfo::isCompressed</function></member> <member><function>PharFileInfo::isCompressedGZ</function></member> <member><function>PharFileInfo::setCompressedBZIP2</function></member> <member><function>PharFileInfo::setCompressedGZ</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compressAllFilesBZIP2</function></member> <member><function>Phar::compressAllFilesGZ</function></member> <member><function>Phar::getSupportedCompression</function></member> <member><function>Phar::uncompressAllFiles</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/PharFileInfo/hasMetadata.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/hasMetadata.xml +++ phpdoc-fr/reference/phar/PharFileInfo/hasMetadata.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xml:id="pharfileinfo.hasmetadata" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharFileInfo::hasMetadata</refname> <refpurpose>Retourne les méta-données de l'entrée</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::hasMetadata</methodname> <void/> </methodsynopsis> <para> Retourne les méta-données d'un fichier au sein d'une archive Phar. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> Aucun paramètre. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne &false; si aucune méta-donnée n'est présente ou vaut &null;, &true; si les méta-données ne valent pas &null; </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::setMetadata</function></member> <member><function>PharFileInfo::getMetadata</function></member> <member><function>PharFileInfo::delMetadata</function></member> <member><function>Phar::setMetadata</function></member> <member><function>Phar::hasMetadata</function></member> <member><function>Phar::getMetadata</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/PharFileInfo/isCRCChecked.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/isCRCChecked.xml +++ phpdoc-fr/reference/phar/PharFileInfo/isCRCChecked.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="pharfileinfo.iscrcchecked"> <refnamediv> <refname>PharFileInfo::isCRCChecked</refname> <refpurpose>Détermine si le fichier a un CRC vérifié</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::isCRCChecked</methodname> <void/> </methodsynopsis> <para> Cette méthode détermine si un fichier au sein d'une archive Phar a un CRC vérifié. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &true; si le fichier a un CRC vérifié, &false; sinon. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::isCRCChecked</function></title> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $file = $p['monfichier.txt']; var_dump($file->isCRCChecked()); } catch (Exception $e) { echo 'La création/modification de mon.phar a échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ bool(true) ]]> </screen> </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/PharFileInfo/isCompressed.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/isCompressed.xml +++ phpdoc-fr/reference/phar/PharFileInfo/isCompressed.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="pharfileinfo.iscompressed"> <refnamediv> <refname>PharFileInfo::isCompressed</refname> <refpurpose>Retourne si l'entrée est compressée</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::isCompressed</methodname> <methodparam choice="opt"><type>int</type><parameter>compression_type</parameter><initializer>9021976</initializer></methodparam> </methodsynopsis> <para> Cette méthode détermine si un fichier au sein d'une archive Phar est compressé avec une des compression Gzip o Bzip2. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>compression_type</parameter></term> <listitem> <para> Une des compressions <constant>Phar::GZ</constant> ou <constant>Phar::BZ2</constant>, aucune compression par défaut. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &true; si le fichier au sein de l'archive est compressé, &false; sinon. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::isCompressed</function></title> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $p['monfichier2.txt'] = 'salut'; $p['monfichier2.txt']->setCompressedGZ(); $file = $p['monfichier.txt']; $file2 = $p['monfichier2.txt']; var_dump($file->isCompressed()); var_dump($file2->isCompressed()); } catch (Exception $e) { echo 'La création/modification de mon.phar a échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ bool(false) bool(true) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::getCompressedSize</function></member> <member><function>PharFileInfo::decompress</function></member> <member><function>PharFileInfo::compress</function></member> <member><function>Phar::decompress</function></member> <member><function>Phar::compress</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::getSupportedCompression</function></member> <member><function>Phar::decompressFiles</function></member> <member><function>Phar::compressFiles</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/PharFileInfo/isCompressedBZIP2.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/isCompressedBZIP2.xml +++ phpdoc-fr/reference/phar/PharFileInfo/isCompressedBZIP2.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="pharfileinfo.iscompressedbzip2"> <refnamediv> <refname>PharFileInfo::isCompressedBZIP2</refname> <refpurpose>Détermine si l'entrée est compressée avec bzip2</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::isCompressedBZIP2</methodname> <void/> </methodsynopsis> &phar.removed.pharfileinfocompress; <para> Cetté méthode détermine si le fichier au sein de l'archive Phar est compressé avec Bzip2. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &true; si le fichier au sein de l'archive Phar est compressé avec Bzip2, &false; sinon. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::isCompressedBZIP2</function></title> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $p['monfichier2.txt'] = 'salut'; $p['monfichier3.txt'] = 'salut'; $p['monfichier2.txt']->setCompressedGZ(); $p['monfichier3.txt']->setCompressedBZIP2(); $file = $p['monfichier.txt']; $file2 = $p['monfichier2.txt']; $file3 = $p['monfichier3.txt']; var_dump($file->isCompressedBZIP2()); var_dump($file2->isCompressedBZIP2()); var_dump($file3->isCompressedBZIP2()); } catch (Exception $e) { echo 'La création/modification de mon.phar a échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ bool(false) 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::isCompressedGZ</function></member> <member><function>PharFileInfo::setCompressedBZIP2</function></member> <member><function>PharFileInfo::setUncompressed</function></member> <member><function>PharFileInfo::setCompressedGZ</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compressAllFilesBZIP2</function></member> <member><function>Phar::compressAllFilesGZ</function></member> <member><function>Phar::getSupportedCompression</function></member> <member><function>Phar::uncompressAllFiles</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/PharFileInfo/isCompressedGZ.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/isCompressedGZ.xml +++ phpdoc-fr/reference/phar/PharFileInfo/isCompressedGZ.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="pharfileinfo.iscompressedgz"> <refnamediv> <refname>PharFileInfo::isCompressedGZ</refname> <refpurpose>Détermine si l'entrée est compressée avec gzip</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::isCompressedGZ</methodname> <void/> </methodsynopsis> &phar.removed.pharfileinfocompress; <para> Cette méthode détermine si un fichier au sein de l'archive Phar est compressé avec Gzip. with Gzip compression. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &true; si le fichier au sein de l'archive Phar est compressé avec Gzip, &false; sinon. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::isCompressedGZ</function></title> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $p['monfichier2.txt'] = 'salut'; $p['monfichier3.txt'] = 'salut'; $p['monfichier2.txt']->setCompressedGZ(); $p['monfichier3.txt']->setCompressedBZIP2(); $file = $p['monfichier.txt']; $file2 = $p['monfichier2.txt']; $file3 = $p['monfichier3.txt']; var_dump($file->isCompressedGZ()); var_dump($file2->isCompressedGZ()); var_dump($file3->isCompressedGZ()); } catch (Exception $e) { echo 'La création/modification de mon.phar a échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ bool(false) bool(true) bool(false) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::getCompressedSize</function></member> <member><function>PharFileInfo::isCompressedBZIP2</function></member> <member><function>PharFileInfo::isCompressed</function></member> <member><function>PharFileInfo::setCompressedBZIP2</function></member> <member><function>PharFileInfo::setUncompressed</function></member> <member><function>PharFileInfo::setCompressedGZ</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compressAllFilesBZIP2</function></member> <member><function>Phar::compressAllFilesGZ</function></member> <member><function>Phar::getSupportedCompression</function></member> <member><function>Phar::uncompressAllFiles</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/PharFileInfo/setCompressedBZIP2.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/setCompressedBZIP2.xml +++ phpdoc-fr/reference/phar/PharFileInfo/setCompressedBZIP2.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="pharfileinfo.setcompressedbzip2"> <refnamediv> <refname>PharFileInfo::setCompressedBZIP2</refname> <refpurpose>Compresse l'entrée Phar courante au sein du phar avec Bzip2</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::setCompressedBZIP2</methodname> <void/> </methodsynopsis> &phar.removed.pharfileinfocompress; <para> Cette méthode compresse le fichier au sein de l'archive Phar en utilisant bzip2. L'extension <link linkend="ref.bzip2">bzip2</link> doit être activée doit être activée pour tirer parti de cette fonctionnalité. De plus, si au moins un fichier est déjà compressé avec gzip, l'extension <link linkend="ref.zlib">zlib</link> doit être activée pour décompresser le fichier. Comme avec toutes les fonctionnalités qui modifient le contenu du phar, la variable INI <link linkend="ini.phar.readonly">phar.readonly</link> doit être à off pour réussir. </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, ou si l'extension <link linkend="ref.bzip2">bzip2</link> n'est pas disponible. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::setCompressedBZIP2</function></title> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $file = $p['monfichier.txt']; var_dump($file->isCompressedBZIP2()); $p['monfichier.txt']->setCompressedBZIP2(); var_dump($file->isCompressedBZIP2()); } catch (Exception $e) { echo 'La création/modification de mon.phar a échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ bool(false) bool(true) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::getCompressedSize</function></member> <member><function>PharFileInfo::isCompressedBZIP2</function></member> <member><function>PharFileInfo::isCompressed</function></member> <member><function>PharFileInfo::isCompressedGZ</function></member> <member><function>PharFileInfo::setUncompressed</function></member> <member><function>PharFileInfo::setCompressedGZ</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compressAllFilesBZIP2</function></member> <member><function>Phar::compressAllFilesGZ</function></member> <member><function>Phar::getSupportedCompression</function></member> <member><function>Phar::uncompressAllFiles</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/PharFileInfo/setCompressedGZ.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/setCompressedGZ.xml +++ phpdoc-fr/reference/phar/PharFileInfo/setCompressedGZ.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="pharfileinfo.setcompressedgz"> <refnamediv> <refname>PharFileInfo::setCompressedGZ</refname> <refpurpose>Compresse l'entrée Phar courante au sein du phar avec gzip</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::setCompressedGZ</methodname> <void/> </methodsynopsis> &phar.removed.pharfileinfocompress; <para> Cette méthode compresse le fichier au sein de l'archive Phar en utilisant gzip. L'extension <link linkend="ref.zlib">zlib</link> doit être activée doit être activée pour tirer parti de cette fonctionnalité. De plus, si au moins un fichier est déjà compressé avec bzip2, l'extension <link linkend="ref.bzip2">bzip2</link> doit être activée pour décompresser le fichier. Comme avec toutes les fonctionnalités qui modifient le contenu du phar, la variable INI <link linkend="ini.phar.readonly">phar.readonly</link> doit être à off pour réussir. </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, ou si l'extension <link linkend="ref.zlib">zlib</link> n'est pas disponible. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::setCompressedGZ</function></title> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $file = $p['monfichier.txt']; var_dump($file->isCompressedGZ()); $p['monfichier.txt']->setCompressedGZ(); var_dump($file->isCompressedGZ()); } catch (Exception $e) { echo 'La création/modification de mon.phar a échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ bool(false) bool(true) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::getCompressedSize</function></member> <member><function>PharFileInfo::isCompressedBZIP2</function></member> <member><function>PharFileInfo::isCompressed</function></member> <member><function>PharFileInfo::isCompressedGZ</function></member> <member><function>PharFileInfo::setCompressedBZIP2</function></member> <member><function>PharFileInfo::setUncompressed</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compressAllFilesBZIP2</function></member> <member><function>Phar::compressAllFilesGZ</function></member> <member><function>Phar::getSupportedCompression</function></member> <member><function>Phar::uncompressAllFiles</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/PharFileInfo/setMetadata.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/setMetadata.xml +++ phpdoc-fr/reference/phar/PharFileInfo/setMetadata.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="pharfileinfo.setmetadata"> <refnamediv> <refname>PharFileInfo::setMetaData</refname> <refpurpose>Fixe les méta-données spécifiques à un fichier</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>PharFileInfo::setMetaData</methodname> <methodparam><type>mixed</type><parameter>metadata</parameter></methodparam> </methodsynopsis> <para> <function>PharFileInfo::setMetaData</function> ne doit être utilisée que pour stocker des données personnalisées dans un fichier qui ne peuvent pas l'être avec des informations normalement stockées avec le fichier. Les méta-données peuvent dégrader les performances de chargement d'une archive phar si les données sont trop lourdes ou s'il y a beaucoup de fichiers avec des méta-données. Il est important de noter que les permissions de fichiers sont supportées nativement dans un phar; il est possible de les fixer avec la méthode <function>PharFileInfo::chmod</function>. Comme avec toutes les fonctionnalités qui modifient le contenu du phar, la variable INI <link linkend="ini.phar.readonly">phar.readonly</link> doit être à off pour réussir si le fchier est au seint d'une archive <classname>Phar</classname>. Les fichiers au sein d'archives <classname>PharData</classname> n'ont pas cette restriction. </para> <para> Une utilisation possible des méta-données est le passage d'un utilisateur/groupe qui devrait être utilisé quand un fichier est extrait du phar vers le disque. On peut aussi spécifier un type MIME à retourner. De manière générale, on peut stocker toute donnée utile qui décrit un fichier mais qui ne peut pas y être inscrite directement. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>metadata</parameter></term> <listitem> <para> Toute variable PHP contenant des informations à stocker à part du fichier </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::setMetaData</function></title> <para> </para> <programlisting role="php"> <![CDATA[ <?php // on s'assure que le phar n'existe pas déjà @unlink('nouveauphar.phar'); try { $p = new Phar(dirname(__FILE__) . '/nouveauphar.phar', 0, 'nouveauphar.phar'); $p['fichier.txt'] = 'salut'; $p['fichier.txt']->setMetaData(array('utilisateur' => 'Yannick', 'mime-type' => 'text/plain')); var_dump($p['fichier.txt']->getMetaData()); } catch (Exception $e) { echo 'Ne peut pas créer/modifier le phar : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array(2) { ["utilisateur"]=> string(7) "Yannick" ["mime-type"]=> string(10) "text/plain" } ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::hasMetadata</function></member> <member><function>PharFileInfo::getMetadata</function></member> <member><function>PharFileInfo::delMetadata</function></member> <member><function>Phar::setMetadata</function></member> <member><function>Phar::hasMetadata</function></member> <member><function>Phar::getMetadata</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/PharFileInfo/setUncompressed.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/setUncompressed.xml +++ phpdoc-fr/reference/phar/PharFileInfo/setUncompressed.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="pharfileinfo.setuncompressed"> <refnamediv> <refname>PharFileInfo::setUncompressed</refname> <refpurpose>Décompresse l'entrée Phar courante au sein du phar s'il y a lieu</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::setUncompressed</methodname> <void/> </methodsynopsis> &phar.removed.pharfileinfocompress; <para> Cette méthode décompresse le fichier au sein de l'archive Phar. Selon la façon dont le fichier est compressé, les extensions <link linkend="ref.bzip2">bzip2</link> ou <link linkend="ref.zlib">zlib</link> doivent être activées pour tirer parti de cette fonctionnalité. Comme avec toutes les fonctionnalités qui modifient le contenu du phar, la variable INI <link linkend="ini.phar.readonly">phar.readonly</link> doit être à off pour réussir. </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, ou si l'extension <link linkend="ref.bzip2">bzip2</link>/<link linkend="ref.zlib">zlib</link> n'est pas disponible. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::setUncompressed</function></title> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $file = $p['monfichier.txt']; $file->setCompressedGZ(); var_dump($file->isCompressed()); $p['monfichier.txt']->setUncompressed(); var_dump($file->isCompressed()); } catch (Exception $e) { echo 'La création/modification de mon.phar a échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ bool(true) bool(false) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::getCompressedSize</function></member> <member><function>PharFileInfo::isCompressedBZIP2</function></member> <member><function>PharFileInfo::isCompressed</function></member> <member><function>PharFileInfo::isCompressedGZ</function></member> <member><function>PharFileInfo::setCompressedBZIP2</function></member> <member><function>PharFileInfo::setCompressedGZ</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compressAllFilesBZIP2</function></member> <member><function>Phar::compressAllFilesGZ</function></member> <member><function>Phar::getSupportedCompression</function></member> <member><function>Phar::uncompressAllFiles</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 -->