Lección 3 de 9 · La actualización a Laravel 12

Actualizar Pest 2 a Pest 3 (PHPUnit 11) con el proyecto en Laravel 11

12 min de lectura Actualizada el 24 de octubre de 2026 Laravel 12

Hola, bienvenido. En esta lección vamos a dar el primer paso del plan: actualizar Pest 2 a Pest 3, que funciona sobre PHPUnit 11, con el proyecto todavía en Laravel 11.

Y vamos a aprovechar para dejar los tests como están en el esqueleto: tests/Pest.php con la función pest(), que es la forma de configurar Pest 3, y sin el trait CreatesApplication, que sobra desde Laravel 11.

Pest 3 y su plugin en composer.json

La guía oficial de Laravel 12 sube pestphp/pest a ^3.0, y la guía de actualización de Pest 3 añade que todos los plugins de Pest tienen que pasar también de la versión 2 a la 3. En este proyecto el único es pest-plugin-laravel, así que son 2 líneas de require-dev en composer.json:

composer.json Modificado +2 −2

2 "name": "laravel/laravel",

3 "type": "project",

4 "description": "The skeleton application for the Laravel framework.",

5 "keywords": ["laravel", "framework"],

6 "license": "MIT",

7 "require": {

8 "php": "^8.2",

9 "guzzlehttp/guzzle": "^7.2",

10 "laravel/framework": "^11.0",

11 "laravel/sanctum": "^4.0",

12 "laravel/tinker": "^2.8",

13 "livewire/livewire": "^3.4",

14 "spatie/laravel-permission": "^6.0"

15 },

16 "require-dev": {

17 "driftingly/rector-laravel": "^1.2",

18 "fakerphp/faker": "^1.9.1",

19 "larastan/larastan": "^2.9",

20 "laravel/breeze": "^2.0",

21 "laravel/pint": "^1.13",

22 "laravel/sail": "^1.26",

23 "mockery/mockery": "^1.4.4",

24 "nunomaduro/collision": "^8.1",

− "pestphp/pest": "^2.0",

− "pestphp/pest-plugin-laravel": "^2.4",

+ "pestphp/pest": "^3.0",

+ "pestphp/pest-plugin-laravel": "^3.0",

27 "rector/rector": "^1.2",

28 "spatie/laravel-ignition": "^2.0"

29 },

30 "autoload": {

31 "psr-4": {

32 "App\\": "app/",

33 "Database\\Factories\\": "database/factories/",

34 "Database\\Seeders\\": "database/seeders/"

35 }

36 },

37 "autoload-dev": {

38 "psr-4": {

39 "Tests\\": "tests/"

40 }

41 },

42 "scripts": {

43 "post-autoload-dump": [

44 "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",

45 "@php artisan package:discover --ansi"

46 ],

47 "post-update-cmd": [

48 "@php artisan vendor:publish --tag=laravel-assets --ansi --force"

49 ],

50 "post-root-package-install": [

51 "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""

52 ],

53 "post-create-project-cmd": [

54 "@php artisan key:generate --ansi"

55 ],

56 "qa": [

57 "@php artisan test",

58 "phpstan analyse",

59 "pint --test"

60 ]

61 },

62 "extra": {

63 "laravel": {

64 "dont-discover": []

65 }

66 },

67 "config": {

68 "optimize-autoloader": true,

69 "preferred-install": "dist",

70 "sort-packages": true,

71 "allow-plugins": {

72 "pestphp/pest-plugin": true,

73 "php-http/discovery": true

74 },

75 "policy": {

76 "advisories": {

77 "ignore-id": {

78 "PKSA-mdq4-51ck-6kdq": {"on-audit": false, "reason": "Sin parche en Laravel 11, corregido en la 12.60. Quitar al subir a Laravel 12."},

79 "PKSA-3r5d-mb8f-1qw9": {"on-audit": false, "reason": "Sin parche en Laravel 11, corregido en la 12.60. Quitar al subir a Laravel 12."},

80 "PKSA-m5cs-t1y6-qpcs": {"on-audit": false, "reason": "Sin parche en Laravel 11, corregido en la 12.61.1. Quitar al subir a Laravel 12."},

81 "PKSA-d5tc-s1qs-h781": {"on-audit": false, "reason": "Sin parche en Laravel 11, corregido en la 12.69. Quitar al subir a Laravel 12."}

82 }

83 }

84 }

85 },

86 "minimum-stability": "stable",

87 "prefer-stable": true

88}

2 "name": "laravel/laravel",

3 "type": "project",

4 "description": "The skeleton application for the Laravel framework.",

5 "keywords": ["laravel", "framework"],

6 "license": "MIT",

7 "require": {

8 "php": "^8.2",

9 "guzzlehttp/guzzle": "^7.2",

10 "laravel/framework": "^11.0",

11 "laravel/sanctum": "^4.0",

12 "laravel/tinker": "^2.8",

13 "livewire/livewire": "^3.4",

14 "spatie/laravel-permission": "^6.0"

15 },

16 "require-dev": {

17 "driftingly/rector-laravel": "^1.2",

18 "fakerphp/faker": "^1.9.1",

19 "larastan/larastan": "^2.9",

20 "laravel/breeze": "^2.0",

21 "laravel/pint": "^1.13",

22 "laravel/sail": "^1.26",

23 "mockery/mockery": "^1.4.4",

24 "nunomaduro/collision": "^8.1",

25 "pestphp/pest": "^3.0",

26 "pestphp/pest-plugin-laravel": "^3.0",

27 "rector/rector": "^1.2",

28 "spatie/laravel-ignition": "^2.0"

29 },

