How a phpDocumentor commment is structured (DocBlock Sections)

The most current version as of .

PHP DocBlock are mainly built up by three different parts, which all together create one DocBlock:

  1. The Summary
  2. The Description
  3. The Tags

The summary is a one-liner, which descripes what the code block is all about.

The description adds more details about the described code in form of an extended text.

Tags describe the properties, for example @param and @return.

More details on the topic can be found in the phpDocumentor docs.

— David Wolf