PhpStorm运行配置中的Working Directory_正确设置工作目录保障执行【手册】-phpstorm-PHP中文网

Working directory设错会导致“找不到配置”或“只检查了部分文件”，必须设为$ProjectFileDir$以确保PHPStan、php-cs-fixer等工具正确加载根目录下的phpstan.neon、.php-cs-fixer.php等配置文件，避免因路径错误引发各类解析失败问题。

phpstorm运行配置中的working directory_正确设置工作目录保障执行【手册】

Working directory设错会导致“找不到配置”或“只检查了部分文件”

PHPStorm里几乎所有外部工具（PHPStan、php-cs-fixer、PHPUnit、自定义脚本）都依赖Working directory决定从哪开始找配置文件、解析相对路径、扫描源码范围。设成 $ProjectFileDir$ 是最安全的选择——它指向你用PhpStorm打开的那个项目根目录，确保phpstan.neon、.php-cs-fixer.php、phpunit.xml这些文件能被正确加载。

常见错误现象：

PHPStan报Configuration file "phpstan.neon" not found，但文件明明就在项目根目录
php-cs-fixer修复后没生效，或者提示Could not open input file: .php-cs-fixer.php
PHPUnit运行时找不到测试类，或--bootstrap路径报错

原因基本都是Working directory被误设为 $FileDir$ （当前文件所在目录）或空值。一旦工具从子目录启动，就看不到根目录下的配置。

External Tools配置中必须显式填$ProjectFileDir$

在Settings → Tools → External Tools里添加命令时，Working directory字段不能留空，也不能依赖IDE自动推断。必须手动输入： $ProjectFileDir$ 。

这个变量是PhpStorm内置宏，展开后就是你打开项目的绝对路径，比如/home/user/my-project或C:\dev\my-project。它和 $ProjectConfigDir$ （存.idea的目录）不同，后者可能指向别的位置。

实操要点：

不要用 $FileDir$ ：它会随你当前编辑的文件变化，比如你在src/Controller/下右键运行，工具就从那里启动，根本读不到根目录的phpstan.neon
别写死绝对路径：跨机器、跨系统就失效；也别写相对路径如../，PhpStorm不解析
验证方法：在External Tool的Arguments里加--debug或pwd（Linux/macOS）/ cd（Windows），看控制台输出的实际路径

Run Configuration里的Working directory影响PHPUnit和内置Web Server

不只是External Tools，Run → Edit Configurations里新建的PHP Script、PHPUnit、PHP Built-in Web Server也都需要检查Working directory。

对PHPUnit来说，设错会导致：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

bootstrap文件路径解析失败（比如vendor/autoload.php找不到）
测试数据文件（tests/_data/）读取失败
XML配置中<php><include path="..."></include></php>失效

对PHP Built-in Web Server，Working directory虽不直接暴露，但它决定了Document root的基准——如果你把Document root设为public，而Working directory却是 $FileDir$ ，那实际服务的根目录就可能变成/path/to/current/file/public，而非项目根下的public。

建议统一设为 $ProjectFileDir$ ，再配合Document root填public或web等子目录名。

Working directory和Environment Variables共同决定临时路径行为

虽然PHP的upload_tmp_dir、sys_temp_dir必须在php.ini里改，但Working directory会影响你本地调试时某些工具的行为边界。

比如Composer安装、phpunit生成coverage报告、甚至Xdebug日志写入，都会受sys_get_temp_dir()返回值影响——而该函数优先读环境变量TMPDIR（macOS/Linux）或TEMP（Windows）。你在Run Configuration里设置的Environment variables，会覆盖系统默认值，但前提是Working directory正确，否则环境变量可能被忽略或作用域错乱。

所以：先保证Working directory是 $ProjectFileDir$ ，再在Environment variables里加TMPDIR=/tmp/my-project-tmp，才能让所有子进程真正落到你指定的临时目录。

最容易被忽略的是：External Tools和Run Configuration是两套独立设置，改完一个不等于另一个也同步了。每个地方都要单独确认。