워드프레스에서 PHP 파일 저장 시 오류 발생
워드프레스에서 functions.php와 같은 PHP 파일을 수정한 뒤 저장하려고 하면 아래와 같은 오류가 나타나는 경우가 있다.
Unable to communicate back with site to check for fatal errors, so the PHP change was reverted.
You will need to upload your PHP file change by some other means, such as by using SFTP.
처음 보면 PHP 코드에 문제가 생긴 것처럼 보이지만, 사실 이 오류 메시지 자체는 특정 원인을 알려주는 에러는 아니다.
구글 검색만 해봐도 플러그인 충돌, 테마 오류, PHP 버전 호환성 문제, 서버 방화벽 설정, 보안 플러그인, 웹 접근 제한 등 다양한 이유로 동일한 메시지가 나타나는 것을 확인할 수 있다.
즉, 이 오류가 발생했다고 해서 무조건 PHP 코드가 잘못된 것은 아니다. 워드프레스가 변경 사항을 저장한 뒤 정상적으로 동작하는지 확인하는 과정에서 문제가 발생하면 같은 메시지가 표시될 수 있다.
이번 글에서는 내가 실제로 겪은 사례와 해결 과정을 간단히 정리해 보려고 한다. 참고로 아래 내용은 하나의 사례일 뿐이며, 모든 환경에 동일하게 적용되는 정답은 아닐 수 있다.
언제 발생했나?
내 경우에는 PHP 버전을 업그레이드한 직후 워드프레스 관리자 화면의 테마 파일 편집기에서 functions.php 파일을 수정할 때 해당 오류가 발생했다.
처음에는 PHP 버전이 변경되면서 기존 코드가 더 이상 호환되지 않는 것으로 생각했다. 하지만 코드를 수정하지 않고 저장 버튼만 눌러도 동일한 오류가 발생했다.
그래서 코드 자체보다는 서버 설정이나 접근 권한 문제일 가능성이 높다고 판단했다.
확인해 본 내용
우선 functions.php 파일 자체에 문제가 있는지 확인하기 위해 FileZilla를 이용해 파일을 다운로드한 뒤 수정 후 다시 업로드해 보았다.
그 결과 SFTP를 통한 업로드는 정상적으로 동작했다. 즉, 파일 자체에 심각한 문제가 있는 것은 아니었다.
반면 워드프레스 관리자 화면에서 저장할 때만 동일한 오류가 반복적으로 발생했다.
내 환경에서 확인한 원인
서버 설정을 하나씩 확인하던 중 PHP 업그레이드 이후 카페24의 호스팅관리 > 보안관리에서 특정 디렉토리 웹 접근 제한 설정이 적용된 것을 발견했다.
특히 wp-admin 폴더가 접근 제한이 설정되어 있었는데, 이를 해제한 뒤 다시 저장을 시도하자 오류 없이 정상적으로 저장되었다.
워드프레스는 파일을 저장한 뒤 정상 동작 여부를 확인하기 위해 자체적으로 웹 요청을 보내는데, 웹 접근을 특정 IP만 허용하도록 설정한 상태에서는 이 과정이 실패할 수 있는 것으로 보인다.
실제로 내 IP만 허용한 상태에서는 계속 오류가 발생했지만, 국내 접속 허용 방식으로 변경한 뒤에는 정상적으로 저장이 가능했다.
정확한 내부 동작까지 확인한 것은 아니지만, 내 환경에서는 웹 접근 제한 설정과 워드프레스의 저장 후 검증 과정이 충돌하면서 발생한 문제로 판단된다.
해결 방법
- FileZilla 등 SFTP 프로그램으로 파일을 다운로드한다.
- 파일을 수정한 뒤 다시 업로드한다.
- 워드프레스 관리자 화면에서만 오류가 발생하는지 확인한다.
- 서버 또는 호스팅의 웹 접근 제한 설정을 점검한다.
- wp-admin 관련 접근 제한이 있는 경우 해제 후 테스트해 본다.
정리
이 오류 메시지는 특정 원인을 의미하는 에러가 아니라 워드프레스가 변경 사항을 확인하는 과정에서 문제가 발생했을 때 나타나는 공통 메시지에 가깝다.
따라서 플러그인, 테마, PHP 버전, 서버 설정 등 다양한 원인이 있을 수 있으며, 환경에 따라 해결 방법도 달라질 수 있다.
내 경우에는 웹 접근 제한 설정이 원인이었던 것으로 보였으며, 접근 제한을 조정한 뒤 정상적으로 저장할 수 있었다. 만약 같은 오류를 겪고 있다면 코드만 의심하기보다는 서버 설정과 접근 권한도 함께 확인해 보는 것을 추천한다.