直接运行CodeIgniter的PHP脚本会报错，因其依赖index.php引导流程加载核心类与配置；CLI下应使用php index.php（CI3）或php spark（CI4）执行，或手动引入框架环境确保上下文完整。
直接运行 CodeIgniter 的 PHP 脚本会报错？先确认入口方式
CodeIgniter 不是普通 PHP 脚本集合，它依赖框架引导流程（index.php）加载核心类、配置和自动加载机制。直接用 php script.php 执行某个控制器或模型文件，大概率会遇到 Fatal error: Class 'CI_Controller' not found 或 Undefined variable: $this —— 因为没走框架初始化流程。
想在 CLI 下运行控制器逻辑？用 php index.php 命令行模式
CodeIgniter 3 和 4 都原生支持 CLI 运行，但路径和参数格式不同：
- CodeIgniter 3：
php index.php <class> <method> [param1] [param2]，比如php index.php welcome test hello world - CodeIgniter 4：
php spark <command>（自定义命令需继承CodeIgniter\CLI\BaseCommand），或直接调用路由：php spark serve启服务后用 curl，但 CLI 执行业务逻辑推荐写成 command 类 - 确保
index.php顶部的define('ENVIRONMENT', 'development');已设置，否则 CLI 环境可能被误判为 production 导致错误静默 - 控制器方法必须是
public，且不能依赖 HTTP 请求对象（如$this->input）——CLI 下$_POST/$_GET为空，要用$this->input->get_post()或显式传参
需要定时执行或后台跑脚本？别硬塞进控制器，改用独立 CLI 脚本 + 框架加载
有些任务（比如清理日志、同步数据）不适合挂到 Web 请求链路里，也不愿走完整路由。这时可以写一个独立的 .php 文件，手动引入框架环境：
- CodeIgniter 3 示例：
<?php define('STDIN', fopen('php://stdin', 'r')); require dirname(__FILE__) . '/index.php'; // 触发自动加载和初始化 $CI =& get_instance(); $CI->load->model('my_model'); $CI->my_model->do_something(); - CodeIgniter 4 更推荐用
spark命令扩展：新建app/Commands/SyncData.php，实现run()方法，在里面用model()、db()等服务 - 注意 CLI 脚本默认工作目录是执行位置，不是项目根目录 —— 所有相对路径（如日志、缓存）容易出错，建议用
APPPATH/WRITEPATH常量代替硬编码路径
执行时报 Class not found 或 Call to undefined method？检查自动加载和作用域
常见原因不是代码写错，而是框架上下文缺失：
立即学习“PHP免费学习笔记（深入）”；
- 没调用
get_instance()（CI3）或没通过服务容器获取实例（CI4），导致$this不可用或方法不可见 - 模型/库没在控制器里
load，或 CI4 中没在构造函数里注入（public function __construct(MyModel $model)） - CI4 的命名空间问题：CLI 命令类必须在
AppCommands命名空间下，且类名首字母大写匹配文件名（SyncData.php→SyncData类） - CI3 的
uri类在 CLI 下不可用，别调$this->uri->segment()，改用$this->input->get_args()
真正卡住的地方往往不是语法，而是“以为自己在框架里，其实只是在裸 PHP 环境中”。每次执行前，先问一句：这个对象是谁给的？它在这个上下文里存在吗？
