[PHP-DOC] cvs: phpdoc /fr/functions zip.xml

[Damien Seguy]

dams            Tue Jul 10 03:28:32 2001 EDT

  Added files:                 
    /phpdoc/fr/functions        zip.xml 
  Log:
  Initial translation
  
  

Index: phpdoc/fr/functions/zip.xml
+++ phpdoc/fr/functions/zip.xml
<reference id="ref.zip">
 <title>Zip (d&eacute;compression)</title>
 <titleabbrev>Zip</titleabbrev>
 <partintro>
  <para>
   Ce module utilise les fonctions de la librairie
   <ulink url="&url.zziplib;">ZZIPlib</ulink>, cr&eacute;&eacute;e par Guido Draheim 
pour
   lire de mani&egrave;re transparente des archives compress&eacute;es Zip, et les 
fichiers
   qu'elles contiennent.
  </para>
  <para>
   Notez que ZZIPlib ne fournit qu'une partie des fonctions utilisant
   l'algorithme de compression ZIP : elle ne permet que de lire les
   fichiers Zip. Un utilitaire Zip est n&eacute;cessaire pour cr&eacute;er ces
   archives, vous ne pourrez pas le faire en PHP.
  </para>
  <para>
   Le support de Zip par PHP n'est pas activ&eacute; par d&eacute;faut. Vous devez 
utiliser l'option
   <link linkend="install.configure.with-zip">--with-zip</link>
   lorsque vous compilez PHP pour l'activer. Ce module requiert par ailleurs
   la librairie ZZIPlib version &gt;= 0.10.6.
  </para>
  <note>
   <para>
     Le support de Zip pour les versions ant&eacute;rieures &agrave; PHP 4.0.7 est 
exp&eacute;rimental.
     Cette section d&eacute;crit l'extension Zip telle qu'elle existe en PHP 4.0.7
     et plus r&eacute;cent.
   </para>
  </note>
  <sect1 id="zip-example">
   <title>Exemple d'utilisation</title>
   <para>
    Cet exemple ouvre un fichier ZIP, lit chaque fichier de l'archive, et
    affiche son contenu. Le script <filename>test2.php</filename> utilis&eacute; dans
    cet exemple est un des fichiers de test de la distribution source de
    ZZIPlib.
   </para>
   <example>
    <title>Exemple d'utilisation de l'extension Zip</title>
    <programlisting role="php">
&lt;?php
$zip = zip_open("/tmp/test2.zip");
if ($zip) {
    while ($zip_entry = zip_read($zip)) {
        echo "Name:               " . zip_entry_name($zip_entry) . "\n";
        echo "Actual Filesize:    " . zip_entry_filesize($zip_entry) . "\n";
        echo "Compressed Size:    " . zip_entry_compressedsize($zip_entry) . "\n";
        echo "Compression Method: " . zip_entry_compressionmethod($zip_entry) . "\n";
///
        if (zip_entry_open($zip, $zip_entry, "r")) {
            echo "File Contents:\n";
            $buf = zip_entry_read($zip_entry, zip_entry_filesize($zip_entry));
            echo "$buf\n";
            zip_entry_close($zip_entry);
        }
        echo "\n";
    }
    zip_close($zip);
}
?&gt;
    </programlisting>
   </example>
  </sect1>
 </partintro>
 <refentry id="function.zip-close">
  <refnamediv>
   <refname>zip_close</refname>
   <refpurpose>Ferme une archive Zip</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
   <funcsynopsis>
    <funcprototype>
     <funcdef>void <function>zip_close</function></funcdef>
     <paramdef>resource <parameter>zip</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <para>
    <function>zip_close</function> ferme l'archive zip <parameter>zip</parameter>.
    Le param&egrave;tre <parameter>zip</parameter> doit &ecirc;tre une archive zip,
    cr&eacute;&eacute;e par la fonction <function>zip_open</function>.
   </para>
   <para>
    Cette fonction ne retourne pas de valeur.
   </para>
   <para>
    Voir aussi
    <function>zip_open</function> et
    <function>zip_read</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.zip-entry-close">
  <refnamediv>
   <refname>zip_entry_close</refname>
   <refpurpose>Ferme un &eacute;l&eacute;ment d'archive</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
   <funcsynopsis>
    <funcprototype>
     <funcdef>void <function>zip_close</function></funcdef>
     <paramdef>resource <parameter>zip_entry</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <para>
    <function>zip_close</function> ferme l'&eacute;l&eacute;ment d'archive 
<parameter>zip_entry</parameter>.
    Le param&egrave;tre <parameter>zip_entry</parameter> doit &ecirc;tre un 
