是，直接访问首页显示欢迎页是最快速的环境验证动作；若显示“Welcome to CodeIgniter!”则PHP+Web服务通路正常，白屏需检查ENVIRONMENT配置、PHP版本及错误显示设置。
直接访问首页是否显示欢迎页？
这是最快速的环境验证动作。CodeIgniter 安装后，只要 Web 服务器能解析 PHP、index.php 可执行、且没有致命错误，就会默认展示 welcome 页面（application/views/welcome_message.php）。
- 如果浏览器打开 http://localhost/your_ci_project/ 或 http://127.0.0.1/your_ci_project/ 显示 “Welcome to CodeIgniter!”，说明基础 PHP+Web 服务通路已跑通
- 若出现白屏，**先检查 PHP 错误是否被屏蔽**：打开 index.php，确认第 56 行附近类似 define('ENVIRONMENT', 'development'); 是否生效；若设为 'production'，错误默认不显示，需临时改成 'development' 再刷新
- 若报错 Parse error: syntax error, unexpected token，大概率是 PHP 版本过低（CI4 要求 PHP 8.0+，CI3 最低 PHP 5.6，但 PHP 7.4 是稳妥选择）
能否正常加载控制器并输出内容？
欢迎页只是静态视图，真正验证框架路由和 MVC 流程是否就位，得手动写一个最小控制器。
- 在 app/Controllers/（CI4）或 application/controllers/（CI3）下新建 Hello.php
- CI4 示例：<?php
namespace App\Controllers;
use CodeIgniter\Controller;
<p>class Hello extends Controller
{
public function index()
{
return 'OK from controller';
}
}
- 访问
<a href="https://www.php.cn/link/d3a5264ea817ce57b3c026e6c15671cd">https://www.php.cn/link/d3a5264ea817ce57b3c026e6c15671cd</a>（CI4 默认移除 index.php），或 <a href="https://www.php.cn/link/66eb81a2a1c2e634f6e2993408674fce">https://www.php.cn/link/66eb81a2a1c2e634f6e2993408674fce</a>（CI3 或未配置重写时）
- 若返回
OK from controller，说明自动加载、路由、控制器实例化均正常
- 常见失败点：CI4 中忘记加
namespace 或类名没首字母大写；CI3 中文件名与类名大小写不一致（Linux 下严格区分）
数据库连接能否成功触发错误提示？
即使项目暂时不用数据库，也建议走一遍连接测试——它能暴露很多隐藏配置问题，比如 MySQL 扩展未启用、host 权限限制、或 socket 路径不对。
- 编辑 app/Config/Database.php（CI4）或 application/config/database.php（CI3），填入本地 MySQL 凭据（如 hostname => 'localhost', username => 'root', password => ''）
- 新建一个测试控制器方法，调用 $db = \Config\Database::connect();（CI4）或 $this->load->database();（CI3）
- 若页面报出明确错误如 mysqli_connect(): (HY000/1045): Access denied for user...，说明 PHP 能找到 MySQL 扩展，只是账号问题；若直接卡住、超时或报 Call to undefined function mysqli_connect()，则是 PHP 缺少 mysqli 扩展（Windows 需检查 php.ini 中 extension=mysqli 是否取消注释）
.env 文件是否被正确读取？
CI4 默认依赖 .env 控制环境行为，但很多人忽略它的加载前提：必须在 Web 服务器层面允许读取该文件，且不能被 URL 直接访问。
- 确保项目根目录存在 .env，内容至少含 CI_ENVIRONMENT = development
- 检查 Apache 的 .htaccess 或 Nginx 配置中是否屏蔽了 .env（例如 Apache 有 RedirectMatch 404 ^\.env$ 是对的，但若写成 Deny from all 且没配好作用域，可能连框架自己都读不到）
- 验证方式：在控制器里加一行 var_dump($_SERVER['CI_ENVIRONMENT'] ?? getenv('CI_ENVIRONMENT'));，应输出 string(11) "development"
- 容易被忽略的一点：某些共享主机禁用 getenv()，此时需在 public/index.php 开头手动加载 DotEnv，或改用 $_SERVER 注入方式
app/Controllers/（CI4）或 application/controllers/（CI3）下新建 Hello.php
- CI4 示例：<?php
namespace App\Controllers;
use CodeIgniter\Controller;
<p>class Hello extends Controller
{
public function index()
{
return 'OK from controller';
}
} - 访问
<a href="https://www.php.cn/link/d3a5264ea817ce57b3c026e6c15671cd">https://www.php.cn/link/d3a5264ea817ce57b3c026e6c15671cd</a>（CI4 默认移除index.php），或<a href="https://www.php.cn/link/66eb81a2a1c2e634f6e2993408674fce">https://www.php.cn/link/66eb81a2a1c2e634f6e2993408674fce</a>（CI3 或未配置重写时） - 若返回
OK from controller，说明自动加载、路由、控制器实例化均正常 - 常见失败点：CI4 中忘记加
namespace或类名没首字母大写；CI3 中文件名与类名大小写不一致（Linux 下严格区分）
数据库连接能否成功触发错误提示？
即使项目暂时不用数据库，也建议走一遍连接测试——它能暴露很多隐藏配置问题，比如 MySQL 扩展未启用、host 权限限制、或 socket 路径不对。
- 编辑 app/Config/Database.php（CI4）或 application/config/database.php（CI3），填入本地 MySQL 凭据（如 hostname => 'localhost', username => 'root', password => ''）
- 新建一个测试控制器方法，调用 $db = \Config\Database::connect();（CI4）或 $this->load->database();（CI3）
- 若页面报出明确错误如 mysqli_connect(): (HY000/1045): Access denied for user...，说明 PHP 能找到 MySQL 扩展，只是账号问题；若直接卡住、超时或报 Call to undefined function mysqli_connect()，则是 PHP 缺少 mysqli 扩展（Windows 需检查 php.ini 中 extension=mysqli 是否取消注释）
.env 文件是否被正确读取？
CI4 默认依赖 .env 控制环境行为，但很多人忽略它的加载前提：必须在 Web 服务器层面允许读取该文件，且不能被 URL 直接访问。
- 确保项目根目录存在 .env，内容至少含 CI_ENVIRONMENT = development
- 检查 Apache 的 .htaccess 或 Nginx 配置中是否屏蔽了 .env（例如 Apache 有 RedirectMatch 404 ^\.env$ 是对的，但若写成 Deny from all 且没配好作用域，可能连框架自己都读不到）
- 验证方式：在控制器里加一行 var_dump($_SERVER['CI_ENVIRONMENT'] ?? getenv('CI_ENVIRONMENT'));，应输出 string(11) "development"
- 容易被忽略的一点：某些共享主机禁用 getenv()，此时需在 public/index.php 开头手动加载 DotEnv，或改用 $_SERVER 注入方式
.env 控制环境行为，但很多人忽略它的加载前提：必须在 Web 服务器层面允许读取该文件，且不能被 URL 直接访问。
- 确保项目根目录存在 .env，内容至少含 CI_ENVIRONMENT = development
- 检查 Apache 的 .htaccess 或 Nginx 配置中是否屏蔽了 .env（例如 Apache 有 RedirectMatch 404 ^\.env$ 是对的，但若写成 Deny from all 且没配好作用域，可能连框架自己都读不到）
- 验证方式：在控制器里加一行 var_dump($_SERVER['CI_ENVIRONMENT'] ?? getenv('CI_ENVIRONMENT'));，应输出 string(11) "development"
- 容易被忽略的一点：某些共享主机禁用 getenv()，此时需在 public/index.php 开头手动加载 DotEnv，或改用 $_SERVER 注入方式
环境验证不是一次性的动作，尤其在部署到新服务器时，.env 权限、PHP 扩展可用性、以及 Web 服务器对隐藏文件的处理逻辑，这三个地方最容易反复出问题。
