라이트세일 - PHP 버전 웹 서버와 CLI가 다를 경우 해결 방법

라이트세일(Lightsail) SSH 프로토콜에서 PHP 버전을 확인을 했는데 웹 서버와 다른 것을 확인하게 되었습니다. 그래서 문제가 생길 수 있는지 알아본 결과, 버전이 다를 경우 예상치 못한 오류가 발생할 수도 있다는 내용이 있었습니다.

해당 내용은 SSH로 접속한 후에 php -v 명령어를 입력했을 때 자신이 사용하는 웹 서버의 PHP 버전과 다를 경우 PHP 코드의 개발 및 배포 환경에서 버전 차이로 인해 디버깅이 복잡해질 수 있고 정상적으로 작동하지 않을 수 있다는 내용이었습니다.

그래서 버전이 같도록 업그레이드를 진행해야 하는데, 웹 서버의 경우 Cpanel, Cyberpanel 같은 관리 패널에서 어렵지 않게 업그레이드를 할 수 있으며, 만약 관리 패널이 없는 환경일 경우에는 인스턴스를 교체하면 최신 버전의 PHP를 사용할 수 있습니다.

SSH는 몇 가지 명령어를 실행하면 어렵지 않게 PHP 업그레이드를 진행할 수 있습니다. 웹 서버와 동일한 PHP 버전을 설치하면 문제가 해결되기 때문에 아래의 설명을 보시고 순서대로 명령어를 입력해 보시기 바랍니다.

아래의 설명은 PHP 8.2 로 동일하게 설치하는 과정이기 때문에 다른 버전일 경우에는 아래의 설명에서 버전만 다르게 입력하시면 됩니다.

웹 서버 버전 확인

웹 서버의 PHP 버전을 확인하는 가장 편한 방법은 워드프레스 > 도구 > 사이트 건강으로 들어간 후 상단에 있는 정보로 들어가면 서버 정보에서 확인할 수 있습니다.

워드프레스 환경이 아닐 경우에는 SSH 접속 후 아래의 명령어를 입력하여 확인할 수 있습니다.

위의 명령어를 사용해서 현재 사용하고 있는 웹 서버의 PHP 버전을 확인을 했다면 이제 SSH에서 PHP는 어떤 버전을 사용하고 있는지 확인을 하시면 됩니다.

SSH 프로토콜에서 php -v 입력하게 되면 위에 보이는 것처럼 현재 CLI (Command Line Interface) PHP 버전을 확인하실 수 있습니다. 여기서 SSH와 CLI에 대해서 알아보고 가겠습니다.

어려운 부분일 수 있지만 검색을 할 때 필요할 수 있기 때문에 아래에 용어 설명을 하겠습니다.

SSH(Secure Shell) : 보안된 방식으로 원격 시스템에 접속할 수 있게 해주는 프로토콜입니다. SSH를 사용하면 원격 서버에 안전하게 연결해서 명령을 실행할 수 있습니다.
CLI(Command Line Interface) : 사용자가 텍스트 기반의 명령어를 입력해서 컴퓨터 시스템과 상호작용하는 방식의 인터페이스입니다.

SSH는 CLI에서 사용할 수 있는 도구 중 하나이며, CLI는 SSH를 포함한 다양한 명령어를 입력하고 실행할 수 있는 인터페이스입니다.

웹 서버와 CLI (Command Line Interface) PHP 버전이 다를 경우에는 아래의 명령어를 입력해서 업그레이드를 진행해주시면 됩니다. 해당 명령어는 Ubuntu 기준으로 작성되었습니다.

sudo apt list --installed | grep php8.2

먼저 위의 명령어를 입력하게 되면 php 8.2 패키지가 설치되어 있는지 확인할 수 있습니다.

sudo apt update

php 8.2 패키지 목록을 확인했다면 위의 명령어를 입력해서 업데이트를 진행하시면 됩니다.

sudo apt install php8.2-cli

그 다음 위의 명령어를 입력해서 PHP 8.2 CLI 설치를 하시면 됩니다.

sudo update-alternatives --set php /usr/bin/php8.2

PHP 8.2 CLI 설치를 하였다면 이제 위의 명령어를 입력하여 PHP CLI 버전을 변경해주시면 됩니다.

php - v

모든 과정이 끝났기 때문에 php -v 명령어를 입력하여 CLI PHP 버전을 확인하시면 됩니다. 제대로 설치가 되었다면 자신의 서버에 맞는 재시작 명령어를 입력하시면 됩니다.

버전이 서로 다르다고 큰 문제가 발생하지는 않지만 추후에 문제가 발생할 수 있기 때문에 PHP 버전은 동일하게 설정하는 것이 좋습니다.