케미클라우드 워드프레스에 2.3MB 테마를 올리다 "업로드한 파일은 php.ini의 upload_max_filesize 지시를 초과합니다" 오류가 났습니다. 원인은 PHP 기본값 그대로인 2M 한도였고, cPanel Select PHP Version의 Options 탭에서 upload_max_filesize와 post_max_size를 128M로 바꿔 해결했습니다. 도움말에는 기본값이 100M로 적혀 있어도 실제 값은 다를 수 있으니, 바꾸기 전에 지금 값을 확인하는 방법도 함께 적었습니다.
- 케미클라우드 SSH 키 등록 방법 — 공유호스팅에서 SSH 접속하는 법
- 케미클라우드 워드프레스 테마 업로드 오류 - upload_max_filesize 초과, 원인은 PHP 기본값 2M
케미클라우드 워드프레스에서 "업로드한 파일은 php.ini의 upload_max_filesize 지시를 초과합니다"가 뜨면, PHP의 파일 업로드 한도가 올리려는 파일보다 작게 잡혀 있다는 뜻입니다. 제 계정은 한도가 PHP 기본값인 2M였고, cPanel의 Select PHP Version에서 upload_max_filesize와 post_max_size를 128M로 바꾸니 바로 풀렸습니다.
최종 업데이트: 2026-10-26 · 환경: 케미클라우드 cPanel 138.0.18, PHP 8.4.27(CloudLinux alt-php), 워드프레스 7.1.3
2.3MB짜리 테마를 올리다가 막혔습니다
이번에 내가 개발한 H-style 테마를 배포용으로 손 본 후 기존에 내가 운영하는 워드프레스 사이트에 하나씩 적용해 보고 있습니다. 테스트겸 이 테마가 나름 최선을 다해서 개발한 최신 버전이기 때문입니다. 오늘 https://fullmazablog.com/ 블로그에 테마를 업로드 했는데 아래와 같이 용량제한에 걸렸다는 에러 메시지가 나오네요. 그러고 보니 지금까지 몇개 블로그에 적용했었는데 모두 카페24에 설치된 것이였고 오늘 이 블로그는 케미클라우드 해외호스팅에 있는 것이라 처음 에러를 발견했습니다.
파일이 2.3MB밖에 안 됐습니다. 수백 MB짜리 동영상도 아니고, 이 정도가 막힐 거라고는 생각을 못 했죠. 메시지에 php.ini라는 말이 들어 있어서 파일보다는 서버 설정 쪽을 먼저 보기로 했습니다.
이 계정에는 예전에 SSH 키를 등록해 둔 상태라, 같이 작업하던 AI 에이전트에게 서버에 직접 붙어서 값을 확인하게 했습니다. 아래 숫자는 그렇게 서버에서 찍어 본 값입니다.
2.3MB 테마는 왜 안 올라갔을까?
파일 하나의 업로드 한도가 2M로 잡혀 있었기 때문입니다. 2.3MB가 2M를 넘으니 PHP가 파일을 받지 않았고, 워드프레스는 그 결과를 이 메시지로 보여 준 겁니다.
저도 처음에는 이름이 비슷한 설정 두 개가 헷갈렸습니다. 제가 이해하기론 이렇습니다.
| 설정 | 쉽게 말하면 | 바꾸기 전 |
|---|---|---|
| upload_max_filesize | 파일 한 개가 넘을 수 없는 크기 | 2M |
| post_max_size | 한 번에 보내는 전체 데이터의 크기 (파일 포함) | 8M |
테마 zip은 파일 한 개라서 위쪽 값에 먼저 걸렸습니다.
2M는 누가 정해 둔 값일까?
누가 일부러 낮춰 둔 값은 아니었습니다. PHP가 처음부터 갖고 있는 기본값 그대로였습니다.
PHP 공식 문서에 적힌 기본값이 upload_max_filesize 2M, post_max_size 8M입니다. 서버의 PHP 설정 파일에도 같은 값이 그대로 들어 있었고, 사이트 폴더나 계정 설정에 이 값을 따로 바꿔 둔 곳은 없었습니다.
그런데 하나 이상한 점이 있었습니다. 케미클라우드 도움말 중 워드프레스 업로드 문제를 다룬 글에는 "케미클라우드의 기본값은 둘 다 100M"라고 적혀 있습니다(2024년 10월 16일 갱신). 제 계정에서 실제로 적용되던 값은 2M와 8M였고요. 왜 다른지는 확인하지 못했습니다. 도움말 숫자만 보고 넘어가지 말고 지금 값을 한 번 직접 보시는 게 좋겠습니다.
지금 한도는 어떻게 확인할까?
PHP 파일 하나를 잠깐 만들어 브라우저로 열어 보면 지금 적용 중인 값이 바로 나옵니다. 이번에 AI 에이전트가 쓴 방법도 이거였습니다.
<?php echo ini_get('upload_max_filesize'), ' / ', ini_get('post_max_size');이 한 줄을 아무 이름의 .php 파일로 저장해서 사이트 폴더에 올리고 주소창에서 열면 "2M / 8M"처럼 지금 값이 나옵니다. 설정 파일을 열어 보는 것보다 이게 더 정확한데, 웹사이트가 실제로 쓰는 값이 그대로 찍히기 때문입니다.
파일을 올리는 게 어렵다면 이 부분은 넘어가도 됩니다. 아래 cPanel 화면에서도 지금 값이 보입니다.
케미클라우드에서는 어디서 한도를 바꿀까?
cPanel의 Select PHP Version 화면에서 바꿉니다. 케미클라우드 도움말에도 서버의 php.ini를 직접 고치는 건 허용하지 않고 cPanel에서 바꾸라고 되어 있습니다.
- cPanel에 로그인해서 Software 묶음에 있는 Select PHP Version을 누릅니다.
- PHP Selector 화면이 열리면 Account Global Settings 탭에서 Options 탭으로 들어갑니다.
- 목록에서 upload_max_filesize를 찾아 값을 누르고 128M을 고릅니다.
같은 화면의 post_max_size도 128M으로 맞춥니다.
값을 바꾼 항목 아래에는 "Reset to default"라는 링크가 생깁니다. 나중에 원래대로 돌리고 싶으면 그걸 누르면 됩니다.
제일 작은 값이 128M인데, 이렇게 올려도 괜찮을까?
테마 파일을 올리는 용도라면 괜찮습니다. 128M는 "여기까지 받을 수 있다"는 상한선이라, 그보다 작은 파일을 올릴 때는 달라지는 게 없습니다.
사실 여기서 한 번 멈칫했습니다. 드롭다운을 열어 보니 고를 수 있는 값이 128M, 256M, 512M, 1G 네 개뿐이었고, 제일 작은 게 128M였거든요. 기본이 2M인데 변경하려니 최저가 128M라 망설여 질 수 밖에 없었습니다. 설정 잘못해서 함께 사용하는 공유호스팅에 문제가 있는건 아닐까란 생각이 솔지히 먼저 들긴 했습니다. 그런데 알아보니 나의 기우였습니다. 알아보고 나서 정리한 건 이렇습니다.
- 2M는 누가 일부러 정한 값이 아니었습니다. 위에서 본 것처럼 PHP 기본값 그대로였습니다.
- 128M는 상한선입니다. 공식 문서에도 upload_max_filesize는 "업로드되는 파일의 최대 크기"라고만 되어 있습니다.
- 테마 업로드는 관리자로 로그인해야 쓰는 기능입니다. 한도를 올렸다고 방문자가 큰 파일을 올릴 수 있게 되는 건 아닙니다.
그래서 128M로 진행했습니다.
바꾼 뒤 값은 어떻게 달라졌을까?
둘 다 128M로 바뀌었습니다. 앞에서 쓴 확인용 파일을 다시 열어 보니 이렇게 나왔습니다.
| 설정 | 바꾸기 전 | 바꾼 뒤 |
|---|---|---|
| upload_max_filesize | 2M | 128M |
| post_max_size | 8M | 128M |
둘을 같은 값으로 둬도 되는지는 문서마다 말이 조금 다릅니다. PHP 공식 문서는 큰 파일을 올리려면 post_max_size가 upload_max_filesize보다 커야 한다고 하고, 케미클라우드 도움말은 둘을 같게 두거나 post_max_size를 조금 더 크게 두라고 합니다. 몇 MB짜리 테마에는 어느 쪽이든 상관없습니다. 128MB에 가까운 파일을 올릴 일이 생기면 그때 post_max_size를 256M으로 한 단계 올리면 됩니다.
역시 문제가 용량제한이 맞았나 봅니다. 다시 H-style 테마를 업로드 했는데 문제없이 설치되어 지금 세부적인 부분을 조정하고 있습니다.
놓치기 쉬운 점 3가지
- post_max_size도 같이 올려야 합니다. upload_max_filesize만 올리면 한 번에 보내는 전체 크기에서 다시 막힐 수 있습니다.
- Account Global Settings 탭은 계정 전체에 적용됩니다. 화면 위쪽에 "These settings apply to all your domains by default"라는 안내가 있습니다. 사이트 하나만 다르게 하고 싶으면 옆의 Per Domain Settings 탭을 씁니다.
- 도움말의 기본값과 내 계정의 실제 값이 다를 수 있습니다. 도움말에는 100M로 나와 있었지만 제 계정은 2M였습니다. 바꾸기 전에 지금 값부터 확인하는 편이 헷갈리지 않습니다.
자주 묻는 질문
마무리
처음엔 무슨 문제가 있나 싶었는데, 원인은 PHP 기본값 2M 하나였습니다. 케미클라우드 신청 후 가장 먼저 설정변경을 해야 할 것 같아요. 요즘 블로그 업로드를 2M로 제한해 두면 어떤 사진도 못올릴것 같은데요? 핸드폰으로 사진 찍으면 4~5M가 기본인데 시대에 너무 역행하는것 아닌가 싶기도 하고 공유호스팅이니까 가장 최저값으로 세팅하고 필요한 사람만 설정값 변경해서 사용하세요~라는 운영자 입장도 이해가 되긴 합니다. 그래서 다시 정리하면 케미클라우드에서 워드프레스를 새로 세팅하신다면 테마를 올리기 전에 Select PHP Version 화면부터 한번 열어 보시는 걸 권합니다. 호스팅을 새로 알아보는 중이라면 얼마 전 정리한 케미클라우드 2026 블랙프라이데이 가격과 조건도 같이 보시면 좋겠습니다.
참고한 자료
- PHP 공식 문서 - php.ini 핵심 지시어 - upload_max_filesize·post_max_size 기본값(2M·8M)과 두 값의 관계 (2026-10-26 확인)
- ChemiCloud - How to Increase the upload_max_filesize Limit in cPanel - Select PHP Version에서 바꾸는 순서, php.ini 직접 수정 불가 (2023-01-16 갱신, 2026-10-26 확인)
- ChemiCloud - How To Fix WordPress Image Upload Issues - 기본값 100M 안내, 두 값을 같게 또는 post_max_size를 조금 크게 (2024-10-16 갱신, 2026-10-26 확인)