验证核心功能需分三步:一是访问欢迎页确认PHP与框架加载正常;二是新建Hello控制器并访问对应路由验证MVC流程通畅;三是配置数据库连接并在控制器中测试,确保MySQL扩展启用且凭据正确。

配置完成后,最直接的方式是分三步验证核心功能是否就绪:欢迎页、路由与控制器、数据库连接。不用等全部写完业务逻辑,这几个关键点一测,就能快速定位环境或配置问题。
看欢迎页是否正常显示
这是第一道门槛,也是最快捷的通路检查:
- 访问 http://localhost/your_project/(CI4)或 http://localhost/your_project/index.php(CI3 或未配置重写时)
- 如果看到 “Welcome to CodeIgniter!”,说明 PHP 解析、Web 服务、基础框架加载都正常
- 若白屏,先确认 index.php 中 ENVIRONMENT 是否设为 'development';再检查 PHP 版本是否达标(CI4 需 PHP 8.0+,CI3 建议 PHP 7.4+)
- 报语法错误(如 unexpected token),基本可锁定为 PHP 版本过低或短标签未启用
手动调用控制器验证 MVC 流程
欢迎页只是静态视图,真正检验框架是否跑起来,得走一遍请求→路由→控制器→响应流程:
- 在 app/Controllers/(CI4)或 application/controllers/(CI3)下新建 Hello.php
- CI4 示例内容:class Hello extends Controller { public function index() { return 'OK from controller'; } }(注意命名空间和首字母大写)
- CI3 示例:class Hello extends CI_Controller { public function index() { echo 'OK from controller'; } }(文件名与类名严格一致,Linux 下区分大小写)
- 访问 /hello(CI4,已去 index.php)或 /index.php/hello(CI3),返回纯文本 OK 即表示自动加载、路由解析、控制器实例化全部通畅
测试数据库连接是否生效
即使当前不用数据库,也建议立即跑一次连接测试——它能暴露很多隐藏配置问题:
- 编辑 app/Config/Database.php(CI4)或 application/config/database.php(CI3),填入本地 MySQL 凭据(如 hostname='localhost'、username='root'、password='')
- 在刚建的 Hello 控制器中加测试代码:$this->load->database(); echo $this->db->conn_id ? 'OK' : 'FAIL';
- 若提示 FAIL,常见原因包括:MySQL 扩展未启用(检查 phpinfo() 中 mysqli 或 pdo_mysql)、host 权限限制(如 localhost 不通,试 127.0.0.1)、socket 路径错误(尤其 macOS MAMP 环境)
- 开启 db_debug => TRUE 可获得具体错误信息,比静默失败更有诊断价值
不复杂但容易忽略,这三步做完,框架主干就稳了。后续表单验证、单元测试、路由扩展等,都是在此基础上叠加的。


















