cvs: phpdoc(REF_STRUCT_DEV) / manual.xml.in /en/reference/lzf book.xml constants.xml reference.xml setup.xml /en/reference/phar book.xml
constants.xml fileformat.xml reference.xml setup.xml using.xml /en/reference/rar book.xml constants.xml examples.xml reference.xml setup.xml
/en/reference/zip book.xml constants.xml examples.xml reference.xml setup.xml /en/reference/zlib book.xml constants.xml examples.xml reference.xml
setup.xml
| From: | Hannes Magnusson | Date: | Fri, 30 Nov 2007 18:24:06 +0000 |
| Subject: | cvs: phpdoc(REF_STRUCT_DEV) / manual.xml.in /en/reference/lzf book.xml constants.xml reference.xml setup.xml /en/reference/phar book.xml constants.xml fileformat.xml reference.xml setup.xml using.xml /en/reference/rar book.xml constants.xml examples.xml reference.xml setup.xml /en/reference/zip book.xml constants.xml examples.xml reference.xml setup.xml /en/reference/zlib book.xml constants.xml examples.xml reference.xml setup.xml |
||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-491@lists.php.net to get a copy of this message | ||
bjori Fri Nov 30 18:24:06 2007 UTC
Added files: (Branch: REF_STRUCT_DEV)
/phpdoc/en/reference/lzf book.xml constants.xml setup.xml
/phpdoc/en/reference/phar book.xml constants.xml setup.xml
/phpdoc/en/reference/rar book.xml constants.xml examples.xml
setup.xml
/phpdoc/en/reference/zip book.xml examples.xml setup.xml
/phpdoc/en/reference/zlib book.xml examples.xml setup.xml
Modified files:
/phpdoc manual.xml.in
/phpdoc/en/reference/lzf reference.xml
/phpdoc/en/reference/phar fileformat.xml reference.xml using.xml
/phpdoc/en/reference/rar reference.xml
/phpdoc/en/reference/zip constants.xml reference.xml
/phpdoc/en/reference/zlib constants.xml reference.xml
Log:
Upgrade refs.compression
http://cvs.php.net/viewvc.cgi/phpdoc/manual.xml.in?r1=1.224.2.20&r2=1.224.2.21&diff_format=u Index: phpdoc/manual.xml.in diff -u phpdoc/manual.xml.in:1.224.2.20 phpdoc/manual.xml.in:1.224.2.21 --- phpdoc/manual.xml.in:1.224.2.20 Fri Nov 30 16:31:32 2007 +++ phpdoc/manual.xml.in Fri Nov 30 18:24:05 2007 @@ -2,7 +2,7 @@ <!DOCTYPE set PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN" "@srcdir@/docbook/docbook-xml/docbook.dtd" [ -<!-- $Revision: 1.224.2.20 $ --> <!-- Last updated to comply to manual.xml.in 1.189 --> +<!-- $Revision: 1.224.2.21 $ --> <!-- Last updated to comply to manual.xml.in 1.189 --> <!-- We use xhtml entities all over the place --> <!ENTITY % xhtml-lat1 SYSTEM "@srcdir@/entities/ISO/xhtml1-lat1.ent"> <!ENTITY % xhtml-symbol SYSTEM "@srcdir@/entities/ISO/xhtml1-symbol.ent"> @@ -319,14 +319,14 @@ &reference.shmop.reference; </book> - <book xml:id="refs.remote.mail"> + <set xml:id="refs.remote.mail"> <title>Mail Related Extensions</title> - &reference.cyrus.reference; - &reference.mail.reference; - &reference.mailparse.reference; - &reference.imap.reference; - &reference.vpopmail.reference; - </book> + &reference.cyrus.book; + &reference.mail.book; + &reference.mailparse.book; + &reference.imap.book; + &reference.vpopmail.book; + </set> <book xml:id="refs.remote.auth"> <title>Authentication Services</title> @@ -360,15 +360,15 @@ &reference.snmp.reference; </book> - <book xml:id="refs.compression"> + <set xml:id="refs.compression"> <title>Compression Extensions</title> - &reference.bzip2.reference; - &reference.lzf.reference; - &reference.phar.reference; - &reference.rar.reference; - &reference.zip.reference; - &reference.zlib.reference; - </book> + &reference.bzip2.book; + &reference.lzf.book; + &reference.phar.book; + &reference.rar.book; + &reference.zip.book; + &reference.zlib.book; + </set> <book xml:id="refs.calendar"> <title>Calendar and Event Related Extensions</title> @@ -422,12 +422,12 @@ &reference.printer.reference; </book> - <book xml:id="refs.utilspec.server"> + <set xml:id="refs.utilspec.server"> <title>Server Specific Extensions</title> - &reference.apache.reference; - &reference.nsapi.reference; - &reference.iisfunc.reference; - </book> + &reference.apache.book; + &reference.nsapi.book; + &reference.iisfunc.book; + </set> <set xml:id="refs.utilspec.misc"> <title>Misc Extensions</title> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/lzf/reference.xml?r1=1.5.2.1&r2=1.5.2.2&diff_format=u Index: phpdoc/en/reference/lzf/reference.xml diff -u phpdoc/en/reference/lzf/reference.xml:1.5.2.1 phpdoc/en/reference/lzf/reference.xml:1.5.2.2 --- phpdoc/en/reference/lzf/reference.xml:1.5.2.1 Wed Oct 3 11:41:11 2007 +++ phpdoc/en/reference/lzf/reference.xml Fri Nov 30 18:24:05 2007 @@ -1,23 +1,10 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.5.2.1 $ --> +<!-- $Revision: 1.5.2.2 $ --> <!-- Purpose: compression --> <!-- Membership: pecl --> -<reference xml:id="ref.lzf" xmlns="http://docbook.org/ns/docbook"> - <title>LZF Functions</title> - <titleabbrev>LZF</titleabbrev> - - <partintro> - <section xml:id="lzf.intro"> - &reftitle.intro; - <para> - LZF is a very fast compression algorithm, ideal for saving space with - only slight speed cost. It can be optimized for speed or space at the - time of compilation. - </para> - </section> - &reference.lzf.configure; - </partintro> +<reference xml:id="functions.lzf" xmlns="http://docbook.org/ns/docbook"> + <title>LZF &Functions;</title> &reference.lzf.functions.entities; http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/phar/fileformat.xml?r1=1.6&r2=1.6.2.1&diff_format=u Index: phpdoc/en/reference/phar/fileformat.xml diff -u phpdoc/en/reference/phar/fileformat.xml:1.6 phpdoc/en/reference/phar/fileformat.xml:1.6.2.1 --- phpdoc/en/reference/phar/fileformat.xml:1.6 Wed Jun 20 22:25:15 2007 +++ phpdoc/en/reference/phar/fileformat.xml Fri Nov 30 18:24:06 2007 @@ -1,25 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<section xml:id="phar.fileformat" xmlns="http://docbook.org/ns/docbook"> - <title>Phar file format</title> - <para> - All Phar files contain three to four sections: - <orderedlist> - <listitem> - <para>a stub</para> - </listitem> - <listitem> - <para>a manifest describing the contents</para> - </listitem> - <listitem> - <para>the file contents</para> - </listitem> - <listitem> - <para>[optional] a signature for verifying Phar integrity</para> - </listitem> - </orderedlist> - </para> -</section> +<!-- $Revision: 1.6.2.1 $ --> +<chapter xml:id="phar.fileformat" xmlns="http://docbook.org/ns/docbook"> + <title>Phar File format</title> + <section> + <title>Phar file format</title> + <para> + All Phar files contain three to four sections: + <orderedlist> + <listitem> + <para>a stub</para> + </listitem> + <listitem> + <para>a manifest describing the contents</para> + </listitem> + <listitem> + <para>the file contents</para> + </listitem> + <listitem> + <para>[optional] a signature for verifying Phar integrity</para> + </listitem> + </orderedlist> + </para> + </section> <section> <title>Phar file stub</title> <para> @@ -302,6 +304,7 @@ </table> </para> </section> +</chapter> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/phar/reference.xml?r1=1.8.2.1&r2=1.8.2.2&diff_format=u Index: phpdoc/en/reference/phar/reference.xml diff -u phpdoc/en/reference/phar/reference.xml:1.8.2.1 phpdoc/en/reference/phar/reference.xml:1.8.2.2 --- phpdoc/en/reference/phar/reference.xml:1.8.2.1 Wed Oct 3 11:41:14 2007 +++ phpdoc/en/reference/phar/reference.xml Fri Nov 30 18:24:06 2007 @@ -1,96 +1,12 @@ <?xml version = '1.0' encoding = 'iso-8859-1'?> -<!-- $Revision: 1.8.2.1 $ --> +<!-- $Revision: 1.8.2.2 $ --> <!-- Purpose: compression --> <!-- Membership: pecl --> -<reference xml:id="ref.phar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Phar archive stream and classes</title> - <titleabbrev>phar</titleabbrev> - <partintro> - <section xml:id="phar.intro" > - &reftitle.intro; - <para> - The phar extension - provides the <literal>phar</literal> stream wrapper and the <classname>Phar</classname> - class for manipulating self-contained PHP Archive (phar) files. The - Phar class can be used to create and to extract contents of phar files as - well as iterating over their contents. - </para> - <para> - PHP Archive files (Phars) are special collections of files that can be transparently - run right out of the file, similar to Java's jar archive files. Using a phar archive, - it is possible to distribute a complete PHP application in a single file that will - run out of the file without modification or extraction. Phar - archives can also be used to store files for extraction similar to tar or zip - archive files. Phars support compression using gzip if the - <link linkend="ref.zlib">zlib</link> extension is present, and using bzip2 if - the <link linkend="ref.bzip2">bz2</link> extension is present. In addition, - iteration and other features are available if the <link linkend="ref.spl">SPL</link> - extension is available. Phar signature verification using md5 or sha1 is natively - supported to ensure archive integrity. - </para> - <para> - The original implementation for Phar archives was in the PEAR package - <link xlink:href="http://pear.php.net/PHP_Archive">PHP_Archive</link>, and - the implementation details are very similar, although the Phar extension - is more full-featured. PHP_Archive has more flexibility in Phar creation, - and helpful debugging tools like the <classname>PHP_Archive_Manager</classname> - class, and the Phar extension supports iteration, array access, and - directly manipulating Phar contents through a simple interface. PHP_Archive - supports creation of Phar archives that can be processed using the Phar - extension or PHP_Archive seamlessly, whereas the Phar extension is designed - to create extensions that function with the Phar extension. In addition, - the Phar extension will continue to work even if the - <link linkend="ini.allow-url-include">allow_url_include</link> or - <link linkend="ini.allow-url-fopen">allow_url_fopen</link> INI variables - are disabled, while PHP_Archive-based Phar archives (without the Phar extension) - will not function. - </para> - </section> - <section xml:id="phar.requirements" > - &reftitle.required; - <para> - Phar requires PHP 5.2.0 or newer. Additional features require the - <link linkend="ref.spl">SPL</link> extension in order to take advantage - of iteration and array access to a Phar's file contents. The <literal>phar</literal> - stream does not require any additional extensions to function. - </para> - <para> - You may optionally wish to enable the <link linkend="ref.zlib" >zlib</link> - and <link linkend="ref.bzip2" >bzip2</link> extensions to take - advantage of compressed phar support. - </para> - </section> - &reference.phar.installation; - <!-- Information found in configure.xml --> - <!-- reference.phar.configure; --> - <!-- Information found in ini.xml --> - &reference.phar.ini; - <section xml:id="phar.resources" > - &reftitle.resources; - <para> - The Phar extension provides the <literal>phar</literal> stream, which - allows accessing files contained within a phar transparently. The - file format of a Phar is described <link linkend="phar.fileformat">here</link> - </para> - </section> - <section> - &reftitle.classes; - <simplelist> - <member> - <classname>Phar</classname> - </member> - <member> - <classname>PharFileInfo</classname> - </member> - <member> - <classname>PharException</classname> - </member> - </simplelist> - </section> - &reference.phar.using; - &reference.phar.fileformat; - </partintro> - &reference.phar.functions.entities; +<reference xml:id="functions.phar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Phar archive stream and classes</title> + <titleabbrev>phar</titleabbrev> + + &reference.phar.functions.entities; </reference> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/phar/using.xml?r1=1.5&r2=1.5.2.1&diff_format=u Index: phpdoc/en/reference/phar/using.xml diff -u phpdoc/en/reference/phar/using.xml:1.5 phpdoc/en/reference/phar/using.xml:1.5.2.1 --- phpdoc/en/reference/phar/using.xml:1.5 Wed Jun 20 22:25:15 2007 +++ phpdoc/en/reference/phar/using.xml Fri Nov 30 18:24:06 2007 @@ -1,6 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<section xml:id="phar.using.basics" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> +<!-- $Revision: 1.5.2.1 $ --> +<chapter xml:id="phar.using.basics" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Using Phar Archives</title> + + <section> <title>Using Phar Archives: Introduction</title> <para> Phar archives are similar in concept to Java JAR archives, but are @@ -263,6 +266,7 @@ contained within a Phar, such as manipulating compression and metadata. </para> </section> +</chapter> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/rar/reference.xml?r1=1.5.2.1&r2=1.5.2.2&diff_format=u Index: phpdoc/en/reference/rar/reference.xml diff -u phpdoc/en/reference/rar/reference.xml:1.5.2.1 phpdoc/en/reference/rar/reference.xml:1.5.2.2 --- phpdoc/en/reference/rar/reference.xml:1.5.2.1 Wed Oct 3 11:41:14 2007 +++ phpdoc/en/reference/rar/reference.xml Fri Nov 30 18:24:06 2007 @@ -1,171 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5.2.1 $ --> -<!-- Purpose: compression --> -<!-- Membership: pecl, external --> +<!-- $Revision: 1.5.2.2 $ --> - <reference xml:id="ref.rar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Rar Functions</title> + <reference xml:id="functions.rar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Rar &Functions;</title> <titleabbrev>Rar</titleabbrev> - <partintro> - - <section xml:id="rar.intro"> - &reftitle.intro; - <para> - Rar is a powerful and effective archiver created by Eugene Roshal. - This extension gives you possibility to read Rar archives but - doesn't support writing Rar archives, because this is not supported - by UnRar library and is directly prohibited by it's license. - </para> - <para> - More information about Rar and UnRar can be found at <link - xlink:href="&url.rar;">&url.rar;</link>. - </para> - </section> - - <section xml:id="rar.requirements"> - &reftitle.required; - &no.requirement; - </section> - - &reference.rar.ini; - - <section xml:id="rar.install"> - &reftitle.install; - <para> - Rar is currently available through PECL - <link xlink:href="&url.pecl.package;rar">&url.pecl.package;rar</link>. - </para> - <para> - Also you can use the PECL installer to install the Rar extension, - using the following command: <command>pecl -v install rar</command>. - </para> - <para> - You can always download the tar.gz package and install Rar by hand: - <example> - <title>Rar installation</title> - <programlisting role="shell"> -<![CDATA[ -gunzip rar-xxx.tgz -tar -xvf rar-xxx.tar -cd rar-xxx -phpize -./configure && make && make install -]]> - </programlisting> - </example> - </para> - <para> - Windows users can download the extension dll <filename>php_rar.dll</filename> - here: <link xlink:href="&url.pecl.get.win;">&url.pecl.get.win;</link>. - </para> - </section> - - <section xml:id="rar.resources"> - &reftitle.resources; - <para> - There is one resource used in Rar extension: a file descriptor returned - by <function>rar_open</function>. - </para> - </section> - - <section xml:id="rar.constants"> - &reftitle.constants; - <variablelist> - <varlistentry> - <term> - <constant>RAR_HOST_MSDOS</constant> - (<type>integer</type>) - </term> - <listitem> - <simpara> - - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term> - <constant>RAR_HOST_OS2</constant> - (<type>integer</type>) - </term> - <listitem> - <simpara> - - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term> - <constant>RAR_HOST_WIN32</constant> - (<type>integer</type>) - </term> - <listitem> - <simpara> - - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term> - <constant>RAR_HOST_UNIX</constant> - (<type>integer</type>) - </term> - <listitem> - <simpara> - - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term> - <constant>RAR_HOST_BEOS</constant> - (<type>integer</type>) - </term> - <listitem> - <simpara> - - </simpara> - </listitem> - </varlistentry> - </variablelist> - </section> - - <section xml:id="rar.examples"> - &reftitle.examples; - <para> - <example> - <title>Rar extension overview example</title> - <programlisting role="php"> -<![CDATA[ -<?php - -$rar_file = rar_open('example.rar') or die("Can't open Rar archive"); - -$entries = rar_list($rar_file); - -foreach ($entries as $entry) { - echo 'Filename: ' . $entry->getName() . "\n"; - echo 'Packed size: ' . $entry->getPackedSize() . "\n"; - echo 'Unpacked size: ' . $entry->getUnpackedSize() . "\n"; - - $entry->extract('/dir/extract/to/'); -} - -rar_close($rar_file); - -?> -]]> - </programlisting> - </example> - </para> - <para> - This example opens a Rar file archive and extracts each entry to the - specified directory. - </para> - </section> - - </partintro> - &reference.rar.functions.entities; </reference> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zip/constants.xml?r1=1.5&r2=1.5.2.1&diff_format=u Index: phpdoc/en/reference/zip/constants.xml diff -u phpdoc/en/reference/zip/constants.xml:1.5 phpdoc/en/reference/zip/constants.xml:1.5.2.1 --- phpdoc/en/reference/zip/constants.xml:1.5 Wed Jun 20 22:25:39 2007 +++ phpdoc/en/reference/zip/constants.xml Fri Nov 30 18:24:06 2007 @@ -1,6 +1,6 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.5 $ --> -<section xml:id="zip.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.5.2.1 $ --> +<appendix xml:id="zip.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; @@ -503,7 +503,7 @@ </listitem> </varlistentry> </variablelist> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zip/reference.xml?r1=1.15.2.1&r2=1.15.2.2&diff_format=u Index: phpdoc/en/reference/zip/reference.xml diff -u phpdoc/en/reference/zip/reference.xml:1.15.2.1 phpdoc/en/reference/zip/reference.xml:1.15.2.2 --- phpdoc/en/reference/zip/reference.xml:1.15.2.1 Wed Oct 3 11:41:17 2007 +++ phpdoc/en/reference/zip/reference.xml Fri Nov 30 18:24:06 2007 @@ -1,181 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15.2.1 $ --> -<!-- Purpose: compression --> -<!-- Membership: bundled, pecl --> +<!-- $Revision: 1.15.2.2 $ --> -<reference xml:id="ref.zip" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> +<reference xml:id="functions.zip" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Zip File Functions</title> - <titleabbrev>Zip</titleabbrev> - - <partintro> - <section xml:id="zip.intro"> - &reftitle.intro; - <para> - This extension enables you to transparently read or write ZIP compressed - archives and the files inside them. - </para> - </section> - - <section xml:id="zip.requirements"> - &reftitle.required; - <section xml:id="zip.requirements.old"> - <title>PHP 4</title> - <para> - The bundled PHP 4 version requires <link xlink:href="&url.zziplib;">ZZIPlib</link>, - by Guido Draheim, version 0.10.6 or later - </para> - </section> - - <section xml:id="zip.requirements.new"> - <title>PHP 5.2.0 or later</title> - <para> - This extension uses the functions of <link xlink:href="&url.zlib;">zlib</link> - by Jean-loup Gailly and Mark Adler. - </para> - </section> - </section> - - &reference.zip.configure; - - <section xml:id="zip.configuration"> - &reftitle.runtime; - &no.config; - </section> - - <section xml:id="zip.resources"> - &reftitle.resources; - <para> - There are two resource types used in the Zip module. The first one - is the Zip directory for the Zip archive, the second Zip Entry for - the archive entries. - </para> - </section> - - &reference.zip.constants; - - <section xml:id="zip.examples"> - &reftitle.examples; - <example> - <title>Create a Zip archive</title> - <programlisting role="php"> -<![CDATA[ -<?php - -$zip = new ZipArchive(); -$filename = "./test112.zip"; - -if ($zip->open($filename, ZIPARCHIVE::CREATE)!==TRUE) { - exit("cannot open <$filename>\n"); -} - -$zip->addFromString("testfilephp.txt" . time(), "#1 This is a test string added as testfilephp.txt.\n"); -$zip->addFromString("testfilephp2.txt" . time(), "#2 This is a test string added as testfilephp2.txt.\n"); -$zip->addFile($thisdir . "/too.php","/testfromfile.php"); -echo "numfiles: " . $zip->numFiles . "\n"; -echo "status:" . $zip->status . "\n"; -$zip->close(); -?> -]]> - </programlisting> - </example> - <example> - <title>Dump the archive details and listing</title> - <programlisting role="php"> -<![CDATA[ -<?php -$za = new ZipArchive(); - -$za->open('test_with_comment.zip'); -print_r($za); -var_dump($za); -echo "numFiles: " . $za->numFiles . "\n"; -echo "status: " . $za->status . "\n"; -echo "statusSys: " . $za->statusSys . "\n"; -echo "filename: " . $za->filename . "\n"; -echo "comment: " . $za->comment . "\n"; - -for ($i=0; $i<$za->numFiles;$i++) { - echo "index: $i\n"; - print_r($za->statIndex($i)); -} -echo "numFile:" . $za->numFiles . "\n"; -?> -]]> - </programlisting> - </example> - <example> - <title>Zip stream wrapper, read an OpenOffice meta info</title> - <programlisting role="php"> -<![CDATA[ -<?php -$reader = new XMLReader(); - -$reader->open('zip://' . dirname(__FILE__) . '/test.odt#meta.xml'); -$odt_meta = array(); -while ($reader->read()) { - if ($reader->nodeType == XMLREADER::ELEMENT) { - $elm = $reader->name; - } else { - if ($reader->nodeType == XMLREADER::END_ELEMENT && $reader->name == 'office:meta') { - break; - } - if (!trim($reader->value)) { - continue; - } - $odt_meta[$elm] = $reader->value; - } -} -print_r($odt_meta); -?> -]]> - </programlisting> - </example> - <para> - This example uses the old API (PHP 4), it opens a ZIP file - archive, reads each file in the archive and prints out its - contents. The <filename>test2.zip</filename> archive used in this - example is one of the test archives in the ZZIPlib source - distribution. - </para> - <example> - <title>Zip Usage Example</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> - </section> - </partintro> &reference.zip.functions.entities; </reference> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zlib/constants.xml?r1=1.6&r2=1.6.2.1&diff_format=u Index: phpdoc/en/reference/zlib/constants.xml diff -u phpdoc/en/reference/zlib/constants.xml:1.6 phpdoc/en/reference/zlib/constants.xml:1.6.2.1 --- phpdoc/en/reference/zlib/constants.xml:1.6 Wed Jun 20 22:25:40 2007 +++ phpdoc/en/reference/zlib/constants.xml Fri Nov 30 18:24:06 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<section xml:id="zlib.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.6.2.1 $ --> +<appendix xml:id="zlib.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> @@ -27,7 +27,7 @@ </listitem> </varlistentry> </variablelist> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zlib/reference.xml?r1=1.18.2.1&r2=1.18.2.2&diff_format=u Index: phpdoc/en/reference/zlib/reference.xml diff -u phpdoc/en/reference/zlib/reference.xml:1.18.2.1 phpdoc/en/reference/zlib/reference.xml:1.18.2.2 --- phpdoc/en/reference/zlib/reference.xml:1.18.2.1 Wed Oct 3 11:41:17 2007 +++ phpdoc/en/reference/zlib/reference.xml Fri Nov 30 18:24:06 2007 @@ -1,121 +1,12 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18.2.1 $ --> -<!-- Purpose: compression --> -<!-- Membership: bundled --> +<!-- $Revision: 1.18.2.2 $ --> - <reference xml:id="ref.zlib" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Zlib Compression Functions</title> - <titleabbrev>Zlib</titleabbrev> +<reference xml:id="functions.zlib" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Zlib Compression Functions</title> - <partintro> - <section xml:id="zlib.intro"> - &reftitle.intro; - <para> - This module enables you to transparently read and write - gzip (.gz) compressed files, through versions of most of - the <link linkend="ref.filesystem">filesystem</link> functions - which work with gzip-compressed files (and uncompressed files, - too, but not with sockets). - </para> - <note> - <para> - Version 4.0.4 introduced a fopen-wrapper for .gz-files, so that - you can use a special <filename>zlib:</filename> URL to access - compressed files transparently using the normal f*() file access - functions if you prefix the filename or path with - <filename>zlib:</filename> when calling <function>fopen</function>. This - feature requires a C runtime library that provides the - <literal>fopencookie()</literal> function. Up to now the GNU libc - seems to be the only library that provides this feature. - </para> - <para> - In PHP 4.3.0, <filename>zlib:</filename> has been changed to - <filename>compress.zlib://</filename> to prevent ambiguities with - filenames containing ':' characters. The - <literal>fopencookie()</literal> function is not longer required. - More information is available in the section about - <xref linkend="wrappers.compression" />. - </para> - </note> - </section> + &reference.zlib.functions.entities; - <section xml:id="zlib.requirements"> - &reftitle.required; - <para> - This module uses the functions of <link xlink:href="&url.zlib;">zlib</link> - by Jean-loup Gailly and Mark Adler. You have to use a zlib - version >= 1.0.9 with this module. - </para> - </section> - - &reference.zlib.configure; - - &reference.zlib.ini; - - <section xml:id="zlib.resources"> - &reftitle.resources; - <para> - This extension defines a file pointer resource returned by - <function>gzopen</function>. - </para> - </section> - - &reference.zlib.constants; - - <section xml:id="zlib.examples"> - &reftitle.examples; - <para> - This example opens a temporary file and writes a test string - to it, then it prints out the content of this file twice. - </para> - <example> - <title>Small Zlib Example</title> - <programlisting role="php"> -<![CDATA[ -<?php - -$filename = tempnam('/tmp', 'zlibtest') . '.gz'; -echo "<html>\n<head></head>\n<body>\n<pre>\n"; -$s = "Only a test, test, test, test, test, test, test, test!\n"; - -// open file for writing with maximum compression -$zp = gzopen($filename, "w9"); - -// write string to file -gzwrite($zp, $s); - -// close file -gzclose($zp); - -// open file for reading -$zp = gzopen($filename, "r"); - -// read 3 char -echo gzread($zp, 3); - -// output until end of the file and close it. -gzpassthru($zp); -gzclose($zp); - -echo "\n"; - -// open file and print content (the 2nd time). -if (readgzfile($filename) != strlen($s)) { - echo "Error with zlib functions!"; -} -unlink($filename); -echo "</pre>\n</body>\n</html>\n"; - -?> -]]> - </programlisting> - </example> - </section> - </partintro> - -&reference.zlib.functions.entities; - - </reference> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/lzf/book.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/lzf/book.xml +++ phpdoc/en/reference/lzf/book.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/lzf/constants.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/lzf/constants.xml +++ phpdoc/en/reference/lzf/constants.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/lzf/setup.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/lzf/setup.xml +++ phpdoc/en/reference/lzf/setup.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/phar/book.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/phar/book.xml +++ phpdoc/en/reference/phar/book.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/phar/constants.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/phar/constants.xml +++ phpdoc/en/reference/phar/constants.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/phar/setup.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/phar/setup.xml +++ phpdoc/en/reference/phar/setup.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/rar/book.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/rar/book.xml +++ phpdoc/en/reference/rar/book.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/rar/constants.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/rar/constants.xml +++ phpdoc/en/reference/rar/constants.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/rar/examples.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/rar/examples.xml +++ phpdoc/en/reference/rar/examples.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/rar/setup.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/rar/setup.xml +++ phpdoc/en/reference/rar/setup.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zip/book.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/zip/book.xml +++ phpdoc/en/reference/zip/book.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zip/examples.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/zip/examples.xml +++ phpdoc/en/reference/zip/examples.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zip/setup.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/zip/setup.xml +++ phpdoc/en/reference/zip/setup.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zlib/book.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/zlib/book.xml +++ phpdoc/en/reference/zlib/book.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zlib/examples.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/zlib/examples.xml +++ phpdoc/en/reference/zlib/examples.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zlib/setup.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/zlib/setup.xml +++ phpdoc/en/reference/zlib/setup.xml
http://cvs.php.net/viewvc.cgi/phpdoc/manual.xml.in?r1=1.224.2.20&r2=1.224.2.21&diff_format=u Index: phpdoc/manual.xml.in diff -u phpdoc/manual.xml.in:1.224.2.20 phpdoc/manual.xml.in:1.224.2.21 --- phpdoc/manual.xml.in:1.224.2.20 Fri Nov 30 16:31:32 2007 +++ phpdoc/manual.xml.in Fri Nov 30 18:24:05 2007 @@ -2,7 +2,7 @@ <!DOCTYPE set PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN" "@srcdir@/docbook/docbook-xml/docbook.dtd" [ -<!-- $Revision: 1.224.2.20 $ --> <!-- Last updated to comply to manual.xml.in 1.189 --> +<!-- $Revision: 1.224.2.21 $ --> <!-- Last updated to comply to manual.xml.in 1.189 --> <!-- We use xhtml entities all over the place --> <!ENTITY % xhtml-lat1 SYSTEM "@srcdir@/entities/ISO/xhtml1-lat1.ent"> <!ENTITY % xhtml-symbol SYSTEM "@srcdir@/entities/ISO/xhtml1-symbol.ent"> @@ -319,14 +319,14 @@ &reference.shmop.reference; </book> - <book xml:id="refs.remote.mail"> + <set xml:id="refs.remote.mail"> <title>Mail Related Extensions</title> - &reference.cyrus.reference; - &reference.mail.reference; - &reference.mailparse.reference; - &reference.imap.reference; - &reference.vpopmail.reference; - </book> + &reference.cyrus.book; + &reference.mail.book; + &reference.mailparse.book; + &reference.imap.book; + &reference.vpopmail.book; + </set> <book xml:id="refs.remote.auth"> <title>Authentication Services</title> @@ -360,15 +360,15 @@ &reference.snmp.reference; </book> - <book xml:id="refs.compression"> + <set xml:id="refs.compression"> <title>Compression Extensions</title> - &reference.bzip2.reference; - &reference.lzf.reference; - &reference.phar.reference; - &reference.rar.reference; - &reference.zip.reference; - &reference.zlib.reference; - </book> + &reference.bzip2.book; + &reference.lzf.book; + &reference.phar.book; + &reference.rar.book; + &reference.zip.book; + &reference.zlib.book; + </set> <book xml:id="refs.calendar"> <title>Calendar and Event Related Extensions</title> @@ -422,12 +422,12 @@ &reference.printer.reference; </book> - <book xml:id="refs.utilspec.server"> + <set xml:id="refs.utilspec.server"> <title>Server Specific Extensions</title> - &reference.apache.reference; - &reference.nsapi.reference; - &reference.iisfunc.reference; - </book> + &reference.apache.book; + &reference.nsapi.book; + &reference.iisfunc.book; + </set> <set xml:id="refs.utilspec.misc"> <title>Misc Extensions</title> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/lzf/reference.xml?r1=1.5.2.1&r2=1.5.2.2&diff_format=u Index: phpdoc/en/reference/lzf/reference.xml diff -u phpdoc/en/reference/lzf/reference.xml:1.5.2.1 phpdoc/en/reference/lzf/reference.xml:1.5.2.2 --- phpdoc/en/reference/lzf/reference.xml:1.5.2.1 Wed Oct 3 11:41:11 2007 +++ phpdoc/en/reference/lzf/reference.xml Fri Nov 30 18:24:05 2007 @@ -1,23 +1,10 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.5.2.1 $ --> +<!-- $Revision: 1.5.2.2 $ --> <!-- Purpose: compression --> <!-- Membership: pecl --> -<reference xml:id="ref.lzf" xmlns="http://docbook.org/ns/docbook"> - <title>LZF Functions</title> - <titleabbrev>LZF</titleabbrev> - - <partintro> - <section xml:id="lzf.intro"> - &reftitle.intro; - <para> - LZF is a very fast compression algorithm, ideal for saving space with - only slight speed cost. It can be optimized for speed or space at the - time of compilation. - </para> - </section> - &reference.lzf.configure; - </partintro> +<reference xml:id="functions.lzf" xmlns="http://docbook.org/ns/docbook"> + <title>LZF &Functions;</title> &reference.lzf.functions.entities; http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/phar/fileformat.xml?r1=1.6&r2=1.6.2.1&diff_format=u Index: phpdoc/en/reference/phar/fileformat.xml diff -u phpdoc/en/reference/phar/fileformat.xml:1.6 phpdoc/en/reference/phar/fileformat.xml:1.6.2.1 --- phpdoc/en/reference/phar/fileformat.xml:1.6 Wed Jun 20 22:25:15 2007 +++ phpdoc/en/reference/phar/fileformat.xml Fri Nov 30 18:24:06 2007 @@ -1,25 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<section xml:id="phar.fileformat" xmlns="http://docbook.org/ns/docbook"> - <title>Phar file format</title> - <para> - All Phar files contain three to four sections: - <orderedlist> - <listitem> - <para>a stub</para> - </listitem> - <listitem> - <para>a manifest describing the contents</para> - </listitem> - <listitem> - <para>the file contents</para> - </listitem> - <listitem> - <para>[optional] a signature for verifying Phar integrity</para> - </listitem> - </orderedlist> - </para> -</section> +<!-- $Revision: 1.6.2.1 $ --> +<chapter xml:id="phar.fileformat" xmlns="http://docbook.org/ns/docbook"> + <title>Phar File format</title> + <section> + <title>Phar file format</title> + <para> + All Phar files contain three to four sections: + <orderedlist> + <listitem> + <para>a stub</para> + </listitem> + <listitem> + <para>a manifest describing the contents</para> + </listitem> + <listitem> + <para>the file contents</para> + </listitem> + <listitem> + <para>[optional] a signature for verifying Phar integrity</para> + </listitem> + </orderedlist> + </para> + </section> <section> <title>Phar file stub</title> <para> @@ -302,6 +304,7 @@ </table> </para> </section> +</chapter> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/phar/reference.xml?r1=1.8.2.1&r2=1.8.2.2&diff_format=u Index: phpdoc/en/reference/phar/reference.xml diff -u phpdoc/en/reference/phar/reference.xml:1.8.2.1 phpdoc/en/reference/phar/reference.xml:1.8.2.2 --- phpdoc/en/reference/phar/reference.xml:1.8.2.1 Wed Oct 3 11:41:14 2007 +++ phpdoc/en/reference/phar/reference.xml Fri Nov 30 18:24:06 2007 @@ -1,96 +1,12 @@ <?xml version = '1.0' encoding = 'iso-8859-1'?> -<!-- $Revision: 1.8.2.1 $ --> +<!-- $Revision: 1.8.2.2 $ --> <!-- Purpose: compression --> <!-- Membership: pecl --> -<reference xml:id="ref.phar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Phar archive stream and classes</title> - <titleabbrev>phar</titleabbrev> - <partintro> - <section xml:id="phar.intro" > - &reftitle.intro; - <para> - The phar extension - provides the <literal>phar</literal> stream wrapper and the <classname>Phar</classname> - class for manipulating self-contained PHP Archive (phar) files. The - Phar class can be used to create and to extract contents of phar files as - well as iterating over their contents. - </para> - <para> - PHP Archive files (Phars) are special collections of files that can be transparently - run right out of the file, similar to Java's jar archive files. Using a phar archive, - it is possible to distribute a complete PHP application in a single file that will - run out of the file without modification or extraction. Phar - archives can also be used to store files for extraction similar to tar or zip - archive files. Phars support compression using gzip if the - <link linkend="ref.zlib">zlib</link> extension is present, and using bzip2 if - the <link linkend="ref.bzip2">bz2</link> extension is present. In addition, - iteration and other features are available if the <link linkend="ref.spl">SPL</link> - extension is available. Phar signature verification using md5 or sha1 is natively - supported to ensure archive integrity. - </para> - <para> - The original implementation for Phar archives was in the PEAR package - <link xlink:href="http://pear.php.net/PHP_Archive">PHP_Archive</link>, and - the implementation details are very similar, although the Phar extension - is more full-featured. PHP_Archive has more flexibility in Phar creation, - and helpful debugging tools like the <classname>PHP_Archive_Manager</classname> - class, and the Phar extension supports iteration, array access, and - directly manipulating Phar contents through a simple interface. PHP_Archive - supports creation of Phar archives that can be processed using the Phar - extension or PHP_Archive seamlessly, whereas the Phar extension is designed - to create extensions that function with the Phar extension. In addition, - the Phar extension will continue to work even if the - <link linkend="ini.allow-url-include">allow_url_include</link> or - <link linkend="ini.allow-url-fopen">allow_url_fopen</link> INI variables - are disabled, while PHP_Archive-based Phar archives (without the Phar extension) - will not function. - </para> - </section> - <section xml:id="phar.requirements" > - &reftitle.required; - <para> - Phar requires PHP 5.2.0 or newer. Additional features require the - <link linkend="ref.spl">SPL</link> extension in order to take advantage - of iteration and array access to a Phar's file contents. The <literal>phar</literal> - stream does not require any additional extensions to function. - </para> - <para> - You may optionally wish to enable the <link linkend="ref.zlib" >zlib</link> - and <link linkend="ref.bzip2" >bzip2</link> extensions to take - advantage of compressed phar support. - </para> - </section> - &reference.phar.installation; - <!-- Information found in configure.xml --> - <!-- reference.phar.configure; --> - <!-- Information found in ini.xml --> - &reference.phar.ini; - <section xml:id="phar.resources" > - &reftitle.resources; - <para> - The Phar extension provides the <literal>phar</literal> stream, which - allows accessing files contained within a phar transparently. The - file format of a Phar is described <link linkend="phar.fileformat">here</link> - </para> - </section> - <section> - &reftitle.classes; - <simplelist> - <member> - <classname>Phar</classname> - </member> - <member> - <classname>PharFileInfo</classname> - </member> - <member> - <classname>PharException</classname> - </member> - </simplelist> - </section> - &reference.phar.using; - &reference.phar.fileformat; - </partintro> - &reference.phar.functions.entities; +<reference xml:id="functions.phar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Phar archive stream and classes</title> + <titleabbrev>phar</titleabbrev> + + &reference.phar.functions.entities; </reference> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/phar/using.xml?r1=1.5&r2=1.5.2.1&diff_format=u Index: phpdoc/en/reference/phar/using.xml diff -u phpdoc/en/reference/phar/using.xml:1.5 phpdoc/en/reference/phar/using.xml:1.5.2.1 --- phpdoc/en/reference/phar/using.xml:1.5 Wed Jun 20 22:25:15 2007 +++ phpdoc/en/reference/phar/using.xml Fri Nov 30 18:24:06 2007 @@ -1,6 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<section xml:id="phar.using.basics" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> +<!-- $Revision: 1.5.2.1 $ --> +<chapter xml:id="phar.using.basics" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Using Phar Archives</title> + + <section> <title>Using Phar Archives: Introduction</title> <para> Phar archives are similar in concept to Java JAR archives, but are @@ -263,6 +266,7 @@ contained within a Phar, such as manipulating compression and metadata. </para> </section> +</chapter> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/rar/reference.xml?r1=1.5.2.1&r2=1.5.2.2&diff_format=u Index: phpdoc/en/reference/rar/reference.xml diff -u phpdoc/en/reference/rar/reference.xml:1.5.2.1 phpdoc/en/reference/rar/reference.xml:1.5.2.2 --- phpdoc/en/reference/rar/reference.xml:1.5.2.1 Wed Oct 3 11:41:14 2007 +++ phpdoc/en/reference/rar/reference.xml Fri Nov 30 18:24:06 2007 @@ -1,171 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5.2.1 $ --> -<!-- Purpose: compression --> -<!-- Membership: pecl, external --> +<!-- $Revision: 1.5.2.2 $ --> - <reference xml:id="ref.rar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Rar Functions</title> + <reference xml:id="functions.rar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Rar &Functions;</title> <titleabbrev>Rar</titleabbrev> - <partintro> - - <section xml:id="rar.intro"> - &reftitle.intro; - <para> - Rar is a powerful and effective archiver created by Eugene Roshal. - This extension gives you possibility to read Rar archives but - doesn't support writing Rar archives, because this is not supported - by UnRar library and is directly prohibited by it's license. - </para> - <para> - More information about Rar and UnRar can be found at <link - xlink:href="&url.rar;">&url.rar;</link>. - </para> - </section> - - <section xml:id="rar.requirements"> - &reftitle.required; - &no.requirement; - </section> - - &reference.rar.ini; - - <section xml:id="rar.install"> - &reftitle.install; - <para> - Rar is currently available through PECL - <link xlink:href="&url.pecl.package;rar">&url.pecl.package;rar</link>. - </para> - <para> - Also you can use the PECL installer to install the Rar extension, - using the following command: <command>pecl -v install rar</command>. - </para> - <para> - You can always download the tar.gz package and install Rar by hand: - <example> - <title>Rar installation</title> - <programlisting role="shell"> -<![CDATA[ -gunzip rar-xxx.tgz -tar -xvf rar-xxx.tar -cd rar-xxx -phpize -./configure && make && make install -]]> - </programlisting> - </example> - </para> - <para> - Windows users can download the extension dll <filename>php_rar.dll</filename> - here: <link xlink:href="&url.pecl.get.win;">&url.pecl.get.win;</link>. - </para> - </section> - - <section xml:id="rar.resources"> - &reftitle.resources; - <para> - There is one resource used in Rar extension: a file descriptor returned - by <function>rar_open</function>. - </para> - </section> - - <section xml:id="rar.constants"> - &reftitle.constants; - <variablelist> - <varlistentry> - <term> - <constant>RAR_HOST_MSDOS</constant> - (<type>integer</type>) - </term> - <listitem> - <simpara> - - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term> - <constant>RAR_HOST_OS2</constant> - (<type>integer</type>) - </term> - <listitem> - <simpara> - - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term> - <constant>RAR_HOST_WIN32</constant> - (<type>integer</type>) - </term> - <listitem> - <simpara> - - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term> - <constant>RAR_HOST_UNIX</constant> - (<type>integer</type>) - </term> - <listitem> - <simpara> - - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term> - <constant>RAR_HOST_BEOS</constant> - (<type>integer</type>) - </term> - <listitem> - <simpara> - - </simpara> - </listitem> - </varlistentry> - </variablelist> - </section> - - <section xml:id="rar.examples"> - &reftitle.examples; - <para> - <example> - <title>Rar extension overview example</title> - <programlisting role="php"> -<![CDATA[ -<?php - -$rar_file = rar_open('example.rar') or die("Can't open Rar archive"); - -$entries = rar_list($rar_file); - -foreach ($entries as $entry) { - echo 'Filename: ' . $entry->getName() . "\n"; - echo 'Packed size: ' . $entry->getPackedSize() . "\n"; - echo 'Unpacked size: ' . $entry->getUnpackedSize() . "\n"; - - $entry->extract('/dir/extract/to/'); -} - -rar_close($rar_file); - -?> -]]> - </programlisting> - </example> - </para> - <para> - This example opens a Rar file archive and extracts each entry to the - specified directory. - </para> - </section> - - </partintro> - &reference.rar.functions.entities; </reference> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zip/constants.xml?r1=1.5&r2=1.5.2.1&diff_format=u Index: phpdoc/en/reference/zip/constants.xml diff -u phpdoc/en/reference/zip/constants.xml:1.5 phpdoc/en/reference/zip/constants.xml:1.5.2.1 --- phpdoc/en/reference/zip/constants.xml:1.5 Wed Jun 20 22:25:39 2007 +++ phpdoc/en/reference/zip/constants.xml Fri Nov 30 18:24:06 2007 @@ -1,6 +1,6 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.5 $ --> -<section xml:id="zip.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.5.2.1 $ --> +<appendix xml:id="zip.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; @@ -503,7 +503,7 @@ </listitem> </varlistentry> </variablelist> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zip/reference.xml?r1=1.15.2.1&r2=1.15.2.2&diff_format=u Index: phpdoc/en/reference/zip/reference.xml diff -u phpdoc/en/reference/zip/reference.xml:1.15.2.1 phpdoc/en/reference/zip/reference.xml:1.15.2.2 --- phpdoc/en/reference/zip/reference.xml:1.15.2.1 Wed Oct 3 11:41:17 2007 +++ phpdoc/en/reference/zip/reference.xml Fri Nov 30 18:24:06 2007 @@ -1,181 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15.2.1 $ --> -<!-- Purpose: compression --> -<!-- Membership: bundled, pecl --> +<!-- $Revision: 1.15.2.2 $ --> -<reference xml:id="ref.zip" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> +<reference xml:id="functions.zip" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Zip File Functions</title> - <titleabbrev>Zip</titleabbrev> - - <partintro> - <section xml:id="zip.intro"> - &reftitle.intro; - <para> - This extension enables you to transparently read or write ZIP compressed - archives and the files inside them. - </para> - </section> - - <section xml:id="zip.requirements"> - &reftitle.required; - <section xml:id="zip.requirements.old"> - <title>PHP 4</title> - <para> - The bundled PHP 4 version requires <link xlink:href="&url.zziplib;">ZZIPlib</link>, - by Guido Draheim, version 0.10.6 or later - </para> - </section> - - <section xml:id="zip.requirements.new"> - <title>PHP 5.2.0 or later</title> - <para> - This extension uses the functions of <link xlink:href="&url.zlib;">zlib</link> - by Jean-loup Gailly and Mark Adler. - </para> - </section> - </section> - - &reference.zip.configure; - - <section xml:id="zip.configuration"> - &reftitle.runtime; - &no.config; - </section> - - <section xml:id="zip.resources"> - &reftitle.resources; - <para> - There are two resource types used in the Zip module. The first one - is the Zip directory for the Zip archive, the second Zip Entry for - the archive entries. - </para> - </section> - - &reference.zip.constants; - - <section xml:id="zip.examples"> - &reftitle.examples; - <example> - <title>Create a Zip archive</title> - <programlisting role="php"> -<![CDATA[ -<?php - -$zip = new ZipArchive(); -$filename = "./test112.zip"; - -if ($zip->open($filename, ZIPARCHIVE::CREATE)!==TRUE) { - exit("cannot open <$filename>\n"); -} - -$zip->addFromString("testfilephp.txt" . time(), "#1 This is a test string added as testfilephp.txt.\n"); -$zip->addFromString("testfilephp2.txt" . time(), "#2 This is a test string added as testfilephp2.txt.\n"); -$zip->addFile($thisdir . "/too.php","/testfromfile.php"); -echo "numfiles: " . $zip->numFiles . "\n"; -echo "status:" . $zip->status . "\n"; -$zip->close(); -?> -]]> - </programlisting> - </example> - <example> - <title>Dump the archive details and listing</title> - <programlisting role="php"> -<![CDATA[ -<?php -$za = new ZipArchive(); - -$za->open('test_with_comment.zip'); -print_r($za); -var_dump($za); -echo "numFiles: " . $za->numFiles . "\n"; -echo "status: " . $za->status . "\n"; -echo "statusSys: " . $za->statusSys . "\n"; -echo "filename: " . $za->filename . "\n"; -echo "comment: " . $za->comment . "\n"; - -for ($i=0; $i<$za->numFiles;$i++) { - echo "index: $i\n"; - print_r($za->statIndex($i)); -} -echo "numFile:" . $za->numFiles . "\n"; -?> -]]> - </programlisting> - </example> - <example> - <title>Zip stream wrapper, read an OpenOffice meta info</title> - <programlisting role="php"> -<![CDATA[ -<?php -$reader = new XMLReader(); - -$reader->open('zip://' . dirname(__FILE__) . '/test.odt#meta.xml'); -$odt_meta = array(); -while ($reader->read()) { - if ($reader->nodeType == XMLREADER::ELEMENT) { - $elm = $reader->name; - } else { - if ($reader->nodeType == XMLREADER::END_ELEMENT && $reader->name == 'office:meta') { - break; - } - if (!trim($reader->value)) { - continue; - } - $odt_meta[$elm] = $reader->value; - } -} -print_r($odt_meta); -?> -]]> - </programlisting> - </example> - <para> - This example uses the old API (PHP 4), it opens a ZIP file - archive, reads each file in the archive and prints out its - contents. The <filename>test2.zip</filename> archive used in this - example is one of the test archives in the ZZIPlib source - distribution. - </para> - <example> - <title>Zip Usage Example</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> - </section> - </partintro> &reference.zip.functions.entities; </reference> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zlib/constants.xml?r1=1.6&r2=1.6.2.1&diff_format=u Index: phpdoc/en/reference/zlib/constants.xml diff -u phpdoc/en/reference/zlib/constants.xml:1.6 phpdoc/en/reference/zlib/constants.xml:1.6.2.1 --- phpdoc/en/reference/zlib/constants.xml:1.6 Wed Jun 20 22:25:40 2007 +++ phpdoc/en/reference/zlib/constants.xml Fri Nov 30 18:24:06 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<section xml:id="zlib.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.6.2.1 $ --> +<appendix xml:id="zlib.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> @@ -27,7 +27,7 @@ </listitem> </varlistentry> </variablelist> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zlib/reference.xml?r1=1.18.2.1&r2=1.18.2.2&diff_format=u Index: phpdoc/en/reference/zlib/reference.xml diff -u phpdoc/en/reference/zlib/reference.xml:1.18.2.1 phpdoc/en/reference/zlib/reference.xml:1.18.2.2 --- phpdoc/en/reference/zlib/reference.xml:1.18.2.1 Wed Oct 3 11:41:17 2007 +++ phpdoc/en/reference/zlib/reference.xml Fri Nov 30 18:24:06 2007 @@ -1,121 +1,12 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18.2.1 $ --> -<!-- Purpose: compression --> -<!-- Membership: bundled --> +<!-- $Revision: 1.18.2.2 $ --> - <reference xml:id="ref.zlib" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Zlib Compression Functions</title> - <titleabbrev>Zlib</titleabbrev> +<reference xml:id="functions.zlib" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Zlib Compression Functions</title> - <partintro> - <section xml:id="zlib.intro"> - &reftitle.intro; - <para> - This module enables you to transparently read and write - gzip (.gz) compressed files, through versions of most of - the <link linkend="ref.filesystem">filesystem</link> functions - which work with gzip-compressed files (and uncompressed files, - too, but not with sockets). - </para> - <note> - <para> - Version 4.0.4 introduced a fopen-wrapper for .gz-files, so that - you can use a special <filename>zlib:</filename> URL to access - compressed files transparently using the normal f*() file access - functions if you prefix the filename or path with - <filename>zlib:</filename> when calling <function>fopen</function>. This - feature requires a C runtime library that provides the - <literal>fopencookie()</literal> function. Up to now the GNU libc - seems to be the only library that provides this feature. - </para> - <para> - In PHP 4.3.0, <filename>zlib:</filename> has been changed to - <filename>compress.zlib://</filename> to prevent ambiguities with - filenames containing ':' characters. The - <literal>fopencookie()</literal> function is not longer required. - More information is available in the section about - <xref linkend="wrappers.compression" />. - </para> - </note> - </section> + &reference.zlib.functions.entities; - <section xml:id="zlib.requirements"> - &reftitle.required; - <para> - This module uses the functions of <link xlink:href="&url.zlib;">zlib</link> - by Jean-loup Gailly and Mark Adler. You have to use a zlib - version >= 1.0.9 with this module. - </para> - </section> - - &reference.zlib.configure; - - &reference.zlib.ini; - - <section xml:id="zlib.resources"> - &reftitle.resources; - <para> - This extension defines a file pointer resource returned by - <function>gzopen</function>. - </para> - </section> - - &reference.zlib.constants; - - <section xml:id="zlib.examples"> - &reftitle.examples; - <para> - This example opens a temporary file and writes a test string - to it, then it prints out the content of this file twice. - </para> - <example> - <title>Small Zlib Example</title> - <programlisting role="php"> -<![CDATA[ -<?php - -$filename = tempnam('/tmp', 'zlibtest') . '.gz'; -echo "<html>\n<head></head>\n<body>\n<pre>\n"; -$s = "Only a test, test, test, test, test, test, test, test!\n"; - -// open file for writing with maximum compression -$zp = gzopen($filename, "w9"); - -// write string to file -gzwrite($zp, $s); - -// close file -gzclose($zp); - -// open file for reading -$zp = gzopen($filename, "r"); - -// read 3 char -echo gzread($zp, 3); - -// output until end of the file and close it. -gzpassthru($zp); -gzclose($zp); - -echo "\n"; - -// open file and print content (the 2nd time). -if (readgzfile($filename) != strlen($s)) { - echo "Error with zlib functions!"; -} -unlink($filename); -echo "</pre>\n</body>\n</html>\n"; - -?> -]]> - </programlisting> - </example> - </section> - </partintro> - -&reference.zlib.functions.entities; - - </reference> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/lzf/book.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/lzf/book.xml +++ phpdoc/en/reference/lzf/book.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/lzf/constants.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/lzf/constants.xml +++ phpdoc/en/reference/lzf/constants.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/lzf/setup.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/lzf/setup.xml +++ phpdoc/en/reference/lzf/setup.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/phar/book.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/phar/book.xml +++ phpdoc/en/reference/phar/book.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/phar/constants.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/phar/constants.xml +++ phpdoc/en/reference/phar/constants.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/phar/setup.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/phar/setup.xml +++ phpdoc/en/reference/phar/setup.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/rar/book.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/rar/book.xml +++ phpdoc/en/reference/rar/book.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/rar/constants.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/rar/constants.xml +++ phpdoc/en/reference/rar/constants.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/rar/examples.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/rar/examples.xml +++ phpdoc/en/reference/rar/examples.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/rar/setup.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/rar/setup.xml +++ phpdoc/en/reference/rar/setup.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zip/book.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/zip/book.xml +++ phpdoc/en/reference/zip/book.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zip/examples.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/zip/examples.xml +++ phpdoc/en/reference/zip/examples.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zip/setup.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/zip/setup.xml +++ phpdoc/en/reference/zip/setup.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zlib/book.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/zlib/book.xml +++ phpdoc/en/reference/zlib/book.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zlib/examples.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/zlib/examples.xml +++ phpdoc/en/reference/zlib/examples.xml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/zlib/setup.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/zlib/setup.xml +++ phpdoc/en/reference/zlib/setup.xml