워드프레스, 테마, 플러그인의 설치나 업데이트가 실패하는 경우

0

근래 들어 워드프레스나 테마, 플러그인을 설치하거나 업데이트할 때 오류가 발생하는 문제와 관련된 질문이 많이 올라와서 이와 관련된 문제를 해결하는 방법을 정리해보았습니다.

이 블로그의 이전 글에서도 비슷한 문제를 다루었지만 개별적인 문제(예: 워드프레스 테마 설치 오류)에 대해 설명하고 있습니다. 다음과 같은 문제의 경우 원인과 해결 방법은 비슷합니다.

  1. 워드프레스 코어 설치/업데이트 실패
  2. 워드프레스 테마/데모 설치/업데이트 실패
  3. 워드프레스 플러그인 설치/업데이트 실패
  4. 이미지 업로드 실패

이와 관련하여 다음과 같은 오류 메시지가 표시될 수 있습니다.

Your browser sent a request that this server could not understand.

– 또는 –

업로드된 파일이 wp-content/uploads/2018/06 로 옮겨질 수 없습니다

– 또는 –

https://downloads.wordpress.org/release/ko_KR/wordpress-4.9.6.zip로부터 업데이트 다운로드.
업데이트 압축 푸는 중.
디렉터리를 생성할 수 없습니다.
설치 실패

이와 같은 문제가 발생하는 경우 다음 사항을 체크해보시기 바랍니다. 아래의 방법으로 대부분의 문제가 해결될 수 있지만, 모든 문제가 해결될 것이라고 보장하지 않으며 특정 문제는 해결되지 않을 수도 있습니다.

웹호스팅 디스크 공간 부족

업로드 실패 관련 문제는 많은 경우 웹호스팅 디스크 공간 부족으로 인해 발생할 수 있습니다. 특히 카페24의 저가 호스팅이나 닷홈 무료 호스팅을 이용하는 경우 워드프레스 테마를 설치하고 이미지 몇 개를 올리면 금방 디스크 공간이 소진될 수 있습니다.

먼저 웹호스팅 업체 사이트에 로그인하여 디스크 공간이 충분한지 확인하시기 바랍니다. 카페24에서는 호스팅관리 > 사용량 모니터링에서 디스크와 트래픽 사용량을 확인할 수 있습니다.

카페24에서 디스크 용량 확인하기

만약 디스크(웹하드) 용량이 얼마 남지 않았다면 디스크 용량을 추가하거나 웹호스팅 상품을 업그레이드할 수 있습니다. 저렴하게 괜찮은 호스팅을 이용하고 싶은 경우 우리나라에 잘 알려진 해외 호스팅 중 하나인 블루호스트 공유호스팅을 고려해볼 수 있습니다(“해외 웹호스팅 서비스 – 블루호스트(Bluehost) 소개” 참고).

업로드하는 파일의 크기가 큰 경우

업로드하려는 파일의 크기가 서버에서 제한하는 최대 파일 크기를 초과하는 경우 설치/업데이트/업로드가 실패할 수 있습니다.

최대 파일 업로드 크기는 phpinfo 페이지를 만들어 쉽게 확인이 가능합니다. 즉, FTP에 접속하여 루트 폴더에 새 파일을 하나 만들고 다음 코드를 추가합니다.

<?php phpinfo(); ?>

파일 이름을 info.php 파일로 지정합니다(혹은 임의의 원하는 이름으로 지정 가능). 브라우저에 http://www.example.com/info.php를 입력하여 파일 업로드 크기 등을 확인할 수 있습니다.

더 간단한 방법은 워드프레스 관리자 페이지에서 미디어 > 파일 올리기를 클릭하면 업로드 가능한 최대 파일 크기를 확인할 수 있습니다.

파일 업로드 크기 확인

최대 업로드 파일 크기가 너무 작으면 여러 가지 방법으로 이 설정을 늘릴 수 있으며 웹호스팅 업체에 따라 방법이 다를 수 있습니다. 먼저 php.ini 파일에 접근이 가능하면 다음 설정값을 변경하거나 추가합니다.

upload_max_filesize = 64M
post_max_size = 64M
file_uploads = On

php.ini 파일에 접근할 수 없는 경우 .htaccess 파일에 다음 라인을 추가할 수 있습니다.

php_value upload_max_filesize 64M
php_value post_max_size 64M

일부 호스팅에서는 이 설정값을 변경하지 못할 수도 있습니다. 잘 안 되면 웹호스팅 업체에 문의하도록 합니다.

권한 문제

폴더 권한 문제 때문에 파일 업로드가 잘 안 되는 경우가 있습니다. 요즘에는 이런 문제가 거의 없지만, 1~2년 전만 하더라도 일부 호스팅 업체들의 기술이 부족하여 권한(퍼미션; permission) 문제가 종종 발생했습니다.

서버를 직접 운영하는 경우, 이런 문제의 상당수는 잘못된 소유권(privilege) 설정과 관련되어 있습니다. 이 경우 서버 관리자에게 문의하여 권한 설정을 올바르게 수정해달라고 요청해야 합니다.

웹호스팅을 이용하는 경우 폴더의 설정을 755로 설정해야 합니다. 777은 보안상 안전하지 않으므로 권장하지 않습니다. 권한 설정이 의심되면 웹호스팅에 연락하여 상의해보는 것이 좋을 듯 합니다. (직접 서버를 운용하는 경우에는 직접 해결해야 합니다.)

실행 시간 초과

max_execution_time 설정 값이 작은 경우에도 워드프레스, 테마, 플러그인의 설치/업데이트가 실패할 수 있습니다. “fatal error: maximum execution time exceeded” 혹은 시간 초과 (타임아웃) 관련 오류 메시지가 표시될 수 있습니다. 이 경우 max_execution_time 설정 값을 높여보시기 바랍니다.

php.ini 파일에 접근이 가능하면 다음 설정을 변경하거나 추가해보십시오.

max_execution_time = 300

php.ini 파일에 접근할 수 없는 경우 .htaccess 파일에 다음 라인을 추가할 수 있습니다.

php_value max_execution_time 300

사이트그라운드의 경우 다음 글을 참고해보세요.

호스팅에 따라 이 설정을 변경하지 못할 수도 있습니다.

플러그인 충돌 문제

플러그인 충돌 때문에 이와 같은 문제가 발생하는 경우가 있습니다. 모든 플러그인을 비활성화한 후에도 문제가 발생하는지 확인해보시기 바랍니다.

문제를 일으키는 플러그인을 찾으면 삭제하고, 비슷한 기능의 다른 플러그인으로 대체하는 것은 좋습니다.

마치며

이상으로 워드프레스, 테마, 플러그인의 설치나 업데이트가 실패하는 문제가 발생하는 경우에 대처할 수 있는 방법에 대해 살펴보았습니다.

여러 가지 조치에도 불구하고 문제가 잘 해결되지 않으면 여기에서 유료 서비스를 의뢰할 수 있습니다.

Related Posts