Tutorial CRUD en Laravel 12 - Sistema de Pasteles-index

🎯 Objetivo

Crear un sistema CRUD completo para una tabla de pasteles en Laravel 12, usando las mejores prácticas y herramientas modernas.

---

Nota importante sobre Namespaces: En Laravel, cada clase vive en un namespace (una "carpeta lógica"). Para usar una clase de otro namespace, debes importarla con use al inicio del archivo. Esto NO es include ni require; solo crea un alias. Si olvidas el use, PHP buscará la clase en el namespace actual y lanzará "Class not found". Lo iremos señalando en cada paso.

📋 Índice del Tutorial

1. Configuración inicial del proyecto

2. Creación de la migración

3. Creación del modelo (¡PASO CLAVE!)

4. Creación del Factory

5. Creación del Seeder

6. Ejecutar migraciones y seeders

7. Probar con Laravel Tinker

8. Creación del controlador

9. Creación de las vistas

10. Definición de rutas

11. Pruebas finales

Índice

Propósito	Comando
1-Configuración inicial	composer create-project laravel/laravel nombre-proyecto
2-Creación de la migración	php artisan make:migration create_pasteles_table
3-Creación del modelo	php artisan make:model Pastel
4-Creación del seeder	php artisan make:seeder PastelSeeder
5-Creación del controlador	php artisan make:controller PastelController
6-Definición de rutas	php artisan route:list
7-Creación de vistas	(Crear manualmente en resources/views/)
8-Mejores prácticas y optimizaciones	php artisan optimize

---

1️⃣ Configuración inicial

Requisitos previos

bash

# Verifica PHP (mínimo 8.2)

php -v

# Verifica Composer

composer -V

# Crear proyecto

composer create-project laravel/laravel pasteles-app

cd pasteles-app

# Configurar .env

DB_CONNECTION=mysql

DB_HOST=127.0.0.1

DB_PORT=3306

DB_DATABASE=pasteles_db

DB_USERNAME=root

DB_PASSWORD=

---

Si tu servicio PHP se llama app, entonces ejecuta:

text

docker compose exec app php artisan make:controller PastelController

Esto hace exactamente lo que querías, pero ejecuta PHP dentro del contenedor.

Si tu contenedor realmente se llama laravel-docker, puedes hacer:

text

docker exec -it laravel-app-1 /bin/bash

docker exec -it laravel-docker /bin/bash

Una vez dentro, verás algo parecido a:

text

root@abc123:/var/www/html#

Entonces ya puedes ejecutar:

text

php artisan make:controller PastelController

Con esto ya tienes el flujo completo: crear la migración → ejecutarla → y saber cómo deshacer o reiniciar cuando sea necesario

2️⃣ Creación de la migración

Las migraciones en Laravel son como un control de versiones para tu base de datos. Permiten definir y modificar la estructura de las tablas (crear, alterar o eliminar columnas) usando código PHP en lugar de SQL manual. 

bash

php artisan make:migration create_pasteles_table

Edita el archivo creado en database/migrations/:

php

<?php

use Illuminate\Database\Migrations\Migration;

use Illuminate\Database\Schema\Blueprint;

use Illuminate\Support\Facades\Schema;

return new class extends Migration

{

    public function up(): void

    {

        Schema::create('pasteles', function (Blueprint $table) {

            $table->id();

            $table->string('nombre', 100);

            $table->enum('sabor', ['chocolate', 'vainilla', 'cheesecake', 'fresa', 'coco']);

            $table->decimal('precio', 8, 2);

            $table->boolean('disponible')->default(true);

            $table->text('descripcion')->nullable();

            $table->timestamps();

            $table->softDeletes(); // Eliminación lógica

        });

    }

    public function down(): void

    {

        Schema::dropIfExists('pasteles');

    }

};

---

🧠 Namespaces aquí: fíjate que Migration, Blueprint y Schema están en namespaces distintos (Illuminate\Database\Migrations, Illuminate\Database\Schema, Illuminate\Support\Facades). Por eso van los tres use arriba. Si quitas uno, verás: "Class 'Blueprint' not found". Las clases Migration y Blueprint no van con use solo por estética: son obligatorios.

