Logo
자주 발생하는 문제
자주 발생하는 문제PHP 서버에서 타임아웃 방지하기

PHP 서버에서 타임아웃 방지하기

AI 서비스 API에 전송되는 요청에는 번역할 문자열이 최대한 많이 포함됩니다. 요청이 길어질수록 API가 처리하는 데 더 많은 시간이 걸립니다.

응답이 느린 경우 PHP 서버에서 타임아웃이 발생할 수 있습니다（예: PHP 스크립트의 최대 실행 시간이 30초로 설정된 경우）.

타임아웃을 방지하려면 다음 방법을 사용할 수 있습니다:

  • PHP의 max_execution_time보다 낮은 값으로 Translation Timeout을 설정하기（권장）
  • PHP 설정에서 최대 실행 시간 늘리기
  • 플러그인 설정에서 API에 전송하는 페이로드 크기 줄이기
  • 서버에서 허용하는 동시 아웃바운드 요청 수 늘리기（여러 언어로 많은 게시물을 한꺼번에 번역하면 실패함 참고）

페이로드 크기를 줄이면 요청이 여러 개의 요청으로 분할되며, 각 요청이 더 빠르게 처리됩니다.

Settings > Service Configuration > [AI service] 로 이동하여 Max request payload length 옵션을 타임아웃 오류를 방지할 수 있는 적절한 문자 수로 줄이세요.

예를 들어, 4000으로 설정했을 때 실패하면 2000으로 설정해 보세요.

「Max request payload length」옵션 설정
「Max request payload length」옵션 설정

Translation Timeout 설정

웹 서버는 max_execution_time 지시문（php.ini 또는 호스팅 제어판에서 설정）을 통해 모든 PHP 요청의 최대 실행 시간을 강제합니다.

플러그인은 Plugin Configuration > Translation Timeout 아래의 설정에서 Translation Timeout 옵션을 제공합니다. 이 값을 서버의 max_execution_time보다 낮게 유지하면, 번역이 중단되었을 때 일반적인 서버 타임아웃（HTTP 502 / 504, 또는 「Maximum execution time of N seconds exceeded」라는 빈 페이지）이 발생하는 대신 로그에 제어된 오류로 깔끔하게 실패합니다.

Translation Timeout 옵션 설정
Translation Timeout 옵션 설정

번역이 정기적으로 타임아웃되는 경우 이 값과 서버의 max_execution_time _모두_를 함께 늘려 주세요.