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.

v5.6.2

PHP Monitor 5.6.2 is a maintenance release that fixes a few minor bugs.

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

Resolved Issues

• Fixed an issue with the way the valet secure command works (#197).
• Fixed an issue with a separator being missing from the menu when Xdebug mode configuration is hidden.
• Fixed an issue with a retain cycle (i.e. small memory leak) related to the update window that is displayed when you manually or automatically upgrade your Composer dependencies. This probably didn't even need to be fixed (due to the very limited impact) but here we are.

v5.6.1

PHP Monitor 5.6.1 is a minor update that fixes a few bugs that may have caused issues for some users when starting the app. As usual, all users are recommended to upgrade.

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

Resolved Issues

• Fixed an issue where the update checker would link to the incorrect URL (#195).
• Fixed an issue where the app wouldn't progress past initial PATH determination, causing the icon to either freeze or not appear (#194).
• If the scanApps property is missing in the custom configuration file, the config file will now still be read correctly.

v5.6

PHP Monitor 5.6 is a quality of life release and improves the ease of use of the site isolation feature, and introduces the ability of users to customize what appears in the main menu when you click on the version number (or truck icon).

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

What's New in 5.6

• In Preferences there's a new Visibility tab. Here you can hide specific features from PHP Monitor's main menu: only keep what you really need!

• The way the contextual menu works in the domain list has been modified. Instead of having to left-click on a domain before right-clicking, you can now instantly right-click on the item in question, and the domain will immediately be selected.

• Upon right-clicking, if a site is already isolated, you will be able to instantly choose a different version of PHP to switch to for that site. (Think of this as a switcher... this means you won't have to remove site isolation and then manually reisolate the site again with your preferred PHP version. Thankfully!)

v5.5.1

This release fixes an issue that could occur if your username and your home directory have different names. This could have caused various issues in versions <5.5, but since the latest minor update the app wouldn't start on systems with this issue. This has now been resolved.

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

Resolved in 5.5.1

• whoami is no longer used, instead id -un is used to determine the active user's username. (#189)
• The user's home directory is now correctly determined and used where necessary. (#189)

What's New in 5.5

• Added PHP Doctor, which will alert you if there are issues with your setup in regard to file permissions and such. For now, the recommendations are limited to ensuring you are running the optimal version of Homebrew on M1 and related to ensuring that the helper files can be generated and symlinked correctly.
• Added support for custom environment variables (#183, consult the issue or FAQ for more information).
• Added a new "Welcome to PHP Monitor" onboarding screen (only displayed at first launch, #181).

v5.5

This release adds a few new features (PHP Doctor, a better onboarding experience and custom environment variable support) to PHP Monitor. This release also includes a various bugfixes that should improve the experience for new users or users who have difficulties with their Valet setup. All users are recommended to upgrade.

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 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 PHP Doctor, which will alert you if there are issues with your setup in regard to file permissions and such. For now, the recommendations are limited to ensuring you are running the optimal version of Homebrew on M1 and related to ensuring that the helper files can be generated and symlinked correctly.
• Added support for custom environment variables (#183, consult the issue or FAQ for more information).
• Added a new "Welcome to PHP Monitor" onboarding screen (only displayed at first launch, #181).

Resolved Issues

• Fixed an issue with the text in the "could not check for updates" alert (#185).
• PHP Doctor now alerts you about #179 and #171 (both require manual user intervention).
• The app now checks if you ran valet install (#182).
• The app will no longer crash if it has difficulty parsing your Valet version number (#188).
• This build has been tested with macOS Ventura, and should work. I have not tested every feature extensively, so please let me know if you encounter any issues. (#176).