goba Wed Nov 14 05:22:19 2001 EDT
Added files:
/phpdoc/hu/functions zip.xml
Modified files:
/phpdoc/hu Translators
Log:
Adding zip.xml translated by Andras Csontos
Index: phpdoc/hu/Translators
diff -u phpdoc/hu/Translators:1.59 phpdoc/hu/Translators:1.60
--- phpdoc/hu/Translators:1.59 Thu Oct 25 13:36:28 2001
+++ phpdoc/hu/Translators Wed Nov 14 05:22:19 2001
@@ -178,7 +178,7 @@
xml.xml
xslt.xml
yaz.xml
-zip.xml Csontos András [undrcon]
+zip.xml Csontos András 1.13
zlib.xml
-------- language -----------------------------------------------------------
basic-syntax.xml Kontra Gergely 1.14
Index: phpdoc/hu/functions/zip.xml
+++ phpdoc/hu/functions/zip.xml
<?xml encoding="iso-8859-2"?>
<!-- EN-Revision: 1.13 Maintainer: acsontos Status: ready -->
<reference id="ref.zip">
<title>Zip Fájl függvények (csak olvasáshoz)</title>
<titleabbrev>Zip</titleabbrev>
<partintro>
<para>
Ez a modul a <ulink
url="&url.zziplib;">ZZIPlib</ulink> könyvtár függvényeit használja,
a zip eljárással tömörített állományok és a bennük levő fájlok
olvasásához. A ZZIPlib-et Guido Draheimnek köszönhetjük.
</para>
<para>
Vedd figyelembe, hogy a ZZIPlib csak a teljes zip imlementációnak megfelelő
tömörített zip fájlokat kezeli. A zip programkészletre is
szükség van ahhoz, hogy zip fájlokat olvasson a modul.
</para>
<para>
A zip támogatás nincs beépítve a PHP-ben, a
<link
linkend="install.configure.with-zip">--with-zip</link>
opcióval kell fordítanod, hogy használhasd.
Szükség van még a ZZIPlib 0.10.6 vagy későbbi kiadására is.
</para>
<note>
<para>
A zip támogatás a PHP 4.1.0-nál régebbi verziókban csak
kísérleti jellegű, tehát ezekben nem működik megbízhatóan.
Ez a dokumentum a 4.1.0 és az újabb PHP verziók zip modulját mutatja be.
</para>
</note>
<sect1 id="zip-example">
<title>Példa</title>
<para>
Az alábbi példa megnyit egy zip állományt, beolvassa a benne
található fájlokat és kinyomtatja tartalmukat. A példában felhasznált
<filename>test2.zip</filename> állomány a ZZIPlib csomag egyik
"beépített" próba állománya.
</para>
<example>
<title>Példaprogram</title>
<programlisting role="php">
<?php
$zip = zip_open("/tmp/test2.zip");
if ($zip) {
while ($zip_entry = zip_read($zip)) {
echo "Név: " . zip_entry_name($zip_entry) . "\n";
echo "Tömörítetlen méret: " . zip_entry_filesize($zip_entry) . "\n";
echo "Tömörített méret: " . zip_entry_compressedsize($zip_entry) . "\n";
echo "Tömörítési metódus: " . zip_entry_compressionmethod($zip_entry) . "\n";
if (zip_entry_open($zip, $zip_entry, "r")) {
echo "A fájl tartalma:\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>
<para>
A program először megnyitja a megadott útvonalon található
<filename>test2.zip</filename> fájlt. A ciklust addig végzi,
amíg a a <function>zip_read</function> egy érvényes
<literal>$zip_entry</literal> (vagyis a zip állományban
létező fájl vagy könyvtár) értékkel tér vissza.
A <function>zip_read<function> tulajdonképpen egy tömb eléréseként
képzelhető, amely tömbbe a <funtion>zip_open</funtion> betölti
a megnyitott zip állományban lévő fájlok neveit. Minden egyes
ciklusnál a program automatikusan előre lépteti a tömböt eggyel.
</para>
</partintro>
<refentry id="function.zip-close">
<refnamediv>
<refname>zip_close</refname>
<refpurpose>Lezár egy megnyitott ZIP állományt</refpurpose>
</refnamediv>
<refsect1>
<title>Leírás</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>zip_close</function></funcdef>
<paramdef>resource <parameter>zip</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Lezár egy megnyitott ZIP állományt. Ez csak akkor működik, ha a
<parameter>zip</parameter> forrásfájlt előzőleg a
<function>zip_open</function> függvénnyel nyitottuk meg.
</para>
<para>
Ennek a függvénynek nincs visszatérési értéke.
</para>
<para>
Lásd még: <function>zip_open</function> és
<function>zip_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-close">
<refnamediv>
<refname>zip_entry_close</refname>
<refpurpose>Lezár egy ZIP állományban található objektumot</refpurpose>
</refnamediv>
<refsect1>
<title>Leírás</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>zip_entry_close</function></funcdef>
<paramdef>resource <parameter>zip_entry</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Lezárja a zip állományban lévő <parameter>zip_entry</parameter>
objektumot. A <parameter>zip_entry</parameter> paraméter egy létező
objektum a zip fájlban, amit a <function>zip_entry_open</function>
függvénnyel nyitottunk meg.
</para>
<para>
Ennek a függvénynek nincs visszatérési értéke.
</para>
<para>
Lásd még: <function>zip_entry_open</function> és
<function>zip_entry_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-compressedsize">
<refnamediv>
<refname>zip_entry_compressedsize</refname>
<refpurpose>Egy zip-ben lévő objektum tömörített méretét adja vissza</refpurpose>
</refnamediv>
<refsect1>
<title>Leírás</title>
<funcsynopsis>
<funcprototype>
<funcdef>int
<function>zip_entry_compressedsize</function></funcdef>
<paramdef>resource <parameter>zip_entry</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Az adott <parameter>zip_entry</parameter> objektum tömörített
méretével tér vissza. A <parameter>zip_entry</parameter> egy
létező zip állománybeli objektumra mutat, amihez a
<function>zip_read</function> függvény segítségével jutunk.
</para>
<para>
Lásd még: <function>zip_open</function> és
<function>zip_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-compressionmethod">
<refnamediv>
<refname>zip_entry_compressionmethod</refname>
<refpurpose>
A megadott zip objektum tömörítési típusával tér vissza
</refpurpose>
</refnamediv>
<refsect1>
<title>Leírás</title>
<funcsynopsis>
<funcprototype>
<funcdef>string
<function>zip_entry_compressionmethod</function>
</funcdef>
<paramdef>resource <parameter>zip_entry</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
A megadott <parameter>zip_entry</parameter> objektum tömörítési
metódusának típusával tér vissza. A paraméter egy létező zip
állománybeli objektumra mutat, amihez a
<function>zip_read</function> függvény segítségével
jutottunk.
</para>
<para>
Lásd még: <function>zip_open</function> és
<function>zip_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-filesize">
<refnamediv>
<refname>zip_entry_filesize</refname>
<refpurpose>
Az adott zip objektum tömörítetlen fájlméretét adja vissza
</refpurpose>
</refnamediv>
<refsect1>
<title>Leírás</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>zip_entry_filesize</function></funcdef>
<paramdef>resource <parameter>zip_entry</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Visszatér az adott <parameter>zip_entry</parameter> objektum
tömörítetlen fájlméretének értékével. Ez a
<parameter>zip_entry</parameter> paraméter egy létező zip
objektum ami a <function>zip_read</function> függvény
visszatérési értéke.
</para>
<para>
Lásd még: <function>zip_open</function> és
<function>zip_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-name">
<refnamediv>
<refname>zip_entry_name</refname>
<refpurpose>A zip objektum nevével tér vissza</refpurpose>
</refnamediv>
<refsect1>
<title>Leírás</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>zip_entry_name</function></funcdef>
<paramdef>resource <parameter>zip_entry</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
A <parameter>zip_entry</parameter> paraméterrel megadott zip
objektum nevével tér vissza. A <parameter>zip_entry</parameter>
paraméter egy létező zip objektum, amit a
<function>zip_read</function> függvénnyel olvashatunk ki a
zip állományból.
</para>
<para>
Lásd még: <function>zip_open</function> és
<function>zip_read</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-open">
<refnamediv>
<refname>zip_entry_open</refname>
<refpurpose>Olvasásra megnyit egy zip objektumot</refpurpose>
</refnamediv>
<refsect1>
<title>Leírás</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>
Olvasásra megnyit egy létező zip objektumot egy zip állományból.
A <parameter>zip</parameter> paraméter egy létező zip fájl,
amit a <function>zip_open</function> függvénnyel nyitottunk meg.
Az olvasni kívánt objektumot a <parameter>zip_entry</parameter> definiálja,
ami a <function>zip_read</function> függvény visszatérési értéke.
A <parameter>mode</parameter> nem kötelező paraméter, lásd az
<function>fopen</function> dokumentációját a lehetséges értékekért.
</para>
<note>
<para>
Jelenleg a <parameter>mode</parameter> paramétert nem veszi
figyelembe a PHP, csak az <literal>"rb"</literal> alapértelmezett
értékkel dolgozik. Emiatt a PHP-ben csak olvasási hozzáférést
kapunk a zip állományokhoz. Az <function>fopen</function>
dokumentációja részletesen magyarázza a különböző fájl kapcsolókat,
köztük az <literal>"rb"</literal>-t is.
</para>
</note>
<para>
Ez a függvény siker esetén logikai IGAZ (&true;), kudarcnál logikai
HAMIS (&false;) értékeket vesz fel.
</para>
<note>
<para>
Ellentétben az <function>fopen</function> és más hasonló
függvényekkel, a <function>zip_entry_open</function> függvény
visszatérési értéke csak a művelet eredményességét mutatja
és nincs szükség a vizsgált zip objektum olvasására vagy
lezárására.
</para>
</note>
<para>
Lásd még: <function>zip_entry_read</function> és
<function>zip_entry_close</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-entry-read">
<refnamediv>
<refname>zip_entry_read</refname>
<refpurpose>Olvas egy megnyitott zip objektumból</refpurpose>
</refnamediv>
<refsect1>
<title>Leírás</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>
A <parameter>length</parameter> paraméterben megadott bájt
hosszúságú részt olvas be egy megnyitott zip objektumból. Ha
a <parameter>length</parameter> paraméter nincs megadva,
az alapértelmezés 1024 bájt. A <parameter>zip_entry</parameter>
paraméter egy létező zip objektum, ami a
<function>zip_read</function> függvény visszatérési értéke.
</para>
<note>
<para>
A <parameter>length</parameter> paramétert tömörítetlen
méretben kell érteni!
</para>
</note>
<para>
Az olvasott adattal vagy (pl. hibás adatok esetén) logikai HAMIS
(&false;) értékkel tér vissza, ha elérte a fájl végét.
</para>
<para>
Lásd még: <function>zip_entry_open</function>,
<function>zip_entry_close</function> és
<function>zip_entry_filesize</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-open">
<refnamediv>
<refname>zip_open</refname>
<refpurpose>Megnyit egy zip állományt</refpurpose>
</refnamediv>
<refsect1>
<title>Leírás</title>
<funcsynopsis>
<funcprototype>
<funcdef>resource <function>zip_open</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Olvasásra megnyit egy zip állományt.
A <parameter>filename</parameter> az olvasni kívánt
zip állomány neve.
</para>
<para>
Ezzel a függvénnyel nyitjuk meg a zip állományokat további
feldolgozásra. Miután megnyitottuk, a <function>zip_read</function>
függvénnyel olvashatjuk ill. a <function>zip_close</function>
függvénnyel zárhatjuk le az állományt. A
<function>zip_open</function> logikai HAMIS (&false;) értékkel
tér vissza, ha a <parameter>filename</parameter> paraméterben
megadott fájl nem létezik.
</para>
<para>
Lásd még: <function>zip_read</function> és
<function>zip_close</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.zip-read">
<refnamediv>
<refname>zip_read</refname>
<refpurpose>Beolvassa a soron következő zip objektumot egy zip
állományban</refpurpose>
</refnamediv>
<refsect1>
<title>Leírás</title>
<funcsynopsis>
<funcprototype>
<funcdef>resource <function>zip_read</function></funcdef>
<paramdef>resource <parameter>zip</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Beolvassa a soron következő zip objektumot egy zip állományból.
A <parameter>zip</parameter> paraméter egy létező zip állomány,
amit előzőleg megnyitottunk a <function>zip_open</function> függvénnyel.
</para>
<para>
Ez a függvény az aktuális zip objektumot feldolgozhatóvá teszi a
<function>zip_entry_...</function> függvények számára.
</para>
<para>
Lásd még: <function>zip_open</function>,
<function>zip_close</function>,
<function>zip_entry_open</function>, és
<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:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
