PHP - Manual: 魔术常量

2025-10-31

魔术常量

一些魔术常量会根据使用位置而变化。例如 __LINE__ 的值取决于它在脚本中使用的行。所有这些“魔术”常量都在编译时解析，而常规常量则在运行时解析。这些特殊的常量不区分大小写，如下：

**PHP 的魔术常量**
名字	说明
`__LINE__`	文件中的当前行号。
`__FILE__`	文件的完整路径和文件名。如果用在被包含文件中，则返回被包含的文件名。
`__DIR__`	文件所在的目录。如果用在被包括文件中，则返回被包括的文件所在的目录。它等价于 `dirname(__FILE__)`。除非是根目录，否则目录中名不包括末尾的斜杠。
`__FUNCTION__`	当前函数的名称。匿名函数则为 `{closure}`。
`__CLASS__`	当前类的名称。类名包括其被声明的作用域（例如 `Foo\Bar`）。当用在 trait 方法中时，`__CLASS__` 是调用 trait 方法的类的名字。
`__TRAIT__`	Trait 的名字。Trait 名包括其被声明的作用域（例如 `Foo\Bar`）。
`__METHOD__`	类的方法名。
`__PROPERTY__`	仅在属性挂钩内有效。等同于属性的名称。
`__NAMESPACE__`	当前命名空间的名称。
`ClassName::class`	完整的类名。

参见

发现了问题？

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

＋添加备注

用户贡献的备注 3 notes

down

Rich ¶

1 year ago

<?php

namespace My\App {
  class Api {
    public static fetch() {
      print __FUNCTION__ . "\n"; // outputs fetch
print __METHOD__ . "\n"; // outputs My\App\Api::fetch
}
  }

Api::fetch();
}

namespace {
My\App\Api::fetch();
}
?>

__METHOD__ outputs a fully qualified method name; __FUNCTION__ when used in a method, outputs just the method name.

down

chris at ocproducts dot com ¶

1 year ago

Note that __CLASS__ and __METHOD__ both reference the class the code is written in, not whatever the object class is. E.g. if you have an object of class B inheriting from class A, any usage of __CLASS__ in class A is going to give "A".

down

theking2 at king dot ma ¶

2 years ago

If PHP is run inside a web server request there is an important difference between the __DIR__ constant and $_SERVER['DOCUMENT_ROOT'].

Where __DIR__ of a PHP script contained within a sub-folder will include the complete server path $_SERVER['DOCUMENT_ROOT'] will contain a server path up to the _root_ of the application. This can be helpful when for instance an auto-loader is defined in an include file sitting inside a sub-folder and where the classes are located in another folder at the root of the application.

＋添加备注

官方地址：https://www.php.net/manual/en/language.constants.magic.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言开发编程 Linux 科技 Elasticsearch HTML/CSS/XML 面试数据库网络 JAVA NoSQL C/C++ Golang 操作系统 Git 算法正则表达式 Redis 互联网 MySql 软件运维 JavaScript 国际架构设计 Mac OS Excel TCP/IP Windows Oracle Socket Vim VR MongoDB 运营 Python MemCache 商业硬件电子娱乐设计摄影 nginx WordPress 游戏 HTTP 团建数码电器 Docker

php7.3 使用 PDO_DM 扩展连接 DM8 中文乱码 PhpStorm中PHP注释的规范指南使用PHPWord将docx文件转换为html格式 docker-compose启动nginx与php-fpm laravel查看orm生成的sql PHPStorm ESC 会退出命令行 composer install参数 laravel orm中DB::insert方法导致内存泄漏的问题解决方法 php7 安装fileinfo扩展 adodb手册 ADORecordSet对象常用的php ADODB使用方法集锦 ADOConnection 公用函数利用php soap实现web service adodb连接mysql多个数据库的问题 mysql面试题 PHP注释规范 [PHP] inet_pton/inet_ntop IP地址转换函数 php上周一、本周一、下周一日期 PHP7添加redis扩展

略微加速

PHP官方手册 - 互联网笔记

魔术常量

参见

发现了问题？

用户贡献的备注 3 notes