PHPプログラマ関数注釈仕様(守ってください)

1160 ワード

以前は私も注釈を书きたくなかったが、2ヶ月后に自分が何を书いているのか分からないことに気づいた.
宇宙の発展のために、二次開発の便利さのために、コードの可読性のために、注釈を書くことをお勧めします.
<?php
/**
* @name   
* @abstract     / /  
* @access       、 、  /       
* @author             
* @category    packages
* @copyright       
* @const     
* @deprecate              MyEclipse    
* @example   
* @exclude              ,       
* @final           、  、  ,    、  。
* @global               
* @include           
* @link       
* @module          
* @modulegroup         
* @package          
* @param              
* @return              
* @see          、  ,          。
* @since    api                 
* @static     、 、      。
* @throws               ,       
* @todo               
* @var       /  。
* @version       
*/
function XXX($a){...}