PHP 환경 설정 파일(php.ini) 수정 방법

이승일 · November 2019

PHP 언어를 사용하는 웹기반 시스템(ex: Omeka, AtoM 등)에서 파일 업로드시 기본 크기가 2Mb로 제한되어 있는 경우 아래와 같이 서버에 설치한 PHP의 기본 환경을 수정하시면 파일 업로드 크기를 상향 조정할 수 있습니다.

1. 터미널 접속 프로그램(ex: Putty)으로 원격지 서버 접속

*주의사항 : 우분투 서버 운영체제 기준입니다. 타 운영체제는 경로가 다를 수 있습니다.

2. 터미널용 nano 에디터로 PHP 환경설정 파일 열기(PHP 7 버젼 기준)

$ sudo nano /etc/php/7.0/apache2/php.ini

*주의사항 : PHP 5 버젼은 아래 명령어 사용.

$ sudo nano /etc/php5/apache2/php.ini

3. PHP 환경설정 수정(아래의 라인 찾아서 수정)

아래의 라인을 찾은 후 용량을 원하는 크기로 수정

[수정 전]

upload_max_filesize = 2M

[수정 후]

upload_max_filesize = 100M

[수정 전]

post_max_size = 8M

[수정 후]

post_max_size = 150M

[수정 전]

memory_limit = 128M

[수정 후]

memory_limit = 256M

*주의사항 : memory_limit > post_max_size > uplad_max_filesize 순으로 설정

4. 수정 완료 후 파일 저장

Ctrl키와 영문 o 를 함께 누르면 파일 저장됨.

에디터 모드를 빠져나오려면 Ctrl키와 영문 x 를 함께 누르면 됨

5. Apache(웹 구동용 소프트웨어) 서비스 재시작

$ sudo /etc/init.d/apache2 restart

6. Omeka 또는 AtoM 관리자 모드에서 원하는 크기의 파일 업로드 가능한지 테스트

# php.ini 수정시 참고할 사항

- 파일 업로드 허용 여부 설정

file_uploads = On //On 또는 Off로 설정

- 파일 업로드 사이즈의 최대 크기 설정

upload_max_filesize = 2M //최대 2048M 이하로 설정

- 파일 업로드 최대 개수 설정

max_file_uploads = 20 //한 번에 함께 올릴 수 있는 파일 개수 설정

- post 방식으로 업로드시의 파일의 최대 크기 설정

post_max_size = 8M //최대 2048M 이하로 설정

- 스크립트 페이지(*.php)의 최대 실행 시간 설정

max_execution_time = 180 //초 단위로 설정. 무제한은 0으로 설정

- 스크립트 페이지로 넘어오기전 PHP엔진이 post로 전달된 데이터를 처리하는 시간 설정

max_input_time = 60 //초 단위로 설정. 무제한은 -1로 설정

- 스크립트가 사용할 수 있는 최대 메모리 사용량 설정

memory_limit = 128M //memory_limit > post_max_size > uplad_max_filesize 순으로 설정

- 시간대 설정

date.timezone = Asia/Seoul //디폴트는 비활성화되어 있음. 주석 해제 필요

- 오류 화면 출력

display_errors = Off //On 또는 Off로 설정. 시스템 개발시엔 보통 On으로 설정