ini_restore() 和ini_set() 的區別是什麼？什麼時候該用哪一個？

gitbox 2025-08-25

1. ini_set()函數

ini_set()函數用於設置PHP 配置選項的值。通過它，開發者可以在運行時改變某些PHP 配置選項的值，從而影響腳本的行為。 ini_set()可以修改大多數PHP 配置項，但有些項只有在php.ini 配置文件中修改或在Web 服務器級別的配置中設置才會生效。

文法:

 <span><span><span class="hljs-title function_ invoke__">ini_set</span></span><span>(</span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$varname</span></span><span>, </span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$newvalue</span></span><span>): </span><span><span class="hljs-keyword">string</span></span><span>|</span><span><span class="hljs-literal">false</span></span><span>
</span></span>

$varname ：要設置的配置選項名稱。
$newvalue ：新的配置值。

示例：

 <span><span><span class="hljs-comment">// 設定 PHP 錯誤報告級別</span></span><span>
</span><span><span class="hljs-title function_ invoke__">ini_set</span></span><span>(</span><span><span class="hljs-string">'error_reporting'</span></span><span>, E_ALL);
</span></span>

ini_set()在執行腳本時有效，且作用範圍通常限於當前腳本生命週期。一旦腳本結束，它對配置的修改將失效。它還可能受到php.ini中的限制，某些配置項（如max_execution_time ）可能無法通過此函數修改。

2. ini_restore()函數

ini_restore()函數用於恢復先前通過ini_set()修改的PHP 配置項到其默認值。換句話說，它撤銷了ini_set()所做的更改，使該配置項恢復為其在PHP 配置文件或服務器級別的默認值。

文法:

 <span><span><span class="hljs-title function_ invoke__">ini_restore</span></span><span>(</span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$varname</span></span><span>): </span><span><span class="hljs-keyword">bool</span></span><span>
</span></span>

$varname ：需要恢復默認值的配置項名稱。

示例：

 <span><span><span class="hljs-comment">// 恢復配置項</span></span><span>
</span><span><span class="hljs-title function_ invoke__">ini_restore</span></span><span>(</span><span><span class="hljs-string">'error_reporting'</span></span><span>);
</span></span>

當調用ini_restore()時，它只會恢復通過ini_set()修改過的配置項，並且該修改會立即生效。

3. 區別與應用場景

功能差異：
- ini_set()用於在運行時設置配置項的值。
- ini_restore()用於恢復通過ini_set()修改過的配置項，恢復到默認值。
適用範圍：
- ini_set()可以設置多數PHP 配置項，適用於需要臨時調整腳本行為的場景。
- ini_restore()只對通過ini_set()設置的配置項有效，並且通常用於需要恢復默認配置的場景。
持久性：
- ini_set()只會在當前腳本執行期間有效。
- ini_restore()會撤銷當前腳本內ini_set()所做的更改。
限制：
- ini_set()和ini_restore()都可能受到php.ini配置文件的限制，某些配置項不能被更改。

4. 什麼時候使用ini_set()和ini_restore() ？

使用ini_set() ：
- 當你需要在腳本執行期間修改某個配置項的值時，例如調整錯誤報告級別、設置上傳文件大小限制等。
- 適用於臨時調整，而不需要永久更改服務器的配置。
使用ini_restore() ：
- 當你希望撤銷之前通過ini_set()所做的配置更改，恢復配置項的默認值時。
- 比如，在一個函數或代碼塊中修改了某個配置項的值，執行完畢後再恢復原值，避免對其他部分產生不必要的影響。

5. 總結

ini_set()和ini_restore()都是在PHP 中用於管理運行時配置的重要工具。 ini_set()用於修改配置項，通常用於個別腳本需求的調整，而ini_restore()用於恢復之前的配置狀態。合理使用它們能夠幫助開發者更靈活地控制PHP 環境的行為，確保腳本按預期執行。