PHPDoc用于可变长度的参数数组

发布时间:2022-04-30 发布网站:脚本宝典
脚本宝典收集整理的这篇文章主要介绍了PHPDoc用于可变长度的参数数组脚本宝典觉得挺不错的,现在分享给大家,也给大家做个参考。
是否有用于记录功能的语法,该函数采用单个配置数组,而不是单个参数?

我正在考虑使用类似于以下机制的CodeignITer样式库:

<?PHP

//
// Library deFinition
//

class MyLibrary {
  VAR $foo;
  var $bar;
  var $baz;
  // ... and many more vars...


  /* Following is how CodeIgniter Documents their built-in libraries,* which is mostly useless.  AFaiK they should be sPEcifying a name
   * and description for their @param (which they don't) and omitting
   * @return for constructors 
   */

  /** 
   * @access public
   * @param array
   * @return void
   */
  function MyLibrary($config = array()) {
    foreach ($config as $key => $value) {
      $this->$key = $value;
    }
  }
}

//
// Library usage:
//

// Iniitialize our configuration parameters
$config['foo'] = 'test';
$config['bar'] = 4;
$config['baz'] = array('x','y','z');

$x = new MyLibrary($config);

?>

所以我的问题是,有没有一些限制的方式记录配置数组,而不仅仅是纯文本描述?实际指定一个适当的@param [type] [name] [desc],允许PHPDoc解析出有用的值?

除此之外,CodeIgniter真的只是覆盖那些通过$config数组传入的值,它们有效地允许你隐藏私有成员.我不是粉丝,但我被困住了.

我从来没有看到任何“好”的记录方式 – 我从来没有看到IDE可以使用的任何东西(如Eclipse PDT),参数暗示:-(

我会说“像你的框架一样”,但正如你所说,这里做的不够好,

可能一个快速/排序列表可能的键可能比没有更好,但是;有点像这样:

@param array $config [key1=>int,otherKey=>string]

知道如何解释PHPDocumentor或IDE …但可能值得一试?

这是BTw,为什么我倾向于避免这种传递参数的方法一个原因 – 至少当方法没有太多(可选)参数时.

脚本宝典总结

以上是脚本宝典为你收集整理的PHPDoc用于可变长度的参数数组全部内容,希望文章能够帮你解决PHPDoc用于可变长度的参数数组所遇到的问题。

如果觉得脚本宝典网站内容还不错,欢迎将脚本宝典推荐好友。

本图文内容来源于网友网络收集整理提供,作为学习参考使用,版权属于原作者。
如您有任何意见或建议可联系处理。小编QQ:384754419,请注明来意。