Skip to content

Latest commit

 

History

History
283 lines (181 loc) · 4.93 KB

README.md

File metadata and controls

283 lines (181 loc) · 4.93 KB
Raw

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.

Platform support

  • Mac OS 10.7
  • Ubuntu, Debian

Requirements

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

Mac OS X

MacPorts users:

$ port install $(port echo depof:php5)

Ubuntu/Debian

$ sudo apt-get build-dep php5

Install phpbrew

Just download it:

curl -O https://raw.github.com/c9s/phpbrew/master/phpbrew

Install through PEAR channel:

$ sudo pear channel-discover pear.corneltek.com
$ sudo pear install -a -f corneltek/PhpBrew

Install from github:

$ git clone [email protected]:c9s/phpbrew.git
$ cd phpbrew
$ sudo pear install -f package.xml

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
Available svn versions:
	php-svn-head
	php-svn-5.3
	php-svn-5.4
Available versions from PhpStas:
	php-5.4.0RC1
	php-5.4.0RC2
	php-5.4.0RC3
	php-5.4.0RC4
	php-5.4.0RC5
	php-5.4.0RC6
	php-5.4.0RC7
	php-5.4.0alpha1
	php-5.4.0alpha2
	php-5.4.0alpha3
	php-5.4.0beta1
	php-5.4.0beta2

Build And Install

simply build and install PHP:

$ phpbrew install php-5.4.0

Without tests:

$ phpbrew install --no-test php-5.4.0

With debug messages:

$ phpbrew -d install --no-test php-5.4.0

Variants

To list variants:

$ phpbrew variants

Variants:
    pdo
    pear
    mysql
    debug
    sqlite
    pgsql
    cli
    apxs2
    debug
    cgi
    soap
    pcntl
    ...

You can build PHP with extra variants:

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

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

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

PDO is enabled by default.

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)

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:

phpbrew install-ext pdo

Installed PHPs

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

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 \$ "

Hacking

Install Onion first:

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

Install dependencies:

$ onion -d bundle

Initialize

$ php scripts/phpbrew.php init

List known versions:

$ php scripts/phpbrew.php known

Install:

$ php scripts/phpbrew.php -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.sh

Community

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

Contributors

  • yftzeng
  • Gasol

Author

Yo-An Lin (c9s) [email protected]