v25.08

PHP Monitor 25.08 is now available with various speed improvements for Homebrew operations, automatic fixes for recommendations, and a new feature that lets you upgrade Laravel Valet via the GUI. You will be able to see if updates are available in the menu bar menu, but you can (as always) turn this feature off by disabling the relevant menu section if you like a simpler menu.

How to install or upgrade

If you have an existing PHP Monitor.app in your Applications folder you can use the built-in updater.

If you haven't installed PHP Monitor yet, you can click here to download the app. Place the app in your Applications folder and you may want to consult the README file for some more information.

Important

macOS 13.5 is the minimum required version of macOS in order to run PHP Monitor.
You can keep using an older version of PHP Monitor if you cannot upgrade your Mac.

What's New

• The app now checks if there is a newer version of Valet available at launch, and displays if an upgrade is available below the driver.
• A new preference has been added to toggle displaying the app driver (Standalone Mode, Valet) in the menu. The default is to display it, which also does upgrade version checks. If you are on a previous version of Valet and don't care about updates, you can turn this off.
• If displaying information about the driver is disabled, this Valet upgrade check that occurs when the app launches is disabled.
• If a newer version of Valet is available, you can upgrade to it. If due to the global composer.json the installation of this version of Valet is not possible, you will be notified about this.
• Some recommendations made by PHP Doctor can now be automatically addressed ("automatic fix" functionality):
  • Any missing taps related to PHP and/or PHP extensions can be installed automatically. These are important if the PHP Version Manager and/or PHP Extension Manager are to work correctly.
  • In case Xdebug is missing xdebug.mode, you can have that fixed automatically. This will ensure the menu item to switch modes will be displayed in PHP Monitor's menu.
  • PHP Monitor helpers not included in PATH? Have it added to your .zshrc automatically. This only works if your chosen shell is /bin/zsh (the default). This will let you use the . pm84 type helpers.

What's Changed

• Installing PHP versions and extensions via Homebrew 6.4 or newer now uses the HOMEBREW_DOWNLOAD_CONCURRENCY=auto environment variable, which should significantly speed up installations and upgrades.

v25.07

PHP Monitor 25.07 is now available with various bug fixes and minor additions.

How to install or upgrade

If you have an existing PHP Monitor.app in your Applications folder you can use the built-in updater.

If you haven't installed PHP Monitor yet, you can click here to download the app. Place the app in your Applications folder and you may want to consult the README file for some more information.

Important

macOS 13.5 is now the minimum required version of macOS in order to run PHP Monitor.
You can keep using an older version of PHP Monitor if you cannot upgrade your Mac.

What's New

• PHP Monitor will now internally log how quickly the app boots. This information may be relevant for crash logs.
• The app will now always display in the menu whether Valet is being used (and which version) or not (in case of Standalone Mode).
• Like last month's release: preliminary support for macOS Tahoe (#301), but not built against the new SDK yet.

What's Fixed

• Fixed an issue where securing or unsecuring a domain would fail if a given folder was in use for multiple domains. If you serve a single folder locally as cdn.mydomain.test and www.mydomain.test, securing would fail for the domain that came alphabetically last. This has been resolved if you are running Valet 3 or newer.
• Fixed an issue where the timeout message would be triggered incorrectly.

v25.06

PHP Monitor 25.06 is now available with a few fresh visual touches and some minor bug fixes. I've also written a brief blog post about this release with screenshots.

How to install or upgrade

If you have an existing PHP Monitor.app in your Applications folder you can use the built-in updater.

If you haven't installed PHP Monitor yet, you can click here to download the app. Place the app in your Applications folder and you may want to consult the README file for some more information.

Important

macOS 13.5 is now the minimum required version of macOS in order to run PHP Monitor.
You can keep using an older version of PHP Monitor if you cannot upgrade your Mac.

What's New

