ubuntu phpstorm怎么配置php

在 Ubuntu 上用 PhpStorm 配置 PHP 一般分为三步：安装 PHP → 安装并配置 PHP 解释器 → 在 PhpStorm 中指定 PHP。下面按最常见情况讲（命令行 PHP + 本地开发）。

一、在 Ubuntu 上安装 PHP

1. 更新软件源

sudo apt update

2. 安装 PHP（以 PHP 8.1 为例）

sudo apt install php php-cli php-common

如果你需要 Web 开发，还可以装：

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

3. 确认 PHP 安装成功

php -v

输出类似：

PHP 8.1.x (cli)

记下 PHP 可执行文件路径（一般如下）：

which php
# 通常是 /usr/bin/php

二、在 PhpStorm 中配置 PHP 解释器

方法一：新建/打开项目时配置

1. 打开 PhpStorm
2. 打开你的 PHP 项目
3. 菜单栏选择：

   File → Settings（或 Preferences）
   

4. 左侧选择：

   PHP
   

5. 在 CLI Interpreter 右侧点击 ...
6. 点击 + → From Docker / Local
7. 选择 Local
8. PHP executable 填写：

   /usr/bin/php
   

9. 点击 OK → Apply

方法二：手动指定 PHP 路径

如果 PhpStorm 没自动识别：

1. Settings → PHP
2. CLI Interpreter → ...
3. 点 + → Local
4. PHP executable:

   /usr/bin/php
   

5. 下方会显示 PHP 版本，说明配置成功

三、配置 PHP 运行/调试（可选）

1. 运行 PHP 文件

右键 PHP 文件 → Run 'xxx.php'

2. 配置 Xdebug（调试用）

安装 Xdebug：

sudo apt install php-xdebug

查看配置文件位置：

php --ini

编辑：

sudo nano /etc/php/8.1/cli/conf.d/20-xdebug.ini

示例：

zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes

PhpStorm 中：

Settings → PHP → Debug

端口默认 9003

四、常见问题

1. PhpStorm 检测不到 PHP

• 确认 php -v 能运行
• 确认路径是 /usr/bin/php
• 用绝对路径配置

2. 用的是 PHP-FPM 而不是 CLI

PhpStorm 运行脚本用的是 CLI PHP，不是 FPM
Web 服务才用 FPM

3. 多版本 PHP

sudo update-alternatives --config php

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

• 你是 本地运行 还是 Docker
• PHP 版本
• 是否要 Web + 浏览器调试

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