The mod_php Apache Module

The best way to use PHP with your Virtual Private Server is as an Apache Module. Alternately, the PHP CGI is available for those who need command-line access to PHP.

NOTE: Any version of PHP prior to 4.2.2 has a known security vulnerability which can compromise your Virtual Private Server. If you are using any version prior to PHP4.2.2, we strongly encourage you to upgrade to the current version.

PHP3

PHP3 is an older version of PHP, available as an Apache Module on FreeBSD Virtual Private Servers for legacy purposes.

NOTE: Most PHP3 scripts should work properly with PHP4. If you have PHP3 scripts that don't work in PHP4, however, a few PHP3 apache modules are available on FreeBSD Virtual Private Servers.

See mod_php3 for instructions on installing and using the PHP3 Apache module on your Virtual Private Server

PHP4

PHP4 is the latest version of PHP and offers improved performance, scalability, features, and extensibility over previous versions.

NOTE: PHP no longer creates GIF images via lib-gd. Due to patent restrictions on the GIF compression algorithm we can no longer support it. The PNG Image Format has support for alpha channels, gamma correction, has better compression than GIF compression and supports 48-bit color depth (versus 8-bit color GIF images), and is now widely supported by nearly all modern web browsers.

To install mod_php4 on your Virtual Private Server, connect to your server via SSH or Telnet and do the following:

Install the PHP4 Apache module by running the following command:
```
% vinstall php4-dso
```
When you run the vinstall command, you will be given the option to select which extensions you want to use. In order to not waste memory on your Virtual Private Server, we recomend that you only select extensions you will actually be using. If you find you need to add or remove extensions at a later time, you can manually edit the php.ini file, or use the vinstall command to change the active extensions.

The installation process should configure your web server to dynamically load the PHP4 Apache module. Check to make sure the following line is in your web server configuration file (~/www/conf/httpd.conf).

LoadModule  php4_module  modules/mod_php4-4.3.0.so

NOTE: In versions of PHP4.2.2 and later, one of the default settings has been changed. This has been found to affect several commonly used scripts, including TWIG. If you are using TWIG or are having trouble with scripts that worked without problems prior to upgrading to version 4.2.2, create or edit the file named php.ini in the ~/usr/local/lib/ directory of your Virtual Private Server. The php.ini file needs to contain at least this line:

register_globals = On

Check to see that the following additions and modifications have been made to your web server configuration file (~/www/conf/httpd.conf). If the vinstall script failed to make the appropriate changes, you will need to do so yourself.
1. Modify the DirectoryIndex line so that PHP4 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 PHP4 Apache module.
```
AddType application/x-httpd-php .php .php3 .php4 .phtml
AddType application/x-httpd-php-source .phps
```
Restart Your Web Server.
To test your PHP installation, try creating the following ~/www/htdocs/test.php4 document and viewing it in your web browser.
```
<HTML>
<BODY>
<?php
  phpinfo();
?>
</BODY>
</HTML>
```
The phpinfo() function reports the version number, as well as the features that are compiled into PHP.