PHP Класс phpDoctor

Показать файл Открыть проект Примеры использования класса

Открытые свойства

Свойство Тип Описание
$_constants boolean Parse out global constants.
$_currentFilename str The path and filename of the current file being parsed.
$_defaultPackage str Package to use for elements not in a package.
$_doclet str Specifies the name of the class that starts the doclet used in generating the documentation.
$_docletPath str Specifies the path to the doclet starting class file. If the doclet class is not in a file named <_doclet>/<_doclet>.php then this path should include the filename of the class file also.
$_files str[] Array of files to parse.
$_formatter str Specifies the name of the text formatter class.
$_formatterPath str Specifies the path to the formatters to use.
$_globals boolean Parse out global variables.
$_ignore str[] Array of files not to parse.
$_ignorePackageTags boolean Ignore any package tags in the source code.
$_options str[] Options from config file.
$_overview str Overview file. The "source" file that contains the overview documentation.
$_packageCommentDir str Package comment directory. if set, PHPDoctor will look in this directory for package comment files. Otherwise it looks in a directory named after the package ala Javadoc.
$_path str The path PHPDoctor is running from.
$_pearCompat boolean Whether or not to use PEAR compatibility mode for first sentence tags.
$_private boolean Parse all classes and members.
$_protected boolean Parse protected and public classes and members.
$_public boolean Parse only public classes and members.
$_quiet boolean Turn off all output other than warnings and errors.
$_sourceIndex
$_sourcePath str Directory containing files for parsing.
$_startTime integer The time in microseconds at the start of execution.
$_subdirs boolean Traverse sub-directories
$_tagletPath str Specifies the path to the taglets to use.
$_tree boolean Display class tree.
$_useClassPathAsPackage boolean Use the filesystem path of the class as the package it should be in.
$_verbose boolean Turn on verbose output.
$_version str The version of PHPDoctor.

Открытые методы

Метод Описание
_buildFileList ( $files, $dir ) Build a complete list of file to parse. Expand out wildcards and traverse directories if asked to.
_getNext ( &$tokens, $key, $whatToGet, $maxDist ) : str Get next token of a certain type from token array
_getPrev ( &$tokens, $key, $whatToGet ) : str Get previous token of a certain type from token array
_getProgramElementName ( &$tokens, $key ) : str Get the next program element name from the token list
_getTime ( ) : integer Get the current time in microseconds.
_hasPrivateName ( $name ) : boolean Does the given element name conform to the format that is used for private elements?
_includeElements ( &$element ) : boolean Is an element private and we are including private elements, or element is protected and we are including protected elements.
_mergeArrays ( $one, $two ) : mixed[] Recursively merge two arrays into a single array. This differs from the PHP function array_merge_recursive as it replaces values with the same index from the first array with items from the second.
_mergeSuperClassData ( &$rootDoc, $parent = NULL )
createTag ( $name, $text, &$data, &$root ) : Tag Create a tag. This method first tries to load a Taglet for the given tag name, upon failing it then tries to load a PHPDoctor specialised tag class (e.g. classes/paramtag.php), if it still has not found a tag class it uses the standard tag class.
defaultPackage ( ) : str Return the default package.
docletPath ( ) : str Return the path PHPDoctor is running from.
error ( $msg ) Write an error message to standard error.
execute ( &$rootDoc ) : boolean Loads and runs the doclet.
fixPath ( $path ) : str Add a trailing slash to a path if it does not have one.
getFormatter ( ) : TextFormatter Creates the formatter and returns it.
getOption ( $option ) : str Get a configuration option.
makeAbsolutePath ( $path, $prefix ) : str Turn path into an absolute path using the given prefix?
message ( $msg ) Write a message to standard output.
options ( ) : str[] Return a reference to the set options.
parse ( ) : RootDoc Parse files into tokens and create rootDoc.
phpDoctor ( $config = 'default.ini' ) Constructor
processDocComment ( $comment, &$root ) : mixed[] Process a doc comment into a doc tag array.
sourcePath ( ) : str Return the source path.
verbose ( $msg ) Write a message to standard output.
version ( ) : str Return the version of PHPDoctor.
warning ( $msg ) Write a warning message to standard error.

Описание методов

_buildFileList() публичный Метод

Build a complete list of file to parse. Expand out wildcards and traverse directories if asked to.
public _buildFileList ( $files, $dir )

_getNext() публичный Метод

Get next token of a certain type from token array
public _getNext ( &$tokens, $key, $whatToGet, $maxDist ) : str
Результат str Value of found token

_getPrev() публичный Метод

Get previous token of a certain type from token array
public _getPrev ( &$tokens, $key, $whatToGet ) : str
Результат str Value of found token

_getProgramElementName() публичный Метод

Get the next program element name from the token list
public _getProgramElementName ( &$tokens, $key ) : str
Результат str

_getTime() публичный Метод

Get the current time in microseconds.
public _getTime ( ) : integer
Результат integer

_hasPrivateName() публичный Метод

Does the given element name conform to the format that is used for private elements?
public _hasPrivateName ( $name ) : boolean
Результат boolean

_includeElements() публичный Метод

Is an element private and we are including private elements, or element is protected and we are including protected elements.
public _includeElements ( &$element ) : boolean
Результат boolean

_mergeArrays() публичный Метод

Recursively merge two arrays into a single array. This differs from the PHP function array_merge_recursive as it replaces values with the same index from the first array with items from the second.
public _mergeArrays ( $one, $two ) : mixed[]
Результат mixed[] Merged array

