Ubuntu中PHPStorm配置步骤是什么

首页

编程语言

热心网友

转载

2026-04-16

Ubuntu 系统下 PhpStorm 安装与配置完整指南

你是否正在寻找在 Ubuntu 操作系统上高效配置 PhpStorm 进行 PHP 项目开发的详细教程？本文将为你提供从软件安装、PHP 环境集成、Xdebug 调试器设置到远程服务器部署的一站式解决方案。遵循以下步骤，你可以在 Ubuntu 桌面或服务器上快速搭建专业的 PHP 集成开发环境。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

一、 PhpStorm 安装与首次启动设置

首先，你需要从 JetBrains 官网下载适用于 Linux 平台的 PhpStorm 安装包。通常，官方提供的是 .tar.gz 格式的压缩归档文件，建议将其保存到用户下载目录（如 ~/Downloads）以便管理。

接下来的安装过程主要通过终端命令行完成，具体操作如下：

解压缩文件：在终端中导航到下载目录，执行解压命令 tar -zxvf PhpStorm-*.tar.gz。
移动至系统目录：为了保持系统整洁并便于多用户访问，建议将解压后的文件夹移动到 /opt 目录，使用命令 sudo mv PhpStorm-* /opt/phpstorm。

完成基础安装后，你可以通过进入安装目录的 bin 子文件夹并运行 ./phpstorm.sh 脚本来首次启动 IDE。

为了提升日常使用的便捷性，我们推荐进行以下两项优化设置：

创建全局终端命令：通过建立符号链接，实现在任意终端路径下快速启动。执行 sudo ln -s /opt/phpstorm/bin/phpstorm.sh /usr/local/bin/phpstorm，之后只需输入 phpstorm 即可启动。
创建桌面应用程序图标：在 /usr/share/applications/ 路径下创建名为 phpstorm.desktop 的桌面入口文件，内容可参考下方配置。完成后，你便能在系统应用启动器中找到 PhpStorm 图标。
```
[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 解释器，这是代码运行、语法检查与调试的基础。

首先，请确保你的 Ubuntu 系统已安装了合适版本的 PHP 运行时及相关扩展。建议使用 PHP 7.4 或更高版本以获得更好的性能与特性支持。可以通过以下命令安装：

更新包列表并安装：sudo apt update && sudo apt install php php-xdebug php-mbstring php-xml
验证安装：安装完成后，在终端执行 php -v 来确认 PHP 版本信息。

随后，在 PhpStorm 内部进行解释器绑定：

导航至 File > Settings > Languages & Frameworks > PHP > CLI Interpreter。
点击设置齿轮图标，选择 Add 来添加新的解释器。
在弹出的对话框中，选择 “PHP Executable” 类型，然后通过浏览文件系统定位到 PHP 可执行文件的路径（通常位于 /usr/bin/php）。

完成此配置后，PhpStorm 将能够正确解析 PHP 语法并利用该环境执行脚本。

三、集成 Xdebug 进行代码调试

高效的调试是开发效率的关键。在 Ubuntu 中配置 Xdebug 扩展并与 PhpStorm 集成，可以实现强大的断点调试、变量监视和堆栈跟踪功能。

如果尚未安装 Xdebug 扩展，请使用命令 sudo apt install php-xdebug 进行安装。

接下来是关键的配置文件修改。你需要编辑 PHP 的配置文件 php.ini。可以通过运行 php --ini 命令来查找其准确路径。在文件中添加或修改以下 Xdebug 配置项：

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，填写服务器的主机名（如 localhost）、端口号（如 80 或 443），并将 Debugger 类型设置为 Xdebug。
设置项目的起始 URL（例如 https://localhost/your_project/index.php）。保存配置后，你就可以在代码编辑器中点击行号旁设置断点，并启动调试会话了。