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.

v7.0

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.

v7.0 (pre-release 2)

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.

v6.2.2

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.

v6.2.1

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.

v6.2

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.

v6.1

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)

v6.0.1

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.

v6.0

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.

v5.8.1

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.