PIPE es un ORM - Mapeador Objeto Relacional desarrollado en PHP que permite interactuar con el modelo de las tablas en la base de datos accediendo a métodos escritos en español.

PIPE es muy sencillo de instalar.

# Instalación vía composer.

PIPE requiere una versión de PHP >= 7.3.0 para poder ser instalado.

Para instalar PIPE abrimos nuestra terminal, nos ubicamos en el directorio de nuestro proyecto y ejecutamos el siguiente comando.

$ composer require proesio/pipe

También podemos instalar PIPE por medio del archivo composer.json de la siguiente manera.

1. Nos ubicamos en el directorio de nuestro proyecto.

2. Creamos un archivo con el nombre de composer.json y lo editamos de la siguiente manera.

{
  "require": {
    "proesio/pipe": "^5"
    }
}

3. Abrimos nuestra terminal dentro del directorio de nuestro proyecto y escribimos el siguiente comando.

$ composer install

Una vez terminado el proceso, composer creará un directorio llamado vendor en la raíz de nuestro proyecto donde quedará instalado el ORM PIPE.

# Instalación manual.

Para instalar PIPE de forma manual, descargamos la última versión estable desde el repositorio de GitHub.

Una vez descargado tienes toda la libertad de pegar el código fuente del ORM PIPE en cualquier parte de tu proyecto.

Serás tú el que decide el flujo y la estructura de tu aplicación web.

PIPE es muy sencillo de configurar.

Si hemos instalado PIPE por medio de composer, debemos incluir el archivo vendor/autoload.php en nuestro código de programación para poder utilizar el ORM PIPE.

Si por el contrario, hemos instalado PIPE manualmente, debemos incluir el archivo src/PIPE/inicializador.php que se encuentra en la raíz del código fuente descargado.

Para configurar el ORM PIPE, inicializamos la configuración de la siguiente manera.

<?php
  
require_once __DIR__.'/vendor/autoload.php';

use PIPE\Clases\PIPE;
use PIPE\Clases\Configuracion;

Configuracion::inicializar(
    [
        'BD_CONTROLADOR' => 'mysql',
        'BD_HOST' => 'localhost',
        'BD_PUERTO' => '3306',
        'BD_USUARIO' => 'root',
        'BD_CONTRASENA' => 'contrasena',
        'BD_BASEDATOS' => 'pipe',
        'IDIOMA' => 'es',
        'RUTA_MODELOS' => 'ruta/completa/a/mis/modelos',
        'ZONA_HORARIA' => 'America/Bogota',
        'COMANDO_INICIAL' => 'set names utf8mb4 collate utf8mb4_unicode_ci',
        'TIPO_RETORNO' => Configuracion::CLASE,
        'OPCIONES' => [PDO::MYSQL_ATTR_LOCAL_INFILE => 1]
    ]
);

/**
 * Finalmente, verificamos que hemos inicializado la configuración correctamente
 * imprimiendo la versión del ORM PIPE.
 */

echo PIPE::VERSION;

PIPE permite configurar múltiples conexiones de la siguiente manera.

<?php
  
require_once __DIR__.'/vendor/autoload.php';

use PIPE\Clases\PIPE;
use PIPE\Clases\Configuracion;

$conexiones = [
    'mysql' => [ 
        'BD_CONTROLADOR' => 'mysql',
        'BD_HOST' => 'localhost',
        'BD_PUERTO' => '3306',
        'BD_USUARIO' => 'root',
        'BD_CONTRASENA' => 'contrasena',
        'BD_BASEDATOS' => 'pipe',
        'IDIOMA' => 'es',
        'RUTA_MODELOS' => 'ruta/completa/a/mis/modelos',
        'ZONA_HORARIA' => 'America/Bogota',
        'COMANDO_INICIAL' => 'set names utf8mb4 collate utf8mb4_unicode_ci',
        'TIPO_RETORNO' => Configuracion::CLASE,
        'OPCIONES' => [PDO::MYSQL_ATTR_LOCAL_INFILE => 1]
    ],
    'pgsql' => [ 
        'BD_CONTROLADOR' => 'pgsql',
        'BD_HOST' => 'localhost',
        'BD_PUERTO' => '5432',
        'BD_USUARIO' => 'root',
        'BD_CONTRASENA' => 'contrasena',
        'BD_BASEDATOS' => 'pipe',
        'IDIOMA' => 'es',
        'RUTA_MODELOS' => 'ruta/completa/a/mis/modelos',
        'ZONA_HORARIA' => 'America/Bogota',
        'TIPO_RETORNO' => Configuracion::CLASE
    ]
];

// El segundo parámetro indica la conexión por defecto que será utilizada.
Configuracion::inicializar($conexiones, 'mysql');

/**
 * Finalmente, verificamos que hemos inicializado la configuración correctamente
 * imprimiendo la versión del ORM PIPE.
 */

echo PIPE::VERSION;

Creación de un Modelo.

PIPE automáticamente importa los modelos que han sido ubicados en la ruta especificada por medio de la constante RUTA_MODELOS al inicializar la configuración.

Creamos el archivo Usuario.php y lo guardamos en la ruta que hemos especificado en la constante RUTA_MODELOS.

<?php
  
namespace Modelos;

use PIPE\Clases\Modelo;

class Usuario extends Modelo 
{
    // Todo tu código aquí.
}

Vamos a obtener todos los datos de la tabla usuarios por medio del modelo.

<?php

$usuarios = Usuario::todo();

Ahora, vamos a obtener todos los datos de la tabla usuarios por medio del constructor de consultas PIPE.

<?php

$usuarios = PIPE::tabla('usuarios')->todo();

Así de simple.