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.

v5.8

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.

v5.7.4

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.)

v5.7.3

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.)

v5.7.2

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.)

v5.7.1

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.)