Mejoras en ActiveRecord

Se corrigieron ejemplos de validación que contenían sintaxis PHP incorrecta y se ajustaron argumentos y mensajes para que correspondan con la API actual de KumbiaPHP. También se repararon ejemplos relacionados con callbacks y validaciones de correo electrónico.

La documentación de paginación también fue revisada. El ejemplo completo ahora conserva correctamente las condiciones de búsqueda y el estado de la paginación entre las diferentes solicitudes, además de corregir referencias a propiedades, comparaciones y archivos de las vistas.

Otro cambio importante fue la actualización de la referencia de la API de ActiveRecord. Se alinearon firmas de métodos, valores de retorno, convenciones de fechas, configuración y ejemplos con el comportamiento actual del framework.

Sin embargo, también se recomienda revisar la opción de utilizar el nuevo ActiveRecord, ya que incorpora mejoras de optimización y seguridad que pueden beneficiar a las aplicaciones que utilizan KumbiaPHP.

Documentación de seguridad más precisa

La seguridad también recibió una revisión importante.

Se eliminó de la documentación una afirmación incorrecta sobre la protección automática de ActiveRecord frente a inyecciones SQL. Ahora se explica con mayor claridad la diferencia entre el filtrado de solicitudes, el manejo de SQL, las consultas sin parámetros y el escape de contenido HTML.

El objetivo es que la documentación no solo muestre cómo utilizar el framework, sino que también ayude a comprender sus límites y a desarrollar aplicaciones más seguras.

Un tutorial CRUD más fácil de seguir

El tutorial de CRUD fue reorganizado para ofrecer una experiencia más progresiva, especialmente para quienes están comenzando con KumbiaPHP.

La nueva versión explica el flujo de datos y la relación con MVC, incorpora pasos para CRUD, rutas, paginación y verificación, además de incluir una sección de solución de problemas y una lista de comprobación. También se añadieron 14 capturas de pantalla con textos alternativos descriptivos y captions en Markdown.

Estas mejoras permiten seguir el tutorial de principio a fin y comprender no solo qué código escribir, sino también cómo se relacionan las diferentes partes de una aplicación KumbiaPHP.

Seguimos mejorando

Estas actualizaciones son parte del trabajo continuo para mantener la documentación de KumbiaPHP alineada con el framework y hacerla más útil tanto para desarrolladores experimentados como para quienes están aprendiendo.

Puedes consultar los cambios directamente en GitHub:

• PR #90, correcciones de ejemplos de ActiveRecord
• PR #91, correcciones del ejemplo de paginación
• PR #92, mejoras de documentación sobre seguridad SQL
• PR #93, actualización de la referencia de ActiveRecord
• PR #97, mejora del tutorial de CRUD

La documentación es una parte fundamental del proyecto. Mantenerla actualizada ayuda a que KumbiaPHP siga siendo más fácil de aprender, utilizar y mantener.

La entrada Actualizamos la documentación de KumbiaPHP se publicó primero en KumbiaPHP Framework PHP en español.

En este nuevo escenario, un framework no solo necesita estar actualizado para los desarrolladores, sino que también debe ofrecer a estos nuevos agentes el contexto necesario para entender cómo debe utilizarse. Con ese objetivo nace el repositorio KumbiaPHP Agent Skills, una nueva iniciativa de la comunidad para preparar el ecosistema para esta nueva etapa del desarrollo de software.

https://github.com/KumbiaPHP/agents-skills

¿Qué son las KumbiaPHP Agent Skills?

Las KumbiaPHP Agent Skills son un conjunto de instrucciones estructuradas diseñadas para que los agentes de inteligencia artificial puedan trabajar correctamente con el framework. A diferencia de la documentación tradicional, que está pensada para humanos, las Agent Skills están diseñadas para responder las dudas clave de los agentes, indicándoles cuándo usar una funcionalidad específica, qué decisiones arquitectónicas deben respetar, las convenciones propias del framework y cómo evitar errores conceptuales al generar código. Estas habilidades utilizan el estándar abierto Agent Skills, basado en archivos SKILL.md alojados dentro de carpetas especializadas.

Independencia de proveedores

El repositorio KumbiaPHP Agent Skills no está ligado a ninguna herramienta específica. Al no depender de asistentes concretos como Claude, GitHub Copilot, OpenCode o Codex, se convierte en una capa de conocimiento reutilizable para cualquier sistema compatible con el estándar. El objetivo no es crear una integración cerrada, sino construir una base de conocimiento universal para la IA aplicada a KumbiaPHP.

