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协议实现本地与远程项目的文件同步，步骤如下：

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

3. 配置远程PHP解释器

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

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

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

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

1. 远程服务器安装Apache：

   sudo apt install apache2
   

2. 将项目目录设置为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
   

3. 进入File > Settings > Tools > Web Servers，点击+号添加新服务器：
   • Name：自定义服务器名称（如My Remote Server）；
   • Type：选择Local or mounted folder；
   • URL：输入访问地址（如http://localhost）；
   • Document root：选择本地项目目录（与远程项目目录映射的本地路径一致）。
4. 点击OK保存，此后可通过PhpStorm的浏览器工具栏快速访问远程项目。

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

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

1. 远程服务器安装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
   

2. PhpStorm配置Xdebug：
   进入File > Settings > Languages & Frameworks > PHP > Debug，确保Debug port与xdebug.remote_port一致（如9003）。
   点击Validate debugger configuration，选择Xdebug，验证连接是否成功。
   配置DBGp Proxy，设置IDE key为PHPSTORM。

3. 开始调试：
   在代码中设置断点，点击PhpStorm顶部工具栏的Start Listening for PHP Debug Connections（电话图标），然后在浏览器中访问远程项目（如http://localhost/my_project/index.php），即可触发调试。

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

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！