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 配置常用片段提升效率。