Installing PHP 4 as a
Dynamic Module

NOTE: PHP4 has a large list of known bugs. Please consult the PHP Bug Reporting list if you are finding strange behavior from your PHP4 modules. Some of the more apparent bugs involve multiple file uploads, url rewriting during session handling, and occasional zombies using backtick execution. If any of your existing PHP3 applications rely on some of these features, be sure to test them before making a full commitment to PHP4.

1. Install the PHP 4 dynamic modules on your Virtual Server.
   
   
   % vinstall php4-dso
   
   The dynamic module PHP4 installation does not include a PHP configuration file (php.ini). Only the CGI installation (below) includes the configuration file.
   
   
2. Add the following line to the top of your Virtual Server web server configuration file (~/www/conf/httpd.conf) to dynamically load the PHP 4 dynamic module. Substitute the name of the dynamic module you want to install for MODULE-NAME.
   
   
   LoadModule php4_module modules/MODULE-NAME
   
   Currently, these PHP4 dynamic modules are available:
   

   No database support
   mod_php4-4.0.0-module.so
   mod_php4-4.0.0-module-imap.so
   mod_php4-4.0.0-module-ftp-imap-freetype-gd.so
   mod_php4-4.0.0-module-mcrypt-freetype-gd.so
   mod_php4-4.0.0-module-mcrypt-ftp-imap-freetype-gd-xml.so
   mod_php4-4.0.0-module-mcrypt-ftp-imap.so
   
   mSQL database support
   mod_php4-4.0.0-module-msql.so
   mod_php4-4.0.0-module-msql-imap.so
   mod_php4-4.0.0-module-msql-ftp-imap-freetype-gd.so
   mod_php4-4.0.0-module-msql-mcrypt-freetype-.so
   mod_php4-4.0.0-module-msql-mcrypt-ftp-imap-freetype-gd-xml.so
   mod_php4-4.0.0-module-msql-mcrypt-ftp-imap.so
   
   MySQL database support
   mod_php4-4.0.0-module-mysql.so
   mod_php4-4.0.0-module-mysql-imap.so
   mod_php4-4.0.0-module-mysql-ftp-imap-freetype-gd.so
   mod_php4-4.0.0-module-mysql-mcrypt-freetype-gd.so
   mod_php4-4.0.0-module-mysql-mcrypt-ftp-imap-freetype-gd-xml.so
   mod_php4-4.0.0-module-mysql-mcrypt-ftp-imap.so
   
   PostgreSQL database support
   mod_php4-4.0.0-module-pgsql.so
   mod_php4-4.0.0-module-pgsql-imap.so
   mod_php4-4.0.0-module-pgsql-ftp-imap-freetype-gd.so
   mod_php4-4.0.0-module-pgsql-mcrypt-freetype-gd.so
   mod_php4-4.0.0-module-pgsql-mcrypt-ftp-imap-freetype-gd-xml.so
   mod_php4-4.0.0-module-pgsql-mcrypt-ftp-imap.so

3. Make the following additions and modifications to your Virtual Server web server configuration file (~/www/conf/httpd.conf).
   
   
   1. Modify the DirectoryIndex line so that PHP 4 files will be included as directory indices.
      

       DirectoryIndex index.php index.php4 index.php3 index.cgi index.html index.htm

   2. Add the following lines so that all files with .php, .php3, .php4, and .phtml extensions will be redirected to the PHP 4 dynamic module.
      
      
      AddType application/x-httpd-php .php .php3 .php4
AddType application/x-httpd-php-source .phps


      If you want to run PHP 3 and PHP 4 concurrently, add the following lines instead of those above.
      
      
      AddType application/x-httpd-php3 .php3
AddType application/x-httpd-php .php .php4
AddType application/x-httpd-php-source .phps