php-src/sapi/servlet
Sascha Schumann 953fe189da Overall UNIX build system improvements:
* Makefile header is now completely dynamic
* Absolute paths in (top_)?(src|build)dir and VPATH
  (fixes Tru64 support)
* VPATH does not contain variables anymore
  (fixes UnixWare support)
2000-04-30 03:20:09 +00:00
..
config.m4 fix typo: wrong variable name 2000-04-05 12:15:57 +00:00
cookies.php Both PHP and Java can't read Post data - let java do it and reconstruct for 2000-03-09 13:07:25 +00:00
date.php Improved handing of instances of private classes. Added servlet examples. 2000-02-28 17:02:28 +00:00
formatter.java Add support for PHP syntax highlighting 2000-03-05 21:35:24 +00:00
jinfo.php Improved handing of instances of private classes. Added servlet examples. 2000-02-28 17:02:28 +00:00
jver.php Improved handing of instances of private classes. Added servlet examples. 2000-02-28 17:02:28 +00:00
Makefile.in Overall UNIX build system improvements: 2000-04-30 03:20:09 +00:00
README Improved handing of instances of private classes. Added servlet examples. 2000-02-28 17:02:28 +00:00
reqheaders.php Cleanup 2000-03-06 13:19:58 +00:00
reqinfo.php Cleanup 2000-03-06 13:19:58 +00:00
reqparams.php Cleanup 2000-03-06 13:19:58 +00:00
servlet.c Eliminate warning if virtual cwd is specified 2000-04-11 00:30:33 +00:00
servlet.dsp support non-debug builds 2000-03-26 20:24:55 +00:00
servlet.java Oops - remove debug statement 2000-04-13 19:05:01 +00:00
sessions.php match changes to Tomcat example 2000-04-13 19:02:40 +00:00
web.xml Add support for PHP syntax highlighting 2000-03-05 21:35:24 +00:00

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) 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