Пример #1
0
 private function _getDc($data, $type = 'function')
 {
     $prefix = is_in($type, 'function', 'class') ? "{$type} {$data['name']}" : "{$type}{$data['name']}";
     $dc = PhpDocComment::Parse($data['comment']);
     $is_private = starts_with($data['name'], '_') || contains($data['modifiers'], 'private', 'protected') || $dc && $dc->has('private');
     if (!$dc) {
         if (!$is_private) {
             $this->_warn("{$prefix} MISSING DocComment", 'comment');
         }
         return array(false, $is_private);
     }
     if ($dc->hasOne('internal', 'override', 'deprecated', 'shortcut', 'implements')) {
         return array($dc, $is_private);
     }
     if (!$is_private) {
         if (!$dc->ShortDesc) {
             $this->_warn("{$prefix} MISSING ShortDesc", 'short');
         }
         if ($dc->LongDesc === false) {
             $this->_warn("{$prefix} MISSING LongDesc", 'long');
         }
     }
     if ($type == 'class') {
         return array($dc, $is_private);
     }
     if (!$is_private && !$dc->has('return')) {
         $this->_warn("{$prefix} MISSING @return", 'return');
     }
     return array($dc, $is_private);
 }
Пример #2
0
 /**
  * Returns the DocComment for a method(or the class) as object
  * 
  * This is the modern version of <WdfReflector::getCommentString>().
  * @param string $method_name Name of method or false if you want the class comment
  * @return PhpDocComment The DocComment wrapped as PhpDocComment
  */
 public function getCommentObject($method_name = false)
 {
     $comment = $this->_getComment($method_name);
     return PhpDocComment::Parse($comment);
 }