如何在 WordPress 主题头部正确调用自定义 PHP 函数

在 wordpress 主题的 `header.php` 中调用自定义 php 函数（如输出 meta 描述）时，若直接使用 `` 会导致内容为空，根本原因是该函数未返回值——必须使用 `echo` 显式输出其返回结果。

wordPress 主题中，functions.php 文件常用于定义工具函数，例如生成动态页面描述：

// functions.php 中的示例函数（务必有 return） function meta_desc() {     if (is_home() || is_front_page()) {         return '欢迎访问我们的 WordPress 博客，分享前端开发与主题定制技巧。';     } elseif (is_single()) {         global $post;         return wp_trim_words($post->post_excerpt ?: $post->post_content, 20, '…');     } else {         return get_bloginfo('description');     } }

⚠️ 关键注意点：

• 函数必须使用 return 返回字符串，而非 echo 或 print 输出；
• 在 header.php 的 html 属性中（如 content=””），需用 显式输出，因为 仅执行但不回显；
• 若函数内部已含 echo，则不可再套用 echo，否则会报错或重复输出——推荐统一采用 return + 外部 echo 的模式，更安全、可控。

正确写法（header.php 中）：

✅ 补充建议：

立即学习“PHP免费学习笔记（深入）”；

• 使用 esc_attr() 对输出进行属性安全转义，防止 xss 风险；
• 确保函数在 header.php 加载前已被 functions.php 定义（默认满足，因 functions.php 优先加载）；
• 可通过 var_dump(meta_desc()); die; 在函数末尾临时调试，确认返回值非空。

遵循以上规范，即可确保自定义函数在

区域稳定、安全、准确地输出预期内容。