Repolode
Luracast

Luracast/Restler

Framework de API REST para PHP 8+ que genera rutas, validaciones y documentación OpenAPI a partir de métodos de clase mediante reflexión.

Estrellas
1,386
Forks
313
Issues abiertos
33
Último commit
anteayer

¿Qué es?

Restler permite escribir la lógica de la API como métodos de clase normales de PHP. Usa reflexión y PHPDoc o atributos para asociar métodos con rutas HTTP, validar parámetros tipados y generar documentación OpenAPI 3.0 con un explorador Swagger UI integrado, de modo que no es necesario escribir a mano la mayor parte del código de rutas y controladores.

Las respuestas son JSON de forma predeterminada, y extensiones de archivo como .xml, .csv o .xlsx permiten seleccionar otros formatos de salida una vez configurados. El framework puede ejecutarse en PHP-FPM, con Swoole u OpenSwoole para ofrecer un servicio persistente de alto rendimiento, con ReactPHP, con Workerman o en AWS Lambda mediante Bref. También incluye compatibilidad con GraphQL, ejemplos de servidores OAuth 2.0 y limitación de solicitudes.

El proyecto requiere PHP 8.0 o posterior y se instala con Composer. Su README incluye una guía de migración desde v5 y proyectos de ejemplo que abarcan CRUD, autenticación, versionado y plantillas HTML.

Funciones clave

  • 01Asocia automáticamente métodos de clase con rutas REST mediante reflexión
  • 02Valida parámetros tipados y devuelve los códigos de estado HTTP adecuados
  • 03Genera documentación OpenAPI 3.0 a partir de comentarios PHPDoc con Swagger UI
  • 04Admite JSON de forma predeterminada y XML, CSV, XLSX, YAML y HTML cuando se configuran
  • 05Se ejecuta en PHP-FPM, Swoole/OpenSwoole, ReactPHP, Workerman o AWS Lambda
  • 06Incluye compatibilidad con GraphQL, limitación de solicitudes y ejemplos de servidores OAuth 2.0

Casos de uso

  • Crear API internas o microservicios en una base de código PHP existente
  • Ofrecer JSON a clientes modernos y XML o CSV a sistemas heredados desde los mismos endpoints
  • Exportar grandes conjuntos de datos como CSV o Excel mediante streaming con generadores
  • Modernizar una aplicación PHP antigua al añadir una capa de API REST

Inicio rápido

  1. 1

    Instala el paquete con Composer

    composer require luracast/restler:^6.0
  2. 2

    Crea una clase API y una pasarela public/index.php que la mapee (consulta el README)

  3. 3

    Inicia el servidor PHP integrado

    php -S localhost:8080 -t public

Antes de usarlo

  • Requiere PHP 8.0 o posterior.
  • No se especifica ninguna licencia en los metadatos del proyecto.
  • La versión 6 incluye cambios incompatibles con la v5, por lo que para actualizar necesitas la guía de migración.

En colecciones

Temas

Preguntas frecuentes

¿Qué es Restler?
Framework de API REST para PHP 8+ que genera rutas, validaciones y documentación OpenAPI a partir de métodos de clase mediante reflexión. Restler permite escribir la lógica de la API como métodos de clase normales de PHP. Usa reflexión y PHPDoc o atributos para asociar métodos con rutas HTTP, validar parámetros tipados y generar documentación OpenAPI 3.0 con un explorador Swagger UI integrado, de modo que no es necesario escribir a mano la mayor parte del código de rutas y controladores.
¿Restler es gratuito? ¿Qué licencia tiene?
Restler no declara ninguna licencia. Su código es público, pero sin licencia no tienes permiso explícito para reutilizarlo; consulta al autor antes de depender de él.
¿Restler sigue mantenido?
Mantenimiento activo. El último commit de Restler fue el 4 nov 2026.
¿Para qué puedo usar Restler?
Crear API internas o microservicios en una base de código PHP existente Ofrecer JSON a clientes modernos y XML o CSV a sistemas heredados desde los mismos endpoints Exportar grandes conjuntos de datos como CSV o Excel mediante streaming con generadores Modernizar una aplicación PHP antigua al añadir una capa de API REST
¿Cómo se instala Restler?
Instala el paquete con Composer: composer require luracast/restler:^6.0 Crea una clase API y una pasarela public/index.php que la mapee (consulta el README) Inicia el servidor PHP integrado: php -S localhost:8080 -t public
¿Dónde consigo Restler?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Luracast/Restler

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados