Windows环境下Laragon运行PHP无法写入文件夹如何解决

1. 清除文件夹强制只读/系统属性 #

Windows资源管理器中无法取消的只读标记，通常是文件夹被设置了隐藏的系统属性导致，需要以管理员身份启动命令提示符执行以下命令：
attrib -r -s C:\替换为你的目标文件夹绝对路径 /s /d
参数说明：

• -r：清除只读属性
• -s：清除系统文件属性
• /s：递归处理目录下所有子文件和子文件夹
• /d：同时修改目录本身的属性

2. 配置Laragon运行账户的写入权限 #

Laragon的PHP进程默认使用当前Windows登录用户身份运行，如果你开启了Laragon的系统服务模式，进程会以SYSTEM账户身份运行，需要手动给目标文件夹加权限：

• 右键目标文件夹 → 选择「属性」→ 切换到「安全」选项卡
• 点击「编辑」按钮 → 再点击「添加」，输入账户名：普通启动模式填你的Windows登录用户名，服务启动模式添加SYSTEM和Users用户组
• 给刚添加的账户/用户组勾选「完全控制」权限，点击「应用」保存配置

3. 验证PHPUnit配置 #

• 检查项目根目录的phpunit.xml配置文件，确认测试写入目录的路径配置正确，没有硬编码为其他不存在/无权限的路径
• 可在测试脚本中增加路径校验代码，排除相对路径解析错误的问题：var_dump(realpath($targetWritePath));

临时验证方案 #

如果调整后仍报错，可以完全退出Laragon后右键选择「以管理员身份运行」，再执行PHPUnit测试确认问题是否由权限导致，不建议长期用管理员身份运行Laragon。

内容的提问来源于stack exchange，提问作者Joe Simpson