常量应定义在application/config/constants.php中;框架级常量需启动前定义,应用级常量在此文件用define()安全可靠,避免污染index.php或混用$config,数据库动态加载需绕过CI未初始化陷阱。

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