&eacute;l&eacute;ment d'archive valide,
    cr&eacute;&eacute; par la fonction <function>zip_entry_open</function>.
   </para>
   <para>
    Cette fonction ne retourne pas de valeur.
   </para>
   <para>
    Voir aussi
    <function>zip_entry_open</function> et
    <function>zip_entry_read</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.zip-entry-compressedsize">
  <refnamediv>
   <refname>zip_entry_compressedsize</refname>
   <refpurpose>Lit la taille compress&eacute;e d'un dossier</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
   <funcsynopsis>
    <funcprototype>
     <funcdef>int <function>zip_entry_compressedsize</function></funcdef>
     <paramdef>resource <parameter>zip_entry</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <para>
    <function>zip_entry_compressedsize</function> retourne la taille compress&eacute;e
    de l'&eacute;l&eacute;ment d'archive <parameter>zip_entry</parameter>.
    Le param&egrave;tre <parameter>zip_entry</parameter> doit &ecirc;tre un 
&eacute;l&eacute;ment d'archive valide, cr&eacute;&eacute; par
    la fonction <function>zip_entry_open</function>.
   </para>
   <para>
    Voir aussi
    <function>zip_open</function> et
    <function>zip_read</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.zip-entry-compressionmethod">
  <refnamediv>
   <refname>zip_entry_compressionmethod</refname>
   <refpurpose>Retourne la m&eacute;thode de compression d'un dossier</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
   <funcsynopsis>
    <funcprototype>
     <funcdef>string <function>zip_entry_compressionmethod</function></funcdef>
     <paramdef>resource <parameter>zip_entry</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <para>
    <function>zip_entry_compressionmethod</function> la m&eacute;thode de compression
    de l'&eacute;l&eacute;ment d'archive sp&eacute;cifi&eacute; 
<parameter>zip_entry</parameter>.
    Le param&egrave;tre <parameter>zip_entry</parameter> doit &ecirc;tre un 
&eacute;l&eacute;ment d'archive valide,
    cr&eacute;&eacute; par la fonction <function>zip_entry_open</function>.
   </para>
   <para>
    Voir aussi
    <function>zip_open</function> et
    <function>zip_read</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.zip-entry-filesize">
  <refnamediv>
   <refname>zip_entry_filesize</refname>
   <refpurpose>Retourne la taille r&eacute;elle d'un fichier dans un 
dossier</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
   <funcsynopsis>
    <funcprototype>
     <funcdef>int <function>zip_entry_filesize</function></funcdef>
     <paramdef>resource <parameter>zip_entry</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <para>
    <function>zip_entry_filesize</function> retourne la taille r&eacute;elle
    de l'&eacute;l&eacute;ment d'archive <parameter>zip_entry</parameter>.
    Le param&egrave;tre <parameter>zip_entry</parameter> doit &ecirc;tre un 
&eacute;l&eacute;ment d'archive valide,
    cr&eacute;&eacute; par la fonction <function>zip_entry_open</function>.
   </para>
   <para>
    Voir aussi
    <function>zip_open</function> et
    <function>zip_read</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.zip-entry-name">
  <refnamediv>
   <refname>zip_entry_name</refname>
   <refpurpose>Retourne le nom de l'&eacute;l&eacute;ment d'archive</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
   <funcsynopsis>
    <funcprototype>
     <funcdef>string <function>zip_entry_name</function></funcdef>
     <paramdef>resource <parameter>zip_entry</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <para>
    <function>zip_entry_name</function> retourne le nom de l'&eacute;l&eacute;ment
    d'archive sp&eacute;cifi&eacute; par <parameter>zip_entry</parameter>.
    Le param&egrave;tre <parameter>zip_entry</parameter> doit &ecirc;tre un 
&eacute;l&eacute;ment d'archive valide,
    cr&eacute;&eacute; par la fonction <function>zip_entry_open</function>.
   </para>
   <para>
    Voir aussi
    <function>zip_open</function> et
    <function>zip_read</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.zip-entry-open">
  <refnamediv>
   <refname>zip_entry_open</refname>
   <refpurpose>Ouvre un nouveau dossier dans une archive</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
   <funcsynopsis>
    <funcprototype>
     <funcdef>bool <function>zip_entry_open</function></funcdef>
     <paramdef>resource <parameter>zip</parameter></paramdef>
     <paramdef>resource <parameter>zip_entry</parameter></paramdef>
     <paramdef>string <parameter><optional>mode</optional></parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <para>
    <function>zip_entry_open</function> ouvre un dossier dans une archive
    Zip, en lecture seule. Le parma&egrave;tre <parameter>zip</parameter> est une
    ressource valide, retourn&eacute;e par <function>zip_open</function>. Le 
param&egrave;tre
    <parameter>zip_entry</parameter> est une ressource de dossier, retourn&eacute;e
    par <function>zip_read</function>. Le param&egrave;tre optinnel
    <parameter>mode</parameter> peut &ecirc;tre l'un des mode sp&eacute;cifi&eacute; 
