Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. PHP

Desarrolla aplicaciones web desde cero con Laravel - Eloquent ORM

by
Difficulty:IntermediateLength:LongLanguages:

Spanish (Español) translation by Steven (you can also view the original English article)

En esta miniserie de Tuts+, construiremos una aplicación web desde cero, mientras nos sumergimos en un nuevo framework de PHP que está cogiendo rápidamente vapor, llamado Laravel.

En esta lección, trabajaremos en una parte integral de cualquier aplicación web: los modelos. En el camino, aprenderemos sobre la increíble implementación de ORM de Laravel: Eloquent.


Revisión

¡Bienvenido de nuevo a nuestra serie de aplicaciones web desde cero con Laravel! En el primer tutorial de la serie, aprendimos mucho sobre Laravel y su filosofía:

  • Qué es Laravel
  • Lo que diferencia a Laravel de otros frameworks PHP
  • Dónde descargar Laravel
  • Cómo configurar Laravel
  • Cómo funciona el sistema de rutas de Laravel
  • Algunas otras características del sistema de rutas de Laravel
  • Cómo crear tu primer controlador en Laravel
  • Algunas características adicionales con los controladores de Laravel
  • Cómo crear tu primera Vista en Laravel
  • Cómo utilizar el motor de plantillas blade de Laravel

Si aún no lo has leído, deberías echar un vistazo al tutorial anterior y darle una lectura - esto hará que sea más fácil entender la filosofía detrás de Laravel y la mayor parte de lo que hablaremos en este tutorial.

En esta segunda parte de la serie Laravel, crearemos una parte crucial de nuestra aplicación web de prueba, Instapics, que es la implementación del modelo. ¡Sin más preámbulos, empecemos!


¿Qué son los "Modelos"?

Ya he hablado un poco sobre lo que son los modelos en uno de mis artículos anteriores, Zend Framework desde cero - Modelos e Integrando Doctrine ORM, así que para evitar repetirlo, escribiré la esencia de lo que escribí antes aquí. Siéntete libre de referirte al otro tutorial y leer más acerca de qué modelos están allí.

Resumen:

  • Los modelos son representaciones de la base de datos y deben estar donde reside toda la lógica de la empresa de una aplicación
  • Los controladores se comunican con los Modelos y les piden que obtengan la información que necesitan
  • Después, un controlador pasa esta información a la vista y se muestra
  • Es muy raro que un modelo interactúe directamente con una vista, pero a veces puede suceder cuando es necesario
  • Los modelos pueden hablar con otros modelos y no son autónomos. Tienen relaciones que se entrelazan entre sí
  • Estas relaciones hacen que sea más fácil y rápido para un Controlador obtener información, ya que no tiene que interactuar con diferentes Modelos - los Modelos pueden hacerlo entre ellos

Los modelos en Laravel, o en la mayoría de los frameworks, se desarrollan de la misma manera. La diferencia es que Laravel nos da una manera fácil de construir estos modelos, proporcionándonos métodos de uso general que la mayoría de los modelos necesitarían - el Eloquent de ORM.


El Eloquent de ORM

Un ORM es un mapeador relacional de objetos, ¡y Laravel tiene uno que te encantará! Se denomina "Eloquent", porque te permite trabajar con tus objetos de base de datos y las relaciones mediante una sintaxis elocuente y expresiva.

Eloquent ORM es la implementación ORM integrada de Laravel. En mi opinión, es una de las mejores implementaciones de ORM que he visto hasta ahora- rivalizando incluso con Doctrine ORM. Es increíblemente elegante, haciendo uso de las convenciones estándar de la industria para disminuir la configuración.

Convenciones

Por ejemplo, el uso de un modelo elocuente supone que la tabla que representa el modelo tiene un campo id. El id es la clave primaria para cualquier registro y lo utilizan la mayoría de los métodos de Eloquent.

Otra cosa que Eloquent asume correctamente es que el nombre de la tabla es la forma plural del modelo. Por ejemplo, el modelo User hará referencia a la tabla users. Como esto podría no ser siempre el estándar para algunos, Laravel proporciona una manera de invalidar esto: simplemente utiliza el indicador $table:

Esto indicará a Laravel que no use la convención y, en su lugar, use una tabla especificada.

Por último, Laravel también puede automatizar la creación y actualización de las marcas de tiempo para nosotros. Para ello, agrega una columna created_at y/o updated_at en la tabla y establece la marca $timestamp en el modelo:

Eloquent verá la marca y establecerá automáticamente el campo created_at en la creación y actualizará el campo updated_at cada vez que se actualice un registro. Bastante bueno, ¿no?

Recuperación rápida

Recuperar registros es muy fácil con los métodos de recuperación de Eloquent. Por ejemplo, ¿necesitas encontrar un registro de usuario específico? Sólo haz:

¡Esto devuelve un modelo User en el que puedes realizar operaciones! ¿Necesitas usar condicionales? Imaginemos que deseas obtener un usuario por su dirección de correo electrónico. Para llevar a cabo esta tarea, puedes hacer algo como:

Alternativamente, podrías utilizar los métodos dinámicos de Laravel:

Inserciones fáciles & Actualizaciones

La inserción y actualización de modelos mediante Eloquent se puede realizar en tres pasos.

  • Paso 1 - Obtener/Crear el modelo.

  • Paso 2 - Establecer los datos

  • Paso 3 - Guardar

  • ¡Listo!

Y finalmente, definir relaciones.

Eloquent hace que el proceso de definición de relaciones y recuperación de modelos relacionados sea simple e intuitivo.

¡Maldita sea! Eloquent admite tres tipos de relaciones:

  1. Uno a uno
  2. Uno a muchos
  3. Muchos a muchos

Para definir una relación entre modelos, deberás crear un método en ambos modelos que "describa" sus relaciones. Por ejemplo, supongamos que User has_one User_Profile. Puedes hacerlo definiendo un método user_profile en el modelo User:

Dado que User es nuestro modelo "dominante" aquí (es decir, un usuario tiene un perfil, y no un perfil tiene un usuario), definimos que User_Profile belongs_to (pertenece a un usuario) User:

Una vez que hayamos definido estas relaciones, entonces podemos hacer lo siguiente:

Una cosa que vale la pena señalar aquí es otra convención: Eloquent asume que la clave externa utilizada en User_Profile es el nombre +_id de la tabla a la que se hace referencia. Una vez más, si deseas cambiar este comportamiento, puedes anularlo:

Supongamos que queremos definir la relación entre User y Photo (sus fotos subidas). Esta es una relación de uno a muchos One-to-Many, a diferencia de la relación User Profile a User que era uno a uno One-to-One. Sabemos que User has_many Photo, por lo cual:

La principal diferencia aquí con has_one es que la función que usaremos para recuperar las fotos de un usuario ahora devolverá una matriz de objetos del modelo Photo. Por lo tanto, si quisiéramos traer todas las fotos de un usuario, podríamos hacer lo siguiente:

No, referirse a photos como una propiedad no es un error tipográfico. Laravel nos da ese sabor dulce. También podríamos hacer:

Relaciones de muchos a muchos - Mant-to-Many

Este es un poco complicado, pero una vez implementado, hace que sea fácil manejar las relaciones de muchos a muchos entre los modelos. Imaginemos, por ejemplo, que, de nuevo, tienes un modelo User y cada uno de estos usuarios puede tener varios grupos y para eso usamos el modelo Group. Un grupo también puede tener varios usuarios. Usaremos tres tablas para representar estas relaciones particulares:

  • Users - tabla donde están todos nuestros usuarios
  • Groups - tabla donde están todos nuestros grupos
  • Group User - tabla que enumera todos los usuarios de un grupo

La convención de estructura de tabla que Eloquent buscará será algo como esto:

  • users
    • id
    • ... otras columnas
  • groups
    • id
    • ... otras columnas
  • group_user
    • id
    • user_id
    • group_id
    • ... otras columnas

Otra convención a tener en cuenta aquí es que la tabla intermedia, group_user, son los nombres singulares de las dos tablas que estás conectando, organizados alfabéticamente con un carácter de subrayado. Como siempre, somos libres de anular esto.

Así es como se verá el código dentro de cada uno de los modelos para estas tres tablas:

Con esto en su lugar, podemos aprovechar las funciones de relación de Eloquent:


Paso 1 - Creación de la base de datos Instapics

Instapics

Continuando con nuestra aplicación web, Instapics, comencemos creando la base de datos de nuestra aplicación. Para ello, vamos a anotar las funcionalidades deseadas de la aplicación:

  • Los usuarios pueden iniciar sesión y registrarse para obtener una cuenta
  • Los usuarios pueden seguir a otros usuarios para ver las fotos que han subido
  • Los usuarios pueden subir su propia foto y aplicar un filtro a ella
  • Los usuarios pueden comentar y darle me gusta a otras fotos

Para esto, podemos deducir las tablas de base de datos que necesitaremos:

  • users

    • id (uno a uno con user_profiles.user_id, muchos a muchos usando la misma tabla relationships.follower_id y followed_id, uno a muchos con photos.user_id y photo_comments.user_id)
    • email
    • password
    • created_at
    • updated_at
  • user_profiles

    • id
    • user_id (uno a uno con users.id)
    • name
    • profile_photo
  • relationships

    • id
    • follower_id (uno a uno con users.id)
    • followed_id (uno a uno con users.id)
    • created_at
    • updated_at
  • photos

    • id (uno a muchos con photo_comments.user_id)
    • user_id (uno a uno con users.id)
    • location
    • description
    • created_at
    • updated_at
  • photo_comments

    • id
    • user_id (uno a uno con users.id)
    • photo_id (uno a uno con photos.id)
    • message
    • created_at
    • updated_at