30 "autoload": {

31 "psr-4": {

32 "App\\": "app/",

33 "Database\\Factories\\": "database/factories/",

34 "Database\\Seeders\\": "database/seeders/"

35 }

36 },

37 "autoload-dev": {

38 "psr-4": {

39 "Tests\\": "tests/"

40 }

41 },

42 "scripts": {

43 "post-autoload-dump": [

44 "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",

45 "@php artisan package:discover --ansi"

46 ],

47 "post-update-cmd": [

48 "@php artisan vendor:publish --tag=laravel-assets --ansi --force"

49 ],

50 "post-root-package-install": [

51 "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""

52 ],

53 "post-create-project-cmd": [

54 "@php artisan key:generate --ansi"

55 ],

56 "qa": [

57 "@php artisan test",

58 "phpstan analyse",

59 "pint --test"

60 ]

61 },

62 "extra": {

63 "laravel": {

64 "dont-discover": []

65 }

66 },

67 "config": {

68 "optimize-autoloader": true,

69 "preferred-install": "dist",

70 "sort-packages": true,

71 "allow-plugins": {

72 "pestphp/pest-plugin": true,

73 "php-http/discovery": true

74 },

75 "policy": {

76 "advisories": {

77 "ignore-id": {

78 "PKSA-mdq4-51ck-6kdq": {"on-audit": false, "reason": "Sin parche en Laravel 11, corregido en la 12.60. Quitar al subir a Laravel 12."},

79 "PKSA-3r5d-mb8f-1qw9": {"on-audit": false, "reason": "Sin parche en Laravel 11, corregido en la 12.60. Quitar al subir a Laravel 12."},

80 "PKSA-m5cs-t1y6-qpcs": {"on-audit": false, "reason": "Sin parche en Laravel 11, corregido en la 12.61.1. Quitar al subir a Laravel 12."},

81 "PKSA-d5tc-s1qs-h781": {"on-audit": false, "reason": "Sin parche en Laravel 11, corregido en la 12.69. Quitar al subir a Laravel 12."}

82 }

83 }

84 }

85 },

86 "minimum-stability": "stable",

87 "prefer-stable": true

88}

La guía de Pest también exige Collision 8, que el proyecto ya tiene con ^8.1. Vamos a resolver las dependencias con -W (--with-all-dependencies), que permite a Composer subir también las dependencias de nuestras dependencias, como PHPUnit o Collision. Esta es la salida el 21 de octubre de 2026 (las versiones pueden cambiar cuando lo lances tú):

Terminal

sail composer update -W

Salida

Loading composer repositories with package information Updating dependencies Lock file operations: 2 installs, 27 updates, 0 removals - Upgrading brianium/paratest (v7.4.9 => v7.8.6) - Upgrading nunomaduro/collision (v8.5.0 => v8.9.5) - Upgrading pestphp/pest (v2.36.1 => v3.8.7) - Upgrading pestphp/pest-plugin (v2.1.1 => v3.0.0) - Upgrading pestphp/pest-plugin-arch (v2.7.0 => v3.1.1) - Upgrading pestphp/pest-plugin-laravel (v2.4.0 => v3.2.0) - Locking pestphp/pest-plugin-mutate (v3.0.5) - Upgrading phpunit/php-code-coverage (10.1.16 => 11.0.12) ... - Upgrading phpunit/phpunit (10.5.63 => 11.5.56) ... - Locking staabm/side-effects-detector (1.0.5) Writing lock file ... Found 4 security vulnerability advisories affecting 1 package. Run "composer audit" for a full list of advisories.

Todo lo que ha cambiado es la familia de Pest y PHPUnit: Pest 3.8, pest-plugin-laravel 3.2, PHPUnit 11.5 con sus componentes de sebastian/*, y Collision 8.9, que es la versión mínima que exige esta versión de Pest 3 y que ya admite Laravel 12. laravel/framework no aparece en la lista: sigue en la versión 11.57.

¿Y el error de Composer por los avisos de seguridad? No ha aparecido gracias a las 4 excepciones de composer.json: sin ellas, este update -W habría fallado. Los 4 avisos que cuenta al final son esos mismos.

Antes de cambiar ningún archivo de los tests, vamos a comprobar que Pest 3 ejecuta la suite tal como está:

Terminal

sail test

Salida

PASS Tests\Unit\SlaTest ✓ the due date depends on the priority with dataset "high" 0.02s ... Tests: 82 passed (175 assertions) Duration: 5.58s

Los mismos 82 tests en verde, ahora sobre PHPUnit 11.

Lo que queda de esta lección

02Lo que cambia en Pest 3
03tests/Pest.php con la función pest()
04tests/CreatesApplication.php sobra desde Laravel 11
05composer qa en verde y el commit

Sigue leyendo con tu suscripción El curso completo, con el certificado y el foro, está incluido en la suscripción. Ver los planes ¿Ya tienes cuenta? Entra

🎃 12 meses por 75 €

🎃 Halloween: 12 meses por 75 €

Actualizar Pest 2 a Pest 3 (PHPUnit 11) con el proyecto en Laravel 11

Pest 3 y su plugin en composer.json