PhpStorm 中运行 artisan 命令需手动配置 PHP 解释器和 artisan 路径（填 ./artisan），并确保终端路径正确；composer 需系统 PATH 可访问且 PhpStorm 终端加载对应 shell 配置；artisan serve 失败多因端口占用或 APP_URL 与 host 不一致；多项目需为每个项目单独配置匹配的 PHP 解释器并重载项目。
怎么在 PhpStorm 里直接运行 artisan 命令
phpstorm 能直接调用 laravel 的 artisan，但默认不自动识别项目根目录下的 artisan 文件，必须手动指定解释器和工作路径。
常见错误现象：Command not found: artisan、Could not open input file: artisan，本质是终端没进对目录，或 PHP 解释器没选对。
- 右键项目根目录 → Open in Terminal，确认当前路径含
artisan文件（ls -l artisan应返回存在） - 菜单栏 Tools → Laravel → Run Artisan Command…，首次会弹窗要求配置：
PHP interpreter选项目所用版本（别用系统默认的/usr/bin/php），Artisan path填./artisan（不是绝对路径，相对路径更可靠） - 如果项目用了 Docker 或 Valet，
PHP interpreter必须指向容器内或 Valet 的 PHP，否则命令执行但数据库连不上、配置读不到
为什么 composer 快捷运行总报错 command not found
PhpStorm 不自带 composer，它只是调用你系统 PATH 里的可执行文件；报错基本等于终端里也跑不通 composer --version。
使用场景：想右键 composer.json → Run Composer Command，或在终端里用 PhpStorm 内置终端敲 composer install。
- 先在系统终端验证：
which composer，如果为空，说明没装或没加进 PATH —— Mac/Linux 加到~/.zshrc或~/.bash_profile，Windows 检查系统环境变量 - PhpStorm 内置终端默认不加载 shell 配置（尤其 zsh + oh-my-zsh 用户），菜单栏 File → Settings → Tools → Terminal → Shell path 改成
/bin/zsh或/bin/bash，别留空 - 如果用 Homebrew 安装的 Composer，路径通常是
/opt/homebrew/bin/composer（Apple Silicon）或/usr/local/bin/composer（Intel），可在 Settings → Languages & Frameworks → PHP → Composer 里手动指定Path to composer.phar
artisan serve 启动后刷新没反应？端口被占或路由没生效
PhpStorm 里点运行 artisan serve，控制台显示 Laravel development server started，但浏览器打不开，大概率是端口冲突或服务没真起来。
立即学习“PHP免费学习笔记（深入）”；
性能影响：别长期开着 artisan serve 当正式服务器用，它单线程、无静态资源缓存，开发够用，压测或调试中间件时容易卡住。
- 默认端口
8000，启动前先检查：lsof -i :8000（Mac/Linux）或netstat -ano | findstr :8000（Windows），杀掉占用进程再试 - 确保
APP_URL和SERVER_ADDR配置没干扰，.env里不要写APP_URL=http://localhost后又在artisan serve --host=127.0.0.1，IP 不一致会导致 Session 或 CSRF 失败 - 想改端口或 host，在运行配置里点 Edit Configurations → artisan serve → Additional parameters 填
--port=8080 --host=0.0.0.0，别直接改命令行参数框外的内容
快捷键运行命令时，为什么总是用错 PHP 版本
一个项目用 PHP 8.2，另一个用 8.1，PhpStorm 默认按全局设置走，切项目不自动切解释器，artisan 和 composer 就可能因语法不兼容直接报错。
兼容性影响：PHP 8.2 的 match 表达式在 8.1 下直接 Parse error；Composer 2.5+ 要求 PHP 8.0+，低版本会提示 Your requirements could not be resolved。
- 每个项目单独配 PHP 解释器：Settings → Languages & Frameworks → PHP，
Interpreter点右侧…→ Add → Remote… → Docker 或 Local，选对应版本的php可执行文件（如/usr/bin/php8.2） - Composer 配置要跟着 PHP 走：Settings → Languages & Frameworks → PHP → Composer，勾选
Use composer from project folder（如果有composer.phar），否则它仍用全局composer，而全局composer又依赖全局 PHP - 命令行工具配置（
artisan/composer）本身不绑定 PHP 版本，它只负责“调用”，真正执行靠你配的解释器 —— 所以解释器错了，命令再对也没用
最常被忽略的是：改完 PHP 解释器后，没点右下角的 Reload project 图标，导致旧配置还在内存里跑。改完记得点一下，或者重启 PhpStorm。
