ThinkPHP命名空间不懂_ThinkPHP命名空间规范详解【技巧】-ThinkPHP-PHP中文网

thinkphp命名空间与文件系统、自动加载、类实例化强绑定，写错斜杠、空格或目录名不一致均导致class not found；namespace声明必须位于文件首行且前面不能有任何内容。

thinkphp命名空间不懂_thinkphp命名空间规范详解【技巧】

ThinkPHP 的命名空间不是“配个路径就行”，而是和文件系统、自动加载、类实例化三者强绑定的硬规则。写错一个斜杠、多一个空格、或目录名和命名空间不一致，new 就直接报 Class not found。

namespace 声明必须在文件最顶行，且前面不能有任何东西

这是最常踩的致命坑：哪怕 <?php 前有个 BOM 字节、空行、注释，或者把 declare(strict_types=1); 放在 namespace 前面，PHP 都会抛出 Fatal error: Namespace declaration statement has to be the very first statement in the script。

用 VS Code 或 Sublime Text 打开 PHP 文件，编码选 “UTF-8 without BOM”
declare 必须紧贴 <?php 后，再换行写 namespace，顺序只能是：<?php declare(strict_types=1); namespace App\Controller;
文件开头不能有 echo、print、空白符、HTML 标签、甚至不可见的全角空格

命名空间路径必须和物理目录结构完全一致（大小写敏感）

ThinkPHP（尤其是 TP6/TP8）默认走 PSR-4 自动加载，namespace App\Controller 就意味着这个类文件必须存放在 app/controller/ 目录下（注意是小写 controller），而不是 App/Controller 或 app/Controller。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

Linux 服务器上大小写严格区分，app/Controller/Index.php + namespace App\Controller; 会加载失败
Windows 开发时可能“侥幸”通过，但上线就炸 —— 别依赖开发环境宽容
TP8 的 app/controller/ 目录名是小写，对应命名空间就是 App\Controller（首字母大写），这是约定，不是随意组合

use 是起别名，不是“导入文件”

写了 use App\Model\User; 并不会自动包含 User.php，它只是告诉当前作用域：“以后我写 User，就等价于写 App\Model\User”。能不能 new 出来，取决于自动加载是否能定位到那个文件。

确保 User.php 真实存在于 app/model/User.php，且文件内第一行是 namespace App\Model;
调用内置类如 Exception 或 DateTime 时，必须加反斜杠：new Exception()，否则 PHP 会在当前命名空间里找 App\Controller\Exception
想在命名空间内用全局函数（比如 array_filter），稳妥写法是 \array_filter($arr)，避免被同名自定义函数覆盖

控制器/模型/服务类的命名空间不能凭感觉写

TP8 明确推荐分层结构：App\Controller、App\Model、App\Service，而不是混用 Home\Controller 或 app\controller 这类低版本遗留写法。

旧项目从 TP5 升级上来，要检查所有 namespace 声明是否已统一为 App\Xxx 格式
模块化项目若启用多应用，命名空间前缀仍是 App，子模块如 App\Module\Blog\Controller\Post，对应路径是 app/module/blog/controller/Post.php
别在命名空间里用点号（.）或短横线（-），只允许字母、数字、下划线、反斜杠，且反斜杠必须是 \（Windows 路径分隔符 / 无效）