本文详解 php 中因重复定义内置常量（如 log_debug）导致的“constant already defined”警告，揭示其根源为系统预定义的 syslog 常量，并提供安全、可移植的替代方案。
在您提供的代码中，define('LOG_DEBUG', 'DEBUG') 触发了 PHP Notice：
PHP Notice: Constant LOG_DEBUG already defined in ... on line 3
这是因为 LOG_DEBUG（以及 LOG_ERROR、LOG_INFO 等）并非用户自定义常量，而是 PHP 内置的整型常量，专用于 syslog() 系统日志函数。根据 PHP 官方文档，它们属于 network.constants，值如下：
LOG_DEBUG => 7 // 注意：这就是您输出中出现的 "7" LOG_ERROR => 3 LOG_INFO => 6 LOG_WARNING => 4
当您执行 trace('test debug message') 时，由于 $level=LOG_DEBUG 的默认值实际是整数 7（而非字符串 'DEBUG'），因此输出中出现了 [2022-02-11 22:00:33 7] —— 这正是 PHP 忽略您 define() 而直接使用内置常量的结果。
✅ 正确解决方案：使用命名空间化常量名
为避免与 PHP 内置常量冲突，应采用唯一前缀（如应用名、模块名）：
立即学习“PHP免费学习笔记（深入）”；
<?php
// ✅ 安全命名：避免与 PHP 内置常量同名
define('MYAPP_LOG_DEBUG', 'DEBUG');
define('MYAPP_LOG_ERROR', 'ERROR');
function trace($message, $level = MYAPP_LOG_DEBUG) {
echo '[' . date('Y-m-d H:i:s') . ' ' . $level . '] ' . $message . "\n";
}
trace('test debug message'); // [2022-02-11 22:00:33 DEBUG] test debug message
trace('test error message', MYAPP_LOG_ERROR); // [2022-02-11 22:00:33 ERROR] test error message? 更现代的推荐方式：使用 const 或 enum（PHP 8.1+）
对于类内日志级别，建议用 const 提升可读性与作用域隔离：
class Logger {
const LEVEL_DEBUG = 'DEBUG';
const LEVEL_ERROR = 'ERROR';
public static function trace($message, $level = self::LEVEL_DEBUG) {
echo '[' . date('Y-m-d H:i:s') . ' ' . $level . '] ' . $message . "\n";
}
}
Logger::trace('test debug message'); // [2022-02-11 22:00:33 DEBUG] ...PHP 8.1+ 还支持更严格的枚举类型：
enum LogLevel: string {
case Debug = 'DEBUG';
case Error = 'ERROR';
}
function trace(string $message, LogLevel $level = LogLevel::Debug) {
echo '[' . date('Y-m-d H:i:s') . ' ' . $level->value . '] ' . $message . "\n";
}⚠️ 注意事项总结
- ❌ 不要重定义 PHP 预定义常量（如 LOG_*, E_*, FILTER_* 等），即使 define() 未报错，行为也不可控；
- ✅ 使用带前缀的常量名（如 APP_LOG_DEBUG）是最简单、向后兼容的修复方式；
- ✅ 在新项目中优先采用 class const 或 enum，获得类型安全与 IDE 支持；
- ? 可通过 var_dump(LOG_DEBUG) 验证其真实值（输出 int(7)），确认是否被系统占用。
遵循以上实践，即可彻底消除该 Notice，并确保日志逻辑清晰、可维护、无歧义。
