| 函數 | 用途 | 返回值 | 作用域 |
|---|---|---|---|
ini_get(string $option) | 獲取配置值 | 字串/空字串 (未設置)/false (不存在) | 當前腳本運行時值 |
ini_set(string $option, string $value) | 設置配置值 | 舊值/false (失敗) | **當前腳本運行時** (腳本結束失效) |
ini_get_all(string $extension = null) | 獲取所有/擴充套件配置 | 關聯陣列 [ | 當前運行時值 |
ini_restore(string $option) | 恢復配置為 php.ini 原始值 | void | 當前腳本運行時 |
access 值含義:1=PHP_INI_USER (腳本可改)、2=PHP_INI_PERDIR (php.ini/.htaccess)、4=PHP_INI_SYSTEM (php.ini)、7=所有。ini_set 僅能修改 access & 1 的選項。
// 檢查危險配置是否開啟
if (ini_get('expose_php')) {
error_log('警告: expose_php 開啟,版本信息洩漏風險');
}
// 適配 magic_quotes_gpc (舊版遺留)
function safe_input(string $str): string {
if (ini_get('magic_quotes_gpc')) {
$str = stripslashes($str);
}
return $str; // 後續仍需參數化查詢/輸出轉義
}
// 動態調整錯誤報告級別 (開發/生產環境切換)
if (ENV === 'development') {
error_reporting(E_ALL);
ini_set('display_errors', '1');
} else {
error_reporting(E_ALL & ~E_DEPRECATED & ~E_STRICT);
ini_set('display_errors', '0');
ini_set('log_errors', '1');
ini_set('error_log', '/var/log/php/app_error.log');
}
// 長時間任務 (導出、導入、視頻處理) 臨時放寬限制
ini_set('max_execution_time', '300'); // 5 分鐘
ini_set('memory_limit', '512M'); // 512MB
// 大文件上傳臨時調整 (需配合 post_max_size、upload_max_filesize 在 php.ini 預設足夠大)
ini_set('max_input_time', '600'); // 10 分鐘解析輸入
// 臨時開啟錯誤顯示調試特定腳本
ini_set('display_errors', '1');
error_reporting(E_ALL);
注意:ini_set **不能**修改 upload_max_filesize、post_max_size、max_execution_time (在安全模式/某些 SAPI 下) 等 PHP_INI_SYSTEM 選項。必須在 php.ini/.htaccess/.user.ini/Apache/Nginx 配置中預設足夠大。
// 將項目庫目錄加入 include_path,舊代碼無需修改 require 路徑
$newPath = __DIR__ . '/../lib';
$current = ini_get('include_path');
if (strpos($current, $newPath) === false) {
ini_set('include_path', $current . PATH_SEPARATOR . $newPath);
}
// 現在可直接 require 'MyClass.php'; 自動查找 lib 目錄
// 臨時關閉錯誤顯示執行敏感操作
$oldDisplay = ini_get('display_errors');
ini_set('display_errors', '0');
// ... 敏感操作 (如連接含密碼 DSN) ...
ini_restore('display_errors'); // 恢復原狀
// 或 ini_set('display_errors', $oldDisplay);
// 生成配置報告
$inis = ini_get_all();
echo "<table border=1><tr><th>Option</th><th>Global</th><th>Local</th><th>Access</th></tr>";
foreach ($inis as $name => $info) {
$accessMap = [
1 => 'PHP_INI_USER', 2 => 'PHP_INI_PERDIR', 3 => 'USER|PERDIR',
4 => 'PHP_INI_SYSTEM', 5 => 'USER|SYSTEM', 6 => 'PERDIR|SYSTEM', 7 => 'ALL'
];
echo "<tr><td>$name</td><td>{$info['global_value']}</td><td>{$info['local_value']}</td><td>{$accessMap[$info['access']]}</td></tr>";
}
echo "</table>";
// 檢查特定擴充套件配置
$mysqliInis = ini_get_all('mysqli');
print_r($mysqliInis);
PHP_INI_SCAN_DIR 或 FPM pool 配置載入。default_charset、mbstring.internal_encoding)。ini_get_all()['option']['access'] & 1 判斷是否可 ini_set,避免靜默失敗。ini_get/ini_set 是運行時配置交互核心。**配置治理以靜態文件為主,動態調整為輔**。善用 ini_get_all 審計、ini_restore 安全恢復。理解 access 權限位掩碼,避免無效 ini_set。現代框架 (Laravel/Symfony) 封裝了配置管理層,優先使用框架機制 (config()、env()) 而非直接操作 INI。