<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.17 Maintainer: stefan_saasen Status: ready -->
<reference id="ref.zip">
 <title>ZIP Funktionen (Lesezugriff)</title>
 <titleabbrev>Zip</titleabbrev>
  
  <partintro>
   <para>
    Dieses Modul benutzt die Funktionen der <ulink
    url="&url.zziplib;">ZZIPlib</ulink> Bibliothek von Guido Draheim
    um ZIP komprimierte Archive und die darin enthaltenen Dateien zu
    lesen.
   </para>
   <para>
    Zu beachten ist, dass ZZIPlib nur eine Untermenge der Funktionen
    zur Verfgung stellt, die in einer vollstndigen Implementation
    des ZIP Algorithmus vorhanden sind.  Zur Erstellung eines ZIP
    Archivs muss man sich eines der blichen ZIP Programme bedienen.
   </para>
   <para>
   Die ZIP Untersttzung ist standardmig nicht aktiviert.  Um die
   ZIP Funktionen nutzen zu knnen, muss PHP mit der option <link
   linkend="install.configure.with-zip">--with-zip</link> kompiliert
   werden.  Das ZIP Modul bentigt ZZIPlib version &gt;= 0.10.6.
   </para>
   <note>
    <para>
     Zip Untersttzung fr PHP vor Version 4.1.0 ist als experimentell
     anzusehen.  Dieser Abschnitt beschreibt die ZIP Untersttzung,
     wie sie fr PHP ab Version 4.1.0 existiert.
    </para>
   </note>

   <sect1 id="zip-example">
    <title>Beispiel zur Verwendung</title>
    <para>
     Dieses Beispiel ffnet ein ein ZIP Archiv, liest jede Datei
     innerhalb des Archivs und gibt den Inhalt zurck. Das
     <filename>test2.zip</filename> Archiv, das in diesem Beispiel
     benutzt wird, wird mit der Original Distribution der ZZIPlib
     Bibliothek mitgeliefert.
    </para>
    <example>
     <title>Beispiel zur Verwendung der Zip Funktion</title>
     <programlisting role="php">
<![CDATA[      
<?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);

}

