Files
doc-fr/reference/zlib/reference.xml
Yannick Torres 6aa59cf475 librairie => bibliothèque
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@163596 c90b9560-bf6c-de11-be94-00142212c4b1
2004-07-18 22:37:41 +00:00

135 lines
3.5 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.11 $ -->
<!-- EN-Revision: 1.14 Maintainer: didou Status: ready -->
<!-- Reviewed: no -->
<reference id="ref.zlib">
<title>Compression Zlib</title>
<titleabbrev>Zlib</titleabbrev>
<partintro>
<section id="zlib.intro">
&reftitle.intro;
<para>
Ce module vous permet de lire et ecrire de manière transparente
des fichiers compressés gzip (.gz), avec la plupart des fonctions
<link linkend="ref.filesystem">fichier</link> qui fonctionnent
avec les fichiers compressés en gzip (et les fichiers décompressés
aussi, mais pas avec les sockets).
</para>
<note>
<para>
La version 4.0.4 a introduit la version étendue de <function>fopen</function>
pour les fichiers compressés avec GZ. Vous pouvez utiliser le préfixe spécial
<literal>zlib:</literal> dans les URL pour accéder directement
et de manière transparente aux fichiers compressés par GZ, avec toutes
les fonctions f*() habituelles.
</para>
<para>
En version 4.3.0, ce préfixe spécial est remplacé par
<literal>zlib://</literal> pour éviter les ambiguités
avec les noms de fichiers contenant des <literal>:</literal>.
</para>
<para>
Cette fonctionnalité requière une librarie C qui fournit la fonction
<literal>fopencookie()</literal>. A ma connaissance, la bibliothèque
GNU libc est la seule à fournir cette fonctionnalité.
</para>
</note>
</section>
<section id="zlib.requirements">
&reftitle.required;
<para>
Ce module utilise les fonctions de la bibliothèque <ulink url="&url.zlib;">zlib</ulink>
de Jean-loup Gailly et Mark Adler. Vous devez utiliser zlib
version &gt;= 1.0.9 avec ce module.
</para>
</section>
&reference.zlib.configure;
&reference.zlib.ini;
<section id="zlib.resources">
&reftitle.resources;
&no.resource;
</section>
&reference.zlib.constants;
<section id="zlib.examples">
&reftitle.examples;
<para>
Cet exemple ouvre un fichier temporaire, écrit une page de test dedans,
puis affiche le contenu du fichier deux fois.
</para>
<example>
<title>Exemple de l'extension Zlib</title>
<programlisting role="php">
<![CDATA[
<?php
$filename = tempnam('/tmp', 'zlibtest') . '.gz';
echo "<html>\n<head></head>\n<body>\n<pre>\n";
$s = "C'est juste un test, test, test, test, test, test, test, test!\n";
// ouvre le fichier en écriture avec la compression maximale
$zp = gzopen($filename, "w9");
// écrit uen chaîne dans le fichier
gzwrite($zp, $s);
// ferme le fichier
gzclose($zp);
// ouvre le fichier en lecture
$zp = gzopen($filename, "r");
// lit 3 caractères
echo gzread($zp, 3);
// affiche le reste du fichier, puis le ferme
gzpassthru($zp);
gzclose($zp);
echo "\n";
// ouvre le fichier et affiche le fichier une seconde fois
if (readgzfile($filename) != strlen($s)) {
echo "Erreur avec les fonctions zlib!";
}
unlink($filename);
echo "</pre>\n</body>\n</html>\n";
?>
]]>
</programlisting>
</example>
</section>
</partintro>
&reference.zlib.functions;
</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
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
-->