WordPress如何动态自动加载blocks下各区块的functions.php文件

你之前手动逐行引入区块文件的写法维护成本很高，新增、删除区块都需要修改加载代码，用下面的通用自动加载逻辑可以一劳永逸，自动识别所有符合/blocks/<区块名>/functions.php规则的文件并加载，不需要提前知道区块文件夹名称。

生产可用实现代码 #

把下面代码放到主题根目录的functions.php中，替换掉原来所有手动require区块函数的语句即可：

/**
 * 自动加载所有区块目录下的functions.php
 */
function autoload_all_block_functions() {
    // 获取主题内blocks目录的绝对路径
    $blocks_root = get_parent_theme_file_path('/blocks/');

    // 目录不存在直接返回，避免抛出错误
    if (!is_dir($blocks_root)) {
        return;
    }

    // 遍历blocks目录下的所有一级子项
    $iterator = new DirectoryIterator($blocks_root);
    foreach ($iterator as $entry) {
        // 跳过.、..特殊目录和非文件夹项
        if ($entry->isDot() || !$entry->isDir()) {
            continue;
        }

        // 拼接当前区块的functions.php文件路径
        $func_path = $entry->getPathname() . '/functions.php';
        // 确认文件存在且可读时加载
        if (is_file($func_path) && is_readable($func_path)) {
            require $func_path;
        }
    }
}
// 挂载到主题初始化阶段执行，保证加载时机符合WordPress规范
add_action('after_setup_theme', 'autoload_all_block_functions');

方案特性 #

• 严格匹配现有目录规则：仅扫描blocks目录下的一级子文件夹，不会递归遍历深层目录，不会误加载其他位置的文件
• 兼容性强：做了全链路的存在性、可读性校验，目录缺失、单个区块没有functions.php、文件权限不足都不会引发站点报错
• 零维护成本：后续新增、删除区块不需要修改任何加载代码，只要按照既定目录结构存放文件就会自动加载

低环境要求替代方案 #

如果你的服务器环境默认禁用了DirectoryIterator扩展（极少见，绝大多数PHP环境默认开启），可以换用glob实现，效果完全一致：

function autoload_all_block_functions() {
    // 直接匹配所有符合路径规则的文件
    $block_funcs = glob(get_parent_theme_file_path('/blocks/*/functions.php'));
    if (empty($block_funcs)) {
        return;
    }
    foreach ($block_funcs as $file) {
        is_readable($file) && require $file;
    }
}
add_action('after_setup_theme', 'autoload_all_block_functions');

子主题适配提示：如果你使用的是子主题，需要优先加载子主题下的区块文件，把代码中get_parent_theme_file_path替换为get_theme_file_path即可，函数会自动优先查找子主题对应文件，不存在时 fallback 到父主题的同名文件。

内容的提问来源于stack exchange，提问作者Kristian Borisov-Kurtashev