¿Cómo pruebas aplicaciones Laravel?

Question

Accepted Answer

Laravel proporciona excelente soporte de pruebas integrado (en PHPUnit, con la opción moderna Pest) más ayudantes específicos para pruebas — una base de datos de prueba, pruebas HTTP, ayudantes de autenticación, y fakes — haciendo que las aplicaciones sean altamente comprobables. Las pruebas se dividen en pruebas de feature (flujo de solicitud completo) y pruebas unitarias (lógica aislada).

## Pruebas de feature — prueba el flujo de solicitud completo

```php
class UserTest extends TestCase {
    use RefreshDatabase;            // fresh, migrated test database per test (isolated)

public function test_can_create_user(): void {
        $response = $this->postJson('/api/users', [    // make a real request to the app
            'name' => 'Ann', 'email' => 'ann@x.com',
        ]);
        $response->assertStatus(201)
                 ->assertJson(['name' => 'Ann']);       // assert the response
        $this->assertDatabaseHas('users', ['email' => 'ann@x.com']);   // assert the DB
    }
}
```

**Las pruebas de feature** ejercen la pila completa (enrutamiento, middleware, validación, controlador, base de datos) haciendo solicitudes HTTP con ayudantes como `get`/`postJson`, luego afirmando sobre la respuesta y el estado de la base de datos (`assertDatabaseHas`). Esto verifica el comportamiento real de la aplicación.

## Los ayudantes de prueba hacen que Laravel sea altamente comprobable

```php
$this->actingAs($user)->get('/dashboard');         // authenticate as a user
User::factory()->count(10)->create();               // generate test data via factories

Mail::fake(); Mail::assertSent(WelcomeEmail::class);   // assert mail without sending
Queue::fake(); Queue::assertPushed(ProcessJob::class); // assert jobs queued, don't run them
Event::fake(); Storage::fake('s3');                    // fake events, storage, etc.
Http::fake();                                           // fake external HTTP calls
```

Los **fakes** de Laravel (`Mail::fake()`, `Queue::fake()`, `Http::fake()`, etc.) te permiten afirmar que los emails fueron enviados, los trabajos fueron encolados, o las llamadas HTTP fueron realizadas — *sin* realizarlas realmente, permitiendo pruebas rápidas, aisladas y deterministas. Los ayudantes `actingAs` y factory facilitan la configuración de escenarios de prueba autenticados y ricos en datos.

## Pruebas unitarias y Pest

```php
// unit test — isolated logic, no framework/DB
public function test_discount_calculation(): void {
    $this->assertEquals(90, (new Cart)->applyDiscount(100, 10));
}

// Pest — a modern, expressive testing syntax on top of PHPUnit (popular in Laravel)
it('creates a user', fn() => post('/users', [...])->assertCreated());
```

## Por qué es importante

Las pruebas son esenciales para aplicaciones confiables, y el excelente soporte de pruebas integrado en Laravel — con ayudantes conscientes de la web que hacen que las aplicaciones sean notablemente comprobables — significa que entender cómo probar es importante tanto para la calidad del código como expectativa profesional. **Las pruebas de feature** son especialmente valiosas: al hacer solicitudes HTTP reales a la aplicación y afirmar sobre respuestas y estado de la base de datos (con el trait `RefreshDatabase` proporcionando una base de datos de prueba aislada), verifican que todo el flujo de solicitud (enrutamiento, middleware, validación, controladores, persistencia) funciona correctamente juntos — probando el comportamiento real tal como los usuarios lo experimentan.

Los **ayudantes de prueba y fakes de Laravel** son lo que hace esto tan práctico: `actingAs` para autenticación, **factories** para generar datos de prueba, y especialmente los **fakes** (`Mail::fake()`, `Queue::fake()`, `Http::fake()`, `Event::fake()`) que te permiten afirmar que los efectos secundarios ocurrieron (emails enviados, trabajos encolados, llamadas externas realizadas) *sin* realizarlos realmente — permitiendo pruebas rápidas, aisladas y deterministas de comportamiento complejo.

Entender pruebas de feature vs unitarias, los ayudantes de prueba y fakes, factories para datos, y la opción moderna Pest cubre el alcance práctico de pruebas efectivas en Laravel.

Ya que Laravel proporciona herramientas de prueba tan fuertes y conscientes de la web, y ya que las aplicaciones bien probadas detectan regresiones y permiten refactorización confiada, saber cómo aprovechar el soporte de pruebas de Laravel — particularmente pruebas de feature y los ayudantes fake/factory — es conocimiento importante de nivel senior que distingue a desarrolladores que construyen aplicaciones robustas y mantenibles de aquellos que entregan código untested y frágil, reflejando práctica de ingeniería profesional.