Mostrando entradas con la etiqueta table. Mostrar todas las entradas
Mostrando entradas con la etiqueta table. Mostrar todas las entradas

lunes, 14 de julio de 2025

Laravel: vinculación entre un modelo y una tabla de base de datos

 ¿En dónde se define que App\Models\User está vinculado a la tabla users?


En Laravel, la vinculación entre un modelo Eloquent (como App\Models\User) y su tabla correspondiente en la base de datos se maneja principalmente a través de la convención sobre configuración de Eloquent ORM.


La Convención de Eloquent (La forma por defecto)

Por defecto, Eloquent asume que el nombre de la tabla de la base de datos es la versión en plural y en "snake_case" del nombre de la clase del modelo.

  • Ejemplo:

    • Si tu modelo se llama User (singular), Eloquent asumirá que la tabla asociada es users (plural).

    • Si tu modelo se llama ProductCategory (singular, CamelCase), Eloquent asumirá que la tabla es product_categories (plural, snake_case).

Esta es la razón por la que, en una instalación estándar de Laravel, tu modelo App\Models\User se vincula automáticamente a la tabla users sin que tengas que especificarlo explícitamente en el código del modelo.


Definición Explícita (Cuando la Convención no Aplica)

Si el nombre de tu tabla no sigue esta convención (por ejemplo, si tu tabla se llama my_users en lugar de users), puedes especificar el nombre de la tabla manualmente dentro del modelo utilizando la propiedad $table.

  • Ejemplo:

    PHP
    <?php
    
    namespace App\Models;
    
    use Illuminate\Database\Eloquent\Factories\HasFactory;
    use Illuminate\Foundation\Auth\User as Authenticatable;
    use Illuminate\Notifications\Notifiable;
    
    class User extends Authenticatable
    {
        use HasFactory, Notifiable;
    
        /**
         * The table associated with the model.
         *
         * @var string
         */
        protected $table = 'my_users'; // <-- ¡Aquí se define explícitamente!
    
        // ... el resto de tu modelo User
    }
    

En Resumen:

Para el modelo App\Models\User y la tabla users, la vinculación se da por la convención por defecto de Eloquent. No hay una línea de código específica en el modelo User que diga "vincúlame a la tabla users" porque Eloquent lo infiere automáticamente. Solo necesitarías añadir la propiedad $table si el nombre de tu tabla fuera diferente a users.