?>
]]>
     </programlisting>
    </example>
   </sect1>
  </partintro>

  <refentry id="function.zip-open">
   <refnamediv>
    <refname>zip_open</refname>
    <refpurpose>ffnet ein ZIP Archiv</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>resource</type><methodname>zip_open</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion ffnet ein ZIP Archiv fr den Lesezugriff.  Der
     Parameter <parameter>filename</parameter> ist der Name der zu
     ffnenden ZIP Datei.
    </para>
    <para>
     Gibt einen Dateizeiger zurck, der in den Funktionen
     <function>zip_read</function> und <function>zip_close</function>
     benutzt wird.  Existiert die Datei
     <parameter>filename</parameter> nicht wird &false; zurckgegeben.
    </para>
    <para>
     Siehe auch <function>zip_read</function> und
     <function>zip_close</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.zip-read">
   <refnamediv>
    <refname>zip_read</refname>
    <refpurpose>
     Liest den nchsten Eintrag innerhalb des ZIP Archivs
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>resource</type><methodname>zip_read</methodname>
      <methodparam><type>resource</type><parameter>zip</parameter></methodparam>
     </methodsynopsis>
    <para>
     Liest den nchsten Eintrag innerhalb des ZIP Archivs.  Der
     Parameter <parameter>zip</parameter> muss ein Dateizeiger sein,
     der vorher durch <function>zip_open</function> zurckgegeben
     wurde.
    </para>
    <para>
     Gibt einen Verzeichniseintrag zur spteren Benutzung mit den
     <function>zip_entry_...</function> Funktionen zurck.
    </para>
    <para>
     Siehe auch <function>zip_open</function>,
     <function>zip_close</function>,
     <function>zip_entry_open</function> und
     <function>zip_entry_read</function>.
    </para>
   </refsect1>
  </refentry>
 
  <refentry id="function.zip-close">
   <refnamediv>
    <refname>zip_close</refname>
    <refpurpose>Schliet ein ZIP Archiv</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>void</type><methodname>zip_close</methodname>
     <methodparam><type>resource</type><parameter>zip</parameter></methodparam>
     </methodsynopsis>
    <para>
     Schliet ein ZIP Archiv.  Der Parameter
     <parameter>zip</parameter> muss ein Dateizeiger sein, der vorher
     durch <function>zip_open</function> zurckgegeben wurde.
    </para>
    <para>
     Diese Funktion hat keinen Rckgabewert.
    </para>
    <para>
     Siehe auch <function>zip_open</function> und
     <function>zip_read</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.zip-entry-close">
   <refnamediv>
    <refname>zip_entry_close</refname>
    <refpurpose>Schliet einen Verzeichniseintrag</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>void</type><methodname>zip_entry_close</methodname>
      <methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
     </methodsynopsis>
    <para>
     Schliet einen Verzeichniseintrag, der durch den Parameter
     <parameter>zip_entry</parameter> identifiziert wird. Dieser
     Parameter muss ein gltiger Verzeichniseintrag sein, der vorher
     durch <function>zip_entry_open</function> geffnet wurde.
    </para>
    <para>
     Diese Funktion hat keinen Rckgabewert.
    </para>
    <para>
     Siehe auch <function>zip_entry_open</function> und
     <function>zip_entry_read</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.zip-entry-compressedsize">
   <refnamediv>
    <refname>zip_entry_compressedsize</refname>
    <refpurpose>
     Gibt die komprimierte Gre eines Verzeichniseintrages zurck
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>zip_entry_compressedsize</methodname>
      <methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt die komprimierte Gre des Verzeichniseintrages zurck, der
     durch <parameter>zip_entry</parameter> spezifiziert wird.  Der
     Parameter <parameter>zip_entry</parameter> muss ein gltiger
     Verzeichniseintrag sein, der durch <function>zip_read</function>
     zurckgegeben wurde.
    </para>
    <para>
     Siehe auch <function>zip_open</function> und
     <function>zip_read</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.zip-entry-compressionmethod">
   <refnamediv>
    <refname>zip_entry_compressionmethod</refname>
    <refpurpose>
     Gibt die Komprimierungsmethode eines Verzeichniseintrages zurck.
    </refpurpose>
   </refnamediv>

   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>zip_entry_compressionmethod</methodname>
      <methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt die Komprimierungsmethode eines Verzeichniseintrages zurck,
     der durch <parameter>zip_entry</parameter> spezifiziert wird.
     Der Parameter <parameter>zip_entry</parameter> muss ein gltiger
     Verzeichniseintrag sein, der durch <function>zip_read</function>
     zurckgegeben wurde.
    </para>
    <para>
     Siehe auch <function>zip_open</function> und
     <function>zip_read</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.zip-entry-filesize">
   <refnamediv>
    <refname>zip_entry_filesize</refname>
    <refpurpose>
     Gibt die Gre eines Verzeichniseintrages zurck
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>zip_entry_filesize</methodname>
      <methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
     </methodsynopsis>
    <para>
    Gibt die Gre eines Verzeichniseintrages zurck, der durch
    <parameter>zip_entry</parameter> spezifiziert wird.  Der Parameter
    <parameter>zip_entry</parameter> muss ein gltiger
    Verzeichniseintrag sein, der durch <function>zip_read</function>
    zurckgegeben wurde.
    </para>
    <para>
     Siehe auch <function>zip_open</function> und
     <function>zip_read</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.zip-entry-name">
   <refnamediv>
    <refname>zip_entry_name</refname>                 
    <refpurpose>
     Gibt den Namen eines Verzeichniseintrages zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>zip_entry_name</methodname>
      <methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt den Namen eines Verzeichniseintrages zurck, der durch den
     Parameter <parameter>zip_entry</parameter> spezifiziert wurde.
     Der Parameter <parameter>zip_entry</parameter> muss ein gltiger
     Verzeichniseintrag sein, der durch <function>zip_read</function>
     zurckgegeben wurde.
    </para>
    <para>
     Siehe auch <function>zip_open</function> und
     <function>zip_read</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.zip-entry-open">
   <refnamediv>
    <refname>zip_entry_open</refname>
    <refpurpose>
     ffnet einen Verzeichniseintrag fr den Lesezugriff
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>bool</type><methodname>zip_entry_open</methodname>      
      <methodparam><type>resource</type><parameter>zip</parameter></methodparam>
      <methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <para>
     ffnet einen Verzeichniseintrag fr den Lesezugriff. Der
     Parameter <parameter>zip</parameter> muss ein Dateizeiger sein,
     der vorher durch <function>zip_open</function> zurckgegeben
     wurde.  Der Parameter <parameter>zip_entry</parameter> ist ein
     Verzeichniseintrag, der durch <function>zip_read</function>
     zurckgegeben wurde. Der optionale Parameter
     <parameter>mode</parameter> kann einer der in der Dokumentation
     zu <function>fopen</function> beschriebenen Werte sein.
    </para>
    <note>
     <para>
      Gegenwrtig wird der Parameter <parameter>mode</parameter>
      ignoriert und implizit auf <literal>"rb"</literal> gesetzt. Dies
      erfolgt aufgrund des ausschlielichen Lesezugriffs der aktuellen
      ZIP Unterstzung fr PHP. In der Dokumentation zu
      <function>fopen</function> finden sich weitere Erklrungen zu
      diesem Parameter.
     </para>
    </note>
    <para>
     Gibt bei Erfolg &true; zurck, andernfalls &false;.
    </para>
    <note>
     <para>
      Im Gegensatz zu <function>fopen</function> und vergleichbaren
      Funktionen zeigt der Rckgabewert von
      <function>zip_entry_open</function> nur das Gelingen an und wird
      nicht fr weitere Operationen bentigt.
     </para>
    </note>
    <para>
     Siehe auch <function>zip_entry_read</function> und
     <function>zip_entry_close</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.zip-entry-read">
   <refnamediv>
    <refname>zip_entry_read</refname>
    <refpurpose>Liest einen geffneten Verzeichniseintrag aus</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Beschreibung</title>
    <methodsynopsis>
     <type>string</type><methodname>zip_entry_read</methodname>
      <methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
     </methodsynopsis>
    <para>
     Liest bis zu <parameter>length</parameter> Bytes von einem
     geffneten Verzeichniseintrag aus.  Wenn der Parameter
     <parameter>length</parameter> nicht angegeben wurde, wird
     versucht die ersten 1024 Bytes auszulesen.  Der Parameter
     <parameter>zip_entry</parameter> muss ein gltiger
     Verzeichniseintrag sein, der durch <function>zip_read</function>
     zurckgegeben wurde.
    </para>
    <note>
     <para>
      Der Parameter <parameter>length</parameter> bezieht sich auf die
      unkomprimierte Gre.
     </para>
    </note>
    <para>
     Gibt die ausgelesenen Daten zurck oder &false;, wenn das Ende
     der Datei erreicht wurde.
    </para>
    <para>
     Siehe auch <function>zip_entry_open</function>,
     <function>zip_entry_close</function> und
     <function>zip_entry_filesize</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
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
-->