Debian 下 PhpStorm 创建项目

一 准备环境

在开始使用 PhpStorm 进行 PHP 开发之前，确保您的 Debian 12 系统已搭建好必要的运行环境。以下步骤将指导您完成基础配置。

安装 PHP 与常用工具： 首先，通过终端安装 PHP 核心组件及开发中常用的扩展。执行以下命令可一次性完成更新与安装：
sudo apt update && sudo apt install php php-cli php-curl php-mbstring php-xml unzip
安装完成后，建议使用 php -v 命令检查 PHP 版本，确认安装成功。

安装 Composer： 作为 PHP 生态的标准依赖管理工具，Composer 是现代化项目开发的必备。在 Debian 系统中，可通过官方仓库快速安装：
sudo apt install composer

启动 PhpStorm： 若您通过压缩包安装，可进入安装目录（例如 /opt/phpstorm/bin/）并执行启动脚本 phpstorm.sh。更便捷的方式是直接从系统应用程序菜单中点击 PhpStorm 图标启动。

二 创建 PHP 项目的两种方式

环境配置完成后，启动 PhpStorm。您可以根据项目实际情况，选择以下两种主流方式之一来创建或导入项目。

方式 A 新建空项目（适合从零开始）

此方法适用于全新项目，您将从一个纯净的目录开始构建代码。

在 PhpStorm 的欢迎界面，点击 New Project。在左侧项目类型列表中，选择 PHP Empty Project。
接下来，为项目命名并选择本地存储路径。请注意右侧的 Interpreter 设置，务必在此处选择或添加您系统中已安装的 PHP CLI 解释器。
最后，点击 Create 按钮，即可生成一个结构清晰、待开发的 PHP 项目空间。

方式 B 从现有代码导入（已有项目目录时）

如果您已有本地项目文件夹，需要借助 PhpStorm 进行后续开发和维护，导入是最高效的方式。

在欢迎界面直接选择 Open，然后浏览并选中项目的根目录。您也可以在启动后通过顶部菜单 File > Open 完成此操作。
项目加载后，建议立即检查 PHP 解释器配置：进入 File > Settings > Languages & Frameworks > PHP，确认 CLI Interpreter 已正确关联。若未识别，请在此页面手动添加。

三 创建入口文件与运行调试

项目初始化后，通常需要创建入口文件并验证开发环境是否工作正常。

新建入口文件： 在左侧项目视图中，右键单击项目根目录，选择 New > PHP File，将其命名为 index.php。随后，您可以输入一段简单的测试代码：

运行与调试： 代码编写完成后，可通过以下方式验证：
运行： 在编辑器内右键单击，选择 Run ‘index.php’，或直接点击工具栏的绿色运行按钮。
调试： 要使用断点调试功能，请在目标代码行的左侧单击设置断点。随后右键选择 Debug ‘index.php’ 启动调试会话。请注意，成功调试的前提是已在设置中正确配置 PHP 解释器及对应的运行/调试配置。

四 常见问题与快速排查

在 Debian 系统上使用 PhpStorm 开发 PHP 项目时，可能会遇到一些典型问题。以下是快速排查与解决方案。

解释器未配置或找不到 PHP： 若 PhpStorm 提示无可用 PHP 解释器，请导航至 File > Settings > Languages & Frameworks > PHP > CLI Interpreter，点击右侧 Add 按钮，手动指定系统 PHP 可执行文件的路径（通常为 /usr/bin/php）。

运行按钮不可用： 如果运行按钮显示为灰色，请首先确认当前编辑的文件为 PHP 类型，且项目已关联 PHP 解释器。若问题依旧，可通过菜单 Run > Edit Configurations 检查或重新创建运行配置。

依赖管理： 项目若需引入外部库，应使用 Composer 进行管理。在终端中进入项目根目录，执行 composer init 初始化并生成 composer.json 文件，之后即可使用 composer require [包名] 命令安装所需依赖包。