php-src/sapi/servlet

What is PHP4 sapi/servlet?

   PHP4 sapi/servlet builds upon the mechanism defined by ext/java to enable
   the entire PHP processor to be run as a servlet.  The primary advanatage
   of this from a PHP perspective is that web servers which support servlets
   typically take great care in pooling and reusing JVMs.

   Notes:

     1) While this code is intended to be able to run on any servlet engine,
        it has only been tested on Apache's Jakarta/tomcat to date.  Bug
        reports, success stories and/or patches required to get this code
        to run on other engines would be appreciated.

     2) This code clean compiles on Win32 and Linux, and is able to process
        phpinfo() commands.  Most of the code is in place, but very little
        testing has been done on even such basic things as cookies and
        sessions.  Treat this code as early alpha at this point.

     3) Until overload resolution is addressed in php/java, much of the
        javax.servlet interfaces can not be directly called.  For example,
        don't try to get the output stream from $response, and expect to
        be able to use println.  For now, use PHP's "echo" instead.

     4) PHP has a habit of changing the working directory.  Sapi/servlet will
        eventually change it back, but while PHP is running the servlet engine
        may not be able to load any classes from the CLASSPATH which are
        specified using a relative directory syntax, or find the work directory
        used for administration and JSP compilation tasks.

Build and execution instructions:

  Most of the configuration hassles associated with ext/java are associated
  with starting the JVM, and as such do not apply to sapi/servlet.  In
  particular, no updates to php.ini are required on any operating system.

  Unix:
    Build:
      ./configure --with-servlet --with-java
    Execute:
      add phpsrvlet.jar to CLASSPATH
      add directory containing libphp4.so to LD_LIBRARY_PATH
      merge/overwrite build/tomcat/examples/WEB-INF/web.xml from sapi/servlet

  Win32:
    Build:
      add jdsk (or d:\build\tomcat\classes) to CLASSPATH
      build sapi\servlet\servlet.dsp
    Execute:
      add phpsrvlet.jar to CLASSPATH
      add directory containing php4ts.dll and phpsrvlt.dll to PATH
      merge/overwrite build\tomcat\examples\WEB-INF\web.xml from sapi\servlet