phpmon

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.

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.

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.

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.

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.

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.

PHP Monitor 7.0 introduces extension management (via "Manage PHP Extensions..." in the main menu). This is a pre-release version, available to the public. Please file a bug report if you bump into an issue!

How to install or upgrade

This pre-release build is only available on the DEV channel. The regular version of PHP Monitor won't be upgraded to v7 until a stable build is available. To download this build, click here.

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.

PHP Monitor 7.0 introduces extension management (via "Manage PHP Extensions..." in the main menu). This is a pre-release version, available to the public. Please file a bug if you bump into an issue!

How to install or upgrade

This pre-release build is only available on the DEV channel. The regular version of PHP Monitor won't be upgraded to v7 until a stable build is available. To download this build, click here.

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.

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.

PHP Monitor 6.2.2 is an important update that aims to improve the upgrade flow for upgrading to PHP 8.3, and adds a French translation to the app. (If you plan on using PHP Version Manager to upgrade to PHP 8.3, this is a required update.)

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

v6.2.2

• PHP Monitor can now handle situations where you've already updated Homebrew, but not the PHP package, which may still be stuck on an older version.
• Fixes an issue when upgrading the php formula to PHP 8.3 would cause all sorts of issues.
• Fixes an issue where PHP 8.3 was incorrectly reported as being installed when that isn't the case. This also had an impact on various other features throughout the app, including services.
• Pressing 'Upgrade All' will now seamlessly upgrade your version of PHP 8.2 to PHP 8.3. This will also install PHP 8.2, so you don't lose access to that version of PHP. (#268)
• A French translation was submitted by the community and was added in this build.

v6.2.1

