如何在Ubuntu上使用PHPStorm远程开发

如何在Ubuntu上使用PHPStorm进行远程开发
在Ubuntu上使用PHPStorm远程开发，核心是通过SSH连接实现代码同步、远程PHP解释器配置及调试工具集成，以下是详细步骤：

一、准备工作：配置Ubuntu远程服务器

1. 安装SSH服务器
   远程开发需通过SSH协议传输文件和命令，在Ubuntu终端执行以下命令安装并启动SSH服务：

   sudo apt update
   sudo apt install openssh-server
   sudo systemctl restart sshd
   

   确保/etc/ssh/sshd_config中PasswordAuthentication yes（允许密码登录）或配置SSH密钥认证（更安全）。

2. 创建项目目录并设置权限
   在远程服务器上创建用于存放项目的目录（如/var/www/html/my_project），并修改所属用户及权限：

   sudo mkdir -p /var/www/html/my_project
   sudo chown -R $USER:$USER /var/www/html/my_project  # 替换$USER为你的Ubuntu用户名
   sudo chmod -R 755 /var/www/html/my_project
   

3. 安装PHP环境
   若未安装PHP，通过以下命令安装（以Ubuntu 22.04为例）：

   sudo apt install php php-cli php-mbstring php-xml php-curl
   

   验证安装：php -v（显示PHP版本即成功）。

二、PHPStorm配置远程开发

1. 配置远程解释器（关键：让PHPStorm使用远程PHP）

远程解释器确保PHPStorm能识别远程服务器的PHP版本及扩展：

• 打开PHPStorm，进入File > Settings > Languages & Frameworks > PHP。
• 点击CLI Interpreter右侧的...，选择Add。
• 选择SSH Interpreter，输入远程服务器的IP地址/域名、用户名（如ubuntu），选择认证方式（密码或SSH密钥）。
• 在Interpreter栏填写远程PHP路径（通常为/usr/bin/php，可通过which php命令获取），点击Test Connection验证连接。
• 点击OK保存，此时PHPStorm会同步远程PHP的扩展（如Xdebug）。

2. 配置文件同步（Deployment：本地与远程代码同步）

通过SFTP协议实现本地项目与远程服务器的文件双向同步：

• 进入File > Settings > Build, Execution, Deployment > Deployment，点击+选择SFTP。
• 在Connection标签页，填写远程服务器的IP地址、端口（默认22）、用户名，选择认证方式（密码或密钥）。
• 点击Test SFTP connection验证连接，成功后进入Mappings标签页：
  • Local path：选择本地项目目录（如~/projects/my_project）；
  • Deployment path on server：填写远程项目目录相对于服务器根目录的路径（如/var/www/html/my_project）。
• （可选）进入Excluded Paths标签页，排除无需同步的文件（如node_modules、.idea）。

3. 配置Web服务器（可选：本地访问远程项目）

若需通过本地浏览器访问远程服务器的项目，可配置PHP内置Web服务器或Nginx/Apache：

• PHP内置服务器（快速测试）：
  在远程服务器的项目目录下执行：

  cd /var/www/html/my_project
  php -S localhost:8000
  

  然后在PHPStorm的Run > Edit Configurations中添加PHP Built-in Web Server，设置Document root为远程项目目录，Port为8000，即可通过http://localhost:8000访问。
• Nginx/Apache（生产环境）：
  安装Nginx（sudo apt install nginx），配置server块指向远程项目目录（如root /var/www/html/my_project; ），重启Nginx（sudo systemctl restart nginx）。

三、远程调试配置（可选：解决代码问题）

若需远程调试（如断点调试），需配置Xdebug：

1. 远程服务器安装Xdebug
   通过PECL安装Xdebug：

   sudo pecl install xdebug
   

   在/etc/php/8.1/cli/php.ini（根据PHP版本调整）中添加以下配置：

   [xdebug]
   zend_extension=xdebug.so
   xdebug.remote_enable=1
   xdebug.remote_handler=dbgp
   xdebug.remote_host=<
       你的本地IP地址>
         # 替换为运行PHPStorm的电脑IP
   xdebug.remote_port=9003               # 避免与内置服务器端口冲突
   xdebug.idekey=PHPSTORM
   xdebug.remote_autostart=1             # 自动启动调试
   

   重启PHP服务：sudo systemctl restart php8.1-fpm（或apache2/nginx）。

2. PHPStorm配置Xdebug

   • 进入File > Settings > Languages & Frameworks > PHP > Debug，确保Debug port与xdebug.remote_port一致（如9003）。
   • 点击DBGp Proxy标签页，设置IDE key为PHPSTORM，Host为< 你的本地IP> ，Port为9003。
   • 在Run > Edit Configurations中添加PHP Remote Debug，选择之前配置的Server（如my_project），保存。

3. 开始调试
   在PHPStorm中打开项目，点击顶部工具栏的Start Listening for PHP Debug Connections（虫子图标），然后在代码中设置断点，通过浏览器访问远程项目（如http://localhost:8000），触发断点即可调试。

四、常用操作：代码同步与运行

• 手动同步：右键项目→Deployment→Upload to [服务器名称]（上传本地更改）；或Download from [服务器名称]（下载远程更改）。
• 自动同步：在Deployment配置的Mappings标签页，勾选Automatic Upload (always upload changed files upon save)，保存文件时自动同步。
• 运行项目：通过Run > Edit Configurations添加PHP Built-in Web Server或PHP Web Page，选择远程服务器配置，点击Run即可启动项目。

通过以上步骤，即可在Ubuntu上使用PHPStorm实现远程开发，覆盖代码编辑、同步、调试全流程。配置过程中需注意权限（避免目录无法访问）、端口冲突（如Xdebug端口与内置服务器端口重复）及防火墙设置（允许SSH、HTTP、调试端口通信）。

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