- 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 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
- Rename
- If you're using Expose and want to connect it to Valet, make sure to upgrade to v2.6.0 or higher