萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 尋找 php.ini 位置的多種方法與跨平台差異

前言

php.ini 是 PHP 核心配置檔,修改記憶體限制、上傳大小、錯誤顯示、擴充模組等都需編輯它。但位置因作業系統、安裝方式(套件管理、編譯安裝、Docker、XAMPP)而異。本文提供跨平台的多種尋找方法。

最通用方法:phpinfo()

<?php
// 建立 info.php 放入網站根目錄
phpinfo();
// 瀏覽器訪問,搜尋 "Loaded Configuration File"
?>

關鍵資訊:

  • Configuration File (php.ini) Path:PHP 編譯時預設的搜尋路徑
  • Loaded Configuration File:實際生效的 php.ini 路徑(重點!)
  • Scan this dir for additional .ini files:額外掃描目錄(如 /etc/php/8.1/fpm/conf.d/)
  • Additional .ini files parsed:實際載入的額外 ini 檔

命令列快速查詢

Linux / macOS / Unix

# 方法一: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

Windows

# 命令提示字元 / 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.iniWeb (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.iniRemi 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 複製

特殊情況處理

1. CLI 與 Web 使用不同 php.ini

修改 CLI 版 php.ini 不影響網站,反之亦然。請以 phpinfo() 顯示的「Loaded Configuration File」為準。

2. 找不到 php.ini(Loaded Configuration File 顯示 none)

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

3. 修改後不生效

  • 確認編輯的是 Loaded Configuration File 指向的檔案
  • 重啟對應服務:systemctl restart php8.1-fpm / systemctl restart nginx / systemctl restart apache2
  • 檢查是否被 .user.ini、.htaccess、ini_set() 覆蓋
  • 檢查 Scan this dir for additional .ini files 目錄下的檔案是否覆蓋設定

4. Docker 環境修改 php.ini

# 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 或掛載卷管理配置,實現基礎設施即代碼。

copyright © 萬盛學電腦網 all rights reserved