Comando para ejecutar las migraciones

bash

php artisan migrate

Flujo recomendado completo

bash

# 1. Crear la migración
php artisan make:migration create_pasteles_table

# 2. Editar el archivo en database/migrations/ (lo que ya hiciste)

# 3. Ejecutar
php artisan migrate

# 4. (Opcional) Verificar en tu BD o con:
php artisan migrate:status

Ejecución de las migraciones

Una vez definida la migración, estos son los comandos que usarás en el día a día:

Comando	¿Qué hace?
php artisan migrate	Ejecuta todas las migraciones pendientes (crea la tabla en la BD).
php artisan migrate:fresh	Elimina todas las tablas y vuelve a ejecutar todas las migraciones desde cero. Útil para reiniciar el proyecto en desarrollo.
php artisan migrate:refresh	Hace un rollback (reversión) de todas las migraciones y luego ejecuta migrate de nuevo. Es como un "reinicio suave" que conserva los datos de los seeders si los tienes.
php artisan migrate:rollback	Revierte solo el último lote de migraciones (las que se ejecutaron en la última tanda).
php artisan migrate:status	Muestra el estado de todas las migraciones (cuáles están ejecutadas y cuáles pendientes).

Probar con Laravel Tinker (¡MANUAL DETALLADO!)

🔹 Abrir Tinker

bash

php artisan tinker

🔹 Verificar que la tabla existe

php

>>> Schema::hasTable('pasteles')

=> true

🔹 Ver los campos de la tabla

php

>>> Schema::getColumnListing('pasteles')

=> [

     "id",

     "nombre",

     "sabor",

     "precio",

     "disponible",

     "descripcion",

     "created_at",

     "updated_at",

     "deleted_at",

   ]

// 4. Salir de Tinker

>>> exit

3️⃣ Creación del modelo (¡PASO CLAVE!)

El modelo es lo que conecta tu código con la base de datos.

php artisan make:model Pastel

Edita app/Models/Pastel.php:

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;

use Illuminate\Database\Eloquent\Model;

use Illuminate\Database\Eloquent\SoftDeletes;

class Pastel extends Model

{

    use HasFactory, SoftDeletes;

    protected $table = 'pasteles';

    protected $fillable = [

        'nombre',

        'sabor',

        'precio',

        'disponible',

        'descripcion'

    ];

    // Esto es útil para que Laravel trate los tipos de datos correctamente

    protected $casts = [

        'precio' => 'decimal:2',

        'disponible' => 'boolean',

        'created_at' => 'datetime',

        'updated_at' => 'datetime',

    ];

}

¿Por qué es importante tener el modelo primero?

• Laravel necesita saber qué campos tiene tu tabla

• Los factories y seeders dependen del modelo

• Sin modelo, no puedes usar Tinker para probar

🧠 Dos tipos de use (¡no los confundas!):

• use Illuminate\...\Model; → importa una clase. Va antes de class.

• use HasFactory, SoftDeletes; → aplica traits dentro de la clase. Va después de class.

Si pones un trait arriba, error. Si pones una clase abajo, error.

---

4️⃣ Creación del Factory

Factory: es la receta/plantilla para generar datos falsos de un modelo (ej. usuarios, posts). Define cómo se crean esos datos. 

User::factory()->create();        // crea 1 usuario

User::factory()->count(50)->create(); // crea 50 usuarios

Ventajas:

• Ahorran tiempo al escribir pruebas.

• Pueblan la BD con datos realistas sin escribirlos a mano.

• Se combinan con los Seeders para llenar la base de datos de desarrollo.

bash

php artisan make:factory PastelFactory

Edita database/factories/PastelFactory.php:

<?php

namespace Database\Factories;

use Illuminate\Database\Eloquent\Factories\Factory;

use App\Models\Pastel;

class PastelFactory extends Factory

{

    protected $model = Pastel::class;

    public function definition(): array

