ThinkPHP项目部署失败主因是Web服务器根目录未指向public目录，导致.env泄露、路由404、autoload.php加载失败及Class 'thinkApp' not found；因TP6+强制要求所有请求经public/index.php统一调度，且该目录唯一具备安全防护与初始化能力。
ThinkPHP项目在Windows和Linux系统上部署失败，90%是因为Web服务器根目录没指向public目录——这会导致.env配置泄露、路由全部404、vendor/autoload.php加载失败，直接报Class 'thinkApp' not found。
为什么必须把Web服务器根目录设为public
ThinkPHP 6+ 的入口统一为 public/index.php，所有请求都必须经此文件调度。vendor/autoload.php、config/加载、路由解析、中间件执行全依赖该入口的初始化逻辑。若document_root指向项目根目录（如/var/www/myapp/或D: mpphtdocsmyapp），.env、app/、config/、runtime/等敏感路径将被直接暴露在浏览器中，【这是高危安全漏洞】。
public目录内部已通过Nginx location规则或Apache .htaccess屏蔽了对.env、runtime/等路径的访问，它是唯一被设计为“可公开访问”的目录。
Windows下XAMPP/WampServer部署实操
方法一：直接访问/public子路径（最稳妥）
立即学习“PHP免费学习笔记（深入）”；
把ThinkPHP项目完整复制到D: mpphtdocsmyapp，浏览器访问 http://localhost/myapp/public/ 即可运行。这一步操作起来很简单，无需改任何配置，适合本地调试。
方法二：修改Apache虚拟主机指向public物理路径（推荐生产模拟）
打开D: mpppacheconfextrahttpd-vhosts.conf，新增虚拟主机配置：
<VirtualHost *:80>
DocumentRoot "D:/xampp/htdocs/myapp/public"
ServerName myapp.test
<Directory "D:/xampp/htdocs/myapp/public">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
然后在C:WindowsSystem32driversetchosts中添加127.0.0.1 myapp.test，重启Apache。注意路径中必须用正斜杠/或双反斜杠\，单反斜杠会导致Apache启动失败。
Linux下Nginx生产环境标准配置
第一步：确认项目存放位置并设置权限
将提醒同步至 Windows/Outlook 日历。用户提及「提醒我」「设置提醒」「加到日历」「同步到日历」「日程」「calendar」「日历」时触发。支持Microsoft Graph API 设备代码流认证，无需 Web 服务器，直接写入用户 Outlook 日历。
将代码上传至 /var/www/myapp，确保 runtime 目录由 Web 用户（如 www-data 或 nginx）和 CLI 用户共同可写：sudo chown -R www-data:www-data /var/www/myapp/runtime；同时赋予755权限：sudo chmod -R 755 /var/www/myapp/runtime。
第二步：编辑Nginx站点配置（如 /etc/nginx/sites-available/myapp）
root 必须写绝对路径且结尾不带斜杠：root /var/www/myapp/public;（错误写法：/var/www/myapp/public/）；否则 fastcgi_script_name 会多拼一层 public，导致 PHP 找不到 index.php 报404。
第三步：加入关键重写规则
在server块内必须包含：try_files $uri $uri/ /index.php?$query_string;，否则除首页外所有路由均返回404；同时确认 fastcgi_param SCRIPT_FILENAME 的值是 $document_root$fastcgi_script_name，不能硬编码成 /var/www/myapp/public/index.php。
第四步：检查并重载
执行 sudo nginx -t 验证语法，无误后运行 sudo systemctl reload nginx。
Linux下Apache部署要点
Apache用户最容易忽略的是 .htaccess 是否真正生效。ThinkPHP 的 public/.htaccess 是路由重写的依据，但它不会自动启用——必须确认虚拟主机配置中对应目录的 AllowOverride All，且 mod_rewrite 已启用。
在 Ubuntu 上执行：sudo a2enmod rewrite → sudo systemctl restart apache2；在 CentOS 上检查 /etc/httpd/conf.modules.d/00-base.conf 是否已加载 rewrite_module。
虚拟主机 DocumentRoot 必须设为 /var/www/myapp/public，不是项目根目录。若仍404，请检查 Apache 错误日志：sudo tail -f /var/log/apache2/error.log，常见报错是“AH00670: The Alias directive in /etc/apache2/sites-enabled/myapp.conf at line 5 will probably never match”，说明路径配置冲突。
