Custom PHP 5.3.1 with APC and XDEBUG on (Dreamhost) Shared Host

I’ve recently been setting up my new dreamhost for symfony projects deployment and the only thing the default PHP is missing is the support for APC (alternate php cache). So after looking at the dreamhost wiki I cleaned up and added some features to the one of the install scripts. Here it is for your/mine (future) commodity.

#!/bin/sh
# update 16.2.2010
# @author Marco Bernasocchi 
# - Added OPENSSL LIBMCRYPT LIBTOOL and a promt for installing XDEBUG
#   (still uses XDEBUG 2.05, which has basic PHP 5.3.1 support. 2.1.0 is on its way)
# - removed unsupported php configure switches
# - disabled --with-xsl, if you want to use it you'll probably need to install
#   libxslt (http://xmlsoft.org/XSLT/) version 1.1.0 or greater.
# - sets the ini files into the install directory instead than on cgi-bin
# - to add more domains just copy the cgi binary to the new domain
#   cp "$PHP_BIN_DIR/php-cgi" "$NEW_CGI_BIN_DIR/php.cgi" and modifiy the .htaccess
#Script for a minimal PHP 5.3.x install with APC
#
#- Prompts for the domain to build for
#- PHP configure line contains only valid PHP5 options
#- Displays colourful status messages
#- Many build messages, which aren't helpful to most people, are now suppressed
#- Procedurised, making it cleaner and easier to follow
#
#The only things you may want to change in here are marked with "@todo"s
#
#Derived form the original PHP 5.3 install script at
#http://wiki.dreamhost.com/Installing_PHP5
#
#@author Dan Bettles 
#Exit on error
set -e
clear
echo -n "Enter the domain for which you want to build PHP and press [ENTER]: "
read DOMAIN
echo -n "Enable XDEBUG (y|n): "
read ENABLEXDEBUG
#===============================================================================
#@todo Update versions, if necessary
M4="m4-1.4.13"
AUTOCONF="autoconf-2.65"
OPENSSL="openssl-0.9.8l"
CURL="curl-7.20.0"
LIBMCRYPT="libmcrypt-2.5.8"
LIBTOOL="libtool-2.2.6b"
PHP="php-5.3.1"
APC="APC-3.1.3p1"
XDEBUG="xdebug-2.0.5"
#@todo Update install paths, if necessary
WEB_ROOT="$HOME/$DOMAIN/web"
CGI_BIN_DIR="$WEB_ROOT/cgi-bin"
HTACCESS="$WEB_ROOT/.htaccess"
INSTALL_DIR="$HOME/mycompiles"
BUILD_DIR="$INSTALL_DIR/build"
DOWNLOADS_DIR="$INSTALL_DIR/downloads"
PHP_BASE_DIR="$INSTALL_DIR/$PHP"
PHP_BIN_DIR="$PHP_BASE_DIR/bin"
PHP_EXTENSIONS_DIR="$PHP_BASE_DIR/extensions"
PHP_CONFIG_DIR="$PHP_BASE_DIR/etc/php5/config"
PHP_INI="$PHP_CONFIG_DIR/php.ini"
#@todo Alter features, if necessary
PHP_FEATURES="--prefix=$PHP_BASE_DIR
 --with-config-file-path=$PHP_CONFIG_DIR
 --with-config-file-scan-dir=$PHP_CONFIG_DIR
 --bindir=$PHP_BIN_DIR
 --enable-zip
 --with-xmlrpc
 --with-freetype-dir=/usr
 --with-zlib-dir=/usr
 --with-jpeg-dir=/usr
 --with-png-dir=/usr
 --with-curl=$PHP_BASE_DIR
 --with-gd
 --enable-gd-native-ttf
 --enable-ftp
 --enable-exif
 --enable-sockets
 --enable-wddx
 --enable-sqlite-utf8
 --enable-calendar
 --enable-mbstring
 --enable-mbregex
 --enable-bcmath
 --with-mysql=/usr
 --with-mysqli
 --without-pear
 --with-gettext
 --with-pdo-mysql
 --with-openssl=$PHP_BASE_DIR
 #--with-xsl=$=$PHP_BASE_DIR
 --with-mcrypt=$PHP_BASE_DIR"
#===============================================================================
#@param string $1 Message
function echoL1 () {
    echo -e "n33[1;37;44m$133[0;0;0mn"
}
#@param string $1 Message
function echoL2 () {
    echo -e "n33[0;37;44m$133[0;0;0mn"
}
#@param string $1 URL
#@param string $2 Output directory
function downloadTo () {
    wget -c $1 --directory-prefix=$2
}
#@param string $1 TAR filename
#@param string $2 Output directory
function untarTo () {
    cd $2
    tar -xzf $1
    cd -
}
#@param string $1 Source directory
#@param string $2 Output directory
#@param string $3 configure arguments
function configureAndMake () {
    cd $1
    COMMAND="./configure --quiet --prefix=$2 $3"
    if [ $1 = "$BUILD_DIR/$OPENSSL" ];then
      #special command for OPEN SSL
      COMMAND="./config --prefix=$2 $3"
    fi
    echo "$COMMAND"
    eval $COMMAND
    make --quiet
    cd -
}
#@param string $1 Source directory
#@param string $2 Output directory
#@param string $3 configure arguments
function makeAndInstall () {
    configureAndMake $1 $2 "$3"
    cd $1
    make install --quiet
    cd -
}
#@param string $1 Directory
function mkdirClean () {
    rm -rf $1
    mkdir -p $1
}
#@param string $1 Message
function echoWarning () {
    echo -e "n33[1;37;41m$133[0;0;0mn"
}
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
export PATH="$PATH:$PHP_BIN_DIR"
echoL1 "-> DOWNLOADING..."
mkdirClean $BUILD_DIR
echoL2 "--> Downloading $M4..."
downloadTo "http://ftp.gnu.org/gnu/m4/$M4.tar.gz" $DOWNLOADS_DIR
untarTo "$DOWNLOADS_DIR/$M4.tar.gz" $BUILD_DIR
echoL2 "--> Downloading $AUTOCONF..."
downloadTo "http://ftp.gnu.org/gnu/autoconf/$AUTOCONF.tar.gz" $DOWNLOADS_DIR
untarTo "$DOWNLOADS_DIR/$AUTOCONF.tar.gz" $BUILD_DIR
echoL2 "--> Downloading $OPENSSL..."
downloadTo "http://www.openssl.org/source/$OPENSSL.tar.gz" $DOWNLOADS_DIR
untarTo "$DOWNLOADS_DIR/$OPENSSL.tar.gz" $BUILD_DIR
echoL2 "--> Downloading $CURL..."
downloadTo "http://curl.haxx.se/download/$CURL.tar.gz" $DOWNLOADS_DIR
untarTo "$DOWNLOADS_DIR/$CURL.tar.gz" $BUILD_DIR
echoL2 "--> Downloading $LIBMCRYPT..."
downloadTo "http://easynews.dl.sourceforge.net/sourceforge/mcrypt/$LIBMCRYPT.tar.gz" $DOWNLOADS_DIR
untarTo "$DOWNLOADS_DIR/$LIBMCRYPT.tar.gz" $BUILD_DIR
echoL2 "--> Downloading $LIBTOOL..."
downloadTo "http://ftp.gnu.org/gnu/libtool/$LIBTOOL.tar.gz" $DOWNLOADS_DIR
untarTo "$DOWNLOADS_DIR/$LIBTOOL.tar.gz" $BUILD_DIR
echoL2 "--> Downloading $PHP..."
downloadTo "http://www.php.net/get/$PHP.tar.gz/from/this/mirror" $DOWNLOADS_DIR
untarTo "$DOWNLOADS_DIR/$PHP.tar.gz" $BUILD_DIR
echoL2 "--> Downloading $APC..."
downloadTo "http://pecl.php.net/get/$APC.tgz" $DOWNLOADS_DIR
untarTo "$DOWNLOADS_DIR/$APC.tgz" $BUILD_DIR
if [ $ENABLEXDEBUG = "y" ]; then
  echoL2 "--> Downloading $XDEBUG..."
  downloadTo "http://xdebug.org/files/$XDEBUG.tgz" $DOWNLOADS_DIR
  untarTo "$DOWNLOADS_DIR/$XDEBUG.tgz" $BUILD_DIR