dans la documentation
    de <function>fopen</function>.
   </para>
   <note>
    <para>
     Actuellement, <parameter>mode</parameter> est ignor&eacute; et est vaut simplement
     <literal>"rb"</literal>.  Cela est li&eacute; au fait que l'extention zip
     est en lecture seule. Reportez vous &agrave; la fonction
     <function>fopen</function> pour plus de d&eacute;tails sur le mode 
<literal>"rb"</literal>.
    </para>
   </note>
   <para>
    <function>zip_entry_open</function> retourne <literal>true</literal> en cas
    de succ&egrave;s, ou <literal>false</literal> en cas d'&eacute;chec.
   </para>
   <note>
    <para>
     Contrairement &agrave; <function>fopen</function> et d'autres fonctions du 
m&ecirc;me acabi,
     la valeur retourn&eacute;e par <function>zip_entry_open</function> indique 
uniquement
     le r&eacute;sultat de l'op&eacute;ration, et n'est pas n&eacute;cessaire pour 
lire ou fermer le
     dossier.
    </para>
   </note>
   <para>
    Voir aussi
    <function>zip_entry_read</function> et
    <function>zip_entry_close</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.zip-entry-read">
  <refnamediv>
   <refname>zip_entry_read</refname>
   <refpurpose>Lit dans un fichier d'archive</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
   <funcsynopsis>
    <funcprototype>
     <funcdef>string <function>zip_entry_read</function></funcdef>
     <paramdef>resource <parameter>zip_entry</parameter></paramdef>
     <paramdef>int <parameter><optional>length</optional></parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <para>
    <function>zip_entry_read</function> jusqu'&agrave; <parameter>length</parameter> 
octets
    dans un fichier d'archive. Si <parameter>length</parameter> n'est pas 
sp&eacute;cifi&eacute;,
    alors <function>zip_entry_read</function> essaiera de lire 1024 octets. Le
    param&egrave;tre <parameter>zip_entry</parameter> est un &eacute;l&eacute;ment 
d'archive valide,
    retourn&eacute; par <function>zip_read</function>.
   </para>
   <note>
    <para>
     Le param&egrave;tre <parameter>length</parameter> exprime une taille non
     compress&eacute;e.
    </para>
   </note>
   <para>
    <function>zip_entry_read</function> retourne les donn&eacute;es lues, ou bien
    <literal>false</literal> si la fin du fichier est atteinte.
   </para>
   <para>
    Voir aussi
    <function>zip_entry_open</function>,
    <function>zip_entry_close</function> et
    <function>zip_entry_filesize</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.zip-open">
  <refnamediv>
   <refname>zip_open</refname>
   <refpurpose>Ouvre une archive Zip</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
   <funcsynopsis>
    <funcprototype>
     <funcdef>resource <function>zip_open</function></funcdef>
     <paramdef>string <parameter>filename</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <para>
    <function>zip_open</function> ouvre une nouvelle archive en lecture.
    Le param&egrave;tre <parameter>filename</parameter> est le chemine jusqu'au fichier
    &agrave; ouvrir.
   </para>
   <para>
    <function>zip_open</function> retourne une ressource &agrave; utiliser plus tard
    avec les fonctions <function>zip_read</function> et
    <function>zip_close</function>. <function>zip_open</function> retourne
    <literal>FALSE</literal> si <parameter>filename</parameter> n'existe pas.
   </para>
   <para>
    Voir aussi
    <function>zip_read</function> et
    <function>zip_close</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.zip-read">
  <refnamediv>
   <refname>zip_read</refname>
   <refpurpose>Lit le prochain &eacute;l&eacute;ment d'archive</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
   <funcsynopsis>
    <funcprototype>
     <funcdef>resource <function>zip_read</function></funcdef>
     <paramdef>resource <parameter>zip</parameter></paramdef>
    </funcprototype>
   </funcsynopsis>
   <para>
    <function>zip_read</function> lit le prochain &eacute;l&eacute;ment d'archive
    zip, dans l'archive <parameter>zip</parameter>. Le param&egrave;tre
    <parameter>zip</parameter> doit &ecirc;tre une archive zip, ouverte
    pr&eacute;c&eacute;demment par la fonction <function>zip_open</function>.
   </para>
   <para>
    <function>zip_read</function> une ressource d'&eacute;l&eacute;ment d'archive, qui 
peut
    &ecirc;tre utilis&eacute;e ult&eacute;rieurement par les fonctions
    <function>zip_open</function>, <function>zip_close</function>,
    <function>zip_entry_open</function> et <function>zip_entry_read</function>.
   </para>
   <para>
    Voir aussi
    <function>zip_open</function>,
    <function>zip_close</function>,
    <function>zip_entry_open</function> et
    <function>zip_entry_read</function>.
   </para>
  </refsect1>
 </refentry>
</reference>
<!-- 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
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->