什么是 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()，可以使得代码更加稳定和健壮，尤其在大型项目或多模块系统中，它能有效提高代码的可维护性和可靠性。