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

v5.7

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

v5.6.6

PHP Monitor 5.6.6 is a maintenance release with an updated disclaimer for secured proxies, and it has been fully tested with the stable version of PHP 8.2, which is now generally available via Homebrew.

What's New

• Fully tested this release with the official release of PHP 8.2, which is now available via Homebrew as the php formula.
• To get PHP 8.1 back, run brew install [email protected] after running brew upgrade.

Resolved Issues

• The GUI for creating a proxy with a subject that is being accessed over SSL (https:// prefix instead of http://) will now include a small warning about manually needing to set proxy_ssl_verify to off in the domain's nginx configuration file.

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

PHP Monitor 5.6.5 is a maintenance release with an important bugfix, and it also adds official support for the nginx-full formula.

What's New

• Added support for the nginx-full formula (#211).

Resolved Issues

• Fixed an issue with Composer dependency updating causing PHP Monitor's internal "busy" status not to reset (#212). This was a particularly annoying issue that has been resolved now for both manual and automatic dependency updates.

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.

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

v5.6.4

PHP Monitor 5.6.4 is a maintenance release with bugfixes and support for PHP 8.2. This build even introduces support for PHP 8.3 dev builds, as is usually the case when a new stable PHP version is around the corner.

Upgrading

If you are upgrading to macOS Ventura or have upgraded, make sure your installation of Homebrew is up-to-date, since new OS releases often mean that a major update for Homebrew is usually available. If you are having issues after upgrading, you may want to run brew doctor.

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 did not use Homebrew to install the app, you can download a zip below (by expanding Assets and choosing phpmon.zip).

What's New

• Added support for PHP 8.2 (requires shivammathur/php until release day)
• Added detection for PHP 8.3-dev builds (requires shivammathur/php, plus see more info below)

Resolved Issues

• Fixed an issue with the quick-toggling of services (clicking on the button with the checkmark or cross). The spinner there took too long to disappear due to a completion closure not firing.

---

A note on (preliminary) PHP 8.3 support

Valet won't play nice with PHP 8.3 pre-releases yet. You will need to tweak a source file in your local Valet installation (in ~/.composer/vendor/laravel/valet/cli/Valet/Brew.php).

If [email protected] is not listed in the array, add it:

const SUPPORTED_PHP_VERSIONS = [
       'php',
+      '[email protected]',
       '[email protected]',
       '[email protected]',
       '[email protected]',

Run valet install to update Valet's configuration and then it should work. I consider this addition to be preliminary support for this pre-release version, so if this doesn't work or breaks, let me know!

v5.6.3

PHP Monitor 5.6.3 is a maintenance release with official support for macOS Ventura.

Upgrading

If you are upgrading to macOS Ventura or have upgraded, make sure your installation of Homebrew is up-to-date, since new OS releases often mean that a major update for Homebrew is usually available. If you are having issues after upgrading, you may want to run brew doctor.

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 did not use Homebrew to install the app, you can download a zip below (by expanding Assets and choosing phpmon.zip).

What's New

• Added a preference to disable the warning about using a custom TLD (#206).

Resolved Issues

• Potentially fixes issue(s) with concurrency by building against the macOS 13 (Ventura) SDK.
• Fixed an issue with empty terminal output causing the app to crash when running brew info when querying a tap or package that isn't installed.
• Added the instruction to run brew tap homebrew/services when bumping into issue #208.