Primeras KumbiaPHP Agent Skills disponibles

La primera versión del repositorio incluye cuatro Agent Skills fundamentales:

1. Crear controladores (kumbiaphp-create-controller)

Define cómo deben crearse y modificarse los controladores en el framework. Instruye a la IA para que revise los controladores existentes, respete la jerarquía de AppController y mantenga la lógica de negocio estrictamente en los modelos. Al evitar la sobrecarga del controlador, esta Skill garantiza que el código generado mantenga siempre una arquitectura MVC limpia y ordenada.

2. Crear modelos (kumbiaphp-create-model)

Orientada a los modelos basados en ActiveRecord, esta instrucción guía a la IA en la revisión del esquema de la base de datos y en el uso de los patrones nativos del framework. Al enseñarle a evitar capas innecesarias —como repositorios externos— y a adaptarse al código del proyecto, su principal beneficio es asegurar que todas las soluciones respeten fielmente el estilo nativo de KumbiaPHP.

3. Crear vistas (kumbiaphp-create-view)

Esta habilidad define cómo trabajar con las vistas .phtml. Obliga al agente a revisar el controlador asociado, a aprovechar los layouts y helpers existentes, y a evitar la inclusión de lógica de negocio en la interfaz. El resultado directo de estas reglas es la generación de vistas mucho más limpias, coherentes y con una separación estricta del patrón MVC.

4. ActiveRecord (kumbiaphp-work-with-active-record)

Es la Skill más completa del sistema y abarca la formulación de consultas, paginación, relaciones, validaciones y operaciones CRUD. Además, incorpora reglas de seguridad vitales, educando a la IA sobre el control de campos permitidos y la precaución con las consultas dinámicas, mientras evita malas prácticas heredadas de otros ORM. Esto proporciona un equilibrio perfecto entre la seguridad de los datos y la consistencia general del framework.

Principios KISS, DRY y MVC en la IA

Estas directrices refuerzan los principios fundamentales de KumbiaPHP, asegurando que la IA aplique la filosofía KISS (Keep It Simple), DRY (Don’t Repeat Yourself), mantenga el patrón MVC bien separado y priorice el uso de las APIs nativas del framework. Adicionalmente, exigen que los agentes verifiquen la versión real de KumbiaPHP antes de asumir comportamientos, previniendo los clásicos errores que ocurren cuando la IA mezcla funciones de distintas versiones de PHP u otros frameworks.

KumbiaPHP Agent Skills y el futuro del framework

Este repositorio no es un experimento aislado, sino una evolución natural del ecosistema KumbiaPHP. Hoy en día, no basta con que un framework sea estable, esté bien documentado y se mantenga actualizado; también debe ser comprensible para los agentes de IA, compatible con herramientas de desarrollo asistido y estar estructurado para su consumo automático. Esto introduce un concepto vital para la supervivencia del software: el contexto del framework también debe mantenerse actualizado para las máquinas.

Las KumbiaPHP Agent Skills representan un cambio importante en la forma en que los frameworks se preparan para el futuro. Ya no basta con documentar para humanos; ahora también es indispensable documentar para los agentes de inteligencia artificial. Con este repositorio, KumbiaPHP da un paso al frente y se posiciona como un framework completamente preparado para la nueva generación de herramientas de desarrollo asistido por IA.

https://github.com/KumbiaPHP/agents-skills

https://agentskills.io/specification

La entrada KumbiaPHP Agent Skills: IA para el framework PHP se publicó primero en KumbiaPHP Framework PHP en español.

KumbiaPHP y PHP 8.5 representan un paso importante para mantener el framework actualizado, estable y preparado para nuevos proyectos. Las mejoras recientes fortalecen la consola, amplían las pruebas automatizadas y facilitan la colaboración de la comunidad.

Desde la publicación de KumbiaPHP 1.2.1, el proyecto ha seguido evolucionando sin abandonar su objetivo principal: ofrecer una experiencia de desarrollo simple, rápida y productiva.

Resumen

• La consola reconoce mejor la ubicación de las aplicaciones.
• Los errores relacionados con rutas son más claros.
• Se evitaron avisos innecesarios al ejecutar comandos.
• Las pruebas automatizadas cubren desde PHP 8.0 hasta PHP 8.5.
• Se mejoró la compatibilidad con Workerman 5.
• Se añadieron nuevas pruebas para la consola y la gestión de hojas de estilo.
• La comunidad dispone de mejores guías para contribuir.
• Continúan en desarrollo mejoras para PostgreSQL, autenticación, formularios y Registry.

