phpmon

> **Note**
> If this software has been useful to you, I ask that you **please star the repository**, that way I know that the software is being used. Also, please consider [sponsoring](https://nicoverbruggen.be/sponsor) to support the project, as this is something I make in my free time. **Thank you!** ⭐️
 
<p align="center"><img src="./docs/logo.svg" alt="PHP Monitor Logo" width="500px" /></p>

**PHP Monitor** (or *phpmon*) is a lightweight macOS utility app that runs on your Mac, helps set up and maintain your local PHP development environment, and displays the active PHP version in your status bar.

If your Mac is not quite ready yet, PHP Monitor can guide you through that setup on first launch. It's also tightly integrated with [Laravel Valet](https://github.com/laravel/valet), which can be automatically installed for you by the app.

<img src="./docs/marketing@2x.jpg" width="1033px" alt="phpmon screenshot (menu bar app)"/>

<small><i>Screenshot: Showing the key functionality of PHP Monitor. You can switch between PHP versions, manage PHP installations, install extensions, manage domains, and much more.</i></small>

It's super convenient to **globally switch** between different versions of PHP. This applies the selected version of PHP as the default on your system.

If you prefer, you can also **pick a PHP version on a per-site basis** (this uses Valet's site isolation feature) which is very helpful.

<img src="./docs/notification.png" width="370px" alt="phpmon screenshot (notification)"/>

PHP Monitor also gives you quick access to various useful functionality (like accessing configuration files, restarting services, and more).

You can also add new domains as links, isolate sites, manage various services, and perform First Aid to fix all kinds of common PHP and Homebrew issues.

## 🖥 System requirements

PHP Monitor is a universal application that runs natively on Apple Silicon **and** Intel-based Macs.

* A user account that can administer your computer (required for setup + for some functionality, e.g. certificate generation)
* macOS 13.5 or later

If your machine is still missing Homebrew, PHP, Composer, or even Apple's Command Line Tools, PHP Monitor's onboarding wizard can guide you through the initial setup on first launch.

For more information, please see [SECURITY.md](./SECURITY.md) to find out which version of the app is currently supported.

## 🚀 How to install

On first launch, PHP Monitor can **guide you** through installing Apple's Command Line Tools, Homebrew, configuring your PATH, installing PHP and Composer, and optionally setting up [Laravel Valet](https://laravel.com/docs/master/valet) as well.

#### Manual installation (recommended, first time only)

You can [download the latest release](https://github.com/nicoverbruggen/phpmon/releases/latest), unzip it and place it in `/Applications`.

When you launch PHP Monitor for the first time on a fresh machine, the onboarding flow will guide you through whatever is still missin