ubuntu 如何配置 phpstorm 环境

Ubuntu配置PhpStorm环境详细步骤

1. 安装PhpStorm

1.1 下载安装包

访问JetBrains官网（jetbrains.com），进入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=PhpStorm
Comment=PHP IDE
Exec=/opt/phpstorm/bin/phpstorm.sh
Icon=/opt/phpstorm/bin/webide.png
Terminal=false
Type=Application
Categories=Development;IDE;

保存后，桌面上会出现PhpStorm启动器图标。

1.3 配置环境变量（可选）

为方便命令行启动，编辑~/.bashrc（或~/.zshrc，根据shell类型）文件：

nano ~/.bashrc

在文件末尾添加以下内容（替换为实际路径）：

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

保存后运行source ~/.bashrc使更改生效，此后可通过phpstorm命令直接启动软件。

2. 激活PhpStorm

启动PhpStorm（通过终端命令phpstorm或桌面图标），首次启动后会提示激活。选择激活码方式，输入购买的授权码即可；若使用破解版，需将解压包中的ja-netfilter-all文件夹复制至/opt/phpstorm/bin目录，运行./install.sh脚本完成激活。

3. 配置PHP解释器

3.1 安装PHP及扩展

确保系统已安装PHP（建议版本≥7.4）及常用扩展（如xdebug、mbstring）：

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

验证PHP安装：

php -v  # 查看PHP版本

3.2 配置PhpStorm解释器

打开PhpStorm，点击顶部菜单File > Settings（或Ctrl+Alt+S），导航至Languages & Frameworks > PHP。点击右上角齿轮图标→Add，选择PHP Executable，浏览至系统PHP安装路径（通常为/usr/bin/php），点击OK保存。

4. 配置Xdebug调试

4.1 安装与配置Xdebug

若未安装xdebug，通过以下命令安装：

sudo apt install php-xdebug

编辑php.ini文件（位置可通过php --ini查看），在文件末尾添加以下配置（替换/path/to/xdebug.so为实际路径，可通过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  # 注意：避免与php-fpm端口（默认9000）冲突

重启Apache/Nginx使配置生效：

sudo systemctl restart apache2  # 若使用Apache
# 或
sudo systemctl restart nginx    # 若使用Nginx

#### **4.2 配置PhpStorm调试**
打开`Run > Edit Configurations`，点击`+`号选择`PHP Web Page`，配置以下选项：
- **Name**：自定义配置名称（如`Xdebug`）；
- **Server**：点击`+`号添加新服务器，填写`Host`（如`localhost`）、`Port`（如`80`）、`Debugger`（选择`Xdebug`）；
- **Start URL**：填写要调试的页面URL（如`http://localhost/info.php`）。
点击`OK`保存配置。


### **5. 配置远程开发（可选）**
#### **5.1 配置远程服务器**
在远程Ubuntu服务器上安装PHP及Web服务（如Apache）：
```bash
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。

5.3 配置远程调试

打开Run > Edit Configurations，点击+号选择PHP Remote Debug，在Server选项卡中选择之前配置的远程服务器，点击OK保存。设置断点后，点击工具栏绿色蜘蛛图标启动调试会话。

6. 安装插件（可选）

打开File > Settings > Plugins，搜索所需插件（如中文语言包、Git Integration），点击Install安装。安装完成后重启PhpStorm使插件生效（如安装中文包后，重启即可切换语言）。

通过以上步骤，即可在Ubuntu系统上完成PhpStorm的环境配置，满足PHP开发、调试及远程协作需求。配置过程中若遇到权限问题，可使用sudo提升权限；若需更新PhpStorm，重复下载解压步骤并替换旧版本文件即可。