Как сделать фрагменты кода PHP в Eclipse

Question

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

Как:

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

Answer 1

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

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

Answer 2

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

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

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

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

Answer 3

эти разделы

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

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

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

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

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