Как написано в стайлгайде проекта.

Ещё неплохой вариант - как угодно, с последующим автоматическим переоформлением.

/** - это маркер, отличающий просто коммент от документации. Больше нигде в теле коммента два астериска не нужны абсолютно.

Кто прав

Некий Уильям Оккам.

так

/*
 * Comment here
 * more comment here
 */

Какая, твою мать, разница?

Phil Karlton

There are only two hard things in Computer Science: cache invalidation and naming things.

Омг. Ты серьезно спрашиваешь? Как _правильно_?

Второе посимпатичнее но вообще абсолютно пох же.

Никто не прав, звёдочки вне /* и */ не нужны.

В коде больше натыкался на вариант 1

https://en.wikipedia.org/wiki/PHPDoc

Это вообще странно, например VIM (snipMate) делает второй вариант, а другие редакторы/IDE иначе. Понятно, что все это конфижится. Да, подтверждаю — в сишных сорцах в основном первый вариант, в пыховых — второй.

Правильно использовать средство документирования кода, вроде Doxygen, особенно если код является библиотекой.

/** - это маркер документации

Ок. Вменяемо.

Какой нафик пхпдок?

Тогда получается это:

/**
 * Comment here
 * more comment here
 **/

А это:

/*
 * Comment here
 * more comment here
 */

собсно это либо для генерации доков либо для IDE
в случае доков понятно, а вот если IDE понимает то:

/**
 * Some function
 *
 * @param $a
 * @param string $b
 * @return bool|string
 */
function blba($a, $b){...}

Какой нафик пхпдок?

как пример

https://en.wikipedia.org/wiki/Doxygen

Как правильно писать?

Вот так:

{-
...
-}

Странно, я как раз в php и натыкался Zend, Symphony

Может, даже если учитывать только пых, ты мало где смотрел?

возможно. А может просто этот вариант больше запомнился
А почему для тебя это так важно?

Пиздец у людей проблемы.

Я уже джва года ищу ответ на данный вопрос.

посмотри как в doxygen

Документация - это оба примера из ОП. Вторая в конце лишняя в любом случае. Но для красоты можно добавить.

Так мне нравится больше:

/*
 * Comment here
 * more comment here
 */

Как правильно писать? (комментарий)

Оба хуже. Единственная причина существования многострочных комментариев - не отмечать каждую строчку.

/*
Comment here
more comment here
*/

или

//Comment here
//more comment here

Правильно использовать средство документирования кода, вроде Doxygen, особенно если код является библиотекой.

https://ru.wikipedia.org/wiki/Грамотное_программирование - это наше всё

матлаб

%{ ... %}

или

% ...