phpDocumentor

@license

The @license tag is used to indicate which license is applicable for the associated Structural Elements .

Syntax

@license [<url>] [name]

Description

The @license tag provides the user with the name and URL of the license that is applicable to a Structural Element and any of its child elements.

It is RECOMMENDED to apply @license tags ONLY to file-level PHPDocs, to prevent confusion over which license applies to any particular Structural Element .

Whenever multiple licenses apply, there MUST be one @license tag per applicable license.

Effects in phpDocumentor

Structural Elements tagged with the @license tag will show a link to the given license in case a URL is provided or the name is one of the following license names:

  • GPL, or GNU General Public License, version 2
  • GPL, or GNU General Public License, version 3
  • LGPL, or GNU (Library|Lesser) General Public License, version 3
  • BSD
  • FreeBSD
  • MIT

phpDocumentor supports several permutations of the names above and it is RECOMMENDED to try out the form that you desire.

Examples

<?php
/**
 * @license GPL
 *
 * @license https://opensource.org/licenses/gpl-license.php GNU Public License
 */

Search results