최근에 오랫동안 사용하지 않았던 웹호스팅(미리넷)에 설치된 워드프레스를 업그레이드하려고 했습니다. 하지만 업그레이드를 진행하려고 하니 웹호스팅에서 지원하는 PHP 버전이 낮아 최신 워드프레스 설치가 불가능하다는 문제에 직면했습니다.
1. 문제 발생
- 웹호스팅의 PHP 버전이 7.0으로 확인됨
- 최신 워드프레스(6.7.2)는 PHP 7.2.24 이상이 필요하여 설치 불가
- PHP 업그레이드가 불가능한 환경이므로, PHP 7.0에서 설치할 수 있는 마지막 워드프레스 버전 확인 필요
2. 설치 가능한 워드프레스 버전 확인
- 워드프레스 공식 사이트에서 확인한 결과, 워드프레스 5.2까지 PHP 7.0에서 동작 가능
- 그중에서 가장 최신 패치 버전인 5.2.21을 선택하여 업그레이드 진행
3. 워드프레스 5.2.21 다운로드
- 공식 릴리즈 아카이브에서 해당 버전 다운로드:
워드프레스 5.2.21 다운로드
4. 기존 데이터 백업
업그레이드 과정에서 문제가 발생할 수 있으므로 기존 데이터를 백업합니다.
# 원본 폴더 백업
cd /var/www/html/
tar -cvzf chuncheon_20250307.tar.gz ./chuncheon/
추가적으로 중요한 파일을 개별 백업합니다.
- wp-config.php
- wp-content 폴더
- 그리고 개인이 가져다 놓은 파일 (구글 검색 인증 파일, .htaccess 파일 등)
플러그인과 테마에서 충돌이 발생할 가능성이 있으므로 모든 플러그인을 비활성화합니다.
5. 워드프레스 업그레이드 과정
1) 신규 워드프레스 압축 해제
cd html
tar xvzf wordpress-5.2.21-ko_KR.tar.gz
2) 워드프레스 업그레이드
cd wordpress # 신규버전 압축 풀린 폴더로 이동
rm -Rf wp-content # 신규버전 콘텐츠 폴더 삭제
cd ..
mv wordpress chuncheon # 새로설치된 워드프레스 폴더를 기존폴더로 이동
cd chuncheon
cd wordpress/
mv * ../ # 새로 설치된 파일들을 기존운용 폴더로 디렉토리로 이동
cd ..
rm -Rf wordpress/ # 불필요한 폴더 삭제
6. 워드프레스 데이터베이스 업데이트
업그레이드 후 웹사이트의 데이터베이스도 업데이트해야 합니다. 웹 브라우저 주소창에 아래의 URL을 입력하여 업데이트를 진행합니다.
https://도메인.com/wp-admin/upgrade.php
업데이트가 완료되면, 비활성화했던 플러그인을 다시 활성화합니다.
7. 업그레이드 완료 확인
설정 화면에서 정상적으로 업그레이드되었음을 확인했습니다.
워드프레스 5.2.21이(가) MaidenHair 테마를 사용하고 있습니다.
이번 작업을 통해, PHP 버전이 낮아 최신 워드프레스 설치가 불가능한 경우에도 적절한 버전을 선택하여 업그레이드할 수 있음을 확인했습니다. PHP 업그레이드가 불가능한 환경에서는, 워드프레스 공식 사이트에서 해당 PHP 버전에서 실행 가능한 최신 버전을 찾아 설치하는 것이 좋은 해결책이 될 수 있습니다.