常量应定义在application/config/constants.php中;框架级常量需启动前定义,应用级常量在此文件用define()安全可靠,避免污染index.php或混用$config,数据库动态加载需绕过CI未初始化陷阱。
常量该定义在哪儿?别碰
,也别硬塞进
CodeIgniter 的常量分两类:框架级(如
)和应用级(如
)。前者必须由框架启动前定义,后者你完全有自由选择位置——但唯一安全、可升级、可维护的地方只有
。
很多人想“绕开它”,比如建个
然后手动
,结果遇到
这类报错——因为 CI 的配置加载器只认
数组,不认
;而
又不能在配置文件里用(除非你改加载逻辑)。
是框架明确预留的、专门执行
的地方,CI 启动早期就
它,时机正确、无副作用
担心升级覆盖?放心——这个文件属于
目录,根本不在
里,每次升级 CI 只动
和
,你的
完全不动
别往
里塞
:虽然能用,但会污染入口、难以统一管理,且一旦需要根据环境动态设值(比如开发/生产不同版本号),就立刻卡死
和
到底用哪个?看用途,别混用
这是新手最常混淆的一点:
是 PHP 全局常量,编译期生效、不可修改、无命名空间;
是 CI 配置类管理的运行时变量,可被覆盖、可按需加载、支持环境隔离。
用
:适合真正「不变」的标识类值,比如
、
、
(路径字符串),它们在全项目任何地方(包括库、模型、视图甚至钩子)都能直接用,无需加载任何类
用
:适合可能随环境变化、或需被配置类统一管理的值,比如
、
、
。它们必须通过
获取,且建议放在
这类自定义配置文件中,并在
里声明自动加载
严禁在同一个项目里对同一语义值既
又写进
,否则后期排查时你会在日志、调试器、IDE 提示里看到两个同名但值不同的东西,根本分不清谁生效了
从数据库动态加载常量?可以,但得绕过
未定义陷阱
有人想把常量存在数据库里(比如后台可编辑的站点标题、版权年份),然后在配置阶段读出来
。想法合理,但直接在
里写
会报
——因为此时 CI 的核心对象(包括
)根本还没初始化。
可行做法:把数据库读取逻辑封装进一个独立函数,放在
里,用
拿到引用,再在控制器或模型里按需调用;不要试图在配置阶段做这事
更稳妥替代:用 CI4 的
文件(CI3 可用
手动引入),把可变常量转成环境变量,在
中用
赋值,既安全又符合 12-Factor 原则
性能提醒:每次请求都查数据库设常量 = 每次请求多一次 DB 连接+查询,QPS 上千时就是瓶颈。真要动态,缓存到 APCu 或 Redis,查一次存内存,过期再刷
CI4 时间默认是 Chicago?改它别动常量,改
或
CI4 默认时区设为
是历史遗留,不是靠定义某个常量控制的。想全局统一时间,别去翻
找不存在的
,那只会白忙活。
推荐方案:在
顶部(
之前)加一行
,简单、明确、不影响任何其他逻辑
备选方案:改服务器
中的
,一劳永逸,但需要运维权限,本地开发不方便
注意:不要在控制器里用
——它只影响当前请求生命周期,且如果多个控制器先后调用,可能互相覆盖;必须在框架加载前固化
常量这事看着小,但一旦设错位置或混用类型,后面 debug 花的时间远超写的时候省下的那几秒。尤其注意
是唯一允许
的地方,其他所有“看起来像配置”的文件,其实都是给
数组服务的。
system/index.phpENVIRONMENTAPP_VERSIONapplication/config/constants.phpmy_constants.phpincludeYour application/config/my_constants.php file does not appear to contain a valid configuration array$configdefine()define()application/config/constants.phpdefine()requireapplication/system/system/index.phpconstants.phpindex.phpdefine('APP_VERSION', '1.0.0')define()$config[]define()$config['key']define()APP_NAMESITE_CREATORUPLOAD_PATH$config['key']api_timeoutmail_driverapp_debug$this->config->item('key')application/config/app.phpautoload.phpdefine()$config$cidefine()constants.php$ci->load->database()Undefined variable: ci$ciapplication/helpers/constant_helper.phpget_instance().envvlucas/phpdotenvconstants.php$_ENV['APP_COPYRIGHT'] ?? '2026'php.inidate_default_timezone_set()America/Chicagoconstants.phpTIMEZONEpublic/index.phprequire __DIR__.'/../vendor/autoload.php';date_default_timezone_set('Asia/Shanghai');php.inidate.timezone = Asia/Shanghaidate_default_timezone_set()constants.phpdefine()$config