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 Zip Fájl függvények (csak olvasáshoz) Zip Ez a modul a ZZIPlib 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. 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. A zip támogatás nincs beépítve a PHP-ben, a --with-zip 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. 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. Példa 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 test2.zip állomány a ZZIPlib csomag egyik "beépített" próba állománya. Példaprogram <?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); } ?> A program először megnyitja a megadott útvonalon található test2.zip fájlt. A ciklust addig végzi, amíg a a zip_read egy érvényes $zip_entry (vagyis a zip állományban létező fájl vagy könyvtár) értékkel tér vissza. A zip_read tulajdonképpen egy tömb eléréseként képzelhető, amely tömbbe a zip_open 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. zip_close Lezár egy megnyitott ZIP állományt Leírás void zip_close resource zip Lezár egy megnyitott ZIP állományt. Ez csak akkor működik, ha a zip forrásfájlt előzőleg a zip_open függvénnyel nyitottuk meg. Ennek a függvénynek nincs visszatérési értéke. Lásd még: zip_open és zip_read. zip_entry_close Lezár egy ZIP állományban található objektumot Leírás void zip_entry_close resource zip_entry Lezárja a zip állományban lévő zip_entry objektumot. A zip_entry paraméter egy létező objektum a zip fájlban, amit a zip_entry_open függvénnyel nyitottunk meg. Ennek a függvénynek nincs visszatérési értéke. Lásd még: zip_entry_open és zip_entry_read. zip_entry_compressedsize Egy zip-ben lévő objektum tömörített méretét adja vissza Leírás int zip_entry_compressedsize resource zip_entry Az adott zip_entry objektum tömörített méretével tér vissza. A zip_entry egy létező zip állománybeli objektumra mutat, amihez a zip_read függvény segítségével jutunk. Lásd még: zip_open és zip_read. zip_entry_compressionmethod A megadott zip objektum tömörítési típusával tér vissza Leírás string zip_entry_compressionmethod resource zip_entry A megadott zip_entry 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 zip_read függvény segítségével jutottunk. Lásd még: zip_open és zip_read. zip_entry_filesize Az adott zip objektum tömörítetlen fájlméretét adja vissza Leírás int zip_entry_filesize resource zip_entry Visszatér az adott zip_entry objektum tömörítetlen fájlméretének értékével. Ez a zip_entry paraméter egy létező zip objektum ami a zip_read függvény visszatérési értéke. Lásd még: zip_open és zip_read. zip_entry_name A zip objektum nevével tér vissza Leírás string zip_entry_name resource zip_entry A zip_entry paraméterrel megadott zip objektum nevével tér vissza. A zip_entry paraméter egy létező zip objektum, amit a zip_read függvénnyel olvashatunk ki a zip állományból. Lásd még: zip_open és zip_read. zip_entry_open Olvasásra megnyit egy zip objektumot Leírás bool zip_entry_open resource zip resource zip_entry string mode Olvasásra megnyit egy létező zip objektumot egy zip állományból. A zip paraméter egy létező zip fájl, amit a zip_open függvénnyel nyitottunk meg. Az olvasni kívánt objektumot a zip_entry definiálja, ami a zip_read függvény visszatérési értéke. A mode nem kötelező paraméter, lásd az fopen dokumentációját a lehetséges értékekért. Jelenleg a mode paramétert nem veszi figyelembe a PHP, csak az "rb" alapértelmezett értékkel dolgozik. Emiatt a PHP-ben csak olvasási hozzáférést kapunk a zip állományokhoz. Az fopen dokumentációja részletesen magyarázza a különböző fájl kapcsolókat, köztük az "rb"-t is. Ez a függvény siker esetén logikai IGAZ (&true;), kudarcnál logikai HAMIS (&false;) értékeket vesz fel. Ellentétben az fopen és más hasonló függvényekkel, a zip_entry_open 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. Lásd még: zip_entry_read és zip_entry_close. zip_entry_read Olvas egy megnyitott zip objektumból Leírás string zip_entry_read resource zip_entry int length A length paraméterben megadott bájt hosszúságú részt olvas be egy megnyitott zip objektumból. Ha a length paraméter nincs megadva, az alapértelmezés 1024 bájt. A zip_entry paraméter egy létező zip objektum, ami a zip_read függvény visszatérési értéke. A length paramétert tömörítetlen méretben kell érteni! 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. Lásd még: zip_entry_open, zip_entry_close és zip_entry_filesize. zip_open Megnyit egy zip állományt Leírás resource zip_open string filename Olvasásra megnyit egy zip állományt. A filename az olvasni kívánt zip állomány neve. Ezzel a függvénnyel nyitjuk meg a zip állományokat további feldolgozásra. Miután megnyitottuk, a zip_read függvénnyel olvashatjuk ill. a zip_close függvénnyel zárhatjuk le az állományt. A zip_open logikai HAMIS (&false;) értékkel tér vissza, ha a filename paraméterben megadott fájl nem létezik. Lásd még: zip_read és zip_close. zip_read Beolvassa a soron következő zip objektumot egy zip állományban Leírás resource zip_read resource zip Beolvassa a soron következő zip objektumot egy zip állományból. A zip paraméter egy létező zip állomány, amit előzőleg megnyitottunk a zip_open függvénnyel. Ez a függvény az aktuális zip objektumot feldolgozhatóvá teszi a zip_entry_... függvények számára. Lásd még: zip_open, zip_close, zip_entry_open, és zip_entry_read.