ThinkPHP6在Windows 11上用Apache 2.4.69+PHP 8.1.30部署的核心难点是兼容性与配置适配：必须采用FastCGI（非mod_php）模式，启用rewrite和fcgid模块，正确设置DocumentRoot为public目录、PATH_INFO补全、权限与扩展启用，并禁用debug及开启opcache。
Windows 11 上用 Apache 2.4.69 + PHP 8.1.30 部署 ThinkPHP6 项目，核心难点不在安装本身，而在组件兼容性、路径权限和框架运行时的配置适配。ThinkPHP6 官方明确支持 PHP 7.2–8.2，但默认不兼容 Apache 的 mod_php 模式（即 PHP 作为 Apache 模块加载），推荐使用 FastCGI（php-cgi.exe）方式 启动，否则容易出现路由 404、$_SERVER 变量缺失、PATH_INFO 解析异常等问题。
Apache 配置要点：启用 rewrite + FastCGI 转发
确保 Apache 已启用以下模块（在 httpd.conf 中取消注释）：
- LoadModule rewrite_module modules/mod_rewrite.so
- LoadModule fcgid_module modules/mod_fcgid.so（需下载 mod_fcgid-2.3.9-win64-vc15.zip 并解压到 modules 目录）
在站点 VirtualHost 或 .htaccess 中添加：
- 开启重写：RewriteEngine On
- 强制入口文件：RewriteCond %{REQUEST_FILENAME} !-d 和 RewriteCond %{REQUEST_FILENAME} !-f
- 转发到 index.php：RewriteRule ^(.*)$ index.php [QSA,PT,L]
注意：ThinkPHP6 默认使用 PATH_INFO 模式，Windows 下需在 public\index.php 顶部手动补全环境变量（防止 $_SERVER['PATH_INFO'] 为空）：
立即学习“PHP免费学习笔记（深入）”；
$_SERVER['PATH_INFO'] = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
}
PHP 8.1.30 关键配置项
编辑 php.ini，确认以下设置已生效：
- extension_dir = "D:/php/ext"（路径需与实际一致，注意斜杠方向）
- extension=mysqli、extension=pdo_mysql、extension=openssl、extension=mbstring —— 全部启用
- date.timezone = Asia/Shanghai
- display_errors = Off（上线前务必关闭）
- opcache.enable=1（提升性能，TP6 支持良好）
验证 PHP 是否正常识别：在浏览器访问 http://localhost/phpinfo.php，确认版本为 8.1.30，且无“Deprecated”或“Warning”类报错。
ThinkPHP6 项目部署实操步骤
将 TP6 项目解压后，只把 public 目录设为 Apache DocumentRoot（如 D:/www/myapp/public），其余目录（app、config、runtime 等）必须放在 Web 根目录之外，或至少禁止 Apache 直接访问（通过 .htaccess 或 httpd.conf 的 <Directory> 限制）。
- runtime/ 目录需赋予 IIS_IUSRS（或当前 Apache 运行用户）的“修改”权限，否则日志、缓存无法写入
- config/app.php 中设置 'debug' => false，并检查 'app_host' => '' 是否适配域名
- 数据库配置填入 config/database.php，注意 MySQL 主机名不要写 localhost（Windows 下可能走 socket），改用 127.0.0.1
- 首次访问前，手动执行 php think optimize:schema（需命令行进入项目根目录，非 public）生成数据库 schema 缓存
常见报错与快速定位
若首页空白或 500 错误，先查三处日志：
- Apache 的 logs/error.log（看模块加载失败、路径错误）
- PHP 的 logs/php_error.log（看语法、扩展缺失、权限拒绝）
- ThinkPHP 的 runtime/log/ 下日期文件（看框架初始化失败原因）
高频问题示例：
- “Class 'think\App' not found” → 未正确设置自动加载，检查 vendor/autoload.php 是否被引入，或 composer install 是否完整执行
- “No input file specified.” → FastCGI 转发配置错误，确认 FcgidInitialEnv PHPRC 指向正确 php.ini 路径
- “PDO Connection failed: SQLSTATE[HY000] [2002]” → MySQL 服务未运行，或 database.php 中 host/port 填错
