CodeIgniter新手入门配置常量定义_CodeIgniter常量设置指南【汇总】

1次阅读

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

CodeIgniter新手入门配置常量定义_CodeIgniter常量设置指南【汇总】

常量该定义在哪儿?别碰 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_NAMESITE_CREATORUPLOAD_PATH(路径字符串),它们在全项目任何地方(包括库、模型、视图甚至钩子)都能直接用,无需加载任何类
  • $config['key']:适合可能随环境变化、或需被配置类统一管理的值,比如 api_timeoutmail_driverapp_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.inidate_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 数组服务的。

text=ZqhQzanResources