Skip to content
Brezel Docs
Blog

Migrate to brezel/api 1.0

brezel/api 1.0 brings a lot of underlying changes. Functionally, not much is different, but technically, a lot is new.

We now use PHP 8.4 and Laravel 11 with a bunch of new packages and an optimized and linted codebase.

To update your project to brezel/api 1.0, follow these steps:

  1. Update to the latest version of brezel/api 0.x. Ensure that your production environment also got that update.
  2. Install PHP 8.4 on your machine and all servers that run brezel/api. Look at https://wiki.brezel.io/deploy/virtual_server/ for instructions.
  3. Now, update your project to the latest brezel/api 1.x version.
    • For that delete the vendor folder and the composer.lock file.
    • Go into your composer.json and remove "@composer check-platform-reqs" from the pre-update-cmd hook in the scripts section if present.
    • Run composer update to install the new dependencies.
    • Re-add "@composer check-platform-reqs" to the pre-update-cmd hook in the scripts section in your composer.json file.
  4. Update your .env file to match the new .env.example file.
  5. Run / deploy as normal
    • Make sure to test important parts of your application to ensure that everything works as expected.