• Added icons to PHP Monitor's main menu and to the context menu in the Domains List (#304).
• Updated the PHP Monitor icon for the main app and the PHP Monitor Self-Updater.
• Preliminary support for macOS Tahoe (#301), but not built against the new SDK yet.

What's Changed

• Fixed visibility of spinning indicator when PHP Monitor's domain list window is taking longer than 0.5 sec to complete a task.
• Switched to new versioning system using year and month combination in preparation for a future release later this year.
• Updated certificate for signing this and future builds.

v7.2

PHP Monitor 7.2 is now available with various QoL improvements related to installing and updating Homebrew packages, and comes with experimental support for Spanish and Indonesian translations.

How to install or upgrade

If you have an existing PHP Monitor.app in your Applications folder you can use the built-in updater.

If you haven't installed PHP Monitor yet, you can click here to download the app. Place the app in your Applications folder and you may want to consult the README file for some more information.

Notice
The phpmon-dev formula will be marked as deprecated starting with this release. This does not affect you if you are using the regular or EAP version of PHP Monitor. If you are using a DEV version, this will no longer receive updates. Please update to the stable build (the phpmon formula). Sometime in the future, it is possible that EAP builds will become available to non-sponsors, too.

What's New

• Improved the accuracy of the status message that is being displayed when PHP Monitor is tasking brew to install or update packages.
• Added translations for Spanish and Indonesian (generated using LLMs). The decision to add these languages is based on traffic to my website, I will be adding additional language support in the future. If you notice an issue with one of these translations, please get in touch.

What's Changed

• Fixed missing translations for some languages.
• Replaced Twitter profile link with a new link to my Bluesky profile.
• Added missing historical sponsors to the about screen. Many thanks!
• Fixed an issue with displaying the about screen in the background on the latest version of macOS.
• Updated copyright information. It's a new year, after all!

v7.1

PHP Monitor 7.1 is now available with support for the latest PHP version. This update also contains additional startup checks, lets you add domains as favorites (yay!) and contains a few QoL improvements to the extension manager.

Note: I had originally planned to release this version over the summer. Unfortunately, I've been dealing with burnout so I may not be able to fix issues or follow up on issues as quickly as usual.

How to install or upgrade

If you have an existing PHP Monitor.app in your Applications folder you can use the built-in updater.

If you haven't installed PHP Monitor yet, you can click here to download the app. Place the app in your Applications folder and you may want to consult the README file for some more information.

What's New

• Added support for PHP 8.4 (release version). You may need to update or manually patch Valet.
• Added support for PHP 8.5 (pre-release version). You will need to manually patch Valet.
• Individual sites or proxies (domains in general) can now be favorited by right-clicking on the domain, and choosing "Favorite Domain" or "Unfavorite Domain". Favorited domains will always appear at the top.
• If PHP Monitor seems to stall or hang when starting up due to issues with Homebrew, an alert should be displayed that may be helpful. A link to #294 is included.
• If a PHP formula is (temporarily) unavailable via the shivammathur/php tap, this is indicated in the UI as such.

What's Changed

• PHP Monitor now uses the NVAlert and NVAppUpdater packages. I felt that it was time to remove this generic code from the app, with the intent to improve decoupling.
• Added additional text and button to clarify an upgrade will also keep the old PHP version (e.g. when upgrading PHP 8.3 to 8.4) installed. This is also explained in more detail here.
• Homebrew PHP formulae are now consistently sourced from the shivammathur/php tap.
• Installed extensions now appear at the top of the list of the Extension Manager.
• Installing and removing extensions now scrolls to the extension afterwards, and animates this. This is done to emphasise that the operation succeeded.
• Fixed an issue where a non-sendable Timer could cause certain operations to stall or fail.
• Updated copyright information.

Known Issues

• Some translations for some of the new warnings may be missing. This will be fixed later.

v7.0.6

PHP Monitor 7.0 is now available with a bunch of new features, most notably improved extension management (including "PHP Extension Manager") and administration features. Learn more about all the new features in my blog post.

How to install or upgrade

⚠️ PHP Monitor 5.8 and newer require macOS Monterey 12.4 or newer! Learn more here.

If you have an existing PHP Monitor.app in your Applications folder you can use the built-in updater.

If you haven't installed PHP Monitor yet, you can click here to download the app. Place the app in your Applications folder and you may want to consult the README file for some more information.

Patch History

Version 7.0.6

• Added official support for macOS Sequoia (#290).
• Avoid displaying out-of-date message in PHP Version Manager ("this version is outdated") until November 30th (for more information, see #295).

Version 7.0.5

• PHP Monitor 7.0.5 shipped with an incorrect fix for #295 and this broken release has been removed.

Version 7.0.4

• PHP Monitor Self-Updater is built as part of the main target build process.
• Chinese translations added (contributed by @guanguans, via #285).
• Fixed an issue with Bedrock projects not being recognized correctly (reported by @chrillep, via #287).
• Added the context actions for a selected site to PHP Monitor's main menu. This will allow you to customize the menu hotkeys if needed via System Settings (reported by @renecum, via #289).
• The PHP-FPM process will be automatically restarted after installing or removing extensions. This will ensure certain extensions always work after installing them, like Imagick and Redis, without requiring you to perform the restart manually (#292).

Version 7.0.3

• Some minor UI fixes have been made in the PHP compatibility popover if you have many PHP versions.
• Automatic site isolation suggestions for older versions of PHP has been added to the PHP compatibility popover if your installation of Valet supports it. If not supported, switching your global PHP version is suggested instead.

Version 7.0.2

• From this version on, resolving PHP upgrades happens based on the formula name. This avoids issues where available PHP version upgrades would not be detected correctly (based on the installed version).
• The "busy" overlay that used to be transparent is now opaque to avoid displaying outdated and incorrect info while PHP Monitor upgrades your PHP versions.
• Made some visual improvements to PHP Version Manager. Now the PHP logo is used as the icon in the view, and the "upgrade all" button has been made more enticing.
• If no domains are available in the domains list (due to not having any domains or due to your search operation being too specific), a custom view will be displayed to encourage you to add a domain.
• Both the PHP Version Manager and PHP Extension Manager windows can now be freely resized instead of being restricted to a fixed size. There is a minimum size constraint specified in order to avoid UI issues.

Version 7.0.1

• Fixed a critical issue with extensions not being detected on Intel Mac systems under some circumstances. (#275)
• Added an alert that instructs you to run brew tap shivammathur/extensions if the list of extensions remains empty. (#275)

What's New

• "PHP Version Manager..." is now listed as "Manage PHP Versions...".
• Added the PHP Extension Manager (accessible via "Manage PHP Extensions...") which allows you to manage PHP extensions for any of the usable PHP versions.
• You can filter extensions with the search field, and switch between which PHP version you'd like to manage extensions.
• You can now install and remove extensions and their dependencies with one click. These operations are managed by Homebrew, and may install other dependencies.
• You can now choose a custom display language for PHP Monitor via Settings. (You will need to restart the app to make sure all translations are correctly loaded, but you can preview this change by checking the main menu, which will always be correctly translated.)
• It is now possible to toggle specific extensions on a per PHP version basis via the Domains list. To toggle an extension, right-click on a site that is currently using a different PHP version. You will then be toggling extensions for that version of PHP.
• When the app boots, the integrity of the PHP symlinks are checked to ensure that all symlinks correctly link to the correct PHP version. If any links to an incorrect PHP version, then those outdated or incorrect symlinks will be removed, which avoids a variety of issues with PHP Monitor and Homebrew.

Notes: There are some restrictions related to managing extensions. You cannot remove extensions that are dependencies of other extensions (without removing the dependent first), and you cannot manage external extensions, i.e. extensions that were installed via pecl.

v7.0.4

PHP Monitor 7.0 is now available with a bunch of new features, most notably improved extension management (including "PHP Extension Manager") and administration features. Learn more about all the new features in my blog post.

How to install or upgrade

⚠️ PHP Monitor 5.8 and newer require macOS Monterey 12.4 or newer! Learn more here.

If you have an existing PHP Monitor.app in your Applications folder you can use the built-in updater.

If you haven't installed PHP Monitor yet, you can click here to download the app. Place the app in your Applications folder and you may want to consult the README file for some more information.

Patch History

Version 7.0.4

• PHP Monitor Self-Updater is built as part of the main target build process.
• Chinese translations added (contributed by @guanguans, via #285).
• Fixed an issue with Bedrock projects not being recognized correctly (reported by @chrillep, via #287).
• Added the context actions for a selected site to PHP Monitor's main menu. This will allow you to customize the menu hotkeys if needed via System Settings (reported by @renecum, via #289).
• The PHP-FPM process will be automatically restarted after installing or removing extensions. This will ensure certain extensions always work after installing them, like Imagick and Redis, without requiring you to perform the restart manually (#292).

Version 7.0.3

• Some minor UI fixes have been made in the PHP compatibility popover if you have many PHP versions.
• Automatic site isolation suggestions for older versions of PHP has been added to the PHP compatibility popover if your installation of Valet supports it. If not supported, switching your global PHP version is suggested instead.

Version 7.0.2

• From this version on, resolving PHP upgrades happens based on the formula name. This avoids issues where available PHP version upgrades would not be detected correctly (based on the installed version).
• The "busy" overlay that used to be transparent is now opaque to avoid displaying outdated and incorrect info while PHP Monitor upgrades your PHP versions.
• Made some visual improvements to PHP Version Manager. Now the PHP logo is used as the icon in the view, and the "upgrade all" button has been made more enticing.
• If no domains are available in the domains list (due to not having any domains or due to your search operation being too specific), a custom view will be displayed to encourage you to add a domain.
• Both the PHP Version Manager and PHP Extension Manager windows can now be freely resized instead of being restricted to a fixed size. There is a minimum size constraint specified in order to avoid UI issues.

Version 7.0.1

• Fixed a critical issue with extensions not being detected on Intel Mac systems under some circumstances. (#275)
• Added an alert that instructs you to run brew tap shivammathur/extensions if the list of extensions remains empty. (#275)

What's New

• "PHP Version Manager..." is now listed as "Manage PHP Versions...".
• Added the PHP Extension Manager (accessible via "Manage PHP Extensions...") which allows you to manage PHP extensions for any of the usable PHP versions.
• You can filter extensions with the search field, and switch between which PHP version you'd like to manage extensions.
• You can now install and remove extensions and their dependencies with one click. These operations are managed by Homebrew, and may install other dependencies.
• You can now choose a custom display language for PHP Monitor via Settings. (You will need to restart the app to make sure all translations are correctly loaded, but you can preview this change by checking the main menu, which will always be correctly translated.)
• It is now possible to toggle specific extensions on a per PHP version basis via the Domains list. To toggle an extension, right-click on a site that is currently using a different PHP version. You will then be toggling extensions for that version of PHP.
• When the app boots, the integrity of the PHP symlinks are checked to ensure that all symlinks correctly link to the correct PHP version. If any links to an incorrect PHP version, then those outdated or incorrect symlinks will be removed, which avoids a variety of issues with PHP Monitor and Homebrew.

Notes: There are some restrictions related to managing extensions. You cannot remove extensions that are dependencies of other extensions (without removing the dependent first), and you cannot manage external extensions, i.e. extensions that were installed via pecl.

v7.0.3

PHP Monitor 7.0 is now available with a bunch of new features, most notably improved extension management (including "PHP Extension Manager") and administration features. Learn more about all the new features in my blog post.

How to install or upgrade

⚠️ PHP Monitor 5.8 and newer require macOS Monterey 12.4 or newer! Learn more here.

If you have an existing PHP Monitor.app in your Applications folder you can use the built-in updater.

If you haven't installed PHP Monitor yet, you can click here to download the app. Place the app in your Applications folder and you may want to consult the README file for some more information.

Patch History

Version 7.0.3

• Some minor UI fixes have been made in the PHP compatibility popover if you have many PHP versions.
• Automatic site isolation suggestions for older versions of PHP has been added to the PHP compatibility popover if your installation of Valet supports it. If not supported, switching your global PHP version is suggested instead.

Version 7.0.2

• From this version on, resolving PHP upgrades happens based on the formula name. This avoids issues where available PHP version upgrades would not be detected correctly (based on the installed version).
• The "busy" overlay that used to be transparent is now opaque to avoid displaying outdated and incorrect info while PHP Monitor upgrades your PHP versions.
• Made some visual improvements to PHP Version Manager. Now the PHP logo is used as the icon in the view, and the "upgrade all" button has been made more enticing.
• If no domains are available in the domains list (due to not having any domains or due to your search operation being too specific), a custom view will be displayed to encourage you to add a domain.
• Both the PHP Version Manager and PHP Extension Manager windows can now be freely resized instead of being restricted to a fixed size. There is a minimum size constraint specified in order to avoid UI issues.

Version 7.0.1

• Fixed a critical issue with extensions not being detected on Intel Mac systems under some circumstances. (#275)
• Added an alert that instructs you to run brew tap shivammathur/extensions if the list of extensions remains empty. (#275)

What's New

• "PHP Version Manager..." is now listed as "Manage PHP Versions...".
• Added the PHP Extension Manager (accessible via "Manage PHP Extensions...") which allows you to manage PHP extensions for any of the usable PHP versions.
• You can filter extensions with the search field, and switch between which PHP version you'd like to manage extensions.
• You can now install and remove extensions and their dependencies with one click. These operations are managed by Homebrew, and may install other dependencies.
• You can now choose a custom display language for PHP Monitor via Settings. (You will need to restart the app to make sure all translations are correctly loaded, but you can preview this change by checking the main menu, which will always be correctly translated.)
• It is now possible to toggle specific extensions on a per PHP version basis via the Domains list. To toggle an extension, right-click on a site that is currently using a different PHP version. You will then be toggling extensions for that version of PHP.
• When the app boots, the integrity of the PHP symlinks are checked to ensure that all symlinks correctly link to the correct PHP version. If any links to an incorrect PHP version, then those outdated or incorrect symlinks will be removed, which avoids a variety of issues with PHP Monitor and Homebrew.

Notes: There are some restrictions related to managing extensions. You cannot remove extensions that are dependencies of other extensions (without removing the dependent first), and you cannot manage external extensions, i.e. extensions that were installed via pecl.

v7.0.2

PHP Monitor 7.0 is now available with a bunch of new features, most notably improved extension management (including "PHP Extension Manager") and administration features. Learn more about all the new features in my blog post.

How to install or upgrade

⚠️ PHP Monitor 5.8 and newer require macOS Monterey 12.4 or newer! Learn more here.

If you have an existing PHP Monitor.app in your Applications folder you can use the built-in updater.

If you haven't installed PHP Monitor yet, you can click here to download the app. Place the app in your Applications folder and you may want to consult the README file for some more information.

Patch History

Version 7.0.2

• From this version on, resolving PHP upgrades happens based on the formula name. This avoids issues where available PHP version upgrades would not be detected correctly (based on the installed version).
• The "busy" overlay that used to be transparent is now opaque to avoid displaying outdated and incorrect info while PHP Monitor upgrades your PHP versions.
• Made some visual improvements to PHP Version Manager. Now the PHP logo is used as the icon in the view, and the "upgrade all" button has been made more enticing.
• If no domains are available in the domains list (due to not having any domains or due to your search operation being too specific), a custom view will be displayed to encourage you to add a domain.
• Both the PHP Version Manager and PHP Extension Manager windows can now be freely resized instead of being restricted to a fixed size. There is a minimum size constraint specified in order to avoid UI issues.

Version 7.0.1

• Fixed a critical issue with extensions not being detected on Intel Mac systems under some circumstances. (#275)
• Added an alert that instructs you to run brew tap shivammathur/extensions if the list of extensions remains empty. (#275)

What's New

• "PHP Version Manager..." is now listed as "Manage PHP Versions...".
• Added the PHP Extension Manager (accessible via "Manage PHP Extensions...") which allows you to manage PHP extensions for any of the usable PHP versions.
• You can filter extensions with the search field, and switch between which PHP version you'd like to manage extensions.
• You can now install and remove extensions and their dependencies with one click. These operations are managed by Homebrew, and may install other dependencies.
• You can now choose a custom display language for PHP Monitor via Settings. (You will need to restart the app to make sure all translations are correctly loaded, but you can preview this change by checking the main menu, which will always be correctly translated.)
• It is now possible to toggle specific extensions on a per PHP version basis via the Domains list. To toggle an extension, right-click on a site that is currently using a different PHP version. You will then be toggling extensions for that version of PHP.
• When the app boots, the integrity of the PHP symlinks are checked to ensure that all symlinks correctly link to the correct PHP version. If any links to an incorrect PHP version, then those outdated or incorrect symlinks will be removed, which avoids a variety of issues with PHP Monitor and Homebrew.

Notes: There are some restrictions related to managing extensions. You cannot remove extensions that are dependencies of other extensions (without removing the dependent first), and you cannot manage external extensions, i.e. extensions that were installed via pecl.

v7.0.1

PHP Monitor 7.0 is now available with a bunch of new features, most notably improved extension management (including "PHP Extension Manager") and administration features. Learn more about all the new features in my blog post.

How to install or upgrade

⚠️ PHP Monitor 5.8 and newer require macOS Monterey 12.4 or newer! Learn more here.

If you have an existing PHP Monitor.app in your Applications folder you can use the built-in updater.

If you haven't installed PHP Monitor yet, you can click here to download the app. Place the app in your Applications folder and you may want to consult the README file for some more information.

Patch History

Version 7.0.1

• Fixed a critical issue with extensions not being detected on Intel Mac systems under some circumstances. (#275)
• Added an alert that instructs you to run brew tap shivammathur/extensions if the list of extensions remains empty. (#275)

What's New

• "PHP Version Manager..." is now listed as "Manage PHP Versions...".
• Added the PHP Extension Manager (accessible via "Manage PHP Extensions...") which allows you to manage PHP extensions for any of the usable PHP versions.
• You can filter extensions with the search field, and switch between which PHP version you'd like to manage extensions.
• You can now install and remove extensions and their dependencies with one click. These operations are managed by Homebrew, and may install other dependencies.
• You can now choose a custom display language for PHP Monitor via Settings. (You will need to restart the app to make sure all translations are correctly loaded, but you can preview this change by checking the main menu, which will always be correctly translated.)
• It is now possible to toggle specific extensions on a per PHP version basis via the Domains list. To toggle an extension, right-click on a site that is currently using a different PHP version. You will then be toggling extensions for that version of PHP.
• When the app boots, the integrity of the PHP symlinks are checked to ensure that all symlinks correctly link to the correct PHP version. If any links to an incorrect PHP version, then those outdated or incorrect symlinks will be removed, which avoids a variety of issues with PHP Monitor and Homebrew.

Notes: There are some restrictions related to managing extensions. You cannot remove extensions that are dependencies of other extensions (without removing the dependent first), and you cannot manage external extensions, i.e. extensions that were installed via pecl.