Installing PHP from source on Debian

This page lists common error messages and their solution when installing php from source on Debian.

Apache handler

apxs not found

Solution

 aptitude install apache2-prefork-dev

bzip2

Solution

libbz2 + libbz2-dev

IMAP and SSL

configure:46794: checking for IMAP support
configure:46841: checking for IMAP Kerberos support
configure:46867: checking for IMAP SSL support
configure:47275:19: error: /mail.h: No such file or directory

Solution

aptitude install libc-client-dev

Installing PHP with apxs

apxs:Error: Activation failed for custom /etc/apache2/httpd.conf file..
apxs:Error: At least one `LoadModule' directive already has to exist..
make: *** [install-sapi] Error 1

Original Solution

See Debian bug #231134

Edit /etc/apache2/httpd.conf and add

#LoadModule dummy_module /usr/lib/apache2/modules/mod_dummy.so

Current Solution on Ubuntu

This issue is in the process of being fixed (Ubuntu bug #500703). Until then, add the configuration files manually and force the install to continue.

Edit /etc/apache2/mods-available/php5.load and add:

LoadModule php5_module /usr/lib/apache2/modules/libphp5.so

Edit /etc/apache2/mods-available/php5.conf and put in:

<IfModule mod_php5.c>
  AddType application/x-httpd-php .php
  AddType application/x-httpd-php-source .phps
</IfModule>

During the make install step, use the -k flag. The -k flag means “keep going when some targets can't be made.” The output will still show the apxs error, but the installation should work. Do keep an eye out for other compile errors.

make install -k

Then enable the php5 module and restart Apache:

a2enmod php5
/etc/init.d/apache2 restart