phpstorm在Ubuntu如何进行远程开发

PhpStorm在Ubuntu上的远程开发配置指南
PhpStorm支持在Ubuntu（本地或远程服务器）上进行高效的远程开发，核心流程包括SSH连接配置、远程解释器设置、文件同步及可选的远程调试。以下是详细步骤：

1. 准备远程Ubuntu服务器

确保远程Ubuntu服务器已安装必要组件：

SSH服务器：用于安全文件传输和远程命令执行。若未安装，运行以下命令：
```
sudo apt update
sudo apt install openssh-server
```
编辑配置文件/etc/ssh/sshd_config，确保Port 22、PasswordAuthentication yes（或配置SSH密钥）未被注释，重启服务使配置生效：
```
sudo systemctl restart sshd
```
PHP环境：根据项目需求安装PHP及扩展（如php-cli、php-mysql、php-curl等）：
```
sudo apt install php php-cli php-mysql php-curl
```

2. 配置PhpStorm的SSH连接与文件同步

通过SFTP协议实现本地与远程项目的文件同步，步骤如下：

打开PhpStorm，进入File > Settings > Build, Execution, Deployment > Deployment。
点击+号添加新配置，选择SFTP类型。
在Connection标签页填写远程服务器信息：
- SFTP host：远程服务器IP或域名（如192.168.1.100）；
- Port：SSH端口（默认22，若修改过需保持一致）；
- Username：登录远程服务器的用户名（如ubuntu）；
- Authentication type：选择Password（输入密码）或Key pair（配置SSH密钥，更安全）。
点击Test SFTP connection验证连接是否成功。
切换至Mappings标签页，设置本地项目路径（如/home/user/my_project）与远程项目路径（如/var/www/html/my_project）的映射关系。
（可选）切换至Excluded Paths标签页，排除无需同步的目录（如node_modules、vendor）。
点击OK保存配置，此后可通过Deployment > Upload to [配置名]手动同步文件，或开启Automatic upload实现保存时自动同步。

3. 配置远程PHP解释器

让PhpStorm使用远程服务器的PHP环境，确保代码解析与远程一致：

进入File > Settings > Languages & Frameworks > PHP。
点击CLI Interpreter右侧的...按钮，选择Add。
在Interpreter标签页，选择Remote类型，再选择SSH Credentials。
输入远程服务器的Host、Port、Username及认证信息（密码或密钥），点击Next。
PhpStorm会自动检测远程PHP路径（如/usr/bin/php），确认后点击Finish。
点击OK保存配置，此时PhpStorm会使用远程PHP解释器执行代码检查、调试等操作。

4. 配置Web服务器（可选但推荐）

若项目需要通过HTTP访问（如测试接口、查看前端页面），需配置远程Web服务器（以Apache为例）：

远程服务器安装Apache：
```
sudo apt install apache2
```
将项目目录设置为Apache的虚拟主机根目录（如/var/www/html/my_project），并赋予适当权限：
```
sudo chown -R $USER:$USER /var/www/html/my_project
sudo chmod -R 755 /var/www/html/my_project
```
进入File > Settings > Tools > Web Servers，点击+号添加新服务器：
- Name：自定义服务器名称（如My Remote Server）；
- Type：选择Local or mounted folder；
- URL：输入访问地址（如http://localhost）；
- Document root：选择本地项目目录（与远程项目目录映射的本地路径一致）。
点击OK保存，此后可通过PhpStorm的浏览器工具栏快速访问远程项目。

5. 远程调试配置（可选）

若需要调试远程代码（如设置断点、查看变量），需配置Xdebug：

远程服务器安装Xdebug：

sudo pecl install xdebug

编辑php.ini文件（如/etc/php/8.1/cli/php.ini），添加以下配置：

[xdebug]
zend_extension=xdebug.so
xdebug.remote_enable=1
xdebug.remote_handler=dbgp
xdebug.remote_host=<你的本地IP地址>  # 如192.168.1.101
xdebug.remote_port=9003               # 避免与默认端口冲突
xdebug.remote_autostart=1
xdebug.idekey=PHPSTORM

重启Apache使配置生效：

sudo systemctl restart apache2

PhpStorm配置Xdebug：
进入File > Settings > Languages & Frameworks > PHP > Debug，确保Debug port与xdebug.remote_port一致（如9003）。
点击Validate debugger configuration，选择Xdebug，验证连接是否成功。
配置DBGp Proxy，设置IDE key为PHPSTORM。
开始调试：
在代码中设置断点，点击PhpStorm顶部工具栏的Start Listening for PHP Debug Connections（电话图标），然后在浏览器中访问远程项目（如http://localhost/my_project/index.php），即可触发调试。

通过以上步骤，即可在Ubuntu环境下使用PhpStorm实现远程开发，覆盖代码编写、同步、调试全流程。配置过程中需注意权限设置（如远程目录权限）及网络连通性（如防火墙放行SSH、Xdebug端口），确保配置顺利。

1. 准备远程Ubuntu服务器

2. 配置PhpStorm的SSH连接与文件同步

3. 配置远程PHP解释器

4. 配置Web服务器（可选但推荐）

5. 远程调试配置（可选）

最新问答

相关标签