Thin Wrapper around rbenv for PHP version managment
Switch branches/tags
Nothing to show
Clone or download
Latest commit f347f96 Oct 20, 2014
CHH Merge pull request #32 from gitter-badger/gitter-badge
Add a Gitter chat badge to


![Gitter]( Chat.svg)

Sets up a separate rbenv environment for PHP

man page



The command sets up a separate rbenv environment for usage with PHP. This environment is stored in the $HOME/.phpenv directory and contains a phpenv executable which sets the RBENV_ROOT environment variable to $HOME/.phpenv.

To install PHP versions, just put them to the $HOME/.phpenv/versions directory. You can use php-build to do this with one command:

$ php-build -i development 5.4.9 $HOME/.phpenv/versions/5.4.9
$ phpenv versions
$ phpenv rehash
$ phpenv global 5.4.9
$ php --version
  PHP 5.4.9 (cli) (built: Nov 25 2012 17:27:10) 
  Copyright (c) 1997-2012 The PHP Group
  Zend Engine v2.4.0, Copyright (c) 1998-2012 Zend Technologies
      with Xdebug v2.2.1, Copyright (c) 2002-2012, by Derick Rethans

The command has an optional "update" mode which updates the $HOME/.phpenv to the latest source code from the rbenv repository and creates a new phpenv executable.

This mode is triggered by setting the UPDATE environment variable before calling, for example:

$ UPDATE=yes

Finally, enable phpenv in your shell by adding $HOME/.phpenv/bin and $HOME/.phpenv/shims to your PATH and adding eval "$(phpenv init -)" to your $HOME/.bash_profile or $HOME/.bashrc (or your shell's respective file) and restart your shell.


  • For rbenv users: Make sure that ~/.rbenv/bin takes precedence in the PATH over ~/.phpenv/bin by placing it before, so rbenv gets used from ~/.rbenv.

  • You need to have git installed to run the command.