Debian下phpStorm如何管理项目

Debian下 PhpStorm 项目管理实战指南

一 安装与首次配置

• 安装方式与依赖
  • 方式一：下载 .deb 包安装
    sudo apt update && sudo apt install ./phpstorm-*.deb
    若依赖异常：sudo apt --fix-broken install
  • 方式二：下载 .tar.gz 解压运行
    tar xzf PhpStorm-*.tar.gz -C /opt
    /opt/PhpStorm/bin/phpstorm.sh
  • 常见依赖（GUI/字体/剪贴板等）：sudo apt install libgtk-3-0 libnotify-dev libgconf-2-4 libnss3 libxss1 libasound2 libxtst6 xauth xvfb
• 首次配置
  • 设置 PHP 解释器：File → Settings → Languages & Frameworks → PHP → CLI Interpreter（选择系统中的 /usr/bin/php 或新增解释器）。
  • 配置 运行/调试：Run → Edit Configurations，按需新增如 PHP Script、PHP Web Page 等配置。

二 创建与导入项目

• 新建项目
  • 欢迎页选择 New Project → PHP Empty Project → 指定项目名与路径 → 选择或添加 PHP 解释器 → Finish。
• 导入现有项目
  • 方式一：File → Open，选择项目根目录（如 /var/www/html/my_project），以现有源码方式打开。
  • 方式二：VCS → Get from VCS（如 Git），填入仓库地址克隆到本地后自动打开。
• 多项目管理
  • 同一窗口多项目：File → Settings → Directories，在 Content Roots 中添加多个目录，统一在一个窗口管理。
  • 多窗口并行：Window → New Window 打开新窗口，分别打开不同项目；或创建多个启动器实现“快速双开”。

三 运行与调试

• 运行
  • 在代码编辑区右键选择 Run，或使用工具栏绿色三角运行当前脚本/页面。
• 断点调试（Xdebug 3）
  • 安装扩展：sudo apt install php-xdebug
  • 编辑 php.ini（CLI 或 FPM，按实际启用项调整路径与端口）：
    zend_extension=/usr/lib/php//xdebug.so
    xdebug.mode=debug
    xdebug.client_host=127.0.0.1
    xdebug.client_port=9003
    xdebug.start_with_request=yes
  • 重启服务：sudo systemctl restart apache2 或 sudo systemctl restart php****-fpm
  • PhpStorm：Run → Edit Configurations → 新增 PHP Web Page 或 PHP Script → 选择服务器/解释器 → 在代码行号侧点下断点 → 点击 Debug。

四 版本控制与协作

• Git 集成
  • 确认系统已安装 Git：sudo apt install git
  • PhpStorm：File → Settings → Version Control → Git → Path to Git executable 设为 /usr/bin/git；填写 User name 与 Email。
  • 在项目中：VCS → Enable Version Control Integration → 选择 Git；随后可使用 Commit、Push、Pull 等完整协作流程。
• GitHub 集成
  • VCS → GitHub → 登录账号；可直接 Clone、Create Pull Request、Review 等。

五 远程开发与多项目管理技巧

• 远程解释器
  • File → Settings → Languages & Frameworks → PHP → Add → Remote（SSH/WSL 等），填写 Host/Port，测试连接后作为项目解释器使用，实现依赖与运行环境统一。
• 远程项目与内置服务器
  • 远程开发：通过 Remote Interpreter 或 Deployment 同步/直接编辑远程代码，本地调试与运行。
  • 快速演示：远程服务器在项目目录执行 php -S 0.0.0.0:8000；PhpStorm 新增 PHP Built-in Web Server 配置 Document root 与 Port，浏览器访问 http://服务器IP:8000。
• 多项目与窗口管理
  • 同一窗口多目录：使用 Content Roots 聚合管理。
  • 并行多开：Window → New Window；或创建多个桌面快捷方式/启动器，便于同时开发多个项目。