v4.1

PHP Monitor 4.1 now requires at least macOS 11 (Big Sur). If you're using an older version of macOS, please install v4.0.

The recommended way of upgrading is running brew upgrade phpmon after you've installed PHP Monitor using Homebrew. It is recommended to run composer global update && valet install after upgrading, as this updates both Valet and your other dependencies.

What’s New In v4.1

• Valet version detection. PHP Monitor will now alert you when your version of Valet does not properly support the latest version of PHP. Currently this means you need at least Valet 2.16.2 installed.
• Detect Valet sites. PHP Monitor now has the option to display all linked and parked domains in a convenient list. You can then perform common operations on these sites: open them in your browser, secure/unsecure, unlink, open in your favorite editor... all from a single right-click! (Linking via the GUI is currently not possible yet, that’s coming later.)
• Tweaked indicator in menu bar. Instead of just showing the version number, there’s a little bit of text on the left that says "PHP", to make it clear that this is PHP Monitor in action. (This was done to use as little space as possible, and as such there is currently no preference to disable this. I might add one later.)

This release also includes further refinements and bug fixes.

v4.0

Upgrade Instructions

The recommended way of upgrading is running brew upgrade phpmon after you've installed PHP Monitor using Homebrew.
Because a new version of PHP has dropped, however, it is recommended that you run the following:

brew update
brew upgrade phpmon
brew upgrade php
brew install [email protected]
valet install

This will upgrade your PHP installation to 8.1, and install 8.0 (which was previously the latest, stable release).
If you are having issues with conflicts or incorrect linking, please see #54.

What’s New In v4.0

• Added an option to view the full PHP version number in the menu bar and switcher (#53)
• Added an option to automatically restart PHP-FPM when an extension is toggled (#32)
• Added support for symlinked .ini files in the .conf.d directory (requires gsed, which is installed as a dependency if you install or upgrade via Homebrew; users who download the app will need to run brew install gnu-sed to support this functionality) (#47)
• Added php alias conflict detection, which is hopefully not needed once you've run brew update (#56).

v3.5

The recommended way of upgrading is running brew upgrade phpmon after you've installed PHP Monitor using Homebrew. If you haven't, you can download the .zip below. It is recommended to run valet install after upgrading.

Here's what's changed:

• Added support for macOS Monterey
• Added support for PHP 8.1 and 8.2 (currently pre-release versions, installable via here)

These minor changes were also made:

• Improved detection of extensions (#45)
• Adjusted notification body to fit in a single line on macOS Monterey (now that the icon is larger)
• Code style fixes & minor performance improvements

Download available below or via Homebrew. SHA256: dd709325d41d842aeb773162431f946eb9493d285d994936804c1af45e4c7038

v3.4

The recommended way of upgrading is running brew upgrade phpmon after you've installed PHP Monitor using Homebrew. If you haven't, you can download the .zip below. It is recommended to run valet install after upgrading.

New in this release:

• Global hotkey added: You can now go to Preferences and set up a global hotkey to trigger PHP Monitor.
• More hotkeys: Each item that triggers an action should now have a shortcut; extensions are limited to the first nine (extensions 10 and onwards don't have a shortcut).
• Scan all .ini files: Often requested, and finally here. All your .ini files are now scanned for extensions.
• Speed boost for PHP version switch: The brew commands that PHP Monitor runs in the background are now parallelized (where possible) so you should see a speed boost of a few seconds if you have multiple PHP versions installed.
• Detect broken PHP-FPM configuration: Valet actually modifies your PHP-FPM configuration. If you install a new version of PHP and Valet hasn't configured that PHP-FPM instance yet, you'll get 502 Bad Gateway errors until you run valet install again. Now PHP Monitor will let you know what's going on when that happens.
• Locate your global composer.json file. Instantly opens Finder and highlights your global composer file.
• Stop all services has been added, and will let you know via a notification when it is done.
• Restart all services will also let you know when the services are done restarting via an additional notification.

As usual, if you encounter any issues with this new release, please let me know by creating an issue.

v3.3

• PHP Monitor now lets you refresh the information that it displays on command, instead of just having to wait for the information to update. Just press Command-R to refresh the menu, just like you would in a browser. (Alternatively, you can press the menu item, too.) PHP Monitor's menu opens again automatically to display the updated information. (#24)

• Not a fan of the PHP version number in your menu bar? I get it! You can now go to Preferences in the menu and deselect "Show a dynamic icon in the menu bar" to get a simple truck icon instead. Enjoy. (#25)

• If you've got Valet installed in ~/.composer/vendor/bin/valet but not symlinked, PHP Monitor will now work correctly. (#27)

• In rare scenarios, duplicate menu items of "Switch to PHP X" would appear. This should now no longer happen. (#30)

• The "About PHP Monitor" option now also shows useful links to this repository and directly links to the FAQ & Troubleshooting section.

v3.2

Important: It is a good idea to run valet install after upgrading to a new version of PHP Monitor. If you are encountering issues, please check out the Quick Troubleshooting section in the README.

• PHP Monitor now respects valet installed in either /usr/local/bin/valet or /opt/homebrew/bin/valet. This was causing issues for new Valet installations.

• The method that is used to determine the presence of Valet has changed; which valet isn't used, only the existence of a binary is checked. If the file exists (in either /usr/local/bin or /opt/homebrew/bin) then PHP Monitor will start up. (This should fix issues with new installations on brand new Apple Silicon systems.)

v3.1

Important: It is a good idea to run valet install after upgrading to a new version of PHP Monitor. If you are encountering issues, please check out the Quick Troubleshooting section in the README.

• PHP Monitor now respects valet installed in either /usr/local/bin/valet or /opt/homebrew/bin/valet. This was causing issues for new Valet installations.
• PHP Monitor now runs on macOS Mojave, but you should probably upgrade to Big Sur if you can.

v3.0

Important: It is a good idea to run valet install after upgrading to a new version of PHP Monitor. If you are encountering issues, please check out the Quick Troubleshooting section in the README.

• PHP Monitor now shows you various limits (max POST size, max upload size, memory limit) for the currently active PHP installation. This information is refreshed every minute.
• You can now see all user-installed extensions that have been enabled for each individual PHP installation. The extensions shown apply to the currently active installation. You can toggle them off individually. (Previously, there was a hard-coded check for Xdebug.)

v2.6

Important: It is a good idea to run valet install after upgrading to a new version of PHP Monitor. If you are encountering issues, please check out the Troubleshooting section in the README.

• PHP Monitor 2.6 now supports Homebrew installations in /opt/homebrew (/opt/homebrew takes precedence)
• Adds support for restarting dnsmasq
• Adds support for restarting all services at once

v2.5

Important: If you have upgraded to PHP 8.0, please run brew install [email protected], composer global update and valet install to upgrade the dependencies. This should get Valet into a workable state at which point you can make good use of PHP Monitor.

• Initial compatibility with PHP 8.0.0 via Homebrew
• PHP Monitor now no longer requires you have the latest version of PHP installed: it will determine via brew info php --json what version of PHP you have installed
• If you only have php installed and you don't have [email protected] or [email protected] installed, that version now appears in the switcher
• A new feature has been added that allows you to quickly check the phpinfo() of your current PHP setup