Search by

jbflores24 / framework

jbflores24

Miniframework PHP 8.2 para APIs REST.

Package info

github.com/jbflores24/jb-framework

pkg:composer/jbflores24/framework

Security

Advisories: 0

Aikido package health analysis

Transparency log

Statistics

Installs: 8

Dependents: 1

Suggesters: 0

Stars: 29

Open Issues: 0

v1.0.3 2026-10-25 19:34 UTC

Requires

Requires (Dev)

Suggests

None

Provides

None

Conflicts

None

Replaces

None

MIT 0078834b5e5f05476f02a759dee6846ad7383b06

frameworkmicroframeworkphprestapi

Published on Packagist.org on 2026-10-25 19:46 UTC

This package is auto-updated.

Last update: 2026-11-12 06:44:10 UTC

README

JB Framework es un framework PHP 8.2 ligero para APIs REST JSON. Se enfoca en código claro, seguridad por defecto y un núcleo pequeño y fácil de auditar.

Qué incluye

  • Núcleo HTTP con Router, Request, Response, Container y HttpException
  • Capa de base de datos con QueryBuilder, BaseRepository, migraciones y seeders
  • Autenticación JWT y middleware de permisos
  • Módulo de seguridad con detección de amenazas, puntuación, listas de permitidos y bloqueados
  • Caché en archivo, registro, correo, limitación de solicitudes y utilidades de validación
  • CLI para crear proyectos, generar estructuras, ejecutar migraciones, seeders y documentación
  • Suite de pruebas PHPUnit 11 con cobertura unitaria e integral

Qué no incluye

  • Plantillas HTML
  • ORM como Eloquent
  • Colas, jobs o workers
  • WebSockets
  • Sistema de eventos integrado
  • Capa de almacenamiento para cargas de archivos
  • OAuth o inicio de sesión social
  • Interfaz administrativa
  • Multitenencia
  • Internacionalización

Requisitos

  • PHP 8.2 o superior
  • Composer 2 o superior
  • Extensión PDO y un controlador de base de datos compatible
  • Un servidor web con soporte para reescritura de URLs

Instalación del framework

git clone https://github.com/jbflores24/jb-framework.git jb
cd jb
composer install
composer test

Crear un proyecto nuevo

Con Composer 2 y PHP 8.2 o superior, desde cualquier computadora con acceso a internet:

composer create-project jbflores24/skeleton mi_api
cd mi_api
php jb serve

El proyecto se prepara solo: crea el .env con un JWT_SECRET nuevo y las carpetas de almacenamiento.

Alternativa desde el repositorio del framework (sin Packagist):

php bin/jb new mi_api
cd mi_api
composer install

Generar un recurso

php jb make:scaffold Producto
php jb migrate
php jb seed Producto
php jb test

El comando make:scaffold crea el controlador, el modelo, la migración, el seeder, la prueba unitaria, la prueba de integración, el bloque de rutas, el permiso de seguridad y la entrada de auditoría.

Documentación

Reproducibilidad del estudio

  • jbtest: entorno de prueba usado para medir el comportamiento del framework.
  • pruebas_jb: herramientas, metodología y trazabilidad del estudio.
  • research-2026-v1: referencia estable de esta documentación y de los artefactos asociados.

Proyecto de ejemplo

El directorio examples/demo_api/ contiene una estructura de ejemplo ligera para referencia.

Para crear un proyecto ejecutable, usa composer create-project jbflores24/skeleton mi_api (ver arriba). El código base de ese proyecto vive en skeleton/.

Licencia MIT.