feat: add Homebrew-PHP plugin

[naviapis]

Summary

Description:

• Homebrew-based PHP plugin for asdf and mise.
  Installs PHP via the shivammathur/homebrew-php tap on macOS.

• Tool repo URL: https://github.com/naviapps/asdf-homebrew-php

• Plugin repo URL: https://github.com/naviapps/asdf-homebrew-php

Checklist

• Format with scripts/format.bash
• Test locally with scripts/test_plugin.bash --file plugins/homebrew-php
• Your plugin CI tests are green
  • Tip: using the plugin_test action from asdf-actions in plugin CI

[davidjeddy]

My apologies if I am missing context for this, would it not be more pragmatic to use the existing https://github.com/asdf-community/asdf-php plugin? asdf-php does not require homebrew nor MacOs host. Reducing the dependency chain from macos->asdf->homebrew->php to asdf->php.

[naviapis]

@davidjeddy Thanks for the question.

I agree that asdf-php is the most general and portable option. However, on macOS the php-build backend frequently breaks due to Homebrew dependency changes (OpenSSL, ICU, libzip, Xcode/clang updates, etc.). These issues happen regularly and many macOS users run into repeated build failures.

For most macOS environments, Homebrew’s PHP (shivammathur/homebrew-php) is actually the most stable and commonly used PHP distribution — including on GitHub Actions macOS runners. This plugin simply exposes those Homebrew-managed PHP versions to asdf/mise without introducing a separate build toolchain.

So this project is not a replacement for asdf-php.
It is a macOS-specific complementary backend for users who already rely on Homebrew PHP and want a stable, fast, and consistent way to switch PHP versions via asdf/mise.