brew tap shivammathur/php

PHP Support

PHP Version	NTS Formula	Debug Formula	ZTS Formula	Debug ZTS Formula
PHP 5.6	`php@5.6`	`php@5.6-debug`	`php@5.6-zts`	`php@5.6-debug-zts`
PHP 7.0	`php@7.0`	`php@7.0-debug`	`php@7.0-zts`	`php@7.0-debug-zts`
PHP 7.1	`php@7.1`	`php@7.1-debug`	`php@7.1-zts`	`php@7.1-debug-zts`
PHP 7.2	`php@7.2`	`php@7.2-debug`	`php@7.2-zts`	`php@7.2-debug-zts`
PHP 7.3	`php@7.3`	`php@7.3-debug`	`php@7.3-zts`	`php@7.3-debug-zts`
PHP 7.4	`php@7.4`	`php@7.4-debug`	`php@7.4-zts`	`php@7.4-debug-zts`
PHP 8.0	`php@8.0`	`php@8.0-debug`	`php@8.0-zts`	`php@8.0-debug-zts`
PHP 8.1	`php@8.1`	`php@8.1-debug`	`php@8.1-zts`	`php@8.1-debug-zts`
PHP 8.2	`php@8.2`	`php@8.2-debug`	`php@8.2-zts`	`php@8.2-debug-zts`
PHP 8.3	`php` or `php@8.3`	`php-debug` or `php@8.3-debug`	`php-zts` or `php@8.3-zts`	`php-debug-zts` or `php@8.3-debug-zts`
PHP 8.4.0-dev	`php@8.4`	`php@8.4-debug`	`php@8.4-zts`	`php@8.4-debug-zts`

For each PHP version, we have formulae with thread-safety support (zts) and debug symbols support (debug) and both (debug-zts) as well. The formulae with debug symbols can be used when building or debugging PHP extensions and are not recommended for production usage. The formulae with thread-safety support can be used with applications that require multi-threading support.

OS Support

Operating System	Architecture
Linux	`x86_64`
macOS Monterey	`x86_64`, `arm64`
macOS Ventura	`x86_64`, `arm64`
macOS Sonoma	`x86_64`, `arm64`

Usage

Prerequisites

On macOS, install Xcode Command Line Utilities:

xcode-select --install

On Linux, install cURL and Git:

# Using APT
sudo apt-get install -y curl git

# Using Yum
sudo yum install -y curl git

Install Homebrew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

If previously installed, update homebrew and the formulae:

brew update

If you have packages from old homebrew/php tap, refer to this guide for removing them.

Add this tap

Fetch the formulae in this tap:

brew tap shivammathur/php

Install PHP

See PHP Support for available formulae.

For example, to install PHP 8.3:

brew install shivammathur/php/php@8.3

After installing you have to link it:

brew link --overwrite --force shivammathur/php/php@8.3

Restart the terminal and test your PHP version:

php -v

Upgrade your PHP version

You can upgrade your PHP version to the latest patch release.

For example, to upgrade PHP 8.3:

brew upgrade shivammathur/php/php@8.3

Switch between PHP versions

If you have multiple PHP versions installed, you can switch between them easily.

For example, to switch to PHP 8.3:

brew link --overwrite --force shivammathur/php/php@8.3

If you get a warning like below, then do as recommended:

Warning: Already linked: <Cellar Path>
To relink:
  brew unlink <formula> && brew link <formula>

brew unlink php@8.3
brew link --overwrite --force shivammathur/php/php@8.3

Restart your webserver

If you are using Apache or Nginx with php-fpm, restart your webserver after any change in your PHP.

For Apache (httpd):

brew services restart httpd

For Nginx:

brew services restart nginx

Debugging

Make sure you ran brew update before installing PHP.
Run brew doctor and fix the warnings it reports.
Make sure homebrew has correct permissions.

sudo chown -R "$(id -un)":"$(id -gn)" $(brew --prefix)

If PHP is not working after a macOS update. Reinstall PHP along with its dependencies.

For example to reinstall PHP 8.3 and its dependencies:

brew reinstall $(brew deps shivammathur/php/php@8.3) shivammathur/php/php@8.3

Check if your issue is a Homebrew's common issue.
If you are still facing an issue, please create a discussion thread here.

License

The code in this project is licensed under the MIT license. Please see the license file for more information.

This project has some dependencies, and their license can be found here.

Contributions

Contributions are welcome! Please see Contributor's Guide before you start. If you face any issues while using this tap or want to suggest a feature/improvement, create an discussion thread here.