[svn:PHP-Sandwich] r1448 - PHP-Sandwich/trunk

Author: gschlossnagle
Date: Mon Aug  1 19:09:14 2005
New Revision: 1448

Modified:
   PHP-Sandwich/trunk/README
Log:
a better howto


Modified: PHP-Sandwich/trunk/README
==============================================================================
--- PHP-Sandwich/trunk/README	(original)
+++ PHP-Sandwich/trunk/README	Mon Aug  1 19:09:14 2005
@@ -1,17 +1,60 @@
-PHP/Sandwich version 0.01
-=========================
+PHP::Interpreter version 1.0
+============================
 
 This module provides a way to load a PHP interpreter into your Perl programs.
 The PHP interpreter then automagically has access to all of the modules and
 variables loaded into Perl. So PHP executed from Perl can use any Perl
 modules.
 
-BUILD INSTRUCTIONS
-==================
+CAPABILITIES MATRIX
+===================
 
-1) Apply stuff/TSRM.patch to a PHP 5.x source tree (patch is now present
-   in PHP CVS HEAD, so you can just grab a snapshot from snaps.php.net)
-2) Build/install PHP with --enable-maintainer-zts and --enable-embed 
-3) Build/Install PHP sources HERE.  See non-tests in t/ for examples.
+PHP::Interpreter supports both PHP 5.0 and PHP 5.1.  In PHP 5.1 you have the
+possibility of instantiating multiple simultaneous PHP interpeters in a 
+single process.  In PHP 5.0, the PHP interpreter is effectively a singleton.
 
+BUILD INSTRUCTIONS (PHP 5.0.x)
+==============================
 
+1) Download the PHP sources from php.net
+2) tar zxf php-5.0.x.tar.gz
+3) cd php-5.0.x
+4) ./configure --enable-embed [any other options you want]
+5) make
+6) make install
+7) install PHP::Interpreter
+8) ...
+9) profit!
+
+BUILD INSTRUCTIONS (PHP 5.1.x - WITHOUT MULTIPLICITY)
+=====================================================
+
+1) Download the PHP sources from php.net
+2) tar zxf php-5.1.x.tar.gz
+3) cd php-5.1.x
+4) ./configure --enable-embed [any other options you want]
+5) make
+6) make install
+7) install PHP::Interpreter
+8) ...
+9) profit!
+
+BUILD INSTRUCTIONS (PHP 5.1.x - WITH MULTIPLICITY)
+==================================================
+
+1) Download the PHP sources from php.net
+2) tar zxf php-5.1.x.tar.gz
+3) cd php-5.1.x
+4) ./configure --enable-embed --enable-maintainer-zts [any other options you want]
+5) make
+6) make install
+7) install PHP::Interpreter
+8) ...
+9) profit!
+
+HOW TO USE PHP::Interpreter
+===========================
+
+The two best methods are:
+1) perldoc PHP::Interpreter
+2) read the tests in t/*.t