From dd27b915276b71aaba9daf5693a6e2ab767b9ff3 Mon Sep 17 00:00:00 2001 From: Nico Verbruggen Date: Wed, 6 Jan 2021 17:49:26 +0100 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20Updated=20quick=20troubleshootin?= =?UTF-8?q?g?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 22 +++++++++++++--------- docs/ADDITIONAL.md | 12 ++++++++++++ 2 files changed, 25 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 57155b2..b8617b3 100644 --- a/README.md +++ b/README.md @@ -72,7 +72,7 @@ This app isn't very complicated after all. In the end, this just (conveniently) ## 🤬 Troubleshooting -**If you are having issues, the first thing you should be doing is installing the latest version of PHP Monitor _and_ Laravel Valet. This can resolve a variety of issues. Don't forget to run `valet install` after upgrading.** +**If you are having issues, the first thing you should be doing is installing the latest version of PHP Monitor _and_ Laravel Valet. This can resolve a variety of issues. To upgrade Valet, run `composer global update`. Don't forget to run `valet install` after upgrading.** PHP Monitor performs some integrity checks to ensure a good experience when using the app. You'll get a message telling you that PHP Monitor won't work correctly in the following scenarios: @@ -85,25 +85,29 @@ PHP Monitor performs some integrity checks to ensure a good experience when usin Follow instructions as specified in the alert in order to resolve any issues. -## 🤔 Quick Troubleshooting +## 🏎 Quick Troubleshooting -### PHP Monitor says that the latest version of PHP is not installed, but it is! +### PHP Monitor tells me `php` is not installed 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.) -### PHP Monitor says the correct version is loaded, but my Valet sites don't work! + brew install php + brew link php --force + +### Valet sites won't load (502 Bad Gateway) -Your sites aren't showing up, or you are seeing a 502? It's a common issue. +If you're visiting your `.test` domain, and you're getting a 502 (Bad Gateway) after switching to a different PHP version, you're dealing with a common issue. -You may need to run `valet install`, preferably after updating `valet` by running `composer global update`. +This problem is usually resolved by upgrading Valet and running `valet install` again. -## 📝 Quick Setup & FAQ + composer global update + valet install -Please consult the [additional information][2] file that contains more information. +## 📝 Additional Info -It has answers to additional questions and more information to troubleshoot your problem. +Please consult the [additional file][2] that contains more information. It may have answers to additional questions and more information to troubleshoot your problem. ## ⭐️ Star me! diff --git a/docs/ADDITIONAL.md b/docs/ADDITIONAL.md index cf62bb2..8c22bd0 100644 --- a/docs/ADDITIONAL.md +++ b/docs/ADDITIONAL.md @@ -66,6 +66,18 @@ You can do this by dragging *PHP Monitor.app* into the **Login Items** section i 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._