KumbiaPHP y PHP 8.5: una base más confiable

La compatibilidad entre KumbiaPHP y PHP 8.5 ayuda a que el framework pueda utilizarse en entornos actuales sin dejar atrás los proyectos existentes.

La matriz de pruebas automatizadas cubre ahora desde PHP 8.0 hasta PHP 8.5. Esto permite detectar incompatibilidades y elementos deprecados antes de que lleguen a afectar las aplicaciones.

También se realizaron ajustes para mantener la compatibilidad con Workerman 5, especialmente en el uso de temporizadores y en el proceso de inicio del servidor.

En conjunto, estos cambios crean una base más sólida para desarrollar aplicaciones con versiones recientes de PHP.

Una consola más clara y predecible

La consola de KumbiaPHP ahora reconoce con mayor facilidad la ubicación de una aplicación.

La opción --path puede apuntar directamente al directorio de la aplicación o a la raíz de un proyecto que contenga la estructura habitual del framework.

Cuando una ruta no existe o no contiene una aplicación válida, la consola muestra un mensaje más claro. Esto facilita la identificación del problema y evita perder tiempo revisando configuraciones incorrectas.

También se corrigió un aviso que podía aparecer cuando application.production no estaba definido. En ese caso, la consola utiliza un valor predeterminado seguro, sin modificar la configuración del proyecto.

Estas mejoras permiten ejecutar comandos desde diferentes ubicaciones con un comportamiento más consistente.

Más pruebas para proteger la estabilidad

Las pruebas automatizadas son una parte esencial para mantener KumbiaPHP estable.

Además de ampliar la compatibilidad con distintas versiones de PHP, se añadieron pruebas específicas para la consola y para la gestión de hojas de estilo mediante Css.

Estas pruebas comprueban aspectos como:

• El orden de los archivos.
• La eliminación de duplicados.
• El manejo de dependencias.
• Las llamadas repetidas.
• Las rutas dentro de subdirectorios.

Con esta cobertura, resulta más sencillo detectar regresiones antes de integrar nuevos cambios.

Un camino más sencillo para contribuir

KumbiaPHP también ha mejorado la documentación dirigida a la comunidad.

El proyecto cuenta ahora con una guía de contribución que explica cómo preparar cambios, ejecutar pruebas y enviar propuestas al repositorio.

También se añadieron un código de conducta y una política para reportar vulnerabilidades de seguridad.

Estas mejoras ofrecen un entorno más claro y seguro para quienes desean colaborar, proponer correcciones o ayudar a revisar el código.

La documentación también incluye información sobre la estructura del proyecto, las versiones compatibles y las prácticas recomendadas para trabajar en el framework.

Qué sigue en desarrollo

Varias mejoras continúan en revisión y todavía no forman parte de la rama principal.

Estas propuestas buscan resolver situaciones reales encontradas en diferentes entornos de desarrollo.

Mientras continúen en revisión, no deben considerarse funcionalidades disponibles de manera general.

Problemas que aún necesitan una solución

También se han identificado dos situaciones que requieren una implementación más completa.

La primera está relacionada con las asociaciones belongs_to. Actualmente, puede resultar difícil diferenciar entre una relación declarada cuyo registro no existe y una relación que nunca fue configurada.

Distinguir ambos casos permitiría mostrar errores más precisos y simplificar la depuración.

La segunda está relacionada con los adaptadores de bases de datos. Los valores SQL y los identificadores, como nombres de tablas, columnas o esquemas, necesitan tratamientos diferentes.

Separarlos claramente ayudaría a mejorar la seguridad y la consistencia de las consultas.

Cómo ayudar a fortalecer KumbiaPHP

La mejor forma de apoyar estos avances es probar KumbiaPHP en proyectos y entornos reales.

Quienes utilicen la consola, Workerman, PostgreSQL, FastCGI, formularios o Registry pueden compartir sus resultados indicando:

• La versión de PHP utilizada.
• El sistema operativo o entorno de ejecución.
• Los pasos necesarios para reproducir el comportamiento.
• El resultado esperado.
• El resultado obtenido.

Antes de proponer un cambio, conviene consultar CONTRIBUTING.md y acompañar cada corrección con una prueba enfocada.

Los avances de KumbiaPHP y PHP 8.5 muestran que el framework puede conservar su sencillez mientras fortalece su compatibilidad, estabilidad y capacidad de evolución. Cada prueba, reporte y contribución ayuda a construir una base más sólida para toda la comunidad.