fi
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
echoL1 "-> BUILDING..."
mkdir -p $PHP_BASE_DIR
echoL2 "--> Building $M4..."
makeAndInstall "$BUILD_DIR/$M4" $PHP_BASE_DIR
echoL2 "--> Building $AUTOCONF..."
makeAndInstall "$BUILD_DIR/$AUTOCONF" $PHP_BASE_DIR
echoL2 "--> Building $OPENSSL..."
makeAndInstall "$BUILD_DIR/$OPENSSL" $PHP_BASE_DIR
echoL2 "--> Building $CURL..."
makeAndInstall "$BUILD_DIR/$CURL" $PHP_BASE_DIR "--enable-ipv6 --enable-cookies
 --enable-crypto-auth --with-ssl"
echoL2 "--> Building $LIBMCRYPT..."
makeAndInstall "$BUILD_DIR/$LIBMCRYPT" $PHP_BASE_DIR "--disable-posix-threads"
echoL2 "--> Building $LIBTOOL..."
makeAndInstall "$BUILD_DIR/$LIBTOOL" $PHP_BASE_DIR
echoL2 "--> Building $PHP..."
#Fixes compile error
export EXTRA_LIBS="-lresolv"
makeAndInstall "$BUILD_DIR/$PHP" $PHP_BASE_DIR "$PHP_FEATURES"
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
echoL1 "-> INSTALLING PHP..."
mkdir -p -m 0755 $CGI_BIN_DIR
mkdir -p -m 0755 $PHP_CONFIG_DIR
cp "$PHP_BIN_DIR/php-cgi" "$CGI_BIN_DIR/php.cgi"
cp "$BUILD_DIR/$PHP/php.ini-production" $PHP_INI
mkdir -p $PHP_EXTENSIONS_DIR
echoL2 "--> Building $APC..."
APC_SOURCE_DIR="$BUILD_DIR/$APC"
cd $APC_SOURCE_DIR
$PHP_BIN_DIR/phpize
configureAndMake $APC_SOURCE_DIR $PHP_BASE_DIR "--enable-apc --enable-apc-mmap
 --with-php-config=$PHP_BIN_DIR/php-config"
cp modules/apc.so $PHP_EXTENSIONS_DIR
echo "extension=$PHP_EXTENSIONS_DIR/apc.so" > $PHP_CONFIG_DIR/apc.ini
cd -
if [ $ENABLEXDEBUG = "y" ]; then
  echoL2 "--> Building $XDEBUG..."
  XDEBUG_SOURCE_DIR="$BUILD_DIR/$XDEBUG"
  cd $XDEBUG_SOURCE_DIR
  $PHP_BIN_DIR/phpize
  configureAndMake $XDEBUG_SOURCE_DIR $PHP_BASE_DIR "--enable-xdebug
   --with-php-config=$PHP_BIN_DIR/php-config"
  cp modules/xdebug.so $PHP_EXTENSIONS_DIR
  echo "zend_extension=$PHP_EXTENSIONS_DIR/xdebug.so" > $PHP_CONFIG_DIR/xdebug.ini
  cd -
fi
#-------------------------------------------------------------------------------
if [ -f $HTACCESS ]; then
    HTACCESS_NEW="$HTACCESS.old"
    cp $HTACCESS $HTACCESS_NEW
    echoWarning "--> Copied $HTACCESS to $HTACCESS_NEW"
