PHP Monitor
Early Access

Changelog

This is the changelog for the early access builds of PHP Monitor. You can gain access to these early access builds by sponsoring the project on a monthly basis on GitHub.

Current status

Maintenance releases are planned and the app will receive periodical updates when required. I do have plans for polishing the app further later this year.

Last updated: March 22, 2025.

EAP 7.2 (1535) - March 22, 2025

Improved the accuracy of the status message that is being displayed when PHP Monitor is tasking brew to install or update packages.
Replaced Twitter profile link with a new link to my Bluesky profile.
Added missing historical sponsors to the about screen. Many thanks!
Updated copyright information.

EAP 7.1.1 (1530) - March 1, 2025

Fixed missing translations for some languages.
Added translations for Spanish and Indonesian (generated using LLMs). Based on traffic to my website, I will be adding addtional language support (based on country of origin). If you notice an issue with one of these translations, please get in touch.
The phpmon-dev formula will be marked as deprecated starting with this release. This does not affect you if you are using the regular or EAP version of PHP Monitor.

EAP 7.1 (1525) - November 25, 2024

Fixed an issue with upgrading formulae when installed via the shivammathur/php tap.
Added additional text and button to clarify an upgrade will also keep the old PHP version (e.g. when upgrading PHP 8.3 to 8.4) installed.
Temporarily unavailable formulae are marked as such.

EAP 7.1 (1520) - November 15, 2024

Homebrew PHP formulae are now consistently sourced from the shivammathur/php tap.
Adds support for PHP 8.5 (dailies).
Updated cut-off date to November 2025 for PHP 8.5.
If PHP Monitor seems to stall or hang when starting up due to issues with Homebrew, an alert should be displayed that may be helpful.

EAP 7.1 (1516) - October 31, 2024

