Comparte en Facebook Twitter Google+

laravel-eloquent-orm

Eloquent es el ORM que incluye Laravel para manejar de una forma fácil y sencilla los procesos correspondientes al manejo de bases de datos en nuestro proyecto, gracias a las funciones que provee podremos realizar complejas consultas y peticiones de base de datos sin escribir una sola línea de código SQL.

Configurar Base de datos

El primer paso a iniciar es crear una base de datos, en caso de que aun no lo hayas hecho puedes seguir las siguientes líneas desde la consola de comando

Una vez creada se deben configurar los datos de conexión en el archivo config/database.php, yo prefiero configurar esta información “delicada” en el archivo .env de la aplicación

Crear un nuevo modelo de Eloquent

Gracias a los comandos de artisan podemos crear los modelos desde la consola

Por lo general el nombre del modelo debe escribirse con la primera letra mayúscula y en singular, laravel hará el resto por nosotros. Con el comando anterior se habrán creado dos archivos nuevos, uno llamado “Movie.php” dentro de la carpeta /app , el cual es el modelo y otro llamado create_movies_table_000000.php dentro de database/migrations que es la migración para dicha tabla.

Para mas información sobre migraciones visita el post  Creando Migraciones en Laravel 5

Creando la migración

Vamos a definir los campos “name” y “description” en el archivo de migración creado anteriormente (create_movies_table.php).

Atributos protected, fillable y guarded

Laravel permite asignar valores a cada uno de los atributos de la tabla de una manera muy sencilla con un array asociativo de elementos (que pueden ser los campos de un formulario), de esta forma se facilita el proceso de almacenaje desde un form. Sin embargo esto puede originar un problema de seguridad, ya que en ocasiones hay campos que no deberían enviarse a los formularios y tienen que permanecer protegidos a la vista de los usuarios finales.

Por defecto, todos los campos se tratan como protegidos y se debe indicar cuales pueden ser llenados de esta forma.

Dentro de este array se pueden especificar cuáles de los campos de la tabla pueden ser llenados con asignación masiva (que es el caso cuando enviamos un formulario creando un array asociativo para ser guardado).

Esta propiedad indica que los campos definidos allí no pueden ser llenados usando Mass Assignment, por lo cual nunca debería enviarse un Input::get() o cualquier otro tipo de datos o arreglo proveniente de un controlador manipulable por un usuario.

Configuración del modelo

Configurando rutas de acceso

Guardar un nuevo modelo con Eloquent

Cuando creamos un registro, instanciamos el modelo, asociamos los valores correspondientes a cada campo y procedemos a guardar, con Eloquent podemos hacer esto de dos formas diferentes.

Primero iniciemos creando un controlador para el recurso movie, llamado MovieController

En la cabecera de este nuevo archivo importamos el modelo Movie con

La función store() será quien reciba por post la petición de guardado del nuevo registro, en este caso nos apoyaremos en la clase Illuminate\Http\Request para manejar las peticiones.

De esta forma, instanciamos el modelo Movie, y asignamos uno a uno los valores a cada campo de la tabla, y luego guardamos usando el método save(). Hasta ahora todo bien, pero podemos hacer esto usando menos código de la siguiente manera.

En este caso hacemos uso del método Create() y ya que en el formulario se han definido los campos usando los mismos nombres de la tabla movies, no habrá ningún problema al enviar el request como array asociativo y guardar el nuevo registro.

Para ver esto en funcionamiento debemos crear primero el formulario, creamos un archivo llamado new.blade.php

Te recomiendo el tutorial sobre Integrando los componentes Html y Form a Laravel

Editamos la funcion create dentro de MovieController para acceder a la vista de este formulario

Y por ultimo la lista a la que nos redirige el controlador luego de guardar el registro llamada list.blade.php

Esta vista se muestra en el index del controlador

Si ingresamos a http:://rutadetuproyecto/movie veremos algo similar a esto

movie-list

 

para crear un nuevo registro hacemos click en Create y vamos al formulario

movie-form

Actualizando registros con Eloquent

Creamos un nuevo formulario de actualización con algunos cambios llamado update.blade.php

Para este formulario hemos cambiado el método a put y la ruta apunta a movie.update.

La función edit debe quedar de la siguiente manera

Esta función recibe como parámetro el id del registro a modificar, usando Eloquent buscamos el registro y lo pasamos al formulario para cargar los datos en pantalla.

Ahora podemos hacer click sobre el boton Edit de cualquier registro de la lista y veremos el siguiente formulario.

movie-edit-form

Para almacenar estos cambios debemos editar la función update de nuestro controlador.

Se busca el registro usando el método find() pasando como parámetro el id definido en el campo hidden del formulario, luego asignamos cada uno de los valores al modelo y por ultimo usamos nuevamente el método Save() para almacenar los cambios.

Querys básicos con Eloquent

En la lista de registro creamos un formulario de búsqueda, con el vamos a buscar las películas (movies) por el nombre usando el operador Like de Sql. Gracias a Eloquent no es necesario escribir toda una linea de Sql para crear la búsqueda, veamos como se usa.

Creamos una nueva función dentro de MovieController.php llamada search()

el método where(), recibe como parámetros, el nombre de la columna en la base de datos a comparar, el operador y por ultimo el valor que deseamos buscar, por lo cual podemos hacer otros tipos de búsquedas como

Cuando usamos varios ->where() Eloquent los agrupa usando el operador AND de sql, si queremos trabajar con OR debemos usar ->orWhere()

Eliminando Registros con Eloquent

Para eliminar registros se hace uso del método delete() sobre un registro, editamos la función destroy() en el archivo MovieController.php

Nuevamente encontramos el registro usando find(), y lo eliminamos con delete()

Esto ha sido todo sobre el uso básico de Eloquent, veamos un resumen de lo aprendido.

  • Crear modelos  con php artisan make:model.
  • Uso de los atributos fillable, public, guarded.
  • Repaso sobre creación de migraciones.
  • Crear nuevos registros en la base de datos.
  • Buscar registros con Eloquent y el método find().
  • Modificar Registros existentes.
  • Realizar búsquedas (Query) con Eloquent.
  • Uso de operadores con Eloquent.
  • Eliminar registros con Eloquent.

Otros tutoriales recomendados

Regístrate hoy en Styde y continua mejorando tus habilidades: ver planes.

Lección anterior Aprende cómo validar datos con Laravel Lección siguiente Uso de los View Composer en Laravel 5