En la primera semana del presente mes (febrero) se ha lanzado la nueva versión mayor de Laravel y es por eso que en este tutorial aprenderás cómo hacer upgrade de Laravel 9 a Laravel 10 para que mantengas actualizados todos tus proyectos. Sin más, manos a la obra.
Requisitos previos
- Contar con PHP en la versión 8.1 ya que esta es la versión mínima con la que funciona Laravel 10.
- Tener composer instalado de manera global en su versión 2.2.0 o superior.
- Editor de textos como PHPStorm o VS Code.
Cómo hacer upgrade de Laravel 9 a Laravel 10
1. Hacer cambios en el archivo composer.json
Desde tu editor de textos abre el proyecto que quieres actualizar a Laravel 10 y en la raíz del mismo abre el archivo composer.json:
1.1 Cambiar la versión de PHP
A diferencia de Laravel 9 que funciona con PHP 8.0, Laravel 10 solo trabaja a partir de PHP 8.1 por lo que es necesario hacer el cambio en el archivo composer.json:
"php": "^8.1.0",
1.2 Actualizar versión de Laravel
Busca la línea en donde se muestra la versión de Laravel y cambia de 9.0 a 10.0:
"laravel/framework": "^10.0"
1.3 Spatie/laravel-ignition
En la sección «require-dev» busca la línea de spatie/laravel-ignition y cambia la versión por la 2.0:
"spatie/laravel-ignition": "^2.0",
1.4 Numomaduro/collision
En la línea de nunomaduro/collision cambia su versión por la 7.0:
"nunomaduro/collision": "^7.0",
1.5 Phpunit/phpunit
Busca la línea de phpunit/phpunit y cambia la versión por la 10.0:
"phpunit/phpunit": "^10.0"
1.6 Minimum-stability
Casi al final del archivo busca la línea minimum-stability y cambia a «stable»:
"minimum-stability": "stable",
2. Ejecutar composer update
Antes de ejecutar la instrucción composer update borra el archivo composer.lock que se encuentra en la raíz de tu proyecto:
Después de borrar el archivo composer.lock ejecuta la siguiente instrucción en la terminal de comandos:
composer update
Si todo sale bien verás que tu proyecto en Laravel se ha actualizado a la versión 10. Ahora éstos son los pasos podemos decir «genéricos» para hacer un upgrade los cuales pueden variar de acuerdo a las dependencias que tiene tu proyecto en Laravel, si tienes errores observa que paquetes son los confictivos y ve a su documentación lo más problale es que tengas que hacer unos pasos extra.
Para verificar la versión de tu proyecto en Laravel ejecuta la siguiente instrucción en la terminal de comandos:
php artisan --version
Conclusión
En este tutorial aprendiste facilmente cómo hacer upgrade de Laravel 9 a Laravel 10. Recuerda que según las dependencias de tu proyecto es posible que requieras seguir más pasos que seguramente encontrarás en la documentación de esas dependencias. Si este tutorial fue de ayuda te invito a que lo compartas en tus redes sociales para que llegue a más personas y si tienes dudas o comentarios déjalos en la caja de comentarios, estaré al pendiente de ellos. Saludos!
Fuente: Laravel documentación.
