Ubuntu如何设置PHPStorm

在 Ubuntu 上设置 PhpStorm，通常包含 安装、JDK 环境、中文/语言设置、PHP 解释器、服务器&调试 等几个部分。下面按完整流程给你说明，适合新手和上手使用。

一、安装 PhpStorm（常见方式）

✅ 方法一：通过 Snap（最推荐）

sudo snap install phpstorm --classic

安装完成后，在应用菜单中搜索 PhpStorm 即可启动。

✅ 方法二：从 JetBrains 官网下载（适合指定版本）

1. 下载地址：
   https://www.jetbrains.com/phpstorm/download/linux.html
2. 解压：

tar -xzf phpstorm-*.tar.gz

3. 运行：

cd PhpStorm-*/
cd bin
./phpstorm.sh

二、安装 Java 环境（一般可跳过）

PhpStorm 自带 JDK，但如果你系统没有 Java，也可以安装：

sudo apt update
sudo apt install openjdk-17-jdk

验证：

java -version

三、首次启动配置

1️⃣ 导入设置

• 第一次启动可选择：
  • Do not import settings

2️⃣ 主题选择

• Light / Dark（推荐 Darcula）

3️⃣ 插件

推荐安装的插件：

• ✅ PHP
• ✅ Docker（如果用）
• ✅ Git
• ✅ Chinese (Simplified) Language Pack（中文包）

四、设置 PHP 解释器（非常关键）

1️⃣ 安装 PHP（如果还没装）

sudo apt update
sudo apt install php php-cli php-fpm php-mysql php-xml php-curl

查看 PHP 路径：

which php

一般是：

/usr/bin/php

2️⃣ 在 PhpStorm 中配置 PHP

Settings / Preferences
└── PHP
    ├── PHP language level（选择你的 PHP 版本）
    └── PHP interpreter
        └── 点击 ...
            └── 选择 PHP executable
                （填 /usr/bin/php）

✅ 如果成功，会显示 PHP 版本号。

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

✅ 方法一：使用 PhpStorm 内置服务器（最简单）

Run → Edit Configurations
└── 点击 + 
    └── PHP Built-in Web Server
        Host: localhost
        Port: 8000
        Document root: 项目目录

运行后访问：

http://localhost:8000

✅ 方法二：Apache / Nginx（进阶）

如果你用：

• Apache：/var/www/html
• Nginx：/var/www

需要在 PhpStorm 中设置 Deployment 或直接打开对应目录。

六、配置 Xdebug（调试 PHP）

1️⃣ 安装 Xdebug

sudo apt install php-xdebug

查看是否成功：

php -v

2️⃣ 配置 php.ini

php --ini
sudo nano /etc/php/8.x/cli/php.ini

添加：

[xdebug]
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.client_port=9003

重启 PHP-FPM（如果用）：

sudo systemctl restart php8.x-fpm

3️⃣ PhpStorm 中启用调试

Settings → PHP → Debug
    Debug port: 9003

设置断点 → 点击 电话图标（Listen for Debug Connections） → 浏览器访问。

七、Git 配置（推荐）

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

PhpStorm 会自动识别 Git。

八、常见问题

❓ 中文乱码

• 安装中文语言包插件
• 系统语言设置为 UTF-8

❓ 无法识别 PHP

• 确认 which php
• 指向正确的 PHP 可执行文件

九、推荐配置总结 ✅

如果你愿意，我可以：

• ✅ 给你 一步一步截图式配置
• ✅ 针对 Laravel / ThinkPHP / WordPress
• ✅ 配置 Docker + PhpStorm

你可以直接告诉我：你用 PhpStorm 做什么项目？