IntelliJ Ultimate无法识别require函数，PHP变量$names未定义报错

问题场景 #

我在index.php中定义了$names数组，代码如下：

index.php代码：

<?php
$names = [
    'Jeff',
    'Steve',
    'AJ'
];

require 'index.view.php';

index.view.php代码：

<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Document</title>
    <style>
        header {
            background: #e3e3e3;
            padding: 2em;
            text-align: center;
        }
    </style>
</head>
<body>
<ul>
    <?php
    foreach ($names as $name ) {
        echo "<li>$name</li>";
    }
    ?>
</ul>
</body>
</html>

运行时出现以下警告：

警告：在C:\Users\ajmar\Desktop\php-learning\index.view.php第30行中，变量$names未定义
警告：在C:\Users\ajmar\Desktop\php-learning\index.view.php第30行中，foreach()参数必须为array|object类型，传入了null

该问题仅在IntelliJ Ultimate中出现，在Atom中运行完全正常。

问题原因 #

这不是代码逻辑问题，核心原因是IntelliJ的运行入口错误：你大概率直接运行了index.view.php文件，而非作为入口的index.php。直接执行index.view.php时，$names变量从未被定义，自然触发警告；而Atom中是正确以index.php为入口执行，所以运行正常。

解决方案 #

1. 修正运行配置

   • 点击IntelliJ右上角的运行配置下拉菜单，选择Edit Configurations...
   • 在弹出窗口中，确认当前运行配置的File选项指向index.php，而非index.view.php
   • 若没有对应配置，点击+号选择PHP Script，指定index.php为运行文件后保存配置

2. 确保执行入口正确
   右键点击项目中的index.php文件，选择Run 'index.php'，不要直接运行index.view.php

3. 可选：加固文件引入路径
   如果确认运行入口正确仍报错，将require 'index.view.php';修改为绝对路径写法，避免因IntelliJ工作目录设置导致路径解析错误：

   require __DIR__ . '/index.view.php';
   

内容的提问来源于stack exchange，提问作者Choych