Создание констант в PHP — const и define()

В этой заметке разберемся, в чем разница в объявлении PHP констант с помощью ключевого слова const и функции define().

Константы в PHP - это «постоянные», значения которых указывается всего один раз и затем не может быть изменено. При попытке изменить значение, оно не изменится и появится PHP заметка: «Constant already defined» (константа уже определена):

define('FOO', 'val');
define('FOO', 'val2'); // Notice: Constant already defined

echo FOO; //> val

Объявлять константы в PHP можно двумя способами:

// 1
define( 'NAME', 'VALUE' );

// 2
const NAME = 'VALUE';

У каждого способа есть свои особенности, чтобы их понять, давайте рассмотрим все поэтапно, как и что менялось с каждой версией PHP.

Как создавать константы

PHP меньше 5.3

До 5.3 в PHP, константы можно было определять только через define(). Ключевое слово const появилось с версии 5.3.

Константы могут хранить только скаляры. Скалярные переменные - это переменные с типами integer, float, string и boolean. Типы array, object и resource не являются скалярными.

// скаляры
define( 'FOO', 10 );
define( 'FOO', 10.9 );
define( 'FOO', 'val' );
define( 'FOO', true );

// не скаляры
define( 'FOO', array(1) );          // константа не установиться и получим Warning
define( 'FOO', (object) array(1) ); // константа не установиться и получим Warning

С версии PHP 5.3

Появилось ключевое слово const и теперь константу можно определять еще и с помощью него.

Однако, в const нельзя указать переменную, функцию или какое то выражение, а нужно передавать скаляр «напрямую»:

const FOO = 'val';       // нет ошибок
const FOO = $var;        // Parse error
const FOO = home_url();  // Parse error
const FOO = 5 + 10;      // Parse error
const FOO = 'foo'.'bar'; // Parse error

Тогда как для define() таких ограничений нет...

define('FOO', 'val');         // нет ошибок
define('FOO', $var );         // нет ошибок
define('FOO', home_url() );   // нет ошибок
define('FOO', 5 + 10 );       // нет ошибок
define('FOO', 'foo'.'bar' );  // нет ошибок

PHP 5.6

Стало возможным указывать в значения const примитивные PHP выражения (выражения из скаляров):

const FOO = 1 + 2;
const FOO = 'foo' . 'bar';

Стало возможным хранить массивы в константах:

const FOO = [1, 2, 3];      // работает

define( 'FOO', [1, 2, 3] ); // не работает PHP 5.6, работает в PHP 7.0

Разница между define() и const

#1 const должны быть объявлены в верхней области

В отличие define(), const должны быть объявлены в самой верхней области видимости, потому что они определяются при компилировании скрипта. Это значит, что их нельзя объявлять внутри функций/циклов/выражений if или try/catch блоков.

if ( 1 ) {
	const NAME = 'VALUE';  // не работает
}
// но
if ( 1 ) {
	define('NAME', 'VALUE');  // работает
}

#2 const всегда регистрозависима

const всегда регистро-зависима, в то время как define() позволяет сделать регистро-независимые константы:

define('NAME', 'VALUE', true);
echo NAME; // VALUE
echo name; // VALUE

#3 const понимает только скаляры

Это справедливо только для версий PHP 5.6 и ниже...

const нельзя передать переменные, функции, выражения, а define() можно:

const FOO = $var;       // Parse error
const FOO = home_url(); // Parse error

define('FOO', $var );        // нет ошибок
define('FOO', home_url() );  // нет ошибок

#4 const может хранить массивы с версии PHP 5.6 а define с PHP 7.0

const FOO = [1, 2, 3];      // работает в PHP 5.6
define( 'FOO', [1, 2, 3] ); // не работает PHP 5.6, работает в PHP 7.0

Итоги сравнения

Определять константу почти всегда лучше с помощью define(), потому что тут больше возможностей и меньше вариантов «поймать» ошибку... Исключение - это когда у вас версия PHP 5.6 и вам нужно сохранить массив в константу, тут поможет const.

Константы PHP класса

Объявляются только с помощью const. Правила для них такие как описано выше: принимают только скаляры, не понимают PHP переменные, функции, выражения...

Объявленная константа принадлежит именно классу, она не принадлежит ни одному объекту и является общей на все объекты (экземпляры) класса.

class My_Class {
	const NAME = 'VALUE';

	// начиная с PHP 5.6 можно использовать математические выражения
	const SEC_PER_DAY = 60 * 60 * 24;

	function print_name() {
		// обращение к константе класса внутри метода через self (сам класс)
		echo self::NAME;
	}
}

// обращение к константе вне класса
// можно вызывать из глобальной области видимости без инициализации экземпляра класса
echo My_Class::NAME;

class Foo {
	// Начиная с PHP 7.1.0
	public const BAR = 'bar';
	private const BAZ = 'baz';
}

class My_Class {
	const NAME = 'VALUE';
	static $name = 'VALUE';
}

echo My_Class::NAME;
echo My_Class::$name;

«Волшебные» константы

И в заключении вспомним про особые константы PHP...

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