thinkphp public目录环境变量文件加载_env配置文件路径设置
thinkphp框架从5.0版本开始推荐把入口文件放在public目录下，将public作为网站运行目录，这是框架官方推荐的安全部署方式。但很多站长和开发者对这个设置并不熟悉，尤其是虚拟主机环境下无法直接绑定子目录的情况，容易出现访问404、静态资源加载失败、安全漏洞等问题。本文从基础配置到高级优化，把public目录入口设置的全场景方案讲清楚。
iis环境下把public设为运行目录，在IIS管理器中找到对应网站，右键「管理网站」-「高级设置」，把物理路径改为项目的public目录路径。或者在网站根目录设置中直接修改物理路径。修改后应用池不需要重启，但建议刷新网站确保配置生效。
iis环境下虚拟主机如果不支持修改物理路径，可以用URL重写把请求转发到public目录。在网站根目录的web.config中配置规则，匹配所有URL，条件排除public目录，操作重写为public/{R:1}。这种方式能在不修改物理路径的情况下实现public目录作为入口，但性能略低于直接设置物理路径。
多应用模式下public目录可以放置多个入口文件，如index.php前台入口、admin.php后台入口、api.php接口入口。每个入口文件绑定不同的应用，在index.php中通过$http = (new App())->http; $response = $http->name('index')->run(); 这种方式指定应用名。多入口文件的好处是前后台分离、接口独立，便于权限控制和负载均衡分发。
CDN加速配置时，静态资源可以用独立域名如static.域名.com指向public/static目录，在CDN服务商处添加源站为该目录或整个站点。模板中静态资源路径改为//static.域名.com/css/style.css这种协议相对路径。动态请求仍然走主域名，静态资源走CDN域名，实现动静分离，提升网站加载速度。注意CDN缓存规则中不要缓存PHP动态页面。
方案二：整个项目上传到空间一个子目录如tp项目，然后在空间根目录创建index.php，内容为require 'tp项目/public/index.php'，同时在根目录创建.htaccess或web.config把所有请求转发到这个入口文件。这种方式简单但应用目录在web可访问范围内，需要额外添加访问保护规则防止敏感文件被直接访问。
虚拟主机环境下还要注意runtime目录的写入权限。thinkphp的缓存、日志、session等都写在runtime目录，这个目录必须有写入权限。Linux虚拟主机在FTP中右键设置runtime目录权限为755或777，Windows虚拟主机在目录属性中给IIS用户添加修改和写入权限。权限不足会导致页面报错、缓存无法生成、日志无法写入。
国内很多虚拟主机不支持自定义网站根目录，域名默认指向空间根目录，无法直接绑定到public子目录。这种情况下有两种解决方案。方案一：把thinkphp项目的应用目录（app、config、route、runtime、vendor）上传到空间根目录之外的目录，把public目录下的文件上传到空间根目录，然后修改index.php中的应用路径为../应用目录名/。这种方式最安全也最规范。
宝塔面板用户设置更简单，在网站设置中找到「网站目录」，把运行目录选择为/public即可，宝塔会自动修改nginx配置中的root路径。伪静态规则在宝塔面板的「伪静态」设置中选择thinkphp规则，面板会自动填入标准rewrite代码。保存后重载nginx配置即可生效。
nginx配置中还要注意fastcgi_param SCRIPT_FILENAME必须用$document_root$fastcgi_script_name，不能写死路径。$document_root会自动取root指令的值即public目录路径，这样入口文件路径就是public/index.php，正确无误。如果写死路径可能导致入口文件找不到或路径错误。
开发者反馈：「thinkphp5项目部署到虚拟主机，一直不知道public目录怎么设，按文中方案一把应用目录移到根目录外，入口放根目录，安全又稳定，伪静态也正常了」「nginx伪静态规则之前写错了导致除首页外全部404，对照文中配置改了rewrite规则，所有页面访问正常」。
操作提示：配置public目录前先备份整个项目文件和数据库，配置过程中如果出现问题可以快速回滚。配置完成后测试首页、列表页、详情页、后台登录、静态资源加载、文件上传这6项功能，全部正常才算配置成功。伪静态规则修改后要重载Web服务器配置才能生效，nginx用nginx -s reload，apache用service httpd restart。
更新时间：2026-08-27 12:13:30