WordPress中从PHP文件提取数据到模板的方法疑问

一、现有方法的核心问题 #

1. 全局变量污染风险
   直接在data-lemon.php里定义全局变量，很容易和WordPress核心、插件或主题的其他变量重名，引发难以排查的冲突bug。

2. 无法满足客户修改需求
   你提到客户不能访问文件结构，但当前变量存储在PHP文件中，客户依然无法自行修改内容，完全违背了“按需修改”的初衷。

3. 维护性差
   随着页面区块增多，零散的全局变量会越来越难管理；更换主题或更新文件时，这些自定义的模板片段也容易丢失。

另外你提到get_template_part无法传递变量，原因是该函数会在独立的作用域内执行文件，所以内部定义的变量不会暴露到主模板中；而locate_template($path, true)本质和include一致，会在当前作用域执行文件，因此能拿到变量，但这只是“能用”，并非规范做法。

二、改进方案 #

方案1：规范变量传递，避免全局污染

将变量封装为函数返回值，替代全局变量定义：
修改data-lemon.php：

<?php
function get_lemon_hero_data() {
    return [
        'subtitle' => 'Meet Lemon',
        'title' => 'Build a better site for your business.',
        'description' => '[short description here] blorem blipsum dolor sit bamat minim mollit non deserunt ullamco lorem ipsum.'
    ];
}
?>

主模板中调用：

<?php
// 加载函数文件
locate_template('template-parts/data/lemon/data-lemon.php', true);
// 获取变量数组
$hero_data = get_lemon_hero_data();
?>

<!-- Hero Section -->
<section id="hero" class="flex flex-col md:flex-row gap-4">
    <div id="col-left" class="basis-2/5">
        <h3><?php echo esc_html($hero_data['subtitle']); ?></h3>
        <h1><?php echo esc_html($hero_data['title']); ?></h1>
        <p><?php echo esc_html($hero_data['description']); ?></p>
        <!-- 按钮等其他代码保持不变 -->
    </div>
    <div id="col-right" class="basis-3/5">
        <figure>
            <!-- 注意这里路径用正斜杠，避免Windows路径问题 -->
            <img src="<?php echo esc_url(get_stylesheet_directory_uri() . '/assets/img/progessive-img.png'); ?>" alt="" title="" />
        </figure>
    </div>
</section>

注：添加esc_html、esc_url是WordPress的安全规范，避免XSS攻击。

方案2：彻底解决客户修改需求——用自定义字段

既然客户不能碰代码也不愿用编辑器，WordPress原生自定义字段或ACF（高级自定义字段）是最佳选择：

• 原生自定义字段：在页面编辑后台开启“自定义字段”面板（右上角选项中勾选），添加hero_subtitle、hero_title、hero_description三个字段，模板中用以下代码获取：

<h3><?php echo esc_html(get_post_meta(get_the_ID(), 'hero_subtitle', true)); ?></h3>
<h1><?php echo esc_html(get_post_meta(get_the_ID(), 'hero_title', true)); ?></h1>
<p><?php echo esc_html(get_post_meta(get_the_ID(), 'hero_description', true)); ?></p>

• ACF插件：安装后创建字段组，为每个内容项设置友好的输入框（文本、文本区域等），客户可在后台直观填写，模板中用get_field('hero_subtitle')即可获取内容，体验更友好。

三、总结 #

你的当前方法能正常运行，但不适合长期维护和客户需求。建议优先采用方案2（自定义字段），既符合WordPress开发规范，又能让客户无需技术基础即可修改内容；如果暂时不想用自定义字段，至少用方案1封装变量，避免全局污染问题。

内容的提问来源于stack exchange，提问作者shingen