在 Debian 上配置 PHPStorm 开发环境
一 准备与安装
- 更新系统与基础工具：
- 执行：
sudo apt update && sudo apt upgrade
- 安装常用构建工具：
sudo apt install gcc make
- 获取并安装 PHPStorm（以 2024.3.5 为例，可按需替换为最新版本）：
- 下载：
wget https://download.jetbrains.com/phpstorm/phpstorm-2024.3.5.tar.gz
- 解压到系统目录：
sudo tar -xzf phpstorm-2024.3.5.tar.gz -C /opt
- 运行安装脚本：
/opt/phpstorm-2024.3.5/bin/install.sh
- 启动与激活：
- 启动：
/opt/phpstorm-2024.3.5/bin/phpstorm.sh
- 首次启动按提示完成许可证激活（JetBrains 账号/激活码/许可证文件）。
二 配置 PHP 解释器与 Web 服务器
- 配置 CLI 解释器：
- 打开设置：File → Settings → Languages & Frameworks → PHP
- 在 CLI Interpreter 中点“…”选择或添加 /usr/bin/php（可通过
which php 确认路径）
- 配置 Web 服务器（如 Apache/Nginx）：
- Settings → PHP → Servers 新增服务器，指定本地站点根目录与 URL
- 若使用本机 Web 服务，确保 80/443 端口未被占用且防火墙放行
- 兼容性核对：
- 确认项目所需 PHP 版本与系统一致（
php -v）
- 检查 Web 服务器对 .php 的处理配置是否正确。
三 调试环境 Xdebug 3 配置
- 安装 Xdebug（Debian 常见包名）：
- 执行：
sudo apt install php-xdebug
- 配置 php.ini（示例为 Xdebug 3，路径以实际为准，如 /etc/php/*/cli/php.ini 与 /etc/php/*/fpm/php.ini）：
- 追加或确保包含：
zend_extension=xdebug.soxdebug.mode=debugxdebug.client_host=127.0.0.1xdebug.client_port=9003xdebug.idekey=PHPSTORM
- 配置 PHPStorm 调试：
- Settings → PHP → Debug：设置 Debug port 为 9003，IDE Key 为 PHPSTORM
- 浏览器安装 Xdebug Helper 等扩展，并将监听端口设为 9003
- 验证：
- 在 PHPStorm 中开启监听（Start Listening for PHP Debug Connections），访问项目触发断点。
四 常用优化与问题排查
- 命令行一键启动与 PATH：
- 将 PHPStorm 加入 PATH：在
~/.bashrc 或 ~/.zshrc 中添加
export PATH=$PATH:/opt/phpstorm-2024.3.5/bin
- 使配置生效：
source ~/.bashrc 或 source ~/.zshrc
- 之后可直接执行：
phpstorm
- 代码自动补全与模板：
- Settings → Editor → General → Code Completion：勾选 Autopopup code completion
- 在 Editor → Live Templates 中自定义常用代码片段
- 常见报错处理：
- 权限问题：对解压目录执行
sudo chown -R $USER:$USER /opt/phpstorm-2024.3.5
- 内存不足：增加 Swap 或关闭占用大的应用
- 查看日志定位：日志目录
~/.phpstorm<version>/system/log/
- 运行环境：确保已安装 JRE（如
sudo apt install openjdk-11-jre）。
