Магические константы

PHP включает девять магических констант, значение которых изменяет контекст. Например, значение константы __LINE__ зависит от строки скрипта, на которой указали константу. Магические константы PHP разрешает во время компиляции, в отличие от стандартных констант, которые PHP разрешает во время выполнения. Специальные константы нечувствительны к регистру, а их список приводит следующий параграф:

Магические константы PHP
Имя Описание
__LINE__ Текущий номер строки в файле.
__FILE__ Полный путь и имя текущего файла с развёрнутыми символическими ссылками. Возвращается имя подключаемого файла, если константу указали внутри подключаемого файла.
__DIR__ Возвращает директория подключаемого файла, если константу указали внутри подключаемого файла. Это эквивалентно вызову dirname(__FILE__). Возвращаемое имя директории не оканчивается на слеш, за исключением корневой директории.
__FUNCTION__ Имя функции или {closure} для анонимной функции.
__CLASS__ Имя класса. Имя класса включает пространство имён, в котором объявили класс (например, Foo\Bar). В методах трейтов константа __CLASS__ — имя класса, в котором вызывают метод трейта.
__TRAIT__ Имя трейта. Имя трейта включает пространство имён, в котором объявили трейт (например, Foo\Bar).
__METHOD__ Имя метода класса.
__NAMESPACE__ Имя текущего пространства имён.
ClassName::class Абсолютное имя класса.

add a note

User Contributed Notes 3 notes

up
2
Rich
8 months 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.
up
1
chris at ocproducts dot com
10 months 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".
up
0
theking2 at king dot ma
1 year 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.
To Top