PHP annotation Standard

Source: Internet
Author: User
Tags deprecated
/*** @name name * @abstract DECLARE variable/class/method * @access indicate access rights for this variable, class, Function/method * @author function Author's name and email address * @category Organization packages* @copyright indicate Copyright information * @const Indicate constants * @deprecate indicate deprecated or deprecated information * @example Example * @exclude indicates that the current comment will not be parsed and does not appear in the text block * @final indicate that this is a final class, method, property, prohibit derivation, Modify.  * @global indicate the global variable referenced in this function * @include indicate the information contained in the file * @link define an online connection * @module define the module information for attribution * @modulegroup define the attribution of the module group * @package Define the ownership of the package information * @param define the parameter information for a function or method * @return Define the return information of a function or method * @see define the function, variable, and add the corresponding super-connection. * @since indicates which version of the API function or method was introduced from * @static indicates that variables, classes, functions are static. * @throws indicate the error exception that may be thrown by this function, the very occurrence of the condition * @todo indicate where it should be improved or not implemented * @var define the description variable/property. * @version Define version information */

Transfer from----http://www.akii.org/note-the-standard-php-syntax.html

The use of a document tag is a keyword, or other document tag, that the tag can be used to decorate.
All document tags begin with a * after each line. If the mark of @ is out of the middle of a paragraph, the tag will be ignored as normal content.
@access
Scope of Use: Class,function,var,define,module
The tag is used to indicate access rights for the keyword: private, public, or proteced
@author
Specify the author
@copyright
Scope of Use: Class,function,var,define,module,use
Specify copyright information
@deprecated
Scope of Use: Class,function,var,define,module,constent,global,include
Identify unused or deprecated keywords
@example
This tag is used to parse the contents of a file and highlight them. Phpdoc will attempt to read the file contents from the file path that the token gives
@const
Scope of Use: Define
Constants used to indicate define in PHP
@final
Scope of Use: Class,function,var
Indicates that the keyword is a final class, method, property, prohibit derivation, modification.
@filesource
Similar to example, except that the tag directly reads and displays the contents of the currently parsed PHP file.
@global
Indicates the global variable referenced in this function
@ingore
Used to omit the specified keyword from the document
@license
Equivalent to the HTML tag, first the URL, followed by the content to be displayed
For example [url=http://bbs.phpchina.com/"http://www.jigwang.com"]php those things [/url]
You can write @license http://www.jigwang.com php stuff.
@link
Similar to license
But you can also refer to any one of the keywords in the document by using link
@name
Specifies an alias for the keyword.
@package
Scope of Use: page-level, define,function,include
Class-Level->class,var,methods
Used to logically divide one or several keywords into a group.
@abstrcut
Indicates that the current class is an abstract class
@param
Indicates the parameters of a function
@return
Indicates that the return of a method or function refers to the
@static
Indicates that the off-build word is static.
@var
Indicate variable type
@version
Specifying version information
@todo
Identify areas that should be improved or not implemented
@throws
Indicates that this function may throw an error exception, which can occur in extreme cases
As mentioned above, ordinary document tag tags must be at the beginning of each line at the @ mark, in addition, there is a tag called inline tag, with {@}, including the following:
{@link}
Usage with @link
{@source}
Show the contents of a function or method

  • Related Article

    Contact Us

    The content source of this page is from Internet, which doesn't represent Alibaba Cloud's opinion; products and services mentioned on that page don't have any relationship with Alibaba Cloud. If the content of the page makes you feel confusing, please write us an email, we will handle the problem within 5 days after receiving your email.

    If you find any instances of plagiarism from the community, please send an email to: info-contact@alibabacloud.com and provide relevant evidence. A staff member will contact you within 5 working days.

    A Free Trial That Lets You Build Big!

    Start building with 50+ products and up to 12 months usage for Elastic Compute Service

    • Sales Support

      1 on 1 presale consultation

    • After-Sales Support

      24/7 Technical Support 6 Free Tickets per Quarter Faster Response

    • Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.