# homebrew-php

**Repository Path**: flyingblazer/homebrew-php

## Basic Information

- **Project Name**: homebrew-php
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-03
- **Last Updated**: 2026-03-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <a href="https://github.com/shivammathur/homebrew-php" target="_blank">
    <img src="https://repository-images.githubusercontent.com/229187949/f140f880-4c25-11eb-8105-aefec9dc7c66" alt="Homebrew Tap for PHP" width="560">
  </a>
</p>

<h1 align="center">brew tap shivammathur/php</h1>

<p align="center">
  <a href="https://github.com/shivammathur/homebrew-php" title="Homebrew tap to install PHP: Builds">
    <img alt="Build status" src="https://github.com/shivammathur/homebrew-php/workflows/Update%20and%20Build%20Formulae/badge.svg">
  </a>
  <a href="https://github.com/shivammathur/homebrew-php" title="Homebrew tap to install PHP: Tests">
    <img alt="Test status" src="https://github.com/shivammathur/homebrew-php/actions/workflows/test.yml/badge.svg">
  </a>
  <a href="https://github.com/shivammathur/homebrew-php/blob/main/LICENSE" title="license">
    <img alt="LICENSE" src="https://img.shields.io/badge/license-MIT-428f7e.svg?logo=open%20source%20initiative&logoColor=white&labelColor=555555">
  </a>
  <a href="https://github.com/shivammathur/homebrew-php/tree/main/Formula" title="Formulae for PHP versions">
    <img alt="PHP Versions Supported" src="https://img.shields.io/badge/php-5.6%20to%208.6-777bb3.svg?logo=php&logoColor=white&labelColor=555555">
  </a>
</p>
<p align="center">
  <a href="https://github.com/shivammathur/homebrew-php#os-support" title="Linux x86_64 supported">
    <img alt="Linux architectures supported" src="https://img.shields.io/badge/Linux-x86__64%20-f6ab01?logo=linux&logoColor=555555&labelColor=ffffff">
  </a>
  <a href="https://github.com/shivammathur/homebrew-php#os-support" title="Apple Intel x86_64 supported">
    <img alt="macOS architectures supported" src="https://img.shields.io/badge/macOS-Intel%20x86__64%20-007DC3?logo=apple&logoColor=555555&labelColor=ffffff">
  </a>
  <a href="https://github.com/shivammathur/homebrew-php#os-support" title="Apple M1 arm64 supported">
    <img alt="macOS architectures supported" src="https://img.shields.io/badge/macOS-Apple%20arm64%20-c0476d?logo=apple&logoColor=555555&labelColor=ffffff">
  </a>
</p>

## 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@8.3`          | `php@8.3-debug`                | `php@8.3-zts`              | `php@8.3-debug-zts`                    |
| PHP 8.4       | `php@8.4`          | `php@8.4-debug`                | `php@8.4-zts`              | `php@8.4-debug-zts`                    |
| PHP 8.5       | `php` or `php@8.5` | `php-debug` or `php@8.5-debug` | `php-zts` or `php@8.5-zts` | `php-debug-zts` or `php@8.5-debug-zts` |
| PHP 8.6.0-dev | `php@8.6`          | `php@8.6-debug`                | `php@8.6-zts`              | `php@8.6-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`, `arm64` |
| macOS Sonoma     | `x86_64`, `arm64` |
| macOS Sequoia    | `x86_64`, `arm64` |
| macOS Tahoe      | `x86_64`, `arm64` |

## Usage

### Prerequisites

- On macOS, install Xcode Command Line Utilities:

```zsh
xcode-select --install
```

- On Linux, install cURL and Git:

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

# Using Yum
sudo yum install -y curl git
```

- Install Homebrew:

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

- If previously installed, update homebrew and the formulae:

```zsh
brew update
```

- If you have packages from old `homebrew/php` tap, refer to [this guide](https://github.com/shivammathur/homebrew-php/wiki/Cleanup) for removing them.

### Add this tap

Fetch the formulae in this tap:

```zsh
brew tap shivammathur/php
```

### Install PHP

> See [PHP Support](#php-support) for available formulae.

- For example, to install `PHP 8.5`:

```zsh
brew install shivammathur/php/php@8.5
```

- After installing you have to link it:

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

- Restart the terminal and test your PHP version:

```zsh
php -v
```

### Upgrade your PHP version

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

For example, to upgrade `PHP 8.5`:

```zsh
brew upgrade shivammathur/php/php@8.5
```

### Switch between PHP versions

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

For example, to switch to `PHP 8.5`:

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

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

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

```zsh
brew unlink php@8.5
brew link --overwrite --force shivammathur/php/php@8.5
```

### 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`):

```zsh
brew services restart httpd
```
- For Nginx:

```zsh
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.

```zsh
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.5` and its dependencies:

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

- Check if your issue is a Homebrew's [common issue](https://docs.brew.sh/Common-Issues).

- If you are still facing an issue, please create a discussion thread [here](https://github.com/shivammathur/homebrew-php/discussions).

## License

The code in this project is licensed under the [MIT license](http://choosealicense.com/licenses/mit/).
Please see the [license file](LICENSE) for more information.

This project has some [dependencies](#dependencies), and their license can be found [here](LICENSE_HOMEBREW).


## Contributions

Contributions are welcome!
Please see [Contributor's Guide](.github/CONTRIBUTING.md "shivammathur/homebrew-php contribution 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](https://github.com/shivammathur/homebrew-php/discussions "shivammathur/php discussions").

## Sponsors

In addition to GitHub Actions, we use [MacStadium](https://www.macstadium.com/opensource/members) for our CI infrastructure.

<a href="https://www.macstadium.com/company/opensource#gh-light-mode-only">
    <img src="https://setup-php.com/sponsors/macstadium.png" alt="Mac Stadium" width="200px">
</a>
<a href="https://www.macstadium.com/company/opensource#gh-dark-mode-only">
    <img src="https://setup-php.com/sponsors/macstadium-white.png" alt="Mac Stadium" width="200px">
</a>

This project is generously supported by many other users and organisations via [GitHub Sponsors](https://github.com/sponsors/shivammathur).

<a href="https://github.com/sponsors/shivammathur"><img src="https://setup-php.com/sponsors.svg?" alt="Sponsor shivammathur"></a>

## Related Projects

- [shivammathur/homebrew-extensions](https://github.com/shivammathur/homebrew-extensions "Tap for PHP extensions")
- [shivammathur/setup-php](https://github.com/shivammathur/setup-php "Setup PHP in GitHub Actions")

## Dependencies

- [Homebrew/brew](https://github.com/Homebrew/brew "Homebrew GitHub Repo")
- [Homebrew/homebrew-core](https://github.com/Homebrew/homebrew-core "Homebrew core tap")
- [Homebrew/actions](https://github.com/Homebrew/actions "Homebrew GitHub Actions")