phpvm

phpvm is a simple command-line tool for managing multiple PHP versions on macOS, built with Go.

Requirements

• macOS: This tool is designed for macOS environments.
• Homebrew: phpvm relies on Homebrew for installing PHP versions. Ensure you have Homebrew installed.

Installation

Using go cli

go install github.com/jrmd/phpvm

Using brew

brew tap jrmd/tools
brew install phpvm

Configuration

To make phpvm available in your terminal, you need to add its binary directory to your PATH and set up shell completion.

Add the following lines to your shell configuration file (e.g., ~/.zshrc, ~/.bash_profile, ~/.config/fish/config.fish):

eval"$(phpvm completion <your_shell>)"# Replace <your_shell> with your shell (e.g., zsh, bash)eval"$(phpvm env <your_shell>)"

After adding these lines, reload your shell configuration:

source~/.zshrc # Or your shell config file

Usage

phpvm [command]
Available Commands:
cd Use composer php requirements
completion Generate the autocompletion script for the specified shell
default Apply default version
help Help about any command
install Install a version of PHP
use Set a version of PHP to use
Flags:
-h, --help help for phpvm

### php env [shell]

Sets up the env variables for the specified shell.

Print and set up required environment variables for bash, zsh, fish
Usage:
phpvm env [shell] [flags]
Flags:
-h, --help help for env
-m, --multi-shell Different phpversion per shell
-n, --now run phpvm use now
-c, --use-on-cd Use phpvm cd on cd

e.g phpvm env zsh --use-on-cd --multi-shell

phpvm cd

Takes the php value from composer.json's require section and attempts to switch to a compatible PHP version.

$ phpvm cd --help
Takes the php value composer.json's requireUsage: phpvm cd [flags]Flags: -h, --help help for cd

phpvm completion

Generate the autocompletion script for phpvm for the specified shell. See each sub-command's help for details on how to use the generated script.

$ phpvm completion --help
Generate the autocompletion script for phpvm for the specified shell.
See each sub-command's help for details on how to use the generated script.Usage: phpvm completion [command] Available Commands: bash Generate the autocompletion script for bash fish Generate the autocompletion script for fish powershell Generate the autocompletion script for powershell zsh Generate the autocompletion script for zshFlags: -h, --help help for completion

phpvm default

Applies the default PHP version that was set with the --default flag during install or use.

$ phpvm default
Apply default version
Usage:
phpvm default [flags]
Aliases:
default, d
Flags:
-h, --help helpfor default

phpvm use

Sets a specific version of PHP to be used in the current terminal session.

$ phpvm use --help
Set a version of PHP to use
Usage:
phpvm use [version] [flags]
Aliases:
use, u
Flags:
-d, --default Set as the version as the default version
-h, --help helpfor use

phpvm install

Installs a specific version of PHP using Homebrew.

$ phpvm install --help
Install a version of PHP
Usage:
phpvm install [version] [flags]
Aliases:
install, i
Flags:
-d, --default Set as the version as the default version
-h, --help helpfor install
-u, --use Set as the version once installed

Example:

install 8.4 and set it as the default and set it to using.

phpvm install -ud 8.4