ubuntu怎样配置phpstorm

在 Ubuntu 上配置 PhpStorm 一般包括：安装 PhpStorm → 安装 PHP → 配置 PHP 解释器 →（可选）配置 Web 服务器 / Composer / Xdebug。下面按步骤说明。

一、安装 PhpStorm

方式 1：通过 JetBrains Toolbox（推荐）

# 下载 Toolbox
wget https://download-cdn.jetbrains.com/toolbox/jetbrains-toolbox-2.1.1.17175.tar.gz
tar -xzf jetbrains-toolbox-*.tar.gz
cd jetbrains-toolbox-*/
./jetbrains-toolbox

安装后通过 Toolbox 安装 PhpStorm。

方式 2：直接安装 PhpStorm

sudo snap install phpstorm --classic

或去官网下载 .tar.gz：

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

二、安装 PHP

sudo apt update
sudo apt install php php-cli php-common

查看版本：

php -v

如需常见扩展：

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

三、在 PhpStorm 中配置 PHP 解释器

1. 打开 PhpStorm
2. File → Settings（或 Ctrl + Alt + S）
3. PHP
4. 点击 CLI Interpreter 右侧的 ...
5. 点击 + → From Docker / WSL / Local
6. 选择 Local
7. PHP executable 填：

   /usr/bin/php
   

8. 点击 Apply / OK

✅ 此时 PhpStorm 已能运行 PHP

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

1️⃣ 使用内置 PHP Server（最简单）

php -S localhost:8000

或在 PhpStorm 中：

• Run → Edit Configurations
• 添加 PHP Built-in Web Server
• Host: localhost
• Port: 8000

2️⃣ 使用 Apache（推荐用于真实环境）

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

项目目录：

/var/www/html

在 PhpStorm 中配置：

• Settings → PHP → Server
• 添加 Server，Host: localhost

3️⃣ 使用 Nginx + PHP-FPM

sudo apt install nginx php-fpm

配置 /etc/nginx/sites-available/default 中：

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

五、配置 Composer

sudo apt install composer
composer -v

PhpStorm：

• Settings → PHP → Composer
• 勾选 composer.phar 或系统 composer
• Path：/usr/bin/composer

六、配置 Xdebug（调试用，可选）

安装 Xdebug

sudo apt install php-xdebug

修改 php.ini

php --ini
sudo nano /etc/php/8.2/cli/php.ini

添加：

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

重启：

sudo systemctl restart apache2
# 或 php-fpm

PhpStorm 配置

• Settings → PHP → Debug
• Debug port: 9003
• 打开 Run → Start Listening for PHP Debug Connections

七、常见问题

❓ PhpStorm 无法找到 PHP

• 确认：which php
• 路径一般是 /usr/bin/php

❓ 权限问题

sudo chown -R $USER:$USER project-folder

如果你愿意，可以告诉我：

• 你用的是 Ubuntu 几版本
• 是否用 Docker / WSL / Apache / Nginx
• 是 学习 PHP 还是 Laravel 项目

我可以给你一套最合适的配置方案。