Question

J'ai vraiment juste découvert que vous pouvez utiliser / ** * @blah / commentaires pour préciser certaines choses, mais est-il possible de créer des sections dans le code?

Comme:

/** Start Section "Blah" **/
$result = doSomething();
echo $result;
/** End Section "Blah" */
Était-ce utile?

La solution

Non PDT ne peut le faire. En général, les sections de code expansibles sont identifiés par des fonctions et des organes méthode de classe.

Si vous pensez que vous avez besoin des sections artificielles identifiées par des commentaires que je recommande de penser plutôt à réorganiser votre code dans des fichiers à grains plus fines, la fonction, les classes et les méthodes qui peuvent être facilement documentés à l'aide PHPDoc (ce qui est l'utilisation standard PDT).

Autres conseils

ces sections

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

sont basées sur javadoc: http://www.oracle .com / TechNetwork / java / JavaSE / documentation / index-137868.html

Regardez cette page où Documenter pour PHP est décrit. Je ne sais pas ce standard est utilisé dans Eclipse, mais je devine qu'ils sont tous plutôt ressemblent: http://www.phpdoc.org/

Est est principalement basée sur des commentaires certaines parties du code, par exemple classes, fonctions et variables. Pour autant que je sais qu'il n'y a pas de code spécial pour « sections ». La raison pour laquelle je pense que cela est que vous êtes « censé » faire une documentation de cela, avec des classes, il est des méthodes, etc. Il n'y a pas de façon particulière pour représenter « sections » dans une documentation comme ça.

Mais lisez-liens ci-dessus, il va éclaircir beaucoup!

En PHP, vous pouvez utiliser des sections pour séparer des morceaux de code. La syntaxe est comme ceci:

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

Ils ont été utilisés par le style de goto programmation procédurale avant la programmation orientée objet a été utilisé (classes et instances). L'utilisation de ces sections et les déclarations de goto est très mauvaise pratique et devrait être boudé par tout développeur.

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

Licencié sous: CC-BY-SA avec attribution
Non affilié à StackOverflow
scroll top