PHPDoc：如何记录不同的类属性选项

Question

Is there any way with phpdoc to document the different values that a class property can take and what effect this will have. For example:-

class SomeClass {

   /**
   * Cell text align
   * 
   * null - table default
   * l - left align
   * r - right align
   * c - centre align
   * j - justify
   */
   public $align;

   Some code
}

Is there any way to make the value-description pairs be parsed by phpdoc so that it will turn them into a definition list or such like?

Answer 1

Something like this will become a <ul> in the documentation output:

class SomeClass {

   /**
    * Cell text align
    * 
    * Possible values: 
    * - null - table default
    * - l - left align
    * - r - right align
    * - c - centre align
    * - j - justify
    */
   public $align;

   // Some code
}

From the manual page on DocBlock description details.