Problemas con respuestas AJAX JSON en controlador frontal

alberto_pro

Saludos a todos, estoy teniendo un quebradero de cabeza con las respuestas AJAX en uno de mis controladores frontales en PrestaShop 1.7.6.0. Tengo un módulo que usa un controlador api.php para ciertas llamadas, y parece que las respuestas JSON no se están gestionando de forma óptima.

He implementado un contador de carrito persistente en custom.js que se actualiza con prestashop.on('updatedCart', ...), pero noto que a veces el evento se dispara varias veces seguidas o, lo que es peor, no se actualiza correctamente al reducir la cantidad de productos en el checkout. Sospecho que el problema viene de cómo se envía la respuesta JSON desde el controlador.

El código en prestaspeedcache/controllers/front/api.php donde creo que está el conflicto es este:

function initContent()
    {
        parent::initContent();
        header('Content-Type: application/json; charset=utf-8');
        header('Cache-Control: no-store');
        $token = (string) Tools::getValue('token');
        $expected = (str

Al usar header() y luego un json_encode() directo, siento que estoy bypassando alguna capa de PrestaShop que debería manejar esto, afectando quizás la consistencia de CORS o CSRF. ¿Cómo debería adaptar o modificar esto para que las respuestas JSON se manejen correctamente en un controlador frontal de PrestaShop 1.7.6.0?

ignacio_tech

Hola @alberto_pro, por lo que veo en el snippet, estás usando header() directamente. Esto es una señal de alarma en entornos de frameworks como PrestaShop (incluso la versión 1.7, que ya tiene parte de Symfony).

Cuando haces header('Content-Type: application/json; charset=utf-8'); a mano, estás forzando la cabecera antes de que el controlador tenga la oportunidad de gestionar su propia respuesta. Esto puede generar conflictos o que se ignoren otras cabeceras necesarias. Para respuestas AJAX en controladores frontales, PrestaShop tiene un método específico.

¿Podrías confirmar qué versión exacta de PrestaShop 1.7 estás usando? A veces hay pequeñas diferencias entre 1.7.0 y 1.7.6, por ejemplo.

antonio_bcn

Totalmente de acuerdo con @ignacio_tech. Las llamadas directas a header() en un controlador de PrestaShop 1.7 suelen ser el origen de muchos problemas con la gestión de respuestas, especialmente en peticiones AJAX.

La forma correcta de devolver una respuesta JSON desde un FrontController o uno que herede de él, es usando el método $this->ajaxRender(json_encode($data)). Este método se encarga de establecer las cabeceras HTTP adecuadas (como Content-Type: application/json), gestionar la finalización del script y asegurar que se sigan las prácticas de seguridad como la prevención de ataques CSRF si el controlador está configurado para ello.

Si el evento updatedCart se dispara múltiples veces, es muy probable que sea porque la respuesta de tu API no está bien formada o no se está terminando correctamente, haciendo que el frontend lo interprete mal o intente procesar datos incompletos. ajaxRender te ayudará con eso.

Milo

Hola @alberto_pro, el problema que describes es un clásico al intentar gestionar respuestas AJAX sin usar las utilidades del framework de PrestaShop. Tal como han señalado @ignacio_tech y @antonio_bcn, la clave está en el método ajaxRender().

En PrestaShop 1.7.6.0, cuando un controlador frontal recibe una petición AJAX y debe devolver una respuesta JSON, es fundamental dejar que el propio controlador gestione la respuesta. Al llamar a header() manualmente y luego a json_encode() y exit; o die();, estás bypassando el flujo de PrestaShop, lo que puede provocar problemas con la validación de tokens (CSRF), cabeceras CORS y el correcto manejo de eventos en el frontend.

La solución consiste en eliminar esas llamadas manuales a header() y encapsular tu respuesta JSON dentro de $this->ajaxRender(). Aquí te dejo el fragmento de código modificado para tu archivo prestaspeedcache/controllers/front/api.php:

// Las cabeceras se gestionan automáticamente con ajaxRender
        $token = (string) Tools::getValue('token');
        $expected = (string) Configuration::get(PscConfig::CRON_TOKEN);
        if ($expected === '' || !hash_equals($expected, $token)) {
            $response = ['error' => true, 'message' => 'Token inválido.'];
            $this->ajaxRender(json_encode($response));
        }

Explicación de los cambios:

Eliminación de header(): Las líneas header('Content-Type: application/json; charset=utf-8'); y header('Cache-Control: no-store'); se eliminan. ajaxRender() se encargará de establecer la cabecera Content-Type y otras cabeceras necesarias.
Uso de ajaxRender(): Dentro del bloque if, en lugar de un echo json_encode(...) seguido de un exit; (que se infiere de tu descripción), ahora creamos el array de respuesta ($response) y lo codificamos a JSON para pasárselo a $this->ajaxRender(). Este método se encarga de enviar la respuesta y finalizar la ejecución del script de forma controlada por PrestaShop, lo que garantiza la consistencia y evita los problemas que mencionas.

alberto_pro

¡Increíble, @Milo! He aplicado los cambios que sugeriste en prestaspeedcache/controllers/front/api.php, eliminando las llamadas header() y utilizando $this->ajaxRender() dentro de la lógica de validación del token. Y funciona perfectamente.

El contador de carrito se actualiza de forma consistente, sin los disparos duplicados ni los fallos de actualización que tenía antes. Está claro que el manejo correcto de las respuestas JSON a través de ajaxRender() es crucial en PrestaShop. Muchas gracias por la explicación detallada y el snippet, me ha solucionado el problema por completo.