From b8c621648d450667ae5b7448b184e05eec4709fe Mon Sep 17 00:00:00 2001 From: Matt Stauffer Date: Wed, 15 Mar 2023 14:47:50 -0400 Subject: [PATCH] Bring back UPGRADE.md for now --- UPGRADE.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 UPGRADE.md diff --git a/UPGRADE.md b/UPGRADE.md new file mode 100644 index 0000000..72fb5ff --- /dev/null +++ b/UPGRADE.md @@ -0,0 +1,12 @@ +# Upgrading to v4 + +- You must have PHP 8.0+ installed, and set as your primary/linked PHP install when you install v4; you can use 7.4+ as your primary after that, but need to keep a version of 8+ installed at all times +- You must run `valet` once for the upgrader to run; this will attempt to update all of your configuration items and custom local drivers for v4 +- If you have any issues with your drivers, all custom drivers (including the `SampleValetDriver` published by previous versions of Valet) must have the following; see the [new SampleValetDriver](https://github.com/laravel/valet/blob/d7787c025e60abc24a5195dc7d4c5c6f2d984339/cli/stubs/SampleValetDriver.php) for an example: + - Match the new type hints of the base ValetDriver + - Extend the new namespaced drivers instead of the old globally-namespaced drivers + - Have their own namespace +- If you have any `.valetphprc` files in your projects, update them to use the new `.valetrc` syntax: + - Rename `.valetphprc` to `.valetrc` + - Add `php=` before the version number; e.g. `php=php@8.2` +- If you're using Expose and want to connect it to Valet, make sure to upgrade to v2.6.0 or higher