    {

        $sabores = ['chocolate', 'vainilla', 'cheesecake', 'fresa', 'coco'];

        return [

            'nombre' => 'Pastel ' . $this->faker->firstName() . ' ' . $this->faker->lastName(),

            'sabor' => $this->faker->randomElement($sabores),

            'precio' => $this->faker->randomFloat(2, 50, 500),

            'disponible' => $this->faker->boolean(80),

            'descripcion' => $this->faker->paragraph(2),

            'created_at' => $this->faker->dateTimeBetween('-1 year', 'now'),

            'updated_at' => $this->faker->dateTimeBetween('-1 month', 'now'),

        ];

    }}

 Namespaces aquí: el factory vive en Database\Factories, pero el modelo vive en App\Models. Son namespaces distintos → necesitas use App\Models\Pastel;. Si lo olvidas, PHP buscaría Database\Factories\Pastel y fallaría.

---

5️⃣ Creación del Seeder

Los Seeder es el ejecutable que llena la base de datos con datos (iniciales, de prueba o demo). Puede usar factories o datos fijos . 

• Insertan registros en las tablas (usuarios, roles, categorías, etc.).

• Se ejecutan con php artisan db:seed.

• Suelen usar Factories para generar datos falsos.

bash

php artisan make:seeder PastelSeeder

Edita database/seeders/PastelSeeder.php:

php

<?php

namespace Database\Seeders;

use Illuminate\Database\Seeder;

use App\Models\Pastel;

class PastelSeeder extends Seeder

{

    public function run(): void

    {

        // Crear 30 pasteles falsos usando el factory

        Pastel::factory(30)->create();

        

        // También podemos crear uno específico

      //  Pastel::create([

     //       'nombre' => 'Pastel Especial de Chocolate',

      //      'sabor' => 'chocolate',

      //      'precio' => 350.00,

     //       'disponible' => true,

    //        'descripcion' => 'Nuestro pastel más popular, hecho con //chocolate belga'

 //       ]);

    }

}

Regla de oro: si el namespace de la clase que quieres usar no es el mismo que el namespace de tu archivo, necesitas use. Aquí Seeder está en Illuminate\Database\Seeder (importado) y Pastel está en App\Models (importado).

---

6️⃣ Registrar el Seeder en DatabaseSeeder

Edita database/seeders/DatabaseSeeder.php:

Opción 1: Registrarlo junto con lo que ya tienes

php

<?php

namespace Database\Seeders;

use App\Models\User;
use Illuminate\Database\Console\Seeds\WithoutModelEvents;
use Illuminate\Database\Seeder;

class DatabaseSeeder extends Seeder
{
    use WithoutModelEvents;

    /**
     * Seed the application's database.
     */
    public function run(): void
    {
        // User::factory(10)->create();

        User::factory()->create([
            'name' => 'Test User',
            'email' => 'test@example.com',
        ]);

        // 👇 Registras tu seeder aquí
        $this->call([
            PastelSeeder::class,
        ]);
    }
}

💡 Como DatabaseSeeder y PastelSeeder están en el mismo namespace (Database\Seeders), no necesitas importarlo con use. Solo escríbelo tal cual: PastelSeeder::class.

Opción 2: Si tienes varios seeders

php

$this->call([
    UserSeeder::class,
    PastelSeeder::class,
    ClienteSeeder::class,
]);

El orden importa: se ejecutan en el orden en que los listas. Útil si un seeder depende de otro (por ejemplo, si PastelSeeder necesitara usuarios ya creados).

Esto es lo más común cuando tienes varios seeders.

Ojo: el orden importa si hay relaciones. Por ejemplo, si PastelSeeder depende de usuarios creados por UserSeeder, primero debe ir UserSeeder.

7️⃣ Ejecutar migraciones y seeders

bash

# Luego ejecuta los seeders para llenar con datos falsos

php artisan db:seed

# Si quieres hacer todo de una vez (reinicia desde cero)

php artisan migrate:fresh --seed

php artisan migrate:fresh --seed

---

