PHP 有所謂的 Magic Method ( 不是魔術喔) , 例如 __get() , __call() 這類的就是叫 magic method , 使用這類的 magic method 雖然很方便 , 但使用 IDE 之類的編輯器無法做出自動完成 , 反而程式越大的時候越搞不清楚這個物件中有那些屬性或方法

最近有去喵一下 phpDoc 官網 , 原來版本已經到了 1.4 了 , 而 1.4 版就針對了 magic method 提出了兩個新 tag 分別為 @property 及@method

@property 主要是對應 __get() 及 __set() 的文件說明 ,  而另外還有 @property-read 及 @property-write

@method 就是對應到 __call() 的文件說明

這兩種 tag 屬性在官方網站的範例一看就知道怎麼用 , 連結如下

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

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

ok . 到這裡雖然看起來很不錯 , 但現在的 IDE 有沒有支援 ??

我目前手上的 Zend Studio 6.1.2 是不支援的 , 但 Netbeans 最新版已經支援到 @property 了 , 有圖有真相

但很可惜 , Netbeans 經過測試還不支援 @method

不過我相信日後 Zend Studio 或 Netbeans 會去支援 , 這樣寫起 PHP 起來就更方便瞭