跳转到主内容
新派编程网 - 新潮编程理念,全新技术课堂!

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

常量应定义在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
数组服务的。

相关文章