본문 바로가기
IT

Ubuntu 환경에서 PHP 업그레이드 하기

by haul-studio 2025. 2. 26.

 

 

Ubuntu 환경에서 PHP 업그레이드 하기 - Haul's Tech Insigts

Ubuntu에서 PHP 버전을 업그레이드하는 방법은 다음과 같습니다. 이 과정은 현재 PHP 버전을 확인하고, 새로운 버전을 설치하며, 필요시 기본 PHP 버전을 변경하는 작업을 포함합니다. 1....

www.haul.kr

 

Ubuntu에서 PHP 버전을 업그레이드하는 방법은 다음과 같습니다. 이 과정은 현재 PHP 버전을 확인하고, 새로운 버전을 설치하며, 필요시 기본 PHP 버전을 변경하는 작업을 포함합니다.

 


 

1. 현재 PHP 버전 확인

 

명령어:

 

php -v

 

  • 현재 설치된 PHP 버전이 출력됩니다.

 


 

2. PHP 저장소 추가

 

Ubuntu 기본 저장소에는 최신 PHP 버전이 포함되지 않을 수 있으므로 Ondřej Surý PPA 저장소를 추가해야 합니다.

 

명령어:

 

sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update

 


 

3. PHP의 특정 버전 설치

 

예: PHP 8.2 설치

 

sudo apt install php8.2

 

PHP와 함께 사용할 모듈도 필요하면 함께 설치합니다. 예:

 

sudo apt install php8.2-cli php8.2-fpm php8.2-mysql php8.2-curl php8.2-xml php8.2-mbstring php8.2-zip php8.2-soap

 


 

4. 기본 PHP 버전 변경

 

Ubuntu에는 여러 PHP 버전이 동시에 설치될 수 있으므로 update-alternatives 명령어로 기본 버전을 변경합니다.

 

명령어:

 

sudo update-alternatives --config php

 

  • 여러 PHP 버전 목록이 표시됩니다.
  • 기본으로 사용할 PHP 버전 번호를 선택합니다.

 


 

5. Apache와 PHP 연결 재설정 (Apache 사용 시)

 

PHP 모듈 활성화:

 

sudo a2enmod php8.2

 

Apache 재시작:

 

sudo systemctl restart apache2

 


 

6. Nginx와 PHP 연결 재설정 (Nginx 사용 시)

 

Nginx는 PHP-FPM을 사용하므로, 새 버전의 PHP-FPM 설정 파일을 업데이트해야 합니다.

 

PHP-FPM 서비스 활성화:

 

sudo systemctl enable php8.2-fpm
sudo systemctl restart php8.2-fpm

 

Nginx 설정 파일 업데이트:

 

  • /etc/nginx/sites-available/default 또는 관련 Nginx 설정 파일을 편집합니다.
  • 기존 PHP-FPM 소켓 경로를 새 버전에 맞게 수정합니다: fastcgi_pass unix:/run/php/php8.2-fpm.sock;

 

Nginx 재시작:

 

sudo systemctl restart nginx

 


 

7. 설치 확인

 

PHP 버전 확인:

 

php -v

 

Apache/Nginx + PHP 확인:

 

  1. 웹 서버의 루트 디렉토리(/var/www/html/ 등)에 info.php 파일 생성: <?php phpinfo();
  2. 브라우저에서 http://yourdomain/info.php로 접속하여 PHP 버전을 확인합니다.

 


 

8. 필요 없는 PHP 버전 제거 (선택사항)

 

사용하지 않는 이전 PHP 버전을 제거하여 공간을 확보할 수 있습니다.

 

예: PHP 7.4 제거

 

sudo apt purge php7.4*

 


 

주의 사항:

 

  • PHP 버전 업그레이드 시, 호환성 문제로 인해 기존 PHP 코드나 플러그인이 제대로 작동하지 않을 수 있으므로 반드시 테스트 환경에서 먼저 확인하세요.
  • 중요 웹 애플리케이션은 업그레이드 전 백업을 수행하는 것이 좋습니다.
  • PHP 최신 버전을 지원하려면 Ubuntu 20.04 (Focal Fossa) 이상을 사용하는 것이 좋습니다.

출처: https://www.haul.kr/2025/01/%ec%9a%b0%eb%b6%84%ed%88%ac%ec%97%90%ec%84%9c-php-%ec%97%85%ea%b7%b8%eb%a0%88%ec%9d%b4%eb%93%9c-%ed%95%98%ea%b8%b0/