Есть пара вопросов по phpDoc

[ekkl]

В общем в начале класса есть описание магического метода

/** * @method Xform text(string $name, string $value = null, mixed $attribules = array()) Создает текстовое поле *  */

Как добавить описание для параметров функции. На сайте ничего не нашел

http://manual.phpdoc.org/HTMLSmartyConverter/PHP/phpDocumentor/tutorial_tags.method.pkg.html

В редакторе Netbeans 8.0 это выглядит так

text  Создает текстовое поле Параметры: string $name Не удалось найти PHPDoc string $value = null mixed $attribules = array()

[npofopr]

Как это к верстке то относится?

[wwt]

В общем в начале класса есть описание магического метода

/** * @method Xform text(string $name, string $value = null, mixed $attribules = array()) Создает текстовое поле *  */

Как добавить описание для параметров функции. На сайте ничего не нашел

http://manual.phpdoc.org/HTMLSmartyConverter/PHP/phpDocumentor/tutorial_tags.method.pkg.html

В редакторе Netbeans 8.0 это выглядит так

text  Создает текстовое поле Параметры: string $name Не удалось найти PHPDoc string $value = null mixed $attribules = array()

/** * Создает текстовое поле * @param string $name * @param string $value * @param mixed $attribules * @return mixed  */

@param http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.param.pkg.html

@return http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.return.pkg.html

Edited March 7, 2014 by wwt

[ekkl]

Как это к верстке то относится?

К самой верстке никак. Если не в том разделе, прошу прощения.

wwt, нет, не проходит. Предложенное вами объявления для явных функций, а функция создания текстовго поля вызыввается через __call()

Edited March 7, 2014 by ekkl

[wwt]

__call()

 

функционал создания находится в теле метода  __call ? Что-то сомневаюсь. Скорее там что-то типо:

function __call($method_name, array $params){   $object = new Field;//как пример   if(method_exists($object, $method_name )){      return $object->$method_name($params);   }else{      return false;   }}

Вообще @method предназначен для документирования магических методов которые реализованы через __call() при этом вам никто не мешает вынести сам функционал из __call() в приватный метод и задокументировать его.

что-то типо:

/*** @method Xform text(string $name, string $value = null, mixed $attribules = array()) Создает текстовое поле**/function __call($method_name, array $params){   if($method_name == 'text' && count($params) == 3){      return $this->_text($params[0], $params[1], $params[2]);   }else{      return false;   }}/*** Создает текстовое поле* @param string $name* @param string $value* @param mixed $attribules* @return boolean*/private function _text($name, $value = null, $attribules = array()){}

Edited March 7, 2014 by wwt

[ekkl]

 /**     *      * @param string имя поля или параметра     * @param array Параметры      * @return $this     */    public function __call($type, $args)    {        $name = $args[0];        $value = isset($args[1]) ? $args[1] : null;        $param = isset($args[2]) ? $args[2] : array();        // Это поле, или устанавливается параметр?        if (in_array($type, ['text', 'hidden', 'password', 'file', 'textarea', 'submit', 'checkbox', 'email']))        {            // Создаем новое поле            $this->new_field($type, $name, $value, $param);        }        else        {            // Устанавливаем параметр для текущего поля            $this->set_param($type, $name);        }                return $this;    }

nef_field() создает не только поля, но и списки, флажки, кнопки и т.д.

[wwt]

 

// Это поле, или устанавливается параметр?

public function __call($type, $args)

 

$type - имя вызываемого метода

$args - переданные в него параметры

$this->new_field($type, $name, $value, $param);

Метод класса через который создаются элементы формы, а селекты и тд тоже элементы формы. Если вы не заметили все передаваемые в него параметры статичны. Теперь можете проанализировать работу данного метода. В параметры добавляется только 1 параметр(первый $type) это тип поля, который определяется с помощью названия вызываемого метода.