Điều này cho phép các nhà phát triển để xác định tác giả của một tập tin, thông tin giấy phép cho một lớp học, thông tin tài sản hoặc các phương pháp, và hữu ích khác. Các thẻ được sử dụng phổ biến nhất sau: @ tác giả: Tác giả của phần tử hiện hành (có thể là một lớp học, tập tin, phương pháp, hoặc bit bất kỳ của mã) được liệt kê bằng cách sử dụng thẻ này. | CHAPTER 3 OBJECT-ORIENTED PROGRAMMING The real power of DocBlocks comes with the ability to use tags which start with an at symbol @ immediately followed by the tag name and the value of the tag. These allow developers to define authors of a file the license for a class the property or method information and other useful information. The most common tags used follow @author The author of the current element which might be a class file method or any bit of code are listed using this tag. Multiple author tags can be used in the same DocBlock if more than one author is credited. The format for the author name is John Doe . copyright This signifies the copyright year and name of the copyright holder for the current element. The format is 2010 Copyright Holder. @license This links to the license for the current element. The format for the license information is http path to License Name. @var This holds the type and description of a variable or class property. The format is type element description. @param This tag shows the type and description of a function or method parameter. The format is type element_name element description. @return The type and description of the return value of a function or method are provided in this tag. The format is type return element description. A sample class commented with DocBlocks might look like this php A simple class This is the long description for this class which can span as many lines as needed. It is not required whereas the short description is necessary. It can also span multiple paragraphs if the description merits that much verbiage. @author Jason Lengstorf copyright 2010 Ennui Design @license http license PHP License class SimpleClass A public variable @var string stores data for the class public foo 111 CHAPTER 3 OBJECT-ORIENTED PROGRAMMING Sets foo to a new value upon class instantiation @param string val a value .
