Evitare i timeout sul server PHP
La richiesta inviata all'API del servizio di IA include il maggior numero possibile di stringhe da tradurre. Più lunga è la richiesta, più tempo impiegherà l'API per elaborarla.
Una risposta lenta può provocare un timeout sul tuo server PHP (ad esempio: se il tempo massimo di esecuzione di uno script PHP è di 30 secondi).
Per evitare un timeout, puoi:
- Impostare un Translation Timeout inferiore al
max_execution_timedi PHP (consigliato) - Aumentare il tempo massimo di esecuzione nella configurazione di PHP
- Ridurre la dimensione del payload inviato all'API nelle impostazioni del plugin
- Aumentare il numero di richieste in uscita simultanee consentite dal tuo server (vedi La traduzione di molti articoli in molte lingue non riesce)
Riducendo la dimensione del payload, la richiesta verrà suddivisa in più richieste, ognuna delle quali verrà risolta più rapidamente.
Vai su Settings > Service Configuration > [AI service] e diminuisci l'opzione Max request payload length a un numero di caratteri adeguato che eviti un errore di timeout.
Ad esempio, se è impostata su 4000 e fallisce, prova a impostarla su 2000.
Configurare il Translation Timeout
Il tuo server web impone un tempo di esecuzione massimo per ogni richiesta PHP tramite la direttiva max_execution_time (definita in php.ini, oppure tramite il pannello di controllo del tuo hosting).
Il plugin espone un'opzione Translation Timeout nelle impostazioni, sotto Plugin Configuration > Translation Timeout. Mantienila al di sotto del max_execution_time del tuo server, così una traduzione bloccata fallisce in modo pulito con un errore controllato nei log, invece di attivare il timeout generico del server (HTTP 502 / 504, oppure una pagina bianca che mostra "Maximum execution time of N seconds exceeded").
Se le tue traduzioni superano regolarmente il limite di tempo, aumenta entrambi i valori: questo e il max_execution_time del tuo server in modo congiunto.