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

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

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

**Магические константы PHP**
Имя	Описание
`__LINE__`	Текущий номер строки в файле.
`__FILE__`	Полный путь и имя текущего файла с развёрнутыми символическими ссылками. Возвращается имя подключаемого файла, если константу указали внутри подключаемого файла.
`__DIR__`	Возвращает директория подключаемого файла, если константу указали внутри подключаемого файла. Это эквивалентно вызову `dirname(__FILE__)`. Возвращаемое имя директории не оканчивается на слеш, за исключением корневой директории.
`__FUNCTION__`	Имя функции или `{closure}` для анонимной функции.
`__CLASS__`	Имя класса. Имя класса включает пространство имён, в котором объявили класс (например, `Foo\Bar`). В методах трейтов константа __CLASS__ — имя класса, в котором вызывают метод трейта.
`__TRAIT__`	Имя трейта. Имя трейта включает пространство имён, в котором объявили трейт (например, `Foo\Bar`).
`__METHOD__`	Имя метода класса.
`__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.

＋Добавить