La entrada KumbiaPHP y PHP 8.5: mejoras del framework se publicó primero en KumbiaPHP Framework PHP en español.

En este artículo, exploraremos una forma más limpia y eficiente de gestionar la renderización condicional en KumbiaPHP con return 1;. También profundizaremos en por qué este enfoque es preferible sobre el uso estándar de return; o estructuras if-else anidadas.

El Enfoque Tradicional: Uso de if-else

Considera un escenario donde quieres mostrar un mensaje si no hay datos para mostrar y renderizar el resto de la vista solo cuando los datos están disponibles. Un enfoque típico podría verse así:

<?php if (!$products): ?>
    <h2>No hay productos disponibles</h2>
<?php else: ?>
    <h1>Lista de Productos</h1>
    <ul>
        <?php foreach ($products as $product): ?>
            <li>
                <h3><?= $product->nombre ?></h3>
                <img src="<?= $product->imagen_url ?>" alt="<?= $product->nombre ?>" />
                <p><strong>Categoría:</strong> <?= $product->categoria ?></p>
                <p><strong>Descripción:</strong> <?= $product->descripcion ?></p>
                <p><strong>Precio:</strong> $<?= number_format($product->precio, 2) ?></p>
                <p><strong>Stock:</strong> <?= $product->stock ?> unidades disponibles</p>
                <p><strong>SKU:</strong> <?= $product->sku ?></p>
                <a href="/productos/<?= $product->id ?>" class="btn">Ver Detalles</a>
            </li>
        <?php endforeach ?>
    </ul>
<?php endif; ?>

Aunque esto funciona, envolver todo el código de la vista dentro de un bloque else añade una indentación y complejidad innecesarias, especialmente en vistas más grandes.

Renderización condicional en KumbiaPHP con return 1; Una Solución Más Limpia:

Para mejorar la legibilidad y mantener el código más limpio, podemos utilizar return 1; para salir de la vista de manera anticipada si no hay datos. Aquí está cómo se vería el código:

<?php if (!$products) {
    echo "<h2>No hay productos disponibles</h2>";
    //View::partial('sin-datos'); // o enviamos un partial
    return 1;
}?>

<h1>Lista de Productos</h1>
<ul>
    <?php foreach ($products as $product): ?>
        <li>
            <h3><?= $product->nombre ?></h3>
            <img src="<?= $product->imagen_url ?>" alt="<?= $product->nombre ?>" />
            <p><strong>Categoría:</strong> <?= $product->categoria ?></p>
            <p><strong>Descripción:</strong> <?= $product->descripcion ?></p>
            <p><strong>Precio:</strong> $<?= number_format($product->precio, 2) ?></p>
            <p><strong>Stock:</strong> <?= $product->stock ?> unidades disponibles</p>
            <p><strong>SKU:</strong> <?= $product->sku ?></p>
            <p><strong>Fecha de Lanzamiento:</strong> <?= date('d/m/Y', strtotime($product->fecha_lanzamiento)) ?></p>
            <p><strong>Calificación:</strong> <?= $product->calificacion ?> estrellas</p>
            <a href="/productos/<?= $product->id ?>" class="btn">Ver Detalles</a>
        </li>
    <?php endforeach ?>
</ul>

En este ejemplo:

• Si $products está vacío o es false, se muestra el mensaje «No hay productos disponibles» y la ejecución de la vista se detiene gracias a return 1;.
• Si $products tiene datos, el código continúa ejecutándose y se muestra la lista detallada de productos sin necesidad de un bloque else.
• El código es más limpio y fácil de leer al eliminar la indentación adicional.

Aplicación en Templates y Partials

La misma técnica puede aplicarse en templates y partials. Esto es útil cuando necesitas condicionar la inclusión de ciertas secciones o elementos de la interfaz de usuario.

Ejemplo en un Partial

En un partial que muestra comentarios de un artículo:

<?php
if (!$comments) {
    echo "<p>No hay comentarios aún. ¡Sé el primero en comentar!</p>";
    return 1;
}?>

<div class="comments">
    <h3><?= count($comments) ?> Comentarios</h3>
    <?php foreach ($comments as $comment): ?>
        <div class="comment">
            <p><strong><?= $comment->autor ?></strong> dice:</p>
            <p><?= $comment->contenido ?></p>
            <p><em>Publicado el <?= date('d/m/Y H:i', strtotime($comment->fecha_publicacion)) ?></em></p>
        </div>
    <?php endforeach ?>
