🛢️ Modelo

Modelos

Los modelos son las clases que forman la capa empresarial en su aplicación. Deben ser responsables de administrar casi todo lo relacionado con sus datos, su validez y sus interacciones.

Generalmente, las clases modelo representan datos y se usan en las aplicaciones de Ligne para el acceso a datos. Pueden usarse para acceder a cualquier cosa que manipule datos, como archivos, servicios web externos.

Como funcionan los modelos

Un modelo representa su modelo de datos. En la programación orientada a objetos, un modelo de datos es un objeto que representa una cosa como una persona o una casa.

Un blog, por ejemplo, puede tener muchas publicaciones y cada publicación del blog puede tener muchos comentarios. El Blog, Publicación y Comentario son todos ejemplos de modelos, cada uno asociado con otro.

Aquí hay un ejemplo simple de una definición de modelo en Ligne:

<?php

namespace App\models\Tasks;

use System\Model;

class Tasks extends Model
{
  public function index()
  {
      //code...
  }
}
    

Para poder trabajar con el modelo Tasks, se crea el archivo PHP en el directorio src/models/Tasks/. Por convención, debería tener el mismo nombre que la clase, para este ejemplo será Tasks.php

Esta clase debe contener un namespace ya que este se utiliza para incluir el modelo en donde sea necesario su uso. El namespace no es más que el directorio con barras invertidas donde está el modelo, por ejemplo, en nuestro caso el modelo está en el directorio src/models/Tasks/

Recuperar datos Pdox

El generador de consultas Pdox proporciona una interfaz fluida fácil de usar para crear y ejecutar consultas. Al componer las consultas juntas, puede crear consultas avanzadas utilizando uniones y subconsultas con facilidad.

Debajo de las capas, el generador de consultas utiliza declaraciones preparadas con PDO que protegen contra ataques de inyección SQL

Ejemplo de selección un único registro

Podemos obtener un registro con el método get() veamos un ejemplo de consulta por un criterio en concreto;

public function showTask($id)
 {
    $req = $this->db()->table('tasks')
        ->select('id, title, description, created_at,updated_at,success')
        ->where('id','=',$id)
        ->get();
    return $req;
 }
    

La sintaxis es sumamente sencilla, tenemos un método db() el cual nos proporciona una conexión nueva a la base de datos, luego de esto es aquí donde entra la magia de Pdox (Query Builder) el mismo nos proporciona una serie de métodos que nos facilitaran la vida.

La salida de esta consulta seria;

array (size=6)
    'id' => string '17' (length=2)
    'title' => string 'New task' (length=8)
    'description' => string 'yes!' (length=4)
    'created_at' => string '2018-10-10 22:54:30' (length=19)
    'updated_at' => string '2018-10-12 15:05:25' (length=19)
    'success' => string '0' (length=1)
    

GetAll()

Así como realizamos consultas de registros individuales, podemos hacer consultas de un conglomerado de registros con el método getAll(). En este caso obtendremos todas las tareas que su valor success sea igual a 0 y ordenaremos estos registros por created_at de manera descendente;

public function showAllTasks()
 {
    $req = $this->db()->table('tasks')
        ->select('id, title, description, created_at,updated_at,success')
        ->where('success','=',0)
        ->orderBy('created_at', 'desc')
        ->getAll();
    return $req;
 }
    

Método	Descripción
table()	Nombre de la tabla (‘tasks’)
select()	Campos que queremos obtener (‘campo1, campo2, campo3,….’)
where()	Criterio (‘campo’,’operador’,’valor’)
orderBy()	Ordena los datos (‘campo’,’orden’)
getAll();	Obtener todos los resultados

Salida;

array (size=2)
 0 =>
    array (size=6)
            'id' => string '17' (length=2)
            'title' => string 'New task' (length=8)
            'description' => string 'yes!' (length=4)
            'created_at' => string '2018-10-10 22:54:30' (length=19)
            'updated_at' => string '2018-10-12 15:05:25' (length=19)
            'success' => string '0' (length=1)
 1 =>
    array (size=6)
            'id' => string '15' (length=2)
            'title' => string 'new config' (length=13)
            'description' => string 'a new config, yeah!' (length=22)
            'created_at' => string '2018-10-10 20:32:37' (length=19)
            'updated_at' => string '2018-10-10 20:32:37' (length=19)
            'success' => string '0' (length=1)
    

Insertando datos

A diferencia de los ejemplos anteriores, no debe utilizar get() ni getAll() para crear consultas de inserción. En lugar de esto creamos un arreglo asociativo el cual puede ser como el ejemplo a continuación;

 $data = [
    'title' => $title,
    'description' => $description,
    'created_at' => date('Y-m-d H:i:s')
 ];
    

Este arreglo es pasado al método insert() de la siguiente manera;

 $data = [
    'title' => $title,
    'description' => $description,
    'created_at' => date('Y-m-d H:i:s')
 ];

 $this->db()->table('tasks')->insert($data);
    

Puedes obtener el id insertado con una simple línea luego de realizada la inserción de datos;

 $data = [
    'title' => $title,
    'description' => $description,
    'created_at' => date('Y-m-d H:i:s')
 ];

 $this->db()->table('tasks')->insert($data);

 //Obteniendo el id insertado
 $last_insert_id = $this->db()->insertId();
    

Actualizando registros

Como vimos en el ejemplo se inserción de datos en el caso de actualizar tampoco usaremos los métodos get() y getAll() en lugar de esto usaremos update();

Crearemos un arreglo asociativo como en el ejemplo anterior, esta vez solo con los datos que se actualizarán, no es necesario enviar todos los campos;

 $data = [
    'title' => $title,
    'description' => $description,
    'updated_at' => date('Y-m-d H:i:s')
 ];

 $this->db()->table('tasks')->where('id','=', $id)->update($data);
    

En este caso como actualizaremos un registro por su id debemos usar el método where() seguido del método update(), a este ultimo le pasamos nuestro arreglo.

Eliminar registros

Es mas sencillo eliminar registros ya que en esta ocasión no necesitamos crear ningún arreglo, esto es tan sencillo como especificar con el método where() los criterios;

$this->db()->table('tasks')->where('id','=', $id)->delete();
    

Consultas método Query

También puedes realizar consultas SQL utilizando el método query()

 //Select todos por criterio
 $this->db()->query('SELECT * FROM test WHERE id=? AND status=?', [10, 1])->fetchAll();

 //Selecionar 1 registro
 $this->db()->query('SELECT * FROM test WHERE id=? AND status=?', [10, 1])->fetch();

 //Puedes usar consultas como update, insert, select, etc...
 $this->db()->query('DELETE FROM test WHERE id=?', [10])->exec();
    

Se recomienda utilizar los método del Query Builder en todos los casos ya que tienes una sintaxis más organizada y legible, inclusive escalable.

Resumen

En general es mas sencillo que las consultas anteriores. En esta sección solo veremos consultas simples como las anteriores, para ampliar más puede visitar la documentación del Query Builder Query Builder