PHP 설정 조정으로 파일 업로드 제한을 필요한 만큼 늘립니다

워드프레스 파일 업로드 용량 제한 늘리기가 필요했던 건 병원 원무팀이 설명서 PDF(8MB)를 올리려는데 “업로드 파일 크기가 허용된 최대 크기를 초과합니다”라는 오류가 났을 때였습니다. 기본 워드프레스는 PHP 설정에 따라 2MB~8MB로 제한이 걸려 있습니다. 의료 이미지나 문서는 이 제한을 쉽게 넘기 때문에 실무에서 자주 마주치는 문제입니다.

현재 업로드 제한 확인

관리자 → 미디어 → 새 파일 추가
→ 하단에 "최대 업로드 파일 크기: X MB" 표시

또는 phpinfo()에서 upload_max_filesize, post_max_size, max_execution_time 값 확인.

php.ini에서 설정 변경 (권장)

sudo nano /etc/php/8.1/fpm/php.ini

upload_max_filesize = 32M    ; 기본 2M → 32M
post_max_size = 64M          ; upload_max_filesize보다 크게
max_execution_time = 300     ; 큰 파일 업로드 시 시간 여유
max_input_time = 300
memory_limit = 256M

post_max_size는 업로드 파일 크기 + 기타 POST 데이터를 포함하므로 upload_max_filesize보다 크게 설정합니다.

변경 후 PHP-FPM 재시작:

sudo systemctl restart php8.1-fpm

.htaccess에서 설정 (Apache, 공유 호스팅)

php.ini를 직접 수정할 수 없는 공유 호스팅에서 사용합니다.

# .htaccess 파일에 추가
php_value upload_max_filesize 32M
php_value post_max_size 64M
php_value max_execution_time 300

wp-config.php에서 설정 (일부 호스팅)

@ini_set('upload_max_filesize', '32M');
@ini_set('post_max_size', '64M');

설정이 적용됐는지 확인

변경 후 미디어 → 새 파일 추가 페이지에서 최대 업로드 파일 크기가 변경됐는지 확인합니다. 변경 전 캐시가 남아 있으면 캐시를 지우거나 브라우저를 새로 고침하세요.

용량 제한을 무작정 크게 늘리는 것보다는 실제 업무에서 필요한 크기(예: 32MB)로 적당히 설정하는 것이 좋습니다. 너무 큰 파일 업로드는 서버 메모리와 처리 시간에 부하를 줍니다.