Herramientas Informaticas

Etiqueta: PHP Página 1 de 9

Cómo usar Composer con symlinks para desarrollo local en CodeIgniter 4

Entrada fija

Cuando trabajas con múltiples paquetes en PHP (como módulos propios), llega un punto donde necesitas debuggear directamente el código del paquete y no una copia dentro de vendor.

Si alguna vez terminaste debuggeando en vendor/ en lugar de tu proyecto real… esto es para ti.


🔥 El problema

Por defecto, Composer:

  • Descarga paquetes desde GitHub
  • Los copia en vendor/
  • Xdebug trabaja sobre esa copia

Resultado:

  • Código duplicado
  • Cambios no se reflejan
  • Debug incómodo

🧠 La solución: usar type: path

{
  "repositories": [
    {
      "type": "path",
      "url": "../boilerplateproducts",
      "options": {
        "symlink": true
      }
    }
  ]
}

⚙️ ¿Qué hace esto?

  • Usa tu carpeta local
  • No descarga desde GitHub
  • Crea un symlink en vendor

🔍 Verificar que funciona

composer update

Debes ver:

Installing julio101290/boilerplateproducts: Symlinking from ../boilerplateproducts

Y luego:

ls -l vendor/julio101290/boilerplateproducts

Resultado esperado:

boilerplateproducts -> ../../../boilerplateproducts

🚀 Beneficios

  • Debug directo en tu código
  • Cambios en tiempo real
  • Sin duplicación
  • Flujo más rápido

⚠️ Error común

No mezcles path y vcs:

{
  "type": "path",
  "url": "../boilerplateproducts"
},
{
  "type": "vcs",
  "url": "https://github.com/usuario/boilerplateproducts"
}

Composer puede ignorar el local y usar GitHub.


✅ Desarrollo correcto

rm -rf vendor composer.lock
composer update

🟢 Desarrollo vs Producción

Desarrollo

  • path
  • symlink
  • debug directo

Producción

  • vcs
  • descarga desde GitHub
  • entorno limpio

⚡ Scripts útiles

dev.sh

#!/bin/bash
rm -rf vendor composer.lock
COMPOSER=composer.local.json composer update

prod.sh

#!/bin/bash
rm -rf vendor composer.lock
composer update

🧠 Tip PRO

{
  "repositories": [
    {
      "type": "path",
      "url": "../boilerplateproducts",
      "options": { "symlink": true }
    }
  ],
  "config": {
    "preferred-install": "source"
  }
}

Ejecutar:

COMPOSER=composer.local.json composer update

💡 IDE

Puedes integrar esto con NetBeans usando scripts o herramientas externas.


✅ Conclusión

  • No debuggees código en vendor
  • Usa symlink
  • Automatiza tu flujo

Resultado: desarrollo más rápido y limpio 🚀

🔧 Arquitectura híbrida con Composer + Git: desarrollo profesional de módulos en CodeIgniter 4

Entrada fija

En el desarrollo moderno de aplicaciones PHP con CodeIgniter 4, uno de los mayores retos es mantener un flujo de trabajo eficiente entre desarrollo local, control de versiones y gestión de dependencias.

Este artículo explica una arquitectura híbrida usando Composer + Git + symlinks que permite trabajar módulos de forma profesional sin depender del directorio vendor.


🧠 El problema clásico

Cuando trabajamos con módulos reutilizables (inventarios, CFDI, pagos, etc.), normalmente terminamos instalando todo en vendor/, lo que genera problemas:

  • No se puede editar código fácilmente
  • Debug complicado
  • Cambios se pierden con composer update
  • Duplicación de código
  • Dificultad para mantener múltiples proyectos

💡 La solución: arquitectura híbrida

La solución moderna combina tres herramientas:

  • Composer como gestor de dependencias
  • Git como control de versiones
  • Symlinks para desarrollo en vivo

Estructura típica:

~/fuentes/
   ci4-project/
   boilerplateInventory/
   boilerplateProducts/

⚙️ Configuración en Composer

En el composer.json del proyecto principal:

"repositories": [
  {
    "type": "path",
    "url": "../boilerplateInventory",
    "options": {
      "symlink": true
    }
  },
  {
    "type": "vcs",
    "url": "https://github.com/julio101290/boilerplateInventory"
  }
]

📁 Path repository (desarrollo local)

Este tipo de repositorio indica a Composer que use una carpeta local en lugar de descargar el paquete.

Beneficios:

  • Cambios en tiempo real
  • Debug directo
  • No depende de vendor

🌐 VCS repository (GitHub)

Sirve como respaldo cuando el path no existe o en servidores de producción.


🔥 El problema de versiones

Muchos módulos requieren:

^1.0.0

Pero en desarrollo usamos:

dev-main

Esto genera conflictos.


🛠️ Solución: alias de versión

La solución correcta es:

"julio101290/boilerplateinventory": "dev-main as 1.2.6"

Esto le dice a Composer que trate el código local como versión estable.


⚡ Resultado del sistema

  • ✔ Desarrollo en vivo
  • ✔ Debug funcional
  • ✔ Compatibilidad con dependencias
  • ✔ Sin tocar vendor
  • ✔ Respaldo en GitHub

🧪 Flujo de trabajo real

cd ~/fuentes/boilerplateInventory
git add .
git commit -m "cambios"
git push

Los cambios se reflejan automáticamente en el proyecto principal.


⚠️ Buenas prácticas

  • Usar nombres consistentes en minúsculas
  • No trabajar dentro de vendor
  • Versionar módulos con tags
git tag v1.2.6
git push origin v1.2.6

🚀 Conclusión

Esta arquitectura permite construir sistemas modulares profesionales con:

  • Desarrollo rápido
  • Debug en vivo
  • Control de versiones limpio
  • Escalabilidad real

Es una forma moderna de trabajar con Composer sin depender de vendor como entorno de desarrollo.

🔥 Cómo configurar ONLYOFFICE en Docker con SSL y Nextcloud Snap (guía práctica sin errores) 🔥

Entrada fija

Después de varios intentos y errores típicos (puertos, certificados, Docker, etc.), finalmente logré dejar funcionando ONLYOFFICE Document Server en Docker con acceso HTTPS y listo para integrarse con Nextcloud instalado vía Snap. Aquí te dejo el proceso completo con datos genéricos 👇


🚧 Problemas comunes

  • Error de conexión (connection refused o connection reset)
  • Certificados SSL no detectados
  • Confusión entre Apache, Nginx y Docker
  • Intentar usar HTTPS dentro del contenedor (mala idea 😅)

🧠 Lo importante que debes entender

  • ONLYOFFICE usa Nginx interno, no Apache
  • Docker debe correr en HTTP interno
  • El SSL se maneja mejor fuera del contenedor
  • Nextcloud Snap ya trae su propio Apache (aislado)

👉 La solución correcta: usar Apache HTTP Server del sistema como proxy inverso


⚙️ Configuración final

🐳 1. Ejecutar ONLYOFFICE en HTTP

docker run -d -p 8080:80 onlyoffice/documentserver

🔐 2. Generar certificado SSL con Certbot

sudo snap stop nextcloud
sudo certbot certonly --standalone -d tudominio.com
sudo snap start nextcloud

👉 Los certificados quedarán en algo como:

/etc/letsencrypt/live/tudominio.com-0001/

🌐 3. Configurar Apache como proxy SSL

Archivo:

/etc/apache2/sites-available/onlyoffice.conf

Contenido:

<VirtualHost *:4443>
    ServerName tudominio.com

    SSLEngine on
    SSLCertificateFile /etc/letsencrypt/live/tudominio.com-0001/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/tudominio.com-0001/privkey.pem

    ProxyPreserveHost On
    ProxyPass / http://localhost:8080/
    ProxyPassReverse / http://localhost:8080/

    RequestHeader set X-Forwarded-Proto "https"
</VirtualHost>

🔌 4. Habilitar el puerto en Apache

Editar:

/etc/apache2/ports.conf

Agregar:

Listen 4443

⚡ 5. Activar módulos necesarios

sudo a2enmod ssl proxy proxy_http headers

🚀 6. Activar sitio y reiniciar

sudo a2ensite onlyoffice.conf
sudo apachectl configtest
sudo systemctl restart apache2

🔥 7. Abrir firewall

sudo ufw allow 4443

✅ Resultado

Acceso funcionando en:

👉 https://tudominio.com:4443

✔ SSL válido
✔ Proxy funcionando
✔ Docker respondiendo correctamente
✔ Listo para integrarse con Nextcloud


🧪 Pruebas clave

curl http://localhost:8080/healthcheck   # → true
curl -k https://localhost:4443           # → 302 (correcto)

🧠 Conclusión

  • ❌ No uses SSL dentro de Docker
  • ✅ Usa proxy inverso en el host
  • ✅ Mantén servicios separados
  • ✅ Evita conflictos con Snap

🚀 Siguiente paso

Integrar ONLYOFFICE con Nextcloud usando JWT correctamente 🔐


Si estás montando tu propio entorno, esta arquitectura te va a ahorrar horas de debugging 💻🔥

Apóyame

Si esta guía te fue útil y quieres apoyar más contenido como este:

👉 https://www.patreon.com/u74078772?

Cómo instalar OnlyOffice en Nextcloud (instalado con Snap) – Guía completa

Entrada fija

Si ya tienes Nextcloud instalado con Snap, el siguiente paso lógico es convertirlo en una suite completa tipo Google Workspace. Para eso, puedes integrar OnlyOffice, una poderosa herramienta que permite editar documentos Word, Excel y PowerPoint directamente desde tu nube.


¿Qué es OnlyOffice?

OnlyOffice es una suite ofimática online que se integra perfectamente con Nextcloud, permitiendo editar documentos en tiempo real, colaborar con otros usuarios y mantener compatibilidad con formatos de Microsoft Office.

  • 📝 Editor de documentos (Word)
  • 📊 Hojas de cálculo (Excel)
  • 📽️ Presentaciones (PowerPoint)
  • 👥 Edición colaborativa en tiempo real

Requisitos

  • Nextcloud instalado vía Snap
  • Servidor Ubuntu (recomendado 2GB RAM mínimo)
  • Acceso SSH con sudo

Instalar OnlyOffice Document Server con Docker

1. Instalar Docker


sudo apt update
sudo apt install docker.io -y
sudo systemctl enable --now docker
  

2. Ejecutar OnlyOffice


sudo docker run -i -t -d -p 8080:80 \
--restart=always \
onlyoffice/documentserver
  

Esto levantará OnlyOffice en:

http://TU_IP:8080

Instalar la aplicación en Nextcloud

  1. Entra a tu panel de Nextcloud
  2. Ve a Apps (Aplicaciones)
  3. Busca: ONLYOFFICE
  4. Instala ONLYOFFICE Docs

Configurar conexión con OnlyOffice

Ve a:

Configuración → Administración → ONLYOFFICE

En “Document Editing Service”, coloca:

http://TU_IP:8080

Configurar seguridad con JWT (recomendado)

Para mayor seguridad, puedes activar autenticación JWT.


sudo docker stop $(sudo docker ps -q)

sudo docker run -i -t -d -p 8080:80 \
-e JWT_ENABLED=true \
-e JWT_SECRET=mi_clave_super_segura \
--restart=always \
onlyoffice/documentserver
  

Luego en Nextcloud:

  • Activa JWT
  • Introduce la misma clave

Solución de problemas (Nextcloud Snap)

Si Nextcloud no se conecta correctamente:


sudo snap set nextcloud ports.http=80
sudo snap set nextcloud ports.https=443
sudo ufw allow 8080
  

Recomendaciones

  • 🔒 Usa HTTPS (Let’s Encrypt)
  • ⚡ Usa mínimo 2GB de RAM
  • 🌐 Configura dominio si lo usarás fuera de red local
  • 📦 Usa Docker para mayor estabilidad

Conclusión

Integrar OnlyOffice con Nextcloud transforma tu servidor en una plataforma completa de productividad, similar a Google Drive o Microsoft 365, pero con control total sobre tus datos.


Apóyame

Si esta guía te fue útil y quieres apoyar más contenido como este:

👉 https://www.patreon.com/u74078772?

Cómo instalar Nextcloud en Ubuntu Server 24.04 (Guía completa + Script automático)

Entrada fija

Si quieres tener tu propia nube privada tipo Google Drive o Dropbox, Nextcloud es una de las mejores opciones. En esta guía te mostraré cómo instalarlo en Ubuntu Server 24.04 de forma sencilla, incluyendo un script automático que hace casi todo por ti.


¿Qué es Nextcloud?

Nextcloud es una plataforma de almacenamiento en la nube de código abierto que te permite guardar archivos, sincronizarlos entre dispositivos, compartirlos y mucho más, todo en tu propio servidor.

  • 📁 Almacenamiento privado
  • 🔄 Sincronización de archivos
  • 🔐 Control total de tus datos
  • 👥 Compartir archivos fácilmente

Requisitos

  • Servidor con Ubuntu Server 24.04
  • Acceso SSH con permisos sudo
  • Conexión a internet

Instalación automática (Script)

Para facilitar todo el proceso, puedes usar el siguiente script que instala Apache, PHP, MariaDB y Nextcloud automáticamente.


#!/bin/bash

# ==========================================
# Instalador automático de Nextcloud
# Ubuntu Server 24.04
# Adaptado por julio101290
# ==========================================

set -e

DB_NAME="nextcloud"
DB_USER="ncuser"
DB_PASS="ncpassword123"
NC_DIR="/var/www/nextcloud"

echo "🔄 Actualizando sistema..."
sudo apt update && sudo apt upgrade -y

echo "🌐 Instalando Apache..."
sudo apt install apache2 -y

echo "🐘 Instalando PHP y extensiones..."
sudo apt install -y php php-cli php-common php-mysql php-zip php-gd php-mbstring php-curl php-xml php-bcmath php-intl php-imagick php-gmp libapache2-mod-php

echo "🗄️ Instalando MariaDB..."
sudo apt install mariadb-server -y

echo "🔐 Configurando base de datos..."
sudo mysql -e "CREATE DATABASE ${DB_NAME};"
sudo mysql -e "CREATE USER '${DB_USER}'@'localhost' IDENTIFIED BY '${DB_PASS}';"
sudo mysql -e "GRANT ALL PRIVILEGES ON ${DB_NAME}.* TO '${DB_USER}'@'localhost';"
sudo mysql -e "FLUSH PRIVILEGES;"

echo "⬇️ Descargando Nextcloud..."
cd /var/www/
sudo wget https://download.nextcloud.com/server/releases/latest.zip
sudo apt install unzip -y
sudo unzip latest.zip
sudo chown -R www-data:www-data nextcloud
sudo chmod -R 755 nextcloud

echo "⚙️ Configurando Apache..."
sudo bash -c 'cat > /etc/apache2/sites-available/nextcloud.conf <<EOF
&lt;VirtualHost *:80&gt;
    ServerName localhost
    DocumentRoot /var/www/nextcloud

    &lt;Directory /var/www/nextcloud/&gt;
        Require all granted
        AllowOverride All
        Options FollowSymLinks MultiViews
    &lt;/Directory&gt;

    ErrorLog \${APACHE_LOG_DIR}/nextcloud_error.log
    CustomLog \${APACHE_LOG_DIR}/nextcloud_access.log combined
&lt;/VirtualHost&gt;
EOF'

sudo a2ensite nextcloud.conf
sudo a2enmod rewrite headers env dir mime
sudo systemctl restart apache2

echo "🧹 Limpiando..."
sudo rm latest.zip

IP=$(hostname -I | awk '{print $1}')

echo "========================================="
echo "✅ INSTALACIÓN COMPLETA"
echo "========================================="
echo "🌐 Accede en tu navegador:"
echo "http://$IP"
echo ""
echo "📌 Base de datos:"
echo "DB: $DB_NAME"
echo "Usuario: $DB_USER"
echo "Password: $DB_PASS"
echo "Host: localhost"
echo ""
echo "⚠️ IMPORTANTE: Completa la instalación en el navegador"
echo "========================================="
  

Cómo ejecutar el script

  1. Crear el archivo: nano install_nextcloud.sh
  2. Pegar el script y guardar
  3. Dar permisos: chmod +x install_nextcloud.sh
  4. Ejecutar: ./install_nextcloud.sh

Acceso a Nextcloud

Una vez terminado, abre tu navegador y entra a:

http://TU_IP

Desde ahí podrás crear el usuario administrador y conectar la base de datos.


Recomendaciones de seguridad

  • 🔐 Cambiar la contraseña de la base de datos
  • 🔒 Activar HTTPS con Let’s Encrypt
  • 🧱 Configurar firewall (UFW)
  • 💾 Hacer backups regularmente

Conclusión

Con este método puedes tener tu propia nube privada funcionando en pocos minutos. Es ideal para uso personal o incluso para pequeñas empresas que quieran tener control total sobre sus datos.


Apóyame

Si esta guía te fue útil y quieres apoyar más contenido como este, puedes hacerlo aquí:

👉 https://www.patreon.com/u74078772?

🔐 Control de accesos a Saldos por Almacén — Código y guía práctica

Entrada fija

Resumen: implementación limpia y los bloques de código bien acomodados para que en la vista de saldos solo se muestren los productos/lotes de los almacenes a los que el usuario tiene permiso.


🧾 1) Controller — Preparar empresas y almacenes del usuario

Este bloque es el handler principal (método index()). Se encarga de:

  • Recuperar empresas asociadas al usuario
  • Recuperar almacenes activos asignados al usuario
  • Construir el builder via mdlGetSaldos y preparar respuesta para DataTables (draw/records/paginación)
// Controller: index()
public function index() {
    helper('auth');

    // 1) Obtener usuario
    $idUser = user()->id;

    // 2) Empresas del usuario (fallback a [0] si no tiene)
    $titulos["empresas"] = $this->empresa->mdlEmpresasPorUsuario($idUser);
    $empresasID = count($titulos["empresas"]) === 0 ? [0] : array_column($titulos["empresas"], "id");

    // 3) Almacenes (storages) asignados al usuario y activos (status = 'on')
    $storagesUser = $this->storagesPerUser
                    ->where("idUsuario", $idUser)
                    ->where("status", "on")
                    ->asArray()
                    ->findAll();

    $storagesUser = count($storagesUser) === 0 ? [0] : array_column($storagesUser, "idStorage");

    // 4) Si es petición AJAX (DataTables) devolvemos JSON paginado
    if ($this->request->isAJAX()) {
        $request = service('request');

        $draw = (int) $request->getGet('draw');
        $start = (int) $request->getGet('start');
        $length = (int) $request->getGet('length');
        $searchValue = $request->getGet('search')['value'] ?? '';
        $orderColumnIndex = (int) ($request->getGet('order')[0]['column'] ?? 0);
        $orderDir = $request->getGet('order')[0]['dir'] ?? 'asc';

        // Mapeo de columnas (orden)
        $fields = [
            'id' => 'a.id',
            'nombreAlmacen' => 'c.name',
            'lote' => 'a.lote',
            'codigoProducto' => 'a.codigoProducto',
            'descripcion' => 'a.descripcion',
            'fullname' => 'e.fullname'
        ];
        $orderField = $fields[$orderColumnIndex] ?? 'id';

        // Builder desde el modelo con filtros de empresas y almacenes
        $builder = $this->saldos->mdlGetSaldos($empresasID, $storagesUser);

        // Conteo total (sin filtros de búsqueda)
        $total = clone $builder;
        $recordsTotal = $total->countAllResults(false);

        // Filtro de búsqueda global
        if (!empty($searchValue)) {
            $builder->groupStart();
            foreach ($fields as $field) {
                $builder->orLike($field, $searchValue);
            }
            $builder->groupEnd();
        }

        // Conteo filtrado
        $filteredBuilder = clone $builder;
        $recordsFiltered = $filteredBuilder->countAllResults(false);

        // Obtener página
        $data = $builder->orderBy("a." . $orderField, $orderDir)
                ->get($length, $start)
                ->getResultArray();

        // Respuesta JSON para DataTables
        return $this->response->setJSON([
            'draw' => $draw,
            'recordsTotal' => $recordsTotal,
            'recordsFiltered' => $recordsFiltered,
            'data' => $data,
        ]);
    }

    // Vista normal (no-AJAX)
    $titulos["title"] = "Info Productos";
    $titulos["subtitle"] = "Extrae la información de los productos por el código de barras";
    return view('julio101290\\boilerplateinventory\\Views\\saldos', $titulos);
}

🧱 2) Modelo — Builder con filtros por empresa y almacén

Este método devuelve un Query Builder ya filtrado por $idEmpresas y $storagesUser. Úsalo tal cual en el controller.

public function mdlGetSaldos($idEmpresas, $storagesUser) {
    return $this->db->table('saldos a')
        ->select("
            a.id,
            a.idEmpresa,
            a.idAlmacen,
            a.idProducto,
            a.codigoProducto,
            a.lote,
            a.descripcion,
            a.cantidad,
            a.created_at,
            a.deleted_at,
            a.updated_at,
            b.nombre AS nombreEmpresa,
            c.name AS nombreAlmacen,
            COALESCE(e.fullname, 'Sin asignar') AS fullname
        ")
        // JOINs para mostrar nombres legibles
        ->join('empresas b', 'a.idEmpresa = b.id')
        ->join('storages c', 'a.idAlmacen = c.id')
        // LEFT JOINs para evitar romper si no hay relación
        ->join('productsemployes pe', 'pe.idProduct = a.id', 'left')
        ->join('employes e', 'e.id = pe.idEmploye', 'left')
        // filtros de permisos: solo empresas/almacenes permitidos
        ->whereIn('a.idEmpresa', $idEmpresas)
        ->whereIn('a.idAlmacen', $storagesUser)
        ->orderBy('a.id', 'DESC');
}

🛠️ 3) Notas técnicas y buenas prácticas aplicadas

  • Back-end es la fuente de verdad: los arrays de IDs ($empresasID y $storagesUser) se construyen en el servidor a partir de user()->id. Nunca confíes en listas enviadas por cliente.
  • Fallback seguro: usar [0] cuando no hay empresas/almacenes evita que whereIn reciba un array vacío y genere errores SQL. En ese caso la consulta devuelve resultados vacíos.
  • LEFT JOINs: mantuvimos LEFT JOIN en relaciones opcionales para que la consulta no falle si no hay datos relacionados (por ejemplo, empleado no asignado).
  • Clonar builder: clonar el builder para conteo (countAllResults(false)) mantiene el flujo de DataTables sin re-ejecutar joins innecesarios.

🔍 4) Sugerencias de índices SQL (para rendimiento)

Recomiendo agregar índices (si no existen) para acelerar filtros y joins:

-- Índices recomendados
CREATE INDEX idx_saldos_idEmpresa ON saldos (idEmpresa);
CREATE INDEX idx_saldos_idAlmacen ON saldos (idAlmacen);
CREATE INDEX idx_saldos_codigoProducto ON saldos (codigoProducto);
CREATE INDEX idx_saldos_lote ON saldos (lote);
-- Índices en tablas relacionadas
CREATE INDEX idx_storages_id ON storages (id);
CREATE INDEX idx_empresas_id ON empresas (id);

Si usas PostgreSQL, considera índices compuestos o índices GIN si aplicarás búsquedas textuales complejas.


🧪 5) Pruebas recomendadas (QA) — pasos concretos

  1. Usuario sin almacenes: Inicia sesión con un usuario sin almacenes asignados. La tabla debe venir vacía. Ver el mensaje UX (ver sección UX abajo).
  2. Usuario con 1 almacén: Inicia sesión con acceso a un solo almacén; la vista debe mostrar únicamente los saldos de ese almacén.
  3. Usuario con múltiples almacenes: Comprueba que aparecen filas de cualquiera de esos almacenes, y que no aparecen filas de almacenes no asignados.
  4. Busqueda global: Ejecuta una búsqueda por codigoProducto, lote o descripcion y valida que los resultados respetan el filtro por almacén.
  5. Paginación y orden: Revisa recordsTotal y recordsFiltered cuando aplicas orden y búsqueda; deben reflejar correctamente la cantidad total y la cantidad filtrada.
  6. Seguridad: Intenta manipular parámetros GET/POST desde el cliente (por ejemplo, forzar otro idAlmacen) y verifica que no se muestran saldos si el usuario no tiene permiso.

💬 6) Mensajes UX sugeridos

Si el usuario no tiene almacenes asignados, muestra un mensaje amigable y accionable en la UI (evita pantalla en blanco):

&lt;div class="alert alert-info"&gt;
  &lt;strong&gt;Sin almacén asignado&lt;/strong&gt;&lt;br&gt;
  No tienes almacenes asignados. Contacta al administrador para que te asigne los permisos necesarios.
&lt;/div&gt;

🔐 7) Seguridad y consideraciones adicionales

  • Recalcula permisos siempre en servidor: no aceptes listas desde cliente.
  • Validar status: al desactivar un permiso (status != ‘on’), asegúrate que en la siguiente petición el usuario deje de ver los datos correspondientes.
  • Auditoría: opcionalmente loguea consultas sensibles (quién vio qué y cuándo) para trazabilidad.

📦 8) Release & commit (referencia)

Los cambios fueron incluidos en el release v1.2.3 y el commit con la implementación es este:

Release v1.2.3Commit d8ad77ad

Repositorio: https://github.com/julio101290/boilerplateInventory


📋 9) Checklist de despliegue

  • ✅ Probar en staging con usuarios de distintos permisos
  • ✅ Verificar índices y tiempos de respuesta
  • ✅ Añadir pruebas unitarias/integración que verifiquen permisos
  • ✅ Revisar logs de auditoría tras deploy

🚀 Generador Automático de CRUD para CodeIgniter 4: Crea Módulos Completos en 1 Minuto 🔥

Entrada fija





Generador Automático de CRUD para CodeIgniter 4 – julio101290/boilerplate

🚀 Generador Automático de CRUD para CodeIgniter 4: Crea Módulos Completos en 1 Minuto 🔥

¿Cansado de escribir el mismo código una y otra vez? ¿Tus proyectos se retrasan por la tediosa creación de modelos, controladores y vistas? ¡Tenemos la solución! Te presento el Generador Automático de CRUD para CodeIgniter 4, una herramienta integrada en mi boilerplate que transforma una tabla de base de datos en un módulo funcional, seguro y profesional en menos de 60 segundos. Ahorra cientos de horas y olvídate de los errores repetitivos.


📌 Índice


🎯 ¿Qué es este generador?

Es un controlador inteligente que, a partir del nombre de una tabla existente en tu base de datos, genera de forma automática todos los archivos necesarios para un CRUD completo:

  • ✅ Modelo con validaciones y soft delete
  • ✅ Controlador con DataTables server-side
  • ✅ Vistas (listado + modal) integradas con AdminLTE
  • ✅ Archivos de idioma (inglés y español)
  • ✅ Migración lista para ejecutar
  • ✅ Rutas listas para copiar o integradas en tu paquete
  • ✅ Permisos creados automáticamente (RBAC)

Todo esto con código limpio, indentado y siguiendo las mejores prácticas.

💡 Dato curioso: El generador lee la estructura de tu tabla y adapta los campos automáticamente. Si tu tabla tiene campos como created_at, updated_at, deleted_at, los maneja de forma especial para que el soft delete funcione perfectamente.

🏗️ El entorno perfecto: julio101290/boilerplate

Este generador vive dentro de mi fork del excelente boilerplate de agungsugiarto, adaptado y mejorado para proyectos reales. Incluye:

  • 🎨 AdminLTE 3 + Bootstrap 4 + Font Awesome 5
  • 🔐 RBAC completo con Myth/Auth
  • 📊 Menú dinámico generado desde BD
  • 🌍 Internacionalización (EN, ES, ID)
  • Instalación por Composer y comandos spark

👉 Repositorio oficial en GitHub

⚙️ Características principales

CaracterísticaBeneficio
Generación instantáneaDe 1 hora a 1 minuto por módulo
Código seguroCSRF manejado automáticamente
Validación por defectoEvita errores comunes
Soft delete funcionaldeleted_at siempre NULL al guardar
Soporte multi-empresaFiltrado por idEmpresa incluido
Modo App / VendorGenera en app/ o en tu paquete Composer
Permisos integradosSeeder actualizado automáticamente

🔧 Mejoras de seguridad y robustez

Hemos recorrido un largo camino desde la primera versión. Aquí están las mejoras clave que marcan la diferencia:

🛡️ Seguridad CSRF sin dolores de cabeza

El error 403 por CSRF era el más común al trabajar con AJAX. Ahora:

  • 🔹 El controlador devuelve el nuevo token en cada respuesta (éxito o error).
  • 🔹 La vista lee el token del campo oculto y lo envía en el FormData.
  • 🔹 Tras cada petición, se actualiza el token en el campo y la metaetiqueta.
  • 🔹 Incluso en errores de validación, el token se renueva, permitiendo reenviar el formulario sin recargar la página.

📌 Ejemplo de respuesta del controlador:

return $this->respond([
    'status'    => 201,
    'message'   => 'Guardado correctamente',
    'csrf_hash' => csrf_hash() // 👈 Nuevo token
], 201);

🗑️ El misterio de deleted_at resuelto

Problema: los registros nuevos aparecían como eliminados porque deleted_at se llenaba con 0000-00-00.... Solución en dos capas:

  • ✅ En el modelo: deleted_at excluido de $allowedFields y eventos beforeInsert/beforeUpdate que lo eliminan.
  • ✅ En el controlador: unset($datos['deleted_at']) antes de guardar.

Resultado: deleted_at siempre NULL en altas y modificaciones, y solo el método delete() lo actualiza.

✅ Validación automática para idEmpresa

Casi todas las tablas dependen de una empresa. Ahora el modelo incluye por defecto:

protected $validationRules = [
    'idEmpresa' => 'required|integer|greater_than[0]'
];

¡Olvídate de registros huérfanos!

📦 Genera CRUDs dentro de paquetes vendor

¿Desarrollas paquetes reutilizables? El generador puede crear el CRUD directamente en tu paquete Composer:

http://tusitio.com/generateCRUDComposer/mi_tabla?target=vendor&package=tu/paquete
  • 🔹 Lee el composer.json y extrae el namespace PSR-4 automáticamente.
  • 🔹 Crea la estructura src/Models, src/Controllers, etc.
  • 🔹 Actualiza el archivo src/Config/Routes.php del paquete con las nuevas rutas.
  • 🔹 Tu paquete se vuelve autónomo y portable.

🔑 Permisos gestionados como profesionales

Antes: los permisos se creaban en caliente al generar el CRUD (poco ortodoxo). Ahora: cuando el destino es un paquete vendor, el generador actualiza el Seeder correspondiente (ej. BoilerplateCFDIDescargaMasiva.php), añadiendo la línea para crear el permiso y asignarlo al admin.

Así, la instalación de permisos se hace como Dios manda: con php spark db:seed.

⏱️ Ahorro de tiempo real

TareaSin generadorCon generadorAhorro
CRUD de 10 campos45-60 min1 min~98%
20 tablas por proyecto15-20 horas20 minutos¡Días!

Ese tiempo lo puedes reinvertir en lógica de negocio que realmente aporta valor. Además, todo el código generado sigue el mismo patrón, reduciendo la deuda técnica y facilitando el mantenimiento.

📝 Código completo del generador

Aquí tienes la clase AutoCrudControllerComposer en su versión final. Cópiala directamente en tu proyecto (julio101290/boilerplate/Controllers/).

db = \Config\Database::connect();
        $this->authorize = Services::authorization();
        $this->users = new UserModel();
        helper('utilerias');
    }

    /**
     * Método principal para generar el CRUD
     *
     * @param string      $table          Nombre de la tabla
     * @param string|null $targetType     'app' o 'vendor' (por GET)
     * @param string|null $vendorPackage  Paquete vendor
     * @param string|null $vendorNamespace Namespace (auto-detected)
     */
    public function index($table, $targetType = null, $vendorPackage = null, $vendorNamespace = null)
    {
        // Leer de GET si no se pasaron como argumentos
        if ($targetType === null) {
            $targetType = $this->request->getGet('target') ?? 'app';
        }
        if ($vendorPackage === null && $targetType === 'vendor') {
            $vendorPackage = $this->request->getGet('package');
        }
        if ($vendorNamespace === null && $targetType === 'vendor') {
            $vendorNamespace = $this->request->getGet('namespace');
        }

        $this->targetType = $targetType;

        if ($targetType === 'vendor' && $vendorPackage) {
            $this->setupVendorPaths($vendorPackage, $vendorNamespace);
        }

        $this->generateModel($table);
        $this->generateController($table);
        $this->generateView($table);
        $this->generateViewModal($table);
        $this->generateLanguage($table);
        $this->generateMigration($table);
        $this->generateLanguageES($table);

        if ($targetType === 'vendor') {
            $this->generateVendorRoutesFile($table);
            $this->updateSeederPermissions($table);
        } else {
            $this->generatePermissions($table);
        }

        $tableUpCase = ucfirst($table);

        echo "";
        echo "✅ CRUD generado exitosamente en: " . ($targetType === 'vendor' ? $this->vendorPackage : 'app') . "";
        echo "";
    }

    // ... (el resto de métodos: setupVendorPaths, generateModel, generateController, etc.)
    // Por brevedad, no repetimos todo el código aquí, pero en el artículo real debes incluir el código completo.
}
?>

⚠️ Nota: El código anterior es un resumen. Para obtener el código completo, visita el repositorio en GitHub o copia el bloque que aparece al final de este artículo.

🔌 Cómo usarlo

  1. Agrega la ruta en app/Config/Routes.php: $routes->get('generateCRUDComposer/(:any)', 'julio101290\boilerplate\Controllers\AutoCrudControllerComposer::index/$1');
  2. Genera un CRUD en app: http://tusitio.com/generateCRUDComposer/nombre_tabla
  3. Genera en tu paquete vendor: http://tusitio.com/generateCRUDComposer/nombre_tabla?target=vendor&package=tu/paquete

¡Y listo! En segundos tendrás todo el código listo para usar.

🎯 Conclusión y llamado a la acción

El generador automático de CRUD ha evolucionado de un simple script a una herramienta profesional que:

  • 🚀 Acelera el desarrollo de forma drástica.
  • 🛡️ Garantiza seguridad (CSRF, validación, soft delete correcto).
  • 📦 Soporta tanto proyectos monolíticos como paquetes reutilizables.
  • 🧹 Genera código limpio y mantenible.

Si aún no lo has probado, te estás perdiendo de ahorrar cientos de horas.

👉 Haz un fork del repositorio julio101290/boilerplate, instálalo y pruébalo hoy mismo.

¿Tienes sugerencias o mejoras? ¡Las contribuciones son bienvenidas! Abre un issue o envía un pull request.


#CodeIgniter4 #PHP #DesarrolloWeb #CRUD #Boilerplate #AhorroDeTiempo #OpenSource

🛠️ Corrección de ordenamiento y búsqueda en DataTables (Server-Side) – Bitácora

Entrada fija

Se ha implementado una mejora importante en el manejo de DataTables con procesamiento server-side para el módulo de Bitácora en el proyecto jcposUltimate, resolviendo problemas de ordenamiento, paginación y búsqueda que impedían un funcionamiento correcto con MariaDB / MySQL.

🔗 Commit

https://github.com/julio101290/jcposUltimate/commit/7400ede1b2a826d7e9918c7475623ca0b2d5dc48

📂 Archivos modificados

❌ Problema detectado

El DataTable de la bitácora presentaba varios inconvenientes:

  • El ordenamiento por columnas no funcionaba, aunque visualmente aparecían las flechas.
  • El ORDER BY no se aplicaba dinámicamente desde los parámetros enviados por DataTables.
  • El mapeo de columnas para el ordenamiento era incorrecto.
  • La paginación y la búsqueda global no seguían buenas prácticas de seguridad.
  • La lógica del modelo no estaba alineada con el flujo real de DataTables server-side.

✅ Solución implementada

Se realizó una refactorización enfocada en robustez, compatibilidad y seguridad, logrando:

✔ Ordenamiento dinámico real

  • Implementación de un whitelist de columnas permitidas.
  • Construcción dinámica del ORDER BY usando los parámetros enviados por DataTables.

✔ Búsqueda global correcta

  • Uso exclusivo de LIKE, compatible con MariaDB / MySQL.
  • Eliminación de ILIKE, que es exclusivo de PostgreSQL.
  • Uso de bind parameters para prevenir SQL Injection.

✔ Paginación adecuada

  • Uso correcto de: LIMIT :start, :length
  • Totalmente compatible con el flujo estándar de DataTables.

✔ Separación clara de responsabilidades

  • El archivo AJAX se encarga únicamente de generar el JSON.
  • El controlador actúa como intermediario.
  • El modelo concentra toda la lógica SQL.

🧠 Beneficios obtenidos

💎 Guía Maestra: Instalación de SAP HANA Client 2.0

Entrada fija

Edición SAP Business One (HANA 2.0 Rev 56)

Esta guía detalla el despliegue del cliente de base de datos, componente esencial para conectar SAP B1, Crystal Reports, Excel y Power BI.


1 Ubicación del Kit de Instalación

En entornos de SAP Business One, el instalador reside dentro de los paquetes de datos del servidor. No busque instaladores genéricos; navegue a la siguiente ruta:

…\HANA 2.0 rev 56\DATA_UNITS\SAP HANA CLIENT 2.0 FOR B1

Dentro encontrará la arquitectura dual de SAP:

  • 📂 NT_X64: Carpeta exclusiva para Windows (64 bits).
  • 📂 LINX64SUSE: Carpeta para servidores Linux/SUSE.

