Return to README CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / php / sapi / thttpd

Annotation of embedaddon/php/sapi/thttpd/README, revision 1.1.1.2

1.1       misho       1: README FOR THTTPD MODULE (by Sascha Schumann)        
1.1.1.2 ! misho       2: ($Date$)
1.1       misho       3: 
                      4:        This is a SAPI module for PHP 4.x supporting thttpd, the tiny,
                      5:        turbo, throttling HTTP server by Jef Poskanzer.
                      6: 
                      7:        NOTE: All HTTP requests will be serialized. That means, one long running
                      8:              script will block all other requests. Choose another web server,
                      9:              if you want to execute arbitrarily long running scripts.
                     10: 
                     11:        The module contains a patch against version 2.21b of thttpd. The patch
                     12:        fixes a number of bugs and adds some functionality:
                     13: 
                     14:        - HTTP/1.1 Persistent Connection/Pipeline Support
                     15:        - PHP Scripting (**.php by default)
                     16:        - Highlighting PHP Scripts (**.phps by default)
                     17:        - Fast Accept Loop (unique to PHP)
                     18:        - Periodic Connection Expiring (unique to PHP)
                     19:        - Log to stdout (logfile=-)
                     20:        - Fixes the Host: header vulnerability (affects vhosts only)
                     21:        - Asynchronous request body handling (e.g. for POSTs)
                     22:        - Accept filter for Linux
                     23:        - Fix for non-blocking sending of thttpd-generated responses
                     24: 
                     25:        You can configure the filename extensions by creating a config file for
                     26:        thttpd and setting these entries:
                     27: 
                     28:        phppat=PATTERN
                     29:        phpspat=PATTERN
                     30: 
                     31:        The PATTERN has the same format as defined here:
                     32: 
                     33:                http://acme.com/software/thttpd/options.html#CGI_PATTERN
                     34: 
                     35:        "**.php" means: match any file ending in .php in any directory.
                     36:        Setting the pattern from the command line is not supported.
                     37: 
                     38:        NOTE: This version supports *only* thttpd 2.21b, no prior or later
                     39:        version.
                     40: 
                     41:        This is a functional and stable module (it runs a large application
                     42:        like IMP 2.2.0 without any problems). Its original intention was to
                     43:        demonstrate the ability of PHP to work in every web server environment.
                     44: 
                     45: REQUIRED DOWNLOADS
                     46: 
                     47:        1. thttpd 2.21b (2.20 or +2.22beta will _not_ work)
                     48:           
                     49:           Full Distribution:
                     50:           http://www.acme.com/software/thttpd/thttpd-2.21b.tar.gz
                     51:           
                     52:        2. PHP 4.x
                     53:           
                     54:           Download:
                     55:           http://www.php.net/
                     56:           
                     57:           Snapshots from CVS:
                     58:           http://snaps.php.net/
                     59: 
                     60: 
                     61: BUILD INSTRUCTIONS
                     62: 
                     63:        1. Extract software packages
                     64: 
                     65:           $ gunzip -c thttpd-2.xx.tar.gz | tar xf -
                     66:           $ gunzip -c php-*.tar.gz | tar xf -
                     67: 
                     68:        2. Prepare PHP
                     69: 
                     70:           $ cd php-*
                     71:           $ ./configure \
                     72:                        --with-thttpd=../thttpd-2.xx \
                     73:                        <further PHP options>
                     74:           $ make install
                     75:           $ cd ..
                     76:        
                     77:           You can see the list of valid PHP options by executing
                     78: 
                     79:           $ ./configure --help
                     80: 
                     81:        3. Configure, compile, install thttpd
                     82: 
                     83:           Now follow the thttpd instructions. The Makefile template of
                     84:           thttpd was changed to automatically use the components
                     85:           required by PHP.