README

Una librería de abstracción de base de datos ligera y segura para PHP, basada en PDO. Diseñada para funcionar como un query builder simple o una capa tipo ORM en aplicaciones MVC.

Este repositorio contiene una versión modernizada y refactorizada del clásico PDODb manteniendo las llamadas a los métodos originales para asegurar la compatibilidad con código existente.

Requisitos

PHP 8.0 o superior.
Extensión PDO habilitada.
Drivers de base de datos correspondientes (mysql, sqlite, pgsql, sqlsrv).

Instalación

Instalar vía composer:

composer require ctrbts/base-model

Cambios Principales (Refactorización)

Esta librería ha sido actualizada para cumplir con estándares modernos de PHP y seguridad:

Namespace: Se ha introducido el namespace BaseModel. Deberás actualizar tus llamadas new BaseModel(...) a new BaseModel\BaseModel(...) o agregar use BaseModel\BaseModel;.
Tipado Estricto: Se ha implementado declare(strict_types=1) y tipado fuerte en propiedades y argumentos de métodos. Esto previene errores silenciosos y mejora la estabilidad.
Seguridad en Constructor: Se eliminó el uso inseguro de "variables variables" ($$key) en el constructor. Ahora los parámetros se asignan de manera explícita y controlada.
Sanitización: Mejorada la sanitización en cláusulas ORDER BY y nombres de tablas para prevenir inyecciones SQL en identificadores.
Manejo de Errores: Uso consistente de Exception y PDOException.
PHP 8 Match: Uso de expresiones match en lugar de switch para operaciones más limpias y estrictas.

Nota de compatibilidad: Aunque el código interno ha cambiado drásticamente, se han conservado los nombres de todos los métodos públicos y el orden de sus parámetros para asegurar que tu código existente funcione con mínimos cambios.

¿Por qué existe esta versión?

Si conoces la librería original de tommyknocker, notarás que su versión 2.0+ ha evolucionado hacia un framework de base de datos completo con ORM, migraciones y CLI, similar a Eloquent o Doctrine.

Esta refactorización (BaseModel) mantiene la filosofía original:

Ligereza: Todo el código reside en una sola clase. No hay sobrecarga de cientos de archivos incluidos.
Simplicidad: Es un drop-in replacement para sistemas legacy o frameworks ligeros que solo necesitan un wrapper de PDO robusto y un Query Builder, sin la complejidad de un Active Record completo.
Control: Ideal para desarrolladores que quieren entender y controlar exactamente qué consultas se ejecutan sin capas de abstracción "mágicas".

Uso Básico

use BaseModel\BaseModel;

Inicialización

$db = new BaseModel([
    'type' => 'mysql',
    'host' => 'localhost',
    'username' => 'root',
    'password' => 'secret',
    'dbname' => 'mi_app',
    'charset' => 'utf8mb4'
]);

Select (Get)

// Obtener todos los usuarios activos
$users = $db->where('active', 1)
            ->get('users');

// Obtener un solo usuario
$user = $db->where('id', 15)
           ->getOne('users');

Insert

$data = [
    'username' => 'nuevo_usuario',
    'email' => 'email@test.com',
    'created_at' => $db->now()
];

$id = $db->insert('users', $data);

Update

$data = ['active' => 0];
$db->where('last_login', $db->interval('-1 year'), '<');
$db->update('users', $data);

Delete

$db->where('id', 50)->delete('users');

Contribuir

Las contribuciones son bienvenidas. Por favor asegura que cualquier cambio pase los estándares de codificación PSR-12.

Créditos y Reconocimientos

Trabajo Original: Este proyecto es un fork modernizado de la librería pdo-database-class creada por tommyknocker. Se basa en la arquitectura de la versión 1.x, antes de que el proyecto original evolucionara hacia un framework completo en su versión 2.0.

Refactorización: La modernización a PHP 8, tipado estricto y mejoras de seguridad fue realizada con la asistencia de IA, siguiendo el mismo proceso de calidad aplicado en proyectos similares como la Refactorización de TimThumb.

ctrbts / base-model

Maintainers

Details