• Fixed an issue where toggling extensions off and on again would not work correctly under certain circumstances. This has now been resolved. (#265)
• Added threading fix that prevents the truck icon of PHP Monitor from getting stuck. This was an annoying bug that has been around for some time, so I'm happy to finally have squashed it.
• After the official release of PHP 8.3 (on November 23), this release will automatically be marked as "stable" and no longer have the "experimental" flag in the PHP Version Manager.

What's New

🆕 A simple configuration editor has been added!

You can now edit the maximum memory limit, max POST size and the maximum upload size with PHP Monitor. If you are using Valet and the memory-limits.ini stub file is missing, PHP Monitor will attempt to restore it. As you adjust the values, PHP Monitor will try to dynamically apply the memory limits.

This is the first version of the configuration editor, and it will be expanded in the future. If you encounter any bugs while using this feature, please get in touch via an issue.

What's Fixed

• PHP Monitor now generates scripts compatible with Fish in ~/.config/phpmon/bin if your default shell environment is Fish. For more details on how to use these, please see the write-up here. (#264)
• Fixed an issue where the type of projects in the Domains window would not be detected correctly. (#263)
• Fixed an issue with some windows not coming to the front after selecting a menu item if another application had the focus (on macOS Sonoma only). Windows are now brought to the front by using window?.orderFrontRegardless(), which should resolve this problem.
• Added detection of Laravel Herd, which may conflict with a standalone Laravel Valet installation (installed with composer global install laravel/valet). During startup of PHP Monitor, the app will now require you to terminate Laravel Herd. You can start Laravel Herd afterwards, but this is currently not supported.

Note: Ensuring that PHP Monitor does not conflict with Laravel Herd is very much a temporary solution, as I will try to ensure that PHP Monitor and Herd can integrate better in the future.

PHP Monitor 6.2 is a minor update that comes with a bunch of fixes and adds a configuration editor which currently lets you edit the following: memory_limit, post_max_size and upload_max_filesize via the GUI.

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

v6.2.1

• Fixed an issue where toggling extensions off and on again would not work correctly under certain circumstances. This has now been resolved. (#265)
• Added threading fix that prevents the truck icon of PHP Monitor from getting stuck. This was an annoying bug that has been around for some time, so I'm happy to finally have squashed it.
• After the official release of PHP 8.3 (on November 23), this release will automatically be marked as "stable" and no longer have the "experimental" flag in the PHP Version Manager.

What's New

🆕 A simple configuration editor has been added!

You can now edit the maximum memory limit, max POST size and the maximum upload size with PHP Monitor. If you are using Valet and the memory-limits.ini stub file is missing, PHP Monitor will attempt to restore it. As you adjust the values, PHP Monitor will try to dynamically apply the memory limits.

This is the first version of the configuration editor, and it will be expanded in the future. If you encounter any bugs while using this feature, please get in touch via an issue.

What's Fixed

• PHP Monitor now generates scripts compatible with Fish in ~/.config/phpmon/bin if your default shell environment is Fish. For more details on how to use these, please see the write-up here. (#264)
• Fixed an issue where the type of projects in the Domains window would not be detected correctly. (#263)
• Fixed an issue with some windows not coming to the front after selecting a menu item if another application had the focus (on macOS Sonoma only). Windows are now brought to the front by using window?.orderFrontRegardless(), which should resolve this problem.
• Added detection of Laravel Herd, which may conflict with a standalone Laravel Valet installation (installed with composer global install laravel/valet). During startup of PHP Monitor, the app will now require you to terminate Laravel Herd. You can start Laravel Herd afterwards, but this is currently not supported.

Note: Ensuring that PHP Monitor does not conflict with Laravel Herd is very much a temporary solution, as I will try to ensure that PHP Monitor and Herd can integrate better in the future.

PHP Monitor 6.2 is a minor update that comes with a bunch of fixes and adds a configuration editor which currently lets you edit the following: memory_limit, post_max_size and upload_max_filesize via the GUI.

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.

What's New

🆕 A simple configuration editor has been added!

You can now edit the maximum memory limit, max POST size and the maximum upload size with PHP Monitor. If you are using Valet and the memory-limits.ini stub file is missing, PHP Monitor will attempt to restore it. As you adjust the values, PHP Monitor will try to dynamically apply the memory limits.

This is the first version of the configuration editor, and it will be expanded in the future. If you encounter any bugs while using this feature, please get in touch via an issue.

What's Fixed

• PHP Monitor now generates scripts compatible with Fish in ~/.config/phpmon/bin if your default shell environment is Fish. For more details on how to use these, please see the write-up here. (#264)
• Fixed an issue where the type of projects in the Domains window would not be detected correctly. (#263)
• Fixed an issue with some windows not coming to the front after selecting a menu item if another application had the focus (on macOS Sonoma only). Windows are now brought to the front by using window?.orderFrontRegardless(), which should resolve this problem.
• Added detection of Laravel Herd, which may conflict with a standalone Laravel Valet installation (installed with composer global install laravel/valet). During startup of PHP Monitor, the app will now require you to terminate Laravel Herd. You can start Laravel Herd afterwards, but this is currently not supported.

Note: Ensuring that PHP Monitor does not conflict with Laravel Herd is very much a temporary solution, as I will try to ensure that PHP Monitor and Herd can integrate better in the future.

PHP Monitor 6.1 is a minor update that comes with various translations, makes it possible to install PHP 8.3 pre-release builds via the GUI, and includes a few fixes.

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.

What's New

🆕 PHP Monitor has been translated! A bit.

The app has been translated to some languages. This particular release comes in the following languages: English, Dutch, Vietnamese, German and Portuguese (Portugal). For a list of available translations and a list of contributors, please see (#257).

🆕 PHP 8.3 support (detection and installation)

It is now possible to install PHP 8.3 (daily builds) via PHP Version Manager's GUI.

Note: You may need to remove PHP 8.3 and reinstall it in order to get more recent daily builds, as PHP Monitor may not pick up that a new build is available. Your mileage may vary until PHP 8.3 is stable. I will see if I can address this in a patch update.

🆕 PHP 8.4 support (detection)

While these builds aren't available to install via the GUI, you can still install PHP 8.4 daily builds by running [email protected] after tapping homebrew-php. PHP 8.4 installs are now also picked up and were added to the support matrix of PHP Monitor.

Note: Laravel Valet may not yet support this version of PHP. To add support, please see this workaround.

What's Fixed

• If the various limits cannot be read, a warning is now displayed that can help you resolve this issue (#258).
• When sorting domains in the Domains List, the domain name is now used instead of the full absolute path. (#259)
• Fixed a duplicate domain from appearing in the Domains List if it was in the Sites directory but also designated as the default domain. (#261)

PHP Monitor 6.0 comes with the new PHP Version Manager, the new Standalone Mode that allows the app to work without having Valet installed, and Instant Homebrew Response, which allows the app to respond immediately to any Homebrew changes.

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

v6.0.1

• Fixed an issue where in Standalone Mode, PHP Monitor would crash trying to load service information if you had previously used brew services and need password entry to run sudo brew services commands. (#253)
• Fixed an issue where the user could prompt a crash in PHP Monitor by using a third-party integration. In Standalone Mode, PHP Monitor no longer responds to various third-party interactions if that functionality is not available. (#252)

What's New

For a complete list of changes, find out what's new in my blogpost about PHP Monitor 6.

🆕 Standalone Mode (#192)

This feature was introduced to ensure PHP Monitor can run without needing to have Valet installed.

🆕 Instant Homebrew Response (#219)

This feature mostly guarantees that if your Homebrew setup changes, PHP Monitor doesn't need to be restarted.

🆕 PHP Version Manager

This feature was introduced to help you manage your PHP installations. It can help you install, remove, upgrade and repair PHP installations on your system.

At least, it can help you avoid having to run Homebrew commands yourself, and may help you fix certain issues with your PHP installations.

When you use the PHP Version Manager other tasks are also taken into account (like version switching back to the original version of PHP that was active, as well as some file permission tasks).

Note: This feature has been created to be as reliable as possible but depending on your local Homebrew setup you may encounter issues when running commands. PHP Monitor will let you know if something failed.

PHP Monitor 6.0 comes with the new PHP Version Manager, the new Standalone Mode that allows the app to work without having Valet installed, and Instant Homebrew Response, which allows the app to respond immediately to any Homebrew changes.

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.

Important: A newer release is available. Installing this older release is not recommended.

What's New

For a complete list of changes, find out what's new in my blogpost about PHP Monitor 6.

🆕 Standalone Mode (#192)

This feature was introduced to ensure PHP Monitor can run without needing to have Valet installed.

🆕 Instant Homebrew Response (#219)

This feature mostly guarantees that if your Homebrew setup changes, PHP Monitor doesn't need to be restarted.

🆕 PHP Version Manager

This feature was introduced to help you manage your PHP installations. It can help you install, remove, upgrade and repair PHP installations on your system.

At least, it can help you avoid having to run Homebrew commands yourself, and may help you fix certain issues with your PHP installations.

When you use the PHP Version Manager other tasks are also taken into account (like version switching back to the original version of PHP that was active, as well as some file permission tasks).

Note: This feature has been created to be as reliable as possible but depending on your local Homebrew setup you may encounter issues when running commands. PHP Monitor will let you know if something failed.

PHP Monitor 5.8 includes a toggle to automatically start the app at login, and adds the new PHP Monitor Self-Updater, which should make installing newer builds of the app a breeze.

How to upgrade

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

If you are still running PHP Monitor earlier than version 5.8, you can use brew upgrade phpmon one last time. Users on PHP Monitor 5.8 should receive a notification and be able to easily upgrade to 5.8.1 using the built-in updater.

(If you are on the DEV channel, you can use brew upgrade phpmon-dev or use the built-in updater.)

Important: A newer release is available. Installing this older release is not recommended.

Patch History

v5.8.1

• This release fixes a crash issue when linked folders aren't accessible (see #247). For now I've only seen this happen to with iCloud Drive being linked but it is not impossible to have this issue occur with network shares as well.

What's New

🆕 Update with ease

PHP Monitor is now able to update itself, without you needing to run brew upgrade, making it much easier for you to stay up-to-date. You can still turn off automatic update checks, of course.

If you want to see the source code of the embedded updater app, it is not included in this repository. Explore the code here.

🆕 Launch at login

The option to launch the app at login has been added in Settings on macOS 13 (Ventura) and newer. On older systems you can still manually add PHP Monitor. For more information about that, please consult the FAQ.

Quality of Life

• Made various improvements to PHP Doctor, including a new check that ensures that key configuration files for each of your PHP installations aren't missing.
• Opening the release notes now won't close the "update available" dialog.
• Fixes an issue with the 'Scan Again' button not working in PHP Doctor, and added a new check that ensures key config files aren't missing.
• Added note that upgrading via Homebrew is no longer the recommended upgrade method.
• Fixed an issue where 'Restore Homebrew Permissions' always failed.
• Detection of whether PHP Monitor is installed via Homebrew has been improved.
• This update improves the Internet Access Policy for PHP Monitor (useful for users of Little Snitch or other firewalls) who may now see an explanation for requests to https://formulae.brew.sh, which may occur when PHP Monitor requests more information about the php formula in Homebrew 4.0 and newer.

PHP Monitor 5.8 includes a toggle to automatically start the app at login, and adds the new PHP Monitor Self-Updater, which should make installing newer builds of the app a breeze.

How to upgrade

⚠️ PHP Monitor now requires macOS Monterey 12.4 or newer! Learn more here.

You can use brew upgrade phpmon one last time. After that, once you have PHP Monitor 5.8 (or newer) you will be able to upgrade from inside the app itself.

(If you are on the DEV channel, you can use brew upgrade phpmon-dev or use the built-in updater.)

What's New

🆕 Update with ease

PHP Monitor is now able to update itself, without you needing to run brew upgrade, making it much easier for you to stay up-to-date. You can still turn off automatic update checks, of course.

If you want to see the source code of the embedded updater app, it is not included in this repository. Explore the code here.

🆕 Launch at login

The option to launch the app at login has been added in Settings on macOS 13 (Ventura) and newer. On older systems you can still manually add PHP Monitor. For more information about that, please consult the FAQ.

Quality of Life

• Made various improvements to PHP Doctor, including a new check that ensures that key configuration files for each of your PHP installations aren't missing.
• Opening the release notes now won't close the "update available" dialog.
• Fixes an issue with the 'Scan Again' button not working in PHP Doctor, and added a new check that ensures key config files aren't missing.
• Added note that upgrading via Homebrew is no longer the recommended upgrade method.
• Fixed an issue where 'Restore Homebrew Permissions' always failed.
• Detection of whether PHP Monitor is installed via Homebrew has been improved.
• This update improves the Internet Access Policy for PHP Monitor (useful for users of Little Snitch or other firewalls) who may now see an explanation for requests to https://formulae.brew.sh, which may occur when PHP Monitor requests more information about the php formula in Homebrew 4.0 and newer.

PHP Monitor 5.7 mostly focuses on getting many of the new systems that form the foundation of PHP Monitor 6 in your hands early, along with a few new features. This release should be faster and more stable in various situations where the previous app would crash, but should you encounter problems, don't hesitate to open an issue.

Patch History

v5.7.4

• This hotfix release fixes a crash issue (#235) caused by a change in the JSON output when requesting the details of a given formula via Homebrew. The name property isn't always included in JSON output, and this caused a crash. This has been resolved.

v5.7.3

• This hotfix release fixes #231, which prevented PHP Monitor from correctly restoring Homebrew folder permissions. Since this too was a rather important fix, I wanted to make sure to release this relatively quickly. I apologize for the frequent patches. Installing updates will be less troublesome in PHP Monitor v5.8 and later.

v5.7.2

• Another hotfix release that fixes #227, which prevented PHP Monitor from launching when getting deprecation messages in the output of valet --version (i.e. when running PHP 7.2 globally).
• This release also adds verbose logging to ~/.config/phpmon/last_session.log when a file at ~/.config/phpmon/verbose exists. This will help troubleshooting and bug reporting significantly. This is disabled by default and should only be enabled if you need to report an issue.

v5.7.1

• This is a hotfix release that fixes #225, which prevented you from turning off Valet's services via the keyboard shortcut.

v5.7.0:

• Initial release.
• Learn more about the features new in this release below.

What's New

🆕 PHP Guard

PHP Monitor keeps track of the last version that was linked globally. If this version is different when PHP Monitor is restarted, you will be notified.

🆕 Services Manager v2

An indicator has been added to let you know if all key Valet services are running correctly. If there are issues with services (i.e. an error state) you will also be able to more easily debug these issues.

Foundational Changes

• If you are running a version of Valet that isn't supported, you'll be notified at app launch.
• All interaction with the system shell has been reworked to be fully asynchronous, resulting in the app hanging less frequently.
• Improved handling of services status retrieval.
• Improved test coverage. Various minor timing issues and bugs have been resolved.

Miscellaneous

• You will now be notified if the system PHP version has changed between sessions of PHP Monitor. (#220)
• A new menu item was added that teaches you how to use an isolated version of PHP in the terminal using the helper scripts. (You can see this item if you right-click on an isolated domain in the domains list.)
• Added support for Valet 4 (works with PHP 7.1+) and the new upcoming .valetrc file format.
• The onboarding flow now works as expected. Previously, the welcome screen would not be displayed.
• Added monitoring for older PHP versions that have become unsupported. This makes it easier to understand why particular PHP versions are not being made available. Newer versions of Valet drop support for older PHP versions, and this is also reflected in PHP Monitor.

Upgrading

The recommended way of upgrading is running brew update-reset && brew upgrade phpmon after you've installed PHP Monitor using Homebrew. This always gets you the latest and greatest stable version of PHP Monitor.

If you are having issues after upgrading, you may want to run brew doctor and valet install.

(If you did not use Homebrew to install the app, you can also download a zip below.)

PHP Monitor 5.7 mostly focuses on getting many of the new systems that form the foundation of PHP Monitor 6 in your hands early, along with a few new features. This release should be faster and more stable in various situations where the previous app would crash, but should you encounter problems, don't hesitate to open an issue.

Patch History

v5.7.3

• This hotfix release fixes #231, which prevented PHP Monitor from correctly restoring Homebrew folder permissions. Since this too was a rather important fix, I wanted to make sure to release this relatively quickly. I apologize for the frequent patches. Installing updates will be less troublesome in PHP Monitor v5.8 and later.

v5.7.2

• Another hotfix release that fixes #227, which prevented PHP Monitor from launching when getting deprecation messages in the output of valet --version (i.e. when running PHP 7.2 globally).
• This release also adds verbose logging to ~/.config/phpmon/last_session.log when a file at ~/.config/phpmon/verbose exists. This will help troubleshooting and bug reporting significantly. This is disabled by default and should only be enabled if you need to report an issue.

v5.7.1

• This is a hotfix release that fixes #225, which prevented you from turning off Valet's services via the keyboard shortcut.

v5.7.0:

• Initial release.
• Learn more about the features new in this release below.

What's New

🆕 PHP Guard

PHP Monitor keeps track of the last version that was linked globally. If this version is different when PHP Monitor is restarted, you will be notified.

🆕 Services Manager v2

An indicator has been added to let you know if all key Valet services are running correctly. If there are issues with services (i.e. an error state) you will also be able to more easily debug these issues.

Foundational Changes

• If you are running a version of Valet that isn't supported, you'll be notified at app launch.
• All interaction with the system shell has been reworked to be fully asynchronous, resulting in the app hanging less frequently.
• Improved handling of services status retrieval.
• Improved test coverage. Various minor timing issues and bugs have been resolved.

Miscellaneous

• You will now be notified if the system PHP version has changed between sessions of PHP Monitor. (#220)
• A new menu item was added that teaches you how to use an isolated version of PHP in the terminal using the helper scripts. (You can see this item if you right-click on an isolated domain in the domains list.)
• Added support for Valet 4 (works with PHP 7.1+) and the new upcoming .valetrc file format.
• The onboarding flow now works as expected. Previously, the welcome screen would not be displayed.
• Added monitoring for older PHP versions that have become unsupported. This makes it easier to understand why particular PHP versions are not being made available. Newer versions of Valet drop support for older PHP versions, and this is also reflected in PHP Monitor.

Upgrading

The recommended way of upgrading is running brew update-reset && brew upgrade phpmon after you've installed PHP Monitor using Homebrew. This always gets you the latest and greatest stable version of PHP Monitor.

If you are having issues after upgrading, you may want to run brew doctor and valet install.

(If you did not use Homebrew to install the app, you can also download a zip below.)

PHP Monitor 5.7 mostly focuses on getting many of the new systems that form the foundation of PHP Monitor 6 in your hands early, along with a few new features. This release should be faster and more stable in various situations where the previous app would crash, but should you encounter problems, don't hesitate to open an issue.

Patch History

v5.7.2

• Another hotfix release that fixes #227, which prevented PHP Monitor from launching when getting deprecation messages in the output of valet --version (i.e. when running PHP 7.2 globally).
• This release also adds verbose logging to ~/.config/phpmon/last_session.log when a file at ~/.config/phpmon/verbose exists. This will help troubleshooting and bug reporting significantly. This is disabled by default and should only be enabled if you need to report an issue.

v5.7.1

• This is a hotfix release that fixes #225, which prevented you from turning off Valet's services via the keyboard shortcut.

v5.7.0:

• Initial release.
• Learn more about the features new in this release below.

What's New

🆕 PHP Guard

PHP Monitor keeps track of the last version that was linked globally. If this version is different when PHP Monitor is restarted, you will be notified.

🆕 Services Manager v2

An indicator has been added to let you know if all key Valet services are running correctly. If there are issues with services (i.e. an error state) you will also be able to more easily debug these issues.

Foundational Changes

• If you are running a version of Valet that isn't supported, you'll be notified at app launch.
• All interaction with the system shell has been reworked to be fully asynchronous, resulting in the app hanging less frequently.
• Improved handling of services status retrieval.
• Improved test coverage. Various minor timing issues and bugs have been resolved.

Miscellaneous

• You will now be notified if the system PHP version has changed between sessions of PHP Monitor. (#220)
• A new menu item was added that teaches you how to use an isolated version of PHP in the terminal using the helper scripts. (You can see this item if you right-click on an isolated domain in the domains list.)
• Added support for Valet 4 (works with PHP 7.1+) and the new upcoming .valetrc file format.
• The onboarding flow now works as expected. Previously, the welcome screen would not be displayed.
• Added monitoring for older PHP versions that have become unsupported. This makes it easier to understand why particular PHP versions are not being made available. Newer versions of Valet drop support for older PHP versions, and this is also reflected in PHP Monitor.

Upgrading

The recommended way of upgrading is running brew update-reset && brew upgrade phpmon after you've installed PHP Monitor using Homebrew. This always gets you the latest and greatest stable version of PHP Monitor.

If you are having issues after upgrading, you may want to run brew doctor and valet install.

(If you did not use Homebrew to install the app, you can also download a zip below.)

PHP Monitor 5.7 mostly focuses on getting many of the new systems that form the foundation of PHP Monitor 6 in your hands early, along with a few new features. This release should be faster and more stable in various situations where the previous app would crash, but should you encounter problems, don't hesitate to open an issue.

Patch History

• v5.7.1: This is a hotfix release that fixes #225, which prevented you from turning off Valet's services via the keyboard shortcut.
• v5.7.0: Initial release. Learn more about the features new in this release below.

What's New

🆕 PHP Guard

PHP Monitor keeps track of the last version that was linked globally. If this version is different when PHP Monitor is restarted, you will be notified.

🆕 Services Manager v2

An indicator has been added to let you know if all key Valet services are running correctly. If there are issues with services (i.e. an error state) you will also be able to more easily debug these issues.

Foundational Changes

• If you are running a version of Valet that isn't supported, you'll be notified at app launch.
• All interaction with the system shell has been reworked to be fully asynchronous, resulting in the app hanging less frequently.
• Improved handling of services status retrieval.
• Improved test coverage. Various minor timing issues and bugs have been resolved.

Miscellaneous

• You will now be notified if the system PHP version has changed between sessions of PHP Monitor. (#220)
• A new menu item was added that teaches you how to use an isolated version of PHP in the terminal using the helper scripts. (You can see this item if you right-click on an isolated domain in the domains list.)
• Added support for Valet 4 (works with PHP 7.1+) and the new upcoming .valetrc file format.
• The onboarding flow now works as expected. Previously, the welcome screen would not be displayed.
• Added monitoring for older PHP versions that have become unsupported. This makes it easier to understand why particular PHP versions are not being made available. Newer versions of Valet drop support for older PHP versions, and this is also reflected in PHP Monitor.

Upgrading

The recommended way of upgrading is running brew update-reset && brew upgrade phpmon after you've installed PHP Monitor using Homebrew. This always gets you the latest and greatest stable version of PHP Monitor.

If you are having issues after upgrading, you may want to run brew doctor and valet install.

(If you did not use Homebrew to install the app, you can also download a zip below.)

PHP Monitor 5.7 mostly focuses on getting many of the new systems that form the foundation of PHP Monitor 6 in your hands early, along with a few new features. This release should be faster and more stable in various situations where the previous app would crash, but should you encounter problems, don't hesitate to open an issue.

What's New

🆕 PHP Guard

PHP Monitor keeps track of the last version that was linked globally. If this version is different when PHP Monitor is restarted, you will be notified.

🆕 Services Manager v2

An indicator has been added to let you know if all key Valet services are running correctly. If there are issues with services (i.e. an error state) you will also be able to more easily debug these issues.

Foundational Changes

• If you are running a version of Valet that isn't supported, you'll be notified at app launch.
• All interaction with the system shell has been reworked to be fully asynchronous, resulting in the app hanging less frequently.
• Improved handling of services status retrieval.
• Improved test coverage. Various minor timing issues and bugs have been resolved.

Miscellaneous

• You will now be notified if the system PHP version has changed between sessions of PHP Monitor. (#220)
• A new menu item was added that teaches you how to use an isolated version of PHP in the terminal using the helper scripts. (You can see this item if you right-click on an isolated domain in the domains list.)
• Added support for Valet 4 (works with PHP 7.1+) and the new upcoming .valetrc file format.
• The onboarding flow now works as expected. Previously, the welcome screen would not be displayed.
• Added monitoring for older PHP versions that have become unsupported. This makes it easier to understand why particular PHP versions are not being made available. Newer versions of Valet drop support for older PHP versions, and this is also reflected in PHP Monitor.

Upgrading

The recommended way of upgrading is running brew update-reset && brew upgrade phpmon after you've installed PHP Monitor using Homebrew. This always gets you the latest and greatest stable version of PHP Monitor.

If you are having issues after upgrading, you may want to run brew doctor and valet install.

(If you did not use Homebrew to install the app, you can also download a zip below.)