Adjusted the cut-off date for the "brew formulae out-of-date" message when using PHP Version Manager. This is now set to late November, since PHP 8.4 should be stable by then. This prevents the message from popping up incorrectly, which it will for older version of PHP Monitor. (Oops!)
Installed extensions now appear at the top of the list of the Extension Manager (#274).
Installing and removing extensions now scrolls to the extension afterwards, and animates this. This is done to emphasise that the operation succeeded.

EAP 7.1 (1505) - August 25, 2024

Individual sites or proxies (domains in general) can now be favorited by right-clicking on the domain, and choosing "Favorite Domain" or "Unfavorite Domain". Favorited domains will always appear at the top.

EAP 7.1 (1500) - August 21, 2024

PHP Monitor now uses the NVAlert and NVAppUpdater packages. I felt that it was time to remove this generic code from the app, with the intent to improve decoupling.
Fixed an issue where a non-sendable Timer could cause certain operations to stall or fail.
Updated copyright information.

EAP 7.0.4 (1490) - June 28, 2024

PHP Monitor Self-Updater is built as part of the main target build process.
Chinese translations added (by @guanguans, via #285).
Fixed an issue with Bedrock projects not being recognized correctly. (#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. (#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)

EAP 7.0.3 (1460) - April 9, 2024

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.

EAP 7.0.2 (1455) - March 20, 2024

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.

EAP 7.0.2 (1450) - March 15, 2024

In this build, 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.

EAP 7.0.1 (1425) - February 12, 2024

Fixed a critical issue with extensions not being detected on Intel Mac systems under some circumstances.
Added an alert that instructs you to run brew tap shivammathur/extensions if the list of extensions is empty.

EAP 7.0 (1422) - January 25, 2024

Fixed an issue where the dropdown in PHP Extension Manager would reset to the currently linked PHP version after installing or removing an extension, which would also update the list of extensions again (which was annoying behaviour, at the very least, if not a bug).

EAP 7.0 (1420) - January 21, 2024

Fixed an issue where managing extensions for the non-linked PHP installation would report that certain extensions present on the linked PHP installation were installed (when they were not). A quick workaround for this issue was to only install extensions for the globally linked PHP version, but this is now fixed.

EAP 7.0 (1415) - January 9, 2024

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.

EAP 7.0 (1400) - November 30, 2023

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

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.

6.2.2 (1350) - November 24, 2023

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.
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, while also retaining the PHP 8.2 installation.
A French translation was submitted by the community and was added in this build.

6.2.1 (1346) - November 2, 2023

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.
Fixed an issue where toggling extensions off and on again would not work correctly under certain circumstances. This has now been resolved.
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.

6.2 (1340) - October 27, 2023

This is the release version of PHP Monitor 6.2. It received a minor version bump and some changes were made to the filesystem watchers to make them more reliable.
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.

EAP 6.2 (1335) - October 23, 2023

PHP Monitor now generates scripts compatible with Fish in ~/.config/phpmon/bin if your default shell environment is Fish (usually located in /usr/local/bin/fish or /opt/homebrew/bin/fish). For more details on how to use these, please see the associated issue.

EAP 6.2 (1330) - October 7, 2023

Fixed an issue where the type of projects in the Domains window would not be detected correctly.
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. This is a temporary solution, as I will try to ensure that PHP Monitor and Herd can integrate better.

EAP 6.2 (1320) - September 17, 2023

You can now edit the maximum memory limit, max POST size and the maximum upload size with PHP Monitor.
Note: I'm still tackling a small bug where the menu bar icon may get stuck on the truck icon. You can fix this by opening PHP Monitor and pressing Command-R to reload the menu, which should refresh the icon in your menu bar.

6.1 (1306) - September 7, 2023

Fixed a duplicate domain from appearing in the Domains List if it is located in the Sites directory, but also designated as the default domain.

EAP 6.1 (1305) - September 6, 2023

Preliminary macOS Sonoma support. Let me know if something is broken on your system!
The app has been translated to some languages. This particular release comes in the following languages: English, Dutch, Vietnamese, German and Portuguese (Portugal).
It is now possible to install PHP 8.3 (daily builds) via PHP Version Manager's GUI.
While these builds aren't available to install via the GUI, you can still install PHP 8.4 daily builds by running brew install [email protected], and PHP Monitor will detect them.
If the various limits (memory, max upload, max POST) cannot be read, a warning is now displayed that can help you resolve this issue.
When sorting domains in the Domains List, the domain name is now used instead of the full absolute path.

6.0.1 (1252) - May 30, 2023

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

6.0 (1250) - May 27, 2023

PHP Version Manager will no longer allow running operations (install, upgrade, remove, repair) if the app is busy for some reason (i.e. version switching). You will be told to wait until the app is no longer busy before the action will be executed.
It is no longer possible to open the sites window when in Standalone Mode by using the Sites menu item. This menu item is no longer available in the main menu if running in Standalone Mode.
Added current and past public GitHub Sponsors to credits in About PHP Monitor.

EAP 6.0 (1245) - May 24, 2023

Fixed various bugs related to file and folder ownership when removing a PHP version via PHP Version Manager.
Fixed various bugs related to async task handing when Homebrew is done with its installation(s) and/or upgrade(s). This is when PHP Guard restores the previous PHP version, and this was incorrectly dispatched asynchronously so PHP Monitor would indicate that it was ready (too quickly) when this wasn't the case.
Fixed an issue with PHP Version Manager displaying an outdated label when performing an install or upgrade operation.
Fixed an issue where taking ownership of the server binary would not happen and uninstalling a PHP version would fail if Valet was actively being used.
Fixed an issue where failing to uninstall a PHP version would display an error message that contained a raw dumped Swift struct instead of a descriptive formula identifier.

EAP 6.0 (1240) - May 22, 2023

If an empty byte count is returned for memory, upload and max POST size limits, an indicator will be displayed to make it clear that the value could not be read.
Various bugfixes: Removed unneeded environment manager code and improved Laravel Valet checks when switching between PHP version if Valet is not installed (for Standalone Mode).

EAP 6.0 (1235) - May 18, 2023

Added a Repair button to PHP Version Manager, which is displayed if a PHP installation is detected as being broken due to missing binaries (links). Pressing this button will attempt to repair all broken PHP versions at once.
Added a message to the PHP Version Manager if a PHP installation is broken.
The notification that is displayed when you install a new update has been modified for EAP and DEV builds, which will now note which build specifically the app was updated to.
If Homebrew is installed in /usr/local/homebrew and the /usr/local/Cellar folder does not exist, the folder /usr/local/homebrew is used as the base directory for resolving paths internally inside of PHP Monitor. This is only an issue on x86 Macs (running Intel). Newer Mac hardware is not affected.

EAP 6.0 (1230) - May 13, 2023

Fixed a few bugs related to reloading the main menu while the PHP Version Manager is busy installing or upgrading PHP formulae.
PHP Version Manager will now offer to upgrade all PHP versions at once.
PHP Version Manager will now automatically attempt to repair broken PHP installations once an install or upgrade command has been given.
PHP Version Manager will be released as a part of PHP Monitor 6.0 but will be marked as a beta feature until I consider it stable and reliable enough. There are still certain issues with Valet that may need to be ironed out.
Fixed an issue with menu items being unavailable if PHP Monitor was busy.

EAP 6.0 (1215) - April 22, 2023

A menu item has been added that is only visible when Standalone Mode is enabled. You can click it to learn more about what Standalone Mode does. If you see this menu item, the app is running with limited functionality.
If Standalone Mode is enabled, some preferences that only apply to Valet in the Settings menu will no longer be displayed, since they are not relevant.

EAP 6.0 (1210) - April 4, 2023

A warning has been added if you are not running Homebrew 4.0, since running older (or newer) versions of Homebrew are not officially supported.
The PHP Version Manager now shows the full version number for up-to-date PHP installations.
You must now confirm the deletion of an installed version of PHP before the uninstallation will start.
It is no longer possible to press the refresh button if you've already pressed it and PHP Monitor is already busy executing commands.

EAP 6.0 (1205) - March 27, 2023

EAP builds now have access to a changelog when an update is available.
Added missing dialog when PHP is unlinked for menu bar item "What's This?".
Improved terminology consistency for PHP Version Manager ("Manage PHP versions...").

EAP 6.0 (1200) - March 24, 2023

Initial release for GitHub Sponsors.
Adds Standalone Mode, which allows you to use PHP Monitor without Valet.
Adds Instant Homebrew Response, which allows PHP Monitor to instantly respond to changes to the linked version of PHP.
Adds PHP Version Manager, which allows you to install, update or remove PHP versions.
Also includes various bug fixes and improvements.