PHP 설정 파일 php.ini 설정 가이드 완전 정리

php.ini 설정 가이드 완전 정리- PHP 개발이나 서버 운영을 하다 보면 반드시 한 번쯤은 마주하게 되는 파일이 있습니다. 바로 PHP의 핵심 설정 파일인 php.ini입니다.

php.ini 는 PHP가 어떻게 동작할지를 결정하는 설정 모음으로, 에러 로그 출력부터 업로드 용량 제한, 확장 모듈 활성화, 시간 제한 설정 등 수많은 중요한 기능을 조정할 수 있습니다.

이 글에서는 php.ini 기본 개념부터, php.ini 경로 확인 방법, php.ini 수정 예시, 최적화 방법과, 실무에서 자주 수정하는 항목, 주의해야 할 설정까지 단계별로 php.ini 설정 가이드 방법을 제시합니다.

1. php.ini란 무엇인가?

php.ini는 PHP 해석기의 설정값을 정의하는 구성 파일입니다.
서버가 PHP를 실행할 때 이 파일을 읽어, 어떻게 동작할지 결정합니다.

✔️ 주요 설정 항목 예시:

• 에러 출력 여부
• 메모리 사용량 제한
• 파일 업로드 용량 제한
• 타임존 설정
• cURL, mbstring 등 확장 모듈 설정

2. php.ini 위치 확인하는 방법

php -i | grep php.ini

결과 예시:

Loaded Configuration File => /etc/php/8.3/apache2/php.ini

✔️ PHP-FPM을 사용할 경우:

/etc/php/8.3/fpm/php.ini

✔️ CLI만 쓴다면:

/etc/php/8.3/cli/php.ini

3. 자주 사용하는 설정 항목 정리

아래는 실무에서 가장 자주 조정하는 php.ini 설정입니다:

추가로 많이 사용되는 php.ini 고급 설정 항목

🔐 실무에서 잘 안 건드리는 설정

• doc_root, user_dir 등은 PHP를 Apache 모듈로 직접 설정할 때 외에는 잘 쓰지 않음
• extension_dir 등은 대부분 자동 설정됨
• default_charset, default_mimetype는 프레임워크에서 이미 설정되어 있음

4. 확장 모듈 활성화 예시

주석(;)이 붙어 있으면 비활성 상태입니다.
세미콜론을 제거해 모듈을 활성화합니다.

;extension=curl   ; ❌ 비활성화 상태
extension=curl    ; ✅ 활성화 상태
extension=mbstring
extension=gd

5. 설정 변경 후 반영하는 방법

php.ini를 수정한 뒤에는 웹 서버 재시작이 필요합니다.

Apache 사용 시:

sudo systemctl restart apache2

PHP-FPM 사용 시:

sudo systemctl restart php8.3-fpm

6. 설정 값이 제대로 적용됐는지 확인

간단한 PHP 코드로 확인 가능:

<?php
phpinfo();
?>

브라우저로 열면, 현재 php.ini에 적용된 설정이 화면에 표시됩니다.

이런 화면이 나타납니다. 그리고 설정된 값도 저기에 반영되어 표시됩니다.

7. 개발 vs 운영 환경 설정 비교 팁

8. 주의가 필요한 php.ini 설정 항목

💡 팁: 실수하기 쉬운 설정

• upload_tmp_dir을 지정했는데 퍼미션이 없으면 업로드 실패
• timezone 설정을 안 하면 date()에서 경고 발생
• session.save_path가 유효하지 않으면 세션이 저장되지 않아 로그인 불가

운영 서버 설정 체크리스트

• display_errors = Off
• log_errors = On + error_log 경로 지정
• expose_php = Off
• memory_limit = 256M 또는 용도에 맞게
• disable_functions에 exec, system, passthru 등 추가
• session.cookie_secure = On (HTTPS 환경)
• allow_url_fopen = Off (외부 API 필요 시만 On)

php.ini는 단순히 성능을 조절하는 파일이 아니라,
보안·자원 관리·애플리케이션 안정성까지 직접 영향을 줍니다.

특히 운영 환경에서는 보안 위협 요소가 될 수 있는 항목을 꼭 점검하고,
필요하다면 ini_set()이나 .htaccess로 제한적으로 설정을 오버라이드하는 것도 좋습니다.

자주 묻는 질문 (FAQ)

Q. php.ini 파일을 실수로 잘못 바꿨는데 복구 방법은?
→ 원본 백업(php.ini.default) 파일을 복사해 복구할 수 있습니다. 또는 PHP 재설치 시 초기화됩니다.

Q. CLI와 웹서버 설정이 다른 것 같아요.
→ php -i 결과의 Loaded Configuration File을 확인하고, 각각 CLI, Apache, FPM 별로 php.ini가 따로 존재하는 점을 주의하세요.

Q. 설정이 적용이 안 되는 것 같아요.
→ phpinfo()로 적용 여부를 반드시 확인하고, 웹서버가 재시작되었는지 점검하세요.

요약 정리

🔧 결론

“php.ini 설정 가이드”를 이렇게 알아봤습니다.php.ini 파일은 PHP의 성능, 보안, 안정성에 직결되는 핵심 설정 파일입니다. 자주 사용하는 옵션부터 천천히 익혀가며 실무에서 유용하게 활용해보세요.

관련 내용

Fatal error: Call to undefined function mb_strpos() 오류 해결법

Fatal error: Call to undefined function curl_init() 오류 해결법