Pruebas de Creación de Datos en Aplicaciones Web

Curso de Estándares y Buenas Prácticas para API REST con Laravel

Contenido del curso

Buenas prácticas a nivel general

Creación del proyecto

Planificación y mantenimiento

Funciones de seguridad

API Testing

API Breaking Changes

Conclusiones

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:007:37

Pruebas de Creación de Datos en Aplicaciones Web

Curso de Estándares y Buenas Prácticas para API REST con Laravel

Clase 24 de 29

Clase 24 / 29

Comentarios (2)2 comentarios

Jorge Andrés Pérez Jiménez

Hace 3 años

En mi caso me salió error al cargar la imagen con el código implementado:

❌GD extension is not installed.

Encontré esta solución en ChatGPT:

Abrir el archivo php.ini en tu editor de texto preferido.
Busca la línea ;extension=gd y elimina el punto y coma al principio para habilitar la extensión GD. Debería verse así: extension=gd
Guarda el archivo y reinicia tu servidor web.

Después de esto, deberías poder utilizar el método image de UploadedFile::fake() sin problemas.

Añaqui Apolinar Morales

Hace 2 años

Exclente, de mucha ayuda

Kenneth Angulo L

Hace 2 años

Complemento por aquí el código, en este valido, además:

que la información haya quedado almacenada en la base de datos (por eso le paso datos específicos).
Valido el almacenamiento de la imagen en la carpeta ‘publica’
Y valido también el almacenamiento en la tabla pivot que relaciona con tags.

public function test_api_route_store(): void
{
	//Arrange 🛠
	Storage::fake('public'); // Simulate the 'local' disk
	$user = Sanctum::actingAs(User::factory()->create());
	$category = Category::factory()->create();
	$image = UploadedFile::fake()->image('recipe.jpg', 640, 480)->size(1000);
	$tags = Tag::factory()->count(3)->create()->pluck('id')->toArray();


	// Act ⚙️
	$response = $this->postJson(route('v1.recipes.store'), [
		'title'        => 'Test Recipe',
		'description'  => 'This is a test recipe',
		'category_id'  => $category->id,
		'ingredients'  => 'these are the ingredients',
		'instructions' => 'these are the instructions',
		'image'        => $image,
		'tags'         => json_encode($tags),
	]);


	// Assert ✅
	// $response->assertStatus(201); // Ensure the recipe was created (HTTP 201)
	$response->assertStatus(Response::HTTP_CREATED); // 200
	$this->assertDatabaseHas('recipes', [
		'title'        => 'Test Recipe',
		'description'  => 'This is a test recipe',
		'category_id'  => $category->id,
		'user_id'      => $user->id,
	]);

	$recipe = Recipe::where('title', 'Test Recipe')->first();
	$this->assertNotNull($recipe);

	// Assert the image was stored
	Storage::disk('public')->assertExists($recipe->image);

	// Assert tags were attached
	$this->assertCount(3, $recipe->tags);
}

Juan Pablo Campuzano Monsalve

Hace 2 años

Excelente! Es una forma muy buena de complementar el código y hacerlo todavía más funcional

Recursos

¿Cómo probar la funcionalidad de creación en una aplicación?

Probar nuestras funcionalidades es esencial para garantizar que todo funcione como debería. Aquí te explicaremos cómo llevar a cabo la prueba de la función de creación en tu aplicación, simulando el envío de datos desde un formulario.

¿Cuál es el punto de partida para las pruebas?

El primer paso es visitar una ruta específica y analizar la respuesta obtenida. Habitualmente, se comienza por funcionalidad como index, show o eliminar. Para esta ocasión, nos centraremos en la función de creación.

Para ello, nos dirigimos al archivo de recetas y copiamos el código de show como base. Luego, nos aseguramos de adaptarlo para trabajar con el método de creación.

¿Cómo simular los datos de entrada?

Creamos una variable para las etiquetas, simulando los datos que el formulario podría enviar. Es crucial que no se intente crear una receta directamente; en su lugar, aprovechamos el método POST.

$etiquetas = []; // Simulación de datos de etiqueta

Para esta función, estructuramos un array que contenga todos los campos requeridos, como category ID, title y description. Para el título, utilizamos Faker para generar un texto aleatorio.

¿Cómo manejar diferentes tipos de datos?

Cada campo necesita atención particular para simular un escenario real:

Categoría: Usamos category ID como referencia.
Título: Generado aleatoriamente con Faker.
Descripción: Puede ser un breve párrafo.
Ingredientes: Se utiliza un texto que haga sentido con la realidad.
Instrucciones: También se maneja con un texto.
Imagen: Usamos una clase especial que simula la carga de un archivo. Se especifica que es un archivo PNG.

$image = new Image;
$image::fake()->image('file.png');

¿Qué rutas se deben visitar y qué esperar?

La siguiente acción es visitar la ruta de creación mediante POST. En lugar de trabajar con un ID, se pasa toda la información simulada. La expectativa es recibir un estado que confirme la creación correcta.

¿Qué clases y traits son necesarios?

Es vital importar las clases y traits necesarios para que el código funcione. Al añadir las instrucciones en la parte superior de tu archivo, garantizas que todo sea reconocido y funcione como esperado:

use Illuminate\Http\UploadedFile; // Para la carga de archivos
use Faker\Factory as Faker; // Para generar datos aleatorios

¿Qué sucede si algo falla en las pruebas?

Si en el proceso te encuentras con que falta una etiqueta u otro elemento, asegúrate de importar correctamente las clases correspondientes. Esto puede requerir ajustar el código:

