PhpStorm Ubuntu怎么配环境

在 Ubuntu 上配置 PhpStorm + PHP 开发环境，可以按下面步骤来，基本是「系统环境 → PHP → PhpStorm → 调试（Xdebug）」这样一个流程。

一、安装 PHP（Ubuntu）

1️⃣ 更新软件源

sudo apt update
sudo apt upgrade -y

2️⃣ 安装 PHP（以 PHP 8.2 为例）

sudo apt install php8.2 php8.2-cli php8.2-fpm -y

常用扩展（按需）：

sudo apt install php8.2-mysql php8.2-curl php8.2-mbstring php8.2-xml php8.2-zip -y

查看版本：

php -v

二、安装 Web 服务器（可选）

✅ 方式一：Apache（简单）

sudo apt install apache2
sudo apt install libapache2-mod-php8.2

访问：

http://localhost

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

sudo apt install nginx

配置 Nginx 支持 PHP：

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

关键配置：

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

重启：

sudo systemctl restart nginx
sudo systemctl restart php8.2-fpm

三、安装 PhpStorm

✅ 方式一：Snap（最简单，推荐）

sudo snap install phpstorm --classic

✅ 方式二：官网下载（手动）

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

tar -xzf PhpStorm-*.tar.gz

3. 运行：

cd PhpStorm-*/bin
./phpstorm.sh

四、PhpStorm 配置 PHP 解释器

1. 打开 PhpStorm
2. File → Settings → PHP
3. 点击 CLI Interpreter → +
4. 选择：

   /usr/bin/php
   

   或

   /usr/bin/php8.2
   

✅ 成功后能看到 PHP 版本

五、配置 Xdebug（调试必备）

1️⃣ 安装 Xdebug

sudo apt install php8.2-xdebug

确认：

php -i | grep xdebug

2️⃣ 配置 Xdebug

编辑：

sudo nano /etc/php/8.2/cli/conf.d/20-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

重启服务：

sudo systemctl restart php8.2-fpm

3️⃣ PhpStorm 启用调试

1. Settings → PHP → Debug
2. Debug port：9003
3. 勾选：
   • ✅ Can accept external connections
4. 打开电话图标（Start Listening for PHP Debug Connections）

浏览器访问即可断点调试 ✅

六、配置项目运行（本地服务器）

方式一：内置服务器（最快）

php -S localhost:8000

PhpStorm 中：

• Run → Edit Configurations
• PHP Built-in Web Server

方式二：Apache / Nginx

• 项目目录放到 /var/www/html
• 配置 PhpStorm 的 Deployment（可选）

七、常见问题

❓ PhpStorm 找不到 PHP

which php

手动指定路径即可

❓ 端口冲突

• Apache：80
• Nginx：80
• Xdebug：9003

八、推荐组合（新手友好）

✅ Ubuntu + PHP 8.2 + Nginx + PhpStorm + Xdebug

如果你愿意，我可以：

• ✅ 帮你 一步步截图式配置
• ✅ 针对 Laravel / ThinkPHP / 原生 PHP 单独说明
• ✅ 配 Docker + PhpStorm

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