"업로드한 파일은 php.ini의 upload_max_filesize 지시를 초과합니다" 오류 해결 방법?

플러그인을 업로드 하는데 "업로드한 파일은 php.ini의 upload_max_filesize 지시를 초과합니다" 라는 오류가 발생한 경우는 업로드하려는 플러그인 파일의 크기가 PHP 설정에서 허용하는 최대 업로드 크기를 초과해서 발생하는 문제입니다. 예를 들어 서버의 upload_max_filesize가 2MB로 설정되어 있는데, 플러그인 파일이 10MB라면 이 오류가 나타납니다.

ChemiCloud 공유 호스팅에서는 아래 방법들로 해결할 수 있습니다. 제가 사용하는 방법을 경험을 바탕으로 공유합니다.

왜 이런 일이 발생할까?

이번에 업로드 시도했던 플러그인 파일 사이즈를 확인해보니 3.5MB밖에 안 되는 파일인데 이 오류가 나서 깜짝 놀랐습니다. 큰 사이즈도 아닌데 이런 에러가 나는 것은 너무 한것 아닌가? 란 생각도 들고요. 핵심 원인은 php.ini의 upload_max_filesize 기본값이 2MB로 설정되어 있는 경우가 많기 때문입니다.

즉, 호스팅 서버의 PHP 설정에서 허용하는 업로드 최대 크기가 2MB로 잡혀 있으면, 3.5MB 파일은 당연히 거부됩니다.

현재 설정 확인 방법

WordPress 관리자 페이지에서 미디어 → 새로 추가 화면 하단에 "최대 업로드 파일 크기: 2MB" 같은 문구가 보일 겁니다. 이걸 먼저 확인해 보세요. 제 경우 확인해보니 정말 최대 업로드 파일 크기: 2MB 라고 되어 있네요.

케미클라우드(ChemiCloud) 공유 호스팅에서 해결하는 방법

방법 1: .htaccess 파일 수정

WordPress 루트 디렉토리의 .htaccess 파일 맨 위에 다음을 추가하세요:

<IfModule Litespeed>
php_value upload_max_filesize 128M
php_value post_max_size 128M
php_value max_execution_time 300
</IfModule>

파일매니저(File Manager) 접속

.htaccess 파일을 수정하기 위해서는 먼저 Cpanel에서 파일 매니저 접속을 합니다.

내 계정 폴더로 이동

케미클라우드에 사이트가 1개 밖에 없다면 public_html 로 이동하면 되고 추가로 사이트를 여럿 개설 했다면 해당 도메인 폴더로 이동하면 됩니다.

.htaccess 파일은 어떻게 찾을까요?

계정 폴더로 이동 후 .htaccess 파일을 찾아야 합니다. 만약 보이지 않는다면 우측 상단의 Settings > Show Hidden Files를 체크하면 숨김 파일이 모두 보여지기 때문에 찾을 수 있을 것입니다.

파일 편집기로 열기는 어떻게 할까요?

.htaccess 파일을 선택 후 오른쪽 마우스를 클릭하면 아래와 같이 메뉴가 나오면 Edit(편집)을 선택합니다. 선택하면 경고창 비슷하게 나오는데 그냥 무시하고 Edit 버튼을 클릭하면 편집기가 나옵니다.

편집하기

# Begin Wordpress 바로 위에 아래 내용을 복사해서 붙여 넣으세요. 케미클라우드는 Litespeed 를 사용하기 때문에 아래와 같이 추가 후 우측 상단 “Save Changes”를 클릭해 저장하기를 하면 끝납니다.

<IfModule Litespeed>
php_value upload_max_filesize 128M
php_value post_max_size 128M
php_value max_execution_time 300
</IfModule>

방법 2: FTP/SFTP로 플러그인 직접 업로드

위 방법으로 안되면 가장 확실한 방법은 PHP 설정을 변경하지 않고 우회하는 방법입니다.

1. 플러그인 ZIP 파일을 PC에서 압축 해제
2. cPanel File Manager 또는 FTP 프로그램(FileZilla 등)으로 접속
3. /wp-content/plugins/ 폴더 안에 압축 해제한 플러그인 폴더를 통째로 업로드
4. WordPress 관리자 → 플러그인 목록에서 해당 플러그인 활성화

이 방법은 PHP 업로드 제한과 무관하게 작동하므로, 설정 변경이 어려울 때 가장 확실한 방법입니다.

정리하며 마무리…

케미클라우드 이용하면서 파일 크기 때문에 오류가 생긴다면 위와 같은 방법으로 해결 할 수 있습니다. 몰라서 그렇지 알고나면 어렵지 않으니 차근차근 하나씩 배워 가요.