cvs: phpdoc /fr/functions zip.xml

From: Date: Tue, 10 Jul 2001 07:28:32 +0000
Subject: cvs: phpdoc /fr/functions zip.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969336052@lists.php.net to get a copy of this message
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: -->
« previous php.doc (#969336052) next »