什麼是PHP 中的defined() 函數？如何用它來檢查常量是否已經定義？

gitbox 2025-08-15

在PHP 中， defined()函數是一個非常實用的工具，用於檢查常量是否已被定義。常量是不可變的值，它在定義後不能更改。與變量不同，常量不需要美元符號$來引用。在PHP 程序中，常量通常用於存儲配置項、數據庫連接信息或其他不會變化的值。使用defined()函數可以避免因重複定義常量而導致的錯誤，確保程序運行的穩定性。

defined()函數的語法

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

$name ：要檢查的常量名稱。常量名稱必須是一個字符串，區分大小寫。
返回值：如果常量已經定義， defined()返回true ；否則，返回false 。

示例代碼

假設我們有一個常量SITE_NAME ，並想要檢查它是否已定義。代碼示例如下：

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 檢查常量是否已定義</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">defined</span></span><span>(</span><span><span class="hljs-string">'SITE_NAME'</span></span><span>)) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"常量 SITE_NAME 已定義，值為: "</span></span><span> . SITE_NAME;
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"常量 SITE_NAME 未定義"</span></span><span>;
}

</span><span><span class="hljs-comment">// 定義常量</span></span><span>
</span><span><span class="hljs-title function_ invoke__">define</span></span><span>(</span><span><span class="hljs-string">'SITE_NAME'</span></span><span>, </span><span><span class="hljs-string">'My Awesome Site'</span></span><span>);
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

在上面的例子中，第一次執行defined()時，常量SITE_NAME尚未定義，因此輸出結果會是“常量SITE_NAME 未定義”。當我們在之後使用define()定義了常量SITE_NAME後，再次執行defined() ，結果會變成“常量SITE_NAME 已定義，值為: My Awesome Site”。

使用defined()避免重複定義常量

PHP 中的常量一旦被定義，無法被重新定義。如果你嘗試再次定義一個已存在的常量，PHP 會拋出一個錯誤。因此，使用defined()函數可以避免因重複定義常量而導致的錯誤。

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 先檢查常量是否已定義</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (!</span><span><span class="hljs-title function_ invoke__">defined</span></span><span>(</span><span><span class="hljs-string">'DB_HOST'</span></span><span>)) {
    </span><span><span class="hljs-title function_ invoke__">define</span></span><span>(</span><span><span class="hljs-string">'DB_HOST'</span></span><span>, </span><span><span class="hljs-string">'localhost'</span></span><span>);
}

</span><span><span class="hljs-keyword">echo</span></span><span> DB_HOST;
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

在這個例子中， DB_HOST常量只有在尚未定義的情況下才會被定義。這樣一來，即使程序運行多次，也不會因重複定義常量而引發錯誤。

defined()在實際應用中的用途

檢查配置項：在配置文件中，我們通常會定義多個常量用於存儲數據庫連接信息、應用名稱等。通過defined()可以確保配置項不會被重複定義。
避免衝突：當開發多個模塊或庫時，可能會有多個文件定義了相同名稱的常量。使用defined()來檢查常量是否已經存在，可以防止因常量名稱衝突導致的問題。
控制流程：在某些條件下，你可能希望控制是否執行特定的操作。通過檢查常量是否已經定義，可以做出不同的程序決策。

總結

PHP 的defined()函數是一個非常有用的工具，可以幫助開發者檢查常量是否已被定義，從而避免重複定義或衝突的發生。通過合理使用defined() ，可以使得代碼更加穩定和健壯，尤其在大型項目或多模塊系統中，它能有效提高代碼的可維護性和可靠性。