Я использую Eclipse Kepler (4.3.1) для проекта PHP.
Я наткнулся на проблему с форматировщиком кода eclipse для PHP, касающуюся @return PHPDoc с символом трубы (вертикальной полосы): при наличии такого комментария:
<?php
/**
*
* @param string|array The parameter. Either a string or an array.
* @return int|string The return value. Either an int or a string.
*/
function test($param) {
}
Использование функции формата с [CTRL]+[SHIFT]+[F] приводит к:
<?php
/**
*
* @param
* string|array The parameter. Either a string or an array.
* @return int string return value. Either an int or a string.
*/
function test($param) {
}
Как видите, символ вертикальной черты между 'int' и 'string' в операторе '@return' был заменен пробелом. Но не только это. Также было обрезано первое слово описания («The»). С другой стороны, он отлично работает для оператора @param.
На phpdoc.org указано, что символ вертикальной черты используется при обработке неоднозначных возвращаемых значений: phpdoc-@return
Кто-то также задал вопрос об этом на форумах сообщества Eclipse: Сообщение на форуме буквально несколько дней назад.
Использование '@formatter:off' и '@formatter:on' не является вариантом, так как этот параметр является только локальным, и у других он может не быть установлен.
Кто-нибудь знает, как исправить и настроить форматировщик php-кода eclipse? У кого-нибудь есть обходной путь?