Cómo hacer upgrade de Laravel 8 a Laravel 9

Hace pocos días ha salido la nueva versión de Laravel la versión 9, en este tutorial te mostraré cómo hacer upgrade de Laravel 8 a Laravel 9 para que tengas las últimas funcionalidades y seguridad en todos tus proyectos. Sin más, manos a la obra.

Requisitos previos

1. Es muy importante que en tu servidor o ambiente de desarrollo funcione PHP 8 ya que Laravel 9 sólo funciona con esta versión de PHP.
2. Acceso SSH a tu servidor (si estás en local no hace falta)

Cómo hacer upgrade de Laravel 8 a Laravel 9

1. Hacer cambios en el archivo composer.json

Abre el proyecto que quieres hacer upgrade con tu editor de textos y abre el archivo composer.json

1.1 Cambiar versión de PHP

Laravel 9 únicamente funciona con la versión 8 de PHP por lo que es necesario cambiarlo en este archivo:

"php": "^8.0",

1.2 Cambiar versión de Laravel

En la línea en donde se muestra la versión de Laravel cambia a Laravel 9:

"laravel/framework": "^9.0"

1.3 Cambiar versión de nunomaduro

En la línea en donde se encuentra nunomaduro/collision de debe cambiar a la versión 6:

"nunomaduro/collision": "^6.1",

1.4 Remplazar librería facade/ignition

Es necesario reemplazar la librería facade/ignition por spatie/laravel-ignition:

«spatie/laravel-ignition»: «^1.0»

Cambia esa línea por:

2. Correr composer update

Desde la terminal de comandos abierta en la raíz de tu proyecto escribe:

composer update

En este caso me muestra un error con la librería shoppingcart por lo que es necesario ir a la documentación de la librería bumbummen99/shoppingcart en GitHub. Me comuniqué con el autor y me contesto que actualmente esta librería solo funciona con Laravel 8 y que ellos ya están trabajando en la actualización para que corra en Laravel 9.

Actualización. La librería shoppingcart ya ha sido actualizada por su autor y ahora al ejecutar el comando composer update se actualiza automáticamente y el error anterior ya no se muestra.

composer update

Ahora arrojó un problema con los headers, para solucionarlo abre el archivo que se encuentra en app/Http/Middleware/TrustProxies.php y localiza en el inicio del archivo la línea:

use Fideloper\Proxy\TrustProxies as Middleware;

Esa línea se debe cambiar por:

use Illuminate\Http\Middleware\TrustProxies as Middleware;

Verifica al final del archivo si tienes esta línea:

protected $headers = Request::HEADER_X_FORWARDED_ALL;

La debes de cambiar por:

protected $headers =
Request::HEADER_X_FORWARDED_FOR|
Request::HEADER_X_FORWARDED_HOST|
Request::HEADER_X_FORWARDED_PORT|
Request::HEADER_X_FORWARDED_PROTO|
Request::HEADER_X_FORWARDED_AWS_ELB;

Ahora desde la terminal escribe:

composer remove fideloper/proxy

Y vuelve a correr:

composer update

Ya se instalaron correctamente las librerías, ahora ve a la terminal y escribe:

php artisan --version

Verás que ya está instalado Laravel 9:

Te recomiendo probar cada una de las vistas y funciones de tu aplicación antes de subir los cambios a tu servidor de producción.

Conclusión

En este tutorial aprendiste a cómo hacer upgrade de Laravel 8 a Laravel 9 para más información lee la guía oficial que encontrarás al final de este post, si te aparecen errores en algunas de tus librerías ve a la documentación oficial de la librería para ver cómo solucionar el problema. Si te fue de ayuda este tutorial te invito a compartirlo en tus redes sociales y si tienes dudas o comentarios déjalos en la caja de comentarios, estaré al pendiente de ellos. Saludos.

Fuente: Upgrade Guide Laravel