Ubuntu PhpStorm怎么配置

在 Ubuntu 上配置 PhpStorm，一般包含 安装、JDK、PHP、服务器环境、项目配置 这几步。下面给你一套从零到可用的完整配置流程（适用于 Ubuntu 20.04 / 22.04 / 24.04）。

一、安装 PhpStorm

方法一：官方方式（推荐）

1. 下载 PhpStorm

   https://www.jetbrains.com/phpstorm/download/linux
   

2. 解压

   tar -xzf PhpStorm-*.tar.gz
   sudo mv PhpStorm-* /opt/phpstorm
   

3. 运行

   /opt/phpstorm/bin/phpstorm.sh
   

4. 创建快捷方式

   /opt/phpstorm/bin/phpstorm.sh
   

   启动后 → Tools → Create Desktop Entry

方法二：Snap（最简单）

sudo snap install phpstorm --classic

二、安装 Java（JDK）

PhpStorm 依赖 Java，Ubuntu 22+ 一般自带 OpenJDK。

sudo apt update
sudo apt install openjdk-17-jdk

检查：

java -version

三、安装 PHP（Ubuntu 自带源）

1️⃣ 安装 PHP

sudo apt install php php-cli php-fpm

2️⃣ 常用扩展

sudo apt install php-mysql php-curl php-xml php-mbstring php-zip php-gd

3️⃣ 查看 PHP 路径

which php
# 通常是 /usr/bin/php

四、PhpStorm 中配置 PHP 解释器

1. 打开 PhpStorm
2. File → Settings → PHP
3. 点击 ... 选择 PHP 解释器
4. 选择：

   /usr/bin/php
   

5. 确认 PHP 版本显示正常 ✅

五、配置本地服务器（Apache / Nginx）

方式一：Apache（简单）

sudo apt install apache2
sudo apt install libapache2-mod-php

项目目录：

/var/www/html

浏览器访问：

http://localhost

方式二：Nginx + PHP-FPM（推荐）

sudo apt install nginx php-fpm

编辑配置：

sudo nano /etc/nginx/sites-available/default

确保包含：

location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/var/run/php/php-fpm.sock;
}

重启：

sudo systemctl restart nginx

六、配置 PhpStorm 服务器（Debug / Run）

1. Settings → PHP → Servers
2. 添加服务器：
   • Name：localhost
   • Host：localhost
   • Port：80
   • Debugger：Xdebug

七、配置 Xdebug（调试必备）

1️⃣ 安装 Xdebug

sudo apt install php-xdebug

2️⃣ 查看配置文件

php --ini | grep xdebug

3️⃣ 配置 Xdebug

编辑：

/etc/php/*/mods-available/xdebug.ini

示例：

zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003

重启 PHP-FPM / Apache：

sudo systemctl restart php*-fpm

八、配置 Composer

sudo apt install composer

PhpStorm 自动识别 composer.json

九、推荐插件（PhpStorm）

• PHP Annotations
• Symfony Support
• Laravel Idea（Laravel 必备）
• GitToolBox
• Chinese Language Pack（中文）

十、常见问题

❌ PhpStorm 打不开

java -version

确认 JDK 已安装

❌ PHP 不识别

确认：

which php

❌ 端口被占用

sudo lsof -i :80

如果你愿意，我可以：

• ✅ 帮你 针对 Laravel / ThinkPHP / 原生 PHP 配置
• ✅ 给你 Ubuntu + Docker + PhpStorm
• ✅ 手把手 远程配置截图版

你现在用的是 哪种 PHP 项目？