8️⃣ Probar con Laravel Tinker (¡MANUAL DETALLADO!)

🔹 Abrir Tinker

bash

php artisan tinker

🔹 Ver todos los pasteles creados

php

>>> use App\Models\Pastel;

>>> $pasteles = Pastel::all()

>>> $pasteles->count()

=> 31 // 30 del factory + 1 creado manualmente

// 4. Salir de Tinker

>>> exit

---

9️⃣ Creación del controlador

bash

php artisan make:controller PastelController

---

Temporalmente en tu controlador:

php

<?php

namespace App\Http\Controllers;

use App\Models\Pastel;

use Illuminate\Http\Request;

class PastelController extends Controller

{

public function index()

{

    $pasteles = Pastel::all();

    

    // Verificar que los datos existen antes de pasar a la vista

    dd($pasteles); // Esto mostrará los datos y se detendrá

    

    return view('pasteles.index', compact('pasteles'));

}}

Y creas resources/views/pasteles/index.blade.php:

use App\Http\Controllers\PastelController; 

Route::get('/pasteles', [PastelController::class, 'index'])->name('pasteles.index');

Definición de rutas

Edita routes/web.php:

php

<?php

use Illuminate\Support\Facades\Route;
use App\Http\Controllers\PastelController;   // ← ¡IMPORTANTE! Sin esto: Class not found

Route::get('/pasteles', [PastelController::class, 'index'])->name('pasteles.index');

🧠 Namespaces en rutas: routes/web.php no tiene namespace (está en el namespace global \). Por eso PHP no encuentra PastelController a menos que lo importes con use, o uses el FQCN: \App\Http\Controllers\PastelController::class.

Regla: archivo sin namespace → siempre necesitas use para clases de otros namespaces.

Verifica:

bash

php artisan route:list

1. dd() — Dump and Die (muestra y detiene)

blade

{{-- Opción A: sintaxis Blade --}}

<pre>

@dd($pasteles)

</pre>

{{-- Opción B: sintaxis PHP directa --}}

<?php dd($pasteles); ?>

⚠️ Nota: dd() detiene la ejecución, así que todo lo que pongas después no se verá. Es para verificar y salir. 

2. dump() — Muestra pero NO detiene ⭐ (la mejor para vistas)

blade

{{-- Opción A: directiva Blade --}}

@dump($pasteles)

{{-- Opción B: PHP directo --}}

<?php dump($pasteles); ?>

Recomendación

Para tu archivo views/pasteles/debug.blade.php:

• Si quieres ver y detenerte → @dd($pasteles)

• Si quieres ver y seguir → @dump($pasteles) ← la más cómoda

• Si quieres el estilo clásico PHP → <?php var_dump($pasteles->toArray()); ?>

🧠 Este es EL error más común que describes:

Sin use App\Models\Pastel;, cuando escribes Pastel::all() PHP busca la clase en App\Http\Controllers\Pastel (el namespace actual) y lanza:

text

Class "App\Http\Controllers\Pastel" not found

Solución: añadir el use arriba. No es include ni require, es importar el namespace.

🔟 Creación de vistas

Crea manualmente en resources/views/:

• index.blade.php - Listar pasteles

• create.blade.php - Formulario de creación

• edit.blade.php - Formulario de edición

• show.blade.php - Ver detalle

---

Verificar rutas:

bash

php artisan route:list

---

⚡ Bonus: Solución de problemas comunes

❌ "Class 'App\Models\Pastel' not found"

Solución: Reinicia Tinker con php artisan tinker después de crear el modelo.

❌ "No such file or directory"

Solución: Verifica que la base de datos esté creada y corriendo.

❌ Error de conexión en Tinker

Solución: Verifica tu archivo .env y ejecuta:

bash

php artisan config:clear

❌ Los seeders no crean registros

Solución: Ejecuta en orden:

bash

php artisan migrate:fresh

php artisan db:seed

---

Debug en vistas

blade

{{-- Muestra y DETIENE --}}
@dd($pasteles)

{{-- Muestra y SIGUE (la más cómoda en vistas) --}}
@dump($pasteles)

