Неожиданный токен в PHP – отладка и исправление синтаксических ошибок

Расширенные примеры синтаксических ошибок unexpected token

Ниже приведены более сложные и нестандартные случаи появления ошибки "unexpected token" в PHP. Каждый пример содержит код, ожидаемый результат (если применимо) и разбор проблемы.

1. Heredoc с некорректным идентификатором

Heredoc требует, чтобы закрывающий идентификатор располагался строго в начале строки без пробелов. Если это условие нарушается, возникает неожиданный токен.

<?php
$text = <<<EOT
Hello, world!
  EOT;  // пробелы перед EOT
?>

Ошибка: unexpected 'EOT' (T_ENCAPSED_AND_WHITESPACE). Исправление: удалить пробелы перед EOT.

<?php
$text = <<<EOT
Hello, world!
EOT;
?>

(без ошибки)

2. Статический вызов метода с синтаксической ошибкой

При использовании оператора разрешения области видимости (::) нельзя ставить пробел между именем класса и ::, а также после :: перед именем метода.

<?php
class MyClass {
    public static function test() {
        echo 'OK';
    }
}
MyClass :: test();
?>

Ошибка: unexpected '::' (T_PAAMAYIM_NEKUDOTAYIM) или подобная. Исправление: убрать пробел.

MyClass::test();

3. Использование ключевого слова в качестве имени константы класса

В PHP 7+ некоторые ключевые слова разрешены как имена констант, но не все. Например, const class = 1; вызовет ошибку.

<?php
class A {
    const class = 1;
}
?>

Ошибка: unexpected 'class' (T_CLASS). Исправление: выбрать другое имя, например, const className = 1;

4. Неправильное использование оператора instanceof с переменной

Оператор instanceof требует имени класса (строки или идентификатора) справа. Если поставить переменную без специального синтаксиса, возникнет ошибка.

<?php
$obj = new stdClass();
$class = 'stdClass';
if ($obj instanceof $class) {
    echo 'yes';
}
?>

Ошибка: unexpected '$class' (T_VARIABLE) (на самом деле в PHP 5 это было ошибкой, начиная с PHP 5.6? PHP 7.0? В современных версиях можно использовать переменную в instanceof, но раньше требовалась строка. Пример для образовательных целей).

В современных PHP код допустим. Аналогичная проблема могла быть с dynamic call: $obj->$method().

5. Смешанный синтаксис: фигурные скобки и альтернативный синтаксис в одном блоке

<?php
if ($a) {
    echo 'a';
} endif;
?>

Ошибка: unexpected 'endif' (T_ENDIF). Нельзя одновременно использовать { и endif. Выберите один стиль.

<?php
if ($a):
    echo 'a';
endif;
?>

6. Ошибка при использовании генератора с неправильным ключевым словом yield

<?php
function gen() {
    for ($i = 0; $i < 5; $i++) {
        yeild $i;  // опечатка
    }
}
?>

Ошибка: unexpected 'yeild' (T_STRING). Исправление: yield.

yield $i;

7. Пропуск запятой в объявлении массива

<?php
$arr = [1, 2 3];
?>

Ошибка: unexpected '3' (T_LNUMBER). Исправление: поставить запятую между 2 и 3.

$arr = [1, 2, 3];

8. Неверный синтаксис для использования traits

<?php
trait T {
    public function foo() {}
}
class A {
    use T {
        foo as private;
    }  // пропущена точка с запятой после класса
?>

Ошибка: unexpected end of file. Исправление: добавить закрывающую } для класса и ?>.

class A {
    use T {
        foo as private;
    }
}
?>

9. Динамические имена констант с помощью constant()

Если забыть синтаксис, можно получить ошибку. Например, constant('CLASS') вызовет ошибку, так как CLASS не определена.

<?php
echo constant('CLASS');
?>

Ошибка: unexpected 'CLASS' (T_CLASS) (на самом деле это runtime-ошибка, но в некоторых контекстах может быть синтаксической).

10. Использование null как имя функции

<?php
function null() {
    return null;
}
?>

Ошибка: unexpected 'null' (T_NULL). Исправление: изменить имя.

function returnNull() {
    return null;
}

Эти примеры показывают разнообразие ситуаций, в которых может появиться сообщение "unexpected token". Ключ к быстрому исправлению – внимательно читать сообщение об ошибке, анализировать строку и ожидаемый токен, пользоваться подсветкой синтаксиса и утилитой php -l.