Vamos a continuar y vamos crear estas tablas. Para este proyecto, usaré MySQL; no dudes en copiar y pegar estos comandos.

Alternativamente, podrías usar las migraciones, pero las revisaremos en una lección futura.


Paso 2 - Configurar la base de datos de Laravel

Antes de hacer nada con los modelos Laravel, necesitamos configurar la base de datos de nuestra instalación de Laravel. Abre application/config/database.php, para encontrar algunos de estos ajustes:

  • profile - establecer esto en true registrará todas las horas de las consultas en SQL en los registros de Laravel. Deja esto como true por ahora.
  • fetch - el tipo de datos devueltos de PDO. El valor predeterminado es PDO::FETCH_CLASS y debe dejarse así.
  • default - este es el nombre de la configuración de conexión utilizada por la aplicación. El nombre hace referencia al índice de la matriz $connections justo debajo
  • connections: una matriz asociativa de las posibles conexiones para la aplicación.

    • driver: el tipo de servidor de base de datos. Puede ser pgsql, sqlite, mysql o sqlsrv
    • host - el nombre de host del servidor de tu base de datos
    • database - el nombre de la base de datos
    • username - nombre de usuario para usar en el servidor de la base de datos
    • password - contraseña para usar en el servidor de la base de datos
    • charset - El tipo de charset para usar en el servidor de la base de datos
    • prefix - prefijo de tabla en la base de datos, si hay
  • redis: si planeas utilizar la biblioteca Redis de Laravel, puedes configurar la información del servidor aquí.

Para los fines de este tutorial, usaremos MySQL. Tu archivo database.php debería tener un aspecto similar al siguiente (eliminé los comentarios, pero deberías dejarlos):


Paso 3 - Creación de tu primer modelo en laravel

Comienza creando un modelo de Laravel dentro de la carpeta application/models. Crea user.php dentro y añade el siguiente código:

Ahora, sobre la base de nuestra revisión de cuáles son las relaciones de User, necesitamos codificar los métodos de las relaciones para todas ellas:

Notablemente, hacemos uso de algunas funciones avanzadas de muchos a muchos aquí, debido a la estructura de la tabla de nuestro modelo 'follower' (es decir, la tabla users hace referencia a la tabla relationships, la cual hace referencia a la tabla users de nuevo). La función has_many_and_belongs_to tiene la siguiente firma de método:

Esto realmente nos permite crear un modelo que tiene una relación de muchos a muchos con sí mismo (es decir, los usuarios siguen a otros usuarios). Utilizamos followers y following como los nombres de los métodos en el modelo User para permitirnos obtener seguidores de un usuario u obtener todos los usuarios que un solo usuario está siguiendo, respectivamente.

Siguiendo el ejemplo del modelo User, crea los otros modelos. Cuando termines, debes tener:

  • application/models/photo.php
  • application/models/photo_comment.php
  • application/models/relationship.php
  • application/models/user.php
  • application/models/user_profile.php

Estos archivos estarán en el repositorio Git del tutorial, por lo que si prefieres descargarlos, puedes encontrarlos aquí: https://github.com/nikkobautista/laravel-tutorial


Paso 4 - Crear las funciones del usuario para Instapics

Comencemos a usar nuestros modelos creando algunas de las funciones de usuario que necesitaremos en la aplicación. En primer lugar: registro de usuarios. Desde el tutorial anterior, ya hemos creado un formulario de registro/inicio de sesión en la página de inicio. En este momento, esto no está haciendo nada, pero vamos a conectarlo a un controlador de User, para que se pueda autenticar mediante la acción authenticate. Crea un archivo en application/controllers/user.php con el siguiente código:

Abre application/views/home/index.blade.php y busca el formulario de inicio de sesión. Actualiza el formulario de la línea 18 para enviarlo al método action_authenticate():

Volviendo al controlador User_Controller, agreguemos un poco de código en action_authenticate():

Vamos a desglosar lo que hemos hecho aquí hasta ahora:

  • Usamos la librería Input para obtener los datos del formulario enviado
  • Si se ha marcado el indicador $new_user, creamos un nuevo usuario, utilizando la biblioteca Hash para generar una contraseña cifrada.
  • Inicia sesión en el nuevo usuario con la librería Auth
  • Si el indicador $new_user estaba desmarcado, creamos una matriz $credentials y la usamos con la librería Auth.
  • Si Auth::attempt es verdadero, significa que las credenciales eran correctas y hemos iniciado sesión
  • De lo contrario, significa que las credenciales estaban equivocadas.
  • En ambos escenarios, redirigimos al controlador Dashboard, a la acción index cuando se realice correctamente. Y mostraremos un mensaje de error en caso contrario.

