Ошибка незаконченного комментария в PHP

Раньше как-то особо не приходилось с этим сталкиваться, а может я просто этого не замечал, ведь это не критическая ошибка, а просто предупреждение, которое записывается в логи и часто не выводится на рабочих серверах из-за соответствующих настроек PHP.

Как бы там не было, но ошибка незаконченного комментария вещь достаточно интересная и ведь действительно это ошибка. О таких ошибках часто не задумываешься, ведь в IDE как правило всё выглядит нормально.

Ошибка незаконченного комментария возникает тогда, когда закрывающий элемент многострочного комментария волей случая оказался за элементом однострочного комментария на одной строке. Получается, что как бы однострочный комментарий экранирует и закрывающий элемент многострочного комментария. На конкретном примере выглядит это примерно так:

/*
$aInserts['SkinBuild'] = array(
      'on' => true,
      'content' => array(array('',''))); // inline comment */

Да, это ошибка! Казалось бы, какая разница где закрывать элемент многострочного комментария, но нет. Закрывать многострочный комментарий в однострочном нельзя. Это не критично т.к. интерпретатор всё прекрасно понимает, но всё же считается за ошибку. Правильно будет вот так:

/*
$aInserts['SkinBuild'] = array(
      'on' => true,
      'content' => array(array('',''))); // inline comment
*/

Вот такие вот подводные камни могут поджидать неопытного программисты. Будьте осторожны при написании кода. Работать будет, но логи будут забиты ошибками, а оно вам надо? В работе программы всё должно быть чисто и без всяких ошибок.