Ya están publicados nuevos contenidos y mejoras en la documentación: guías de instalación en Apache y Nginx (en inglés), una guía “Primera App” en español totalmente revisada, instrucciones para instalar con Composer y una sección de Controladores clarificada y con imágenes nuevas. Todo esto alineado con KumbiaPHP 1.2 optimizado para PHP 8. Consulta el repo del manual para ver los cambios completos. (GitHub)
1) Nuevas guías: instalación en Apache y Nginx (en inglés)
Publicamos instrucciones claras para servir aplicaciones KumbiaPHP detrás de Apache (VirtualHosts) y Nginx (server blocks), destacando los puntos clave: usar public/ como document root y habilitar las reglas de reescritura para el front controller. Estas guías facilitan el despliegue en entornos modernos sin dependencias innecesarias. GitHub
Qué encontrarás:
- Estructura mínima y document root correcto (public/).
- Directrices de reescritura para URLs limpias (pretty URLs).
- Notas rápidas para PHP-FPM (Nginx) y módulos en Apache.
2) “Primera App” — más clara y didáctica
La guía Primera App fue reescrita con foco en personas que inician con MVC:
a. Se aclaró la arquitectura MVC y el manejo de URLs, explicando cómo el front controller enruta /controlador/acción/param hacia tu lógica.
b. Se actualizaron los ejemplos de controladores y vistas, con código más legible y ordenado.
c. Se mejoraron los títulos y subtítulos para escanear mejor el contenido.
d. Se reemplazaron capturas de pantalla, haciendo más evidente cada paso (crear controlador, renderizar vista, pasar variables).
3) Instalación con Composer (nuevo apartado)
Ahora el manual incluye un flujo directo para iniciar proyectos con Composer:
Requisitos mínimos: PHP 8.x recomendado.
Pasos típicos:
1) Crear un nuevo proyecto base de KumbiaPHP
composer create-project kumbia/framework myapp
2) Entrar al proyecto
cd myapp/default/app
3) Iniciar servidor de desarrollo de PHP apuntando a public/
./bin/phpserver
El paquete framework es el esqueleto básico para comenzar: genera la estructura y te deja listo para desarrollar. Si eres nuevo en Composer, la sección Instalación con Composer te guiarán sobre cómo funciona composer.json y los comandos principales.
4) Controladores: contenido revisado + nuevas imágenes
La sección de Controladores se reordenó para mejorar la lectura y cubrir escenarios reales:
- Validación de parámetros: número de parámetros, pasar valores a la vista, convenciones de nombrado, acciones y filtros.
- Controladores dinámicos: cuándo conviene y cómo mantenerlos legibles.
Enlaces rápidos
- Manual (repo): documentación central y carpetas es/ y en/. (GitHub)
- Paquete framework en Packagist: referencias y enlaces al manual. (Packagist)
Gracias a la comunidad 🙌
Estas mejoras nacen de pull requests recientes y la colaboración constante de la comunidad. Si quieres proponer cambios, abre un PR en el repo del manual o únete al Slack para coordinar traducciones/imágenes adicionales. ¡Seguimos puliendo el contenido para que empezar con KumbiaPHP 1.2 (PHP 8) sea cada vez más fácil!