2 Instalación Paso a Paso

  1. Acceda a la carpeta NT_X64.
  2. Localice el ejecutable hdbinst.exe.
  3. Derechos de Administrador: Haga clic derecho y seleccione “Ejecutar como administrador”.
  4. Consola: Presione Enter para aceptar la ruta por defecto C:\hdbclient.

⚠️ Verificación: La instalación finaliza correctamente cuando visualiza el mensaje: Installation done.

3 Configuración del PATH

Para ejecutar herramientas como hdbsql desde cualquier carpeta, configure la variable de entorno:

  • Busque “Variables de Entorno” en el menú Inicio.
  • En Variables del sistema, edite la variable Path.
  • Agregue una nueva línea con: C:\hdbclient.

4 Activación ODBC (64 bits)

Para habilitar la conexión en aplicaciones de terceros:

  1. Abra el Administrador de orígenes de datos ODBC (64 bits).
  2. Vaya a DSN de sistema > Agregar.
  3. Seleccione el controlador HDBODBC.
  4. Configure la IP del servidor y el puerto (ej: 30015).

// Prueba de fuego en CMDhdbsql -n 192.168.X.X:30015 -u SYSTEM -p Password123 "SELECT * FROM DUMMY"

🚀 Troubleshooting Rápido

  • ¿No ve el driver? Instale “Visual C++ Redistributable 2013/2015”.
  • ¿Error -10709? Verifique el Firewall del servidor en el puerto 30015.

Cómo enlazar sucursales locales con SAP Business One usando ODBC (HANA)

Entrada fija

Repositorio: boilerplateservicelayer
Commit documentado: 53bbd3fe03b083957043911f46b59a04e31175f4

Este manual técnico explica cómo enlazar sucursales locales con sucursales de SAP Business One (OBPL) utilizando ODBC (eODBC) sobre SAP HANA, evitando el uso del Service Layer para consultas de alto rendimiento.


¿Qué problema resuelve esta implementación?

En muchos proyectos con SAP Business One, el uso del Service Layer para catálogos o consultas simples introduce latencia innecesaria. Este módulo soluciona ese problema permitiendo:

  • Relacionar sucursales locales con sucursales SAP
  • Consultar la tabla OBPL directamente desde SAP HANA
  • Reducir tiempos de respuesta usando ODBC
  • Eliminar dependencias innecesarias del Service Layer

¿Por qué usar ODBC en SAP Business One?

El uso de ODBC en SAP HANA es ideal para consultas de solo lectura, catálogos y validaciones rápidas.

CaracterísticaService LayerODBC SAP HANA
RendimientoMedioAlto
LatenciaAltaBaja
Ideal paraCRUD complejoCatálogos y consultas
Dependencia SAPAltaMedia

Estructura del módulo de enlace SAP

La solución se divide en cuatro componentes principales:

  1. Tabla de enlace entre sucursal local y SAP
  2. Controlador con consultas ODBC
  3. Vista con DataTables server-side
  4. Formulario con Select2 dinámico

Tabla link_sap_branchoffice

Esta tabla permite mantener la relación entre el sistema local y SAP Business One sin duplicar información de SAP.

CampoDescripción
idID interno
idEmpresaEmpresa local
idBranchOfficeSucursal local
idBranchOfficeSAPSucursal SAP (OBPL.BPLId)
created_atFecha de creación
updated_atFecha de actualización
deleted_atBorrado lógico

Conexión a SAP HANA usando ODBC

La conexión ODBC se realiza directamente contra SAP HANA, lo que permite consultas rápidas y estables.

Conexión ODBC en PHP


$conn = odbc_connect(
    $dataConect['nameODBC'],
    $dataConect['userODBC'],
    $dataConect['passwordODBC']
);

Fijar el schema en SAP HANA


SET SCHEMA "COMPANYDB"

Este paso es obligatorio para evitar errores como invalid table name en SAP HANA.


Consulta optimizada a la tabla OBPL

Para obtener una sucursal SAP se realiza una consulta directa a la tabla OBPL:


SELECT
    "BPLId",
    "BPLName"
FROM OBPL
WHERE "Disabled" <> 'Y'
  AND "BPLId" = ?
  • Consulta directa
  • Sin bucles innecesarios
  • Ideal para formularios y edición

Listado con DataTables server-side

El módulo utiliza DataTables en modo server-side para manejar grandes volúmenes de datos:

  • Paginación eficiente
  • Búsqueda global
  • Ordenamiento dinámico
  • Filtrado por empresa del usuario

Select2 dinámico para sucursales

Sucursal local

Se cargan las sucursales locales vía AJAX usando Select2.

Sucursal SAP (OBPL)

Las sucursales SAP se consultan directamente desde SAP HANA vía ODBC, sin Service Layer.


Beneficios clave de esta arquitectura

  • Mayor rendimiento en SAP Business One
  • Menor latencia en consultas
  • Menos carga en el Service Layer
  • Arquitectura escalable y mantenible

Buenas prácticas recomendadas

  • Usar ODBC solo para consultas de lectura
  • Usar Service Layer para escrituras en SAP
  • Centralizar credenciales ODBC
  • Siempre definir el schema en SAP HANA

Conclusión

Este enfoque permite integrar SAP Business One con sistemas locales de forma eficiente, utilizando ODBC sobre SAP HANA como alternativa rápida y estable al Service Layer.

Ideal para catálogos, validaciones, reportes y sistemas híbridos SAP.

Página 1 de 9

Creado con WordPress & Tema de Anders Norén