jmarizgit / phpbrew

Brew & manage PHP versions in pure PHP at HOME

PHPBrew

phpbrew builds and installs multiple version php(s) in your $HOME directory.

phpbrew also manage the environment variables, so you can use, switch php version whenever you need.

phpbrew can:

• build php with different variants like PDO, mysql, sqlite, debug ...etc.
• compile apache php module and seperate them by different versions.
• build and install php(s) in your home directory, so you don't need root permission.
• switch versions very easily and is integrated with bash/zsh shell.
• automatic feature detection.
• install multiple php into system-wide environment.

Platform support

• Mac OS 10.5+
• Ubuntu
• Debian

Requirement

• PHP5.3
• curl
• gcc, binutil, autoconf, libxml, zlib, readline

Mac OS X Requirement

MacPorts users:

port install curl automake autoconf icu $(port echo depof:php5)

HomeBrew users:

brew install automake autoconf curl pcre re2c mhash glibtool icu4c gettext jpeg libxml2 mcrypt gmp libevent
brew link icu4c

Ubuntu/Debian Requirement

sudo apt-get install autoconf automake curl build-essential libxslt1-dev re2c libxml2-dev
sudo apt-get build-dep php5

Cent OS Requirement

Cent OS requirement setup

sudo rpm -Uvh http://repo.webtatic.com/yum/centos/5/latest.rpm

# If you don't have php
sudo yum install --enablerepo=webtatic php php-xml
wget http://pkgs.repoforge.org/rpmforge-release/rpmforge-release-0.5.2-2.el5.rf.x86_64.rpm
sudo rpm -Uvh rpmforge-release-0.5.2-2.el5.rf.x86_64.rpm
sudo yum install --enablerepo=rpmforge re2c libmhash

Reference: http://matome.naver.jp/odai/2133887830324055901

Install phpbrew

Just download it:

curl -O https://raw.github.com/c9s/phpbrew/master/phpbrew
chmod +x phpbrew
sudo cp phpbrew /usr/bin/phpbrew

Basic usage

Init a bash script for your shell environment:

$ phpbrew init

Then add these lines to your .bashrc or .zshrc file:

$ source ~/.phpbrew/bashrc

To list known versions:

$ phpbrew known
Available stable versions:
    php-5.3.10
    php-5.3.9
    php-5.3.8
    php-5.3.7

To list known subversion versions:

$ phpbrew known --svn

To list known older versions (less than 5.3):

$ phpbrew known --old

Build And Install

Simply build and install PHP with default variant:

$ phpbrew install php-5.4.0 +default

Here we suggest default variant set, which includes most commonly used variants, if you need a minimum install, just remove the default variant set.

With tests:

$ phpbrew install --test php-5.4.0

With debug messages:

$ phpbrew -d install --test php-5.4.0

Variants

PHPBrew arranges configure options for you, you can simply specify variant name, and phpbrew will detect include paths and options for you.

PHPBrew provides a default variant set, which include the most commonly used variants, to see what is included in these variant sets, simply run variants subcommand to list variants:

$ phpbrew variants

Variants:
    pear
    mysql
    debug
    sqlite
    pgsql
    cli
    apxs2
    cgi
    soap
    pcntl
    ... (etc)

Currently phpbrew provides 2 variant set:

1. default (most commonly used variants, eg: filter bcmath ctype fileinfo pdo posix ipc pcntl bz2 cli intl fpm calendar sockets readline, zip)
2. dbs (sqlite, mysql, pgsql, pdo)

For example,

$ phpbrew install php-5.4.5 +default+dbs

You can also build PHP with extra variants:

$ phpbrew install php-5.3.10 +mysql+sqlite+cgi

$ phpbrew install php-5.3.10 +mysql+debug+pgsql +apxs2

$ phpbrew install php-5.3.10 +mysql +pgsql +apxs2=/usr/bin/apxs2

PDO is enabled by default.

To build PHP with pgsql (Postgresql) extension:

$ phpbrew install php-5.4.1 +pgsql

Or build pgsql extension with postgresql base dir:

$ phpbrew install php-5.4.1 +pgsql=/opt/local/lib/postgresql91

NOTE:

1. If you want to build php with apache php module, please change the permission of apache module directory, eg: /opt/local/apache2/modules/. it should be writable and phpbrew should be able to change permission. after install, you should check your httpd.conf configuration file, to switch your php module version. :-)

2. phpbrew currently only supports for apxs2 (apache2)

If you enabled the apxs2 variant, your apache conf file might look like this if you have multiple php(s) installed on your system:

# LoadModule php5_module        modules/libphp5.3.10.so
# LoadModule php5_module        modules/libphp5.4.0.so
# LoadModule php5_module        modules/libphp5.4.0RC8.so
# LoadModule php5_module        modules/libphp5.4.0RC7.so
# LoadModule php5_module        modules/libphp5.4.1RC2.so
# LoadModule php5_module        modules/libphp5.4.1.so
# LoadModule php5_module        modules/libphp5.4.2.so
LoadModule php5_module          modules/libphp5.4.4.so

You can simply uncomment/comment it to enable the php5 apache module you needed, after modifying it, remember to restart your apache http server. :)

Extra options

To pass extra configure arguments, you can do this:

$ phpbrew install php-5.3.10 +mysql +sqlite -- \
  --enable-ftp --apxs2=/opt/local/apache2/bin/apxs

Use And Switch

Use (switch version temporarily):

$ phpbrew use php-5.4.0RC7

Switch (switch version as default)

$ phpbrew switch php-5.4.0

Turn Off:

$ phpbrew off

List installed PHP

$ phpbrew list

Build & Install extensions from PHP source

(after the installation):

phpbrew install-ext pdo
phpbrew install-ext mcrypt --with-mcrypt=/opt/local

Enable Extension

pecl install mongo
phpbrew enable mongo

the enable command allows you to create a config {current php base}/var/db/{extension name}.ini to enable the extension.

Upgrade phpbrew

To upgrade phpbrew, you can simply run the self-update command, this command enables you to install the latest version of master branch from github:

$ phpbrew self-update

The Installed PHP(s)

The installed phps are located in ~/.phpbrew/php, for example, php 5.4.0RC7 is located at:

~/.phpbrew/php/5.4.0RC7/bin/php

And you should put your configuration file in:

~/.phpbrew/php/5.4.0RC7/etc/php.ini

Extension configuration files should be put in:

~/.phpbrew/php/5.4.0RC7/var/db
~/.phpbrew/php/5.4.0RC7/var/db/xdebug.ini
~/.phpbrew/php/5.4.0RC7/var/db/apc.ini
~/.phpbrew/php/5.4.0RC7/var/db/memcache.ini
... etc

Install phpbrew into system-wide environment

First, sudo as a root user or login as a root user:

sudo -i

Now initialize your phpbrew bashrc for root:

phpbrew init

Now export phpbrew paths to your desired paths, edit your ~/.phpbrew/init

export PHPBREW_ROOT=/opt/phpbrew

Source your phpbrew bashrc

source ~/.phpbrew/bashrc

Install system-wide php(s):

phpbrew install php-5.4.5 +default +dbs

Now your php(s) will be installed under the /opt/phpbrew path, To let your users can use php(s) built by phpbrew, you need to export PHPBREW_ROOT environment in /etc/bashrc or in /etc/profile.d/phpbrew for bash users, before they load the phpbrew/bashrc file.

export PHPBREW_ROOT=/opt/phpbrew
source /opt/phpbrew/bashrc

To keep system's safety, please use root to install php(s).

a non-root user should not be able to install new php or switch

and remember to fix permissions if these files were installed by non-root user.

chown -R root: /opt/phpbrew

Enable Version Info Prompt

To add PHP version info in your shell prompt, you can use "PHPBREW_SET_PROMPT=1" variable.

The default is "PHPBREW_SET_PROMPT=0" (disable). To enable it, you can add this line to your ~/.bashrc file and put this line before you source ~/.phpbrew/bashrc.

    export PHPBREW_SET_PROMPT=1

To embed version info in your prompt, you can use current_php_version shell function, which is defined in .phpbrew/bashrc. and you can set the version info in your PS1 var. e.g.

    PHP_VERSION=$(current_php_version)
    PS1=" $PHP_VERSION \$ "

Known Problems

• For PHP-5.3+ versions, "Building intl 64-bit fails on OS X" https://bugs.php.net/bug.php?id=48795

Hacking

Install Onion first:

$ curl http://install.onionphp.org/ | sh

Install dependencies:

$ onion -d install

Initialize

$ php bin/phpbrew init

List known versions:

$ php bin/phpbrew known

Install:

$ php bin/phpbrew -d install --no-test 5.4.0RC7

To show which phpbrew is running:

$ unset -f phpbrew
$ which phpbrew

Re-compile phar file:

$ bash scripts/compile

PHP Release channels

• http://snaps.php.net/
• http://tw2.php.net/releases/
• http://downloads.php.net/stas/

Community

Join us on #php-tw on irc.freenode.net

Contributors

• yftzeng
• Gasol

Author

Yo-An Lin (c9s) [e-mail]