FreeScout을 PHP 8.5로 업그레이드(Ubuntu 26.04 체크리스트)
FreeScout을 PHP 8.5로 이동하기 전에 FreeScout 및 실행 중인 모든 모듈이 이를 지원하는지 확인한 후 PHP 확장을 확인하고, 큐 워커를 재시작하고, 로그에서 다음을 확인하세요 deprecated since 8.5 메시지. Ubuntu 26.04는 기본적으로 PHP 8.5를 설치하므로 운영 체제 업그레이드가 종종 변경을 유발합니다.
FreeScout이 사용 중단 알림을 처리하는 방식 때문에, 이는 대부분의 PHP 앱보다 FreeScout에서 더 중요합니다.
PHP 8.5가 FreeScout 모듈을 손상시킬 수 있는 이유
각 PHP 릴리스는 일부 이전 함수를 더 이상 사용하지 않게 합니다. PHP 8.5는 PHP 8.0 이후 아무 기능도 하지 않은 여러 함수를 더 이상 사용하지 않게 합니다. 여기에는 다음이 포함됩니다 curl_close(), imagedestroy(), 그리고 xml_parser_free(). 또한 일부 엣지 케이스를 더 이상 사용하지 않습니다. 예를 들어 null 배열 키로 또는 전달 chr() 0에서 255를 벗어난 값.
대부분의 PHP 앱은 사용 중단 알림을 기록하고 계속 진행합니다. FreeScout은 모든 사용 중단 알림을 오류로 전환하므로, 남은 호출 하나가 해당 요청이나 백그라운드 작업을 중단시킵니다. 모듈이 설치되어 정상으로 보이지만 모든 연결이 실패할 수 있습니다.
업그레이드 후 이러한 오류가 표시되면 FreeScout에서 "deprecated since 8.5" 오류 수정 책임이 있는 모듈을 찾아 수정하는 과정을 안내합니다.
업그레이드 전에
- 지원 확인: PHP 8.5에 대한 FreeScout 릴리스 노트와 시스템 요구 사항을 읽고, 설치된 각 모듈에 PHP 8.5 호환 릴리스가 있는지 확인하세요.
- 먼저 모듈 업데이트: 현재 PHP 버전에 있는 동안 해당 업데이트를 설치하여 이동 전에 모든 모듈이 준비되도록 하세요.
- 백업: FreeScout 디렉터리, 데이터베이스, PHP 구성 파일의 복사본을 만드세요.
- 복사본에서 테스트: 가능하면 헬프 데스크의 스테이징 복사본에서 먼저 업그레이드를 실행하세요.
업그레이드한 후
FreeScout가 실행되는 PHP 버전 확인
열기 관리 > 시스템. 웹 서버가 사용하는 PHP 버전을 표시하고 FreeScout에 필요한 PHP 확장을 나열하며 누락된 것을 표시합니다.명령줄 PHP와 일치시키기
실행php -v서버에서. 큐 워커와schedule:runcron은 웹 서버와 다른 버전일 수 있는 명령줄 PHP를 사용합니다. 둘 다 동일한 버전과 동일한 확장으로 실행되어야 합니다.확장 및 설정 재설치
새 PHP 버전에는 자체 확장 패키지와php.ini파일. 확장을 설치하세요 관리 > 시스템 누락으로 표시한 다음 다음과 같은 사용자 지정 설정을 다시 적용합니다upload_max_filesize그리고post_max_size.웹 서버를 새 PHP로 지정
PHP-FPM을 사용한다면 웹 서버가 PHP 8.5 FPM 소켓 또는 서비스를 사용하는지 확인한 다음 PHP-FPM과 웹 서버를 재시작하세요.캐시 지우기 및 큐 워커 재시작
구 코드를 계속 실행하는 프로세스가 없도록 FreeScout 디렉터리에서 다음을 실행하세요:터미널php artisan freescout:clear-cache php artisan queue:restart
로그에서 확인할 것
열기 관리 > 로그 > 앱 로그 헬프 데스크를 잠시 사용한 후. 검색:
is deprecated since 8.5, 아직 PHP 8.5 준비가 되지 않은 모듈이나 파일을 가리킵니다.Providing a value not in-between 0 and 255 is deprecated, 다음에서chr()호출.Using null as an array offset is deprecated.
각 항목은 파일 이름을 지정합니다. 다음 아래의 경로 Modules/<Name> 어떤 모듈에 업데이트가 필요한지 알려줍니다.
아웃바운드 연결을 만드는 기능을 테스트하세요. 이러한 기능이 가장 먼저 실패하기 때문입니다: 메일 가져오기, AI 제공업체, 지식 소스, Linear, Jira, Slack 또는 스토어 커넥터와 같은 통합. 모듈이 제공하는 경우 연결 테스트 버튼을 사용하세요.
문제가 발생하면
업데이트를 기다리는 동안 FreeScout을 PHP 8.4로 되돌리세요. PHP 8.4는 이러한 함수를 사용 중단으로 처리하지 않으므로 동일한 코드가 정상적으로 실행됩니다. 웹 서버와 명령줄 PHP를 모두 전환한 다음 PHP-FPM, 웹 서버, 큐 워커를 재시작하세요.