你有幾個選項來幫助自己,而無需等待任何插件:
- 學習並記住;)
- 所有可用的選項擴展您的PHPDoc的塊:
示例(說實話,我不知道Eclipse是否支持phpDoc中的html,甚至不知道@param中的變量名稱後面的文本,但它在Netbeans中正常工作):
/**
* [...]
* @param string $type Can be: <ul><li>DateTextBox</li><li>ValidationTextBox</li></ul>
* @param string $name Whatever
* @param array|Zend_Config $options Array with following keys: <ul><li>require</li><li>invalidMessage</li></ul>
* @return Zend_Form_Element
*/
public function createElement($type, $name, $options = null)
例子:
class My_Zend_Form_Element extends Zend_Form_Element
{
public function createDateTextBox($name, $options = null)
{
return $this->createElement('DateTextBox', $name, $options);
}
}
- 聲明一些很好命名的常量和PHPDoc的
提供一些線索
例子:(類型ZFE_OPTIONS和IDE應該表現出一絲的一些常量數組鍵使用)
/**
* Can be true or false
*/
define('ZFE_OPTIONS_REQUIRE','require');
例子:
class ZFE_Options
{
protected $opts = array();
/**
* @param bool $req
* @return ZFE_Options
*/
public function setRequired($req){
$this->opts['require'] = (bool)$req;
return $this;
}
/**
* @param string $txt
* @return ZFE_Options
*/
public function setInvalidMessage($txt){
$this->opts['invalidMessage'] = (string)$txt;
return $this;
}
/**
* @return array
*/
public function toArray(){
return $this->opts;
}
}
$zfe_options = new ZFE_Options();
$opts = $zfe_options
->setRequired(true)
->setInvalidMessage('Please provide valid email address')
->toArray();
覆蓋ZF的DocBlocks毫無意義,因爲每次更新庫時都會丟失更改。剩下的感覺對我來說很臃腫,尤其是常數方法。 – Gordon 2010-09-15 21:05:36
當更新庫時,這可能會導致函數參數發生變化,所以在新版本中小心是很自然的;)。我也不喜歡常量,但它們有兩個主要優點:可以隨處使用,並且可以自動完成。 http://www.php.net/manual/en/function.curl-setopt.php激勵我使用它們 – 2010-09-15 21:43:18