断网时PHP项目离线运行的前提是本地已安装并正确配置PHP解释器，PhpStorm依赖其执行语法检查、脚本运行及内置服务器；需确保PHP路径无中文/空格、CLI与Web使用同一解释器、启用内置服务器、提前配好Xdebug及离线代码检查规则。
断网时 PHP 解释器必须本地可执行
离线运行项目的前提，是系统里已装好 PHP 二进制文件且能被 php -v 正常调用。PhpStorm 本身不带 PHP，所有语法检查、脚本执行、内置服务器都依赖这个本地解释器。
常见错误现象：PHP interpreter is not configured 或右键 Run 时提示 “No PHP interpreter configured”。这说明 PhpStorm 没找到或没正确绑定你本地的 php.exe（Windows）或 php（macOS/Linux）。
- 确认 PHP 已安装：终端/命令行执行
php -v，有输出即通过 - 在 PhpStorm 中配置路径：Settings → PHP → Interpreter → Add → Local → 浏览到你的
php.exe或/usr/bin/php（macOS/Linux） - 避免路径含中文或空格：比如
C:\Program Files\php\php.exe容易出错，建议解压到C:\php\这类纯英文无空格路径 - CLI 和 Web 解释器最好用同一个：Settings → PHP → CLI Interpreter 也指向同一路径，防止 Terminal 面板里
php --version和编辑器内提示不一致
不用 Apache/Nginx：用 PHP 内置服务器启动项目
离线时最轻量、最可靠的本地运行方式，就是启用 PHP 自带的 CLI 服务器。它不依赖外部 Web 服务，只要 PHP 装好了就能跑，且 PhpStorm 支持一键触发。
使用场景：快速验证 index.php、调试路由逻辑、测试 API 接口返回，无需部署到 htdocs 或配置虚拟主机。
立即学习“PHP免费学习笔记（深入）”；
- 确保项目根目录下有可响应的入口文件（如
index.php），内容至少为<?php echo 'ok'; ?> - 右键该文件 → Run 'index.php'（不是 Debug），PhpStorm 会自动调用
php -S localhost:8000 -t . - 若提示 “Port 8000 is already in use”，可在 Settings → PHP → Built-in Web Server → Port 改为其他值（如 8080）
- 浏览器访问
http://localhost:8000即可；注意：此服务器不支持 .htaccess、rewrite 规则，复杂路由需自行用router.php代理
离线调试必须提前配好 Xdebug 扩展和 php.ini
断网环境下无法动态下载或校验 Xdebug，所有配置必须在联网时完成，并验证可用。一旦离线，xdebug 就是“只读状态”——改了 ini 文件也不会热加载，必须重启 PHP 进程。
容易踩的坑：Xdebug helper 浏览器插件在离线时仍可点击，但若后端没监听或配置错端口，断点永远不命中。
- 确认
phpinfo()页面中已显示 Xdebug 模块（不是仅显示 “with Xdebug” 字样，要看到完整版本和配置项） - 关键配置项必须匹配：PhpStorm 的 Debug → Xdebug → Debug port（默认
9003）要和php.ini中的xdebug.client_port=9003严格一致 -
xdebug.mode=debug和xdebug.start_with_request=yes是 Xdebug 3 的必需项，漏掉任一都会导致“监听中但无连接” - 离线时不要尝试切换 Xdebug 版本或重装 DLL/SO 文件——没有网络就无法下载适配包，强行替换会导致 PHP 启动失败
离线检查代码质量：用 inspect.sh/inspect.bat 生成 XML 报告
PhpStorm 的离线代码检查不是“不联网就不能用”，而是把 IDE 的检查能力打包成命令行工具，提前导出规则、执行扫描、保存结果。适合 CI 流程或定期自查。
性能影响：全量扫描大项目（>10k 行）可能耗时数秒到分钟级，建议只扫 -d src/ 这类核心目录，而非整个 vendor。
- Windows 下运行：
inspect.bat <project-path> <profile-path> <output-dir> -v2 -d src/ - macOS/Linux 下运行：
inspect.sh <project-path> <profile-path> <output-dir> -v2 -
profile-path必须是已存在的 XML 文件，例如~/.phpstorm2025.2/config/inspection/Project_Default.xml，不能临时创建 - 输出的 XML 文件可后续导入 PhpStorm：Code → View Offline Inspection Results → 选中该目录即可可视化查看警告/错误
真正麻烦的不是“怎么跑起来”，而是离线时所有依赖都变成静态快照——PHP 版本、Xdebug 版本、检查规则、插件 ZIP 包，全都得提前对齐。少一个环节，断点就不停，检查就报错，连 php -l 都可能因扩展缺失而失败。
