WordPress functions.php 文件详解

很多关于WordPress的教程中，会提到functions.php文件，特别是需要将一些自定义代码添加到WordPress时。那么 functions.php 是什么呢？本文将详细讲解它的作用和注意事项。

functions.php 是什么？

简单来说，functions.php文件的行为类似于 WordPress 插件，可以向 WordPress 网站添加自定义程序和功能。

当主题被激活启用，该主题目录下如果存在functions.php文件，则会被WordPress自动载入并随核心程序一起执行。

这样一来，我们可以使用它来调用 WordPress 函数并定义自己的函数。

使用 functions.php 示例

一般情况下，functions.php文件是给主题开发者用来自定义一些函数或调用WordPress核心函数使用的。例如WordPress帖子的摘录默认为55个字，主题开发者可以在functions.php文件中添加以下代码修改默认值：

<?php
function modify_excerpt_length( $length ) {
    return 30; //将摘录变更为30个字
}
add_filter( 'excerpt_length', 'modify_excerpt_length');

注意事项

值得注意的是，上述代码用到了一个自定义函数名：modify_excerpt_length，它不能与WordPress的核心函数或已启用的插件中的函数重名，否则可能导致WordPress出错。

对于这类自定义函数最佳的命名方式为：主题名_功能_描述，例如：zhanzhangb_theme_modify_excerpt_length 与其它函数重名的风险就低了很多。

在 WordPress 中，当两个或多个函数、类或变量具有相同名称时，可能会发生命名冲突。这可能会导致 WordPress 网站出现错误或意外行为。主题开发人员和插件开发人员都有责任避免各自代码中的命名冲突。

主题开发人员应确保其函数、类和变量具有唯一的名称，不会与 WordPress 核心或其他插件使用的名称冲突。他们还应该在函数和类名称前添加唯一标识符（例如主题名称或缩写），以最大程度地减少命名冲突的可能性。

由于使用 functions.php 的便捷性，所以很多WordPress教程会建议将一些自定义函数或自定义程序代码放入其中。但在实际使用中应了解以下几点：

1. functions.php 会随主题启用而生效，如果更换了主题，那么原主题中的 functions.php 文件不再被执行。
2. 如果升级主题 functions.php 文件会被自动替换掉。
3. 在WordPress默认的执行顺序中，functions.php的顺序在所有插件之后。
4. 子主题可以有自己的functions.php文件，且在加载父主题的functions.php之前执行。
5. 如果不仅仅是定义函数或调用核心函数等，而是增加某些新的功能的话，更建议使用插件。
6. 推荐：WPCode Pro 代码片段插件替代 functions.php 。