(PHP 5 >= 5.3.0, PHP 7)
Этот список вопросов разделен на две части: общие вопросы и некоторые особенности реализации, которые полезны для более полного понимания.
Сперва, общие вопросы.
- Если я не использую пространства имен, следует ли считать что-либо из этого важным?
- Как мне использовать внутренние или глобальные классы в пространстве имен?
- Как мне использовать функции классов в пространствах имен, или константы в их собственном пространстве имен?
- Как такое имя как \my\name или \name преобразуется?
- Как такое имя, как my\name преобразуется?
- Как неполное имя класса такое как name преобразуется?
- Как неполное имя функции или неполное имя константы такое как name преобразуется?
Некоторые детали реализации пространств имен, которые полезно понимать.
- Импортируемые имена не могут конфликтовать с классами, определенными в том же файле.
- Ни функции, ни константы не могут быть заимпортированы с помощью оператора use .
- Динамические имена пространств имен (идентификаторы, взятые в кавычки) должны экранировать символ обратного слеша.
- Ссылаться на неопределенные константы, используя обратный слеш, нельзя. Выводится фатальная ошибка
- Невозможно переопределить специальные константы, такие как NULL, TRUE, FALSE, ZEND_THREAD_SAFE или ZEND_DEBUG_BUILD
Если я не использую пространства имен, следует ли считать что-либо из этого важным?
Нет. Пространства имен не оказывают никакого влияния ни на какой существующий код ни в каком виде или на любой написанный код, который не содержит пространств имен. Вы можете написать такой код, если желаете:
Пример #1 Доступ к глобальным классам вне пространства имен
$a
= new \
stdClass
;
?>
Это функционально эквивалентно следующему:
Пример #2 Доступ к глобальным классам вне пространства имен
$a
= new
stdClass
;
?>
Как мне использовать внутренние или глобальные классы в пространстве имен?
Пример #3 Доступ ко внутренним классам в пространствах имен
namespace
foo
;
$a
= new \
stdClass
;
function test (\ ArrayObject $typehintexample = null ) {}
$a = \ DirectoryIterator :: CURRENT_AS_FILEINFO ;
// расширение внутреннего или глобального класса
class
MyException
extends \
Exception
{}
?>
Как мне использовать функции классов в пространствах имен или константы в их собственном пространстве имен?
Пример #4 Доступ ко внутренним классам, функциям или константам в пространствах имен
namespace foo ;
class MyClass {}
// использование класса из текущего пространства имен
function
test
(MyClass $typehintexample
=
null
) {}
// другой способ использовать класс из текущего пространства имен
function
test
(\
foo
\
MyClass $typehintexample
=
null
) {}
// расширение класса из текущего пространства имен
class
Extended
extends
MyClass
{}
// доступ к глобальной функции
$a
= \
globalfunc
();
// доступ к глобальной константе
$b
= \
INI_ALL
;
?>
Как такое имя как \my\name или \name преобразуется?
Имена, которые начинаются с \ всегда преобразуются к тому как они выглядят, т.е. \my\name - это на самом деле my\name , и \Exception - это Exception .
Пример #5 Абсолютные имена
namespace
foo
;
$a
= new \
my
\
name
();
// создает экземпляр класса "my\name"
echo \
strlen
("hi"
);
// вызывает функцию "strlen"
$a
= \
INI_ALL
;
// переменной $a присваивается значение константы "INI_ALL"
?>
Как такое имя, как my\name преобразуется?
Имена, которые содержат обратный слеш, но не начинаются с него, такие как my\name
my другого имени, то этот синоним применяется к my в my\name .
my\name .
Пример #6 Полные имена
namespace
foo
;
use
blah
\
blah
as
foo
;
$a
= new
my
\
name
();
// создает экземпляр класса "foo\my\name"
foo
\
bar
::
name
();
// вызывает статический метод "name" в классе "blah\blah\bar"
my
\
bar
();
// вызывает функцию "foo\my\bar"
$a
=
my
\
BAR
;
// присваивает переменной $a значение константы "foo\my\BAR"
?>
Как неполное имя класса такое как name преобразуется?
Имена классов, которые не содержат обратный слеш, такие как name могут быть преобразованы двумя различными способами.
Если присутствует импортирующее выражение, которое создает синоним name другого имени, то применяется этот синоним.
В ином случае, текущее имя пространства имен становится префиксом к my\name .
Пример #7 Неполные имена классов
namespace
foo
;
use
blah
\
blah
as
foo
;
$a
= new
name
();
// создает экземпляр класса "foo\name"
foo
::
name
();
// вызывает статический метод "name" в классе "blah\blah"
?>
Как неполное имя функции или неполное имя константы такое как name преобразуется?
Имена функций или констант, которые не содержат обратного слеша, такие как name могут быть преобразованы двумя различными способами.
Сперва, текущее имя пространства имен становится префиксом к name .
Затем, если константа или функция name не существует в текущем пространстве имен, используется глобальная константа или функция name , если она существует.
Пример #8 Неполные имена функций или констант
namespace
foo
;
use
blah
\
blah
as
foo
;
const FOO = 1 ;
function
my
() {}
function
foo
() {}
function
sort
(&
$a
)
{
\
sort
($a
);
// вызывает глобальную функцию "sort"
$a
=
array_flip
($a
);
return
$a
;
}
My
();
// вызывает "foo\my"
$a
=
strlen
("hi"
);
// вызывает глобальную функцию "strlen", потому что "foo\strlen" не существует
$arr
= array(1
,
3
,
2
);
$b
=
sort
($arr
);
// вызывает функцию "foo\sort"
$c
=
foo
();
// вызывает функцию "foo\foo" - импорт не применяется
$a
=
FOO
;
// присваивает переменной $a значение константы "foo\FOO" - импорт не применяется
$b
=
INI_ALL
;
// присваивает переменной $b значение глобальной константы "INI_ALL"
?>
Импортируемые имена не могут конфликтовать с классами, определенными в том же файле.
Следующие комбинации скриптов допустимы:
namespace
my
\
stuff
;
class
MyClass
{}
?>
namespace
another
;
class
thing
{}
?>
namespace
my
\
stuff
;
include
"file1.php"
;
include
"another.php"
;
$a
= new
MyClass
;
// создает экземпляр класса "thing" из пространства имен "another"
?>
Конфликт имен отсутствует даже несмотря на то, что класс MyClass существует внутри пространства имен my\stuff , потому что определение MyClass находится в отдельном файле. Однако следующий пример приводит к фатальной ошибке с конфликтом имен, потому что класс MyClass определен в том же файле, где находится оператор use.
namespace
my
\
stuff
;
use
another
\
thing
as
MyClass
;
class
MyClass
{}
// фатальная ошибка: MyClass конфликтует с выражением импорта
$a
= new
MyClass
;
?>
Вложенные пространства имен недопустимы.
PHP не позволяет вложение пространств имен одно в другое
namespace
my
\
stuff
{
namespace
nested
{
class
foo
{}
}
}
?>
Однако, сымитировать вложенные пространства имен так:
namespace
my
\
stuff
\
nested
{
class
foo
{}
}
?>
До PHP 5.6 ни функции, ни константы не могли быть импортированы с помощью оператора use .
До PHP 5.6 единственные элементы, которые подвержены действию оператора use - это пространства имен и имена классов. Для сокращения длинных имен констант или функций, заимпортируйте их содержимое в пространство имен.
namespace
mine
;
use
ultra
\
long
\
ns
\
name
;
$a
=
name
\
CONSTANT
;
name
\
func
();
?>
Начиная с PHP 5.6 стало возможным импортирование и создание пседонимов для функций и имен констант.
Динамические имена пространств имен (идентификаторы, взятые в кавычки) должны экранировать символ обратного слеша.
Очень важно представлять это, потому что обратный слеш используется как экранирующий символ внутри строк. Он всегда должен быть продублирован, когда используется внутри строки, иначе появляется риск возникновения неумышленных последствий:
Пример #9 Подводные камни при использовании имени пространства имен внутри строки с двойными кавычками
$a
=
"dangerous\name"
;
// \n - это переход на новую строку внутри строки с двойными кавычками!
$obj
= new
$a
;
$a
=
"not\at\all\dangerous"
;
// а тут нет проблем.
$obj
= new
$a
;
?>
Внутри строк, заключенных в одинарные кавычки, обратный слеш в качестве разделителя более безопасен, но по-прежнему рекомендуемая практика экранирования обратного слеша во всех строках является наилучшим вариантом.
Ссылаться на неопределенные константы, используя обратный слеш, нельзя. Выводится фатальная ошибка
Любая неопределенная константа, являющаяся неполным именем, как FOO , будет приводить к выводу сообщения о том, что PHP предположил, что FOO было значение константы. Любая константа, с полным или абсолютным именем, которая содержит символ обратного слеша будет приводить к фатальной ошибке, если не будет найдена.
Пример #10 Неопределенные константы
namespace
bar
;
$a
=
FOO
;
// выводит предупреждение: undefined constants "FOO" assumed "FOO";
$a
= \
FOO
;
// фатальная ошибка: undefined namespace constant FOO
$a
=
Bar
\
FOO
;
// фатальная ошибка: undefined namespace constant bar\Bar\FOO
$a
= \
Bar
\
FOO
;
// фатальная ошибка: undefined namespace constant Bar\FOO
?>
Невозможно переопределить специальные константы, такие как NULL, TRUE, FALSE, ZEND_THREAD_SAFE или ZEND_DEBUG_BUILD
Любая попытка определить константу пространства имен, которая совпадает с названиями специальных встроенных констант, приведет к фатальной ошибке.
Пример #11 Неопределенные константы
namespace
bar
;
const
NULL
=
0
;
// Фатальная ошибка;
const
true
=
"stupid"
;
// также фатальная ошибка;
// и т.д.
?>
7 years ago
There is a way to define a namespaced constant that is a special, built-in constant, using define function and setting the third parameter case_insensitive to false:
namespace
foo
;
define
(__NAMESPACE__
.
"\NULL"
,
10
);
// defines the constant NULL in the current namespace
?>
No need to specify the namespace in your call to define(), like it happens usually
namespace
foo
;
define
(INI_ALL
,
"bar"
);
// produces notice - Constant INI_ALL already defined. But:
Define
(__NAMESPACE__
.
"\INI_ALL"
,
"bar"
);
// defines the constant INI_ALL in the current namespace
var_dump
(INI_ALL
);
// will show string(3)"bar". Nothing unespected so far. But:
Define
("NULL"
,
10
);
// defines the constant NULL in the current namespace...
var_dump
(NULL
);
// will show 10
var_dump
(null
);
// will show NULL
?>
If the parameter case_insensitive is set to true
namespace
foo
;
define
(__NAMESPACE__
.
"\NULL"
,
10
,
true
);
// produces notice - Constant null already defined
?>
3 years ago
When creating classes or calling static methods from within namespaces using variables, you need to keep in mind that they require the full namespace in order for the appropriate class to be used; you CANNOT use an alias or short name, even if it is called within the same namespace. Neglecting to take this into account can cause your code to use the wrong class, throw a fatal missing class exception, or throw errors or warnings.
In these cases, you can use the magic constant __NAMESPACE__, or specify the full namespace and class name directly. The function class_exists also requires the full namespace and class name, and can be used to ensure that a fatal error won"t be thrown due to missing classes.
Namespace
Foo
;
class
Bar
{
public static function
test
() {
return
get_called_class
();
}
}
namespace
Foo
\
Foo
;
class
Bar
extends \
Foo
\
Bar
{
}
Var_dump (Bar :: test ()); // string(11) "Foo\Foo\Bar"
$bar
=
"Foo\Bar"
;
var_dump
($bar
::
test
());
// string(7) "Foo\Bar"
$bar
=
__NAMESPACE__
.
"\Bar"
;
var_dump
($bar
::
test
());
// string(11) "Foo\Foo\Bar"
$bar
=
"Bar"
;
var_dump
($bar
::
test
());
// FATAL ERROR: Class "Bar" not found or Incorrect class \Bar used
Константа - это идентификатор (имя) для простого значения. Как следует из названия, их значение не может изменится в ходе выполнения скрипта (кроме магических констант , которые на самом деле не являются константами). Имена констант по умолчанию чувствительны к регистру. По принятому соглашению, имена констант всегда пишутся в верхнем регистре.
Имя константы должно соответствовать тем же правилам именования, что и другие имена в PHP. Правильное имя начинается с буквы или символа подчеркивания, за которым следует любое количество букв, цифр и символов подчеркивания. Регулярное выражение для проверки правильности имени константы выглядит так: ^*$
Возможно определить константы с помощью функции define() зарезервированными или даже некорректными именами, значения которых могут быть (только) получены через функцию constant() . Однако, делать это не рекомендуется.
Пример #1 Правильные и неправильные имена констант
// Правильные имена констант
define
("FOO"
,
"что-то"
);
define
("FOO2"
,
"что-то ещё"
);
define
("FOO_BAR"
,
"что-то большее"
);
// Неправильные имена констант
define
("2FOO"
,
"что-то"
);
// Это верное объявление, но лучше его не использовать:
// PHP однажды может зарегистрировать волшебную константу,
// которая нарушит работу скрипта
define
("__FOO__"
,
"что-то"
);
?>
Замечание : Понятие "буквы" здесь - это символы a-z, A-Z, и другие символы с ASCII-кодами от 128 до 255 (0x80-0xff).
2 years ago
Performance of constants. PHP 7.1.10 32 bits (Opcache active, windows 10 i7-64bits) but apparently the trends is the same with the 5.x
using a constant declared by DEFINE("CNS",value) : 0.63575601577759s
using a constant declared by const CNS=value: 0.61372208595276s
using a variable declared by $v=value: 0.51184010505676s
In average, the use of DEFINE and CONST is around the same with some sightly better performance of CONST instead of DEFINE. However, using a variable is around 10-50% better than to use a constant. So, for a performance intensive task, constant is not the best option.
$p1=microtime(true);
$x=0;
for($i=0;$i<50000000;$i++) {
$x+=CNS;
}
$p2=microtime(true);
14 years ago
An undefined constant evaluates as true when not used correctly. Say for example you had something like this:
settings.php
// Debug mode
define
("DEBUG"
,
false
);
?>
test.php
include("settings.php"
);
if (DEBUG
) {
// echo some sensitive data.
}
?>
If for some reason settings.php doesn"t get included and the DEBUG constant is not set, PHP will STILL print the sensitive data. The solution is to evaluate it. Like so:
settings.php
// Debug mode
define
("DEBUG"
,
0
);
?>
test.php
include("settings.php"
);
if (DEBUG
==
1
) {
// echo some sensitive data.
}
?>
Now it works correctly.
Для каждого выполняемого скрипта. Многие из этих констант определяются различными модулями и будут присутствовать только в том случае, если эти модули доступны в результате динамической загрузки или в результате статической сборки.
Есть девять магических констант, которые меняют свое значение в зависимости от контекста, в котором они используются. Например, значение __LINE__ зависит от строки в скрипте, на которой эта константа указана. Все магические константы разрешаются во время компиляции, в отличие от обычных констант, которые разрешаются во время выполнения. Специальные константы нечувствительны к регистру и их список приведен ниже:
| Имя | Описание |
|---|---|
| __LINE__ | Текущий номер строки в файле. |
| __FILE__ | Полный путь и имя текущего файла с развернутыми симлинками. Если используется внутри подключаемого файла, то возвращается имя данного файла. |
| __DIR__ | Директория файла. Если используется внутри подключаемого файла, то возвращается директория этого файла. Это эквивалентно вызову dirname(__FILE__) . Возвращаемое имя директории не оканчивается на слеш, за исключением корневой директории. |
| __FUNCTION__ | Имя функции или {closure} в случае анонимной функции. |
| __CLASS__ | Имя класса. Это имя содержит название пространства имен, в котором класс был объявлен (например, Foo\Bar ). Обратите внимание, что начиная с PHP 5.4 __CLASS__ также работает в трейтах. При использовании в методах трейтов __CLASS__ является именем класса, в котором эти методы используется. |
| __TRAIT__ | Имя трейта. Это имя содержит название пространства имен, в котором трейт был объявлен (например, Foo\Bar ). |
| __METHOD__ | Имя метода класса. |
| __NAMESPACE__ | Имя текущего пространства имен. |
| ClassName::class | Полное имя класса (с указанием пространства имен). См. также ::class . |
Смотрите также get_class() , get_object_vars() , file_exists() и function_exists() .
Список изменений
14 years ago
The difference between
__FUNCTION__ and __METHOD__ as in PHP 5.0.4 is that
FUNCTION__ returns only the name of the function
while as __METHOD__ returns the name of the class alongwith the name of the function
class trick
{
function doit()
{
echo __FUNCTION__;
}
function doitagain()
{
echo __METHOD__;
}
}
$obj=new trick();
$obj->doit();
output will be ---- doit
$obj->doitagain();
output will be ----- trick::doitagain
12 years ago
The __CLASS__ magic constant nicely complements the get_class() function.
Sometimes you need to know both:
- name of the inherited class
- name of the class actually executed
Here"s an example that shows the possible solution:
Class
base_class
{
function
say_a
()
{
"
;
}
Function
say_b
()
{
"
;
}
class
derived_class
extends
base_class
{
function
say_a
()
{
parent
::
say_a
();
echo
""a" - said the "
.
__CLASS__
.
"
"
;
}
Function
say_b
()
{
parent
::
say_b
();
echo
""b" - said the "
.
get_class
($this
) .
"
"
;
}
}
$obj_b = new derived_class ();
$obj_b
->
say_a
();
echo
"
"
;
$obj_b
->
say_b
();
?>
The output should look roughly like this:
"a" - said the base_class
"a" - said the derived_class
"b" - said the derived_class
"b" - said the derived_class
3 years ago
Note a small inconsistency when using __CLASS__ and __METHOD__ in traits (stand php 7.0.4): While __CLASS__ is working as advertized and returns dynamically the name of the class the trait is being used in, __METHOD__ will actually prepend the trait name instead of the class name!
8 years ago
There is no way to implement a backwards compatible __DIR__ in versions prior to 5.3.0.
The only thing that you can do is to perform a recursive search and replace to dirname(__FILE__):
find . -type f -print0 | xargs -0 sed -i "s/__DIR__/dirname(__FILE__)/"
5 years ago
A lot of notes here concern defining the __DIR__ magic constant for PHP versions not supporting the feature. Of course you can define this magic constant for PHP versions not yet having this constant, but it will defeat its purpose as soon as you are using the constant in an included file, which may be in a different directory then the file defining the __DIR__ constant. As such, the constant has lost its *magic*, and would be rather useless unless you assure yourself to have all of your includes in the same directory.
Concluding: eye catchup at gmail dot com"s note regarding whether you can or cannot define magic constants is valid, but stating that defining __DIR__ is not useless, is not!
7 years ago
You cannot check if a magic constant is defined. This means there is no point in checking if __DIR__ is defined then defining it. `defined("__DIR__")` always returns false. Defining __DIR__ will silently fail in PHP 5.3+. This could cause compatibility issues if your script includes other scripts.
echo (defined
("__DIR__"
) ?
"__DIR__ is defined"
:
"__DIR__ is NOT defined"
.
PHP_EOL
);
echo (defined
("__FILE__"
) ?
"__FILE__ is defined"
:
"__FILE__ is NOT defined"
.
PHP_EOL
);
echo (defined
("PHP_VERSION"
) ?
"PHP_VERSION is defined"
:
"PHP_VERSION is NOT defined"
) .
PHP_EOL
;
echo
"PHP Version: "
.
PHP_VERSION
.
PHP_EOL
;
?>
Output:
__DIR__ is NOT defined
__FILE__ is NOT defined
PHP_VERSION is defined
PHP Version: 5.3.6
В этой заметке речь пойдет о константах. Как обычно разберемся с самим понятием константы в языках программирования и посмотрим, как объявляются и используются константы в PHP .
Понятие константа и константы в PHP
Слово константа должно быть вам уже знакомо из математики:
“Математическая константа - величина, значение которой не меняется.”
Тоже самое и в PHP. Константа в PHP – это идентификатор, который служит для обозначения простого значения (строка, число какое-нибудь), которое не может изменяться в процессе выполнения кода.
Для объявления константы (присвоения ей значения) используется функция define . Пример объявления константы:
Имена констант в PHP чувствительны к регистру (большие и маленькие буквы различаются), так что нужно быть внимательней. Также существует соглашение, что имена констант всегда пишутся в верхнем регистре.
Имя константы должно начинаться с буквы или символа подчеркивания “_” и может состоять из букв, цифр и подчеркивания.
Рассмотрим простой пример использования константы:
В этом примере мы объявили константу и использовали ее в программе.
Для чего используются константы и не проще ли использовать переменные?
Как уже было сказано, константы не могут изменить своего значения в процессе выполнения программы. В константах обычно сохраняют постоянные параметры сайта, такие как реквизиты доступа к базе данных (хост, логин и пароль пользователя, имя базы данных), расположение сайта на диске и многие другие настройки.
Если мы будем использовать переменные, то скрип может случайно (в случаем ошибки) изменить значение переменной и будет работать не так как вы задумали.
Использование констант гарантирует, что то значение которое вы указали при объявлении константы останется неизменным.
Встречаются случаи, когда переменные довольно неудобно использовать для постоянного хранения каких либо определенных значений, которые не меняются в течение работы программы. Такими значениями могут быть математические константы, пути к файлам, разнообразные пароли и.т.д. Как раз для этих целей в PHP предусмотрена такая конструкция, как.
называется именованная величина, которая не изменяется в процессе выполнения программы (скрипта).
В РНР константы определяются функцией define() . Эта функция имеет следующий формат:
define ($name , $value , $case_sen ), где:
$name
- имя константы;
$value
- значение константы;
$case_sen
- необязательный параметр логического типа,
указывающий, следует ли учитывать регистр букв (true) или нет (false).
Пример определения и использования констант в PHP:
echo pi
;
// Выводит 3.14
?>
Если параметр $case_sen равен true , то интерпретатор будет учитывать регистр символов при работе с константой. Обратите внимание, что константы используются без предваряющего знака $ .
Различия между константами и переменными:
У констант нет приставки в виде знака доллара ($ );
Константы можно определить только с помощью функции define() , а не присваиванием значения;
Константы могут быть определены и доступны в любом месте без учета области видимости;
Константы не могут быть определены или аннулированы после первоначального объявления;
Константы могут иметь только скалярные значения.
Проверка существования констант
Для проверки существования константы можно использовать функцию defined() . Данная функция возвращает true , если константа объявлена. Приведем пример:
// Объявляем константу pi
define
("pi"
,
3.14
,
true
);
if
(defined
("pi"
)==
true
)
echo
"Константа pi объявлена!"
;
// Скрипт выведет "Константа pi объявлена!"
?>
Предопределенные константы PHP
В PHP существуют следующие предопределенные константы:
PHP предоставляет большой список предопределенных констант для каждого выполняемого скрипта. Многие из этих констант определяются различными модулями и будут присутствовать только в том случае, если эти модули доступны в результате динамической загрузки или в результате статической сборки.
Есть пять предопределенных констант, которые меняют свое значение в зависимости от контекста, в котором они используются. Например, константа __LINE__ зависит от строки в скрипте, на которой эта константа указана. Специальные константы нечувствительны к регистру и их список приведен ниже:
| Имя | Описание |
|---|---|
| __LINE__ | Текущая строка в файле. |
| __FILE__ | Полный путь и имя текущего файла. |
| __DIR__ | The directory of the file. If used inside an include, the directory of the included file is returned. This is equivalent to dirname(__FILE__). This directory name does not have a trailing slash unless it is the root directory. |
| __FUNCTION__ | Имя функции. (Добавлена в PHP 4.3.0.) |
| __CLASS__ | Имя класса. (Добавлена в PHP 4.3.0.) |
| __TRAIT__ | The trait name. The trait name includes the namespace it was declared in (e.g. Foo\Bar). |
| __METHOD__ | Имя метода класса. (Добавлена в PHP 5.0.0) |
| __NAMESPACE__ | The name of the current namespace. |
Дополнительно
