mirror of
https://github.com/nicoverbruggen/phpmon.git
synced 2025-08-08 04:20:07 +02:00
125 lines
4.1 KiB
Markdown
125 lines
4.1 KiB
Markdown
### Quick Setup
|
|
|
|
If you want to set up your computer for the very first time with PHP Monitor, here's how I do it:
|
|
|
|
Install [Homebrew](https://brew.sh) first.
|
|
|
|
Install PHP, composer, add to path:
|
|
|
|
brew install php
|
|
brew install composer
|
|
nano .zshrc
|
|
|
|
Make sure the following line is not in the comments:
|
|
|
|
# on an Intel Mac
|
|
export PATH=$HOME/bin:/usr/local/bin:$PATH
|
|
|
|
If you're on an Apple Silicon-based Mac, you'll need to add:
|
|
|
|
# on an M1 Mac
|
|
export PATH=$HOME/bin:/opt/homebrew/bin:$PATH
|
|
|
|
and add the following to your .zshrc:
|
|
|
|
export PATH=$HOME/bin:~/.composer/vendor/bin:$PATH
|
|
|
|
Make sure PHP is linked correctly:
|
|
|
|
which php
|
|
|
|
should return: `/usr/local/bin/php` (or `/opt/homebrew/bin/php`)
|
|
|
|
composer global require laravel/valet
|
|
valet install
|
|
|
|
This should install `dnsmasq` and set up Valet. Great, almost there!
|
|
|
|
valet trust
|
|
|
|
Finally, run PHP Monitor. Since the app is notarized and signed with a developer ID, it should work.
|
|
|
|
### FAQ
|
|
|
|
#### Q: Does this support Apple Silicon?
|
|
|
|
Yes. This is a universal app.
|
|
|
|
The following installation paths are supported:
|
|
|
|
* `/usr/local/homebrew` (default on Intel Macs)
|
|
* `/opt/homebrew` (default on Apple Silicon Macs)
|
|
|
|
#### Q: Is PHP 8.0 supported?
|
|
|
|
Yes.
|
|
|
|
#### Q: This app is doing network requests? Why?
|
|
|
|
It's Homebrew. I can't prevent `brew` from doing things via the network when I invoke it.
|
|
|
|
PHP Monitor itself doesn't do any network requests. Feel free to check the source code or intercept the traffic, if you don't believe me.
|
|
|
|
#### Q: I want PHP Monitor to start up when I boot my Mac!
|
|
|
|
You can do this by dragging *PHP Monitor.app* into the **Login Items** section in **System Preferences > Users & Groups** for your account.
|
|
|
|
Super convenient!
|
|
|
|
### Q: PHP Monitor says that the latest version of PHP is not installed, but it is!
|
|
|
|
Try installing again using `brew install php`.
|
|
|
|
This should resolve the issue! If that does not fix the issue, run `brew link php --force`. (Afterwards, you may need to restart your terminal to make sure the new linked version is detected.)
|
|
|
|
### Q: PHP Monitor says the correct version is loaded, but my Valet sites don't work!
|
|
|
|
Your sites aren't showing up, or you are seeing a 502? It's a common issue.
|
|
|
|
You may need to run `valet install`, preferably after updating `valet` by running `composer global update`.
|
|
|
|
#### Q: PHP Monitor reports another version compared to phpinfo on my local website, what is going on?
|
|
|
|
_Beginning with version 2.0 you'll get alerts about this at startup._
|
|
|
|
If you're still seeing another version of PHP in your scripts running on your local webserver (nginx) — e.g. when running `phpinfo()` — I recommend you shut down all PHP services that are currently active. You can find out what services are active by running:
|
|
|
|
sudo brew services list | grep php
|
|
|
|
This will present to you a list of services, like so (depending on the installed versions of PHP):
|
|
|
|
```
|
|
php started root /Library/LaunchDaemons/homebrew.mxcl.php.plist
|
|
php@5.6 stopped
|
|
php@7.0 stopped
|
|
php@7.1 stopped
|
|
php@7.2 stopped
|
|
php@7.3 stopped
|
|
```
|
|
|
|
You'll want to make sure that **only one service is running** and that it is running **as `root`**. You can terminate a service by running:
|
|
|
|
sudo brew services stop {service_name}
|
|
|
|
So in order to disable PHP 7.3, you'd need to run:
|
|
|
|
sudo brew services stop php@7.3
|
|
|
|
If you notice that PHP FPM is running as your own user account, you can turn off the service by running:
|
|
|
|
brew services stop php@7.3
|
|
|
|
The easiest way to make sure that PHP Monitor works again is to run the following commands:
|
|
|
|
sudo brew services stop php
|
|
sudo brew services stop php@7.3
|
|
sudo brew services stop php@7.2
|
|
sudo brew services stop php@7.1
|
|
sudo brew services stop php@7.0
|
|
sudo brew services stop php@5.6
|
|
sudo brew services stop nginx
|
|
|
|
Then, in PHP Monitor, select "Restart php-fpm service", which should start the service.
|
|
|
|
Alternatively, you can run `sudo brew services start php@7.4` where `7.4` is your preferred version of PHP (for the latest version of PHP, you may omit `@7.4` like in the example above).
|