WordPress自定义插件开发遇unexpected end of file语法错误

Parse error: syntax error, unexpected end of file这个报错的本质是PHP解析到文件末尾时，仍未找到足够的闭合语法结构（你这里就是未识别到函数的闭合花括号}）。你肉眼检查花括号成对，但加一个额外}后运行时错误消失、IDE报语法错，刚好说明有一个你写的}没有被PHP解析器识别为有效语法符号，按以下优先级排查：

• 优先检查PHP块切换的标签合法性
  你当前代码在函数内部通过?>退出PHP模式、输出HTML后再用<?php重回PHP模式写闭合}，这是最高发的异常点：

  1. 确认重回PHP的开标签完全符合规范：不能写成<?（PHP7.4默认关闭短标签支持，不会被识别为PHP代码起始）、不能写成<? php（<?和php之间不能有空格），标签字符间不能混入零宽空格、不可见控制字符。只要开标签不合法，后面写的}会被当成普通HTML文本直接输出，PHP永远找不到函数的闭合括号，直接报文件意外结束。
  2. 检查退出PHP前最后一行代码的语法：确认global $wpdb;末尾确实有分号，不要漏写，分号前后不要混不可见字符。
  3. 两段PHP标签之间的区域是纯HTML输出区，不要在这里写PHP格式的注释，尤其不要出现未闭合的PHP短标签、花括号字符，避免干扰解析。

• 其次检查文件编码与隐式字符问题
  把文件放到纯文本编辑器中开启「显示所有控制字符」：

  1. 确认文件编码为无BOM的UTF-8，带BOM的文件会在内容开头插入3个不可见字节，若BOM出现在PHP标签附近会直接打断语法解析。
  2. 逐行检查闭合花括号}、PHP开闭标签周围，有没有零宽空格、异常换行、其他不可见控制字符，这类字符肉眼完全看不到，但会导致PHP无法识别语法符号。

• 最后检查嵌套结构匹配
  不要只检查单独的花括号，要排除PHP块外的内容：如果你在中间HTML区域内联了其他PHP代码片段，要确认这些片段里的if/for/function结构的花括号完全闭合，不要出现漏写闭合括号的情况。

快速验证方法 #

先把中间所有HTML内容、标签切换部分全部删掉，写成最简洁的函数结构：

<?php
function my_function()
{
    $jer_ver = filemtime(WP_PLUGIN_DIR . '/somefile.js');
    $style_ver = filemtime(WP_PLUGIN_DIR . '/somefile.css');
    wp_enqueue_script('admin_js', plugins_url('../JS/admin.js', __FILE__), array(), $jer_ver);
    wp_enqueue_style('admin_style', plugins_url('../CSS/admin.css', __FILE__), array(), $style_ver);
    global $wpdb;
}

如果这段代码运行不报错，就可以确定问题出在你删掉的HTML内容、PHP标签切换的位置，逐行恢复内容就能定位到具体异常点。

编码规范建议 #

按照WordPress官方编码规范，纯PHP文件末尾不要加?>闭合标签，避免标签后多余的空行、字符导致输出异常；如果函数内需要混写HTML，尽量保证PHP块切换的位置不要有多余字符，闭合函数的}要紧贴<?php标签，中间不要留空行或其他内容。

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