Debian 上配置 PhpStorm 的完整指南
一 安装与首次启动
- 下载并解压 PhpStorm（Linux 版为 .tar.gz）：
- 示例：wget https://download.jetbrains.com/phpstorm/phpstorm-2024.3.5.tar.gz
- 解压：tar -xzf phpstorm-2024.3.5.tar.gz -C /opt
- 运行安装脚本并启动：
- cd /opt/phpstorm-2024.3.5/bin
- ./install.sh
- ./phpstorm.sh
- 可选：将 /opt/phpstorm-2024.3.5/bin 加入 PATH，便于命令行启动：
- echo ‘export PATH=$PATH:/opt/phpstorm-2024.3.5/bin’ >> ~/.bashrc && source ~/.bashrc
- 首次启动按向导完成配置，进入 IDE 主界面。
二 基础配置
- 设置 PHP 解释器：File → Settings → Languages & Frameworks → PHP → CLI Interpreter，选择或添加 /usr/bin/php 等可用解释器。
- 外观与字体：Editor → Color Scheme、Editor → Font，按习惯调整主题与字号。
- 版本控制：Settings → Version Control，配置 Git 路径（通常自动检测）。
- 插件：Settings → Plugins，按需安装如 Docker、Xdebug Helper 等。
三 调试配置 Xdebug 3
- 安装扩展（CLI 与 Web 保持一致版本）：sudo apt install php-xdebug
- 编辑 php.ini（路径因版本可能为 /etc/php/8.x/cli/php.ini 或 /etc/php/8.x/apache2/php.ini）：
- zend_extension=xdebug.so
- xdebug.mode=debug
- xdebug.client_host=127.0.0.1
- xdebug.client_port=9003
- xdebug.idekey=PHPSTORM
- 重启服务：sudo systemctl restart apache2 或 sudo systemctl restart php8.x-fpm
- PhpStorm 设置：Settings → Languages & Frameworks → PHP → Debug，将端口设为 9003；Run → Edit Configurations 新建 PHP Web Page 或 PHP Script，IDE Key 填 PHPSTORM。
- 浏览器调试：安装 Xdebug Helper 扩展，调试时选择 IDE Key 为 PHPSTORM 并开启监听。
四 导入项目与运行调试
- 导入项目：File → Open，选择项目目录；或 Welcome 界面选择 New Project（如 PHP Empty Project），指定项目 SDK（PHP 解释器）。
- 运行与调试：在代码行号左侧点下断点，使用工具栏绿色三角（Run）或虫子图标（Debug）启动；也可右键文件选择 Run/Debug。
五 常见问题与优化
- 依赖缺失导致界面异常：安装常见 GUI 依赖（示例）sudo apt install libgtk-3-0 libnotify-dev libgconf-2-4 libnss3 libxss1 libasound2 libxtst6 xauth xvfb。
- 命令行无法启动：确认已将 /opt/phpstorm-2024.3.5/bin 加入 PATH 并执行 source 使配置生效。
- 代码自动补全：Settings → Editor → General → Code Completion，勾选 Autopopup code completion；在 Editor → Live Templates 配置常用片段提升效率。
