PHP魔法常量

PHP魔法常量的概述

PHP魔法常量是预定义的常量，根据其使用的位置动态改变值。这些常量不区分大小写，通常以双下划线开头和结尾。它们提供脚本运行时的上下文信息，如当前行号、文件路径等。

LINE 常量

LINE 返回当前行号在脚本中的位置。调试或日志记录时非常有用。

echo "当前行号是: " . __LINE__;
// 输出示例: 当前行号是: 3

FILE 常量

FILE 返回当前文件的完整路径和文件名。常用于包含文件或记录日志时获取文件信息。

echo "当前文件路径: " . __FILE__;
// 输出示例: 当前文件路径: /var/www/example.php

DIR 常量

DIR 返回当前文件所在目录的路径。与 dirname(FILE) 等效，但更简洁。

echo "当前目录: " . __DIR__;
// 输出示例: 当前目录: /var/www

FUNCTION 常量

FUNCTION 返回当前函数的名称。在调试或跟踪函数调用时非常有用。

function testFunction() {
    echo "当前函数: " . __FUNCTION__;
}
testFunction();
// 输出示例: 当前函数: testFunction

CLASS 常量

CLASS 返回当前类的名称。在面向对象编程中用于获取类名。

class ExampleClass {
    public function getClassName() {
        return __CLASS__;
    }
}
$obj = new ExampleClass();
echo $obj->getClassName();
// 输出示例: ExampleClass

TRAIT 常量

TRAIT 返回当前 trait 的名称。用于在 trait 中获取自身名称。

trait ExampleTrait {
    public function getTraitName() {
        return __TRAIT__;
    }
}
class MyClass {
    use ExampleTrait;
}
$obj = new MyClass();
echo $obj->getTraitName();
// 输出示例: ExampleTrait

METHOD 常量

METHOD 返回当前方法的名称，包括类名。比 FUNCTION 更详细。

class ExampleClass {
    public function exampleMethod() {
        echo __METHOD__;
    }
}
$obj = new ExampleClass();
$obj->exampleMethod();
// 输出示例: ExampleClass::exampleMethod

NAMESPACE 常量

NAMESPACE 返回当前命名空间的名称。在命名空间代码中非常有用。

namespace MyProject;
echo "当前命名空间: " . __NAMESPACE__;
// 输出示例: 当前命名空间: MyProject

魔法常量的实际应用

魔法常量在日志记录、调试和框架开发中非常实用。以下是综合示例：

namespace MyApp\Controllers;

class UserController {
    public function updateUser() {
        $log = sprintf(
            "[%s] %s::%s (Line: %d)",
            date('Y-m-d H:i:s'),
            __CLASS__,
            __METHOD__,
            __LINE__
        );
        file_put_contents('debug.log', $log . PHP_EOL, FILE_APPEND);
    }
}

$controller = new UserController();
$controller->updateUser();
// 日志内容示例: [2023-05-20 14:30:00] MyApp\Controllers\UserController::updateUser (Line: 8)

魔法常量提供运行时信息，无需手动维护，使代码更灵活和可维护。合理使用可以显著提升开发效率。