php.ini 是 PHP 核心配置檔,修改記憶體限制、上傳大小、錯誤顯示、擴充模組等都需編輯它。但位置因作業系統、安裝方式(套件管理、編譯安裝、Docker、XAMPP)而異。本文提供跨平台的多種尋找方法。
<?php
// 建立 info.php 放入網站根目錄
phpinfo();
// 瀏覽器訪問,搜尋 "Loaded Configuration File"
?>
關鍵資訊:
/etc/php/8.1/fpm/conf.d/)# 方法一:php -i(CLI 版 phpinfo)
php -i | grep "Loaded Configuration File"
# 輸出:Loaded Configuration File => /etc/php/8.1/cli/php.ini
# 方法二:php --ini
php --ini
# 輸出:
# Configuration File (php.ini) Path: /etc/php/8.1/cli
# Loaded Configuration File: /etc/php/8.1/cli/php.ini
# Scan for additional .ini files in: /etc/php/8.1/cli/conf.d
# Additional .ini files parsed: /etc/php/8.1/cli/conf.d/10-opcache.ini, ...
# 方法三:查詢特定 SAPI(如 php-fpm)
# 注意:CLI 與 FPM 可能用不同 ini!
php-fpm -i | grep "Loaded Configuration File"
# 或
php-fpm --ini
# 命令提示字元 / PowerShell
php -i | findstr "Loaded Configuration File"
php --ini
# XAMPP / WAMP 典型路徑
# C:\xampp\php\php.ini
# C:\wamp64\bin\php\php8.x.x\php.ini
| 環境 | CLI php.ini | Web (FPM/Apache) php.ini | 備註 |
|---|---|---|---|
| Ubuntu/Debian (apt) | /etc/php/8.x/cli/php.ini | /etc/php/8.x/fpm/php.ini 或 /etc/php/8.x/apache2/php.ini | 版本號隨 PHP 版本變化 |
| CentOS/RHEL (yum/dnf) | /etc/php.ini | /etc/php.ini(同檔)或 /etc/opt/remi/php81/php.ini | Remi repo 路徑不同 |
| Alpine (apk) | /etc/php81/php.ini | /etc/php81/php.ini | |
| macOS (Homebrew) | /opt/homebrew/etc/php/8.x/php.ini | /opt/homebrew/etc/php/8.x/php-fpm.d/www.conf 另設 | Apple Silicon 路徑 |
| Windows (手動安裝) | C:\php\php.ini | 同檔 | 需從 php.ini-development/production 複製重命名 |
| Docker (官方映像) | /usr/local/etc/php/php.ini | /usr/local/etc/php/php.ini | 預設不存在,需從 php.ini-production 複製 |
修改 CLI 版 php.ini 不影響網站,反之亦然。請以 phpinfo() 顯示的「Loaded Configuration File」為準。
PHP 會使用內建預設值。解決:
# 從預設模板複製
cp /usr/local/etc/php/php.ini-production /usr/local/etc/php/php.ini
# 或
cp /etc/php/8.1/fpm/php.ini.default /etc/php/8.1/fpm/php.ini
systemctl restart php8.1-fpm / systemctl restart nginx / systemctl restart apache2.user.ini、.htaccess、ini_set() 覆蓋Scan this dir for additional .ini files 目錄下的檔案是否覆蓋設定# Dockerfile
FROM php:8.2-fpm
# 複製自訂 php.ini
COPY php.ini /usr/local/etc/php/php.ini
# 或運行時掛載
# docker run -v ./php.ini:/usr/local/etc/php/php.ini php:8.2-fpm
; 基礎
memory_limit = 256M
max_execution_time = 30
post_max_size = 100M
upload_max_filesize = 100M
max_file_uploads = 20
; 錯誤處理
display_errors = Off
log_errors = On
error_log = /var/log/php/error.log
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT
; Session
session.save_handler = redis
session.save_path = "tcp://127.0.0.1:6379"
session.gc_maxlifetime = 7200
session.cookie_secure = 1
session.cookie_httponly = 1
session.cookie_samesite = "Lax"
; OPcache (生產必開)
opcache.enable = 1
opcache.memory_consumption = 256
opcache.max_accelerated_files = 20000
opcache.validate_timestamps = 0 ; 生產設 0,部署後需重啟 PHP-FPM 生效
找到正確的 php.ini 是 PHP 環境調優的第一步。牢記:以 phpinfo() 或 php --ini 顯示的「Loaded Configuration File」為唯一真理,區分 CLI 與 Web SAPI 的配置差異,修改後必須重啟對應服務生效。Docker 環境建議透過 Dockerfile 或掛載卷管理配置,實現基礎設施即代碼。