Ubuntu中PHPStorm配置步骤是什么

Ubuntu 中 PhpStorm 配置步骤

想在 Ubuntu 上顺畅地使用 PhpStorm 进行 PHP 开发？其实，只要跟着下面这几个清晰的步骤走，从安装到调试，再到远程部署，整个过程都能一气呵成。咱们这就开始。

一 安装与首次启动

首先，你需要获取 PhpStorm 的 Linux 版本。通常，它是一个 .tar.gz 格式的压缩包，下载后可以放在诸如 ~/Downloads 这样的本地目录。

接下来的操作主要在终端里完成：

• 解压文件：使用命令 tar -zxvf PhpStorm-*.tar.gz。
• 移动目录：为了规范管理，建议将解压后的整个目录移动到系统级的 /opt 目录下，命令是 sudo mv PhpStorm-* /opt/phpstorm。

完成这些，就可以首次启动了。进入刚才那个目录下的 bin 文件夹，执行 ./phpstorm.sh 脚本即可。

当然，每次都这样启动未免麻烦。有两个优化操作能让体验更接近原生应用：

• 创建命令行软链接：执行 sudo ln -s /opt/phpstorm/bin/phpstorm.sh /usr/local/bin/phpstorm，之后在任意终端输入 phpstorm 就能启动。
• 创建桌面图标：在 /usr/share/applications/ 目录下创建一个名为 phpstorm.desktop 的文件，内容可以参考下面的示例。这样，你就能在应用菜单里找到并启动它了。

  [Desktop Entry]
  Name=PhpStorm
  Comment=PHP IDE
  Exec=/opt/phpstorm/bin/phpstorm.sh
  Icon=/opt/phpstorm/bin/webide.png
  Terminal=false
  Type=Application
  Categories=Development;IDE;

首次启动时，跟着向导完成初始配置和激活流程，你的 PhpStorm 就准备就绪了。

二 配置 PHP 解释器

IDE 装好了，但它的核心——PHP 解释器——还没告诉它用哪个。这一步就是让 PhpStorm 认识并调用你系统里的 PHP。

首先，确保系统已经安装了合适版本的 PHP（建议不低于 7.4）以及一些常用扩展：

• 安装命令：sudo apt update && sudo apt install php php-xdebug php-mbstring php-xml
• 安装后，别忘了用 php -v 验证一下是否成功。

然后，在 PhpStorm 中进行设置：

• 打开 File > Settings > Languages & Frameworks > PHP > CLI Interpreter。
• 点击旁边的齿轮图标，选择 Add。
• 在弹出的窗口中，选择 “PHP Executable”，然后浏览并指向你系统 PHP 的路径（通常是 /usr/bin/php）。

这样一来，PhpStorm 就能正确识别并使用你的 PHP 环境了。

三 配置 Xdebug 调试

对于开发者来说，高效的调试工具至关重要。在 Ubuntu 上配置 Xdebug 与 PhpStorm 联动，是打通本地调试的关键。

如果之前安装 PHP 扩展时漏掉了 Xdebug，可以单独安装：sudo apt install php-xdebug。

接下来是核心配置，需要编辑 PHP 的配置文件 php.ini。它的路径可以通过 php --ini 命令查看。在文件中找到或添加以下配置：

zend_extension=/usr/lib/php/20230831/xdebug.so # 路径以 php -i | grep xdebug.so 输出为准
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.client_port=9003 # 避免与 php-fpm 的 9000 端口冲突

配置完成后，需要重启你的 Web 服务器以使更改生效：

• 如果是 Apache：sudo systemctl restart apache2
• 如果是 Nginx：sudo systemctl restart nginx

最后，回到 PhpStorm 创建调试配置：

• 点击 Run > Edit Configurations，然后新建一个 “PHP Web Page”。
• 在配置中，需要新建一个 Server，填写 Host（如 localhost）、Port（如 80），并将 Debugger 选为 Xdebug。
• 设置好 Start URL（例如 http://localhost/info.php），保存后，你就可以在代码中设置断点并进行调试了。

四 远程开发与部署（可选）

如果你的开发环境或生产环境在远程服务器上，PhpStorm 也能很好地支持。

首先，可以添加远程 PHP 解释器：

• 路径是 File > Settings > Languages & Frameworks > PHP，点击齿轮图标选择 Add > Remote。
• 填写远程服务器的 Host、端口（通常是 22），通过 SSH 测试连接，成功即可应用。

其次，配置部署（Deployment）功能，实现代码的自动同步：

• 打开 File > Settings > Build, Execution, Deployment > Deployment，新建一个 SFTP 类型的配置。
• 在这里配置好 SSH 连接信息，并设置本地项目路径与远程服务器路径的映射关系。

最后，远程调试的配置也不复杂：

• 在 Run > Edit Configurations 中，新建一个 “PHP Remote Debug”。
• 选择前面配置好的 Server，然后在代码中设置断点，并启动 PhpStorm 的监听，即可开始远程调试。

五 常用优化与插件

基础功能配置完毕后，还有一些优化和扩展能让你的开发体验更上一层楼。

版本控制集成是必不可少的。在 Settings > Version Control 中，可以配置 Git 等版本控制工具的路径，方便在 IDE 内直接进行代码提交、拉取等操作。

此外，PhpStorm 强大的插件市场能极大扩展其能力。打开 Settings > Plugins，你可以搜索并安装需要的插件，例如中文语言包、更深入的 Git 集成工具等。安装后记得重启 IDE，插件便会生效。

至此，一套从本地安装、环境配置、调试到远程开发的 PhpStorm 工作流就在 Ubuntu 上搭建完成了。剩下的，就是尽情享受高效编码的乐趣了。