Return to README CVS log

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

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

1.1       misho       1: WHAT IS THIS?
                      2: 
                      3:     This module exploits the layered I/O support in Apache 2.0.
                      4: 
                      5: HOW DOES IT WORK?
                      6:     
                      7:     In Apache 2.0, you have handlers which generate content (like
                      8:     reading a script from disk). The content goes then through
                      9:     a chain of filters. PHP can be such a filter, so that it processes
                     10:     your script and hands the output to the next filter (which will
                     11:     usually cause a write to the network).
                     12: 
                     13: DOES IT WORK?
                     14: 
                     15:     It is experimental as interfaces in Apache 2.0 might change in the
                     16:     future.
                     17: 
                     18: HOW TO INSTALL
                     19: 
                     20:     This SAPI module is known to work with Apache 2.0.40.
                     21: 
                     22:         $ cd apache-2.x
                     23:         $ cd src
                     24:         $ ./configure --enable-so
                     25:         $ make install
                     26: 
                     27:     For testing purposes, you might want to use --with-mpm=prefork.
                     28:     (Albeit PHP also works with threaded MPMs.)
                     29: 
                     30:     Configure PHP 4:
                     31: 
                     32:         $ cd php-4.x
                     33:         $ ./configure --with-apxs2=/path/to/apache-2.0/bin/apxs
                     34:         $ make install
                     35:    
                     36:     At the end of conf/httpd.conf, add:
                     37: 
                     38:         AddType application/x-httpd-php .php
                     39: 
                     40:     If you would like to enable source code highlighting functionality add:
                     41:     
                     42:         AddType application/x-httpd-php-source .phps
                     43:     
                     44:     That's it. Now start bin/httpd.
                     45: 
                     46: HOW TO CONFIGURE
                     47: 
                     48:     The Apache 2.0 PHP module supports a new configuration directive that
                     49:     allows an admin to override the php.ini search path. For example,
                     50:     place your php.ini file in Apache's ServerRoot/conf directory and
                     51:     add this to your httpd.conf file:
                     52: 
                     53:         PHPINIDir "conf"
                     54: 
                     55: DEBUGGING APACHE AND PHP
                     56:     
1.1.1.2 ! misho      57:     To debug Apache, we recommend:
1.1       misho      58: 
                     59:         1. Use the Prefork MPM (Apache 1.3-like process model) by
                     60:            configuring Apache with '--with-mpm=prefork'.
                     61:         2. Start httpd using -DONE_PROCESS (e.g. (gdb) r -DONE_PROCESS).
                     62: 
                     63:     If you want to debug a part of the PHP startup procedure, set a 
                     64:     breakpoint on 'load_module'. Step through it until apr_dso_load() is 
                     65:     done. Then you can set a breakpoint on any PHP-related symbol.
                     66: 
                     67: TODO
                     68: 
                     69:     PHP functions like apache_sub_req (see php_functions.c)
                     70:     Protocol handlers
                     71:     Passing script data to engine without temporary file