Как сделать разделы PHP -кода в Eclipse

Question

Я действительно только только что обнаружил, что вы можете использовать / ** @blah* / comments, чтобы указать определенные вещи, но возможно ли создавать разделы в коде?

Нравиться:

/** Start Section "Blah" **/
$result = doSomething();
echo $result;
/** End Section "Blah" */

Answer 1

Ни один PDT не может этого сделать. Обычно разделы расширяемых кодов идентифицируются по функции и методам класса.

Если вы думаете, что вам нужны искусственные разделы, идентифицированные комментариями, которые я рекомендую, чтобы предположить, что реорганизовать ваш код в более мелкозернистые файлы, функции, классы и методы, которые можно легко задокументировать, используя Phpdoc (который является стандартным использованием PDT).

Answer 2

эти разделы

 /**
   * here goes your text
   * @author Nanne
   * /

Основаны на Javadoc: http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html

Посмотрите на эту страницу, где описан документатор для PHP. Я не знаю, какой стандарт используется в Eclipse, но я предполагаю, что они все очень похожи:http://www.phpdoc.org/

В основном основан на комментировании определенных частей кода, например, классов, функций и переменных. Насколько я знаю, нет особого кода для «разделов». Причина, по которой я думаю, заключается в том, что вы «предполагаете» сделать документацию из этого, с классами, его методами и т. Д. В такой документации нет особого способа представить «разделы».

Но прочитайте выше ссылки, это будет много прояснить!

Answer 3

В PHP вы можете использовать разделы для разделения кусков кода. Синтаксис такой:

Blah:{
   $result = doSomething();
   echo $result;
}

Они использовались goto Процедурное программирование в стиле до использования объектно -ориентированного программирования (классы и экземпляры). Используя эти разделы и goto Заявления очень плохая практика, и любой разработчик должен избегать.

https://www.php.net/manual/en/control-structures.goto.php