Repository files navigation

Read this in other languages:English,Português - BR,日本語,中文.

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

What phpbrew can do for you:

• Configure options are simplified into variants, no worries about the path anymore!
• Build php with different variants like PDO, mysql, sqlite, debug ...etc.
• Compile apache php module and separate 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 & enable php extensions into current environment with ease.
• Install multiple php into system-wide environment.
• Path detection optimization for HomeBrew and MacPorts.

Please seeRequirementbefore you get started. you need to install some development packages forbuilding PHP.

Please seeQuick Start if you're impatient. :-p

OK, I assume you have more time to work on this, this is a step-by-steptutorial that helps you get started.

curl -L -O https://github.com/phpbrew/phpbrew/releases/latest/download/phpbrew.pharchmod +x phpbrew.phar# Move the file to some directory within your $PATHsudo mv phpbrew.phar /usr/local/bin/phpbrew

Init a bash script for your shell environment:

phpbrew init

Add these lines to your.bashrc or.zshrc file:

[[-e~/.phpbrew/bashrc ]]&&source~/.phpbrew/bashrc

• Specifically forfish shell users, add following lines to your~/.config/fish/config.fish file*:

source ~/.phpbrew/phpbrew.fish

If you're using system-wide phpbrew, you may setup a shared phpbrew root, for example:

mkdir -p /opt/phpbrewphpbrew init --root=/opt/phpbrew

You may setup your preferred default prefix for looking up libraries, availableoptions aremacports,homebrew,debian,ubuntu or a custom path:

For Homebrew users:

phpbrew lookup-prefix homebrew

For Macports users:

phpbrew lookup-prefix macports

To list known versions:

phpbrew known8.2: 8.2.4, 8.2.3, 8.2.2, 8.2.1, 8.2.0 ...8.1: 8.1.17, 8.1.16, 8.1.15, 8.1.14, 8.1.13, 8.1.12, 8.1.11, 8.1.10 ...8.0: 8.0.28, 8.0.27, 8.0.26, 8.0.25, 8.0.24, 8.0.23, 8.0.22, 8.0.21 ...7.4: 7.4.33, 7.4.32, 7.4.30, 7.4.29, 7.4.28, 7.4.27, 7.4.26, 7.4.25 ...7.3: 7.3.33, 7.3.32, 7.3.31, 7.3.30, 7.3.29, 7.3.28, 7.3.27, 7.3.26 ...7.2: 7.2.34, 7.2.33, 7.2.32, 7.2.31, 7.2.30, 7.2.29, 7.2.28, 7.2.27 ...7.1: 7.1.33, 7.1.32, 7.1.31, 7.1.30, 7.1.29, 7.1.28, 7.1.27, 7.1.26 ...7.0: 7.0.33, 7.0.32 ...

To show more minor versions:

$ phpbrew known --more

To update the release info:

$ phpbrew update

To get older versions (less than 5.4)

Please note that we don't guarantee that you can build the php versions thatare not supported by offical successfully, please don't fire any issue aboutthe older versions, these issues won't be fixed.

$ phpbrew update --old

To list known older versions (less than 5.4)

$ phpbrew known --old

Simply build and install PHP with default variant:

$ phpbrew install 5.4.0 +default

Here we suggestdefault variant set, which includes most commonly usedvariants, if you need a minimum install, just remove thedefault variant set.

You can enable parallel compilation by passing-j or--jobs option andthe following is an example:

$ phpbrew install -j$(nproc) 5.4.0 +default

With tests:

$ phpbrew install --test 5.4.0

With debug messages:

$ phpbrew -d install --test 5.4.0

To install older versions (less than 5.3):

$ phpbrew install --old 5.2.13

To install the latest patch version of a given release:

$ phpbrew install 5.6

To install a pre-release version:

$ phpbrew install 7.2.0alpha1$ phpbrew install 7.2.0beta2$ phpbrew install 7.2.0RC3

To install from a GitHub tag or branch name:

$ phpbrew install github:php/php-src@PHP-7.2 as php-7.2.0-dev

To install the next (unstable) version:

$ phpbrew install next as php-7.3.0-dev

$ phpbrew clean php-5.4.0

PHPBrew arranges configure options for you, you can simply specify variantname, and phpbrew will detect include paths and build options for configuring.

PHPBrew provides default variants and some virtual variants,to the default variants, which includes the most commonly used variants,to the virtual variants, which defines a variant set, you may use one virtual variantto enable multiple variants at one time.

To check out what is included in these variants, runphpbrew variantsto list these variants.

To enable one variant, add a prefix+ before the variant name, eg

+mysql

To disable one variant, add a prefix- before the variant name.

-debug

For example, if we want to build PHP with the default options anddatabase supports (mysql, sqlite, postgresql), you may simply run:

$ phpbrew install 5.4.5 +default+dbs

You may also build PHP with extra variants:

$ phpbrew install 5.3.10 +mysql+sqlite+cgi$ phpbrew install 5.3.10 +mysql+debug+pgsql +apxs2$ phpbrew install 5.3.10 +pdo +mysql +pgsql +apxs2=/usr/bin/apxs2

To build PHP with pgsql (PostgreSQL) extension:

$ phpbrew install 5.4.1 +pgsql+pdo

Or build pgsql extension with postgresql base dir on Mac OS X:

$ phpbrew install 5.4.1 +pdo+pgsql=/opt/local/lib/postgresql91/bin

The pgsql path is the location ofpg_config, you could findpg_config in the /opt/local/lib/postgresql91/bin

To build PHP with neutral compile options, you can specifyneutral virtual variant, which means that phpbrewdoesn't add any additional compile options including--disable-all. But some options(for example--enable-libxml)are still automatically added to supportpear installation.You can build PHP withneutral:

$ phpbrew install 5.4.1 +neutral

For more details, please check outPHPBrew Cookbook.

To pass extra configure arguments, you can do this:

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

Use (switch version temporarily):

$ phpbrew use 5.4.22

Switch PHP version (switch default version)

$ phpbrew switch 5.4.18

Turn Off:

$ phpbrew off

If you enable apache PHP modules, remember to comment out or remove the settings.

$ sudo vim /etc/httpd/conf/httpd.conf# LoadModule php5_module        /usr/lib/httpd/modules/libphp5.3.21.so# LoadModule php5_module        /usr/lib/httpd/modules/libphp5.3.20.so

SeeExtension Installer

Simply run:

$ phpbrew config

You may specify the EDITOR environment variable to your favorite editor:

export EDITOR=vimphpbrew config

To upgrade phpbrew, you may simply run theself-update command,this command enables you to install the latest version ofmaster branch from GitHub:

$ phpbrew self-update

To list all installed php(s), you could run:

$ phpbrew list

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

~/.phpbrew/php/5.4.20/bin/php

And you should put your configuration file in:

~/.phpbrew/php/5.4.20/etc/php.ini

Extension configuration files should be put in:

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

Switching to PHP build directory

$ phpbrew build-dir

Switching to PHP dist directory

$ phpbrew dist-dir

Switching to PHP etc directory

$ phpbrew etc-dir

Switching to PHP var directory

$ phpbrew var-dir

phpbrew also provides useful fpm managing sub-commands. to use them, pleaseremember to enable+fpm variant when building your own php.

To setup the system FPM service, type one of commands:

# Typing the following command when systemctl is available in the Linux distribution.$ phpbrew fpm setup --systemctl# It is available in the Linux distribution.$ phpbrew fpm setup --initd# It is available in the macOS.$ phpbrew fpm setup --launchctl

To start php-fpm, simply type:

$ phpbrew fpm start

To stop php-fpm, type:

$ phpbrew fpm stop

To show php-fpm modules:

phpbrew fpm module

To test php-fpm config:

phpbrew fpmtest

To edit php-fpm config:

phpbrew fpm config

The installedphp-fpm is located in~/.phpbrew/php/php-*/sbin.

The correspondphp-fpm.conf is located in~/.phpbrew/php/php-*/etc/php-fpm.conf.default,you may copy the default config file to the desired location. e.g.,

cp -v ~/.phpbrew/php/php-*/etc/php-fpm.conf.default    ~/.phpbrew/php/php-*/etc/php-fpm.confphp-fpm --php-ini {php config file} --fpm-config {fpm config file}

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 thisline 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 usephpbrew_current_php_version shell function, which is defined in.phpbrew/bashrc.and you can set the version info in yourPS1 var.e.g.

PS1="\$(phpbrew_current_php_version)\$"

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

• To build PHP with GD extension, you need to specify your libpng dir and libjpeg dir, for example,

  $ phpbrew install php-5.4.10 +default +mysql +intl +gettext +apxs2=/usr/bin/apxs2
  -- --with-libdir=lib/x86_64-linux-gnu
  --with-gd=shared
  --enable-gd-natf
  --with-jpeg-dir=/usr
  --with-png-dir=/usr

Please seeTroubleShooting

Q: How do I have the same version with different compile option?

A: Currently, you can install php-5.x.x and rename the /Users/phpbrew/.phpbrew/php/php-5.x.x folder to the new name, for example, php-5.x.x-super , and install another php-5.x.x

Please seeContribution

Please seeWiki

only listing 1k+ lines contributors, names are sorted in alphabetical order

• @c9s
• @GM-Alex
• @jhdxr
• @marcioAlmada
• @morozov
• @markwu
• @peter279k
• @racklin
• @shinnya

SeeLICENSE file.