</div>

Entendiendo View::render() y include

En KumbiaPHP, las vistas se renderizan usando el método View::render(), que internamente incluye el archivo de vista:

// Carga la vista
if (!include self::getView()) {
    throw new KumbiaException('Vista "' . self::getPath() . '" no encontrada', 'no_view');
}

La sentencia include en PHP devuelve false si falla al cargar el archivo (debido a que el archivo no existe, falta de permisos, etc.). Si el archivo incluido ejecuta un return; sin un valor, devuelve null, lo que la validación del include se interpreta como false. Esto lleva a que View::render() crea que el archivo de vista no pudo ser incluido y lanza una excepción.

La Importancia de return 1;

Al usar return 1;, la vista devuelve 1, lo que include interpreta como una inclusión exitosa. Esto permite que el proceso de renderización continúe sin problemas sin desencadenar una excepción.

Beneficios de Usar return 1;

• Código Más Limpio: Al eliminar bloques else innecesarios, el código es más sencillo y legible.
• Facilidad de Mantenimiento: Menos indentaciones y anidaciones facilitan la comprensión y modificación del código en el futuro.
• Consistencia: Puedes aplicar esta técnica en vistas, templates y partials de manera uniforme.
• Mayor Claridad: Separar la lógica de control del contenido principal mejora la claridad y organización del código.

Conclusión

Usar return 1; en las vistas de KumbiaPHP es una forma simple pero efectiva de gestionar la renderización condicional sin complicar tu código con estructuras if-else innecesarias. Asegura que tus vistas se ejecuten sin problemas y que el proceso de renderización continúe sin excepciones.

Al adoptar este enfoque, puedes escribir vistas más limpias y mantenibles en tus aplicaciones KumbiaPHP. Pruébalo en tu próximo proyecto y experimenta la diferencia que hace en tu base de código.

¡Feliz codificación con KumbiaPHP!

La entrada Optimizando la Renderización Condicional en Vistas de KumbiaPHP con return 1; se publicó primero en KumbiaPHP Framework PHP en español.

El problema de dejar PRODUCTION en false:

De manera predeterminada, KumbiaPHP expone la información detallada de cualquier tipo de excepción, a modo de permitirle al desarrollador revisar y entender dónde debe realizar mejoras. El problema es que si se olvida de cambiar el flag de PRODUCCION y lo deja en su valor inicial (false) cuando los usuarios finales realicen alguna operación indebida, o exista algún fallo no previsto en el servidor, por ejemplo con el acceso a la base de datos o al sistema de archivo, Kumbia no tendrá contexto de que se trata de una aplicación en producción y expondrá todos los detalles.

La nueva configuración Exception:

La nueva funcionalidad, de forma definitiva, evita exponer información de excepciones, lo cual es un alivio tanto para los desarrolladores como para los clientes. Para permitir la visualización de excepciones se ha agregado un nuevo archivo llamado exception.php. En su contenido se pueden definir las direcciones IP que tendrán permiso para recibir los detalles entregados por KumbiaPHP tanto en desarrollo como en entorno productivo.

Ventajas de la nueva funcionalidad

Dentro de las ventajas que se obtienen con esta nueva mejora podemos mencionar las siguientes:

• Seguridad: evita la exposición accidental de información sensible.
• Control: permite que sólo los desarrolladores o administradores puedan acceder a los detalles de los errores.
• Fácil configuración: los usuarios solo necesitan añadir las IPs de confianza.

Cómo implementar la nueva funcionalidad:

Para implementar la nueva funcionalida necesitamos seguir los siguientes pasos:

1. Configurar las direcciones IP en el archivo exception.php.
2. Comprobar que los errores solo son visibles desde las IPs configuradas.

Caché:

Desde esta nueva funcionalidad, el flag PRODUCTION asignado con el valor true, sólo será reponsable de habilitar el uso de la caché para el sitio web.

Recordatorio:

Nunca está demás dejar un recordatorio extra: aunque estés en modo desarrollo, si no se incluyen las direcciones IP dentro del archivo exception.php verán únicamente el error clásico, sin todos los detalles. Por lo tanto, no se olviden de agregar su propia dirección dentro de la nueva configuración.

Conclusión:

La nueva configuración de Exception en KumbiaPHP es un gran paso hacia la seguridad en entornos de producción, permitiendo que sólo quienes están autorizados puedan ver los detalles de los errores. Este tipo de mejoras no sólo protegen nuestras aplicaciones, sino que también promueven buenas prácticas en el desarrollo. De todos modos, el equipo está trabajando en agregar funcionalidades para esta nueva característica, así que no te pierdas las próximas mejoras que publicaremos también en nuestro blog.

Mucho ánimo a todos en nuestra comunidad, y como siempre les decimos… ¡larga vida a KumbiaPHP!

¡Un abrazo!

La entrada Mejora en la configuración de errores en KumbiaPHP: Nueva funcionalidad Exception para entornos de producción se publicó primero en KumbiaPHP Framework PHP en español.

KumbiaPHP 1.2 optimizado para PHP 8: Adopción total y ventajas

Una de las principales novedades de KumbiaPHP 1.2 es su completa compatibilidad con PHP 8. Si ya estás utilizando PHP 8 o tienes planes de actualizarte pronto, esta versión de KumbiaPHP es esencial para ti. PHP 8 introduce una serie de mejoras y nuevas características que permiten escribir código más limpio, eficiente y moderno. Al adoptar estas innovaciones, hemos optimizado el núcleo de KumbiaPHP, logrando una reducción significativa en las líneas de código.

Un núcleo más ligero y rápido

Gracias a las nuevas características de PHP 8, hemos logrado simplificar y reducir el núcleo de KumbiaPHP. Esto se traduce en menos líneas de código, y lo convierte en un framework aún más rápido y eficiente. Menos código significa menos posibilidades de errores y un rendimiento mejorado, lo cual es crucial para el desarrollo de aplicaciones modernas y escalables.

Todo funciona igual, pero de forma más eficiente

Sabemos lo importante que es la estabilidad y la compatibilidad para nuestros usuarios. Por eso, aunque hemos realizado cambios significativos en el núcleo, el funcionamiento general de KumbiaPHP sigue siendo el mismo. Puedes actualizar a la versión 1.2 con la confianza de que tu aplicación continuará funcionando como antes, pero con las mejoras en rendimiento y eficiencia que PHP 8 ofrece.

Futuras actualizaciones y nuevas librerías

La versión 1.2 de KumbiaPHP es sólo el comienzo. En las próximas versiones menores, continuaremos aprovechando las ventajas de PHP 8, incorporando nuevas librerías y actualizaciones que enriquecerán nuestro framework. Estamos comprometidos en mantener a KumbiaPHP a la vanguardia de la tecnología, proporcionando a nuestros usuarios las herramientas necesarias para desarrollar aplicaciones robustas y eficientes.

Recomendación adicional

Dado que PHP 8.0 cumplió su ciclo de vida, sería recomendable ir adaptándose a las versiones más modernas que actualmente tienen soporte activo como la 8.2 y 8.3.

¿Por qué actualizar a KumbiaPHP 1.2?

• Compatibilidad Total con PHP 8: Aprovecha todas las mejoras y nuevas características de PHP 8.
• Menos Código, Más Eficiencia: Un núcleo más ligero que mejora el rendimiento de tu aplicación.
• Estabilidad Garantizada: Continúa desarrollando con la tranquilidad de que todo funciona igual.
• Futuras Mejoras: Nuevas librerías y actualizaciones que seguirán optimizando tu experiencia de desarrollo.

¡Actualiza hoy mismo a KumbiaPHP 1.2 optimizado para PHP 8 y lleva tu desarrollo al siguiente nivel!

La entrada KumbiaPHP 1.2 optimizado para PHP 8: código simplificado y mayor velocidad se publicó primero en KumbiaPHP Framework PHP en español.

La entrada Compartir el core para diferentes aplicaciones se publicó primero en KumbiaPHP Framework PHP en español.

Instalación de KumbiaPHP usando XAMPP en Windows

El segundo video trata sobre la…

Configuración de virtual host en Apache para usarlo con KumbiaPHP

La entrada Instalación de XAMPP y configuración de VirtualHost se publicó primero en KumbiaPHP Framework PHP en español.

Tendremos un servidor local de PHP perfecto para desarrollo, sin usar WAMP o XAMPP server.

Antes de comenzar, te dejamos un enlace donde se explican las implicancias del WSL (Windows Subsystem for Linux) https://es.wikipedia.org/wiki/Windows_Subsystem_for_Linux

Vamos con los requisitos. Lo primero que necesitamos es habilitar la caracterísca de Subsistema Linux desde Windows.

Instalar WSL en Windows 10

