cvs: phpdoc-fr /reference/phar/PharFileInfo chmod.xml compress.xml construct.xml

From: Date: Thu, 12 Feb 2009 16:54:57 +0000
Subject: cvs: phpdoc-fr /reference/phar/PharFileInfo chmod.xml compress.xml construct.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-6654@lists.php.net to get a copy of this message
gui Thu Feb 12 16:54:57 2009 UTC Added files: /phpdoc-fr/reference/phar/PharFileInfo chmod.xml compress.xml construct.xml Log: initial translation

http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/PharFileInfo/chmod.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/chmod.xml +++ phpdoc-fr/reference/phar/PharFileInfo/chmod.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.chmod"> <refnamediv> <refname>PharFileInfo::chmod</refname> <refpurpose>Fixe les bits de permission spécifiques aux fichiers</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>PharFileInfo::chmod</methodname> <methodparam><type>int</type><parameter>permissions</parameter></methodparam> </methodsynopsis> <para> <function>PharFileInfo::chmod</function> permet de fixer les bits d'exécution des fichiers, ainsi que ceux de lecture seule. Ceux d'écriture sont ignorés car fixés au démarrage par la variable INI <link linkend="ini.phar.readonly">phar.readonly</link>. 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'une archive <classname>PharData</classname> n'ont pas cette restriction. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>permissions</parameter></term> <listitem> <para> les permissions (voir <function>chmod</function>) </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::chmod</function></title> <para> </para> <programlisting role="php"> <![CDATA[ <?php // on s'assure que le phar n'existe pas @unlink('nouveauphar.phar'); try { $p = new Phar('nouveauphar.phar', 0, 'nouveauphar.phar'); $p['fichier.sh'] = '#!/usr/local/lib/php <?php echo "salut"; ?>'; // met le bit d'exécution $p['fichier.sh']->chmod(0555); var_dump($p['fichier.sh']->isExecutable()); } catch (Exception $e) { echo 'Ne peut pas créer/modifier le phar: ', $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/compress.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/compress.xml +++ phpdoc-fr/reference/phar/PharFileInfo/compress.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="pharfileinfo.compress"> <refnamediv> <refname>PharFileInfo::compress</refname> <refpurpose>Compresse l'entrée Phar courante avec une des compressions zlib ou bzip2</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>PharFileInfo::compress</methodname> <methodparam><type>int</type><parameter>compression</parameter></methodparam> </methodsynopsis> <para> Cette méthode compresse le fichier au sein de l'archive Phar en utilisant l'une des compressions bzip2 ou zlib. 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é. De plus, si le fichier est déjà compressé, l'extension adéquate doit être activée pour le décompresser. 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>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::compress</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->isCompressed(Phar::BZ2)); $p['monfichier.txt']->compress(Phar::BZ2); var_dump($file->isCompressed(Phar::BZ2)); } catch (Exception $e) { echo 'Ne peut pas créer/modifier mon.phar : ', $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::isCompressed</function></member> <member><function>PharFileInfo::decompress</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/construct.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/PharFileInfo/construct.xml +++ phpdoc-fr/reference/phar/PharFileInfo/construct.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.construct"> <refnamediv> <refname>PharFileInfo::__construct</refname> <refpurpose>Construit un objet d'entrée Phar</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>PharFileInfo::__construct</methodname> <methodparam><type>string</type><parameter>entry</parameter></methodparam> </methodsynopsis> <para> Ceci ne doit pas être appelé directement. A la place, un objet PharFileInfo est initialisé en appelant <function>Phar::offsetGet</function> via un accès de type tableau. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>entry</parameter></term> <listitem> <para> L'URL complète pour récuprére un fichier.Si vous voulez récupérer les informations du fichier <literal>mon/fichier.php</literal> du phar <literal>boo.phar</literal>, vous devrez préciser <literal>phar://boo.phar/mon/fichier.php</literal>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Soulève une exception <classname>BadMethodCallException</classname> si <function>__construct</function> est appelé deux fois. Soulève une exception <classname>UnexpectedValueException</classname> si l'URL du phar demandé est mal formée, si le phar ne peut pas être ouvert ou si le fichier ne peut pas être trouvé au sein du phar. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>PharFileInfo::__construct</function></title> <para> </para> <programlisting role="php"> <![CDATA[ <?php try { $p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar'); $p['fichierdetest.txt'] = "salut\nmon\npote"; $file = $p['fichierdetest.txt']; foreach ($file as $line => $text) { echo "ligne numéro $line: $text"; } // ceci marche aussi $file = new PharFileInfo('phar:///chemin/vers/mon.phar/fichierdetest.txt'); foreach ($file as $line => $text) { echo "ligne numéro $line: $text"; } } catch (Exception $e) { echo 'L'opération Phar a échoué : ', $e; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ ligne numéro 1: salut ligne numéro 2: mon ligne numéro 3: pote ligne numéro 1: salut ligne numéro 2: mon ligne numéro 3: pote ]]> </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 -->
« previous php.doc.fr (#6654) next »