{{-- PHP clásico --}}
<?php dump($pasteles); ?>

🚀 Resumen de comandos esenciales

bash

# Crear todo desde cero

php artisan migrate:fresh --seed

# Abrir Tinker para probar

php artisan tinker

# Verificar datos creados

DB::table('pasteles')->get()

# Salir de Tinker

exit

# Listar rutas

php artisan route:list

# Limpiar caché si hay problemas

php artisan optimize:clear

---

 API sencilla al CRUD de Pasteles

API sin autenticación, lista para integrarse después del controlador web.

---

1️⃣1️⃣ Preparar Laravel para API

En Laravel 11/12 el archivo routes/api.php ya no viene por defecto. Hay que generarlo con:

bash

php artisan install:api

Esto hace tres cosas:

• Crea el archivo routes/api.php

• Instala Laravel Sanctum (lo usaremos después si quieres añadir autenticación)

• Registra el grupo de middleware api en bootstrap/app.php

💡 Si te pregunta si deseas ejecutar las migraciones de Sanctum, puedes responder No por ahora, ya que no usaremos autenticación.

Verifica que ahora exista:

bash

ls routes/

# api.php  console.php  web.php

---

1️⃣2️⃣ Creación del controlador API

Igual que hicimos con el controlador web, ahora creamos uno dedicado a la API:

bash

php artisan make:controller PastelApiController

Edita app/Http/Controllers/PastelApiController.php:

php

<?php

namespace App\Http\Controllers;

use App\Models\Pastel;

use Illuminate\Http\Request;

class PastelApiController extends Controller

{

    /**

     * GET /api/pasteles

     * Lista todos los pasteles (Formato JSON)

     */

    public function index()

    {

        $pasteles = Pastel::all();

        return response()->json([

            'success' => true,

            'data'    => $pasteles,

            'message' => 'Lista de pasteles obtenida exitosamente'

        ], 200);

    }

    /**

     * GET /api/pasteles/{id}

     * Muestra un pastel específico

     */

    public function show($id)

    {

        $pastel = Pastel::find($id);

        if (!$pastel) {

            return response()->json([

                'success' => false,

                'message' => 'Pastel no encontrado'

            ], 404);

        }

}

⚠️ Observa que no usamos Pastel $pastel con Route Model Binding, porque si el pastel no existe Laravel devuelve un 404 HTML en lugar de JSON. Usando find($id) controlamos la respuesta.

---

1️⃣3️⃣ Definición de rutas API

Edita routes/api.php:

php

<?php

use Illuminate\Support\Facades\Route;

use App\Http\Controllers\PastelApiController;

/*

|--------------------------------------------------------------------------

| Rutas API - Pasteles

|--------------------------------------------------------------------------

| Prefijo automático: /api

| Sin autenticación (por ahora)

*/

Route::get('/pasteles',        [PastelApiController::class, 'index']);   // GET    /api/pasteles

Route::get('/pasteles/{id}',   [PastelApiController::class, 'show']);    // GET    /api/pasteles/{id}

Route::post('/pasteles',       [PastelApiController::class, 'store']);   // POST   /api/pasteles

Route::put('/pasteles/{id}',   [PastelApiController::class, 'update']);  // PUT    /api/pasteles/{id}

Route::delete('/pasteles/{id}',[PastelApiController::class, 'destroy']); // DELETE /api/pasteles/{id}

Verifica que las rutas estén registradas:

bash

php artisan route:list

Deberías ver algo como:

text

GET|HEAD   api/pasteles ............... PastelApiController@index

POST       api/pasteles ............... PastelApiController@store

GET|HEAD   api/pasteles/{id} .......... PastelApiController@show

PUT        api/pasteles/{id} .......... PastelApiController@update

DELETE     api/pasteles/{id} .......... PastelApiController@destroy

---

1️⃣4️⃣ Probar la API con cURL

Primero levanta el servidor:

bash

php artisan serve

🔹 Obtener todos los pasteles

bash

curl http://localhost:8000/api/pasteles