Docker WordPress PHP 8.5 업데이트 보고서

1. 업데이트 목적

Ubuntu 서버에서 Docker로 운영 중인 WordPress의 PHP 버전을 PHP 8.5.12로 업데이트하고, 업데이트가 정상적으로 적용되었는지 확인합니다.

현재 compose.yml 설정이 다음과 같을 경우을 고려합니다.

wordpress:
  image: amd64/wordpress:7.1.3-php8.5-apache

이 방식은 PHP 소스 코드를 직접 다운로드하여 설치하는 방식이 아니라, PHP 8.5가 포함된 WordPress Docker 이미지를 사용하여 컨테이너를 교체하는 방식입니다.

2. 업데이트 작업 순서

1단계. 백업
WordPress 파일, 업로드 파일, 데이터베이스를 백업합니다.
⬇️
2단계. Compose 설정 변경
이미지 태그를 amd64/wordpress:7.1.3-php8.5-apache로 지정합니다.
⬇️
3단계. 이미지 다운로드
새 WordPress 이미지를 서버에 내려받습니다.
⬇️
4단계. 컨테이너 재생성
새 이미지를 적용하여 WordPress 컨테이너를 다시 생성합니다.
⬇️
5단계. 업데이트 확인
PHP 버전과 WordPress 웹사이트의 정상 작동을 확인합니다.

3. 실제 실행 명령어

다음 명령은 compose.yml이 있는 디렉터리에서 실행합니다.

① 현재 상태 확인

docker compose ps
docker exec -it myapp-wordpress-1 php -v

기존 PHP 버전을 기록해 두면 업데이트 전후를 비교하기 쉽습니다.

② 새 이미지 다운로드

docker pull amd64/wordpress:7.1.3-php8.5-apache

③ WordPress 컨테이너 재생성

docker compose up -d --force-recreate wordpress

이 명령은 wordpress 서비스 컨테이너를 재생성합니다. 데이터베이스 서비스까지 일괄적으로 재생성하는 명령은 아닙니다.

④ PHP 버전 확인

docker exec -it myapp-wordpress-1 php -v

출력 결과에서 다음 부분을 확인합니다.

PHP 8.5.12 (cli)
Zend Engine v4.5.12
with Zend OPcache v8.5.12

실제 패치 버전은 다운로드한 이미지에 따라 달라질 수 있습니다.

⑤ WordPress 웹사이트 확인

웹사이트 접속 및 로그인
글과 이미지 표시 확인
관리자 화면 확인
주요 플러그인과 테마 작동 확인
PHP 오류 로그 확인

docker logs --tail=100 myapp-wordpress-1

4. 주의사항

특히 amd64/wordpress:7.1.3-php8.5-apache는 특정 PHP 패치 버전을 영구적으로 고정하는 태그가 아닐 수 있습니다. 반드시 PHP 8.5.12를 사용해야 한다면, 이미지의 실제 PHP 버전을 확인하고 필요에 따라 검증된 이미지 다이제스트를 고정하는 방법을 고려하세요.

5. 최종 결론

이번 업데이트는 PHP를 컨테이너 내부에서 직접 설치하는 것이 아니라, PHP 8.5가 포함된 새 WordPress 이미지를 내려받아 컨테이너를 재생성하는 방법으로 진행하는 것이 핵심입니다.

백업 → 이미지 다운로드 → 컨테이너 재생성 → PHP 버전 확인 → 웹사이트 테스트 순서로 진행하면 됩니다.

Docker WordPress PHP 8.5.12 업데이트