Evitar timeouts en el servidor PHP
La petición enviada a la API del servicio de IA incluye tantas cadenas a traducir como sea posible. Cuanto más larga sea la petición, más tiempo tardará la API en procesarla.
Una respuesta lenta puede producir un timeout en tu servidor PHP (por ejemplo: si el tiempo máximo para ejecutar un script PHP es de 30 segundos).
Para evitar un timeout, puedes:
- Establecer un Translation Timeout por debajo del
max_execution_timede PHP (recomendado) - Aumentar el tiempo máximo de ejecución en la configuración de PHP
- Reducir el tamaño del payload enviado a la API en los ajustes del plugin
Al reducir el tamaño del payload, la petición se dividirá en varias peticiones, cada una de las cuales se resolverá más rápido.
Ve a Settings > Service Configuration > [AI service] y reduce la opción Max request payload length a un número de caracteres adecuado que evite un error de timeout.
Por ejemplo, si está configurado a 4000 y falla, prueba a establecerlo en 2000.
Configurar el Translation Timeout
Tu servidor web impone un tiempo máximo de ejecución para cada petición PHP a través de la directiva max_execution_time (establecida en php.ini, o mediante el panel de control de tu hosting).
El plugin expone una opción Translation Timeout en los ajustes, en Plugin Configuration > Translation Timeout. Mantenla por debajo del max_execution_time de tu servidor para que una traducción estancada falle de forma controlada con un error en los logs, en lugar de provocar el timeout genérico del servidor (HTTP 502 / 504, o una página en blanco con "Maximum execution time of N seconds exceeded").
Si tus traducciones agotan el tiempo de espera con frecuencia, aumenta ambos valores: este y el max_execution_time de tu servidor de forma conjunta.