Debian下phpstorm如何创建项目

Debian 下 PhpStorm 创建项目

一 准备环境

在开始之前，咱们得先把舞台搭好。对于 Debian 12 这样的系统，准备工作其实相当清晰。

安装 PHP 与常用工具： 打开终端，执行下面这条命令，就能把 PHP 解释器、常用扩展以及一些实用工具一并搞定：
sudo apt update && sudo apt install php php-cli php-curl php-mbstring php-xml unzip
安装完成后，别忘了用 php -v 验证一下版本，确保它已经乖乖就位。

安装 Composer： 现代 PHP 开发离不开依赖管理，所以 Composer 也得安排上。在 Debian 上安装它很简单：
sudo apt install composer

启动 PhpStorm： 如果你是通过解压包安装的，找到安装目录下的启动脚本（比如 /opt/phpstorm/bin/phpstorm.sh）执行即可。当然，更省心的方式是从系统应用菜单里直接点击启动。

二 创建 PHP 项目的两种方式

环境就绪，打开 PhpStorm，接下来就是创建项目。这里通常有两种场景，对应两种不同的入口。

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

如果你想白手起家，从头搭建一个项目，这是最直接的路径。

在 PhpStorm 的欢迎界面，点击 New Project。在左侧的项目类型列表中，选择 PHP Empty Project。
然后，为你的项目起个名字，并指定一个存放位置。关键的一步在右侧：找到 Interpreter 选项，在这里选择或添加你系统上的 PHP CLI 解释器。
最后，点击 Create，一个干净的项目空间就创建好了。

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

如果你手头已经有一个现成的项目文件夹，需要导入 PhpStorm 进行开发或维护，操作更简单。

在欢迎界面直接选择 Open，然后指向你项目的根目录。或者，也可以在启动后通过菜单 File > Open 来操作。
项目打开后，有一件事需要确认：进入 File > Settings > Languages & Frameworks > PHP，检查一下 CLI Interpreter 是否已正确识别或配置。如果没有，就在这里添加它。

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

项目创建好了，总得写点代码跑起来看看。咱们从创建一个简单的入口文件开始。

新建入口文件： 在左侧的项目视图里，右键点击项目根目录，选择 New > PHP File，命名为 index.php。然后，写入一段经典的示例代码：

运行与调试： 代码写好了，怎么执行？
运行： 在编辑器里右键点击，选择 Run ‘index.php’，或者直接点击工具栏上那个绿色的三角按钮。
调试： 这才是体现 IDE 强大功能的地方。在你关心的代码行号左侧点击一下，设置一个断点。然后右键选择 Debug ‘index.php’ 启动调试。当然，这一切的前提是，你的 CLI Interpreter 和运行/调试配置都已经正确设置好了。

四 常见问题与快速排查

过程中难免会遇到一些小麻烦，这里有几个常见问题的排查思路，能帮你快速回到正轨。

解释器未配置或找不到 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 [包名] 来安装具体的依赖了。