PHP Manual
Prev | Chapter 2. Installation | Next

# Servers-Apache

This section contains notes and hints specific to Apache installs of PHP, both for Unix and Windows versions.

## Details of installing PHP with Apache on Unix

You can select arguments to add to the configure on line 8 below from the Complete list of configure options.

Example 2-5. Installation Instructions (Apache Module Version)
    1.  gunzip apache_1.3.x.tar.gz
    2.  tar xvf apache_1.3.x.tar
    3.  gunzip php-x.x.x.tar.gz
    4.  tar xvf php-x.x.x.tar
    5.  cd apache_1.3.x
    6.  ./configure --prefix=/www
    7.  cd ../php-x.x.x
    8.  ./configure --with-mysql --with-apache=../apache_1.3.x --enable-track-vars
    9.  make
    10. make install
    11. cd ../apache_1.3.x
    12. for PHP 3: ./configure --activate-module=src/modules/php3/libphp3.a
        for PHP 4: ./configure --activate-module=src/modules/php4/libphp4.a
    13. make
    14. make install

      Instead of this step you may prefer to simply copy the httpd binary
      overtop of your existing binary.  Make sure you shut down your
      server first though.

    15. cd ../php-x.x.x
    16. for PHP 3: cp php3.ini-dist /usr/local/lib/php3.ini
        for PHP 4: cp php.ini-dist /usr/local/lib/php.ini

      You can edit your .ini file to set PHP options.  If
      you prefer this file in another location, use
      --with-config-file-path=/path in step 8.

    17. Edit your httpd.conf or srm.conf file and add:

         For PHP 3:   AddType application/x-httpd-php3 .php3
         For PHP 4:   AddType application/x-httpd-php .php

      You can choose any extension you wish here.  .php is simply the one
      we suggest. You can even include .html .

    18. Use your normal procedure for starting the Apache server. (You must
        stop and restart the server, not just cause the server to reload by
        use a HUP or USR1 signal.)

Depending on your Apache install and Unix variant, there are many possible ways to stop and restart the server. Below are some typical lines used in restarting the server, for different apache/unix installations. You should replace `/path/to/` with the path to these applications on your systems.

    1. Several Linux and SysV variants:
    /etc/rc.d/init.d/httpd restart

    2. Using apachectl scripts:
    /path/to/apachectl stop
    /path/to/apachectl start

    3. httpdctl and httpsdctl (Using OpenSSL), similar to apachectl:
    /path/to/httpsdctl stop
    /path/to/httpsdctl start

    4. Using mod_ssl, or another SSL server, you may want to manually
    stop and start:
    /path/to/apachectl stop
    /path/to/apachectl startssl

The locations of the apachectl and http(s)dctl binaries often vary. If your system has `locate` or `whereis` or `which` commands, these can assist you in finding your server contrl programs.

Different examples of compiling PHP for apache are as follows:

    ./configure --with-apxs --with-pgsql

This will create a `libphp4.so` shared library that is loaded into Apache using a LoadModule line in Apache's `httpd.conf` file. The PostgreSQL support is embedded into this `libphp4.so` library.

    ./configure --with-apxs --with-pgsql=shared

This will again create a `libphp4.so` shared library for Apache, but it will also create a `pgsql.so` shared library that is loaded into PHP either by using the extension directive in `php.ini` file or by loading it explicitly in a script using the dl() function.

    ./configure --with-apache=/path/to/apache_source --with-pgsql

This will create a `libmodphp4.a` library, a `mod_php4.c` and some accompanying files and copy this into the `src/modules/php4` directory in the Apache source tree. Then you compile Apache using `--activate-module=src/modules/php4/libphp4.a` and the Apache build system will create `libphp4.a` and link it statically into the `httpd` binary. The PostgreSQL support is included directly into this `httpd` binary, so the final result here is a single `httpd` binary that includes all of Apache and all of PHP.

    ./configure --with-apache=/path/to/apache_source --with-pgsql=shared

Same as before, except instead of including PostgreSQL support directly into the final `httpd` you will get a `pgsql.so` shared library that you can load into PHP from either the `php.ini` file or directly using dl().

When choosing to build PHP in different ways, you should consider the advantages and drawbacks of each method. Building as a shared object will mean that you can compile apache separately, and don't have to recompile everything as you add to, or change, PHP. Building PHP into apache (static method) means that PHP will load and run faster. For more information, see the Apache webpage on DSO support.

## Installing PHP on Windows with Apache 1.3.x

There are two ways to set up PHP to work with Apache 1.3.x on Windows. One is to use the CGI binary (php.exe), the other is to use the Apache module dll. In either case you need to stop the Apache server, and edit your `srm.conf` or `httpd.conf` to configure Apache to work with PHP.

Although there can be a few variations of configuring PHP under Apache, these are simple enough to be used by the newcomer. Please consult the Apache Docs for further configuration directives.

If you unziped the PHP package to c:\php\ as described in the Manual Installation Steps section, you need to insert these lines to your Apache configuration file to set up the CGI binary:

- `ScriptAlias /php/ "c:/php/"`

- `AddType application/x-httpd-php .php .phtml`

- `Action application/x-httpd-php "/php/php.exe"`

Note that the second line in the list above can be found in the actual versions of `httpd.conf`, but it is commented out. After changing the configuration file, remember to restart the server, for example, `NET STOP APACHE` followed by `NET START APACHE`, if you run Apache as a Windows Service, or use your regular shortcuts.

If you would like to use PHP as a module in Apache, be sure to move `php4ts.dll` to the windows/system (for Windows 9x/Me) or winnt/system32 (for Windows NT/2000/XP) directory, overwriting any older file. Then you should add the following two lines to you Apache conf file:

- `LoadModule php4_module c:/php/sapi/php4apache.dll`

- `AddType application/x-httpd-php .php .phtml`

> Note: In Apache 1.3.22 for Windows, the default configuration file (`httpd.conf-dist-win`) has a `ClearModuleList` directive included by default. If this directive is used, it is required to put an `AddModule mod_php4.c` to the `AddModule` list, as else PHP will not be registered as an Apache module.

To use the source code highlighting feature, simply create a PHP script file and stick this code in: `<?php show_source ("original_php_script.php"); ?>`. Substitute `original_php_script.php` with the name of the file you wish to show the source of. (This is the only way of doing this, as there is no .phps like feature on Windows).

> Note: On Win-Apache all backslashes in a path statement such as "c:\directory\file.ext", must be converted to forward slashes, as "c:/directory/file.ext".

Prev | Home | Next
Installation on Windows systems | Up | Servers-CGI/Commandline