在 Debian 上定制 PhpStorm 工作环境
一 基础安装与启动
- 下载并解压 PhpStorm 到系统目录（示例为 /opt）：
- 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
- ./bin/phpstorm.sh
- 将可执行目录加入 PATH，便于命令行启动：
- echo ‘export PATH=$PATH:/opt/phpstorm-2024.3.5/bin’ >> ~/.bashrc
- source ~/.bashrc
- 首次启动按向导完成许可证激活与基础设置。
二 外观与编辑器主题
- 切换界面主题（UI）：进入 File → Settings → Appearance & Behavior → Appearance，在 Theme 中选择 Darcula/Light，点击 Apply。
- 更换编辑器配色：进入 File → Settings → Editor → Color Scheme，在 Scheme 中选择内置主题；也可导入第三方 .icls 主题文件后在此选择。
- 导入外部主题的小提示：导入后若出现黑色主题背景异常（局部发白），可在 File → Settings → Editor → Color Scheme → Language Defaults 中取消 Background 的勾选以修复显示。
三 PHP 运行环境与工具链
- 配置 PHP 解释器：进入 Settings → Languages & Frameworks → PHP，点击 Add，选择 PHP 可执行文件（常见路径 /usr/bin/php），自动检测版本与扩展。
- 配置 Composer：在 Settings → Languages & Frameworks → PHP → Composer 指定 Composer 可执行文件路径（常见路径 /usr/local/bin/composer）。
- 安装与配置 Xdebug（推荐）：
- 安装扩展：sudo apt install php-xdebug
- 编辑 php.ini（CLI 与 FPM 分别配置），新增或修改：
- zend_extension=xdebug.so
- xdebug.mode=debug
- xdebug.client_host=127.0.0.1
- xdebug.client_port=9003
- xdebug.idekey=PHPSTORM
- 在 PhpStorm：Settings → PHP → Debug，将调试端口设为 9003，IDE Key 设为 PHPSTORM；浏览器端安装 Xdebug Helper 扩展并配置端口 9003 后开始断点调试。
四 版本选择与安装方式
- 版本选择：优先选择 最新稳定版 以获得更好的 PHP 与框架支持；如需长期稳定可评估 EAP/RC 与稳定分支的取舍。
- 安装方式：
- 官方 .tar.gz 方案：解压即用、便于多版本并存，适合需要灵活管理的开发环境。
- .deb 包方案：sudo dpkg -i phpstorm-*.deb，便于系统集成与更新管理（适合桌面环境）。
五 效率提升与常用定制
- 插件生态：在 Settings → Plugins 搜索并安装常用插件（如 Chinese Language Pack 中文语言包），安装后重启 IDE 生效。
- 数据库工具：在 Settings → Languages & Frameworks → PHP → Database 添加 MySQL/PostgreSQL 等数据源，配置主机、端口、账号密码并测试连接，可在 IDE 内直接执行查询与迁移。
- 外观与配色：结合 Darcula/Light 界面主题与 Color Scheme 配色方案，打造舒适且高对比度的编码环境；导入 .icls 主题后按需微调高亮与背景。