README.md

April 11, 2026 · View on GitHub

brew tap shivammathur/extensions

Extensions

Extension	PHP Version
`amqp`	`PHP 5.6` to `PHP 8.6`
`apcu`	`PHP 5.6` to `PHP 8.6`
`ast`	`PHP 7.0` to `PHP 8.6`
`brotli`	`PHP 5.6` to `PHP 8.6`
`couchbase`	`PHP 5.6` to `PHP 8.6`
`decimal`	`PHP 7.0` to `PHP 8.6`
`ds`	`PHP 7.0` to `PHP 8.6`
`event`	`PHP 5.6` to `PHP 8.6`
`excimer`	`PHP 7.1` to `PHP 8.6`
`expect`	`PHP 5.6` to `PHP 8.6`
`gearman`	`PHP 5.6` to `PHP 8.6`
`gmagick`	`PHP 5.6` to `PHP 8.6`
`gnupg`	`PHP 5.6` to `PHP 8.6`
`grpc`	`PHP 5.6` to `PHP 8.6`
`igbinary`	`PHP 5.6` to `PHP 8.6`
`imagick`	`PHP 5.6` to `PHP 8.6`
`imap`	`PHP 5.6` to `PHP 8.6`
`interbase`	`PHP 5.6` to `PHP 8.6`
`lua`	`PHP 5.6` to `PHP 7.4`
`mailparse`	`PHP 5.6` to `PHP 8.6`
`maxminddb`	`PHP 7.2` to `PHP 8.6`
`mcrypt`	`PHP 5.6` to `PHP 8.6`
`memcache`	`PHP 5.6` to `PHP 8.6`
`memcached`	`PHP 5.6` to `PHP 8.6`
`mongodb1`	`PHP 8.1` to `PHP 8.6`
`mongodb`	`PHP 5.6` to `PHP 8.6`
`msgpack`	`PHP 5.6` to `PHP 8.6`
`newrelic`	`PHP 7.4` to `PHP 8.4`
`oauth`	`PHP 5.6` to `PHP 8.6`
`opentelemetry`	`PHP 8.0` to `PHP 8.6`
`pcov`	`PHP 7.1` to `PHP 8.6`
`pdo_firebird`	`PHP 7.0` to `PHP 8.6`
`pdo_sqlsrv`	`PHP 7.0` to `PHP 8.6`
`pecl_http`	`PHP 5.6` to `PHP 8.6`
`pinba`	`PHP 7.0` to `PHP 8.6`
`phalcon3`	`PHP 5.6` to `PHP 7.3`
`phalcon4`	`PHP 7.2` to `PHP 7.4`
`phalcon5`	`PHP 7.4` to `PHP 8.4`
`propro`	`PHP 5.6` to `PHP 7.4`
`protobuf`	`PHP 5.6` to `PHP 8.6`
`psr`	`PHP 5.6` to `PHP 8.6`
`raphf`	`PHP 5.6` to `PHP 8.6`
`rdkafka`	`PHP 5.6` to `PHP 8.6`
`redis`	`PHP 5.6` to `PHP 8.6`
`seaslog`	`PHP 5.6` to `PHP 8.6`
`scalar_objects`	`PHP 7.0` to `PHP 8.6`
`snmp`	`PHP 5.6` to `PHP 8.3`
`sqlsrv`	`PHP 7.0` to `PHP 8.6`
`ssh2`	`PHP 5.6` to `PHP 8.6`
`spx`	`PHP 5.6` to `PHP 8.6`
`swoole`	`PHP 5.6` to `PHP 8.5`
`swow`	`PHP 8.0` to `PHP 8.5`
`uopz`	`PHP 5.6` to `PHP 8.6`
`uploadprogress`	`PHP 5.6` to `PHP 8.6`
`uuid`	`PHP 5.6` to `PHP 8.6`
`v8js`	`PHP 7.0` to `PHP 8.6`
`vips`	`PHP 7.0` to `PHP 8.6`
`vld`	`PHP 5.6` to `PHP 8.3`
`xdebug`	`PHP 5.6` to `PHP 8.6`
`xdebug2`	`PHP 7.2` to `PHP 7.4`
`xhprof`	`PHP 7.0` to `PHP 8.6`
`xlswriter`	`PHP 7.0` to `PHP 8.6`
`yaml`	`PHP 5.6` to `PHP 8.6`
`zmq`	`PHP 5.6` to `PHP 8.6`
`zstd`	`PHP 7.0` to `PHP 8.6`

OS Support

Operating System	Architecture
Linux	`x86_64`
macOS Tahoe	`x86_64`, `arm64`
macOS Sequoia	`x86_64`, `arm64`
macOS Sonoma	`x86_64`, `arm64`

Usage

Prerequisites

Update homebrew and the formulae:

brew update

Check that the required PHP version is installed. This tap works with PHP from both shivammathur/php tap and homebrew/core tap:

php -v

If not, install the required PHP version. For example, to install PHP 8.4:

brew tap shivammathur/php
brew install shivammathur/php/php@8.4
brew link --force --overwrite shivammathur/php/php@8.4

Refer to shivammathur/php tap for more information about installing PHP.

Install PHP Extensions

Add Tap shivammathur/extensions:

brew tap shivammathur/extensions

Then install the required extension. See Formula directory for available formulae.
For example, to install Xdebug on PHP 8.4:

brew install shivammathur/extensions/xdebug@8.4

Upgrade extensions

For example, to upgrade Xdebug on PHP 8.4.

brew upgrade shivammathur/extensions/xdebug@8.4

Restart your webserver

If you are using Apache or Nginx with php-fpm, restart your webserver after installing or updating any PHP extensions.

For Apache (httpd):

brew services restart httpd

For Nginx:

brew services restart nginx

Debugging

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

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

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

The code in this project is licensed under the MIT license. Please see the license file for more information. This project has multiple dependencies. Their licenses can be found in their respective repositories.

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 a discussion thread here.

README.md

brew tap shivammathur/extensions

Extensions

OS Support

Usage

Prerequisites

Install PHP Extensions

Upgrade extensions

Restart your webserver

Debugging

License

Contributions

Sponsors

Dependencies

Extensions

Homebrew

Formulae dependencies