_mergeSuperClassData() публичный Метод

public _mergeSuperClassData ( &$rootDoc, $parent = NULL )

createTag() публичный Метод

Create a tag. This method first tries to load a Taglet for the given tag name, upon failing it then tries to load a PHPDoctor specialised tag class (e.g. classes/paramtag.php), if it still has not found a tag class it uses the standard tag class.
public createTag ( $name, $text, &$data, &$root ) : Tag
Результат Tag

defaultPackage() публичный Метод

Return the default package.
public defaultPackage ( ) : str
Результат str

docletPath() публичный Метод

Return the path PHPDoctor is running from.
public docletPath ( ) : str
Результат str

error() публичный Метод

Write an error message to standard error.
public error ( $msg )

execute() публичный Метод

Loads and runs the doclet.
public execute ( &$rootDoc ) : boolean
Результат boolean

fixPath() публичный Метод

Add a trailing slash to a path if it does not have one.
public fixPath ( $path ) : str
Результат str

getFormatter() публичный Метод

Creates the formatter and returns it.
public getFormatter ( ) : TextFormatter
Результат TextFormatter

getOption() публичный Метод

Get a configuration option.
public getOption ( $option ) : str
Результат str

makeAbsolutePath() публичный Метод

Turn path into an absolute path using the given prefix?
public makeAbsolutePath ( $path, $prefix ) : str
Результат str

message() публичный Метод

Write a message to standard output.
public message ( $msg )

options() публичный Метод

Return a reference to the set options.
public options ( ) : str[]
Результат str[] An array of strings.

parse() публичный Метод

Parse files into tokens and create rootDoc.
public parse ( ) : RootDoc
Результат RootDoc

phpDoctor() публичный Метод

Constructor
public phpDoctor ( $config = 'default.ini' )

processDocComment() публичный Метод

Process a doc comment into a doc tag array.
public processDocComment ( $comment, &$root ) : mixed[]
Результат mixed[] Array of doc comment data

sourcePath() публичный Метод

Return the source path.
public sourcePath ( ) : str
Результат str

verbose() публичный Метод

Write a message to standard output.
public verbose ( $msg )

version() публичный Метод

Return the version of PHPDoctor.
public version ( ) : str
Результат str

warning() публичный Метод

Write a warning message to standard error.
public warning ( $msg )

Описание свойств

$_constants публичное свойство

Parse out global constants.
public bool $_constants
Результат boolean

$_currentFilename публичное свойство

The path and filename of the current file being parsed.
public str $_currentFilename
Результат str

$_defaultPackage публичное свойство

Package to use for elements not in a package.
public str $_defaultPackage
Результат str

$_doclet публичное свойство

Specifies the name of the class that starts the doclet used in generating the documentation.
public str $_doclet
Результат str

$_docletPath публичное свойство

Specifies the path to the doclet starting class file. If the doclet class is not in a file named <_doclet>/<_doclet>.php then this path should include the filename of the class file also.
public str $_docletPath
Результат str

$_files публичное свойство

Array of files to parse.
public str[] $_files
Результат str[]

$_formatter публичное свойство

Specifies the name of the text formatter class.
public str $_formatter
Результат str

$_formatterPath публичное свойство

Specifies the path to the formatters to use.
public str $_formatterPath
Результат str

$_globals публичное свойство

Parse out global variables.
public bool $_globals
Результат boolean

$_ignore публичное свойство

Array of files not to parse.
public str[] $_ignore
Результат str[]

$_ignorePackageTags публичное свойство

Ignore any package tags in the source code.
public bool $_ignorePackageTags
Результат boolean

$_options публичное свойство

Options from config file.
public str[] $_options
Результат str[]

$_overview публичное свойство

Overview file. The "source" file that contains the overview documentation.
public str $_overview
Результат str

$_packageCommentDir публичное свойство

Package comment directory. if set, PHPDoctor will look in this directory for package comment files. Otherwise it looks in a directory named after the package ala Javadoc.
public str $_packageCommentDir
Результат str

$_path публичное свойство

The path PHPDoctor is running from.
public str $_path
Результат str

$_pearCompat публичное свойство

Whether or not to use PEAR compatibility mode for first sentence tags.
public bool $_pearCompat
Результат boolean

$_private публичное свойство

Parse all classes and members.
public bool $_private
Результат boolean

$_protected публичное свойство

Parse protected and public classes and members.
public bool $_protected
Результат boolean

$_public публичное свойство

Parse only public classes and members.
public bool $_public
Результат boolean

$_quiet публичное свойство

Turn off all output other than warnings and errors.
public bool $_quiet
Результат boolean

$_sourceIndex публичное свойство

public $_sourceIndex

$_sourcePath публичное свойство

Directory containing files for parsing.
public str $_sourcePath
Результат str

$_startTime публичное свойство

The time in microseconds at the start of execution.
public int $_startTime
Результат integer

$_subdirs публичное свойство

Traverse sub-directories
public bool $_subdirs
Результат boolean

$_tagletPath публичное свойство

Specifies the path to the taglets to use.
public str $_tagletPath
Результат str

$_tree публичное свойство

Display class tree.
public bool $_tree
Результат boolean

$_useClassPathAsPackage публичное свойство

Use the filesystem path of the class as the package it should be in.
public bool $_useClassPathAsPackage
Результат boolean

$_verbose публичное свойство

Turn on verbose output.
public bool $_verbose
Результат boolean

$_version публичное свойство

The version of PHPDoctor.
public str $_version
Результат str