Para ello hacemos clic en inicio y escribimos <em>Características de Windows</em> (en mi caso se verá diferente porque llevo una versión de Windows en inglés)

Luego buscaremos al final de la lista el Subsistema Linux para Windows (ver imagen siguiente)

Lo seleccionamos haciendo clic en la casilla de la izquierda, y finalizamos picando en el botón OK para que los cambios sean aplicados.

Tendremos que reiniciar para que la configuración se vea actualizada.

Seleccionar la distribución de Linux en la Tienda de Microsoft

Una vez hecho eso, iniciaremos a la aplicación Tienda de Microsoft (Microsoft Store) y usando su buscador, escribiremos la palabra linux.

La lista de opciones es variada pues se cuenta con Ubuntu, Kali, Debian, OpenSuse, entre otros. Para cuestiones de demostración he seleccionado la opción Debian (aunque en otra máquina lo he probado con Ubuntu 18.04).

Bastará con seleccionar la opción de vuestro gusto, y luego presionar el botón Obtener (Get en mi caso)

Puede que el instalador te pregunte, si quieres mantener sincronizadas tus máquinas de acuerdo a tu cuenta. En mi caso, prefiero que sólo sea instalado en esta máquina, sin importar la sincronización posterior (para ello te requerirá iniciar sesión con una cuenta de Windows Live – Hotmail, Outlook u otra)

En este diálogo he seleccionado «No, gracias». Luego de la respuesta, ha comenzado el proceso de instalación.

Crear usuario y contraseña de la consola de linux

Cuando la configuración de la consola linux haya finalizado, nos pedirá crear un usuario con nombre y contraseña.

Noten que el nombre de usuario de la consola, no tiene por qué coincidir con el nombre de usuario de la máquina de Windows. Una vez creado el usuario habremos finalizado la instalación de la consola de Linux!

Entonces ya tenemos nuestra estación Linux completamente funcional. 

Actualizar paquetes de Linux

En los derivados de Debian (como Ubuntu y Kali) les recomiendo comenzar ejecutando el comando:

<span class="token function">sudo</span> <span class="token function">apt-get</span> update

Con ello cargarás los repositorios de paquetes que podrás usar posteriormente.

Instalar PHP y MariaDB (MySql) en la consola Linux de Windows

Para usar Debian y derivados, con los requerimientos mínimos de desarrollo kumbiero necesitamos hacer la siguiente instalación

<span class="token function">sudo</span> <span class="token function">apt-get</span> <span class="token function">install</span> php php-cli php-mysql mariadb-server php-mbstring <span class="token function">git</span> <span class="token function">wget</span> unzip

Instalar KumbiaPHP framework

Una vez que hemos finalizado la instalación, podemos hacer una prueba descargando la versión de KumbiaPHP desde la página principal del proyecto

Lo hacemos desde el icono de descarga para el formato tar. Hacemos clic con el botón secundario (normalmente el derecho) y copiamos el link desde el botón Copiar enlace (Copy link)

Luego desde la consola escribimos wget y pegamos lo que tenemos en el portapaleles. Deberíamos lograr una línea de ejecución como la siguiente:

<span class="token function">wget</span> https://github.com/KumbiaPHP/KumbiaPHP/archive/v1.0.0.tar.gz

Descomprimimos la descarga:

<span class="token function">tar</span> xvfz v1.0.0.tar.gz

Y renombramos la carpeta resultante con un nombre que tenga relación con el trabajo que llevaremos a cabo (usando el comando mv)

Finalizamos la prueba de instalación entrando en la carpeta que hemos creado hasta llegar a <strong>default/app</strong>

Servidor PHP local

Sin instalar Apache o Nginx,  escribiendo el comando:

bin/phpserver

Windows nos preguntará, si acaso queremos permitir conexiones desde redes internas o desde fuera de la red. Para efectos de prueba he seleccionado ambas opciones y he presionado el botón «Permitir acceso» (Allow access)

Entonces, nuestra aplicación recién instalada de KumbiaPHP estará disponible desde la dirección http://0.0.0.0:8001. En caso que no resulte también puedes invocarla usando la url de http://localhost:8001, o usando http://127.0.0.1:8001, o incluso la dirección ip interna de tu máquina como por ejemplo http://192.168.1.101:8001. Esta última opción nos servirá para hacer pruebas desde otros dispositivos conectados a la misma red (por ejemplo desde un tablet, o un móvil)

Permisos de la base de datos (Mysql, MariaDB, Postresql, otros)

