Repository files navigation

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.

• On macOS, install Xcode Command Line Utilities:

xcode-select --install

• On Linux, install cURL and Git:

# Using APTsudo apt-get install -y curl git# Using Yumsudo yum install -y curl git

• Install Homebrew:

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

• If previously installed, update homebrew and the formulae:

brew update

• If you have packages from oldhomebrew/php tap, refer tothis guide for removing them.

Fetch the formulae in this tap:

brew tap shivammathur/php

SeePHP Support for available formulae.

• For example, to installPHP 8.5:

brew install shivammathur/php/php@8.5

• After installing you have to link it:

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

• Restart the terminal and test your PHP version:

php -v

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

For example, to upgradePHP 8.5:

brew upgrade shivammathur/php/php@8.5

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

For example, to switch toPHP 8.5:

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

• 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.5brew link --overwrite --force shivammathur/php/php@8.5

If you are usingApache orNginx withphp-fpm, restart your webserver after any change in your PHP.

• For Apache (httpd):

brew services restart httpd

• For Nginx:

brew services restart nginx

• Make sure you ranbrew update before installing PHP.

• Runbrew 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 reinstallPHP 8.5 and its dependencies:

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

• Check if your issue is a Homebrew'scommon issue.

• If you are still facing an issue, please create a discussion threadhere.

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

This project has somedependencies, and their license can be foundhere.

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

In addition to GitHub Actions, we useMacStadium for our CI infrastructure.

This project is generously supported by many other users and organisations viaGitHub Sponsors.

• shivammathur/homebrew-extensions
• shivammathur/setup-php

• Homebrew/brew
• Homebrew/homebrew-core
• Homebrew/actions