运行含命名空间的PHP代码报错，求解报错原因

问题重现 #

你运行的代码：

<?php
namespace foo {
    class bar {
    }

    echo bar::class; // foo\bar
}
?>

触发错误：

PHP Fatal error: Namespace declaration statement has to be the very first statement or after any declare call in the script

错误原因 #

这个错误的核心是命名空间声明不是脚本中的第一个有效语句，常见触发场景：

• 文件开头的<?php标签前存在空白、换行或其他可见/不可见字符（比如UTF-8 BOM头）
• <?php标签与namespace语句之间有多余的输出、空行或空白字符
• 脚本之前有其他PHP代码（比如echo、include）或HTML内容

PHP严格要求：命名空间声明必须是脚本的第一个逻辑语句，仅允许在它之前出现declare语句。

解决方法 #

1. 清理文件开头内容
   确保<?php是文件的第一个字符，前面没有任何空格、换行或HTML代码。

2. 移除UTF-8 BOM头
   用文本编辑器（如VS Code、Notepad++）打开文件，将编码设置为UTF-8无BOM后重新保存。很多编辑器默认保存带BOM，这会导致PHP解析时出现隐形的前置字符。

3. 检查语句顺序
   保证namespace是<?php后的第一个语句，中间不要插入任何输出或无关代码。

修正后的代码示例 #

两种合法写法均可：

<?php
namespace foo {
    class bar {
    }

    echo bar::class; // foo\bar
}
?>

或者更常用的无大括号写法：

<?php
namespace foo;

class bar {
}

echo bar::class; // foo\bar
?>

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