by thirdiron

GitHub Readme.md

Apache+PHP build pack

This is a build pack bundling PHP and Apache for Heroku apps.


The config files are bundled with the build pack itself:

  • conf/httpd.conf
  • conf/php.ini

Pre-compiling binaries

On a Heroku Dyno, one can run the following as executable text. After running it, /app will contain, among other entities, apache-2.2.25-1.tar.gz, php-5.3.27-1.tar.gz, and mcrypt-2.5.8-1.tar.gz which should be uploaded to a location that can be downloaded by the build pack (see the URIs in compile).

To compile after making updates, do the following:

  • clone the repo of our heroku app used for building build pack dependencies: git@heroku.com:temporary-php-builder.git

  • copy/paste the script below over build_php.sh within that repository

  • git push to deploy the updated script

  • heroku run bash --app temporary-php-builder

  • cd www

  • chmod 775 ./build_php.sh

  • ./build_php

  • sftp iron@thirdiron.com and put the files on our server for easy upload to S3

    #!/bin/bash set -uex cd /tmp

    Heroku revision. Must match in 'compile' program.

    Affixed to all vendored binary output to represent changes to the

    compilation environment without a change to the upstream version,

    e.g. PHP 5.3.27 without, and then subsequently with, libmcrypt.


    Clear /app directory

    find /app -mindepth 1 -print0 | xargs -0 rm -rf

    Take care of vendoring libmcrypt

    mcrypt_version=2.5.8 mcrypt_dirname=libmcrypt-$mcrypt_version mcrypt_archive_name=$mcrypt_dirname.tar.bz2

    Download mcrypt if necessary

    if [ ! -f mcrypt_archive_name ] then curl -Lo $mcrypt_archive_name http://sourceforge.net/projects/mcrypt/files/Libmcrypt/2.5.8/libmcrypt-2.5.8.tar.bz2/download fi

    Clean and extract mcrypt

    rm -rf $mcrypt_dirname tar jxf $mcrypt_archive_name

    Build and install mcrypt.

    pushd $mcrypt_dirname ./configure --prefix=/app/vendor/mcrypt
    --disable-posix-threads --enable-dynamic-loading make -s make install -s popd

    Take care of vendoring Apache.

    httpd_version=2.2.25 httpd_dirname=httpd-$httpd_version httpd_archive_name=$httpd_dirname.tar.bz2

    Download Apache if necessary.

    if [ ! -f $httpd_archive_name ] then curl -LO http://mirrors.axint.net/apache/httpd/$httpd_archive_name fi

    Clean and extract Apache.

    rm -rf $httpd_dirname tar jxf $httpd_archive_name

    Build and install Apache.

    pushd $httpd_dirname ./configure --prefix=/app/apache --enable-rewrite --with-included-apr make -s make install -s popd

    Take care of vendoring PHP.

    php_version=5.3.27 php_dirname=php-$php_version php_archive_name=$php_dirname.tar.bz2

    Download PHP if necessary.

    if [ ! -f $php_archive_name ] then curl -Lo $php_archive_name http://us1.php.net/get/php-5.3.27.tar.bz2/from/www.php.net/mirror fi

    Clean and extract PHP.

    rm -rf $php_dirname tar jxf $php_archive_name

    Compile PHP

    pushd $php_dirname ./configure --prefix=/app/php --with-apxs2=/app/apache/bin/apxs
    --with-mysql --with-pdo-mysql --with-pgsql --with-pdo-pgsql
    --with-iconv --with-gd --with-curl=/usr/lib
    --with-config-file-path=/app/php --enable-soap=shared
    --with-openssl --with-mcrypt=/app/vendor/mcrypt --enable-sockets
    --enable-mbstring make -s make install -s popd

    Copy in MySQL client library.

    mkdir -p /app/php/lib/php cp /usr/lib/libmysqlclient.so.16 /app/php/lib/php

    'apc' installation

    $PATH manipulation Necessary for 'pecl install', which relies on

    PHP binaries relative to $PATH.

    export PATH=/app/php/bin:$PATH /app/php/bin/pecl channel-update pecl.php.net

    Use defaults for apc build prompts.

    yes '' | /app/php/bin/pecl install apc

    Sanitize default cgi-bin to rid oneself of Apache sample


    find /app/apache/cgi-bin/ -mindepth 1 -print0 | xargs -0 rm -r

    Stamp and archive binaries.

    pushd /app echo $mcrypt_version > vendor/mcrypt/VERSION tar -zcf mcrypt-"$mcrypt_version""$heroku_rev".tar.gz vendor/mcrypt echo $httpd_version > apache/VERSION tar -zcf apache-"$httpd_version""$heroku_rev".tar.gz apache echo $php_version > php/VERSION tar -zcf php-"$php_version""$heroku_rev".tar.gz php popd


To change this buildpack, fork it on Github. Push up changes to your fork, then create a test app with --buildpack and push to it.


Created by Pedro Belo. Many thanks to Keith Rarick for the help with assorted Unix topics :)