Un dato final, es si usamos MySQL o MariaDB o Postgresql, Windows nos preguntará si queremos dar acceso a dichos servicios, tal como ha hecho cuando hemos lanzado <strong>bin/phpserver</strong>. En dicho caso sólo les recomiendo habilitar el uso en el equipo y la red local. No para el exterior. Aunque esta es una decisión que debe tomar cada uno.

¿Y qué hemos ganado con lanzar KumbiaPHP con el comando bin/phpserver?

Pues la ventana en la que lo hemos lanzado, se ha convertido en una ventana de log de utilización, por la que veremos cada una de las acciones que realice el framework mientras estamos trabajando con él

Y lo más importante, también veremos los errores al instante, para depurar más rápidamente nuestas aplicaciones.

Y hasta aquí nuestra publicación :-)

Esperamos que les sea de utilidad y que con ello tengan nuevas opciones de disfrutar programando con el framework más rápido del oeste!

Saludos a todos nuestros colegas kumbieros!

Post data: si eres nuevo por aquí te recomendamos ver algunos de nuestros posts para los recién llegados:

KumbiaPHP essentials

Scaffolding con KumbiaPHP

Dicho esto,

Larga vida a KumbiaPHP!

La entrada Servidor PHP desde la consola Linux de Windows se publicó primero en KumbiaPHP Framework PHP en español.

Para el software de gestión tumia.co hemos desarrollado más de 30 módulos, creado un API REST y también un APP para Android y para iOS.

Ha sido un trabajo largo, llevamos 5 años en este proyecto y nos apoyamos en Kumbiaphp como se indica en el post que publicamos

Antes de tumia.co …

Antes de crear tumia.co desarrollamos varios sistemas de CRM, de comercio electrónico, de historia clínica, entre otros y eso nos sirvió para ver lo tedioso, complejo y costoso que resulta hacer un software sin un buen framework y sin una buena comunidad que lo respalde.

Crear otros sistemas fue fácil, pero dar soporte, actualizar, mejorar y agregar nuevos módulos era un dolor de cabeza (en ese tiempo).

Mediante Kumbiaphp resolvimos ese asunto, luego de aprender a usar el framework en poco tiempo, creamos una plataforma llamada Recaudo Efectivo con la cual atendíamos la facturación electronica de los clientes, poco a poco fue creciendo, pero a diferencia de los proyectos anteriores, con Kumbiaphp dar mantenimiento, realizar mejoras y agregar nuevos módulos no fue un dolor de cabeza, todo lo contrario.

Con Kumbiaphp crear nuevos módulos y dar soporte es todo un placer.

Equipo de desarrollo de tumia.co

Durante casi 5 años hemos depurado nuestro sistema, en ocaciones no usamos patrones de diseño y nos desviamos, pero retomar el buen camino con el framework y el apoyo de la comunidad resulto en algo muy sencillo.

Las actualizaciones del framework

Posteriormente actualizar la version de PHP y adoptar las nuevas características del framework en nuestro sistema no fue nada complejo y es algo que nos gusto muchísimo, pues con otros framewoks suele ser un problema.

Actualizando Kumbiaphp no hemos tenido problema, siempre ha resultado fácil y nos beneficiamos de las nuevas características.

Equipo de desarrollo de tumia.co

Al momento de crear la APP android vimos la necesidad de crear una buena API para nuestro sistema y así compartir información con otros dispositivos; En esto nos sorprendió mucho Kumbiaphp, pues con el Rest Controller todo es super super fácil.

El rest controller junto con el Active records hace un equipo ganador… realmente veloz como lo indica el benchmark y para desarrollar nuevas funcionalidades resulta muy fácil y nada preocupante.

Capturas de pantalla de tumia.co

Dejamos unas pocas, pues el sistema es bastante extenso

Disfrutamos mucho en el desarrollo de tumia.co tenemos muchos módulos para desarrollar y otros para actualizar.

Con la evolución de Javascript y los frameworks JS, gran parte de nuestro sistema se esta apoyando también en vueJS, pero sin dejar a un lado a Kumbiaphp pues nos continua brindando una excelente API REST.

Agradecemos a la comunidad Kumbiaphp en Slack y buscamos el tiempo para apoyar este excelente proyecto http://slack.kumbiaphp.com/

Muy contentos animamos a los emprendedores a conocer y beneficiarse de todo lo que ofrece Kumbiaphp Framework.

La entrada Tumia.co Nuestra experiencia se publicó primero en KumbiaPHP Framework PHP en español.