在 Ubuntu 上使用 PhpStorm 的命令行工具
一 准备与安装
- 从 JetBrains 官网下载适用于 Linux 的 PhpStorm 安装包(.tar.gz),解压到系统目录(如 /opt/phpstorm),并赋予可执行权限。示例:
- 解压:
tar -xvzf PhpStorm-*.tar.gz -C /opt
- 进入目录:
cd /opt/phpstorm/bin
- 启动:
/opt/phpstorm/bin/phpstorm.sh
- 为便于在任意目录调用,将启动脚本加入 PATH 或创建别名(任选其一):
- 软链接:
sudo ln -s /opt/phpstorm/bin/phpstorm.sh /usr/local/bin/phpstorm
- 别名:在
~/.bashrc 或 ~/.zshrc 中添加 alias phpstorm='/opt/phpstorm/bin/phpstorm.sh',然后执行 source ~/.bashrc 或 source ~/.zshrc
- 首次启动按向导完成配置与激活。
二 常用命令行用法
- 启动 IDE:
- 直接启动:
phpstorm
- 指定项目目录:
phpstorm /path/to/project
- 打开文件或目录:
- 打开文件:
phpstorm /path/to/file.php
- 打开目录:
phpstorm /path/to/dir
- 在已打开项目中执行命令(避免新开窗口):
- 仅聚焦到已运行实例:
phpstorm .(当前目录)
- 无界面/后台启动(不占用终端):
- 使用 nohup:
nohup phpstorm . >/dev/null 2>&1 &
- 查看可用命令行开关(不同版本可能略有差异):
- 查看帮助:在终端执行
phpstorm --help(若支持)
三 与项目、调试和版本控制集成
- 配置 PHP 解释器与调试(Xdebug):
- 在 PhpStorm 中:File → Settings → Languages & Frameworks → PHP → CLI Interpreter,设置 PHP Executable(如 /usr/bin/php)。
- 调试端口常用 9003(Xdebug 3+);在 Run → Edit Configurations 中新增 PHP Web Page 或 PHP Remote Debug 进行断点调试。
- 命令行与 Git 协同:
- 确保系统已安装 Git:
sudo apt update && sudo apt install git
- 在 PhpStorm 中:VCS → Enable Version Control Integration → Git,即可在 IDE 内使用提交、拉取、分支等 Git 功能。
四 常见问题与排查
- 命令未找到:确认已将 /opt/phpstorm/bin 加入 PATH 或已创建别名,并执行
source ~/.bashrc/~/.zshrc 使配置生效。
- 权限不足:若使用软链接或安装到 /opt,确保当前用户对相应目录有执行权限(必要时使用
sudo)。
- 无法调试:检查 Xdebug 已安装并启用,PhpStorm 调试端口与 php.ini 配置一致(常见为 9003),并在 Run/Debug 配置中正确选择 Server 与 Debugger。