La librería Input

La función básica de la librería Input es habilitar la obtención de los datos del formulario. Por ejemplo, en el controlador del usuario, usamos Input::get('email'); para obtener el valor del correo electrónico del formulario. Es importante tener en cuenta que el método get se utiliza para todos los tipos de solicitudes y no solo para la matriz $_GET.

Puedes leer más sobre la librería Input aquí: http://laravel.com/docs/input#input

La librería Auth

Laravel viene con su propio mecanismo de autenticación, la biblioteca Auth. Puede hacer las siguientes características con respecto a la autenticación de usuario.

Crea una contraseña encriptada

Podemos hacer uso de la librería Hash de la siguiente manera:

Este método crea una contraseña encriptada y segura para un usuario, utilizando la clave de cifrado que establecemos en el archivo de configuración. Para comprobar si un hash es correcto, puedes utilizar:

Iniciar sesión en un usuario

Para ello, usamos el método attempt de la librería Auth. Antes de eso, sin embargo, construimos una matriz $credentials, que es una matriz asociativa con los índices username y password:

Es importante tener en cuenta que una vez que un intento es "exitoso", el usuario inicia sesión automáticamente.

Hacer que un usuario inicie/cierre sesión

A veces, tendremos que iniciar sesión en un usuario sin usar el método attempt (por ejemplo, al iniciar sesión en un usuario desde un enlace dentro de un correo electrónico o después del registro). Podemos hacerlo con el método Auth::login:

Por otro lado, también tenemos un método Auth::logout para cerrar la sesión de los usuarios:

Esto terminará la sesión del usuario.

Recuperar los datos del usuario que ha iniciado sesión

El método Auth::user nos permite recuperar el objeto de usuario que ha iniciado sesión, así como cualquier información adjunta a él:

Configuración de la librería Auth

La librería Auth debe configurarse antes de usarla (aunque los valores predeterminados funcionarán con la mayoría de los proyectos, como este). Las variables de configuración son:

  • driver - esto puede ser Eloquent o Fluent. Los desarrolladores pueden escribir sus propios controladores extendiendo la clase Driver en laravel/auth/drivers.
  • username: este es el nombre de la columna de lo que representa el "nombre de usuario" de tu usuario en la tabla de la base de datos.
  • model - cuando se utiliza Eloquent, esta es la clase de modelo que utiliza la librería Auth
  • table - cuando se utiliza el controlador de autenticación Fluent, se determina la tabla de base de datos para los usuarios de la aplicación

Nuestro proyecto, Instapics, utiliza los valores predeterminados en el archivo de configuración auth.php, por lo que no necesitamos cambiar nada en él.

Volviendo al proyecto, ¡prueba las características de inicio de sesión/registro de Instapics! Bastante ingenioso, ¿no? Sin embargo, notarás que aún no tenemos nada en el controlador Dashboard, así que vamos a trabajar en él a continuación.


Paso 5 - Crear el panel de Instapics

Lo primero que tenemos que hacer es crear el controlador Dashboard, con la acción index. Crea el archivo application/controllers/dashboard.php y coloca el siguiente código:

Ahora necesitamos crear la página index.blade.php del panel. Crea application/views/dashboard/index.blade.php y añade lo siguiente:

Actualiza la página del panel, deberías ver esto:

Instapics Dashboard

¿Luce un poco vacío? Agrega esto al controlador Dashboard y ejecútalo accediendo a dashboard/insert_test_data en tu navegador:

Cuando actualices la página, verás cómo se ve con los datos de ejemplo insertados:

Instapics Dashboard w Sample Data

Conclusión

En la segunda parte de nuestra serie Laravel, aprendimos:

  • Algunos antecedentes sobre lo que son los "Modelos"
  • Qué es el Eloquent ORM
  • Cómo configurar la base de datos de Laravel
  • Cómo crear tu primer Modelo en Laravel
  • Las funciones básicas de las librerías Auth y Input
  • Hacer uso de Eloquent ORM en una vista

Eloquent realmente es una implementación ORM impresionante - es rápido y tiene un montón de características que hacen que las interacciones con la base de datos en cualquier aplicación sean tan simple como sea posible.

A continuación, en nuestra serie Aplicaciones web desde cero con Laravel, aprenderemos más sobre el uso de los filtros de Laravel, la librería Validation de Laravel, ¡y cómo trabajar con archivos en Laravel!

¿Qué opinas de Eloquent ORM de Laravel? ¿Es algo que te parece útil? ¡Avísame en los comentarios! Y, si eres miembro de Tuts+ Premium, ¡mantente atento a nuestro próximo curso de Laravel Essentials!

Advertisement
Advertisement
Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.