use App\Models\Etiqueta;

¿Cómo confirmamos que la función es robusta?

Una vez estructurado el código, ejecutar la prueba como lo harías con PHP Artisan:

php artisan test

Al hacerlo, verifica que la salida del test coincida con las expectativas previas. Si el código se ejecuta sin errores, significa que la creación, las relaciones de datos, y la carga de archivos funcionan correctamente.

Probar tu aplicación asegura que cada funcionalidad publicada pueda ofrecer la calidad esperada. Atrévete a realizar estas prácticas en tus proyectos para tener una base sólida y confiable. ¡Sigue aprendiendo y mejorando día a día tus habilidades en desarrollo!

public function test_api_route_store(): void
{
	//Arrange 🛠
	Storage::fake('public'); // Simulate the 'local' disk
	$user = Sanctum::actingAs(User::factory()->create());
	$category = Category::factory()->create();
	$image = UploadedFile::fake()->image('recipe.jpg', 640, 480)->size(1000);
	$tags = Tag::factory()->count(3)->create()->pluck('id')->toArray();


	// Act ⚙️
	$response = $this->postJson(route('v1.recipes.store'), [
		'title'        => 'Test Recipe',
		'description'  => 'This is a test recipe',
		'category_id'  => $category->id,
		'ingredients'  => 'these are the ingredients',
		'instructions' => 'these are the instructions',
		'image'        => $image,
		'tags'         => json_encode($tags),
	]);


	// Assert ✅
	// $response->assertStatus(201); // Ensure the recipe was created (HTTP 201)
	$response->assertStatus(Response::HTTP_CREATED); // 200
	$this->assertDatabaseHas('recipes', [
		'title'        => 'Test Recipe',
		'description'  => 'This is a test recipe',
		'category_id'  => $category->id,
		'user_id'      => $user->id,
	]);

	$recipe = Recipe::where('title', 'Test Recipe')->first();
	$this->assertNotNull($recipe);

	// Assert the image was stored
	Storage::disk('public')->assertExists($recipe->image);

	// Assert tags were attached
	$this->assertCount(3, $recipe->tags);
}

Resumen

¿Cómo probar la funcionalidad de creación en una aplicación?

¿Cuál es el punto de partida para las pruebas?

Para ello, nos dirigimos al archivo de recetas y copiamos el código de show como base. Luego, nos aseguramos de adaptarlo para trabajar con el método de creación.

¿Cómo simular los datos de entrada?

Creamos una variable para las etiquetas, simulando los datos que el formulario podría enviar. Es crucial que no se intente crear una receta directamente; en su lugar, aprovechamos el método POST.

$etiquetas = []; // Simulación de datos de etiqueta

Para esta función, estructuramos un array que contenga todos los campos requeridos, como category ID, title y description. Para el título, utilizamos Faker para generar un texto aleatorio.

¿Cómo manejar diferentes tipos de datos?

Cada campo necesita atención particular para simular un escenario real:

Categoría: Usamos category ID como referencia.
Título: Generado aleatoriamente con Faker.
Descripción: Puede ser un breve párrafo.
Ingredientes: Se utiliza un texto que haga sentido con la realidad.
Instrucciones: También se maneja con un texto.
Imagen: Usamos una clase especial que simula la carga de un archivo. Se especifica que es un archivo PNG.

$image = new Image;
$image::fake()->image('file.png');

¿Qué rutas se deben visitar y qué esperar?

¿Qué clases y traits son necesarios?

use Illuminate\Http\UploadedFile; // Para la carga de archivos
use Faker\Factory as Faker; // Para generar datos aleatorios

¿Qué sucede si algo falla en las pruebas?

Si en el proceso te encuentras con que falta una etiqueta u otro elemento, asegúrate de importar correctamente las clases correspondientes. Esto puede requerir ajustar el código:

use App\Models\Etiqueta;

¿Cómo confirmamos que la función es robusta?

Una vez estructurado el código, ejecutar la prueba como lo harías con PHP Artisan:

php artisan test

Buenas prácticas a nivel general

Buenas prácticas para diseñar una API REST

¿Qué son los HTTP Status Codes?

Qué hace cada método HTTP

Creación del proyecto

Migrações e relações de dados em Laravel

Factories y seeders para poblar tu API en Laravel

Consultas API con Laravel: Rutas y Controladores

Consultas con relaciones en Laravel API

Planificación y mantenimiento

Planificación de rutas REST en Laravel

Recursos y colecciones en Laravel API

Recursos anidados en Laravel API

Cómo reducir 932 consultas con Telescope

CRUD de Recetas con Laravel y Symfony en Visual Studio Code

Validación de Datos en Aplicaciones Web con Laravel

Funciones de seguridad

Autenticación vs. autorización

Proteger rutas de API con Sanctum

Ruta de login y tokens con Sanctum

Corrección de bugs de seguridad en aplicaciones web

Políticas de acceso en Laravel con Artisan

Upload e validação de imagens em Laravel

Qué es autenticación en la web

API Testing

Automatiza pruebas de API en Laravel

Testing de Módulos Administrativos en Visual Studio Code

Testing de recetas con PHP Artisan

Pruebas de Creación de Datos en Aplicaciones Web

Test de actualización de recetas en Laravel

API Breaking Changes

Versionado de API en Laravel con v1 y v2

Desarrollo de API con TDD: Implementación de Versión 2

Conclusiones

Desarrollo de API RESTful con Laravel: Buenas Prácticas y Seguridad

Buenas prácticas finales para tu API en Laravel

Pruebas de Creación de Datos en Aplicaciones Web