masan4444 / phpup

Cross-Platform PHP version manager written in rust :crab:

PHP-UP - Cross-Platform PHP version manager

⚡ PHP version manager written in rust

Features

• 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

Upgrade

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

Uninstall

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.

Installation

Requirements

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

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)"

Fish

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.

Usage

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

Contribution

PRs Welcome 🎉

• TODO.md

Inspired

• Schniz/fnm
• TaKO8Ki/frum

phpup's Issues

Add integration test cases

Windows support

fish-shell support

Support .php-version.toml and argument configure-opts?

Just a suggestion.

For example:

version = "8.1.0"
configure-opts = "--with-iconv=$(brew --prefix libiconv)"

M1 Mac support

Support installing pre-release PHP versions

Would be great to be able to install RC versions of PHP - for example, PHP 8.2 RC3 is currently available at the time of writing but can't be installed by phpup: https://www.php.net/archive/2022.php#2022-09-29-3

Arch linux AUR package

Hi @masan4444, I have created an Arch Linux package on AUR. It uses the binaries provided from this repo releases.

https://aur.archlinux.org/packages/phpup-bin

Don't add phpup into PATH when default is system

When using system version as default phpup adds to PATH the tmp dir symlinked to /usr/bin. This is confusing because every binary installed in your system shows as running from phpup path in process managers.