{"id":60,"date":"2025-04-11T11:49:01","date_gmt":"2025-04-11T15:49:01","guid":{"rendered":"https:\/\/juredev.com\/blog\/?p=60"},"modified":"2025-04-12T20:10:00","modified_gmt":"2025-04-13T00:10:00","slug":"composite-db-orm-ultraligero-para-php-moderno-implementa-velocidad-en-tus-soluciones","status":"publish","type":"post","link":"https:\/\/juredev.com\/blog\/2025\/04\/composite-db-orm-ultraligero-para-php-moderno-implementa-velocidad-en-tus-soluciones\/","title":{"rendered":"Composite DB: ORM Ultraligero para PHP Moderno – Implementa Velocidad en tus Soluciones"},"content":{"rendered":"\n

Si hay algo que me apasiona en el desarrollo web, es encontrar herramientas que simplifiquen la vida sin comprometer el rendimiento. ORMs como Doctrine son potentes, pero a menudo vienen con configuraciones complejas y una curva de aprendizaje empinada. Hace poco me encontr\u00e9 Composite DB<\/strong>, un ORM minimalista que puedes tener funcionando en menos de 5 minutos. \u00bfTe gustar\u00eda conocer una opci\u00f3n ligera y r\u00e1pida para tus proyectos en PHP 8.1+? \u00a1Sigue leyendo!<\/p>\n\n\n\n

\u00bfQu\u00e9 es Composite DB?<\/h2>\n\n\n\n

Composite<\/strong> DB<\/strong> es un ORM ultraligero dise\u00f1ado para PHP 8.1+. Su filosof\u00eda es clara: menos configuraci\u00f3n, m\u00e1s acci\u00f3n. Aprovecha las caracter\u00edsticas modernas de PHP para ofrecerte un c\u00f3digo limpio y un rendimiento \u00e1gil, ideal para proyectos donde la velocidad y la simplicidad son prioridad.<\/p>\n\n\n\n

Lo mejor de PHP 8.1+ en tus manos<\/h2>\n\n\n\n

Composite DB<\/strong> saca el m\u00e1ximo provecho de las novedades de PHP. Mira este ejemplo de una entidad:<\/p>\n\n\n\n

\n<?php\n\/\/ src\/Entity\/User.php\nnamespace App\\Entity;\n\nuse Composite\\DB\\Attributes\\{Table, PrimaryKey};\nuse Composite\\Entity\\AbstractEntity;\nuse App\\Enums\\Status;\n\n#[Table(connection: 'sqlite', name: 'Users')]\nclass User extends AbstractEntity\n{\n #[PrimaryKey(autoIncrement: true)]\n public readonly int $id;\n\n public function __construct(\n public string $email,\n public ?string $name = null,\n public bool $is_test = false,\n public Status $status = Status::ACTIVE,\n public readonly \\DateTimeImmutable $created_at = new \\DateTimeImmutable(),\n ) {}\n}\n<\/code><\/p>\n\n\n\n

    \n
  • Enums nativos<\/strong>: Usa Status para definir estados como ACTIVE<\/code> o BLOCKED<\/code> de forma clara.<\/li>\n\n\n\n
  • Propiedades inmutables<\/strong>: id<\/code> y created_at<\/code> son readonly<\/code>, garantizando datos consistentes.<\/li>\n\n\n\n
  • Atributos PHP<\/strong>: Con #[Table]<\/code> y #[PrimaryKey]<\/code>, mapeas la entidad a la base de datos sin complicaciones.<\/li>\n<\/ul>\n\n\n\n

    \u00bfCu\u00e1ndo brilla Composite DB?<\/h2>\n\n\n\n

    Este ORM es perfecto para escenarios donde necesitas moverte r\u00e1pido:<\/p>\n\n\n\n

      \n
    • APIs RESTful<\/strong>: Crea endpoints para apps m\u00f3viles en minutos.<\/li>\n\n\n\n
    • Prototipos r\u00e1pidos<\/strong>: Valida ideas sin perder tiempo en configuraciones.<\/li>\n\n\n\n
    • Proyectos IoT<\/strong>: Gestiona datos de sensores con pocos recursos.<\/li>\n<\/ul>\n\n\n\n

      Tutorial pr\u00e1ctico: API con Composite DB y Slim Framework<\/h2>\n\n\n\n

      Vamos a construir una API sencilla usando Composite DB<\/strong> y Slim <\/strong>con SQLite <\/strong>como base de datos. \u00a1Sigue estos pasos y tendr\u00e1s algo funcional en poco tiempo!<\/p>\n\n\n\n

      1.- Instalar dependencias<\/strong><\/p>\n\n\n\n

      Crea un nuevo proyecto e instala las dependencias con Composer:<\/p>\n\n\n\n

      \nmkdir CompositeDB-Slim\ncd CompositeDB-Slim\ncomposer init --name=\"tu-nombre\/composite-db-slim\" --require=\"php:^8.1\"\ncomposer require slim\/slim:^4.0 slim\/psr7 composite\/db vlucas\/phpdotenv\n<\/code><\/p>\n\n\n\n

      2.- Configurar la conexi\u00f3n a la base de datos<\/strong><\/p>\n\n\n\n

      Composite DB<\/strong> necesita un archivo de configuraci\u00f3n para la conexi\u00f3n. Crea src\/Config\/ConnectionManager.php<\/code>:<\/p>\n\n\n\n

      \n [\n 'driver' => 'pdo_sqlite',\n 'path' => DB_PATH, \/\/SQLite crear\u00e1 este archivo si no existe\n ],\n];\n<\/code><\/p>\n\n\n\n

      Luego, configura la variable de entorno CONNECTIONS_CONFIG_FILE<\/code> usando phpdotenv<\/code>. Crea un archivo .env<\/code> en la ra\u00edz del proyecto:<\/p>\n\n\n\n

      \nCONNECTIONS_CONFIG_FILE=..\/src\/Config\/ConnectionManager.php\n<\/code><\/p>\n\n\n\n

      Tip<\/strong>: La ruta ..\/src\/Config\/ConnectionManager.php<\/code> es relativa al directorio public\/<\/code>, desde donde se ejecuta index.php<\/code>. Esto asegura que Composite DB encuentre el archivo correctamente.<\/p>\n\n\n\n

      3.- Definir el modelo y la tabla<\/strong><\/p>\n\n\n\n

      Crea el enum Status<\/code> en src\/Enums\/Status.php<\/code>:<\/p>\n\n\n\n

      \n<?php\nnamespace App\\Enums;\n\nenum Status: string\n{\n case ACTIVE = 'ACTIVE';\n case BLOCKED = 'BLOCKED';\n}\n<\/code><\/p>\n\n\n\n

      Usa la entidad User que mostramos antes (src\/Model\/User.php)<\/code>.<\/p>\n\n\n\n

      Ahora, define la clase de tabla en src\/Model\/UsersTable.php<\/code>:<\/p>\n\n\n\n

      \n<?php\nnamespace App\\Table;\n\nuse Composite\\DB\\AbstractTable;\nuse App\\Entity\\User;\n\nclass UsersTable extends \\Composite\\DB\\AbstractTable\n{\n protected function getConfig(): \\Composite\\DB\\TableConfig\n {\n return \\Composite\\DB\\TableConfig::fromEntitySchema(User::schema());\n }\n\n \/**\n * @return User[]\n *\/\n public function findAllActive(): array\n {\n return $this->_findAll(['status' => \\App\\Enums\\Status::ACTIVE]);\n }\n\n public function init(): void\n {\n $this->getConnection()->executeStatement(\"\n CREATE TABLE IF NOT EXISTS Users\n (\n `id` INTEGER\n CONSTRAINT Users_pk PRIMARY KEY AUTOINCREMENT,\n `email` VARCHAR(255) NOT NULL,\n `name` VARCHAR(255) DEFAULT NULL,\n `is_test` INT DEFAULT 0 NOT NULL,\n `status` TEXT DEFAULT 'ACTIVE' NOT NULL,\n `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,\n CHECK (status IN ('ACTIVE', 'BLOCKED'))\n );\n \");\n }\n}\n<\/code><\/p>\n\n\n\n

      Nota:<\/strong> Llama a init()<\/code> una vez para crear la tabla. Puedes hacerlo manualmente o en el c\u00f3digo inicial (lo veremos m\u00e1s adelante).<\/p>\n\n\n\n

      4.- Configurar Slim y las rutas<\/strong><\/p>\n\n\n\n

      Crea public\/index.php<\/code> con la l\u00f3gica de la API:<\/p>\n\n\n\n

      \n<?php\ndeclare(strict_types=1);\n\nuse App\\Controllers\\RootController;\nuse App\\Controllers\\UserController;\nuse DI\\ContainerBuilder;\nuse Psr\\Http\\Message\\ResponseInterface as Response;\nuse Psr\\Http\\Message\\ServerRequestInterface as Request;\nuse Slim\\Factory\\AppFactory;\nuse Dotenv\\Dotenv;\n\nrequire __DIR__ . '\/..\/vendor\/autoload.php';\n\n\/\/ Cargar variables de entorno\n$dotenv = Dotenv::createImmutable(__DIR__ . '\/..\/');\n$dotenv->load();\n\n\/\/ Configurar PHP-DI\n$containerBuilder = new ContainerBuilder();\n$containerBuilder->addDefinitions([\n \\App\\Table\\UsersTable::class => \\DI\\create(\\App\\Table\\UsersTable::class)\n]);\n\n\/\/ Construir el contenedor\n$container = $containerBuilder->build();\n\n\/\/ Configurar Slim con el contenedor\nAppFactory::setContainer($container);\n$app = AppFactory::create();\n$app->addRoutingMiddleware();\n\n\/\/ Inicializar la base de datos (descomentar solo la primera vez)\n\/\/ $container->get(App\\Table\\UsersTable::class)->init();\n\n\/\/ Rutas\n$app->get('\/', [RootController::class, 'index']);\n$app->get('\/users', [UserController::class, 'list']);\n$app->post('\/users', [UserController::class, 'create']);\n\n$app->run();\n<\/code><\/p>\n\n\n\n

      5.- Probar la API<\/strong><\/p>\n\n\n\n

      Crea el directorio database\/<\/code> en la ra\u00edz del proyecto:<\/p>\n\n\n\n

      \nmkdir database\n<\/code><\/p>\n\n\n\n

      Nota: <\/strong>En el repositorio incluyo una base datos SQlite con ejemplos pero si deseas hacerlo desde cero, este es el inicio.<\/p>\n\n\n\n

      Inicia el servidor de desarrollo:<\/p>\n\n\n\n

      \nphp -S localhost:8000 -t public\n<\/code><\/p>\n\n\n\n

      Prueba las rutas:<\/p>\n\n\n\n