thinkphp6核心目录结构为：一、app目录是业务逻辑主战场，含controller、model、middleware等子目录及common.php；二、public是唯一web入口，含index.php和static资源；三、config集中管理配置，依赖.env实现环境隔离；四、runtime动态生成缓存日志；五、route定义url映射规则。
如果您刚接触ThinkPHP6.x，面对项目中众多目录和文件不知从何入手，则很可能是尚未理解其约定优于配置的结构逻辑。以下是对其核心目录与关键文件作用的逐层解析：
一、app目录：应用逻辑主战场
app目录是业务代码的核心容器，承载控制器、模型、中间件等运行时加载的类，所有命名空间为App的类均默认从此目录加载。它不是静态资源或工具脚本的存放地，必须严格遵循PSR-4路径映射规则。
1、controller子目录仅存放继承think\Controller的控制器类，文件名与类名须完全一致（如Index.php内定义Index类）。
2、model子目录只放继承think\Model的模型类，命名建议与数据表名一致，或通过$table属性显式指定关联表。
3、middleware子目录存放中间件类，但必须在app/middleware.php中注册后才生效，未注册即不执行。
4、common.php为全局自动加载的辅助函数文件，启动时即载入，适合定义dump()、json_success()等高频工具函数。
5、BaseController.php、Request.php、ExceptionHandle.php为可选基础类，移动或删除需同步调整命名空间及provider.php中的容器绑定。
二、public目录：唯一Web入口与安全边界
public目录是整个应用对外暴露的唯一HTTP可访问路径，所有静态资源和入口脚本必须置于其中，其他目录（如app、config、route）严禁被Web服务器直接访问，否则将导致源码泄露或配置外泄。
1、index.php是请求生命周期起点，负责加载框架并调用think\App::run()启动应用。
2、static子目录用于存放CSS、JS、图片等前端资源，URL路径固定为/static/开头。
3、Nginx/Apache必须将网站根目录指向public，而非项目根目录；本地使用PHP内置服务器时须指定-t public参数。
4、router.php为快速测试路由用的临时脚本，生产环境应删除或禁用。
三、config目录：配置管理中枢
config目录集中管理全部PHP格式配置项，支持多级嵌套与模块覆盖，但真实部署中应避免硬编码敏感信息，优先依赖.env实现环境隔离。
1、database.php中不得直接写死密码，应改用env('DB_PASSWORD')方式读取。
2、app.php中的debug开关由.env的APP_DEBUG值控制，手动设为true在生产环境会泄露路径与SQL。
3、修改.env后若配置未更新，必须清空runtime/config/缓存目录，否则旧值持续生效。
4、各配置文件（如log.php、cache.php）仅定义结构与默认值，具体参数由.env驱动，符合十二要素原则。
四、runtime目录：运行时动态产出区
runtime目录由框架自动生成并写入缓存、日志、模板编译等临时文件，是应用可执行的必要条件。该目录必须对Web进程用户具备完整读写权限，否则首次访问即白屏且无错误提示（尤其当APP_DEBUG=false时）。
1、cache子目录存储路由、配置、语言包等编译缓存，清理后首次访问会重建。
2、log子目录按日期生成日志文件，APP_DEBUG=false时错误默认写入此处而非页面输出。
3、temp子目录用于模板引擎编译后的PHP文件暂存，每次模板变更将触发重写。
4、Linux部署时常见问题为root解压导致www-data或nginx用户无权限，需chown -R www-data:www-data runtime。
五、route目录：URL语义化映射中心
route目录定义请求URL与控制器方法之间的映射关系，是实现RESTful风格和SEO友好的关键层。ThinkPHP6支持闭包路由、分组路由、资源路由等多种声明方式，所有路由规则最终由route/app.php统一加载。
1、app.php是默认路由定义文件，可按模块拆分为admin.php、api.php等并手动引入。
2、路由变量支持正则约束与闭包验证，例如'year' => '\d{4}'可限定年份为四位数字。
3、路由定义不生效的常见原因为public/index.php未正确加载，或Nginx未配置pathinfo支持。
4、调试阶段可通过php think route:list命令查看当前已注册的全部路由规则及其对应控制器方法。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
