phpDocumentor

Version2
in package
implements ConfigurationInterface, Upgradable

Interfaces, Classes and Traits

ConfigurationInterface
Upgradable

Table of Contents

$defaultTemplateName  : string
__construct()  : mixed
getConfigTreeBuilder()  : TreeBuilder
upgrade()  : array<string|int, mixed>
Upgrades the version 2 configuration to the version 3 configuration.
convertSingleStarPathEndingIntoGlobPattern()  : string
Make a `/*` ending backwards compatible for v2.

Properties

$defaultTemplateName

private string $defaultTemplateName

Methods

__construct()

public __construct(string $defaultTemplateName) : mixed
Parameters
$defaultTemplateName : string
Return values
mixed

getConfigTreeBuilder()

public getConfigTreeBuilder() : TreeBuilder
Return values
TreeBuilder

upgrade()

Upgrades the version 2 configuration to the version 3 configuration.

public upgrade(array<string|int, mixed> $values) : array<string|int, mixed>
Parameters
$values : array<string|int, mixed>
Tags
todo

not all options are included yet; finish this

Return values
array<string|int, mixed>

convertSingleStarPathEndingIntoGlobPattern()

Make a `/*` ending backwards compatible for v2.

private convertSingleStarPathEndingIntoGlobPattern(string $path) : string

In phpDocumentor 3 we started adopting the glob pattern with globstar extension to properly define patterns matching file paths. This is incompatible with phpDocumentor 2, that interpreted a * to mean any number of characters, including the path separator.

To ensure this behaviour is properly translated, this method will detect if a path ends with /*, and if it is not a globstar pattern, we convert it to one. This matches the behaviour in phpDocumentor 2 without user interaction.

Parameters
$path : string
Tags
link
https://www.gnu.org/software/bash/manual/html_node/Pattern-Matching.html
Return values
string

Search results