新手建站避坑指南：谈谈目录结构与入口文件的那些门道

最近帮几个朋友建站时发现，很多新手对目录结构的概念特别模糊，要么把所有文件扔在根目录，要么把静态资源和代码混在一起。今天就来聊聊这个看似基础但特别容易踩坑的话题。

以PHP项目为例，规范的目录至少应该包含：app（业务代码）、public（入口文件+静态资源）、config（配置文件）、vendor（依赖包）这几个核心目录。见过最夸张的是把所有PHP文件直接扔在public下的案例 - 这相当于把家底全晾在大门口。

入口文件这里特别容易出幺蛾子。很多人喜欢把index.php随便放个位置，结果导致路由失效。正确的做法是保证入口文件独占public目录，其他PHP文件全部通过composer autoload加载。上周就遇到个案例：因为把工具类放在public/utils下，直接被爬虫扫出了源码。

本地调试推荐用Docker+phpstudy的组合，比直接装php环境省心太多。注意要把项目目录映射到容器里的/var/www，别像我最初那样傻傻地在容器里git clone...

最后说个血泪教训：千万别用中文目录！之前给客户演示项目，就因为路径里有「测试版」三个字，在Linux服务器上死活跑不起来，排查了整整一下午。