在 Debian 上使用 PhpStorm 进行项目管理的实操指南
一 环境准备与安装
- 安装系统依赖与 PHP
- 更新索引并安装常用工具与 PHP：sudo apt update && sudo apt install -y php-cli git curl
- 安装 PhpStorm
- 从 JetBrains 下载适用于 Linux 的版本，解压至如 /opt/phpstorm，通过终端执行：/opt/phpstorm/bin/phpstorm.sh 启动
- 建议将启动脚本加入 PATH，便于快速打开：echo ‘export PATH=$PATH:/opt/phpstorm/bin’ >> ~/.bashrc && source ~/.bashrc
- 首次启动后完成基础配置（UI 主题、插件、键位等），即可开始项目管理
二 创建与导入项目
- 新建项目
- 欢迎页选择 New Project → PHP Empty Project，设置项目名与存放路径
- 在 File → Settings → Languages & Frameworks → PHP → CLI Interpreter 选择或添加 PHP 解释器（常见路径如 /usr/bin/php）
- 导入已有项目
- 打开 PhpStorm → File → Open，选择项目目录
- 若目录未纳入版本控制，可在项目根目录执行：git init，然后在 PhpStorm 中启用 VCS 集成
三 版本控制与协作
- 配置 Git
- 确认已安装 Git：git --version；若未安装：sudo apt install -y git
- 在 PhpStorm：File → Settings → Version Control → Git，将 Path to Git executable 设为 /usr/bin/git
- 配置全局身份：git config --global user.name “Your Name” 与 git config --global user.email “you@example.com”
- 在 PhpStorm 中启用与操作
- 启用版本控制：VCS → Enable Version Control Integration，选择 Git
- 克隆仓库：File → New → Project from Version Control → Git，填入仓库 URL 与本地目录后 Clone
- 提交与推送：在 Version Control 面板中提交（Commit），通过 Git → Repository → Push 推送；拉取更新使用 VCS → Git → Pull
- 分支管理：界面右下角 Git 分支 按钮可查看、切换、合并与创建分支
四 运行与调试配置
- 运行配置
- 通过 Run → Edit Configurations 新增配置，选择 PHP Script 或 PHP Built-in Web Server
- 指定入口脚本或 Document root 与端口，使用工具栏绿色三角运行
- 调试配置
- 安装并启用 Xdebug：sudo apt install -y php-xdebug
- 编辑 php.ini（CLI 或 FPM/Apache 对应配置），启用调试：
- zend_extension=xdebug.so
- xdebug.mode=debug
- xdebug.client_host=127.0.0.1（本机调试常用；远程调试请填写 IDE 所在机器 IP）
- xdebug.client_port=9003
- xdebug.start_with_request=yes
- 重启服务：sudo systemctl restart apache2 或 sudo systemctl restart phpX.Y-fpm
- 在 PhpStorm：Settings → PHP → Debug，将 Debug port 设为 9003；在 Run/Debug Configurations 中新增 PHP Web Page 或 PHP Remote Debug，配置服务器与起始 URL，点击调试工具栏启动监听
五 常见问题与排查
- Git 路径错误：在 Settings → Version Control → Git 将路径设为 /usr/bin/git，确认 git --version 正常
- 解释器未就绪：在 Settings → PHP → CLI Interpreter 选择 /usr/bin/php 或添加可用解释器
- 调试无法连接：核对 php.ini 中 xdebug.mode=debug、xdebug.client_host、xdebug.client_port=9003 与 PhpStorm 调试端口一致；远程场景需确保 IDE 主机 IP 可达且防火墙放行 9003；必要时重启 Web 服务
- 项目未纳入版本控制：在项目根目录执行 git init，随后在 PhpStorm 启用 VCS 集成