워드프레스, 테마, 플러그인의 설치나 업데이트가 실패하는 경우 확인 사항
웹호스팅 서버 디스크 공간 부족
업로드 실패 관련 문제는 많은 경우 웹호스팅 디스크 공간 부족으로 인해 발생할 수 있습니다. 특히 카페24의 저가 호스팅이나 닷홈 무료 호스팅을 이용하는 경우 워드프레스 테마를 설치하고 이미지 몇 개를 올리면 금방 디스크 공간이 소진될 수 있습니다.
먼저 웹호스팅 업체 사이트에 로그인하여 디스크 공간이 충분한지 확인하시기 바랍니다. 카페24에서는 호스팅관리 > 사용량 모니터링에서 디스크와 트래픽 사용량을 확인할 수 있습니다.
만약 디스크(웹하드) 용량이 얼마 남지 않았다면 디스크 용량을 추가하거나 웹호스팅 상품을 업그레이드할 수 있습니다.
업로드하는 파일의 크기가 큰 경우
업로드하려는 파일의 크기가 서버에서 제한하는 최대 파일 크기를 초과하는 경우 설치/업데이트/업로드가 실패할 수 있습니다.
최대 파일 업로드 크기는 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
일부 호스팅에서는 이 설정값을 변경하지 못할 수도 있습니다. 잘 안 되면 웹호스팅 업체에 문의하도록 합니다.
권한 문제
폴더 권한 문제 때문에 파일 업로드가 잘 안 되는 경우가 있습니다. 요즘에는 이런 문제가 거의 없지만, 몇 년 전만 하더라도 일부 호스팅 업체들의 기술이 부족하여 권한(퍼미션; permission) 문제가 종종 발생했습니다.
서버를 직접 운영하는 경우, 이런 문제의 상당수는 잘못된 소유권(privilege) 설정과 관련되어 있습니다. 이 경우 서버 관리자에게 문의하여 권한 설정을 올바르게 수정해달라고 요청해야 합니다.
웹호스팅을 이용하는 경우 폴더의 설정을 755로 설정해야 합니다. 777은 보안상 안전하지 않으므로 권장하지 않습니다. 권한 설정이 의심되면 웹호스팅에 연락하여 상의해보는 것이 좋을 듯 합니다. (직접 서버를 운용하는 경우에는 직접 해결해야 합니다.)
아마존 AWS/라이트세일 등의 VPS 서버에 워드프레스를 설치하여 사용하는 경우, 파일/폴더의 소유권/권한이 잘못되어 이런 문제가 종종 나타납니다. http 소유자 설정이 잘못되는 경우가 있습니다. Ubuntu의 경우 보통 www-data이지만, 서버에 따라 조금씩 다를 수 있습니다. 예를 들어, 다음과 같은 명령어를 통해 폴더의 ownership을 설정해줄 수 있습니다.
sudo chown -R www-data:www-data wordpress/
sudo usermod -a -G www-data www-data
잘 안 되는 경우 서버 관리자에게 연락하여 문제 해결을 시도해보시기 바랍니다.
실행 시간 초과
max_execution_time 설정 값이 작은 경우에도 워드프레스, 테마, 플러그인의 설치/업데이트가 실패할 수 있습니다. "fatal error: maximum execution time exceeded" 혹은 시간 초과 (타임아웃) 관련 오류 메시지가 표시될 수 있습니다. 이 경우 max_execution_time 설정 값을 높여보시기 바랍니다.
php.ini 파일에 접근이 가능하면 다음 설정을 변경하거나 추가해보십시오.
max_execution_time = 600
php.ini 파일에 접근할 수 없는 경우 .htaccess 파일에 다음 라인을 추가할 수 있습니다.
php_value max_execution_time 600
플러그인 충돌 문제
플러그인 충돌 때문에 이와 같은 문제가 발생하는 경우가 있습니다. 모든 플러그인을 비활성화한 후에도 문제가 발생하는지 확인해보시기 바랍니다.
문제를 일으키는 플러그인을 찾으면 삭제하고, 비슷한 기능의 다른 플러그인으로 대체하는 것은 좋습니다.