怎么配置Ubuntu的PhpStorm

在 Ubuntu 上配置 PhpStorm 一般包括 安装、PHP 运行环境、调试（Xdebug）、服务器（如 Apache/Nginx） 以及 与 PhpStorm 的联动配置。下面我按 完整流程 + 常用场景 给你讲一遍。

一、安装 PhpStorm（Ubuntu）

✅ 方法一：官网下载（推荐）

1. 打开官网
   https://www.jetbrains.com/phpstorm/download/

2. 下载 Linux 版本（.tar.gz）

3. 解压并运行：

tar -xzf PhpStorm-*.tar.gz
cd PhpStorm-*/bin
./phpstorm.sh

首次启动会提示是否导入配置，选择 Do not import settings

✅ 方法二：Snap 安装（最简单）

sudo snap install phpstorm --classic

二、安装 PHP（Ubuntu）

1️⃣ 安装 PHP 及常用扩展

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

查看版本：

php -v

三、配置 PHP 解释器（PhpStorm）

1. 打开 PhpStorm
2. File → Settings（或 Ctrl + Alt + S）
3. 进入：

   PHP
   

4. 点击 CLI Interpreter 右侧的 ...
5. 点击 + → From Docker, Vagrant... 或 Local
6. 选择 PHP 路径（通常是）：

   /usr/bin/php
   

✅ 成功后可以看到 PHP 版本信息

四、配置 Xdebug（调试必备）

1️⃣ 安装 Xdebug

sudo apt install php-xdebug

查看是否安装成功：

php -m | grep xdebug

2️⃣ 配置 Xdebug（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
xdebug.start_with_request=yes

⚠️ 如果 PHP 8.0+，默认端口是 9003

重启 PHP：

sudo systemctl restart php8.x-fpm

3️⃣ PhpStorm 中启用 Xdebug

1. Settings → PHP → Debug
2. Debug port 设置为：

   9003
   

3. 勾选：
   • ✅ Can accept external connections

五、配置 Web 服务器（可选）

✅ Apache

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

项目目录：

/var/www/html

✅ Nginx + PHP-FPM

sudo apt install nginx

Nginx 配置示例：

server {
    listen 80;
    server_name localhost;
    root /var/www/html;

    index index.php;

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

六、PhpStorm 配置项目

1. File → Open
2. 选择你的 PHP 项目目录
3. 设置 Deployment（可选）
   Settings → Deployment
   • Type: Local or SFTP
4. 设置 Run/Debug Configurations
   • 选择 PHP Web Page
   • 配置浏览器 & URL

七、测试调试（断点是否有效）

1. 在代码中打一个断点
2. 点击 电话图标（Start Listening）
3. 浏览器访问页面
4. PhpStorm 进入调试状态 ✅

八、常见问题

❓ 断点不生效

• Xdebug 没有加载
• port 不是 9003
• PhpStorm 没开启监听

❓ PHP 找不到

• 确认 /usr/bin/php
• 或 which php

九、推荐插件（PhpStorm）

• PHP Annotations
• Symfony Support
• Laravel Idea（Laravel 项目）
• Docker

如果你愿意，我可以： ✅ 帮你 针对 Laravel / ThinkPHP / 原生 PHP 配置 ✅ 给你 Docker + PhpStorm 的完整方案 ✅ 远程帮你排查 Xdebug 问题

你现在用的是 Ubuntu 多少版本 + PHP 多少版本？