9 releases

0.1.8 Mar 31, 2022
0.1.7 Mar 7, 2022
0.1.1 Feb 24, 2022

#1029 in Development tools

GPL-3.0 license

2.5K SLoC

PHP-UP - Cross-Platform PHP version manager

⚡ PHP version manager written in rust

Blazing fast!


  • No requirements for system PHP installation
  • Cross-platform support (Linux, macOS, Windows[WIP])
  • Automatically version switching via .php-version

Quick Start (Linux, macOS)

For bash, zsh and fish there's a installation script

curl -fsSL https://phpup.vercel.app/install | bash


To prevent duplication in your shell config file, add --skip-shell option to install command.

curl -fsSL https://phpup.vercel.app/install | bash -s -- --skip-shell


To remove PHP-UP, just delete the .phpup folder in your home directory. You should also edit your shell configuration to remove any references to phpup.



  • OS: Linux, macOS, Windows[WIP]
  • shell: bash, zsh, fish or powershell[WIP]
  • curl, ps and make installation


using a release binary

  1. Download the latest release binary for your system
  2. Make it available globally on PATH environment variable

using cargo

cargo install phpup

Shell setup

Bash, Zsh

Add the following to your .bashrc or .zshrc

eval "$(phpup init --auto --recursive)"


Create ~/.config/fish/conf.d/phpup.fish and add the following to it

phpup init --auto --recursive | source
  • To automatically run phpup use when a directory contains a .php-version file, add the --auto (long: --auto-switch) option.
  • To search recursively for a .php-version file in a parent directory when running phpup use automatically, add the --recursive (long: --recursive-version-file) option.
  • For more options, run phpup init --help.


PHP Installation

How to specify configure options

using the command option: --configure-opts
PKG_CONFIG_PATH="$(brew --prefix libxml2)/lib/pkgconfig" \
phpup install 8.1 \
  --configure-opts="--with-iconv=$(brew --prefix libiconv)"
using the shell variable: PHPUP_CONFIGURE_OPTS
PKG_CONFIG_PATH="$(brew --prefix libxml2)/lib/pkgconfig" \
PHPUP_CONFIGURE_OPTS="--with-iconv=$(brew --prefix libiconv)" \
phpup install 8.1
using the env variable: PHPUP_CONFIGURE_OPTS
export PKG_CONFIG_PATH="$(brew --prefix libxml2)/lib/pkgconfig"
export PHPUP_CONFIGURE_OPTS="--with-iconv=$(brew --prefix libiconv)"
phpup install 8.1

See List of core configure options for more configre options.

For more details

phpup help


PRs Welcome 🎉



~327K SLoC