zip-php

 (.)

diff --git a/ChangeLog b/ChangeLog
index b3cb252638c63dce1d0baeacf6eb7c731568bf82..3bc955b335d68c359ab95bb8e4d17b00e886f9f1 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,6 @@
+2006-09-27
+ * adding docs/zip-php.htm integrating Chris Branch's mail into the docs
+       
 2006-09-26
  * adding docs/notes.htm - to register some old dicussions for later
        reference. Let's see how that fills up.

diff --git a/docs/Makefile.am b/docs/Makefile.am
index 5cf0dce880c73b0408b4a7df434b299a1fb59cfb..5b9e0bbd26c16bc46d1877dafc70ef8e637cd7cd 100644 (file)
--- a/docs/Makefile.am
+++ b/docs/Makefile.am
@@ -13,7 +13,7 @@ htm_FILES = zzip-index.htm zzip-zip.htm zzip-file.htm zzip-sdl-rwops.htm \
             64on32.htm future.htm fseeko.htm mmapped.htm memdisk.htm \
             configs.htm sfx-make.htm   developer.htm download.htm \
             history.htm referentials.htm  faq.htm copying.htm notes.htm \
-            functions.htm
+            functions.htm zip-php.htm
 SDL = @top_srcdir@/SDL
 SDL_RWOPS = $(SDL)/SDL_rwops_zzcat.c \
             $(SDL)/SDL_rwops_zzip.c $(SDL)/SDL_rwops_zzip.h

diff --git a/docs/Makefile.in b/docs/Makefile.in
index b66937330e0a120cf5579554b6eac140f0c7b506..fd5ce17ae9b3fb2a30c84d3055903eb7781e25f7 100644 (file)
--- a/docs/Makefile.in
+++ b/docs/Makefile.in
@@ -217,7 +217,7 @@ htm_FILES = zzip-index.htm zzip-zip.htm zzip-file.htm zzip-sdl-rwops.htm \
             64on32.htm future.htm fseeko.htm mmapped.htm memdisk.htm \
             configs.htm sfx-make.htm   developer.htm download.htm \
             history.htm referentials.htm  faq.htm copying.htm notes.htm \
-            functions.htm
+            functions.htm zip-php.htm
 
 SDL_RWOPS = $(SDL)/SDL_rwops_zzcat.c \
             $(SDL)/SDL_rwops_zzip.c $(SDL)/SDL_rwops_zzip.h

diff --git a/docs/body.htm b/docs/body.htm
index 2729c427230b7d64b43bc5c93712633a22ecb839..ed45f5fbb27e5d96dc4a678e45af2896e8c5c3a5 100644 (file)
--- a/docs/body.htm
+++ b/docs/body.htm
@@ -63,6 +63,7 @@
 <br>&nbsp;
 <br><small><a href="faq.html"> faq </a></small>
 <small><><a href="notes.html"> notes </a></small>
+<small><><a href="zip-php.html"> zip-php </a></small>
 <hr><a href="download.html"> Download Area </a>
 <br><><a href="developer.html"> Developer Area </a>
 <br><><a href="http://sourceforge.net/projects/zziplib"> Sourceforge Project</a>

diff --git a/docs/zip-php.htm b/docs/zip-php.htm
new file mode 100644 (file)
index 0000000..0416667
--- /dev/null
+++ b/docs/zip-php.htm
@@ -0,0 +1,63 @@
+<H2> PHP-ZIP Installation </H2>
+
+<P>
+  There have been many problems about the installation of the php-zip
+  module. Since Mid of 2006 the php-zip module does not require the
+  zziplib anymore - it uses its own implementation (which is a clean
+  approach in a double sense - there are no source code comments).
+  So, the following might possibly be only relevant for older
+  installations.
+</P>
+
+<P> Chris Branch has been kind enough to jot down the points of a
+    successful php-zip installation sending it to me in May 2006.
+    I am quoting his text verbatim - again, I do not know whether
+    it works or not as I am not using any PHP for real work.
+</P>
+
+<hr width="60%" align="center">
+<DL>
+<DT> Software Packages </DT>
+<dd><ul>
+<li> Apache 2.4.21 (Linux) </li>
+<li> PHP 4.3.9 </li>
+<li> ZZIPLIB 0.10.82 </li>
+<li> Special requirement: static linking
+</ul></dd>
+<DT> Setting up ZZIPLIB </DT>
+<dd><ul>
+<li> Extract files from zziplib-0.10.82.tar.bz2 to a new folder. </li>
+<li> ./configure --enable-static </li>
+<li> make </li>
+<li> make install </li>
+</ul></dd>
+<DT> Rebuilding PHP to include ZIP support </DT>
+<dd><ul>
+<li> Modify PHP build file and add "--with-zip" 
+[no dir needed because default /usr/local on my machine] </li>
+<li> make </li>
+<li> make install </li>
+</ul></dd>
+<DT> Modifying the Apache Installation </DT>
+<dd><ul>
+<li> Change to Apache source code directory </li>
+<li> Change to "src" subdirectory and edit existing Makefile.  [***]
+<br> Add: EXTRA_LIBS=/usr/local/lib/libzzip.a </li>
+<li> Change back to parent folder (cd ..) </li>
+<li> make </li>
+<li> /usr/local/etc/httpd/bin/apachectl stop </li>
+<li> make install </li>
+<li> /usr/local/etc/httpd/bin/apachectl start </li>
+</ul></dd>
+</DL>
+
+<p><b>[***] Note:</b>
+That step is the critical step that's not obvious.  Apparently,
+when you build PHP as a static library and include the "--with-zip"
+option, it creates a static library for PHP with an external dependency on
+zziplib.a.  However, the Apache configure script and resulting Makefile
+doesn't take this into account, so Apache won't link unless you hand-edit
+the Apache Makefile.  (Maybe there's a better place to make this change so
+that you don't have to re-fix Apache's Makefile each time you run Apache's
+./configure.  However, I didn't spend the time to investigate that).
+</p>