Releases: nicoverbruggen/phpmon
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
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
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 php@8.4
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
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 runsudo 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
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
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
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.)