在PhpStorm中新建PHP项目需分场景操作:欢迎界面点“New Project”并选PHP类型;已开项目时通过“File→New Project…”;已有代码则用“Open”导入并启用PHP支持;最后需正确标记源码、测试及排除目录。

如果您希望在PhpStorm中创建一个新的PHP项目,但找不到新建项目的入口或不清楚如何正确配置项目目录,则可能是由于界面布局不熟悉或项目类型选择有误。以下是完成此操作的具体步骤:
一、通过欢迎界面新建PHP项目
PhpStorm启动后若未打开任何项目,将显示欢迎界面,此处提供最直接的新建项目入口,适用于首次配置或独立项目开发场景。
1、在欢迎界面中点击“New Project”按钮。
2、在弹出的窗口左侧选择“PHP”作为项目类型。
立即学习“PHP免费学习笔记(深入)”;
3、在右侧的“Location”字段中,手动输入或点击文件夹图标选择项目将要存放的本地路径。
4、确认下方的“PHP language level”与目标运行环境匹配,例如选择“PHP 8.1”。
5、点击“Create”按钮完成初始化。
二、通过已打开项目界面新建PHP项目
当PhpStorm已处于打开某个项目的状态时,需通过菜单栏触发新建流程,该方式可避免关闭当前项目,适合多项目并行管理。
1、点击顶部菜单栏的“File”选项。
2、在下拉列表中选择“New Project…”(注意末尾有省略号)。
3、在新建项目窗口中,确保左侧选中“PHP”而非“Empty Project”或其他模板。
4、在“Project location”文本框中指定新项目的根目录路径,路径不可与现有项目目录重叠。
5、勾选“Add framework support”后点击右侧加号,可即时添加Composer或Laravel等支持。
三、基于现有文件夹创建PHP项目
当已有PHP代码存放在某文件夹中,需将其识别为PhpStorm项目时,应使用“Open”方式导入而非“New”,否则会生成嵌套结构或配置冲突。
1、在欢迎界面点击“Open”,或在已打开项目状态下执行“File → Open…”。
2、浏览并选中包含index.php或composer.json的文件夹,点击“OK”。
3、PhpStorm将自动检测PHP文件并提示是否启用PHP支持,点击“Enable”。
4、进入“File → Settings → Languages & Frameworks → PHP”,验证“Interpreter”已指向有效的PHP可执行文件路径。
5、在“Directories”选项卡中,确认“Sources”标记已应用在包含PHP源码的根目录或子目录上。
四、配置项目根目录与源码目录映射
PhpStorm依赖明确的目录角色划分来提供代码补全、引用跳转等功能,错误的目录标记会导致功能失效。
1、右键点击项目视图中的目标文件夹,选择“Mark Directory as” → “Sources Root”。
2、若存在测试代码,对tests/目录执行相同操作并选择“Test Sources Root”。
3、对于vendor/目录,右键选择“Mark Directory as” → “Excluded”以排除索引干扰。
4、进入“Settings → Directories”,检查各目录标记状态是否与实际用途一致。
5、修改后点击“OK”保存设置,PhpStorm将自动重新索引相关文件。











