Solución de problemas

Rama 4.4.x

Magento 2.4.4+ | PHP 8.1+

Rama 4.x

Magento 2.4.0 a 2.4.3 | PHP 7.4

Rama 3.x

Magento 2.3.x | PHP 7.4

Descripción

Problemas comunes al instalar, actualizar o usar GDW_Core y cómo diagnosticarlos rápidamente.

El módulo no aparece como instalado

Síntomas:

• GDW_Core no aparece en Magento.
• No se refleja después de composer require.
• setup:upgrade no registra el módulo.

Validaciones recomendadas:

composer show gdw/core
php bin/magento module:status GDW_Core
php bin/magento setup:upgrade

Qué revisar:

• Que la rama instalada sea compatible con tu stack Magento/PHP.
• Que Composer haya resuelto el paquete correcto.
• Que no exista conflicto con dependencias base de Magento.

El comando gdw:run:function no existe

Síntomas:

• Magento responde There are no commands defined in the "gdw" namespace.

Validaciones recomendadas:

php bin/magento list | grep gdw
php bin/magento setup:upgrade
php bin/magento cache:flush

Qué revisar:

• Que GDW_Core esté habilitado.
• Que la instalación no haya quedado incompleta.
• Que estés ejecutando el comando desde la raíz correcta del proyecto Magento.

Error de compatibilidad de rama

Síntomas:

• Composer rechaza la instalación.
• Aparecen errores por versión de PHP o magento/framework.

Qué revisar:

• Rama 4.4.x: Magento 2.4.4+ / PHP 8.1+.
• Rama 4.x: Magento 2.4.0 a 2.4.3 / PHP 7.4.
• Rama 3.x: Magento 2.3.x / PHP 7.4.

Recomendación:

• Si tu stack no coincide, instala la serie Composer correcta para esa rama.

gdw:run:function falla con Class is outside the allowed namespaces

Causa:

• El comando restringe la ejecución a namespaces permitidos.

Namespaces permitidos actualmente:

• GDW\\
• Magento\\Catalog\\Cron\\

Qué hacer:

• Ejecuta solo clases bajo esos prefijos.
• Si necesitas otro namespace, el módulo debe ampliarse explícitamente.

gdw:run:function falla con Method requires parameters

Causa:

• El comando solo permite métodos públicos sin parámetros obligatorios.

Qué hacer:

• Usa un método sin argumentos obligatorios.
• Si necesitas pasar datos, crea un método adaptador sin parámetros que encapsule la lógica.

gdw:run:function falla por área inválida

Síntomas:

• Error indicando que el área no es válida.

Áreas soportadas:

• frontend
• adminhtml
• crontab

Ejemplo válido:

php bin/magento gdw:run:function \
  --class="GDW\\Core\\Test\\Index" \
  --function="anyFunction" \
  --area="frontend"

No aparece la sección en Stores > Configuration > GDW

Qué revisar:

• Que el usuario tenga permisos ACL suficientes.
• Que Magento_Backend, Magento_Config y Magento_Store estén operativos.
• Que después de instalar hayas ejecutado setup:upgrade y limpieza de caché.

Comandos útiles:

php bin/magento cache:flush
php bin/magento setup:upgrade

Error después de actualizar el módulo

Síntomas:

• El módulo deja de comportarse como antes.
• Composer actualiza una serie no compatible.

Qué hacer:

• Verifica la versión instalada con composer show gdw/core.
• Confirma que la rama objetivo coincide con tu stack.
• Si cambias de línea mayor, valida primero en staging.

No puedes desinstalar GDW_Core

Causa frecuente:

• Otros módulos GDW dependen de este módulo base.

Recomendación:

• Revisa primero dependencias funcionales del proyecto antes de ejecutar composer remove gdw/core.
• No desinstales el core si otros módulos GDW siguen activos.