fi
#The backslash prevents a newline being inserted at the start
HTACCESS_CONTENT="
Options +ExecCGI
AddHandler php-cgi .php
Action php-cgi /cgi-bin/php.cgi
#Deny access to the PHP CGI executable and config files

    Order Deny,Allow
    Deny from All
    Allow from env=REDIRECT_STATUS
"
#Preserve newlines in the content by quoting the variable name
echo "#######ADDED BY installPHP script" >> $HTACCESS
echo "$HTACCESS_CONTENT" >> $HTACCESS
echoL2 "--> Created $PHP_INI"
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
rm -rf $BUILD_DIR
echo -n "Delete the downloads directory? (y/n): "
read DELETE_DOWNLOADS_DIR
if [ $DELETE_DOWNLOADS_DIR = "y" ]; then
    rm -rf $DOWNLOADS_DIR
fi
echoL1 "DONE"
exit 0

20 Responses

  1. Hi,
    does this script create a custom php install with APC working by itself or do I need to modify something else to make it work? I’d like to use APC for magento and all the other scripts for installing php and APC on dreamhost failed to install…
    Thanks

  2. Thanks a lot it works! One last question: Magento doesn’t support php5.3 very well… I’d like to install 5.2. Is it sufficient change PHP=”php-5.3.1″ to PHP=”php-5.2.12″ (for example) at the 1 “#@todo Update” or are there other settings to customize and how?
    I’d really appreciate if you could answer this question, hope it doesn’t bother you too much.
    Thanks a lot.
    Emmanuele

  3. Script blocks when downloading Curl, there must be something with their site cause i cannot reach it. I’ll try later and I’ll tell you.

  4. It blocks during Php 5.2.12 installation: this is the error -> INSTALLING PHP...
    cp: cannot stat `/home/milchstore/mycompiles/build/php-5.2.12/php.ini-production': No such file or directory

  5. dave

    Is it just me or is APC not actually functional? I see that it is enabled, however if you look at apc.php there is never any entries other than apc.php itself, and apc start time is the whenever the script ran. I’m sure there is a way around this, but what am I missing?

  6. dave

    yea, it works fine, except i believe php as cgi runs as a new instance of php each time, hence no shared memory. (well that’s what I’ve gathered from other research I’ve done)
    Take a look at that apc.php file, the output will let you know whether apc is doing anything for you or not
    Thanks for your efforts btw, the script worked great.

  7. Hi, Im getting the following error, no idea what to do, any advice?
    Internal Server Error
    The server encountered an internal error or misconfiguration and was unable to complete your request.
    Please contact the server administrator, webmaster@quefresas.com and inform them of the time the error occurred, and anything you might have done that may have caused the error.
    More information about this error may be available in the server error log.
    Additionally, a 500 Internal Server Error error was encountered while trying to use an ErrorDocument to handle the request.

  8. I use Drupal and some modules would like to have PECL upload progress.
    How could it be added to build script and can you provide a solution for such integration?

  9. GeorgeK

    Did anyone use this installation to debug with Xdebug ?
    I use the following configuration in the php.ini
    end_extension_ts-
    xdebug.remote_enable=on
    xdebug.remote_handler=dbgp
    xdebug.remote_host=
    xdebug.remote_port=
    Alas I it doesn’t work and before I spend more time on it I would like to know if this port opening is even allowed?
    Any help will be very welcomed

  10. GeorgeK

    My message got scrambled, as stated I using the following configuration in the php.ini
    end_extension_ts=[absolute path to xdebug.so]
    xdebug.remote_enable=on
    xdebug.remote_handler=dbgp
    xdebug.remote_host=[domain name]
    xdebug.remote_port=[port of my choosing]

  11. Gary

    I got the script to run without errors, but APC is not showing up as installed. Any suggestions? Is there steps not listed here that I was supposed to follow? Thanks!

Leave a Reply