首页 > 编程语言 >Ubuntu如何配置PhpStorm环境

Ubuntu如何配置PhpStorm环境

来源：互联网 2026-08-01 08:19:04

在Ubuntu上配置PhpStorm开发环境，需先下载解压至/opt目录，并创建桌面启动器。接着安装PHP及所需扩展，配置CLI解释器路径。然后安装Xdebug并设置监听端口9003，通过Run配置启用调试功能。若进行远程开发，则需配置SSH连接。此外，还可选安装插件以增强功能。

在Ubuntu上配置PhpStorm开发环境，过程较为直接，但需要注意若干细节。初学者容易在关键步骤上遇到问题，例如PHP解释器路径、Xdebug端口冲突。以下将完整梳理整个流程，确保配置完成后即可直接用于开发。

长期稳定更新的攒劲资源： >>>点此立即查看<<<

1. 安装PhpStorm

1.1 下载安装包

访问JetBrains官网，找到PhpStorm的下载页面。Linux版本通常为.tar.gz格式的压缩包，直接下载即可。

1.2 解压与安装

打开终端，切换到下载目录，例如~/Downloads，执行解压命令：

tar -zxvf PhpStorm-*.tar.gz  # 将文件名替换为实际下载的文件

解压完成后，将解压后的目录移动到/opt目录下，这是系统级软件的标准安装位置：

sudo mv PhpStorm-* /opt/phpstorm

接下来，可以创建桌面启动器，以便通过图标启动，无需每次运行终端。编辑以下文件：

sudo gedit /usr/share/applications/phpstorm.desktop

将以下内容复制进去，图标路径通常为/opt/phpstorm/bin/webide.png，请确认文件存在：

[Desktop Entry]Name=PhpStormComment=PHP IDEExec=/opt/phpstorm/bin/phpstorm.shIcon=/opt/phpstorm/bin/webide.pngTerminal=falseType=ApplicationCategories=Development;IDE;

保存后，在应用菜单中即可找到PhpStorm的图标。

1.3 配置环境变量（可选）

为了方便在命令行中直接输入phpstorm启动，可以配置环境变量。编辑shell配置文件，例如~/.bashrc：

nano ~/.bashrc

在文件末尾添加以下两行：

alias phpstorm='/opt/phpstorm/bin/phpstorm.sh'export PATH=$PATH:/opt/phpstorm/bin

保存后，运行source ~/.bashrc使配置生效。之后在终端中输入phpstorm即可启动。

2. 激活PhpStorm

首次启动时，会弹出激活窗口。最直接的方式是输入购买的授权码。如果使用其他激活方式，例如破解补丁，则需要将ja-netfilter-all文件夹复制到/opt/phpstorm/bin目录下，然后运行./install.sh脚本。具体操作请参考相应教程。

3. 配置PHP解释器

3.1 安装PHP及扩展

在配置PhpStorm之前，需要确保系统已安装PHP。建议安装7.4及以上版本，并安装常用扩展：

sudo apt update
sudo apt install php php-xdebug php-mbstring php-xml

安装完成后，检查版本：

php -v

3.2 配置PhpStorm解释器

打开PhpStorm，进入File > Settings（或按Ctrl+Alt+S）。在左侧导航菜单中找到Languages & Frameworks > PHP。在右侧的“CLI Interpreter”旁边，点击齿轮图标，选择Add，然后选择PHP Executable。浏览到系统PHP的安装路径，通常为/usr/bin/php，选中后点击OK保存。完成此步骤后，PhpStorm即可识别PHP环境。

4. 配置Xdebug调试

4.1 安装与配置Xdebug

Xdebug是PHP调试的核心工具。如果未安装，可执行以下命令：

sudo apt install php-xdebug

关键步骤是配置php.ini文件。首先找到其位置：php --ini。然后编辑该文件，在末尾添加以下配置。注意，zend_extension的路径需要替换为实际文件路径，可通过php -i | grep xdebug.so查询。

zend_extension=/usr/lib/php/20230831/xdebug.so  # 请替换为实际路径
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.client_port=9003  # 使用9003端口，避免与php-fpm冲突

配置完成后，重启Web服务器：

sudo systemctl restart apache2  # 如果使用Apache
# 或
sudo systemctl restart nginx    # 如果使用Nginx

4.2 配置PhpStorm调试

在PhpStorm中，打开Run > Edit Configurations，点击左上角的+号，选择PHP Web Page。然后进行以下配置：

Name: 任意命名，例如“Xdebug”。
Server: 点击+号添加新服务器。填写Host（例如localhost）、Port（例如80），Debugger选择Xdebug。
Start URL: 填写要调试的页面地址，例如http://localhost/info.php。

点击OK保存。设置断点后，点击调试按钮即可开始调试。

5. 配置远程开发（可选）

5.1 配置远程服务器

如果需要在远程服务器上开发，流程类似。首先在远程Ubuntu服务器上安装PHP和Apache：

sudo apt update
sudo apt install php apache2
sudo systemctl start apache2

然后创建项目目录并设置权限：

mkdir -p /var/www/html/my_project
sudo chown -R $USER:$USER /var/www/html/my_project
sudo chmod -R 755 /var/www/html/my_project

5.2 配置PhpStorm远程解释器

再次进入File > Settings > Languages & Frameworks > PHP，点击齿轮图标，选择Add，这次选择Remote。在Host中填写远程服务器的IP或域名，Port填写SSH端口（默认22），点击Test Connection。系统会提示输入远程服务器的用户名和密码，连接成功后点击OK。这样PhpStorm即可通过SSH调用远程服务器上的PHP。