ThinkPHP在不同操作系统下的开发环境配置_PHPStudy集成环境搭建技巧-ThinkPHP-PHP中文网

windows下phpstudy运行thinkphp报reflectionexception错误，根本原因是opcache和realpath_cache在windows下缓存了错误路径映射，需关闭opcache并设realpath_cache_size=0后重启服务。

thinkphp在不同操作系统下的开发环境配置_phpstudy集成环境搭建技巧

Windows 上用 PHPStudy 跑 ThinkPHP 5.1+ 报 `ReflectionException` 错误

这是 Windows 下最常遇到的启动失败问题，根本原因不是 ThinkPHP 本身，而是 PHPStudy 自带的 opcache 和 realpath_cache 在 Windows 文件系统下缓存了错误的路径映射，尤其在你改过项目目录名、用符号链接、或从压缩包解压后直接运行时特别容易触发。

实操建议：

打开 PHPStudy → 点击右上角「其他选项」→「PHP 设置」→ 找到 opcache.enable=1，改成 opcache.enable=0（临时关闭）
在 php.ini 中加一行：realpath_cache_size = 0（清空路径缓存）
重启 Apache/Nginx，再访问 index.php；确认能跑通后，可逐步恢复 opcache.enable=1，但保留 realpath_cache_size = 4096 即可
ThinkPHP 6+ 用户注意：runtime 目录必须有写权限，PHPStudy 默认用 SYSTEM 或 IIS_IUSRS 身份运行服务，需手动给该目录添加写入权限

macOS 上用 PHPStudy for Mac 启动 ThinkPHP 报 `file_put_contents(): failed to open stream: Permission denied`

PHPStudy for Mac 的默认工作用户是 _www，但它的 runtime 和 public 目录往往属于当前登录用户，导致写入失败。这不是 ThinkPHP 配置问题，是 macOS 权限模型和 PHPStudy 运行身份不匹配。

实操建议：

终端执行：sudo chown -R _www:_www /path/to/thinkphp/runtime 和 sudo chown -R _www:_www /path/to/thinkphp/public
不要用 chmod 777 —— macOS 的 ACL 机制会让它失效，且不安全
如果用的是 ThinkPHP 6.1+，检查 config/app.php 中 runtime_path 是否为绝对路径；相对路径（如 ../runtime/）在 PHPStudy for Mac 下容易解析错，建议显式写成 /Applications/PHPStudy/WWW/thinkphp/runtime/
PHPStudy for Mac 内置的 PHP 版本常为 7.4，而 ThinkPHP 6.3+ 要求 PHP >= 8.0，务必先确认版本：在 PHPStudy 控制台点「PHP 版本」切换，别只看菜单栏显示

Linux（CentOS/Ubuntu）下 PHPStudy-Linux 版本启动 ThinkPHP 无响应，`nginx error.log` 显示 `connect() to unix:/tmp/php-cgi.sock failed`

PHPStudy-Linux 实际是封装了 Nginx + PHP-FPM，但它默认把 PHP-FPM sock 文件放在 /tmp，而部分 Linux 发行版（尤其是启用了 systemd-tmpfiles 的）会定时清理 /tmp，导致 sock 文件被删，Nginx 就连不上 PHP。

协同养育操作系统

协同养育操作系统（Co-Parenting OS）— 离异家庭专业协同养育支持系统。12模块覆盖接送管理、成长记忆库、孩子观察站、亲子关系粘合剂、共同挑战中心、情绪冲突观察、父母成长、成长档案馆、成长阶段引擎、风险预警、驾驶舱、被恶意攻击急救包。当用户涉及离异家庭育儿、协同养育、抚养探视、接送安排、孩子成长记录、亲子关系、离异冲突、被恶意攻击、前任矛盾等话题时触发。

下载

实操建议：

编辑 /usr/local/phpstudy/nginx/conf/vhost/*.conf，把 fastcgi_pass unix:/tmp/php-cgi.sock; 改成 fastcgi_pass 127.0.0.1:9000;
然后去 /usr/local/phpstudy/php/etc/php-fpm.d/www.conf，确认 listen = 127.0.0.1:9000（不是 listen = /tmp/php-cgi.sock）
重启服务：sudo /usr/local/phpstudy/phpstudy restart（不是只 restart nginx）
ThinkPHP 的 .env 中 APP_DEBUG=true 在 PHPStudy-Linux 下可能被 Nginx 的 fastcgi_param 覆盖，建议在 Nginx 配置里显式加：fastcgi_param APP_DEBUG "true";

所有平台共通：ThinkPHP 的 `url_model` 在 PHPStudy 下始终 404

PHPStudy 的 Apache/Nginx 默认没开 URL 重写支持，ThinkPHP 的 PATHINFO 模式（url_model = 1）或兼容模式（url_model = 2）就必然 404。这不是 ThinkPHP bug，是 Web 服务器配置缺失。

实操建议：

Apache：确认 httpd.conf 中 LoadModule rewrite_module modules/mod_rewrite.so 已取消注释，并且对应虚拟主机配置里有 AllowOverride All
Nginx：在站点 server 块中加入 ThinkPHP 官方推荐的重写规则（不是简单加 try_files），例如：
```
location / {<br>    if (!-e $request_filename) {<br>        rewrite ^(.*)$ /index.php?s=$1 last;<br>    }<br>}
```
别信 PHPStudy 界面里那个「伪静态」开关——它只对默认站点生效，自定义项目路径必须手动改配置文件
ThinkPHP 6.2+ 若启用 app_host，要确保 Nginx 的 server_name 和它一致，否则路由匹配会跳空