怎样在ubuntu配phpstorm

下面按最常见场景（Ubuntu 桌面 + PHPStorm 做 PHP 开发）给你一套清晰步骤，从安装到基本配置都覆盖。

一、安装 PHPStorm

方式 1：官方 tar 包（推荐，最稳定）

1. 下载
   官网：https://www.jetbrains.com/phpstorm/download
   选 Linux (.tar.gz)

2. 解压

cd ~/Downloads
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

方式 2：Snap（简单但不推荐做开发）

sudo snap install phpstorm --classic

二、安装 PHP 运行环境

1. 安装 PHP

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

查看版本：

php -v

2. 安装 Web 服务器（可选）

Nginx

sudo apt install nginx

Apache

sudo apt install apache2 libapache2-mod-php

三、PHPStorm 基本配置

1. 设置 PHP 解释器

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

   /usr/bin/php
   

5. 确认 PHP 版本显示正常

2. 配置本地服务器（以 Nginx 为例）

假设项目在：

~/projects/demo

Nginx 配置：

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

内容示例：

server {
    listen 80;
    server_name demo.local;
    root /home/你的用户名/projects/demo;

    index index.php index.html;

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

启用：

sudo ln -s /etc/nginx/sites-available/demo /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

本地 hosts：

sudo nano /etc/hosts

添加：

127.0.0.1 demo.local

浏览器访问：

http://demo.local

3. 配置 Debug（Xdebug，强烈推荐）

sudo apt install php-xdebug

编辑：

php --ini
sudo nano /etc/php/8.x/fpm/conf.d/20-xdebug.ini

内容：

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

重启：

sudo systemctl restart php-fpm

PHPStorm：

• Settings → PHP → Debug
• 确认端口 9003
• 打断点 → 浏览器访问即可调试

四、推荐插件

• PHP Annotations
• Laravel / Symfony 支持
• Docker
• GitToolBox

五、常见问题

❌ PHPStorm 找不到 php
✅ 用 which php 确认路径

❌ 端口被占用
✅ sudo lsof -i:9003

❌ 权限问题
✅ 项目目录不要放 /var/www 之外导致权限混乱

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

• Ubuntu 版本
• 是否用 Docker
• 是否 Laravel / ThinkPHP / 原生 PHP

我可以给你更精确的一套配置。