PHP解释器路径必须手动指定绝对路径，否则PhpStorm无法运行、调试或语法检查；需用which php或where php获取真实路径，确保CLI php.ini启用Xdebug且端口为9003，并正确设置服务器映射与Composer路径。
PHP解释器路径配不对，php命令就永远找不到
PhpStorm 本身不自带 PHP，必须手动指定已安装的 php 可执行文件路径，否则所有运行、调试、语法检查都会失败。常见现象是点击「Run」报错：Cannot find php executable 或直接提示 PHP interpreter is not configured。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- Linux/macOS：用
which php查真实路径（如/usr/bin/php或/opt/homebrew/bin/php），别填别名或 shell 函数 - Windows：优先选
php.exe所在目录下的完整路径（如C:\php\php.exe），避免用 WAMP/XAMPP 自带的快捷方式或桌面图标指向 - 如果用了版本管理工具（如
phpenv、asdf、brew install php@8.2），务必指向具体版本的二进制，例如/opt/homebrew/opt/php@8.2/bin/php，而不是php命令本身
CLI选项和php.ini路径容易被忽略
PhpStorm 默认只调用 php 二进制，但很多项目依赖特定 CLI 参数（比如 -d memory_limit=-1）或自定义 php.ini 文件（尤其当开发环境和 Web 环境配置不一致时）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在 Settings → PHP → Interpreter → 「…」→ Show additional options → CLI options 中填写参数，例如：
-d date.timezone=Asia/Shanghai -d memory_limit=2G - 「Configuration file」字段必须填
.ini文件的绝对路径（不是目录），可用php --ini输出确认；若留空，PhpStorm 会用默认配置，可能和phpinfo()显示的不一致 - 注意：CLI 和 Web SAPI 的
php.ini通常是两个文件，别把 Apache 的php.ini路径错粘过来
Composer自动检测失效，多半是PATH或权限问题
PhpStorm 会尝试自动识别 composer 可执行文件用于依赖管理，但经常失败——不是没装，而是它根本找不到。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 不要依赖全局
composer命令，直接填绝对路径：Linux/macOS 用which composer，Windows 用where composer；常见路径如/usr/local/bin/composer或C:\ProgramData\ComposerSetup\bin\composer.bat - 如果 Composer 是通过
curl -sS https://getcomposer.org/installer | php下载的composer.phar，必须填完整路径加php前缀，例如：/usr/bin/php /home/user/composer.phar - macOS 上用 Homebrew 安装的 Composer，有时因 SIP 限制无法被 GUI 应用读取 PATH，硬编码路径最稳
多PHP版本共存时，项目级解释器设置比全局更重要
一个机器装了 PHP 7.4、8.1、8.3，但每个项目要求不同版本——这时候全局设成 8.3 没用，反而会让老项目报错。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先在 Settings → PHP → Interpreters 里添加多个解释器（分别命名如
php-7.4、php-8.2） - 再进具体项目 Settings → PHP → Interpreter，下拉选择对应版本，这个设置会写入
.idea/workspace.xml，属于项目级 - 如果用了 Docker 或远程解释器（比如 WSL2），确保 SSH 连接能稳定执行
php -v，且容器内路径映射正确，否则断点调试会卡在「Waiting for Xdebug」
路径、版本、CLI 配置这三项一旦配错，后续所有代码补全、类型推导、Xdebug 断点都不可靠——宁可花两分钟验证 php -v 和 php --ini 输出，也别跳过这步。
