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

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

Есть девять магических констант, которые меняют своё значение в зависимости от контекста, в котором они используются. Например, значение __LINE__ зависит от строки в скрипте, на которой эта константа указана. Все магические константы разрешаются во время компиляции, в отличие от обычных констант, которые разрешаются во время выполнения. Специальные константы нечувствительны к регистру и их список приведён ниже:

**Магические константы 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

down

Rich ¶

9 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.

down

chris at ocproducts dot com ¶

11 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".

down

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.

add a note