cvs: phpdoc-fr /reference/phar/PharFileInfo decompress.xml delMetadata.xml getCRC32.xml getCompressedSize.xml getMetadata.xml getPharFlags.xml
| From: | Guillaume Plessis | Date: | Fri, 13 Feb 2009 10:05:12 +0000 |
| Subject: | cvs: phpdoc-fr /reference/phar/PharFileInfo decompress.xml delMetadata.xml getCRC32.xml getCompressedSize.xml getMetadata.xml getPharFlags.xml | ||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-6670@lists.php.net to get a copy of this message | ||
gui Fri Feb 13 10:05:12 2009 UTC
Added files:
/phpdoc-fr/reference/phar/PharFileInfo decompress.xml
delMetadata.xml getCRC32.xml
getCompressedSize.xml
getMetadata.xml
getPharFlags.xml
Log:
initial translation
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/PharFileInfo/decompress.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/decompress.xml +++ phpdoc-fr/reference/phar/PharFileInfo/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="pharfileinfo.decompress"> <refnamediv> <refname>PharFileInfo::decompress</refname> <refpurpose>Decompresse l'entrée Phar courante au sein du phar</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::decompress</methodname> <void/> </methodsynopsis> <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 d'un phar, la variable INI <link linkend="ini.phar.readonly">phar.readonly</link> doit être à off pour réussir si le fichier est dans une archive <classname>Phar</classname>. Les fichiers au sein d'archives <classname>PharData</classname> n'ont pas cette restriction. </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::decompress</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->compress(Phar::GZ); var_dump($file->isCompressed()); $p['monfichier.txt']->decompress(); var_dump($file->isCompressed()); } catch (Exception $e) { echo 'Ne peut pas créer/modifier mon.phar: ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ int(4096) 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>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compressFiles</function></member> <member><function>Phar::decompressFiles</function></member> <member><function>Phar::compress</function></member> <member><function>Phar::decompress</function></member> <member><function>Phar::getSupportedCompression</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/PharFileInfo/delMetadata.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/delMetadata.xml +++ phpdoc-fr/reference/phar/PharFileInfo/delMetadata.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xml:id="pharfileinfo.delmetadata" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharFileInfo::delMetadata</refname> <refpurpose>Efface les méta-données de l'entrée</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::delMetadata</methodname> <void/> </methodsynopsis> <para> Efface les méta-données de l'entrée, s'il y en a. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> No parameters. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne &true; en cas de succès, &false; si l'entrée ne possédait pas de méta-données. Comme avec toutes les fonctionnalités qui modifient le contenu d'un phar, la variable INI <link linkend="ini.phar.readonly">phar.readonly</link> doit être à off pour réussir si le fichier est au sein d'une archive <classname>Phar</classname>. Les fichiers au sein d'archives <classname>PharData</classname> n'ont pas cette restriction. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> si des erreurs ont été rencontrées lors de l'écriture des changements sur le disque, et une exception <classname>BadMethodCallException</classname> si l'accès en écriture est désactivé. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::delMetaData</function></title> <programlisting role="php"> <![CDATA[ <?php try { $a = new Phar('monphar.phar'); $a['salut'] = 'salut'; var_dump($a['salut']->delMetadata()); $a['salut']->setMetadata('mon pote'); var_dump($a['salut']->delMetadata()); var_dump($a['salut']->delMetadata()); } catch (Exception $e) { // on traite les erreurs } ?> ]]> </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::setMetadata</function></member> <member><function>PharFileInfo::hasMetadata</function></member> <member><function>PharFileInfo::getMetadata</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/getCRC32.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/getCRC32.xml +++ phpdoc-fr/reference/phar/PharFileInfo/getCRC32.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.getcrc32"> <refnamediv> <refname>PharFileInfo::getCRC32</refname> <refpurpose>Retourne le code CRC32 ou soulève une exception si le CRC n'a pas été vérifié</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>PharFileInfo::getCRC32</methodname> <void/> </methodsynopsis> <para> Cette méthode retourne la somme de contrôle <function>crc32</function> du fichier au sein de l'archive Phar. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La somme de contrôle <function>crc32</function> du fichier au sein de l'archive Phar. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>BadMethodCallException</classname> si le CRC32 du fichier n'a pas encore été vérfié. Ceci n'arrive normalement pas, car le CRC est vérifié à l'ouverture du fichier en lecture ou en écriture. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::getCRC32</function></title> <para> </para> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $file = $p['monfichier.txt']; echo $file->getCRC32(); } catch (Exception $e) { echo 'L'écriture de mon.phar.phar a échouée : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ 3633523372 ]]> </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/getCompressedSize.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/getCompressedSize.xml +++ phpdoc-fr/reference/phar/PharFileInfo/getCompressedSize.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.getcompressedsize"> <refnamediv> <refname>PharFileInfo::getCompressedSize</refname> <refpurpose>Retourne la taille actuelle (avec compression) du fichier au sein de l'archive Phar</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>PharFileInfo::getCompressedSize</methodname> <void/> </methodsynopsis> <para> Cette méthode retourne la taille du fichier au sein de l'archive Phar. Les fichiers non compressés retourneront la même valeur avec getCompressedSize qu'avec <function>filesize</function> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La taille en octets du fichier au sein de l'archive Phar sur le disque. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::getCompressedSize</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']; echo $file->getCompressedSize(); } catch (Exception $e) { echo 'L'écriture de mon.phar a échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ 2 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::isCompressed</function></member> <member><function>PharFileInfo::decompress</function></member> <member><function>PharFileInfo::compress</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compress</function></member> <member><function>Phar::decompress</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/getMetadata.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/getMetadata.xml +++ phpdoc-fr/reference/phar/PharFileInfo/getMetadata.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.getmetadata"> <refnamediv> <refname>PharFileInfo::getMetaData</refname> <refpurpose>Retourne les méta-données spécifiques attachées à un fichier</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>mixed</type><methodname>PharFileInfo::getMetaData</methodname> <void/> </methodsynopsis> <para> Retourne les méta-données qui ont été sauvegardées dans le manifeste de l'archive Phar pour ce fichier. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> n'importe quelle variable PHP qui peut être sérialisée et qui est stockée comme méta-données pour le fichier, ou &null; si aucune méta-donnée n'est stockée. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::getMetaData</function></title> <para> </para> <programlisting role="php"> <![CDATA[ <?php // on s'assure que le phar n'est 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 nouveauphar.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::setMetadata</function></member> <member><function>PharFileInfo::hasMetadata</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/getPharFlags.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/getPharFlags.xml +++ phpdoc-fr/reference/phar/PharFileInfo/getPharFlags.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.getpharflags"> <refnamediv> <refname>PharFileInfo::getPharFlags</refname> <refpurpose>Retourne les drapeaux du fichier Phar</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>PharFileInfo::getPharFlags</methodname> <void/> </methodsynopsis> <para> Cette méthode retourne les drapeaux fixés dans le manifeste pour un Phar. Elle retournera toujours <literal>0</literal> dans son implémentation actuelle. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Les drapeaux Phar (toujours <literal>0</literal> dans son implémentation actuelle) </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec<function>PharFileInfo::getPharFlags</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->getPharFlags()); } catch (Exception $e) { echo 'Ne peut pas créer/modifier mon.phar: ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ int(0) ]]> </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/decompress.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/decompress.xml +++ phpdoc-fr/reference/phar/PharFileInfo/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="pharfileinfo.decompress"> <refnamediv> <refname>PharFileInfo::decompress</refname> <refpurpose>Decompresse l'entrée Phar courante au sein du phar</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::decompress</methodname> <void/> </methodsynopsis> <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 d'un phar, la variable INI <link linkend="ini.phar.readonly">phar.readonly</link> doit être à off pour réussir si le fichier est dans une archive <classname>Phar</classname>. Les fichiers au sein d'archives <classname>PharData</classname> n'ont pas cette restriction. </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::decompress</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->compress(Phar::GZ); var_dump($file->isCompressed()); $p['monfichier.txt']->decompress(); var_dump($file->isCompressed()); } catch (Exception $e) { echo 'Ne peut pas créer/modifier mon.phar: ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ int(4096) 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>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compressFiles</function></member> <member><function>Phar::decompressFiles</function></member> <member><function>Phar::compress</function></member> <member><function>Phar::decompress</function></member> <member><function>Phar::getSupportedCompression</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/PharFileInfo/delMetadata.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/delMetadata.xml +++ phpdoc-fr/reference/phar/PharFileInfo/delMetadata.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xml:id="pharfileinfo.delmetadata" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>PharFileInfo::delMetadata</refname> <refpurpose>Efface les méta-données de l'entrée</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::delMetadata</methodname> <void/> </methodsynopsis> <para> Efface les méta-données de l'entrée, s'il y en a. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> No parameters. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne &true; en cas de succès, &false; si l'entrée ne possédait pas de méta-données. Comme avec toutes les fonctionnalités qui modifient le contenu d'un phar, la variable INI <link linkend="ini.phar.readonly">phar.readonly</link> doit être à off pour réussir si le fichier est au sein d'une archive <classname>Phar</classname>. Les fichiers au sein d'archives <classname>PharData</classname> n'ont pas cette restriction. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>PharException</classname> si des erreurs ont été rencontrées lors de l'écriture des changements sur le disque, et une exception <classname>BadMethodCallException</classname> si l'accès en écriture est désactivé. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::delMetaData</function></title> <programlisting role="php"> <![CDATA[ <?php try { $a = new Phar('monphar.phar'); $a['salut'] = 'salut'; var_dump($a['salut']->delMetadata()); $a['salut']->setMetadata('mon pote'); var_dump($a['salut']->delMetadata()); var_dump($a['salut']->delMetadata()); } catch (Exception $e) { // on traite les erreurs } ?> ]]> </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::setMetadata</function></member> <member><function>PharFileInfo::hasMetadata</function></member> <member><function>PharFileInfo::getMetadata</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/getCRC32.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/getCRC32.xml +++ phpdoc-fr/reference/phar/PharFileInfo/getCRC32.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.getcrc32"> <refnamediv> <refname>PharFileInfo::getCRC32</refname> <refpurpose>Retourne le code CRC32 ou soulève une exception si le CRC n'a pas été vérifié</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>PharFileInfo::getCRC32</methodname> <void/> </methodsynopsis> <para> Cette méthode retourne la somme de contrôle <function>crc32</function> du fichier au sein de l'archive Phar. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La somme de contrôle <function>crc32</function> du fichier au sein de l'archive Phar. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>BadMethodCallException</classname> si le CRC32 du fichier n'a pas encore été vérfié. Ceci n'arrive normalement pas, car le CRC est vérifié à l'ouverture du fichier en lecture ou en écriture. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::getCRC32</function></title> <para> </para> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['monfichier.txt'] = 'salut'; $file = $p['monfichier.txt']; echo $file->getCRC32(); } catch (Exception $e) { echo 'L'écriture de mon.phar.phar a échouée : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ 3633523372 ]]> </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/getCompressedSize.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/getCompressedSize.xml +++ phpdoc-fr/reference/phar/PharFileInfo/getCompressedSize.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.getcompressedsize"> <refnamediv> <refname>PharFileInfo::getCompressedSize</refname> <refpurpose>Retourne la taille actuelle (avec compression) du fichier au sein de l'archive Phar</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>PharFileInfo::getCompressedSize</methodname> <void/> </methodsynopsis> <para> Cette méthode retourne la taille du fichier au sein de l'archive Phar. Les fichiers non compressés retourneront la même valeur avec getCompressedSize qu'avec <function>filesize</function> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La taille en octets du fichier au sein de l'archive Phar sur le disque. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::getCompressedSize</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']; echo $file->getCompressedSize(); } catch (Exception $e) { echo 'L'écriture de mon.phar a échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ 2 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharFileInfo::isCompressed</function></member> <member><function>PharFileInfo::decompress</function></member> <member><function>PharFileInfo::compress</function></member> <member><function>Phar::canCompress</function></member> <member><function>Phar::isCompressed</function></member> <member><function>Phar::compress</function></member> <member><function>Phar::decompress</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/getMetadata.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/getMetadata.xml +++ phpdoc-fr/reference/phar/PharFileInfo/getMetadata.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.getmetadata"> <refnamediv> <refname>PharFileInfo::getMetaData</refname> <refpurpose>Retourne les méta-données spécifiques attachées à un fichier</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>mixed</type><methodname>PharFileInfo::getMetaData</methodname> <void/> </methodsynopsis> <para> Retourne les méta-données qui ont été sauvegardées dans le manifeste de l'archive Phar pour ce fichier. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> n'importe quelle variable PHP qui peut être sérialisée et qui est stockée comme méta-données pour le fichier, ou &null; si aucune méta-donnée n'est stockée. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::getMetaData</function></title> <para> </para> <programlisting role="php"> <![CDATA[ <?php // on s'assure que le phar n'est 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 nouveauphar.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::setMetadata</function></member> <member><function>PharFileInfo::hasMetadata</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/getPharFlags.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/getPharFlags.xml +++ phpdoc-fr/reference/phar/PharFileInfo/getPharFlags.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.getpharflags"> <refnamediv> <refname>PharFileInfo::getPharFlags</refname> <refpurpose>Retourne les drapeaux du fichier Phar</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>PharFileInfo::getPharFlags</methodname> <void/> </methodsynopsis> <para> Cette méthode retourne les drapeaux fixés dans le manifeste pour un Phar. Elle retournera toujours <literal>0</literal> dans son implémentation actuelle. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Les drapeaux Phar (toujours <literal>0</literal> dans son implémentation actuelle) </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec<function>PharFileInfo::getPharFlags</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->getPharFlags()); } catch (Exception $e) { echo 'Ne peut pas créer/modifier mon.phar: ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ int(0) ]]> </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 -->