WordPress中跨文件传递变量的专业指南

// customtemplate.php
$final_cat_url = 'https://example.com/category/my-category/';
get_template_part( 'custom/last-category', null, array('my_final_cat_url' => $final_cat_url));

// 在这里尝试访问 $args['my_final_cat_url'] 是不正确的，因为 $args 变量是在被包含文件中定义的。
// echo $args['my_final_cat_url']; // 这将导致错误

// custom/last-category.php
if (isset($args['my_final_cat_url'])) {
    echo '<p>The final category URL is: ' . esc_url($args['my_final_cat_url']) . '</p>';
}

/**
 * 包含一个PHP文件，并允许将变量注入到其局部作用域。
 *
 * @param string $filePath 要包含的文件的路径。
 * @param array $variables 一个关联数组，其键将成为变量名，值将成为变量值。
 * @param bool $print 是否直接打印文件的输出内容，默认为true。
 * @return string|null 如果$print为false，则返回文件的输出内容；否则返回null。
 */
function includeWithVariables($filePath, $variables = array(), $print = true){
    $output = NULL;
    // 检查文件是否存在
    if(file_exists($filePath)){
        // 将关联数组中的键值对提取为局部变量
        // 例如，如果 $variables = ['name' => 'John'], 则 $name 变量将被创建并赋值为 'John'。
        extract($variables);

        // 启动输出缓冲，捕获被包含文件的所有输出
        ob_start();

        // 包含目标文件
        include $filePath;

        // 结束缓冲，获取其内容
        $output = ob_get_clean();
    } else {
        // 文件不存在时可以添加错误处理或日志记录
        error_log("File not found for includeWithVariables: " . $filePath);
    }

    // 根据$print参数决定是打印内容还是返回内容
    if ($print) {
        print $output;
    }
    return $output;
}

// customtemplate.php

// 假设我们在这里定义了 $final_cat_url
$final_cat_url = 'https://example.com/category/my-category/';
$product_id = 123;
$user_name = 'Alice';

// 调用 includeWithVariables，将变量作为关联数组传递
// 'final_cat_url' 会在被包含文件中变为 $final_cat_url
// 'product_id' 会在被包含文件中变为 $product_id
// 'name' 会在被包含文件中变为 $user_name
includeWithVariables(
    get_template_directory() . '/custom/last-category.php', // 使用绝对路径更稳健
    array(
        'final_cat_url' => $final_cat_url,
        'product_id'    => $product_id,
        'name'          => $user_name
    )
);

// 如果你希望捕获输出而不是直接打印，可以将第三个参数设置为 false：
// $included_content = includeWithVariables(
//     get_template_directory() . '/custom/last-category.php',
//     array('final_cat_url' => $final_cat_url),
//     false // 不直接打印
// );
// echo "<!-- Included Content: -->" . $included_content;

<?php
// custom/last-category.php

// $final_cat_url, $product_id, $name 现在可以直接在这里访问
// 始终建议在使用前检查变量是否存在，并进行适当的清理/转义
if (isset($final_cat_url)) {
    echo '<p>最终分类URL：' . esc_url($final_cat_url) . '</p>';
}

if (isset($product_id)) {
    echo '<p>产品ID：' . absint($product_id) . '</p>';
}

if (isset($name)) {
    echo '<p>用户名称：' . esc_html($name) . '</p>';
} else {
    echo '<p>未提供用户名称。</p>';
}

// 可以在这里包含其他逻辑或HTML结构
?>
<div class="category-info">
    <h3>更多信息</h3>
    <?php if (isset($final_cat_url)) : ?>
        <a href="<?php echo esc_url($final_cat_url); ?>">查看分类</a>
    <?php endif; ?>
</div>