From 7623226764f8dcf8da59ce0f49ff869ab88cf1fc Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Wed, 17 Jan 2024 17:41:58 +0300 Subject: [PATCH 01/32] Disable throws output --- .../PhpClassToMd/templates/_method_details.md.twig | 13 ------------- 1 file changed, 13 deletions(-) diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_method_details.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_method_details.md.twig index ce1a5da2..722cbbe9 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_method_details.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_method_details.md.twig @@ -59,19 +59,6 @@ {% endif %} {% endif %} -{% if methodEntity.hasThrows() %} - -Throws: - -{% endif %} - {% if methodEntity.hasDescriptionLinks() %} See: From 9163a7bcd37b0c80479e0cc273a59c9b82f70eab Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Thu, 18 Jan 2024 13:39:30 +0300 Subject: [PATCH 02/32] Adding new API methods --- .../ClassConstant/ClassConstantEntity.php | 67 +++++++++++++++++-- 1 file changed, 63 insertions(+), 4 deletions(-) diff --git a/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php b/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php index 59e2a776..311857d3 100644 --- a/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php +++ b/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php @@ -15,6 +15,7 @@ use BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\NodeValueCompiler; use PhpParser\ConstExprEvaluationException; use PhpParser\Node\Stmt\ClassConst; +use PhpParser\PrettyPrinter\Standard; use Psr\Log\LoggerInterface; /** @@ -53,12 +54,12 @@ class ClassConstantEntity extends BaseEntity public function __construct( Configuration $configuration, - private ClassLikeEntity $classEntity, + private readonly ClassLikeEntity $classEntity, ParserHelper $parserHelper, LocalObjectCache $localObjectCache, - LoggerInterface $logger, - private string $constantName, - private string $implementingClassName, + private readonly LoggerInterface $logger, + private readonly string $constantName, + private readonly string $implementingClassName, ) { parent::__construct( $configuration, @@ -158,6 +159,64 @@ public function getNamespaceName(): string return $this->getRootEntity()->getNamespaceName(); } + /** + * Get a text representation of class constant modifiers + * + * @api + * + * @throws InvalidConfigurationParameterException + */ + #[CacheableMethod] public function getModifiersString(): string + { + $modifiersString = []; + if ($this->isPrivate()) { + $modifiersString[] = 'private'; + } elseif ($this->isProtected()) { + $modifiersString[] = 'protected'; + } elseif ($this->isPublic()) { + $modifiersString[] = 'public'; + } + + $modifiersString[] = $this->getType(); + return implode(' ', $modifiersString); + } + + /** + * Get current class constant type + * + * @api + * + * @throws InvalidConfigurationParameterException + */ + #[CacheableMethod] public function getType(): string + { + $type = $this->getAst()->type; + if ($type) { + $astPrinter = new Standard(); + $typeString = $astPrinter->prettyPrint([$type]); + $typeString = str_replace('?', 'null|', $typeString); + } else { + try { + $typeString = gettype($this->getValue()); + } catch (\Exception) { + $typeString = 'mixed'; + $docBlock = $this->getDocBlock(); + $typesFromDoc = []; + foreach ($docBlock->getTagsByName('var') as $param) { + try { + $typesFromDoc[] = (string)$param->getType(); + } catch (\Exception $e) { + $this->logger->error($e->getMessage()); + } + } + if ($typesFromDoc) { + $typeString = implode('|', $typesFromDoc); + } + } + } + return $this->prepareTypeString($typeString); + } + /** * Check if a constant is a public constant * From 6faa28f324147513a45c583ca5274bf3c0a2b37d Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Thu, 18 Jan 2024 13:39:53 +0300 Subject: [PATCH 03/32] Updating templates --- .../templates/_classHeader.md.twig | 4 +- .../templates/_classMainInfo.md.twig | 24 +++--- .../PhpClassToMd/templates/_constants.md.twig | 18 ++--- .../PhpClassToMd/templates/_enumCases.md.twig | 11 ++- .../templates/_method_details.md.twig | 73 +++++-------------- .../PhpClassToMd/templates/_methods.md.twig | 10 +-- .../templates/_properties.md.twig | 13 ++-- .../templates/_property_details.md.twig | 24 +++--- .../PhpClassToMd/templates/_traits.md.twig | 11 ++- .../PhpClassToMd/templates/class.md.twig | 18 +---- 10 files changed, 65 insertions(+), 141 deletions(-) diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_classHeader.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_classHeader.md.twig index c6ec5b81..7d2dbf99 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_classHeader.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_classHeader.md.twig @@ -1,3 +1 @@ -

- {{ classEntity.getShortName() }} {% if classEntity.isEnum() %}enum{% else %}class{% endif %}: -

\ No newline at end of file +# [{{ classEntity.getShortName() }}]({{ classEntity.getFileSourceLink() }}) {% if classEntity.isEnum() %}enum{% else %}class{% endif %}: \ No newline at end of file diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_classMainInfo.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_classMainInfo.md.twig index 30e6a61f..78163c63 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_classMainInfo.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_classMainInfo.md.twig @@ -1,5 +1,5 @@ -{% if classEntity.isInternal() %}:warning: Is internal{% endif %} -{% if classEntity.isDeprecated() %}:no_entry: Deprecated{% endif %} +{% if classEntity.isInternal() %}⚠️ Internal {% endif %} +{% if classEntity.isDeprecated() %}⛔ Deprecated{% endif %} ```php {% if classEntity.getNamespaceName() %} @@ -9,29 +9,23 @@ namespace {{ classEntity.getNamespaceName() }}; {{ classEntity.getModifiersString() }} {{ classEntity.getShortName() }}{% if classEntity.isInterface() and classEntity.getInterfaceNames() %} extends \{{ classEntity.getInterfaceNames() | implode(', \\') }}{% else %}{% if classEntity.getParentClassName() %} extends \{{ classEntity.getParentClassName() }}{% endif %}{% if classEntity.getInterfaceNames() %} implements \{{ classEntity.getInterfaceNames() | implode(', \\') }}{% endif %}{% endif %} ``` - -{% if classEntity.getDescription() %}
{{ classEntity.getDescription() | raw }}
{% endif %} - +{% if classEntity.getDescription() %} +{{ classEntity.getDescription() | raw }} +{% endif %} {% if classEntity.hasDescriptionLinks() %} -See: -
    +***Links:*** {% for link in classEntity.getDescriptionLinks() %} -
  • - {{ link.name }}{% if link.description %} - {{ link.description | removeLineBrakes }} {% endif %} -
  • +- {% if link.url %}[{{ link.name }}]({{ link.url }}){% else %}{{ link.name }}{% endif %}{% if link.description %} - {{ link.description | removeLineBrakes }} {% endif %} + {% endfor %} -
{% endif %} {% if classEntity.hasExamples() %} - -Examples of using: +***Examples of using:*** {% for exampleData in classEntity.getExamples() %} - ```php {{ exampleData.example | raw }} - ``` {% endfor %} {% endif %} \ No newline at end of file diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_constants.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_constants.md.twig index 4229f14c..c3307f59 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_constants.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_constants.md.twig @@ -1,12 +1,8 @@ -{% if not classEntity.getConstantEntitiesCollection().isEmpty() %} -

Constants:

-
    - {% for constantEntity in classEntity.getConstantEntitiesCollection() %} -
  • # - {{ constantEntity.getName() }} {% if constantEntity.isInternal() %}:warning: Is internal {% endif %} {% if constantEntity.isDeprecated() %}:no_entry: Deprecated {% endif %} {% if constantEntity.getRelativeFileName() %} - | source - code {% endif %}
  • - {% endfor %} -
+{% if not classEntity.getPropertyEntitiesCollection().isEmpty() %} +## Constants: + +{% for constantEntity in classEntity.getConstantEntitiesCollection() %} +1. {{ constantEntity.getModifiersString() }} {% if constantEntity.isDeprecated() %}~~`{{ constantEntity.getName() }}`~~{% else %}`{{ constantEntity.getName() }}`{% endif %} {% if constantEntity.getDescription() %}- {{ constantEntity.getDescription() | removeLineBrakes | raw }}{% endif %} + +{% endfor %} {% endif %} \ No newline at end of file diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_enumCases.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_enumCases.md.twig index 33a20242..5711ba09 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_enumCases.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_enumCases.md.twig @@ -1,9 +1,8 @@ {% if classEntity.getCasesNames() %} -

Cases:

+## Cases: -
    - {% for caseName in classEntity.getCasesNames() %} -
  • {{ caseName }}
  • - {% endfor %} -
+{% for caseName in classEntity.getCasesNames() %} +1. **{{ caseName }}** + +{% endfor %} {% endif %} \ No newline at end of file diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_method_details.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_method_details.md.twig index 722cbbe9..6de0c1c5 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_method_details.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_method_details.md.twig @@ -1,15 +1,8 @@ {% if not methodEntitiesCollection.isEmpty() %} -

Method details:

- +## Methods details: {% for methodEntity in methodEntitiesCollection %} -
-
    -
  • # - {{ methodEntity.getName() }} - {% if methodEntity.isInternal() %}:warning: Is internal {% endif %} {% if methodEntity.isDeprecated() %}:no_entry: Deprecated {% endif %} - {% if methodEntity.getFileSourceLink() %} | source code{% endif %}
  • -
+# `{{ methodEntity.getName() }}` {% if methodEntity.isInternal() %}⚠️ Internal {% endif %} {% if methodEntity.isDeprecated() %}⛔ Deprecated {% endif %}{% if methodEntity.getFileSourceLink() %}**|** [source code]({{ methodEntity.getFileSourceLink() }}){% endif %} ```php {% if methodEntity.isImplementedInParentClass() %} @@ -22,67 +15,41 @@ {% endif %} {{ methodEntity.getModifiersString() | raw }} {{ methodEntity.getName() }}({{ methodEntity.getParametersString() | raw }}){% if not methodEntity.isConstructor() %}: {{ methodEntity.getReturnType() | raw }}{% endif %}; ``` - -{% if methodEntity.getDescription() %}
{{ methodEntity.getDescription() }}
{% endif %} - - +{% if methodEntity.getDescription() %} +{{ methodEntity.getDescription() | raw }} +{% endif %} {% if methodEntity.getParameters() %} -Parameters: - - - - - - - - - - {% for parameter in methodEntity.getParameters() %} - - - - - - {% endfor %} - -
NameTypeDescription
${{ parameter.name }}{% if parameter.isVariadic %} (variadic){% endif %}{{ parameter.expectedType | strTypeToUrl(methodEntity.getRootEntityCollection()) }}{% if parameter.description %}{{ parameter.description | addIndentFromLeft(1, true) }}{% else %}-{% endif %}
-{% else %} -Parameters: not specified -{% endif %} +***Parameters:*** -{% if not methodEntity.isConstructor() %} -{% if methodEntity.getReturnType() %} -Return value: {{ methodEntity.getReturnType() | strTypeToUrl(methodEntity.getRootEntityCollection()) }} -{% else %} -Return value: not specified -{% endif %} +| Name | Type | Description | +|:-|:-|:-| +{% for parameter in methodEntity.getParameters() %} +${{ parameter.name }}{% if parameter.isVariadic %} (variadic){% endif %} | {{ parameter.expectedType | strTypeToUrl(methodEntity.getRootEntityCollection(), false, false, ' \\| ') }} | {% if parameter.description %}{{ parameter.description | addIndentFromLeft(1, true) }}{% else %}-{% endif %} | +{% endfor %} {% endif %} +{% if not methodEntity.isConstructor() and methodEntity.getReturnType() %} +***Return value:*** {{ methodEntity.getReturnType() | strTypeToUrl(methodEntity.getRootEntityCollection()) }} +{% endif %} {% if methodEntity.hasDescriptionLinks() %} -See: -
    +***Links:*** {% for link in methodEntity.getDescriptionLinks() %} -
  • - {{ link.name }}{% if link.description %} - {{ link.description | removeLineBrakes }} {% endif %} -
  • +- {% if link.url %}[{{ link.name }}]({{ link.url }}){% else %}{{ link.name }}{% endif %}{% if link.description %} - {{ link.description | removeLineBrakes }} {% endif %} + {% endfor %} -
{% endif %} {% if methodEntity.hasExamples() %} - -Examples of using: - +***Examples of using:*** {% for exampleData in methodEntity.getExamples() %} ```php {{ exampleData.example | raw }} ``` - {% endfor %} {% endif %} -
-
+ +--- {% endfor %} {% endif %} \ No newline at end of file diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_methods.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_methods.md.twig index aba10500..a691f247 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_methods.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_methods.md.twig @@ -1,12 +1,8 @@ {% if not methodEntitiesCollection.isEmpty() %} -

{{ blockName }}:

+## {{ blockName }} -
    {% for methodEntity in methodEntitiesCollection %} -
  1. - {% if methodEntity.isDeprecated() %}{{ methodEntity.getName() }}{% else %}{{ methodEntity.getName() }}{% endif %} - {% if methodEntity.getDescription() %}- {{ methodEntity.getDescription() | removeLineBrakes | raw }}{% endif %} -
  2. +1. [{% if methodEntity.isDeprecated() %}~~{{ methodEntity.getName() }}~~{% else %}{{ methodEntity.getName() }}{% endif %}](#m{{ methodEntity.getName() | prepareSourceLink }}) {% if methodEntity.getDescription() %}- {{ methodEntity.getDescription() | removeLineBrakes | raw }}{% endif %} + {% endfor %} -
{% endif %} \ No newline at end of file diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_properties.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_properties.md.twig index 50cee9ca..397df1ad 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_properties.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_properties.md.twig @@ -1,11 +1,8 @@ {% if not classEntity.getPropertyEntitiesCollection().isEmpty() %} -

Properties:

+## Properties: -
    - {% for propertyEntity in classEntity.getPropertyEntitiesCollection() %} -
  1. - {{ propertyEntity.getName() }} {% if propertyEntity.getDescription() %}- - {{ propertyEntity.getDescription() | removeLineBrakes }}{% endif %}
  2. - {% endfor %} -
+{% for propertyEntity in classEntity.getPropertyEntitiesCollection() %} +1. [{% if propertyEntity.isDeprecated() %}~~{{ propertyEntity.getName() }}~~{% else %}{{ propertyEntity.getName() }}{% endif %}](#p{{ propertyEntity.getName() | prepareSourceLink }}) {% if propertyEntity.getDescription() %}- {{ propertyEntity.getDescription() | removeLineBrakes | raw }}{% endif %} + +{% endfor %} {% endif %} \ No newline at end of file diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_property_details.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_property_details.md.twig index 2ad9272a..a64ebaec 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_property_details.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_property_details.md.twig @@ -1,12 +1,8 @@ {% if not classEntity.getPropertyEntitiesCollection().isEmpty() %} -

Property details:

- +## Properties details: {% for propertyEntity in classEntity.getPropertyEntitiesCollection() %} -* # - ${{ propertyEntity.getName() }} - {% if propertyEntity.isInternal() %}:warning: Is internal {% endif %} {% if propertyEntity.isDeprecated() %}:no_entry: Deprecated {% endif %} - {% if propertyEntity.getFileSourceLink() %} **|** source code{% endif %} +# `{{ propertyEntity.getName() }}` {% if propertyEntity.isInternal() %}⚠️ Internal {% endif %} {% if propertyEntity.isDeprecated() %}⛔ Deprecated {% endif %}{% if propertyEntity.getFileSourceLink() %}**|** [source code]({{ propertyEntity.getFileSourceLink() }}){% endif %} ```php {% if propertyEntity.isImplementedInParentClass() %} @@ -16,20 +12,18 @@ {{ propertyEntity.getModifiersString() }} ${{ propertyEntity.getName() }}; ``` - -{% if propertyEntity.getDescription() %}
{{ propertyEntity.getDescription() }}
{% endif %} - +{% if propertyEntity.getDescription() %} +{{ propertyEntity.getDescription() | raw }} +{% endif %} {% if propertyEntity.hasDescriptionLinks() %} -See: -
    +***Links:*** {% for link in propertyEntity.getDescriptionLinks() %} -
  • - {{ link.name }}{% if link.description %} - {{ link.description | removeLineBrakes }} {% endif %} -
  • +- {% if link.url %}[{{ link.name }}]({{ link.url }}){% else %}{{ link.name }}{% endif %}{% if link.description %} - {{ link.description | removeLineBrakes }} {% endif %} + {% endfor %} -
{% endif %} +--- {% endfor %} {% endif %} \ No newline at end of file diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_traits.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_traits.md.twig index 332310a1..e9d1decb 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_traits.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_traits.md.twig @@ -1,9 +1,8 @@ {% if classEntity.hasTraits() %} -

Traits:

+## Traits: -
    - {% for traitName in classEntity.getTraitsNames() %} -
  • {{ traitName | strTypeToUrl(classEntity.getRootEntityCollection()) }}
  • - {% endfor %} -
+{% for traitName in classEntity.getTraitsNames() %} +1. {{ traitName | strTypeToUrl(classEntity.getRootEntityCollection()) }} + +{% endfor %} {% endif %} \ No newline at end of file diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/class.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/class.md.twig index de49e276..a61cdb26 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/class.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/class.md.twig @@ -1,31 +1,15 @@ {{ generatePageBreadcrumbs(classEntity.getShortName(), parentDocFilePath, false) }} {% include '_classHeader.md.twig' with {'classEntity': classEntity} only %} - - {{ loadPluginsContent('', classEntity, constant('BumbleDocGen\\LanguageHandler\\Php\\Renderer\\EntityDocRenderer\\PhpClassToMd\\PhpClassToMdDocRenderer::BLOCK_AFTER_HEADER')) }} - - {% include '_classMainInfo.md.twig' with {'classEntity': classEntity} only %} - - {{ loadPluginsContent('', classEntity, constant('BumbleDocGen\\LanguageHandler\\Php\\Renderer\\EntityDocRenderer\\PhpClassToMd\\PhpClassToMdDocRenderer::BLOCK_AFTER_MAIN_INFO')) }} - - {% include '_enumCases.md.twig' with {'classEntity': classEntity} only %} - {% include '_methods.md.twig' with {'blockName': 'Initialization methods', 'methodEntitiesCollection': classEntity.getMethodEntitiesCollection().getInitializations()} only %} - {% include '_methods.md.twig' with {'blockName': 'Methods', 'methodEntitiesCollection': classEntity.getMethodEntitiesCollection().getAllExceptInitializations()} only %} - {% include '_traits.md.twig' with {'classEntity': classEntity} only %} - -{% include '_constants.md.twig' with {'classEntity': classEntity} only %} - {% include '_properties.md.twig' with {'classEntity': classEntity} only %} - +{% include '_constants.md.twig' with {'classEntity': classEntity} only %} {{ loadPluginsContent('', classEntity, constant('BumbleDocGen\\LanguageHandler\\Php\\Renderer\\EntityDocRenderer\\PhpClassToMd\\PhpClassToMdDocRenderer::BLOCK_BEFORE_DETAILS')) }} - {% include '_property_details.md.twig' with {'classEntity': classEntity} only %} - {% include '_method_details.md.twig' with {'methodEntitiesCollection': classEntity.getMethodEntitiesCollection()} only %} From c3c31dcabea6675456097bc399121ccd5bbf1bc9 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Thu, 18 Jan 2024 13:40:17 +0300 Subject: [PATCH 04/32] Fixing breadcrumbs generator --- src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php | 3 +-- .../Renderer/Breadcrumbs/templates/breadcrumbs.html.twig | 1 - .../Renderer/Breadcrumbs/templates/breadcrumbs.md.twig | 7 +++++++ .../Renderer/Twig/Function/GeneratePageBreadcrumbs.php | 8 ++++---- 4 files changed, 12 insertions(+), 7 deletions(-) delete mode 100644 src/Core/Renderer/Breadcrumbs/templates/breadcrumbs.html.twig create mode 100644 src/Core/Renderer/Breadcrumbs/templates/breadcrumbs.md.twig diff --git a/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php b/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php index 83059873..8d4edc8f 100644 --- a/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php +++ b/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php @@ -12,7 +12,6 @@ use BumbleDocGen\Core\Plugin\Event\Renderer\OnGetTemplatePathByRelativeDocPath; use BumbleDocGen\Core\Plugin\PluginEventDispatcher; use BumbleDocGen\Core\Renderer\TemplateFile; -use BumbleDocGen\Core\Renderer\Twig\MainTwigEnvironment; use DI\DependencyException; use DI\NotFoundException; use Symfony\Component\Finder\Finder; @@ -349,7 +348,7 @@ public function getPageDocFileByKey(string $key): ?string */ public function renderBreadcrumbs(string $currentPageTitle, string $filePatch, bool $fromCurrent = true): string { - return $this->breadcrumbsTwig->render('breadcrumbs.html.twig', [ + return $this->breadcrumbsTwig->render('breadcrumbs.md.twig', [ 'currentPageTitle' => $currentPageTitle, 'breadcrumbs' => $this->getBreadcrumbs($filePatch, $fromCurrent), ]); diff --git a/src/Core/Renderer/Breadcrumbs/templates/breadcrumbs.html.twig b/src/Core/Renderer/Breadcrumbs/templates/breadcrumbs.html.twig deleted file mode 100644 index 56c0e961..00000000 --- a/src/Core/Renderer/Breadcrumbs/templates/breadcrumbs.html.twig +++ /dev/null @@ -1 +0,0 @@ -{% if breadcrumbs %}{% for item in breadcrumbs %}{{ item.title }} / {% endfor %}{{ currentPageTitle }}
{% endif %} \ No newline at end of file diff --git a/src/Core/Renderer/Breadcrumbs/templates/breadcrumbs.md.twig b/src/Core/Renderer/Breadcrumbs/templates/breadcrumbs.md.twig new file mode 100644 index 00000000..d7e0798c --- /dev/null +++ b/src/Core/Renderer/Breadcrumbs/templates/breadcrumbs.md.twig @@ -0,0 +1,7 @@ +{% if breadcrumbs %} +{% for item in breadcrumbs %} +[{{ item.title }}]({{ item.url }}) **/** +{% endfor %}{{ currentPageTitle }} + +--- +{% endif %} \ No newline at end of file diff --git a/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php b/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php index 4b499068..51c85514 100644 --- a/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php +++ b/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php @@ -20,9 +20,9 @@ final class GeneratePageBreadcrumbs implements CustomFunctionInterface { public function __construct( - private BreadcrumbsHelper $breadcrumbsHelper, - private RendererContext $rendererContext, - private RendererDependencyFactory $dependencyFactory, + private readonly BreadcrumbsHelper $breadcrumbsHelper, + private readonly RendererContext $rendererContext, + private readonly RendererDependencyFactory $dependencyFactory, ) { } @@ -75,6 +75,6 @@ public function __invoke( $this->rendererContext->addDependency($fileDependency); } - return " {$content} "; + return $content; } } From 4ce38957dcefdb366c904d6879b0cc9a4e61eb5d Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Thu, 18 Jan 2024 13:41:28 +0300 Subject: [PATCH 05/32] Output data in MD format --- src/Core/Renderer/Twig/Filter/StrTypeToUrl.php | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php b/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php index 8b550acf..5d40a248 100644 --- a/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php +++ b/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php @@ -18,9 +18,9 @@ final class StrTypeToUrl implements CustomFilterInterface { public function __construct( - private RendererHelper $rendererHelper, - private GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, - private Logger $logger + private readonly RendererHelper $rendererHelper, + private readonly GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, + private readonly Logger $logger ) { } @@ -43,6 +43,7 @@ public static function getOptions(): array * @param bool $useShortLinkVersion Shorten or not the link name. When shortening, only the shortName of the entity will be shown * @param bool $createDocument * If true, creates an entity document. Otherwise, just gives a reference to the entity code + * @param string $separator Separator between types * * @return string */ @@ -50,7 +51,8 @@ public function __invoke( string $text, RootEntityCollection $rootEntityCollection, bool $useShortLinkVersion = false, - bool $createDocument = false + bool $createDocument = false, + string $separator = ' | ' ): string { $getDocumentedEntityUrlFunction = $this->getDocumentedEntityUrlFunction; @@ -62,7 +64,7 @@ public function __invoke( if ($useShortLinkVersion) { $type = array_reverse(explode('\\', $type))[0]; } - $preparedTypes[] = "{$type}"; + $preparedTypes[] = "[{$type}]({$preloadResourceLink})"; continue; } try { @@ -78,7 +80,7 @@ public function __invoke( } if ($link && $link !== '#') { - $preparedTypes[] = "{$type}"; + $preparedTypes[] = "[$type]({$link})"; } else { $preparedTypes[] = $type; } @@ -97,6 +99,6 @@ public function __invoke( } } - return implode(' | ', $preparedTypes); + return implode($separator, $preparedTypes); } } From 170ac1241bb1019091336fd68cf97444f0db7099 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Thu, 18 Jan 2024 14:38:29 +0300 Subject: [PATCH 06/32] Use more md syntax instead of filters --- selfdoc/templates/README.md.twig | 71 ++++++++++--------- .../templates/tech/01_configuration.md.twig | 17 +++-- .../templates/tech/02_parser/entity.md.twig | 28 +++++--- .../02_parser/entityFilterCondition.md.twig | 8 +-- .../templates/tech/02_parser/readme.md.twig | 14 ++-- .../php/phpClassConstantReflectionApi.md.twig | 2 +- .../php/phpClassMethodReflectionApi.md.twig | 2 +- .../php/phpClassPropertyReflectionApi.md.twig | 2 +- .../php/phpClassReflectionApi.md.twig | 2 +- .../php/phpEntitiesCollection.md.twig | 2 +- .../php/phpEnumReflectionApi.md.twig | 2 +- .../php/phpInterfaceReflectionApi.md.twig | 2 +- .../php/phpTraitReflectionApi.md.twig | 2 +- .../reflectionApi/php/readme.md.twig | 8 +-- .../02_parser/reflectionApi/readme.md.twig | 22 +++--- .../tech/02_parser/sourceLocator.md.twig | 10 +-- .../frontMatter.md.twig | 2 +- .../01_howToCreateTemplates/readme.md.twig | 45 ++++++------ .../templatesDynamicBlocks.md.twig | 11 +-- .../templatesLinking.md.twig | 6 +- .../templatesVariables.md.twig | 2 +- .../tech/03_renderer/02_breadcrumbs.md.twig | 26 ++++--- .../03_renderer/03_documentStructure.md.twig | 2 +- .../03_renderer/04_twigCustomFilters.md.twig | 8 +-- .../05_twigCustomFunctions.md.twig | 8 +-- .../templates/tech/03_renderer/readme.md.twig | 14 ++-- .../templates/tech/04_pluginSystem.md.twig | 14 ++-- selfdoc/templates/tech/05_console.md.twig | 6 +- selfdoc/templates/tech/06_debugging.md.twig | 2 +- .../templates/tech/07_outputFormat.md.twig | 2 +- selfdoc/templates/tech/readme.md.twig | 14 ++-- 31 files changed, 199 insertions(+), 157 deletions(-) diff --git a/selfdoc/templates/README.md.twig b/selfdoc/templates/README.md.twig index 99921573..13d8a631 100644 --- a/selfdoc/templates/README.md.twig +++ b/selfdoc/templates/README.md.twig @@ -1,36 +1,38 @@ --- title: BumbleDocGen --- -{{ "BumbleDocGen: A Documentation Generator for PHP projects 🐝" | textToHeading('H1') }} +# BumbleDocGen: A Documentation Generator for PHP projects 🐝 -BumbleDocGen is a robust library for generating and maintaining documentation next to the code of large and small PHP projects. +**BumbleDocGen** is a robust library for generating and maintaining documentation next to the code of large and small PHP projects. This tool analyzes your codebase and produces a comprehensive set of Markdown documents, including descriptions of classes, methods, and properties alongside navigable internal links. -{{ "Installation" | textToHeading('H2') }} +## Installation Add the BumbleDocGen to the `composer.json` file of your project using the following command: -{{ 'composer require bumble-tech/bumble-doc-gen' | textToCodeBlock('console') }} +```console +composer require bumble-tech/bumble-doc-gen +``` -{{ "Detailed technical description" | textToHeading('H2') }} +## Detailed technical description 💡 Please refer to the [a x-title="Description of the technical part of the project"]Technical description of the project[/a] for a detailed explanation of all the classes and methods used. -{{ "Core Features" | textToHeading('H2') }} +## Core Features -- 🔍 [a x-title="Parsing"]Parser[/a]: +1. 🔍 **[a x-title="Parsing"]Parser[/a]:** BumbleDocGen analyzes your code and provides a convenient [a]Reflection API[/a]. -- ✍️ [a x-title="Rendering"]Renderer[/a]: +2. ✍️ **[a x-title="Rendering"]Renderer[/a]:** BumbleDocGen generates markdown content using templates and fills them with data obtained from parsing your code. -- 🧠 AI tools for documentation generation: +3. 🧠 **AI tools for documentation generation:** BumbleDocGen allows you to use a group of AI tools to help generate project documentation. -{{ "How to Use" | textToHeading('H2') }} +## How to Use -{{ "Entry points" | textToHeading('H3') }} +### Entry points BumbleDocGen's interface consists of mainly two classes: [a]DocGenerator[/a] and [a]DocGeneratorFactory[/a]. @@ -42,39 +44,36 @@ BumbleDocGen's interface consists of mainly two classes: [a]DocGenerator[/a] and {{ displayClassApiMethods('\\BumbleDocGen\\DocGeneratorFactory') | addIndentFromLeft }} -{{ "Examples of usage" | textToHeading('H3') }} +### Examples of usage 1) Working with a library in a PHP file + ```php + require_once 'vendor/autoload.php'; -```php -require_once 'vendor/autoload.php'; - -use BumbleDocGen\DocGeneratorFactory; + use BumbleDocGen\DocGeneratorFactory; -// Initialize the factory -$factory = new DocGeneratorFactory(); + // Initialize the factory + $factory = new DocGeneratorFactory(); -// Create a DocGenerator instance -$docgen = $factory->create('/path/to/configuration/files'); + // Create a DocGenerator instance + $docgen = $factory->create('/path/to/configuration/files'); -// or $docgen = $factory->createByConfigArray([...]); - -// Now call the desired operation -$docgen->generate(); -``` + // or $docgen = $factory->createByConfigArray([...]); + // Now call the desired operation + $docgen->generate(); + ``` 2) Working with the library through a console application + ```bash + # List of available commands + ./vendor/bin/bumbleDocGen list -```bash -# List of available commands -./vendor/bin/bumbleDocGen list + # Documentation generation example + ./vendor/bin/bumbleDocGen generate -c -# Documentation generation example -./vendor/bin/bumbleDocGen generate -c - -# Getting detailed information about a command -./vendor/bin/bumbleDocGen generate -h -``` + # Getting detailed information about a command + ./vendor/bin/bumbleDocGen generate -h + ``` ------------------ @@ -82,4 +81,6 @@ $docgen->generate(); To update this documentation, run the following command: -{{ './bin/bumbleDocGen generate' | textToCodeBlock('console') }} +```console +./bin/bumbleDocGen generate +``` diff --git a/selfdoc/templates/tech/01_configuration.md.twig b/selfdoc/templates/tech/01_configuration.md.twig index ff3ad1be..0b5b43bf 100644 --- a/selfdoc/templates/tech/01_configuration.md.twig +++ b/selfdoc/templates/tech/01_configuration.md.twig @@ -4,7 +4,7 @@ prevPage: Technical description of the project --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Configuration" | textToHeading('H1') }} +# Configuration Documentation generator configuration can be stored in special files. They can be in different formats: yaml, json, php arrays, ini, xml @@ -13,17 +13,20 @@ But it is not necessary to use files to store the configuration; you can also in During the instance creation process, configuration data is loaded into [a]Configuration[/a] class, and the code works directly with it. -{{ "Configuration file example" | textToHeading('H2') }} +# Configuration file example Let's look at an example of a real configuration in more detail: -{{ fileGetContents('%WORKING_DIR%/bumble_doc_gen.yaml') | textToCodeBlock('yaml') }} +```yaml +{{ fileGetContents('%WORKING_DIR%/bumble_doc_gen.yaml') }} +``` In this example, we see the real configuration of the self-documentation of this project. **Here is an example of loading this configuration in PHP code:** -{{ "// Single file +```php +// Single file $docGenerator = (new DocGeneratorFactory())->create('config.yaml'); // Multiple files @@ -31,9 +34,9 @@ $docGenerator = (new DocGeneratorFactory())->create('config.yaml', 'config2.yaml // Passing configuration as an array $docGenerator = (new DocGeneratorFactory())->createByConfigArray($configArray); -" | textToCodeBlock('php') }} +``` -{{ "Handling and inheritance of configuration files" | textToHeading('H2') }} +## Handling and inheritance of configuration files The documentation generator can work with several configuration files at once. When processing configuration files, each subsequent file has a higher priority and overwrites the previously defined parameters, but if the parameter has not yet been defined before, it will be added. @@ -41,7 +44,7 @@ When processing configuration files, each subsequent file has a higher priority Each default configuration file inherits the base configuration: `BumbleDocGen/Core/Configuration/defaultConfiguration.yaml`, but the parent configuration file can be changed using the `parent_configuration` parameter. The inheritance algorithm is as follows: scalar types can be overwritten by each subsequent configuration, while arrays are supplemented with new data instead of overwriting. -{{ "Configuration parameters" | textToHeading('H2') }} +## Configuration parameters {% set parameters = getConfigParametersDescription(phpEntities, '%WORKING_DIR%/src/Core/Configuration/defaultConfiguration.yaml') %} diff --git a/selfdoc/templates/tech/02_parser/entity.md.twig b/selfdoc/templates/tech/02_parser/entity.md.twig index 90d69ba7..60ea04b0 100644 --- a/selfdoc/templates/tech/02_parser/entity.md.twig +++ b/selfdoc/templates/tech/02_parser/entity.md.twig @@ -4,42 +4,52 @@ prevPage: Parser --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Entities and entities collections" | textToHeading('H1') }} +# Entities and entities collections Entities are organized outcomes from parsing source code. They help easily extract details about specific items from templates, allowing users to quickly access and display the information they need. Entities are always handled through collections. Collections are the result of the project parsing process and are available in both documentation templates and code. -{{ "Examples of using collections in twig templates" | textToHeading('H2') }} +## Examples of using collections in twig templates * Passing a collection to a function: -{{ "{{ printEntityCollectionAsList(phpEntities) }}" | textToCodeBlock('twig') }} +```twig +{{ "{{ printEntityCollectionAsList(phpEntities) }}" }} +``` * Filtering a collection and passing it to a function: -{{ "{{ printEntityCollectionAsList(phpEntities.filterByInterfaces(['BumbleDocGen\\Core\\Parser\\Entity\\EntityInterface'])) }}" | textToCodeBlock('twig') }} +```twig +{{ "{{ printEntityCollectionAsList(phpEntities.filterByInterfaces(['BumbleDocGen\\Core\\Parser\\Entity\\EntityInterface'])) }}" }} +``` * Saving a filtered collection to a variable: -{{ "{{ {% set filteredCollection = phpEntities.getOnlyInstantiable() %} }}" | textToCodeBlock('twig') }} +```twig +{{ "{% set filteredCollection = phpEntities.getOnlyInstantiable() %}" }} +``` * Using a collection in a for loop: +```twig {{ "{% for someClassEntity in phpEntities %} * {{ someClassEntity.getName() }} -{% endfor %}" | textToCodeBlock('twig') }} +{% endfor %}" }} +``` * Output of all methods of all found entities in `className::methodName()` format: +```twig {{ "{% for someClassEntity in phpEntities %} {% for methodEntity in someClassEntity.getMethodEntitiesCollection() %} * {{ someClassEntity.getName() }}::{{ methodEntity.getName() }}() {% endfor %} -{% endfor %}" | textToCodeBlock('twig') }} +{% endfor %}" }} +``` -{{ "Root entities collections" | textToHeading('H2') }} +## Root entities collections To further facilitate the handling of these entities, we utilize entity collections. These collections not only group relevant entities together but also provide convenient methods for filtering and manipulating these entities. @@ -66,7 +76,7 @@ The root collections ([a]RootEntityCollection[/a]), which are directly accessibl {% endfor %} -{{ "Available entities" | textToHeading('H2') }} +## Available entities Following is the list of available entities that are consistent with [a]EntityInterface[/a] and can be created. These classes are a convenient wrapper for accessing data in templates: diff --git a/selfdoc/templates/tech/02_parser/entityFilterCondition.md.twig b/selfdoc/templates/tech/02_parser/entityFilterCondition.md.twig index d10019a4..0a905715 100644 --- a/selfdoc/templates/tech/02_parser/entityFilterCondition.md.twig +++ b/selfdoc/templates/tech/02_parser/entityFilterCondition.md.twig @@ -4,7 +4,7 @@ prevPage: Parser --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Entity filter conditions" | textToHeading('H1') }} +# Entity filter conditions Filters serve as a foundational mechanism within our documentation generator, dictating which segments of the source code are selected during the initial parsing phase. These rules facilitate a strategic extraction of elements, such as classes, methods, or constants, from the underlying codebase. @@ -13,7 +13,7 @@ This level of granularity not only streamlines the documentation process but als All filter conditions implement the [a]ConditionInterface[/a] interface. -{{ "Mechanism for adding entities to the collection" | textToHeading('H2') }} +## Mechanism for adding entities to the collection For each language handler, according to the configuration, the following scheme is applicable: @@ -35,7 +35,7 @@ flowchart LR The diagram shows the mechanism for adding root entities, but this also applies to the attributes of each entity, for example, for PHP there are rules for checking the possibility of adding methods, properties and constants. -{{ "Filter conditions configuration" | textToHeading('H2') }} +## Filter conditions configuration Filter conditions are configured separately for language handlers. @@ -67,7 +67,7 @@ language_handlers: - class: \BumbleDocGen\LanguageHandler\Php\Parser\FilterCondition\PropertyFilterCondition\OnlyFromCurrentClassCondition ``` -{{ "Available filters" | textToHeading('H2') }} +## Available filters {% set filterConditions = phpEntities.filterByInterfaces(['BumbleDocGen\\Core\\Parser\\FilterCondition\\ConditionInterface']).getOnlyInstantiable() %} diff --git a/selfdoc/templates/tech/02_parser/readme.md.twig b/selfdoc/templates/tech/02_parser/readme.md.twig index eeb8d0c6..e70eb778 100644 --- a/selfdoc/templates/tech/02_parser/readme.md.twig +++ b/selfdoc/templates/tech/02_parser/readme.md.twig @@ -3,7 +3,7 @@ title: Parser --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Documentation parser" | textToHeading('H1') }} +# Documentation parser Most often, we need [a]ProjectParser[/a] in order to get a list of entities for documentation. But this is not the only use of this tool. The result of the parser's work (a collection of entities) can be used to programmatically analyze the project and perform any operations based on this analysis. @@ -12,19 +12,21 @@ You can also use the parser for your own purposes other than generating document In this section, we show how the parser works and what components it consists of. -{{ "Description of the main components of the parser" | textToHeading('H2') }} +## Description of the main components of the parser {{ drawDocumentationMenu(_self) }} -{{ "Starting the parsing process" | textToHeading('H2') }} +## Starting the parsing process -{{ "$parser = new ProjectParser($configuration, $rootEntityCollectionsGroup); +```php +$parser = new ProjectParser($configuration, $rootEntityCollectionsGroup); // Parsing the project and filling RootEntityCollectionsGroup with data $this->parser->parse(); -$rootEntityCollectionsGroup = $this->parser->getRootEntityCollectionsGroup();" | textToCodeBlock('php') }} +$rootEntityCollectionsGroup = $this->parser->getRootEntityCollectionsGroup(); +``` -{{ "How it works" | textToHeading('H2') }} +## How it works ```mermaid flowchart TD diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md.twig index ac76af5f..aaa89e22 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md.twig @@ -4,7 +4,7 @@ prevPage: Reflection API for PHP --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "PHP class constant reflection API" | textToHeading('H1') }} +# PHP class constant reflection API Class constant reflection entity class: [a]ClassConstantEntity[/a]. diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md.twig index 0a3c253b..f19fe3c7 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md.twig @@ -4,7 +4,7 @@ prevPage: Reflection API for PHP --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "PHP class method reflection API" | textToHeading('H1') }} +# PHP class method reflection API Method reflection entity class: [a]MethodEntity[/a]. diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md.twig index a82dbea3..10bae6c8 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md.twig @@ -4,7 +4,7 @@ prevPage: Reflection API for PHP --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "PHP class property reflection API" | textToHeading('H1') }} +# PHP class property reflection API Property reflection entity class: [a]PropertyEntity[/a]. diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md.twig index e57df6db..338e6a76 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md.twig @@ -4,7 +4,7 @@ prevPage: Reflection API for PHP --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "PHP class reflection API" | textToHeading('H1') }} +# PHP class reflection API PHP class reflection [a]ClassEntity[/a] inherits from [a]ClassLikeEntity[/a]. diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md.twig index 05ee72f4..57cb2b0c 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md.twig @@ -4,7 +4,7 @@ prevPage: Reflection API for PHP --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "PHP entities collection" | textToHeading('H1') }} +# PHP entities collection **PHP entities collection API methods:** diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md.twig index 3a062d29..80ff741d 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md.twig @@ -4,7 +4,7 @@ prevPage: Reflection API for PHP --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "PHP enum reflection API" | textToHeading('H1') }} +# PHP enum reflection API PHP enum reflection [a]EnumEntity[/a] inherits from [a]ClassLikeEntity[/a]. diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md.twig index dfe79126..e3c8b7ad 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md.twig @@ -4,7 +4,7 @@ prevPage: Reflection API for PHP --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "PHP interface reflection API" | textToHeading('H1') }} +# PHP interface reflection API PHP interface reflection [a]InterfaceEntity[/a] inherits from [a]ClassLikeEntity[/a]. diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md.twig index bb8c7001..73b2595b 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md.twig @@ -4,7 +4,7 @@ prevPage: Reflection API for PHP --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "PHP trait reflection API" | textToHeading('H1') }} +# PHP trait reflection API PHP trait reflection [a]TraitEntity[/a] inherits from [a]ClassLikeEntity[/a]. diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/readme.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/readme.md.twig index ff9657fa..f98bf7b8 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/readme.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/readme.md.twig @@ -3,12 +3,12 @@ title: Reflection API for PHP --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Reflection API for PHP" | textToHeading('H1') }} +# Reflection API for PHP The tool we implemented partially replicates the [standard PHP reflection API](https://www.php.net/manual/en/book.reflection.php), but it has some additional capabilities. In addition, our Reflection API is available for use in every documentation template, plugin, twig function, etc. at `BumbleDocGen`. -{{ "Class like reflections" | textToHeading('H2') }} +## Class like reflections Using our PHP reflection API you can get information about project entities. Below is information about the available methods for working with each entity type: @@ -33,7 +33,7 @@ $entityClassCodeStartLine = $classReflection->getStartLine(); // ... etc. ``` -{{ "Entities collection" | textToHeading('H2') }} +## Entities collection Class reflections are stored in collections. The collection is filled either before documents are generated, if the Reflection API is used to generate documentation, or when special methods are called that, under certain conditions, fill them with the required reflections. @@ -64,7 +64,7 @@ foreach($entitiesCollection as $classReflection) { } ``` -{{ "Class like sub entities reflections" | textToHeading('H2') }} +## Class like sub entities reflections PHP classes contain methods, properties and constants. Below is information about these child entities: diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/readme.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/readme.md.twig index 7f4be448..41f32923 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/readme.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/readme.md.twig @@ -3,7 +3,7 @@ title: Reflection API --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Reflection API" | textToHeading('H1') }} +# Reflection API The documentation generator has a convenient Reflection API for analyzing the source code of the project being documented. You can use the Reflection API both in documentation templates and simply in your code where necessary. @@ -12,9 +12,10 @@ You can use the Reflection API both in documentation templates and simply in you 1) **[a]Reflection API for PHP[/a]** 2) **[Demo](/demo/demo6-reflection-api/demoScript.php)** -{{ "Example" | textToHeading('H3') }} +## Example -{{ '// Create a Reflection API config object. This example shows the config for parsing PHP code +```php +// Create a Reflection API config object. This example shows the config for parsing PHP code $reflectionApiConfig = PhpReflectionApiConfig::create(); /** @var PhpEntitiesCollection $entitiesCollection*/ @@ -26,19 +27,20 @@ $sourceLocators = SourceLocatorsCollection::create(new DirectoriesSourceLocator( // We can define special filters according to which entities will be loaded $filter = new TrueCondition(); -// By default the collection is empty. You can populate the collection with data +// By default, the collection is empty. You can populate the collection with data $entitiesCollection->loadEntities( $sourceLocators, $filter ); // And now you can use Reflection API -$filename = $entitiesCollection->get(\'SomeClassName\')?->getAbsoluteFileName(); -' | textToCodeBlock('php') }} +$filename = $entitiesCollection->get('SomeClassName')?->getAbsoluteFileName(); +``` -{{ "Example 2 - Working with the Reflection API through a default parsing mechanism" | textToHeading('H3') }} +## Example 2 - Working with the Reflection API through a default parsing mechanism -{{ '// Create a documentation generator object +```php +// Create a documentation generator object $docGen = (new \BumbleDocGen\DocGeneratorFactory())->create($configFile); // Next we get a group of entity collections (according to the configuration) @@ -48,8 +50,8 @@ $entityCollectionsGroup = $docGen->parseAndGetRootEntityCollectionsGroup(); $entitiesCollection = $entityCollectionsGroup->get(PhpEntitiesCollection::class); // And now you can use Reflection API -$filename = $entitiesCollection->get(\'SomeClassName\')?->getAbsoluteFileName(); -' | textToCodeBlock('php') }} +$filename = $entitiesCollection->get('SomeClassName')?->getAbsoluteFileName(); +``` This method is used in the documentation generation process. The only difference with the first example is that the first option is more convenient to use as a separate tool. diff --git a/selfdoc/templates/tech/02_parser/sourceLocator.md.twig b/selfdoc/templates/tech/02_parser/sourceLocator.md.twig index 1abd1872..20cb81a0 100644 --- a/selfdoc/templates/tech/02_parser/sourceLocator.md.twig +++ b/selfdoc/templates/tech/02_parser/sourceLocator.md.twig @@ -4,22 +4,24 @@ prevPage: Parser --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Source locators" | textToHeading('H1') }} +# Source locators Source locators are needed so that the parser knows which files to parse, or to get data on a specific file after the primary parsing procedure Source locators are set in the configuration: -{{ 'source_locators: +```yaml +source_locators: - class: \\BumbleDocGen\\Core\\Parser\\SourceLocator\\RecursiveDirectoriesSourceLocator arguments: directories: - "%project_root%/src" - - "%project_root%/selfdoc"' | textToCodeBlock('yaml') }} + - "%project_root%/selfdoc" +``` You can create your own source locators or use any existing ones. All source locators must implement the [a]SourceLocatorInterface[/a] interface. -{{ "Built-in source locators" | textToHeading('H2') }} +## Built-in source locators {{ printEntityCollectionAsList( phpEntities diff --git a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/frontMatter.md.twig b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/frontMatter.md.twig index 264f45a3..ca00ac21 100644 --- a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/frontMatter.md.twig +++ b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/frontMatter.md.twig @@ -4,7 +4,7 @@ prevPage: How to create documentation templates? --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Front Matter" | textToHeading('H1') }} +# Front Matter Front Matter is a special block at the top of a document template or generated document that contains certain important meta information. diff --git a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/readme.md.twig b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/readme.md.twig index d7db5360..eb7a3a87 100644 --- a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/readme.md.twig +++ b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/readme.md.twig @@ -3,7 +3,7 @@ title: How to create documentation templates? --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "How to create documentation templates?" | textToHeading('H1') }} +# How to create documentation templates? Templates are `twig` files in which you can write both static text and dynamic blocks that will change from code changes or other required parameters. @@ -11,34 +11,39 @@ Templates are `twig` files in which you can write both static text and dynamic b {{ drawDocumentationMenu(_self) }} -{{ "Examples" | textToHeading('H2') }} +## Examples -{{ "1) An example of a template with fully static text:" | textToHeading('H3') }} +### 1) An example of a template with fully static text: -{{ "Some static text\nThis text does not change when the code is changed" | textToCodeBlock('twig') }} +```twig +Some static text +This text does not change when the code is changed +``` After generating the documentation, this page will look exactly like a template. -{{ "2) An example of a template with static text and dynamic blocks:" | textToHeading('H3') }} +### 2) An example of a template with static text and dynamic blocks: -{{ "--- +```twig +--- title: Some page prevPage: Technical description of the project --- -{{ generatePageBreadcrumbs(title, _self) }\} +{{ "{{ generatePageBreadcrumbs(title, _self) }}" }} Some static text... Dynamic block: -{\{ printEntityCollectionAsList(phpEntities.filterByInterfaces(['\\\\BumbleDocGen\\\\Core\\\\Parser\\\\SourceLocator\\\\SourceLocatorInterface']).getOnlyInstantiable()) }\} +{{ "{{ printEntityCollectionAsList(phpEntities.filterByInterfaces(['\\\\BumbleDocGen\\\\Core\\\\Parser\\\\SourceLocator\\\\SourceLocatorInterface']).getOnlyInstantiable()) }}" }} More static text... -" | textToCodeBlock('twig') }} +``` Result after starting the documentation generation process: -{{ ' BumbleDocGen / Technical description of the project / Some page
+```md + BumbleDocGen / Technical description of the project / Some page
Some static text... @@ -51,39 +56,39 @@ More static text...

Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
Last modified date: Sat Jul 29 17:43:49 2023 +0300
Page content update date: Sun Jul 30 2023
Made with Bumble Documentation Generator
-' | textToCodeBlock('html') }} +``` This is how it looks on the GitHub: -{{ "3) Another example of a dynamic block:" | textToHeading('H3') }} +### 3) Another example of a dynamic block: Output method description as a dynamic block: -{{ "Some static text... +```twig +Some static text... Dynamic block: -{\{ phpEntities +{{ "{{ phpEntities .get('\\\\BumbleDocGen\\\\LanguageHandler\\\\LanguageHandlerInterface') .getMethod('getLanguageKey') .getDescription() -}\} +}}" }} More static text... -" | textToCodeBlock('twig') }} +``` Result after starting the documentation generation process: - - -{{ "Some static text... +```twig +Some static text... Dynamic block: Unique language handler key More static text... -" | textToCodeBlock('twig') }} \ No newline at end of file +``` \ No newline at end of file diff --git a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md.twig b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md.twig index 3923b06b..30a19a2b 100644 --- a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md.twig +++ b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md.twig @@ -4,19 +4,22 @@ prevPage: How to create documentation templates? --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Templates dynamic blocks" | textToHeading('H1') }} +# Templates dynamic blocks There are several ways to create dynamic blocks in templates. * First of all, these are custom twig functions and filters. You can use the built-in functions and filters or add your own, so you can implement any logic for generating dynamically changing content. -{{ "{\{ printEntityCollectionAsList(phpEntities.filterByInterfaces(['\\\\BumbleDocGen\\\\Core\\\\Parser\\\\SourceLocator\\\\SourceLocatorInterface']).getOnlyInstantiable()) }\}" | textToCodeBlock('twig') }} +```twig +{{ "{{ printEntityCollectionAsList(phpEntities.filterByInterfaces(['\\\\BumbleDocGen\\\\Core\\\\Parser\\\\SourceLocator\\\\SourceLocatorInterface']).getOnlyInstantiable()) }}" }} +``` * The second way is to output data from variables directly to the template. For example, you can display a list of classes or methods of documented code according to certain rules. +```twig {{ "{% for entity in phpEntities.filterByInterfaces(['\\\\BumbleDocGen\\\\Core\\\\Parser\\\\SourceLocator\\\\SourceLocatorInterface']).getOnlyInstantiable() %} * {{ entity.getName() }} -{% endfor %} -" | textToCodeBlock('twig') }} +{% endfor %}" }} +``` diff --git a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md.twig b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md.twig index d3b7a65f..ec613d68 100644 --- a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md.twig +++ b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md.twig @@ -4,12 +4,12 @@ prevPage: How to create documentation templates? --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Linking templates" | textToHeading('H1') }} +# Linking templates One of the main requirements of the documentation is to be able to easily and quickly implement linking between pages. We have several options for this, such as using special functions or using a special document linking mechanism (`completing blank links`) -{{ "Completing blank links" | textToHeading('H2') }} +## Completing blank links Plugin [a]PageHtmlLinkerPlugin[/a] have been added to the basic configuration, which process the text of the filled template before its result is written to a file, and fill in all empty links. @@ -33,7 +33,7 @@ Examples: {{ '
[a x-title="test"]Existent page name[/a] => <a href="/docs/some/page/targetPage.md">test</a>
' }} -{{ "Generating links through functions" | textToHeading('H2') }} +## Generating links through functions The second way to relink templates is to generate links through functions. diff --git a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md.twig b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md.twig index af9addba..d925bc78 100644 --- a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md.twig +++ b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md.twig @@ -4,7 +4,7 @@ prevPage: How to create documentation templates? --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Templates variables" | textToHeading('H1') }} +# Templates variables There are several variables available in each processed template. diff --git a/selfdoc/templates/tech/03_renderer/02_breadcrumbs.md.twig b/selfdoc/templates/tech/03_renderer/02_breadcrumbs.md.twig index eb418465..5e8551f4 100644 --- a/selfdoc/templates/tech/03_renderer/02_breadcrumbs.md.twig +++ b/selfdoc/templates/tech/03_renderer/02_breadcrumbs.md.twig @@ -4,12 +4,12 @@ prevPage: Renderer --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Documentation structure and breadcrumbs" | textToHeading('H1') }} +# Documentation structure and breadcrumbs To work with breadcrumbs and get the structure of the documentation, we use the inner class [a]BreadcrumbsHelper[/a]. To build the documentation structure, twig templates from the `templates_dir` configuration are used. -{{ "Project structure definitions" | textToHeading('H2') }} +## Project structure definitions To determine the structure of the project, the actual location of the files in the templates directory is used first of all. For each directory there is an index file ( readme.md or index.md ), and they are used to determine the exact input of each level of nesting. @@ -19,28 +19,36 @@ For each directory there is an index file ( readme.md or index.md But in addition to building the documentation structure using the actual location of template files in directories, you can explicitly specify the parent page in each template using the special front matter variable `prevPage`: -{{ "--- +```markdown +--- prevPage: Prev page name ----" | textToCodeBlock('markdown') }} +--- +``` In this way, complex documentation structures can be created with less file nesting: -{{ "Displaying breadcrumbs in documents" | textToHeading('H2') }} +## Displaying breadcrumbs in documents There is a built-in function to generate breadcrumbs in templates [a]GeneratePageBreadcrumbs[/a]. Here is how it is used in twig templates: -{{ '{{ generatePageBreadcrumbs(title, _self) }\}' | textToCodeBlock('twig') }} +```twig +{{ '{{ generatePageBreadcrumbs(title, _self) }}' }} +``` To build breadcrumbs, the previously compiled project structure and the names of each template are used. The template name can be specified using the `title` front matter variable: -{{ "--- +```markdown +--- title: Some page title ----" | textToCodeBlock('markdown') }} +--- +``` Here is an example of the result of the `generatePageBreadcrumbs` function: -{{ ' BumbleDocGen / Technical description of the project / Renderer / Some page title
' | textToCodeBlock('twig') }} \ No newline at end of file +```twig +{{ ' BumbleDocGen / Technical description of the project / Renderer / Some page title
' }} +``` diff --git a/selfdoc/templates/tech/03_renderer/03_documentStructure.md.twig b/selfdoc/templates/tech/03_renderer/03_documentStructure.md.twig index 0e841568..2d2e27ce 100644 --- a/selfdoc/templates/tech/03_renderer/03_documentStructure.md.twig +++ b/selfdoc/templates/tech/03_renderer/03_documentStructure.md.twig @@ -4,7 +4,7 @@ prevPage: Renderer --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Document structure of generated entities" | textToHeading('H1') }} +# Document structure of generated entities *By default, the documentation generator offers two options for organizing the structure of generated entity documents:* diff --git a/selfdoc/templates/tech/03_renderer/04_twigCustomFilters.md.twig b/selfdoc/templates/tech/03_renderer/04_twigCustomFilters.md.twig index d628d61f..4434b72c 100644 --- a/selfdoc/templates/tech/03_renderer/04_twigCustomFilters.md.twig +++ b/selfdoc/templates/tech/03_renderer/04_twigCustomFilters.md.twig @@ -4,7 +4,7 @@ prevPage: Renderer --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Template filters" | textToHeading('H1') }} +# Template filters When generating pages, you can use filters that allow you to modify the content. Filters available during page generation are defined in the configuration ( `twig_filters` parameter ) @@ -12,7 +12,7 @@ Filters available during page generation are defined in {{ someText | filter(...parameters) }}' }} @@ -21,7 +21,7 @@ or {{ '
{{ someText | filter }}
' }} -{{ "Configuration example" | textToHeading('H2') }} +## Configuration example You can add your custom filters to the configuration like this: @@ -34,7 +34,7 @@ twig_filters: It is important to remember that when a template is inherited, custom filters are not overridden and augmented. This information is detailed on page [a]01_configuration.md[/a]. -{{ "Defautl template filters" | textToHeading('H2') }} +## Default template filters Several filters are already defined in the base configuration. There are both general filters for all types of entities, and filters that only serve to process entities that belong to a particular PL. diff --git a/selfdoc/templates/tech/03_renderer/05_twigCustomFunctions.md.twig b/selfdoc/templates/tech/03_renderer/05_twigCustomFunctions.md.twig index 9da7d28c..ee35b1da 100644 --- a/selfdoc/templates/tech/03_renderer/05_twigCustomFunctions.md.twig +++ b/selfdoc/templates/tech/03_renderer/05_twigCustomFunctions.md.twig @@ -4,7 +4,7 @@ prevPage: Renderer --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Template functions" | textToHeading('H1') }} +# Template functions When generating pages, you can use functions that allow you to modify the content. Functions available during page generation are defined in
the configuration ( `twig_functions` parameter ) @@ -14,11 +14,11 @@ We use the twig template engine, you can get more information about working with You can also create your own functions and use them for any purpose, such as loading some additional information into a template, filtering data, or formatting the output of any information. Each function must implement the [a]CustomFunctionInterface[/a] interface, implement the `__invoke` magic method, and be added to the configuration. -{{ "How to use a function in a template" | textToHeading('H2') }} +## How to use a function in a template {{ '
{{ functionName(...parameters) }}
' }} -{{ "Configuration example" | textToHeading('H2') }} +## Configuration example You can add your custom functions to the configuration like this: @@ -32,7 +32,7 @@ twig_functions: It is important to remember that when a template is inherited, custom functions are not overridden and augmented. This information is detailed on page [a]01_configuration.md[/a]. -{{ "Defautl template functions" | textToHeading('H2') }} +## Default template functions Several functions are already defined in the base configuration. There are both general functions for all types of entities, and functions that only serve to process entities that belong to a particular PL. diff --git a/selfdoc/templates/tech/03_renderer/readme.md.twig b/selfdoc/templates/tech/03_renderer/readme.md.twig index 5f1411b8..058fa2d8 100644 --- a/selfdoc/templates/tech/03_renderer/readme.md.twig +++ b/selfdoc/templates/tech/03_renderer/readme.md.twig @@ -3,7 +3,7 @@ title: Renderer --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Documentation renderer" | textToHeading('H1') }} +# Documentation renderer Render passes through all files from the directory specified in configuration param `templates_dir` @@ -11,18 +11,20 @@ If the file ends with **.twig** then the file is processed, otherwise it is simp to the target directory obtained from configuration param `output_dir`. We use twig to process templates. -{{ "More detailed description of renderer components" | textToHeading('H2') }} +## More detailed description of renderer components {{ drawDocumentationMenu(_self) }} -{{ "Starting the rendering process" | textToHeading('H2') }} +## Starting the rendering process -{{ "$renderer = new Renderer(...); +```php +$renderer = new Renderer(...); // Starting the process of filling templates with data and saving finished documents -$renderer->run();" | textToCodeBlock('php') }} +$renderer->run(); +``` -{{ "How it works" | textToHeading('H2') }} +## How it works The process of rendering documents is divided into several stages. We separately generate documentation for templates that were pre-prepared by the user, and then create documentation for classes that the user refers to from document templates. diff --git a/selfdoc/templates/tech/04_pluginSystem.md.twig b/selfdoc/templates/tech/04_pluginSystem.md.twig index b69e12ca..169e5e8e 100644 --- a/selfdoc/templates/tech/04_pluginSystem.md.twig +++ b/selfdoc/templates/tech/04_pluginSystem.md.twig @@ -4,13 +4,13 @@ prevPage: Technical description of the project --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Plugin system" | textToHeading('H1') }} +# Plugin system The documentation generator includes the ability to expand the functionality using plugins that allow you to add the necessary functionality to the system without changing its core. The system is built on the basis of an event model, each plugin class must implement [a]PluginInterface[/a]. -{{ "Configuration example" | textToHeading('H2') }} +## Configuration example You can add your plugins to the configuration like this: @@ -20,7 +20,7 @@ plugins: - class: \SelfDocConfig\Plugin\TwigFunctionClassParser\TwigFunctionClassParserPlugin ``` -{{ "Default plugins" | textToHeading('H2') }} +## Default plugins Below are the plugins that are available by default when working with the library. Plugins for any programming languages work regardless of which language handler is configured in the configuration. @@ -56,7 +56,7 @@ Plugins for any programming languages work regardless of which language handler {% endfor %} -{{ "Default events" | textToHeading('H2') }} +## Default events {{ printEntityCollectionAsList( phpEntities .filterByPaths([ @@ -66,11 +66,11 @@ Plugins for any programming languages work regardless of which language handler .filterByParentClassNames(['Symfony\\Contracts\\EventDispatcher\\Event']) .getOnlyInstantiable() ) }} -{{ "Adding a new plugin" | textToHeading('H2') }} +## Adding a new plugin If you decide to add a new plugin, there are a few things you need to do: -{{ "1) Add plugin class and implement events handling" | textToHeading('H3') }} +### 1) Add plugin class and implement events handling ```php namespace Demo\Plugin\DemoFakeResourceLinkPlugin; @@ -93,7 +93,7 @@ final class DemoFakeResourceLinkPlugin implements \BumbleDocGen\Core\Plugin\Plug } ``` -{{ "2) Add the new plugin to the configuration" | textToHeading('H3') }} +### 2) Add the new plugin to the configuration ```yaml plugins: diff --git a/selfdoc/templates/tech/05_console.md.twig b/selfdoc/templates/tech/05_console.md.twig index ee27c1d3..dccf97a1 100644 --- a/selfdoc/templates/tech/05_console.md.twig +++ b/selfdoc/templates/tech/05_console.md.twig @@ -4,7 +4,7 @@ prevPage: Technical description of the project --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Console app" | textToHeading('H1') }} +# Console app The documentation generator provides the ability to work through a built-in [a x-title="console application"]App[/a]. It is available via composer: @@ -14,7 +14,7 @@ vendor/bin/bumbleDocGen list We use [Symfony Console](https://github.com/symfony/console) as the basis of the console application. -{{ "Built-in console commands" | textToHeading('H2') }} +## Built-in console commands @@ -31,7 +31,7 @@ We use [Symfony Console](https://github.com/symfony/console) as the basis of the {% endfor %}
-{{ "Adding a custom command" | textToHeading('H2') }} +## Adding a custom command The system allows you to add custom commands to a standard console application. This can be done using a special configuration option [a x-title="additional_console_commands"]Configuration::getAdditionalConsoleCommands()[/a] (see [a]Configuration[/a] page). diff --git a/selfdoc/templates/tech/06_debugging.md.twig b/selfdoc/templates/tech/06_debugging.md.twig index 80c64f51..b12f414c 100644 --- a/selfdoc/templates/tech/06_debugging.md.twig +++ b/selfdoc/templates/tech/06_debugging.md.twig @@ -4,7 +4,7 @@ prevPage: Technical description of the project --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Debug documents" | textToHeading('H1') }} +# Debug documents Our tool provides several options for debugging documentation. diff --git a/selfdoc/templates/tech/07_outputFormat.md.twig b/selfdoc/templates/tech/07_outputFormat.md.twig index 4feabc66..ccf7e7d5 100644 --- a/selfdoc/templates/tech/07_outputFormat.md.twig +++ b/selfdoc/templates/tech/07_outputFormat.md.twig @@ -4,7 +4,7 @@ prevPage: Technical description of the project --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Output formats" | textToHeading('H1') }} +# Output formats At the moment, the documentation generator is focused on creating documentation in two formats: [GitHub Flavored Markdown](https://github.github.com/gfm/) and HTML. However, it is possible to create other files with some restrictions. diff --git a/selfdoc/templates/tech/readme.md.twig b/selfdoc/templates/tech/readme.md.twig index 7e3efb2c..33a26434 100644 --- a/selfdoc/templates/tech/readme.md.twig +++ b/selfdoc/templates/tech/readme.md.twig @@ -3,15 +3,15 @@ title: Technical description of the project --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Technical description of the project" | textToHeading('H1') }} +# Technical description of the project This documentation generator is a library that allows you to create handwritten documentation with dynamic blocks that are loaded from the project code or other places. -{{ "Documentation sections" | textToHeading('H2') }} +## Documentation sections {{ drawDocumentationMenu(_self, 1) }} -{{ "How it works" | textToHeading('H2') }} +## How it works ```mermaid graph TD; @@ -30,10 +30,14 @@ This documentation generator is a library that allows you to create handwritten To start the documentation generation process, you need to call the following command: -{{ "(new DocGeneratorFactory())->create($configFile)->generate()" | textToCodeBlock('php') }} +```php +(new DocGeneratorFactory())->create($configFile)->generate(); +``` or -{{ "(new DocGeneratorFactory())->createByConfigArray($configArray)->generate()" | textToCodeBlock('php') }} +```php +(new DocGeneratorFactory())->createByConfigArray($configArray)->generate(); +``` After that, the process of parsing the project code according to the configuration will start, and then filling the templates with data and saving the finished result as final documents. From a7ca6abffbe9f6795e68d8eb6470c371a6284514 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Thu, 18 Jan 2024 14:39:10 +0300 Subject: [PATCH 07/32] Use more md syntax instead of filters --- .../Daux/templates/-Project_Structure/Entities_Map.md.twig | 2 +- .../Daux/templates/-Project_Structure/Project_Classes.md.twig | 2 +- .../templates/-Project_Structure/Project_Interfaces.md.twig | 2 +- .../Daux/templates/-Project_Structure/Project_Traits.md.twig | 2 +- .../CorePlugin/Daux/templates/-Project_Structure/index.md.twig | 2 +- .../EntityDocUnifiedPlace/templates/__structure/classes.md.twig | 2 +- .../templates/__structure/interfaces.md.twig | 2 +- .../EntityDocUnifiedPlace/templates/__structure/map.md.twig | 2 +- .../EntityDocUnifiedPlace/templates/__structure/readme.md.twig | 2 +- .../EntityDocUnifiedPlace/templates/__structure/traits.md.twig | 2 +- 10 files changed, 10 insertions(+), 10 deletions(-) diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Entities_Map.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Entities_Map.md.twig index 3b9bc477..356c08a3 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Entities_Map.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Entities_Map.md.twig @@ -4,6 +4,6 @@ prevPage: Project structure --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Entities map" | textToHeading('H1') }} +# Entities map {{ drawClassMap( phpEntities ) }} \ No newline at end of file diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Classes.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Classes.md.twig index af6001a4..0be48680 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Classes.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Classes.md.twig @@ -4,7 +4,7 @@ prevPage: Project structure --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Project classes" | textToHeading('H1') }} +# Project classes diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Interfaces.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Interfaces.md.twig index 43c47edc..ae2e5cff 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Interfaces.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Interfaces.md.twig @@ -4,7 +4,7 @@ prevPage: Project structure --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Project interfaces" | textToHeading('H1') }} +# Project interfaces
NameNamespace
diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Traits.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Traits.md.twig index a380c2e3..afc78600 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Traits.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Traits.md.twig @@ -4,7 +4,7 @@ prevPage: Project structure --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Project traits" | textToHeading('H1') }} +# Project traits
NameNamespace
diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/index.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/index.md.twig index 93a96255..e8f94804 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/index.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/index.md.twig @@ -4,7 +4,7 @@ prevPage: / --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Project structure" | textToHeading('H1') }} +# Project structure * Interfaces * Classes diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/classes.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/classes.md.twig index af6001a4..0be48680 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/classes.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/classes.md.twig @@ -4,7 +4,7 @@ prevPage: Project structure --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Project classes" | textToHeading('H1') }} +# Project classes
NameNamespace
diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/interfaces.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/interfaces.md.twig index 43c47edc..ae2e5cff 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/interfaces.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/interfaces.md.twig @@ -4,7 +4,7 @@ prevPage: Project structure --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Project interfaces" | textToHeading('H1') }} +# Project interfaces
NameNamespace
diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/map.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/map.md.twig index 3b9bc477..356c08a3 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/map.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/map.md.twig @@ -4,6 +4,6 @@ prevPage: Project structure --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Entities map" | textToHeading('H1') }} +# Entities map {{ drawClassMap( phpEntities ) }} \ No newline at end of file diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/readme.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/readme.md.twig index 93a96255..e8f94804 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/readme.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/readme.md.twig @@ -4,7 +4,7 @@ prevPage: / --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Project structure" | textToHeading('H1') }} +# Project structure * Interfaces * Classes diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/traits.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/traits.md.twig index a380c2e3..afc78600 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/traits.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/traits.md.twig @@ -4,7 +4,7 @@ prevPage: Project structure --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Project traits" | textToHeading('H1') }} +# Project traits
NameNamespace
From 6c657c49e8fd6f9fb2fd24cf42d06c2453c4143e Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Thu, 18 Jan 2024 14:39:23 +0300 Subject: [PATCH 08/32] Removing old functions --- .../Configuration/defaultConfiguration.yaml | 2 - .../Renderer/Twig/Filter/TextToCodeBlock.php | 34 --------------- .../Renderer/Twig/Filter/TextToHeading.php | 41 ------------------- 3 files changed, 77 deletions(-) delete mode 100644 src/Core/Renderer/Twig/Filter/TextToCodeBlock.php delete mode 100644 src/Core/Renderer/Twig/Filter/TextToHeading.php diff --git a/src/Core/Configuration/defaultConfiguration.yaml b/src/Core/Configuration/defaultConfiguration.yaml index 550dfb09..4787d329 100644 --- a/src/Core/Configuration/defaultConfiguration.yaml +++ b/src/Core/Configuration/defaultConfiguration.yaml @@ -28,8 +28,6 @@ twig_filters: # (array) Filters that - class: \BumbleDocGen\Core\Renderer\Twig\Filter\Quotemeta - class: \BumbleDocGen\Core\Renderer\Twig\Filter\RemoveLineBrakes - class: \BumbleDocGen\Core\Renderer\Twig\Filter\StrTypeToUrl - - class: \BumbleDocGen\Core\Renderer\Twig\Filter\TextToCodeBlock - - class: \BumbleDocGen\Core\Renderer\Twig\Filter\TextToHeading - class: \BumbleDocGen\Core\Renderer\Twig\Filter\PregMatch - class: \BumbleDocGen\Core\Renderer\Twig\Filter\Implode plugins: # (array|null) List of plugins diff --git a/src/Core/Renderer/Twig/Filter/TextToCodeBlock.php b/src/Core/Renderer/Twig/Filter/TextToCodeBlock.php deleted file mode 100644 index db9b6df6..00000000 --- a/src/Core/Renderer/Twig/Filter/TextToCodeBlock.php +++ /dev/null @@ -1,34 +0,0 @@ - ['html'], - ]; - } - - /** - * @param string $text Processed text - * @param string $codeBlockType Code block type (e.g. php or console ) - * @return string - */ - public function __invoke(string $text, string $codeBlockType): string - { - $addIndentFromLeftFunction = new AddIndentFromLeft(); - return "```{$codeBlockType}\n{$addIndentFromLeftFunction($text, 1)}\n```\n"; - } -} diff --git a/src/Core/Renderer/Twig/Filter/TextToHeading.php b/src/Core/Renderer/Twig/Filter/TextToHeading.php deleted file mode 100644 index a77ee06c..00000000 --- a/src/Core/Renderer/Twig/Filter/TextToHeading.php +++ /dev/null @@ -1,41 +0,0 @@ - "

%text%

", - 'h2' => "

%text%

", - 'h3' => "

%text%

", - ]; - - public static function getName(): string - { - return 'textToHeading'; - } - - public static function getOptions(): array - { - return [ - 'is_safe' => ['html'], - ]; - } - - /** - * @param string $text - * @param string $headingType Choose heading type: H1, H2, H3 - * @return string - */ - public function __invoke(string $text, string $headingType): string - { - $template = $this->templates[strtolower($headingType)] ?? '%text%'; - $content = str_replace('%text%', $text, $template); - return " {$content} "; - } -} From 7118cd281cf78e8174dc8369f9eb30f165a6f67b Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Thu, 18 Jan 2024 14:39:36 +0300 Subject: [PATCH 09/32] Fixing templates --- demo/demo1/templates/classMap/index.md.twig | 6 ++++-- demo/demo1/templates/readme.md.twig | 7 ++++--- .../sectionWithSubsections/classListExample/index.md.twig | 6 ++++-- demo/demo1/templates/sectionWithSubsections/index.md.twig | 6 ++++-- .../pageLinkingExample/index.md.twig | 2 +- demo/demo4-config-array/templates/README.md.twig | 6 ++++-- 6 files changed, 21 insertions(+), 12 deletions(-) diff --git a/demo/demo1/templates/classMap/index.md.twig b/demo/demo1/templates/classMap/index.md.twig index c44ae3d1..79f5b281 100644 --- a/demo/demo1/templates/classMap/index.md.twig +++ b/demo/demo1/templates/classMap/index.md.twig @@ -3,9 +3,11 @@ title: Class map --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Class map epample" | textToHeading('H1') }} +# Class map example -{{ "{{ drawClassMap( phpEntities ) }}" | textToCodeBlock('twig') }} +```twig +{{ "{{ drawClassMap( phpEntities ) }}" }} +``` **The result of the function execution:** diff --git a/demo/demo1/templates/readme.md.twig b/demo/demo1/templates/readme.md.twig index 95e4e70c..d26250ed 100644 --- a/demo/demo1/templates/readme.md.twig +++ b/demo/demo1/templates/readme.md.twig @@ -1,11 +1,12 @@ --- title: Demo 1 --- -{{ "Demo 1" | textToHeading('H1') }} +# Demo 1 {{ drawDocumentationMenu() }} - To update this documentation, run the following command: -{{ 'php demo/demo1/demoScript.php' | textToCodeBlock('console') }} \ No newline at end of file +```console +php demo/demo1/demoScript.php +``` \ No newline at end of file diff --git a/demo/demo1/templates/sectionWithSubsections/classListExample/index.md.twig b/demo/demo1/templates/sectionWithSubsections/classListExample/index.md.twig index 5aa0c947..38957350 100644 --- a/demo/demo1/templates/sectionWithSubsections/classListExample/index.md.twig +++ b/demo/demo1/templates/sectionWithSubsections/classListExample/index.md.twig @@ -3,10 +3,12 @@ title: Class list example --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Class list" | textToHeading('H1') }} +# Class list **List of classes filtered by the directory where they are located.** -{{ "{{ printEntityCollectionAsList( phpEntities.filterByPaths(['/annotations']) ) }}" | textToCodeBlock('twig') }} +```twig +{{ "{{ printEntityCollectionAsList( phpEntities.filterByPaths(['/annotations']) ) }}" }} +``` {{ printEntityCollectionAsList( phpEntities.filterByPaths(['/annotations']) ) }} diff --git a/demo/demo1/templates/sectionWithSubsections/index.md.twig b/demo/demo1/templates/sectionWithSubsections/index.md.twig index 3df87f7a..5affb6ce 100644 --- a/demo/demo1/templates/sectionWithSubsections/index.md.twig +++ b/demo/demo1/templates/sectionWithSubsections/index.md.twig @@ -3,9 +3,11 @@ title: Section with subsections --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Section with subsections example" | textToHeading('H1') }} +# Section with subsections example -{{ "{{ drawDocumentationMenu(_self) }}" | textToCodeBlock('twig') }} +```twig +{{ "{{ drawDocumentationMenu(_self) }}" }} +``` **Documentation menu from current page only:** diff --git a/demo/demo1/templates/sectionWithSubsections/pageLinkingExample/index.md.twig b/demo/demo1/templates/sectionWithSubsections/pageLinkingExample/index.md.twig index 543908a4..1e5121a8 100644 --- a/demo/demo1/templates/sectionWithSubsections/pageLinkingExample/index.md.twig +++ b/demo/demo1/templates/sectionWithSubsections/pageLinkingExample/index.md.twig @@ -3,7 +3,7 @@ title: Page linking example --- {{ generatePageBreadcrumbs(title, _self) }} -{{ "Page linking example" | textToHeading('H1') }} +# Page linking example 1) [a]InvalidArgumentException[/a] - create a reference by short class name 2) [a]Doctrine\Common\Annotations\AnnotationException[/a] - creating a reference by full class name diff --git a/demo/demo4-config-array/templates/README.md.twig b/demo/demo4-config-array/templates/README.md.twig index db1b72e3..3c4b6f30 100644 --- a/demo/demo4-config-array/templates/README.md.twig +++ b/demo/demo4-config-array/templates/README.md.twig @@ -1,10 +1,12 @@ --- title: Demo 5 --- -{{ "Demo 5" | textToHeading('H1') }} +# Demo 5 {{ printEntityCollectionAsList( phpEntities.filterByPaths(['/annotations']) ) }} To update this documentation, run the following command: -{{ 'php demo/demo4-config-array/demoScript.php' | textToCodeBlock('console') }} +```console +php demo/demo4-config-array/demoScript.php +``` From dfe1be323bf0c3c28ffa43cbad4d99e8d0512d50 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Thu, 18 Jan 2024 14:50:35 +0300 Subject: [PATCH 10/32] Page linker generates MD instead of HTML --- .../Plugin/CorePlugin/PageLinker/PageLinkerPlugin.php | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/src/Core/Plugin/CorePlugin/PageLinker/PageLinkerPlugin.php b/src/Core/Plugin/CorePlugin/PageLinker/PageLinkerPlugin.php index b2f36125..53e58497 100644 --- a/src/Core/Plugin/CorePlugin/PageLinker/PageLinkerPlugin.php +++ b/src/Core/Plugin/CorePlugin/PageLinker/PageLinkerPlugin.php @@ -5,7 +5,7 @@ namespace BumbleDocGen\Core\Plugin\CorePlugin\PageLinker; /** - * Adds URLs to empty links in HTML format; + * Adds URLs to empty links in MD format; * Links may contain: * 1) Short entity name * 2) Full entity name @@ -15,13 +15,13 @@ * 6) Relative reference to the entity document from the root directory of the documentation * * @example - * [a]Existent page name[/a] => Existent page name + * [a]Existent page name[/a] => [Existent page name](/docs/some/page/targetPage.md) * * @example - * [a x-title="Custom title"]\Namespace\ClassName[/a] => Custom title + * [a x-title="Custom title"]\Namespace\ClassName[/a] => [Custom title](/docs/some/page/ClassName.md) * * @example - * [a]\Namespace\ClassName[/a] => \Namespace\ClassName + * [a]\Namespace\ClassName[/a] => [\Namespace\ClassName](/docs/some/page/ClassName.md) * * @example * [a]Non-existent page name[/a] => Non-existent page name @@ -47,6 +47,6 @@ protected function getCustomTitleFromMatch(string $match): string protected function getOutputTemplate(): string { - return '%title%'; + return '[%title%](%url%)'; } } From 1faeba997ab19cc61eaf4fd2679c56516994908d Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Thu, 18 Jan 2024 15:07:07 +0300 Subject: [PATCH 11/32] Generate md instead of HTML --- .../Twig/Function/DrawDocumentationMenu.php | 27 +++++++++---------- 1 file changed, 13 insertions(+), 14 deletions(-) diff --git a/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php b/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php index 0b0beffd..e9cde08e 100644 --- a/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php +++ b/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php @@ -9,12 +9,13 @@ use BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper; use BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory; use BumbleDocGen\Core\Renderer\Context\RendererContext; +use BumbleDocGen\Core\Renderer\Twig\Filter\AddIndentFromLeft; use DI\DependencyException; use DI\NotFoundException; use Symfony\Component\Finder\Finder; /** - * Generate documentation menu in HTML format. To generate the menu, the start page is taken, + * Generate documentation menu in MD format. To generate the menu, the start page is taken, * and all links with this page are recursively collected for it, after which the html menu is created. * * @note This function initiates the creation of documents for the displayed entities @@ -28,10 +29,10 @@ final class DrawDocumentationMenu implements CustomFunctionInterface { public function __construct( - private Configuration $configuration, - private BreadcrumbsHelper $breadcrumbsHelper, - private RendererContext $rendererContext, - private RendererDependencyFactory $dependencyFactory, + private readonly Configuration $configuration, + private readonly BreadcrumbsHelper $breadcrumbsHelper, + private readonly RendererContext $rendererContext, + private readonly RendererDependencyFactory $dependencyFactory, ) { } @@ -94,20 +95,19 @@ public function __invoke(?string $startPageKey = null, ?int $maxDeep = null): st } $drawPages = function (array $pagesData, int $currentDeep = 1) use ($structure, $maxDeep, &$drawPages): string { - $html = '
    '; + $addIndentFromLeft = new AddIndentFromLeft(); + $md = ''; foreach ($pagesData as $pageData) { - $html .= "
  • "; - $html .= ""; + $md .= "\n- "; + $md .= "[{$pageData['title']}]({$pageData['url']})"; if ($structure[$pageData['url']]) { $nextDeep = $currentDeep + 1; if (!$maxDeep || $nextDeep <= $maxDeep) { - $html .= "
    {$drawPages($structure[$pageData['url']], $nextDeep)}
    "; + $md .= "{$addIndentFromLeft($drawPages($structure[$pageData['url']], $nextDeep), 4)}"; } } - $html .= "
  • "; } - $html .= "
"; - return $html; + return $md; }; if ($startPageKey) { @@ -118,7 +118,6 @@ public function __invoke(?string $startPageKey = null, ?int $maxDeep = null): st $startPageKey = array_key_first($structure); } - $content = isset($structure[$startPageKey]) ? $drawPages($structure[$startPageKey]) : ''; - return " {$content} "; + return isset($structure[$startPageKey]) ? $drawPages($structure[$startPageKey]) : ''; } } From 5fb2400af8143d3dc84528bab037e23c6f7d0d80 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Thu, 18 Jan 2024 17:17:34 +0300 Subject: [PATCH 12/32] Generate md instead of HTML --- .../LastPageCommitter/LastPageCommitter.php | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/src/Core/Plugin/CorePlugin/LastPageCommitter/LastPageCommitter.php b/src/Core/Plugin/CorePlugin/LastPageCommitter/LastPageCommitter.php index 994a192a..6f3ddea2 100644 --- a/src/Core/Plugin/CorePlugin/LastPageCommitter/LastPageCommitter.php +++ b/src/Core/Plugin/CorePlugin/LastPageCommitter/LastPageCommitter.php @@ -15,8 +15,8 @@ final class LastPageCommitter implements PluginInterface { public function __construct( - private RendererContext $context, - private Configuration $configuration + private readonly RendererContext $context, + private readonly Configuration $configuration ) { } @@ -41,10 +41,10 @@ final public function beforeCreatingDocFile(BeforeCreatingDocFile $event): void $content = $event->getContent(); if (isset($output[2]) && str_contains($output[2], 'Date: ')) { - $author = str_replace('Author:', 'Last page committer:', htmlspecialchars($output[1])); - $date = str_replace('Date:', 'Last modified date:', $output[2]); - $contentRegenerationDate = 'Page content update date: ' . date('D M d Y'); - $content .= "\n\n
\n
\n{$author}
{$date}
{$contentRegenerationDate}
Made with Bumble Documentation Generator
"; + $author = str_replace('Author:', '**Last page committer:**', htmlspecialchars($output[1])); + $date = str_replace('Date:', '**Last modified date:**', $output[2]); + $contentRegenerationDate = '**Page content update date:** ' . date('D M d Y'); + $content .= "\n\n---\n\n{$author}
{$date}
{$contentRegenerationDate}
Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md)"; } $event->setContent($content); } catch (\Exception) { From 4dbe85159fe8df08fd1fa15fee374a1d220b5a6f Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Thu, 18 Jan 2024 17:18:12 +0300 Subject: [PATCH 13/32] Generate md instead of HTML --- .../Function/PrintEntityCollectionAsList.php | 22 ++++++++++++------- 1 file changed, 14 insertions(+), 8 deletions(-) diff --git a/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php b/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php index 6b0a70ed..f9512760 100644 --- a/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php +++ b/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php @@ -6,9 +6,10 @@ use BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException; use BumbleDocGen\Core\Parser\Entity\RootEntityCollection; +use BumbleDocGen\Core\Renderer\Twig\Filter\RemoveLineBrakes; /** - * Outputting entity data as HTML list + * Outputting entity data as MD list * * @note This function initiates the creation of documents for the displayed entities * @@ -20,8 +21,10 @@ */ final class PrintEntityCollectionAsList implements CustomFunctionInterface { - public function __construct(private GetDocumentedEntityUrl $getDocumentedEntityUrlFunction) - { + public function __construct( + private readonly GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, + private readonly RemoveLineBrakes $removeLineBrakes + ) { } public static function getName(): string @@ -50,18 +53,21 @@ public function __invoke( bool $skipDescription = false, bool $useFullName = false, ): string { - $result = "<{$type}>"; + $result = ''; + $prefix = '1. '; + if ($type === 'ul') { + $prefix = '- '; + } foreach ($rootEntityCollection as $entity) { $description = $entity->getDescription(); - $descriptionText = !$skipDescription && $description ? " - {$description}" : ''; + $descriptionText = call_user_func($this->removeLineBrakes, !$skipDescription && $description ? " - {$description}" : ''); $entityDocUrl = call_user_func_array($this->getDocumentedEntityUrlFunction, [ $rootEntityCollection, $entity->getName() ]); $name = $useFullName ? $entity->getName() : $entity->getShortName(); - $result .= "
  • {$name}{$descriptionText}
  • "; + $result .= "{$prefix} [{$name}]({$entityDocUrl}){$descriptionText}\n"; } - $result .= ""; - return " {$result} "; + return $result; } } From 586857e1a9f3fe3c7acd8943d50849c9940f06fb Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Thu, 18 Jan 2024 17:18:29 +0300 Subject: [PATCH 14/32] Fix Daux links --- src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php index 08fbf021..26524b7f 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php @@ -53,7 +53,7 @@ final public function beforeCreatingDocFile(BeforeCreatingDocFile|BeforeCreating ); // MD links are not always converted to HTML correctly. This hack fixes that - $content = preg_replace('/\[([^\[]+)\]\((.*)\)/', '$1', $content); + $content = preg_replace('/\[([^\[]+)\]\(([^)]+)(\))/', '$1', $content); // Hack to make images work in generated HTML $content = preg_replace_callback('/(src=("|\')\/)([^"\']+)/', function (array $elements): string { From b988eb1d5b795ebe98fdd19459f7744567ef3b43 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Thu, 18 Jan 2024 17:19:08 +0300 Subject: [PATCH 15/32] Updating templates --- .../GetConfigParametersDescription.php | 9 +-- .../PrintClassCollectionAsGroupedTable.php | 16 +++--- .../templates/tech/01_configuration.md.twig | 19 ++----- .../templates/tech/02_parser/entity.md.twig | 56 ++++++------------- .../templates/tech/04_pluginSystem.md.twig | 23 +------- selfdoc/templates/tech/05_console.md.twig | 15 +---- 6 files changed, 38 insertions(+), 100 deletions(-) diff --git a/selfdoc/Twig/CustomFunction/GetConfigParametersDescription.php b/selfdoc/Twig/CustomFunction/GetConfigParametersDescription.php index d1abaf4b..07deaa2f 100644 --- a/selfdoc/Twig/CustomFunction/GetConfigParametersDescription.php +++ b/selfdoc/Twig/CustomFunction/GetConfigParametersDescription.php @@ -13,7 +13,7 @@ final class GetConfigParametersDescription implements CustomFunctionInterface { - public function __construct(private ConfigurationParameterBag $parameterBag) + public function __construct(private readonly ConfigurationParameterBag $parameterBag) { } @@ -30,11 +30,12 @@ public function __invoke(RootEntityCollection $rootEntityCollection, string $con $shortName = array_reverse(explode('\\', $defaultValue['class']))[0]; $tmpDefaultValue = "[a x-title='{$shortName}']{$defaultValue['class']}[/a]"; } else { - $tmpDefaultValue = "\n\n"; + $tmpDefaultValue = "
      "; foreach ($defaultValue as $v) { $shortName = array_reverse(explode('\\', $v['class']))[0]; - $tmpDefaultValue .= "- [a x-title='{$shortName}']{$v['class']}[/a]\n\n"; + $tmpDefaultValue .= "
    • [a x-title='{$shortName}']{$v['class']}[/a]
    • "; } + $tmpDefaultValue .= "
    "; } $defaultValue = $tmpDefaultValue; } else { @@ -42,7 +43,7 @@ public function __invoke(RootEntityCollection $rootEntityCollection, string $con } $params[] = [ 'key' => $name, - 'type' => str_replace([' ', '(', ')'], '', $matches[4] ?? ''), + 'type' => str_replace([' ', '(', ')', '|'], ['','','',' \\| '], $matches[4] ?? ''), 'description' => trim($matches[6] ?? ''), 'defaultValue' => $defaultValue, ]; diff --git a/selfdoc/Twig/CustomFunction/PrintClassCollectionAsGroupedTable.php b/selfdoc/Twig/CustomFunction/PrintClassCollectionAsGroupedTable.php index 165ee93c..5d0708a5 100644 --- a/selfdoc/Twig/CustomFunction/PrintClassCollectionAsGroupedTable.php +++ b/selfdoc/Twig/CustomFunction/PrintClassCollectionAsGroupedTable.php @@ -13,7 +13,7 @@ final class PrintClassCollectionAsGroupedTable implements CustomFunctionInterface { - public function __construct(private GetDocumentedEntityUrl $getDocumentedEntityUrlFunction) + public function __construct(private readonly GetDocumentedEntityUrl $getDocumentedEntityUrlFunction) { } @@ -39,20 +39,18 @@ public function __invoke(PhpEntitiesCollection $rootEntityCollection): string $groups = $this->groupEntities($rootEntityCollection); $getDocumentedEntityUrlFunction = $this->getDocumentedEntityUrlFunction; - $table = "
    NameNamespace
    "; - $table .= ""; + $table = "| Group name | Class short name | Description |\n"; + $table .= "|-|-|-|\n"; foreach ($groups as $groupKey => $entities) { $firstEntity = array_shift($entities); - $table .= ""; + $table .= "| **{$groupKey}** | [{$firstEntity->getShortName()}]({$getDocumentedEntityUrlFunction($rootEntityCollection, $firstEntity->getName())}) | {$firstEntity->getDescription()} |\n"; foreach ($entities as $entity) { - $table .= ""; + $table .= "| | [{$entity->getShortName()}]({$getDocumentedEntityUrlFunction($rootEntityCollection, $entity->getName())}) | {$entity->getDescription()} |\n"; } - $table .= ""; + $table .= "| | | |\n"; } - - $table .= "
    Group nameClass short nameDescription
    {$groupKey}{$firstEntity->getShortName()}{$firstEntity->getDescription()}
    {$entity->getShortName()}{$entity->getDescription()}
    "; - return " {$table} "; + return $table; } private function groupEntities(PhpEntitiesCollection $rootEntityCollection): array diff --git a/selfdoc/templates/tech/01_configuration.md.twig b/selfdoc/templates/tech/01_configuration.md.twig index 0b5b43bf..54f0fb0b 100644 --- a/selfdoc/templates/tech/01_configuration.md.twig +++ b/selfdoc/templates/tech/01_configuration.md.twig @@ -47,20 +47,9 @@ The inheritance algorithm is as follows: scalar types can be overwritten by each ## Configuration parameters {% set parameters = getConfigParametersDescription(phpEntities, '%WORKING_DIR%/src/Core/Configuration/defaultConfiguration.yaml') %} - - - - - - - - +| Key | Type | Default value | Description | +|-|-|-|-| {% for parameter in parameters %} - - - - - - +| **`{{ parameter.key }}`** | {{ parameter.type }} | {{ parameter.defaultValue | raw }} | {{ parameter.description }} | {% endfor %} -
    KeyTypeDefault valueDescription
    {{ parameter.key }}{{ parameter.type }}{{ parameter.defaultValue | raw }}{{ parameter.description }}
    + diff --git a/selfdoc/templates/tech/02_parser/entity.md.twig b/selfdoc/templates/tech/02_parser/entity.md.twig index 60ea04b0..39e4eb9e 100644 --- a/selfdoc/templates/tech/02_parser/entity.md.twig +++ b/selfdoc/templates/tech/02_parser/entity.md.twig @@ -55,54 +55,30 @@ To further facilitate the handling of these entities, we utilize entity collecti These collections not only group relevant entities together but also provide convenient methods for filtering and manipulating these entities. The root collections ([a]RootEntityCollection[/a]), which are directly accessible in your templates, are as follows: - - - - - - - - {% for entitiesCollection in phpEntities - .filterByParentClassNames(['BumbleDocGen\\Core\\Parser\\Entity\\RootEntityCollection']) - .getOnlyInstantiable() - %} - {% set match = entitiesCollection.getRelativeFileName() | preg_match('/(\\/LanguageHandler\\/)([\\s\\S]*?)(?=\\/)/i') %} - - - - - - - {% endfor %} -
    Collection className in twig templatePLDescription
    {{ drawDocumentedEntityLink(entitiesCollection) }}{{ entitiesCollection.getMethod('getEntityCollectionName', true).getFirstReturnValue() }}{{ match[2] | upper }}{{ entitiesCollection.getDescription() }}
    +| Collection class | Name in twig template | PL | Description | +|-|-|-|-| +{% for entitiesCollection in phpEntities + .filterByParentClassNames(['BumbleDocGen\\Core\\Parser\\Entity\\RootEntityCollection']) + .getOnlyInstantiable() +%} +{% set match = entitiesCollection.getRelativeFileName() | preg_match('/(\\/LanguageHandler\\/)([\\s\\S]*?)(?=\\/)/i') %} +| {{ drawDocumentedEntityLink(entitiesCollection) }} | **{{ entitiesCollection.getMethod('getEntityCollectionName', true).getFirstReturnValue() }}** | {{ match[2] | upper }} | {{ entitiesCollection.getDescription() }} | +{% endfor %} ## Available entities Following is the list of available entities that are consistent with [a]EntityInterface[/a] and can be created. These classes are a convenient wrapper for accessing data in templates: - - - - - - - - +| Entity name | Collection name | Is root | PL | Description | +|-|-|-|-|-| {% for entitiesCollection in phpEntities .filterByParentClassNames(['BumbleDocGen\\Core\\Parser\\Entity\\BaseEntityCollection']) .getOnlyInstantiable() %} - {% set match = entitiesCollection.getRelativeFileName() | preg_match('/(\\/LanguageHandler\\/)([\\s\\S]*?)(?=\\/)/i') %} - {% set entitiesClasses = findEntitiesClassesByCollectionClassName(entitiesCollection.getName()) %} - {% for entityClass in entitiesClasses %} - - - - - - - - {% endfor %} +{% set match = entitiesCollection.getRelativeFileName() | preg_match('/(\\/LanguageHandler\\/)([\\s\\S]*?)(?=\\/)/i') %} +{% set entitiesClasses = findEntitiesClassesByCollectionClassName(entitiesCollection.getName()) %} +{% for entityClass in entitiesClasses %} +| {{ drawDocumentedEntityLink(entityClass) }} | {{ drawDocumentedEntityLink(entitiesCollection) }} | {% if entityClass.implementsInterface('BumbleDocGen\\Core\\Parser\\Entity\\RootEntityInterface') %}yes{% else %}no{% endif %} | {{ match[2] | upper }} | {{ entityClass.getDescription() }} | {% endfor %} -
    Entity nameCollection nameIs rootPLDescription
    {{ drawDocumentedEntityLink(entityClass) }}{{ drawDocumentedEntityLink(entitiesCollection) }}{% if entityClass.implementsInterface('BumbleDocGen\\Core\\Parser\\Entity\\RootEntityInterface') %}yes{% else %}no{% endif %}{{ match[2] | upper }}{{ entityClass.getDescription() }}
    \ No newline at end of file +{% endfor %} \ No newline at end of file diff --git a/selfdoc/templates/tech/04_pluginSystem.md.twig b/selfdoc/templates/tech/04_pluginSystem.md.twig index 169e5e8e..a8656722 100644 --- a/selfdoc/templates/tech/04_pluginSystem.md.twig +++ b/selfdoc/templates/tech/04_pluginSystem.md.twig @@ -25,13 +25,8 @@ plugins: Below are the plugins that are available by default when working with the library. Plugins for any programming languages work regardless of which language handler is configured in the configuration. - - - - - - - +| Plugin | PL | Handles events | Description | +|-|-|-|-| {% for pluginEntity in phpEntities .filterByPaths([ '/src/Core', @@ -41,20 +36,8 @@ Plugins for any programming languages work regardless of which language handler .getOnlyInstantiable() %} {% set match = pluginEntity.getRelativeFileName() | preg_match('/(\\/LanguageHandler\\/)([\\s\\S]*?)(?=\\/)/i') %} - - - - - - +| {{ drawDocumentedEntityLink(pluginEntity) }} | {% if match[2] %}{{ match[2] | upper }}{% else %}any{% endif %} |
      {% for key in pluginEntity.getMethod('getSubscribedEvents', true).getFirstReturnValue() | keys %}
    • [a]{{ key }}|short_form[/a]
    • {% endfor %}
    | {{ pluginEntity.getDescription() | removeLineBrakes }} | {% endfor %} -
    PluginPLHandles eventsDescription
    {{ drawDocumentedEntityLink(pluginEntity) }}{% if match[2] %}{{ match[2] | upper }}{% else %}any{% endif %} -
      - {% for key in pluginEntity.getMethod('getSubscribedEvents', true).getFirstReturnValue() | keys %} -
    • [a]{{ key }}|short_form[/a]
    • - {% endfor %} -
    -
    {{ pluginEntity.getDescription() }}
    ## Default events diff --git a/selfdoc/templates/tech/05_console.md.twig b/selfdoc/templates/tech/05_console.md.twig index dccf97a1..0e6edde8 100644 --- a/selfdoc/templates/tech/05_console.md.twig +++ b/selfdoc/templates/tech/05_console.md.twig @@ -16,20 +16,11 @@ We use [Symfony Console](https://github.com/symfony/console) as the basis of the ## Built-in console commands - - - - - - +| Command | Parameters | Description | +|-|-|-| {% for consoleCommandData in getConsoleCommands() %} - - - - - +| [{{ consoleCommandData.name }}]({{ getDocumentedEntityUrl(phpEntities, consoleCommandData.class) }}) | {{ consoleCommandData.synopsis|raw }} | {{ consoleCommandData.description }} | {% endfor %} -
    CommandParametersDescription
    {{ consoleCommandData.name }}{{ consoleCommandData.synopsis|raw }}{{ consoleCommandData.description }}
    ## Adding a custom command From b224447b170e1c5fa93b75d9fd8f2d13a8ab02a6 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Thu, 18 Jan 2024 17:19:34 +0300 Subject: [PATCH 16/32] Updating doc --- UPGRADE.md | 4 + docs/README.md | 83 +- docs/classes/DocGenerator.md | 594 +-- docs/classes/DocGeneratorFactory.md | 377 +- .../InvalidConfigurationParameterException.md | 31 - docs/shared_c.cache | 2 +- docs/tech/01_configuration.md | 281 +- .../ClassConstantEntitiesCollection.md | 398 +- .../02_parser/classes/ClassConstantEntity.md | 1421 ++----- .../classes/ClassConstantEntity_2.md | 1420 ++----- docs/tech/02_parser/classes/ClassEntity.md | 3279 +++------------ .../tech/02_parser/classes/ClassLikeEntity.md | 3236 +++------------ docs/tech/02_parser/classes/ConditionGroup.md | 128 +- .../02_parser/classes/ConditionInterface.md | 75 +- docs/tech/02_parser/classes/Configuration.md | 734 +--- .../classes/DirectoriesSourceLocator.md | 101 +- .../02_parser/classes/DynamicMethodEntity.md | 820 +--- .../tech/02_parser/classes/EntityInterface.md | 211 - docs/tech/02_parser/classes/EnumEntity.md | 3551 ++++------------ docs/tech/02_parser/classes/FalseCondition.md | 76 +- .../classes/FileIteratorSourceLocator.md | 101 +- .../classes/FileTextContainsCondition.md | 120 +- .../tech/02_parser/classes/InterfaceEntity.md | 3249 +++------------ .../InvalidConfigurationParameterException.md | 31 - .../02_parser/classes/IsPrivateCondition.md | 101 +- .../02_parser/classes/IsPrivateCondition_2.md | 101 +- .../02_parser/classes/IsPrivateCondition_3.md | 101 +- .../02_parser/classes/IsProtectedCondition.md | 101 +- .../classes/IsProtectedCondition_2.md | 101 +- .../classes/IsProtectedCondition_3.md | 101 +- .../02_parser/classes/IsPublicCondition.md | 101 +- .../02_parser/classes/IsPublicCondition_2.md | 101 +- .../02_parser/classes/IsPublicCondition_3.md | 101 +- .../02_parser/classes/LocatedInCondition.md | 139 +- .../classes/LocatedNotInCondition.md | 139 +- .../classes/MethodEntitiesCollection.md | 466 +-- docs/tech/02_parser/classes/MethodEntity.md | 1676 ++------ .../classes/OnlyFromCurrentClassCondition.md | 76 +- .../OnlyFromCurrentClassCondition_2.md | 76 +- .../classes/PhpEntitiesCollection.md | 1219 ++---- .../02_parser/classes/PhpHandlerSettings.md | 484 +-- docs/tech/02_parser/classes/ProjectParser.md | 220 +- .../classes/PropertyEntitiesCollection.md | 413 +- docs/tech/02_parser/classes/PropertyEntity.md | 1492 ++----- .../RecursiveDirectoriesSourceLocator.md | 113 +- .../02_parser/classes/RootEntityCollection.md | 561 --- .../02_parser/classes/RootEntityInterface.md | 440 +- .../classes/SingleFileSourceLocator.md | 101 +- .../classes/SourceLocatorInterface.md | 56 +- docs/tech/02_parser/classes/TraitEntity.md | 3249 +++------------ docs/tech/02_parser/classes/TrueCondition.md | 76 +- .../02_parser/classes/VisibilityCondition.md | 120 +- .../classes/VisibilityCondition_2.md | 120 +- .../classes/VisibilityCondition_3.md | 120 +- docs/tech/02_parser/entity.md | 154 +- docs/tech/02_parser/entityFilterCondition.md | 58 +- docs/tech/02_parser/readme.md | 49 +- .../classes/RootEntityCollectionsGroup.md | 323 +- .../php/classes/ClassConstantEntity.md | 1423 ++----- .../php/classes/ClassConstantEntity_2.md | 1422 ++----- .../reflectionApi/php/classes/ClassEntity.md | 3281 +++------------ .../php/classes/ClassLikeEntity.md | 3239 +++------------ .../php/classes/ClassLikeEntity_2.md | 3239 +++------------ .../php/classes/ClassLikeEntity_3.md | 3239 +++------------ .../php/classes/ClassLikeEntity_4.md | 3239 +++------------ .../php/classes/ClassLikeEntity_5.md | 3238 +++------------ .../php/classes/Configuration.md | 736 +--- .../reflectionApi/php/classes/EnumEntity.md | 3553 ++++------------- .../php/classes/InterfaceEntity.md | 3251 +++------------ .../InvalidConfigurationParameterException.md | 31 - .../reflectionApi/php/classes/MethodEntity.md | 1678 ++------ .../php/classes/PhpEntitiesCollection.md | 1221 ++---- .../php/classes/PhpHandlerSettings.md | 486 +-- .../php/classes/PropertyEntity.md | 1494 ++----- .../php/classes/RootEntityInterface.md | 442 +- .../reflectionApi/php/classes/TraitEntity.md | 3251 +++------------ .../php/phpClassConstantReflectionApi.md | 22 +- .../php/phpClassMethodReflectionApi.md | 20 +- .../php/phpClassPropertyReflectionApi.md | 20 +- .../php/phpClassReflectionApi.md | 20 +- .../php/phpEntitiesCollection.md | 18 +- .../reflectionApi/php/phpEnumReflectionApi.md | 20 +- .../php/phpInterfaceReflectionApi.md | 20 +- .../php/phpTraitReflectionApi.md | 20 +- .../02_parser/reflectionApi/php/readme.md | 39 +- docs/tech/02_parser/reflectionApi/readme.md | 90 +- docs/tech/02_parser/sourceLocator.md | 37 +- .../classes/Configuration.md | 736 +--- .../classes/Configuration_2.md | 735 +--- .../classes/DocumentedEntityWrapper.md | 290 +- .../DocumentedEntityWrappersCollection.md | 210 +- .../classes/DrawDocumentationMenu.md | 226 +- .../classes/GetDocumentationPageUrl.md | 204 +- .../classes/GetDocumentedEntityUrl.md | 247 +- .../classes/GetDocumentedEntityUrl_2.md | 246 +- .../InvalidConfigurationParameterException.md | 31 - .../classes/LanguageHandlerInterface.md | 164 +- .../classes/PageHtmlLinkerPlugin.md | 187 +- .../classes/PhpEntitiesCollection.md | 1220 ++---- .../classes/RendererContext.md | 248 +- .../classes/RootEntityInterface.md | 441 +- .../01_howToCreateTemplates/frontMatter.md | 21 +- .../01_howToCreateTemplates/readme.md | 131 +- .../templatesDynamicBlocks.md | 26 +- .../templatesLinking.md | 25 +- .../templatesVariables.md | 19 +- docs/tech/03_renderer/02_breadcrumbs.md | 43 +- docs/tech/03_renderer/03_documentStructure.md | 16 +- docs/tech/03_renderer/04_twigCustomFilters.md | 78 +- .../03_renderer/05_twigCustomFunctions.md | 80 +- .../03_renderer/classes/AddIndentFromLeft.md | 132 +- .../03_renderer/classes/BreadcrumbsHelper.md | 714 +--- .../tech/03_renderer/classes/Configuration.md | 734 +--- .../classes/CustomFunctionInterface.md | 78 +- .../classes/DisplayClassApiMethods.md | 188 +- .../classes/DocumentedEntityWrapper.md | 289 +- .../DocumentedEntityWrappersCollection.md | 209 +- docs/tech/03_renderer/classes/DrawClassMap.md | 297 +- .../classes/DrawDocumentationMenu.md | 225 +- .../classes/DrawDocumentedEntityLink.md | 198 +- .../03_renderer/classes/FileGetContents.md | 180 +- docs/tech/03_renderer/classes/FixStrSize.md | 132 +- .../classes/GeneratePageBreadcrumbs.md | 212 +- .../classes/GeneratePageBreadcrumbs_2.md | 212 +- .../classes/GetClassMethodsBodyCode.md | 188 +- .../classes/GetDocumentationPageUrl.md | 203 +- .../classes/GetDocumentedEntityUrl.md | 246 +- .../classes/GetDocumentedEntityUrl_2.md | 245 +- docs/tech/03_renderer/classes/Implode.md | 133 +- .../InvalidConfigurationParameterException.md | 31 - .../03_renderer/classes/LoadPluginsContent.md | 183 +- .../classes/PhpEntitiesCollection.md | 1219 ++---- docs/tech/03_renderer/classes/PregMatch.md | 133 +- .../03_renderer/classes/PrepareSourceLink.md | 120 +- .../classes/PrintEntityCollectionAsList.md | 199 +- docs/tech/03_renderer/classes/Quotemeta.md | 127 +- .../03_renderer/classes/RemoveLineBrakes.md | 120 +- .../03_renderer/classes/RendererContext.md | 247 +- .../classes/RootEntityCollection.md | 576 +-- .../classes/RootEntityInterface.md | 441 +- .../classes/RootEntityInterface_2.md | 440 +- docs/tech/03_renderer/classes/StrTypeToUrl.md | 204 +- .../03_renderer/classes/TextToCodeBlock.md | 145 - .../tech/03_renderer/classes/TextToHeading.md | 145 - docs/tech/03_renderer/readme.md | 41 +- docs/tech/04_pluginSystem.md | 205 +- docs/tech/05_console.md | 74 +- docs/tech/06_debugging.md | 15 +- docs/tech/07_outputFormat.md | 19 +- docs/tech/classes/AddDocBlocksCommand.md | 85 +- docs/tech/classes/AddIndentFromLeft.md | 131 +- .../AfterLoadingPhpEntitiesCollection.md | 100 +- docs/tech/classes/AfterRenderingEntities.md | 26 +- docs/tech/classes/App.md | 54 +- docs/tech/classes/BasePageLinkProcessor.md | 118 +- docs/tech/classes/BasePhpStubberPlugin.md | 138 +- docs/tech/classes/BeforeCreatingDocFile.md | 210 +- .../classes/BeforeCreatingEntityDocFile.md | 209 +- docs/tech/classes/BeforeParsingProcess.md | 54 +- docs/tech/classes/BeforeRenderingDocFiles.md | 27 +- docs/tech/classes/BeforeRenderingEntities.md | 27 +- docs/tech/classes/Configuration.md | 734 +--- docs/tech/classes/ConfigurationCommand.md | 73 +- docs/tech/classes/Daux.md | 314 +- docs/tech/classes/DocGenerator.md | 596 +-- docs/tech/classes/DocumentedEntityWrapper.md | 288 +- .../DocumentedEntityWrappersCollection.md | 208 +- docs/tech/classes/DrawDocumentationMenu.md | 224 +- docs/tech/classes/DrawDocumentedEntityLink.md | 197 +- .../classes/EntityDocUnifiedPlacePlugin.md | 188 +- docs/tech/classes/FileGetContents.md | 179 +- docs/tech/classes/FixStrSize.md | 131 +- docs/tech/classes/GenerateCommand.md | 73 +- docs/tech/classes/GeneratePageBreadcrumbs.md | 211 +- .../classes/GenerateReadMeTemplateCommand.md | 85 +- docs/tech/classes/GetDocumentationPageUrl.md | 202 +- docs/tech/classes/GetDocumentedEntityUrl.md | 245 +- docs/tech/classes/GetDocumentedEntityUrl_2.md | 244 +- docs/tech/classes/Implode.md | 132 +- .../InvalidConfigurationParameterException.md | 31 - docs/tech/classes/LastPageCommitter.md | 147 +- docs/tech/classes/LoadPluginsContent.md | 182 +- docs/tech/classes/LoadPluginsContent_2.md | 181 +- .../classes/OnAddClassEntityToCollection.md | 150 +- .../classes/OnCheckIsEntityCanBeLoaded.md | 160 +- .../OnCreateDocumentedEntityWrapper.md | 100 +- .../tech/classes/OnGetProjectTemplatesDirs.md | 141 +- .../OnGetTemplatePathByRelativeDocPath.md | 163 +- docs/tech/classes/OnGettingResourceLink.md | 163 +- .../classes/OnLoadEntityDocPluginContent.md | 226 +- docs/tech/classes/PageHtmlLinkerPlugin.md | 185 +- docs/tech/classes/PageHtmlLinkerPlugin_2.md | 185 +- docs/tech/classes/PageLinkerPlugin.md | 191 +- docs/tech/classes/PageLinkerPlugin_2.md | 191 +- docs/tech/classes/PageRstLinkerPlugin.md | 181 +- .../classes/PhpDocumentorStubberPlugin.md | 138 +- docs/tech/classes/PhpUnitStubberPlugin.md | 138 +- docs/tech/classes/PluginInterface.md | 31 - docs/tech/classes/PregMatch.md | 132 +- docs/tech/classes/PrepareSourceLink.md | 119 +- .../classes/PrintEntityCollectionAsList.md | 198 +- docs/tech/classes/Quotemeta.md | 126 +- docs/tech/classes/RemoveLineBrakes.md | 119 +- docs/tech/classes/RendererContext.md | 246 +- docs/tech/classes/ServeCommand.md | 73 +- docs/tech/classes/StrTypeToUrl.md | 203 +- docs/tech/classes/StubberPlugin.md | 196 +- docs/tech/classes/TextToCodeBlock.md | 145 - docs/tech/classes/TextToHeading.md | 145 - docs/tech/readme.md | 33 +- 210 files changed, 18317 insertions(+), 78889 deletions(-) delete mode 100644 docs/classes/InvalidConfigurationParameterException.md delete mode 100644 docs/tech/02_parser/classes/EntityInterface.md delete mode 100644 docs/tech/02_parser/classes/InvalidConfigurationParameterException.md delete mode 100644 docs/tech/02_parser/classes/RootEntityCollection.md delete mode 100644 docs/tech/02_parser/reflectionApi/php/classes/InvalidConfigurationParameterException.md delete mode 100644 docs/tech/03_renderer/01_howToCreateTemplates/classes/InvalidConfigurationParameterException.md delete mode 100644 docs/tech/03_renderer/classes/InvalidConfigurationParameterException.md delete mode 100644 docs/tech/03_renderer/classes/TextToCodeBlock.md delete mode 100644 docs/tech/03_renderer/classes/TextToHeading.md delete mode 100644 docs/tech/classes/InvalidConfigurationParameterException.md delete mode 100644 docs/tech/classes/PluginInterface.md delete mode 100644 docs/tech/classes/TextToCodeBlock.md delete mode 100644 docs/tech/classes/TextToHeading.md diff --git a/UPGRADE.md b/UPGRADE.md index e6a60304..c835a756 100644 --- a/UPGRADE.md +++ b/UPGRADE.md @@ -33,3 +33,7 @@ This document serves as a reference for updating your current version of the Bum * Class `\BumbleDocGen\LanguageHandler\Php\Plugin\Event\Entity\OnCheckIsClassEntityCanBeLoad` has been removed. Use `\BumbleDocGen\LanguageHandler\Php\Plugin\Event\Entity\OnCheckIsEntityCanBeLoaded` * ⚠️**PHP ReflectionAPI has been completely changed. See information about the current version here:** [ReflectionAPI](https://github.com/bumble-tech/bumble-doc-gen/tree/master/docs/tech/2.parser/reflectionApi) * Method `\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getComposerInstalledFile()` renamed to `\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getComposerVendorDir()` +* Twig filter `\BumbleDocGen\Core\Renderer\Twig\Filter\TextToCodeBlock` removed +* Twig filter `\BumbleDocGen\Core\Renderer\Twig\Filter\TextToHeading` removed +* Plugin `\BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\PageLinkerPlugin` now generates MD instead of HTML +* Twig filter `\BumbleDocGen\Core\Renderer\Twig\Function\GeneratePageBreadcrumbs` now generates MD instead of HTML diff --git a/docs/README.md b/docs/README.md index df55c273..8270416f 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,86 +1,82 @@ -

    BumbleDocGen: A Documentation Generator for PHP projects 🐝

    +# BumbleDocGen: A Documentation Generator for PHP projects 🐝 -BumbleDocGen is a robust library for generating and maintaining documentation next to the code of large and small PHP projects. +**BumbleDocGen** is a robust library for generating and maintaining documentation next to the code of large and small PHP projects. This tool analyzes your codebase and produces a comprehensive set of Markdown documents, including descriptions of classes, methods, and properties alongside navigable internal links. -

    Installation

    +## Installation Add the BumbleDocGen to the `composer.json` file of your project using the following command: ```console - composer require bumble-tech/bumble-doc-gen +composer require bumble-tech/bumble-doc-gen ``` +## Detailed technical description -

    Detailed technical description

    +💡 Please refer to the [Description of the technical part of the project](/docs/tech/readme.md) for a detailed explanation of all the classes and methods used. -💡 Please refer to the Description of the technical part of the project for a detailed explanation of all the classes and methods used. +## Core Features -

    Core Features

    +1. 🔍 **[Parsing](/docs/tech/02_parser/readme.md):** + BumbleDocGen analyzes your code and provides a convenient [Reflection API](/docs/tech/02_parser/reflectionApi/readme.md). -- 🔍 Parsing: - BumbleDocGen analyzes your code and provides a convenient Reflection API. - -- ✍️ Rendering: +2. ✍️ **[Rendering](/docs/tech/03_renderer/readme.md):** BumbleDocGen generates markdown content using templates and fills them with data obtained from parsing your code. -- 🧠 AI tools for documentation generation: +3. 🧠 **AI tools for documentation generation:** BumbleDocGen allows you to use a group of AI tools to help generate project documentation. -

    How to Use

    +## How to Use -

    Entry points

    +### Entry points -BumbleDocGen's interface consists of mainly two classes: DocGenerator and DocGeneratorFactory. +BumbleDocGen's interface consists of mainly two classes: [DocGenerator](/docs/classes/DocGenerator.md) and [DocGeneratorFactory](/docs/classes/DocGeneratorFactory.md). -- DocGenerator provides main operations for generating the documents. +- [DocGenerator](/docs/classes/DocGenerator.md) provides main operations for generating the documents. - [addDocBlocks()](/docs/classes/DocGenerator.md#madddocblocks): Generate missing docBlocks with LLM for project class methods that are available for documentation - [generate()](/docs/classes/DocGenerator.md#mgenerate): Generates documentation using configuration - [generateReadmeTemplate()](/docs/classes/DocGenerator.md#mgeneratereadmetemplate): Creates a `README.md` template filled with basic information using LLM - [serve()](/docs/classes/DocGenerator.md#mserve): Serve documentation -- DocGeneratorFactory provides a method for creating `DocGenerator` instance. +- [DocGeneratorFactory](/docs/classes/DocGeneratorFactory.md) provides a method for creating `DocGenerator` instance. - [create()](/docs/classes/DocGeneratorFactory.md#mcreate): Creates a documentation generator instance using configuration files - [createByConfigArray()](/docs/classes/DocGeneratorFactory.md#mcreatebyconfigarray): Creates a documentation generator instance using an array containing the configuration - [createConfiguration()](/docs/classes/DocGeneratorFactory.md#mcreateconfiguration): Creating a project configuration instance - [createRootEntitiesCollection()](/docs/classes/DocGeneratorFactory.md#mcreaterootentitiescollection): Creating a collection of entities (see `ReflectionAPI`) -

    Examples of usage

    +### Examples of usage 1) Working with a library in a PHP file + ```php + require_once 'vendor/autoload.php'; -```php -require_once 'vendor/autoload.php'; - -use BumbleDocGen\DocGeneratorFactory; - -// Initialize the factory -$factory = new DocGeneratorFactory(); + use BumbleDocGen\DocGeneratorFactory; -// Create a DocGenerator instance -$docgen = $factory->create('/path/to/configuration/files'); + // Initialize the factory + $factory = new DocGeneratorFactory(); -// or $docgen = $factory->createByConfigArray([...]); + // Create a DocGenerator instance + $docgen = $factory->create('/path/to/configuration/files'); -// Now call the desired operation -$docgen->generate(); -``` + // or $docgen = $factory->createByConfigArray([...]); + // Now call the desired operation + $docgen->generate(); + ``` 2) Working with the library through a console application + ```bash + # List of available commands + ./vendor/bin/bumbleDocGen list -```bash -# List of available commands -./vendor/bin/bumbleDocGen list - -# Documentation generation example -./vendor/bin/bumbleDocGen generate -c + # Documentation generation example + ./vendor/bin/bumbleDocGen generate -c -# Getting detailed information about a command -./vendor/bin/bumbleDocGen generate -h -``` + # Getting detailed information about a command + ./vendor/bin/bumbleDocGen generate -h + ``` ------------------ @@ -89,11 +85,10 @@ $docgen->generate(); To update this documentation, run the following command: ```console - ./bin/bumbleDocGen generate +./bin/bumbleDocGen generate ``` +--- -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Sat Dec 23 23:00:37 2023 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/classes/DocGenerator.md b/docs/classes/DocGenerator.md index fed1ae00..3357fd25 100644 --- a/docs/classes/DocGenerator.md +++ b/docs/classes/DocGenerator.md @@ -1,577 +1,173 @@ - BumbleDocGen / DocGenerator
    - -

    - DocGenerator class: -

    - +[BumbleDocGen](/docs/README.md) **/** +DocGenerator +--- +# [DocGenerator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L46) class: ```php namespace BumbleDocGen; final class DocGenerator ``` +Class for generating documentation. -
    Class for generating documentation.
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - addDocBlocks - - Generate missing docBlocks with LLM for project class methods that are available for documentation
    2. -
    3. - addPlugin -
    4. -
    5. - generate - - Generates documentation using configuration
    6. -
    7. - generateReadmeTemplate - - Creates a `README.md` template filled with basic information using LLM
    8. -
    9. - getConfiguration -
    10. -
    11. - getConfigurationKey -
    12. -
    13. - getConfigurationKeys -
    14. -
    15. - parseAndGetRootEntityCollectionsGroup -
    16. -
    17. - serve - - Serve documentation
    18. -
    +## Initialization methods +1. [__construct](#m-construct) +## Methods -

    Constants:

    - +1. [addDocBlocks](#madddocblocks) - Generate missing docBlocks with LLM for project class methods that are available for documentation +1. [addPlugin](#maddplugin) +1. [generate](#mgenerate) - Generates documentation using configuration +1. [generateReadmeTemplate](#mgeneratereadmetemplate) - Creates a `README.md` template filled with basic information using LLM +1. [getConfiguration](#mgetconfiguration) +1. [getConfigurationKey](#mgetconfigurationkey) +1. [getConfigurationKeys](#mgetconfigurationkeys) +1. [parseAndGetRootEntityCollectionsGroup](#mparseandgetrootentitycollectionsgroup) +1. [serve](#mserve) - Serve documentation +## Methods details: - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L56) ```php public function __construct(\Symfony\Component\Console\Style\OutputStyle $io, \BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Plugin\PluginEventDispatcher $pluginEventDispatcher, \BumbleDocGen\Core\Parser\ProjectParser $parser, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\Core\Renderer\Renderer $renderer, \BumbleDocGen\Core\Logger\Handler\GenerationErrorsHandler $generationErrorsHandler, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Console\ProgressBar\ProgressBarFactory $progressBarFactory, \DI\Container $diContainer, \BumbleDocGen\Core\Cache\SharedCompressedDocumentFileCache $sharedCompressedDocumentFileCache, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Monolog\Logger $logger); ``` - - -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $io\Symfony\Component\Console\Style\OutputStyle-
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $pluginEventDispatcher\BumbleDocGen\Core\Plugin\PluginEventDispatcher-
    $parser\BumbleDocGen\Core\Parser\ProjectParser-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $renderer\BumbleDocGen\Core\Renderer\Renderer-
    $generationErrorsHandler\BumbleDocGen\Core\Logger\Handler\GenerationErrorsHandler-
    $rootEntityCollectionsGroup\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup-
    $progressBarFactory\BumbleDocGen\Console\ProgressBar\ProgressBarFactory-
    $diContainer\DI\Container-
    $sharedCompressedDocumentFileCache\BumbleDocGen\Core\Cache\SharedCompressedDocumentFileCache-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Monolog\Logger-
    - - - -Throws: - - -
    -
    -
    - - - +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$io | [\Symfony\Component\Console\Style\OutputStyle](https://github.com/symfony/console/blob/master/Style/OutputStyle.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$pluginEventDispatcher | [\BumbleDocGen\Core\Plugin\PluginEventDispatcher](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginEventDispatcher.php) | - | +$parser | [\BumbleDocGen\Core\Parser\ProjectParser](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/ProjectParser.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$renderer | [\BumbleDocGen\Core\Renderer\Renderer](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Renderer.php) | - | +$generationErrorsHandler | [\BumbleDocGen\Core\Logger\Handler\GenerationErrorsHandler](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Logger/Handler/GenerationErrorsHandler.php) | - | +$rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | +$progressBarFactory | [\BumbleDocGen\Console\ProgressBar\ProgressBarFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/ProgressBar/ProgressBarFactory.php) | - | +$diContainer | [\DI\Container](https://github.com/PHP-DI/PHP-DI/blob/master/src/Container.php) | - | +$sharedCompressedDocumentFileCache | [\BumbleDocGen\Core\Cache\SharedCompressedDocumentFileCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/SharedCompressedDocumentFileCache.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/Monolog/Logger.php) | - | + +--- + +# `addDocBlocks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L116) ```php public function addDocBlocks(\BumbleDocGen\AI\ProviderInterface $aiProvider): void; ``` +Generate missing docBlocks with LLM for project class methods that are available for documentation -
    Generate missing docBlocks with LLM for project class methods that are available for documentation
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $aiProvider\BumbleDocGen\AI\ProviderInterface-
    +| Name | Type | Description | +|:-|:-|:-| +$aiProvider | [\BumbleDocGen\AI\ProviderInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/AI/ProviderInterface.php) | - | -Return value: void +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Throws: - - -
    -
    -
    - - - +# `addPlugin` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L85) ```php public function addPlugin(\BumbleDocGen\Core\Plugin\PluginInterface|string $plugin): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$plugin | [\BumbleDocGen\Core\Plugin\PluginInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginInterface.php) \| [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $plugin\BumbleDocGen\Core\Plugin\PluginInterface | string-
    - -Return value: void - - -Throws: - - -
    -
    -
    - - +--- +# `generate` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L287) ```php public function generate(): void; ``` +Generates documentation using configuration -
    Generates documentation using configuration
    - -Parameters: not specified - -Return value: void - - -Throws: - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - - +--- +# `generateReadmeTemplate` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L200) ```php public function generateReadmeTemplate(\BumbleDocGen\AI\ProviderInterface $aiProvider): void; ``` +Creates a `README.md` template filled with basic information using LLM -
    Creates a `README.md` template filled with basic information using LLM
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $aiProvider\BumbleDocGen\AI\ProviderInterface-
    - -Return value: void - - -Throws: - - -
    -
    -
    - - +--- +# `getConfiguration` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L534) ```php public function getConfiguration(): \BumbleDocGen\Core\Configuration\Configuration; ``` +***Return value:*** [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Configuration\Configuration - - -
    -
    -
    - - - +# `getConfigurationKey` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L431) ```php public function getConfigurationKey(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - - -Throws: - - -
    -
    -
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - +--- +# `getConfigurationKeys` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L419) ```php public function getConfigurationKeys(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - -
      -
    • # - parseAndGetRootEntityCollectionsGroup - | source code
    • -
    - +# `parseAndGetRootEntityCollectionsGroup` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L100) ```php public function parseAndGetRootEntityCollectionsGroup(): \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup - - -Throws: - - -
    -
    -
    - - - +# `serve` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L340) ```php public function serve(callable|null $afterPreparation = null, callable|null $afterDocChanged = null, int $timeout = 1000000): void; ``` +Serve documentation + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$afterPreparation | [callable](https://www.php.net/manual/en/language.types.callable.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | +$afterDocChanged | [callable](https://www.php.net/manual/en/language.types.callable.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | +$timeout | [int](https://www.php.net/manual/en/language.types.integer.php) | - | + +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    Serve documentation
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $afterPreparationcallable | null-
    $afterDocChangedcallable | null-
    $timeoutint-
    - -Return value: void - - -Throws: - - -
    -
    +--- diff --git a/docs/classes/DocGeneratorFactory.md b/docs/classes/DocGeneratorFactory.md index 884db17b..d5ca67f1 100644 --- a/docs/classes/DocGeneratorFactory.md +++ b/docs/classes/DocGeneratorFactory.md @@ -1,12 +1,10 @@ - BumbleDocGen / DocGeneratorFactory
    - -

    - DocGeneratorFactory class: -

    - +[BumbleDocGen](/docs/README.md) **/** +DocGeneratorFactory +--- +# [DocGeneratorFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGeneratorFactory.php#L18) class: ```php namespace BumbleDocGen; @@ -14,366 +12,123 @@ namespace BumbleDocGen; final class DocGeneratorFactory ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [create](#mcreate) - Creates a documentation generator instance using configuration files +1. [createByConfigArray](#mcreatebyconfigarray) - Creates a documentation generator instance using an array containing the configuration +1. [createConfiguration](#mcreateconfiguration) - Creating a project configuration instance +1. [createRootEntitiesCollection](#mcreaterootentitiescollection) - Creating a collection of entities (see `ReflectionAPI`) +1. [setCustomConfigurationParameters](#msetcustomconfigurationparameters) +1. [setCustomDiDefinitions](#msetcustomdidefinitions) +## Methods details: - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - create - - Creates a documentation generator instance using configuration files
    2. -
    3. - createByConfigArray - - Creates a documentation generator instance using an array containing the configuration
    4. -
    5. - createConfiguration - - Creating a project configuration instance
    6. -
    7. - createRootEntitiesCollection - - Creating a collection of entities (see `ReflectionAPI`)
    8. -
    9. - setCustomConfigurationParameters -
    10. -
    11. - setCustomDiDefinitions -
    12. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGeneratorFactory.php#L24) ```php public function __construct(string $diConfig = __DIR__ . '/di-config.php'); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$diConfig | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $diConfigstring-
    - - - -
    -
    -
    - - +--- +# `create` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGeneratorFactory.php#L52) ```php public function create(string|null ...$configurationFiles): \BumbleDocGen\DocGenerator; ``` +Creates a documentation generator instance using configuration files -
    Creates a documentation generator instance using configuration files
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configurationFiles (variadic)string | null-
    - -Return value: \BumbleDocGen\DocGenerator - - -Throws: -
      -
    • - \DI\DependencyException
    • - -
    • - \DI\NotFoundException
    • +***Parameters:*** -
    • - \Exception
    • +| Name | Type | Description | +|:-|:-|:-| +$configurationFiles (variadic) | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -
    +***Return value:*** [\BumbleDocGen\DocGenerator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php) -
    -
    -
    - - +--- +# `createByConfigArray` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGeneratorFactory.php#L77) ```php public function createByConfigArray(array $config): \BumbleDocGen\DocGenerator; ``` +Creates a documentation generator instance using an array containing the configuration -
    Creates a documentation generator instance using an array containing the configuration
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configarray-
    - -Return value: \BumbleDocGen\DocGenerator - - -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$config | [array](https://www.php.net/manual/en/language.types.array.php) | - | -
    -
    -
    +***Return value:*** [\BumbleDocGen\DocGenerator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php) - +--- +# `createConfiguration` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGeneratorFactory.php#L102) ```php public function createConfiguration(string ...$configurationFiles): \BumbleDocGen\Core\Configuration\Configuration; ``` +Creating a project configuration instance -
    Creating a project configuration instance
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configurationFiles (variadic)string-
    - -Return value: \BumbleDocGen\Core\Configuration\Configuration - - -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$configurationFiles (variadic) | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) - +--- +# `createRootEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGeneratorFactory.php#L127) ```php public function createRootEntitiesCollection(\BumbleDocGen\Core\Configuration\ReflectionApiConfig $reflectionApiConfig): \BumbleDocGen\Core\Parser\Entity\RootEntityCollection; ``` +Creating a collection of entities (see `ReflectionAPI`) -
    Creating a collection of entities (see `ReflectionAPI`)
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$reflectionApiConfig | [\BumbleDocGen\Core\Configuration\ReflectionApiConfig](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/ReflectionApiConfig.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $reflectionApiConfig\BumbleDocGen\Core\Configuration\ReflectionApiConfig-
    +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityCollection - - -Throws: - - -
    -
    -
    - - +--- +# `setCustomConfigurationParameters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGeneratorFactory.php#L33) ```php public function setCustomConfigurationParameters(array $customConfigurationParameters): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$customConfigurationParameters | [array](https://www.php.net/manual/en/language.types.array.php) | - | -Parameters: +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - - - - - - - - - - - - - - - -
    NameTypeDescription
    $customConfigurationParametersarray-
    - -Return value: void - - -
    -
    -
    - - +--- +# `setCustomDiDefinitions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGeneratorFactory.php#L38) ```php public function setCustomDiDefinitions(array $definitions): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$definitions | [array](https://www.php.net/manual/en/language.types.array.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $definitionsarray-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/classes/InvalidConfigurationParameterException.md b/docs/classes/InvalidConfigurationParameterException.md deleted file mode 100644 index 2a957a0a..00000000 --- a/docs/classes/InvalidConfigurationParameterException.md +++ /dev/null @@ -1,31 +0,0 @@ - BumbleDocGen / InvalidConfigurationParameterException
    - -

    - InvalidConfigurationParameterException class: -

    - - - - - -```php -namespace BumbleDocGen\Core\Configuration\Exception; - -final class InvalidConfigurationParameterException extends \Exception -``` - - - - - - - - - - - - - - - - diff --git a/docs/shared_c.cache b/docs/shared_c.cache index bb842d99..69f561b5 100644 --- a/docs/shared_c.cache +++ b/docs/shared_c.cache @@ -1 +1 @@ -eJztvelyG0mSLjrPUmbH7By7dk7Fvqh/aalFZqoujqSe+XF1jyxWCl0kQQNAVWnG+t1vJBYKBBOBTOTCZKZPT4kAQURken7u4f65h4d5Qbl68d/L9OPFD/PbsDCr2fxm+flqfvn5x1VwX35cBOOvw/+59v9n9efs8oe/mRe4+HuMX/xw++X2p5vVbDULyx/+9vsLmYZ4dXdtr8Kbufsl3Hx6PV+ETxdmsQyLT+s//JZ+dXUVXDHHu/nl77v5Pt2/Wn7/gx+2E6H9CyvmRy/++1//+le6ZP3ihzi7CsvPPtyGGx9uXLqSo5dNX/z37AVK1ylQ2XW+L0ZYpCt9Pb9Zhb9Wn97sBv326ec0y/e3P7xg6wsTm+nfpj9f3Jird7ObP374W7os+eKH//4fq3B9e2VWxcXNFv/jX+UXlQZRL35wxYQ3qzRJGuh9uAx//fC3v/9tc+fXZuW+vE3zbn/HXvzwxSy/rOchL36gkhNMI3UB8UgRMZ4oHAkVWBiBifrhb/+avcA93DMpu+f3P71889tPVW5388mP//d//+///T//3//7v/+//+d//c/08n/9+EOJGIobeiQIJHW6b4cFMzoIKZzmRGjqBfUmeOfWgiCFIEpBmhPEm9kiAXK++LYvDVJIQ6WJ/63xYP+WhHUoT1yGoeIDiVuZcl90VgkviNZceqa1NcaREH0MCicwMeOT6JKyMXbEPiD5eX63ur1b/TxfpMc0JEOx/jVPt3gZVu/mxgf/++J10sFV+Hv4E0eFDeaSRB6w4x5jETnRVBOCIza0uNDiAZ95oR9mN5dXYfM3H4JZuC/3n211SbPSR9l09H+7W5rL8Hp+d7MqdIXQv3U3VVj/9u/mOhRgIoePdfOj+OP5ovgDLbq5jHh3s/7C/YWg8kdefKZUN9dgFpc7zBWrzElp/Otf6zWMqcwallGtvhYzJo4uZkevrvGqxjA2BDPqUZRGBUQ9QSTwaLANFEcJq9qjVe0ZuDSNpSEipowwETWh3HONMBGRuWglkwyHuF2o8LGFSiQds3eXl0mLh7RK7dxZxnOm4MjF92YH6HE7UHppjY2AoDEg7AP3gShEDTXGG5meOXWWEIvBCIAROGoEitCw3Ajwz+mylvOrQUW0MueoGs+iZ0IZYqjgWpkgGQpJBYjTNJI4EkcV9+anFqHMwSRrRKSf19fmxn/aumlh+35yrmt9ARU6dxS/EhEjUHBUSEV9MhUkhKgD55hryjXgty5+8YnH8yEsvk4XvPWkk0Ouw9oKiqlIS45GRKZPLUorD+dee4MlILcmcjk9ENbLt/ePZ2dT3icD8Vv4uHUzporiBpLKIVpKR5mNmNgQjePMcGOSCfaReqkYCYDourY485xeep9++epq7v5YThXHteWTQ29QzpDIEliVjYR7FFTUziCEnIoRgydcG736xFqZ3sfZ5d3my5PF8HlSyiGZuhTSkxCdTNAtolmDqLaBSGo4xYYDkuvmHo6FLC9vbycH2LwwcrjUGBmpEVZax+T4WossUiFYFSyXWqiR4JL1lxRjpRTSA4vx8N3k0HqGhHbJM5pjzEuZvt74cnycLy+5sMZsuTYsYk9Y8JQaHZU0iivEmFeGqmg1sOXAlh9PmR2t7WCfb6/uLmc3H74t060MiTIna848/fuDu5rfhPvvCm64wFoLrDwuLkg89t6qXtDrByNvH7gqr8A5Y8ASZ0nR1gY/tPV4YywTuF59uzCrL8t1ORFvbb4Du26KEqmNgU8P4Mflwv1YDL270WLlWf/ynbm5vEti+DX5zFdhsQGkbk/G8zJQ9V2DlIOpNQ5gugdT9R2ma5sajQudY/W7M1K6KlysjeD2x/1VTQ+rURvA6h5W9dp9/v3mKkF1uTJpLJOm6QisRZ3I+ODGEtxmqzWfvXMjZFq5HYo4ShGST8sDoZEww2hkycm1a5Jang/Btw9n2wPjuqi3iYCPDV0GS93BNOHeETOFvP97Uy981J4Vr7cv35nl6mJ9jdfXs1Ua//FviisvTKSQ1YYsvlx4w2ms4uWvq+urzdvN5ztBiEOGuNpwh0ORYihx1lDvl6vD0Qp+QB2OduCqfLr4clsy+CuzDOmTD6s7a9MfPXz7fQZWOEaHTMpZM6SX6et31+nhzxeP5uGt3Ul6+Y+b2erRDGJLFpwxQ8LW7Tzh/cK4P9IfL3dTPZpDFk/3cGmuNscbc/fX+p9iHLUOnM4baKOT6StJCnEW/MVV8gHKf/v9wvWGq/jXlrE4xrt5o73CTsboiOKMao8J1SEqjJ3j0o6Ed1O90W6t2r2JEXKtyi6Hesyd0ZY4F6XCTKcPMVfI4xiZVGntHwnqcY8JvVrhy8RwXT+2O2quEziJINHQIBG2SBW+aTLVIXmpXEg0FuCinoD796lBkaeJPny7jvObbxsn6CaJ49NPX9O/b2bL24LWLSYs3n+4s0u3mCV3qCI4ObeYYu284tYYa52V3ikrmKVMcDkaq9oXOJPnmVsQ1w/pe97gVYjpw/XDSOOnvy+yBpMztS1ILFuYKaX3jBAUAmOIsvSPigY5gpDGiI2lpFj3h/C2Yvqp4bwtuWW9jSgUisQbpoRMEI8oWXdpsdUupuhwLEWbpL/oMGueyh/bmgy5fzs9oDeXWNagq8g110FT64NyvihjwAxHEhy1HI1lM36PBr0NVnVqGG9DZjmU2xQtGu5NxIYIq5DURWaDKGctx2w8O/n64zvaYvynhvSWxJbfPCUIskQZJJ1xTgilInVFpxVpTPBj4Uj6c1q6zEdNDP9dijKnEyk0ZUkFvJKSUmmR9ZYgFzWj3HIjxlL2PxBH/oBn+P3ml7AqKIb3YTm/W7iwK9WcFPRbkFgO4YIYpKP2hgrvLbeIGptiVceCERaFscSqPSYyDwtdMqZq8/i2M/9+8/pLcH+8XW7evzY3r8LmcU0O853IMOvo4xTAsuBF9AHz6KlDSScoEUGa5P2MhYLvTwu6r5SZmEp0L9CsH2SVdUhjmyKCYuMj0iRFwwFxpCJO/4F+PElsUF7hNTHN6FKUOZ0gAVNkeQoGBMPROKZCcFwyIiKPAo+FAu0xbdttUeLU1KJTYeYUgzlvWTTUYhG8THGFJqZIF0jqWfrJxqIYor+ouXEl7cTA31xg2QZpjBsunYomEuWcl5YHG70Tmqb/8dFsuh9G8e8jjmPzHHZ+bPCbGf5zYW5vJ5jobVV2OdQrb1AMWnFmUdGKimijjLWUICED12Mpee8R9Y+7fuSZvV3nsGI38Ktv70N6PftafLn4xfSA37L4su1/sBVaeYQRUgnwjkStvaNWGE+Vx2PJjfWH/fJTPTIP72Ix/2eacfcMl29mi+XkIN+S1LJRrQmUx6idxkxKFwOnhljClAkCh2hGgnQyjErNbGXtZvTJViS3Jbds6b0hXjPpgvTRo2it8E5GLxlGQqA4Ft6/R7SXC6v0qb2M68Y5xbvdU5uFCRr1FkSWbRGHaNEKzrDIMI2Y4siMcYFbKZUQdiwY75Gn7HFD8sR0oUfJFiqTaZ0iEPbQOgW6Ue1eDbTDjyAOOvzsWzG2D9NFstuvr8xyWXzcX0+q4jCb75tFb1YL41bL8s2i0wOs8BIACy2pOm5JRaJGkXsdkKAhOKuCYApxSizngvoILakqtaRaqxY/zCQ/DlC2U27i8OJNcvouFnMXlsv7LlQthDnbBlTN9ypv20+1RTFs+k9ltyOVDnd/i9uRljsStsFQ+9LibeeHNs2jWqIhN12i2qbxN1VcLVRNb3b/idPg3xuoiJ7usbH5o9ebNsH3IWonta3bPVx1SqEeKO5a4YrBCr393h9436anKQqdUYeCrTrF7zcvvV87Y5vr/zg/GJ1W67wVpDTYGYJckEwrSRBD0XrEvJCY2bEUrPdH2fEKwno/n6+2sNt7aBMjJ84XVJ6ClkRoFRFzXApqPdbBaKKiw44ROZZikv4OcKjymIriT8Dz2YLK4pkSz4m0XnNsqYpYeJbss/PGOZaAPRI897hlurwL2oNJ0tCXRdgIdroVgWU3zDHMlRJEGWODEQQRLEICvbRWcCHGgu++SkEm10muJjm4OTdH5c7NOX7mR2+H54jjh+ccu7rGJ+ig6CiKyX0yPkofuDNGUh0V4Zhq7AOcoAMn6Bw/QUceO0GHfl5sBfLoqp/+EJ2Cv10vTjhnELK3wPqyCfq4TchcYGOzYFUwTOPke0aKPE4YYJJQag3HyKGiOB/MApiFMrNQBKm/HyE3c9J4M1sktZ0vvu2LZJ0HKPzAEqei5mD/liR2KFRcJtTdVooWpnyoUcILojWXnmltjXEkRB+Dwp4oZrZb6wvK+qRFRfxz8aRf3y1X8+uft+7ZckgWNqE4m8CUmGgOCcwhFIYU2LyvDPlxh/AfPyYk/bjD1r01kOUFIz9efLk9+tVppeYl5lYDsgdzspkoTYzdG/ICq592WP300KJO9sQziQUCDM+gvKTj8hLDI43WoiBEdMhHU5wIby0VQiMnA4PykkrlJWvxlheGHLFzbxbmz111wnrA38LN3X2JSd51Pz7Srs5hl/gv7p6Xttw8MlgREP0SVttc//K+wKSOCU+fr2VWNO58VURGbpG+uryvLqk31uqBlIox/7G4ypeXnB5rJ6ftUEV5CS9F+ZGhCuZ1Uxuw3CuLEEfLLI4Mc7GY3Txi7V8u382Wq/uqkirdL44hY7ZMUdW3da3Cy9vZb2H1Ze6X95UlTUZOmFsP+5u53RWYVKoHOf5oNsNtLvHV3CeB+LCtNal2kJnWSAeNlXZKKsK1lZpFFovA2OsoR5LO6DFd14I5m1hKpA2RZTsX8IB1tMxgESgR1scYnSDBMRmRYoDx2hhvZ6GdGszbkVp2rx9lXhrHvKLUahwlxjJGLwk1xSENYzlnp78+Bby8jvRIzdd0j+o7W07ZjvQcCyEUIUjyEKSNnMniCMqAiAoojKaRWH9obhTTTA3SjYSV7TYsiXAxGq6C5yZqGrELDgeKi5Z5ajSdI/vzR1qJsyeG73aElvW7HcHIceuYxmydf6eGYCFJeoedAZx3jPMjHBDg/Ayh5b3uwIIxyCUbnmDNHXeWMiNlepF+OsB5XZy3wU9ODeZtyAw2XvUZW8LGq4qeeCcbr4TRxkrJVGCCkJjiSYy44IjbhGwhx3KmQY/RZdNU0NRg3VRe2T6OtPBIpKeMEUajss5T54oDiSVlHI+m61d/PklrGcqJwbw9wWUPHVBOeBm5TTbd8miJddxIFi21QmECOZ66eO8igz4x5HchwvxWciWKTQ9KaqSk4oolv4ZEKYvzzPBoziV4Qpt/dq3HxJDfnuCyeE8euycES02lL/5VhiGmqFc8IDSaE4t77N5b6cygB3Me6RYDeD9TcNm8kYm4CFcZTv+nBE2ufMK8DTiaGEQUI8F7jz5OF7V3E4N+JzLMV3NxJgNyTlCiHcckIK518nUExjKQsZxQMNCs0tGNJhODfVu7c9bFuUUjwkrbuU/vn+xre3dRzFZhe/epC2683VtKHIVxmFhrUQr+VbCBecq8YFJEaWG7N2z3zm73fmZdEBpLJirEpMFWEEQFUhIbiQj2nDgXqfduu5sbV9nNzfaVe32Vw9rLTU7sFhREQvf02SD2cqPMXu71Fd3DmVffyb394sT2wAqu4OiK2XD2cedXmI2nuL68T/uWdLp7uAX3sId7Bnu4O97DjZXTRivnkWfKF1u5BQo4rDcbIE3giIBqe7jR+oiAKrXyGxv30vvCPU1u7WJ+/S7E1W73NqtSDrEZ4+fZXx9Wiw+z/7o/EIhVv4C3yRffbpItmHVWJT29+ebFIlz+VvjXuz3ZNW47fffWLMKHBw3mWb35//1uniKJsDL3m6+r7CjbfPd9uJ5/LSYOrxbmj83xAMXG6/KNO6VDJJF//HYbPs6327+Lfda8Cg2y+frHFEcVTd99eHU1d3/s9lOXF3dlRvg1rNvUb/ZPV9rjHG3Qmgppg8Q+euwN99GaaJWwWDvgzWtXejVS94kxhc2Elc1/ImW4oVKEYJDWWkUirOFOMea8FWPJf/aH6zOXoIkB+kwp5ZBsHOacUaM4xdpwGby2OCAhNfIUs7HUlveI5DP8oanB+AwR5TBMSVTRWYyJiZRwoqmznEYaCDdBWchL1sbwWZ751FB8lpCyHYF8REQpFJR2BPMonCBGKWwMV0I4DjjuzlsuiRInhudmwspGgUFhQSlVBBuEA0cWK+qpNVIYx6IHXHdnn/eYi4nh+TwhZXf2YM6i4gK7KDxHjgmGqAlUiMBTRAg7e2rb5yYs2sTg3EhW2d2YTtOIVMHUcRUlMslvVkI7nLzn5FPDHvraqD6X2J0aos+VE+yVh0NKBwjnbg4pDUoQrw2NnmMiBBPKCoeZERZ7xoBpro3nBnmzqSG6gahymEYBO888SfGgCjZ5HkxJ7bSQXirNCcSD7djoKpncqSH6bEHt9gvwqvsFTlTo9rZbgFbbLZC93MZ7BRQTKBrEtEY+EGskJlZrKR02GMkIewVgrwDsFehqrwD97Lcdx1IYdedWd4tBnqxZ3bSeuKGhmdbs5TY2rVxir4OJPgofqEGWEISR9i44rZkyYFrBtIJprW1aC7r1tGkln+33lrxDMqrrSudj8ZdkxgpOVVw3vuYG+eSaKeU9SR4a89CxqeU8817b5v3Xv4ar22KT1NRisEbCgu7uQ+1P8At0d2+1u/umsF5XdYqPLkV9ucP8uN9T5UIbO8KMRUeMYhEbEVwUzGppUHrHOYlMgiMMjjA4wvUdYVXpdHn8+cv8z4/zjcX9uLvJH+9v9z/MYr118vk4yQjpwkdGGhNjnEPEEBewsERjao0Zy4FePTrJh23yD9tVHbyfboejBpKCpo1Da1L6cE5o2th208a1m6wqt/E6a6HiPbnQqmJrrzNuorF7bYTX2LmQfITkLCgrvBeMO5J8KoyikeBeg3sN7nU997roQ9C5ZGTFNNURo9KjxLgMyapEFZD3jCfXmxKLGYnGW08R4tuApFLS85SJLKSTlqwhhSM0F444KZNQCEEhMIYoS/+oaJAjKU7BiEE4Utt5k6XCWh/0sn69fVkwcwVYCq+k8FBW11ebt5vPp+e7tSU3ONcPzvUbNtK7PtcPTml92nwVnNLa5imtm0C8chHXGQ5ab2F4M4/5+C00DsIDxmkl9E5EwogMSjgSmaExeYE0UCsgCIcgHIJwCMK7D8JlG0H4m2835nrm1luGBpUZ3NUkF71C21nOjt5qb4taNd0890aaHydhaYr1gic8MJfMmRVUS8GEMJgqU2SnYGmDpQ2WNljaOl7aZBN++fBuhrOUyaaR2eNb62vp6g1hVVOhWAocGJbMK0KF4ALZQBHlwfKIEURhsFTBUnXeUpVvclQimTezRTKA88W3ffGsC/sK5rSEQKs52L8l6R0KGJfBbW2oyo8WqDvlvuisEl4Qrbn0TGtrjCMh+qKjnieKGb9ds0SDNSsu0mX9ZlbpJoe0cGWrMzVGRiYNU1pHimlxAh1SIRSH0HGpBRy4XZc6Z6VPNQE2zi7vtqM9eDc5nvwMCWWbvWqNdNAJwU5JRbi2UrPIYrFceB1hE17t5E+V3h77R50/SGT8Fm7uJgfpNkS2S/yghuHFkVWotxhDNYoxSq++caBhCREycMwMY1wLwlCwlkZmafCYcAeBBgQaEGgAJ9Y5J1Y4MeXxBfl8u16WflxumoHPnUnRzODiiOOHHmotkYRDD4dzaGdpV9jtHB/2Qfbw3WRP7dTa6QgAfsKzlO+xWywH389S3ow9QThaCnCEQ2TbhFvJIbLKI+ENl9YoFxU2yCdvxVsrmGUpLghwiOyxacK9E2Y2mlVe6Fy65O7o6vT1Bx/sjpItLyYtHapwqDfXOF88Gqu4eZljvx6O9T64u8Vy9jXkro8cZTzKvYs1k1Jc5aORaLXTT6nTgTrGqeGGGUEwQlFgFLXCOHITgeKrS/E19w2nxvC14U1vQC5yBN/pMLC3NkTseOh96iqb9yAiKWwODkcigtfcYoU5Ekxi4qyhUgNhB4TdUxJ2mRZd97rRo1yYc1Zz7rF1ihEuvQhcJBfOyUiZpHpLPumT5NMixK2pfHk7G2ARFs7lsoWkwhMbHDHeWC0DikZI43VCi7eCgJtQ003gpSe/nT6JZfnLYn53Ozkfoam4dkcj0EoOwilV7a17N65kC3MX29hdwIxrr1T6f6odc4QgYrT0mirFmKdwLAK4C+Au1HUXxNGGhUfUOvkEA3QZ7o9FyLa2qnVLfdVSiEwbqxoX3Hy3bLCKWpJwIkKgWGqHtRPSGo2DNho6woJ5BfNay7z2UjzRqWfWWEpeOcscEpxKb43zBjmOChNjCQkqim1BtjpjEUr/fVyY2er9/idDWpNULoylnlCNjEY6SUcEU4jJKW40jVp4w0YSxir5dHHs6TaZa/xsXkMcW1NcuVQO1soLTpCQCjFBbFoyQorevGKKUUHGUq3NNesvmXMortOP6/WVWS7fzf4IE0V4GyLLHwVvkaQBRacRx8kdwiJ5jcggyg0J0o4E5ZT1h3J+2C7v9CN7ZZZTBXhDaWUPhg/cKRu0kh4bxlBRWh8VTQ5uCoX8aA4dVsOi2V8b9yVs/i2Knja/Xa+608N2Q3FlDbd3nhcHuFlKFMXIYq+jY1KjgHTgo+mXqXsDtywtnHgc4243RKVndLOM88X198c23aKTVmWXbxPLvDSOeUWp1ThKjGWMXhJqlPNhLE2RCe3PpufqhR7lAqcL8bPllIOziwhFFtLfSSmE88VRhlIiTC1O6BZj6QcrVG9wZuXNqh9MMnUonyWjHIyNJNYGRq2jOGJlMA6YIsGUUcgKPhZPm/Cno0qquo7TRXUbItttbSdnZmBP8vmir96P6KyE7Inrb5yfjZLKoocNCxoTy5BlmIb0AkflODawvR3ys5Cfhfxs6/nZ2Qs+giKYxpLSAiPJkY7II2djipmFwogkkyMsShZo2+n59Nb/0pXjfh19ntls5I1IPivXElPhjcaYe8kQQ1QiaShks/vI991jaKLpkDZEBlntFwxDVntcKIesdklyRPVHSEBWeyBZ7Ykk/vqz35D3g7zfUFDfoz2HtB+k/br2Twik/QYEZUj7ncmYQNZvuKBuJ+s3+SJSiqCIdJgAb15EuklpV2vmdCax31tau0qrp7PuoXlnBxJ4MFyR4KwkjDikBSfCJ4uhglMBUtuQ2obUNqS2IbX9hKltefQQ4/zq8dPN3fXzzGonQWAcPUIkCkdMNJoQppNcpOQihtF0JEX9cQ1nkPsFfiAVco60IJn9guEnZCAgmQ3JbEhmQzIbktlNLDgks58BziGZDcnscSMcktkN/BNIZg8JypDMhmT26EANyWxIZo8a4G0ls/H5yewsld9XHltmzlE++/Ibp7CFUiQU27C59tQqZk2wkmiFqWLKMgwpbEhhQwobUtiQwn7KFPaZfcZ/2mamvy/jQ8ph81wOmzOMPCFY6oSh4l9lGGKKesUDSsIaiduKcY/9hep3zr4ow9DkPNj2BJcL1DglnhNpvebYUhWx8Cxan6ync8knGc0BcbzHZgSly8vDSdLQl0XMUXb22fSQ3lhgWSpCSoOdIcgFybSSBDGUEI6YFxIzG8aCcNljXVIFcQGyGwkqa7ONTEGiiog5LgW1HuuQTLWKDjtGpBoLommPx6FUENf3UgNA9BmCyuapk2k2jAtvaIgkGJdekQRqYqWwOo4F0awvt/vvU4Mlli9+eLsqPp4vXl5eLsJluohWumzmo9nhd9nMXX/zUxARRSHQ6IqKWKkVYqQ4it5xGykOTgCPCzwu8LjA4wKP+wx53HXt+PPci4SwsNRzxDFyNGiFo1YMU+qJJ9wyMxJ/EvdYKnbGCYhrAG1eTy9Oaigu2I30gvW40w52I9VnbWE3EuxGGjPAYTcS7EaaAs5hNxLsRho3wmE3UgP/BHYjDQnKsBsJdiONDtSwG6kVjMNupKECvK3dSA3y2Hk2f/h57Nz1N85jGxsFdprQokAwOEEcc0qmn1RgLjjksSGPDXlsyGNDHvtJT4sUDfLYF4viq6tvg81nZ/clGasZdSJhRyvDdIwkBM0Z18k+c+TGcmIk5v2FaepQ6U6z+x/u7PbVDk33LyaaIulGiJAVfIE1hazgICHfYVYQqDig4p4a3l1TcZA1gazJCLImwCgDozwGRlmjhozyybi6N2ZZNWKWT9xHY4bZYo6RRTwQo11y6QSmgitsmRPWc0SAYQaGGRhmYJiBYX5Khpk1YJh/C6svcz9Yflnk+GUhNPGSKicoNS5qh1VAnjJMpMBYjmW/FKH9hWVSNKBGN1ja/pgo0da+AIFXTk8WeOVhwr1DXjkwLq2lwTktrOLKUJxcbW6SM6WsI6PpgNXj6WXqcNVuaJymS811KEngofvrOAQ89JPw0BNJGRIBOcPhohrK9yHZMmqAt1W+rxomW05QTL2lWkSjVEv2LhonWhTiKjLqMWNKRRQpZ9YIb9N6GD2jERItkGiBRAskWiDR8lxL+ZMQlytzsxpsqiVbyq+iZMFZixlGAYUiaJPp8XBluA3S8JE4s5j0xzzoJlXoDyD18N1EmeiuxQlpGCjvHyz4oby/KbY1UHXDhTeU9z8zjENWBar7gXCeGqKHUt1/MtR+JtX9J+6jMenMldbeUYa9Y1KmRc9a54UwmDKHpHdAOgPpDKQzkM5AOj8h6cx4BdL54TU/PZeMc1yy5xJrwknwlsXgkOVBaOIctgFFgUdzeG9vbirN+V0Xi/k/0+ibd5NzSeuIZut+Ml3R/TxUOtaTV9nyuli12WDUTjglcdAYa8qFMTJYL61F1kgCW0HBWcw7i6VLT04ab2aLpJ3zxbd9kZBCJMXqUGI+ag72b0lih0LFZUJdb4zCrUz5YHO1El4QrZMnybS2xjgSoo9BYU8UM36z/gt0cv3frAab55quw8+KPx2SO7B+aCSJ1l3Nb8L9VwU3XGBtEHFh3QxO6LOv5/WDkbeqo8of2hkDlqztirY2+OHSiTcld+lxvvpO/i3XMOStTXqwVu7zOLnHcACzT/evDlhK3Z7s52VY69ubzcCXEh4Avnvw1WvP7/ebq4TeNYM1K7i+jvCLXvz3uOB2ylpS4gzAbQ9u9Lu1vDCrL/0ZyvQAflwu3I/F0OO0ekWsMVsVvw47x8G6GAmOnGgrPSUES0+o85gHJhHfQFOeD823D2fbA+laL5oI+NjQZXDVHUwT7l2vbWMDmUsBPl5or6/nN4e//dlcLcP92+Ly0Ta+bjpwCjk+Jo+2cGzNrEDM3hxrEeWOJ6o2x7u5S4Lyb28eDF50Oyh6WrQz+N/nq4PxiyKmR9v064//cXH3UPDFuXE8p5xHXadfFvO7280hXFsSImP+GbIIzP8QzH9hHNf2/6Da6seLL7c/bqb68eCZT2aVQDpYwq0WXkZukFFMBIo8CkVD8BTtPvtVgvSxSuANA4Ro9fK+R0ZmP5N8+OHb5cVi9jVdxqMVBKMaO9xrzzlfJYkE/2hNwajG8bx1Z72zVzP3aKXB6HCpaWvK/5gtZ3Z2lTDwaPnRNbrEHA672YhW7UmujzKtcaZ39bnKnuC6dr4BbI7O9vjJifWTq1H1Wm2uImT9eTG/fn23WCQ93D3e7/PK4hZbn/YIUlTDp7frDlkNK3ot0hpV9HWmK1V41FCYmQkfIwZv7MvhktPCdCdBs2mr3MHMR3CD6caN/NfWmTx6sq0iiGFHbGBWBs6DMSoS4RXFLAoEidja9YJNidOJZWdbIJrXABesUsr2ZJ6krwyuKM1h1rvaxgldTaSLhmjEpMEeeaMECjYgTyhRjnFI6EJCF6r/6lT/VavW2uj1oNKz9ETGwTgqgHLaWzzZPuV07/QVH/eYpa3gmX0/Hn6fHRojBZVBr8VRAnohPdt1XkwUuTAqA+aeYueYM0RhppVQiDPGnj3j2UtebC1dUYP02M558X3p3IdFYSpPB8JBJhc4PS7kgizOUk5hMYrWI+aFxMyOpdVsf/s/z1+bphYBN1rEj+GZG5kiGBURc1wKaj3WwWiiosOOEalGgmfW407QCtL63lEBAH2GoLKApsRzIq3XHFuqIhaeJQPtvEnrbEL2SADdX/Oh8uD94SRp6MvCMQRD3YrAsvhmGPnCfdRU+uJfZRhiinrFA0IejQTfuD+D3Z4LOTWgtya4bOopOdqGceENDZEE49IrkpwUYqWwOo7GQ+kJ73+fGkqLfTqbeHK+eHl5uQiX6SI2kMsxQWLj+wIT9Mx4zOMe49iIpRx67abPJqAXeMwOecygqaXcEhMVF9LayLWIyGkaKdOcAo9Zicdk7fOYNcsjtwNWb3L6aEr8t5KdBM0OOno0x7o0qsld7Wqj7l+Uz0P3aGBGimXvZnv0UiBE2RijTYGXdyr9hwLm0TpGmNV2NM1b+wu96j/ONRjfzf54gv6tGO2Dod9QK62Nn5pK6pTL6xwBp2FgLm8bGjJG57fEG4kY2YTlolKNIYNC8kecFVg6rITHCnYbVvdGHrVnrIi6HeLObjX9083d9fdB8HkKcF/1+X2kwnc446bW3Sa/j0L/diI7jLCw1HPEMXI0aIWjVgxT6okn3LKxHDPdY5l0QyBOjOtqKq4ctqlRGEePEInCpZDPaEKYJt5IyUUsqj0B2/Ww3cw8Tg3azaSVtdreCCQY1xJT4Y3GmHvJEENUImk2NAYgu9uw7tGaPTF4tyGyrPX2hGpkNNIOCRFM0XnVKW40jTphHjDeg2fywJucGL6biiuHbUIQ4skxwchbpxxB1ERJZLLkzAXt5Viw3V/NT6/s8cQ0oVfZ5tRmKgf19aY1cExfq4rylMf0WRKTw2SZVzJFBtIIJQ1mRlEc03s9Ft0g/VXZdZsdnJhqdCvMx4lPz7kKwRnJlCJYW6I8Lk4+C9gqgzhwP7W1oUbvmwoP8GnORnvCfGhxvnLdfGhVAZ5Ik3rOHKRJB9OBukNNmkjeVEmOAkOk8GuwCs6j5O6IBHZhNKJKQN60St50c9pAje57x8D45tuNuZ65fUzuEqqPWpE2xPpGOCdymji5v7E4xUM6LaRkFBlvEMEhBI28gZxm7bW/K5BMzQnuSo7Z89uFJl5S5QSlxkXtksVEnjJMpMBYgjbU1Yb2bdrE1KB9AWZXAxK4jkSh4kR3rmSIRmmCuYrIODWeEtj+uPbuS5onphDdCzSnIMZqVjSuTguFMkzHSJKfxBnXTnOOHCRaa7tLTWjg8sc5vUWiGyHm9MBFhCILKZCWUgjnC7pQSoSpxVZjQUEPauoBy50Asp3kCcnAQcD8LBnVO8xz81AGe5jn4eU17v1qGeMMIW0MRxorx5GhgWOBrZVKYQm9X6H3K/R+ba33K/6cLivOLu82nw2q92v+qG7P0o3HyBQPpOgmRpK+8PQ/h1zko8mY91hEW3ru1L3iXKSrKpQg+WQuLJfzxbrzwaPfTs4FaEtsOd/Wa410SKuhdkoqwrWVmkUWC+vndRxNweHTFYw/fGgfkwX89PMWbZ/eLMyf6c/urtMY68F+Czd308N5CyLLVgfygHW0zGARKBE2BXDRCRIckxEpBhivjfH8qebHH1jYErM7l2daMG9HatlaP0mEK+gJFTwvUp0Ru+BwoNgm7CtgKmojvfREziPPLH2+zq4XS/CrwlF3i/TV5fSA3orQso30aGDBGOQStp2h3HFnKTNSphfppwOc18X5YQI6/8hWh6bpH4ur6cG8DZllE/RGGyslU4EJQiIKDCMuOOI2RaVCQqlqXZSXn7x15IkVj+Pi6u5ycwp0Qa9MDuGN5ZXd6kYLCy49ZYwwGpV1njrHlJCSMo4xoLuuDS89/vzI07pYzG4etWt+uXw3W04P5u0JLhuFOoKR49YxjZlZt1UxBAtJ0jucnBjAe7e++f36ux6rcDcn6bS0IrRstpxjIYQiBEkegrSRM4m5MwERFZIPAziv67XkaeCHj6zIOKXHtl2Bpxd7NhNWDtfRBq2pkDZI7KPH3nAfrYlWCYu1E4DrLnC9zmh+eul9kam8WRUnTr8LcXo+SjNhZU/hQMpwQ6UIwSCtdXEYtjXcKcact2I0p3D0V91UJWraPKqfZ399WC0+zP5rgvVN50kpm8v0MfkYCgWlk6/No3CCGKWwMVwJ4SBv36GFvliEW7MIH+Z3Cxcmmd5pJqys5xEUFpRSRbBBOHBksaKeWiOFcSx6wHVdC10l4N88qn+/m6/CdViZyeH5PCFlGT/MWXG8AnZR+GIDgWCImkCFCDx5IcD41bbPVTLKm0f0PlzPvxa2JrxamD/CBAPDJrLKZmmKQ0KQKqJDrqIsaoqJEtphwo3FGHKRtVGNKz+p5BZ+/HYbPs6nSOWdLadsNBiUIF4bGj3HRAgmlBUOMyMs9oxBNFgbzVUI181T+hj+Wn2cv5778Opq7iboQTcQVbYpcsDOM0+S/6yCTZaaKamLDhBeKs0J+M+1MV2lYHP/Qf0ajE+jTw/RZwsq2wCZRBVd8i2IiZRwoqmznMbkd3ATlIXGDR3Ggyl0v/yt2DkzOSyfJ6Ts/nKHOWfUKE6xNlwGry0OSEiNPMUsAI7r4rg6BfX2+vYqrZ7TQ/EZIspmu6X0nhGCQkjeMWXpHxUNcgQhjRHTgOGaGBbl+57XhWXr19uXu31OYbMR6tfV9dXm7ebzyQG7Nbll0a6K/Y+6OCzVB+XShzQZahxJcNRyBDVMtdFeWkN88qlNG+ltyKxSp4TMDmY6gE4JRy+vcaeEpOLFEchJ3QOTUaT/UYGZwBZrm95j6JQAnRLKOyUUOoUedwQwy2VYLX8Mi8V88Tn8ZdJ9hP9zezOIZgDFGefr62bltuDEtfdjBkoV4fiVNe+VIgkigibtp9ymn9YyG7hy2hMrNaXbR42PPmo/d5+Xq8WdW90tAhncs+bZZ3304vt52DTzsMsurfHTFg5TGbS2DiFCDPFJoY112FljNSXkpGI/uKrBPey8Yh+79qdX7JIra/yoiaSWSuq0xNE5EhEl2DLJCY5GO6M2j5qq7KMeqgUnJx/0U9lvdOIxt2u9mZWOJH/FsWCRwjQt3MQpTYgzVgS8rdOgJfp86Fs9/cMluVY9OCpsMJck8oAd9xiLWBDi6VZxxKPZVCNIbxEpOXysmx/FH0+wBc8JaWTbC3OjIkcWcUOET56UYMoko4uDZ8qPZh8MZ71Bkx5Ka/9h/Gxc+nd67VCrCWVLd9AjnlCp1e9lYWwa4VcNZ1BIkSuNMkWrOAjumFQ0OT2KEqk5VUcd3IzyP/3SiBmsjS+47u/kN1gcW1ocNUZGaoSV1pFiam1aJ1UIVgXLpRZqJNjsb21kpSbn9T4//PDd5NB6hoSyRWXMpgCLeS18QEW+17FIQ2RaCCcpHct20P4Cj/LM/C6Xs/7x09f0lTez5W2x2IfpGdxzRJTdMMcl1oST4C2LwSHLg9DEOWwDigITwHDdCKW0Rmo7ycVi/s80+ubd5LBbRzTZsBp7zCIyxHjtRTA0BdlOYo4FDcmpH8smz/4w+6hGNXOexubHr+HqdoIIPl9Q2c2dXijGLBWOBhWZsikaTQ5wMsWSImHBBte2wfmNXrsXk4NvZblkt3Cm99palqApOaNSxOQtEOqMFIHx0ZCaPVrfUpcuDXaZJtkZlm1Qnb79U5HqX25/PzkINxNWdhOnpMITG1wCuLFaJv/XCJlcDE2ot2IsVrg/PoLn3L3tJO/n80ed9Ja/LOZ3t9NDdkNx5bAdNHVFBkpYiw1SnHPrCBEyvSdO8rHwwD3a7Mcbb2+W86tQhDGXi7BcvjKL/ddTTU2dLaespY6cqUgw50QgbESULqBiezLC2EQ7ls2cPaK5dOPAa+O+hE8fvphF8K/n17fFIwr+zbYbZJHiW//F9DDdTFrZrfdGBiIpwTJ4R6wyNLroSVQUMaoNILsFO33/rN7Nnbnae/m7LQioiWL6XDlluWVjHE8oRppgzGOg0nufHGqhsfPEj4Wnk72h+dG5tyX5q5/+cuF2/ertzVdzNfMPPk4XlMZahcX9n00O6t0IMacH0nClaUjRJHHKKWaUR1axQDX1mpCxNFTpsQrscPvXy7eFE/l15sNiuscFV5RKvmDRGZ1CQhelwkynDzFXyOMYmVQijKU9W48Z7VJj8yBdO13A1hPOtn5RltcvHi1C2m3klJ/nd6vbu9XP88W1WT3FPs7nsZOxjy2dz2UnYy/7OouKjmPbe4+BtkOx4CiMjJwYq7mWMjpkUJBWcWFQsSVsu4DofJnsjuZJkfC1ufH3R7xt3w+hcpbmCmeltUVlYkSG2aCEdcimfyRBPjge9VgCccafciV8CJHi5OJ7eMBKmBFOlumXLpqAGQ2OCKE9E0gwKoTkAhdNdkcCXNETbv8+OSQmg/zh23Wc3xTjXd/Ob5I4HsGxEhSNZzHhTxliqOBamSAZCoSk+ELTSMZydmFfUNxsYq63yk4NvLUFtA0qiis8FVScGGsXZ/CiI0vxhxBiQIgxlBADHw8xSvDaoURsJIFZmowEN4JiHlnypkmwwZOgVHTbFUXUiy4+hMVXCC2GtSzSHjc+QWgBocWzS2NAaNEgtJCIGIGCo0Iq6tOKTkKIOnCOuaZ8LC1XVX8m9FidVvkSO0Hk1pDOLqgobzBWeSCIKCCigIiinYhCPG5mdpgq36niLq5/n57qb+Hj9hYHFF1kO35AdAHRxbOMLmggiFCqEXFSqsAU4ZRy7qXmUqPRlJ70Vyz4qFNAsnEfF2a2Wn6vUi4eSxp+5tYfTA+9Z4gIImSIkJ9BhOywtskdoiL5i8mmyvSpRcltTBZVe4PlSKCoezOnvKS6sqLLODEUN5DUNnLW8nTkXHVQiKIhioYouqW8XPUo+qUv9r6tT+ZcQuw8qDUTYudhrJMQO0Ps/IzRC7EzxM5DwmN7sbOUjjIbMbEhGseZ4cZQrn2kXipGxnIobX+xM8tEhKWO4tSwW1c+uwxzvTi5ZCiIjiE6hui4pRwzq1e1+qCnwIBiZKheTTFyj7s6IEaG6lWILwaPxPbii6CcIZGlcEKllYV7FFTUziCEnIoRj2VjXI80oz5hJcqX2qkh+Dwp7XJytH41a9mAEHFAxAERRzsRB63YhePl7e0QAovsMa4s3TBVkmnJkaaOm4CEEJY4JjVxwo5kUeyr4cbk/LPCkh33z5IGXM3c5nHnU2ku2WUSopPJGStMkkFU26Ipq+EUm7GECaQ/8pcc25S/tkoTQ2leGFtXS9ToRpC+Bx4VeFTgUbXE4Z44/nctneyBkU/vZmGc87MmcuwqQT1unoWDV09RD+0evOoiCswwHooCJyOQx4xrJox0wifPDQ5erYvgI0caHH8+F7sW2K/M5eTQ3FBacAAEHAAxPEx3cQAE1SjwSIy02OnkkVsmY3qjWVBIYgTHTtVG8+PT7x4y7i+9nxXfS89r85s9f3FykG4kLDjY5AWGk02eFeD7P9kEq8KQW+0s0dhgYZNlV05ogryQjI2lD1OPBv4wUDo8YPrg/XLK9r2JrHKoVlQwxKLWInAhjMLCea6s8+mXmDk44bguqmWpc3lPMl6kqyoIw4vF3IXlcl7ym+kektKq7LKnagqHLVfEGIUM4hxx5BElFisbJPVgy2vTguXC2j/eZsrmu6548v0gadQRaYmjDyLY5HsgQgNGSCrr9VjO7u4Pu+JwR8r+JB/mdwsXCipgNT94N2VAtyKz7L40ZJ2VmGkdLCcORReIsMQajB2NxgDK66K8VFj3a+vHP2eXnzZZyE+v75ar+fXmzaRB3oLIchhHngoZtNLMaaEikcRj66gKklmKyFj6FvWI8ccs2OMHtkXa7pFt304a5y2JbbdTU1cp6clnkaDOB+p8oM6nnTofdfKEke+xSPF6+/KdWa4u1nb8+nq2Wq05poPfDKECSOQKgLzRXmEnY3REcUa1x4TqEFXyIh2XYym0lviJ6a0z0TOxdbZV2cHR1n1uuoOjrTPkVs2jrTPmOmGTCBINDRJhixSjkSVTvS6AExKNBLewL6arLJkq2xfz09f075vZ8rZwp4oJi/cf7uzSLWY2VE0ZUM2k4NEGari3ihrlYsQkOsswdcaNBJs9pn+reem7X2zfT866niumHJanUhffn38AVfH9VsVzbjHF2nnFrTG2yBV4p6xI0TATXI7Fw+2ROs3FJusV87vNeRVi+nD9LNL46e8L+mRyiG5BYlvCFBf3U4kxPStW3HGp7PPt+jsfvi1X4RoIVSBUh0KoiuOE6jHQdigWGRxSnFltBLWGC2+cwj7qBJbgNdFbVpWcxaruKpa25Uy/rq6vNm83nw+fUY1CoUi8YUpIglBEaRWWtqiLjc7xsfSLJf3tqMyuI+XIKRrBfX8LK299iWVLT5ixglMVcaDYcoO8QUwp7wlimnlIy9eO9PP55VfFkucW6Q+W+69/DVe3EwR3M2Fli14lFZ7Y4IjxxmoZUDRCGq/T8u+tgMLB2rhWp4X1fj5fbV5+n275y2J+N71+ME3FlWW0aGDBGOQcDs5Q7rizlBkp04v0E9jZ2l5JaYHnkZqgX8Iq/dXddRoi+M3o/1hcTQ7grcgMWC9gvYaM8TZYL9ht3BvCYbPxgDcbb9jfHS12Bvt7gk0C5heYX2B+22Z+5YmTQavpKrC+w1uWgfUd8CIMrO/ziq2A9QXWd5S4BtYXWN+RYhtYX2B9J4ByYH2B9QXWF1jfJ2V9SVusLzC+wPgC49tprS9ug/F9v1wNjfRVQPq+kP11fgbSd2Ck70QaJdDeEA6NEjJghkYJA8UtNEposVECJNIgkQaJNMA1JNIgkTZZbEMi7YxYDxJpzw3lkEiDRBok0iCR9qSJNN5WIu2AoIdcGuTSIJfWdi4NoxPJtMOT7S6+3Jao7prl/3L7YXVn7Y70v387nAQbzyXYkj4RZIkySDrjnBBKReqw416apFZjYXFlf32a1SH70yKYprZodyhKSMlB7/JhoBxScgPFLaTkWkzJCWKQjtobKry33CJqrJPWsWCERWEslTz9EV9SV18cN6zOdubfb15/Ce6Pt8stS29uXoXN45qc6e1Ehtnj9phmybv2SkpKpUXWW4Jc1Ixyy40YCzk2TPr395tfwqrgMd+H5eZA0G0QOynMtyCxHe1FK9BerbnsQIUBFQZUWPtUmOyACksvd5nR+eJ5EWIWB09Z8CL6gHn01KHktVIigjTSmLHE/rK/JVofSqt1SE1sBe9eoECOATk2DKwDOTZQ3AI5BuTYcGkBIMeAHAMtAHLsCckxhjsix4477kCRAUUGFNnzqBZLL/9xM1s9L3IMWWUd0thG6hDVFmmikAyIIxVx+m8kK3SP5Fg7JU7lYJrY2t2lKIEQA0JsGCgHQmyguAVCDAix4VIBQIgBIQZaAITYGKvFylx2oMKACgMqrH0qjLZBha29xWSoLoz7I/3xcqfIgyPDsgdSkYApsjwtx4Lh5NIyFYLjkiU88SgwHcnqrPvrTaoO2wu1CqeJrdzdChMIMehoOgycAyE2UNwCIdYiIYYcc4xZx71hjJjIbEDRCyso4QhZMRJs9kcFcFZledzMuVsTp9rPtIGogOQFkvdZgR1I3ueuBUDyPiXJK9sieSsFokDzAs0LNG/bNG9BrzZned+Yu7/W/wyBycU4R+Uy5y1Lcb/FIviix74mRkWuJfUs/WQjWYOx7I+zeqRXtUEztUW4scCAk30hgJMdApaBkx0oboGTbZGT1RgZmTxLpXWkmNoUuyMVglXBcqmFGgk2+4vcWakz+LBJ+4N30zOs9SUE56TBOWnDBHN356RN5AySHrepwRkkLVTkdHQGCZw2NcjcApw21cNpU8QEymNBYGImpYuBU0MsYcoEgUM0gPC6CJfnPq/N6JPFeVtyy6HdMG64dCqaSJRzXloebPROaJr+xyHirF0xUSvzuXkObw7OfPzPhbmdovvequxyqE+hqdDKI4yQogQ5ErX2jlphPFUej4UD7NHGlyfdjuf7Lxbzf6YZP+7SmG9mi+Xk8N6S1HJIV96gGHSRoUUpgmVEG5Xc9gR6IQPXFpBe174fli6eema7h3VhVl9efXsf0uvZ1+LLxS8mB/m2xberEkK6rSqh+/QnVAJBJRBUArW+4RO3Ugp0H+L842YWZ8FfXBkXyn/7TDZ/akSLHJ9hkWGaEIYjM+nquZVSCWHHwqwll7u3tTrNdVYFzBngmtgy3qNkoQbpBYcapCGAHmqQBopbqEFqsQYJGGFghAcDdGCEnyvqgREGRngaSAdGeJCMMGuNEa4dtAJzDMwxMMet7yE90Snwsd3YGqtNcUzxJtmltGC6sFwOgQ4mOTpYMMyVEkQZY4MRBBEsAqdEWiu4EGQkyzT0Uu9oWaV6nyK4WS2MWy3LKYITHKvxIvmHBEnMSKBOKqRwUFon0+7EePiA/khWfthHsablmhiSm4rrvkSgQiORWkODmwduHrh5rbt5sq6bdy+vl3F9tcW7XRX02qV7elcv2ytkIq4edAkdhqu3WQ1xhcNEa6sarIiwIsKK2PqKKM5eEY/sf3v6BRG4j9kLBQviIBbEye92xkT3lxeG/c5Psd956/ShRk5f6ejg84HPBz5f2z5fsaq04vPdp6nB8xvOggue39A9v4l0AenV84M+IOf5f+31Adl6gaJFL/DBHOALgi8IvmDr/J9q6Ave8/RbNYWU2ECWX0iJDcMP3K6LpIV18ZGuwZoIayKsicNdE7+vfbAmwpoIa2KXa+JOp2BNhDUR1sTWcwbn14mc3Dv99GsjhbURGmoMZG2cfPcMjntLG0D7jGfQPiNSrb1RQshgk9cSKHHeOpY8GqWp5HoksO9rt+KxTU+P/RsAemaPWHVx7cId0qxA6oQOQdgDYQ+EPa2HPahB2HO0hc7TBzxQKAWnmA4/4JlI4zQpe3P9oHPaWVVSbXVO2/LerKEjeGQGcAHBBQQXsHUXUDdzAU+0lANfcBBLMPiCA/cFJ9JaFKP+ekVBc9FmBHhHzUUJbe4eZqcCPxH8RPATB9RJY62yxYaX92E5v1u4sBEEuIZDWJHBNRy6a4iYZg47r6SkVFpkvSXIRc0ot9wIPhIg9uka1ukLccR6TQzNLUispU4apaODzwc+H/h8rXODtdvG72lpYa82xqWIy9Z/9HpzK0Nw/Ri4fi/66l8Art+5rp9XMVDhEEOUcCs881QkT9ATaWRgdDStNHiPKeLTLdErGrGJgbo9weUQL4w2VkqmAhOERBRYigsERzzFPEzIOBbE94Z3rrN+zcfkaXz6eYu3T8Xj2Dys5VRh3lheOXRryrw0jnlFqU1uusRYxugloUY5H6DWuza6y8PSB5O8n89Xm5fTPX/5bDndB+1nnQBSaUGA2B1id4jd247dC/ubi90z5zdudHdrFX6/ef0luD/eLjfvX5ubV2Fjy4YQxsPOVuiIOfwwXhCDdNTeUOG95RZRY520jiVUWhTCSICISX+Onzx009uwZxPDdycyhPAHwp/BIb1x+ENUoxOxK2oPREIQCUEk1HYkhBFuGAptDcX64LZCU5Ppufge7+yFKRARDWIBhl4/Q4+InHMGU4mCDxIbQnSMWAWOPTUm+YJj2e7QY6+fooNZV1ZtYijvUpTZI9MYRp4QLDWVvvhXGYaYol7xgJAfy37w/sKjRynr0gf5YE7QgNJc/9mC2wVQlLcQQFVVM4ijII6COKr1jNKJHUBV1ff3m5fev74yyy0B8nE+rAiKQwQFu4IGH0ExxlRUxkarLUIsUh0Y55YYZIlCwo0EiAT15i2y0sqvrQX7/ebq23aov4K7K76+fUgTA/CZUspBWdoU9FgnaKTCekqUwqrIjiITuWNhLHGPJv2RAYf5jnbW5olBvSMp5lQBa+UFL5p+KMQEsck/DZhxr5hiVBA5ElXokQI4FNbpSHb94N7N/tiOPznYtyEyoLmA5noGSG+f5qqwt7mNVQQYLmC4gOFqm+HivPp+582PvVKhpyeuskfg+eRIEkGioUEibFHyJyPD2AVmGBdyLKtuXwnXyRFXxTER34mr69v5TbFUlRJXH+7s0i1mNiweV9IV7Ubr7CM6UDNY92Ddg3Wv9d5ussK6d2QL7JuF+fPN9syW9fd/Czd3Q1gNVW411DSwYAxyDgdnKHfcWcqMlOlF+jkW9ry/8iNBa2yb/iWs3hwc8/OPxdX0ws82ZJZtH6I10kFjpZ2SinBtpWaRxcIqeh3HwiaSvs49LuHGzjCNU0N5CyLLds7mnMmQLLmgRDuOSUBca8WIwFgGMpoeOT3yiaWdn488sdd3y9X8evd2uluM2hFadvccRkYmx1ZpHSmm1qIUxYdgVbBcajGW81H7y5KyUk80RQBxdnm3He3Bu8mB+gwJZRP9zFjBqYo4UGy5Qd4gppT3pOhx60fjj/SGYH5Yqf7Q6LwqAnC3SH+w3H/9a7i6neJBp42ElT3ITTMpeLSBGu6tKnYzx4hJdJZh6kYTTfaI62okze4X2/fTQ/SZYspm56kh6f9dwq2kWmoutEBcJd86WoX1WLqN94fl8oPEc4Tj7rPvv/rZuNV8Mb1SlFZll2VKjHGcWIU0wZjHQKX33ngtNHae+LGgvsftiKWm6aHn+NNfLtyuX729+WquZv7Bx+mC0lgpMrr/s8nBvxsh1qlVqc3V7BJ09PNi+60fEf9c5DkexrzL/Zwdg5wd5OyeMGenj+fs9nDco2SiQkwabAVBVCAlsZGIYM+Jc5F6v8EJ7V4yxcnAFSRzSsM7lFRQhiuGkpdKQoq8kmopIUhSLha8dITVOOe+gpnbZV6GcoBVdqua4gEnp50ZLAIlwvoYoxMkOCYjUmw0bEuP2Z/Sx1obNxPzYlqSGuSAIAc0dKR3nwOaRt1Kf+wM1K2cAfOu61Ym0ie0Rz4d+oRWI9TP7xMK3CJwi88J6h1zi1UPea8ZBgC9CPQi0ItALw6LXhQnOmNV9SKenlDMHovqIkIxhZ8uSCmE8zEaLiXC1OLkpQs6EkdGit48GSZPS2vqPvlZMoLoMjl4EF4ODMqdhJcTKQvvL7yEsvCey8KTO2GwMwQlx4JpJQliKFqPmBcSMzuW47F6pPsqCOu7nZlwA6DzBXV/LmrlfganrDxQG0BtALUB1MawqA154uykHIlbCOyXsNoe87wcAr+RPR3JcSyEUIQgyUOQNnImMXcmIKICCmwsfshg9qedgMvUnJFGwoLyKCiPGjjAuy+PchGt+9kFqbk0AnnMuGbCSCd8dFKMBOg9GvBS8jUT6d8nhV+Zy8kBvKG07g+bZc2S5wdrAwSWEFhCYAmB5cACS31+YJk+L74YLtKiuNeqYQgBpsgFmFYS4YqsuQqem6hpxC64dTMULIIaSwK9zx05dVzKo7CZmJvSjtAg4ISAc0xAPyvghI5W0NFqsIwhdLQaEK6ho1UlRENHq+FjGTpaQUeroaAedp09K/h3vOuMNCPOj8S6QKADgQ4EOhDoYyLQ75sybI3qZVh3ZXh6Aj27A005gpHj1jGNmeHpdXLssZAkvcPOjIZA58PkFY/CZmJeTDtCAwIdCPQxAR0I9CGQM0CgD4JAB/oF6Jfh4X3o9EuppwT0C9AvQL8A/TIw+kW1Qr886In59OyLzrEvkWrtTRKGDDaZlkCJ8wUVE4TSVPKxNE7pz6fhqpqqHWDlPxfmdpLeekNxZf11JQ2SVGJBTVpBVIwBW8SD97GwkGMhXHqszNVNHta+rZoazFuUHJR49WnNocTrqUq8ptIWv8e8EPTFr2+4u+6LD1khyAoNAeedZ4U8ZyjF3GRNUzAepaAcaY4QIobLSEYC9P6yQixfdrp7MdE0UE3pQDfOPpEL3TihG+ezRjB046waGTboxgmZeMjEPyesd5yJx61l4veCU0jEQyIeEvGQiB9WIl7IBofv7DsRT599l7ns+0T8ci4keOZD81a68cy5kWmFVBExx6Wg1mMdjCYqOuwYkWPhStiwQs1XZhkA0GcLCk6WetGjgYaDparBuYuDpYykUUekJY4+iJA8d4YIDRghqazXkIRpJ6e+neTD/G7hwru5M6v5wbtJF0O1IbOszVbJkcaO2MCsDJwHY1QkIplwzKJAgPLaNru0fG07ySZATKGrn62HvX81YdvdVF55j0QJlHxqYaylLhAnlPZSeRuJCtaNxSPpsWCkdMfgw0l21MH6aSwuFvPLRVguX5nFdEHeltjy1VGBC6NVURJlOZUipJfGYKUt9ixGwHpdrJcSkMcnMX73CN+H5d3V9Epbmwvs/ggI1PBYwe/TQNYGsjaQtYGszbCyNpKdv32yMJwXV3eXsyKpsr6DISRvso2rkl9irJRMBSYIKU6pwklCHHGbok8hx+Kb9Hm0YH6X1GnETMw3aSwv2JgAGxMGjvHuNyYgZpOXyLwWPiDkCHIs0hCZFsJJSuGAwbo4Z+XEwNr2bH/89DV95c1seVt4HlPcnXCGiCBL2SfjDVnKrrOUW1ZENitrfezWADkC5AiQI0CODIscUfR8cuRiMbt5xAG/XL6bLQfBkvAcS0Jo0cRBesqSntGorPPUOaaElJRxjMfimfTYhSffMqkGdCbmq7QnOOBNgDcZOtg7502m0qCnP5xDf576MO+6P89EtugMaz8DbNBpJCjYOg9b558X1jveOi+acYyZWADIRiAbgWwEsnFYZKM+QTa+MzeXd2m5/NXc+Kskt4svt8dsX5GBvDLfXl+Z5fLl7ey3sPoy98vB045MOeFl5NZYaXm0xDpuJIuWWqEwGcsZVFL05ufIQ/asBRBNzMvpQoRARb4g/SkBUJGDpCKFpMITGxwx3lidMB+NkCmqTZ6WT17FWIDeH0lTmio5zT0sf1nM724nh/Cm4gKaHWj2QQO8c5odaEmgJYcH+25pSVaBlmwcIQBBCQQlEJRAUA6LoDxVDVnH7C3Mn2ub95u5HQItKXK0JDdKRIq8kjqhSCVJERJJlNJThzAfS3tETHR/7nwTUu0Bdibm3LQnOOAgX5D+GigCBzlIDhJ4GuBpnh7mXfM0wLQD0z5Wpp0zjDwhWGoqffGvMgwxRb3iASGPRoLtHjduVPEwH8558T1om3Dpb3uCA869R1sOnPvgOfcqpcBnxsHAtAPTDkw7MO3Pn2mv5Fk8PdOONZyt9SIZkf5iVdi6VzFK7eZsLZqcciKt1xxbqiIWniVEO2+cS6vqWLgXOqxu6GnoS5P+AoDdisCAgHmBJVAww0d6LxTMVI5LRIPyUeC4xEaCymZBMTIyhbNK60gxtRZZpEKKT4LlUouxALo/TpGVBlMP6bAH7yYH5DMklENw5C4SbwXmQQtPjSA+ROk4ozJ45UZTsNKfRT5sEVu6kn653b79EFarNPb0doeeLSdobg7NzYcE5Labm1OuBSPCYi+N94Jjq5NXIYWQUQprLGC4JoYr7UM/mNOk57T5t4jtd6HOt5+NW80X3yaH8S5EmNMBwkgMzgUeiHHMWRUjo4grGqXXEo2mjW5/ufrDSrls1nczYvrL47/5NVzdTtDYdybHbJSpqQ0qMo8tI9oZobVA0jmJOQqOQZRZmyY8jKEy5iy9PHw1Uey3JLUTBGEgkhKcgk9HrDI0uuhJVBQxqo0HpDeNRjdswXptLs6Zv9p7+bv9Z5pr/YvJYftsOeXQjLVK/jtBQirEBLGYiIAZ94opRsVounL12I/oUFgV3NCiXO3d7I/t+JMDdhsig6raFwqqap8T6ruqqp38kXT97fuEI+maeC4V5JRDszNUWGEDEiaw9K8OEXkqqVYuRaJuNNWE/XGQLReJTg3lrcsvh34jadQRaYmjDyJYyRgiNGCEpLJ+NJWHT723eTvJh/ndwoUislrND95NGfGtyCzrsSiCGHbEBmZl4DwYoyIRyYHBLAoEKK/tsZSeT7+dZLMZIrmYfrYe9v7VhD2XpvLK++NKIKOJMNZSF4gTSnupvI1EBevG4o/3WFpbnuZ+MMn6xyws109jcbGYXy7CcvnKLKYL8rbElm86FLgwWhWdhiynUoT00histMWexQhYr4v1CnX/+5MYv3uE78Py7mqCZ402FljTHcsVatNhxzLsWK4qDdixDDuWezq8iLXWG/SXsNp0Z9j0Qn41999ez30YwuZlltu7bE3ETAXGcPo/JaiUNLnvNuBoYhBxLFW7fZ5edBhatYGiifk0ncgQeofC+UUDxz2cX/T8mEfoqjiUrooTqYeBk12eFeI7PtlFttpl7ojzBPQN0DdA3wB9Myz6pogSc/TNWc7z0/M1OMfXTCRQ7bHVHASqTxiobhNP5LQTc8YE4LWA1wJeC3gtA/NacH2vZX2Zn156X0yfLnsxv34X4moI3grJeSvRBq2pkDZI7KPH3nAfrYlWCYu1G0t2CdP+6MbSmqaqcJmYl9JMWNntpcoapDSyzhCvhIsCBUQI09zRQPFYShzxU9d9lT6rrW1fv5mwC95YYDv3m5zpfh/RnDK3m+0vyuvvgdMNTjc43YN3umk1pzur3x3KSdIguTVMMB24jcFI5TU3LBohaNDbZLg4Ued13Lj9PPvrw2rxYfZfg2AGs742Ryn8MEUFejBIa11sKLKGO8WY81aMpqV5f742K90kcxInE/NDzpQSeNfgXQ8Y1e1515g38a6/qwy41eBWg1sNbvWA3Oqzmey36cYHsjsi61Mbhzln1CievA7DZfDa4oCE1MhTzMbSi6VPn7o6JXsPkom5HueICLxp8KYHDOkWvelGXPVWX8CVBlcaXGlwpQfkSp84O/m4SbtYhMvfiosYvDNNSVTR2WTCTaSEE02d5TTSQLgJyUcZix/SozNdupnqFEwm5nucJyRwqMGhHjCoW3SoWROH+l5jwKUGlxpcanCph+NSn19nnYzarVmEbWvXtVAG7lp7HxFRCgWlHcE8CieIUQobw5UQbjQ73wdZZ10Cl4l5I82EBa42uNoDBvdQ6qwfaQ643OByg8sNLvdwXO7zWex/v5unmw8rM3hXOwaFBaVUEWwQDhxZrKin1khhHItjOSZzmCz2Hkwm5oWcJyRwrcG1HjCoh8Ji32sMuNTgUoNLDS71cFxqic51qd+H6/nXgigIrxbmj7AcvGdNMGdRcYGTK+I5ckkyiJpAhQicI4XH4pD0SGKXPtaKaJmYL9JIVuBng589YGy3SGHjJn72oeKAuw3uNrjb4G4Px90ujow8z93+sFp8/HYbPs7/sbgagqvNc662poEFY5BzODhDuePOUmakTC/STzcSn6Q/T7v8xOjjTfbTX91dpyHC5jDGb2vQTM0raUNm2bNunKYRqaIHJVdRIkMDUUI7TLixGI8F5YT0F1Diyo7kQ3s4MWifLScIJCGQHDCu2wgkM1WsnCEhCFk7sYxHKShHmiOEiOEywtlktTPreTO0e/FruEoDTA7MNaWTQ26QKQRLZhm5IJlWkiCGovWIeSExs2PpE9Kjo1FBWGXHxE0OxOcL6j51XuEEsWruC9B5QOcBnQd03oDovDNOCNvYtY9JeB/nxdmHr67mbvg7wHhQgnhtaPQ8KZNgQlnhMDPCYs8YdP+t74JUOeLqCFim5oQ0EBUwHsB4DBjaLabOURM/+0BvwNUGVxtcbXC1B+Rqy2au9q/pwSfDPHhHGwXsPPNEEayCVTYwJbXTQnqpkqGB/V8tcX1VoDIxX+R8QYGTDU72gIHd4j4w1dzJ3moNuNjgYoOLDS72cFzseh3NXhXP2S3SHyz3X+/S2U/vZoucmy2ZsYJTFXHyQSw3yBvElPKeIKaZlyPxSigV/fnZ+S5dJ/AyMZekmbBy/rbGyMi0RiitI8XUWmSRCimUDJZLLdRIkN1jlVOpvUpLRpxd3m1He/BucmA+Q0I5BHMjA5GUYJl8PWKVodFFT6KiiFFtxkKBPHVZ9WvjvoRP7+bOXO29/N3+M821/sXkcHy2nHJoRlbFqKnD2IiAnZQmYsewNMmlJ2Q0/Ed/aBb5ndRHls4iDv/p5utsMb8pNnlMDtstSS2LdGZTsM68Fj4g5AhyLNIQmRbCyeSJAtLreh6lTuLF1d3l7Gb746ev6StvZsvbIgScoB99joiyewSMcTz5HEgTjHkMVHrvTYK0xs4TP5pO17g3EKtS6uWhc/jTXy7crl+9vflqrmb+wcfpgtJYq7C4/7PJwbwbId6z2qIuq52NT8uYbfLZfv8z4LSB0wZOe+CcNj+Okyqa3aGEtMRIG0QtZ4J456OJiCsjmWM2CU5tVnhMzuzZ+H1L+E1hj8NFWjj3bBxYN7BuYN3Auj2tdRMqn6t7Z24u75Lh+tXc+Kskr4P3e6UNT5+oy7aSQUgXeTqkMUmhmUPEEBewsERjao0ZC32GUX/1Q/ywMUp1sEws7GogqRzJQDWTgkcbqOHeKmqUixGT6CzD1I2mPVKPiK62WOx+sX0/PTifKaYcliWyzkrMtA42reIoukCSdU5LFXY0mrGcutxjeqN6Fe6DQqIJNyloQ2TZxIanQgatNHNaqEgk8dg6qoJkliIylmKhHjFe5UC/XRy+fWTbt5PGeUtig1Yz0GpmeOhu3mqGVegeXdWDL6P58Ocv8z8/zjfi+bjjDn68ZxH+wyxmJk31gALkQAECBQgU4PAoQFmxaP+I1vcoMS6D8D6qgLxnXCFNicWMROOtpwjxtcRY9xJTvJHEcnayQ+kZKzyXPEakuaKEWuwEsRxxjzGl0W3TRbxCEvxw8bj4cnuwQF18p1C/r1CwlsBaAmsJrCWwlkxlLaEVSw+2hYrF613NYlpeChkVq0ux0qyurzZvN5+fs5QU30+BGCwksJDAQgILydgWkmYSO24lO5Sdipxi5K1WHid0Re68YpZix7x2QejtMlKoSbMKtrJDTWAJgSUElhBYQmAJmcASws/sClqyhGy3kVwGWENgDYE1BNYQWEOmsYaQqtsDMx0/aiwYcZHu9TezSjcKawWsFbBWwFoxsrVCqkYSKzWQXQJNxAJRRiuqKJPBKqO0jZgLYShBaMdWVU16HAk13izMnw9ijd/CzR2sG7BuwLoB6wasG2NdN+SJnaz7VcAf5ncLF4r+a6v54tOb2SK49CKtMg8+GMKeVprd00qDojQaJ7gjNFBJsdDROqEF1YSPZU8rVX972t6zpah5ZZbhAC5TK7RvJKzsxlanA3WMU8MNM4JghKLAKGqFceQmjgTYWPcGbFHakrL0WT14N9092y1ILAdxohkJweHkYVOrNQkoYEScVsx7EggdC8R7PM7kcJP9OSv+1EDehsxqnxxYa/xd5E4+366/9uNy/1NokgQR+lAi9EwroHvw9igX5pzVnBdbzBUjXHoRuLBWOBlTFEV1by2SWAW5HFHqLqNKq03gCguOlWUsBGmCoUK79FukCNtGlVVO5i61Z4WM3q6Kb84XEFYO0DWh/fWuhbASwspx+twQVg4rrKSYkmSveeCRExs4pYYhhQhlilrLR9N3vEeIs8oPLLPkTw3lrQjtPrCs0I/jjAkgsoTIEiJLiCyfJrJUVQ6iLzVo74O7WyxnXwMkLoftpUCEOUzvBCLMZ+R+Q4Q5rAgTCa8VJQ6lIFNjhxxHzhhlLTZKOgUQrw1xmZNW7aV/YmhvV3j3EWfVHfPnTQSRJ0SeEHlC5PlEOc2zI8+NZS4kBfHmAH0WiDeH6aNAvPl8nHGINwcWb2KsLWWBEI55VJFg5azVzjrqA/EaMpr1IV49ZDq64E8N4y2I7P6U5Eax5ZHhIaKEiBIiSogonyiiFGdHlEc8gqcPKHEuoJyI300o+N3D9Una8Lu3Lolq5JKUjg4eCXgk4JGAR/JEHgmt7pFsbXLZmXDLXxbzu9shuCMi547oIJlhXHhDQyTBuPSK6GCIlcLqqEbijmDUkzvy96n5EjjZwF2N9MvLy0W4TBeR5+WEpMITGxwx3lgtA4pGSON1MufeCjISzBEq+kuqqPNOrtxZqYmBtqm44PjaF/2RznB8bVVUNzi+NpNFUQpJXORNiMYGC8uCUk5oghKgGRtLBpz0h+dDv+/EgcBTPm+8kaxyqNZUCWQ0EcZa6gJxQmkvlbeRqGAdoLo2C5erVNhOsot+1k9jcbGYJ3dxuXxlpkzFtSS2HNZNLAJerpyWyXAHyUVAWmpGBeHJqHvAel2s14rc1z5j8VB2z/F9WN5draYH9Xakdl9oTeoxzyfd+ke08yLE7R+8vJ094vGAfQb2GdjnAbLPRXarglxyut2hlLxyljkkOJXeGudNsQ0qyUpYQoKKohoJffoY+I8LM9sauiGQ0MlaZ1horJUXnCAhFWKC2KRRATPuFVOFlyJH4qEI1hcNXVJ3dhoyr6/Mcvlu9kfYwWZqDkoLIsvy3s4iSQOKTiOO02qBRVpUkUGUGxKkHQnKie5xM4Gs/ciKOvmJAryhtLKsd+BO2aCV9NgwhggRMiqa1v/kKXoylhhzYCmd18Z9CZt/jd0Nu175p4fthuLKk4XMS+OYV5TaFApJjGWMXhJqlPNhLGSh7A/buQK0R4H6dNnBs+WUQ7OLCEUW0t9JKYTzMRouJcLU4gRuMZb+8aQ/OLPDdfUYiTthKJ8loyyrLYm1gVHrKI5YGYwDpkgwZRSygo/F48D9HWGT3aqUW0Kni+o2RJb1PFJ4KDXCSutIk4W2yCIVglXBcqnFWMrz+tsswEr5rsyxwZOD9BkSyiE4cheJt6Lo+SQ8NYL4EKXjjMrglTMjQXCPB40d+oSlQfyX2+3bD2G1SmMvJ4fjs+WUQzNnGHlCsNRU+uJfZRhiinrFA0IejQTNPe4oPwzbT1NSF98zGBOujGpPcPkWCh6ziAwxXnsRDFXJnkvMU5gYmFRjaaHQY/FfjRzD5sev4SqNNTl8ny+obAtKxxxj1nFvGCMmMhtQ9MIKSjhKYSPguS6eD9v1Zx7T6/n17XzCiG4gqmyMqKkNKjKPLSPaGaG1QNIVZhoFx8YSIz5heV/O9Hy5PXw1UXi3JLWs921kIJIm9zt4R6wyNLroSVQUMarNWCi/Hq13aX5hQ1gVO3Ov9l7+bv+Z5lr/YnLYPltOOTR7YxxPKEaaYMxjSBGl98nPFho7T/xYfGveH5xVaWHhQ+rqp79cuF2/envz1VzN/IOP0wWlsVZhcf9nk8N6N0LMKYKKkgVnLWYYBRSKZI4MxnNluA3SjEUR+tMDffgIT3MDH+7sbvaipC09z+XK3Kwevtv8xeQ0omtxZg97JwhxjxBG3jrlCKImSiK90cwF7cdSGdufbmBUv8qz+tOcNifZq2xzWpOcKqSwI8aoqBQqvCsWNSJK0RiIGkvSqT+tkaUO8P2Wjc0Q6aPjv5lujUCrssu29PaEamQ00g4JEUyx0cQpbjSNWnjDRoL63nr5lBSV1tx3MzGkNxVXdvOE0MRLqpyg1LioHVYBecowkQJjCSa9tkk/3HleZ63+Lay+zP32x0TR3r4Asy4Nicm8W+aVRIJJI5Q0mBlFcUzvR9PMvkeyqL6xyj2+aXv+3QozWwZsNaNO+LQ+KMN0jCQEzRnXTnOO3FicnickUes8yovFPA2792Kia0M3QsxW6pDAdSSqqGLgXMkQjdIEcxWRccqOZnNpfyRqEy6j/BFOe43oXqC71jAMn24NUys0OdEa5vbLbfHf+gvv9z/Z7xYjoFsMdIuBbjHQLablbjFFtXb3UuK1pVQYxR4lpQVGkiMdkUfORmqUUBiRZHKERckCrSXFu5dU4fmdIakTy0eHgnMYMyIpt0pz45APVgSCo/WREOYRqXby6xmtUgbQlCh7Us9UmhJxaEo0YK8ZmhK1EzdCU6KBAhyaEkFTotFiG5oSQVOi0YEamhJBU6JxQBmaEkFTovGhGpoSteNW92eqoSkRNCXqAMHQlGhoOIamROejGZoSDR7e0JToWZY6QVOiquYbmhI9CzxDUyJoSjQyTENTorMcEmhK9OyQDk2JmuRhoClRFTRDU6LnhXVoSvTszTo0JWp3Nw00JRqPbkBTou4UBZoSjVVroCnRM2hKBH1b2kY99G1pCH3o2/Kc8Q99W9qMq6Fvy2j0Avq2QN8W0APo29I609Rf3xbeRt+Wg+2v0LsFerdA7xbo3QK9W6B3C/RuOa93yz3Xt/NoB9C7hUDvlheC9dfVAnq31PacoXdLO7Ej9G4ZKMChdwv0bhkttqF3C/RuGR2ooXcL9G4ZB5Shdwv0bhkfqqF3SztudX+mGnq3QO+WDhAMvVuGhmPo3XI+mqF3y+DhDb1bnmW5E/RuqWq+oXfLs8Az9G6B3i0jwzT0bjnLIYHeLc8O6dC7pUkeBnq3VEEz9G55XliH3i3P3qxD75Z2d9RA75bx6Ab0bulOUaB3y1i1Bnq3QO+WCaIeerc0hD70bnnO+IfeLW3G1U/WuwV5I5ICcC0xFSlywJh7yRBDVCJp6Fh6t+inK5Q8Y0vmxNDfhsigPxH0J3peqIf+RM9eD6A/Udtsan/9iXQb/YkOlqFq/YnuvwQ9iqBHEfQogh5F0KNooj2K2Lk9ik4tIR0KTyLKYiBWWB9kghbVSmlupdaOJIHajQva0vp6Vv8/WF9hfYX1FdZXWF9hfR3r+ipJ0z6AP93cXe9II2gBOAjiSrD+9rpDC8A+0hTQArCEnoUWgAMFOLQAhBaAo8V2hy0Ak4OLcfQIkSgcMdFoQphO/q6UXMQirhwFuHv0Ts6wRPv+7NSw3Uxa0N0SulsOD9PQ3RK6W44DytDdErpbjg/V0N2ynYixP1MN3S2hu2UHCIbulkPDMXS3bEBy9OdzQHfLMz0P6G75HIvlobtlVfMN3S2fBZ6huyV0txwZpqG75VkOCXS3fHZIh+6WTfIw0N2yCpo57w3O0N0SulsOVxH6M+vQ3bLd/djQ3XI8ugHdLbtTFOhuOVatge6W0N1ygqiH7pYNoQ/dLZ8z/qG7ZZtx9ZN1t4TOf13zTND5rwWeCTr/PTc9gM5/bTNNvXX+o610Jvq+gapaU6Li76EfEfQjgn5E0I8I+hFNsx+R1Of2I8qsHh3KzcoUKCVRBeIZM4ZgHJySSHmKsCFrhK1b/bEna/UHqyqsqrCqwqoKqyqsqiNbVYvCu+araunGl6pr6+H3YHGFxRUWV1hcYXGdzOJapCrOXVyPLx8dCo4jJTB33GAdtEyLLPMmaaYIxFhqixY/6/a5tGn73HW4uku9QP/cQaR/RI/tF6F/bu0UD/TPbSfJCf1zBwpw6J8L/XNHi+0O++dCk9FeNrc+nASajEKT0UZuCDQZHRKUW28yirCw1PPkSSNHk+OBo1YMU5qcDcItG82Wiif0OGqyDBNDdFNxQQdd6KA7aIBDB912Ysb+/BDooAsddDtAMHTQHRqOoYPu+WiGDrqDhzd00H2Wm86gg25V8w0ddJ8FnqGDLnTQHRmmoYPuWQ4JdNB9dkiHDrpNkozQQbcKmnl/5B500IUOusNVhP7MOnTQbbevCXTQHY9uQAfd7hQFOuiOVWuggy500J0g6qGDbkPoQwfd54x/6KDbZlwNHXRHoxfQQRc66IIeQAfd1pmm3jroslZaE+0V61drSLT+AnT7g4ZE0JAIGhJBQyJoSFSvIVFu+ehQcA7p4JwwSVAIMaIDx9TzaBwTaSGldtdElz9ZE11YV2FdhXUV1lVYV2FdHdu6qnnTRn8VeKOnb/+Hca7930Q4XCyesFoQWNznwOJOpEUgRT2WgUOLQGgRCC0CoUVgpy0Coala681MoKla/03VoO9U6/stoe8U9J16GkekP1MNfaf67Ts1kfMSntBKw2kJta10y6clQHeetqNF6M5TMU7spDsP9HdoG8/Q36EanKG/w3PgO6C/w7Ps7zCRppn9mXVomnmuQ95i08xNHb1spY7+ZEq0RhXg7otQDQjVgFANCNWAUA040WpA1aga8MQy0uXxvzxposSRccZSyORi8MhTG9MvkWXKbasCcXtVgaWdBgZQEZg9EHgi3T7SrfTmV0O/j2fV72MilYBEI6gEHCTcu6wEZFxaS4NzWljFlaE4xSzcJK9UWUfCSLCdNLY/9rBGg+oqxmm61ScdShKqY6E6drC4h+rY55QtgupYqI6F6tgpohqqY9txRPoz1VAdC9WxUB07LUhDdWw7HnV/0SJUx1aME6E69lngGapjq8EZqmPPRzPuj9+G6liojh2uIvTnikN17JkOeevVsaKVjpjZ3FGNytjN16AuFupioS4W6mKhLnaidbGiUV1sdhHpsiqWUm81k4IGoSSznrOgZeSBMxNxNNse1KjFZpkVji4dQJFstm3mRI4Wxpz35l7D4cKtOt1PebjwZApoe6yoggLagRTQQrEgFAtCseCzBreGWsEBARpqBaFWcHyohlrBdvwQqBUcDKShVhBqBUcGaagVfGZJeKgVrBomQq3gs8Az1ApWgzPUCp6P5v64PKgVhFrBASsC1AoOHfvt1wqqljtpnsyN1qgc3H0RagehdhBqB6F2EGoHJ1o72Kyn5ollpEMBWm0EFt4FGpHQmshoGIkxmS5uTQxs63bSfPHgvi9xsZgX0dvm3RAKAVWuDtBziTXhJHjLYnDI8iA0cQ7bgKLAZCSOM0b91QHSXH3DATom5hzXEQ3kDnsM9yB32HPuEDGbogTmtfABIUeQY5GGyLRIviClAhBcF8GHHXY3k1zdXc5utj9++pq+8ma2vC2cggla33NElK2SllR4YoMjxhurZfIYjJDGJzeKeivG4juw/nIpFSoj38/nW5rm+3TLXxbzu9vJ4bmpuLJV0lIa7Eyyy0EyrSRBDEXrEfNC4mS7R4LtJ8x7V3xY00P12YKCTGGPeIZE4bNMFGqqBDKaCGMtdYE4obSXyttIUvDoNOhBTT0Q5U7l4+L3WViun8YixfmXi7BcvjKLCVdXtyS27DaCyLGyXDktlRNBchGQlrqoTeWWaKh1qo31Wozt2sssHsruOb4Py7ur6e33aklq23R4cdmnsuFHWcWSzPbDVI15QSFhDQlrSFjXSFgXZ86R6vmxzfUlOfnZljS9vp7fHP72Z3O1DPdvh5BGo7k0mlYEMeyIDczKwHkwRkUivKKYRYHGQoX1eOQc1xlpPcbQ9tV0HcrG8sp5khILp7gLniFpjbceM4ZYcAEpRpkfS74N95cklrk9w+eZyIkBvgMJQmeBPhN20Fmgq84Cm7phRupFSufozKOAavOMD760H18xiK8gvoL4anAFwaXqUk+5u6xz1UwqZLVBHgXsqLIKk4i8ScFVWn31rsljjTrNiuYuyepjEmwhXzMrAkUISQflsPTos0NIOqCQVGHsEEOKM5siUIuZRiYtKpRLobA3ZiTwZv0dca5y5TSNreXEsN+tMCFQhUB1UHBvFKgWu2s6CFSPqQ/ErBCzQswKMeswYtZimWg3ZC1ayKyCf3szqFhVQKzaYy9ICFUHFKoyjx0OklrKGdYqvTHcS02k95ZTP5aaU95j8XVpM63GVnJioO9IirBxFzbuDgjlLW/cdREFZhgPUnNpBPKYcc2EkU746CRs3K3tqpRSB5nnc7/l45W5nByaG0oLiEMgDgeF59bPzpjIRkc4Pf1ZwbyrjY7bSi/RBYH+2LcH5hyYc2DOgTkfCHOuO2LO/z5fAXk+OI8HyPOhOjedkufBKeudJhZhrjBSBiNbHMFruCeYhbE04umTPGdt0b6HhnJiuO9OkEChA4U+IKADhT5sBAOFDhT6OJENFDpQ6EChA4XePYWuO6TQH7r3wKIDiw4sOrDoA2HRcdss+sfFHXTuGpyz02MXe6DPh0OfUxm5p55SwSORyWhyIgXz3plotKFsLPDusXNXrnPvWRZyYnhvX4BAyQAlMyiIN+vbVeG834YqAyEohKAQgkIIOowQVKImIej21fZMJ4g2h+CNQJ/owbom3RZrJa2OCEtBIqM2BOkNQ5pxEqmU1o/lxBHWY2o/Z7VOGcOpQbuJrCCGhBhyUGhuFEMWd9AshtzXDggXIVyEcBHCxWGEi7iYJRcvvjM3l3dpYfvV3PirJLWLL7dH7dyVWRadAZcrs7uZ7x++XV4sZl+ToCCbOTBPBZo+D9Zt6TS+tMoS74gnwTLEo7SGxoiZ9A5hTyXEl7XhvW6Z35v1nJgu9CtciGAhgh0U/BtFsKLCOa/daRNEvBDxQsQLEe9AIl5yIkPapiGcJ+GsgoeYd2C+DcS8g3V0uo15MdJpgfHcO4YMMzwFvNxZEo3VLsaxwLvXmPfQbHVrPyemDX2LF+JeiHsHpQCN4l5ZIXPbpT5B5AuRL0S+EPkOJPLFsrfI985ezRyEvQNzbSDsHayf02nYy4kROsioBebOcOED5lFTY4WKybKOBd69hr2H4urQeE5MFXqVLQS8EPAOCv3NEr2y14D3oTJBtAvRLkS7EO0OJdo9caRBW3bwP2bLmZ1dJWFAvDswzwbi3cG6Od02anLJaBtJkmWwhlNJNMcYaYoI4SzA1tlz4t3D/vydms+JKUPP0oWYF2LeQeG/Wcxbodtwh+oEUS9EvRD1QtQ7lKj3RAviGpbwt7D6Mvewkfe5+DQQ7Q7Wwek22hUGKYWpUwYrihRREQmsRXDEK671SODdY7SrD7vqdmI1J6YD/QgVYluIbQcF+2axbYX2xR2oEcS0ENNCTAsx7VBiWtpDTAtbdYfpzUBUO1jXptOoliGvmEaRaiKYlNQI7YzkaXHh0sQ4lrPq+4xqVRcB2OS36PYlVohsIbIdFPCbRba0p8gW9uRCbAuxLcS2Q41t2+tGddQGwmbcITozENgO1rPpNrB1KBJDpfBeCUOYI84RJWRyiWxEXI0E3n0Gtg16JFU2mhNTgV5kCiEthLSDQn2zkLbdblMVtQjiWYhnIZ6FeHYg8SwhHcezv99cfft5Mb9+fbdYpJvcbdeA2HZIXg1mENsO1MXpNLYVRHERPfLMYIKJJtEbF2myo0RrhcdSitwjdYPRoUvatQWdmD70L2CIeiHqHZQKNOuxTHqIerMaBREwRMAQAUMEPJAIGHcdAUPDqcH6NZDTHayT02ncq6wmhhClFNNOEZNWXWMZSwaUB0fDWOLePnO6rUdl0GiqN6lChAsR7qBw3yyv20eEC52lIK6FuBbi2gHHte3twr1YFAM9ulvoLTVYdwYC28H6Np0GtkQE5BU2hjAiDMXSB0lxWlmUREhCYHtGYNtgu2gduzkxLehLrBDaQmg7KOAPaRdudUWC2BZiW4htIbYdSmzLe4ltocfUMD0aiG4H6950Gt06YYyOQWKtkTLe86ADiy5yRqnkXI4E3r2eE3S43HRmOiemCD1KFmJciHEHhf1mMS7vLcaFXlMQ5UKUC1HuUKPc9iqTM1YQuk0N0aGBEHew3k2nIa4mUQhFGAnWMa9UCEYGRbgVgkhnxgLvZ1KZXMNsTkwJepIqhLYQ2g4K90OqTK6sRxDXQlwLcS3EtQOJawnrPK6FrlPPwLOBrlODdXM6jXGtRl46L4m2zHmBXAK5i4Lp6CJFMY4F3n12nTp8Xt3b0IlpxFOIGKJfiH4HpQTNOk+xXqJf6D0FkTBEwhAJP4dIGHcfCUP3qcH6NpDjHayj02n8GwMSkacFNkqlC9sgA0FYYKelUs6IkcC7zxxvB7EZ9J/qUa4Q6UKkOyjkN8vz9hPpQg8qiG8hvoX4drDxrTwR3tZ1qp8+bCUQtr4gFMLWgXot3e6+BT8c/PBn5YeTCn54PQ0B/xr8a/Cvwb8ehn+Ni1kaEA1b+3nx3Zf+brKPWDowbWDawLQN2rRVksuhNneKl2CZT5GCIpgoia0njktNsfESBcK3tgy1YsvW5T6b12DBwIKBBQML1p8Fk21YsJ9u7q7BgIEBAwMGBqxnA4ab7U/eGrB7sgysGFgxsGJgxZ5lIPlxYWYrsGBgwcCCgQXr2YIx1IYF+3Bn90mxJMvlytysHr4DCwcWDiwcWLi+I0159sa32tbtQVpzCEWEKldESAhC3COEkU/QcgRREyWR3mjmgvZjOeMA99od41BeHcJrYvVZvco2V53IjUzLtIqIJXsjqPVYB6OJig47RqQai96gHjeNVhDXK7PcjjVhJThfUNlWwEEyw7jwhoZIgnHpFUmgJlYKq+NYEN1XNfnfp4bKwsd6uyo+ni9eXl4uwmW6iDzksFZecIKEVIgJYpOzHzDjXjHFqCBjcT5IbyZU1F8d16vgu9kf2/EnZ0zbEFl29z13kXgrMA9aeGoE8SFKxxmVwStnAON13QRc5YF9ud2+/RBWqzT2cnLAPltOOTRTrgUjwmIvjU+2G1uNLJJCyJi8BGMBzTXRLGscTL6b07gvYfOvSd/blVN/+9m4tPROz4J3IcKcDqgoWXDWYoZRQCFiZWQwnivDbZCGj0QHRG86oGscXVg/2TA5fehanDnd8MY4TqxCmmDMY6DSe2+8Fho7T/xYdKO/9UGV8vnpkcTZ5d12tJ/+cuF2/ertzVdzNfMPPk4XlMZKgdn9n01OI7oR4m7bJ2+ljO1MlhJSqZBKhVQqpFL7SqVq1V4m9bew+jL3n958uzHXM7d5t3Mynj5tqnNp08C4tJYG57SwKrn+SUzBc5NApKwjYSR+DkX9RQHq8LmeAaV9DE23iUWHkoSGLUUX5d50Alq2dNayJZOVYtJETbmQybhLySgy3iCCQwgapQB3JDjmuMcolja3SKVuwsSw3pkcs4UBGBmZwgeldaTJmltkkQrBqmCTfyigMKC2VS/1YB/SEQ/eTQ7nZ0goa9GxxywiQ4zXKdwzVEXuJObJKQlMKmAlG5dqZezQ5sev4SqNNTkgny8oqJvpMQMFdTO1kd113YwQmnhJlROUGhe1wyogTxkmUmAsx+KF91hpINplBSaH+PYFmMN/kNJgZwhyQTKtJEEMResR80JiZsfCMD6hz1Iyyfv5fJvmhvLyMwQFlQHrxApUBjwbrHdbGUBpu5UBxxkcKAOAMgAoA4AygL7KADCirdcB7Nmzwe2hzhYDWBI9oUlqSiLBpBEque7MKIpjeq9H49pI1Z9zU7+muwaepubkdCpM2CUNu6SHiHrYJd0A0bBLGnZJj5YJhGxPbdjCLulnZVZhlzTskh6TxYZd0s9ul/REdkj0WEML+yOe9/6IiVS09Lc7AipanlVFy0QqAKA3wLPSgY4rAFo5HKIyGw9lAFAGAGUAUAbQWxkAEV3bNyhtApsGNg1sWn82jbZ8HM7Foqgl2nsBdg3sGtg1sGtPcF50WyWb5TZtcGWb2aNvMAlcR6IQsoJzJUM0ShPMVUTGKTuWLB0m/TGyusnpLJUwNTF2qnuBQvkmlG8OEflQvtkA0VC+CeWbo017QflmbdhC+eazMqtQvgnlm2Oy2FC++ezKN43VjCbvWKT4zzAdk7McNGdcO805cmwkOtBje+smp7IcSSFMTgu6ESIUrUHR2jPXg1aL1ljLB9pU4CEhGQrJUEiGQjK0v2RoBRtXse8d2C6wXWC7wHb1ZbsKMjdXx1FitjY/9vapPX1pBs2VZkzlKCGBeou74CihJzhKaCJHp/TX9BaOTun56BRoQ/4EBUDQhryRoLY8lpZnhXgHBh6iO4juILqD6K6v6E7hCtHdvYwu0iJW3O/FYu7CcjlfrGsiH/128AGfooIhFrUusCKMwino48q65GhEzEaTbsb9dVCWh5Uxp4Dz6DfTjQNblV02u+xZMpUxMsUDKarsSVphefqfQy7y0XQOZ/3RHOKwpc2Z9nJiiG9LbECG9BhKAhnSCRmyKYLYeZUno8e6SrILKPFntz/zfkBJIaCEgHKYAeVR1HYoF8wNstYRhSzXCgnJkjyocYJpxAS325Q+rprSvxfUx3Tln37eGq5Pbxbmz/Rnd9fpBtY391u4uQNtBW0Fbe1CW3l72hq2raIKkYDCgsKCwnahsKyZwqbPCz997RC/Kh67W6SvLkFfQV9BX7vQ1wqHz+b1dXW4vv5jcQXqCuoK6tqBuiLdTF0Lou3i6u5yViTj1rcBqgqqCqraxcpaoal7TlUvFrObR2VLL5fvZkvQWdBZ0NlhRq+rB9xwEcWCOwz6CvrakTtcO/36UF8LGSWd3brCwDKBnoKeDklP19f66aX3xTWka1/Mr9+FCP4v6CnoaQd6qs9klzZq+vPsrw+rxYfZfwXQT9BP0M/BraMXi3BrFuHD/G7hAlRBgJ6Cnna0jp5J/W7U9N/v5umGw8qAeoJ6gnp2sYyeWVW40c/34Xr+tVg/w6uF+SMAawRqCmraiZriJmqaYtGP327DxzkkYEBFQUU7UtEzE6YbFf2YJPZx/nruw6uruYNwFLQUtLQTLT1zz9u+lv6anvbs5hJ0FHQUdHRolNHFIlz+VlwIqCeoJ6hnB+rZKPHyNt1scnJBOUE5QTm7KNut3MNzvfVl/Xr7ctd4ZduZ5dfV9dXm7eZzUFlQWVDZp9x3elJlQV1BXUFdu1XXQiintHXzo2jeUHQvOwT6fbs1ULyNSAsg5Dr47ovz/izWp+/Py3P9eROYVOTIIm6I8JRJwZSROOLgmfJhNP15RX9HWdBDcZXiYmING6sJJddlFEeFDeaSRB6w4x5jETnRVBOS4GrGcnQQ6w2n5ND+7D+SyQH0hDSg/y30vx0QWls+DEgwbGkUKgjHg0yGVhHJhMLYKi2Tww0IrolgXtpo/uHzeR/irkXE7Wzz0eRwfLac4GgrONpqgHBuerSVqECLl3jOELyfDN41r3D8zkPD89NfLtyuX729+WquZv7Bx+mpJuil+7j/syEE++jFf2/a3JMK/E8L9/y5nBY0LwjAD0jbUtK2wa7lu1M98QCHgMMaOGzcrDzfS5V+Xmy/VgJMyGoBMJ8yq6WPZ7UyuO1QMlEhlgI3KwiiAimJjUQEe06ci9T7rR+HadXK6FYcG9Bh0GHQ4ZZ1uPIBzhlCE/QT9BP0sxv9lLTOUcX3UjpwhP9zYW7TIENgRViuBCJSrb1RQshgk64ESpy3jiU9UppKrkdCFyvdH1+sqqnVMcBMjTVuKK5sZs8X5217TywlimJksdfRMalRQDpwNxJw91c1ceII6cOH9XFhbpZxvrg2djc+HL/diuxyqOdGBiIpwTIZdGKVodFFT6KiiFFt/EhQ/+T5bOO+hE/v5s5c7b383f4zzbX+xeQQfraccmi2CiGFHTFGRaUQ5jGwqBFRisZAlAE0t2vDN0Okj47/Bmx4K7K7P5O7arKyqlME7ACwA8AOdMMOKNYiO7AfvQ+AKFA5osAraZCkEgtqEoJUjAFbxIP3sZDQWNZhJnpbiIVuEvk+wM7EluEWJZdzPalmUvBoAzXcW0WNcjFiEp1lmDozFvqgx0Cq2pqy+8X2/eTgfa6YgBQAUmB4YO6CFJDMWMGpijhQbLlB3iCmCqYXMc08bNmojWaRNTl7J9vvv/41XE0yZdFIWDlcI2ZTiMq8Fj4g5AhyLNIQmRbCSUoF4Lomrlnpo9o15lj/+Olr+sqb2fK2CBAniOZzRJTdEEqTATaOeUWp1ThKjGWMXpLCf/ZhLBnlp/Y0ju2rmS45e7accmieSH1Ej2iG8oihlEd4YxxPsSDSBBd5NSq99yY5Hxo7TzwfCbb7a36iSgP3pvvqJob4boS4S7aR2md0VGcTIe8GeTfIu3WTdxNVdjCfpkifPslGc0m2iWQchISUw7AW3S5SDo4HqgMxWGPCg0uKLZJTyVVScoYdxSMBc4+VW7Tu0rD77PuvpksPtCw9IA16rDsH0qBn0uBfZ57DdGShgMgIIiOIjDrqCYAqt6Y/RYWDmoKagpp2pKa86pFMrbfuQPjzl/mfH+cbZ+TjTnQlus1At0G3Qbdr6fbsBe1eMkXwWkEyVTW9Q4lxGYT3UQXkPeMKaUosZiQabz1FiG+tIal8BNYZTgsYPDB4YPDA4A3J4NHaJ8/X3+UJdg/sHtg9sHtDsnusdpPZRgU3YALBBIIJBBM4JBNIah/GXj2NBvYO7B3YO7B3Q7J3tOEBF5XPFQDjB8YPjB8YvyEZP6Z6TfOSz7frBEmSxN5BgT/efrktsYIcrCBYwSe0gselsY/j3uTCnLOac4+tU4xw6UXgwlrhZKRMUt2XDRS4klz29btHKXnlLHNIcCq9Nc4b5DhKshKWkKCiWEuJ9SAlXltKZVawQ0lpgZHkSEfkkbORGiUURiSZHGFRskDbnUwiv5Ppnbm5vDOX4Vdz46+S3C6+3Bb/bd9+CKvV7Oa+3nc52H6BkbtIvBWYBy08LfZ+hCgdZ1SGBKmx9AvElP7tyRpBVIXK1Mrfz5VTdjdTRIEZxoPUXBqBPGZcM2GkEz46Ca15aqNZ1jzF/d4JfmUmeFZ4M2lBa8Anb9gDrQF7aQ2oFUEMJxwHZmXgPBQHBxDhFcUsCkRGgmbVH5pLm+1uJ9k40Mnw+NnOBG1eTXefaWN5QcueF7g/Yw09ewbcsyfTARZZZyVmWgfLiUPRBSIssQZjR6MZS3jZnx6IUmEdZOjW1uvT67vlan69eTPpNvQtiCzbDdZTIYNWmjktkhMjSUFVUhUksxQR6HJcG+P5xr0Ps9DbR7Z9O2mctyS2rNuOGXLUFkkaXuQmGbWIYEZZ5NRoDs1iWm4WsxniTe6oqilDvmXp3R/1VaEyphpZCflfyP9C/hfyv5D/fW75X0wrnPdYugg8XOWuzHL5bvbHdkWD9QDWA1gPYD2A9eDZrQe4av+uTLYXzD+YfzD/YP7B/D8/8191t1TlTkiwCMAiAIsALAKwCDybRYBX2DV2mhP6cGf32aEk3eXK3KwevgO+CNYKWCtgrYC14pmuFVXyB93sMIZW8LAewHrQZD1Yn9dQ9QjKcwJ+UFFQUVDRPlT07DotUFFQUVDRpiqKK5xN1kYVDWgraCtoa0Nt1VWbQNcrcQDdBN0E3Wy6krJW6lGb5R5Ak0GTQZMbh61VKwnPabz7WEkJKCkoaamSFi5f1T6oNc87AhgCDGvAEKPazchP4PDx+TMASYBkHctYNX9b8TgQgB/Ar45FxOeRMfXrBw6BcL+/HoC5Oxmoaiq4Ai8G52KApXh2cTacizGVczHSJGHbozxd/tX3LuJk3UacJCRsb09+nt+tbu9WP88XafIDv2b5Il3TffNzctjpfPOjaOsyX9x/o2iRHjbM482uyUz+i+k7vBDXvaO/+96jbuvFvZ28ivW1dtMj7/gtdtXYsLpkCtGw+8fKPyf4LedXh57q/ROVxWvGHl31+kvp5/W1ufGftoIN2/c5CdQfq8bdpeEft699OPyHsPha6TrrDVTrIvlhI6OXb++H393++2Qsfrs3HhUuuMGg9SScmeel9+mXr67m7o9lFRnXHarehT7u+frwCT7QqyqXe96AtS6aHFOPl7e3WduZ/V49uZWeVJFxdrMyqz9YPTt/1tVO2PZ/X9LZ59uru8vZzYdvy+TS7C8AYm8BSOtoeiNLu4JfrL+/fr19+c4sVxfr3nrX17NVutLHv8mJqNVpaoFelLbyfzxzMUfhDhbp1iL1urq+2rzdfJ67udamqHdjpU3zTs5a+abaGL7eDZU2vjw54/vlqvI9tTRDrdtSh5OWZvcfXcMrswzpkw+rO2vTHz18e/pWu5y11u3rwzaiZ11IerlLEMwXlYXQ/dxPgIT08h83s1XPSCiftd7tq7MuJBn+2/kyzWncH+mPl7srqi6ATuetZ+IOPYVql/LG3P21/idr3BqPXetWMDpvvp92rVsTnOIs+Isr40L5b08/2h4vol4ceAi5/YXmp6/pLnb1XK9CLC4rvZndXF4s5i4sl9lgsOHI9eBa3gJ6f7J7Cu5lXLNcxbs03/dhMoBtYfR6t5NzQg8m3EhvTfSlCdPfF3xi9m6aD96eX5ud7x7mJ2+prSna82tLZ73HxXbCPOraGL6vG6qkRm0MX+uGssHcwYy/32zI8iPlHWfHjHWnqffEyo/0PDLzL2GVzGtxYNZ9RuDNbJF/Zu1MUO+pPSaS8nPuJrswqy+vvr1fZxG+Fl8ufpF9cC3P1JmRX09e2Kv3YTm/W7iwyQe1Y+SPDF7vZk6v9nvzFU387y3v5o9eb3JQ2XtqbY56cDzkXDOe2+YqNtMWqv4luD/eLjfvX5ubV2FzfEEWk11M11n098CRW/s+xZSFH/d90P0TD9qJ/urOWu/2Kx0TW3Ihv9+89H69r2HzBD7OK955NxPWY9xLmeEdy7T+sXcUXYZsrzVOPZ69RYJ0oux7a1zsdOXXGvU7XRG2QC1NV3gt+llrIZYfS3pkI1Ax3maYZQV/rfHQNROLTN0nFvdLofjnIql4cP7Yg+pTul8/tE42VjrCb3fpbxbmz104t37Mv4Wbu/p8Ur3RWwgTK0y4i05PhhvtTFCPuiwPcU41R8oi9twh6114nXPzCh4nhWdbncgzro3GrQeo0sD56PbBTelPsRC+KioQ3SJ9NU87tDJ+l7e0eqCTxdT/WFy1eEtHxm+Bz6u1ybM+n1dz+HqaU+Gkx+/6WS36On/Mepc+jnX2mAdyZLaLxezmkeReLt/NlmcwPefMUY/pqZJ/PbaozZa3V+bbOhp/eTv7Lay+zH3WxnUxW7MnWecC0hq+nv03ky0KbG+O9m/toY7XJqzam6N9OvK4Ed4IdIOXV3OfVMZnXaJOputuYX7o5ldy+toZv2YY1158MbpFfpJhfVsB2mSJkQbR4Fpmz6vkvK34a7JwaSvam64A21l21psdy0vFHu+ZrF+Z0XTkeo5KPg6r3j8kux63N0m9+LXavtbdL7bvs8/mzBHBmTi1FDZgSTY5gefJrLZMTkzWtHdDg0xWnG3SLCDEtgidyQnxOZv1jjiviWpTkSoXpalytp8qX3cDWR7ts4HWnkKVlON6oGI3fdEu5Gb182J+/S7EvG/YaNx6lW9VsiebqX6e/fVhtfgw+698Cdx5A9a76OryeXt9e3WC4z1ntHqXW8Ut20xwsQiXvxW9ZbIXfNZ47Sfp76e4NYvwoVJhdrNxu5L6v9/NVyHZFNOS1PfGqyf1KjzoZor34Xr+tRBLeLUwf+R3njQatoU1tnSmpPkfv92Gj/MTDPzZQ9a78CqE2GaWjykML0qNfVj3Rslee4NRW6gMyEz0a1gXjNevDKgyZhvUdSXM4BFmgP61LUcv8U/IZ/udvz44F+B7u5AKjskeDb7/+tdwdYpQbDTutGusTq+qJx/LRD12SPg0D3lEeXXwkUaJ9x0W/8MsZiZd+dFAaGNuDm3kYYB68L5acH3+oFAsA7zR5Hmj7XadM5S+CLaSI3fQEfle5dfexsTadT1bd3KEld2wF7IdnwpKGKCEAUoYBqmaUJ7VNNzBdTyfuEjQ/M0UXUuztMozqpIc2SZO6DNc14RAiT0sKfsWsThi5fCszm2/o7krjmQ4OJHo3vLx4xjYRqwf9of59Ga2SBc0X6SpH3xwRm+0esO3EBWVzljsFX672pxbUf2OWhm/1i3JXOHjwynfB3e3WBa9u854WO3O08KaVjr1h9nN5VUoZFv9mbUwer3byfFABxPuv6u2sav54HXTVuyxiVmEuCstvZ39+PiorX1Lg4+HkqfLd5e/LOZ32c2YTUeu64LSU9JI3yn++7gws9X7/U/yub36nO56hs3rWgKqOXIzVT492bqQ7d3sj3D6VtoYvWZur/FjYZP0VUvY8FLJfbndvv2w6daYr3g5d8jpQvhZRbetCR90DnQOdK66T1MSRJb6NPdOZHW/5gzZ38/SyZN9NPp0gXre/ZQ8HrC3YG/B3oKPAzoHOjdEndtKv5KP89PN3XUN2uawZOW02IsJKrA2zQaeLjL/1cJDAdsKthVsK/gzoHOgc0PUuTp5qN33vme+ju5+X/M1sG8C9k3UMVfPaN9EVZVZG5JOU7d75xu1nLp9MPJ07fl5qduDxwIuCbgk4JJAGAA6Bzo3RJ3bHgZc3ae5WMxvw2L17ahv8ygceKQZp+X/4c7unOftdPcvTj/vbuarZ8g6vecJmrZnplLFTr7qKrXpwFddoWSlE2GPgGsz2fbHaWVqf656itTZvYISDV2J6q1Laa7lytwcL5d+pEa6iY1+MOfDd6eVquuZ66lY93KgoHBDVzhQh+/74VCZ3TncniIPzQnNbSJJntw/0+SbdzlZ1BmlnprXu77Jbo+d1nk5DSiDySIESCogqYCk6tdOQYsH8OifXrTPSmvAo/++/Zw/9ug3V7xpH52G97NinKM5+g3vVt5bbnMbByOlz66v5zeHv/3ZXC3D/dss8db+ZLXAo3LhQsX5Z1ehaACefrMym3O1T993t/PWE0EuFKh2KevOCcG/val2791MWO+mc+1Jal3D3+erqvfd2Zy1bv0R11z/Mj4u7iqqd+tz1fPCS5eeo9NvX51upNFk2Fo3gNGpJtB7S8yjmffXlMMP3y4vFrOvCUyVnmO/11FTRIdPo81Lm6f1NClcRSH1eyU1xVQj9Kp7cXf2auYqyqjHy6gpoEPz3NaV/cdsObOzq1nRU6eSiHq9kHq+do085eHsm/xkMzvUz/z1RFKjeLL6JdWxO31dQT2xNLCFRy+qup3pZfqa9qXGXrtql/T7zdW34ti713eLRbr/ne5XMTF9X0s97LR+dTVNcE8X0Jud2VVYNTS+PV1BTbWqQcLUuap6nl9vF9GbImUuq4YZ7ucCaiKmynGyNS+qgSnu/2rqYaiD66trjvu6hHrkQuk5BqdYgGr7vJoOXS+R0hkDONnUVJf04kSFeqRkaXOdDzrq8v2aJTbqrbqj2VI51e4wQ+7gN5JGy5Afrk8A176aymay18uolxKskeJ4dGHbPRhvvqUZZq7qtpPOpmyWA2+2+aQyFLqdt1lOdKx7jSa4TzHZ4SYmp/wSKoO8+7nrrem5Iz62s5adAZFdzc8es9als1yp0L3rVvyoFGOfNVy9KBC66Ey3iw50VYHieSie73WTD/QyBXUDdetL3eA8BNA50Lmelzg4Yw30DfStN32DHYawwxAySPfq0HMKaaKFDt1nop6V8k0SAH1k5CYn2GfrBUKDwKn6HtBjdeJPv7fU9QSR8HxXgyZZ/LVX/XyzqmdWATy7pnUPy53xZ7c/1INyZ/Sog4so7brwPtz4sCgwmPD4bnbzR7IKLiyX88WnV2YZHv02yxu1NEMzKuzhpB+TQD79fHezHujTm4X5M/3Z3XW68rXMfgs3d7WosDNGr3c7pQCqMGHY+nCFLLN31M4E9W6qdOPDkTnT5yEBeg2MV0XvUbdIX80a2HbGr3dLh9F4fsrVoRT/sbjK3lEbw9db90p3Fx2Z8d3c+Iuru8tNg6FVmrj+xqUaQ9d7MqVNlI7MdrGY3TxaEF8u382W2Ttqb44u9Wj1wBgVeD+FulbGrwe7/JrxcMqiuVWadouLvM/VaNz2b2G9j+vTS+/fpl/frIp9mO9CzKtNo3HrhT9VNHQz1c+zvz6sFh9m/5WvozxvwK7kfrEIt2YRPszvFi6cWiGbjVtP7lXsyGaqf7+br0KKbExW7GeNV0/qVfyHzRTvw/X8ayGWtM6aP0JeX5sM2yzAOz5TwuXHb7fh4/yE3Tx7yHoXXsU6b2YpOgB+nL+e+/Dqau7yaG8war3Lr+JK70/0a/LNUhxcv8i8yphdqWmyCJe/mZX70pKa7o1X75KrG7G317dX6ZlmL/iM0ep5NuUB/NoPXL/evtxFi9tw8tfV9dXm7ebzrHPT1hQtxAknZ618U20MX49raTHgHl0QNTm+tE3GYrKZ/bbokekKsB07si6DfFRN+XCsdYz41+rT4RD/uTC3t/njbZqOXG/dyQdgJyar2t2ivUnquZKlmHs07+4X2/fZZ3PmiLA61N3t2ICNm659a4n3m6wAG8T8eISOarsB12RR1VJsN1H5/Wvzxz++/+nlm99+OnZa6fo1OQwxNj8KPzifkT7xxVqrNz2Me/fH+tm49G+2arva9+sh8KRgpoutQtzbOgn6ebE1pT8+PsuStWjfIYCAAAICiHYXWTj9rpZL0qbWTlaKUzoHd5tIf7xUIvz5y/zPj/PXac1chY/h+vYq/VweW0KnJDPQM+Btwe0Ct2vEqgluV71TVtXjJuSLEHcU9u3sx/SdkqWTly6dcBD96aUDDqI/W3zPdpMTND55UqcX1gQIIo/dLTTFga3J0BTnu0NI7rdpPnb62qx9hNgXYl+IfYFEH5oU1+l9XPx1MejnL2b5ZZcEFzRqRzxWXDDFlLJKRcEZ81JazLFf/1366qxwiW7M1Wdn3JcUK3xefluuwvXnr0nG6+uZvSB/+9f/D970zec= \ No newline at end of file +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 \ No newline at end of file diff --git a/docs/tech/01_configuration.md b/docs/tech/01_configuration.md index 26daec63..f9501371 100644 --- a/docs/tech/01_configuration.md +++ b/docs/tech/01_configuration.md @@ -1,68 +1,70 @@ - BumbleDocGen / Technical description of the project / Configuration
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +Configuration -

    Configuration

    +--- + + +# Configuration Documentation generator configuration can be stored in special files. They can be in different formats: yaml, json, php arrays, ini, xml But it is not necessary to use files to store the configuration; you can also initialize the documentation generator instance by passing there an array of configuration parameters (see demo-5) -During the instance creation process, configuration data is loaded into Configuration class, and the code works directly with it. +During the instance creation process, configuration data is loaded into [Configuration](/docs/tech/01_configuration.md) class, and the code works directly with it. -

    Configuration file example

    +# Configuration file example Let's look at an example of a real configuration in more detail: ```yaml - project_root: '%WORKING_DIR%' - templates_dir: '%project_root%/selfdoc/templates' - output_dir: "%project_root%/docs" - cache_dir: '%project_root%/.bumbleDocGenCache' - output_dir_base_url: "/docs" - language_handlers: - php: - class: \BumbleDocGen\LanguageHandler\Php\PhpHandler - settings: - file_source_base_url: 'https://github.com/bumble-tech/bumble-doc-gen/blob/master' - source_locators: - - class: \BumbleDocGen\Core\Parser\SourceLocator\RecursiveDirectoriesSourceLocator - arguments: - directories: - - "%project_root%/src" - - "%project_root%/selfdoc" - twig_filters: - - class: \SelfDocConfig\Twig\CustomFilter\EvalString - twig_functions: - - class: \SelfDocConfig\Twig\CustomFunction\FindEntitiesClassesByCollectionClassName - - class: \SelfDocConfig\Twig\CustomFunction\PrintClassCollectionAsGroupedTable - - class: \SelfDocConfig\Twig\CustomFunction\GetConfigParametersDescription - - class: \SelfDocConfig\Twig\CustomFunction\GetConsoleCommands - plugins: - - class: \SelfDocConfig\Plugin\TwigFilterClassParser\TwigFilterClassParserPlugin - - class: \SelfDocConfig\Plugin\TwigFunctionClassParser\TwigFunctionClassParserPlugin - - class: \BumbleDocGen\Core\Plugin\CorePlugin\LastPageCommitter\LastPageCommitter - -``` +project_root: '%WORKING_DIR%' +templates_dir: '%project_root%/selfdoc/templates' +output_dir: "%project_root%/docs" +cache_dir: '%project_root%/.bumbleDocGenCache' +output_dir_base_url: "/docs" +language_handlers: + php: + class: \BumbleDocGen\LanguageHandler\Php\PhpHandler + settings: + file_source_base_url: 'https://github.com/bumble-tech/bumble-doc-gen/blob/master' +source_locators: + - class: \BumbleDocGen\Core\Parser\SourceLocator\RecursiveDirectoriesSourceLocator + arguments: + directories: + - "%project_root%/src" + - "%project_root%/selfdoc" +twig_filters: + - class: \SelfDocConfig\Twig\CustomFilter\EvalString +twig_functions: + - class: \SelfDocConfig\Twig\CustomFunction\FindEntitiesClassesByCollectionClassName + - class: \SelfDocConfig\Twig\CustomFunction\PrintClassCollectionAsGroupedTable + - class: \SelfDocConfig\Twig\CustomFunction\GetConfigParametersDescription + - class: \SelfDocConfig\Twig\CustomFunction\GetConsoleCommands +plugins: + - class: \SelfDocConfig\Plugin\TwigFilterClassParser\TwigFilterClassParserPlugin + - class: \SelfDocConfig\Plugin\TwigFunctionClassParser\TwigFunctionClassParserPlugin + - class: \BumbleDocGen\Core\Plugin\CorePlugin\LastPageCommitter\LastPageCommitter +``` In this example, we see the real configuration of the self-documentation of this project. **Here is an example of loading this configuration in PHP code:** ```php - // Single file - $docGenerator = (new DocGeneratorFactory())->create('config.yaml'); - - // Multiple files - $docGenerator = (new DocGeneratorFactory())->create('config.yaml', 'config2.yaml', 'config3.xml'); - - // Passing configuration as an array - $docGenerator = (new DocGeneratorFactory())->createByConfigArray($configArray); - -``` +// Single file +$docGenerator = (new DocGeneratorFactory())->create('config.yaml'); + +// Multiple files +$docGenerator = (new DocGeneratorFactory())->create('config.yaml', 'config2.yaml', 'config3.xml'); +// Passing configuration as an array +$docGenerator = (new DocGeneratorFactory())->createByConfigArray($configArray); +``` -

    Handling and inheritance of configuration files

    +## Handling and inheritance of configuration files The documentation generator can work with several configuration files at once. When processing configuration files, each subsequent file has a higher priority and overwrites the previously defined parameters, but if the parameter has not yet been defined before, it will be added. @@ -70,167 +72,30 @@ When processing configuration files, each subsequent file has a higher priority Each default configuration file inherits the base configuration: `BumbleDocGen/Core/Configuration/defaultConfiguration.yaml`, but the parent configuration file can be changed using the `parent_configuration` parameter. The inheritance algorithm is as follows: scalar types can be overwritten by each subsequent configuration, while arrays are supplemented with new data instead of overwriting. -

    Configuration parameters

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    KeyTypeDefault valueDescription
    parent_configurationstring|nullNULLPath to parent configuration file
    project_rootstringNULLPath to the directory of the documented project (or part of the project)
    templates_dirstringNULLPath to directory with documentation templates
    output_dirstring'%project_root%/docs'Path to the directory where the finished documentation will be generated
    cache_dirstring|null'%WORKING_DIR%/.bumbleDocGenCache'Path to the directory where the documentation generator cache will be saved
    output_dir_base_urlstring'/docs'Basic part of url documentation. Used to form links in generated documents.
    git_client_pathstring'git'Path to git client
    render_with_front_matterboolfalseDo not remove the front matter block from templates when creating documents
    check_file_in_git_before_creating_docbooltrueChecking if a document exists in GIT before creating a document
    page_link_processorPageLinkProcessorInterfaceBasePageLinkProcessorLink handler class on documentation pages
    language_handlersarray<LanguageHandlerInterface>NULLList of programming language handlers
    source_locatorsarray<SourceLocatorInterface>NULLList of source locators
    use_shared_cachebooltrueEnable cache usage of generated documents
    twig_functionsarray<CustomFunctionInterface> - -- DrawDocumentationMenu - -- DrawDocumentedEntityLink - -- GeneratePageBreadcrumbs - -- GetDocumentedEntityUrl - -- LoadPluginsContent - -- PrintEntityCollectionAsList - -- GetDocumentationPageUrl - -- FileGetContents - -Functions that can be used in document templates
    twig_filtersarray<CustomFilterInterface> - -- AddIndentFromLeft - -- FixStrSize - -- PrepareSourceLink - -- Quotemeta - -- RemoveLineBrakes - -- StrTypeToUrl - -- TextToCodeBlock - -- TextToHeading - -- PregMatch - -- Implode - -Filters that can be used in document templates
    pluginsarray<PluginInterface>|null - -- PageHtmlLinkerPlugin - -- PageLinkerPlugin - -List of plugins
    additional_console_commandsarray<Command>NULLAdditional console commands
    - - -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Fri Jan 12 18:53:16 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +## Configuration parameters + +| Key | Type | Default value | Description | +|-|-|-|-| +| **`parent_configuration`** | string \| null | NULL | Path to parent configuration file | +| **`project_root`** | string | NULL | Path to the directory of the documented project (or part of the project) | +| **`templates_dir`** | string | NULL | Path to directory with documentation templates | +| **`output_dir`** | string | '%project_root%/docs' | Path to the directory where the finished documentation will be generated | +| **`cache_dir`** | string \| null | '%WORKING_DIR%/.bumbleDocGenCache' | Path to the directory where the documentation generator cache will be saved | +| **`output_dir_base_url`** | string | '/docs' | Basic part of url documentation. Used to form links in generated documents. | +| **`git_client_path`** | string | 'git' | Path to git client | +| **`render_with_front_matter`** | bool | false | Do not remove the front matter block from templates when creating documents | +| **`check_file_in_git_before_creating_doc`** | bool | true | Checking if a document exists in GIT before creating a document | +| **`page_link_processor`** | PageLinkProcessorInterface | [BasePageLinkProcessor](/docs/tech/classes/BasePageLinkProcessor.md) | Link handler class on documentation pages | +| **`language_handlers`** | array<LanguageHandlerInterface> | NULL | List of programming language handlers | +| **`source_locators`** | array<SourceLocatorInterface> | NULL | List of source locators | +| **`use_shared_cache`** | bool | true | Enable cache usage of generated documents | +| **`twig_functions`** | array<CustomFunctionInterface> |
    • [DrawDocumentationMenu](/docs/tech/classes/DrawDocumentationMenu.md)
    • [DrawDocumentedEntityLink](/docs/tech/classes/DrawDocumentedEntityLink.md)
    • [GeneratePageBreadcrumbs](/docs/tech/classes/GeneratePageBreadcrumbs.md)
    • [GetDocumentedEntityUrl](/docs/tech/classes/GetDocumentedEntityUrl.md)
    • [LoadPluginsContent](/docs/tech/classes/LoadPluginsContent.md)
    • [PrintEntityCollectionAsList](/docs/tech/classes/PrintEntityCollectionAsList.md)
    • [GetDocumentationPageUrl](/docs/tech/classes/GetDocumentationPageUrl.md)
    • [FileGetContents](/docs/tech/classes/FileGetContents.md)
    | Functions that can be used in document templates | +| **`twig_filters`** | array<CustomFilterInterface> |
    • [AddIndentFromLeft](/docs/tech/classes/AddIndentFromLeft.md)
    • [FixStrSize](/docs/tech/classes/FixStrSize.md)
    • [PrepareSourceLink](/docs/tech/classes/PrepareSourceLink.md)
    • [Quotemeta](/docs/tech/classes/Quotemeta.md)
    • [RemoveLineBrakes](/docs/tech/classes/RemoveLineBrakes.md)
    • [StrTypeToUrl](/docs/tech/classes/StrTypeToUrl.md)
    • [PregMatch](/docs/tech/classes/PregMatch.md)
    • [Implode](/docs/tech/classes/Implode.md)
    | Filters that can be used in document templates | +| **`plugins`** | array<PluginInterface> \| null |
    • [PageHtmlLinkerPlugin](/docs/tech/classes/PageHtmlLinkerPlugin_2.md)
    • [PageLinkerPlugin](/docs/tech/classes/PageLinkerPlugin_2.md)
    | List of plugins | +| **`additional_console_commands`** | array<Command> | NULL | Additional console commands | + + + +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 17:19:08 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/classes/ClassConstantEntitiesCollection.md b/docs/tech/02_parser/classes/ClassConstantEntitiesCollection.md index a0ce2089..5d41bec8 100644 --- a/docs/tech/02_parser/classes/ClassConstantEntitiesCollection.md +++ b/docs/tech/02_parser/classes/ClassConstantEntitiesCollection.md @@ -1,12 +1,13 @@ - BumbleDocGen / Technical description of the project / Parser / Entities and entities collections / ClassConstantEntitiesCollection
    - -

    - ClassConstantEntitiesCollection class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +ClassConstantEntitiesCollection +--- +# [ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php#L15) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant; @@ -14,394 +15,147 @@ namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant final class ClassConstantEntitiesCollection extends \BumbleDocGen\Core\Parser\Entity\BaseEntityCollection implements \IteratorAggregate ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [add](#madd) +1. [get](#mget) +1. [getIterator](#mgetiterator) +1. [has](#mhas) - Check if an entity has been added to the collection +1. [isEmpty](#misempty) - Check if the collection is empty or not +1. [loadConstantEntities](#mloadconstantentities) +1. [remove](#mremove) - Remove an entity from a collection +1. [unsafeGet](#munsafeget) +## Methods details: - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - add -
    2. -
    3. - get -
    4. -
    5. - getIterator -
    6. -
    7. - has - - Check if an entity has been added to the collection
    8. -
    9. - isEmpty - - Check if the collection is empty or not
    10. -
    11. - loadConstantEntities -
    12. -
    13. - remove - - Remove an entity from a collection
    14. -
    15. - unsafeGet -
    16. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php#L17) ```php public function __construct(\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity $classEntity, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory $cacheablePhpEntityFactory); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$classEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$cacheablePhpEntityFactory | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/Cache/CacheablePhpEntityFactory.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $cacheablePhpEntityFactory\BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory-
    - - - -
    -
    -
    - - +--- +# `add` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php#L50) ```php public function add(\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity $constantEntity, bool $reload = false): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$constantEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) | - | +$reload | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity-
    $reloadbool-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection - - -
    -
    -
    - - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) +--- + +# `get` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php#L62) ```php public function get(string $objectName): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) +--- -
    -
    -
    - - - +# `getIterator` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L11) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function getIterator(): \Generator; ``` +***Return value:*** [\Generator](https://www.php.net/manual/en/language.generators.overview.php) +--- -Parameters: not specified - -Return value: \Generator - - -
    -
    -
    - - - +# `has` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L42) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function has(string $objectName): bool; ``` +Check if an entity has been added to the collection -
    Check if an entity has been added to the collection
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isEmpty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L52) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function isEmpty(): bool; ``` +Check if the collection is empty or not -
    Check if the collection is empty or not
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - -
      -
    • # - loadConstantEntities - :warning: Is internal | source code
    • -
    +--- +# `loadConstantEntities` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php#L32) ```php public function loadConstantEntities(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - - - +# `remove` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L32) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function remove(string $objectName): void; ``` +Remove an entity from a collection -
    Remove an entity from a collection
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Return value: void +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -
    -
    -
    - - - +# `unsafeGet` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php#L75) ```php public function unsafeGet(string $constantName): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestring-
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity - - -Throws: - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/ClassConstantEntity.md b/docs/tech/02_parser/classes/ClassConstantEntity.md index 9d7979b8..83b92e99 100644 --- a/docs/tech/02_parser/classes/ClassConstantEntity.md +++ b/docs/tech/02_parser/classes/ClassConstantEntity.md @@ -1,1502 +1,617 @@ - BumbleDocGen / Technical description of the project / Parser / Entities and entities collections / ClassConstantEntity
    - -

    - ClassConstantEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +ClassConstantEntity +--- +# [ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L24) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant; class ClassConstantEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity implements \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface ``` - -
    Class constant entity
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    2. -
    3. - getAst - - Get AST for this entity
    4. -
    5. - getCacheKey -
    6. -
    7. - getCachedEntityDependencies -
    8. -
    9. - getCurrentRootEntity -
    10. -
    11. - getDescription - - Get entity description
    12. -
    13. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    14. -
    15. - getDocBlock - - Get DocBlock for current entity
    16. -
    17. - getDocComment - - Get the doc comment of an entity
    18. -
    19. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    20. -
    21. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    22. -
    23. - getDocNote - - Get the note annotation value
    24. -
    25. - getEndLine - - Get the line number of the end of a constant's code in a file
    26. -
    27. - getExamples - - Get parsed examples from `examples` doc block
    28. -
    29. - getFileSourceLink -
    30. -
    31. - getFirstExample - - Get first example from `examples` doc block
    32. -
    33. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    34. -
    35. - getImplementingClassName -
    36. -
    37. - getName - - Constant name
    38. -
    39. - getNamespaceName - - Get the name of the namespace where the current class is implemented
    40. -
    41. - getObjectId - - Get entity unique ID
    42. -
    43. - getRelativeFileName - - File name relative to project_root configuration parameter
    44. -
    45. - getRootEntity - - Get the class like entity where this constant was obtained
    46. -
    47. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    48. -
    49. - getShortName - - Constant short name
    50. -
    51. - getStartLine - - Get the line number of the beginning of the constant code in a file
    52. -
    53. - getThrows - - Get parsed throws from `throws` doc block
    54. -
    55. - getThrowsDocBlockLinks -
    56. -
    57. - getValue - - Get the compiled value of a constant
    58. -
    59. - hasDescriptionLinks - - Checking if an entity has links in its description
    60. -
    61. - hasExamples - - Checking if an entity has `example` docBlock
    62. -
    63. - hasThrows - - Checking if an entity has `throws` docBlock
    64. -
    65. - isApi - - Checking if an entity has `api` docBlock
    66. -
    67. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    68. -
    69. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    70. -
    71. - isEntityDataCacheOutdated -
    72. -
    73. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    74. -
    75. - isInternal - - Checking if an entity has `internal` docBlock
    76. -
    77. - isPrivate - - Check if a constant is a private constant
    78. -
    79. - isProtected - - Check if a constant is a protected constant
    80. -
    81. - isPublic - - Check if a constant is a public constant
    82. -
    83. - reloadEntityDependenciesCache - - Update entity dependency cache
    84. -
    85. - removeEntityValueFromCache -
    86. -
    87. - removeNotUsedEntityDataCache -
    88. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Class constant entity + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getEndLine](#mgetendline) - Get the line number of the end of a constant's code in a file +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getImplementingClassName](#mgetimplementingclassname) +1. [getModifiersString](#mgetmodifiersstring) - Get a text representation of class constant modifiers +1. [getName](#mgetname) - Constant name +1. [getNamespaceName](#mgetnamespacename) - Get the name of the namespace where the current class is implemented +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntity](#mgetrootentity) - Get the class like entity where this constant was obtained +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Constant short name +1. [getStartLine](#mgetstartline) - Get the line number of the beginning of the constant code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getType](#mgettype) - Get current class constant type +1. [getValue](#mgetvalue) - Get the compiled value of a constant +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isPrivate](#misprivate) - Check if a constant is a private constant +1. [isProtected](#misprotected) - Check if a constant is a protected constant +1. [isPublic](#mispublic) - Check if a constant is a public constant +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L55) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity $classEntity, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $constantName, string $implementingClassName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$classEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$implementingClassName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $classEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $constantNamestring-
    $implementingClassNamestring-
    - - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L93) ```php public function getAst(): \PhpParser\Node\Stmt\ClassConst; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\ClassConst - - -Throws: - - -
    -
    -
    +***Return value:*** [\PhpParser\Node\Stmt\ClassConst](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/ClassConst.php) - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    - +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    +***Return value:*** [\phpDocumentor\Reflection\DocBlock](https://github.com/phpDocumentor/ReflectionDocBlock/blob/master/src/DocBlock.php) -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    - +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L129) ```php public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -
    -
    -
    - - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    - -Parameters: not specified - -Return value: null | int - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L275) ```php public function getEndLine(): int; ``` +Get the line number of the end of a constant's code in a file -
    Get the line number of the end of a constant's code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    +--- +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - - -Throws: - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L121) ```php public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -
    -
    -
    - - - +# `getImplementingClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L113) ```php public function getImplementingClassName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L169) +```php +public function getModifiersString(): string; +``` +Get a text representation of class constant modifiers -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L137) ```php public function getName(): string; ``` +Constant name -
    Constant name
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L157) ```php public function getNamespaceName(): string; ``` +Get the name of the namespace where the current class is implemented -
    Get the name of the namespace where the current class is implemented
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L185) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L90) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified - -Return value: null | string - - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -See: - -
    -
    -
    +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) - +--- +# `getRootEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L83) ```php public function getRootEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity where this constant was obtained -
    Get the class like entity where this constant was obtained
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - +--- +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L75) ```php public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) - +--- +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L147) ```php public function getShortName(): string; ``` +Constant short name -
    Constant short name
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::getName()](/docs/tech/02_parser/classes/ClassConstantEntity_2.md#mgetname) -Return value: string - - - -See: - -
    -
    -
    - - +--- +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L263) ```php public function getStartLine(): int; ``` +Get the line number of the beginning of the constant code in a file -
    Get the line number of the beginning of the constant code in a file
    - -Parameters: not specified - -Return value: int - - -Throws: - - -
    -
    -
    - - +--- +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - +# `getType` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L191) +```php +public function getType(): string; +``` +Get current class constant type -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L290) ```php public function getValue(): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) -Return value: string | array | int | bool | null | float - - -Throws: - - -
    -
    -
    - - +--- +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isPrivate` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L251) ```php public function isPrivate(): bool; ``` +Check if a constant is a private constant -
    Check if a constant is a private constant
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isProtected` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L239) ```php public function isProtected(): bool; ``` +Check if a constant is a protected constant -
    Check if a constant is a protected constant
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isPublic` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L227) ```php public function isPublic(): bool; ``` +Check if a constant is a public constant -
    Check if a constant is a public constant
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/02_parser/classes/ClassConstantEntity_2.md b/docs/tech/02_parser/classes/ClassConstantEntity_2.md index bbc713c9..61ae7cc9 100644 --- a/docs/tech/02_parser/classes/ClassConstantEntity_2.md +++ b/docs/tech/02_parser/classes/ClassConstantEntity_2.md @@ -1,1502 +1,616 @@ - BumbleDocGen / Technical description of the project / Parser / ClassConstantEntity
    - -

    - ClassConstantEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +ClassConstantEntity +--- +# [ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L24) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant; class ClassConstantEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity implements \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface ``` - -
    Class constant entity
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    2. -
    3. - getAst - - Get AST for this entity
    4. -
    5. - getCacheKey -
    6. -
    7. - getCachedEntityDependencies -
    8. -
    9. - getCurrentRootEntity -
    10. -
    11. - getDescription - - Get entity description
    12. -
    13. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    14. -
    15. - getDocBlock - - Get DocBlock for current entity
    16. -
    17. - getDocComment - - Get the doc comment of an entity
    18. -
    19. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    20. -
    21. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    22. -
    23. - getDocNote - - Get the note annotation value
    24. -
    25. - getEndLine - - Get the line number of the end of a constant's code in a file
    26. -
    27. - getExamples - - Get parsed examples from `examples` doc block
    28. -
    29. - getFileSourceLink -
    30. -
    31. - getFirstExample - - Get first example from `examples` doc block
    32. -
    33. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    34. -
    35. - getImplementingClassName -
    36. -
    37. - getName - - Constant name
    38. -
    39. - getNamespaceName - - Get the name of the namespace where the current class is implemented
    40. -
    41. - getObjectId - - Get entity unique ID
    42. -
    43. - getRelativeFileName - - File name relative to project_root configuration parameter
    44. -
    45. - getRootEntity - - Get the class like entity where this constant was obtained
    46. -
    47. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    48. -
    49. - getShortName - - Constant short name
    50. -
    51. - getStartLine - - Get the line number of the beginning of the constant code in a file
    52. -
    53. - getThrows - - Get parsed throws from `throws` doc block
    54. -
    55. - getThrowsDocBlockLinks -
    56. -
    57. - getValue - - Get the compiled value of a constant
    58. -
    59. - hasDescriptionLinks - - Checking if an entity has links in its description
    60. -
    61. - hasExamples - - Checking if an entity has `example` docBlock
    62. -
    63. - hasThrows - - Checking if an entity has `throws` docBlock
    64. -
    65. - isApi - - Checking if an entity has `api` docBlock
    66. -
    67. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    68. -
    69. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    70. -
    71. - isEntityDataCacheOutdated -
    72. -
    73. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    74. -
    75. - isInternal - - Checking if an entity has `internal` docBlock
    76. -
    77. - isPrivate - - Check if a constant is a private constant
    78. -
    79. - isProtected - - Check if a constant is a protected constant
    80. -
    81. - isPublic - - Check if a constant is a public constant
    82. -
    83. - reloadEntityDependenciesCache - - Update entity dependency cache
    84. -
    85. - removeEntityValueFromCache -
    86. -
    87. - removeNotUsedEntityDataCache -
    88. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Class constant entity + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getEndLine](#mgetendline) - Get the line number of the end of a constant's code in a file +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getImplementingClassName](#mgetimplementingclassname) +1. [getModifiersString](#mgetmodifiersstring) - Get a text representation of class constant modifiers +1. [getName](#mgetname) - Constant name +1. [getNamespaceName](#mgetnamespacename) - Get the name of the namespace where the current class is implemented +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntity](#mgetrootentity) - Get the class like entity where this constant was obtained +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Constant short name +1. [getStartLine](#mgetstartline) - Get the line number of the beginning of the constant code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getType](#mgettype) - Get current class constant type +1. [getValue](#mgetvalue) - Get the compiled value of a constant +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isPrivate](#misprivate) - Check if a constant is a private constant +1. [isProtected](#misprotected) - Check if a constant is a protected constant +1. [isPublic](#mispublic) - Check if a constant is a public constant +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L55) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity $classEntity, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $constantName, string $implementingClassName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$classEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$implementingClassName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $classEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $constantNamestring-
    $implementingClassNamestring-
    - - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L93) ```php public function getAst(): \PhpParser\Node\Stmt\ClassConst; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\ClassConst - - -Throws: - - -
    -
    -
    +***Return value:*** [\PhpParser\Node\Stmt\ClassConst](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/ClassConst.php) - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    - +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    +***Return value:*** [\phpDocumentor\Reflection\DocBlock](https://github.com/phpDocumentor/ReflectionDocBlock/blob/master/src/DocBlock.php) -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    - +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L129) ```php public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -
    -
    -
    - - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    - -Parameters: not specified - -Return value: null | int - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L275) ```php public function getEndLine(): int; ``` +Get the line number of the end of a constant's code in a file -
    Get the line number of the end of a constant's code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    +--- +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - - -Throws: - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L121) ```php public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -
    -
    -
    - - - +# `getImplementingClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L113) ```php public function getImplementingClassName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L169) +```php +public function getModifiersString(): string; +``` +Get a text representation of class constant modifiers -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L137) ```php public function getName(): string; ``` +Constant name -
    Constant name
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L157) ```php public function getNamespaceName(): string; ``` +Get the name of the namespace where the current class is implemented -
    Get the name of the namespace where the current class is implemented
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L185) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L90) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified - -Return value: null | string - - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -See: - -
    -
    -
    +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) - +--- +# `getRootEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L83) ```php public function getRootEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity where this constant was obtained -
    Get the class like entity where this constant was obtained
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - +--- +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L75) ```php public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) - +--- +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L147) ```php public function getShortName(): string; ``` +Constant short name -
    Constant short name
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::getName()](/docs/tech/02_parser/classes/ClassConstantEntity_2.md#mgetname) -Return value: string - - - -See: - -
    -
    -
    - - +--- +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L263) ```php public function getStartLine(): int; ``` +Get the line number of the beginning of the constant code in a file -
    Get the line number of the beginning of the constant code in a file
    - -Parameters: not specified - -Return value: int - - -Throws: - - -
    -
    -
    - - +--- +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - +# `getType` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L191) +```php +public function getType(): string; +``` +Get current class constant type -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L290) ```php public function getValue(): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) -Return value: string | array | int | bool | null | float - - -Throws: - - -
    -
    -
    - - +--- +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isPrivate` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L251) ```php public function isPrivate(): bool; ``` +Check if a constant is a private constant -
    Check if a constant is a private constant
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isProtected` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L239) ```php public function isProtected(): bool; ``` +Check if a constant is a protected constant -
    Check if a constant is a protected constant
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isPublic` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L227) ```php public function isPublic(): bool; ``` +Check if a constant is a public constant -
    Check if a constant is a public constant
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/02_parser/classes/ClassEntity.md b/docs/tech/02_parser/classes/ClassEntity.md index ce12ff6b..ecbd0aa9 100644 --- a/docs/tech/02_parser/classes/ClassEntity.md +++ b/docs/tech/02_parser/classes/ClassEntity.md @@ -1,3463 +1,1364 @@ - BumbleDocGen / Technical description of the project / Parser / Entities and entities collections / ClassEntity
    - -

    - ClassEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +ClassEntity +--- +# [ClassEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L15) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; class ClassEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity implements \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface, \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface ``` - -
    PHP Class
    - -See: - - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - addPluginData - - Add information to aт entity object
    2. -
    3. - cursorToDocAttributeLinkFragment -
    4. -
    5. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    6. -
    7. - getAst - - Get AST for this entity
    8. -
    9. - getCacheKey -
    10. -
    11. - getCachedEntityDependencies -
    12. -
    13. - getConstant - - Get the method entity by its name
    14. -
    15. - getConstantEntitiesCollection - - Get a collection of constant entities
    16. -
    17. - getConstantValue - - Get the compiled value of a constant
    18. -
    19. - getConstants - - Get all constants that are available according to the configuration as an array
    20. -
    21. - getConstantsData - - Get a list of all constants and classes where they are implemented
    22. -
    23. - getConstantsValues - - Get class constant compiled values according to filters
    24. -
    25. - getCurrentRootEntity -
    26. -
    27. - getDescription - - Get entity description
    28. -
    29. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    30. -
    31. - getDocBlock - - Get DocBlock for current entity
    32. -
    33. - getDocComment - - Get the doc comment of an entity
    34. -
    35. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    36. -
    37. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    38. -
    39. - getDocNote - - Get the note annotation value
    40. -
    41. - getDocRender -
    42. -
    43. - getEndLine - - Get the line number of the end of a class code in a file
    44. -
    45. - getEntityDependencies -
    46. -
    47. - getExamples - - Get parsed examples from `examples` doc block
    48. -
    49. - getFileContent -
    50. -
    51. - getFileSourceLink -
    52. -
    53. - getFirstExample - - Get first example from `examples` doc block
    54. -
    55. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    56. -
    57. - getInterfaceNames - - Get a list of class interface names
    58. -
    59. - getInterfacesEntities - - Get a list of interface entities that the current class implements
    60. -
    61. - getMethod - - Get the method entity by its name
    62. -
    63. - getMethodEntitiesCollection - - Get a collection of method entities
    64. -
    65. - getMethods - - Get all methods that are available according to the configuration as an array
    66. -
    67. - getMethodsData - - Get a list of all methods and classes where they are implemented
    68. -
    69. - getModifiersString - - Get entity modifiers as a string
    70. -
    71. - getName - - Full name of the entity
    72. -
    73. - getNamespaceName - - Get the entity namespace name
    74. -
    75. - getObjectId - - Get entity unique ID
    76. -
    77. - getParentClass - - Get the entity of the parent class if it exists
    78. -
    79. - getParentClassEntities - - Get a list of parent class entities
    80. -
    81. - getParentClassName - - Get the name of the parent class entity if it exists
    82. -
    83. - getParentClassNames - - Get a list of entity names of parent classes
    84. -
    85. - getPluginData - - Get additional information added using the plugin
    86. -
    87. - getProperties - - Get all properties that are available according to the configuration as an array
    88. -
    89. - getPropertiesData - - Get a list of all properties and classes where they are implemented
    90. -
    91. - getProperty - - Get the property entity by its name
    92. -
    93. - getPropertyDefaultValue - - Get the compiled value of a property
    94. -
    95. - getPropertyEntitiesCollection - - Get a collection of property entities
    96. -
    97. - getRelativeFileName - - File name relative to project_root configuration parameter
    98. -
    99. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    100. -
    101. - getShortName - - Short name of the entity
    102. -
    103. - getStartLine - - Get the line number of the start of a class code in a file
    104. -
    105. - getThrows - - Get parsed throws from `throws` doc block
    106. -
    107. - getThrowsDocBlockLinks -
    108. -
    109. - getTraits - - Get a list of trait entities of the current class
    110. -
    111. - getTraitsNames - - Get a list of class traits names
    112. -
    113. - hasConstant - - Check if a constant exists in a class
    114. -
    115. - hasDescriptionLinks - - Checking if an entity has links in its description
    116. -
    117. - hasExamples - - Checking if an entity has `example` docBlock
    118. -
    119. - hasMethod - - Check if a method exists in a class
    120. -
    121. - hasParentClass - - Check if a certain parent class exists in a chain of parent classes
    122. -
    123. - hasProperty - - Check if a property exists in a class
    124. -
    125. - hasThrows - - Checking if an entity has `throws` docBlock
    126. -
    127. - hasTraits - - Check if the class contains traits
    128. -
    129. - implementsInterface - - Check if a class implements an interface
    130. -
    131. - isAbstract - - Check that an entity is abstract
    132. -
    133. - isApi - - Checking if an entity has `api` docBlock
    134. -
    135. - isAttribute - - Check if a class is an attribute
    136. -
    137. - isClass - - Check if an entity is a Class
    138. -
    139. - isClassLoad -
    140. -
    141. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    142. -
    143. - isDocumentCreationAllowed -
    144. -
    145. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    146. -
    147. - isEntityDataCacheOutdated -
    148. -
    149. - isEntityDataCanBeLoaded -
    150. -
    151. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    152. -
    153. - isEntityNameValid - - Check if the name is a valid name for ClassLikeEntity
    154. -
    155. - isEnum - - Check if an entity is an Enum
    156. -
    157. - isExternalLibraryEntity - - Check if a given entity is an entity from a third party library (connected via composer)
    158. -
    159. - isInGit - - Checking if class file is in git repository
    160. -
    161. - isInstantiable - - Check that an entity is instantiable
    162. -
    163. - isInterface - - Check if an entity is an Interface
    164. -
    165. - isInternal - - Checking if an entity has `internal` docBlock
    166. -
    167. - isSubclassOf - - Whether the given class is a subclass of the specified class
    168. -
    169. - isTrait - - Check if an entity is a Trait
    170. -
    171. - normalizeClassName - - Bring the class name to the standard format used in the system
    172. -
    173. - reloadEntityDependenciesCache - - Update entity dependency cache
    174. -
    175. - removeEntityValueFromCache -
    176. -
    177. - removeNotUsedEntityDataCache -
    178. -
    179. - setCustomAst -
    180. -
    - - - - - - - -

    Method details:

    - -
    - - - +PHP Class + +***Links:*** +- [https://www.php.net/manual/en/language.oop5.php](https://www.php.net/manual/en/language.oop5.php) + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [addPluginData](#maddplugindata) - Add information to aт entity object +1. [cursorToDocAttributeLinkFragment](#mcursortodocattributelinkfragment) +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getConstant](#mgetconstant) - Get the method entity by its name +1. [getConstantEntitiesCollection](#mgetconstantentitiescollection) - Get a collection of constant entities +1. [getConstantValue](#mgetconstantvalue) - Get the compiled value of a constant +1. [getConstants](#mgetconstants) - Get all constants that are available according to the configuration as an array +1. [getConstantsData](#mgetconstantsdata) - Get a list of all constants and classes where they are implemented +1. [getConstantsValues](#mgetconstantsvalues) - Get class constant compiled values according to filters +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getDocRender](#mgetdocrender) +1. [getEndLine](#mgetendline) - Get the line number of the end of a class code in a file +1. [getEntityDependencies](#mgetentitydependencies) +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getInterfaceNames](#mgetinterfacenames) - Get a list of class interface names +1. [getInterfacesEntities](#mgetinterfacesentities) - Get a list of interface entities that the current class implements +1. [getMethod](#mgetmethod) - Get the method entity by its name +1. [getMethodEntitiesCollection](#mgetmethodentitiescollection) - Get a collection of method entities +1. [getMethods](#mgetmethods) - Get all methods that are available according to the configuration as an array +1. [getMethodsData](#mgetmethodsdata) - Get a list of all methods and classes where they are implemented +1. [getModifiersString](#mgetmodifiersstring) - Get entity modifiers as a string +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Get the entity namespace name +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getParentClass](#mgetparentclass) - Get the entity of the parent class if it exists +1. [getParentClassEntities](#mgetparentclassentities) - Get a list of parent class entities +1. [getParentClassName](#mgetparentclassname) - Get the name of the parent class entity if it exists +1. [getParentClassNames](#mgetparentclassnames) - Get a list of entity names of parent classes +1. [getPluginData](#mgetplugindata) - Get additional information added using the plugin +1. [getProperties](#mgetproperties) - Get all properties that are available according to the configuration as an array +1. [getPropertiesData](#mgetpropertiesdata) - Get a list of all properties and classes where they are implemented +1. [getProperty](#mgetproperty) - Get the property entity by its name +1. [getPropertyDefaultValue](#mgetpropertydefaultvalue) - Get the compiled value of a property +1. [getPropertyEntitiesCollection](#mgetpropertyentitiescollection) - Get a collection of property entities +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getTraits](#mgettraits) - Get a list of trait entities of the current class +1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names +1. [hasConstant](#mhasconstant) - Check if a constant exists in a class +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasMethod](#mhasmethod) - Check if a method exists in a class +1. [hasParentClass](#mhasparentclass) - Check if a certain parent class exists in a chain of parent classes +1. [hasProperty](#mhasproperty) - Check if a property exists in a class +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [hasTraits](#mhastraits) - Check if the class contains traits +1. [implementsInterface](#mimplementsinterface) - Check if a class implements an interface +1. [isAbstract](#misabstract) - Check that an entity is abstract +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isAttribute](#misattribute) - Check if a class is an attribute +1. [isClass](#misclass) - Check if an entity is a Class +1. [isClassLoad](#misclassload) +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isDocumentCreationAllowed](#misdocumentcreationallowed) +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isEntityNameValid](#misentitynamevalid) - Check if the name is a valid name for ClassLikeEntity +1. [isEnum](#misenum) - Check if an entity is an Enum +1. [isExternalLibraryEntity](#misexternallibraryentity) - Check if a given entity is an entity from a third party library (connected via composer) +1. [isInGit](#misingit) - Checking if class file is in git repository +1. [isInstantiable](#misinstantiable) - Check that an entity is instantiable +1. [isInterface](#misinterface) - Check if an entity is an Interface +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isSubclassOf](#missubclassof) - Whether the given class is a subclass of the specified class +1. [isTrait](#mistrait) - Check if an entity is a Trait +1. [normalizeClassName](#mnormalizeclassname) - Bring the class name to the standard format used in the system +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) +1. [setCustomAst](#msetcustomast) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L51) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection $entitiesCollection, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper $composerHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $className, string|null $relativeFileName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$entitiesCollection | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$composerHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ComposerHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$relativeFileName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $entitiesCollection\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $composerHelper\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $classNamestring-
    $relativeFileNamestring | null-
    - - - -
    -
    -
    - - +--- +# `addPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function addPluginData(string $pluginKey, mixed $data): void; ``` +Add information to aт entity object -
    Add information to aт entity object
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$data | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    $datamixed-
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Return value: void - - -
    -
    -
    - -
      -
    • # - cursorToDocAttributeLinkFragment - :warning: Is internal | source code
    • -
    +--- +# `cursorToDocAttributeLinkFragment` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1286) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function cursorToDocAttributeLinkFragment(string $cursor, bool $isForDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $cursorstring-
    $isForDocumentbool-
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L296) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getAst(): \PhpParser\Node\Stmt\Class_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\Class_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ - +***Return value:*** [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) | [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) | [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) -Throws: - - -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L806) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstant(string $constantName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant whose entity you want to get
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity - - -Throws: - - -
    -
    -
    - - +--- +# `getConstantEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L736) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection; ``` +Get a collection of constant entities -
    Get a collection of constant entities
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +--- -Throws: - - - -See: - -
    -
    -
    - - - +# `getConstantValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L829) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantValue(string $constantName): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant for which you need to get the value
    +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant for which you need to get the value | -Return value: string | array | int | bool | null | float +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) +--- -Throws: - - -
    -
    -
    - - - +# `getConstants` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L765) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstants(): array; ``` +Get all constants that are available according to the configuration as an array -
    Get all constants that are available according to the configuration as an array
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +--- -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getConstantsData - :warning: Is internal | source code
    • -
    - +# `getConstantsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L661) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all constants and classes where they are implemented -
    Get a list of all constants and classes where they are implemented
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for constants from the current class
    $flagsintGet data only for constants corresponding to the visibility modifiers passed in this value
    +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for constants corresponding to the visibility modifiers passed in this value | -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Throws: - - -
    -
    -
    - - - +# `getConstantsValues` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L849) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantsValues(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get class constant compiled values according to filters -
    Get class constant compiled values according to filters
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet values only for constants from the current class
    $flagsintGet values only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array - +***Parameters:*** -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    +--- +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    - -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock +***Return value:*** [\phpDocumentor\Reflection\DocBlock](https://github.com/phpDocumentor/ReflectionDocBlock/blob/master/src/DocBlock.php) +--- -Throws: - - -
    -
    -
    - - - +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    +--- +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L236) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -
    -
    -
    - - - +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    - -Parameters: not specified - -Return value: null | int +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) +--- -Throws: - - -
    -
    -
    - - - +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocRender` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1262) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getDocRender(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRendererInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface - - -Throws: - - -
    -
    -
    - - - +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L469) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getEndLine(): int; ``` +Get the line number of the end of a class code in a file -
    Get the line number of the end of a class code in a file
    - -Parameters: not specified - -Return value: int - - -Throws: - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -
    -
    -
    - - +--- +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Throws: - - -
    -
    -
    - - - +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1035) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    - +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - - -Throws: - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L370) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - +--- +# `getInterfaceNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L530) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getInterfaceNames(): array; ``` +Get a list of class interface names -
    Get a list of class interface names
    - -Parameters: not specified - -Return value: array - - -Throws: - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - - +--- +# `getInterfacesEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L587) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getInterfacesEntities(): array; ``` +Get a list of interface entities that the current class implements -
    Get a list of interface entities that the current class implements
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1203) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethod(string $methodName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to get
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity - - -Throws: - - -
    -
    -
    - - +--- +# `getMethodEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1133) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethodEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; ``` +Get a collection of method entities -
    Get a collection of method entities
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +--- -Throws: - - - -See: - -
    -
    -
    - - - +# `getMethods` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1162) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethods(): array; ``` +Get all methods that are available according to the configuration as an array -
    Get all methods that are available according to the configuration as an array
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +--- -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getMethodsData - :warning: Is internal | source code
    • -
    - +# `getMethodsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1059) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethodsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all methods and classes where they are implemented -
    Get a list of all methods and classes where they are implemented
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for methods from the current class
    $flagsintGet data only for methods corresponding to the visibility modifiers passed in this value
    +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for methods from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for methods corresponding to the visibility modifiers passed in this value | -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Throws: - - -
    -
    -
    - - - +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L120) ```php public function getModifiersString(): string; ``` +Get entity modifiers as a string -
    Get entity modifiers as a string
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L378) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -
    -
    -
    - - +--- +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L397) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getNamespaceName(): string; ``` +Get the entity namespace name -
    Get the entity namespace name
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L142) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -
    -
    -
    - - +--- +# `getParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L106) ```php public function getParentClass(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the entity of the parent class if it exists -
    Get the entity of the parent class if it exists
    - -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) - +--- +# `getParentClassEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClassEntities(): array; ``` +Get a list of parent class entities -
    Get a list of parent class entities
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified - -Return value: array - - -
    -
    -
    - - +--- +# `getParentClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L93) ```php public function getParentClassName(): null|string; ``` +Get the name of the parent class entity if it exists -
    Get the name of the parent class entity if it exists
    - -Parameters: not specified - -Return value: null | string - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L72) ```php public function getParentClassNames(): array; ``` +Get a list of entity names of parent classes -
    Get a list of entity names of parent classes
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified - -Return value: array - - -
    -
    -
    - - +--- +# `getPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L270) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPluginData(string $pluginKey): mixed; ``` +Get additional information added using the plugin -
    Get additional information added using the plugin
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    - -Return value: mixed +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) - +--- +# `getProperties` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L963) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getProperties(): array; ``` +Get all properties that are available according to the configuration as an array -
    Get all properties that are available according to the configuration as an array
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) -Return value: array - - -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getPropertiesData - :warning: Is internal | source code
    • -
    +--- +# `getPropertiesData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L872) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertiesData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all properties and classes where they are implemented -
    Get a list of all properties and classes where they are implemented
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for properties from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for properties corresponding to the visibility modifiers passed in this value | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for properties from the current class
    $flagsintGet data only for properties corresponding to the visibility modifiers passed in this value
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1004) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getProperty(string $propertyName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; ``` +Get the property entity by its name -
    Get the property entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to get
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | -Throws: - - -
    -
    -
    - - +--- +# `getPropertyDefaultValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1027) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertyDefaultValue(string $propertyName): string|array|int|bool|null|float; ``` +Get the compiled value of a property -
    Get the compiled value of a property
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property for which you need to get the value
    - -Return value: string | array | int | bool | null | float - +***Parameters:*** -Throws: - - -
    -
    -
    - - +--- +# `getPropertyEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L934) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertyEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection; ``` +Get a collection of property entities -
    Get a collection of property entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection - - -Throws: - - - -See: - -
    -
    -
    - - +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L412) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified - -Return value: null | string - - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -See: - -
    -
    -
    +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) - +--- +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L160) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -
    -
    -
    - - +--- +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L386) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L457) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getStartLine(): int; ``` +Get the line number of the start of a class code in a file -
    Get the line number of the start of a class code in a file
    +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -Parameters: not specified - -Return value: int - - -Throws: - - -
    -
    -
    - - +--- +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Throws: - - -
    -
    -
    - - - +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getTraits(): array; ``` +Get a list of trait entities of the current class -
    Get a list of trait entities of the current class
    - -Parameters: not specified - -Return value: array - - -Throws: - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - - +--- +# `getTraitsNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L604) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getTraitsNames(): array; ``` +Get a list of class traits names -
    Get a list of class traits names
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `hasConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L785) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasConstant(string $constantName, bool $unsafe = false): bool; ``` +Check if a constant exists in a class -
    Check if a constant exists in a class
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the class whose entity you want to check
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the class whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1182) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasMethod(string $methodName, bool $unsafe = false): bool; ``` +Check if a method exists in a class -
    Check if a method exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to check
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1250) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasParentClass(string $parentClassName): bool; ``` +Check if a certain parent class exists in a chain of parent classes -
    Check if a certain parent class exists in a chain of parent classes
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamestringSearched parent class
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$parentClassName | [string](https://www.php.net/manual/en/language.types.string.php) | Searched parent class | -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L983) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasProperty(string $propertyName, bool $unsafe = false): bool; ``` +Check if a property exists in a class -
    Check if a property exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to check
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: bool - +***Parameters:*** -Throws: - - -
    -
    -
    - - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L644) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasTraits(): bool; ``` +Check if the class contains traits -
    Check if the class contains traits
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `implementsInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1237) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function implementsInterface(string $interfaceName): bool; ``` +Check if a class implements an interface -
    Check if a class implements an interface
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$interfaceName | [string](https://www.php.net/manual/en/language.types.string.php) | Name of the required interface in the interface chain | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfaceNamestringName of the required interface in the interface chain
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isAbstract` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L43) ```php public function isAbstract(): bool; ``` +Check that an entity is abstract -
    Check that an entity is abstract
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isAttribute` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L55) ```php public function isAttribute(): bool; ``` +Check if a class is an attribute -
    Check if a class is an attribute
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L20) ```php public function isClass(): bool; ``` +Check if an entity is a Class -
    Check if an entity is a Class
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isClassLoad` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L343) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isClassLoad(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - isDocumentCreationAllowed - :warning: Is internal | source code
    • -
    - +# `isDocumentCreationAllowed` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L224) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isDocumentCreationAllowed(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L358) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isEntityDataCanBeLoaded(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L84) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public static function isEntityNameValid(string $entityName): bool; ``` +Check if the name is a valid name for ClassLikeEntity -
    Check if the name is a valid name for ClassLikeEntity
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isEnum` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L134) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isEnum(): bool; ``` +Check if an entity is an Enum -
    Check if an entity is an Enum
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - -
      -
    • # - isExternalLibraryEntity - :warning: Is internal | source code
    • -
    +--- +# `isExternalLibraryEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L152) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isExternalLibraryEntity(): bool; ``` +Check if a given entity is an entity from a third party library (connected via composer) -
    Check if a given entity is an entity from a third party library (connected via composer)
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInGit` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L205) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInGit(): bool; ``` +Checking if class file is in git repository -
    Checking if class file is in git repository
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L30) ```php public function isInstantiable(): bool; ``` +Check that an entity is instantiable -
    Check that an entity is instantiable
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L114) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInterface(): bool; ``` +Check if an entity is an Interface -
    Check if an entity is an Interface
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isSubclassOf` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1219) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isSubclassOf(string $className): bool; ``` +Whether the given class is a subclass of the specified class -
    Whether the given class is a subclass of the specified class
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classNamestring-
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Throws: - - -
    -
    -
    - - +--- +# `isTrait` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L124) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isTrait(): bool; ``` +Check if an entity is a Trait -
    Check if an entity is a Trait
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L94) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public static function normalizeClassName(string $name): string; ``` +Bring the class name to the standard format used in the system -
    Bring the class name to the standard format used in the system
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    +***Parameters:*** -Return value: string +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - - - +# `setCustomAst` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L284) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function setCustomAst(\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Class_|null $customAst): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$customAst | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) \| [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) \| [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) \| [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $customAst\PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Class_ | null-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/ClassLikeEntity.md b/docs/tech/02_parser/classes/ClassLikeEntity.md index 569f46b7..e1dd320a 100644 --- a/docs/tech/02_parser/classes/ClassLikeEntity.md +++ b/docs/tech/02_parser/classes/ClassLikeEntity.md @@ -1,12 +1,12 @@ - BumbleDocGen / Technical description of the project / Parser / ClassLikeEntity
    - -

    - ClassLikeEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +ClassLikeEntity +--- +# [ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L44) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; @@ -14,3301 +14,1223 @@ namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; abstract class ClassLikeEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity implements \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface, \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface ``` - - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - addPluginData - - Add information to aт entity object
    2. -
    3. - cursorToDocAttributeLinkFragment -
    4. -
    5. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    6. -
    7. - getAst - - Get AST for this entity
    8. -
    9. - getCacheKey -
    10. -
    11. - getCachedEntityDependencies -
    12. -
    13. - getConstant - - Get the method entity by its name
    14. -
    15. - getConstantEntitiesCollection - - Get a collection of constant entities
    16. -
    17. - getConstantValue - - Get the compiled value of a constant
    18. -
    19. - getConstants - - Get all constants that are available according to the configuration as an array
    20. -
    21. - getConstantsData - - Get a list of all constants and classes where they are implemented
    22. -
    23. - getConstantsValues - - Get class constant compiled values according to filters
    24. -
    25. - getCurrentRootEntity -
    26. -
    27. - getDescription - - Get entity description
    28. -
    29. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    30. -
    31. - getDocBlock - - Get DocBlock for current entity
    32. -
    33. - getDocComment - - Get the doc comment of an entity
    34. -
    35. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    36. -
    37. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    38. -
    39. - getDocNote - - Get the note annotation value
    40. -
    41. - getDocRender -
    42. -
    43. - getEndLine - - Get the line number of the end of a class code in a file
    44. -
    45. - getEntityDependencies -
    46. -
    47. - getExamples - - Get parsed examples from `examples` doc block
    48. -
    49. - getFileContent -
    50. -
    51. - getFileSourceLink -
    52. -
    53. - getFirstExample - - Get first example from `examples` doc block
    54. -
    55. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    56. -
    57. - getInterfaceNames - - Get a list of class interface names
    58. -
    59. - getInterfacesEntities - - Get a list of interface entities that the current class implements
    60. -
    61. - getMethod - - Get the method entity by its name
    62. -
    63. - getMethodEntitiesCollection - - Get a collection of method entities
    64. -
    65. - getMethods - - Get all methods that are available according to the configuration as an array
    66. -
    67. - getMethodsData - - Get a list of all methods and classes where they are implemented
    68. -
    69. - getModifiersString - - Get entity modifiers as a string
    70. -
    71. - getName - - Full name of the entity
    72. -
    73. - getNamespaceName - - Get the entity namespace name
    74. -
    75. - getObjectId - - Get entity unique ID
    76. -
    77. - getParentClass - - Get the entity of the parent class if it exists
    78. -
    79. - getParentClassEntities - - Get a list of parent class entities
    80. -
    81. - getParentClassName - - Get the name of the parent class entity if it exists
    82. -
    83. - getParentClassNames - - Get a list of entity names of parent classes
    84. -
    85. - getPluginData - - Get additional information added using the plugin
    86. -
    87. - getProperties - - Get all properties that are available according to the configuration as an array
    88. -
    89. - getPropertiesData - - Get a list of all properties and classes where they are implemented
    90. -
    91. - getProperty - - Get the property entity by its name
    92. -
    93. - getPropertyDefaultValue - - Get the compiled value of a property
    94. -
    95. - getPropertyEntitiesCollection - - Get a collection of property entities
    96. -
    97. - getRelativeFileName - - File name relative to project_root configuration parameter
    98. -
    99. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    100. -
    101. - getShortName - - Short name of the entity
    102. -
    103. - getStartLine - - Get the line number of the start of a class code in a file
    104. -
    105. - getThrows - - Get parsed throws from `throws` doc block
    106. -
    107. - getThrowsDocBlockLinks -
    108. -
    109. - getTraits - - Get a list of trait entities of the current class
    110. -
    111. - getTraitsNames - - Get a list of class traits names
    112. -
    113. - hasConstant - - Check if a constant exists in a class
    114. -
    115. - hasDescriptionLinks - - Checking if an entity has links in its description
    116. -
    117. - hasExamples - - Checking if an entity has `example` docBlock
    118. -
    119. - hasMethod - - Check if a method exists in a class
    120. -
    121. - hasParentClass - - Check if a certain parent class exists in a chain of parent classes
    122. -
    123. - hasProperty - - Check if a property exists in a class
    124. -
    125. - hasThrows - - Checking if an entity has `throws` docBlock
    126. -
    127. - hasTraits - - Check if the class contains traits
    128. -
    129. - implementsInterface - - Check if a class implements an interface
    130. -
    131. - isAbstract - - Check that an entity is abstract
    132. -
    133. - isApi - - Checking if an entity has `api` docBlock
    134. -
    135. - isClass - - Check if an entity is a Class
    136. -
    137. - isClassLoad -
    138. -
    139. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    140. -
    141. - isDocumentCreationAllowed -
    142. -
    143. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    144. -
    145. - isEntityDataCacheOutdated -
    146. -
    147. - isEntityDataCanBeLoaded -
    148. -
    149. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    150. -
    151. - isEntityNameValid - - Check if the name is a valid name for ClassLikeEntity
    152. -
    153. - isEnum - - Check if an entity is an Enum
    154. -
    155. - isExternalLibraryEntity - - Check if a given entity is an entity from a third party library (connected via composer)
    156. -
    157. - isInGit - - Checking if class file is in git repository
    158. -
    159. - isInstantiable - - Check that an entity is instantiable
    160. -
    161. - isInterface - - Check if an entity is an Interface
    162. -
    163. - isInternal - - Checking if an entity has `internal` docBlock
    164. -
    165. - isSubclassOf - - Whether the given class is a subclass of the specified class
    166. -
    167. - isTrait - - Check if an entity is a Trait
    168. -
    169. - normalizeClassName - - Bring the class name to the standard format used in the system
    170. -
    171. - reloadEntityDependenciesCache - - Update entity dependency cache
    172. -
    173. - removeEntityValueFromCache -
    174. -
    175. - removeNotUsedEntityDataCache -
    176. -
    177. - setCustomAst -
    178. -
    - - - - - - - -

    Method details:

    - -
    - - - +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [addPluginData](#maddplugindata) - Add information to aт entity object +1. [cursorToDocAttributeLinkFragment](#mcursortodocattributelinkfragment) +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getConstant](#mgetconstant) - Get the method entity by its name +1. [getConstantEntitiesCollection](#mgetconstantentitiescollection) - Get a collection of constant entities +1. [getConstantValue](#mgetconstantvalue) - Get the compiled value of a constant +1. [getConstants](#mgetconstants) - Get all constants that are available according to the configuration as an array +1. [getConstantsData](#mgetconstantsdata) - Get a list of all constants and classes where they are implemented +1. [getConstantsValues](#mgetconstantsvalues) - Get class constant compiled values according to filters +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getDocRender](#mgetdocrender) +1. [getEndLine](#mgetendline) - Get the line number of the end of a class code in a file +1. [getEntityDependencies](#mgetentitydependencies) +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getInterfaceNames](#mgetinterfacenames) - Get a list of class interface names +1. [getInterfacesEntities](#mgetinterfacesentities) - Get a list of interface entities that the current class implements +1. [getMethod](#mgetmethod) - Get the method entity by its name +1. [getMethodEntitiesCollection](#mgetmethodentitiescollection) - Get a collection of method entities +1. [getMethods](#mgetmethods) - Get all methods that are available according to the configuration as an array +1. [getMethodsData](#mgetmethodsdata) - Get a list of all methods and classes where they are implemented +1. [getModifiersString](#mgetmodifiersstring) - Get entity modifiers as a string +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Get the entity namespace name +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getParentClass](#mgetparentclass) - Get the entity of the parent class if it exists +1. [getParentClassEntities](#mgetparentclassentities) - Get a list of parent class entities +1. [getParentClassName](#mgetparentclassname) - Get the name of the parent class entity if it exists +1. [getParentClassNames](#mgetparentclassnames) - Get a list of entity names of parent classes +1. [getPluginData](#mgetplugindata) - Get additional information added using the plugin +1. [getProperties](#mgetproperties) - Get all properties that are available according to the configuration as an array +1. [getPropertiesData](#mgetpropertiesdata) - Get a list of all properties and classes where they are implemented +1. [getProperty](#mgetproperty) - Get the property entity by its name +1. [getPropertyDefaultValue](#mgetpropertydefaultvalue) - Get the compiled value of a property +1. [getPropertyEntitiesCollection](#mgetpropertyentitiescollection) - Get a collection of property entities +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getTraits](#mgettraits) - Get a list of trait entities of the current class +1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names +1. [hasConstant](#mhasconstant) - Check if a constant exists in a class +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasMethod](#mhasmethod) - Check if a method exists in a class +1. [hasParentClass](#mhasparentclass) - Check if a certain parent class exists in a chain of parent classes +1. [hasProperty](#mhasproperty) - Check if a property exists in a class +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [hasTraits](#mhastraits) - Check if the class contains traits +1. [implementsInterface](#mimplementsinterface) - Check if a class implements an interface +1. [isAbstract](#misabstract) - Check that an entity is abstract +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isClass](#misclass) - Check if an entity is a Class +1. [isClassLoad](#misclassload) +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isDocumentCreationAllowed](#misdocumentcreationallowed) +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isEntityNameValid](#misentitynamevalid) - Check if the name is a valid name for ClassLikeEntity +1. [isEnum](#misenum) - Check if an entity is an Enum +1. [isExternalLibraryEntity](#misexternallibraryentity) - Check if a given entity is an entity from a third party library (connected via composer) +1. [isInGit](#misingit) - Checking if class file is in git repository +1. [isInstantiable](#misinstantiable) - Check that an entity is instantiable +1. [isInterface](#misinterface) - Check if an entity is an Interface +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isSubclassOf](#missubclassof) - Whether the given class is a subclass of the specified class +1. [isTrait](#mistrait) - Check if an entity is a Trait +1. [normalizeClassName](#mnormalizeclassname) - Bring the class name to the standard format used in the system +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) +1. [setCustomAst](#msetcustomast) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L51) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection $entitiesCollection, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper $composerHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $className, string|null $relativeFileName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$entitiesCollection | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$composerHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ComposerHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$relativeFileName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $entitiesCollection\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $composerHelper\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $classNamestring-
    $relativeFileNamestring | null-
    - - - -
    -
    -
    - - +--- +# `addPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L258) ```php public function addPluginData(string $pluginKey, mixed $data): void; ``` +Add information to aт entity object -
    Add information to aт entity object
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    $datamixed-
    +***Parameters:*** -Return value: void +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$data | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - cursorToDocAttributeLinkFragment - :warning: Is internal | source code
    • -
    +--- +# `cursorToDocAttributeLinkFragment` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1286) ```php public function cursorToDocAttributeLinkFragment(string $cursor, bool $isForDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $cursorstring-
    $isForDocumentbool-
    - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L296) ```php public function getAst(): \PhpParser\Node\Stmt\Class_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\Class_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ - - -Throws: - +***Return value:*** [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) | [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) | [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L806) ```php public function getConstant(string $constantName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant whose entity you want to get
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    +***Parameters:*** -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -Throws: - - -
    -
    -
    - - +--- +# `getConstantEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L736) ```php public function getConstantEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection; ``` +Get a collection of constant entities -
    Get a collection of constant entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) -Throws: - - - -See: - -
    -
    -
    - - +--- +# `getConstantValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L829) ```php public function getConstantValue(string $constantName): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant for which you need to get the value
    - -Return value: string | array | int | bool | null | float +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant for which you need to get the value | -Throws: - - -
    -
    -
    - - +--- +# `getConstants` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L765) ```php public function getConstants(): array; ``` +Get all constants that are available according to the configuration as an array -
    Get all constants that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getConstantsData - :warning: Is internal | source code
    • -
    +--- +# `getConstantsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L661) ```php public function getConstantsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all constants and classes where they are implemented -
    Get a list of all constants and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for constants from the current class
    $flagsintGet data only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for constants corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getConstantsValues` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L849) ```php public function getConstantsValues(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get class constant compiled values according to filters -
    Get class constant compiled values according to filters
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet values only for constants from the current class
    $flagsintGet values only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    +--- +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    - -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    +--- +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L236) ```php public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    - -Parameters: not specified - -Return value: null | int - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getDocRender` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1262) ```php public function getDocRender(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRendererInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface - - -Throws: - - -
    -
    -
    - - - +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L469) ```php public function getEndLine(): int; ``` +Get the line number of the end of a class code in a file -
    Get the line number of the end of a class code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L171) ```php public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1035) ```php public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    - +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L370) ```php public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -
    -
    -
    - - +--- +# `getInterfaceNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L530) ```php public function getInterfaceNames(): array; ``` +Get a list of class interface names -
    Get a list of class interface names
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getInterfacesEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L587) ```php public function getInterfacesEntities(): array; ``` +Get a list of interface entities that the current class implements -
    Get a list of interface entities that the current class implements
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1203) ```php public function getMethod(string $methodName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to get
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +***Parameters:*** -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) -Throws: - - -
    -
    -
    - - +--- +# `getMethodEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1133) ```php public function getMethodEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; ``` +Get a collection of method entities -
    Get a collection of method entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) -Throws: - - - -See: - -
    -
    -
    - - +--- +# `getMethods` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1162) ```php public function getMethods(): array; ``` +Get all methods that are available according to the configuration as an array -
    Get all methods that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getMethodsData - :warning: Is internal | source code
    • -
    +--- +# `getMethodsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1059) ```php public function getMethodsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all methods and classes where they are implemented -
    Get a list of all methods and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for methods from the current class
    $flagsintGet data only for methods corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for methods from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for methods corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L79) ```php public function getModifiersString(): string; ``` +Get entity modifiers as a string -
    Get entity modifiers as a string
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L378) ```php public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L397) ```php public function getNamespaceName(): string; ``` +Get the entity namespace name -
    Get the entity namespace name
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L142) ```php public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L516) ```php public function getParentClass(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the entity of the parent class if it exists -
    Get the entity of the parent class if it exists
    - -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -
    -
    -
    - - - +# `getParentClassEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L493) ```php public function getParentClassEntities(): array; ``` +Get a list of parent class entities -
    Get a list of parent class entities
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -
    -
    -
    - - - +# `getParentClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L506) ```php public function getParentClassName(): null|string; ``` +Get the name of the parent class entity if it exists -
    Get the name of the parent class entity if it exists
    - -Parameters: not specified - -Return value: null | string +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L481) ```php public function getParentClassNames(): array; ``` +Get a list of entity names of parent classes -
    Get a list of entity names of parent classes
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -
    -
    -
    - - +--- +# `getPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L270) ```php public function getPluginData(string $pluginKey): mixed; ``` +Get additional information added using the plugin -
    Get additional information added using the plugin
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Return value: mixed +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) +--- -
    -
    -
    - - - +# `getProperties` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L963) ```php public function getProperties(): array; ``` +Get all properties that are available according to the configuration as an array -
    Get all properties that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getPropertiesData - :warning: Is internal | source code
    • -
    +--- +# `getPropertiesData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L872) ```php public function getPropertiesData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all properties and classes where they are implemented -
    Get a list of all properties and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for properties from the current class
    $flagsintGet data only for properties corresponding to the visibility modifiers passed in this value
    +***Parameters:*** -Return value: array +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for properties from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for properties corresponding to the visibility modifiers passed in this value | +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1004) ```php public function getProperty(string $propertyName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; ``` +Get the property entity by its name -
    Get the property entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to get
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity - - -Throws: -
      -
    • - \DI\DependencyException
    • +***Parameters:*** -
    • - \BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException
    • +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | -
    • - \DI\NotFoundException
    • +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php) -
    - -
    -
    -
    - - +--- +# `getPropertyDefaultValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1027) ```php public function getPropertyDefaultValue(string $propertyName): string|array|int|bool|null|float; ``` +Get the compiled value of a property -
    Get the compiled value of a property
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property for which you need to get the value
    - -Return value: string | array | int | bool | null | float - - -Throws: - - -
    -
    -
    - - +--- +# `getPropertyEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L934) ```php public function getPropertyEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection; ``` +Get a collection of property entities -
    Get a collection of property entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection - - -Throws: - +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +--- -See: - -
    -
    -
    - - - +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L412) ```php public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified - -Return value: null | string +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) +--- -See: - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L160) ```php public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) +--- -
    -
    -
    - - - +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L386) ```php public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L457) ```php public function getStartLine(): int; ``` +Get the line number of the start of a class code in a file -
    Get the line number of the start of a class code in a file
    - -Parameters: not specified - -Return value: int +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) +--- -Throws: - - -
    -
    -
    - - - +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php public function getTraits(): array; ``` +Get a list of trait entities of the current class -
    Get a list of trait entities of the current class
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getTraitsNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L604) ```php public function getTraitsNames(): array; ``` +Get a list of class traits names -
    Get a list of class traits names
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `hasConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L785) ```php public function hasConstant(string $constantName, bool $unsafe = false): bool; ``` +Check if a constant exists in a class -
    Check if a constant exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the class whose entity you want to check
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the class whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | -Throws: - - -
    -
    -
    - - +--- +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool - - -Throws: -
      -
    • - \Exception
    • +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    - -
    -
    -
    - - +--- +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1182) ```php public function hasMethod(string $methodName, bool $unsafe = false): bool; ``` +Check if a method exists in a class -
    Check if a method exists in a class
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to check
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1250) ```php public function hasParentClass(string $parentClassName): bool; ``` +Check if a certain parent class exists in a chain of parent classes -
    Check if a certain parent class exists in a chain of parent classes
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamestringSearched parent class
    +| Name | Type | Description | +|:-|:-|:-| +$parentClassName | [string](https://www.php.net/manual/en/language.types.string.php) | Searched parent class | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `hasProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L983) ```php public function hasProperty(string $propertyName, bool $unsafe = false): bool; ``` +Check if a property exists in a class -
    Check if a property exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to check
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L644) ```php public function hasTraits(): bool; ``` +Check if the class contains traits -
    Check if the class contains traits
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `implementsInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1237) ```php public function implementsInterface(string $interfaceName): bool; ``` +Check if a class implements an interface -
    Check if a class implements an interface
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfaceNamestringName of the required interface in the interface chain
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$interfaceName | [string](https://www.php.net/manual/en/language.types.string.php) | Name of the required interface in the interface chain | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isAbstract` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L445) ```php public function isAbstract(): bool; ``` +Check that an entity is abstract -
    Check that an entity is abstract
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L104) ```php public function isClass(): bool; ``` +Check if an entity is a Class -
    Check if an entity is a Class
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isClassLoad` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L343) ```php public function isClassLoad(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - isDocumentCreationAllowed - :warning: Is internal | source code
    • -
    - +# `isDocumentCreationAllowed` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L224) ```php public function isDocumentCreationAllowed(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L358) ```php public function isEntityDataCanBeLoaded(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L84) ```php public static function isEntityNameValid(string $entityName): bool; ``` +Check if the name is a valid name for ClassLikeEntity -
    Check if the name is a valid name for ClassLikeEntity
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isEnum` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L134) ```php public function isEnum(): bool; ``` +Check if an entity is an Enum -
    Check if an entity is an Enum
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - -
      -
    • # - isExternalLibraryEntity - :warning: Is internal | source code
    • -
    +--- +# `isExternalLibraryEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L152) ```php public function isExternalLibraryEntity(): bool; ``` +Check if a given entity is an entity from a third party library (connected via composer) -
    Check if a given entity is an entity from a third party library (connected via composer)
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInGit` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L205) ```php public function isInGit(): bool; ``` +Checking if class file is in git repository -
    Checking if class file is in git repository
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L435) ```php public function isInstantiable(): bool; ``` +Check that an entity is instantiable -
    Check that an entity is instantiable
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L114) ```php public function isInterface(): bool; ``` +Check if an entity is an Interface -
    Check if an entity is an Interface
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isSubclassOf` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1219) ```php public function isSubclassOf(string $className): bool; ``` +Whether the given class is a subclass of the specified class -
    Whether the given class is a subclass of the specified class
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classNamestring-
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Throws: - - -
    -
    -
    - - +--- +# `isTrait` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L124) ```php public function isTrait(): bool; ``` +Check if an entity is a Trait -
    Check if an entity is a Trait
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L94) ```php public static function normalizeClassName(string $name): string; ``` +Bring the class name to the standard format used in the system -
    Bring the class name to the standard format used in the system
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    +***Parameters:*** -Return value: string +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - - - +# `setCustomAst` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L284) ```php public function setCustomAst(\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Class_|null $customAst): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$customAst | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) \| [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) \| [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) \| [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $customAst\PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Class_ | null-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/ConditionGroup.md b/docs/tech/02_parser/classes/ConditionGroup.md index b21aab22..963588df 100644 --- a/docs/tech/02_parser/classes/ConditionGroup.md +++ b/docs/tech/02_parser/classes/ConditionGroup.md @@ -1,128 +1,56 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / ConditionGroup
    - -

    - ConditionGroup class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +ConditionGroup +--- +# [ConditionGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionGroup.php#L13) class: ```php namespace BumbleDocGen\Core\Parser\FilterCondition; final class ConditionGroup implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Filter condition to group other filter conditions. A group can have an OR/AND condition test; +In the case of OR, it is enough to successfully check at least one condition, in the case of AND, all checks must be successfully completed. -
    Filter condition to group other filter conditions. A group can have an OR/AND condition test; -In the case of OR, it is enough to successfully check at least one condition, in the case of AND, all checks must be successfully completed.
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionGroup.php#L20) ```php public function __construct(string $groupType, \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ...$conditions); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$groupType | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$conditions (variadic) | [\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $groupTypestring-
    $conditions (variadic)\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface-
    - - - -
    -
    -
    - - +--- +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionGroup.php#L25) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/ConditionInterface.md b/docs/tech/02_parser/classes/ConditionInterface.md index 7990b2ad..ba535df4 100644 --- a/docs/tech/02_parser/classes/ConditionInterface.md +++ b/docs/tech/02_parser/classes/ConditionInterface.md @@ -1,12 +1,13 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / ConditionInterface
    - -

    - ConditionInterface class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +ConditionInterface +--- +# [ConditionInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionInterface.php#L9) class: ```php namespace BumbleDocGen\Core\Parser\FilterCondition; @@ -14,65 +15,23 @@ namespace BumbleDocGen\Core\Parser\FilterCondition; interface ConditionInterface ``` +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - - - - - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionInterface.php#L11) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/Configuration.md b/docs/tech/02_parser/classes/Configuration.md index ec4f2530..04578f83 100644 --- a/docs/tech/02_parser/classes/Configuration.md +++ b/docs/tech/02_parser/classes/Configuration.md @@ -1,763 +1,245 @@ - BumbleDocGen / Technical description of the project / Parser / Configuration
    - -

    - Configuration class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +Configuration +--- +# [Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L30) class: ```php namespace BumbleDocGen\Core\Configuration; final class Configuration ``` - -
    Configuration project documentation
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getAdditionalConsoleCommands -
    2. -
    3. - getCacheDir -
    4. -
    5. - getConfigurationVersion -
    6. -
    7. - getDocGenLibDir -
    8. -
    9. - getGitClientPath -
    10. -
    11. - getIfExists -
    12. -
    13. - getLanguageHandlersCollection -
    14. -
    15. - getOutputDir -
    16. -
    17. - getOutputDirBaseUrl -
    18. -
    19. - getPageLinkProcessor -
    20. -
    21. - getPlugins -
    22. -
    23. - getProjectRoot -
    24. -
    25. - getSourceLocators -
    26. -
    27. - getTemplatesDir -
    28. -
    29. - getTwigFilters -
    30. -
    31. - getTwigFunctions -
    32. -
    33. - getWorkingDir -
    34. -
    35. - isCheckFileInGitBeforeCreatingDocEnabled -
    36. -
    37. - renderWithFrontMatter -
    38. -
    39. - useSharedCache -
    40. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Configuration project documentation + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [getAdditionalConsoleCommands](#mgetadditionalconsolecommands) +1. [getCacheDir](#mgetcachedir) +1. [getConfigurationVersion](#mgetconfigurationversion) +1. [getDocGenLibDir](#mgetdocgenlibdir) +1. [getGitClientPath](#mgetgitclientpath) +1. [getIfExists](#mgetifexists) +1. [getLanguageHandlersCollection](#mgetlanguagehandlerscollection) +1. [getOutputDir](#mgetoutputdir) +1. [getOutputDirBaseUrl](#mgetoutputdirbaseurl) +1. [getPageLinkProcessor](#mgetpagelinkprocessor) +1. [getPlugins](#mgetplugins) +1. [getProjectRoot](#mgetprojectroot) +1. [getSourceLocators](#mgetsourcelocators) +1. [getTemplatesDir](#mgettemplatesdir) +1. [getTwigFilters](#mgettwigfilters) +1. [getTwigFunctions](#mgettwigfunctions) +1. [getWorkingDir](#mgetworkingdir) +1. [isCheckFileInGitBeforeCreatingDocEnabled](#mischeckfileingitbeforecreatingdocenabled) +1. [renderWithFrontMatter](#mrenderwithfrontmatter) +1. [useSharedCache](#musesharedcache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L34) ```php public function __construct(\BumbleDocGen\Core\Configuration\ConfigurationParameterBag $parameterBag, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$parameterBag | [\BumbleDocGen\Core\Configuration\ConfigurationParameterBag](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/ConfigurationParameterBag.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parameterBag\BumbleDocGen\Core\Configuration\ConfigurationParameterBag-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `getAdditionalConsoleCommands` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L377) ```php public function getAdditionalConsoleCommands(): \BumbleDocGen\Console\Command\AdditionalCommandCollection; ``` +***Return value:*** [\BumbleDocGen\Console\Command\AdditionalCommandCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/Command/AdditionalCommandCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Console\Command\AdditionalCommandCollection - - -Throws: - - -
    -
    -
    - - - +# `getCacheDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L205) ```php public function getCacheDir(): null|string; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    - - - +# `getConfigurationVersion` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L42) ```php public function getConfigurationVersion(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getDocGenLibDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L367) ```php public function getDocGenLibDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getGitClientPath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L256) ```php public function getGitClientPath(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getIfExists` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L395) ```php public function getIfExists(mixed $key): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keymixed-
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getLanguageHandlersCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L166) ```php public function getLanguageHandlersCollection(): \BumbleDocGen\LanguageHandler\LanguageHandlersCollection; ``` +***Return value:*** [\BumbleDocGen\LanguageHandler\LanguageHandlersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/LanguageHandlersCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\LanguageHandlersCollection - - -Throws: - - -
    -
    -
    - - - +# `getOutputDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L112) ```php public function getOutputDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getOutputDirBaseUrl` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L150) ```php public function getOutputDirBaseUrl(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getPageLinkProcessor` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L238) ```php public function getPageLinkProcessor(): \BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/PageLinkProcessor/PageLinkProcessorInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface - - -Throws: - - -
    -
    -
    - - - +# `getPlugins` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L187) ```php public function getPlugins(): \BumbleDocGen\Core\Plugin\PluginsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Plugin\PluginsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Plugin\PluginsCollection - - -Throws: - - -
    -
    -
    - - - +# `getProjectRoot` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L50) ```php public function getProjectRoot(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getSourceLocators` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L66) ```php public function getSourceLocators(): \BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/SourceLocatorsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection - - -Throws: - - -
    -
    -
    - - - +# `getTemplatesDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L84) ```php public function getTemplatesDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getTwigFilters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L295) ```php public function getTwigFilters(): \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/CustomFiltersCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection - - -Throws: - - -
    -
    -
    - - - +# `getTwigFunctions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L272) ```php public function getTwigFunctions(): \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/CustomFunctionsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection - - -Throws: - - -
    -
    -
    - - - +# `getWorkingDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L358) ```php public function getWorkingDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - isCheckFileInGitBeforeCreatingDocEnabled - | source code
    • -
    - +# `isCheckFileInGitBeforeCreatingDocEnabled` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L344) ```php public function isCheckFileInGitBeforeCreatingDocEnabled(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `renderWithFrontMatter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L330) ```php public function renderWithFrontMatter(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `useSharedCache` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L316) ```php public function useSharedCache(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/02_parser/classes/DirectoriesSourceLocator.md b/docs/tech/02_parser/classes/DirectoriesSourceLocator.md index d72ad4e5..5dc8786e 100644 --- a/docs/tech/02_parser/classes/DirectoriesSourceLocator.md +++ b/docs/tech/02_parser/classes/DirectoriesSourceLocator.md @@ -1,107 +1,50 @@ - BumbleDocGen / Technical description of the project / Parser / Source locators / DirectoriesSourceLocator
    - -

    - DirectoriesSourceLocator class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Source locators](/docs/tech/02_parser/sourceLocator.md) **/** +DirectoriesSourceLocator +--- +# [DirectoriesSourceLocator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/DirectoriesSourceLocator.php#L10) class: ```php namespace BumbleDocGen\Core\Parser\SourceLocator; final class DirectoriesSourceLocator extends \BumbleDocGen\Core\Parser\SourceLocator\BaseSourceLocator implements \BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorInterface ``` +Loads all files from the specified directory -
    Loads all files from the specified directory
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getFinder -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [getFinder](#mgetfinder) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/DirectoriesSourceLocator.php#L12) ```php public function __construct(array $directories); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$directories | [array](https://www.php.net/manual/en/language.types.array.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $directoriesarray-
    - - - -
    -
    -
    - - +--- +# `getFinder` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/BaseSourceLocator.php#L19) ```php // Implemented in BumbleDocGen\Core\Parser\SourceLocator\BaseSourceLocator public function getFinder(): \Symfony\Component\Finder\Finder; ``` +***Return value:*** [\Symfony\Component\Finder\Finder](https://github.com/symfony/finder/blob/master/Finder.php) - -Parameters: not specified - -Return value: \Symfony\Component\Finder\Finder - - -
    -
    +--- diff --git a/docs/tech/02_parser/classes/DynamicMethodEntity.md b/docs/tech/02_parser/classes/DynamicMethodEntity.md index 2cba8ff7..94405f4d 100644 --- a/docs/tech/02_parser/classes/DynamicMethodEntity.md +++ b/docs/tech/02_parser/classes/DynamicMethodEntity.md @@ -1,839 +1,373 @@ - BumbleDocGen / Technical description of the project / Parser / Entities and entities collections / DynamicMethodEntity
    - -

    - DynamicMethodEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +DynamicMethodEntity +--- +# [DynamicMethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L18) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method; class DynamicMethodEntity implements \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface ``` - -
    Method obtained by parsing the "method" annotation
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    2. -
    3. - getBodyCode - - Get the code for this method
    4. -
    5. - getCallMethod - - Get the entity of the magic method that will be called instead of the current virtual one
    6. -
    7. - getDescription - - Get a description of this method
    8. -
    9. - getEndLine - - Get the line number of the end of a method's code in a file
    10. -
    11. - getFirstReturnValue - - Get the compiled first return value of a method (if possible)
    12. -
    13. - getImplementingClass - - Get the ClassLike entity in which this method was implemented
    14. -
    15. - getImplementingClassName - - Get the name of the class in which this method is implemented
    16. -
    17. - getModifiersString - - Get a text representation of method modifiers
    18. -
    19. - getName - - Full name of the entity
    20. -
    21. - getNamespaceName - - Namespace of the class that contains this method
    22. -
    23. - getObjectId - - Entity object ID
    24. -
    25. - getParameters - - Get a list of method parameters
    26. -
    27. - getParametersString - - Get a list of method parameters as a string
    28. -
    29. - getRelativeFileName - - File name relative to project_root configuration parameter
    30. -
    31. - getReturnType - - Get the return type of method
    32. -
    33. - getRootEntity - - Get the class like entity where this method was obtained
    34. -
    35. - getRootEntityCollection - - Get parent collection of entities
    36. -
    37. - getShortName - - Short name of the entity
    38. -
    39. - getSignature - - Get the method signature as a string
    40. -
    41. - getStartColumn - - Get the column number of the beginning of the method code in a file
    42. -
    43. - getStartLine - - Get the line number of the beginning of the method code in a file
    44. -
    45. - isDynamic - - Check if a method is a dynamic method, that is, implementable using __call or __callStatic
    46. -
    47. - isEntityCacheOutdated -
    48. -
    49. - isImplementedInParentClass - - Check if this method is implemented in the parent class
    50. -
    51. - isInitialization - - Check if a method is an initialization method
    52. -
    53. - isPrivate - - Check if a method is a private method
    54. -
    55. - isProtected - - Check if a method is a protected method
    56. -
    57. - isPublic - - Check if a method is a public method
    58. -
    59. - isStatic - - Check if this method is static
    60. -
    - - - - - - - -

    Method details:

    - -
    - - - +Method obtained by parsing the "method" annotation + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getBodyCode](#mgetbodycode) - Get the code for this method +1. [getCallMethod](#mgetcallmethod) - Get the entity of the magic method that will be called instead of the current virtual one +1. [getDescription](#mgetdescription) - Get a description of this method +1. [getEndLine](#mgetendline) - Get the line number of the end of a method's code in a file +1. [getFirstReturnValue](#mgetfirstreturnvalue) - Get the compiled first return value of a method (if possible) +1. [getImplementingClass](#mgetimplementingclass) - Get the ClassLike entity in which this method was implemented +1. [getImplementingClassName](#mgetimplementingclassname) - Get the name of the class in which this method is implemented +1. [getModifiersString](#mgetmodifiersstring) - Get a text representation of method modifiers +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Namespace of the class that contains this method +1. [getObjectId](#mgetobjectid) - Entity object ID +1. [getParameters](#mgetparameters) - Get a list of method parameters +1. [getParametersString](#mgetparametersstring) - Get a list of method parameters as a string +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getReturnType](#mgetreturntype) - Get the return type of method +1. [getRootEntity](#mgetrootentity) - Get the class like entity where this method was obtained +1. [getRootEntityCollection](#mgetrootentitycollection) - Get parent collection of entities +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getSignature](#mgetsignature) - Get the method signature as a string +1. [getStartColumn](#mgetstartcolumn) - Get the column number of the beginning of the method code in a file +1. [getStartLine](#mgetstartline) - Get the line number of the beginning of the method code in a file +1. [isDynamic](#misdynamic) - Check if a method is a dynamic method, that is, implementable using __call or __callStatic +1. [isEntityCacheOutdated](#misentitycacheoutdated) +1. [isImplementedInParentClass](#misimplementedinparentclass) - Check if this method is implemented in the parent class +1. [isInitialization](#misinitialization) - Check if a method is an initialization method +1. [isPrivate](#misprivate) - Check if a method is a private method +1. [isProtected](#misprotected) - Check if a method is a protected method +1. [isPublic](#mispublic) - Check if a method is a public method +1. [isStatic](#misstatic) - Check if this method is static + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L20) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity $classEntity, \phpDocumentor\Reflection\DocBlock\Tags\Method $annotationMethod); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$classEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) | - | +$annotationMethod | [\phpDocumentor\Reflection\DocBlock\Tags\Method](https://github.com/phpDocumentor/ReflectionDocBlock/blob/master/src/DocBlock/Tags/Method.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $classEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity-
    $annotationMethod\phpDocumentor\Reflection\DocBlock\Tags\Method-
    - - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L327) ```php public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string - - -
    -
    -
    - - +--- +# `getBodyCode` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L304) ```php public function getBodyCode(): string; ``` +Get the code for this method -
    Get the code for this method
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getCallMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L67) ```php public function getCallMethod(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Get the entity of the magic method that will be called instead of the current virtual one -
    Get the entity of the magic method that will be called instead of the current virtual one
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity - - -Throws: - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) -
    -
    -
    - - +--- +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L214) ```php public function getDescription(): string; ``` +Get a description of this method -
    Get a description of this method
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L115) ```php public function getEndLine(): int; ``` +Get the line number of the end of a method's code in a file -
    Get the line number of the end of a method's code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -
    -
    -
    - - +--- +# `getFirstReturnValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L296) ```php public function getFirstReturnValue(): mixed; ``` +Get the compiled first return value of a method (if possible) -
    Get the compiled first return value of a method (if possible)
    - -Parameters: not specified - -Return value: mixed - +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L240) ```php public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the ClassLike entity in which this method was implemented -
    Get the ClassLike entity in which this method was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -
    -
    -
    - - +--- +# `getImplementingClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L196) ```php public function getImplementingClassName(): string; ``` +Get the name of the class in which this method is implemented -
    Get the name of the class in which this method is implemented
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L124) ```php public function getModifiersString(): string; ``` +Get a text representation of method modifiers -
    Get a text representation of method modifiers
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L39) ```php public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L256) ```php public function getNamespaceName(): string; ``` +Namespace of the class that contains this method -
    Namespace of the class that contains this method
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L309) ```php public function getObjectId(): string; ``` +Entity object ID -
    Entity object ID
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getParameters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L161) ```php public function getParameters(): array; ``` +Get a list of method parameters -
    Get a list of method parameters
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - - +--- +# `getParametersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L181) ```php public function getParametersString(): string; ``` +Get a list of method parameters as a string -
    Get a list of method parameters as a string
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L83) ```php public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) -See: - -
    -
    -
    - - +--- +# `getReturnType` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L140) ```php public function getReturnType(): string; ``` +Get the return type of method -
    Get the return type of method
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getRootEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L31) ```php public function getRootEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity where this method was obtained -
    Get the class like entity where this method was obtained
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -
    -
    -
    - - +--- +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L317) ```php public function getRootEntityCollection(): \BumbleDocGen\Core\Parser\Entity\RootEntityCollection; ``` +Get parent collection of entities -
    Get parent collection of entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityCollection - +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) -
    -
    -
    - - +--- +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L248) ```php public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getSignature` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L49) ```php public function getSignature(): string; ``` +Get the method signature as a string -
    Get the method signature as a string
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getStartColumn` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L104) ```php public function getStartColumn(): int; ``` +Get the column number of the beginning of the method code in a file -
    Get the column number of the beginning of the method code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -
    -
    -
    - - +--- +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L93) ```php public function getStartLine(): int; ``` +Get the line number of the beginning of the method code in a file -
    Get the line number of the beginning of the method code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -
    -
    -
    - - +--- +# `isDynamic` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L288) ```php public function isDynamic(): bool; ``` +Check if a method is a dynamic method, that is, implementable using __call or __callStatic -
    Check if a method is a dynamic method, that is, implementable using __call or __callStatic
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L339) ```php public function isEntityCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isImplementedInParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L206) ```php public function isImplementedInParentClass(): bool; ``` +Check if this method is implemented in the parent class -
    Check if this method is implemented in the parent class
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isInitialization` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L225) ```php public function isInitialization(): bool; ``` +Check if a method is an initialization method -
    Check if a method is an initialization method
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isPrivate` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L280) ```php public function isPrivate(): bool; ``` +Check if a method is a private method -
    Check if a method is a private method
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isProtected` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L272) ```php public function isProtected(): bool; ``` +Check if a method is a protected method -
    Check if a method is a protected method
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isPublic` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L264) ```php public function isPublic(): bool; ``` +Check if a method is a public method -
    Check if a method is a public method
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isStatic` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/DynamicMethodEntity.php#L57) ```php public function isStatic(): bool; ``` +Check if this method is static -
    Check if this method is static
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/EntityInterface.md b/docs/tech/02_parser/classes/EntityInterface.md deleted file mode 100644 index 6d185a4e..00000000 --- a/docs/tech/02_parser/classes/EntityInterface.md +++ /dev/null @@ -1,211 +0,0 @@ - BumbleDocGen / Technical description of the project / Parser / Entities and entities collections / EntityInterface
    - -

    - EntityInterface class: -

    - - - - - -```php -namespace BumbleDocGen\Core\Parser\Entity; - -interface EntityInterface -``` - - - - - - - - - -

    Methods:

    - -
      -
    1. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    2. -
    3. - getName - - Full name of the entity
    4. -
    5. - getObjectId - - Entity object ID
    6. -
    7. - getRelativeFileName - - File name relative to project_root configuration parameter
    8. -
    9. - getRootEntityCollection - - Get parent collection of entities
    10. -
    11. - getShortName - - Short name of the entity
    12. -
    13. - isEntityCacheOutdated -
    14. -
    - - - - - - - -

    Method details:

    - -
    - - - -```php -public function getAbsoluteFileName(): null|string; -``` - -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - - -
    -
    -
    - - - -```php -public function getName(): string; -``` - -
    Full name of the entity
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - -```php -public function getObjectId(): string; -``` - -
    Entity object ID
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - -```php -public function getRelativeFileName(): null|string; -``` - -
    File name relative to project_root configuration parameter
    - -Parameters: not specified - -Return value: null | string - - - -See: - -
    -
    -
    - - - -```php -public function getRootEntityCollection(): \BumbleDocGen\Core\Parser\Entity\RootEntityCollection; -``` - -
    Get parent collection of entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityCollection - - -
    -
    -
    - - - -```php -public function getShortName(): string; -``` - -
    Short name of the entity
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    - -```php -public function isEntityCacheOutdated(): bool; -``` - - - -Parameters: not specified - -Return value: bool - - -
    -
    diff --git a/docs/tech/02_parser/classes/EnumEntity.md b/docs/tech/02_parser/classes/EnumEntity.md index 71ae969a..3b58894e 100644 --- a/docs/tech/02_parser/classes/EnumEntity.md +++ b/docs/tech/02_parser/classes/EnumEntity.md @@ -1,3559 +1,1400 @@ - BumbleDocGen / Technical description of the project / Parser / Entities and entities collections / EnumEntity
    - -

    - EnumEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +EnumEntity +--- +# [EnumEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/EnumEntity.php#L19) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; class EnumEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity implements \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface, \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface ``` - -
    Enumeration
    - -See: - - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - addPluginData - - Add information to aт entity object
    2. -
    3. - cursorToDocAttributeLinkFragment -
    4. -
    5. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    6. -
    7. - getAst - - Get AST for this entity
    8. -
    9. - getCacheKey -
    10. -
    11. - getCachedEntityDependencies -
    12. -
    13. - getCasesNames - - Get enum cases names
    14. -
    15. - getConstant - - Get the method entity by its name
    16. -
    17. - getConstantEntitiesCollection - - Get a collection of constant entities
    18. -
    19. - getConstantValue - - Get the compiled value of a constant
    20. -
    21. - getConstants - - Get all constants that are available according to the configuration as an array
    22. -
    23. - getConstantsData - - Get a list of all constants and classes where they are implemented
    24. -
    25. - getConstantsValues - - Get class constant compiled values according to filters
    26. -
    27. - getCurrentRootEntity -
    28. -
    29. - getDescription - - Get entity description
    30. -
    31. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    32. -
    33. - getDocBlock - - Get DocBlock for current entity
    34. -
    35. - getDocComment - - Get the doc comment of an entity
    36. -
    37. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    38. -
    39. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    40. -
    41. - getDocNote - - Get the note annotation value
    42. -
    43. - getDocRender -
    44. -
    45. - getEndLine - - Get the line number of the end of a class code in a file
    46. -
    47. - getEntityDependencies -
    48. -
    49. - getEnumCaseValue - - Get enum case value
    50. -
    51. - getEnumCases - - Get enum cases values
    52. -
    53. - getExamples - - Get parsed examples from `examples` doc block
    54. -
    55. - getFileContent -
    56. -
    57. - getFileSourceLink -
    58. -
    59. - getFirstExample - - Get first example from `examples` doc block
    60. -
    61. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    62. -
    63. - getInterfaceNames - - Get a list of class interface names
    64. -
    65. - getInterfacesEntities - - Get a list of interface entities that the current class implements
    66. -
    67. - getMethod - - Get the method entity by its name
    68. -
    69. - getMethodEntitiesCollection - - Get a collection of method entities
    70. -
    71. - getMethods - - Get all methods that are available according to the configuration as an array
    72. -
    73. - getMethodsData - - Get a list of all methods and classes where they are implemented
    74. -
    75. - getModifiersString - - Get entity modifiers as a string
    76. -
    77. - getName - - Full name of the entity
    78. -
    79. - getNamespaceName - - Get the entity namespace name
    80. -
    81. - getObjectId - - Get entity unique ID
    82. -
    83. - getParentClass - - Get the entity of the parent class if it exists
    84. -
    85. - getParentClassEntities - - Get a list of parent class entities
    86. -
    87. - getParentClassName - - Get the name of the parent class entity if it exists
    88. -
    89. - getParentClassNames - - Get a list of entity names of parent classes
    90. -
    91. - getPluginData - - Get additional information added using the plugin
    92. -
    93. - getProperties - - Get all properties that are available according to the configuration as an array
    94. -
    95. - getPropertiesData - - Get a list of all properties and classes where they are implemented
    96. -
    97. - getProperty - - Get the property entity by its name
    98. -
    99. - getPropertyDefaultValue - - Get the compiled value of a property
    100. -
    101. - getPropertyEntitiesCollection - - Get a collection of property entities
    102. -
    103. - getRelativeFileName - - File name relative to project_root configuration parameter
    104. -
    105. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    106. -
    107. - getShortName - - Short name of the entity
    108. -
    109. - getStartLine - - Get the line number of the start of a class code in a file
    110. -
    111. - getThrows - - Get parsed throws from `throws` doc block
    112. -
    113. - getThrowsDocBlockLinks -
    114. -
    115. - getTraits - - Get a list of trait entities of the current class
    116. -
    117. - getTraitsNames - - Get a list of class traits names
    118. -
    119. - hasConstant - - Check if a constant exists in a class
    120. -
    121. - hasDescriptionLinks - - Checking if an entity has links in its description
    122. -
    123. - hasExamples - - Checking if an entity has `example` docBlock
    124. -
    125. - hasMethod - - Check if a method exists in a class
    126. -
    127. - hasParentClass - - Check if a certain parent class exists in a chain of parent classes
    128. -
    129. - hasProperty - - Check if a property exists in a class
    130. -
    131. - hasThrows - - Checking if an entity has `throws` docBlock
    132. -
    133. - hasTraits - - Check if the class contains traits
    134. -
    135. - implementsInterface - - Check if a class implements an interface
    136. -
    137. - isAbstract - - Check that an entity is abstract
    138. -
    139. - isApi - - Checking if an entity has `api` docBlock
    140. -
    141. - isClass - - Check if an entity is a Class
    142. -
    143. - isClassLoad -
    144. -
    145. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    146. -
    147. - isDocumentCreationAllowed -
    148. -
    149. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    150. -
    151. - isEntityDataCacheOutdated -
    152. -
    153. - isEntityDataCanBeLoaded -
    154. -
    155. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    156. -
    157. - isEntityNameValid - - Check if the name is a valid name for ClassLikeEntity
    158. -
    159. - isEnum - - Check if an entity is an Enum
    160. -
    161. - isExternalLibraryEntity - - Check if a given entity is an entity from a third party library (connected via composer)
    162. -
    163. - isInGit - - Checking if class file is in git repository
    164. -
    165. - isInstantiable - - Check that an entity is instantiable
    166. -
    167. - isInterface - - Check if an entity is an Interface
    168. -
    169. - isInternal - - Checking if an entity has `internal` docBlock
    170. -
    171. - isSubclassOf - - Whether the given class is a subclass of the specified class
    172. -
    173. - isTrait - - Check if an entity is a Trait
    174. -
    175. - normalizeClassName - - Bring the class name to the standard format used in the system
    176. -
    177. - reloadEntityDependenciesCache - - Update entity dependency cache
    178. -
    179. - removeEntityValueFromCache -
    180. -
    181. - removeNotUsedEntityDataCache -
    182. -
    183. - setCustomAst -
    184. -
    - - - - - - - -

    Method details:

    - -
    - - - +Enumeration + +***Links:*** +- [https://www.php.net/manual/en/language.enumerations.php](https://www.php.net/manual/en/language.enumerations.php) + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [addPluginData](#maddplugindata) - Add information to aт entity object +1. [cursorToDocAttributeLinkFragment](#mcursortodocattributelinkfragment) +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getCasesNames](#mgetcasesnames) - Get enum cases names +1. [getConstant](#mgetconstant) - Get the method entity by its name +1. [getConstantEntitiesCollection](#mgetconstantentitiescollection) - Get a collection of constant entities +1. [getConstantValue](#mgetconstantvalue) - Get the compiled value of a constant +1. [getConstants](#mgetconstants) - Get all constants that are available according to the configuration as an array +1. [getConstantsData](#mgetconstantsdata) - Get a list of all constants and classes where they are implemented +1. [getConstantsValues](#mgetconstantsvalues) - Get class constant compiled values according to filters +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getDocRender](#mgetdocrender) +1. [getEndLine](#mgetendline) - Get the line number of the end of a class code in a file +1. [getEntityDependencies](#mgetentitydependencies) +1. [getEnumCaseValue](#mgetenumcasevalue) - Get enum case value +1. [getEnumCases](#mgetenumcases) - Get enum cases values +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getInterfaceNames](#mgetinterfacenames) - Get a list of class interface names +1. [getInterfacesEntities](#mgetinterfacesentities) - Get a list of interface entities that the current class implements +1. [getMethod](#mgetmethod) - Get the method entity by its name +1. [getMethodEntitiesCollection](#mgetmethodentitiescollection) - Get a collection of method entities +1. [getMethods](#mgetmethods) - Get all methods that are available according to the configuration as an array +1. [getMethodsData](#mgetmethodsdata) - Get a list of all methods and classes where they are implemented +1. [getModifiersString](#mgetmodifiersstring) - Get entity modifiers as a string +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Get the entity namespace name +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getParentClass](#mgetparentclass) - Get the entity of the parent class if it exists +1. [getParentClassEntities](#mgetparentclassentities) - Get a list of parent class entities +1. [getParentClassName](#mgetparentclassname) - Get the name of the parent class entity if it exists +1. [getParentClassNames](#mgetparentclassnames) - Get a list of entity names of parent classes +1. [getPluginData](#mgetplugindata) - Get additional information added using the plugin +1. [getProperties](#mgetproperties) - Get all properties that are available according to the configuration as an array +1. [getPropertiesData](#mgetpropertiesdata) - Get a list of all properties and classes where they are implemented +1. [getProperty](#mgetproperty) - Get the property entity by its name +1. [getPropertyDefaultValue](#mgetpropertydefaultvalue) - Get the compiled value of a property +1. [getPropertyEntitiesCollection](#mgetpropertyentitiescollection) - Get a collection of property entities +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getTraits](#mgettraits) - Get a list of trait entities of the current class +1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names +1. [hasConstant](#mhasconstant) - Check if a constant exists in a class +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasMethod](#mhasmethod) - Check if a method exists in a class +1. [hasParentClass](#mhasparentclass) - Check if a certain parent class exists in a chain of parent classes +1. [hasProperty](#mhasproperty) - Check if a property exists in a class +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [hasTraits](#mhastraits) - Check if the class contains traits +1. [implementsInterface](#mimplementsinterface) - Check if a class implements an interface +1. [isAbstract](#misabstract) - Check that an entity is abstract +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isClass](#misclass) - Check if an entity is a Class +1. [isClassLoad](#misclassload) +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isDocumentCreationAllowed](#misdocumentcreationallowed) +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isEntityNameValid](#misentitynamevalid) - Check if the name is a valid name for ClassLikeEntity +1. [isEnum](#misenum) - Check if an entity is an Enum +1. [isExternalLibraryEntity](#misexternallibraryentity) - Check if a given entity is an entity from a third party library (connected via composer) +1. [isInGit](#misingit) - Checking if class file is in git repository +1. [isInstantiable](#misinstantiable) - Check that an entity is instantiable +1. [isInterface](#misinterface) - Check if an entity is an Interface +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isSubclassOf](#missubclassof) - Whether the given class is a subclass of the specified class +1. [isTrait](#mistrait) - Check if an entity is a Trait +1. [normalizeClassName](#mnormalizeclassname) - Bring the class name to the standard format used in the system +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) +1. [setCustomAst](#msetcustomast) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L51) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection $entitiesCollection, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper $composerHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $className, string|null $relativeFileName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$entitiesCollection | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$composerHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ComposerHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$relativeFileName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $entitiesCollection\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $composerHelper\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $classNamestring-
    $relativeFileNamestring | null-
    - - - -
    -
    -
    - - +--- +# `addPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function addPluginData(string $pluginKey, mixed $data): void; ``` +Add information to aт entity object -
    Add information to aт entity object
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    $datamixed-
    - -Return value: void +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$data | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | -
    -
    -
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
      -
    • # - cursorToDocAttributeLinkFragment - :warning: Is internal | source code
    • -
    +--- +# `cursorToDocAttributeLinkFragment` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1286) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function cursorToDocAttributeLinkFragment(string $cursor, bool $isForDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $cursorstring-
    $isForDocumentbool-
    - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L296) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getAst(): \PhpParser\Node\Stmt\Class_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_; ``` +Get AST for this entity -
    Get AST for this entity
    +***Return value:*** [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) | [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) | [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\Class_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ - - -Throws: - - -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getCasesNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/EnumEntity.php#L74) ```php public function getCasesNames(): array; ``` +Get enum cases names -
    Get enum cases names
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Throws: - - -
    -
    -
    - - - +# `getConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L806) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstant(string $constantName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant whose entity you want to get
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    +***Parameters:*** -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -Throws: - - -
    -
    -
    - - +--- +# `getConstantEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L736) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection; ``` +Get a collection of constant entities -
    Get a collection of constant entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) -Throws: - - - -See: - -
    -
    -
    - - +--- +# `getConstantValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L829) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantValue(string $constantName): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant for which you need to get the value
    - -Return value: string | array | int | bool | null | float - - -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant for which you need to get the value | -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) - +--- +# `getConstants` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L765) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstants(): array; ``` +Get all constants that are available according to the configuration as an array -
    Get all constants that are available according to the configuration as an array
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) -Return value: array - - -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getConstantsData - :warning: Is internal | source code
    • -
    +--- +# `getConstantsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L661) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all constants and classes where they are implemented -
    Get a list of all constants and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for constants from the current class
    $flagsintGet data only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for constants corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getConstantsValues` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L849) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantsValues(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get class constant compiled values according to filters -
    Get class constant compiled values according to filters
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet values only for constants from the current class
    $flagsintGet values only for constants corresponding to the visibility modifiers passed in this value
    +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get values only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get values only for constants corresponding to the visibility modifiers passed in this value | -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    - +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Throws: - - -
    -
    -
    - - - +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    - -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - +***Return value:*** [\phpDocumentor\Reflection\DocBlock](https://github.com/phpDocumentor/ReflectionDocBlock/blob/master/src/DocBlock.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    +--- +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L236) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -
    -
    -
    - - - +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) -Return value: null | int - - -Throws: - - -
    -
    -
    - - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Throws: - - -
    -
    -
    - - - +# `getDocRender` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1262) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getDocRender(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRendererInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface - - -Throws: - - -
    -
    -
    - - - +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L469) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getEndLine(): int; ``` +Get the line number of the end of a class code in a file -
    Get the line number of the end of a class code in a file
    - -Parameters: not specified - -Return value: int +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) +--- -Throws: - - -
    -
    -
    - - - +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getEnumCaseValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/EnumEntity.php#L87) ```php public function getEnumCaseValue(string $name): mixed; ``` +Get enum case value -
    Get enum case value
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    - -Return value: mixed - - -Throws: - +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) -
    -
    -
    - - +--- +# `getEnumCases` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/EnumEntity.php#L45) ```php public function getEnumCases(): array; ``` +Get enum cases values -
    Get enum cases values
    - -Parameters: not specified - -Return value: array - - -Throws: - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - - +--- +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1035) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    - +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L370) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -
    -
    -
    - - - +# `getInterfaceNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/EnumEntity.php#L32) ```php public function getInterfaceNames(): array; ``` +Get a list of class interface names -
    Get a list of class interface names
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getInterfacesEntities(): array; -``` - -
    Get a list of interface entities that the current class implements
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getMethod(string $methodName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; -``` - -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to get
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity - - -Throws: - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getMethodEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; -``` - -
    Get a collection of method entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection - - -Throws: - - - -See: - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getMethods(): array; -``` - -
    Get all methods that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - - -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getMethodsData - :warning: Is internal | source code
    • -
    - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getMethodsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; -``` - -
    Get a list of all methods and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for methods from the current class
    $flagsintGet data only for methods corresponding to the visibility modifiers passed in this value
    - -Return value: array - - -Throws: - - -
    -
    -
    - - - -```php -public function getModifiersString(): string; -``` - -
    Get entity modifiers as a string
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getName(): string; -``` - -
    Full name of the entity
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getNamespaceName(): string; -``` - -
    Get the entity namespace name
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getObjectId(): string; -``` - -
    Get entity unique ID
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getParentClass(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; -``` - -
    Get the entity of the parent class if it exists
    - -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getParentClassEntities(): array; -``` - -
    Get a list of parent class entities
    - -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getParentClassName(): null|string; -``` - -
    Get the name of the parent class entity if it exists
    - -Parameters: not specified - -Return value: null | string - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getParentClassNames(): array; -``` - -
    Get a list of entity names of parent classes
    - -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getPluginData(string $pluginKey): mixed; -``` - -
    Get additional information added using the plugin
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    - -Return value: mixed - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getProperties(): array; -``` - -
    Get all properties that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - - -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getPropertiesData - :warning: Is internal | source code
    • -
    - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getPropertiesData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; -``` - -
    Get a list of all properties and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for properties from the current class
    $flagsintGet data only for properties corresponding to the visibility modifiers passed in this value
    - -Return value: array - - -Throws: - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getProperty(string $propertyName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; -``` - -
    Get the property entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to get
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity - - -Throws: - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getPropertyDefaultValue(string $propertyName): string|array|int|bool|null|float; -``` - -
    Get the compiled value of a property
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: +--- - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property for which you need to get the value
    +# `getInterfacesEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L587) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -Return value: string | array | int | bool | null | float +public function getInterfacesEntities(): array; +``` +Get a list of interface entities that the current class implements +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) - +--- +# `getMethodEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1133) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getPropertyEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection; +public function getMethodEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; ``` +Get a collection of method entities -
    Get a collection of property entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) -Throws: - +public function getMethods(): array; +``` +Get all methods that are available according to the configuration as an array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -See: - -
    -
    -
    +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) - +--- +# `getMethodsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1059) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getRelativeFileName(): null|string; +public function getMethodsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all methods and classes where they are implemented -
    File name relative to project_root configuration parameter
    +***Parameters:*** -Parameters: not specified +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for methods from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for methods corresponding to the visibility modifiers passed in this value | -Return value: null | string +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/EnumEntity.php#L95) +```php +public function getModifiersString(): string; +``` +Get entity modifiers as a string -See: - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L378) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; +public function getName(): string; ``` +Full name of the entity -
    Get the collection of root entities to which this entity belongs
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified +--- -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L397) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +public function getNamespaceName(): string; +``` +Get the entity namespace name -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L142) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getShortName(): string; +public function getObjectId(): string; ``` +Get entity unique ID -
    Short name of the entity
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified +--- -Return value: string +# `getParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L516) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +public function getParentClass(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; +``` +Get the entity of the parent class if it exists -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) - +--- +# `getParentClassEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getStartLine(): int; +public function getParentClassEntities(): array; ``` +Get a list of parent class entities -
    Get the line number of the start of a class code in a file
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified +--- -Return value: int - - -Throws: - +public function getParentClassName(): null|string; +``` +Get the name of the parent class entity if it exists -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L481) ```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getThrows(): array; +public function getParentClassNames(): array; ``` +Get a list of entity names of parent classes -
    Get parsed throws from `throws` doc block
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified +--- -Return value: array +# `getPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L270) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +public function getPluginData(string $pluginKey): mixed; +``` +Get additional information added using the plugin -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) - +--- +# `getProperties` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L963) ```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getThrowsDocBlockLinks(): array; +public function getProperties(): array; ``` +Get all properties that are available according to the configuration as an array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) -Parameters: not specified +--- -Return value: array +# `getPropertiesData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L872) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +public function getPropertiesData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; +``` +Get a list of all properties and classes where they are implemented -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for properties from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for properties corresponding to the visibility modifiers passed in this value | -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1004) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getTraits(): array; +public function getProperty(string $propertyName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; ``` +Get the property entity by its name -
    Get a list of trait entities of the current class
    +***Parameters:*** -Parameters: not specified +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | -Return value: array +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php) + +--- + +# `getPropertyDefaultValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1027) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +public function getPropertyDefaultValue(string $propertyName): string|array|int|bool|null|float; +``` +Get the compiled value of a property -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property for which you need to get the value | -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) - +--- +# `getPropertyEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L934) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getTraitsNames(): array; +public function getPropertyEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection; ``` +Get a collection of property entities -
    Get a list of class traits names
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) -Parameters: not specified +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) -Return value: array +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L412) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -Throws: - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) - +--- +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L160) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function hasConstant(string $constantName, bool $unsafe = false): bool; +public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Check if a constant exists in a class
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -Parameters: +--- - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the class whose entity you want to check
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    - -Return value: bool +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L386) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +public function getShortName(): string; +``` +Short name of the entity -Throws: - +public function getStartLine(): int; +``` +Get the line number of the start of a class code in a file -
    -
    -
    +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) - +--- +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity -public function hasDescriptionLinks(): bool; +public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Checking if an entity has links in its description
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: bool +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity -Throws: - +public function getThrowsDocBlockLinks(): array; +``` -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function hasExamples(): bool; +public function getTraits(): array; ``` +Get a list of trait entities of the current class -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: bool +--- +# `getTraitsNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L604) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -Throws: - +public function getTraitsNames(): array; +``` +Get a list of class traits names -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `hasConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L785) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function hasMethod(string $methodName, bool $unsafe = false): bool; +public function hasConstant(string $constantName, bool $unsafe = false): bool; ``` +Check if a constant exists in a class + +***Parameters:*** -
    Check if a method exists in a class
    +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the class whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | -Parameters: +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to check
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +--- -Return value: bool +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity +public function hasDescriptionLinks(): bool; +``` +Checking if an entity has links in its description -Throws: - +public function hasExamples(): bool; +``` +Checking if an entity has `example` docBlock -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1182) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function hasParentClass(string $parentClassName): bool; +public function hasMethod(string $methodName, bool $unsafe = false): bool; ``` +Check if a method exists in a class -
    Check if a certain parent class exists in a chain of parent classes
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamestringSearched parent class
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1250) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function hasProperty(string $propertyName, bool $unsafe = false): bool; +public function hasParentClass(string $parentClassName): bool; ``` +Check if a certain parent class exists in a chain of parent classes -
    Check if a property exists in a class
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to check
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    +| Name | Type | Description | +|:-|:-|:-| +$parentClassName | [string](https://www.php.net/manual/en/language.types.string.php) | Searched parent class | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L644) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasTraits(): bool; ``` +Check if the class contains traits -
    Check if the class contains traits
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `implementsInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1237) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function implementsInterface(string $interfaceName): bool; ``` +Check if a class implements an interface -
    Check if a class implements an interface
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$interfaceName | [string](https://www.php.net/manual/en/language.types.string.php) | Name of the required interface in the interface chain | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfaceNamestringName of the required interface in the interface chain
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isAbstract` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L445) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isAbstract(): bool; ``` +Check that an entity is abstract -
    Check that an entity is abstract
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isClass(): bool; ``` +Check if an entity is a Class -
    Check if an entity is a Class
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isClassLoad` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L343) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isClassLoad(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isDocumentCreationAllowed - :warning: Is internal | source code
    • -
    +--- +# `isDocumentCreationAllowed` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L224) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isDocumentCreationAllowed(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L358) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isEntityDataCanBeLoaded(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L84) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public static function isEntityNameValid(string $entityName): bool; ``` +Check if the name is a valid name for ClassLikeEntity -
    Check if the name is a valid name for ClassLikeEntity
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isEnum` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/EnumEntity.php#L24) ```php public function isEnum(): bool; ``` +Check if an entity is an Enum -
    Check if an entity is an Enum
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -
    -
    -
    - -
      -
    • # - isExternalLibraryEntity - :warning: Is internal | source code
    • -
    +--- +# `isExternalLibraryEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L152) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isExternalLibraryEntity(): bool; ``` +Check if a given entity is an entity from a third party library (connected via composer) -
    Check if a given entity is an entity from a third party library (connected via composer)
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isInGit` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L205) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInGit(): bool; ``` +Checking if class file is in git repository -
    Checking if class file is in git repository
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - +--- +# `isInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L435) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInstantiable(): bool; ``` +Check that an entity is instantiable -
    Check that an entity is instantiable
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L114) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInterface(): bool; ``` +Check if an entity is an Interface -
    Check if an entity is an Interface
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isSubclassOf` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1219) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isSubclassOf(string $className): bool; ``` +Whether the given class is a subclass of the specified class -
    Whether the given class is a subclass of the specified class
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classNamestring-
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isTrait` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L124) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isTrait(): bool; ``` +Check if an entity is a Trait -
    Check if an entity is a Trait
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L94) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public static function normalizeClassName(string $name): string; ``` +Bring the class name to the standard format used in the system -
    Bring the class name to the standard format used in the system
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    - +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    - +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    - +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - - - +# `setCustomAst` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L284) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function setCustomAst(\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Class_|null $customAst): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$customAst | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) \| [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) \| [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) \| [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $customAst\PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Class_ | null-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/FalseCondition.md b/docs/tech/02_parser/classes/FalseCondition.md index feaa26e7..da95a718 100644 --- a/docs/tech/02_parser/classes/FalseCondition.md +++ b/docs/tech/02_parser/classes/FalseCondition.md @@ -1,78 +1,38 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / FalseCondition
    - -

    - FalseCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +FalseCondition +--- +# [FalseCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/CommonFilterCondition/FalseCondition.php#L13) class: ```php namespace BumbleDocGen\Core\Parser\FilterCondition\CommonFilterCondition; final class FalseCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +False conditions, any object is not available -
    False conditions, any object is not available
    - - - - - - - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - - - - -

    Method details:

    - -
    - - - +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/CommonFilterCondition/FalseCondition.php#L15) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/FileIteratorSourceLocator.md b/docs/tech/02_parser/classes/FileIteratorSourceLocator.md index 27d9441c..83d0afc1 100644 --- a/docs/tech/02_parser/classes/FileIteratorSourceLocator.md +++ b/docs/tech/02_parser/classes/FileIteratorSourceLocator.md @@ -1,107 +1,50 @@ - BumbleDocGen / Technical description of the project / Parser / Source locators / FileIteratorSourceLocator
    - -

    - FileIteratorSourceLocator class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Source locators](/docs/tech/02_parser/sourceLocator.md) **/** +FileIteratorSourceLocator +--- +# [FileIteratorSourceLocator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/FileIteratorSourceLocator.php#L10) class: ```php namespace BumbleDocGen\Core\Parser\SourceLocator; final class FileIteratorSourceLocator extends \BumbleDocGen\Core\Parser\SourceLocator\BaseSourceLocator implements \BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorInterface ``` +Loads all files using an iterator -
    Loads all files using an iterator
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getFinder -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [getFinder](#mgetfinder) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/FileIteratorSourceLocator.php#L12) ```php public function __construct(\Iterator $fileInfoIterator); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$fileInfoIterator | [\Iterator](https://www.php.net/manual/en/class.iterator.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $fileInfoIterator\Iterator-
    - - - -
    -
    -
    - - +--- +# `getFinder` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/BaseSourceLocator.php#L19) ```php // Implemented in BumbleDocGen\Core\Parser\SourceLocator\BaseSourceLocator public function getFinder(): \Symfony\Component\Finder\Finder; ``` +***Return value:*** [\Symfony\Component\Finder\Finder](https://github.com/symfony/finder/blob/master/Finder.php) - -Parameters: not specified - -Return value: \Symfony\Component\Finder\Finder - - -
    -
    +--- diff --git a/docs/tech/02_parser/classes/FileTextContainsCondition.md b/docs/tech/02_parser/classes/FileTextContainsCondition.md index 3dd496f7..b27c9505 100644 --- a/docs/tech/02_parser/classes/FileTextContainsCondition.md +++ b/docs/tech/02_parser/classes/FileTextContainsCondition.md @@ -1,122 +1,54 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / FileTextContainsCondition
    - -

    - FileTextContainsCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +FileTextContainsCondition +--- +# [FileTextContainsCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/CommonFilterCondition/FileTextContainsCondition.php#L14) class: ```php namespace BumbleDocGen\Core\Parser\FilterCondition\CommonFilterCondition; final class FileTextContainsCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Checking if a file contains a substring -
    Checking if a file contains a substring
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/CommonFilterCondition/FileTextContainsCondition.php#L16) ```php public function __construct(string $substring); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$substring | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $substringstring-
    - - - -
    -
    -
    - - +--- +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/CommonFilterCondition/FileTextContainsCondition.php#L20) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/InterfaceEntity.md b/docs/tech/02_parser/classes/InterfaceEntity.md index 2e61e64a..7466a3b9 100644 --- a/docs/tech/02_parser/classes/InterfaceEntity.md +++ b/docs/tech/02_parser/classes/InterfaceEntity.md @@ -1,3438 +1,1359 @@ - BumbleDocGen / Technical description of the project / Parser / Entities and entities collections / InterfaceEntity
    - -

    - InterfaceEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +InterfaceEntity +--- +# [InterfaceEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/InterfaceEntity.php#L12) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; class InterfaceEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity implements \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface, \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface ``` - -
    Object interface
    - -See: - - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - addPluginData - - Add information to aт entity object
    2. -
    3. - cursorToDocAttributeLinkFragment -
    4. -
    5. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    6. -
    7. - getAst - - Get AST for this entity
    8. -
    9. - getCacheKey -
    10. -
    11. - getCachedEntityDependencies -
    12. -
    13. - getConstant - - Get the method entity by its name
    14. -
    15. - getConstantEntitiesCollection - - Get a collection of constant entities
    16. -
    17. - getConstantValue - - Get the compiled value of a constant
    18. -
    19. - getConstants - - Get all constants that are available according to the configuration as an array
    20. -
    21. - getConstantsData - - Get a list of all constants and classes where they are implemented
    22. -
    23. - getConstantsValues - - Get class constant compiled values according to filters
    24. -
    25. - getCurrentRootEntity -
    26. -
    27. - getDescription - - Get entity description
    28. -
    29. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    30. -
    31. - getDocBlock - - Get DocBlock for current entity
    32. -
    33. - getDocComment - - Get the doc comment of an entity
    34. -
    35. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    36. -
    37. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    38. -
    39. - getDocNote - - Get the note annotation value
    40. -
    41. - getDocRender -
    42. -
    43. - getEndLine - - Get the line number of the end of a class code in a file
    44. -
    45. - getEntityDependencies -
    46. -
    47. - getExamples - - Get parsed examples from `examples` doc block
    48. -
    49. - getFileContent -
    50. -
    51. - getFileSourceLink -
    52. -
    53. - getFirstExample - - Get first example from `examples` doc block
    54. -
    55. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    56. -
    57. - getInterfaceNames - - Get a list of class interface names
    58. -
    59. - getInterfacesEntities - - Get a list of interface entities that the current class implements
    60. -
    61. - getMethod - - Get the method entity by its name
    62. -
    63. - getMethodEntitiesCollection - - Get a collection of method entities
    64. -
    65. - getMethods - - Get all methods that are available according to the configuration as an array
    66. -
    67. - getMethodsData - - Get a list of all methods and classes where they are implemented
    68. -
    69. - getModifiersString - - Get entity modifiers as a string
    70. -
    71. - getName - - Full name of the entity
    72. -
    73. - getNamespaceName - - Get the entity namespace name
    74. -
    75. - getObjectId - - Get entity unique ID
    76. -
    77. - getParentClass - - Get the entity of the parent class if it exists
    78. -
    79. - getParentClassEntities - - Get a list of parent class entities
    80. -
    81. - getParentClassName - - Get the name of the parent class entity if it exists
    82. -
    83. - getParentClassNames - - Get a list of entity names of parent classes
    84. -
    85. - getPluginData - - Get additional information added using the plugin
    86. -
    87. - getProperties - - Get all properties that are available according to the configuration as an array
    88. -
    89. - getPropertiesData - - Get a list of all properties and classes where they are implemented
    90. -
    91. - getProperty - - Get the property entity by its name
    92. -
    93. - getPropertyDefaultValue - - Get the compiled value of a property
    94. -
    95. - getPropertyEntitiesCollection - - Get a collection of property entities
    96. -
    97. - getRelativeFileName - - File name relative to project_root configuration parameter
    98. -
    99. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    100. -
    101. - getShortName - - Short name of the entity
    102. -
    103. - getStartLine - - Get the line number of the start of a class code in a file
    104. -
    105. - getThrows - - Get parsed throws from `throws` doc block
    106. -
    107. - getThrowsDocBlockLinks -
    108. -
    109. - getTraits - - Get a list of trait entities of the current class
    110. -
    111. - getTraitsNames - - Get a list of class traits names
    112. -
    113. - hasConstant - - Check if a constant exists in a class
    114. -
    115. - hasDescriptionLinks - - Checking if an entity has links in its description
    116. -
    117. - hasExamples - - Checking if an entity has `example` docBlock
    118. -
    119. - hasMethod - - Check if a method exists in a class
    120. -
    121. - hasParentClass - - Check if a certain parent class exists in a chain of parent classes
    122. -
    123. - hasProperty - - Check if a property exists in a class
    124. -
    125. - hasThrows - - Checking if an entity has `throws` docBlock
    126. -
    127. - hasTraits - - Check if the class contains traits
    128. -
    129. - implementsInterface - - Check if a class implements an interface
    130. -
    131. - isAbstract - - Check that an entity is abstract
    132. -
    133. - isApi - - Checking if an entity has `api` docBlock
    134. -
    135. - isClass - - Check if an entity is a Class
    136. -
    137. - isClassLoad -
    138. -
    139. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    140. -
    141. - isDocumentCreationAllowed -
    142. -
    143. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    144. -
    145. - isEntityDataCacheOutdated -
    146. -
    147. - isEntityDataCanBeLoaded -
    148. -
    149. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    150. -
    151. - isEntityNameValid - - Check if the name is a valid name for ClassLikeEntity
    152. -
    153. - isEnum - - Check if an entity is an Enum
    154. -
    155. - isExternalLibraryEntity - - Check if a given entity is an entity from a third party library (connected via composer)
    156. -
    157. - isInGit - - Checking if class file is in git repository
    158. -
    159. - isInstantiable - - Check that an entity is instantiable
    160. -
    161. - isInterface - - Check if an entity is an Interface
    162. -
    163. - isInternal - - Checking if an entity has `internal` docBlock
    164. -
    165. - isSubclassOf - - Whether the given class is a subclass of the specified class
    166. -
    167. - isTrait - - Check if an entity is a Trait
    168. -
    169. - normalizeClassName - - Bring the class name to the standard format used in the system
    170. -
    171. - reloadEntityDependenciesCache - - Update entity dependency cache
    172. -
    173. - removeEntityValueFromCache -
    174. -
    175. - removeNotUsedEntityDataCache -
    176. -
    177. - setCustomAst -
    178. -
    - - - - - - - -

    Method details:

    - -
    - - - +Object interface + +***Links:*** +- [https://www.php.net/manual/en/language.oop5.interfaces.php](https://www.php.net/manual/en/language.oop5.interfaces.php) + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [addPluginData](#maddplugindata) - Add information to aт entity object +1. [cursorToDocAttributeLinkFragment](#mcursortodocattributelinkfragment) +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getConstant](#mgetconstant) - Get the method entity by its name +1. [getConstantEntitiesCollection](#mgetconstantentitiescollection) - Get a collection of constant entities +1. [getConstantValue](#mgetconstantvalue) - Get the compiled value of a constant +1. [getConstants](#mgetconstants) - Get all constants that are available according to the configuration as an array +1. [getConstantsData](#mgetconstantsdata) - Get a list of all constants and classes where they are implemented +1. [getConstantsValues](#mgetconstantsvalues) - Get class constant compiled values according to filters +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getDocRender](#mgetdocrender) +1. [getEndLine](#mgetendline) - Get the line number of the end of a class code in a file +1. [getEntityDependencies](#mgetentitydependencies) +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getInterfaceNames](#mgetinterfacenames) - Get a list of class interface names +1. [getInterfacesEntities](#mgetinterfacesentities) - Get a list of interface entities that the current class implements +1. [getMethod](#mgetmethod) - Get the method entity by its name +1. [getMethodEntitiesCollection](#mgetmethodentitiescollection) - Get a collection of method entities +1. [getMethods](#mgetmethods) - Get all methods that are available according to the configuration as an array +1. [getMethodsData](#mgetmethodsdata) - Get a list of all methods and classes where they are implemented +1. [getModifiersString](#mgetmodifiersstring) - Get entity modifiers as a string +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Get the entity namespace name +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getParentClass](#mgetparentclass) - Get the entity of the parent class if it exists +1. [getParentClassEntities](#mgetparentclassentities) - Get a list of parent class entities +1. [getParentClassName](#mgetparentclassname) - Get the name of the parent class entity if it exists +1. [getParentClassNames](#mgetparentclassnames) - Get a list of entity names of parent classes +1. [getPluginData](#mgetplugindata) - Get additional information added using the plugin +1. [getProperties](#mgetproperties) - Get all properties that are available according to the configuration as an array +1. [getPropertiesData](#mgetpropertiesdata) - Get a list of all properties and classes where they are implemented +1. [getProperty](#mgetproperty) - Get the property entity by its name +1. [getPropertyDefaultValue](#mgetpropertydefaultvalue) - Get the compiled value of a property +1. [getPropertyEntitiesCollection](#mgetpropertyentitiescollection) - Get a collection of property entities +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getTraits](#mgettraits) - Get a list of trait entities of the current class +1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names +1. [hasConstant](#mhasconstant) - Check if a constant exists in a class +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasMethod](#mhasmethod) - Check if a method exists in a class +1. [hasParentClass](#mhasparentclass) - Check if a certain parent class exists in a chain of parent classes +1. [hasProperty](#mhasproperty) - Check if a property exists in a class +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [hasTraits](#mhastraits) - Check if the class contains traits +1. [implementsInterface](#mimplementsinterface) - Check if a class implements an interface +1. [isAbstract](#misabstract) - Check that an entity is abstract +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isClass](#misclass) - Check if an entity is a Class +1. [isClassLoad](#misclassload) +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isDocumentCreationAllowed](#misdocumentcreationallowed) +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isEntityNameValid](#misentitynamevalid) - Check if the name is a valid name for ClassLikeEntity +1. [isEnum](#misenum) - Check if an entity is an Enum +1. [isExternalLibraryEntity](#misexternallibraryentity) - Check if a given entity is an entity from a third party library (connected via composer) +1. [isInGit](#misingit) - Checking if class file is in git repository +1. [isInstantiable](#misinstantiable) - Check that an entity is instantiable +1. [isInterface](#misinterface) - Check if an entity is an Interface +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isSubclassOf](#missubclassof) - Whether the given class is a subclass of the specified class +1. [isTrait](#mistrait) - Check if an entity is a Trait +1. [normalizeClassName](#mnormalizeclassname) - Bring the class name to the standard format used in the system +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) +1. [setCustomAst](#msetcustomast) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L51) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection $entitiesCollection, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper $composerHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $className, string|null $relativeFileName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$entitiesCollection | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$composerHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ComposerHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$relativeFileName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $entitiesCollection\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $composerHelper\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $classNamestring-
    $relativeFileNamestring | null-
    - - - -
    -
    -
    - - +--- +# `addPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function addPluginData(string $pluginKey, mixed $data): void; ``` +Add information to aт entity object -
    Add information to aт entity object
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$data | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    $datamixed-
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Return value: void - - -
    -
    -
    - -
      -
    • # - cursorToDocAttributeLinkFragment - :warning: Is internal | source code
    • -
    +--- +# `cursorToDocAttributeLinkFragment` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1286) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function cursorToDocAttributeLinkFragment(string $cursor, bool $isForDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $cursorstring-
    $isForDocumentbool-
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L296) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getAst(): \PhpParser\Node\Stmt\Class_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\Class_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ - +***Return value:*** [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) | [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) | [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) -Throws: - - -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L806) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstant(string $constantName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant whose entity you want to get
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity - - -Throws: - - -
    -
    -
    - - +--- +# `getConstantEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L736) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection; ``` +Get a collection of constant entities -
    Get a collection of constant entities
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +--- -Throws: - - - -See: - -
    -
    -
    - - - +# `getConstantValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L829) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantValue(string $constantName): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant for which you need to get the value
    - -Return value: string | array | int | bool | null | float - - -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant for which you need to get the value | -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) - +--- +# `getConstants` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L765) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstants(): array; ``` +Get all constants that are available according to the configuration as an array -
    Get all constants that are available according to the configuration as an array
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) -Return value: array - - -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getConstantsData - :warning: Is internal | source code
    • -
    +--- +# `getConstantsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L661) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all constants and classes where they are implemented -
    Get a list of all constants and classes where they are implemented
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for constants corresponding to the visibility modifiers passed in this value | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for constants from the current class
    $flagsintGet data only for constants corresponding to the visibility modifiers passed in this value
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getConstantsValues` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L849) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantsValues(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get class constant compiled values according to filters -
    Get class constant compiled values according to filters
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet values only for constants from the current class
    $flagsintGet values only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get values only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get values only for constants corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    +--- +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    +***Return value:*** [\phpDocumentor\Reflection\DocBlock](https://github.com/phpDocumentor/ReflectionDocBlock/blob/master/src/DocBlock.php) -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    - +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L236) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) -Parameters: not specified - -Return value: null | int - - -Throws: - - -
    -
    -
    - - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getDocRender` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1262) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getDocRender(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRendererInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface - - -Throws: - - -
    -
    -
    - - - +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L469) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getEndLine(): int; ``` +Get the line number of the end of a class code in a file -
    Get the line number of the end of a class code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1035) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    - +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L370) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -
    -
    -
    - - +--- +# `getInterfaceNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L530) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getInterfaceNames(): array; ``` +Get a list of class interface names -
    Get a list of class interface names
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getInterfacesEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L587) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getInterfacesEntities(): array; ``` +Get a list of interface entities that the current class implements -
    Get a list of interface entities that the current class implements
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1203) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethod(string $methodName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to get
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity - - -Throws: - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) -
    -
    -
    - - +--- +# `getMethodEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1133) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethodEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; ``` +Get a collection of method entities -
    Get a collection of method entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection - - -Throws: - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) -See: - -
    -
    -
    - - +--- +# `getMethods` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1162) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethods(): array; ``` +Get all methods that are available according to the configuration as an array -
    Get all methods that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - - -Throws: - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) -See: - -
    -
    -
    - -
      -
    • # - getMethodsData - :warning: Is internal | source code
    • -
    +--- +# `getMethodsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1059) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethodsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all methods and classes where they are implemented -
    Get a list of all methods and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for methods from the current class
    $flagsintGet data only for methods corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for methods from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for methods corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/InterfaceEntity.php#L33) ```php public function getModifiersString(): string; ``` +Get entity modifiers as a string -
    Get entity modifiers as a string
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L378) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L397) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getNamespaceName(): string; ``` +Get the entity namespace name -
    Get the entity namespace name
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L142) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L516) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClass(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the entity of the parent class if it exists -
    Get the entity of the parent class if it exists
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - +--- +# `getParentClassEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClassEntities(): array; ``` +Get a list of parent class entities -
    Get a list of parent class entities
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -
    -
    -
    - - +--- +# `getParentClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L506) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClassName(): null|string; ``` +Get the name of the parent class entity if it exists -
    Get the name of the parent class entity if it exists
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string - - -
    -
    -
    - - +--- +# `getParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L481) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClassNames(): array; ``` +Get a list of entity names of parent classes -
    Get a list of entity names of parent classes
    - -Parameters: not specified - -Return value: array - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L270) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPluginData(string $pluginKey): mixed; ``` +Get additional information added using the plugin -
    Get additional information added using the plugin
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) -Return value: mixed - - -
    -
    -
    - - +--- +# `getProperties` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L963) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getProperties(): array; ``` +Get all properties that are available according to the configuration as an array -
    Get all properties that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - - -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getPropertiesData - :warning: Is internal | source code
    • -
    +--- +# `getPropertiesData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L872) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertiesData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all properties and classes where they are implemented -
    Get a list of all properties and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for properties from the current class
    $flagsintGet data only for properties corresponding to the visibility modifiers passed in this value
    - -Return value: array - - -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for properties from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for properties corresponding to the visibility modifiers passed in this value | -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1004) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getProperty(string $propertyName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; ``` +Get the property entity by its name -
    Get the property entity by its name
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to get
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php) -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity - - -Throws: - - -
    -
    -
    - - +--- +# `getPropertyDefaultValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1027) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertyDefaultValue(string $propertyName): string|array|int|bool|null|float; ``` +Get the compiled value of a property -
    Get the compiled value of a property
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property for which you need to get the value
    +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property for which you need to get the value | -Return value: string | array | int | bool | null | float +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) +--- -Throws: - - -
    -
    -
    - - - +# `getPropertyEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L934) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertyEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection; ``` +Get a collection of property entities -
    Get a collection of property entities
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +--- -Throws: - - - -See: - -
    -
    -
    - - - +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L412) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) +--- - -See: - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L160) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -
    -
    -
    - - +--- +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L386) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L457) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getStartLine(): int; ``` +Get the line number of the start of a class code in a file -
    Get the line number of the start of a class code in a file
    - -Parameters: not specified - -Return value: int - - -Throws: - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -
    -
    -
    - - +--- +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getTraits(): array; ``` +Get a list of trait entities of the current class -
    Get a list of trait entities of the current class
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getTraitsNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/InterfaceEntity.php#L41) ```php public function getTraitsNames(): array; ``` +Get a list of class traits names -
    Get a list of class traits names
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `hasConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L785) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasConstant(string $constantName, bool $unsafe = false): bool; ``` +Check if a constant exists in a class -
    Check if a constant exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the class whose entity you want to check
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    - -Return value: bool - - -Throws: -
      -
    • - \DI\DependencyException
    • +***Parameters:*** -
    • - \DI\NotFoundException
    • +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the class whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | -
    • - \BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException
    • +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    - -
    -
    -
    - - +--- +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `hasMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1182) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasMethod(string $methodName, bool $unsafe = false): bool; ``` +Check if a method exists in a class -
    Check if a method exists in a class
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to check
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `hasParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1250) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasParentClass(string $parentClassName): bool; ``` +Check if a certain parent class exists in a chain of parent classes -
    Check if a certain parent class exists in a chain of parent classes
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamestringSearched parent class
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$parentClassName | [string](https://www.php.net/manual/en/language.types.string.php) | Searched parent class | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L983) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasProperty(string $propertyName, bool $unsafe = false): bool; ``` +Check if a property exists in a class -
    Check if a property exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to check
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: bool - - -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L644) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasTraits(): bool; ``` +Check if the class contains traits -
    Check if the class contains traits
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `implementsInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1237) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function implementsInterface(string $interfaceName): bool; ``` +Check if a class implements an interface -
    Check if a class implements an interface
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfaceNamestringName of the required interface in the interface chain
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$interfaceName | [string](https://www.php.net/manual/en/language.types.string.php) | Name of the required interface in the interface chain | -Throws: - - -
    -
    -
    - - +--- +# `isAbstract` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/InterfaceEntity.php#L25) ```php public function isAbstract(): bool; ``` +Check that an entity is abstract -
    Check that an entity is abstract
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isClass(): bool; ``` +Check if an entity is a Class -
    Check if an entity is a Class
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isClassLoad` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L343) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isClassLoad(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - -
      -
    • # - isDocumentCreationAllowed - :warning: Is internal | source code
    • -
    +--- +# `isDocumentCreationAllowed` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L224) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isDocumentCreationAllowed(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L358) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isEntityDataCanBeLoaded(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L84) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public static function isEntityNameValid(string $entityName): bool; ``` +Check if the name is a valid name for ClassLikeEntity -
    Check if the name is a valid name for ClassLikeEntity
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isEnum` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L134) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isEnum(): bool; ``` +Check if an entity is an Enum -
    Check if an entity is an Enum
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - -
      -
    • # - isExternalLibraryEntity - :warning: Is internal | source code
    • -
    - +# `isExternalLibraryEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L152) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isExternalLibraryEntity(): bool; ``` +Check if a given entity is an entity from a third party library (connected via composer) -
    Check if a given entity is an entity from a third party library (connected via composer)
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInGit` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L205) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInGit(): bool; ``` +Checking if class file is in git repository -
    Checking if class file is in git repository
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L435) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInstantiable(): bool; ``` +Check that an entity is instantiable -
    Check that an entity is instantiable
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/InterfaceEntity.php#L17) ```php public function isInterface(): bool; ``` +Check if an entity is an Interface -
    Check if an entity is an Interface
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isSubclassOf` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1219) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isSubclassOf(string $className): bool; ``` +Whether the given class is a subclass of the specified class -
    Whether the given class is a subclass of the specified class
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classNamestring-
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Throws: - - -
    -
    -
    - - +--- +# `isTrait` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L124) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isTrait(): bool; ``` +Check if an entity is a Trait -
    Check if an entity is a Trait
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L94) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public static function normalizeClassName(string $name): string; ``` +Bring the class name to the standard format used in the system -
    Bring the class name to the standard format used in the system
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    +***Parameters:*** -Return value: string +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - - - +# `setCustomAst` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L284) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function setCustomAst(\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Class_|null $customAst): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$customAst | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) \| [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) \| [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) \| [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $customAst\PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Class_ | null-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/InvalidConfigurationParameterException.md b/docs/tech/02_parser/classes/InvalidConfigurationParameterException.md deleted file mode 100644 index 57e5652d..00000000 --- a/docs/tech/02_parser/classes/InvalidConfigurationParameterException.md +++ /dev/null @@ -1,31 +0,0 @@ - BumbleDocGen / Technical description of the project / Parser / InvalidConfigurationParameterException
    - -

    - InvalidConfigurationParameterException class: -

    - - - - - -```php -namespace BumbleDocGen\Core\Configuration\Exception; - -final class InvalidConfigurationParameterException extends \Exception -``` - - - - - - - - - - - - - - - - diff --git a/docs/tech/02_parser/classes/IsPrivateCondition.md b/docs/tech/02_parser/classes/IsPrivateCondition.md index 46e5ef0f..27ca44a1 100644 --- a/docs/tech/02_parser/classes/IsPrivateCondition.md +++ b/docs/tech/02_parser/classes/IsPrivateCondition.md @@ -1,105 +1,48 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / IsPrivateCondition
    - -

    - IsPrivateCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +IsPrivateCondition +--- +# [IsPrivateCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/ClassConstantFilterCondition/IsPrivateCondition.php#L14) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\FilterCondition\ClassConstantFilterCondition; final class IsPrivateCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Check is a private constant or not -
    Check is a private constant or not
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/ClassConstantFilterCondition/IsPrivateCondition.php#L18) ```php public function __construct(); ``` +--- - -Parameters: not specified - - - -
    -
    -
    - - - +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/ClassConstantFilterCondition/IsPrivateCondition.php#L23) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/IsPrivateCondition_2.md b/docs/tech/02_parser/classes/IsPrivateCondition_2.md index 301bd358..92a10b6c 100644 --- a/docs/tech/02_parser/classes/IsPrivateCondition_2.md +++ b/docs/tech/02_parser/classes/IsPrivateCondition_2.md @@ -1,105 +1,48 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / IsPrivateCondition
    - -

    - IsPrivateCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +IsPrivateCondition +--- +# [IsPrivateCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/MethodFilterCondition/IsPrivateCondition.php#L14) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\FilterCondition\MethodFilterCondition; final class IsPrivateCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Check is a private method or not -
    Check is a private method or not
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/MethodFilterCondition/IsPrivateCondition.php#L18) ```php public function __construct(); ``` +--- - -Parameters: not specified - - - -
    -
    -
    - - - +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/MethodFilterCondition/IsPrivateCondition.php#L23) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/IsPrivateCondition_3.md b/docs/tech/02_parser/classes/IsPrivateCondition_3.md index 22861f3d..a566f9fa 100644 --- a/docs/tech/02_parser/classes/IsPrivateCondition_3.md +++ b/docs/tech/02_parser/classes/IsPrivateCondition_3.md @@ -1,105 +1,48 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / IsPrivateCondition
    - -

    - IsPrivateCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +IsPrivateCondition +--- +# [IsPrivateCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/PropertyFilterCondition/IsPrivateCondition.php#L14) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\FilterCondition\PropertyFilterCondition; final class IsPrivateCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Check is a private property or not -
    Check is a private property or not
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/PropertyFilterCondition/IsPrivateCondition.php#L18) ```php public function __construct(); ``` +--- - -Parameters: not specified - - - -
    -
    -
    - - - +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/PropertyFilterCondition/IsPrivateCondition.php#L23) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/IsProtectedCondition.md b/docs/tech/02_parser/classes/IsProtectedCondition.md index d8db64d7..968cd669 100644 --- a/docs/tech/02_parser/classes/IsProtectedCondition.md +++ b/docs/tech/02_parser/classes/IsProtectedCondition.md @@ -1,105 +1,48 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / IsProtectedCondition
    - -

    - IsProtectedCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +IsProtectedCondition +--- +# [IsProtectedCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/ClassConstantFilterCondition/IsProtectedCondition.php#L14) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\FilterCondition\ClassConstantFilterCondition; final class IsProtectedCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Check is a protected constant or not -
    Check is a protected constant or not
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/ClassConstantFilterCondition/IsProtectedCondition.php#L18) ```php public function __construct(); ``` +--- - -Parameters: not specified - - - -
    -
    -
    - - - +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/ClassConstantFilterCondition/IsProtectedCondition.php#L23) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/IsProtectedCondition_2.md b/docs/tech/02_parser/classes/IsProtectedCondition_2.md index 315db5e9..276e0a64 100644 --- a/docs/tech/02_parser/classes/IsProtectedCondition_2.md +++ b/docs/tech/02_parser/classes/IsProtectedCondition_2.md @@ -1,105 +1,48 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / IsProtectedCondition
    - -

    - IsProtectedCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +IsProtectedCondition +--- +# [IsProtectedCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/MethodFilterCondition/IsProtectedCondition.php#L14) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\FilterCondition\MethodFilterCondition; final class IsProtectedCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Check is a protected method or not -
    Check is a protected method or not
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/MethodFilterCondition/IsProtectedCondition.php#L18) ```php public function __construct(); ``` +--- - -Parameters: not specified - - - -
    -
    -
    - - - +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/MethodFilterCondition/IsProtectedCondition.php#L23) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/IsProtectedCondition_3.md b/docs/tech/02_parser/classes/IsProtectedCondition_3.md index 78bda0ec..0b790cf3 100644 --- a/docs/tech/02_parser/classes/IsProtectedCondition_3.md +++ b/docs/tech/02_parser/classes/IsProtectedCondition_3.md @@ -1,105 +1,48 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / IsProtectedCondition
    - -

    - IsProtectedCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +IsProtectedCondition +--- +# [IsProtectedCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/PropertyFilterCondition/IsProtectedCondition.php#L14) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\FilterCondition\PropertyFilterCondition; final class IsProtectedCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Check is a protected property or not -
    Check is a protected property or not
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/PropertyFilterCondition/IsProtectedCondition.php#L18) ```php public function __construct(); ``` +--- - -Parameters: not specified - - - -
    -
    -
    - - - +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/PropertyFilterCondition/IsProtectedCondition.php#L23) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/IsPublicCondition.md b/docs/tech/02_parser/classes/IsPublicCondition.md index e93c169f..92386e8e 100644 --- a/docs/tech/02_parser/classes/IsPublicCondition.md +++ b/docs/tech/02_parser/classes/IsPublicCondition.md @@ -1,105 +1,48 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / IsPublicCondition
    - -

    - IsPublicCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +IsPublicCondition +--- +# [IsPublicCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/ClassConstantFilterCondition/IsPublicCondition.php#L14) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\FilterCondition\ClassConstantFilterCondition; final class IsPublicCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Check is a public constant or not -
    Check is a public constant or not
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/ClassConstantFilterCondition/IsPublicCondition.php#L18) ```php public function __construct(); ``` +--- - -Parameters: not specified - - - -
    -
    -
    - - - +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/ClassConstantFilterCondition/IsPublicCondition.php#L23) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/IsPublicCondition_2.md b/docs/tech/02_parser/classes/IsPublicCondition_2.md index 3333cc43..d5a3b5af 100644 --- a/docs/tech/02_parser/classes/IsPublicCondition_2.md +++ b/docs/tech/02_parser/classes/IsPublicCondition_2.md @@ -1,105 +1,48 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / IsPublicCondition
    - -

    - IsPublicCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +IsPublicCondition +--- +# [IsPublicCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/MethodFilterCondition/IsPublicCondition.php#L14) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\FilterCondition\MethodFilterCondition; final class IsPublicCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Check is a public method or not -
    Check is a public method or not
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/MethodFilterCondition/IsPublicCondition.php#L18) ```php public function __construct(); ``` +--- - -Parameters: not specified - - - -
    -
    -
    - - - +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/MethodFilterCondition/IsPublicCondition.php#L23) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/IsPublicCondition_3.md b/docs/tech/02_parser/classes/IsPublicCondition_3.md index cd3693ef..94df41ce 100644 --- a/docs/tech/02_parser/classes/IsPublicCondition_3.md +++ b/docs/tech/02_parser/classes/IsPublicCondition_3.md @@ -1,105 +1,48 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / IsPublicCondition
    - -

    - IsPublicCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +IsPublicCondition +--- +# [IsPublicCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/PropertyFilterCondition/IsPublicCondition.php#L14) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\FilterCondition\PropertyFilterCondition; final class IsPublicCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Check is a public property or not -
    Check is a public property or not
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/PropertyFilterCondition/IsPublicCondition.php#L18) ```php public function __construct(); ``` +--- - -Parameters: not specified - - - -
    -
    -
    - - - +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/PropertyFilterCondition/IsPublicCondition.php#L23) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/LocatedInCondition.md b/docs/tech/02_parser/classes/LocatedInCondition.md index 0d42026c..2a66b34a 100644 --- a/docs/tech/02_parser/classes/LocatedInCondition.md +++ b/docs/tech/02_parser/classes/LocatedInCondition.md @@ -1,139 +1,56 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / LocatedInCondition
    - -

    - LocatedInCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +LocatedInCondition +--- +# [LocatedInCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/CommonFilterCondition/LocatedInCondition.php#L16) class: ```php namespace BumbleDocGen\Core\Parser\FilterCondition\CommonFilterCondition; final class LocatedInCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Checking the existence of an entity in the specified directories -
    Checking the existence of an entity in the specified directories
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/CommonFilterCondition/LocatedInCondition.php#L18) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Configuration\ConfigurationParameterBag $parameterBag, array $directories = []); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$parameterBag | [\BumbleDocGen\Core\Configuration\ConfigurationParameterBag](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/ConfigurationParameterBag.php) | - | +$directories | [array](https://www.php.net/manual/en/language.types.array.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $parameterBag\BumbleDocGen\Core\Configuration\ConfigurationParameterBag-
    $directoriesarray-
    - - - -
    -
    -
    - - +--- +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/CommonFilterCondition/LocatedInCondition.php#L28) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/LocatedNotInCondition.md b/docs/tech/02_parser/classes/LocatedNotInCondition.md index 31d91c10..d55a8bbf 100644 --- a/docs/tech/02_parser/classes/LocatedNotInCondition.md +++ b/docs/tech/02_parser/classes/LocatedNotInCondition.md @@ -1,139 +1,56 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / LocatedNotInCondition
    - -

    - LocatedNotInCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +LocatedNotInCondition +--- +# [LocatedNotInCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/CommonFilterCondition/LocatedNotInCondition.php#L16) class: ```php namespace BumbleDocGen\Core\Parser\FilterCondition\CommonFilterCondition; final class LocatedNotInCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Checking the existence of an entity not in the specified directories -
    Checking the existence of an entity not in the specified directories
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/CommonFilterCondition/LocatedNotInCondition.php#L18) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Configuration\ConfigurationParameterBag $parameterBag, array $directories = []); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$parameterBag | [\BumbleDocGen\Core\Configuration\ConfigurationParameterBag](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/ConfigurationParameterBag.php) | - | +$directories | [array](https://www.php.net/manual/en/language.types.array.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $parameterBag\BumbleDocGen\Core\Configuration\ConfigurationParameterBag-
    $directoriesarray-
    - - - -
    -
    -
    - - +--- +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/CommonFilterCondition/LocatedNotInCondition.php#L28) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/MethodEntitiesCollection.md b/docs/tech/02_parser/classes/MethodEntitiesCollection.md index dd2a9b0e..9d3c00a7 100644 --- a/docs/tech/02_parser/classes/MethodEntitiesCollection.md +++ b/docs/tech/02_parser/classes/MethodEntitiesCollection.md @@ -1,466 +1,192 @@ - BumbleDocGen / Technical description of the project / Parser / Entities and entities collections / MethodEntitiesCollection
    - -

    - MethodEntitiesCollection class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +MethodEntitiesCollection +--- +# [MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php#L22) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method; final class MethodEntitiesCollection extends \BumbleDocGen\Core\Parser\Entity\BaseEntityCollection implements \IteratorAggregate ``` +Collection of PHP class method entities -
    Collection of PHP class method entities
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - add - - Add an entity to a collection
    2. -
    3. - get - - Get the loaded method entity if it exists
    4. -
    5. - getAllExceptInitializations - - Get a copy of the collection containing only those methods that are not initialization methods
    6. -
    7. - getInitializations - - Get a copy of the collection containing only those methods that are initialization methods
    8. -
    9. - getIterator -
    10. -
    11. - has - - Check if an entity has been added to the collection
    12. -
    13. - isEmpty - - Check if the collection is empty or not
    14. -
    15. - loadMethodEntities - - Load method entities into the collection according to the project configuration
    16. -
    17. - remove - - Remove an entity from a collection
    18. -
    19. - unsafeGet - - Get the method entity if it exists. If the method exists but has not been loaded into the collection, a new entity object will be created
    20. -
    - - - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [add](#madd) - Add an entity to a collection +1. [get](#mget) - Get the loaded method entity if it exists +1. [getAllExceptInitializations](#mgetallexceptinitializations) - Get a copy of the collection containing only those methods that are not initialization methods +1. [getInitializations](#mgetinitializations) - Get a copy of the collection containing only those methods that are initialization methods +1. [getIterator](#mgetiterator) +1. [has](#mhas) - Check if an entity has been added to the collection +1. [isEmpty](#misempty) - Check if the collection is empty or not +1. [loadMethodEntities](#mloadmethodentities) - Load method entities into the collection according to the project configuration +1. [remove](#mremove) - Remove an entity from a collection +1. [unsafeGet](#munsafeget) - Get the method entity if it exists. If the method exists but has not been loaded into the collection, a new entity object will be created -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php#L26) ```php public function __construct(\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity $classEntity, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory $cacheablePhpEntityFactory, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$classEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$cacheablePhpEntityFactory | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/Cache/CacheablePhpEntityFactory.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $cacheablePhpEntityFactory\BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `add` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php#L82) ```php public function add(\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntityInterface $methodEntity, bool $reload = false): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; ``` +Add an entity to a collection -
    Add an entity to a collection
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntityInterfaceEntity to be added to the collection
    $reloadboolReplace an entity with a new one if one has already been loaded previously
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection - - -
    -
    -
    - - +***Parameters:*** -```php -public function get(string $objectName): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; -``` +| Name | Type | Description | +|:-|:-|:-| +$methodEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntityInterface.php) | Entity to be added to the collection | +$reload | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Replace an entity with a new one if one has already been loaded previously | -
    Get the loaded method entity if it exists
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) -Parameters: +--- - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestringMethod entity name
    +# `get` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php#L98) +```php +public function get(string $objectName): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; +``` +Get the loaded method entity if it exists -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | Method entity name | -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) - +--- +# `getAllExceptInitializations` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php#L162) ```php public function getAllExceptInitializations(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; ``` +Get a copy of the collection containing only those methods that are not initialization methods -
    Get a copy of the collection containing only those methods that are not initialization methods
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection - - -
    -
    -
    - - +--- +# `getInitializations` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php#L140) ```php public function getInitializations(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; ``` +Get a copy of the collection containing only those methods that are initialization methods -
    Get a copy of the collection containing only those methods that are initialization methods
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) -
    -
    -
    - - +--- +# `getIterator` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L11) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function getIterator(): \Generator; ``` +***Return value:*** [\Generator](https://www.php.net/manual/en/language.generators.overview.php) +--- -Parameters: not specified - -Return value: \Generator - - -
    -
    -
    - - - +# `has` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L42) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function has(string $objectName): bool; ``` +Check if an entity has been added to the collection -
    Check if an entity has been added to the collection
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isEmpty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L52) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function isEmpty(): bool; ``` +Check if the collection is empty or not -
    Check if the collection is empty or not
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - -
      -
    • # - loadMethodEntities - :warning: Is internal | source code
    • -
    +--- +# `loadMethodEntities` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php#L45) ```php public function loadMethodEntities(): void; ``` +Load method entities into the collection according to the project configuration -
    Load method entities into the collection according to the project configuration
    - -Parameters: not specified - -Return value: void +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) -Throws: - - - -See: - -
    -
    -
    - - +--- +# `remove` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L32) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function remove(string $objectName): void; ``` +Remove an entity from a collection -
    Remove an entity from a collection
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    +***Parameters:*** -Return value: void +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - - +--- +# `unsafeGet` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php#L114) ```php public function unsafeGet(string $objectName): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Get the method entity if it exists. If the method exists but has not been loaded into the collection, a new entity object will be created -
    Get the method entity if it exists. If the method exists but has not been loaded into the collection, a new entity object will be created
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestringMethod entity name
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity - - -Throws: - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/MethodEntity.md b/docs/tech/02_parser/classes/MethodEntity.md index abc48f0e..88796e0c 100644 --- a/docs/tech/02_parser/classes/MethodEntity.md +++ b/docs/tech/02_parser/classes/MethodEntity.md @@ -1,1777 +1,731 @@ - BumbleDocGen / Technical description of the project / Parser / Entities and entities collections / MethodEntity
    - -

    - MethodEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +MethodEntity +--- +# [MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L31) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method; class MethodEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity implements \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface, \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface ``` - -
    Class method entity
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    2. -
    3. - getAst - - Get AST for this entity
    4. -
    5. - getBodyCode - - Get the code for this method
    6. -
    7. - getCacheKey -
    8. -
    9. - getCachedEntityDependencies -
    10. -
    11. - getCurrentRootEntity -
    12. -
    13. - getDescription - - Get entity description
    14. -
    15. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    16. -
    17. - getDocBlock - - Get DocBlock for current entity
    18. -
    19. - getDocComment - - Get the doc comment of an entity
    20. -
    21. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    22. -
    23. - getDocCommentLine -
    24. -
    25. - getDocNote - - Get the note annotation value
    26. -
    27. - getEndLine - - Get the line number of the end of a method's code in a file
    28. -
    29. - getExamples - - Get parsed examples from `examples` doc block
    30. -
    31. - getFileSourceLink -
    32. -
    33. - getFirstExample - - Get first example from `examples` doc block
    34. -
    35. - getFirstReturnValue - - Get the compiled first return value of a method (if possible)
    36. -
    37. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    38. -
    39. - getImplementingClassName - - Get the name of the class in which this method is implemented
    40. -
    41. - getModifiersString - - Get a text representation of method modifiers
    42. -
    43. - getName - - Full name of the entity
    44. -
    45. - getNamespaceName - - Namespace of the class that contains this method
    46. -
    47. - getObjectId - - Get entity unique ID
    48. -
    49. - getParameters - - Get a list of method parameters
    50. -
    51. - getParametersString - - Get a list of method parameters as a string
    52. -
    53. - getParentMethod - - Get the parent method for this method
    54. -
    55. - getRelativeFileName - - File name relative to project_root configuration parameter
    56. -
    57. - getReturnType - - Get the return type of method
    58. -
    59. - getRootEntity -
    60. -
    61. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    62. -
    63. - getShortName - - Short name of the entity
    64. -
    65. - getSignature - - Get the method signature as a string
    66. -
    67. - getStartColumn - - Get the column number of the beginning of the method code in a file
    68. -
    69. - getStartLine - - Get the line number of the beginning of the entity code in a file
    70. -
    71. - getThrows - - Get parsed throws from `throws` doc block
    72. -
    73. - getThrowsDocBlockLinks -
    74. -
    75. - hasDescriptionLinks - - Checking if an entity has links in its description
    76. -
    77. - hasExamples - - Checking if an entity has `example` docBlock
    78. -
    79. - hasThrows - - Checking if an entity has `throws` docBlock
    80. -
    81. - isApi - - Checking if an entity has `api` docBlock
    82. -
    83. - isConstructor - - Checking that a method is a constructor
    84. -
    85. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    86. -
    87. - isDynamic - - Check if a method is a dynamic method, that is, implementable using __call or __callStatic
    88. -
    89. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    90. -
    91. - isEntityDataCacheOutdated -
    92. -
    93. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    94. -
    95. - isImplementedInParentClass - - Check if this method is implemented in the parent class
    96. -
    97. - isInitialization - - Check if a method is an initialization method
    98. -
    99. - isInternal - - Checking if an entity has `internal` docBlock
    100. -
    101. - isPrivate - - Check if a method is a private method
    102. -
    103. - isProtected - - Check if a method is a protected method
    104. -
    105. - isPublic - - Check if a method is a public method
    106. -
    107. - isStatic - - Check if this method is static
    108. -
    109. - reloadEntityDependenciesCache - - Update entity dependency cache
    110. -
    111. - removeEntityValueFromCache -
    112. -
    113. - removeNotUsedEntityDataCache -
    114. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Class method entity + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getBodyCode](#mgetbodycode) - Get the code for this method +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getEndLine](#mgetendline) - Get the line number of the end of a method's code in a file +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getFirstReturnValue](#mgetfirstreturnvalue) - Get the compiled first return value of a method (if possible) +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getImplementingClassName](#mgetimplementingclassname) - Get the name of the class in which this method is implemented +1. [getModifiersString](#mgetmodifiersstring) - Get a text representation of method modifiers +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Namespace of the class that contains this method +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getParameters](#mgetparameters) - Get a list of method parameters +1. [getParametersString](#mgetparametersstring) - Get a list of method parameters as a string +1. [getParentMethod](#mgetparentmethod) - Get the parent method for this method +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getReturnType](#mgetreturntype) - Get the return type of method +1. [getRootEntity](#mgetrootentity) +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getSignature](#mgetsignature) - Get the method signature as a string +1. [getStartColumn](#mgetstartcolumn) - Get the column number of the beginning of the method code in a file +1. [getStartLine](#mgetstartline) - Get the line number of the beginning of the entity code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isConstructor](#misconstructor) - Checking that a method is a constructor +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isDynamic](#misdynamic) - Check if a method is a dynamic method, that is, implementable using __call or __callStatic +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isImplementedInParentClass](#misimplementedinparentclass) - Check if this method is implemented in the parent class +1. [isInitialization](#misinitialization) - Check if a method is an initialization method +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isPrivate](#misprivate) - Check if a method is a private method +1. [isProtected](#misprotected) - Check if a method is a protected method +1. [isPublic](#mispublic) - Check if a method is a public method +1. [isStatic](#misstatic) - Check if this method is static +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L55) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity $classEntity, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \PhpParser\PrettyPrinter\Standard $astPrinter, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $methodName, string $implementingClassName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$classEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$astPrinter | [\PhpParser\PrettyPrinter\Standard](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/PrettyPrinter/Standard.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$implementingClassName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $classEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $astPrinter\PhpParser\PrettyPrinter\Standard-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $methodNamestring-
    $implementingClassNamestring-
    - - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L78) ```php public function getAst(): \PhpParser\Node\Stmt\ClassMethod; ``` +Get AST for this entity -
    Get AST for this entity
    +***Return value:*** [\PhpParser\Node\Stmt\ClassMethod](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/ClassMethod.php) -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\ClassMethod - - -Throws: - - -
    -
    -
    - - +--- +# `getBodyCode` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L545) ```php public function getBodyCode(): string; ``` +Get the code for this method -
    Get the code for this method
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    - +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Throws: - - -
    -
    -
    - - - +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    - -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    +--- +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L142) ```php public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity - - -
    -
    -
    - - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L200) ```php public function getDocCommentLine(): null|int; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) +--- -Parameters: not specified - -Return value: null | int - - -Throws: - - -
    -
    -
    - - - +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L518) ```php public function getEndLine(): int; ``` +Get the line number of the end of a method's code in a file -
    Get the line number of the end of a method's code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -
    -
    -
    - - +--- +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    +--- +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -Throws: - - -
    -
    -
    - - - +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getFirstReturnValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L529) ```php public function getFirstReturnValue(): mixed; ``` +Get the compiled first return value of a method (if possible) -
    Get the compiled first return value of a method (if possible)
    - -Parameters: not specified - -Return value: mixed - - -
    -
    -
    +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L106) ```php public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) - +--- +# `getImplementingClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L414) ```php public function getImplementingClassName(): string; ``` +Get the name of the class in which this method is implemented -
    Get the name of the class in which this method is implemented
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -
    -
    -
    - - +--- +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L242) ```php public function getModifiersString(): string; ``` +Get a text representation of method modifiers -
    Get a text representation of method modifiers
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L114) ```php public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L130) ```php public function getNamespaceName(): string; ``` +Namespace of the class that contains this method -
    Namespace of the class that contains this method
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L185) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getParameters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L300) ```php public function getParameters(): array; ``` +Get a list of method parameters -
    Get a list of method parameters
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - - +--- +# `getParametersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L392) ```php public function getParametersString(): string; ``` +Get a list of method parameters as a string -
    Get a list of method parameters as a string
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getParentMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L184) ```php public function getParentMethod(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Get the parent method for this method -
    Get the parent method for this method
    - -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity - - -Throws: - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) - +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L232) ```php public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) -Return value: null | string - - - -See: - -
    -
    -
    - - +--- +# `getReturnType` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L269) ```php public function getReturnType(): string; ``` +Get the return type of method -
    Get the return type of method
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getRootEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L90) ```php public function getRootEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L98) ```php public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) +--- -
    -
    -
    - - - +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L122) ```php public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getSignature` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L212) ```php public function getSignature(): string; ``` +Get the method signature as a string -
    Get the method signature as a string
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getStartColumn` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L508) ```php public function getStartColumn(): int; ``` +Get the column number of the beginning of the method code in a file -
    Get the column number of the beginning of the method code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -
    -
    -
    - - +--- +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L498) ```php public function getStartLine(): int; ``` +Get the line number of the beginning of the entity code in a file -
    Get the line number of the beginning of the entity code in a file
    - -Parameters: not specified - -Return value: int - - -
    -
    -
    +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) - +--- +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isConstructor` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L222) ```php public function isConstructor(): bool; ``` +Checking that a method is a constructor -
    Checking that a method is a constructor
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isDynamic` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L448) ```php public function isDynamic(): bool; ``` +Check if a method is a dynamic method, that is, implementable using __call or __callStatic -
    Check if a method is a dynamic method, that is, implementable using __call or __callStatic
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isImplementedInParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L406) ```php public function isImplementedInParentClass(): bool; ``` +Check if this method is implemented in the parent class -
    Check if this method is implemented in the parent class
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isInitialization` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L426) ```php public function isInitialization(): bool; ``` +Check if a method is an initialization method -
    Check if a method is an initialization method
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isPrivate` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L488) ```php public function isPrivate(): bool; ``` +Check if a method is a private method -
    Check if a method is a private method
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isProtected` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L478) ```php public function isProtected(): bool; ``` +Check if a method is a protected method -
    Check if a method is a protected method
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isPublic` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L458) ```php public function isPublic(): bool; ``` +Check if a method is a public method -
    Check if a method is a public method
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isStatic` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L468) ```php public function isStatic(): bool; ``` +Check if this method is static -
    Check if this method is static
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Return value: void - - -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition.md b/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition.md index dfcd5eb3..0901bb75 100644 --- a/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition.md +++ b/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition.md @@ -1,78 +1,38 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / OnlyFromCurrentClassCondition
    - -

    - OnlyFromCurrentClassCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +OnlyFromCurrentClassCondition +--- +# [OnlyFromCurrentClassCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/MethodFilterCondition/OnlyFromCurrentClassCondition.php#L14) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\FilterCondition\MethodFilterCondition; final class OnlyFromCurrentClassCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Only methods that belong to the current class (not parent) -
    Only methods that belong to the current class (not parent)
    - - - - - - - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - - - - -

    Method details:

    - -
    - - - +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/MethodFilterCondition/OnlyFromCurrentClassCondition.php#L16) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition_2.md b/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition_2.md index 6ca28f92..a212ea6b 100644 --- a/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition_2.md +++ b/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition_2.md @@ -1,78 +1,38 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / OnlyFromCurrentClassCondition
    - -

    - OnlyFromCurrentClassCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +OnlyFromCurrentClassCondition +--- +# [OnlyFromCurrentClassCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/PropertyFilterCondition/OnlyFromCurrentClassCondition.php#L14) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\FilterCondition\PropertyFilterCondition; final class OnlyFromCurrentClassCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Only properties that belong to the current class (not parent) -
    Only properties that belong to the current class (not parent)
    - - - - - - - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - - - - -

    Method details:

    - -
    - - - +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/PropertyFilterCondition/OnlyFromCurrentClassCondition.php#L16) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/PhpEntitiesCollection.md b/docs/tech/02_parser/classes/PhpEntitiesCollection.md index b6328938..7c4ecb6b 100644 --- a/docs/tech/02_parser/classes/PhpEntitiesCollection.md +++ b/docs/tech/02_parser/classes/PhpEntitiesCollection.md @@ -1,883 +1,352 @@ - BumbleDocGen / Technical description of the project / Parser / Entities and entities collections / PhpEntitiesCollection
    - -

    - PhpEntitiesCollection class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +PhpEntitiesCollection +--- +# [PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L43) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; final class PhpEntitiesCollection extends \BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection implements \IteratorAggregate ``` - -
    Collection of php root entities
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - add - - Add an entity to the collection
    2. -
    3. - clearOperationsLogCollection -
    4. -
    5. - filterByInterfaces - - Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity)
    6. -
    7. - filterByNameRegularExpression - - Get a copy of the current collection with only entities whose names match the regular expression
    8. -
    9. - filterByParentClassNames - - Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity)
    10. -
    11. - filterByPaths - - Get a copy of the current collection only with entities filtered by file paths (from project_root)
    12. -
    13. - findEntity - - Find an entity in a collection
    14. -
    15. - get - - Get an entity from a collection (only previously added)
    16. -
    17. - getEntityCollectionName - - Get collection name
    18. -
    19. - getEntityLinkData -
    20. -
    21. - getIterator -
    22. -
    23. - getLoadedOrCreateNew - - Get an entity from the collection or create a new one if it has not yet been added
    24. -
    25. - getOnlyAbstractClasses - - Get a copy of the current collection with only abstract classes
    26. -
    27. - getOnlyInstantiable - - Get a copy of the current collection with only instantiable entities
    28. -
    29. - getOnlyInterfaces - - Get a copy of the current collection with only interfaces
    30. -
    31. - getOnlyTraits - - Get a copy of the current collection with only traits
    32. -
    33. - getOperationsLogCollection -
    34. -
    35. - has - - Check if an entity has been added to the collection
    36. -
    37. - internalFindEntity -
    38. -
    39. - internalGetLoadedOrCreateNew -
    40. -
    41. - isEmpty - - Check if the collection is empty or not
    42. -
    43. - loadEntities - - Load entities into a collection
    44. -
    45. - loadEntitiesByConfiguration - - Load entities into a collection by configuration
    46. -
    47. - remove - - Remove an entity from a collection
    48. -
    49. - removeAllNotLoadedEntities -
    50. -
    51. - toArray - - Convert collection to array
    52. -
    53. - updateEntitiesCache -
    54. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Collection of php root entities + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [add](#madd) - Add an entity to the collection +1. [clearOperationsLogCollection](#mclearoperationslogcollection) +1. [filterByInterfaces](#mfilterbyinterfaces) - Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity) +1. [filterByNameRegularExpression](#mfilterbynameregularexpression) - Get a copy of the current collection with only entities whose names match the regular expression +1. [filterByParentClassNames](#mfilterbyparentclassnames) - Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity) +1. [filterByPaths](#mfilterbypaths) - Get a copy of the current collection only with entities filtered by file paths (from project_root) +1. [findEntity](#mfindentity) - Find an entity in a collection +1. [get](#mget) - Get an entity from a collection (only previously added) +1. [getEntityCollectionName](#mgetentitycollectionname) - Get collection name +1. [getEntityLinkData](#mgetentitylinkdata) +1. [getIterator](#mgetiterator) +1. [getLoadedOrCreateNew](#mgetloadedorcreatenew) - Get an entity from the collection or create a new one if it has not yet been added +1. [getOnlyAbstractClasses](#mgetonlyabstractclasses) - Get a copy of the current collection with only abstract classes +1. [getOnlyInstantiable](#mgetonlyinstantiable) - Get a copy of the current collection with only instantiable entities +1. [getOnlyInterfaces](#mgetonlyinterfaces) - Get a copy of the current collection with only interfaces +1. [getOnlyTraits](#mgetonlytraits) - Get a copy of the current collection with only traits +1. [getOperationsLogCollection](#mgetoperationslogcollection) +1. [has](#mhas) - Check if an entity has been added to the collection +1. [internalFindEntity](#minternalfindentity) +1. [internalGetLoadedOrCreateNew](#minternalgetloadedorcreatenew) +1. [isEmpty](#misempty) - Check if the collection is empty or not +1. [loadEntities](#mloadentities) - Load entities into a collection +1. [loadEntitiesByConfiguration](#mloadentitiesbyconfiguration) - Load entities into a collection by configuration +1. [remove](#mremove) - Remove an entity from a collection +1. [removeAllNotLoadedEntities](#mremoveallnotloadedentities) +1. [toArray](#mtoarray) - Convert collection to array +1. [updateEntitiesCache](#mupdateentitiescache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L50) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\Core\Plugin\PluginEventDispatcher $pluginEventDispatcher, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory $cacheablePhpEntityFactory, \BumbleDocGen\LanguageHandler\Php\Renderer\EntityDocRenderer\EntityDocRendererHelper $docRendererHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$pluginEventDispatcher | [\BumbleDocGen\Core\Plugin\PluginEventDispatcher](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginEventDispatcher.php) | - | +$cacheablePhpEntityFactory | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/Cache/CacheablePhpEntityFactory.php) | - | +$docRendererHelper | [\BumbleDocGen\LanguageHandler\Php\Renderer\EntityDocRenderer\EntityDocRendererHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/EntityDocRenderer/EntityDocRendererHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $pluginEventDispatcher\BumbleDocGen\Core\Plugin\PluginEventDispatcher-
    $cacheablePhpEntityFactory\BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory-
    $docRendererHelper\BumbleDocGen\LanguageHandler\Php\Renderer\EntityDocRenderer\EntityDocRendererHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `add` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L190) ```php public function add(\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity $classEntity, bool $reload = false): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Add an entity to the collection -
    Add an entity to the collection
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity-
    $reloadbool-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -Throws: - - -
    -
    -
    - - +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$classEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) | - | +$reload | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | + +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) + +--- + +# `clearOperationsLogCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L28) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function clearOperationsLogCollection(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -
    -
    -
    - - - +# `filterByInterfaces` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L244) ```php public function filterByInterfaces(array $interfaces): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity) -
    Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity)
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfacesstring[]-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Parameters:*** -Throws: - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `filterByNameRegularExpression` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L321) ```php public function filterByNameRegularExpression(string $regexPattern): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection with only entities whose names match the regular expression -
    Get a copy of the current collection with only entities whose names match the regular expression
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $regexPatternstring-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$regexPattern | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) - +--- +# `filterByParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L270) ```php public function filterByParentClassNames(array $parentClassNames): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity) -
    Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity)
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamesarray-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Parameters:*** -Throws: - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `filterByPaths` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L298) ```php public function filterByPaths(array $paths): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection only with entities filtered by file paths (from project_root) -
    Get a copy of the current collection only with entities filtered by file paths (from project_root)
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pathsarray-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$paths | [array](https://www.php.net/manual/en/language.types.array.php) | - | -Throws: - - -
    -
    -
    - - +--- +# `findEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L118) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function findEntity(string $search, bool $useUnsafeKeys = true): null|\BumbleDocGen\Core\Parser\Entity\RootEntityInterface; ``` +Find an entity in a collection + +***Parameters:*** -
    Find an entity in a collection
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $searchstring-
    $useUnsafeKeysbool-
    - -Return value: null | \BumbleDocGen\Core\Parser\Entity\RootEntityInterface - - -
    -
    -
    - - +| Name | Type | Description | +|:-|:-|:-| +$search | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$useUnsafeKeys | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) + +--- + +# `get` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L86) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function get(string $objectName): null|\BumbleDocGen\Core\Parser\Entity\RootEntityInterface; ``` +Get an entity from a collection (only previously added) -
    Get an entity from a collection (only previously added)
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    +***Parameters:*** -Return value: null | \BumbleDocGen\Core\Parser\Entity\RootEntityInterface +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) -
    -
    -
    - - +--- +# `getEntityCollectionName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L66) ```php public function getEntityCollectionName(): string; ``` +Get collection name -
    Get collection name
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - getEntityLinkData - :warning: Is internal | source code
    • -
    +--- +# `getEntityLinkData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L508) ```php public function getEntityLinkData(string $rawLink, string|null $defaultEntityName = null, bool $useUnsafeKeys = true): array; ``` +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$rawLink | [string](https://www.php.net/manual/en/language.types.string.php) | Raw link to an entity or entity element | +$defaultEntityName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Entity name to use if the link does not contain a valid or existing entity name, + but only a cursor on an entity element | +$useUnsafeKeys | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rawLinkstringRaw link to an entity or entity element
    $defaultEntityNamestring | nullEntity name to use if the link does not contain a valid or existing entity name, - but only a cursor on an entity element
    $useUnsafeKeysbool-
    - -Return value: array - - -
    -
    -
    - - +--- +# `getIterator` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L46) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function getIterator(): \Generator; ``` +***Return value:*** [\Generator](https://www.php.net/manual/en/language.generators.overview.php) +--- -Parameters: not specified - -Return value: \Generator - - -
    -
    -
    - - - +# `getLoadedOrCreateNew` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L102) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function getLoadedOrCreateNew(string $objectName, bool $withAddClassEntityToCollectionEvent = false): \BumbleDocGen\Core\Parser\Entity\RootEntityInterface; ``` +Get an entity from the collection or create a new one if it has not yet been added -
    Get an entity from the collection or create a new one if it has not yet been added
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    $withAddClassEntityToCollectionEventbool-
    - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityInterface - - - -See: - -
    -
    -
    - - +***Parameters:*** -```php -public function getOnlyAbstractClasses(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; -``` - -
    Get a copy of the current collection with only abstract classes
    +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$withAddClassEntityToCollectionEvent | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: not specified +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Links:*** +- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](/docs/tech/02_parser/classes/RootEntityInterface.md#misentitydatacanbeloaded) +--- -Throws: - +# `getOnlyAbstractClasses` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L388) +```php +public function getOnlyAbstractClasses(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; +``` +Get a copy of the current collection with only abstract classes -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) - +--- +# `getOnlyInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L338) ```php public function getOnlyInstantiable(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection with only instantiable entities -
    Get a copy of the current collection with only instantiable entities
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -
    -
    -
    - - +--- +# `getOnlyInterfaces` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L354) ```php public function getOnlyInterfaces(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection with only interfaces -
    Get a copy of the current collection with only interfaces
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `getOnlyTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L370) ```php public function getOnlyTraits(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection with only traits -
    Get a copy of the current collection with only traits
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `getOperationsLogCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function getOperationsLogCollection(): \BumbleDocGen\Core\Parser\Entity\CollectionLogOperation\OperationsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionLogOperation\OperationsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionLogOperation/OperationsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionLogOperation\OperationsCollection - - -
    -
    -
    - - - +# `has` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L42) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function has(string $objectName): bool; ``` +Check if an entity has been added to the collection -
    Check if an entity has been added to the collection
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - -
      -
    • # - internalFindEntity - :warning: Is internal | source code
    • -
    +--- +# `internalFindEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L421) ```php public function internalFindEntity(string $search, bool $useUnsafeKeys = true): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Parameters:*** - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $searchstringSearch query. For the search, only the main part is taken, up to the characters: `::`, `->`, `#`. +| Name | Type | Description | +|:-|:-|:-| +$search | [string](https://www.php.net/manual/en/language.types.string.php) | Search query. For the search, only the main part is taken, up to the characters: `::`, `->`, `#`. If the request refers to multiple existing entities and if unsafe keys are allowed, - a warning will be shown and the first entity found will be used.
    $useUnsafeKeysboolWhether to use search keys that can be used to find several entities
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity + a warning will be shown and the first entity found will be used. | +$useUnsafeKeys | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Whether to use search keys that can be used to find several entities | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) - - -Examples of using: - +***Examples of using:*** ```php $entitiesCollection->findEntity('App'); // class name $entitiesCollection->findEntity('BumbleDocGen\Console\App'); // class with namespace @@ -889,318 +358,118 @@ $entitiesCollection->findEntity('/Users/someuser/Desktop/projects/bumble-doc-gen $entitiesCollection->findEntity('https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/App.php'); // source link ``` -
    -
    -
    - -
      -
    • # - internalGetLoadedOrCreateNew - :warning: Is internal | source code
    • -
    +--- +# `internalGetLoadedOrCreateNew` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L214) ```php public function internalGetLoadedOrCreateNew(string $objectName, bool $withAddClassEntityToCollectionEvent = false): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$withAddClassEntityToCollectionEvent | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    $withAddClassEntityToCollectionEventbool-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -Throws: - - -
    -
    -
    - - +--- +# `isEmpty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L52) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function isEmpty(): bool; ``` +Check if the collection is empty or not -
    Check if the collection is empty or not
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `loadEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L100) ```php public function loadEntities(\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection $sourceLocatorsCollection, \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface|null $filters = null, \BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface|null $progressBar = null): \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult; ``` +Load entities into a collection -
    Load entities into a collection
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $sourceLocatorsCollection\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection-
    $filters\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface | null-
    $progressBar\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface | null-
    - -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult - - -Throws: - - -
    -
    -
    - -
      -
    • # - loadEntitiesByConfiguration - :warning: Is internal | source code
    • -
    - -```php -public function loadEntitiesByConfiguration(\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface|null $progressBar = null): \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult; -``` - -
    Load entities into a collection by configuration
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $progressBar\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface | null-
    +***Parameters:*** -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult +| Name | Type | Description | +|:-|:-|:-| +$sourceLocatorsCollection | [\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/SourceLocatorsCollection.php) | - | +$filters | [\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | +$progressBar | [\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntitiesLoaderProgressBarInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionLoadEntitiesResult.php) -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$progressBar | [\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntitiesLoaderProgressBarInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -
    -
    -
    +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionLoadEntitiesResult.php) - +--- +# `remove` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L32) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function remove(string $objectName): void; ``` +Remove an entity from a collection -
    Remove an entity from a collection
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    - -Return value: void +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - +--- +# `removeAllNotLoadedEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L132) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\RootEntityCollection public function removeAllNotLoadedEntities(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -
    -
    -
    - - - +# `toArray` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L127) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\RootEntityCollection public function toArray(): array; ``` +Convert collection to array -
    Convert collection to array
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - updateEntitiesCache - :warning: Is internal | source code
    • -
    +--- +# `updateEntitiesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L97) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\RootEntityCollection public function updateEntitiesCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/02_parser/classes/PhpHandlerSettings.md b/docs/tech/02_parser/classes/PhpHandlerSettings.md index b3acb783..06fe9c9b 100644 --- a/docs/tech/02_parser/classes/PhpHandlerSettings.md +++ b/docs/tech/02_parser/classes/PhpHandlerSettings.md @@ -1,12 +1,12 @@ - BumbleDocGen / Technical description of the project / Parser / PhpHandlerSettings
    - -

    - PhpHandlerSettings class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +PhpHandlerSettings +--- +# [PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L21) class: ```php namespace BumbleDocGen\LanguageHandler\Php; @@ -14,498 +14,144 @@ namespace BumbleDocGen\LanguageHandler\Php; final class PhpHandlerSettings ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [getClassConstantEntityFilter](#mgetclassconstantentityfilter) +1. [getClassEntityFilter](#mgetclassentityfilter) +1. [getComposerConfigFile](#mgetcomposerconfigfile) +1. [getComposerVendorDir](#mgetcomposervendordir) +1. [getCustomTwigFilters](#mgetcustomtwigfilters) +1. [getCustomTwigFunctions](#mgetcustomtwigfunctions) +1. [getEntityDocRenderersCollection](#mgetentitydocrendererscollection) +1. [getFileSourceBaseUrl](#mgetfilesourcebaseurl) +1. [getMethodEntityFilter](#mgetmethodentityfilter) +1. [getPropertyEntityFilter](#mgetpropertyentityfilter) +1. [getPsr4Map](#mgetpsr4map) +1. [getUseComposerAutoload](#mgetusecomposerautoload) +## Methods details: - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getClassConstantEntityFilter -
    2. -
    3. - getClassEntityFilter -
    4. -
    5. - getComposerConfigFile -
    6. -
    7. - getComposerVendorDir -
    8. -
    9. - getCustomTwigFilters -
    10. -
    11. - getCustomTwigFunctions -
    12. -
    13. - getEntityDocRenderersCollection -
    14. -
    15. - getFileSourceBaseUrl -
    16. -
    17. - getMethodEntityFilter -
    18. -
    19. - getPropertyEntityFilter -
    20. -
    21. - getPsr4Map -
    22. -
    23. - getUseComposerAutoload -
    24. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L26) ```php public function __construct(\BumbleDocGen\Core\Configuration\ConfigurationParameterBag $parameterBag, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$parameterBag | [\BumbleDocGen\Core\Configuration\ConfigurationParameterBag](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/ConfigurationParameterBag.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parameterBag\BumbleDocGen\Core\Configuration\ConfigurationParameterBag-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    - - - -
    -
    -
    - - +--- +# `getClassConstantEntityFilter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L63) ```php public function getClassConstantEntityFilter(): \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface - - -Throws: - - -
    -
    -
    - - - +# `getClassEntityFilter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L43) ```php public function getClassEntityFilter(): \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface - - -Throws: - - -
    -
    -
    - - - +# `getComposerConfigFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L176) ```php public function getComposerConfigFile(): null|string; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    - - - +# `getComposerVendorDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L193) ```php public function getComposerVendorDir(): null|string; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    - - - +# `getCustomTwigFilters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L250) ```php public function getCustomTwigFilters(): \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/CustomFiltersCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection - - -Throws: - - -
    -
    -
    - - - +# `getCustomTwigFunctions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L227) ```php public function getCustomTwigFunctions(): \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/CustomFunctionsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection - - -Throws: - - -
    -
    -
    - - - +# `getEntityDocRenderersCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L123) ```php public function getEntityDocRenderersCollection(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRenderersCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRenderersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRenderersCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRenderersCollection - - -Throws: - - -
    -
    -
    - - - +# `getFileSourceBaseUrl` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L144) ```php public function getFileSourceBaseUrl(): null|string; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    - - - +# `getMethodEntityFilter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L83) ```php public function getMethodEntityFilter(): \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface - - -Throws: - - -
    -
    -
    - - - +# `getPropertyEntityFilter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L103) ```php public function getPropertyEntityFilter(): \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface - - -Throws: - - -
    -
    -
    - - - +# `getPsr4Map` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L209) ```php public function getPsr4Map(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getUseComposerAutoload` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L160) ```php public function getUseComposerAutoload(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/02_parser/classes/ProjectParser.md b/docs/tech/02_parser/classes/ProjectParser.md index 4b1e91cd..57e20108 100644 --- a/docs/tech/02_parser/classes/ProjectParser.md +++ b/docs/tech/02_parser/classes/ProjectParser.md @@ -1,223 +1,81 @@ - BumbleDocGen / Technical description of the project / Parser / ProjectParser
    - -

    - ProjectParser class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +ProjectParser +--- +# [ProjectParser](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/ProjectParser.php#L21) class: ```php namespace BumbleDocGen\Core\Parser; final class ProjectParser ``` +Entity for project parsing using source locators -
    Entity for project parsing using source locators
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    +## Initialization methods -
      -
    1. - getEntityCollectionForPL -
    2. -
    3. - getRootEntityCollectionsGroup -
    4. -
    5. - parse -
    6. -
    +1. [__construct](#m-construct) +## Methods +1. [getEntityCollectionForPL](#mgetentitycollectionforpl) +1. [getRootEntityCollectionsGroup](#mgetrootentitycollectionsgroup) +1. [parse](#mparse) +## Methods details: - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/ProjectParser.php#L23) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Plugin\PluginEventDispatcher $pluginEventDispatcher, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$pluginEventDispatcher | [\BumbleDocGen\Core\Plugin\PluginEventDispatcher](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginEventDispatcher.php) | - | +$rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $pluginEventDispatcher\BumbleDocGen\Core\Plugin\PluginEventDispatcher-
    $rootEntityCollectionsGroup\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup-
    - - - -
    -
    -
    - - +--- +# `getEntityCollectionForPL` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/ProjectParser.php#L58) ```php public function getEntityCollectionForPL(string $plHandlerClassName): null|\BumbleDocGen\Core\Parser\Entity\RootEntityCollection; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$plHandlerClassName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $plHandlerClassNamestring-
    - -Return value: null | \BumbleDocGen\Core\Parser\Entity\RootEntityCollection +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) +--- -Throws: - - -
    -
    -
    - - - +# `getRootEntityCollectionsGroup` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/ProjectParser.php#L46) ```php public function getRootEntityCollectionsGroup(): \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup - - -
    -
    -
    - - - +# `parse` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/ProjectParser.php#L37) ```php public function parse(\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface|null $progressBar = null): \BumbleDocGen\Core\Parser\Entity\CollectionGroupLoadEntitiesResult; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$progressBar | [\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntitiesLoaderProgressBarInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $progressBar\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface | null-
    - -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionGroupLoadEntitiesResult - - -Throws: - +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionGroupLoadEntitiesResult](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionGroupLoadEntitiesResult.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/PropertyEntitiesCollection.md b/docs/tech/02_parser/classes/PropertyEntitiesCollection.md index c759783c..057c5797 100644 --- a/docs/tech/02_parser/classes/PropertyEntitiesCollection.md +++ b/docs/tech/02_parser/classes/PropertyEntitiesCollection.md @@ -1,12 +1,13 @@ - BumbleDocGen / Technical description of the project / Parser / Entities and entities collections / PropertyEntitiesCollection
    - -

    - PropertyEntitiesCollection class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +PropertyEntitiesCollection +--- +# [PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php#L15) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property; @@ -14,400 +15,154 @@ namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property; final class PropertyEntitiesCollection extends \BumbleDocGen\Core\Parser\Entity\BaseEntityCollection implements \IteratorAggregate ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [add](#madd) - Add an entity to a collection +1. [get](#mget) - Get the loaded property entity if it exists +1. [getIterator](#mgetiterator) +1. [has](#mhas) - Check if an entity has been added to the collection +1. [isEmpty](#misempty) - Check if the collection is empty or not +1. [loadPropertyEntities](#mloadpropertyentities) - Load property entities into the collection according to the project configuration +1. [remove](#mremove) - Remove an entity from a collection +1. [unsafeGet](#munsafeget) - Get the property entity if it exists. If the property exists but has not been loaded into the collection, a new entity object will be created +## Methods details: - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - add - - Add an entity to a collection
    2. -
    3. - get - - Get the loaded property entity if it exists
    4. -
    5. - getIterator -
    6. -
    7. - has - - Check if an entity has been added to the collection
    8. -
    9. - isEmpty - - Check if the collection is empty or not
    10. -
    11. - loadPropertyEntities - - Load property entities into the collection according to the project configuration
    12. -
    13. - remove - - Remove an entity from a collection
    14. -
    15. - unsafeGet - - Get the property entity if it exists. If the property exists but has not been loaded into the collection, a new entity object will be created
    16. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php#L17) ```php public function __construct(\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity $classEntity, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory $cacheablePhpEntityFactory); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$classEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$cacheablePhpEntityFactory | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/Cache/CacheablePhpEntityFactory.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $cacheablePhpEntityFactory\BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory-
    - - - -
    -
    -
    - - +--- +# `add` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php#L58) ```php public function add(\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity $propertyEntity, bool $reload = false): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection; ``` +Add an entity to a collection -
    Add an entity to a collection
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntityEntity to be added to the collection
    $reloadboolReplace an entity with a new one if one has already been loaded previously
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection - - -
    -
    -
    - - +***Parameters:*** -```php -public function get(string $objectName): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; -``` +| Name | Type | Description | +|:-|:-|:-| +$propertyEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php) | Entity to be added to the collection | +$reload | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Replace an entity with a new one if one has already been loaded previously | -
    Get the loaded property entity if it exists
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) -Parameters: +--- - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestringProperty entity name
    +# `get` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php#L74) +```php +public function get(string $objectName): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; +``` +Get the loaded property entity if it exists -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | Property entity name | -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php) - +--- +# `getIterator` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L11) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function getIterator(): \Generator; ``` +***Return value:*** [\Generator](https://www.php.net/manual/en/language.generators.overview.php) +--- -Parameters: not specified - -Return value: \Generator - - -
    -
    -
    - - - +# `has` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L42) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function has(string $objectName): bool; ``` +Check if an entity has been added to the collection -
    Check if an entity has been added to the collection
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isEmpty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L52) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function isEmpty(): bool; ``` +Check if the collection is empty or not -
    Check if the collection is empty or not
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - -
      -
    • # - loadPropertyEntities - :warning: Is internal | source code
    • -
    - +# `loadPropertyEntities` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php#L35) ```php public function loadPropertyEntities(): void; ``` +Load property entities into the collection according to the project configuration -
    Load property entities into the collection according to the project configuration
    - -Parameters: not specified - -Return value: void - - -Throws: - - - -See: - -
    -
    -
    - - +--- +# `remove` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L32) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function remove(string $objectName): void; ``` +Remove an entity from a collection -
    Remove an entity from a collection
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    - -Return value: void +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - +--- +# `unsafeGet` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php#L90) ```php public function unsafeGet(string $objectName): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; ``` +Get the property entity if it exists. If the property exists but has not been loaded into the collection, a new entity object will be created -
    Get the property entity if it exists. If the property exists but has not been loaded into the collection, a new entity object will be created
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestringProperty entity name
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity - - -Throws: - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/PropertyEntity.md b/docs/tech/02_parser/classes/PropertyEntity.md index fe25d5b0..8cb54eff 100644 --- a/docs/tech/02_parser/classes/PropertyEntity.md +++ b/docs/tech/02_parser/classes/PropertyEntity.md @@ -1,1585 +1,623 @@ - BumbleDocGen / Technical description of the project / Parser / Entities and entities collections / PropertyEntity
    - -

    - PropertyEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +PropertyEntity +--- +# [PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L28) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property; class PropertyEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity implements \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface ``` - -
    Class property entity
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    2. -
    3. - getAst - - Get AST for this entity
    4. -
    5. - getCacheKey -
    6. -
    7. - getCachedEntityDependencies -
    8. -
    9. - getCurrentRootEntity -
    10. -
    11. - getDefaultValue - - Get the compiled default value of a property
    12. -
    13. - getDescription - - Get entity description
    14. -
    15. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    16. -
    17. - getDocBlock - - Get DocBlock for current entity
    18. -
    19. - getDocComment - - Get the doc comment of an entity
    20. -
    21. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    22. -
    23. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    24. -
    25. - getDocNote - - Get the note annotation value
    26. -
    27. - getEndLine - - Get the line number of the end of a property's code in a file
    28. -
    29. - getExamples - - Get parsed examples from `examples` doc block
    30. -
    31. - getFileSourceLink -
    32. -
    33. - getFirstExample - - Get first example from `examples` doc block
    34. -
    35. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    36. -
    37. - getImplementingClassName - - Get the name of the class in which this property is implemented
    38. -
    39. - getModifiersString - - Get a text representation of property modifiers
    40. -
    41. - getName - - Full name of the entity
    42. -
    43. - getNamespaceName - - Namespace of the class that contains this property
    44. -
    45. - getObjectId - - Get entity unique ID
    46. -
    47. - getRelativeFileName - - File name relative to project_root configuration parameter
    48. -
    49. - getRootEntity -
    50. -
    51. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    52. -
    53. - getShortName - - Short name of the entity
    54. -
    55. - getStartLine - - Get the line number of the beginning of the entity code in a file
    56. -
    57. - getThrows - - Get parsed throws from `throws` doc block
    58. -
    59. - getThrowsDocBlockLinks -
    60. -
    61. - getType - - Get current property type
    62. -
    63. - hasDescriptionLinks - - Checking if an entity has links in its description
    64. -
    65. - hasExamples - - Checking if an entity has `example` docBlock
    66. -
    67. - hasThrows - - Checking if an entity has `throws` docBlock
    68. -
    69. - isApi - - Checking if an entity has `api` docBlock
    70. -
    71. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    72. -
    73. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    74. -
    75. - isEntityDataCacheOutdated -
    76. -
    77. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    78. -
    79. - isImplementedInParentClass - - Check if this property is implemented in the parent class
    80. -
    81. - isInternal - - Checking if an entity has `internal` docBlock
    82. -
    83. - isPrivate - - Check if a private is a public private
    84. -
    85. - isProtected - - Check if a protected is a public protected
    86. -
    87. - isPublic - - Check if a property is a public property
    88. -
    89. - reloadEntityDependenciesCache - - Update entity dependency cache
    90. -
    91. - removeEntityValueFromCache -
    92. -
    93. - removeNotUsedEntityDataCache -
    94. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Class property entity + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDefaultValue](#mgetdefaultvalue) - Get the compiled default value of a property +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getEndLine](#mgetendline) - Get the line number of the end of a property's code in a file +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getImplementingClassName](#mgetimplementingclassname) - Get the name of the class in which this property is implemented +1. [getModifiersString](#mgetmodifiersstring) - Get a text representation of property modifiers +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Namespace of the class that contains this property +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntity](#mgetrootentity) +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getStartLine](#mgetstartline) - Get the line number of the beginning of the entity code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getType](#mgettype) - Get current property type +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isImplementedInParentClass](#misimplementedinparentclass) - Check if this property is implemented in the parent class +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isPrivate](#misprivate) - Check if a private is a public private +1. [isProtected](#misprotected) - Check if a protected is a public protected +1. [isPublic](#mispublic) - Check if a property is a public property +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L59) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity $classEntity, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $propertyName, string $implementingClassName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$classEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$implementingClassName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $classEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $propertyNamestring-
    $implementingClassNamestring-
    - - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - - -Throws: - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L86) ```php public function getAst(): \PhpParser\Node\Stmt\Property; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\Property - +***Return value:*** [\PhpParser\Node\Stmt\Property](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Property.php) -Throws: - - -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    - +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDefaultValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L370) ```php public function getDefaultValue(): string|array|int|bool|null|float; ``` +Get the compiled default value of a property -
    Get the compiled default value of a property
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) -Parameters: not specified - -Return value: string | array | int | bool | null | float - - -Throws: - - -
    -
    -
    - - +--- +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Throws: - - -
    -
    -
    - - - +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    - -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - +***Return value:*** [\phpDocumentor\Reflection\DocBlock](https://github.com/phpDocumentor/ReflectionDocBlock/blob/master/src/DocBlock.php) -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    +--- +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L135) ```php public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity - - -
    -
    -
    - - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    - -Parameters: not specified - -Return value: null | int - - -Throws: - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L352) ```php public function getEndLine(): int; ``` +Get the line number of the end of a property's code in a file -
    Get the line number of the end of a property's code in a file
    - -Parameters: not specified - -Return value: int +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) +--- -Throws: - - -
    -
    -
    - - - +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    +--- +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - - -Throws: - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L207) ```php public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -
    -
    -
    - - +--- +# `getImplementingClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L199) ```php public function getImplementingClassName(): string; ``` +Get the name of the class in which this property is implemented -
    Get the name of the class in which this property is implemented
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L265) ```php public function getModifiersString(): string; ``` +Get a text representation of property modifiers -
    Get a text representation of property modifiers
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L171) ```php public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L189) ```php public function getNamespaceName(): string; ``` +Namespace of the class that contains this property -
    Namespace of the class that contains this property
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L185) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L217) ```php public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified - -Return value: null | string - - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -See: - -
    -
    -
    +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) - +--- +# `getRootEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L76) ```php public function getRootEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L123) ```php public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L179) ```php public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L337) ```php public function getStartLine(): int; ``` +Get the line number of the beginning of the entity code in a file -
    Get the line number of the beginning of the entity code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -
    -
    -
    - - +--- +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getType` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L231) ```php public function getType(): string; ``` +Get current property type -
    Get current property type
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isImplementedInParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L291) ```php public function isImplementedInParentClass(): bool; ``` +Check if this property is implemented in the parent class -
    Check if this property is implemented in the parent class
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isPrivate` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L327) ```php public function isPrivate(): bool; ``` +Check if a private is a public private -
    Check if a private is a public private
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isProtected` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L315) ```php public function isProtected(): bool; ``` +Check if a protected is a public protected -
    Check if a protected is a public protected
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isPublic` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L303) ```php public function isPublic(): bool; ``` +Check if a property is a public property -
    Check if a property is a public property
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    - +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    - +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/02_parser/classes/RecursiveDirectoriesSourceLocator.md b/docs/tech/02_parser/classes/RecursiveDirectoriesSourceLocator.md index 5e15b9ba..e2deb84a 100644 --- a/docs/tech/02_parser/classes/RecursiveDirectoriesSourceLocator.md +++ b/docs/tech/02_parser/classes/RecursiveDirectoriesSourceLocator.md @@ -1,117 +1,52 @@ - BumbleDocGen / Technical description of the project / Parser / Source locators / RecursiveDirectoriesSourceLocator
    - -

    - RecursiveDirectoriesSourceLocator class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Source locators](/docs/tech/02_parser/sourceLocator.md) **/** +RecursiveDirectoriesSourceLocator +--- +# [RecursiveDirectoriesSourceLocator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/RecursiveDirectoriesSourceLocator.php#L10) class: ```php namespace BumbleDocGen\Core\Parser\SourceLocator; final class RecursiveDirectoriesSourceLocator extends \BumbleDocGen\Core\Parser\SourceLocator\BaseSourceLocator implements \BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorInterface ``` +Loads all files from the specified directories, which are traversed recursively -
    Loads all files from the specified directories, which are traversed recursively
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getFinder -
    2. -
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [getFinder](#mgetfinder) +## Methods details: - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/RecursiveDirectoriesSourceLocator.php#L12) ```php public function __construct(array $directories, array $exclude = [], bool $abortExecutionIfPartOfDirsNotExists = true); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$directories | [array](https://www.php.net/manual/en/language.types.array.php) | - | +$exclude | [array](https://www.php.net/manual/en/language.types.array.php) | - | +$abortExecutionIfPartOfDirsNotExists | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $directoriesarray-
    $excludearray-
    $abortExecutionIfPartOfDirsNotExistsbool-
    - - - -
    -
    -
    - - +--- +# `getFinder` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/BaseSourceLocator.php#L19) ```php // Implemented in BumbleDocGen\Core\Parser\SourceLocator\BaseSourceLocator public function getFinder(): \Symfony\Component\Finder\Finder; ``` +***Return value:*** [\Symfony\Component\Finder\Finder](https://github.com/symfony/finder/blob/master/Finder.php) - -Parameters: not specified - -Return value: \Symfony\Component\Finder\Finder - - -
    -
    +--- diff --git a/docs/tech/02_parser/classes/RootEntityCollection.md b/docs/tech/02_parser/classes/RootEntityCollection.md deleted file mode 100644 index 9c667f81..00000000 --- a/docs/tech/02_parser/classes/RootEntityCollection.md +++ /dev/null @@ -1,561 +0,0 @@ - BumbleDocGen / Technical description of the project / Parser / Entities and entities collections / RootEntityCollection
    - -

    - RootEntityCollection class: -

    - - - - - -```php -namespace BumbleDocGen\Core\Parser\Entity; - -abstract class RootEntityCollection extends \BumbleDocGen\Core\Parser\Entity\BaseEntityCollection implements \IteratorAggregate -``` - - - - - - - - - -

    Methods:

    - -
      -
    1. - findEntity - - Find an entity in a collection
    2. -
    3. - get - - Get an entity from a collection (only previously added)
    4. -
    5. - getEntityCollectionName - - Get collection name
    6. -
    7. - getEntityLinkData -
    8. -
    9. - getIterator -
    10. -
    11. - getLoadedOrCreateNew - - Get an entity from the collection or create a new one if it has not yet been added
    12. -
    13. - has - - Check if an entity has been added to the collection
    14. -
    15. - isEmpty - - Check if the collection is empty or not
    16. -
    17. - loadEntities -
    18. -
    19. - loadEntitiesByConfiguration -
    20. -
    21. - remove - - Remove an entity from a collection
    22. -
    23. - removeAllNotLoadedEntities -
    24. -
    25. - toArray - - Convert collection to array
    26. -
    27. - updateEntitiesCache -
    28. -
    - - - - - - - -

    Method details:

    - -
    - - - -```php -public function findEntity(string $search, bool $useUnsafeKeys = true): null|\BumbleDocGen\Core\Parser\Entity\RootEntityInterface; -``` - -
    Find an entity in a collection
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $searchstring-
    $useUnsafeKeysbool-
    - -Return value: null | \BumbleDocGen\Core\Parser\Entity\RootEntityInterface - - -
    -
    -
    - - - -```php -public function get(string $objectName): null|\BumbleDocGen\Core\Parser\Entity\RootEntityInterface; -``` - -
    Get an entity from a collection (only previously added)
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    - -Return value: null | \BumbleDocGen\Core\Parser\Entity\RootEntityInterface - - -
    -
    -
    - - - -```php -public function getEntityCollectionName(): string; -``` - -
    Get collection name
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getEntityLinkData - :warning: Is internal | source code
    • -
    - -```php -public function getEntityLinkData(string $rawLink, string|null $defaultEntityName = null, bool $useUnsafeKeys = true): array; -``` - - - -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rawLinkstringRaw link to an entity or entity element
    $defaultEntityNamestring | nullEntity name to use if the link does not contain a valid or existing entity name, - but only a cursor on an entity element
    $useUnsafeKeysbool-
    - -Return value: array - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection - -public function getIterator(): \Generator; -``` - - - -Parameters: not specified - -Return value: \Generator - - -
    -
    -
    - - - -```php -public function getLoadedOrCreateNew(string $objectName, bool $withAddClassEntityToCollectionEvent = false): \BumbleDocGen\Core\Parser\Entity\RootEntityInterface; -``` - -
    Get an entity from the collection or create a new one if it has not yet been added
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    $withAddClassEntityToCollectionEventbool-
    - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityInterface - - - -See: - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection - -public function has(string $objectName): bool; -``` - -
    Check if an entity has been added to the collection
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    - -Return value: bool - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection - -public function isEmpty(): bool; -``` - -
    Check if the collection is empty or not
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - -```php -public function loadEntities(\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection $sourceLocatorsCollection, \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface|null $filters = null, \BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface|null $progressBar = null): \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult; -``` - - - -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $sourceLocatorsCollection\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection-
    $filters\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface | null-
    $progressBar\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface | null-
    - -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult - - -
    -
    -
    - - - -```php -public function loadEntitiesByConfiguration(\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface|null $progressBar = null): \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult; -``` - - - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $progressBar\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface | null-
    - -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection - -public function remove(string $objectName): void; -``` - -
    Remove an entity from a collection
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    - -Return value: void - - -
    -
    -
    - - - -```php -public function removeAllNotLoadedEntities(): void; -``` - - - -Parameters: not specified - -Return value: void - - -
    -
    -
    - - - -```php -public function toArray(): array; -``` - -
    Convert collection to array
    - -Parameters: not specified - -Return value: array - - -
    -
    -
    - -
      -
    • # - updateEntitiesCache - :warning: Is internal | source code
    • -
    - -```php -public function updateEntitiesCache(): void; -``` - - - -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    diff --git a/docs/tech/02_parser/classes/RootEntityInterface.md b/docs/tech/02_parser/classes/RootEntityInterface.md index 2d506c9b..c8c6a137 100644 --- a/docs/tech/02_parser/classes/RootEntityInterface.md +++ b/docs/tech/02_parser/classes/RootEntityInterface.md @@ -1,469 +1,217 @@ - BumbleDocGen / Technical description of the project / Parser / RootEntityInterface
    - -

    - RootEntityInterface class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +RootEntityInterface +--- +# [RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L11) class: ```php namespace BumbleDocGen\Core\Parser\Entity; interface RootEntityInterface extends \BumbleDocGen\Core\Parser\Entity\EntityInterface ``` +Since the documentation generator supports several programming languages, +their entities need to correspond to the same interfaces -
    Since the documentation generator supports several programming languages, -their entities need to correspond to the same interfaces
    - - - - - - - -

    Methods:

    - -
      -
    1. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    2. -
    3. - getEntityDependencies -
    4. -
    5. - getFileContent -
    6. -
    7. - getFileSourceLink -
    8. -
    9. - getName - - Full name of the entity
    10. -
    11. - getObjectId - - Entity object ID
    12. -
    13. - getRelativeFileName - - File name relative to project_root configuration parameter
    14. -
    15. - getRootEntityCollection - - Get parent collection of entities
    16. -
    17. - getShortName - - Short name of the entity
    18. -
    19. - isEntityCacheOutdated -
    20. -
    21. - isEntityDataCanBeLoaded - - Checking if it is possible to get the entity data
    22. -
    23. - isEntityNameValid - - Check if entity name is valid
    24. -
    25. - isExternalLibraryEntity - - The entity is loaded from a third party library and should not be treated the same as a standard one
    26. -
    27. - isInGit - - The entity file is in the git repository
    28. -
    29. - normalizeClassName -
    30. -
    +## Methods +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getEntityDependencies](#mgetentitydependencies) +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getName](#mgetname) - Full name of the entity +1. [getObjectId](#mgetobjectid) - Entity object ID +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get parent collection of entities +1. [getShortName](#mgetshortname) - Short name of the entity +1. [isEntityCacheOutdated](#misentitycacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) - Checking if it is possible to get the entity data +1. [isEntityNameValid](#misentitynamevalid) - Check if entity name is valid +1. [isExternalLibraryEntity](#misexternallibraryentity) - The entity is loaded from a third party library and should not be treated the same as a standard one +1. [isInGit](#misingit) - The entity file is in the git repository +1. [normalizeClassName](#mnormalizeclassname) +## Methods details: - - - - -

    Method details:

    - -
    - - - +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L53) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L33) ```php public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L40) ```php public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getFileSourceLink` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L42) ```php public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L30) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L16) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getObjectId(): string; ``` +Entity object ID -
    Entity object ID
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -
    -
    -
    - - +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L46) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) +--- - -See: - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getRootEntityCollection(): \BumbleDocGen\Core\Parser\Entity\RootEntityCollection; ``` +Get parent collection of entities -
    Get parent collection of entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityCollection +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) +--- -
    -
    -
    - - - +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L37) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L58) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function isEntityCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L23) ```php public function isEntityDataCanBeLoaded(): bool; ``` +Checking if it is possible to get the entity data -
    Checking if it is possible to get the entity data
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L18) ```php public static function isEntityNameValid(string $entityName): bool; ``` +Check if entity name is valid -
    Check if entity name is valid
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isExternalLibraryEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L28) ```php public function isExternalLibraryEntity(): bool; ``` +The entity is loaded from a third party library and should not be treated the same as a standard one -
    The entity is loaded from a third party library and should not be treated the same as a standard one
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInGit` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L38) ```php public function isInGit(): bool; ``` +The entity file is in the git repository -
    The entity file is in the git repository
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L13) ```php public static function normalizeClassName(string $name): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/SingleFileSourceLocator.md b/docs/tech/02_parser/classes/SingleFileSourceLocator.md index 8ec0205f..06464283 100644 --- a/docs/tech/02_parser/classes/SingleFileSourceLocator.md +++ b/docs/tech/02_parser/classes/SingleFileSourceLocator.md @@ -1,107 +1,50 @@ - BumbleDocGen / Technical description of the project / Parser / Source locators / SingleFileSourceLocator
    - -

    - SingleFileSourceLocator class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Source locators](/docs/tech/02_parser/sourceLocator.md) **/** +SingleFileSourceLocator +--- +# [SingleFileSourceLocator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/SingleFileSourceLocator.php#L10) class: ```php namespace BumbleDocGen\Core\Parser\SourceLocator; final class SingleFileSourceLocator extends \BumbleDocGen\Core\Parser\SourceLocator\BaseSourceLocator implements \BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorInterface ``` +Loads one specific file by its path -
    Loads one specific file by its path
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getFinder -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [getFinder](#mgetfinder) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/SingleFileSourceLocator.php#L12) ```php public function __construct(string $filename); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$filename | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $filenamestring-
    - - - -
    -
    -
    - - +--- +# `getFinder` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/BaseSourceLocator.php#L19) ```php // Implemented in BumbleDocGen\Core\Parser\SourceLocator\BaseSourceLocator public function getFinder(): \Symfony\Component\Finder\Finder; ``` +***Return value:*** [\Symfony\Component\Finder\Finder](https://github.com/symfony/finder/blob/master/Finder.php) - -Parameters: not specified - -Return value: \Symfony\Component\Finder\Finder - - -
    -
    +--- diff --git a/docs/tech/02_parser/classes/SourceLocatorInterface.md b/docs/tech/02_parser/classes/SourceLocatorInterface.md index 65dbdcd1..169743cb 100644 --- a/docs/tech/02_parser/classes/SourceLocatorInterface.md +++ b/docs/tech/02_parser/classes/SourceLocatorInterface.md @@ -1,12 +1,13 @@ - BumbleDocGen / Technical description of the project / Parser / Source locators / SourceLocatorInterface
    - -

    - SourceLocatorInterface class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Source locators](/docs/tech/02_parser/sourceLocator.md) **/** +SourceLocatorInterface +--- +# [SourceLocatorInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/SourceLocatorInterface.php#L9) class: ```php namespace BumbleDocGen\Core\Parser\SourceLocator; @@ -14,48 +15,17 @@ namespace BumbleDocGen\Core\Parser\SourceLocator; interface SourceLocatorInterface ``` +## Methods +1. [getFinder](#mgetfinder) +## Methods details: - - - - - -

    Methods:

    - -
      -
    1. - getFinder -
    2. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `getFinder` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/SourceLocatorInterface.php#L11) ```php public function getFinder(): null|\Symfony\Component\Finder\Finder; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\Symfony\Component\Finder\Finder](https://github.com/symfony/finder/blob/master/Finder.php) - -Parameters: not specified - -Return value: null | \Symfony\Component\Finder\Finder - - -
    -
    +--- diff --git a/docs/tech/02_parser/classes/TraitEntity.md b/docs/tech/02_parser/classes/TraitEntity.md index c3d74282..82b35b1f 100644 --- a/docs/tech/02_parser/classes/TraitEntity.md +++ b/docs/tech/02_parser/classes/TraitEntity.md @@ -1,3438 +1,1359 @@ - BumbleDocGen / Technical description of the project / Parser / Entities and entities collections / TraitEntity
    - -

    - TraitEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +TraitEntity +--- +# [TraitEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/TraitEntity.php#L12) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; class TraitEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity implements \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface, \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface ``` - -
    Trait
    - -See: - - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - addPluginData - - Add information to aт entity object
    2. -
    3. - cursorToDocAttributeLinkFragment -
    4. -
    5. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    6. -
    7. - getAst - - Get AST for this entity
    8. -
    9. - getCacheKey -
    10. -
    11. - getCachedEntityDependencies -
    12. -
    13. - getConstant - - Get the method entity by its name
    14. -
    15. - getConstantEntitiesCollection - - Get a collection of constant entities
    16. -
    17. - getConstantValue - - Get the compiled value of a constant
    18. -
    19. - getConstants - - Get all constants that are available according to the configuration as an array
    20. -
    21. - getConstantsData - - Get a list of all constants and classes where they are implemented
    22. -
    23. - getConstantsValues - - Get class constant compiled values according to filters
    24. -
    25. - getCurrentRootEntity -
    26. -
    27. - getDescription - - Get entity description
    28. -
    29. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    30. -
    31. - getDocBlock - - Get DocBlock for current entity
    32. -
    33. - getDocComment - - Get the doc comment of an entity
    34. -
    35. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    36. -
    37. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    38. -
    39. - getDocNote - - Get the note annotation value
    40. -
    41. - getDocRender -
    42. -
    43. - getEndLine - - Get the line number of the end of a class code in a file
    44. -
    45. - getEntityDependencies -
    46. -
    47. - getExamples - - Get parsed examples from `examples` doc block
    48. -
    49. - getFileContent -
    50. -
    51. - getFileSourceLink -
    52. -
    53. - getFirstExample - - Get first example from `examples` doc block
    54. -
    55. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    56. -
    57. - getInterfaceNames - - Get a list of class interface names
    58. -
    59. - getInterfacesEntities - - Get a list of interface entities that the current class implements
    60. -
    61. - getMethod - - Get the method entity by its name
    62. -
    63. - getMethodEntitiesCollection - - Get a collection of method entities
    64. -
    65. - getMethods - - Get all methods that are available according to the configuration as an array
    66. -
    67. - getMethodsData - - Get a list of all methods and classes where they are implemented
    68. -
    69. - getModifiersString - - Get entity modifiers as a string
    70. -
    71. - getName - - Full name of the entity
    72. -
    73. - getNamespaceName - - Get the entity namespace name
    74. -
    75. - getObjectId - - Get entity unique ID
    76. -
    77. - getParentClass - - Get the entity of the parent class if it exists
    78. -
    79. - getParentClassEntities - - Get a list of parent class entities
    80. -
    81. - getParentClassName - - Get the name of the parent class entity if it exists
    82. -
    83. - getParentClassNames - - Get a list of entity names of parent classes
    84. -
    85. - getPluginData - - Get additional information added using the plugin
    86. -
    87. - getProperties - - Get all properties that are available according to the configuration as an array
    88. -
    89. - getPropertiesData - - Get a list of all properties and classes where they are implemented
    90. -
    91. - getProperty - - Get the property entity by its name
    92. -
    93. - getPropertyDefaultValue - - Get the compiled value of a property
    94. -
    95. - getPropertyEntitiesCollection - - Get a collection of property entities
    96. -
    97. - getRelativeFileName - - File name relative to project_root configuration parameter
    98. -
    99. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    100. -
    101. - getShortName - - Short name of the entity
    102. -
    103. - getStartLine - - Get the line number of the start of a class code in a file
    104. -
    105. - getThrows - - Get parsed throws from `throws` doc block
    106. -
    107. - getThrowsDocBlockLinks -
    108. -
    109. - getTraits - - Get a list of trait entities of the current class
    110. -
    111. - getTraitsNames - - Get a list of class traits names
    112. -
    113. - hasConstant - - Check if a constant exists in a class
    114. -
    115. - hasDescriptionLinks - - Checking if an entity has links in its description
    116. -
    117. - hasExamples - - Checking if an entity has `example` docBlock
    118. -
    119. - hasMethod - - Check if a method exists in a class
    120. -
    121. - hasParentClass - - Check if a certain parent class exists in a chain of parent classes
    122. -
    123. - hasProperty - - Check if a property exists in a class
    124. -
    125. - hasThrows - - Checking if an entity has `throws` docBlock
    126. -
    127. - hasTraits - - Check if the class contains traits
    128. -
    129. - implementsInterface - - Check if a class implements an interface
    130. -
    131. - isAbstract - - Check that an entity is abstract
    132. -
    133. - isApi - - Checking if an entity has `api` docBlock
    134. -
    135. - isClass - - Check if an entity is a Class
    136. -
    137. - isClassLoad -
    138. -
    139. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    140. -
    141. - isDocumentCreationAllowed -
    142. -
    143. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    144. -
    145. - isEntityDataCacheOutdated -
    146. -
    147. - isEntityDataCanBeLoaded -
    148. -
    149. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    150. -
    151. - isEntityNameValid - - Check if the name is a valid name for ClassLikeEntity
    152. -
    153. - isEnum - - Check if an entity is an Enum
    154. -
    155. - isExternalLibraryEntity - - Check if a given entity is an entity from a third party library (connected via composer)
    156. -
    157. - isInGit - - Checking if class file is in git repository
    158. -
    159. - isInstantiable - - Check that an entity is instantiable
    160. -
    161. - isInterface - - Check if an entity is an Interface
    162. -
    163. - isInternal - - Checking if an entity has `internal` docBlock
    164. -
    165. - isSubclassOf - - Whether the given class is a subclass of the specified class
    166. -
    167. - isTrait - - Check if an entity is a Trait
    168. -
    169. - normalizeClassName - - Bring the class name to the standard format used in the system
    170. -
    171. - reloadEntityDependenciesCache - - Update entity dependency cache
    172. -
    173. - removeEntityValueFromCache -
    174. -
    175. - removeNotUsedEntityDataCache -
    176. -
    177. - setCustomAst -
    178. -
    - - - - - - - -

    Method details:

    - -
    - - - +Trait + +***Links:*** +- [https://www.php.net/manual/en/language.oop5.traits.php](https://www.php.net/manual/en/language.oop5.traits.php) + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [addPluginData](#maddplugindata) - Add information to aт entity object +1. [cursorToDocAttributeLinkFragment](#mcursortodocattributelinkfragment) +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getConstant](#mgetconstant) - Get the method entity by its name +1. [getConstantEntitiesCollection](#mgetconstantentitiescollection) - Get a collection of constant entities +1. [getConstantValue](#mgetconstantvalue) - Get the compiled value of a constant +1. [getConstants](#mgetconstants) - Get all constants that are available according to the configuration as an array +1. [getConstantsData](#mgetconstantsdata) - Get a list of all constants and classes where they are implemented +1. [getConstantsValues](#mgetconstantsvalues) - Get class constant compiled values according to filters +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getDocRender](#mgetdocrender) +1. [getEndLine](#mgetendline) - Get the line number of the end of a class code in a file +1. [getEntityDependencies](#mgetentitydependencies) +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getInterfaceNames](#mgetinterfacenames) - Get a list of class interface names +1. [getInterfacesEntities](#mgetinterfacesentities) - Get a list of interface entities that the current class implements +1. [getMethod](#mgetmethod) - Get the method entity by its name +1. [getMethodEntitiesCollection](#mgetmethodentitiescollection) - Get a collection of method entities +1. [getMethods](#mgetmethods) - Get all methods that are available according to the configuration as an array +1. [getMethodsData](#mgetmethodsdata) - Get a list of all methods and classes where they are implemented +1. [getModifiersString](#mgetmodifiersstring) - Get entity modifiers as a string +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Get the entity namespace name +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getParentClass](#mgetparentclass) - Get the entity of the parent class if it exists +1. [getParentClassEntities](#mgetparentclassentities) - Get a list of parent class entities +1. [getParentClassName](#mgetparentclassname) - Get the name of the parent class entity if it exists +1. [getParentClassNames](#mgetparentclassnames) - Get a list of entity names of parent classes +1. [getPluginData](#mgetplugindata) - Get additional information added using the plugin +1. [getProperties](#mgetproperties) - Get all properties that are available according to the configuration as an array +1. [getPropertiesData](#mgetpropertiesdata) - Get a list of all properties and classes where they are implemented +1. [getProperty](#mgetproperty) - Get the property entity by its name +1. [getPropertyDefaultValue](#mgetpropertydefaultvalue) - Get the compiled value of a property +1. [getPropertyEntitiesCollection](#mgetpropertyentitiescollection) - Get a collection of property entities +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getTraits](#mgettraits) - Get a list of trait entities of the current class +1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names +1. [hasConstant](#mhasconstant) - Check if a constant exists in a class +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasMethod](#mhasmethod) - Check if a method exists in a class +1. [hasParentClass](#mhasparentclass) - Check if a certain parent class exists in a chain of parent classes +1. [hasProperty](#mhasproperty) - Check if a property exists in a class +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [hasTraits](#mhastraits) - Check if the class contains traits +1. [implementsInterface](#mimplementsinterface) - Check if a class implements an interface +1. [isAbstract](#misabstract) - Check that an entity is abstract +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isClass](#misclass) - Check if an entity is a Class +1. [isClassLoad](#misclassload) +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isDocumentCreationAllowed](#misdocumentcreationallowed) +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isEntityNameValid](#misentitynamevalid) - Check if the name is a valid name for ClassLikeEntity +1. [isEnum](#misenum) - Check if an entity is an Enum +1. [isExternalLibraryEntity](#misexternallibraryentity) - Check if a given entity is an entity from a third party library (connected via composer) +1. [isInGit](#misingit) - Checking if class file is in git repository +1. [isInstantiable](#misinstantiable) - Check that an entity is instantiable +1. [isInterface](#misinterface) - Check if an entity is an Interface +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isSubclassOf](#missubclassof) - Whether the given class is a subclass of the specified class +1. [isTrait](#mistrait) - Check if an entity is a Trait +1. [normalizeClassName](#mnormalizeclassname) - Bring the class name to the standard format used in the system +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) +1. [setCustomAst](#msetcustomast) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L51) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection $entitiesCollection, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper $composerHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $className, string|null $relativeFileName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$entitiesCollection | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$composerHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ComposerHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$relativeFileName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $entitiesCollection\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $composerHelper\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $classNamestring-
    $relativeFileNamestring | null-
    - - - -
    -
    -
    - - +--- +# `addPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function addPluginData(string $pluginKey, mixed $data): void; ``` +Add information to aт entity object -
    Add information to aт entity object
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$data | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    $datamixed-
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Return value: void - - -
    -
    -
    - -
      -
    • # - cursorToDocAttributeLinkFragment - :warning: Is internal | source code
    • -
    +--- +# `cursorToDocAttributeLinkFragment` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1286) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function cursorToDocAttributeLinkFragment(string $cursor, bool $isForDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $cursorstring-
    $isForDocumentbool-
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L296) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getAst(): \PhpParser\Node\Stmt\Class_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\Class_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ - +***Return value:*** [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) | [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) | [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) -Throws: - - -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L806) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstant(string $constantName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant whose entity you want to get
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity - - -Throws: - - -
    -
    -
    - - +--- +# `getConstantEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L736) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection; ``` +Get a collection of constant entities -
    Get a collection of constant entities
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +--- -Throws: - - - -See: - -
    -
    -
    - - - +# `getConstantValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L829) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantValue(string $constantName): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant for which you need to get the value
    - -Return value: string | array | int | bool | null | float - - -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant for which you need to get the value | -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) - +--- +# `getConstants` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L765) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstants(): array; ``` +Get all constants that are available according to the configuration as an array -
    Get all constants that are available according to the configuration as an array
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) -Return value: array - - -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getConstantsData - :warning: Is internal | source code
    • -
    +--- +# `getConstantsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L661) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all constants and classes where they are implemented -
    Get a list of all constants and classes where they are implemented
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for constants corresponding to the visibility modifiers passed in this value | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for constants from the current class
    $flagsintGet data only for constants corresponding to the visibility modifiers passed in this value
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getConstantsValues` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L849) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantsValues(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get class constant compiled values according to filters -
    Get class constant compiled values according to filters
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet values only for constants from the current class
    $flagsintGet values only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get values only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get values only for constants corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    +--- +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    +***Return value:*** [\phpDocumentor\Reflection\DocBlock](https://github.com/phpDocumentor/ReflectionDocBlock/blob/master/src/DocBlock.php) -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    - +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L236) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) -Parameters: not specified - -Return value: null | int - - -Throws: - - -
    -
    -
    - - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getDocRender` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1262) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getDocRender(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRendererInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface - - -Throws: - - -
    -
    -
    - - - +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L469) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getEndLine(): int; ``` +Get the line number of the end of a class code in a file -
    Get the line number of the end of a class code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1035) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    - +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L370) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -
    -
    -
    - - +--- +# `getInterfaceNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/TraitEntity.php#L25) ```php public function getInterfaceNames(): array; ``` +Get a list of class interface names -
    Get a list of class interface names
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getInterfacesEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L587) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getInterfacesEntities(): array; ``` +Get a list of interface entities that the current class implements -
    Get a list of interface entities that the current class implements
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1203) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethod(string $methodName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to get
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity - - -Throws: - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) -
    -
    -
    - - +--- +# `getMethodEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1133) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethodEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; ``` +Get a collection of method entities -
    Get a collection of method entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection - - -Throws: - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) -See: - -
    -
    -
    - - +--- +# `getMethods` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1162) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethods(): array; ``` +Get all methods that are available according to the configuration as an array -
    Get all methods that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - - -Throws: - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) -See: - -
    -
    -
    - -
      -
    • # - getMethodsData - :warning: Is internal | source code
    • -
    +--- +# `getMethodsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1059) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethodsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all methods and classes where they are implemented -
    Get a list of all methods and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for methods from the current class
    $flagsintGet data only for methods corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for methods from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for methods corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/TraitEntity.php#L33) ```php public function getModifiersString(): string; ``` +Get entity modifiers as a string -
    Get entity modifiers as a string
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L378) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L397) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getNamespaceName(): string; ``` +Get the entity namespace name -
    Get the entity namespace name
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L142) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L516) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClass(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the entity of the parent class if it exists -
    Get the entity of the parent class if it exists
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - +--- +# `getParentClassEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClassEntities(): array; ``` +Get a list of parent class entities -
    Get a list of parent class entities
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -
    -
    -
    - - +--- +# `getParentClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L506) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClassName(): null|string; ``` +Get the name of the parent class entity if it exists -
    Get the name of the parent class entity if it exists
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string - - -
    -
    -
    - - +--- +# `getParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L481) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClassNames(): array; ``` +Get a list of entity names of parent classes -
    Get a list of entity names of parent classes
    - -Parameters: not specified - -Return value: array - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L270) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPluginData(string $pluginKey): mixed; ``` +Get additional information added using the plugin -
    Get additional information added using the plugin
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) -Return value: mixed - - -
    -
    -
    - - +--- +# `getProperties` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L963) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getProperties(): array; ``` +Get all properties that are available according to the configuration as an array -
    Get all properties that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - - -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getPropertiesData - :warning: Is internal | source code
    • -
    +--- +# `getPropertiesData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L872) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertiesData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all properties and classes where they are implemented -
    Get a list of all properties and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for properties from the current class
    $flagsintGet data only for properties corresponding to the visibility modifiers passed in this value
    - -Return value: array - - -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for properties from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for properties corresponding to the visibility modifiers passed in this value | -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1004) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getProperty(string $propertyName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; ``` +Get the property entity by its name -
    Get the property entity by its name
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to get
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php) -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity - - -Throws: - - -
    -
    -
    - - +--- +# `getPropertyDefaultValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1027) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertyDefaultValue(string $propertyName): string|array|int|bool|null|float; ``` +Get the compiled value of a property -
    Get the compiled value of a property
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property for which you need to get the value
    +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property for which you need to get the value | -Return value: string | array | int | bool | null | float +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) +--- -Throws: - - -
    -
    -
    - - - +# `getPropertyEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L934) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertyEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection; ``` +Get a collection of property entities -
    Get a collection of property entities
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +--- -Throws: - - - -See: - -
    -
    -
    - - - +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L412) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) +--- - -See: - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L160) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -
    -
    -
    - - +--- +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L386) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L457) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getStartLine(): int; ``` +Get the line number of the start of a class code in a file -
    Get the line number of the start of a class code in a file
    - -Parameters: not specified - -Return value: int - - -Throws: - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -
    -
    -
    - - +--- +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getTraits(): array; ``` +Get a list of trait entities of the current class -
    Get a list of trait entities of the current class
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getTraitsNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L604) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getTraitsNames(): array; ``` +Get a list of class traits names -
    Get a list of class traits names
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `hasConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L785) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasConstant(string $constantName, bool $unsafe = false): bool; ``` +Check if a constant exists in a class -
    Check if a constant exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the class whose entity you want to check
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    - -Return value: bool - - -Throws: -
      -
    • - \DI\DependencyException
    • +***Parameters:*** -
    • - \DI\NotFoundException
    • +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the class whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | -
    • - \BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException
    • +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    - -
    -
    -
    - - +--- +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `hasMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1182) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasMethod(string $methodName, bool $unsafe = false): bool; ``` +Check if a method exists in a class -
    Check if a method exists in a class
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to check
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `hasParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1250) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasParentClass(string $parentClassName): bool; ``` +Check if a certain parent class exists in a chain of parent classes -
    Check if a certain parent class exists in a chain of parent classes
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamestringSearched parent class
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$parentClassName | [string](https://www.php.net/manual/en/language.types.string.php) | Searched parent class | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L983) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasProperty(string $propertyName, bool $unsafe = false): bool; ``` +Check if a property exists in a class -
    Check if a property exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to check
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: bool - - -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L644) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasTraits(): bool; ``` +Check if the class contains traits -
    Check if the class contains traits
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `implementsInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1237) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function implementsInterface(string $interfaceName): bool; ``` +Check if a class implements an interface -
    Check if a class implements an interface
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfaceNamestringName of the required interface in the interface chain
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$interfaceName | [string](https://www.php.net/manual/en/language.types.string.php) | Name of the required interface in the interface chain | -Throws: - - -
    -
    -
    - - +--- +# `isAbstract` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L445) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isAbstract(): bool; ``` +Check that an entity is abstract -
    Check that an entity is abstract
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isClass(): bool; ``` +Check if an entity is a Class -
    Check if an entity is a Class
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isClassLoad` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L343) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isClassLoad(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - -
      -
    • # - isDocumentCreationAllowed - :warning: Is internal | source code
    • -
    +--- +# `isDocumentCreationAllowed` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L224) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isDocumentCreationAllowed(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L358) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isEntityDataCanBeLoaded(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L84) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public static function isEntityNameValid(string $entityName): bool; ``` +Check if the name is a valid name for ClassLikeEntity -
    Check if the name is a valid name for ClassLikeEntity
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isEnum` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L134) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isEnum(): bool; ``` +Check if an entity is an Enum -
    Check if an entity is an Enum
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - -
      -
    • # - isExternalLibraryEntity - :warning: Is internal | source code
    • -
    - +# `isExternalLibraryEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L152) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isExternalLibraryEntity(): bool; ``` +Check if a given entity is an entity from a third party library (connected via composer) -
    Check if a given entity is an entity from a third party library (connected via composer)
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInGit` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L205) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInGit(): bool; ``` +Checking if class file is in git repository -
    Checking if class file is in git repository
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L435) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInstantiable(): bool; ``` +Check that an entity is instantiable -
    Check that an entity is instantiable
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L114) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInterface(): bool; ``` +Check if an entity is an Interface -
    Check if an entity is an Interface
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isSubclassOf` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/TraitEntity.php#L41) ```php public function isSubclassOf(string $className): bool; ``` +Whether the given class is a subclass of the specified class -
    Whether the given class is a subclass of the specified class
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classNamestring-
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Throws: - - -
    -
    -
    - - +--- +# `isTrait` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/TraitEntity.php#L17) ```php public function isTrait(): bool; ``` +Check if an entity is a Trait -
    Check if an entity is a Trait
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L94) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public static function normalizeClassName(string $name): string; ``` +Bring the class name to the standard format used in the system -
    Bring the class name to the standard format used in the system
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    +***Parameters:*** -Return value: string +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - - - +# `setCustomAst` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L284) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function setCustomAst(\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Class_|null $customAst): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$customAst | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) \| [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) \| [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) \| [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $customAst\PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Class_ | null-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/TrueCondition.md b/docs/tech/02_parser/classes/TrueCondition.md index 99aaf064..856c8ed5 100644 --- a/docs/tech/02_parser/classes/TrueCondition.md +++ b/docs/tech/02_parser/classes/TrueCondition.md @@ -1,78 +1,38 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / TrueCondition
    - -

    - TrueCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +TrueCondition +--- +# [TrueCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/CommonFilterCondition/TrueCondition.php#L13) class: ```php namespace BumbleDocGen\Core\Parser\FilterCondition\CommonFilterCondition; final class TrueCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +True conditions, any object is available -
    True conditions, any object is available
    - - - - - - - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - - - - -

    Method details:

    - -
    - - - +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/CommonFilterCondition/TrueCondition.php#L15) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/VisibilityCondition.md b/docs/tech/02_parser/classes/VisibilityCondition.md index 72274d8b..f3395bfa 100644 --- a/docs/tech/02_parser/classes/VisibilityCondition.md +++ b/docs/tech/02_parser/classes/VisibilityCondition.md @@ -1,122 +1,54 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / VisibilityCondition
    - -

    - VisibilityCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +VisibilityCondition +--- +# [VisibilityCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/ClassConstantFilterCondition/VisibilityCondition.php#L15) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\FilterCondition\ClassConstantFilterCondition; final class VisibilityCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Constant access modifier check -
    Constant access modifier check
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/ClassConstantFilterCondition/VisibilityCondition.php#L19) ```php public function __construct(string ...$visibilityModifiers); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$visibilityModifiers (variadic) | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $visibilityModifiers (variadic)string-
    - - - -
    -
    -
    - - +--- +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/ClassConstantFilterCondition/VisibilityCondition.php#L24) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/VisibilityCondition_2.md b/docs/tech/02_parser/classes/VisibilityCondition_2.md index d00e2f85..fdce542c 100644 --- a/docs/tech/02_parser/classes/VisibilityCondition_2.md +++ b/docs/tech/02_parser/classes/VisibilityCondition_2.md @@ -1,122 +1,54 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / VisibilityCondition
    - -

    - VisibilityCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +VisibilityCondition +--- +# [VisibilityCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/MethodFilterCondition/VisibilityCondition.php#L15) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\FilterCondition\MethodFilterCondition; final class VisibilityCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Method access modifier check -
    Method access modifier check
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/MethodFilterCondition/VisibilityCondition.php#L19) ```php public function __construct(string ...$visibilityModifiers); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$visibilityModifiers (variadic) | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $visibilityModifiers (variadic)string-
    - - - -
    -
    -
    - - +--- +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/MethodFilterCondition/VisibilityCondition.php#L24) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/classes/VisibilityCondition_3.md b/docs/tech/02_parser/classes/VisibilityCondition_3.md index fc485d02..820e80bc 100644 --- a/docs/tech/02_parser/classes/VisibilityCondition_3.md +++ b/docs/tech/02_parser/classes/VisibilityCondition_3.md @@ -1,122 +1,54 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions / VisibilityCondition
    - -

    - VisibilityCondition class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +VisibilityCondition +--- +# [VisibilityCondition](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/PropertyFilterCondition/VisibilityCondition.php#L15) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\FilterCondition\PropertyFilterCondition; final class VisibilityCondition implements \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface ``` +Property access modifier check -
    Property access modifier check
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - canAddToCollection -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [canAddToCollection](#mcanaddtocollection) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/PropertyFilterCondition/VisibilityCondition.php#L19) ```php public function __construct(string ...$visibilityModifiers); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$visibilityModifiers (variadic) | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $visibilityModifiers (variadic)string-
    - - - -
    -
    -
    - - +--- +# `canAddToCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/FilterCondition/PropertyFilterCondition/VisibilityCondition.php#L24) ```php public function canAddToCollection(\BumbleDocGen\Core\Parser\Entity\EntityInterface $entity): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\EntityInterface-
    - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    +--- diff --git a/docs/tech/02_parser/entity.md b/docs/tech/02_parser/entity.md index 5491e99f..b9df364d 100644 --- a/docs/tech/02_parser/entity.md +++ b/docs/tech/02_parser/entity.md @@ -1,147 +1,83 @@ - BumbleDocGen / Technical description of the project / Parser / Entities and entities collections
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +Entities and entities collections -

    Entities and entities collections

    +--- + + +# Entities and entities collections Entities are organized outcomes from parsing source code. They help easily extract details about specific items from templates, allowing users to quickly access and display the information they need. Entities are always handled through collections. Collections are the result of the project parsing process and are available in both documentation templates and code. -

    Examples of using collections in twig templates

    +## Examples of using collections in twig templates * Passing a collection to a function: ```twig - {{ printEntityCollectionAsList(phpEntities) }} +{{ printEntityCollectionAsList(phpEntities) }} ``` - * Filtering a collection and passing it to a function: ```twig - {{ printEntityCollectionAsList(phpEntities.filterByInterfaces(['BumbleDocGen\Core\Parser\Entity\EntityInterface'])) }} +{{ printEntityCollectionAsList(phpEntities.filterByInterfaces(['BumbleDocGen\Core\Parser\Entity\EntityInterface'])) }} ``` - * Saving a filtered collection to a variable: ```twig - {{ {% set filteredCollection = phpEntities.getOnlyInstantiable() %} }} +{% set filteredCollection = phpEntities.getOnlyInstantiable() %} ``` - * Using a collection in a for loop: ```twig - {% for someClassEntity in phpEntities %} - * {{ someClassEntity.getName() }} - {% endfor %} +{% for someClassEntity in phpEntities %} + * {{ someClassEntity.getName() }} +{% endfor %} ``` - * Output of all methods of all found entities in `className::methodName()` format: ```twig - {% for someClassEntity in phpEntities %} - {% for methodEntity in someClassEntity.getMethodEntitiesCollection() %} - * {{ someClassEntity.getName() }}::{{ methodEntity.getName() }}() - {% endfor %} - {% endfor %} +{% for someClassEntity in phpEntities %} + {% for methodEntity in someClassEntity.getMethodEntitiesCollection() %} + * {{ someClassEntity.getName() }}::{{ methodEntity.getName() }}() + {% endfor %} +{% endfor %} ``` - -

    Root entities collections

    +## Root entities collections To further facilitate the handling of these entities, we utilize entity collections. These collections not only group relevant entities together but also provide convenient methods for filtering and manipulating these entities. -The root collections (RootEntityCollection), which are directly accessible in your templates, are as follows: - - - - - - - - - - - - - - -
    Collection className in twig templatePLDescription
    PhpEntitiesCollectionphpEntitiesPHPCollection of php root entities
    - -

    Available entities

    - -Following is the list of available entities that are consistent with EntityInterface and can be created. +The root collections ([a]RootEntityCollection[/a]), which are directly accessible in your templates, are as follows: + +| Collection class | Name in twig template | PL | Description | +|-|-|-|-| +| PhpEntitiesCollection | **phpEntities** | PHP | Collection of php root entities | + +## Available entities + +Following is the list of available entities that are consistent with [a]EntityInterface[/a] and can be created. These classes are a convenient wrapper for accessing data in templates: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Entity nameCollection nameIs rootPLDescription
    ClassEntityPhpEntitiesCollectionyesPHPPHP Class
    EnumEntityPhpEntitiesCollectionyesPHPEnumeration
    InterfaceEntityPhpEntitiesCollectionyesPHPObject interface
    TraitEntityPhpEntitiesCollectionyesPHPTrait
    ClassConstantEntityClassConstantEntitiesCollectionnoPHPClass constant entity
    DynamicMethodEntityMethodEntitiesCollectionnoPHPMethod obtained by parsing the "method" annotation
    MethodEntityMethodEntitiesCollectionnoPHPClass method entity
    PropertyEntityPropertyEntitiesCollectionnoPHPClass property entity
    - -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +| Entity name | Collection name | Is root | PL | Description | +|-|-|-|-|-| +| ClassEntity | PhpEntitiesCollection | yes | PHP | PHP Class | +| EnumEntity | PhpEntitiesCollection | yes | PHP | Enumeration | +| InterfaceEntity | PhpEntitiesCollection | yes | PHP | Object interface | +| TraitEntity | PhpEntitiesCollection | yes | PHP | Trait | +| ClassConstantEntity | ClassConstantEntitiesCollection | no | PHP | Class constant entity | +| DynamicMethodEntity | MethodEntitiesCollection | no | PHP | Method obtained by parsing the "method" annotation | +| MethodEntity | MethodEntitiesCollection | no | PHP | Class method entity | +| PropertyEntity | PropertyEntitiesCollection | no | PHP | Class property entity | + + +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 17:19:08 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/entityFilterCondition.md b/docs/tech/02_parser/entityFilterCondition.md index c8dbf646..2e0a7c6b 100644 --- a/docs/tech/02_parser/entityFilterCondition.md +++ b/docs/tech/02_parser/entityFilterCondition.md @@ -1,15 +1,21 @@ - BumbleDocGen / Technical description of the project / Parser / Entity filter conditions
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +Entity filter conditions -

    Entity filter conditions

    +--- + + +# Entity filter conditions Filters serve as a foundational mechanism within our documentation generator, dictating which segments of the source code are selected during the initial parsing phase. These rules facilitate a strategic extraction of elements, such as classes, methods, or constants, from the underlying codebase. By implementing these filters, users are endowed with the capability to customize the documentation output, ensuring that it precisely aligns with their requirements and expectations. This level of granularity not only streamlines the documentation process but also guarantees that the resultant documents are devoid of superfluous details, focusing solely on pertinent information. -All filter conditions implement the ConditionInterface interface. +All filter conditions implement the [ConditionInterface](/docs/tech/02_parser/classes/ConditionInterface.md) interface. -

    Mechanism for adding entities to the collection

    +## Mechanism for adding entities to the collection For each language handler, according to the configuration, the following scheme is applicable: @@ -31,7 +37,7 @@ flowchart LR The diagram shows the mechanism for adding root entities, but this also applies to the attributes of each entity, for example, for PHP there are rules for checking the possibility of adding methods, properties and constants. -

    Filter conditions configuration

    +## Filter conditions configuration Filter conditions are configured separately for language handlers. @@ -63,19 +69,43 @@ language_handlers: - class: \BumbleDocGen\LanguageHandler\Php\Parser\FilterCondition\PropertyFilterCondition\OnlyFromCurrentClassCondition ``` -

    Available filters

    +## Available filters Common filtering conditions that are available for any entity: -
    • FalseCondition - False conditions, any object is not available
    • FileTextContainsCondition - Checking if a file contains a substring
    • LocatedInCondition - Checking the existence of an entity in the specified directories
    • LocatedNotInCondition - Checking the existence of an entity not in the specified directories
    • TrueCondition - True conditions, any object is available
    • ConditionGroup - Filter condition to group other filter conditions. A group can have an OR/AND condition test; -In the case of OR, it is enough to successfully check at least one condition, in the case of AND, all checks must be successfully completed.
    +- [FalseCondition](/docs/tech/02_parser/classes/FalseCondition.md) - False conditions, any object is not available +- [FileTextContainsCondition](/docs/tech/02_parser/classes/FileTextContainsCondition.md) - Checking if a file contains a substring +- [LocatedInCondition](/docs/tech/02_parser/classes/LocatedInCondition.md) - Checking the existence of an entity in the specified directories +- [LocatedNotInCondition](/docs/tech/02_parser/classes/LocatedNotInCondition.md) - Checking the existence of an entity not in the specified directories +- [TrueCondition](/docs/tech/02_parser/classes/TrueCondition.md) - True conditions, any object is available +- [ConditionGroup](/docs/tech/02_parser/classes/ConditionGroup.md) - Filter condition to group other filter conditions. A group can have an OR/AND condition test; In the case of OR, it is enough to successfully check at least one condition, in the case of AND, all checks must be successfully completed. -Filter condition for working with entities PHP language handler: - -
    Group nameClass short nameDescription
    ClassConstantFilterConditionIsPrivateConditionCheck is a private constant or not
    IsProtectedConditionCheck is a protected constant or not
    IsPublicConditionCheck is a public constant or not
    VisibilityConditionConstant access modifier check
    MethodFilterConditionIsPrivateConditionCheck is a private method or not
    IsProtectedConditionCheck is a protected method or not
    IsPublicConditionCheck is a public method or not
    OnlyFromCurrentClassConditionOnly methods that belong to the current class (not parent)
    VisibilityConditionMethod access modifier check
    PropertyFilterConditionIsPrivateConditionCheck is a private property or not
    IsProtectedConditionCheck is a protected property or not
    IsPublicConditionCheck is a public property or not
    OnlyFromCurrentClassConditionOnly properties that belong to the current class (not parent)
    VisibilityConditionProperty access modifier check
    +Filter condition for working with entities PHP language handler: -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +| Group name | Class short name | Description | +|-|-|-| +| **ClassConstantFilterCondition** | [IsPrivateCondition](/docs/tech/02_parser/classes/IsPrivateCondition.md) | Check is a private constant or not | +| | [IsProtectedCondition](/docs/tech/02_parser/classes/IsProtectedCondition.md) | Check is a protected constant or not | +| | [IsPublicCondition](/docs/tech/02_parser/classes/IsPublicCondition.md) | Check is a public constant or not | +| | [VisibilityCondition](/docs/tech/02_parser/classes/VisibilityCondition.md) | Constant access modifier check | +| | | | +| **MethodFilterCondition** | [IsPrivateCondition](/docs/tech/02_parser/classes/IsPrivateCondition_2.md) | Check is a private method or not | +| | [IsProtectedCondition](/docs/tech/02_parser/classes/IsProtectedCondition_2.md) | Check is a protected method or not | +| | [IsPublicCondition](/docs/tech/02_parser/classes/IsPublicCondition_2.md) | Check is a public method or not | +| | [OnlyFromCurrentClassCondition](/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition.md) | Only methods that belong to the current class (not parent) | +| | [VisibilityCondition](/docs/tech/02_parser/classes/VisibilityCondition_2.md) | Method access modifier check | +| | | | +| **PropertyFilterCondition** | [IsPrivateCondition](/docs/tech/02_parser/classes/IsPrivateCondition_3.md) | Check is a private property or not | +| | [IsProtectedCondition](/docs/tech/02_parser/classes/IsProtectedCondition_3.md) | Check is a protected property or not | +| | [IsPublicCondition](/docs/tech/02_parser/classes/IsPublicCondition_3.md) | Check is a public property or not | +| | [OnlyFromCurrentClassCondition](/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition_2.md) | Only properties that belong to the current class (not parent) | +| | [VisibilityCondition](/docs/tech/02_parser/classes/VisibilityCondition_3.md) | Property access modifier check | +| | | | + + + +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/readme.md b/docs/tech/02_parser/readme.md index eb86f695..8c600502 100644 --- a/docs/tech/02_parser/readme.md +++ b/docs/tech/02_parser/readme.md @@ -1,30 +1,47 @@ - BumbleDocGen / Technical description of the project / Parser
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +Parser -

    Documentation parser

    +--- -Most often, we need ProjectParser in order to get a list of entities for documentation. + +# Documentation parser + +Most often, we need [ProjectParser](/docs/tech/02_parser/classes/ProjectParser.md) in order to get a list of entities for documentation. But this is not the only use of this tool. The result of the parser's work (a collection of entities) can be used to programmatically analyze the project and perform any operations based on this analysis. For example, in our documentation generator, we also use the result of the parser in the tasks of generating documentation using AI tools. You can also use the parser for your own purposes other than generating documentation. In this section, we show how the parser works and what components it consists of. -

    Description of the main components of the parser

    +## Description of the main components of the parser + - +- [Entities and entities collections](/docs/tech/02_parser/entity.md) +- [Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) +- [Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) + - [Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) + - [PHP class constant reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md) + - [PHP class method reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md) + - [PHP class property reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md) + - [PHP class reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md) + - [PHP entities collection](/docs/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md) + - [PHP enum reflection API](/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md) + - [PHP interface reflection API](/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md) + - [PHP trait reflection API](/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md) +- [Source locators](/docs/tech/02_parser/sourceLocator.md) -

    Starting the parsing process

    +## Starting the parsing process ```php - $parser = new ProjectParser($configuration, $rootEntityCollectionsGroup); - - // Parsing the project and filling RootEntityCollectionsGroup with data - $this->parser->parse(); - $rootEntityCollectionsGroup = $this->parser->getRootEntityCollectionsGroup(); -``` +$parser = new ProjectParser($configuration, $rootEntityCollectionsGroup); +// Parsing the project and filling RootEntityCollectionsGroup with data +$this->parser->parse(); +$rootEntityCollectionsGroup = $this->parser->getRootEntityCollectionsGroup(); +``` -

    How it works

    +## How it works ```mermaid flowchart TD @@ -40,6 +57,6 @@ In this section, we show how the parser works and what components it consists of ReturnResult --> Exit(((Exit))) ``` -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/classes/RootEntityCollectionsGroup.md b/docs/tech/02_parser/reflectionApi/classes/RootEntityCollectionsGroup.md index ae563dc6..29b6ce38 100644 --- a/docs/tech/02_parser/reflectionApi/classes/RootEntityCollectionsGroup.md +++ b/docs/tech/02_parser/reflectionApi/classes/RootEntityCollectionsGroup.md @@ -1,12 +1,13 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / RootEntityCollectionsGroup
    - -

    - RootEntityCollectionsGroup class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +RootEntityCollectionsGroup +--- +# [RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php#L10) class: ```php namespace BumbleDocGen\Core\Parser\Entity; @@ -14,320 +15,122 @@ namespace BumbleDocGen\Core\Parser\Entity; final class RootEntityCollectionsGroup implements \IteratorAggregate ``` +## Methods +1. [add](#madd) +1. [clearOperationsLog](#mclearoperationslog) +1. [get](#mget) +1. [getIterator](#mgetiterator) +1. [getOperationsLog](#mgetoperationslog) +1. [getOperationsLogWithoutDuplicates](#mgetoperationslogwithoutduplicates) +1. [isFoundEntitiesOperationsLogCacheOutdated](#misfoundentitiesoperationslogcacheoutdated) +1. [loadByLanguageHandlers](#mloadbylanguagehandlers) +1. [updateAllEntitiesCache](#mupdateallentitiescache) +## Methods details: - - - - - -

    Methods:

    - -
      -
    1. - add -
    2. -
    3. - clearOperationsLog -
    4. -
    5. - get -
    6. -
    7. - getIterator -
    8. -
    9. - getOperationsLog -
    10. -
    11. - getOperationsLogWithoutDuplicates -
    12. -
    13. - isFoundEntitiesOperationsLogCacheOutdated -
    14. -
    15. - loadByLanguageHandlers -
    16. -
    17. - updateAllEntitiesCache -
    18. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `add` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php#L36) ```php public function add(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rootEntityCollection\BumbleDocGen\Core\Parser\Entity\RootEntityCollection-
    - -Return value: void - - -
    -
    -
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - +--- +# `clearOperationsLog` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php#L46) ```php public function clearOperationsLog(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -
    -
    -
    - - - +# `get` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php#L41) ```php public function get(string $collectionName): null|\BumbleDocGen\Core\Parser\Entity\RootEntityCollection; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$collectionName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $collectionNamestring-
    - -Return value: null | \BumbleDocGen\Core\Parser\Entity\RootEntityCollection +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) +--- -
    -
    -
    - - - +# `getIterator` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php#L17) ```php public function getIterator(): \Generator; ``` +***Return value:*** [\Generator](https://www.php.net/manual/en/language.generators.overview.php) +--- -Parameters: not specified - -Return value: \Generator - - -
    -
    -
    - - - +# `getOperationsLog` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php#L55) ```php public function getOperationsLog(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getOperationsLogWithoutDuplicates` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php#L68) ```php public function getOperationsLogWithoutDuplicates(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - -
      -
    • # - isFoundEntitiesOperationsLogCacheOutdated - | source code
    • -
    - +# `isFoundEntitiesOperationsLogCacheOutdated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php#L82) ```php public function isFoundEntitiesOperationsLogCacheOutdated(array $entitiesCollectionOperationsLog): bool; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entitiesCollectionOperationsLog | [array](https://www.php.net/manual/en/language.types.array.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entitiesCollectionOperationsLogarray-
    - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `loadByLanguageHandlers` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php#L22) ```php public function loadByLanguageHandlers(\BumbleDocGen\LanguageHandler\LanguageHandlersCollection $languageHandlersCollection, \BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface|null $progressBar = null): \BumbleDocGen\Core\Parser\Entity\CollectionGroupLoadEntitiesResult; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$languageHandlersCollection | [\BumbleDocGen\LanguageHandler\LanguageHandlersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/LanguageHandlersCollection.php) | - | +$progressBar | [\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntitiesLoaderProgressBarInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $languageHandlersCollection\BumbleDocGen\LanguageHandler\LanguageHandlersCollection-
    $progressBar\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface | null-
    - -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionGroupLoadEntitiesResult - - -
    -
    -
    - - +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionGroupLoadEntitiesResult](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionGroupLoadEntitiesResult.php) +--- + +# `updateAllEntitiesCache` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php#L96) ```php public function updateAllEntitiesCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md index bf4f2465..044f4972 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md @@ -1,1502 +1,619 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP class constant reflection API / ClassConstantEntity
    - -

    - ClassConstantEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[PHP class constant reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md) **/** +ClassConstantEntity +--- +# [ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L24) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant; class ClassConstantEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity implements \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface ``` - -
    Class constant entity
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    2. -
    3. - getAst - - Get AST for this entity
    4. -
    5. - getCacheKey -
    6. -
    7. - getCachedEntityDependencies -
    8. -
    9. - getCurrentRootEntity -
    10. -
    11. - getDescription - - Get entity description
    12. -
    13. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    14. -
    15. - getDocBlock - - Get DocBlock for current entity
    16. -
    17. - getDocComment - - Get the doc comment of an entity
    18. -
    19. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    20. -
    21. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    22. -
    23. - getDocNote - - Get the note annotation value
    24. -
    25. - getEndLine - - Get the line number of the end of a constant's code in a file
    26. -
    27. - getExamples - - Get parsed examples from `examples` doc block
    28. -
    29. - getFileSourceLink -
    30. -
    31. - getFirstExample - - Get first example from `examples` doc block
    32. -
    33. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    34. -
    35. - getImplementingClassName -
    36. -
    37. - getName - - Constant name
    38. -
    39. - getNamespaceName - - Get the name of the namespace where the current class is implemented
    40. -
    41. - getObjectId - - Get entity unique ID
    42. -
    43. - getRelativeFileName - - File name relative to project_root configuration parameter
    44. -
    45. - getRootEntity - - Get the class like entity where this constant was obtained
    46. -
    47. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    48. -
    49. - getShortName - - Constant short name
    50. -
    51. - getStartLine - - Get the line number of the beginning of the constant code in a file
    52. -
    53. - getThrows - - Get parsed throws from `throws` doc block
    54. -
    55. - getThrowsDocBlockLinks -
    56. -
    57. - getValue - - Get the compiled value of a constant
    58. -
    59. - hasDescriptionLinks - - Checking if an entity has links in its description
    60. -
    61. - hasExamples - - Checking if an entity has `example` docBlock
    62. -
    63. - hasThrows - - Checking if an entity has `throws` docBlock
    64. -
    65. - isApi - - Checking if an entity has `api` docBlock
    66. -
    67. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    68. -
    69. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    70. -
    71. - isEntityDataCacheOutdated -
    72. -
    73. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    74. -
    75. - isInternal - - Checking if an entity has `internal` docBlock
    76. -
    77. - isPrivate - - Check if a constant is a private constant
    78. -
    79. - isProtected - - Check if a constant is a protected constant
    80. -
    81. - isPublic - - Check if a constant is a public constant
    82. -
    83. - reloadEntityDependenciesCache - - Update entity dependency cache
    84. -
    85. - removeEntityValueFromCache -
    86. -
    87. - removeNotUsedEntityDataCache -
    88. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Class constant entity + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getEndLine](#mgetendline) - Get the line number of the end of a constant's code in a file +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getImplementingClassName](#mgetimplementingclassname) +1. [getModifiersString](#mgetmodifiersstring) - Get a text representation of class constant modifiers +1. [getName](#mgetname) - Constant name +1. [getNamespaceName](#mgetnamespacename) - Get the name of the namespace where the current class is implemented +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntity](#mgetrootentity) - Get the class like entity where this constant was obtained +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Constant short name +1. [getStartLine](#mgetstartline) - Get the line number of the beginning of the constant code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getType](#mgettype) - Get current class constant type +1. [getValue](#mgetvalue) - Get the compiled value of a constant +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isPrivate](#misprivate) - Check if a constant is a private constant +1. [isProtected](#misprotected) - Check if a constant is a protected constant +1. [isPublic](#mispublic) - Check if a constant is a public constant +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L55) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity $classEntity, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $constantName, string $implementingClassName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$classEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$implementingClassName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $classEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $constantNamestring-
    $implementingClassNamestring-
    - - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L93) ```php public function getAst(): \PhpParser\Node\Stmt\ClassConst; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\ClassConst - - -Throws: - - -
    -
    -
    +***Return value:*** [\PhpParser\Node\Stmt\ClassConst](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/ClassConst.php) - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    - +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    +***Return value:*** [\phpDocumentor\Reflection\DocBlock](https://github.com/phpDocumentor/ReflectionDocBlock/blob/master/src/DocBlock.php) -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    - +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L129) ```php public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -
    -
    -
    - - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    - -Parameters: not specified - -Return value: null | int - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L275) ```php public function getEndLine(): int; ``` +Get the line number of the end of a constant's code in a file -
    Get the line number of the end of a constant's code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    +--- +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - - -Throws: - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L121) ```php public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -
    -
    -
    - - - +# `getImplementingClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L113) ```php public function getImplementingClassName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L169) +```php +public function getModifiersString(): string; +``` +Get a text representation of class constant modifiers -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L137) ```php public function getName(): string; ``` +Constant name -
    Constant name
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L157) ```php public function getNamespaceName(): string; ``` +Get the name of the namespace where the current class is implemented -
    Get the name of the namespace where the current class is implemented
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L185) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L90) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified - -Return value: null | string - - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -See: - -
    -
    -
    +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) - +--- +# `getRootEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L83) ```php public function getRootEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity where this constant was obtained -
    Get the class like entity where this constant was obtained
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - +--- +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L75) ```php public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) - +--- +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L147) ```php public function getShortName(): string; ``` +Constant short name -
    Constant short name
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::getName()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity_2.md#mgetname) -Return value: string - - - -See: - -
    -
    -
    - - +--- +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L263) ```php public function getStartLine(): int; ``` +Get the line number of the beginning of the constant code in a file -
    Get the line number of the beginning of the constant code in a file
    - -Parameters: not specified - -Return value: int - - -Throws: - - -
    -
    -
    - - +--- +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - +# `getType` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L191) +```php +public function getType(): string; +``` +Get current class constant type -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L290) ```php public function getValue(): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) -Return value: string | array | int | bool | null | float - - -Throws: - - -
    -
    -
    - - +--- +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isPrivate` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L251) ```php public function isPrivate(): bool; ``` +Check if a constant is a private constant -
    Check if a constant is a private constant
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isProtected` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L239) ```php public function isProtected(): bool; ``` +Check if a constant is a protected constant -
    Check if a constant is a protected constant
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isPublic` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L227) ```php public function isPublic(): bool; ``` +Check if a constant is a public constant -
    Check if a constant is a public constant
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity_2.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity_2.md index 0254d7cc..3118a62d 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity_2.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity_2.md @@ -1,1502 +1,618 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / ClassConstantEntity
    - -

    - ClassConstantEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +ClassConstantEntity +--- +# [ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L24) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant; class ClassConstantEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity implements \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface ``` - -
    Class constant entity
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    2. -
    3. - getAst - - Get AST for this entity
    4. -
    5. - getCacheKey -
    6. -
    7. - getCachedEntityDependencies -
    8. -
    9. - getCurrentRootEntity -
    10. -
    11. - getDescription - - Get entity description
    12. -
    13. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    14. -
    15. - getDocBlock - - Get DocBlock for current entity
    16. -
    17. - getDocComment - - Get the doc comment of an entity
    18. -
    19. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    20. -
    21. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    22. -
    23. - getDocNote - - Get the note annotation value
    24. -
    25. - getEndLine - - Get the line number of the end of a constant's code in a file
    26. -
    27. - getExamples - - Get parsed examples from `examples` doc block
    28. -
    29. - getFileSourceLink -
    30. -
    31. - getFirstExample - - Get first example from `examples` doc block
    32. -
    33. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    34. -
    35. - getImplementingClassName -
    36. -
    37. - getName - - Constant name
    38. -
    39. - getNamespaceName - - Get the name of the namespace where the current class is implemented
    40. -
    41. - getObjectId - - Get entity unique ID
    42. -
    43. - getRelativeFileName - - File name relative to project_root configuration parameter
    44. -
    45. - getRootEntity - - Get the class like entity where this constant was obtained
    46. -
    47. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    48. -
    49. - getShortName - - Constant short name
    50. -
    51. - getStartLine - - Get the line number of the beginning of the constant code in a file
    52. -
    53. - getThrows - - Get parsed throws from `throws` doc block
    54. -
    55. - getThrowsDocBlockLinks -
    56. -
    57. - getValue - - Get the compiled value of a constant
    58. -
    59. - hasDescriptionLinks - - Checking if an entity has links in its description
    60. -
    61. - hasExamples - - Checking if an entity has `example` docBlock
    62. -
    63. - hasThrows - - Checking if an entity has `throws` docBlock
    64. -
    65. - isApi - - Checking if an entity has `api` docBlock
    66. -
    67. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    68. -
    69. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    70. -
    71. - isEntityDataCacheOutdated -
    72. -
    73. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    74. -
    75. - isInternal - - Checking if an entity has `internal` docBlock
    76. -
    77. - isPrivate - - Check if a constant is a private constant
    78. -
    79. - isProtected - - Check if a constant is a protected constant
    80. -
    81. - isPublic - - Check if a constant is a public constant
    82. -
    83. - reloadEntityDependenciesCache - - Update entity dependency cache
    84. -
    85. - removeEntityValueFromCache -
    86. -
    87. - removeNotUsedEntityDataCache -
    88. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Class constant entity + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getEndLine](#mgetendline) - Get the line number of the end of a constant's code in a file +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getImplementingClassName](#mgetimplementingclassname) +1. [getModifiersString](#mgetmodifiersstring) - Get a text representation of class constant modifiers +1. [getName](#mgetname) - Constant name +1. [getNamespaceName](#mgetnamespacename) - Get the name of the namespace where the current class is implemented +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntity](#mgetrootentity) - Get the class like entity where this constant was obtained +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Constant short name +1. [getStartLine](#mgetstartline) - Get the line number of the beginning of the constant code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getType](#mgettype) - Get current class constant type +1. [getValue](#mgetvalue) - Get the compiled value of a constant +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isPrivate](#misprivate) - Check if a constant is a private constant +1. [isProtected](#misprotected) - Check if a constant is a protected constant +1. [isPublic](#mispublic) - Check if a constant is a public constant +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L55) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity $classEntity, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $constantName, string $implementingClassName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$classEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$implementingClassName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $classEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $constantNamestring-
    $implementingClassNamestring-
    - - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L93) ```php public function getAst(): \PhpParser\Node\Stmt\ClassConst; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\ClassConst - - -Throws: - - -
    -
    -
    +***Return value:*** [\PhpParser\Node\Stmt\ClassConst](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/ClassConst.php) - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    - +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    +***Return value:*** [\phpDocumentor\Reflection\DocBlock](https://github.com/phpDocumentor/ReflectionDocBlock/blob/master/src/DocBlock.php) -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    - +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L129) ```php public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -
    -
    -
    - - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    - -Parameters: not specified - -Return value: null | int - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L275) ```php public function getEndLine(): int; ``` +Get the line number of the end of a constant's code in a file -
    Get the line number of the end of a constant's code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    +--- +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - - -Throws: - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L121) ```php public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -
    -
    -
    - - - +# `getImplementingClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L113) ```php public function getImplementingClassName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L169) +```php +public function getModifiersString(): string; +``` +Get a text representation of class constant modifiers -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L137) ```php public function getName(): string; ``` +Constant name -
    Constant name
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L157) ```php public function getNamespaceName(): string; ``` +Get the name of the namespace where the current class is implemented -
    Get the name of the namespace where the current class is implemented
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L185) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L90) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified - -Return value: null | string - - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -See: - -
    -
    -
    +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) - +--- +# `getRootEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L83) ```php public function getRootEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity where this constant was obtained -
    Get the class like entity where this constant was obtained
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - +--- +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L75) ```php public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) - +--- +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L147) ```php public function getShortName(): string; ``` +Constant short name -
    Constant short name
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::getName()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity_2.md#mgetname) -Return value: string - - - -See: - -
    -
    -
    - - +--- +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L263) ```php public function getStartLine(): int; ``` +Get the line number of the beginning of the constant code in a file -
    Get the line number of the beginning of the constant code in a file
    - -Parameters: not specified - -Return value: int - - -Throws: - - -
    -
    -
    - - +--- +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - +# `getType` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L191) +```php +public function getType(): string; +``` +Get current class constant type -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L290) ```php public function getValue(): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) -Return value: string | array | int | bool | null | float - - -Throws: - - -
    -
    -
    - - +--- +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isPrivate` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L251) ```php public function isPrivate(): bool; ``` +Check if a constant is a private constant -
    Check if a constant is a private constant
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isProtected` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L239) ```php public function isProtected(): bool; ``` +Check if a constant is a protected constant -
    Check if a constant is a protected constant
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isPublic` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L227) ```php public function isPublic(): bool; ``` +Check if a constant is a public constant -
    Check if a constant is a public constant
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md index 7401aedc..efc264e5 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md @@ -1,3463 +1,1366 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP class reflection API / ClassEntity
    - -

    - ClassEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[PHP class reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md) **/** +ClassEntity +--- +# [ClassEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L15) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; class ClassEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity implements \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface, \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface ``` - -
    PHP Class
    - -See: - - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - addPluginData - - Add information to aт entity object
    2. -
    3. - cursorToDocAttributeLinkFragment -
    4. -
    5. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    6. -
    7. - getAst - - Get AST for this entity
    8. -
    9. - getCacheKey -
    10. -
    11. - getCachedEntityDependencies -
    12. -
    13. - getConstant - - Get the method entity by its name
    14. -
    15. - getConstantEntitiesCollection - - Get a collection of constant entities
    16. -
    17. - getConstantValue - - Get the compiled value of a constant
    18. -
    19. - getConstants - - Get all constants that are available according to the configuration as an array
    20. -
    21. - getConstantsData - - Get a list of all constants and classes where they are implemented
    22. -
    23. - getConstantsValues - - Get class constant compiled values according to filters
    24. -
    25. - getCurrentRootEntity -
    26. -
    27. - getDescription - - Get entity description
    28. -
    29. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    30. -
    31. - getDocBlock - - Get DocBlock for current entity
    32. -
    33. - getDocComment - - Get the doc comment of an entity
    34. -
    35. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    36. -
    37. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    38. -
    39. - getDocNote - - Get the note annotation value
    40. -
    41. - getDocRender -
    42. -
    43. - getEndLine - - Get the line number of the end of a class code in a file
    44. -
    45. - getEntityDependencies -
    46. -
    47. - getExamples - - Get parsed examples from `examples` doc block
    48. -
    49. - getFileContent -
    50. -
    51. - getFileSourceLink -
    52. -
    53. - getFirstExample - - Get first example from `examples` doc block
    54. -
    55. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    56. -
    57. - getInterfaceNames - - Get a list of class interface names
    58. -
    59. - getInterfacesEntities - - Get a list of interface entities that the current class implements
    60. -
    61. - getMethod - - Get the method entity by its name
    62. -
    63. - getMethodEntitiesCollection - - Get a collection of method entities
    64. -
    65. - getMethods - - Get all methods that are available according to the configuration as an array
    66. -
    67. - getMethodsData - - Get a list of all methods and classes where they are implemented
    68. -
    69. - getModifiersString - - Get entity modifiers as a string
    70. -
    71. - getName - - Full name of the entity
    72. -
    73. - getNamespaceName - - Get the entity namespace name
    74. -
    75. - getObjectId - - Get entity unique ID
    76. -
    77. - getParentClass - - Get the entity of the parent class if it exists
    78. -
    79. - getParentClassEntities - - Get a list of parent class entities
    80. -
    81. - getParentClassName - - Get the name of the parent class entity if it exists
    82. -
    83. - getParentClassNames - - Get a list of entity names of parent classes
    84. -
    85. - getPluginData - - Get additional information added using the plugin
    86. -
    87. - getProperties - - Get all properties that are available according to the configuration as an array
    88. -
    89. - getPropertiesData - - Get a list of all properties and classes where they are implemented
    90. -
    91. - getProperty - - Get the property entity by its name
    92. -
    93. - getPropertyDefaultValue - - Get the compiled value of a property
    94. -
    95. - getPropertyEntitiesCollection - - Get a collection of property entities
    96. -
    97. - getRelativeFileName - - File name relative to project_root configuration parameter
    98. -
    99. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    100. -
    101. - getShortName - - Short name of the entity
    102. -
    103. - getStartLine - - Get the line number of the start of a class code in a file
    104. -
    105. - getThrows - - Get parsed throws from `throws` doc block
    106. -
    107. - getThrowsDocBlockLinks -
    108. -
    109. - getTraits - - Get a list of trait entities of the current class
    110. -
    111. - getTraitsNames - - Get a list of class traits names
    112. -
    113. - hasConstant - - Check if a constant exists in a class
    114. -
    115. - hasDescriptionLinks - - Checking if an entity has links in its description
    116. -
    117. - hasExamples - - Checking if an entity has `example` docBlock
    118. -
    119. - hasMethod - - Check if a method exists in a class
    120. -
    121. - hasParentClass - - Check if a certain parent class exists in a chain of parent classes
    122. -
    123. - hasProperty - - Check if a property exists in a class
    124. -
    125. - hasThrows - - Checking if an entity has `throws` docBlock
    126. -
    127. - hasTraits - - Check if the class contains traits
    128. -
    129. - implementsInterface - - Check if a class implements an interface
    130. -
    131. - isAbstract - - Check that an entity is abstract
    132. -
    133. - isApi - - Checking if an entity has `api` docBlock
    134. -
    135. - isAttribute - - Check if a class is an attribute
    136. -
    137. - isClass - - Check if an entity is a Class
    138. -
    139. - isClassLoad -
    140. -
    141. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    142. -
    143. - isDocumentCreationAllowed -
    144. -
    145. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    146. -
    147. - isEntityDataCacheOutdated -
    148. -
    149. - isEntityDataCanBeLoaded -
    150. -
    151. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    152. -
    153. - isEntityNameValid - - Check if the name is a valid name for ClassLikeEntity
    154. -
    155. - isEnum - - Check if an entity is an Enum
    156. -
    157. - isExternalLibraryEntity - - Check if a given entity is an entity from a third party library (connected via composer)
    158. -
    159. - isInGit - - Checking if class file is in git repository
    160. -
    161. - isInstantiable - - Check that an entity is instantiable
    162. -
    163. - isInterface - - Check if an entity is an Interface
    164. -
    165. - isInternal - - Checking if an entity has `internal` docBlock
    166. -
    167. - isSubclassOf - - Whether the given class is a subclass of the specified class
    168. -
    169. - isTrait - - Check if an entity is a Trait
    170. -
    171. - normalizeClassName - - Bring the class name to the standard format used in the system
    172. -
    173. - reloadEntityDependenciesCache - - Update entity dependency cache
    174. -
    175. - removeEntityValueFromCache -
    176. -
    177. - removeNotUsedEntityDataCache -
    178. -
    179. - setCustomAst -
    180. -
    - - - - - - - -

    Method details:

    - -
    - - - +PHP Class + +***Links:*** +- [https://www.php.net/manual/en/language.oop5.php](https://www.php.net/manual/en/language.oop5.php) + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [addPluginData](#maddplugindata) - Add information to aт entity object +1. [cursorToDocAttributeLinkFragment](#mcursortodocattributelinkfragment) +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getConstant](#mgetconstant) - Get the method entity by its name +1. [getConstantEntitiesCollection](#mgetconstantentitiescollection) - Get a collection of constant entities +1. [getConstantValue](#mgetconstantvalue) - Get the compiled value of a constant +1. [getConstants](#mgetconstants) - Get all constants that are available according to the configuration as an array +1. [getConstantsData](#mgetconstantsdata) - Get a list of all constants and classes where they are implemented +1. [getConstantsValues](#mgetconstantsvalues) - Get class constant compiled values according to filters +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getDocRender](#mgetdocrender) +1. [getEndLine](#mgetendline) - Get the line number of the end of a class code in a file +1. [getEntityDependencies](#mgetentitydependencies) +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getInterfaceNames](#mgetinterfacenames) - Get a list of class interface names +1. [getInterfacesEntities](#mgetinterfacesentities) - Get a list of interface entities that the current class implements +1. [getMethod](#mgetmethod) - Get the method entity by its name +1. [getMethodEntitiesCollection](#mgetmethodentitiescollection) - Get a collection of method entities +1. [getMethods](#mgetmethods) - Get all methods that are available according to the configuration as an array +1. [getMethodsData](#mgetmethodsdata) - Get a list of all methods and classes where they are implemented +1. [getModifiersString](#mgetmodifiersstring) - Get entity modifiers as a string +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Get the entity namespace name +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getParentClass](#mgetparentclass) - Get the entity of the parent class if it exists +1. [getParentClassEntities](#mgetparentclassentities) - Get a list of parent class entities +1. [getParentClassName](#mgetparentclassname) - Get the name of the parent class entity if it exists +1. [getParentClassNames](#mgetparentclassnames) - Get a list of entity names of parent classes +1. [getPluginData](#mgetplugindata) - Get additional information added using the plugin +1. [getProperties](#mgetproperties) - Get all properties that are available according to the configuration as an array +1. [getPropertiesData](#mgetpropertiesdata) - Get a list of all properties and classes where they are implemented +1. [getProperty](#mgetproperty) - Get the property entity by its name +1. [getPropertyDefaultValue](#mgetpropertydefaultvalue) - Get the compiled value of a property +1. [getPropertyEntitiesCollection](#mgetpropertyentitiescollection) - Get a collection of property entities +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getTraits](#mgettraits) - Get a list of trait entities of the current class +1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names +1. [hasConstant](#mhasconstant) - Check if a constant exists in a class +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasMethod](#mhasmethod) - Check if a method exists in a class +1. [hasParentClass](#mhasparentclass) - Check if a certain parent class exists in a chain of parent classes +1. [hasProperty](#mhasproperty) - Check if a property exists in a class +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [hasTraits](#mhastraits) - Check if the class contains traits +1. [implementsInterface](#mimplementsinterface) - Check if a class implements an interface +1. [isAbstract](#misabstract) - Check that an entity is abstract +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isAttribute](#misattribute) - Check if a class is an attribute +1. [isClass](#misclass) - Check if an entity is a Class +1. [isClassLoad](#misclassload) +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isDocumentCreationAllowed](#misdocumentcreationallowed) +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isEntityNameValid](#misentitynamevalid) - Check if the name is a valid name for ClassLikeEntity +1. [isEnum](#misenum) - Check if an entity is an Enum +1. [isExternalLibraryEntity](#misexternallibraryentity) - Check if a given entity is an entity from a third party library (connected via composer) +1. [isInGit](#misingit) - Checking if class file is in git repository +1. [isInstantiable](#misinstantiable) - Check that an entity is instantiable +1. [isInterface](#misinterface) - Check if an entity is an Interface +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isSubclassOf](#missubclassof) - Whether the given class is a subclass of the specified class +1. [isTrait](#mistrait) - Check if an entity is a Trait +1. [normalizeClassName](#mnormalizeclassname) - Bring the class name to the standard format used in the system +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) +1. [setCustomAst](#msetcustomast) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L51) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection $entitiesCollection, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper $composerHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $className, string|null $relativeFileName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$entitiesCollection | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$composerHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ComposerHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$relativeFileName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $entitiesCollection\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $composerHelper\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $classNamestring-
    $relativeFileNamestring | null-
    - - - -
    -
    -
    - - +--- +# `addPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function addPluginData(string $pluginKey, mixed $data): void; ``` +Add information to aт entity object -
    Add information to aт entity object
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$data | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    $datamixed-
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Return value: void - - -
    -
    -
    - -
      -
    • # - cursorToDocAttributeLinkFragment - :warning: Is internal | source code
    • -
    +--- +# `cursorToDocAttributeLinkFragment` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1286) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function cursorToDocAttributeLinkFragment(string $cursor, bool $isForDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $cursorstring-
    $isForDocumentbool-
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L296) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getAst(): \PhpParser\Node\Stmt\Class_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\Class_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ - +***Return value:*** [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) | [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) | [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) -Throws: - - -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L806) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstant(string $constantName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant whose entity you want to get
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity - - -Throws: - - -
    -
    -
    - - +--- +# `getConstantEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L736) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection; ``` +Get a collection of constant entities -
    Get a collection of constant entities
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +--- -Throws: - - - -See: - -
    -
    -
    - - - +# `getConstantValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L829) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantValue(string $constantName): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant for which you need to get the value
    +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant for which you need to get the value | -Return value: string | array | int | bool | null | float +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) +--- -Throws: - - -
    -
    -
    - - - +# `getConstants` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L765) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstants(): array; ``` +Get all constants that are available according to the configuration as an array -
    Get all constants that are available according to the configuration as an array
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +--- -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getConstantsData - :warning: Is internal | source code
    • -
    - +# `getConstantsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L661) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all constants and classes where they are implemented -
    Get a list of all constants and classes where they are implemented
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for constants from the current class
    $flagsintGet data only for constants corresponding to the visibility modifiers passed in this value
    +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for constants corresponding to the visibility modifiers passed in this value | -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Throws: - - -
    -
    -
    - - - +# `getConstantsValues` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L849) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantsValues(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get class constant compiled values according to filters -
    Get class constant compiled values according to filters
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet values only for constants from the current class
    $flagsintGet values only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array - +***Parameters:*** -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    +--- +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    - -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock +***Return value:*** [\phpDocumentor\Reflection\DocBlock](https://github.com/phpDocumentor/ReflectionDocBlock/blob/master/src/DocBlock.php) +--- -Throws: - - -
    -
    -
    - - - +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    +--- +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L236) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -
    -
    -
    - - - +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    - -Parameters: not specified - -Return value: null | int +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) +--- -Throws: - - -
    -
    -
    - - - +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocRender` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1262) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getDocRender(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRendererInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface - - -Throws: - - -
    -
    -
    - - - +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L469) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getEndLine(): int; ``` +Get the line number of the end of a class code in a file -
    Get the line number of the end of a class code in a file
    - -Parameters: not specified - -Return value: int - - -Throws: - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -
    -
    -
    - - +--- +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Throws: - - -
    -
    -
    - - - +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1035) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    - +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - - -Throws: - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L370) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - +--- +# `getInterfaceNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L530) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getInterfaceNames(): array; ``` +Get a list of class interface names -
    Get a list of class interface names
    - -Parameters: not specified - -Return value: array - - -Throws: - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - - +--- +# `getInterfacesEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L587) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getInterfacesEntities(): array; ``` +Get a list of interface entities that the current class implements -
    Get a list of interface entities that the current class implements
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1203) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethod(string $methodName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to get
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity - - -Throws: - - -
    -
    -
    - - +--- +# `getMethodEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1133) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethodEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; ``` +Get a collection of method entities -
    Get a collection of method entities
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +--- -Throws: - - - -See: - -
    -
    -
    - - - +# `getMethods` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1162) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethods(): array; ``` +Get all methods that are available according to the configuration as an array -
    Get all methods that are available according to the configuration as an array
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +--- -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getMethodsData - :warning: Is internal | source code
    • -
    - +# `getMethodsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1059) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethodsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all methods and classes where they are implemented -
    Get a list of all methods and classes where they are implemented
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for methods from the current class
    $flagsintGet data only for methods corresponding to the visibility modifiers passed in this value
    +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for methods from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for methods corresponding to the visibility modifiers passed in this value | -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Throws: - - -
    -
    -
    - - - +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L120) ```php public function getModifiersString(): string; ``` +Get entity modifiers as a string -
    Get entity modifiers as a string
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L378) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -
    -
    -
    - - +--- +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L397) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getNamespaceName(): string; ``` +Get the entity namespace name -
    Get the entity namespace name
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L142) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -
    -
    -
    - - +--- +# `getParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L106) ```php public function getParentClass(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the entity of the parent class if it exists -
    Get the entity of the parent class if it exists
    - -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) - +--- +# `getParentClassEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClassEntities(): array; ``` +Get a list of parent class entities -
    Get a list of parent class entities
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified - -Return value: array - - -
    -
    -
    - - +--- +# `getParentClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L93) ```php public function getParentClassName(): null|string; ``` +Get the name of the parent class entity if it exists -
    Get the name of the parent class entity if it exists
    - -Parameters: not specified - -Return value: null | string - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L72) ```php public function getParentClassNames(): array; ``` +Get a list of entity names of parent classes -
    Get a list of entity names of parent classes
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified - -Return value: array - - -
    -
    -
    - - +--- +# `getPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L270) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPluginData(string $pluginKey): mixed; ``` +Get additional information added using the plugin -
    Get additional information added using the plugin
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    - -Return value: mixed +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) - +--- +# `getProperties` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L963) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getProperties(): array; ``` +Get all properties that are available according to the configuration as an array -
    Get all properties that are available according to the configuration as an array
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) -Return value: array - - -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getPropertiesData - :warning: Is internal | source code
    • -
    +--- +# `getPropertiesData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L872) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertiesData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all properties and classes where they are implemented -
    Get a list of all properties and classes where they are implemented
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for properties from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for properties corresponding to the visibility modifiers passed in this value | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for properties from the current class
    $flagsintGet data only for properties corresponding to the visibility modifiers passed in this value
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1004) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getProperty(string $propertyName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; ``` +Get the property entity by its name -
    Get the property entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to get
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | -Throws: - - -
    -
    -
    - - +--- +# `getPropertyDefaultValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1027) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertyDefaultValue(string $propertyName): string|array|int|bool|null|float; ``` +Get the compiled value of a property -
    Get the compiled value of a property
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property for which you need to get the value
    - -Return value: string | array | int | bool | null | float - +***Parameters:*** -Throws: - - -
    -
    -
    - - +--- +# `getPropertyEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L934) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertyEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection; ``` +Get a collection of property entities -
    Get a collection of property entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection - - -Throws: - - - -See: - -
    -
    -
    - - +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L412) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified - -Return value: null | string - - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -See: - -
    -
    -
    +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) - +--- +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L160) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -
    -
    -
    - - +--- +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L386) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L457) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getStartLine(): int; ``` +Get the line number of the start of a class code in a file -
    Get the line number of the start of a class code in a file
    +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -Parameters: not specified - -Return value: int - - -Throws: - - -
    -
    -
    - - +--- +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Throws: - - -
    -
    -
    - - - +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getTraits(): array; ``` +Get a list of trait entities of the current class -
    Get a list of trait entities of the current class
    - -Parameters: not specified - -Return value: array - - -Throws: - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - - +--- +# `getTraitsNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L604) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getTraitsNames(): array; ``` +Get a list of class traits names -
    Get a list of class traits names
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `hasConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L785) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasConstant(string $constantName, bool $unsafe = false): bool; ``` +Check if a constant exists in a class -
    Check if a constant exists in a class
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the class whose entity you want to check
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the class whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1182) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasMethod(string $methodName, bool $unsafe = false): bool; ``` +Check if a method exists in a class -
    Check if a method exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to check
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1250) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasParentClass(string $parentClassName): bool; ``` +Check if a certain parent class exists in a chain of parent classes -
    Check if a certain parent class exists in a chain of parent classes
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamestringSearched parent class
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$parentClassName | [string](https://www.php.net/manual/en/language.types.string.php) | Searched parent class | -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L983) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasProperty(string $propertyName, bool $unsafe = false): bool; ``` +Check if a property exists in a class -
    Check if a property exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to check
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: bool - +***Parameters:*** -Throws: - - -
    -
    -
    - - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L644) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasTraits(): bool; ``` +Check if the class contains traits -
    Check if the class contains traits
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `implementsInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1237) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function implementsInterface(string $interfaceName): bool; ``` +Check if a class implements an interface -
    Check if a class implements an interface
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$interfaceName | [string](https://www.php.net/manual/en/language.types.string.php) | Name of the required interface in the interface chain | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfaceNamestringName of the required interface in the interface chain
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isAbstract` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L43) ```php public function isAbstract(): bool; ``` +Check that an entity is abstract -
    Check that an entity is abstract
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isAttribute` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L55) ```php public function isAttribute(): bool; ``` +Check if a class is an attribute -
    Check if a class is an attribute
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L20) ```php public function isClass(): bool; ``` +Check if an entity is a Class -
    Check if an entity is a Class
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isClassLoad` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L343) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isClassLoad(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - isDocumentCreationAllowed - :warning: Is internal | source code
    • -
    - +# `isDocumentCreationAllowed` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L224) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isDocumentCreationAllowed(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L358) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isEntityDataCanBeLoaded(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L84) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public static function isEntityNameValid(string $entityName): bool; ``` +Check if the name is a valid name for ClassLikeEntity -
    Check if the name is a valid name for ClassLikeEntity
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isEnum` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L134) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isEnum(): bool; ``` +Check if an entity is an Enum -
    Check if an entity is an Enum
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - -
      -
    • # - isExternalLibraryEntity - :warning: Is internal | source code
    • -
    +--- +# `isExternalLibraryEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L152) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isExternalLibraryEntity(): bool; ``` +Check if a given entity is an entity from a third party library (connected via composer) -
    Check if a given entity is an entity from a third party library (connected via composer)
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInGit` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L205) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInGit(): bool; ``` +Checking if class file is in git repository -
    Checking if class file is in git repository
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassEntity.php#L30) ```php public function isInstantiable(): bool; ``` +Check that an entity is instantiable -
    Check that an entity is instantiable
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L114) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInterface(): bool; ``` +Check if an entity is an Interface -
    Check if an entity is an Interface
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isSubclassOf` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1219) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isSubclassOf(string $className): bool; ``` +Whether the given class is a subclass of the specified class -
    Whether the given class is a subclass of the specified class
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classNamestring-
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Throws: - - -
    -
    -
    - - +--- +# `isTrait` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L124) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isTrait(): bool; ``` +Check if an entity is a Trait -
    Check if an entity is a Trait
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L94) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public static function normalizeClassName(string $name): string; ``` +Bring the class name to the standard format used in the system -
    Bring the class name to the standard format used in the system
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    +***Parameters:*** -Return value: string +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - - - +# `setCustomAst` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L284) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function setCustomAst(\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Class_|null $customAst): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$customAst | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) \| [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) \| [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) \| [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $customAst\PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Class_ | null-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity.md index f46f99aa..bf560140 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity.md @@ -1,12 +1,15 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP trait reflection API / ClassLikeEntity
    - -

    - ClassLikeEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[PHP trait reflection API](/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md) **/** +ClassLikeEntity +--- +# [ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L44) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; @@ -14,3301 +17,1223 @@ namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; abstract class ClassLikeEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity implements \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface, \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface ``` - - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - addPluginData - - Add information to aт entity object
    2. -
    3. - cursorToDocAttributeLinkFragment -
    4. -
    5. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    6. -
    7. - getAst - - Get AST for this entity
    8. -
    9. - getCacheKey -
    10. -
    11. - getCachedEntityDependencies -
    12. -
    13. - getConstant - - Get the method entity by its name
    14. -
    15. - getConstantEntitiesCollection - - Get a collection of constant entities
    16. -
    17. - getConstantValue - - Get the compiled value of a constant
    18. -
    19. - getConstants - - Get all constants that are available according to the configuration as an array
    20. -
    21. - getConstantsData - - Get a list of all constants and classes where they are implemented
    22. -
    23. - getConstantsValues - - Get class constant compiled values according to filters
    24. -
    25. - getCurrentRootEntity -
    26. -
    27. - getDescription - - Get entity description
    28. -
    29. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    30. -
    31. - getDocBlock - - Get DocBlock for current entity
    32. -
    33. - getDocComment - - Get the doc comment of an entity
    34. -
    35. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    36. -
    37. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    38. -
    39. - getDocNote - - Get the note annotation value
    40. -
    41. - getDocRender -
    42. -
    43. - getEndLine - - Get the line number of the end of a class code in a file
    44. -
    45. - getEntityDependencies -
    46. -
    47. - getExamples - - Get parsed examples from `examples` doc block
    48. -
    49. - getFileContent -
    50. -
    51. - getFileSourceLink -
    52. -
    53. - getFirstExample - - Get first example from `examples` doc block
    54. -
    55. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    56. -
    57. - getInterfaceNames - - Get a list of class interface names
    58. -
    59. - getInterfacesEntities - - Get a list of interface entities that the current class implements
    60. -
    61. - getMethod - - Get the method entity by its name
    62. -
    63. - getMethodEntitiesCollection - - Get a collection of method entities
    64. -
    65. - getMethods - - Get all methods that are available according to the configuration as an array
    66. -
    67. - getMethodsData - - Get a list of all methods and classes where they are implemented
    68. -
    69. - getModifiersString - - Get entity modifiers as a string
    70. -
    71. - getName - - Full name of the entity
    72. -
    73. - getNamespaceName - - Get the entity namespace name
    74. -
    75. - getObjectId - - Get entity unique ID
    76. -
    77. - getParentClass - - Get the entity of the parent class if it exists
    78. -
    79. - getParentClassEntities - - Get a list of parent class entities
    80. -
    81. - getParentClassName - - Get the name of the parent class entity if it exists
    82. -
    83. - getParentClassNames - - Get a list of entity names of parent classes
    84. -
    85. - getPluginData - - Get additional information added using the plugin
    86. -
    87. - getProperties - - Get all properties that are available according to the configuration as an array
    88. -
    89. - getPropertiesData - - Get a list of all properties and classes where they are implemented
    90. -
    91. - getProperty - - Get the property entity by its name
    92. -
    93. - getPropertyDefaultValue - - Get the compiled value of a property
    94. -
    95. - getPropertyEntitiesCollection - - Get a collection of property entities
    96. -
    97. - getRelativeFileName - - File name relative to project_root configuration parameter
    98. -
    99. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    100. -
    101. - getShortName - - Short name of the entity
    102. -
    103. - getStartLine - - Get the line number of the start of a class code in a file
    104. -
    105. - getThrows - - Get parsed throws from `throws` doc block
    106. -
    107. - getThrowsDocBlockLinks -
    108. -
    109. - getTraits - - Get a list of trait entities of the current class
    110. -
    111. - getTraitsNames - - Get a list of class traits names
    112. -
    113. - hasConstant - - Check if a constant exists in a class
    114. -
    115. - hasDescriptionLinks - - Checking if an entity has links in its description
    116. -
    117. - hasExamples - - Checking if an entity has `example` docBlock
    118. -
    119. - hasMethod - - Check if a method exists in a class
    120. -
    121. - hasParentClass - - Check if a certain parent class exists in a chain of parent classes
    122. -
    123. - hasProperty - - Check if a property exists in a class
    124. -
    125. - hasThrows - - Checking if an entity has `throws` docBlock
    126. -
    127. - hasTraits - - Check if the class contains traits
    128. -
    129. - implementsInterface - - Check if a class implements an interface
    130. -
    131. - isAbstract - - Check that an entity is abstract
    132. -
    133. - isApi - - Checking if an entity has `api` docBlock
    134. -
    135. - isClass - - Check if an entity is a Class
    136. -
    137. - isClassLoad -
    138. -
    139. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    140. -
    141. - isDocumentCreationAllowed -
    142. -
    143. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    144. -
    145. - isEntityDataCacheOutdated -
    146. -
    147. - isEntityDataCanBeLoaded -
    148. -
    149. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    150. -
    151. - isEntityNameValid - - Check if the name is a valid name for ClassLikeEntity
    152. -
    153. - isEnum - - Check if an entity is an Enum
    154. -
    155. - isExternalLibraryEntity - - Check if a given entity is an entity from a third party library (connected via composer)
    156. -
    157. - isInGit - - Checking if class file is in git repository
    158. -
    159. - isInstantiable - - Check that an entity is instantiable
    160. -
    161. - isInterface - - Check if an entity is an Interface
    162. -
    163. - isInternal - - Checking if an entity has `internal` docBlock
    164. -
    165. - isSubclassOf - - Whether the given class is a subclass of the specified class
    166. -
    167. - isTrait - - Check if an entity is a Trait
    168. -
    169. - normalizeClassName - - Bring the class name to the standard format used in the system
    170. -
    171. - reloadEntityDependenciesCache - - Update entity dependency cache
    172. -
    173. - removeEntityValueFromCache -
    174. -
    175. - removeNotUsedEntityDataCache -
    176. -
    177. - setCustomAst -
    178. -
    - - - - - - - -

    Method details:

    - -
    - - - +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [addPluginData](#maddplugindata) - Add information to aт entity object +1. [cursorToDocAttributeLinkFragment](#mcursortodocattributelinkfragment) +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getConstant](#mgetconstant) - Get the method entity by its name +1. [getConstantEntitiesCollection](#mgetconstantentitiescollection) - Get a collection of constant entities +1. [getConstantValue](#mgetconstantvalue) - Get the compiled value of a constant +1. [getConstants](#mgetconstants) - Get all constants that are available according to the configuration as an array +1. [getConstantsData](#mgetconstantsdata) - Get a list of all constants and classes where they are implemented +1. [getConstantsValues](#mgetconstantsvalues) - Get class constant compiled values according to filters +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getDocRender](#mgetdocrender) +1. [getEndLine](#mgetendline) - Get the line number of the end of a class code in a file +1. [getEntityDependencies](#mgetentitydependencies) +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getInterfaceNames](#mgetinterfacenames) - Get a list of class interface names +1. [getInterfacesEntities](#mgetinterfacesentities) - Get a list of interface entities that the current class implements +1. [getMethod](#mgetmethod) - Get the method entity by its name +1. [getMethodEntitiesCollection](#mgetmethodentitiescollection) - Get a collection of method entities +1. [getMethods](#mgetmethods) - Get all methods that are available according to the configuration as an array +1. [getMethodsData](#mgetmethodsdata) - Get a list of all methods and classes where they are implemented +1. [getModifiersString](#mgetmodifiersstring) - Get entity modifiers as a string +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Get the entity namespace name +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getParentClass](#mgetparentclass) - Get the entity of the parent class if it exists +1. [getParentClassEntities](#mgetparentclassentities) - Get a list of parent class entities +1. [getParentClassName](#mgetparentclassname) - Get the name of the parent class entity if it exists +1. [getParentClassNames](#mgetparentclassnames) - Get a list of entity names of parent classes +1. [getPluginData](#mgetplugindata) - Get additional information added using the plugin +1. [getProperties](#mgetproperties) - Get all properties that are available according to the configuration as an array +1. [getPropertiesData](#mgetpropertiesdata) - Get a list of all properties and classes where they are implemented +1. [getProperty](#mgetproperty) - Get the property entity by its name +1. [getPropertyDefaultValue](#mgetpropertydefaultvalue) - Get the compiled value of a property +1. [getPropertyEntitiesCollection](#mgetpropertyentitiescollection) - Get a collection of property entities +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getTraits](#mgettraits) - Get a list of trait entities of the current class +1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names +1. [hasConstant](#mhasconstant) - Check if a constant exists in a class +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasMethod](#mhasmethod) - Check if a method exists in a class +1. [hasParentClass](#mhasparentclass) - Check if a certain parent class exists in a chain of parent classes +1. [hasProperty](#mhasproperty) - Check if a property exists in a class +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [hasTraits](#mhastraits) - Check if the class contains traits +1. [implementsInterface](#mimplementsinterface) - Check if a class implements an interface +1. [isAbstract](#misabstract) - Check that an entity is abstract +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isClass](#misclass) - Check if an entity is a Class +1. [isClassLoad](#misclassload) +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isDocumentCreationAllowed](#misdocumentcreationallowed) +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isEntityNameValid](#misentitynamevalid) - Check if the name is a valid name for ClassLikeEntity +1. [isEnum](#misenum) - Check if an entity is an Enum +1. [isExternalLibraryEntity](#misexternallibraryentity) - Check if a given entity is an entity from a third party library (connected via composer) +1. [isInGit](#misingit) - Checking if class file is in git repository +1. [isInstantiable](#misinstantiable) - Check that an entity is instantiable +1. [isInterface](#misinterface) - Check if an entity is an Interface +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isSubclassOf](#missubclassof) - Whether the given class is a subclass of the specified class +1. [isTrait](#mistrait) - Check if an entity is a Trait +1. [normalizeClassName](#mnormalizeclassname) - Bring the class name to the standard format used in the system +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) +1. [setCustomAst](#msetcustomast) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L51) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection $entitiesCollection, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper $composerHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $className, string|null $relativeFileName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$entitiesCollection | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$composerHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ComposerHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$relativeFileName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $entitiesCollection\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $composerHelper\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $classNamestring-
    $relativeFileNamestring | null-
    - - - -
    -
    -
    - - +--- +# `addPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L258) ```php public function addPluginData(string $pluginKey, mixed $data): void; ``` +Add information to aт entity object -
    Add information to aт entity object
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    $datamixed-
    +***Parameters:*** -Return value: void +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$data | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - cursorToDocAttributeLinkFragment - :warning: Is internal | source code
    • -
    +--- +# `cursorToDocAttributeLinkFragment` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1286) ```php public function cursorToDocAttributeLinkFragment(string $cursor, bool $isForDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $cursorstring-
    $isForDocumentbool-
    - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L296) ```php public function getAst(): \PhpParser\Node\Stmt\Class_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\Class_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ - - -Throws: - +***Return value:*** [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) | [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) | [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L806) ```php public function getConstant(string $constantName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant whose entity you want to get
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    +***Parameters:*** -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -Throws: - - -
    -
    -
    - - +--- +# `getConstantEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L736) ```php public function getConstantEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection; ``` +Get a collection of constant entities -
    Get a collection of constant entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) -Throws: - - - -See: - -
    -
    -
    - - +--- +# `getConstantValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L829) ```php public function getConstantValue(string $constantName): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant for which you need to get the value
    - -Return value: string | array | int | bool | null | float +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant for which you need to get the value | -Throws: - - -
    -
    -
    - - +--- +# `getConstants` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L765) ```php public function getConstants(): array; ``` +Get all constants that are available according to the configuration as an array -
    Get all constants that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getConstantsData - :warning: Is internal | source code
    • -
    +--- +# `getConstantsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L661) ```php public function getConstantsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all constants and classes where they are implemented -
    Get a list of all constants and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for constants from the current class
    $flagsintGet data only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for constants corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getConstantsValues` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L849) ```php public function getConstantsValues(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get class constant compiled values according to filters -
    Get class constant compiled values according to filters
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet values only for constants from the current class
    $flagsintGet values only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    +--- +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    - -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    +--- +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L236) ```php public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    - -Parameters: not specified - -Return value: null | int - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getDocRender` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1262) ```php public function getDocRender(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRendererInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface - - -Throws: - - -
    -
    -
    - - - +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L469) ```php public function getEndLine(): int; ``` +Get the line number of the end of a class code in a file -
    Get the line number of the end of a class code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L171) ```php public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1035) ```php public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    - +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L370) ```php public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -
    -
    -
    - - +--- +# `getInterfaceNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L530) ```php public function getInterfaceNames(): array; ``` +Get a list of class interface names -
    Get a list of class interface names
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getInterfacesEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L587) ```php public function getInterfacesEntities(): array; ``` +Get a list of interface entities that the current class implements -
    Get a list of interface entities that the current class implements
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1203) ```php public function getMethod(string $methodName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to get
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +***Parameters:*** -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) -Throws: - - -
    -
    -
    - - +--- +# `getMethodEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1133) ```php public function getMethodEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; ``` +Get a collection of method entities -
    Get a collection of method entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) -Throws: - - - -See: - -
    -
    -
    - - +--- +# `getMethods` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1162) ```php public function getMethods(): array; ``` +Get all methods that are available according to the configuration as an array -
    Get all methods that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getMethodsData - :warning: Is internal | source code
    • -
    +--- +# `getMethodsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1059) ```php public function getMethodsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all methods and classes where they are implemented -
    Get a list of all methods and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for methods from the current class
    $flagsintGet data only for methods corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for methods from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for methods corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L79) ```php public function getModifiersString(): string; ``` +Get entity modifiers as a string -
    Get entity modifiers as a string
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L378) ```php public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L397) ```php public function getNamespaceName(): string; ``` +Get the entity namespace name -
    Get the entity namespace name
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L142) ```php public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L516) ```php public function getParentClass(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the entity of the parent class if it exists -
    Get the entity of the parent class if it exists
    - -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -
    -
    -
    - - - +# `getParentClassEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L493) ```php public function getParentClassEntities(): array; ``` +Get a list of parent class entities -
    Get a list of parent class entities
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -
    -
    -
    - - - +# `getParentClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L506) ```php public function getParentClassName(): null|string; ``` +Get the name of the parent class entity if it exists -
    Get the name of the parent class entity if it exists
    - -Parameters: not specified - -Return value: null | string +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L481) ```php public function getParentClassNames(): array; ``` +Get a list of entity names of parent classes -
    Get a list of entity names of parent classes
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -
    -
    -
    - - +--- +# `getPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L270) ```php public function getPluginData(string $pluginKey): mixed; ``` +Get additional information added using the plugin -
    Get additional information added using the plugin
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Return value: mixed +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) +--- -
    -
    -
    - - - +# `getProperties` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L963) ```php public function getProperties(): array; ``` +Get all properties that are available according to the configuration as an array -
    Get all properties that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getPropertiesData - :warning: Is internal | source code
    • -
    +--- +# `getPropertiesData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L872) ```php public function getPropertiesData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all properties and classes where they are implemented -
    Get a list of all properties and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for properties from the current class
    $flagsintGet data only for properties corresponding to the visibility modifiers passed in this value
    +***Parameters:*** -Return value: array +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for properties from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for properties corresponding to the visibility modifiers passed in this value | +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1004) ```php public function getProperty(string $propertyName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; ``` +Get the property entity by its name -
    Get the property entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to get
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity - - -Throws: -
      -
    • - \DI\DependencyException
    • +***Parameters:*** -
    • - \BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException
    • +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | -
    • - \DI\NotFoundException
    • +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php) -
    - -
    -
    -
    - - +--- +# `getPropertyDefaultValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1027) ```php public function getPropertyDefaultValue(string $propertyName): string|array|int|bool|null|float; ``` +Get the compiled value of a property -
    Get the compiled value of a property
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property for which you need to get the value
    - -Return value: string | array | int | bool | null | float - - -Throws: - - -
    -
    -
    - - +--- +# `getPropertyEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L934) ```php public function getPropertyEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection; ``` +Get a collection of property entities -
    Get a collection of property entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection - - -Throws: - +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +--- -See: - -
    -
    -
    - - - +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L412) ```php public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified - -Return value: null | string +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +--- -See: - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L160) ```php public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) +--- -
    -
    -
    - - - +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L386) ```php public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L457) ```php public function getStartLine(): int; ``` +Get the line number of the start of a class code in a file -
    Get the line number of the start of a class code in a file
    - -Parameters: not specified - -Return value: int +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) +--- -Throws: - - -
    -
    -
    - - - +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php public function getTraits(): array; ``` +Get a list of trait entities of the current class -
    Get a list of trait entities of the current class
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getTraitsNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L604) ```php public function getTraitsNames(): array; ``` +Get a list of class traits names -
    Get a list of class traits names
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `hasConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L785) ```php public function hasConstant(string $constantName, bool $unsafe = false): bool; ``` +Check if a constant exists in a class -
    Check if a constant exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the class whose entity you want to check
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the class whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | -Throws: - - -
    -
    -
    - - +--- +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool - - -Throws: -
      -
    • - \Exception
    • +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    - -
    -
    -
    - - +--- +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1182) ```php public function hasMethod(string $methodName, bool $unsafe = false): bool; ``` +Check if a method exists in a class -
    Check if a method exists in a class
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to check
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1250) ```php public function hasParentClass(string $parentClassName): bool; ``` +Check if a certain parent class exists in a chain of parent classes -
    Check if a certain parent class exists in a chain of parent classes
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamestringSearched parent class
    +| Name | Type | Description | +|:-|:-|:-| +$parentClassName | [string](https://www.php.net/manual/en/language.types.string.php) | Searched parent class | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `hasProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L983) ```php public function hasProperty(string $propertyName, bool $unsafe = false): bool; ``` +Check if a property exists in a class -
    Check if a property exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to check
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L644) ```php public function hasTraits(): bool; ``` +Check if the class contains traits -
    Check if the class contains traits
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `implementsInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1237) ```php public function implementsInterface(string $interfaceName): bool; ``` +Check if a class implements an interface -
    Check if a class implements an interface
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfaceNamestringName of the required interface in the interface chain
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$interfaceName | [string](https://www.php.net/manual/en/language.types.string.php) | Name of the required interface in the interface chain | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isAbstract` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L445) ```php public function isAbstract(): bool; ``` +Check that an entity is abstract -
    Check that an entity is abstract
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L104) ```php public function isClass(): bool; ``` +Check if an entity is a Class -
    Check if an entity is a Class
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isClassLoad` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L343) ```php public function isClassLoad(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - isDocumentCreationAllowed - :warning: Is internal | source code
    • -
    - +# `isDocumentCreationAllowed` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L224) ```php public function isDocumentCreationAllowed(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L358) ```php public function isEntityDataCanBeLoaded(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L84) ```php public static function isEntityNameValid(string $entityName): bool; ``` +Check if the name is a valid name for ClassLikeEntity -
    Check if the name is a valid name for ClassLikeEntity
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isEnum` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L134) ```php public function isEnum(): bool; ``` +Check if an entity is an Enum -
    Check if an entity is an Enum
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - -
      -
    • # - isExternalLibraryEntity - :warning: Is internal | source code
    • -
    +--- +# `isExternalLibraryEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L152) ```php public function isExternalLibraryEntity(): bool; ``` +Check if a given entity is an entity from a third party library (connected via composer) -
    Check if a given entity is an entity from a third party library (connected via composer)
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInGit` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L205) ```php public function isInGit(): bool; ``` +Checking if class file is in git repository -
    Checking if class file is in git repository
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L435) ```php public function isInstantiable(): bool; ``` +Check that an entity is instantiable -
    Check that an entity is instantiable
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L114) ```php public function isInterface(): bool; ``` +Check if an entity is an Interface -
    Check if an entity is an Interface
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isSubclassOf` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1219) ```php public function isSubclassOf(string $className): bool; ``` +Whether the given class is a subclass of the specified class -
    Whether the given class is a subclass of the specified class
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classNamestring-
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Throws: - - -
    -
    -
    - - +--- +# `isTrait` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L124) ```php public function isTrait(): bool; ``` +Check if an entity is a Trait -
    Check if an entity is a Trait
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L94) ```php public static function normalizeClassName(string $name): string; ``` +Bring the class name to the standard format used in the system -
    Bring the class name to the standard format used in the system
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    +***Parameters:*** -Return value: string +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - - - +# `setCustomAst` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L284) ```php public function setCustomAst(\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Class_|null $customAst): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$customAst | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) \| [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) \| [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) \| [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $customAst\PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Class_ | null-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_2.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_2.md index 89480354..416546c8 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_2.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_2.md @@ -1,12 +1,15 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP interface reflection API / ClassLikeEntity
    - -

    - ClassLikeEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[PHP interface reflection API](/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md) **/** +ClassLikeEntity +--- +# [ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L44) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; @@ -14,3301 +17,1223 @@ namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; abstract class ClassLikeEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity implements \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface, \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface ``` - - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - addPluginData - - Add information to aт entity object
    2. -
    3. - cursorToDocAttributeLinkFragment -
    4. -
    5. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    6. -
    7. - getAst - - Get AST for this entity
    8. -
    9. - getCacheKey -
    10. -
    11. - getCachedEntityDependencies -
    12. -
    13. - getConstant - - Get the method entity by its name
    14. -
    15. - getConstantEntitiesCollection - - Get a collection of constant entities
    16. -
    17. - getConstantValue - - Get the compiled value of a constant
    18. -
    19. - getConstants - - Get all constants that are available according to the configuration as an array
    20. -
    21. - getConstantsData - - Get a list of all constants and classes where they are implemented
    22. -
    23. - getConstantsValues - - Get class constant compiled values according to filters
    24. -
    25. - getCurrentRootEntity -
    26. -
    27. - getDescription - - Get entity description
    28. -
    29. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    30. -
    31. - getDocBlock - - Get DocBlock for current entity
    32. -
    33. - getDocComment - - Get the doc comment of an entity
    34. -
    35. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    36. -
    37. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    38. -
    39. - getDocNote - - Get the note annotation value
    40. -
    41. - getDocRender -
    42. -
    43. - getEndLine - - Get the line number of the end of a class code in a file
    44. -
    45. - getEntityDependencies -
    46. -
    47. - getExamples - - Get parsed examples from `examples` doc block
    48. -
    49. - getFileContent -
    50. -
    51. - getFileSourceLink -
    52. -
    53. - getFirstExample - - Get first example from `examples` doc block
    54. -
    55. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    56. -
    57. - getInterfaceNames - - Get a list of class interface names
    58. -
    59. - getInterfacesEntities - - Get a list of interface entities that the current class implements
    60. -
    61. - getMethod - - Get the method entity by its name
    62. -
    63. - getMethodEntitiesCollection - - Get a collection of method entities
    64. -
    65. - getMethods - - Get all methods that are available according to the configuration as an array
    66. -
    67. - getMethodsData - - Get a list of all methods and classes where they are implemented
    68. -
    69. - getModifiersString - - Get entity modifiers as a string
    70. -
    71. - getName - - Full name of the entity
    72. -
    73. - getNamespaceName - - Get the entity namespace name
    74. -
    75. - getObjectId - - Get entity unique ID
    76. -
    77. - getParentClass - - Get the entity of the parent class if it exists
    78. -
    79. - getParentClassEntities - - Get a list of parent class entities
    80. -
    81. - getParentClassName - - Get the name of the parent class entity if it exists
    82. -
    83. - getParentClassNames - - Get a list of entity names of parent classes
    84. -
    85. - getPluginData - - Get additional information added using the plugin
    86. -
    87. - getProperties - - Get all properties that are available according to the configuration as an array
    88. -
    89. - getPropertiesData - - Get a list of all properties and classes where they are implemented
    90. -
    91. - getProperty - - Get the property entity by its name
    92. -
    93. - getPropertyDefaultValue - - Get the compiled value of a property
    94. -
    95. - getPropertyEntitiesCollection - - Get a collection of property entities
    96. -
    97. - getRelativeFileName - - File name relative to project_root configuration parameter
    98. -
    99. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    100. -
    101. - getShortName - - Short name of the entity
    102. -
    103. - getStartLine - - Get the line number of the start of a class code in a file
    104. -
    105. - getThrows - - Get parsed throws from `throws` doc block
    106. -
    107. - getThrowsDocBlockLinks -
    108. -
    109. - getTraits - - Get a list of trait entities of the current class
    110. -
    111. - getTraitsNames - - Get a list of class traits names
    112. -
    113. - hasConstant - - Check if a constant exists in a class
    114. -
    115. - hasDescriptionLinks - - Checking if an entity has links in its description
    116. -
    117. - hasExamples - - Checking if an entity has `example` docBlock
    118. -
    119. - hasMethod - - Check if a method exists in a class
    120. -
    121. - hasParentClass - - Check if a certain parent class exists in a chain of parent classes
    122. -
    123. - hasProperty - - Check if a property exists in a class
    124. -
    125. - hasThrows - - Checking if an entity has `throws` docBlock
    126. -
    127. - hasTraits - - Check if the class contains traits
    128. -
    129. - implementsInterface - - Check if a class implements an interface
    130. -
    131. - isAbstract - - Check that an entity is abstract
    132. -
    133. - isApi - - Checking if an entity has `api` docBlock
    134. -
    135. - isClass - - Check if an entity is a Class
    136. -
    137. - isClassLoad -
    138. -
    139. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    140. -
    141. - isDocumentCreationAllowed -
    142. -
    143. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    144. -
    145. - isEntityDataCacheOutdated -
    146. -
    147. - isEntityDataCanBeLoaded -
    148. -
    149. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    150. -
    151. - isEntityNameValid - - Check if the name is a valid name for ClassLikeEntity
    152. -
    153. - isEnum - - Check if an entity is an Enum
    154. -
    155. - isExternalLibraryEntity - - Check if a given entity is an entity from a third party library (connected via composer)
    156. -
    157. - isInGit - - Checking if class file is in git repository
    158. -
    159. - isInstantiable - - Check that an entity is instantiable
    160. -
    161. - isInterface - - Check if an entity is an Interface
    162. -
    163. - isInternal - - Checking if an entity has `internal` docBlock
    164. -
    165. - isSubclassOf - - Whether the given class is a subclass of the specified class
    166. -
    167. - isTrait - - Check if an entity is a Trait
    168. -
    169. - normalizeClassName - - Bring the class name to the standard format used in the system
    170. -
    171. - reloadEntityDependenciesCache - - Update entity dependency cache
    172. -
    173. - removeEntityValueFromCache -
    174. -
    175. - removeNotUsedEntityDataCache -
    176. -
    177. - setCustomAst -
    178. -
    - - - - - - - -

    Method details:

    - -
    - - - +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [addPluginData](#maddplugindata) - Add information to aт entity object +1. [cursorToDocAttributeLinkFragment](#mcursortodocattributelinkfragment) +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getConstant](#mgetconstant) - Get the method entity by its name +1. [getConstantEntitiesCollection](#mgetconstantentitiescollection) - Get a collection of constant entities +1. [getConstantValue](#mgetconstantvalue) - Get the compiled value of a constant +1. [getConstants](#mgetconstants) - Get all constants that are available according to the configuration as an array +1. [getConstantsData](#mgetconstantsdata) - Get a list of all constants and classes where they are implemented +1. [getConstantsValues](#mgetconstantsvalues) - Get class constant compiled values according to filters +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getDocRender](#mgetdocrender) +1. [getEndLine](#mgetendline) - Get the line number of the end of a class code in a file +1. [getEntityDependencies](#mgetentitydependencies) +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getInterfaceNames](#mgetinterfacenames) - Get a list of class interface names +1. [getInterfacesEntities](#mgetinterfacesentities) - Get a list of interface entities that the current class implements +1. [getMethod](#mgetmethod) - Get the method entity by its name +1. [getMethodEntitiesCollection](#mgetmethodentitiescollection) - Get a collection of method entities +1. [getMethods](#mgetmethods) - Get all methods that are available according to the configuration as an array +1. [getMethodsData](#mgetmethodsdata) - Get a list of all methods and classes where they are implemented +1. [getModifiersString](#mgetmodifiersstring) - Get entity modifiers as a string +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Get the entity namespace name +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getParentClass](#mgetparentclass) - Get the entity of the parent class if it exists +1. [getParentClassEntities](#mgetparentclassentities) - Get a list of parent class entities +1. [getParentClassName](#mgetparentclassname) - Get the name of the parent class entity if it exists +1. [getParentClassNames](#mgetparentclassnames) - Get a list of entity names of parent classes +1. [getPluginData](#mgetplugindata) - Get additional information added using the plugin +1. [getProperties](#mgetproperties) - Get all properties that are available according to the configuration as an array +1. [getPropertiesData](#mgetpropertiesdata) - Get a list of all properties and classes where they are implemented +1. [getProperty](#mgetproperty) - Get the property entity by its name +1. [getPropertyDefaultValue](#mgetpropertydefaultvalue) - Get the compiled value of a property +1. [getPropertyEntitiesCollection](#mgetpropertyentitiescollection) - Get a collection of property entities +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getTraits](#mgettraits) - Get a list of trait entities of the current class +1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names +1. [hasConstant](#mhasconstant) - Check if a constant exists in a class +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasMethod](#mhasmethod) - Check if a method exists in a class +1. [hasParentClass](#mhasparentclass) - Check if a certain parent class exists in a chain of parent classes +1. [hasProperty](#mhasproperty) - Check if a property exists in a class +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [hasTraits](#mhastraits) - Check if the class contains traits +1. [implementsInterface](#mimplementsinterface) - Check if a class implements an interface +1. [isAbstract](#misabstract) - Check that an entity is abstract +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isClass](#misclass) - Check if an entity is a Class +1. [isClassLoad](#misclassload) +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isDocumentCreationAllowed](#misdocumentcreationallowed) +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isEntityNameValid](#misentitynamevalid) - Check if the name is a valid name for ClassLikeEntity +1. [isEnum](#misenum) - Check if an entity is an Enum +1. [isExternalLibraryEntity](#misexternallibraryentity) - Check if a given entity is an entity from a third party library (connected via composer) +1. [isInGit](#misingit) - Checking if class file is in git repository +1. [isInstantiable](#misinstantiable) - Check that an entity is instantiable +1. [isInterface](#misinterface) - Check if an entity is an Interface +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isSubclassOf](#missubclassof) - Whether the given class is a subclass of the specified class +1. [isTrait](#mistrait) - Check if an entity is a Trait +1. [normalizeClassName](#mnormalizeclassname) - Bring the class name to the standard format used in the system +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) +1. [setCustomAst](#msetcustomast) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L51) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection $entitiesCollection, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper $composerHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $className, string|null $relativeFileName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$entitiesCollection | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$composerHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ComposerHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$relativeFileName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $entitiesCollection\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $composerHelper\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $classNamestring-
    $relativeFileNamestring | null-
    - - - -
    -
    -
    - - +--- +# `addPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L258) ```php public function addPluginData(string $pluginKey, mixed $data): void; ``` +Add information to aт entity object -
    Add information to aт entity object
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    $datamixed-
    +***Parameters:*** -Return value: void +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$data | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - cursorToDocAttributeLinkFragment - :warning: Is internal | source code
    • -
    +--- +# `cursorToDocAttributeLinkFragment` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1286) ```php public function cursorToDocAttributeLinkFragment(string $cursor, bool $isForDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $cursorstring-
    $isForDocumentbool-
    - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L296) ```php public function getAst(): \PhpParser\Node\Stmt\Class_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\Class_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ - - -Throws: - +***Return value:*** [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) | [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) | [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L806) ```php public function getConstant(string $constantName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant whose entity you want to get
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    +***Parameters:*** -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -Throws: - - -
    -
    -
    - - +--- +# `getConstantEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L736) ```php public function getConstantEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection; ``` +Get a collection of constant entities -
    Get a collection of constant entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) -Throws: - - - -See: - -
    -
    -
    - - +--- +# `getConstantValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L829) ```php public function getConstantValue(string $constantName): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant for which you need to get the value
    - -Return value: string | array | int | bool | null | float +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant for which you need to get the value | -Throws: - - -
    -
    -
    - - +--- +# `getConstants` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L765) ```php public function getConstants(): array; ``` +Get all constants that are available according to the configuration as an array -
    Get all constants that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getConstantsData - :warning: Is internal | source code
    • -
    +--- +# `getConstantsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L661) ```php public function getConstantsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all constants and classes where they are implemented -
    Get a list of all constants and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for constants from the current class
    $flagsintGet data only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for constants corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getConstantsValues` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L849) ```php public function getConstantsValues(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get class constant compiled values according to filters -
    Get class constant compiled values according to filters
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet values only for constants from the current class
    $flagsintGet values only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    +--- +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    - -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    +--- +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L236) ```php public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    - -Parameters: not specified - -Return value: null | int - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getDocRender` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1262) ```php public function getDocRender(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRendererInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface - - -Throws: - - -
    -
    -
    - - - +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L469) ```php public function getEndLine(): int; ``` +Get the line number of the end of a class code in a file -
    Get the line number of the end of a class code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L171) ```php public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1035) ```php public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    - +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L370) ```php public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -
    -
    -
    - - +--- +# `getInterfaceNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L530) ```php public function getInterfaceNames(): array; ``` +Get a list of class interface names -
    Get a list of class interface names
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getInterfacesEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L587) ```php public function getInterfacesEntities(): array; ``` +Get a list of interface entities that the current class implements -
    Get a list of interface entities that the current class implements
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1203) ```php public function getMethod(string $methodName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to get
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +***Parameters:*** -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) -Throws: - - -
    -
    -
    - - +--- +# `getMethodEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1133) ```php public function getMethodEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; ``` +Get a collection of method entities -
    Get a collection of method entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) -Throws: - - - -See: - -
    -
    -
    - - +--- +# `getMethods` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1162) ```php public function getMethods(): array; ``` +Get all methods that are available according to the configuration as an array -
    Get all methods that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getMethodsData - :warning: Is internal | source code
    • -
    +--- +# `getMethodsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1059) ```php public function getMethodsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all methods and classes where they are implemented -
    Get a list of all methods and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for methods from the current class
    $flagsintGet data only for methods corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for methods from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for methods corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L79) ```php public function getModifiersString(): string; ``` +Get entity modifiers as a string -
    Get entity modifiers as a string
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L378) ```php public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L397) ```php public function getNamespaceName(): string; ``` +Get the entity namespace name -
    Get the entity namespace name
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L142) ```php public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L516) ```php public function getParentClass(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the entity of the parent class if it exists -
    Get the entity of the parent class if it exists
    - -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -
    -
    -
    - - - +# `getParentClassEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L493) ```php public function getParentClassEntities(): array; ``` +Get a list of parent class entities -
    Get a list of parent class entities
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -
    -
    -
    - - - +# `getParentClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L506) ```php public function getParentClassName(): null|string; ``` +Get the name of the parent class entity if it exists -
    Get the name of the parent class entity if it exists
    - -Parameters: not specified - -Return value: null | string +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L481) ```php public function getParentClassNames(): array; ``` +Get a list of entity names of parent classes -
    Get a list of entity names of parent classes
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -
    -
    -
    - - +--- +# `getPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L270) ```php public function getPluginData(string $pluginKey): mixed; ``` +Get additional information added using the plugin -
    Get additional information added using the plugin
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Return value: mixed +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) +--- -
    -
    -
    - - - +# `getProperties` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L963) ```php public function getProperties(): array; ``` +Get all properties that are available according to the configuration as an array -
    Get all properties that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getPropertiesData - :warning: Is internal | source code
    • -
    +--- +# `getPropertiesData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L872) ```php public function getPropertiesData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all properties and classes where they are implemented -
    Get a list of all properties and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for properties from the current class
    $flagsintGet data only for properties corresponding to the visibility modifiers passed in this value
    +***Parameters:*** -Return value: array +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for properties from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for properties corresponding to the visibility modifiers passed in this value | +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1004) ```php public function getProperty(string $propertyName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; ``` +Get the property entity by its name -
    Get the property entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to get
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity - - -Throws: -
      -
    • - \DI\DependencyException
    • +***Parameters:*** -
    • - \BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException
    • +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | -
    • - \DI\NotFoundException
    • +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php) -
    - -
    -
    -
    - - +--- +# `getPropertyDefaultValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1027) ```php public function getPropertyDefaultValue(string $propertyName): string|array|int|bool|null|float; ``` +Get the compiled value of a property -
    Get the compiled value of a property
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property for which you need to get the value
    - -Return value: string | array | int | bool | null | float - - -Throws: - - -
    -
    -
    - - +--- +# `getPropertyEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L934) ```php public function getPropertyEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection; ``` +Get a collection of property entities -
    Get a collection of property entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection - - -Throws: - +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +--- -See: - -
    -
    -
    - - - +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L412) ```php public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified - -Return value: null | string +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +--- -See: - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L160) ```php public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) +--- -
    -
    -
    - - - +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L386) ```php public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L457) ```php public function getStartLine(): int; ``` +Get the line number of the start of a class code in a file -
    Get the line number of the start of a class code in a file
    - -Parameters: not specified - -Return value: int +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) +--- -Throws: - - -
    -
    -
    - - - +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php public function getTraits(): array; ``` +Get a list of trait entities of the current class -
    Get a list of trait entities of the current class
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getTraitsNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L604) ```php public function getTraitsNames(): array; ``` +Get a list of class traits names -
    Get a list of class traits names
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `hasConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L785) ```php public function hasConstant(string $constantName, bool $unsafe = false): bool; ``` +Check if a constant exists in a class -
    Check if a constant exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the class whose entity you want to check
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the class whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | -Throws: - - -
    -
    -
    - - +--- +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool - - -Throws: -
      -
    • - \Exception
    • +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    - -
    -
    -
    - - +--- +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1182) ```php public function hasMethod(string $methodName, bool $unsafe = false): bool; ``` +Check if a method exists in a class -
    Check if a method exists in a class
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to check
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1250) ```php public function hasParentClass(string $parentClassName): bool; ``` +Check if a certain parent class exists in a chain of parent classes -
    Check if a certain parent class exists in a chain of parent classes
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamestringSearched parent class
    +| Name | Type | Description | +|:-|:-|:-| +$parentClassName | [string](https://www.php.net/manual/en/language.types.string.php) | Searched parent class | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `hasProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L983) ```php public function hasProperty(string $propertyName, bool $unsafe = false): bool; ``` +Check if a property exists in a class -
    Check if a property exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to check
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L644) ```php public function hasTraits(): bool; ``` +Check if the class contains traits -
    Check if the class contains traits
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `implementsInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1237) ```php public function implementsInterface(string $interfaceName): bool; ``` +Check if a class implements an interface -
    Check if a class implements an interface
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfaceNamestringName of the required interface in the interface chain
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$interfaceName | [string](https://www.php.net/manual/en/language.types.string.php) | Name of the required interface in the interface chain | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isAbstract` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L445) ```php public function isAbstract(): bool; ``` +Check that an entity is abstract -
    Check that an entity is abstract
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L104) ```php public function isClass(): bool; ``` +Check if an entity is a Class -
    Check if an entity is a Class
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isClassLoad` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L343) ```php public function isClassLoad(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - isDocumentCreationAllowed - :warning: Is internal | source code
    • -
    - +# `isDocumentCreationAllowed` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L224) ```php public function isDocumentCreationAllowed(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L358) ```php public function isEntityDataCanBeLoaded(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L84) ```php public static function isEntityNameValid(string $entityName): bool; ``` +Check if the name is a valid name for ClassLikeEntity -
    Check if the name is a valid name for ClassLikeEntity
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isEnum` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L134) ```php public function isEnum(): bool; ``` +Check if an entity is an Enum -
    Check if an entity is an Enum
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - -
      -
    • # - isExternalLibraryEntity - :warning: Is internal | source code
    • -
    +--- +# `isExternalLibraryEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L152) ```php public function isExternalLibraryEntity(): bool; ``` +Check if a given entity is an entity from a third party library (connected via composer) -
    Check if a given entity is an entity from a third party library (connected via composer)
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInGit` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L205) ```php public function isInGit(): bool; ``` +Checking if class file is in git repository -
    Checking if class file is in git repository
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L435) ```php public function isInstantiable(): bool; ``` +Check that an entity is instantiable -
    Check that an entity is instantiable
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L114) ```php public function isInterface(): bool; ``` +Check if an entity is an Interface -
    Check if an entity is an Interface
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isSubclassOf` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1219) ```php public function isSubclassOf(string $className): bool; ``` +Whether the given class is a subclass of the specified class -
    Whether the given class is a subclass of the specified class
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classNamestring-
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Throws: - - -
    -
    -
    - - +--- +# `isTrait` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L124) ```php public function isTrait(): bool; ``` +Check if an entity is a Trait -
    Check if an entity is a Trait
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L94) ```php public static function normalizeClassName(string $name): string; ``` +Bring the class name to the standard format used in the system -
    Bring the class name to the standard format used in the system
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    +***Parameters:*** -Return value: string +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - - - +# `setCustomAst` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L284) ```php public function setCustomAst(\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Class_|null $customAst): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$customAst | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) \| [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) \| [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) \| [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $customAst\PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Class_ | null-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_3.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_3.md index 9730b3fa..246b4ad0 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_3.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_3.md @@ -1,12 +1,15 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP enum reflection API / ClassLikeEntity
    - -

    - ClassLikeEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[PHP enum reflection API](/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md) **/** +ClassLikeEntity +--- +# [ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L44) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; @@ -14,3301 +17,1223 @@ namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; abstract class ClassLikeEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity implements \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface, \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface ``` - - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - addPluginData - - Add information to aт entity object
    2. -
    3. - cursorToDocAttributeLinkFragment -
    4. -
    5. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    6. -
    7. - getAst - - Get AST for this entity
    8. -
    9. - getCacheKey -
    10. -
    11. - getCachedEntityDependencies -
    12. -
    13. - getConstant - - Get the method entity by its name
    14. -
    15. - getConstantEntitiesCollection - - Get a collection of constant entities
    16. -
    17. - getConstantValue - - Get the compiled value of a constant
    18. -
    19. - getConstants - - Get all constants that are available according to the configuration as an array
    20. -
    21. - getConstantsData - - Get a list of all constants and classes where they are implemented
    22. -
    23. - getConstantsValues - - Get class constant compiled values according to filters
    24. -
    25. - getCurrentRootEntity -
    26. -
    27. - getDescription - - Get entity description
    28. -
    29. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    30. -
    31. - getDocBlock - - Get DocBlock for current entity
    32. -
    33. - getDocComment - - Get the doc comment of an entity
    34. -
    35. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    36. -
    37. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    38. -
    39. - getDocNote - - Get the note annotation value
    40. -
    41. - getDocRender -
    42. -
    43. - getEndLine - - Get the line number of the end of a class code in a file
    44. -
    45. - getEntityDependencies -
    46. -
    47. - getExamples - - Get parsed examples from `examples` doc block
    48. -
    49. - getFileContent -
    50. -
    51. - getFileSourceLink -
    52. -
    53. - getFirstExample - - Get first example from `examples` doc block
    54. -
    55. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    56. -
    57. - getInterfaceNames - - Get a list of class interface names
    58. -
    59. - getInterfacesEntities - - Get a list of interface entities that the current class implements
    60. -
    61. - getMethod - - Get the method entity by its name
    62. -
    63. - getMethodEntitiesCollection - - Get a collection of method entities
    64. -
    65. - getMethods - - Get all methods that are available according to the configuration as an array
    66. -
    67. - getMethodsData - - Get a list of all methods and classes where they are implemented
    68. -
    69. - getModifiersString - - Get entity modifiers as a string
    70. -
    71. - getName - - Full name of the entity
    72. -
    73. - getNamespaceName - - Get the entity namespace name
    74. -
    75. - getObjectId - - Get entity unique ID
    76. -
    77. - getParentClass - - Get the entity of the parent class if it exists
    78. -
    79. - getParentClassEntities - - Get a list of parent class entities
    80. -
    81. - getParentClassName - - Get the name of the parent class entity if it exists
    82. -
    83. - getParentClassNames - - Get a list of entity names of parent classes
    84. -
    85. - getPluginData - - Get additional information added using the plugin
    86. -
    87. - getProperties - - Get all properties that are available according to the configuration as an array
    88. -
    89. - getPropertiesData - - Get a list of all properties and classes where they are implemented
    90. -
    91. - getProperty - - Get the property entity by its name
    92. -
    93. - getPropertyDefaultValue - - Get the compiled value of a property
    94. -
    95. - getPropertyEntitiesCollection - - Get a collection of property entities
    96. -
    97. - getRelativeFileName - - File name relative to project_root configuration parameter
    98. -
    99. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    100. -
    101. - getShortName - - Short name of the entity
    102. -
    103. - getStartLine - - Get the line number of the start of a class code in a file
    104. -
    105. - getThrows - - Get parsed throws from `throws` doc block
    106. -
    107. - getThrowsDocBlockLinks -
    108. -
    109. - getTraits - - Get a list of trait entities of the current class
    110. -
    111. - getTraitsNames - - Get a list of class traits names
    112. -
    113. - hasConstant - - Check if a constant exists in a class
    114. -
    115. - hasDescriptionLinks - - Checking if an entity has links in its description
    116. -
    117. - hasExamples - - Checking if an entity has `example` docBlock
    118. -
    119. - hasMethod - - Check if a method exists in a class
    120. -
    121. - hasParentClass - - Check if a certain parent class exists in a chain of parent classes
    122. -
    123. - hasProperty - - Check if a property exists in a class
    124. -
    125. - hasThrows - - Checking if an entity has `throws` docBlock
    126. -
    127. - hasTraits - - Check if the class contains traits
    128. -
    129. - implementsInterface - - Check if a class implements an interface
    130. -
    131. - isAbstract - - Check that an entity is abstract
    132. -
    133. - isApi - - Checking if an entity has `api` docBlock
    134. -
    135. - isClass - - Check if an entity is a Class
    136. -
    137. - isClassLoad -
    138. -
    139. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    140. -
    141. - isDocumentCreationAllowed -
    142. -
    143. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    144. -
    145. - isEntityDataCacheOutdated -
    146. -
    147. - isEntityDataCanBeLoaded -
    148. -
    149. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    150. -
    151. - isEntityNameValid - - Check if the name is a valid name for ClassLikeEntity
    152. -
    153. - isEnum - - Check if an entity is an Enum
    154. -
    155. - isExternalLibraryEntity - - Check if a given entity is an entity from a third party library (connected via composer)
    156. -
    157. - isInGit - - Checking if class file is in git repository
    158. -
    159. - isInstantiable - - Check that an entity is instantiable
    160. -
    161. - isInterface - - Check if an entity is an Interface
    162. -
    163. - isInternal - - Checking if an entity has `internal` docBlock
    164. -
    165. - isSubclassOf - - Whether the given class is a subclass of the specified class
    166. -
    167. - isTrait - - Check if an entity is a Trait
    168. -
    169. - normalizeClassName - - Bring the class name to the standard format used in the system
    170. -
    171. - reloadEntityDependenciesCache - - Update entity dependency cache
    172. -
    173. - removeEntityValueFromCache -
    174. -
    175. - removeNotUsedEntityDataCache -
    176. -
    177. - setCustomAst -
    178. -
    - - - - - - - -

    Method details:

    - -
    - - - +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [addPluginData](#maddplugindata) - Add information to aт entity object +1. [cursorToDocAttributeLinkFragment](#mcursortodocattributelinkfragment) +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getConstant](#mgetconstant) - Get the method entity by its name +1. [getConstantEntitiesCollection](#mgetconstantentitiescollection) - Get a collection of constant entities +1. [getConstantValue](#mgetconstantvalue) - Get the compiled value of a constant +1. [getConstants](#mgetconstants) - Get all constants that are available according to the configuration as an array +1. [getConstantsData](#mgetconstantsdata) - Get a list of all constants and classes where they are implemented +1. [getConstantsValues](#mgetconstantsvalues) - Get class constant compiled values according to filters +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getDocRender](#mgetdocrender) +1. [getEndLine](#mgetendline) - Get the line number of the end of a class code in a file +1. [getEntityDependencies](#mgetentitydependencies) +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getInterfaceNames](#mgetinterfacenames) - Get a list of class interface names +1. [getInterfacesEntities](#mgetinterfacesentities) - Get a list of interface entities that the current class implements +1. [getMethod](#mgetmethod) - Get the method entity by its name +1. [getMethodEntitiesCollection](#mgetmethodentitiescollection) - Get a collection of method entities +1. [getMethods](#mgetmethods) - Get all methods that are available according to the configuration as an array +1. [getMethodsData](#mgetmethodsdata) - Get a list of all methods and classes where they are implemented +1. [getModifiersString](#mgetmodifiersstring) - Get entity modifiers as a string +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Get the entity namespace name +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getParentClass](#mgetparentclass) - Get the entity of the parent class if it exists +1. [getParentClassEntities](#mgetparentclassentities) - Get a list of parent class entities +1. [getParentClassName](#mgetparentclassname) - Get the name of the parent class entity if it exists +1. [getParentClassNames](#mgetparentclassnames) - Get a list of entity names of parent classes +1. [getPluginData](#mgetplugindata) - Get additional information added using the plugin +1. [getProperties](#mgetproperties) - Get all properties that are available according to the configuration as an array +1. [getPropertiesData](#mgetpropertiesdata) - Get a list of all properties and classes where they are implemented +1. [getProperty](#mgetproperty) - Get the property entity by its name +1. [getPropertyDefaultValue](#mgetpropertydefaultvalue) - Get the compiled value of a property +1. [getPropertyEntitiesCollection](#mgetpropertyentitiescollection) - Get a collection of property entities +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getTraits](#mgettraits) - Get a list of trait entities of the current class +1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names +1. [hasConstant](#mhasconstant) - Check if a constant exists in a class +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasMethod](#mhasmethod) - Check if a method exists in a class +1. [hasParentClass](#mhasparentclass) - Check if a certain parent class exists in a chain of parent classes +1. [hasProperty](#mhasproperty) - Check if a property exists in a class +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [hasTraits](#mhastraits) - Check if the class contains traits +1. [implementsInterface](#mimplementsinterface) - Check if a class implements an interface +1. [isAbstract](#misabstract) - Check that an entity is abstract +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isClass](#misclass) - Check if an entity is a Class +1. [isClassLoad](#misclassload) +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isDocumentCreationAllowed](#misdocumentcreationallowed) +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isEntityNameValid](#misentitynamevalid) - Check if the name is a valid name for ClassLikeEntity +1. [isEnum](#misenum) - Check if an entity is an Enum +1. [isExternalLibraryEntity](#misexternallibraryentity) - Check if a given entity is an entity from a third party library (connected via composer) +1. [isInGit](#misingit) - Checking if class file is in git repository +1. [isInstantiable](#misinstantiable) - Check that an entity is instantiable +1. [isInterface](#misinterface) - Check if an entity is an Interface +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isSubclassOf](#missubclassof) - Whether the given class is a subclass of the specified class +1. [isTrait](#mistrait) - Check if an entity is a Trait +1. [normalizeClassName](#mnormalizeclassname) - Bring the class name to the standard format used in the system +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) +1. [setCustomAst](#msetcustomast) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L51) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection $entitiesCollection, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper $composerHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $className, string|null $relativeFileName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$entitiesCollection | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$composerHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ComposerHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$relativeFileName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $entitiesCollection\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $composerHelper\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $classNamestring-
    $relativeFileNamestring | null-
    - - - -
    -
    -
    - - +--- +# `addPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L258) ```php public function addPluginData(string $pluginKey, mixed $data): void; ``` +Add information to aт entity object -
    Add information to aт entity object
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    $datamixed-
    +***Parameters:*** -Return value: void +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$data | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - cursorToDocAttributeLinkFragment - :warning: Is internal | source code
    • -
    +--- +# `cursorToDocAttributeLinkFragment` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1286) ```php public function cursorToDocAttributeLinkFragment(string $cursor, bool $isForDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $cursorstring-
    $isForDocumentbool-
    - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L296) ```php public function getAst(): \PhpParser\Node\Stmt\Class_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\Class_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ - - -Throws: - +***Return value:*** [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) | [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) | [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L806) ```php public function getConstant(string $constantName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant whose entity you want to get
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    +***Parameters:*** -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -Throws: - - -
    -
    -
    - - +--- +# `getConstantEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L736) ```php public function getConstantEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection; ``` +Get a collection of constant entities -
    Get a collection of constant entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) -Throws: - - - -See: - -
    -
    -
    - - +--- +# `getConstantValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L829) ```php public function getConstantValue(string $constantName): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant for which you need to get the value
    - -Return value: string | array | int | bool | null | float +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant for which you need to get the value | -Throws: - - -
    -
    -
    - - +--- +# `getConstants` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L765) ```php public function getConstants(): array; ``` +Get all constants that are available according to the configuration as an array -
    Get all constants that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getConstantsData - :warning: Is internal | source code
    • -
    +--- +# `getConstantsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L661) ```php public function getConstantsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all constants and classes where they are implemented -
    Get a list of all constants and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for constants from the current class
    $flagsintGet data only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for constants corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getConstantsValues` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L849) ```php public function getConstantsValues(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get class constant compiled values according to filters -
    Get class constant compiled values according to filters
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet values only for constants from the current class
    $flagsintGet values only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    +--- +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    - -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    +--- +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L236) ```php public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    - -Parameters: not specified - -Return value: null | int - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getDocRender` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1262) ```php public function getDocRender(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRendererInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface - - -Throws: - - -
    -
    -
    - - - +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L469) ```php public function getEndLine(): int; ``` +Get the line number of the end of a class code in a file -
    Get the line number of the end of a class code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L171) ```php public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1035) ```php public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    - +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L370) ```php public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -
    -
    -
    - - +--- +# `getInterfaceNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L530) ```php public function getInterfaceNames(): array; ``` +Get a list of class interface names -
    Get a list of class interface names
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getInterfacesEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L587) ```php public function getInterfacesEntities(): array; ``` +Get a list of interface entities that the current class implements -
    Get a list of interface entities that the current class implements
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1203) ```php public function getMethod(string $methodName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to get
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +***Parameters:*** -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) -Throws: - - -
    -
    -
    - - +--- +# `getMethodEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1133) ```php public function getMethodEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; ``` +Get a collection of method entities -
    Get a collection of method entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) -Throws: - - - -See: - -
    -
    -
    - - +--- +# `getMethods` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1162) ```php public function getMethods(): array; ``` +Get all methods that are available according to the configuration as an array -
    Get all methods that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getMethodsData - :warning: Is internal | source code
    • -
    +--- +# `getMethodsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1059) ```php public function getMethodsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all methods and classes where they are implemented -
    Get a list of all methods and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for methods from the current class
    $flagsintGet data only for methods corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for methods from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for methods corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L79) ```php public function getModifiersString(): string; ``` +Get entity modifiers as a string -
    Get entity modifiers as a string
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L378) ```php public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L397) ```php public function getNamespaceName(): string; ``` +Get the entity namespace name -
    Get the entity namespace name
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L142) ```php public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L516) ```php public function getParentClass(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the entity of the parent class if it exists -
    Get the entity of the parent class if it exists
    - -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -
    -
    -
    - - - +# `getParentClassEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L493) ```php public function getParentClassEntities(): array; ``` +Get a list of parent class entities -
    Get a list of parent class entities
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -
    -
    -
    - - - +# `getParentClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L506) ```php public function getParentClassName(): null|string; ``` +Get the name of the parent class entity if it exists -
    Get the name of the parent class entity if it exists
    - -Parameters: not specified - -Return value: null | string +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L481) ```php public function getParentClassNames(): array; ``` +Get a list of entity names of parent classes -
    Get a list of entity names of parent classes
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -
    -
    -
    - - +--- +# `getPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L270) ```php public function getPluginData(string $pluginKey): mixed; ``` +Get additional information added using the plugin -
    Get additional information added using the plugin
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Return value: mixed +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) +--- -
    -
    -
    - - - +# `getProperties` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L963) ```php public function getProperties(): array; ``` +Get all properties that are available according to the configuration as an array -
    Get all properties that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getPropertiesData - :warning: Is internal | source code
    • -
    +--- +# `getPropertiesData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L872) ```php public function getPropertiesData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all properties and classes where they are implemented -
    Get a list of all properties and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for properties from the current class
    $flagsintGet data only for properties corresponding to the visibility modifiers passed in this value
    +***Parameters:*** -Return value: array +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for properties from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for properties corresponding to the visibility modifiers passed in this value | +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1004) ```php public function getProperty(string $propertyName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; ``` +Get the property entity by its name -
    Get the property entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to get
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity - - -Throws: -
      -
    • - \DI\DependencyException
    • +***Parameters:*** -
    • - \BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException
    • +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | -
    • - \DI\NotFoundException
    • +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php) -
    - -
    -
    -
    - - +--- +# `getPropertyDefaultValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1027) ```php public function getPropertyDefaultValue(string $propertyName): string|array|int|bool|null|float; ``` +Get the compiled value of a property -
    Get the compiled value of a property
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property for which you need to get the value
    - -Return value: string | array | int | bool | null | float - - -Throws: - - -
    -
    -
    - - +--- +# `getPropertyEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L934) ```php public function getPropertyEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection; ``` +Get a collection of property entities -
    Get a collection of property entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection - - -Throws: - +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +--- -See: - -
    -
    -
    - - - +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L412) ```php public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified - -Return value: null | string +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +--- -See: - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L160) ```php public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) +--- -
    -
    -
    - - - +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L386) ```php public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L457) ```php public function getStartLine(): int; ``` +Get the line number of the start of a class code in a file -
    Get the line number of the start of a class code in a file
    - -Parameters: not specified - -Return value: int +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) +--- -Throws: - - -
    -
    -
    - - - +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php public function getTraits(): array; ``` +Get a list of trait entities of the current class -
    Get a list of trait entities of the current class
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getTraitsNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L604) ```php public function getTraitsNames(): array; ``` +Get a list of class traits names -
    Get a list of class traits names
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `hasConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L785) ```php public function hasConstant(string $constantName, bool $unsafe = false): bool; ``` +Check if a constant exists in a class -
    Check if a constant exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the class whose entity you want to check
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the class whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | -Throws: - - -
    -
    -
    - - +--- +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool - - -Throws: -
      -
    • - \Exception
    • +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    - -
    -
    -
    - - +--- +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1182) ```php public function hasMethod(string $methodName, bool $unsafe = false): bool; ``` +Check if a method exists in a class -
    Check if a method exists in a class
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to check
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1250) ```php public function hasParentClass(string $parentClassName): bool; ``` +Check if a certain parent class exists in a chain of parent classes -
    Check if a certain parent class exists in a chain of parent classes
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamestringSearched parent class
    +| Name | Type | Description | +|:-|:-|:-| +$parentClassName | [string](https://www.php.net/manual/en/language.types.string.php) | Searched parent class | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `hasProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L983) ```php public function hasProperty(string $propertyName, bool $unsafe = false): bool; ``` +Check if a property exists in a class -
    Check if a property exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to check
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L644) ```php public function hasTraits(): bool; ``` +Check if the class contains traits -
    Check if the class contains traits
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `implementsInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1237) ```php public function implementsInterface(string $interfaceName): bool; ``` +Check if a class implements an interface -
    Check if a class implements an interface
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfaceNamestringName of the required interface in the interface chain
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$interfaceName | [string](https://www.php.net/manual/en/language.types.string.php) | Name of the required interface in the interface chain | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isAbstract` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L445) ```php public function isAbstract(): bool; ``` +Check that an entity is abstract -
    Check that an entity is abstract
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L104) ```php public function isClass(): bool; ``` +Check if an entity is a Class -
    Check if an entity is a Class
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isClassLoad` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L343) ```php public function isClassLoad(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - isDocumentCreationAllowed - :warning: Is internal | source code
    • -
    - +# `isDocumentCreationAllowed` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L224) ```php public function isDocumentCreationAllowed(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L358) ```php public function isEntityDataCanBeLoaded(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L84) ```php public static function isEntityNameValid(string $entityName): bool; ``` +Check if the name is a valid name for ClassLikeEntity -
    Check if the name is a valid name for ClassLikeEntity
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isEnum` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L134) ```php public function isEnum(): bool; ``` +Check if an entity is an Enum -
    Check if an entity is an Enum
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - -
      -
    • # - isExternalLibraryEntity - :warning: Is internal | source code
    • -
    +--- +# `isExternalLibraryEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L152) ```php public function isExternalLibraryEntity(): bool; ``` +Check if a given entity is an entity from a third party library (connected via composer) -
    Check if a given entity is an entity from a third party library (connected via composer)
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInGit` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L205) ```php public function isInGit(): bool; ``` +Checking if class file is in git repository -
    Checking if class file is in git repository
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L435) ```php public function isInstantiable(): bool; ``` +Check that an entity is instantiable -
    Check that an entity is instantiable
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L114) ```php public function isInterface(): bool; ``` +Check if an entity is an Interface -
    Check if an entity is an Interface
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isSubclassOf` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1219) ```php public function isSubclassOf(string $className): bool; ``` +Whether the given class is a subclass of the specified class -
    Whether the given class is a subclass of the specified class
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classNamestring-
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Throws: - - -
    -
    -
    - - +--- +# `isTrait` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L124) ```php public function isTrait(): bool; ``` +Check if an entity is a Trait -
    Check if an entity is a Trait
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L94) ```php public static function normalizeClassName(string $name): string; ``` +Bring the class name to the standard format used in the system -
    Bring the class name to the standard format used in the system
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    +***Parameters:*** -Return value: string +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - - - +# `setCustomAst` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L284) ```php public function setCustomAst(\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Class_|null $customAst): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$customAst | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) \| [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) \| [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) \| [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $customAst\PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Class_ | null-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_4.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_4.md index 8f9d9810..d3733a22 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_4.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_4.md @@ -1,12 +1,15 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP class reflection API / ClassLikeEntity
    - -

    - ClassLikeEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[PHP class reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md) **/** +ClassLikeEntity +--- +# [ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L44) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; @@ -14,3301 +17,1223 @@ namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; abstract class ClassLikeEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity implements \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface, \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface ``` - - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - addPluginData - - Add information to aт entity object
    2. -
    3. - cursorToDocAttributeLinkFragment -
    4. -
    5. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    6. -
    7. - getAst - - Get AST for this entity
    8. -
    9. - getCacheKey -
    10. -
    11. - getCachedEntityDependencies -
    12. -
    13. - getConstant - - Get the method entity by its name
    14. -
    15. - getConstantEntitiesCollection - - Get a collection of constant entities
    16. -
    17. - getConstantValue - - Get the compiled value of a constant
    18. -
    19. - getConstants - - Get all constants that are available according to the configuration as an array
    20. -
    21. - getConstantsData - - Get a list of all constants and classes where they are implemented
    22. -
    23. - getConstantsValues - - Get class constant compiled values according to filters
    24. -
    25. - getCurrentRootEntity -
    26. -
    27. - getDescription - - Get entity description
    28. -
    29. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    30. -
    31. - getDocBlock - - Get DocBlock for current entity
    32. -
    33. - getDocComment - - Get the doc comment of an entity
    34. -
    35. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    36. -
    37. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    38. -
    39. - getDocNote - - Get the note annotation value
    40. -
    41. - getDocRender -
    42. -
    43. - getEndLine - - Get the line number of the end of a class code in a file
    44. -
    45. - getEntityDependencies -
    46. -
    47. - getExamples - - Get parsed examples from `examples` doc block
    48. -
    49. - getFileContent -
    50. -
    51. - getFileSourceLink -
    52. -
    53. - getFirstExample - - Get first example from `examples` doc block
    54. -
    55. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    56. -
    57. - getInterfaceNames - - Get a list of class interface names
    58. -
    59. - getInterfacesEntities - - Get a list of interface entities that the current class implements
    60. -
    61. - getMethod - - Get the method entity by its name
    62. -
    63. - getMethodEntitiesCollection - - Get a collection of method entities
    64. -
    65. - getMethods - - Get all methods that are available according to the configuration as an array
    66. -
    67. - getMethodsData - - Get a list of all methods and classes where they are implemented
    68. -
    69. - getModifiersString - - Get entity modifiers as a string
    70. -
    71. - getName - - Full name of the entity
    72. -
    73. - getNamespaceName - - Get the entity namespace name
    74. -
    75. - getObjectId - - Get entity unique ID
    76. -
    77. - getParentClass - - Get the entity of the parent class if it exists
    78. -
    79. - getParentClassEntities - - Get a list of parent class entities
    80. -
    81. - getParentClassName - - Get the name of the parent class entity if it exists
    82. -
    83. - getParentClassNames - - Get a list of entity names of parent classes
    84. -
    85. - getPluginData - - Get additional information added using the plugin
    86. -
    87. - getProperties - - Get all properties that are available according to the configuration as an array
    88. -
    89. - getPropertiesData - - Get a list of all properties and classes where they are implemented
    90. -
    91. - getProperty - - Get the property entity by its name
    92. -
    93. - getPropertyDefaultValue - - Get the compiled value of a property
    94. -
    95. - getPropertyEntitiesCollection - - Get a collection of property entities
    96. -
    97. - getRelativeFileName - - File name relative to project_root configuration parameter
    98. -
    99. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    100. -
    101. - getShortName - - Short name of the entity
    102. -
    103. - getStartLine - - Get the line number of the start of a class code in a file
    104. -
    105. - getThrows - - Get parsed throws from `throws` doc block
    106. -
    107. - getThrowsDocBlockLinks -
    108. -
    109. - getTraits - - Get a list of trait entities of the current class
    110. -
    111. - getTraitsNames - - Get a list of class traits names
    112. -
    113. - hasConstant - - Check if a constant exists in a class
    114. -
    115. - hasDescriptionLinks - - Checking if an entity has links in its description
    116. -
    117. - hasExamples - - Checking if an entity has `example` docBlock
    118. -
    119. - hasMethod - - Check if a method exists in a class
    120. -
    121. - hasParentClass - - Check if a certain parent class exists in a chain of parent classes
    122. -
    123. - hasProperty - - Check if a property exists in a class
    124. -
    125. - hasThrows - - Checking if an entity has `throws` docBlock
    126. -
    127. - hasTraits - - Check if the class contains traits
    128. -
    129. - implementsInterface - - Check if a class implements an interface
    130. -
    131. - isAbstract - - Check that an entity is abstract
    132. -
    133. - isApi - - Checking if an entity has `api` docBlock
    134. -
    135. - isClass - - Check if an entity is a Class
    136. -
    137. - isClassLoad -
    138. -
    139. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    140. -
    141. - isDocumentCreationAllowed -
    142. -
    143. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    144. -
    145. - isEntityDataCacheOutdated -
    146. -
    147. - isEntityDataCanBeLoaded -
    148. -
    149. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    150. -
    151. - isEntityNameValid - - Check if the name is a valid name for ClassLikeEntity
    152. -
    153. - isEnum - - Check if an entity is an Enum
    154. -
    155. - isExternalLibraryEntity - - Check if a given entity is an entity from a third party library (connected via composer)
    156. -
    157. - isInGit - - Checking if class file is in git repository
    158. -
    159. - isInstantiable - - Check that an entity is instantiable
    160. -
    161. - isInterface - - Check if an entity is an Interface
    162. -
    163. - isInternal - - Checking if an entity has `internal` docBlock
    164. -
    165. - isSubclassOf - - Whether the given class is a subclass of the specified class
    166. -
    167. - isTrait - - Check if an entity is a Trait
    168. -
    169. - normalizeClassName - - Bring the class name to the standard format used in the system
    170. -
    171. - reloadEntityDependenciesCache - - Update entity dependency cache
    172. -
    173. - removeEntityValueFromCache -
    174. -
    175. - removeNotUsedEntityDataCache -
    176. -
    177. - setCustomAst -
    178. -
    - - - - - - - -

    Method details:

    - -
    - - - +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [addPluginData](#maddplugindata) - Add information to aт entity object +1. [cursorToDocAttributeLinkFragment](#mcursortodocattributelinkfragment) +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getConstant](#mgetconstant) - Get the method entity by its name +1. [getConstantEntitiesCollection](#mgetconstantentitiescollection) - Get a collection of constant entities +1. [getConstantValue](#mgetconstantvalue) - Get the compiled value of a constant +1. [getConstants](#mgetconstants) - Get all constants that are available according to the configuration as an array +1. [getConstantsData](#mgetconstantsdata) - Get a list of all constants and classes where they are implemented +1. [getConstantsValues](#mgetconstantsvalues) - Get class constant compiled values according to filters +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getDocRender](#mgetdocrender) +1. [getEndLine](#mgetendline) - Get the line number of the end of a class code in a file +1. [getEntityDependencies](#mgetentitydependencies) +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getInterfaceNames](#mgetinterfacenames) - Get a list of class interface names +1. [getInterfacesEntities](#mgetinterfacesentities) - Get a list of interface entities that the current class implements +1. [getMethod](#mgetmethod) - Get the method entity by its name +1. [getMethodEntitiesCollection](#mgetmethodentitiescollection) - Get a collection of method entities +1. [getMethods](#mgetmethods) - Get all methods that are available according to the configuration as an array +1. [getMethodsData](#mgetmethodsdata) - Get a list of all methods and classes where they are implemented +1. [getModifiersString](#mgetmodifiersstring) - Get entity modifiers as a string +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Get the entity namespace name +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getParentClass](#mgetparentclass) - Get the entity of the parent class if it exists +1. [getParentClassEntities](#mgetparentclassentities) - Get a list of parent class entities +1. [getParentClassName](#mgetparentclassname) - Get the name of the parent class entity if it exists +1. [getParentClassNames](#mgetparentclassnames) - Get a list of entity names of parent classes +1. [getPluginData](#mgetplugindata) - Get additional information added using the plugin +1. [getProperties](#mgetproperties) - Get all properties that are available according to the configuration as an array +1. [getPropertiesData](#mgetpropertiesdata) - Get a list of all properties and classes where they are implemented +1. [getProperty](#mgetproperty) - Get the property entity by its name +1. [getPropertyDefaultValue](#mgetpropertydefaultvalue) - Get the compiled value of a property +1. [getPropertyEntitiesCollection](#mgetpropertyentitiescollection) - Get a collection of property entities +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getTraits](#mgettraits) - Get a list of trait entities of the current class +1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names +1. [hasConstant](#mhasconstant) - Check if a constant exists in a class +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasMethod](#mhasmethod) - Check if a method exists in a class +1. [hasParentClass](#mhasparentclass) - Check if a certain parent class exists in a chain of parent classes +1. [hasProperty](#mhasproperty) - Check if a property exists in a class +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [hasTraits](#mhastraits) - Check if the class contains traits +1. [implementsInterface](#mimplementsinterface) - Check if a class implements an interface +1. [isAbstract](#misabstract) - Check that an entity is abstract +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isClass](#misclass) - Check if an entity is a Class +1. [isClassLoad](#misclassload) +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isDocumentCreationAllowed](#misdocumentcreationallowed) +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isEntityNameValid](#misentitynamevalid) - Check if the name is a valid name for ClassLikeEntity +1. [isEnum](#misenum) - Check if an entity is an Enum +1. [isExternalLibraryEntity](#misexternallibraryentity) - Check if a given entity is an entity from a third party library (connected via composer) +1. [isInGit](#misingit) - Checking if class file is in git repository +1. [isInstantiable](#misinstantiable) - Check that an entity is instantiable +1. [isInterface](#misinterface) - Check if an entity is an Interface +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isSubclassOf](#missubclassof) - Whether the given class is a subclass of the specified class +1. [isTrait](#mistrait) - Check if an entity is a Trait +1. [normalizeClassName](#mnormalizeclassname) - Bring the class name to the standard format used in the system +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) +1. [setCustomAst](#msetcustomast) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L51) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection $entitiesCollection, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper $composerHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $className, string|null $relativeFileName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$entitiesCollection | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$composerHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ComposerHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$relativeFileName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $entitiesCollection\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $composerHelper\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $classNamestring-
    $relativeFileNamestring | null-
    - - - -
    -
    -
    - - +--- +# `addPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L258) ```php public function addPluginData(string $pluginKey, mixed $data): void; ``` +Add information to aт entity object -
    Add information to aт entity object
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    $datamixed-
    +***Parameters:*** -Return value: void +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$data | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - cursorToDocAttributeLinkFragment - :warning: Is internal | source code
    • -
    +--- +# `cursorToDocAttributeLinkFragment` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1286) ```php public function cursorToDocAttributeLinkFragment(string $cursor, bool $isForDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $cursorstring-
    $isForDocumentbool-
    - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L296) ```php public function getAst(): \PhpParser\Node\Stmt\Class_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\Class_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ - - -Throws: - +***Return value:*** [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) | [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) | [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L806) ```php public function getConstant(string $constantName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant whose entity you want to get
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    +***Parameters:*** -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -Throws: - - -
    -
    -
    - - +--- +# `getConstantEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L736) ```php public function getConstantEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection; ``` +Get a collection of constant entities -
    Get a collection of constant entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) -Throws: - - - -See: - -
    -
    -
    - - +--- +# `getConstantValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L829) ```php public function getConstantValue(string $constantName): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant for which you need to get the value
    - -Return value: string | array | int | bool | null | float +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant for which you need to get the value | -Throws: - - -
    -
    -
    - - +--- +# `getConstants` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L765) ```php public function getConstants(): array; ``` +Get all constants that are available according to the configuration as an array -
    Get all constants that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getConstantsData - :warning: Is internal | source code
    • -
    +--- +# `getConstantsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L661) ```php public function getConstantsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all constants and classes where they are implemented -
    Get a list of all constants and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for constants from the current class
    $flagsintGet data only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for constants corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getConstantsValues` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L849) ```php public function getConstantsValues(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get class constant compiled values according to filters -
    Get class constant compiled values according to filters
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet values only for constants from the current class
    $flagsintGet values only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    +--- +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    - -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    +--- +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L236) ```php public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    - -Parameters: not specified - -Return value: null | int - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getDocRender` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1262) ```php public function getDocRender(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRendererInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface - - -Throws: - - -
    -
    -
    - - - +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L469) ```php public function getEndLine(): int; ``` +Get the line number of the end of a class code in a file -
    Get the line number of the end of a class code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L171) ```php public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1035) ```php public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    - +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L370) ```php public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -
    -
    -
    - - +--- +# `getInterfaceNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L530) ```php public function getInterfaceNames(): array; ``` +Get a list of class interface names -
    Get a list of class interface names
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getInterfacesEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L587) ```php public function getInterfacesEntities(): array; ``` +Get a list of interface entities that the current class implements -
    Get a list of interface entities that the current class implements
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1203) ```php public function getMethod(string $methodName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to get
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +***Parameters:*** -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) -Throws: - - -
    -
    -
    - - +--- +# `getMethodEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1133) ```php public function getMethodEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; ``` +Get a collection of method entities -
    Get a collection of method entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) -Throws: - - - -See: - -
    -
    -
    - - +--- +# `getMethods` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1162) ```php public function getMethods(): array; ``` +Get all methods that are available according to the configuration as an array -
    Get all methods that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getMethodsData - :warning: Is internal | source code
    • -
    +--- +# `getMethodsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1059) ```php public function getMethodsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all methods and classes where they are implemented -
    Get a list of all methods and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for methods from the current class
    $flagsintGet data only for methods corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for methods from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for methods corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L79) ```php public function getModifiersString(): string; ``` +Get entity modifiers as a string -
    Get entity modifiers as a string
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L378) ```php public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L397) ```php public function getNamespaceName(): string; ``` +Get the entity namespace name -
    Get the entity namespace name
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L142) ```php public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L516) ```php public function getParentClass(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the entity of the parent class if it exists -
    Get the entity of the parent class if it exists
    - -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -
    -
    -
    - - - +# `getParentClassEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L493) ```php public function getParentClassEntities(): array; ``` +Get a list of parent class entities -
    Get a list of parent class entities
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -
    -
    -
    - - - +# `getParentClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L506) ```php public function getParentClassName(): null|string; ``` +Get the name of the parent class entity if it exists -
    Get the name of the parent class entity if it exists
    - -Parameters: not specified - -Return value: null | string +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L481) ```php public function getParentClassNames(): array; ``` +Get a list of entity names of parent classes -
    Get a list of entity names of parent classes
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -
    -
    -
    - - +--- +# `getPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L270) ```php public function getPluginData(string $pluginKey): mixed; ``` +Get additional information added using the plugin -
    Get additional information added using the plugin
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Return value: mixed +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) +--- -
    -
    -
    - - - +# `getProperties` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L963) ```php public function getProperties(): array; ``` +Get all properties that are available according to the configuration as an array -
    Get all properties that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getPropertiesData - :warning: Is internal | source code
    • -
    +--- +# `getPropertiesData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L872) ```php public function getPropertiesData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all properties and classes where they are implemented -
    Get a list of all properties and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for properties from the current class
    $flagsintGet data only for properties corresponding to the visibility modifiers passed in this value
    +***Parameters:*** -Return value: array +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for properties from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for properties corresponding to the visibility modifiers passed in this value | +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1004) ```php public function getProperty(string $propertyName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; ``` +Get the property entity by its name -
    Get the property entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to get
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity - - -Throws: -
      -
    • - \DI\DependencyException
    • +***Parameters:*** -
    • - \BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException
    • +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | -
    • - \DI\NotFoundException
    • +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php) -
    - -
    -
    -
    - - +--- +# `getPropertyDefaultValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1027) ```php public function getPropertyDefaultValue(string $propertyName): string|array|int|bool|null|float; ``` +Get the compiled value of a property -
    Get the compiled value of a property
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property for which you need to get the value
    - -Return value: string | array | int | bool | null | float - - -Throws: - - -
    -
    -
    - - +--- +# `getPropertyEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L934) ```php public function getPropertyEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection; ``` +Get a collection of property entities -
    Get a collection of property entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection - - -Throws: - +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +--- -See: - -
    -
    -
    - - - +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L412) ```php public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified - -Return value: null | string +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +--- -See: - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L160) ```php public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) +--- -
    -
    -
    - - - +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L386) ```php public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L457) ```php public function getStartLine(): int; ``` +Get the line number of the start of a class code in a file -
    Get the line number of the start of a class code in a file
    - -Parameters: not specified - -Return value: int +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) +--- -Throws: - - -
    -
    -
    - - - +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php public function getTraits(): array; ``` +Get a list of trait entities of the current class -
    Get a list of trait entities of the current class
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getTraitsNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L604) ```php public function getTraitsNames(): array; ``` +Get a list of class traits names -
    Get a list of class traits names
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `hasConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L785) ```php public function hasConstant(string $constantName, bool $unsafe = false): bool; ``` +Check if a constant exists in a class -
    Check if a constant exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the class whose entity you want to check
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the class whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | -Throws: - - -
    -
    -
    - - +--- +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool - - -Throws: -
      -
    • - \Exception
    • +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    - -
    -
    -
    - - +--- +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1182) ```php public function hasMethod(string $methodName, bool $unsafe = false): bool; ``` +Check if a method exists in a class -
    Check if a method exists in a class
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to check
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1250) ```php public function hasParentClass(string $parentClassName): bool; ``` +Check if a certain parent class exists in a chain of parent classes -
    Check if a certain parent class exists in a chain of parent classes
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamestringSearched parent class
    +| Name | Type | Description | +|:-|:-|:-| +$parentClassName | [string](https://www.php.net/manual/en/language.types.string.php) | Searched parent class | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `hasProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L983) ```php public function hasProperty(string $propertyName, bool $unsafe = false): bool; ``` +Check if a property exists in a class -
    Check if a property exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to check
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L644) ```php public function hasTraits(): bool; ``` +Check if the class contains traits -
    Check if the class contains traits
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `implementsInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1237) ```php public function implementsInterface(string $interfaceName): bool; ``` +Check if a class implements an interface -
    Check if a class implements an interface
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfaceNamestringName of the required interface in the interface chain
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$interfaceName | [string](https://www.php.net/manual/en/language.types.string.php) | Name of the required interface in the interface chain | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isAbstract` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L445) ```php public function isAbstract(): bool; ``` +Check that an entity is abstract -
    Check that an entity is abstract
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L104) ```php public function isClass(): bool; ``` +Check if an entity is a Class -
    Check if an entity is a Class
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isClassLoad` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L343) ```php public function isClassLoad(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - isDocumentCreationAllowed - :warning: Is internal | source code
    • -
    - +# `isDocumentCreationAllowed` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L224) ```php public function isDocumentCreationAllowed(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L358) ```php public function isEntityDataCanBeLoaded(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L84) ```php public static function isEntityNameValid(string $entityName): bool; ``` +Check if the name is a valid name for ClassLikeEntity -
    Check if the name is a valid name for ClassLikeEntity
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isEnum` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L134) ```php public function isEnum(): bool; ``` +Check if an entity is an Enum -
    Check if an entity is an Enum
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - -
      -
    • # - isExternalLibraryEntity - :warning: Is internal | source code
    • -
    +--- +# `isExternalLibraryEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L152) ```php public function isExternalLibraryEntity(): bool; ``` +Check if a given entity is an entity from a third party library (connected via composer) -
    Check if a given entity is an entity from a third party library (connected via composer)
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInGit` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L205) ```php public function isInGit(): bool; ``` +Checking if class file is in git repository -
    Checking if class file is in git repository
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L435) ```php public function isInstantiable(): bool; ``` +Check that an entity is instantiable -
    Check that an entity is instantiable
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L114) ```php public function isInterface(): bool; ``` +Check if an entity is an Interface -
    Check if an entity is an Interface
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isSubclassOf` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1219) ```php public function isSubclassOf(string $className): bool; ``` +Whether the given class is a subclass of the specified class -
    Whether the given class is a subclass of the specified class
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classNamestring-
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Throws: - - -
    -
    -
    - - +--- +# `isTrait` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L124) ```php public function isTrait(): bool; ``` +Check if an entity is a Trait -
    Check if an entity is a Trait
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L94) ```php public static function normalizeClassName(string $name): string; ``` +Bring the class name to the standard format used in the system -
    Bring the class name to the standard format used in the system
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    +***Parameters:*** -Return value: string +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - - - +# `setCustomAst` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L284) ```php public function setCustomAst(\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Class_|null $customAst): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$customAst | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) \| [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) \| [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) \| [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $customAst\PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Class_ | null-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md index b18e9778..971a6cfb 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md @@ -1,12 +1,14 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / ClassLikeEntity
    - -

    - ClassLikeEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +ClassLikeEntity +--- +# [ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L44) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; @@ -14,3301 +16,1223 @@ namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; abstract class ClassLikeEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity implements \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface, \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface ``` - - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - addPluginData - - Add information to aт entity object
    2. -
    3. - cursorToDocAttributeLinkFragment -
    4. -
    5. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    6. -
    7. - getAst - - Get AST for this entity
    8. -
    9. - getCacheKey -
    10. -
    11. - getCachedEntityDependencies -
    12. -
    13. - getConstant - - Get the method entity by its name
    14. -
    15. - getConstantEntitiesCollection - - Get a collection of constant entities
    16. -
    17. - getConstantValue - - Get the compiled value of a constant
    18. -
    19. - getConstants - - Get all constants that are available according to the configuration as an array
    20. -
    21. - getConstantsData - - Get a list of all constants and classes where they are implemented
    22. -
    23. - getConstantsValues - - Get class constant compiled values according to filters
    24. -
    25. - getCurrentRootEntity -
    26. -
    27. - getDescription - - Get entity description
    28. -
    29. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    30. -
    31. - getDocBlock - - Get DocBlock for current entity
    32. -
    33. - getDocComment - - Get the doc comment of an entity
    34. -
    35. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    36. -
    37. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    38. -
    39. - getDocNote - - Get the note annotation value
    40. -
    41. - getDocRender -
    42. -
    43. - getEndLine - - Get the line number of the end of a class code in a file
    44. -
    45. - getEntityDependencies -
    46. -
    47. - getExamples - - Get parsed examples from `examples` doc block
    48. -
    49. - getFileContent -
    50. -
    51. - getFileSourceLink -
    52. -
    53. - getFirstExample - - Get first example from `examples` doc block
    54. -
    55. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    56. -
    57. - getInterfaceNames - - Get a list of class interface names
    58. -
    59. - getInterfacesEntities - - Get a list of interface entities that the current class implements
    60. -
    61. - getMethod - - Get the method entity by its name
    62. -
    63. - getMethodEntitiesCollection - - Get a collection of method entities
    64. -
    65. - getMethods - - Get all methods that are available according to the configuration as an array
    66. -
    67. - getMethodsData - - Get a list of all methods and classes where they are implemented
    68. -
    69. - getModifiersString - - Get entity modifiers as a string
    70. -
    71. - getName - - Full name of the entity
    72. -
    73. - getNamespaceName - - Get the entity namespace name
    74. -
    75. - getObjectId - - Get entity unique ID
    76. -
    77. - getParentClass - - Get the entity of the parent class if it exists
    78. -
    79. - getParentClassEntities - - Get a list of parent class entities
    80. -
    81. - getParentClassName - - Get the name of the parent class entity if it exists
    82. -
    83. - getParentClassNames - - Get a list of entity names of parent classes
    84. -
    85. - getPluginData - - Get additional information added using the plugin
    86. -
    87. - getProperties - - Get all properties that are available according to the configuration as an array
    88. -
    89. - getPropertiesData - - Get a list of all properties and classes where they are implemented
    90. -
    91. - getProperty - - Get the property entity by its name
    92. -
    93. - getPropertyDefaultValue - - Get the compiled value of a property
    94. -
    95. - getPropertyEntitiesCollection - - Get a collection of property entities
    96. -
    97. - getRelativeFileName - - File name relative to project_root configuration parameter
    98. -
    99. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    100. -
    101. - getShortName - - Short name of the entity
    102. -
    103. - getStartLine - - Get the line number of the start of a class code in a file
    104. -
    105. - getThrows - - Get parsed throws from `throws` doc block
    106. -
    107. - getThrowsDocBlockLinks -
    108. -
    109. - getTraits - - Get a list of trait entities of the current class
    110. -
    111. - getTraitsNames - - Get a list of class traits names
    112. -
    113. - hasConstant - - Check if a constant exists in a class
    114. -
    115. - hasDescriptionLinks - - Checking if an entity has links in its description
    116. -
    117. - hasExamples - - Checking if an entity has `example` docBlock
    118. -
    119. - hasMethod - - Check if a method exists in a class
    120. -
    121. - hasParentClass - - Check if a certain parent class exists in a chain of parent classes
    122. -
    123. - hasProperty - - Check if a property exists in a class
    124. -
    125. - hasThrows - - Checking if an entity has `throws` docBlock
    126. -
    127. - hasTraits - - Check if the class contains traits
    128. -
    129. - implementsInterface - - Check if a class implements an interface
    130. -
    131. - isAbstract - - Check that an entity is abstract
    132. -
    133. - isApi - - Checking if an entity has `api` docBlock
    134. -
    135. - isClass - - Check if an entity is a Class
    136. -
    137. - isClassLoad -
    138. -
    139. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    140. -
    141. - isDocumentCreationAllowed -
    142. -
    143. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    144. -
    145. - isEntityDataCacheOutdated -
    146. -
    147. - isEntityDataCanBeLoaded -
    148. -
    149. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    150. -
    151. - isEntityNameValid - - Check if the name is a valid name for ClassLikeEntity
    152. -
    153. - isEnum - - Check if an entity is an Enum
    154. -
    155. - isExternalLibraryEntity - - Check if a given entity is an entity from a third party library (connected via composer)
    156. -
    157. - isInGit - - Checking if class file is in git repository
    158. -
    159. - isInstantiable - - Check that an entity is instantiable
    160. -
    161. - isInterface - - Check if an entity is an Interface
    162. -
    163. - isInternal - - Checking if an entity has `internal` docBlock
    164. -
    165. - isSubclassOf - - Whether the given class is a subclass of the specified class
    166. -
    167. - isTrait - - Check if an entity is a Trait
    168. -
    169. - normalizeClassName - - Bring the class name to the standard format used in the system
    170. -
    171. - reloadEntityDependenciesCache - - Update entity dependency cache
    172. -
    173. - removeEntityValueFromCache -
    174. -
    175. - removeNotUsedEntityDataCache -
    176. -
    177. - setCustomAst -
    178. -
    - - - - - - - -

    Method details:

    - -
    - - - +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [addPluginData](#maddplugindata) - Add information to aт entity object +1. [cursorToDocAttributeLinkFragment](#mcursortodocattributelinkfragment) +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getConstant](#mgetconstant) - Get the method entity by its name +1. [getConstantEntitiesCollection](#mgetconstantentitiescollection) - Get a collection of constant entities +1. [getConstantValue](#mgetconstantvalue) - Get the compiled value of a constant +1. [getConstants](#mgetconstants) - Get all constants that are available according to the configuration as an array +1. [getConstantsData](#mgetconstantsdata) - Get a list of all constants and classes where they are implemented +1. [getConstantsValues](#mgetconstantsvalues) - Get class constant compiled values according to filters +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getDocRender](#mgetdocrender) +1. [getEndLine](#mgetendline) - Get the line number of the end of a class code in a file +1. [getEntityDependencies](#mgetentitydependencies) +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getInterfaceNames](#mgetinterfacenames) - Get a list of class interface names +1. [getInterfacesEntities](#mgetinterfacesentities) - Get a list of interface entities that the current class implements +1. [getMethod](#mgetmethod) - Get the method entity by its name +1. [getMethodEntitiesCollection](#mgetmethodentitiescollection) - Get a collection of method entities +1. [getMethods](#mgetmethods) - Get all methods that are available according to the configuration as an array +1. [getMethodsData](#mgetmethodsdata) - Get a list of all methods and classes where they are implemented +1. [getModifiersString](#mgetmodifiersstring) - Get entity modifiers as a string +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Get the entity namespace name +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getParentClass](#mgetparentclass) - Get the entity of the parent class if it exists +1. [getParentClassEntities](#mgetparentclassentities) - Get a list of parent class entities +1. [getParentClassName](#mgetparentclassname) - Get the name of the parent class entity if it exists +1. [getParentClassNames](#mgetparentclassnames) - Get a list of entity names of parent classes +1. [getPluginData](#mgetplugindata) - Get additional information added using the plugin +1. [getProperties](#mgetproperties) - Get all properties that are available according to the configuration as an array +1. [getPropertiesData](#mgetpropertiesdata) - Get a list of all properties and classes where they are implemented +1. [getProperty](#mgetproperty) - Get the property entity by its name +1. [getPropertyDefaultValue](#mgetpropertydefaultvalue) - Get the compiled value of a property +1. [getPropertyEntitiesCollection](#mgetpropertyentitiescollection) - Get a collection of property entities +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getTraits](#mgettraits) - Get a list of trait entities of the current class +1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names +1. [hasConstant](#mhasconstant) - Check if a constant exists in a class +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasMethod](#mhasmethod) - Check if a method exists in a class +1. [hasParentClass](#mhasparentclass) - Check if a certain parent class exists in a chain of parent classes +1. [hasProperty](#mhasproperty) - Check if a property exists in a class +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [hasTraits](#mhastraits) - Check if the class contains traits +1. [implementsInterface](#mimplementsinterface) - Check if a class implements an interface +1. [isAbstract](#misabstract) - Check that an entity is abstract +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isClass](#misclass) - Check if an entity is a Class +1. [isClassLoad](#misclassload) +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isDocumentCreationAllowed](#misdocumentcreationallowed) +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isEntityNameValid](#misentitynamevalid) - Check if the name is a valid name for ClassLikeEntity +1. [isEnum](#misenum) - Check if an entity is an Enum +1. [isExternalLibraryEntity](#misexternallibraryentity) - Check if a given entity is an entity from a third party library (connected via composer) +1. [isInGit](#misingit) - Checking if class file is in git repository +1. [isInstantiable](#misinstantiable) - Check that an entity is instantiable +1. [isInterface](#misinterface) - Check if an entity is an Interface +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isSubclassOf](#missubclassof) - Whether the given class is a subclass of the specified class +1. [isTrait](#mistrait) - Check if an entity is a Trait +1. [normalizeClassName](#mnormalizeclassname) - Bring the class name to the standard format used in the system +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) +1. [setCustomAst](#msetcustomast) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L51) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection $entitiesCollection, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper $composerHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $className, string|null $relativeFileName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$entitiesCollection | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$composerHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ComposerHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$relativeFileName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $entitiesCollection\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $composerHelper\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $classNamestring-
    $relativeFileNamestring | null-
    - - - -
    -
    -
    - - +--- +# `addPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L258) ```php public function addPluginData(string $pluginKey, mixed $data): void; ``` +Add information to aт entity object -
    Add information to aт entity object
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    $datamixed-
    +***Parameters:*** -Return value: void +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$data | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - cursorToDocAttributeLinkFragment - :warning: Is internal | source code
    • -
    +--- +# `cursorToDocAttributeLinkFragment` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1286) ```php public function cursorToDocAttributeLinkFragment(string $cursor, bool $isForDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $cursorstring-
    $isForDocumentbool-
    - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L296) ```php public function getAst(): \PhpParser\Node\Stmt\Class_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\Class_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ - - -Throws: - +***Return value:*** [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) | [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) | [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L806) ```php public function getConstant(string $constantName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant whose entity you want to get
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    +***Parameters:*** -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -Throws: - - -
    -
    -
    - - +--- +# `getConstantEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L736) ```php public function getConstantEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection; ``` +Get a collection of constant entities -
    Get a collection of constant entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) -Throws: - - - -See: - -
    -
    -
    - - +--- +# `getConstantValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L829) ```php public function getConstantValue(string $constantName): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant for which you need to get the value
    - -Return value: string | array | int | bool | null | float +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant for which you need to get the value | -Throws: - - -
    -
    -
    - - +--- +# `getConstants` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L765) ```php public function getConstants(): array; ``` +Get all constants that are available according to the configuration as an array -
    Get all constants that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getConstantsData - :warning: Is internal | source code
    • -
    +--- +# `getConstantsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L661) ```php public function getConstantsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all constants and classes where they are implemented -
    Get a list of all constants and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for constants from the current class
    $flagsintGet data only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for constants corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getConstantsValues` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L849) ```php public function getConstantsValues(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get class constant compiled values according to filters -
    Get class constant compiled values according to filters
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet values only for constants from the current class
    $flagsintGet values only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    +--- +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    - -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    +--- +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L236) ```php public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    - -Parameters: not specified - -Return value: null | int - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getDocRender` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1262) ```php public function getDocRender(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRendererInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface - - -Throws: - - -
    -
    -
    - - - +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L469) ```php public function getEndLine(): int; ``` +Get the line number of the end of a class code in a file -
    Get the line number of the end of a class code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L171) ```php public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1035) ```php public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    - +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L370) ```php public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -
    -
    -
    - - +--- +# `getInterfaceNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L530) ```php public function getInterfaceNames(): array; ``` +Get a list of class interface names -
    Get a list of class interface names
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getInterfacesEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L587) ```php public function getInterfacesEntities(): array; ``` +Get a list of interface entities that the current class implements -
    Get a list of interface entities that the current class implements
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1203) ```php public function getMethod(string $methodName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to get
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +***Parameters:*** -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) -Throws: - - -
    -
    -
    - - +--- +# `getMethodEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1133) ```php public function getMethodEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; ``` +Get a collection of method entities -
    Get a collection of method entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) -Throws: - - - -See: - -
    -
    -
    - - +--- +# `getMethods` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1162) ```php public function getMethods(): array; ``` +Get all methods that are available according to the configuration as an array -
    Get all methods that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getMethodsData - :warning: Is internal | source code
    • -
    +--- +# `getMethodsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1059) ```php public function getMethodsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all methods and classes where they are implemented -
    Get a list of all methods and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for methods from the current class
    $flagsintGet data only for methods corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for methods from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for methods corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L79) ```php public function getModifiersString(): string; ``` +Get entity modifiers as a string -
    Get entity modifiers as a string
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L378) ```php public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L397) ```php public function getNamespaceName(): string; ``` +Get the entity namespace name -
    Get the entity namespace name
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L142) ```php public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L516) ```php public function getParentClass(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the entity of the parent class if it exists -
    Get the entity of the parent class if it exists
    - -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -
    -
    -
    - - - +# `getParentClassEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L493) ```php public function getParentClassEntities(): array; ``` +Get a list of parent class entities -
    Get a list of parent class entities
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -
    -
    -
    - - - +# `getParentClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L506) ```php public function getParentClassName(): null|string; ``` +Get the name of the parent class entity if it exists -
    Get the name of the parent class entity if it exists
    - -Parameters: not specified - -Return value: null | string +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L481) ```php public function getParentClassNames(): array; ``` +Get a list of entity names of parent classes -
    Get a list of entity names of parent classes
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -
    -
    -
    - - +--- +# `getPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L270) ```php public function getPluginData(string $pluginKey): mixed; ``` +Get additional information added using the plugin -
    Get additional information added using the plugin
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Return value: mixed +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) +--- -
    -
    -
    - - - +# `getProperties` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L963) ```php public function getProperties(): array; ``` +Get all properties that are available according to the configuration as an array -
    Get all properties that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getPropertiesData - :warning: Is internal | source code
    • -
    +--- +# `getPropertiesData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L872) ```php public function getPropertiesData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all properties and classes where they are implemented -
    Get a list of all properties and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for properties from the current class
    $flagsintGet data only for properties corresponding to the visibility modifiers passed in this value
    +***Parameters:*** -Return value: array +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for properties from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for properties corresponding to the visibility modifiers passed in this value | +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1004) ```php public function getProperty(string $propertyName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; ``` +Get the property entity by its name -
    Get the property entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to get
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity - - -Throws: -
      -
    • - \DI\DependencyException
    • +***Parameters:*** -
    • - \BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException
    • +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | -
    • - \DI\NotFoundException
    • +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php) -
    - -
    -
    -
    - - +--- +# `getPropertyDefaultValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1027) ```php public function getPropertyDefaultValue(string $propertyName): string|array|int|bool|null|float; ``` +Get the compiled value of a property -
    Get the compiled value of a property
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property for which you need to get the value
    - -Return value: string | array | int | bool | null | float - - -Throws: - - -
    -
    -
    - - +--- +# `getPropertyEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L934) ```php public function getPropertyEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection; ``` +Get a collection of property entities -
    Get a collection of property entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection - - -Throws: - +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +--- -See: - -
    -
    -
    - - - +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L412) ```php public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified - -Return value: null | string +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +--- -See: - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L160) ```php public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) +--- -
    -
    -
    - - - +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L386) ```php public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L457) ```php public function getStartLine(): int; ``` +Get the line number of the start of a class code in a file -
    Get the line number of the start of a class code in a file
    - -Parameters: not specified - -Return value: int +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) +--- -Throws: - - -
    -
    -
    - - - +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php public function getTraits(): array; ``` +Get a list of trait entities of the current class -
    Get a list of trait entities of the current class
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getTraitsNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L604) ```php public function getTraitsNames(): array; ``` +Get a list of class traits names -
    Get a list of class traits names
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `hasConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L785) ```php public function hasConstant(string $constantName, bool $unsafe = false): bool; ``` +Check if a constant exists in a class -
    Check if a constant exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the class whose entity you want to check
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the class whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | -Throws: - - -
    -
    -
    - - +--- +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool - - -Throws: -
      -
    • - \Exception
    • +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    - -
    -
    -
    - - +--- +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1182) ```php public function hasMethod(string $methodName, bool $unsafe = false): bool; ``` +Check if a method exists in a class -
    Check if a method exists in a class
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to check
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1250) ```php public function hasParentClass(string $parentClassName): bool; ``` +Check if a certain parent class exists in a chain of parent classes -
    Check if a certain parent class exists in a chain of parent classes
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamestringSearched parent class
    +| Name | Type | Description | +|:-|:-|:-| +$parentClassName | [string](https://www.php.net/manual/en/language.types.string.php) | Searched parent class | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `hasProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L983) ```php public function hasProperty(string $propertyName, bool $unsafe = false): bool; ``` +Check if a property exists in a class -
    Check if a property exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to check
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L644) ```php public function hasTraits(): bool; ``` +Check if the class contains traits -
    Check if the class contains traits
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `implementsInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1237) ```php public function implementsInterface(string $interfaceName): bool; ``` +Check if a class implements an interface -
    Check if a class implements an interface
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfaceNamestringName of the required interface in the interface chain
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$interfaceName | [string](https://www.php.net/manual/en/language.types.string.php) | Name of the required interface in the interface chain | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isAbstract` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L445) ```php public function isAbstract(): bool; ``` +Check that an entity is abstract -
    Check that an entity is abstract
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L104) ```php public function isClass(): bool; ``` +Check if an entity is a Class -
    Check if an entity is a Class
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isClassLoad` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L343) ```php public function isClassLoad(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - isDocumentCreationAllowed - :warning: Is internal | source code
    • -
    - +# `isDocumentCreationAllowed` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L224) ```php public function isDocumentCreationAllowed(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L358) ```php public function isEntityDataCanBeLoaded(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L84) ```php public static function isEntityNameValid(string $entityName): bool; ``` +Check if the name is a valid name for ClassLikeEntity -
    Check if the name is a valid name for ClassLikeEntity
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isEnum` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L134) ```php public function isEnum(): bool; ``` +Check if an entity is an Enum -
    Check if an entity is an Enum
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - -
      -
    • # - isExternalLibraryEntity - :warning: Is internal | source code
    • -
    +--- +# `isExternalLibraryEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L152) ```php public function isExternalLibraryEntity(): bool; ``` +Check if a given entity is an entity from a third party library (connected via composer) -
    Check if a given entity is an entity from a third party library (connected via composer)
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInGit` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L205) ```php public function isInGit(): bool; ``` +Checking if class file is in git repository -
    Checking if class file is in git repository
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L435) ```php public function isInstantiable(): bool; ``` +Check that an entity is instantiable -
    Check that an entity is instantiable
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L114) ```php public function isInterface(): bool; ``` +Check if an entity is an Interface -
    Check if an entity is an Interface
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isSubclassOf` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1219) ```php public function isSubclassOf(string $className): bool; ``` +Whether the given class is a subclass of the specified class -
    Whether the given class is a subclass of the specified class
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classNamestring-
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Throws: - - -
    -
    -
    - - +--- +# `isTrait` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L124) ```php public function isTrait(): bool; ``` +Check if an entity is a Trait -
    Check if an entity is a Trait
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L94) ```php public static function normalizeClassName(string $name): string; ``` +Bring the class name to the standard format used in the system -
    Bring the class name to the standard format used in the system
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    +***Parameters:*** -Return value: string +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - - - +# `setCustomAst` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L284) ```php public function setCustomAst(\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Class_|null $customAst): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$customAst | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) \| [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) \| [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) \| [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $customAst\PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Class_ | null-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md b/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md index 96f0b795..2fbd6a3d 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md @@ -1,763 +1,247 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / Configuration
    - -

    - Configuration class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +Configuration +--- +# [Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L30) class: ```php namespace BumbleDocGen\Core\Configuration; final class Configuration ``` - -
    Configuration project documentation
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getAdditionalConsoleCommands -
    2. -
    3. - getCacheDir -
    4. -
    5. - getConfigurationVersion -
    6. -
    7. - getDocGenLibDir -
    8. -
    9. - getGitClientPath -
    10. -
    11. - getIfExists -
    12. -
    13. - getLanguageHandlersCollection -
    14. -
    15. - getOutputDir -
    16. -
    17. - getOutputDirBaseUrl -
    18. -
    19. - getPageLinkProcessor -
    20. -
    21. - getPlugins -
    22. -
    23. - getProjectRoot -
    24. -
    25. - getSourceLocators -
    26. -
    27. - getTemplatesDir -
    28. -
    29. - getTwigFilters -
    30. -
    31. - getTwigFunctions -
    32. -
    33. - getWorkingDir -
    34. -
    35. - isCheckFileInGitBeforeCreatingDocEnabled -
    36. -
    37. - renderWithFrontMatter -
    38. -
    39. - useSharedCache -
    40. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Configuration project documentation + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [getAdditionalConsoleCommands](#mgetadditionalconsolecommands) +1. [getCacheDir](#mgetcachedir) +1. [getConfigurationVersion](#mgetconfigurationversion) +1. [getDocGenLibDir](#mgetdocgenlibdir) +1. [getGitClientPath](#mgetgitclientpath) +1. [getIfExists](#mgetifexists) +1. [getLanguageHandlersCollection](#mgetlanguagehandlerscollection) +1. [getOutputDir](#mgetoutputdir) +1. [getOutputDirBaseUrl](#mgetoutputdirbaseurl) +1. [getPageLinkProcessor](#mgetpagelinkprocessor) +1. [getPlugins](#mgetplugins) +1. [getProjectRoot](#mgetprojectroot) +1. [getSourceLocators](#mgetsourcelocators) +1. [getTemplatesDir](#mgettemplatesdir) +1. [getTwigFilters](#mgettwigfilters) +1. [getTwigFunctions](#mgettwigfunctions) +1. [getWorkingDir](#mgetworkingdir) +1. [isCheckFileInGitBeforeCreatingDocEnabled](#mischeckfileingitbeforecreatingdocenabled) +1. [renderWithFrontMatter](#mrenderwithfrontmatter) +1. [useSharedCache](#musesharedcache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L34) ```php public function __construct(\BumbleDocGen\Core\Configuration\ConfigurationParameterBag $parameterBag, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$parameterBag | [\BumbleDocGen\Core\Configuration\ConfigurationParameterBag](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/ConfigurationParameterBag.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parameterBag\BumbleDocGen\Core\Configuration\ConfigurationParameterBag-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `getAdditionalConsoleCommands` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L377) ```php public function getAdditionalConsoleCommands(): \BumbleDocGen\Console\Command\AdditionalCommandCollection; ``` +***Return value:*** [\BumbleDocGen\Console\Command\AdditionalCommandCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/Command/AdditionalCommandCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Console\Command\AdditionalCommandCollection - - -Throws: - - -
    -
    -
    - - - +# `getCacheDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L205) ```php public function getCacheDir(): null|string; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    - - - +# `getConfigurationVersion` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L42) ```php public function getConfigurationVersion(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getDocGenLibDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L367) ```php public function getDocGenLibDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getGitClientPath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L256) ```php public function getGitClientPath(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getIfExists` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L395) ```php public function getIfExists(mixed $key): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keymixed-
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getLanguageHandlersCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L166) ```php public function getLanguageHandlersCollection(): \BumbleDocGen\LanguageHandler\LanguageHandlersCollection; ``` +***Return value:*** [\BumbleDocGen\LanguageHandler\LanguageHandlersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/LanguageHandlersCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\LanguageHandlersCollection - - -Throws: - - -
    -
    -
    - - - +# `getOutputDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L112) ```php public function getOutputDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getOutputDirBaseUrl` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L150) ```php public function getOutputDirBaseUrl(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getPageLinkProcessor` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L238) ```php public function getPageLinkProcessor(): \BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/PageLinkProcessor/PageLinkProcessorInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface - - -Throws: - - -
    -
    -
    - - - +# `getPlugins` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L187) ```php public function getPlugins(): \BumbleDocGen\Core\Plugin\PluginsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Plugin\PluginsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Plugin\PluginsCollection - - -Throws: - - -
    -
    -
    - - - +# `getProjectRoot` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L50) ```php public function getProjectRoot(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getSourceLocators` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L66) ```php public function getSourceLocators(): \BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/SourceLocatorsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection - - -Throws: - - -
    -
    -
    - - - +# `getTemplatesDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L84) ```php public function getTemplatesDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getTwigFilters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L295) ```php public function getTwigFilters(): \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/CustomFiltersCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection - - -Throws: - - -
    -
    -
    - - - +# `getTwigFunctions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L272) ```php public function getTwigFunctions(): \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/CustomFunctionsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection - - -Throws: - - -
    -
    -
    - - - +# `getWorkingDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L358) ```php public function getWorkingDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - isCheckFileInGitBeforeCreatingDocEnabled - | source code
    • -
    - +# `isCheckFileInGitBeforeCreatingDocEnabled` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L344) ```php public function isCheckFileInGitBeforeCreatingDocEnabled(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `renderWithFrontMatter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L330) ```php public function renderWithFrontMatter(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `useSharedCache` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L316) ```php public function useSharedCache(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md index 5ae0f989..852d7845 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md @@ -1,3559 +1,1402 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP enum reflection API / EnumEntity
    - -

    - EnumEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[PHP enum reflection API](/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md) **/** +EnumEntity +--- +# [EnumEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/EnumEntity.php#L19) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; class EnumEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity implements \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface, \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface ``` - -
    Enumeration
    - -See: - - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - addPluginData - - Add information to aт entity object
    2. -
    3. - cursorToDocAttributeLinkFragment -
    4. -
    5. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    6. -
    7. - getAst - - Get AST for this entity
    8. -
    9. - getCacheKey -
    10. -
    11. - getCachedEntityDependencies -
    12. -
    13. - getCasesNames - - Get enum cases names
    14. -
    15. - getConstant - - Get the method entity by its name
    16. -
    17. - getConstantEntitiesCollection - - Get a collection of constant entities
    18. -
    19. - getConstantValue - - Get the compiled value of a constant
    20. -
    21. - getConstants - - Get all constants that are available according to the configuration as an array
    22. -
    23. - getConstantsData - - Get a list of all constants and classes where they are implemented
    24. -
    25. - getConstantsValues - - Get class constant compiled values according to filters
    26. -
    27. - getCurrentRootEntity -
    28. -
    29. - getDescription - - Get entity description
    30. -
    31. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    32. -
    33. - getDocBlock - - Get DocBlock for current entity
    34. -
    35. - getDocComment - - Get the doc comment of an entity
    36. -
    37. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    38. -
    39. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    40. -
    41. - getDocNote - - Get the note annotation value
    42. -
    43. - getDocRender -
    44. -
    45. - getEndLine - - Get the line number of the end of a class code in a file
    46. -
    47. - getEntityDependencies -
    48. -
    49. - getEnumCaseValue - - Get enum case value
    50. -
    51. - getEnumCases - - Get enum cases values
    52. -
    53. - getExamples - - Get parsed examples from `examples` doc block
    54. -
    55. - getFileContent -
    56. -
    57. - getFileSourceLink -
    58. -
    59. - getFirstExample - - Get first example from `examples` doc block
    60. -
    61. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    62. -
    63. - getInterfaceNames - - Get a list of class interface names
    64. -
    65. - getInterfacesEntities - - Get a list of interface entities that the current class implements
    66. -
    67. - getMethod - - Get the method entity by its name
    68. -
    69. - getMethodEntitiesCollection - - Get a collection of method entities
    70. -
    71. - getMethods - - Get all methods that are available according to the configuration as an array
    72. -
    73. - getMethodsData - - Get a list of all methods and classes where they are implemented
    74. -
    75. - getModifiersString - - Get entity modifiers as a string
    76. -
    77. - getName - - Full name of the entity
    78. -
    79. - getNamespaceName - - Get the entity namespace name
    80. -
    81. - getObjectId - - Get entity unique ID
    82. -
    83. - getParentClass - - Get the entity of the parent class if it exists
    84. -
    85. - getParentClassEntities - - Get a list of parent class entities
    86. -
    87. - getParentClassName - - Get the name of the parent class entity if it exists
    88. -
    89. - getParentClassNames - - Get a list of entity names of parent classes
    90. -
    91. - getPluginData - - Get additional information added using the plugin
    92. -
    93. - getProperties - - Get all properties that are available according to the configuration as an array
    94. -
    95. - getPropertiesData - - Get a list of all properties and classes where they are implemented
    96. -
    97. - getProperty - - Get the property entity by its name
    98. -
    99. - getPropertyDefaultValue - - Get the compiled value of a property
    100. -
    101. - getPropertyEntitiesCollection - - Get a collection of property entities
    102. -
    103. - getRelativeFileName - - File name relative to project_root configuration parameter
    104. -
    105. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    106. -
    107. - getShortName - - Short name of the entity
    108. -
    109. - getStartLine - - Get the line number of the start of a class code in a file
    110. -
    111. - getThrows - - Get parsed throws from `throws` doc block
    112. -
    113. - getThrowsDocBlockLinks -
    114. -
    115. - getTraits - - Get a list of trait entities of the current class
    116. -
    117. - getTraitsNames - - Get a list of class traits names
    118. -
    119. - hasConstant - - Check if a constant exists in a class
    120. -
    121. - hasDescriptionLinks - - Checking if an entity has links in its description
    122. -
    123. - hasExamples - - Checking if an entity has `example` docBlock
    124. -
    125. - hasMethod - - Check if a method exists in a class
    126. -
    127. - hasParentClass - - Check if a certain parent class exists in a chain of parent classes
    128. -
    129. - hasProperty - - Check if a property exists in a class
    130. -
    131. - hasThrows - - Checking if an entity has `throws` docBlock
    132. -
    133. - hasTraits - - Check if the class contains traits
    134. -
    135. - implementsInterface - - Check if a class implements an interface
    136. -
    137. - isAbstract - - Check that an entity is abstract
    138. -
    139. - isApi - - Checking if an entity has `api` docBlock
    140. -
    141. - isClass - - Check if an entity is a Class
    142. -
    143. - isClassLoad -
    144. -
    145. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    146. -
    147. - isDocumentCreationAllowed -
    148. -
    149. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    150. -
    151. - isEntityDataCacheOutdated -
    152. -
    153. - isEntityDataCanBeLoaded -
    154. -
    155. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    156. -
    157. - isEntityNameValid - - Check if the name is a valid name for ClassLikeEntity
    158. -
    159. - isEnum - - Check if an entity is an Enum
    160. -
    161. - isExternalLibraryEntity - - Check if a given entity is an entity from a third party library (connected via composer)
    162. -
    163. - isInGit - - Checking if class file is in git repository
    164. -
    165. - isInstantiable - - Check that an entity is instantiable
    166. -
    167. - isInterface - - Check if an entity is an Interface
    168. -
    169. - isInternal - - Checking if an entity has `internal` docBlock
    170. -
    171. - isSubclassOf - - Whether the given class is a subclass of the specified class
    172. -
    173. - isTrait - - Check if an entity is a Trait
    174. -
    175. - normalizeClassName - - Bring the class name to the standard format used in the system
    176. -
    177. - reloadEntityDependenciesCache - - Update entity dependency cache
    178. -
    179. - removeEntityValueFromCache -
    180. -
    181. - removeNotUsedEntityDataCache -
    182. -
    183. - setCustomAst -
    184. -
    - - - - - - - -

    Method details:

    - -
    - - - +Enumeration + +***Links:*** +- [https://www.php.net/manual/en/language.enumerations.php](https://www.php.net/manual/en/language.enumerations.php) + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [addPluginData](#maddplugindata) - Add information to aт entity object +1. [cursorToDocAttributeLinkFragment](#mcursortodocattributelinkfragment) +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getCasesNames](#mgetcasesnames) - Get enum cases names +1. [getConstant](#mgetconstant) - Get the method entity by its name +1. [getConstantEntitiesCollection](#mgetconstantentitiescollection) - Get a collection of constant entities +1. [getConstantValue](#mgetconstantvalue) - Get the compiled value of a constant +1. [getConstants](#mgetconstants) - Get all constants that are available according to the configuration as an array +1. [getConstantsData](#mgetconstantsdata) - Get a list of all constants and classes where they are implemented +1. [getConstantsValues](#mgetconstantsvalues) - Get class constant compiled values according to filters +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getDocRender](#mgetdocrender) +1. [getEndLine](#mgetendline) - Get the line number of the end of a class code in a file +1. [getEntityDependencies](#mgetentitydependencies) +1. [getEnumCaseValue](#mgetenumcasevalue) - Get enum case value +1. [getEnumCases](#mgetenumcases) - Get enum cases values +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getInterfaceNames](#mgetinterfacenames) - Get a list of class interface names +1. [getInterfacesEntities](#mgetinterfacesentities) - Get a list of interface entities that the current class implements +1. [getMethod](#mgetmethod) - Get the method entity by its name +1. [getMethodEntitiesCollection](#mgetmethodentitiescollection) - Get a collection of method entities +1. [getMethods](#mgetmethods) - Get all methods that are available according to the configuration as an array +1. [getMethodsData](#mgetmethodsdata) - Get a list of all methods and classes where they are implemented +1. [getModifiersString](#mgetmodifiersstring) - Get entity modifiers as a string +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Get the entity namespace name +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getParentClass](#mgetparentclass) - Get the entity of the parent class if it exists +1. [getParentClassEntities](#mgetparentclassentities) - Get a list of parent class entities +1. [getParentClassName](#mgetparentclassname) - Get the name of the parent class entity if it exists +1. [getParentClassNames](#mgetparentclassnames) - Get a list of entity names of parent classes +1. [getPluginData](#mgetplugindata) - Get additional information added using the plugin +1. [getProperties](#mgetproperties) - Get all properties that are available according to the configuration as an array +1. [getPropertiesData](#mgetpropertiesdata) - Get a list of all properties and classes where they are implemented +1. [getProperty](#mgetproperty) - Get the property entity by its name +1. [getPropertyDefaultValue](#mgetpropertydefaultvalue) - Get the compiled value of a property +1. [getPropertyEntitiesCollection](#mgetpropertyentitiescollection) - Get a collection of property entities +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getTraits](#mgettraits) - Get a list of trait entities of the current class +1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names +1. [hasConstant](#mhasconstant) - Check if a constant exists in a class +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasMethod](#mhasmethod) - Check if a method exists in a class +1. [hasParentClass](#mhasparentclass) - Check if a certain parent class exists in a chain of parent classes +1. [hasProperty](#mhasproperty) - Check if a property exists in a class +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [hasTraits](#mhastraits) - Check if the class contains traits +1. [implementsInterface](#mimplementsinterface) - Check if a class implements an interface +1. [isAbstract](#misabstract) - Check that an entity is abstract +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isClass](#misclass) - Check if an entity is a Class +1. [isClassLoad](#misclassload) +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isDocumentCreationAllowed](#misdocumentcreationallowed) +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isEntityNameValid](#misentitynamevalid) - Check if the name is a valid name for ClassLikeEntity +1. [isEnum](#misenum) - Check if an entity is an Enum +1. [isExternalLibraryEntity](#misexternallibraryentity) - Check if a given entity is an entity from a third party library (connected via composer) +1. [isInGit](#misingit) - Checking if class file is in git repository +1. [isInstantiable](#misinstantiable) - Check that an entity is instantiable +1. [isInterface](#misinterface) - Check if an entity is an Interface +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isSubclassOf](#missubclassof) - Whether the given class is a subclass of the specified class +1. [isTrait](#mistrait) - Check if an entity is a Trait +1. [normalizeClassName](#mnormalizeclassname) - Bring the class name to the standard format used in the system +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) +1. [setCustomAst](#msetcustomast) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L51) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection $entitiesCollection, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper $composerHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $className, string|null $relativeFileName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$entitiesCollection | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$composerHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ComposerHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$relativeFileName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $entitiesCollection\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $composerHelper\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $classNamestring-
    $relativeFileNamestring | null-
    - - - -
    -
    -
    - - +--- +# `addPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function addPluginData(string $pluginKey, mixed $data): void; ``` +Add information to aт entity object -
    Add information to aт entity object
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    $datamixed-
    - -Return value: void +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$data | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | -
    -
    -
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
      -
    • # - cursorToDocAttributeLinkFragment - :warning: Is internal | source code
    • -
    +--- +# `cursorToDocAttributeLinkFragment` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1286) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function cursorToDocAttributeLinkFragment(string $cursor, bool $isForDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $cursorstring-
    $isForDocumentbool-
    - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L296) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getAst(): \PhpParser\Node\Stmt\Class_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_; ``` +Get AST for this entity -
    Get AST for this entity
    +***Return value:*** [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) | [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) | [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\Class_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ - - -Throws: - - -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getCasesNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/EnumEntity.php#L74) ```php public function getCasesNames(): array; ``` +Get enum cases names -
    Get enum cases names
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Throws: - - -
    -
    -
    - - - +# `getConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L806) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstant(string $constantName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant whose entity you want to get
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    +***Parameters:*** -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -Throws: - - -
    -
    -
    - - +--- +# `getConstantEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L736) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection; ``` +Get a collection of constant entities -
    Get a collection of constant entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) -Throws: - - - -See: - -
    -
    -
    - - +--- +# `getConstantValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L829) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantValue(string $constantName): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant for which you need to get the value
    - -Return value: string | array | int | bool | null | float - - -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant for which you need to get the value | -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) - +--- +# `getConstants` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L765) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstants(): array; ``` +Get all constants that are available according to the configuration as an array -
    Get all constants that are available according to the configuration as an array
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) -Return value: array - - -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getConstantsData - :warning: Is internal | source code
    • -
    +--- +# `getConstantsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L661) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all constants and classes where they are implemented -
    Get a list of all constants and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for constants from the current class
    $flagsintGet data only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for constants corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getConstantsValues` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L849) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantsValues(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get class constant compiled values according to filters -
    Get class constant compiled values according to filters
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet values only for constants from the current class
    $flagsintGet values only for constants corresponding to the visibility modifiers passed in this value
    +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get values only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get values only for constants corresponding to the visibility modifiers passed in this value | -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    - +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Throws: - - -
    -
    -
    - - - +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    - -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - +***Return value:*** [\phpDocumentor\Reflection\DocBlock](https://github.com/phpDocumentor/ReflectionDocBlock/blob/master/src/DocBlock.php) -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    +--- +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L236) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -
    -
    -
    - - - +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) -Return value: null | int - - -Throws: - - -
    -
    -
    - - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Throws: - - -
    -
    -
    - - - +# `getDocRender` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1262) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getDocRender(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRendererInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface - - -Throws: - - -
    -
    -
    - - - +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L469) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getEndLine(): int; ``` +Get the line number of the end of a class code in a file -
    Get the line number of the end of a class code in a file
    - -Parameters: not specified - -Return value: int +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) +--- -Throws: - - -
    -
    -
    - - - +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getEnumCaseValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/EnumEntity.php#L87) ```php public function getEnumCaseValue(string $name): mixed; ``` +Get enum case value -
    Get enum case value
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    - -Return value: mixed - - -Throws: - +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) -
    -
    -
    - - +--- +# `getEnumCases` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/EnumEntity.php#L45) ```php public function getEnumCases(): array; ``` +Get enum cases values -
    Get enum cases values
    - -Parameters: not specified - -Return value: array - - -Throws: - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - - +--- +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1035) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    - +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L370) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -
    -
    -
    - - - +# `getInterfaceNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/EnumEntity.php#L32) ```php public function getInterfaceNames(): array; ``` +Get a list of class interface names -
    Get a list of class interface names
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getInterfacesEntities(): array; -``` - -
    Get a list of interface entities that the current class implements
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getMethod(string $methodName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; -``` - -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to get
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity - - -Throws: - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getMethodEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; -``` - -
    Get a collection of method entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection - - -Throws: - - - -See: - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getMethods(): array; -``` - -
    Get all methods that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - - -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getMethodsData - :warning: Is internal | source code
    • -
    - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getMethodsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; -``` - -
    Get a list of all methods and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for methods from the current class
    $flagsintGet data only for methods corresponding to the visibility modifiers passed in this value
    - -Return value: array - - -Throws: - - -
    -
    -
    - - - -```php -public function getModifiersString(): string; -``` - -
    Get entity modifiers as a string
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getName(): string; -``` - -
    Full name of the entity
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getNamespaceName(): string; -``` - -
    Get the entity namespace name
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getObjectId(): string; -``` - -
    Get entity unique ID
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getParentClass(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; -``` - -
    Get the entity of the parent class if it exists
    - -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getParentClassEntities(): array; -``` - -
    Get a list of parent class entities
    - -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getParentClassName(): null|string; -``` - -
    Get the name of the parent class entity if it exists
    - -Parameters: not specified - -Return value: null | string - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getParentClassNames(): array; -``` - -
    Get a list of entity names of parent classes
    - -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getPluginData(string $pluginKey): mixed; -``` - -
    Get additional information added using the plugin
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    - -Return value: mixed - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getProperties(): array; -``` - -
    Get all properties that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - - -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getPropertiesData - :warning: Is internal | source code
    • -
    - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getPropertiesData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; -``` - -
    Get a list of all properties and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for properties from the current class
    $flagsintGet data only for properties corresponding to the visibility modifiers passed in this value
    - -Return value: array - - -Throws: - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getProperty(string $propertyName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; -``` - -
    Get the property entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to get
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity - - -Throws: - - -
    -
    -
    - - - -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - -public function getPropertyDefaultValue(string $propertyName): string|array|int|bool|null|float; -``` - -
    Get the compiled value of a property
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: +--- - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property for which you need to get the value
    +# `getInterfacesEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L587) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -Return value: string | array | int | bool | null | float +public function getInterfacesEntities(): array; +``` +Get a list of interface entities that the current class implements +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) - +--- +# `getMethodEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1133) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getPropertyEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection; +public function getMethodEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; ``` +Get a collection of method entities -
    Get a collection of property entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) -Throws: - +public function getMethods(): array; +``` +Get all methods that are available according to the configuration as an array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -See: - -
    -
    -
    +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) - +--- +# `getMethodsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1059) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getRelativeFileName(): null|string; +public function getMethodsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all methods and classes where they are implemented -
    File name relative to project_root configuration parameter
    +***Parameters:*** -Parameters: not specified +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for methods from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for methods corresponding to the visibility modifiers passed in this value | -Return value: null | string +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/EnumEntity.php#L95) +```php +public function getModifiersString(): string; +``` +Get entity modifiers as a string -See: - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L378) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; +public function getName(): string; ``` +Full name of the entity -
    Get the collection of root entities to which this entity belongs
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified +--- -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L397) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +public function getNamespaceName(): string; +``` +Get the entity namespace name -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L142) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getShortName(): string; +public function getObjectId(): string; ``` +Get entity unique ID -
    Short name of the entity
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified +--- -Return value: string +# `getParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L516) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +public function getParentClass(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; +``` +Get the entity of the parent class if it exists -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) - +--- +# `getParentClassEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getStartLine(): int; +public function getParentClassEntities(): array; ``` +Get a list of parent class entities -
    Get the line number of the start of a class code in a file
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified +--- -Return value: int - - -Throws: - +public function getParentClassName(): null|string; +``` +Get the name of the parent class entity if it exists -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L481) ```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getThrows(): array; +public function getParentClassNames(): array; ``` +Get a list of entity names of parent classes -
    Get parsed throws from `throws` doc block
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified +--- -Return value: array +# `getPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L270) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +public function getPluginData(string $pluginKey): mixed; +``` +Get additional information added using the plugin -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) - +--- +# `getProperties` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L963) ```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getThrowsDocBlockLinks(): array; +public function getProperties(): array; ``` +Get all properties that are available according to the configuration as an array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) -Parameters: not specified +--- -Return value: array +# `getPropertiesData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L872) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +public function getPropertiesData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; +``` +Get a list of all properties and classes where they are implemented -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for properties from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for properties corresponding to the visibility modifiers passed in this value | -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1004) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getTraits(): array; +public function getProperty(string $propertyName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; ``` +Get the property entity by its name -
    Get a list of trait entities of the current class
    +***Parameters:*** -Parameters: not specified +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | -Return value: array +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php) + +--- + +# `getPropertyDefaultValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1027) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +public function getPropertyDefaultValue(string $propertyName): string|array|int|bool|null|float; +``` +Get the compiled value of a property -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property for which you need to get the value | -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) - +--- +# `getPropertyEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L934) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function getTraitsNames(): array; +public function getPropertyEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection; ``` +Get a collection of property entities -
    Get a list of class traits names
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) -Parameters: not specified +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) -Return value: array +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L412) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -Throws: - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) - +--- +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L160) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function hasConstant(string $constantName, bool $unsafe = false): bool; +public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Check if a constant exists in a class
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -Parameters: +--- - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the class whose entity you want to check
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    - -Return value: bool +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L386) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity +public function getShortName(): string; +``` +Short name of the entity -Throws: - +public function getStartLine(): int; +``` +Get the line number of the start of a class code in a file -
    -
    -
    +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) - +--- +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity -public function hasDescriptionLinks(): bool; +public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Checking if an entity has links in its description
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: bool +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity -Throws: - +public function getThrowsDocBlockLinks(): array; +``` -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function hasExamples(): bool; +public function getTraits(): array; ``` +Get a list of trait entities of the current class -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: bool +--- +# `getTraitsNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L604) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -Throws: - +public function getTraitsNames(): array; +``` +Get a list of class traits names -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `hasConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L785) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function hasMethod(string $methodName, bool $unsafe = false): bool; +public function hasConstant(string $constantName, bool $unsafe = false): bool; ``` +Check if a constant exists in a class + +***Parameters:*** -
    Check if a method exists in a class
    +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the class whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | -Parameters: +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to check
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +--- -Return value: bool +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +```php +// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity +public function hasDescriptionLinks(): bool; +``` +Checking if an entity has links in its description -Throws: - +public function hasExamples(): bool; +``` +Checking if an entity has `example` docBlock -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1182) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function hasParentClass(string $parentClassName): bool; +public function hasMethod(string $methodName, bool $unsafe = false): bool; ``` +Check if a method exists in a class -
    Check if a certain parent class exists in a chain of parent classes
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamestringSearched parent class
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1250) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity -public function hasProperty(string $propertyName, bool $unsafe = false): bool; +public function hasParentClass(string $parentClassName): bool; ``` +Check if a certain parent class exists in a chain of parent classes -
    Check if a property exists in a class
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to check
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    +| Name | Type | Description | +|:-|:-|:-| +$parentClassName | [string](https://www.php.net/manual/en/language.types.string.php) | Searched parent class | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L644) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasTraits(): bool; ``` +Check if the class contains traits -
    Check if the class contains traits
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `implementsInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1237) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function implementsInterface(string $interfaceName): bool; ``` +Check if a class implements an interface -
    Check if a class implements an interface
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$interfaceName | [string](https://www.php.net/manual/en/language.types.string.php) | Name of the required interface in the interface chain | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfaceNamestringName of the required interface in the interface chain
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isAbstract` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L445) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isAbstract(): bool; ``` +Check that an entity is abstract -
    Check that an entity is abstract
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isClass(): bool; ``` +Check if an entity is a Class -
    Check if an entity is a Class
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isClassLoad` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L343) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isClassLoad(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isDocumentCreationAllowed - :warning: Is internal | source code
    • -
    +--- +# `isDocumentCreationAllowed` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L224) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isDocumentCreationAllowed(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L358) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isEntityDataCanBeLoaded(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L84) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public static function isEntityNameValid(string $entityName): bool; ``` +Check if the name is a valid name for ClassLikeEntity -
    Check if the name is a valid name for ClassLikeEntity
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isEnum` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/EnumEntity.php#L24) ```php public function isEnum(): bool; ``` +Check if an entity is an Enum -
    Check if an entity is an Enum
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -
    -
    -
    - -
      -
    • # - isExternalLibraryEntity - :warning: Is internal | source code
    • -
    +--- +# `isExternalLibraryEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L152) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isExternalLibraryEntity(): bool; ``` +Check if a given entity is an entity from a third party library (connected via composer) -
    Check if a given entity is an entity from a third party library (connected via composer)
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isInGit` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L205) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInGit(): bool; ``` +Checking if class file is in git repository -
    Checking if class file is in git repository
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - +--- +# `isInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L435) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInstantiable(): bool; ``` +Check that an entity is instantiable -
    Check that an entity is instantiable
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L114) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInterface(): bool; ``` +Check if an entity is an Interface -
    Check if an entity is an Interface
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isSubclassOf` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1219) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isSubclassOf(string $className): bool; ``` +Whether the given class is a subclass of the specified class -
    Whether the given class is a subclass of the specified class
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classNamestring-
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isTrait` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L124) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isTrait(): bool; ``` +Check if an entity is a Trait -
    Check if an entity is a Trait
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L94) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public static function normalizeClassName(string $name): string; ``` +Bring the class name to the standard format used in the system -
    Bring the class name to the standard format used in the system
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    - +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    - +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    - +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - - - +# `setCustomAst` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L284) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function setCustomAst(\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Class_|null $customAst): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$customAst | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) \| [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) \| [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) \| [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $customAst\PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Class_ | null-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md index 5961f0c9..0bb671a5 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md @@ -1,3438 +1,1361 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP interface reflection API / InterfaceEntity
    - -

    - InterfaceEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[PHP interface reflection API](/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md) **/** +InterfaceEntity +--- +# [InterfaceEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/InterfaceEntity.php#L12) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; class InterfaceEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity implements \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface, \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface ``` - -
    Object interface
    - -See: - - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - addPluginData - - Add information to aт entity object
    2. -
    3. - cursorToDocAttributeLinkFragment -
    4. -
    5. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    6. -
    7. - getAst - - Get AST for this entity
    8. -
    9. - getCacheKey -
    10. -
    11. - getCachedEntityDependencies -
    12. -
    13. - getConstant - - Get the method entity by its name
    14. -
    15. - getConstantEntitiesCollection - - Get a collection of constant entities
    16. -
    17. - getConstantValue - - Get the compiled value of a constant
    18. -
    19. - getConstants - - Get all constants that are available according to the configuration as an array
    20. -
    21. - getConstantsData - - Get a list of all constants and classes where they are implemented
    22. -
    23. - getConstantsValues - - Get class constant compiled values according to filters
    24. -
    25. - getCurrentRootEntity -
    26. -
    27. - getDescription - - Get entity description
    28. -
    29. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    30. -
    31. - getDocBlock - - Get DocBlock for current entity
    32. -
    33. - getDocComment - - Get the doc comment of an entity
    34. -
    35. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    36. -
    37. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    38. -
    39. - getDocNote - - Get the note annotation value
    40. -
    41. - getDocRender -
    42. -
    43. - getEndLine - - Get the line number of the end of a class code in a file
    44. -
    45. - getEntityDependencies -
    46. -
    47. - getExamples - - Get parsed examples from `examples` doc block
    48. -
    49. - getFileContent -
    50. -
    51. - getFileSourceLink -
    52. -
    53. - getFirstExample - - Get first example from `examples` doc block
    54. -
    55. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    56. -
    57. - getInterfaceNames - - Get a list of class interface names
    58. -
    59. - getInterfacesEntities - - Get a list of interface entities that the current class implements
    60. -
    61. - getMethod - - Get the method entity by its name
    62. -
    63. - getMethodEntitiesCollection - - Get a collection of method entities
    64. -
    65. - getMethods - - Get all methods that are available according to the configuration as an array
    66. -
    67. - getMethodsData - - Get a list of all methods and classes where they are implemented
    68. -
    69. - getModifiersString - - Get entity modifiers as a string
    70. -
    71. - getName - - Full name of the entity
    72. -
    73. - getNamespaceName - - Get the entity namespace name
    74. -
    75. - getObjectId - - Get entity unique ID
    76. -
    77. - getParentClass - - Get the entity of the parent class if it exists
    78. -
    79. - getParentClassEntities - - Get a list of parent class entities
    80. -
    81. - getParentClassName - - Get the name of the parent class entity if it exists
    82. -
    83. - getParentClassNames - - Get a list of entity names of parent classes
    84. -
    85. - getPluginData - - Get additional information added using the plugin
    86. -
    87. - getProperties - - Get all properties that are available according to the configuration as an array
    88. -
    89. - getPropertiesData - - Get a list of all properties and classes where they are implemented
    90. -
    91. - getProperty - - Get the property entity by its name
    92. -
    93. - getPropertyDefaultValue - - Get the compiled value of a property
    94. -
    95. - getPropertyEntitiesCollection - - Get a collection of property entities
    96. -
    97. - getRelativeFileName - - File name relative to project_root configuration parameter
    98. -
    99. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    100. -
    101. - getShortName - - Short name of the entity
    102. -
    103. - getStartLine - - Get the line number of the start of a class code in a file
    104. -
    105. - getThrows - - Get parsed throws from `throws` doc block
    106. -
    107. - getThrowsDocBlockLinks -
    108. -
    109. - getTraits - - Get a list of trait entities of the current class
    110. -
    111. - getTraitsNames - - Get a list of class traits names
    112. -
    113. - hasConstant - - Check if a constant exists in a class
    114. -
    115. - hasDescriptionLinks - - Checking if an entity has links in its description
    116. -
    117. - hasExamples - - Checking if an entity has `example` docBlock
    118. -
    119. - hasMethod - - Check if a method exists in a class
    120. -
    121. - hasParentClass - - Check if a certain parent class exists in a chain of parent classes
    122. -
    123. - hasProperty - - Check if a property exists in a class
    124. -
    125. - hasThrows - - Checking if an entity has `throws` docBlock
    126. -
    127. - hasTraits - - Check if the class contains traits
    128. -
    129. - implementsInterface - - Check if a class implements an interface
    130. -
    131. - isAbstract - - Check that an entity is abstract
    132. -
    133. - isApi - - Checking if an entity has `api` docBlock
    134. -
    135. - isClass - - Check if an entity is a Class
    136. -
    137. - isClassLoad -
    138. -
    139. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    140. -
    141. - isDocumentCreationAllowed -
    142. -
    143. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    144. -
    145. - isEntityDataCacheOutdated -
    146. -
    147. - isEntityDataCanBeLoaded -
    148. -
    149. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    150. -
    151. - isEntityNameValid - - Check if the name is a valid name for ClassLikeEntity
    152. -
    153. - isEnum - - Check if an entity is an Enum
    154. -
    155. - isExternalLibraryEntity - - Check if a given entity is an entity from a third party library (connected via composer)
    156. -
    157. - isInGit - - Checking if class file is in git repository
    158. -
    159. - isInstantiable - - Check that an entity is instantiable
    160. -
    161. - isInterface - - Check if an entity is an Interface
    162. -
    163. - isInternal - - Checking if an entity has `internal` docBlock
    164. -
    165. - isSubclassOf - - Whether the given class is a subclass of the specified class
    166. -
    167. - isTrait - - Check if an entity is a Trait
    168. -
    169. - normalizeClassName - - Bring the class name to the standard format used in the system
    170. -
    171. - reloadEntityDependenciesCache - - Update entity dependency cache
    172. -
    173. - removeEntityValueFromCache -
    174. -
    175. - removeNotUsedEntityDataCache -
    176. -
    177. - setCustomAst -
    178. -
    - - - - - - - -

    Method details:

    - -
    - - - +Object interface + +***Links:*** +- [https://www.php.net/manual/en/language.oop5.interfaces.php](https://www.php.net/manual/en/language.oop5.interfaces.php) + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [addPluginData](#maddplugindata) - Add information to aт entity object +1. [cursorToDocAttributeLinkFragment](#mcursortodocattributelinkfragment) +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getConstant](#mgetconstant) - Get the method entity by its name +1. [getConstantEntitiesCollection](#mgetconstantentitiescollection) - Get a collection of constant entities +1. [getConstantValue](#mgetconstantvalue) - Get the compiled value of a constant +1. [getConstants](#mgetconstants) - Get all constants that are available according to the configuration as an array +1. [getConstantsData](#mgetconstantsdata) - Get a list of all constants and classes where they are implemented +1. [getConstantsValues](#mgetconstantsvalues) - Get class constant compiled values according to filters +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getDocRender](#mgetdocrender) +1. [getEndLine](#mgetendline) - Get the line number of the end of a class code in a file +1. [getEntityDependencies](#mgetentitydependencies) +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getInterfaceNames](#mgetinterfacenames) - Get a list of class interface names +1. [getInterfacesEntities](#mgetinterfacesentities) - Get a list of interface entities that the current class implements +1. [getMethod](#mgetmethod) - Get the method entity by its name +1. [getMethodEntitiesCollection](#mgetmethodentitiescollection) - Get a collection of method entities +1. [getMethods](#mgetmethods) - Get all methods that are available according to the configuration as an array +1. [getMethodsData](#mgetmethodsdata) - Get a list of all methods and classes where they are implemented +1. [getModifiersString](#mgetmodifiersstring) - Get entity modifiers as a string +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Get the entity namespace name +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getParentClass](#mgetparentclass) - Get the entity of the parent class if it exists +1. [getParentClassEntities](#mgetparentclassentities) - Get a list of parent class entities +1. [getParentClassName](#mgetparentclassname) - Get the name of the parent class entity if it exists +1. [getParentClassNames](#mgetparentclassnames) - Get a list of entity names of parent classes +1. [getPluginData](#mgetplugindata) - Get additional information added using the plugin +1. [getProperties](#mgetproperties) - Get all properties that are available according to the configuration as an array +1. [getPropertiesData](#mgetpropertiesdata) - Get a list of all properties and classes where they are implemented +1. [getProperty](#mgetproperty) - Get the property entity by its name +1. [getPropertyDefaultValue](#mgetpropertydefaultvalue) - Get the compiled value of a property +1. [getPropertyEntitiesCollection](#mgetpropertyentitiescollection) - Get a collection of property entities +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getTraits](#mgettraits) - Get a list of trait entities of the current class +1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names +1. [hasConstant](#mhasconstant) - Check if a constant exists in a class +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasMethod](#mhasmethod) - Check if a method exists in a class +1. [hasParentClass](#mhasparentclass) - Check if a certain parent class exists in a chain of parent classes +1. [hasProperty](#mhasproperty) - Check if a property exists in a class +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [hasTraits](#mhastraits) - Check if the class contains traits +1. [implementsInterface](#mimplementsinterface) - Check if a class implements an interface +1. [isAbstract](#misabstract) - Check that an entity is abstract +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isClass](#misclass) - Check if an entity is a Class +1. [isClassLoad](#misclassload) +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isDocumentCreationAllowed](#misdocumentcreationallowed) +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isEntityNameValid](#misentitynamevalid) - Check if the name is a valid name for ClassLikeEntity +1. [isEnum](#misenum) - Check if an entity is an Enum +1. [isExternalLibraryEntity](#misexternallibraryentity) - Check if a given entity is an entity from a third party library (connected via composer) +1. [isInGit](#misingit) - Checking if class file is in git repository +1. [isInstantiable](#misinstantiable) - Check that an entity is instantiable +1. [isInterface](#misinterface) - Check if an entity is an Interface +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isSubclassOf](#missubclassof) - Whether the given class is a subclass of the specified class +1. [isTrait](#mistrait) - Check if an entity is a Trait +1. [normalizeClassName](#mnormalizeclassname) - Bring the class name to the standard format used in the system +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) +1. [setCustomAst](#msetcustomast) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L51) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection $entitiesCollection, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper $composerHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $className, string|null $relativeFileName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$entitiesCollection | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$composerHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ComposerHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$relativeFileName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $entitiesCollection\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $composerHelper\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $classNamestring-
    $relativeFileNamestring | null-
    - - - -
    -
    -
    - - +--- +# `addPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function addPluginData(string $pluginKey, mixed $data): void; ``` +Add information to aт entity object -
    Add information to aт entity object
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$data | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    $datamixed-
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Return value: void - - -
    -
    -
    - -
      -
    • # - cursorToDocAttributeLinkFragment - :warning: Is internal | source code
    • -
    +--- +# `cursorToDocAttributeLinkFragment` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1286) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function cursorToDocAttributeLinkFragment(string $cursor, bool $isForDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $cursorstring-
    $isForDocumentbool-
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L296) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getAst(): \PhpParser\Node\Stmt\Class_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\Class_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ - +***Return value:*** [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) | [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) | [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) -Throws: - - -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L806) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstant(string $constantName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant whose entity you want to get
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity - - -Throws: - - -
    -
    -
    - - +--- +# `getConstantEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L736) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection; ``` +Get a collection of constant entities -
    Get a collection of constant entities
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +--- -Throws: - - - -See: - -
    -
    -
    - - - +# `getConstantValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L829) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantValue(string $constantName): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant for which you need to get the value
    - -Return value: string | array | int | bool | null | float - - -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant for which you need to get the value | -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) - +--- +# `getConstants` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L765) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstants(): array; ``` +Get all constants that are available according to the configuration as an array -
    Get all constants that are available according to the configuration as an array
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) -Return value: array - - -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getConstantsData - :warning: Is internal | source code
    • -
    +--- +# `getConstantsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L661) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all constants and classes where they are implemented -
    Get a list of all constants and classes where they are implemented
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for constants corresponding to the visibility modifiers passed in this value | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for constants from the current class
    $flagsintGet data only for constants corresponding to the visibility modifiers passed in this value
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getConstantsValues` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L849) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantsValues(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get class constant compiled values according to filters -
    Get class constant compiled values according to filters
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet values only for constants from the current class
    $flagsintGet values only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get values only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get values only for constants corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    +--- +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    +***Return value:*** [\phpDocumentor\Reflection\DocBlock](https://github.com/phpDocumentor/ReflectionDocBlock/blob/master/src/DocBlock.php) -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    - +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L236) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) -Parameters: not specified - -Return value: null | int - - -Throws: - - -
    -
    -
    - - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getDocRender` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1262) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getDocRender(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRendererInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface - - -Throws: - - -
    -
    -
    - - - +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L469) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getEndLine(): int; ``` +Get the line number of the end of a class code in a file -
    Get the line number of the end of a class code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1035) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    - +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L370) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -
    -
    -
    - - +--- +# `getInterfaceNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L530) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getInterfaceNames(): array; ``` +Get a list of class interface names -
    Get a list of class interface names
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getInterfacesEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L587) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getInterfacesEntities(): array; ``` +Get a list of interface entities that the current class implements -
    Get a list of interface entities that the current class implements
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1203) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethod(string $methodName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to get
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity - - -Throws: - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) -
    -
    -
    - - +--- +# `getMethodEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1133) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethodEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; ``` +Get a collection of method entities -
    Get a collection of method entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection - - -Throws: - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) -See: - -
    -
    -
    - - +--- +# `getMethods` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1162) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethods(): array; ``` +Get all methods that are available according to the configuration as an array -
    Get all methods that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - - -Throws: - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) -See: - -
    -
    -
    - -
      -
    • # - getMethodsData - :warning: Is internal | source code
    • -
    +--- +# `getMethodsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1059) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethodsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all methods and classes where they are implemented -
    Get a list of all methods and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for methods from the current class
    $flagsintGet data only for methods corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for methods from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for methods corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/InterfaceEntity.php#L33) ```php public function getModifiersString(): string; ``` +Get entity modifiers as a string -
    Get entity modifiers as a string
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L378) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L397) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getNamespaceName(): string; ``` +Get the entity namespace name -
    Get the entity namespace name
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L142) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L516) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClass(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the entity of the parent class if it exists -
    Get the entity of the parent class if it exists
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - +--- +# `getParentClassEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClassEntities(): array; ``` +Get a list of parent class entities -
    Get a list of parent class entities
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -
    -
    -
    - - +--- +# `getParentClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L506) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClassName(): null|string; ``` +Get the name of the parent class entity if it exists -
    Get the name of the parent class entity if it exists
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string - - -
    -
    -
    - - +--- +# `getParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L481) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClassNames(): array; ``` +Get a list of entity names of parent classes -
    Get a list of entity names of parent classes
    - -Parameters: not specified - -Return value: array - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L270) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPluginData(string $pluginKey): mixed; ``` +Get additional information added using the plugin -
    Get additional information added using the plugin
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) -Return value: mixed - - -
    -
    -
    - - +--- +# `getProperties` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L963) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getProperties(): array; ``` +Get all properties that are available according to the configuration as an array -
    Get all properties that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - - -Throws: -
      -
    • - \DI\DependencyException
    • - -
    • - \BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException
    • +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    • - \DI\NotFoundException
    • +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) -
    - - -See: - -
    -
    -
    - -
      -
    • # - getPropertiesData - :warning: Is internal | source code
    • -
    +--- +# `getPropertiesData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L872) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertiesData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all properties and classes where they are implemented -
    Get a list of all properties and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for properties from the current class
    $flagsintGet data only for properties corresponding to the visibility modifiers passed in this value
    - -Return value: array - - -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for properties from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for properties corresponding to the visibility modifiers passed in this value | -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1004) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getProperty(string $propertyName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; ``` +Get the property entity by its name -
    Get the property entity by its name
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to get
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php) -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity - - -Throws: - - -
    -
    -
    - - +--- +# `getPropertyDefaultValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1027) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertyDefaultValue(string $propertyName): string|array|int|bool|null|float; ``` +Get the compiled value of a property -
    Get the compiled value of a property
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property for which you need to get the value
    +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property for which you need to get the value | -Return value: string | array | int | bool | null | float +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) +--- -Throws: - - -
    -
    -
    - - - +# `getPropertyEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L934) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertyEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection; ``` +Get a collection of property entities -
    Get a collection of property entities
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +--- -Throws: - - - -See: - -
    -
    -
    - - - +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L412) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +--- - -See: - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L160) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -
    -
    -
    - - +--- +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L386) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L457) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getStartLine(): int; ``` +Get the line number of the start of a class code in a file -
    Get the line number of the start of a class code in a file
    - -Parameters: not specified - -Return value: int - - -Throws: - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -
    -
    -
    - - +--- +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getTraits(): array; ``` +Get a list of trait entities of the current class -
    Get a list of trait entities of the current class
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getTraitsNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/InterfaceEntity.php#L41) ```php public function getTraitsNames(): array; ``` +Get a list of class traits names -
    Get a list of class traits names
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `hasConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L785) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasConstant(string $constantName, bool $unsafe = false): bool; ``` +Check if a constant exists in a class -
    Check if a constant exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the class whose entity you want to check
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    - -Return value: bool - - -Throws: -
      -
    • - \DI\DependencyException
    • +***Parameters:*** -
    • - \DI\NotFoundException
    • +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the class whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | -
    • - \BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException
    • +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    - -
    -
    -
    - - +--- +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `hasMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1182) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasMethod(string $methodName, bool $unsafe = false): bool; ``` +Check if a method exists in a class -
    Check if a method exists in a class
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to check
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `hasParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1250) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasParentClass(string $parentClassName): bool; ``` +Check if a certain parent class exists in a chain of parent classes -
    Check if a certain parent class exists in a chain of parent classes
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamestringSearched parent class
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$parentClassName | [string](https://www.php.net/manual/en/language.types.string.php) | Searched parent class | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L983) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasProperty(string $propertyName, bool $unsafe = false): bool; ``` +Check if a property exists in a class -
    Check if a property exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to check
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: bool - - -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L644) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasTraits(): bool; ``` +Check if the class contains traits -
    Check if the class contains traits
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `implementsInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1237) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function implementsInterface(string $interfaceName): bool; ``` +Check if a class implements an interface -
    Check if a class implements an interface
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfaceNamestringName of the required interface in the interface chain
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$interfaceName | [string](https://www.php.net/manual/en/language.types.string.php) | Name of the required interface in the interface chain | -Throws: - - -
    -
    -
    - - +--- +# `isAbstract` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/InterfaceEntity.php#L25) ```php public function isAbstract(): bool; ``` +Check that an entity is abstract -
    Check that an entity is abstract
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isClass(): bool; ``` +Check if an entity is a Class -
    Check if an entity is a Class
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isClassLoad` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L343) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isClassLoad(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - -
      -
    • # - isDocumentCreationAllowed - :warning: Is internal | source code
    • -
    +--- +# `isDocumentCreationAllowed` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L224) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isDocumentCreationAllowed(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L358) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isEntityDataCanBeLoaded(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L84) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public static function isEntityNameValid(string $entityName): bool; ``` +Check if the name is a valid name for ClassLikeEntity -
    Check if the name is a valid name for ClassLikeEntity
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isEnum` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L134) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isEnum(): bool; ``` +Check if an entity is an Enum -
    Check if an entity is an Enum
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - -
      -
    • # - isExternalLibraryEntity - :warning: Is internal | source code
    • -
    - +# `isExternalLibraryEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L152) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isExternalLibraryEntity(): bool; ``` +Check if a given entity is an entity from a third party library (connected via composer) -
    Check if a given entity is an entity from a third party library (connected via composer)
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInGit` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L205) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInGit(): bool; ``` +Checking if class file is in git repository -
    Checking if class file is in git repository
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L435) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInstantiable(): bool; ``` +Check that an entity is instantiable -
    Check that an entity is instantiable
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/InterfaceEntity.php#L17) ```php public function isInterface(): bool; ``` +Check if an entity is an Interface -
    Check if an entity is an Interface
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isSubclassOf` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1219) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isSubclassOf(string $className): bool; ``` +Whether the given class is a subclass of the specified class -
    Whether the given class is a subclass of the specified class
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classNamestring-
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Throws: - - -
    -
    -
    - - +--- +# `isTrait` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L124) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isTrait(): bool; ``` +Check if an entity is a Trait -
    Check if an entity is a Trait
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L94) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public static function normalizeClassName(string $name): string; ``` +Bring the class name to the standard format used in the system -
    Bring the class name to the standard format used in the system
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    +***Parameters:*** -Return value: string +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - - - +# `setCustomAst` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L284) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function setCustomAst(\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Class_|null $customAst): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$customAst | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) \| [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) \| [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) \| [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $customAst\PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Class_ | null-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/InvalidConfigurationParameterException.md b/docs/tech/02_parser/reflectionApi/php/classes/InvalidConfigurationParameterException.md deleted file mode 100644 index ac1a4bc3..00000000 --- a/docs/tech/02_parser/reflectionApi/php/classes/InvalidConfigurationParameterException.md +++ /dev/null @@ -1,31 +0,0 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / InvalidConfigurationParameterException
    - -

    - InvalidConfigurationParameterException class: -

    - - - - - -```php -namespace BumbleDocGen\Core\Configuration\Exception; - -final class InvalidConfigurationParameterException extends \Exception -``` - - - - - - - - - - - - - - - - diff --git a/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md index 62f9fec9..487a9b75 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md @@ -1,1777 +1,733 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP class method reflection API / MethodEntity
    - -

    - MethodEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[PHP class method reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md) **/** +MethodEntity +--- +# [MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L31) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method; class MethodEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity implements \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface, \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface ``` - -
    Class method entity
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    2. -
    3. - getAst - - Get AST for this entity
    4. -
    5. - getBodyCode - - Get the code for this method
    6. -
    7. - getCacheKey -
    8. -
    9. - getCachedEntityDependencies -
    10. -
    11. - getCurrentRootEntity -
    12. -
    13. - getDescription - - Get entity description
    14. -
    15. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    16. -
    17. - getDocBlock - - Get DocBlock for current entity
    18. -
    19. - getDocComment - - Get the doc comment of an entity
    20. -
    21. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    22. -
    23. - getDocCommentLine -
    24. -
    25. - getDocNote - - Get the note annotation value
    26. -
    27. - getEndLine - - Get the line number of the end of a method's code in a file
    28. -
    29. - getExamples - - Get parsed examples from `examples` doc block
    30. -
    31. - getFileSourceLink -
    32. -
    33. - getFirstExample - - Get first example from `examples` doc block
    34. -
    35. - getFirstReturnValue - - Get the compiled first return value of a method (if possible)
    36. -
    37. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    38. -
    39. - getImplementingClassName - - Get the name of the class in which this method is implemented
    40. -
    41. - getModifiersString - - Get a text representation of method modifiers
    42. -
    43. - getName - - Full name of the entity
    44. -
    45. - getNamespaceName - - Namespace of the class that contains this method
    46. -
    47. - getObjectId - - Get entity unique ID
    48. -
    49. - getParameters - - Get a list of method parameters
    50. -
    51. - getParametersString - - Get a list of method parameters as a string
    52. -
    53. - getParentMethod - - Get the parent method for this method
    54. -
    55. - getRelativeFileName - - File name relative to project_root configuration parameter
    56. -
    57. - getReturnType - - Get the return type of method
    58. -
    59. - getRootEntity -
    60. -
    61. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    62. -
    63. - getShortName - - Short name of the entity
    64. -
    65. - getSignature - - Get the method signature as a string
    66. -
    67. - getStartColumn - - Get the column number of the beginning of the method code in a file
    68. -
    69. - getStartLine - - Get the line number of the beginning of the entity code in a file
    70. -
    71. - getThrows - - Get parsed throws from `throws` doc block
    72. -
    73. - getThrowsDocBlockLinks -
    74. -
    75. - hasDescriptionLinks - - Checking if an entity has links in its description
    76. -
    77. - hasExamples - - Checking if an entity has `example` docBlock
    78. -
    79. - hasThrows - - Checking if an entity has `throws` docBlock
    80. -
    81. - isApi - - Checking if an entity has `api` docBlock
    82. -
    83. - isConstructor - - Checking that a method is a constructor
    84. -
    85. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    86. -
    87. - isDynamic - - Check if a method is a dynamic method, that is, implementable using __call or __callStatic
    88. -
    89. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    90. -
    91. - isEntityDataCacheOutdated -
    92. -
    93. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    94. -
    95. - isImplementedInParentClass - - Check if this method is implemented in the parent class
    96. -
    97. - isInitialization - - Check if a method is an initialization method
    98. -
    99. - isInternal - - Checking if an entity has `internal` docBlock
    100. -
    101. - isPrivate - - Check if a method is a private method
    102. -
    103. - isProtected - - Check if a method is a protected method
    104. -
    105. - isPublic - - Check if a method is a public method
    106. -
    107. - isStatic - - Check if this method is static
    108. -
    109. - reloadEntityDependenciesCache - - Update entity dependency cache
    110. -
    111. - removeEntityValueFromCache -
    112. -
    113. - removeNotUsedEntityDataCache -
    114. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Class method entity + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getBodyCode](#mgetbodycode) - Get the code for this method +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getEndLine](#mgetendline) - Get the line number of the end of a method's code in a file +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getFirstReturnValue](#mgetfirstreturnvalue) - Get the compiled first return value of a method (if possible) +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getImplementingClassName](#mgetimplementingclassname) - Get the name of the class in which this method is implemented +1. [getModifiersString](#mgetmodifiersstring) - Get a text representation of method modifiers +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Namespace of the class that contains this method +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getParameters](#mgetparameters) - Get a list of method parameters +1. [getParametersString](#mgetparametersstring) - Get a list of method parameters as a string +1. [getParentMethod](#mgetparentmethod) - Get the parent method for this method +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getReturnType](#mgetreturntype) - Get the return type of method +1. [getRootEntity](#mgetrootentity) +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getSignature](#mgetsignature) - Get the method signature as a string +1. [getStartColumn](#mgetstartcolumn) - Get the column number of the beginning of the method code in a file +1. [getStartLine](#mgetstartline) - Get the line number of the beginning of the entity code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isConstructor](#misconstructor) - Checking that a method is a constructor +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isDynamic](#misdynamic) - Check if a method is a dynamic method, that is, implementable using __call or __callStatic +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isImplementedInParentClass](#misimplementedinparentclass) - Check if this method is implemented in the parent class +1. [isInitialization](#misinitialization) - Check if a method is an initialization method +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isPrivate](#misprivate) - Check if a method is a private method +1. [isProtected](#misprotected) - Check if a method is a protected method +1. [isPublic](#mispublic) - Check if a method is a public method +1. [isStatic](#misstatic) - Check if this method is static +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L55) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity $classEntity, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \PhpParser\PrettyPrinter\Standard $astPrinter, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $methodName, string $implementingClassName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$classEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$astPrinter | [\PhpParser\PrettyPrinter\Standard](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/PrettyPrinter/Standard.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$implementingClassName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $classEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $astPrinter\PhpParser\PrettyPrinter\Standard-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $methodNamestring-
    $implementingClassNamestring-
    - - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L78) ```php public function getAst(): \PhpParser\Node\Stmt\ClassMethod; ``` +Get AST for this entity -
    Get AST for this entity
    +***Return value:*** [\PhpParser\Node\Stmt\ClassMethod](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/ClassMethod.php) -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\ClassMethod - - -Throws: - - -
    -
    -
    - - +--- +# `getBodyCode` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L545) ```php public function getBodyCode(): string; ``` +Get the code for this method -
    Get the code for this method
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    - +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Throws: - - -
    -
    -
    - - - +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    - -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    +--- +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L142) ```php public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity - - -
    -
    -
    - - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L200) ```php public function getDocCommentLine(): null|int; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) +--- -Parameters: not specified - -Return value: null | int - - -Throws: - - -
    -
    -
    - - - +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L518) ```php public function getEndLine(): int; ``` +Get the line number of the end of a method's code in a file -
    Get the line number of the end of a method's code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -
    -
    -
    - - +--- +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    +--- +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -Throws: - - -
    -
    -
    - - - +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getFirstReturnValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L529) ```php public function getFirstReturnValue(): mixed; ``` +Get the compiled first return value of a method (if possible) -
    Get the compiled first return value of a method (if possible)
    - -Parameters: not specified - -Return value: mixed - - -
    -
    -
    +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L106) ```php public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) - +--- +# `getImplementingClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L414) ```php public function getImplementingClassName(): string; ``` +Get the name of the class in which this method is implemented -
    Get the name of the class in which this method is implemented
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -
    -
    -
    - - +--- +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L242) ```php public function getModifiersString(): string; ``` +Get a text representation of method modifiers -
    Get a text representation of method modifiers
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L114) ```php public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L130) ```php public function getNamespaceName(): string; ``` +Namespace of the class that contains this method -
    Namespace of the class that contains this method
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L185) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getParameters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L300) ```php public function getParameters(): array; ``` +Get a list of method parameters -
    Get a list of method parameters
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - - +--- +# `getParametersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L392) ```php public function getParametersString(): string; ``` +Get a list of method parameters as a string -
    Get a list of method parameters as a string
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getParentMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L184) ```php public function getParentMethod(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Get the parent method for this method -
    Get the parent method for this method
    - -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity - - -Throws: - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) - +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L232) ```php public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) -Return value: null | string - - - -See: - -
    -
    -
    - - +--- +# `getReturnType` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L269) ```php public function getReturnType(): string; ``` +Get the return type of method -
    Get the return type of method
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getRootEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L90) ```php public function getRootEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L98) ```php public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) +--- -
    -
    -
    - - - +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L122) ```php public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getSignature` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L212) ```php public function getSignature(): string; ``` +Get the method signature as a string -
    Get the method signature as a string
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getStartColumn` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L508) ```php public function getStartColumn(): int; ``` +Get the column number of the beginning of the method code in a file -
    Get the column number of the beginning of the method code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -
    -
    -
    - - +--- +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L498) ```php public function getStartLine(): int; ``` +Get the line number of the beginning of the entity code in a file -
    Get the line number of the beginning of the entity code in a file
    - -Parameters: not specified - -Return value: int - - -
    -
    -
    +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) - +--- +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isConstructor` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L222) ```php public function isConstructor(): bool; ``` +Checking that a method is a constructor -
    Checking that a method is a constructor
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isDynamic` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L448) ```php public function isDynamic(): bool; ``` +Check if a method is a dynamic method, that is, implementable using __call or __callStatic -
    Check if a method is a dynamic method, that is, implementable using __call or __callStatic
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isImplementedInParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L406) ```php public function isImplementedInParentClass(): bool; ``` +Check if this method is implemented in the parent class -
    Check if this method is implemented in the parent class
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isInitialization` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L426) ```php public function isInitialization(): bool; ``` +Check if a method is an initialization method -
    Check if a method is an initialization method
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isPrivate` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L488) ```php public function isPrivate(): bool; ``` +Check if a method is a private method -
    Check if a method is a private method
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isProtected` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L478) ```php public function isProtected(): bool; ``` +Check if a method is a protected method -
    Check if a method is a protected method
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isPublic` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L458) ```php public function isPublic(): bool; ``` +Check if a method is a public method -
    Check if a method is a public method
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isStatic` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php#L468) ```php public function isStatic(): bool; ``` +Check if this method is static -
    Check if this method is static
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Return value: void - - -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md b/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md index b1cf22c2..93fcf638 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md @@ -1,883 +1,354 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP entities collection / PhpEntitiesCollection
    - -

    - PhpEntitiesCollection class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[PHP entities collection](/docs/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md) **/** +PhpEntitiesCollection +--- +# [PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L43) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; final class PhpEntitiesCollection extends \BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection implements \IteratorAggregate ``` - -
    Collection of php root entities
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - add - - Add an entity to the collection
    2. -
    3. - clearOperationsLogCollection -
    4. -
    5. - filterByInterfaces - - Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity)
    6. -
    7. - filterByNameRegularExpression - - Get a copy of the current collection with only entities whose names match the regular expression
    8. -
    9. - filterByParentClassNames - - Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity)
    10. -
    11. - filterByPaths - - Get a copy of the current collection only with entities filtered by file paths (from project_root)
    12. -
    13. - findEntity - - Find an entity in a collection
    14. -
    15. - get - - Get an entity from a collection (only previously added)
    16. -
    17. - getEntityCollectionName - - Get collection name
    18. -
    19. - getEntityLinkData -
    20. -
    21. - getIterator -
    22. -
    23. - getLoadedOrCreateNew - - Get an entity from the collection or create a new one if it has not yet been added
    24. -
    25. - getOnlyAbstractClasses - - Get a copy of the current collection with only abstract classes
    26. -
    27. - getOnlyInstantiable - - Get a copy of the current collection with only instantiable entities
    28. -
    29. - getOnlyInterfaces - - Get a copy of the current collection with only interfaces
    30. -
    31. - getOnlyTraits - - Get a copy of the current collection with only traits
    32. -
    33. - getOperationsLogCollection -
    34. -
    35. - has - - Check if an entity has been added to the collection
    36. -
    37. - internalFindEntity -
    38. -
    39. - internalGetLoadedOrCreateNew -
    40. -
    41. - isEmpty - - Check if the collection is empty or not
    42. -
    43. - loadEntities - - Load entities into a collection
    44. -
    45. - loadEntitiesByConfiguration - - Load entities into a collection by configuration
    46. -
    47. - remove - - Remove an entity from a collection
    48. -
    49. - removeAllNotLoadedEntities -
    50. -
    51. - toArray - - Convert collection to array
    52. -
    53. - updateEntitiesCache -
    54. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Collection of php root entities + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [add](#madd) - Add an entity to the collection +1. [clearOperationsLogCollection](#mclearoperationslogcollection) +1. [filterByInterfaces](#mfilterbyinterfaces) - Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity) +1. [filterByNameRegularExpression](#mfilterbynameregularexpression) - Get a copy of the current collection with only entities whose names match the regular expression +1. [filterByParentClassNames](#mfilterbyparentclassnames) - Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity) +1. [filterByPaths](#mfilterbypaths) - Get a copy of the current collection only with entities filtered by file paths (from project_root) +1. [findEntity](#mfindentity) - Find an entity in a collection +1. [get](#mget) - Get an entity from a collection (only previously added) +1. [getEntityCollectionName](#mgetentitycollectionname) - Get collection name +1. [getEntityLinkData](#mgetentitylinkdata) +1. [getIterator](#mgetiterator) +1. [getLoadedOrCreateNew](#mgetloadedorcreatenew) - Get an entity from the collection or create a new one if it has not yet been added +1. [getOnlyAbstractClasses](#mgetonlyabstractclasses) - Get a copy of the current collection with only abstract classes +1. [getOnlyInstantiable](#mgetonlyinstantiable) - Get a copy of the current collection with only instantiable entities +1. [getOnlyInterfaces](#mgetonlyinterfaces) - Get a copy of the current collection with only interfaces +1. [getOnlyTraits](#mgetonlytraits) - Get a copy of the current collection with only traits +1. [getOperationsLogCollection](#mgetoperationslogcollection) +1. [has](#mhas) - Check if an entity has been added to the collection +1. [internalFindEntity](#minternalfindentity) +1. [internalGetLoadedOrCreateNew](#minternalgetloadedorcreatenew) +1. [isEmpty](#misempty) - Check if the collection is empty or not +1. [loadEntities](#mloadentities) - Load entities into a collection +1. [loadEntitiesByConfiguration](#mloadentitiesbyconfiguration) - Load entities into a collection by configuration +1. [remove](#mremove) - Remove an entity from a collection +1. [removeAllNotLoadedEntities](#mremoveallnotloadedentities) +1. [toArray](#mtoarray) - Convert collection to array +1. [updateEntitiesCache](#mupdateentitiescache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L50) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\Core\Plugin\PluginEventDispatcher $pluginEventDispatcher, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory $cacheablePhpEntityFactory, \BumbleDocGen\LanguageHandler\Php\Renderer\EntityDocRenderer\EntityDocRendererHelper $docRendererHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$pluginEventDispatcher | [\BumbleDocGen\Core\Plugin\PluginEventDispatcher](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginEventDispatcher.php) | - | +$cacheablePhpEntityFactory | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/Cache/CacheablePhpEntityFactory.php) | - | +$docRendererHelper | [\BumbleDocGen\LanguageHandler\Php\Renderer\EntityDocRenderer\EntityDocRendererHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/EntityDocRenderer/EntityDocRendererHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $pluginEventDispatcher\BumbleDocGen\Core\Plugin\PluginEventDispatcher-
    $cacheablePhpEntityFactory\BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory-
    $docRendererHelper\BumbleDocGen\LanguageHandler\Php\Renderer\EntityDocRenderer\EntityDocRendererHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `add` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L190) ```php public function add(\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity $classEntity, bool $reload = false): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Add an entity to the collection -
    Add an entity to the collection
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity-
    $reloadbool-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -Throws: - - -
    -
    -
    - - +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$classEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) | - | +$reload | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | + +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) + +--- + +# `clearOperationsLogCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L28) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function clearOperationsLogCollection(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -
    -
    -
    - - - +# `filterByInterfaces` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L244) ```php public function filterByInterfaces(array $interfaces): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity) -
    Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity)
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfacesstring[]-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Parameters:*** -Throws: - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `filterByNameRegularExpression` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L321) ```php public function filterByNameRegularExpression(string $regexPattern): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection with only entities whose names match the regular expression -
    Get a copy of the current collection with only entities whose names match the regular expression
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $regexPatternstring-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$regexPattern | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) - +--- +# `filterByParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L270) ```php public function filterByParentClassNames(array $parentClassNames): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity) -
    Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity)
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamesarray-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Parameters:*** -Throws: - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `filterByPaths` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L298) ```php public function filterByPaths(array $paths): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection only with entities filtered by file paths (from project_root) -
    Get a copy of the current collection only with entities filtered by file paths (from project_root)
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pathsarray-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$paths | [array](https://www.php.net/manual/en/language.types.array.php) | - | -Throws: - - -
    -
    -
    - - +--- +# `findEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L118) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function findEntity(string $search, bool $useUnsafeKeys = true): null|\BumbleDocGen\Core\Parser\Entity\RootEntityInterface; ``` +Find an entity in a collection + +***Parameters:*** -
    Find an entity in a collection
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $searchstring-
    $useUnsafeKeysbool-
    - -Return value: null | \BumbleDocGen\Core\Parser\Entity\RootEntityInterface - - -
    -
    -
    - - +| Name | Type | Description | +|:-|:-|:-| +$search | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$useUnsafeKeys | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) + +--- + +# `get` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L86) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function get(string $objectName): null|\BumbleDocGen\Core\Parser\Entity\RootEntityInterface; ``` +Get an entity from a collection (only previously added) -
    Get an entity from a collection (only previously added)
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    +***Parameters:*** -Return value: null | \BumbleDocGen\Core\Parser\Entity\RootEntityInterface +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) -
    -
    -
    - - +--- +# `getEntityCollectionName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L66) ```php public function getEntityCollectionName(): string; ``` +Get collection name -
    Get collection name
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - getEntityLinkData - :warning: Is internal | source code
    • -
    +--- +# `getEntityLinkData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L508) ```php public function getEntityLinkData(string $rawLink, string|null $defaultEntityName = null, bool $useUnsafeKeys = true): array; ``` +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$rawLink | [string](https://www.php.net/manual/en/language.types.string.php) | Raw link to an entity or entity element | +$defaultEntityName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Entity name to use if the link does not contain a valid or existing entity name, + but only a cursor on an entity element | +$useUnsafeKeys | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rawLinkstringRaw link to an entity or entity element
    $defaultEntityNamestring | nullEntity name to use if the link does not contain a valid or existing entity name, - but only a cursor on an entity element
    $useUnsafeKeysbool-
    - -Return value: array - - -
    -
    -
    - - +--- +# `getIterator` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L46) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function getIterator(): \Generator; ``` +***Return value:*** [\Generator](https://www.php.net/manual/en/language.generators.overview.php) +--- -Parameters: not specified - -Return value: \Generator - - -
    -
    -
    - - - +# `getLoadedOrCreateNew` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L102) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function getLoadedOrCreateNew(string $objectName, bool $withAddClassEntityToCollectionEvent = false): \BumbleDocGen\Core\Parser\Entity\RootEntityInterface; ``` +Get an entity from the collection or create a new one if it has not yet been added -
    Get an entity from the collection or create a new one if it has not yet been added
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    $withAddClassEntityToCollectionEventbool-
    - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityInterface - - - -See: - -
    -
    -
    - - +***Parameters:*** -```php -public function getOnlyAbstractClasses(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; -``` - -
    Get a copy of the current collection with only abstract classes
    +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$withAddClassEntityToCollectionEvent | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: not specified +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Links:*** +- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](/docs/tech/02_parser/reflectionApi/php/classes/RootEntityInterface.md#misentitydatacanbeloaded) +--- -Throws: - +# `getOnlyAbstractClasses` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L388) +```php +public function getOnlyAbstractClasses(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; +``` +Get a copy of the current collection with only abstract classes -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) - +--- +# `getOnlyInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L338) ```php public function getOnlyInstantiable(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection with only instantiable entities -
    Get a copy of the current collection with only instantiable entities
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -
    -
    -
    - - +--- +# `getOnlyInterfaces` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L354) ```php public function getOnlyInterfaces(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection with only interfaces -
    Get a copy of the current collection with only interfaces
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `getOnlyTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L370) ```php public function getOnlyTraits(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection with only traits -
    Get a copy of the current collection with only traits
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `getOperationsLogCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function getOperationsLogCollection(): \BumbleDocGen\Core\Parser\Entity\CollectionLogOperation\OperationsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionLogOperation\OperationsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionLogOperation/OperationsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionLogOperation\OperationsCollection - - -
    -
    -
    - - - +# `has` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L42) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function has(string $objectName): bool; ``` +Check if an entity has been added to the collection -
    Check if an entity has been added to the collection
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - -
      -
    • # - internalFindEntity - :warning: Is internal | source code
    • -
    +--- +# `internalFindEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L421) ```php public function internalFindEntity(string $search, bool $useUnsafeKeys = true): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Parameters:*** - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $searchstringSearch query. For the search, only the main part is taken, up to the characters: `::`, `->`, `#`. +| Name | Type | Description | +|:-|:-|:-| +$search | [string](https://www.php.net/manual/en/language.types.string.php) | Search query. For the search, only the main part is taken, up to the characters: `::`, `->`, `#`. If the request refers to multiple existing entities and if unsafe keys are allowed, - a warning will be shown and the first entity found will be used.
    $useUnsafeKeysboolWhether to use search keys that can be used to find several entities
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity + a warning will be shown and the first entity found will be used. | +$useUnsafeKeys | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Whether to use search keys that can be used to find several entities | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) - - -Examples of using: - +***Examples of using:*** ```php $entitiesCollection->findEntity('App'); // class name $entitiesCollection->findEntity('BumbleDocGen\Console\App'); // class with namespace @@ -889,318 +360,118 @@ $entitiesCollection->findEntity('/Users/someuser/Desktop/projects/bumble-doc-gen $entitiesCollection->findEntity('https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/App.php'); // source link ``` -
    -
    -
    - -
      -
    • # - internalGetLoadedOrCreateNew - :warning: Is internal | source code
    • -
    +--- +# `internalGetLoadedOrCreateNew` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L214) ```php public function internalGetLoadedOrCreateNew(string $objectName, bool $withAddClassEntityToCollectionEvent = false): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$withAddClassEntityToCollectionEvent | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    $withAddClassEntityToCollectionEventbool-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -Throws: - - -
    -
    -
    - - +--- +# `isEmpty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L52) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function isEmpty(): bool; ``` +Check if the collection is empty or not -
    Check if the collection is empty or not
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `loadEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L100) ```php public function loadEntities(\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection $sourceLocatorsCollection, \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface|null $filters = null, \BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface|null $progressBar = null): \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult; ``` +Load entities into a collection -
    Load entities into a collection
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $sourceLocatorsCollection\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection-
    $filters\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface | null-
    $progressBar\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface | null-
    - -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult - - -Throws: - - -
    -
    -
    - -
      -
    • # - loadEntitiesByConfiguration - :warning: Is internal | source code
    • -
    - -```php -public function loadEntitiesByConfiguration(\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface|null $progressBar = null): \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult; -``` - -
    Load entities into a collection by configuration
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $progressBar\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface | null-
    +***Parameters:*** -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult +| Name | Type | Description | +|:-|:-|:-| +$sourceLocatorsCollection | [\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/SourceLocatorsCollection.php) | - | +$filters | [\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | +$progressBar | [\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntitiesLoaderProgressBarInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionLoadEntitiesResult.php) -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$progressBar | [\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntitiesLoaderProgressBarInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -
    -
    -
    +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionLoadEntitiesResult.php) - +--- +# `remove` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L32) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function remove(string $objectName): void; ``` +Remove an entity from a collection -
    Remove an entity from a collection
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    - -Return value: void +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - +--- +# `removeAllNotLoadedEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L132) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\RootEntityCollection public function removeAllNotLoadedEntities(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -
    -
    -
    - - - +# `toArray` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L127) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\RootEntityCollection public function toArray(): array; ``` +Convert collection to array -
    Convert collection to array
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - updateEntitiesCache - :warning: Is internal | source code
    • -
    +--- +# `updateEntitiesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L97) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\RootEntityCollection public function updateEntitiesCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md b/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md index 0426fe22..a568152f 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md @@ -1,12 +1,14 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PhpHandlerSettings
    - -

    - PhpHandlerSettings class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +PhpHandlerSettings +--- +# [PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L21) class: ```php namespace BumbleDocGen\LanguageHandler\Php; @@ -14,498 +16,144 @@ namespace BumbleDocGen\LanguageHandler\Php; final class PhpHandlerSettings ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [getClassConstantEntityFilter](#mgetclassconstantentityfilter) +1. [getClassEntityFilter](#mgetclassentityfilter) +1. [getComposerConfigFile](#mgetcomposerconfigfile) +1. [getComposerVendorDir](#mgetcomposervendordir) +1. [getCustomTwigFilters](#mgetcustomtwigfilters) +1. [getCustomTwigFunctions](#mgetcustomtwigfunctions) +1. [getEntityDocRenderersCollection](#mgetentitydocrendererscollection) +1. [getFileSourceBaseUrl](#mgetfilesourcebaseurl) +1. [getMethodEntityFilter](#mgetmethodentityfilter) +1. [getPropertyEntityFilter](#mgetpropertyentityfilter) +1. [getPsr4Map](#mgetpsr4map) +1. [getUseComposerAutoload](#mgetusecomposerautoload) +## Methods details: - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getClassConstantEntityFilter -
    2. -
    3. - getClassEntityFilter -
    4. -
    5. - getComposerConfigFile -
    6. -
    7. - getComposerVendorDir -
    8. -
    9. - getCustomTwigFilters -
    10. -
    11. - getCustomTwigFunctions -
    12. -
    13. - getEntityDocRenderersCollection -
    14. -
    15. - getFileSourceBaseUrl -
    16. -
    17. - getMethodEntityFilter -
    18. -
    19. - getPropertyEntityFilter -
    20. -
    21. - getPsr4Map -
    22. -
    23. - getUseComposerAutoload -
    24. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L26) ```php public function __construct(\BumbleDocGen\Core\Configuration\ConfigurationParameterBag $parameterBag, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$parameterBag | [\BumbleDocGen\Core\Configuration\ConfigurationParameterBag](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/ConfigurationParameterBag.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parameterBag\BumbleDocGen\Core\Configuration\ConfigurationParameterBag-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    - - - -
    -
    -
    - - +--- +# `getClassConstantEntityFilter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L63) ```php public function getClassConstantEntityFilter(): \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface - - -Throws: - - -
    -
    -
    - - - +# `getClassEntityFilter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L43) ```php public function getClassEntityFilter(): \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface - - -Throws: - - -
    -
    -
    - - - +# `getComposerConfigFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L176) ```php public function getComposerConfigFile(): null|string; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    - - - +# `getComposerVendorDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L193) ```php public function getComposerVendorDir(): null|string; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    - - - +# `getCustomTwigFilters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L250) ```php public function getCustomTwigFilters(): \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/CustomFiltersCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection - - -Throws: - - -
    -
    -
    - - - +# `getCustomTwigFunctions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L227) ```php public function getCustomTwigFunctions(): \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/CustomFunctionsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection - - -Throws: - - -
    -
    -
    - - - +# `getEntityDocRenderersCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L123) ```php public function getEntityDocRenderersCollection(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRenderersCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRenderersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRenderersCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRenderersCollection - - -Throws: - - -
    -
    -
    - - - +# `getFileSourceBaseUrl` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L144) ```php public function getFileSourceBaseUrl(): null|string; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    - - - +# `getMethodEntityFilter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L83) ```php public function getMethodEntityFilter(): \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface - - -Throws: - - -
    -
    -
    - - - +# `getPropertyEntityFilter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L103) ```php public function getPropertyEntityFilter(): \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface - - -Throws: - - -
    -
    -
    - - - +# `getPsr4Map` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L209) ```php public function getPsr4Map(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getUseComposerAutoload` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L160) ```php public function getUseComposerAutoload(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md index bb36e3bc..a86da0ba 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md @@ -1,1585 +1,625 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP class property reflection API / PropertyEntity
    - -

    - PropertyEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[PHP class property reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md) **/** +PropertyEntity +--- +# [PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L28) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property; class PropertyEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity implements \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface ``` - -
    Class property entity
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    2. -
    3. - getAst - - Get AST for this entity
    4. -
    5. - getCacheKey -
    6. -
    7. - getCachedEntityDependencies -
    8. -
    9. - getCurrentRootEntity -
    10. -
    11. - getDefaultValue - - Get the compiled default value of a property
    12. -
    13. - getDescription - - Get entity description
    14. -
    15. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    16. -
    17. - getDocBlock - - Get DocBlock for current entity
    18. -
    19. - getDocComment - - Get the doc comment of an entity
    20. -
    21. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    22. -
    23. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    24. -
    25. - getDocNote - - Get the note annotation value
    26. -
    27. - getEndLine - - Get the line number of the end of a property's code in a file
    28. -
    29. - getExamples - - Get parsed examples from `examples` doc block
    30. -
    31. - getFileSourceLink -
    32. -
    33. - getFirstExample - - Get first example from `examples` doc block
    34. -
    35. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    36. -
    37. - getImplementingClassName - - Get the name of the class in which this property is implemented
    38. -
    39. - getModifiersString - - Get a text representation of property modifiers
    40. -
    41. - getName - - Full name of the entity
    42. -
    43. - getNamespaceName - - Namespace of the class that contains this property
    44. -
    45. - getObjectId - - Get entity unique ID
    46. -
    47. - getRelativeFileName - - File name relative to project_root configuration parameter
    48. -
    49. - getRootEntity -
    50. -
    51. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    52. -
    53. - getShortName - - Short name of the entity
    54. -
    55. - getStartLine - - Get the line number of the beginning of the entity code in a file
    56. -
    57. - getThrows - - Get parsed throws from `throws` doc block
    58. -
    59. - getThrowsDocBlockLinks -
    60. -
    61. - getType - - Get current property type
    62. -
    63. - hasDescriptionLinks - - Checking if an entity has links in its description
    64. -
    65. - hasExamples - - Checking if an entity has `example` docBlock
    66. -
    67. - hasThrows - - Checking if an entity has `throws` docBlock
    68. -
    69. - isApi - - Checking if an entity has `api` docBlock
    70. -
    71. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    72. -
    73. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    74. -
    75. - isEntityDataCacheOutdated -
    76. -
    77. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    78. -
    79. - isImplementedInParentClass - - Check if this property is implemented in the parent class
    80. -
    81. - isInternal - - Checking if an entity has `internal` docBlock
    82. -
    83. - isPrivate - - Check if a private is a public private
    84. -
    85. - isProtected - - Check if a protected is a public protected
    86. -
    87. - isPublic - - Check if a property is a public property
    88. -
    89. - reloadEntityDependenciesCache - - Update entity dependency cache
    90. -
    91. - removeEntityValueFromCache -
    92. -
    93. - removeNotUsedEntityDataCache -
    94. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Class property entity + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDefaultValue](#mgetdefaultvalue) - Get the compiled default value of a property +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getEndLine](#mgetendline) - Get the line number of the end of a property's code in a file +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getImplementingClassName](#mgetimplementingclassname) - Get the name of the class in which this property is implemented +1. [getModifiersString](#mgetmodifiersstring) - Get a text representation of property modifiers +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Namespace of the class that contains this property +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntity](#mgetrootentity) +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getStartLine](#mgetstartline) - Get the line number of the beginning of the entity code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getType](#mgettype) - Get current property type +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isImplementedInParentClass](#misimplementedinparentclass) - Check if this property is implemented in the parent class +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isPrivate](#misprivate) - Check if a private is a public private +1. [isProtected](#misprotected) - Check if a protected is a public protected +1. [isPublic](#mispublic) - Check if a property is a public property +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L59) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity $classEntity, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $propertyName, string $implementingClassName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$classEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$implementingClassName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $classEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $propertyNamestring-
    $implementingClassNamestring-
    - - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - - -Throws: - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L86) ```php public function getAst(): \PhpParser\Node\Stmt\Property; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\Property - +***Return value:*** [\PhpParser\Node\Stmt\Property](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Property.php) -Throws: - - -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    - +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDefaultValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L370) ```php public function getDefaultValue(): string|array|int|bool|null|float; ``` +Get the compiled default value of a property -
    Get the compiled default value of a property
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) -Parameters: not specified - -Return value: string | array | int | bool | null | float - - -Throws: - - -
    -
    -
    - - +--- +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Throws: - - -
    -
    -
    - - - +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    - -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - +***Return value:*** [\phpDocumentor\Reflection\DocBlock](https://github.com/phpDocumentor/ReflectionDocBlock/blob/master/src/DocBlock.php) -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    +--- +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L135) ```php public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity - - -
    -
    -
    - - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    - -Parameters: not specified - -Return value: null | int - - -Throws: - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L352) ```php public function getEndLine(): int; ``` +Get the line number of the end of a property's code in a file -
    Get the line number of the end of a property's code in a file
    - -Parameters: not specified - -Return value: int +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) +--- -Throws: - - -
    -
    -
    - - - +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    +--- +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - - -Throws: - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L207) ```php public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -
    -
    -
    - - +--- +# `getImplementingClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L199) ```php public function getImplementingClassName(): string; ``` +Get the name of the class in which this property is implemented -
    Get the name of the class in which this property is implemented
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L265) ```php public function getModifiersString(): string; ``` +Get a text representation of property modifiers -
    Get a text representation of property modifiers
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L171) ```php public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L189) ```php public function getNamespaceName(): string; ``` +Namespace of the class that contains this property -
    Namespace of the class that contains this property
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L185) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L217) ```php public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified - -Return value: null | string - - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -See: - -
    -
    -
    +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) - +--- +# `getRootEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L76) ```php public function getRootEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L123) ```php public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L179) ```php public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L337) ```php public function getStartLine(): int; ``` +Get the line number of the beginning of the entity code in a file -
    Get the line number of the beginning of the entity code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -
    -
    -
    - - +--- +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getType` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L231) ```php public function getType(): string; ``` +Get current property type -
    Get current property type
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isImplementedInParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L291) ```php public function isImplementedInParentClass(): bool; ``` +Check if this property is implemented in the parent class -
    Check if this property is implemented in the parent class
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isPrivate` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L327) ```php public function isPrivate(): bool; ``` +Check if a private is a public private -
    Check if a private is a public private
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `isProtected` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L315) ```php public function isProtected(): bool; ``` +Check if a protected is a public protected -
    Check if a protected is a public protected
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isPublic` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L303) ```php public function isPublic(): bool; ``` +Check if a property is a public property -
    Check if a property is a public property
    - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    - +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    - +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/RootEntityInterface.md b/docs/tech/02_parser/reflectionApi/php/classes/RootEntityInterface.md index 1b87c139..c4996fd9 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/RootEntityInterface.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/RootEntityInterface.md @@ -1,469 +1,219 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / RootEntityInterface
    - -

    - RootEntityInterface class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +RootEntityInterface +--- +# [RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L11) class: ```php namespace BumbleDocGen\Core\Parser\Entity; interface RootEntityInterface extends \BumbleDocGen\Core\Parser\Entity\EntityInterface ``` +Since the documentation generator supports several programming languages, +their entities need to correspond to the same interfaces -
    Since the documentation generator supports several programming languages, -their entities need to correspond to the same interfaces
    - - - - - - - -

    Methods:

    - -
      -
    1. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    2. -
    3. - getEntityDependencies -
    4. -
    5. - getFileContent -
    6. -
    7. - getFileSourceLink -
    8. -
    9. - getName - - Full name of the entity
    10. -
    11. - getObjectId - - Entity object ID
    12. -
    13. - getRelativeFileName - - File name relative to project_root configuration parameter
    14. -
    15. - getRootEntityCollection - - Get parent collection of entities
    16. -
    17. - getShortName - - Short name of the entity
    18. -
    19. - isEntityCacheOutdated -
    20. -
    21. - isEntityDataCanBeLoaded - - Checking if it is possible to get the entity data
    22. -
    23. - isEntityNameValid - - Check if entity name is valid
    24. -
    25. - isExternalLibraryEntity - - The entity is loaded from a third party library and should not be treated the same as a standard one
    26. -
    27. - isInGit - - The entity file is in the git repository
    28. -
    29. - normalizeClassName -
    30. -
    +## Methods +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getEntityDependencies](#mgetentitydependencies) +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getName](#mgetname) - Full name of the entity +1. [getObjectId](#mgetobjectid) - Entity object ID +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get parent collection of entities +1. [getShortName](#mgetshortname) - Short name of the entity +1. [isEntityCacheOutdated](#misentitycacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) - Checking if it is possible to get the entity data +1. [isEntityNameValid](#misentitynamevalid) - Check if entity name is valid +1. [isExternalLibraryEntity](#misexternallibraryentity) - The entity is loaded from a third party library and should not be treated the same as a standard one +1. [isInGit](#misingit) - The entity file is in the git repository +1. [normalizeClassName](#mnormalizeclassname) +## Methods details: - - - - -

    Method details:

    - -
    - - - +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L53) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L33) ```php public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L40) ```php public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getFileSourceLink` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L42) ```php public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L30) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L16) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getObjectId(): string; ``` +Entity object ID -
    Entity object ID
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -
    -
    -
    - - +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L46) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +--- - -See: - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getRootEntityCollection(): \BumbleDocGen\Core\Parser\Entity\RootEntityCollection; ``` +Get parent collection of entities -
    Get parent collection of entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityCollection +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) +--- -
    -
    -
    - - - +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L37) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L58) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function isEntityCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L23) ```php public function isEntityDataCanBeLoaded(): bool; ``` +Checking if it is possible to get the entity data -
    Checking if it is possible to get the entity data
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L18) ```php public static function isEntityNameValid(string $entityName): bool; ``` +Check if entity name is valid -
    Check if entity name is valid
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isExternalLibraryEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L28) ```php public function isExternalLibraryEntity(): bool; ``` +The entity is loaded from a third party library and should not be treated the same as a standard one -
    The entity is loaded from a third party library and should not be treated the same as a standard one
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInGit` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L38) ```php public function isInGit(): bool; ``` +The entity file is in the git repository -
    The entity file is in the git repository
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L13) ```php public static function normalizeClassName(string $name): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md index 635487f6..3d49c047 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md @@ -1,3438 +1,1361 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP trait reflection API / TraitEntity
    - -

    - TraitEntity class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[PHP trait reflection API](/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md) **/** +TraitEntity +--- +# [TraitEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/TraitEntity.php#L12) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; class TraitEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity implements \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface, \BumbleDocGen\Core\Parser\Entity\EntityInterface, \BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityInterface ``` - -
    Trait
    - -See: - - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - addPluginData - - Add information to aт entity object
    2. -
    3. - cursorToDocAttributeLinkFragment -
    4. -
    5. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    6. -
    7. - getAst - - Get AST for this entity
    8. -
    9. - getCacheKey -
    10. -
    11. - getCachedEntityDependencies -
    12. -
    13. - getConstant - - Get the method entity by its name
    14. -
    15. - getConstantEntitiesCollection - - Get a collection of constant entities
    16. -
    17. - getConstantValue - - Get the compiled value of a constant
    18. -
    19. - getConstants - - Get all constants that are available according to the configuration as an array
    20. -
    21. - getConstantsData - - Get a list of all constants and classes where they are implemented
    22. -
    23. - getConstantsValues - - Get class constant compiled values according to filters
    24. -
    25. - getCurrentRootEntity -
    26. -
    27. - getDescription - - Get entity description
    28. -
    29. - getDescriptionLinks - - Get parsed links from description and doc blocks `see` and `link`
    30. -
    31. - getDocBlock - - Get DocBlock for current entity
    32. -
    33. - getDocComment - - Get the doc comment of an entity
    34. -
    35. - getDocCommentEntity - - Link to an entity where docBlock is implemented for this entity
    36. -
    37. - getDocCommentLine - - Get the code line number where the docBlock of the current entity begins
    38. -
    39. - getDocNote - - Get the note annotation value
    40. -
    41. - getDocRender -
    42. -
    43. - getEndLine - - Get the line number of the end of a class code in a file
    44. -
    45. - getEntityDependencies -
    46. -
    47. - getExamples - - Get parsed examples from `examples` doc block
    48. -
    49. - getFileContent -
    50. -
    51. - getFileSourceLink -
    52. -
    53. - getFirstExample - - Get first example from `examples` doc block
    54. -
    55. - getImplementingClass - - Get the class like entity in which the current entity was implemented
    56. -
    57. - getInterfaceNames - - Get a list of class interface names
    58. -
    59. - getInterfacesEntities - - Get a list of interface entities that the current class implements
    60. -
    61. - getMethod - - Get the method entity by its name
    62. -
    63. - getMethodEntitiesCollection - - Get a collection of method entities
    64. -
    65. - getMethods - - Get all methods that are available according to the configuration as an array
    66. -
    67. - getMethodsData - - Get a list of all methods and classes where they are implemented
    68. -
    69. - getModifiersString - - Get entity modifiers as a string
    70. -
    71. - getName - - Full name of the entity
    72. -
    73. - getNamespaceName - - Get the entity namespace name
    74. -
    75. - getObjectId - - Get entity unique ID
    76. -
    77. - getParentClass - - Get the entity of the parent class if it exists
    78. -
    79. - getParentClassEntities - - Get a list of parent class entities
    80. -
    81. - getParentClassName - - Get the name of the parent class entity if it exists
    82. -
    83. - getParentClassNames - - Get a list of entity names of parent classes
    84. -
    85. - getPluginData - - Get additional information added using the plugin
    86. -
    87. - getProperties - - Get all properties that are available according to the configuration as an array
    88. -
    89. - getPropertiesData - - Get a list of all properties and classes where they are implemented
    90. -
    91. - getProperty - - Get the property entity by its name
    92. -
    93. - getPropertyDefaultValue - - Get the compiled value of a property
    94. -
    95. - getPropertyEntitiesCollection - - Get a collection of property entities
    96. -
    97. - getRelativeFileName - - File name relative to project_root configuration parameter
    98. -
    99. - getRootEntityCollection - - Get the collection of root entities to which this entity belongs
    100. -
    101. - getShortName - - Short name of the entity
    102. -
    103. - getStartLine - - Get the line number of the start of a class code in a file
    104. -
    105. - getThrows - - Get parsed throws from `throws` doc block
    106. -
    107. - getThrowsDocBlockLinks -
    108. -
    109. - getTraits - - Get a list of trait entities of the current class
    110. -
    111. - getTraitsNames - - Get a list of class traits names
    112. -
    113. - hasConstant - - Check if a constant exists in a class
    114. -
    115. - hasDescriptionLinks - - Checking if an entity has links in its description
    116. -
    117. - hasExamples - - Checking if an entity has `example` docBlock
    118. -
    119. - hasMethod - - Check if a method exists in a class
    120. -
    121. - hasParentClass - - Check if a certain parent class exists in a chain of parent classes
    122. -
    123. - hasProperty - - Check if a property exists in a class
    124. -
    125. - hasThrows - - Checking if an entity has `throws` docBlock
    126. -
    127. - hasTraits - - Check if the class contains traits
    128. -
    129. - implementsInterface - - Check if a class implements an interface
    130. -
    131. - isAbstract - - Check that an entity is abstract
    132. -
    133. - isApi - - Checking if an entity has `api` docBlock
    134. -
    135. - isClass - - Check if an entity is a Class
    136. -
    137. - isClassLoad -
    138. -
    139. - isDeprecated - - Checking if an entity has `deprecated` docBlock
    140. -
    141. - isDocumentCreationAllowed -
    142. -
    143. - isEntityCacheOutdated - - Checking if the entity cache is out of date
    144. -
    145. - isEntityDataCacheOutdated -
    146. -
    147. - isEntityDataCanBeLoaded -
    148. -
    149. - isEntityFileCanBeLoad - - Checking if entity data can be retrieved
    150. -
    151. - isEntityNameValid - - Check if the name is a valid name for ClassLikeEntity
    152. -
    153. - isEnum - - Check if an entity is an Enum
    154. -
    155. - isExternalLibraryEntity - - Check if a given entity is an entity from a third party library (connected via composer)
    156. -
    157. - isInGit - - Checking if class file is in git repository
    158. -
    159. - isInstantiable - - Check that an entity is instantiable
    160. -
    161. - isInterface - - Check if an entity is an Interface
    162. -
    163. - isInternal - - Checking if an entity has `internal` docBlock
    164. -
    165. - isSubclassOf - - Whether the given class is a subclass of the specified class
    166. -
    167. - isTrait - - Check if an entity is a Trait
    168. -
    169. - normalizeClassName - - Bring the class name to the standard format used in the system
    170. -
    171. - reloadEntityDependenciesCache - - Update entity dependency cache
    172. -
    173. - removeEntityValueFromCache -
    174. -
    175. - removeNotUsedEntityDataCache -
    176. -
    177. - setCustomAst -
    178. -
    - - - - - - - -

    Method details:

    - -
    - - - +Trait + +***Links:*** +- [https://www.php.net/manual/en/language.oop5.traits.php](https://www.php.net/manual/en/language.oop5.traits.php) + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [addPluginData](#maddplugindata) - Add information to aт entity object +1. [cursorToDocAttributeLinkFragment](#mcursortodocattributelinkfragment) +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getAst](#mgetast) - Get AST for this entity +1. [getCacheKey](#mgetcachekey) +1. [getCachedEntityDependencies](#mgetcachedentitydependencies) +1. [getConstant](#mgetconstant) - Get the method entity by its name +1. [getConstantEntitiesCollection](#mgetconstantentitiescollection) - Get a collection of constant entities +1. [getConstantValue](#mgetconstantvalue) - Get the compiled value of a constant +1. [getConstants](#mgetconstants) - Get all constants that are available according to the configuration as an array +1. [getConstantsData](#mgetconstantsdata) - Get a list of all constants and classes where they are implemented +1. [getConstantsValues](#mgetconstantsvalues) - Get class constant compiled values according to filters +1. [getCurrentRootEntity](#mgetcurrentrootentity) +1. [getDescription](#mgetdescription) - Get entity description +1. [getDescriptionLinks](#mgetdescriptionlinks) - Get parsed links from description and doc blocks `see` and `link` +1. [getDocBlock](#mgetdocblock) - Get DocBlock for current entity +1. [getDocComment](#mgetdoccomment) - Get the doc comment of an entity +1. [getDocCommentEntity](#mgetdoccommententity) - Link to an entity where docBlock is implemented for this entity +1. [getDocCommentLine](#mgetdoccommentline) - Get the code line number where the docBlock of the current entity begins +1. [getDocNote](#mgetdocnote) - Get the note annotation value +1. [getDocRender](#mgetdocrender) +1. [getEndLine](#mgetendline) - Get the line number of the end of a class code in a file +1. [getEntityDependencies](#mgetentitydependencies) +1. [getExamples](#mgetexamples) - Get parsed examples from `examples` doc block +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getFirstExample](#mgetfirstexample) - Get first example from `examples` doc block +1. [getImplementingClass](#mgetimplementingclass) - Get the class like entity in which the current entity was implemented +1. [getInterfaceNames](#mgetinterfacenames) - Get a list of class interface names +1. [getInterfacesEntities](#mgetinterfacesentities) - Get a list of interface entities that the current class implements +1. [getMethod](#mgetmethod) - Get the method entity by its name +1. [getMethodEntitiesCollection](#mgetmethodentitiescollection) - Get a collection of method entities +1. [getMethods](#mgetmethods) - Get all methods that are available according to the configuration as an array +1. [getMethodsData](#mgetmethodsdata) - Get a list of all methods and classes where they are implemented +1. [getModifiersString](#mgetmodifiersstring) - Get entity modifiers as a string +1. [getName](#mgetname) - Full name of the entity +1. [getNamespaceName](#mgetnamespacename) - Get the entity namespace name +1. [getObjectId](#mgetobjectid) - Get entity unique ID +1. [getParentClass](#mgetparentclass) - Get the entity of the parent class if it exists +1. [getParentClassEntities](#mgetparentclassentities) - Get a list of parent class entities +1. [getParentClassName](#mgetparentclassname) - Get the name of the parent class entity if it exists +1. [getParentClassNames](#mgetparentclassnames) - Get a list of entity names of parent classes +1. [getPluginData](#mgetplugindata) - Get additional information added using the plugin +1. [getProperties](#mgetproperties) - Get all properties that are available according to the configuration as an array +1. [getPropertiesData](#mgetpropertiesdata) - Get a list of all properties and classes where they are implemented +1. [getProperty](#mgetproperty) - Get the property entity by its name +1. [getPropertyDefaultValue](#mgetpropertydefaultvalue) - Get the compiled value of a property +1. [getPropertyEntitiesCollection](#mgetpropertyentitiescollection) - Get a collection of property entities +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get the collection of root entities to which this entity belongs +1. [getShortName](#mgetshortname) - Short name of the entity +1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file +1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block +1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) +1. [getTraits](#mgettraits) - Get a list of trait entities of the current class +1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names +1. [hasConstant](#mhasconstant) - Check if a constant exists in a class +1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description +1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock +1. [hasMethod](#mhasmethod) - Check if a method exists in a class +1. [hasParentClass](#mhasparentclass) - Check if a certain parent class exists in a chain of parent classes +1. [hasProperty](#mhasproperty) - Check if a property exists in a class +1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock +1. [hasTraits](#mhastraits) - Check if the class contains traits +1. [implementsInterface](#mimplementsinterface) - Check if a class implements an interface +1. [isAbstract](#misabstract) - Check that an entity is abstract +1. [isApi](#misapi) - Checking if an entity has `api` docBlock +1. [isClass](#misclass) - Check if an entity is a Class +1. [isClassLoad](#misclassload) +1. [isDeprecated](#misdeprecated) - Checking if an entity has `deprecated` docBlock +1. [isDocumentCreationAllowed](#misdocumentcreationallowed) +1. [isEntityCacheOutdated](#misentitycacheoutdated) - Checking if the entity cache is out of date +1. [isEntityDataCacheOutdated](#misentitydatacacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) +1. [isEntityFileCanBeLoad](#misentityfilecanbeload) - Checking if entity data can be retrieved +1. [isEntityNameValid](#misentitynamevalid) - Check if the name is a valid name for ClassLikeEntity +1. [isEnum](#misenum) - Check if an entity is an Enum +1. [isExternalLibraryEntity](#misexternallibraryentity) - Check if a given entity is an entity from a third party library (connected via composer) +1. [isInGit](#misingit) - Checking if class file is in git repository +1. [isInstantiable](#misinstantiable) - Check that an entity is instantiable +1. [isInterface](#misinterface) - Check if an entity is an Interface +1. [isInternal](#misinternal) - Checking if an entity has `internal` docBlock +1. [isSubclassOf](#missubclassof) - Whether the given class is a subclass of the specified class +1. [isTrait](#mistrait) - Check if an entity is a Trait +1. [normalizeClassName](#mnormalizeclassname) - Bring the class name to the standard format used in the system +1. [reloadEntityDependenciesCache](#mreloadentitydependenciescache) - Update entity dependency cache +1. [removeEntityValueFromCache](#mremoveentityvaluefromcache) +1. [removeNotUsedEntityDataCache](#mremovenotusedentitydatacache) +1. [setCustomAst](#msetcustomast) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L51) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection $entitiesCollection, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper $composerHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger, string $className, string|null $relativeFileName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$entitiesCollection | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$composerHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ComposerHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$relativeFileName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $entitiesCollection\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $composerHelper\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    $classNamestring-
    $relativeFileNamestring | null-
    - - - -
    -
    -
    - - +--- +# `addPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function addPluginData(string $pluginKey, mixed $data): void; ``` +Add information to aт entity object -
    Add information to aт entity object
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$data | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    $datamixed-
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Return value: void - - -
    -
    -
    - -
      -
    • # - cursorToDocAttributeLinkFragment - :warning: Is internal | source code
    • -
    +--- +# `cursorToDocAttributeLinkFragment` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1286) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function cursorToDocAttributeLinkFragment(string $cursor, bool $isForDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $cursorstring-
    $isForDocumentbool-
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getAst` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L296) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getAst(): \PhpParser\Node\Stmt\Class_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_; ``` +Get AST for this entity -
    Get AST for this entity
    - -Parameters: not specified - -Return value: \PhpParser\Node\Stmt\Class_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ - +***Return value:*** [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) | [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) | [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) -Throws: - - -
    -
    -
    - - +--- +# `getCacheKey` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function getCacheKey(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getCachedEntityDependencies - :warning: Is internal | source code
    • -
    - +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCachedEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L806) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstant(string $constantName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant whose entity you want to get
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php) -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity - - -Throws: - - -
    -
    -
    - - +--- +# `getConstantEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L736) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection; ``` +Get a collection of constant entities -
    Get a collection of constant entities
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +--- -Throws: - - - -See: - -
    -
    -
    - - - +# `getConstantValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L829) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantValue(string $constantName): string|array|int|bool|null|float; ``` +Get the compiled value of a constant -
    Get the compiled value of a constant
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the constant for which you need to get the value
    - -Return value: string | array | int | bool | null | float - - -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the constant for which you need to get the value | -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) - +--- +# `getConstants` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L765) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstants(): array; ``` +Get all constants that are available according to the configuration as an array -
    Get all constants that are available according to the configuration as an array
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) -Return value: array - - -Throws: - - - -See: - -
    -
    -
    - -
      -
    • # - getConstantsData - :warning: Is internal | source code
    • -
    +--- +# `getConstantsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L661) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all constants and classes where they are implemented -
    Get a list of all constants and classes where they are implemented
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for constants corresponding to the visibility modifiers passed in this value | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for constants from the current class
    $flagsintGet data only for constants corresponding to the visibility modifiers passed in this value
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getConstantsValues` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L849) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getConstantsValues(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get class constant compiled values according to filters -
    Get class constant compiled values according to filters
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet values only for constants from the current class
    $flagsintGet values only for constants corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get values only for constants from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get values only for constants corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - -
      -
    • # - getCurrentRootEntity - :warning: Is internal | source code
    • -
    +--- +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescription(): string; ``` +Get entity description -
    Get entity description
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDescriptionLinks(): array; ``` +Get parsed links from description and doc blocks `see` and `link` -
    Get parsed links from description and doc blocks `see` and `link`
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocBlock(): \phpDocumentor\Reflection\DocBlock; ``` +Get DocBlock for current entity -
    Get DocBlock for current entity
    +***Return value:*** [\phpDocumentor\Reflection\DocBlock](https://github.com/phpDocumentor/ReflectionDocBlock/blob/master/src/DocBlock.php) -Parameters: not specified - -Return value: \phpDocumentor\Reflection\DocBlock - - -Throws: - - -
    -
    -
    - - +--- +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocComment(): string; ``` +Get the doc comment of an entity -
    Get the doc comment of an entity
    - -Parameters: not specified - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Throws: - - -
    -
    -
    - -
      -
    • # - getDocCommentEntity - :warning: Is internal | source code
    • -
    - +# `getDocCommentEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L236) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getDocCommentEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Link to an entity where docBlock is implemented for this entity -
    Link to an entity where docBlock is implemented for this entity
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) - +--- +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocCommentLine(): null|int; ``` +Get the code line number where the docBlock of the current entity begins -
    Get the code line number where the docBlock of the current entity begins
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [int](https://www.php.net/manual/en/language.types.integer.php) -Parameters: not specified - -Return value: null | int - - -Throws: - - -
    -
    -
    - - +--- +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getDocNote(): string; ``` +Get the note annotation value -
    Get the note annotation value
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getDocRender` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1262) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getDocRender(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRendererInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface - - -Throws: - - -
    -
    -
    - - - +# `getEndLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L469) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getEndLine(): int; ``` +Get the line number of the end of a class code in a file -
    Get the line number of the end of a class code in a file
    - -Parameters: not specified - -Return value: int - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -Throws: - - -
    -
    -
    - - +--- +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getExamples(): array; ``` +Get parsed examples from `examples` doc block -
    Get parsed examples from `examples` doc block
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1035) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - getFileSourceLink - :warning: Is internal | source code
    • -
    - +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getFirstExample(): string; ``` +Get first example from `examples` doc block -
    Get first example from `examples` doc block
    - -Parameters: not specified - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getImplementingClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L370) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getImplementingClass(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the class like entity in which the current entity was implemented -
    Get the class like entity in which the current entity was implemented
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -
    -
    -
    - - +--- +# `getInterfaceNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/TraitEntity.php#L25) ```php public function getInterfaceNames(): array; ``` +Get a list of class interface names -
    Get a list of class interface names
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `getInterfacesEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L587) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getInterfacesEntities(): array; ``` +Get a list of interface entities that the current class implements -
    Get a list of interface entities that the current class implements
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1203) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethod(string $methodName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity; ``` +Get the method entity by its name -
    Get the method entity by its name
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to get
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity - - -Throws: - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntity.php) -
    -
    -
    - - +--- +# `getMethodEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1133) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethodEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection; ``` +Get a collection of method entities -
    Get a collection of method entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection - - -Throws: - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) -See: - -
    -
    -
    - - +--- +# `getMethods` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1162) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethods(): array; ``` +Get all methods that are available according to the configuration as an array -
    Get all methods that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - - -Throws: - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) -See: - -
    -
    -
    - -
      -
    • # - getMethodsData - :warning: Is internal | source code
    • -
    +--- +# `getMethodsData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1059) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getMethodsData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all methods and classes where they are implemented -
    Get a list of all methods and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for methods from the current class
    $flagsintGet data only for methods corresponding to the visibility modifiers passed in this value
    - -Return value: array +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for methods from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for methods corresponding to the visibility modifiers passed in this value | -Throws: - - -
    -
    -
    - - +--- +# `getModifiersString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/TraitEntity.php#L33) ```php public function getModifiersString(): string; ``` +Get entity modifiers as a string -
    Get entity modifiers as a string
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L378) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getNamespaceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L397) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getNamespaceName(): string; ``` +Get the entity namespace name -
    Get the entity namespace name
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L142) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getObjectId(): string; ``` +Get entity unique ID -
    Get entity unique ID
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L516) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClass(): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +Get the entity of the parent class if it exists -
    Get the entity of the parent class if it exists
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - +--- +# `getParentClassEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClassEntities(): array; ``` +Get a list of parent class entities -
    Get a list of parent class entities
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -
    -
    -
    - - +--- +# `getParentClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L506) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClassName(): null|string; ``` +Get the name of the parent class entity if it exists -
    Get the name of the parent class entity if it exists
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string - - -
    -
    -
    - - +--- +# `getParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L481) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getParentClassNames(): array; ``` +Get a list of entity names of parent classes -
    Get a list of entity names of parent classes
    - -Parameters: not specified - -Return value: array - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getPluginData` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L270) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPluginData(string $pluginKey): mixed; ``` +Get additional information added using the plugin -
    Get additional information added using the plugin
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$pluginKey | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginKeystring-
    +***Return value:*** [mixed](https://www.php.net/manual/en/language.types.mixed.php) -Return value: mixed - - -
    -
    -
    - - +--- +# `getProperties` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L963) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getProperties(): array; ``` +Get all properties that are available according to the configuration as an array -
    Get all properties that are available according to the configuration as an array
    - -Parameters: not specified - -Return value: array - - -Throws: -
      -
    • - \DI\DependencyException
    • - -
    • - \BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException
    • +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    • - \DI\NotFoundException
    • +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) -
    - - -See: - -
    -
    -
    - -
      -
    • # - getPropertiesData - :warning: Is internal | source code
    • -
    +--- +# `getPropertiesData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L872) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertiesData(bool $onlyFromCurrentClassAndTraits = false, int $flags = \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity::VISIBILITY_MODIFIERS_FLAG_ANY): array; ``` +Get a list of all properties and classes where they are implemented -
    Get a list of all properties and classes where they are implemented
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $onlyFromCurrentClassAndTraitsboolGet data only for properties from the current class
    $flagsintGet data only for properties corresponding to the visibility modifiers passed in this value
    - -Return value: array - - -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$onlyFromCurrentClassAndTraits | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Get data only for properties from the current class | +$flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get data only for properties corresponding to the visibility modifiers passed in this value | -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1004) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getProperty(string $propertyName, bool $unsafe = false): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity; ``` +Get the property entity by its name -
    Get the property entity by its name
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to get | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to get
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php) -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntity - - -Throws: - - -
    -
    -
    - - +--- +# `getPropertyDefaultValue` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1027) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertyDefaultValue(string $propertyName): string|array|int|bool|null|float; ``` +Get the compiled value of a property -
    Get the compiled value of a property
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property for which you need to get the value
    +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property for which you need to get the value | -Return value: string | array | int | bool | null | float +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) | [array](https://www.php.net/manual/en/language.types.array.php) | [int](https://www.php.net/manual/en/language.types.integer.php) | [bool](https://www.php.net/manual/en/language.types.boolean.php) | [null](https://www.php.net/manual/en/language.types.null.php) | [float](https://www.php.net/manual/en/language.types.float.php) +--- -Throws: - - -
    -
    -
    - - - +# `getPropertyEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L934) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getPropertyEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection; ``` +Get a collection of property entities -
    Get a collection of property entities
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection +***Links:*** +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +--- -Throws: - - - -See: - -
    -
    -
    - - - +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L412) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +--- - -See: - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L160) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getRootEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get the collection of root entities to which this entity belongs -
    Get the collection of root entities to which this entity belongs
    - -Parameters: not specified +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -
    -
    -
    - - +--- +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L386) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Return value: string - - -
    -
    -
    - - +--- +# `getStartLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L457) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getStartLine(): int; ``` +Get the line number of the start of a class code in a file -
    Get the line number of the start of a class code in a file
    - -Parameters: not specified - -Return value: int - - -Throws: - +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) -
    -
    -
    - - +--- +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrows(): array; ``` +Get parsed throws from `throws` doc block -
    Get parsed throws from `throws` doc block
    - -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function getThrowsDocBlockLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getTraits(): array; ``` +Get a list of trait entities of the current class -
    Get a list of trait entities of the current class
    - -Parameters: not specified +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getTraitsNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L604) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function getTraitsNames(): array; ``` +Get a list of class traits names -
    Get a list of class traits names
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - - -
    -
    -
    - - +--- +# `hasConstant` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L785) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasConstant(string $constantName, bool $unsafe = false): bool; ``` +Check if a constant exists in a class -
    Check if a constant exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $constantNamestringThe name of the class whose entity you want to check
    $unsafeboolCheck all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter())
    - -Return value: bool - - -Throws: -
      -
    • - \DI\DependencyException
    • +***Parameters:*** -
    • - \DI\NotFoundException
    • +| Name | Type | Description | +|:-|:-|:-| +$constantName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the class whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all constants, not just the constants allowed in the configuration (@see PhpHandlerSettings::getClassConstantEntityFilter()) | -
    • - \BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException
    • +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    - -
    -
    -
    - - +--- +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasDescriptionLinks(): bool; ``` +Checking if an entity has links in its description -
    Checking if an entity has links in its description
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasExamples(): bool; ``` +Checking if an entity has `example` docBlock -
    Checking if an entity has `example` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `hasMethod` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1182) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasMethod(string $methodName, bool $unsafe = false): bool; ``` +Check if a method exists in a class -
    Check if a method exists in a class
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $methodNamestringThe name of the method whose entity you want to check
    $unsafeboolCheck all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter())
    +| Name | Type | Description | +|:-|:-|:-| +$methodName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the method whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all methods, not just the methods allowed in the configuration (@see PhpHandlerSettings::getMethodEntityFilter()) | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `hasParentClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1250) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasParentClass(string $parentClassName): bool; ``` +Check if a certain parent class exists in a chain of parent classes -
    Check if a certain parent class exists in a chain of parent classes
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamestringSearched parent class
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$parentClassName | [string](https://www.php.net/manual/en/language.types.string.php) | Searched parent class | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `hasProperty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L983) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasProperty(string $propertyName, bool $unsafe = false): bool; ``` +Check if a property exists in a class -
    Check if a property exists in a class
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $propertyNamestringThe name of the property whose entity you want to check
    $unsafeboolCheck all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter())
    - -Return value: bool - - -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$propertyName | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the property whose entity you want to check | +$unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Check all properties, not just the properties allowed in the configuration (@see PhpHandlerSettings::getPropertyEntityFilter()) | -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function hasThrows(): bool; ``` +Checking if an entity has `throws` docBlock -
    Checking if an entity has `throws` docBlock
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `hasTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L644) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function hasTraits(): bool; ``` +Check if the class contains traits -
    Check if the class contains traits
    - -Parameters: not specified +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -Throws: - - -
    -
    -
    - - +--- +# `implementsInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L1237) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function implementsInterface(string $interfaceName): bool; ``` +Check if a class implements an interface -
    Check if a class implements an interface
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfaceNamestringName of the required interface in the interface chain
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$interfaceName | [string](https://www.php.net/manual/en/language.types.string.php) | Name of the required interface in the interface chain | -Throws: - - -
    -
    -
    - - +--- +# `isAbstract` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L445) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isAbstract(): bool; ``` +Check that an entity is abstract -
    Check that an entity is abstract
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isApi(): bool; ``` +Checking if an entity has `api` docBlock -
    Checking if an entity has `api` docBlock
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Throws: - - -
    -
    -
    - - - +# `isClass` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isClass(): bool; ``` +Check if an entity is a Class -
    Check if an entity is a Class
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isClassLoad` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L343) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isClassLoad(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isDeprecated(): bool; ``` +Checking if an entity has `deprecated` docBlock -
    Checking if an entity has `deprecated` docBlock
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - -
      -
    • # - isDocumentCreationAllowed - :warning: Is internal | source code
    • -
    +--- +# `isDocumentCreationAllowed` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L224) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isDocumentCreationAllowed(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityCacheOutdated(): bool; ``` +Checking if the entity cache is out of date -
    Checking if the entity cache is out of date
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - -
      -
    • # - isEntityDataCacheOutdated - :warning: Is internal | source code
    • -
    - +# `isEntityDataCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L94) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function isEntityDataCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L358) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isEntityDataCanBeLoaded(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isEntityFileCanBeLoad(): bool; ``` +Checking if entity data can be retrieved -
    Checking if entity data can be retrieved
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Throws: - - -
    -
    -
    - - +--- +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L84) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public static function isEntityNameValid(string $entityName): bool; ``` +Check if the name is a valid name for ClassLikeEntity -
    Check if the name is a valid name for ClassLikeEntity
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isEnum` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L134) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isEnum(): bool; ``` +Check if an entity is an Enum -
    Check if an entity is an Enum
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - -
      -
    • # - isExternalLibraryEntity - :warning: Is internal | source code
    • -
    - +# `isExternalLibraryEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L152) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isExternalLibraryEntity(): bool; ``` +Check if a given entity is an entity from a third party library (connected via composer) -
    Check if a given entity is an entity from a third party library (connected via composer)
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInGit` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L205) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInGit(): bool; ``` +Checking if class file is in git repository -
    Checking if class file is in git repository
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L435) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInstantiable(): bool; ``` +Check that an entity is instantiable -
    Check that an entity is instantiable
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInterface` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L114) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function isInterface(): bool; ``` +Check if an entity is an Interface -
    Check if an entity is an Interface
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function isInternal(): bool; ``` +Checking if an entity has `internal` docBlock -
    Checking if an entity has `internal` docBlock
    - -Parameters: not specified - -Return value: bool - - -Throws: - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `isSubclassOf` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/TraitEntity.php#L41) ```php public function isSubclassOf(string $className): bool; ``` +Whether the given class is a subclass of the specified class -
    Whether the given class is a subclass of the specified class
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classNamestring-
    - -Return value: bool +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$className | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Throws: - - -
    -
    -
    - - +--- +# `isTrait` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/TraitEntity.php#L17) ```php public function isTrait(): bool; ``` +Check if an entity is a Trait -
    Check if an entity is a Trait
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L94) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public static function normalizeClassName(string $name): string; ``` +Bring the class name to the standard format used in the system -
    Bring the class name to the standard format used in the system
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    +***Parameters:*** -Return value: string +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - reloadEntityDependenciesCache - :warning: Is internal | source code
    • -
    +--- +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity public function reloadEntityDependenciesCache(): array; ``` +Update entity dependency cache -
    Update entity dependency cache
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - removeEntityValueFromCache - :warning: Is internal | source code
    • -
    +--- +# `removeEntityValueFromCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L80) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeEntityValueFromCache(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - -
      -
    • # - removeNotUsedEntityDataCache - :warning: Is internal | source code
    • -
    +--- +# `removeNotUsedEntityDataCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/Cache/CacheableEntityTrait.php#L116) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\Cache\CacheableEntityTrait public function removeNotUsedEntityDataCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - - - +# `setCustomAst` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L284) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity public function setCustomAst(\PhpParser\Node\Stmt\Trait_|\PhpParser\Node\Stmt\Enum_|\PhpParser\Node\Stmt\Interface_|\PhpParser\Node\Stmt\Class_|null $customAst): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$customAst | [\PhpParser\Node\Stmt\Trait_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Trait_.php) \| [\PhpParser\Node\Stmt\Enum_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Enum_.php) \| [\PhpParser\Node\Stmt\Interface_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Interface_.php) \| [\PhpParser\Node\Stmt\Class_](https://github.com/nikic/PHP-Parser/blob/master/lib/PhpParser/Node/Stmt/Class_.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $customAst\PhpParser\Node\Stmt\Trait_ | \PhpParser\Node\Stmt\Enum_ | \PhpParser\Node\Stmt\Interface_ | \PhpParser\Node\Stmt\Class_ | null-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md index b90b25ed..447fe407 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md @@ -1,8 +1,16 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP class constant reflection API
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +PHP class constant reflection API -

    PHP class constant reflection API

    +--- -Class constant reflection entity class: ClassConstantEntity. + +# PHP class constant reflection API + +Class constant reflection entity class: [ClassConstantEntity](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md). **Example of creating class constant reflection:** @@ -27,12 +35,14 @@ $constantReflection = $classReflection->getConstant('constantName'); - [getExamples()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetexamples): Get parsed examples from `examples` doc block - [getFirstExample()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetfirstexample): Get first example from `examples` doc block - [getImplementingClass()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetimplementingclass): Get the class like entity in which the current entity was implemented +- [getModifiersString()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetmodifiersstring): Get a text representation of class constant modifiers - [getNamespaceName()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetnamespacename): Get the name of the namespace where the current class is implemented - [getObjectId()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetobjectid): Get entity unique ID - [getRelativeFileName()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetrelativefilename): File name relative to project_root configuration parameter - [getRootEntityCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetrootentitycollection): Get the collection of root entities to which this entity belongs - [getStartLine()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetstartline): Get the line number of the beginning of the constant code in a file - [getThrows()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetthrows): Get parsed throws from `throws` doc block +- [getType()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgettype): Get current class constant type - [getValue()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetvalue): Get the compiled value of a constant - [hasDescriptionLinks()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mhasdescriptionlinks): Checking if an entity has links in its description - [hasExamples()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mhasexamples): Checking if an entity has `example` docBlock @@ -45,6 +55,6 @@ $constantReflection = $classReflection->getConstant('constantName'); - [isProtected()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#misprotected): Check if a constant is a protected constant - [isPublic()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mispublic): Check if a constant is a public constant -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md index a972c962..37f9288b 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md @@ -1,8 +1,16 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP class method reflection API
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +PHP class method reflection API -

    PHP class method reflection API

    +--- -Method reflection entity class: MethodEntity. + +# PHP class method reflection API + +Method reflection entity class: [MethodEntity](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md). **Example of creating class method reflection:** @@ -60,6 +68,6 @@ $methodReflection = $classReflection->getMethod('methodName'); - [isPublic()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mispublic): Check if a method is a public method - [isStatic()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#misstatic): Check if this method is static -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md index a0dba3d1..7e9d599b 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md @@ -1,8 +1,16 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP class property reflection API
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +PHP class property reflection API -

    PHP class property reflection API

    +--- -Property reflection entity class: PropertyEntity. + +# PHP class property reflection API + +Property reflection entity class: [PropertyEntity](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md). **Example of creating class property reflection:** @@ -51,6 +59,6 @@ $propertyReflection = $classReflection->getProperty('propertyName'); - [isProtected()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#misprotected): Check if a protected is a public protected - [isPublic()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mispublic): Check if a property is a public property -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md index 77561997..9b53ba47 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md @@ -1,8 +1,16 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP class reflection API
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +PHP class reflection API -

    PHP class reflection API

    +--- -PHP class reflection ClassEntity inherits from ClassLikeEntity. + +# PHP class reflection API + +PHP class reflection [ClassEntity](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md) inherits from [ClassLikeEntity](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_4.md). **Source class formats:** @@ -84,6 +92,6 @@ $classReflection = $entitiesCollection->getLoadedOrCreateNew('SomeClassName'); / - [normalizeClassName()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mnormalizeclassname): Bring the class name to the standard format used in the system -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md b/docs/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md index 8d8df162..5f27bb4f 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md +++ b/docs/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md @@ -1,6 +1,14 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP entities collection
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +PHP entities collection -

    PHP entities collection

    +--- + + +# PHP entities collection **PHP entities collection API methods:** @@ -23,6 +31,6 @@ - [remove()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mremove): Remove an entity from a collection - [toArray()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mtoarray): Convert collection to array -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md index 6084c478..bfa984d8 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md @@ -1,8 +1,16 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP enum reflection API
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +PHP enum reflection API -

    PHP enum reflection API

    +--- -PHP enum reflection EnumEntity inherits from ClassLikeEntity. + +# PHP enum reflection API + +PHP enum reflection [EnumEntity](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md) inherits from [ClassLikeEntity](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_3.md). **Source enum formats:** @@ -83,6 +91,6 @@ $enumReflection = $entitiesCollection->getLoadedOrCreateNew('SomeEnumName'); // - [isTrait()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mistrait): Check if an entity is a Trait - [normalizeClassName()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mnormalizeclassname): Bring the class name to the standard format used in the system -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md index 8f6cd7f7..b269b0e4 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md @@ -1,8 +1,16 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP interface reflection API
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +PHP interface reflection API -

    PHP interface reflection API

    +--- -PHP interface reflection InterfaceEntity inherits from ClassLikeEntity. + +# PHP interface reflection API + +PHP interface reflection [InterfaceEntity](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md) inherits from [ClassLikeEntity](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_2.md). **Source interface formats:** @@ -80,6 +88,6 @@ $interfaceReflection = $entitiesCollection->getLoadedOrCreateNew('SomeInterfaceN - [isTrait()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mistrait): Check if an entity is a Trait - [normalizeClassName()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mnormalizeclassname): Bring the class name to the standard format used in the system -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md index 0d06f9b9..e0491fe5 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md @@ -1,8 +1,16 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP / PHP trait reflection API
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +PHP trait reflection API -

    PHP trait reflection API

    +--- -PHP trait reflection TraitEntity inherits from ClassLikeEntity. + +# PHP trait reflection API + +PHP trait reflection [TraitEntity](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md) inherits from [ClassLikeEntity](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity.md). **Source trait formats:** @@ -80,6 +88,6 @@ $traitReflection = $entitiesCollection->getLoadedOrCreateNew('SomeTraitName'); / - [isTrait()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mistrait): Check if an entity is a Trait - [normalizeClassName()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mnormalizeclassname): Bring the class name to the standard format used in the system -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/readme.md b/docs/tech/02_parser/reflectionApi/php/readme.md index f489a1d3..949a3b90 100644 --- a/docs/tech/02_parser/reflectionApi/php/readme.md +++ b/docs/tech/02_parser/reflectionApi/php/readme.md @@ -1,19 +1,26 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API / Reflection API for PHP
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +Reflection API for PHP -

    Reflection API for PHP

    +--- + + +# Reflection API for PHP The tool we implemented partially replicates the [standard PHP reflection API](https://www.php.net/manual/en/book.reflection.php), but it has some additional capabilities. In addition, our Reflection API is available for use in every documentation template, plugin, twig function, etc. at `BumbleDocGen`. -

    Class like reflections

    +## Class like reflections Using our PHP reflection API you can get information about project entities. Below is information about the available methods for working with each entity type: -1) Class reflection -2) Trait reflection -3) Interface reflection -4) Enum reflection +1) [Class reflection](/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md) +2) [Trait reflection](/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md) +3) [Interface reflection](/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md) +4) [Enum reflection](/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md) **Usage example:** @@ -30,13 +37,13 @@ $entityClassCodeStartLine = $classReflection->getStartLine(); // ... etc. ``` -

    Entities collection

    +## Entities collection Class reflections are stored in collections. The collection is filled either before documents are generated, if the Reflection API is used to generate documentation, or when special methods are called that, under certain conditions, fill them with the required reflections. You can perform a number of filtering and searching operations on a collection of entities. -The collections API is presented on this page: PHP entities collection +The collections API is presented on this page: [PHP entities collection](/docs/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md) **Usage example:** @@ -61,13 +68,13 @@ foreach($entitiesCollection as $classReflection) { } ``` -

    Class like sub entities reflections

    +## Class like sub entities reflections PHP classes contain methods, properties and constants. Below is information about these child entities: -1) Class method reflection -2) Class property reflection -3) Class constant reflection +1) [Class method reflection](/docs/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md) +2) [Class property reflection](/docs/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md) +3) [Class constant reflection](/docs/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md) **Usage example:** @@ -86,6 +93,6 @@ $firstMethodReturnValue = $methodReflection->getFirstReturnValue(); // ... etc. ``` -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/readme.md b/docs/tech/02_parser/reflectionApi/readme.md index f30625e1..a8d3cc24 100644 --- a/docs/tech/02_parser/reflectionApi/readme.md +++ b/docs/tech/02_parser/reflectionApi/readme.md @@ -1,67 +1,69 @@ - BumbleDocGen / Technical description of the project / Parser / Reflection API
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +Reflection API -

    Reflection API

    +--- + + +# Reflection API The documentation generator has a convenient Reflection API for analyzing the source code of the project being documented. You can use the Reflection API both in documentation templates and simply in your code where necessary. **See:** -1) **Reflection API for PHP** +1) **[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md)** 2) **[Demo](/demo/demo6-reflection-api/demoScript.php)** -

    Example

    +## Example ```php - // Create a Reflection API config object. This example shows the config for parsing PHP code - $reflectionApiConfig = PhpReflectionApiConfig::create(); - - /** @var PhpEntitiesCollection $entitiesCollection*/ - $entitiesCollection = (new BumbleDocGenDocGeneratorFactory())->createRootEntitiesCollection($reflectionApiConfig); - - // Source locators are needed so that we can determine all the files that will be traversed to fill the collection with data - $sourceLocators = SourceLocatorsCollection::create(new DirectoriesSourceLocator([__DIR__])); - - // We can define special filters according to which entities will be loaded - $filter = new TrueCondition(); - - // By default the collection is empty. You can populate the collection with data - $entitiesCollection->loadEntities( - $sourceLocators, - $filter - ); - - // And now you can use Reflection API - $filename = $entitiesCollection->get('SomeClassName')?->getAbsoluteFileName(); - -``` +// Create a Reflection API config object. This example shows the config for parsing PHP code +$reflectionApiConfig = PhpReflectionApiConfig::create(); +/** @var PhpEntitiesCollection $entitiesCollection*/ +$entitiesCollection = (new \BumbleDocGen\DocGeneratorFactory())->createRootEntitiesCollection($reflectionApiConfig); -

    Example 2 - Working with the Reflection API through a default parsing mechanism

    +// Source locators are needed so that we can determine all the files that will be traversed to fill the collection with data +$sourceLocators = SourceLocatorsCollection::create(new DirectoriesSourceLocator([__DIR__])); -```php - // Create a documentation generator object - $docGen = (new BumbleDocGenDocGeneratorFactory())->create($configFile); - - // Next we get a group of entity collections (according to the configuration) - $entityCollectionsGroup = $docGen->parseAndGetRootEntityCollectionsGroup(); - - // Next, we can get a specific collection, for example for PHP entities - $entitiesCollection = $entityCollectionsGroup->get(PhpEntitiesCollection::class); - - // And now you can use Reflection API - $filename = $entitiesCollection->get('SomeClassName')?->getAbsoluteFileName(); - +// We can define special filters according to which entities will be loaded +$filter = new TrueCondition(); + +// By default, the collection is empty. You can populate the collection with data +$entitiesCollection->loadEntities( + $sourceLocators, + $filter +); + +// And now you can use Reflection API +$filename = $entitiesCollection->get('SomeClassName')?->getAbsoluteFileName(); ``` +## Example 2 - Working with the Reflection API through a default parsing mechanism + +```php +// Create a documentation generator object +$docGen = (new \BumbleDocGen\DocGeneratorFactory())->create($configFile); + +// Next we get a group of entity collections (according to the configuration) +$entityCollectionsGroup = $docGen->parseAndGetRootEntityCollectionsGroup(); + +// Next, we can get a specific collection, for example for PHP entities +$entitiesCollection = $entityCollectionsGroup->get(PhpEntitiesCollection::class); + +// And now you can use Reflection API +$filename = $entitiesCollection->get('SomeClassName')?->getAbsoluteFileName(); +``` This method is used in the documentation generation process. The only difference with the first example is that the first option is more convenient to use as a separate tool. The settings for which entities will be available to the reflector in this case are taken from the configuration file or configuration array, depending on the method of creating the documentation generator instance. -In addition, RootEntityCollectionsGroup is always available through DI, for example when you implement some twig function or plugin. +In addition, [RootEntityCollectionsGroup](/docs/tech/02_parser/reflectionApi/classes/RootEntityCollectionsGroup.md) is always available through DI, for example when you implement some twig function or plugin. + +--- -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/sourceLocator.md b/docs/tech/02_parser/sourceLocator.md index f677a293..c301a2a0 100644 --- a/docs/tech/02_parser/sourceLocator.md +++ b/docs/tech/02_parser/sourceLocator.md @@ -1,28 +1,37 @@ - BumbleDocGen / Technical description of the project / Parser / Source locators
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Parser](/docs/tech/02_parser/readme.md) **/** +Source locators -

    Source locators

    +--- + + +# Source locators Source locators are needed so that the parser knows which files to parse, or to get data on a specific file after the primary parsing procedure Source locators are set in the configuration: ```yaml - source_locators: - - class: \BumbleDocGen\Core\Parser\SourceLocator\RecursiveDirectoriesSourceLocator - arguments: - directories: - - "%project_root%/src" - - "%project_root%/selfdoc" +source_locators: + - class: \\BumbleDocGen\\Core\\Parser\\SourceLocator\\RecursiveDirectoriesSourceLocator + arguments: + directories: + - "%project_root%/src" + - "%project_root%/selfdoc" ``` +You can create your own source locators or use any existing ones. All source locators must implement the [SourceLocatorInterface](/docs/tech/02_parser/classes/SourceLocatorInterface.md) interface. + +## Built-in source locators -You can create your own source locators or use any existing ones. All source locators must implement the SourceLocatorInterface interface. +- [DirectoriesSourceLocator](/docs/tech/02_parser/classes/DirectoriesSourceLocator.md) - Loads all files from the specified directory +- [FileIteratorSourceLocator](/docs/tech/02_parser/classes/FileIteratorSourceLocator.md) - Loads all files using an iterator +- [RecursiveDirectoriesSourceLocator](/docs/tech/02_parser/classes/RecursiveDirectoriesSourceLocator.md) - Loads all files from the specified directories, which are traversed recursively +- [SingleFileSourceLocator](/docs/tech/02_parser/classes/SingleFileSourceLocator.md) - Loads one specific file by its path -

    Built-in source locators

    - +--- -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration.md index 0d1a5a5f..568f73a0 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration.md @@ -1,763 +1,247 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / Front Matter / Configuration
    - -

    - Configuration class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +[Front Matter](/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md) **/** +Configuration +--- +# [Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L30) class: ```php namespace BumbleDocGen\Core\Configuration; final class Configuration ``` - -
    Configuration project documentation
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getAdditionalConsoleCommands -
    2. -
    3. - getCacheDir -
    4. -
    5. - getConfigurationVersion -
    6. -
    7. - getDocGenLibDir -
    8. -
    9. - getGitClientPath -
    10. -
    11. - getIfExists -
    12. -
    13. - getLanguageHandlersCollection -
    14. -
    15. - getOutputDir -
    16. -
    17. - getOutputDirBaseUrl -
    18. -
    19. - getPageLinkProcessor -
    20. -
    21. - getPlugins -
    22. -
    23. - getProjectRoot -
    24. -
    25. - getSourceLocators -
    26. -
    27. - getTemplatesDir -
    28. -
    29. - getTwigFilters -
    30. -
    31. - getTwigFunctions -
    32. -
    33. - getWorkingDir -
    34. -
    35. - isCheckFileInGitBeforeCreatingDocEnabled -
    36. -
    37. - renderWithFrontMatter -
    38. -
    39. - useSharedCache -
    40. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Configuration project documentation + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [getAdditionalConsoleCommands](#mgetadditionalconsolecommands) +1. [getCacheDir](#mgetcachedir) +1. [getConfigurationVersion](#mgetconfigurationversion) +1. [getDocGenLibDir](#mgetdocgenlibdir) +1. [getGitClientPath](#mgetgitclientpath) +1. [getIfExists](#mgetifexists) +1. [getLanguageHandlersCollection](#mgetlanguagehandlerscollection) +1. [getOutputDir](#mgetoutputdir) +1. [getOutputDirBaseUrl](#mgetoutputdirbaseurl) +1. [getPageLinkProcessor](#mgetpagelinkprocessor) +1. [getPlugins](#mgetplugins) +1. [getProjectRoot](#mgetprojectroot) +1. [getSourceLocators](#mgetsourcelocators) +1. [getTemplatesDir](#mgettemplatesdir) +1. [getTwigFilters](#mgettwigfilters) +1. [getTwigFunctions](#mgettwigfunctions) +1. [getWorkingDir](#mgetworkingdir) +1. [isCheckFileInGitBeforeCreatingDocEnabled](#mischeckfileingitbeforecreatingdocenabled) +1. [renderWithFrontMatter](#mrenderwithfrontmatter) +1. [useSharedCache](#musesharedcache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L34) ```php public function __construct(\BumbleDocGen\Core\Configuration\ConfigurationParameterBag $parameterBag, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$parameterBag | [\BumbleDocGen\Core\Configuration\ConfigurationParameterBag](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/ConfigurationParameterBag.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parameterBag\BumbleDocGen\Core\Configuration\ConfigurationParameterBag-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `getAdditionalConsoleCommands` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L377) ```php public function getAdditionalConsoleCommands(): \BumbleDocGen\Console\Command\AdditionalCommandCollection; ``` +***Return value:*** [\BumbleDocGen\Console\Command\AdditionalCommandCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/Command/AdditionalCommandCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Console\Command\AdditionalCommandCollection - - -Throws: - - -
    -
    -
    - - - +# `getCacheDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L205) ```php public function getCacheDir(): null|string; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    - - - +# `getConfigurationVersion` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L42) ```php public function getConfigurationVersion(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getDocGenLibDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L367) ```php public function getDocGenLibDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getGitClientPath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L256) ```php public function getGitClientPath(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getIfExists` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L395) ```php public function getIfExists(mixed $key): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keymixed-
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getLanguageHandlersCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L166) ```php public function getLanguageHandlersCollection(): \BumbleDocGen\LanguageHandler\LanguageHandlersCollection; ``` +***Return value:*** [\BumbleDocGen\LanguageHandler\LanguageHandlersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/LanguageHandlersCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\LanguageHandlersCollection - - -Throws: - - -
    -
    -
    - - - +# `getOutputDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L112) ```php public function getOutputDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getOutputDirBaseUrl` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L150) ```php public function getOutputDirBaseUrl(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getPageLinkProcessor` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L238) ```php public function getPageLinkProcessor(): \BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/PageLinkProcessor/PageLinkProcessorInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface - - -Throws: - - -
    -
    -
    - - - +# `getPlugins` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L187) ```php public function getPlugins(): \BumbleDocGen\Core\Plugin\PluginsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Plugin\PluginsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Plugin\PluginsCollection - - -Throws: - - -
    -
    -
    - - - +# `getProjectRoot` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L50) ```php public function getProjectRoot(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getSourceLocators` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L66) ```php public function getSourceLocators(): \BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/SourceLocatorsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection - - -Throws: - - -
    -
    -
    - - - +# `getTemplatesDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L84) ```php public function getTemplatesDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getTwigFilters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L295) ```php public function getTwigFilters(): \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/CustomFiltersCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection - - -Throws: - - -
    -
    -
    - - - +# `getTwigFunctions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L272) ```php public function getTwigFunctions(): \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/CustomFunctionsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection - - -Throws: - - -
    -
    -
    - - - +# `getWorkingDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L358) ```php public function getWorkingDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - isCheckFileInGitBeforeCreatingDocEnabled - | source code
    • -
    - +# `isCheckFileInGitBeforeCreatingDocEnabled` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L344) ```php public function isCheckFileInGitBeforeCreatingDocEnabled(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `renderWithFrontMatter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L330) ```php public function renderWithFrontMatter(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `useSharedCache` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L316) ```php public function useSharedCache(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration_2.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration_2.md index b2770cc8..b4493c61 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration_2.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration_2.md @@ -1,763 +1,246 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / Configuration
    - -

    - Configuration class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +Configuration +--- +# [Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L30) class: ```php namespace BumbleDocGen\Core\Configuration; final class Configuration ``` - -
    Configuration project documentation
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getAdditionalConsoleCommands -
    2. -
    3. - getCacheDir -
    4. -
    5. - getConfigurationVersion -
    6. -
    7. - getDocGenLibDir -
    8. -
    9. - getGitClientPath -
    10. -
    11. - getIfExists -
    12. -
    13. - getLanguageHandlersCollection -
    14. -
    15. - getOutputDir -
    16. -
    17. - getOutputDirBaseUrl -
    18. -
    19. - getPageLinkProcessor -
    20. -
    21. - getPlugins -
    22. -
    23. - getProjectRoot -
    24. -
    25. - getSourceLocators -
    26. -
    27. - getTemplatesDir -
    28. -
    29. - getTwigFilters -
    30. -
    31. - getTwigFunctions -
    32. -
    33. - getWorkingDir -
    34. -
    35. - isCheckFileInGitBeforeCreatingDocEnabled -
    36. -
    37. - renderWithFrontMatter -
    38. -
    39. - useSharedCache -
    40. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Configuration project documentation + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [getAdditionalConsoleCommands](#mgetadditionalconsolecommands) +1. [getCacheDir](#mgetcachedir) +1. [getConfigurationVersion](#mgetconfigurationversion) +1. [getDocGenLibDir](#mgetdocgenlibdir) +1. [getGitClientPath](#mgetgitclientpath) +1. [getIfExists](#mgetifexists) +1. [getLanguageHandlersCollection](#mgetlanguagehandlerscollection) +1. [getOutputDir](#mgetoutputdir) +1. [getOutputDirBaseUrl](#mgetoutputdirbaseurl) +1. [getPageLinkProcessor](#mgetpagelinkprocessor) +1. [getPlugins](#mgetplugins) +1. [getProjectRoot](#mgetprojectroot) +1. [getSourceLocators](#mgetsourcelocators) +1. [getTemplatesDir](#mgettemplatesdir) +1. [getTwigFilters](#mgettwigfilters) +1. [getTwigFunctions](#mgettwigfunctions) +1. [getWorkingDir](#mgetworkingdir) +1. [isCheckFileInGitBeforeCreatingDocEnabled](#mischeckfileingitbeforecreatingdocenabled) +1. [renderWithFrontMatter](#mrenderwithfrontmatter) +1. [useSharedCache](#musesharedcache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L34) ```php public function __construct(\BumbleDocGen\Core\Configuration\ConfigurationParameterBag $parameterBag, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$parameterBag | [\BumbleDocGen\Core\Configuration\ConfigurationParameterBag](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/ConfigurationParameterBag.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parameterBag\BumbleDocGen\Core\Configuration\ConfigurationParameterBag-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `getAdditionalConsoleCommands` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L377) ```php public function getAdditionalConsoleCommands(): \BumbleDocGen\Console\Command\AdditionalCommandCollection; ``` +***Return value:*** [\BumbleDocGen\Console\Command\AdditionalCommandCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/Command/AdditionalCommandCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Console\Command\AdditionalCommandCollection - - -Throws: - - -
    -
    -
    - - - +# `getCacheDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L205) ```php public function getCacheDir(): null|string; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    - - - +# `getConfigurationVersion` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L42) ```php public function getConfigurationVersion(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getDocGenLibDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L367) ```php public function getDocGenLibDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getGitClientPath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L256) ```php public function getGitClientPath(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getIfExists` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L395) ```php public function getIfExists(mixed $key): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keymixed-
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getLanguageHandlersCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L166) ```php public function getLanguageHandlersCollection(): \BumbleDocGen\LanguageHandler\LanguageHandlersCollection; ``` +***Return value:*** [\BumbleDocGen\LanguageHandler\LanguageHandlersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/LanguageHandlersCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\LanguageHandlersCollection - - -Throws: - - -
    -
    -
    - - - +# `getOutputDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L112) ```php public function getOutputDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getOutputDirBaseUrl` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L150) ```php public function getOutputDirBaseUrl(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getPageLinkProcessor` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L238) ```php public function getPageLinkProcessor(): \BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/PageLinkProcessor/PageLinkProcessorInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface - - -Throws: - - -
    -
    -
    - - - +# `getPlugins` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L187) ```php public function getPlugins(): \BumbleDocGen\Core\Plugin\PluginsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Plugin\PluginsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Plugin\PluginsCollection - - -Throws: - - -
    -
    -
    - - - +# `getProjectRoot` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L50) ```php public function getProjectRoot(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getSourceLocators` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L66) ```php public function getSourceLocators(): \BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/SourceLocatorsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection - - -Throws: - - -
    -
    -
    - - - +# `getTemplatesDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L84) ```php public function getTemplatesDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getTwigFilters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L295) ```php public function getTwigFilters(): \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/CustomFiltersCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection - - -Throws: - - -
    -
    -
    - - - +# `getTwigFunctions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L272) ```php public function getTwigFunctions(): \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/CustomFunctionsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection - - -Throws: - - -
    -
    -
    - - - +# `getWorkingDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L358) ```php public function getWorkingDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - isCheckFileInGitBeforeCreatingDocEnabled - | source code
    • -
    - +# `isCheckFileInGitBeforeCreatingDocEnabled` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L344) ```php public function isCheckFileInGitBeforeCreatingDocEnabled(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `renderWithFrontMatter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L330) ```php public function renderWithFrontMatter(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `useSharedCache` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L316) ```php public function useSharedCache(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrapper.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrapper.md index 8ba4fd69..fbc0d92a 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrapper.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrapper.md @@ -1,300 +1,130 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / DocumentedEntityWrapper
    - -

    - DocumentedEntityWrapper class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +DocumentedEntityWrapper +--- +# [DocumentedEntityWrapper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L14) class: ```php namespace BumbleDocGen\Core\Renderer\Context; final class DocumentedEntityWrapper ``` +Wrapper for the entity that was requested for documentation -
    Wrapper for the entity that was requested for documentation
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getDocRender -
    2. -
    3. - getDocUrl - - Get the relative path to the document to be generated
    4. -
    5. - getDocumentTransformableEntity - - Get entity that is allowed to be documented
    6. -
    7. - getEntityName -
    8. -
    9. - getFileName - - The name of the file to be generated
    10. -
    11. - getKey - - Get document key
    12. -
    13. - getParentDocFilePath -
    14. -
    15. - setParentDocFilePath -
    16. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [getDocRender](#mgetdocrender) +1. [getDocUrl](#mgetdocurl) - Get the relative path to the document to be generated +1. [getDocumentTransformableEntity](#mgetdocumenttransformableentity) - Get entity that is allowed to be documented +1. [getEntityName](#mgetentityname) +1. [getFileName](#mgetfilename) - The name of the file to be generated +1. [getKey](#mgetkey) - Get document key +1. [getParentDocFilePath](#mgetparentdocfilepath) +1. [setParentDocFilePath](#msetparentdocfilepath) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L20) ```php public function __construct(\BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface $documentTransformableEntity, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, string $parentDocFilePath); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$documentTransformableEntity | [\BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentTransformableEntityInterface.php) | An entity that is allowed to be documented | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$parentDocFilePath | [string](https://www.php.net/manual/en/language.types.string.php) | The file in which the documentation of the entity was requested | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $documentTransformableEntity\BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterfaceAn entity that is allowed to be documented
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $parentDocFilePathstringThe file in which the documentation of the entity was requested
    - - - -
    -
    -
    - - +--- +# `getDocRender` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L27) ```php public function getDocRender(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRendererInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface - - -
    -
    -
    - - - +# `getDocUrl` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L88) ```php public function getDocUrl(): string; ``` +Get the relative path to the document to be generated -
    Get the relative path to the document to be generated
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getDocumentTransformableEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L80) ```php public function getDocumentTransformableEntity(): \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface; ``` +Get entity that is allowed to be documented -
    Get entity that is allowed to be documented
    +***Return value:*** [\BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentTransformableEntityInterface.php) -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface - - -
    -
    -
    - - +--- +# `getEntityName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L40) ```php public function getEntityName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L72) ```php public function getFileName(): string; ``` +The name of the file to be generated -
    The name of the file to be generated
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getKey` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L35) ```php public function getKey(): string; ``` +Get document key -
    Get document key
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -
    -
    -
    - - +--- +# `getParentDocFilePath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L96) ```php public function getParentDocFilePath(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `setParentDocFilePath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L101) ```php public function setParentDocFilePath(string $parentDocFilePath): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$parentDocFilePath | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentDocFilePathstring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrappersCollection.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrappersCollection.md index 96e1dcaa..13e60b39 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrappersCollection.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrappersCollection.md @@ -1,12 +1,13 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / DocumentedEntityWrappersCollection
    - -

    - DocumentedEntityWrappersCollection class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +DocumentedEntityWrappersCollection +--- +# [DocumentedEntityWrappersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L14) class: ```php namespace BumbleDocGen\Core\Renderer\Context; @@ -14,203 +15,72 @@ namespace BumbleDocGen\Core\Renderer\Context; final class DocumentedEntityWrappersCollection implements \IteratorAggregate, \Countable ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [count](#mcount) +1. [createAndAddDocumentedEntityWrapper](#mcreateandadddocumentedentitywrapper) +1. [getDocumentedEntitiesRelations](#mgetdocumentedentitiesrelations) +1. [getIterator](#mgetiterator) +## Methods details: - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - count -
    2. -
    3. - createAndAddDocumentedEntityWrapper -
    4. -
    5. - getDocumentedEntitiesRelations -
    6. -
    7. - getIterator -
    8. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L21) ```php public function __construct(\BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Plugin\PluginEventDispatcher $pluginEventDispatcher); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rendererContext | [\BumbleDocGen\Core\Renderer\Context\RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$pluginEventDispatcher | [\BumbleDocGen\Core\Plugin\PluginEventDispatcher](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginEventDispatcher.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rendererContext\BumbleDocGen\Core\Renderer\Context\RendererContext-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $pluginEventDispatcher\BumbleDocGen\Core\Plugin\PluginEventDispatcher-
    - - - -
    -
    -
    - - +--- +# `count` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L76) ```php public function count(): int; ``` +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) +--- -Parameters: not specified - -Return value: int - - -
    -
    -
    - - - +# `createAndAddDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L42) ```php public function createAndAddDocumentedEntityWrapper(\BumbleDocGen\Core\Parser\Entity\RootEntityInterface $rootEntity): \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rootEntity | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rootEntity\BumbleDocGen\Core\Parser\Entity\RootEntityInterface-
    - -Return value: \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper - - -Throws: - - -
    -
    -
    +***Return value:*** [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php) - +--- +# `getDocumentedEntitiesRelations` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L71) ```php public function getDocumentedEntitiesRelations(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getIterator` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L29) ```php public function getIterator(): \Generator; ``` +***Return value:*** [\Generator](https://www.php.net/manual/en/language.generators.overview.php) - -Parameters: not specified - -Return value: \Generator - - -
    -
    +--- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/DrawDocumentationMenu.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/DrawDocumentationMenu.md index 6da79a1e..5cc6a413 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/DrawDocumentationMenu.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/DrawDocumentationMenu.md @@ -1,54 +1,41 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / Front Matter / DrawDocumentationMenu
    - -

    - DrawDocumentationMenu class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +[Front Matter](/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md) **/** +DrawDocumentationMenu +--- +# [DrawDocumentationMenu](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L29) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class DrawDocumentationMenu implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Generate documentation menu in MD format. To generate the menu, the start page is taken, +and all links with this page are recursively collected for it, after which the html menu is created. -
    Generate documentation menu in HTML format. To generate the menu, the start page is taken, -and all links with this page are recursively collected for it, after which the html menu is created.
    - -See: - - - -Examples of using: +***Links:*** +- [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl_2.md) +***Examples of using:*** ```php {{ drawDocumentationMenu() }} - The menu contains links to all documents - ``` - ```php {{ drawDocumentationMenu('/render/index.md') }} - The menu contains links to all child documents from the /render/index.md file (for example /render/test/index.md) - ``` - ```php {{ drawDocumentationMenu(_self) }} - The menu contains links to all child documents from the file where this function was called - ``` - ```php {{ drawDocumentationMenu(_self, 2) }} - The menu contains links to all child documents from the file where this function was called, but no more than 2 in depth - ``` - -

    Settings:

    @@ -58,188 +45,65 @@ See:
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L31) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$rendererContext | [\BumbleDocGen\Core\Renderer\Context\RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php) | - | +$dependencyFactory | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/Dependency/RendererDependencyFactory.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $rendererContext\BumbleDocGen\Core\Renderer\Context\RendererContext-
    $dependencyFactory\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L64) ```php public function __invoke(string|null $startPageKey = null, int|null $maxDeep = null): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$startPageKey | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Relative path to the page from which the menu will be generated (only child pages will be taken into account). + By default, the main documentation page (readme.md) is used. | +$maxDeep | [int](https://www.php.net/manual/en/language.types.integer.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Maximum parsing depth of documented links starting from the current page. + By default, this restriction is disabled. | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $startPageKeystring | nullRelative path to the page from which the menu will be generated (only child pages will be taken into account). - By default, the main documentation page (readme.md) is used.
    $maxDeepint | nullMaximum parsing depth of documented links starting from the current page. - By default, this restriction is disabled.
    - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L39) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L44) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentationPageUrl.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentationPageUrl.md index 18f448e9..08cb13a9 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentationPageUrl.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentationPageUrl.md @@ -1,47 +1,37 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / Linking templates / GetDocumentationPageUrl
    - -

    - GetDocumentationPageUrl class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +[Linking templates](/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md) **/** +GetDocumentationPageUrl +--- +# [GetDocumentationPageUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php#L21) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class GetDocumentationPageUrl implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Creates an entity link by object -
    Creates an entity link by object
    - - -Examples of using: - +***Examples of using:*** ```php {{ getDocumentationPageUrl('Page name') }} - ``` - ```php {{ getDocumentationPageUrl('/someDir/someTemplate.md.twig') }} - ``` - ```php {{ getDocumentationPageUrl('/docs/someDir/someDocFile.md') }} - ``` - ```php {{ getDocumentationPageUrl('readme.md') }} - ``` - -

    Settings:

    @@ -51,179 +41,61 @@ final class GetDocumentationPageUrl implements \BumbleDocGen\Core\Renderer\Twig\
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php#L25) ```php public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php#L53) ```php public function __invoke(string $key): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | The key by which to look up the URL of the page. + Can be the title of a page, a path to a template, or a generated document | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystringThe key by which to look up the URL of the page. - Can be the title of a page, a path to a template, or a generated document
    - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php#L31) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php#L36) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl.md index 7f5fbfdb..e196660f 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl.md @@ -1,56 +1,43 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / Linking templates / GetDocumentedEntityUrl
    - -

    - GetDocumentedEntityUrl class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +[Linking templates](/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md) **/** +GetDocumentedEntityUrl +--- +# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L37) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class GetDocumentedEntityUrl implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Get the URL of a documented entity by its name. If the entity is found, next to the file where this method was called, +the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created -
    Get the URL of a documented entity by its name. If the entity is found, next to the file where this method was called, -the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created
    - -See: - - - -Examples of using: +***Links:*** +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrapper.md) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrappersCollection.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/03_renderer/01_howToCreateTemplates/classes/RendererContext.md) +***Examples of using:*** ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension', 'getFunctions') }} The function returns a reference to the documented entity, anchored to the getFunctions method - ``` - ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension') }} The function returns a reference to the documented entity MainExtension - ``` - ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension', '', false) }} The function returns a link to the file MainExtension - ``` - -

    Settings:

    @@ -60,204 +47,66 @@ The function returns a link to the file MainExtension
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L41) ```php public function __construct(\BumbleDocGen\Core\Renderer\RendererHelper $rendererHelper, \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection $documentedEntityWrappersCollection, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Monolog\Logger $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rendererHelper | [\BumbleDocGen\Core\Renderer\RendererHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/RendererHelper.php) | - | +$documentedEntityWrappersCollection | [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/Monolog/Logger.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rendererHelper\BumbleDocGen\Core\Renderer\RendererHelper-
    $documentedEntityWrappersCollection\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection-
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $logger\Monolog\Logger-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L76) ```php public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | Processed entity collection | +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | The full name of the entity for which the URL will be retrieved. + If the entity is not found, the DEFAULT_URL value will be returned. | +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | Cursor on the page of the documented entity (for example, the name of a method or property) | +$createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | If true, creates an entity document. Otherwise, just gives a reference to the entity code | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rootEntityCollection\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionProcessed entity collection
    $entityNamestringThe full name of the entity for which the URL will be retrieved. - If the entity is not found, the DEFAULT_URL value will be returned.
    $cursorstringCursor on the page of the documented entity (for example, the name of a method or property)
    $createDocumentboolIf true, creates an entity document. Otherwise, just gives a reference to the entity code
    - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L49) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L54) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl_2.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl_2.md index 3e39559c..b7fb2ada 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl_2.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl_2.md @@ -1,56 +1,42 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / GetDocumentedEntityUrl
    - -

    - GetDocumentedEntityUrl class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +GetDocumentedEntityUrl +--- +# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L37) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class GetDocumentedEntityUrl implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Get the URL of a documented entity by its name. If the entity is found, next to the file where this method was called, +the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created -
    Get the URL of a documented entity by its name. If the entity is found, next to the file where this method was called, -the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created
    - -See: - - - -Examples of using: +***Links:*** +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrapper.md) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrappersCollection.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/03_renderer/01_howToCreateTemplates/classes/RendererContext.md) +***Examples of using:*** ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension', 'getFunctions') }} The function returns a reference to the documented entity, anchored to the getFunctions method - ``` - ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension') }} The function returns a reference to the documented entity MainExtension - ``` - ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension', '', false) }} The function returns a link to the file MainExtension - ``` - -

    Settings:

    @@ -60,204 +46,66 @@ The function returns a link to the file MainExtension
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L41) ```php public function __construct(\BumbleDocGen\Core\Renderer\RendererHelper $rendererHelper, \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection $documentedEntityWrappersCollection, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Monolog\Logger $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rendererHelper | [\BumbleDocGen\Core\Renderer\RendererHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/RendererHelper.php) | - | +$documentedEntityWrappersCollection | [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/Monolog/Logger.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rendererHelper\BumbleDocGen\Core\Renderer\RendererHelper-
    $documentedEntityWrappersCollection\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection-
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $logger\Monolog\Logger-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L76) ```php public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | Processed entity collection | +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | The full name of the entity for which the URL will be retrieved. + If the entity is not found, the DEFAULT_URL value will be returned. | +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | Cursor on the page of the documented entity (for example, the name of a method or property) | +$createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | If true, creates an entity document. Otherwise, just gives a reference to the entity code | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rootEntityCollection\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionProcessed entity collection
    $entityNamestringThe full name of the entity for which the URL will be retrieved. - If the entity is not found, the DEFAULT_URL value will be returned.
    $cursorstringCursor on the page of the documented entity (for example, the name of a method or property)
    $createDocumentboolIf true, creates an entity document. Otherwise, just gives a reference to the entity code
    - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L49) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L54) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/InvalidConfigurationParameterException.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/InvalidConfigurationParameterException.md deleted file mode 100644 index 7d350595..00000000 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/InvalidConfigurationParameterException.md +++ /dev/null @@ -1,31 +0,0 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / InvalidConfigurationParameterException
    - -

    - InvalidConfigurationParameterException class: -

    - - - - - -```php -namespace BumbleDocGen\Core\Configuration\Exception; - -final class InvalidConfigurationParameterException extends \Exception -``` - - - - - - - - - - - - - - - - diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/LanguageHandlerInterface.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/LanguageHandlerInterface.md index c0c9d8e4..15248528 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/LanguageHandlerInterface.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/LanguageHandlerInterface.md @@ -1,12 +1,14 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / Templates variables / LanguageHandlerInterface
    - -

    - LanguageHandlerInterface class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +[Templates variables](/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md) **/** +LanguageHandlerInterface +--- +# [LanguageHandlerInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/LanguageHandlerInterface.php#L12) class: ```php namespace BumbleDocGen\LanguageHandler; @@ -14,154 +16,62 @@ namespace BumbleDocGen\LanguageHandler; interface LanguageHandlerInterface ``` +## Methods +1. [getCustomTwigFilters](#mgetcustomtwigfilters) - Additional twig filters that are added to the built-in ones when a language handler is included +1. [getCustomTwigFunctions](#mgetcustomtwigfunctions) - Additional twig functions that are added to the built-in ones when a language handler is included +1. [getEntityCollection](#mgetentitycollection) +1. [getLanguageKey](#mgetlanguagekey) - Unique language handler key +## Methods details: - - - - - -

    Methods:

    - -
      -
    1. - getCustomTwigFilters - - Additional twig filters that are added to the built-in ones when a language handler is included
    2. -
    3. - getCustomTwigFunctions - - Additional twig functions that are added to the built-in ones when a language handler is included
    4. -
    5. - getEntityCollection -
    6. -
    7. - getLanguageKey - - Unique language handler key
    8. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `getCustomTwigFilters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/LanguageHandlerInterface.php#L27) ```php public function getCustomTwigFilters(\BumbleDocGen\Core\Renderer\Context\RendererContext $context): \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection; ``` +Additional twig filters that are added to the built-in ones when a language handler is included -
    Additional twig filters that are added to the built-in ones when a language handler is included
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $context\BumbleDocGen\Core\Renderer\Context\RendererContext-
    +***Parameters:*** -Return value: \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection +| Name | Type | Description | +|:-|:-|:-| +$context | [\BumbleDocGen\Core\Renderer\Context\RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php) | - | +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/CustomFiltersCollection.php) -
    -
    -
    - - +--- +# `getCustomTwigFunctions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/LanguageHandlerInterface.php#L22) ```php public function getCustomTwigFunctions(\BumbleDocGen\Core\Renderer\Context\RendererContext $context): \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection; ``` +Additional twig functions that are added to the built-in ones when a language handler is included -
    Additional twig functions that are added to the built-in ones when a language handler is included
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $context\BumbleDocGen\Core\Renderer\Context\RendererContext-
    - -Return value: \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$context | [\BumbleDocGen\Core\Renderer\Context\RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php) | - | -
    -
    -
    +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/CustomFunctionsCollection.php) - +--- +# `getEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/LanguageHandlerInterface.php#L29) ```php public function getEntityCollection(): \BumbleDocGen\Core\Parser\Entity\RootEntityCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityCollection - - -
    -
    -
    - - - +# `getLanguageKey` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/LanguageHandlerInterface.php#L17) ```php public static function getLanguageKey(): string; ``` +Unique language handler key -
    Unique language handler key
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    +--- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/PageHtmlLinkerPlugin.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/PageHtmlLinkerPlugin.md index 514fbddc..0ab9fe7f 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/PageHtmlLinkerPlugin.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/PageHtmlLinkerPlugin.md @@ -1,210 +1,95 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / Linking templates / PageHtmlLinkerPlugin
    - -

    - PageHtmlLinkerPlugin class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +[Linking templates](/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md) **/** +PageHtmlLinkerPlugin +--- +# [PageHtmlLinkerPlugin](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/PageHtmlLinkerPlugin.php#L29) class: ```php namespace BumbleDocGen\Core\Plugin\CorePlugin\PageLinker; final class PageHtmlLinkerPlugin extends \BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker implements \BumbleDocGen\Core\Plugin\PluginInterface, \Symfony\Component\EventDispatcher\EventSubscriberInterface ``` - -
    Adds URLs to empty links in HTML format; +Adds URLs to empty links in HTML format; Links may contain: 1) Short entity name 2) Full entity name 3) Relative link to the entity file from the root directory of the project 4) Page title ( title ) 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) - 6) Relative reference to the entity document from the root directory of the documentation
    - - -Examples of using: + 6) Relative reference to the entity document from the root directory of the documentation +***Examples of using:*** ```php Existent page name => Existent page name - ``` - ```php \Namespace\ClassName => Custom title - ``` - ```php \Namespace\ClassName => \Namespace\ClassName - ``` - ```php Non-existent page name => Non-existent page name - ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [beforeCreatingDocFile](#mbeforecreatingdocfile) +1. [getSubscribedEvents](#mgetsubscribedevents) +## Methods details: - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - beforeCreatingDocFile -
    2. -
    3. - getSubscribedEvents -
    4. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L19) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | +$getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $rootEntityCollectionsGroup\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup-
    $getDocumentedEntityUrlFunction\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L71) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public function beforeCreatingDocFile(\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingDocFile.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Throws: - - -
    -
    -
    - - +--- +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L59) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public static function getSubscribedEvents(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/PhpEntitiesCollection.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/PhpEntitiesCollection.md index febcb6b5..6ad2bd07 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/PhpEntitiesCollection.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/PhpEntitiesCollection.md @@ -1,883 +1,353 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / Templates variables / PhpEntitiesCollection
    - -

    - PhpEntitiesCollection class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +[Templates variables](/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md) **/** +PhpEntitiesCollection +--- +# [PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L43) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; final class PhpEntitiesCollection extends \BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection implements \IteratorAggregate ``` - -
    Collection of php root entities
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - add - - Add an entity to the collection
    2. -
    3. - clearOperationsLogCollection -
    4. -
    5. - filterByInterfaces - - Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity)
    6. -
    7. - filterByNameRegularExpression - - Get a copy of the current collection with only entities whose names match the regular expression
    8. -
    9. - filterByParentClassNames - - Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity)
    10. -
    11. - filterByPaths - - Get a copy of the current collection only with entities filtered by file paths (from project_root)
    12. -
    13. - findEntity - - Find an entity in a collection
    14. -
    15. - get - - Get an entity from a collection (only previously added)
    16. -
    17. - getEntityCollectionName - - Get collection name
    18. -
    19. - getEntityLinkData -
    20. -
    21. - getIterator -
    22. -
    23. - getLoadedOrCreateNew - - Get an entity from the collection or create a new one if it has not yet been added
    24. -
    25. - getOnlyAbstractClasses - - Get a copy of the current collection with only abstract classes
    26. -
    27. - getOnlyInstantiable - - Get a copy of the current collection with only instantiable entities
    28. -
    29. - getOnlyInterfaces - - Get a copy of the current collection with only interfaces
    30. -
    31. - getOnlyTraits - - Get a copy of the current collection with only traits
    32. -
    33. - getOperationsLogCollection -
    34. -
    35. - has - - Check if an entity has been added to the collection
    36. -
    37. - internalFindEntity -
    38. -
    39. - internalGetLoadedOrCreateNew -
    40. -
    41. - isEmpty - - Check if the collection is empty or not
    42. -
    43. - loadEntities - - Load entities into a collection
    44. -
    45. - loadEntitiesByConfiguration - - Load entities into a collection by configuration
    46. -
    47. - remove - - Remove an entity from a collection
    48. -
    49. - removeAllNotLoadedEntities -
    50. -
    51. - toArray - - Convert collection to array
    52. -
    53. - updateEntitiesCache -
    54. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Collection of php root entities + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [add](#madd) - Add an entity to the collection +1. [clearOperationsLogCollection](#mclearoperationslogcollection) +1. [filterByInterfaces](#mfilterbyinterfaces) - Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity) +1. [filterByNameRegularExpression](#mfilterbynameregularexpression) - Get a copy of the current collection with only entities whose names match the regular expression +1. [filterByParentClassNames](#mfilterbyparentclassnames) - Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity) +1. [filterByPaths](#mfilterbypaths) - Get a copy of the current collection only with entities filtered by file paths (from project_root) +1. [findEntity](#mfindentity) - Find an entity in a collection +1. [get](#mget) - Get an entity from a collection (only previously added) +1. [getEntityCollectionName](#mgetentitycollectionname) - Get collection name +1. [getEntityLinkData](#mgetentitylinkdata) +1. [getIterator](#mgetiterator) +1. [getLoadedOrCreateNew](#mgetloadedorcreatenew) - Get an entity from the collection or create a new one if it has not yet been added +1. [getOnlyAbstractClasses](#mgetonlyabstractclasses) - Get a copy of the current collection with only abstract classes +1. [getOnlyInstantiable](#mgetonlyinstantiable) - Get a copy of the current collection with only instantiable entities +1. [getOnlyInterfaces](#mgetonlyinterfaces) - Get a copy of the current collection with only interfaces +1. [getOnlyTraits](#mgetonlytraits) - Get a copy of the current collection with only traits +1. [getOperationsLogCollection](#mgetoperationslogcollection) +1. [has](#mhas) - Check if an entity has been added to the collection +1. [internalFindEntity](#minternalfindentity) +1. [internalGetLoadedOrCreateNew](#minternalgetloadedorcreatenew) +1. [isEmpty](#misempty) - Check if the collection is empty or not +1. [loadEntities](#mloadentities) - Load entities into a collection +1. [loadEntitiesByConfiguration](#mloadentitiesbyconfiguration) - Load entities into a collection by configuration +1. [remove](#mremove) - Remove an entity from a collection +1. [removeAllNotLoadedEntities](#mremoveallnotloadedentities) +1. [toArray](#mtoarray) - Convert collection to array +1. [updateEntitiesCache](#mupdateentitiescache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L50) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\Core\Plugin\PluginEventDispatcher $pluginEventDispatcher, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory $cacheablePhpEntityFactory, \BumbleDocGen\LanguageHandler\Php\Renderer\EntityDocRenderer\EntityDocRendererHelper $docRendererHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$pluginEventDispatcher | [\BumbleDocGen\Core\Plugin\PluginEventDispatcher](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginEventDispatcher.php) | - | +$cacheablePhpEntityFactory | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/Cache/CacheablePhpEntityFactory.php) | - | +$docRendererHelper | [\BumbleDocGen\LanguageHandler\Php\Renderer\EntityDocRenderer\EntityDocRendererHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/EntityDocRenderer/EntityDocRendererHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $pluginEventDispatcher\BumbleDocGen\Core\Plugin\PluginEventDispatcher-
    $cacheablePhpEntityFactory\BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory-
    $docRendererHelper\BumbleDocGen\LanguageHandler\Php\Renderer\EntityDocRenderer\EntityDocRendererHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `add` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L190) ```php public function add(\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity $classEntity, bool $reload = false): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Add an entity to the collection -
    Add an entity to the collection
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity-
    $reloadbool-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -Throws: - - -
    -
    -
    - - +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$classEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) | - | +$reload | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | + +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) + +--- + +# `clearOperationsLogCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L28) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function clearOperationsLogCollection(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -
    -
    -
    - - - +# `filterByInterfaces` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L244) ```php public function filterByInterfaces(array $interfaces): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity) -
    Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity)
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfacesstring[]-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Parameters:*** -Throws: - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `filterByNameRegularExpression` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L321) ```php public function filterByNameRegularExpression(string $regexPattern): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection with only entities whose names match the regular expression -
    Get a copy of the current collection with only entities whose names match the regular expression
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $regexPatternstring-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$regexPattern | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) - +--- +# `filterByParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L270) ```php public function filterByParentClassNames(array $parentClassNames): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity) -
    Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity)
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamesarray-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Parameters:*** -Throws: - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `filterByPaths` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L298) ```php public function filterByPaths(array $paths): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection only with entities filtered by file paths (from project_root) -
    Get a copy of the current collection only with entities filtered by file paths (from project_root)
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pathsarray-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$paths | [array](https://www.php.net/manual/en/language.types.array.php) | - | -Throws: - - -
    -
    -
    - - +--- +# `findEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L118) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function findEntity(string $search, bool $useUnsafeKeys = true): null|\BumbleDocGen\Core\Parser\Entity\RootEntityInterface; ``` +Find an entity in a collection + +***Parameters:*** -
    Find an entity in a collection
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $searchstring-
    $useUnsafeKeysbool-
    - -Return value: null | \BumbleDocGen\Core\Parser\Entity\RootEntityInterface - - -
    -
    -
    - - +| Name | Type | Description | +|:-|:-|:-| +$search | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$useUnsafeKeys | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) + +--- + +# `get` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L86) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function get(string $objectName): null|\BumbleDocGen\Core\Parser\Entity\RootEntityInterface; ``` +Get an entity from a collection (only previously added) -
    Get an entity from a collection (only previously added)
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    +***Parameters:*** -Return value: null | \BumbleDocGen\Core\Parser\Entity\RootEntityInterface +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) -
    -
    -
    - - +--- +# `getEntityCollectionName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L66) ```php public function getEntityCollectionName(): string; ``` +Get collection name -
    Get collection name
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - getEntityLinkData - :warning: Is internal | source code
    • -
    +--- +# `getEntityLinkData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L508) ```php public function getEntityLinkData(string $rawLink, string|null $defaultEntityName = null, bool $useUnsafeKeys = true): array; ``` +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$rawLink | [string](https://www.php.net/manual/en/language.types.string.php) | Raw link to an entity or entity element | +$defaultEntityName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Entity name to use if the link does not contain a valid or existing entity name, + but only a cursor on an entity element | +$useUnsafeKeys | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rawLinkstringRaw link to an entity or entity element
    $defaultEntityNamestring | nullEntity name to use if the link does not contain a valid or existing entity name, - but only a cursor on an entity element
    $useUnsafeKeysbool-
    - -Return value: array - - -
    -
    -
    - - +--- +# `getIterator` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L46) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function getIterator(): \Generator; ``` +***Return value:*** [\Generator](https://www.php.net/manual/en/language.generators.overview.php) +--- -Parameters: not specified - -Return value: \Generator - - -
    -
    -
    - - - +# `getLoadedOrCreateNew` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L102) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function getLoadedOrCreateNew(string $objectName, bool $withAddClassEntityToCollectionEvent = false): \BumbleDocGen\Core\Parser\Entity\RootEntityInterface; ``` +Get an entity from the collection or create a new one if it has not yet been added -
    Get an entity from the collection or create a new one if it has not yet been added
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    $withAddClassEntityToCollectionEventbool-
    - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityInterface - - - -See: - -
    -
    -
    - - +***Parameters:*** -```php -public function getOnlyAbstractClasses(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; -``` - -
    Get a copy of the current collection with only abstract classes
    +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$withAddClassEntityToCollectionEvent | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: not specified +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Links:*** +- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](/docs/tech/03_renderer/01_howToCreateTemplates/classes/RootEntityInterface.md#misentitydatacanbeloaded) +--- -Throws: - +# `getOnlyAbstractClasses` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L388) +```php +public function getOnlyAbstractClasses(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; +``` +Get a copy of the current collection with only abstract classes -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) - +--- +# `getOnlyInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L338) ```php public function getOnlyInstantiable(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection with only instantiable entities -
    Get a copy of the current collection with only instantiable entities
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -
    -
    -
    - - +--- +# `getOnlyInterfaces` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L354) ```php public function getOnlyInterfaces(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection with only interfaces -
    Get a copy of the current collection with only interfaces
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `getOnlyTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L370) ```php public function getOnlyTraits(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection with only traits -
    Get a copy of the current collection with only traits
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `getOperationsLogCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function getOperationsLogCollection(): \BumbleDocGen\Core\Parser\Entity\CollectionLogOperation\OperationsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionLogOperation\OperationsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionLogOperation/OperationsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionLogOperation\OperationsCollection - - -
    -
    -
    - - - +# `has` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L42) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function has(string $objectName): bool; ``` +Check if an entity has been added to the collection -
    Check if an entity has been added to the collection
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - -
      -
    • # - internalFindEntity - :warning: Is internal | source code
    • -
    +--- +# `internalFindEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L421) ```php public function internalFindEntity(string $search, bool $useUnsafeKeys = true): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Parameters:*** - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $searchstringSearch query. For the search, only the main part is taken, up to the characters: `::`, `->`, `#`. +| Name | Type | Description | +|:-|:-|:-| +$search | [string](https://www.php.net/manual/en/language.types.string.php) | Search query. For the search, only the main part is taken, up to the characters: `::`, `->`, `#`. If the request refers to multiple existing entities and if unsafe keys are allowed, - a warning will be shown and the first entity found will be used.
    $useUnsafeKeysboolWhether to use search keys that can be used to find several entities
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity + a warning will be shown and the first entity found will be used. | +$useUnsafeKeys | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Whether to use search keys that can be used to find several entities | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) - - -Examples of using: - +***Examples of using:*** ```php $entitiesCollection->findEntity('App'); // class name $entitiesCollection->findEntity('BumbleDocGen\Console\App'); // class with namespace @@ -889,318 +359,118 @@ $entitiesCollection->findEntity('/Users/someuser/Desktop/projects/bumble-doc-gen $entitiesCollection->findEntity('https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/App.php'); // source link ``` -
    -
    -
    - -
      -
    • # - internalGetLoadedOrCreateNew - :warning: Is internal | source code
    • -
    +--- +# `internalGetLoadedOrCreateNew` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L214) ```php public function internalGetLoadedOrCreateNew(string $objectName, bool $withAddClassEntityToCollectionEvent = false): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$withAddClassEntityToCollectionEvent | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    $withAddClassEntityToCollectionEventbool-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -Throws: - - -
    -
    -
    - - +--- +# `isEmpty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L52) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function isEmpty(): bool; ``` +Check if the collection is empty or not -
    Check if the collection is empty or not
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `loadEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L100) ```php public function loadEntities(\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection $sourceLocatorsCollection, \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface|null $filters = null, \BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface|null $progressBar = null): \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult; ``` +Load entities into a collection -
    Load entities into a collection
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $sourceLocatorsCollection\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection-
    $filters\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface | null-
    $progressBar\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface | null-
    - -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult - - -Throws: - - -
    -
    -
    - -
      -
    • # - loadEntitiesByConfiguration - :warning: Is internal | source code
    • -
    - -```php -public function loadEntitiesByConfiguration(\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface|null $progressBar = null): \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult; -``` - -
    Load entities into a collection by configuration
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $progressBar\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface | null-
    +***Parameters:*** -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult +| Name | Type | Description | +|:-|:-|:-| +$sourceLocatorsCollection | [\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/SourceLocatorsCollection.php) | - | +$filters | [\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | +$progressBar | [\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntitiesLoaderProgressBarInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionLoadEntitiesResult.php) -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$progressBar | [\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntitiesLoaderProgressBarInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -
    -
    -
    +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionLoadEntitiesResult.php) - +--- +# `remove` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L32) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function remove(string $objectName): void; ``` +Remove an entity from a collection -
    Remove an entity from a collection
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    - -Return value: void +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - +--- +# `removeAllNotLoadedEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L132) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\RootEntityCollection public function removeAllNotLoadedEntities(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -
    -
    -
    - - - +# `toArray` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L127) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\RootEntityCollection public function toArray(): array; ``` +Convert collection to array -
    Convert collection to array
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - updateEntitiesCache - :warning: Is internal | source code
    • -
    +--- +# `updateEntitiesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L97) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\RootEntityCollection public function updateEntitiesCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/RendererContext.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/RendererContext.md index c7b2bcdf..b6b18a7a 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/RendererContext.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/RendererContext.md @@ -1,256 +1,112 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / RendererContext
    - -

    - RendererContext class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +RendererContext +--- +# [RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L12) class: ```php namespace BumbleDocGen\Core\Renderer\Context; final class RendererContext ``` +Document rendering context -
    Document rendering context
    - - - - - - - -

    Methods:

    - -
      -
    1. - addDependency -
    2. -
    3. - clearDependencies -
    4. -
    5. - getCurrentDocumentedEntityWrapper -
    6. -
    7. - getCurrentTemplateFilePatch - - Getting the path to the template file that is currently being worked on
    8. -
    9. - getDependencies -
    10. -
    11. - setCurrentDocumentedEntityWrapper -
    12. -
    13. - setCurrentTemplateFilePatch - - Saving the path to the template file that is currently being worked on in the context
    14. -
    - - +## Methods +1. [addDependency](#madddependency) +1. [clearDependencies](#mcleardependencies) +1. [getCurrentDocumentedEntityWrapper](#mgetcurrentdocumentedentitywrapper) +1. [getCurrentTemplateFilePatch](#mgetcurrenttemplatefilepatch) - Getting the path to the template file that is currently being worked on +1. [getDependencies](#mgetdependencies) +1. [setCurrentDocumentedEntityWrapper](#msetcurrentdocumentedentitywrapper) +1. [setCurrentTemplateFilePatch](#msetcurrenttemplatefilepatch) - Saving the path to the template file that is currently being worked on in the context +## Methods details: - - -

    Method details:

    - -
    - - - +# `addDependency` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L53) ```php public function addDependency(\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyInterface $dependency): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$dependency | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/Dependency/RendererDependencyInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $dependency\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyInterface-
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Return value: void - - -
    -
    -
    - - +--- +# `clearDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L48) ```php public function clearDependencies(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -
    -
    -
    - - - +# `getCurrentDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L43) ```php public function getCurrentDocumentedEntityWrapper(): null|\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper - - -
    -
    -
    - - - +# `getCurrentTemplateFilePatch` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L32) ```php public function getCurrentTemplateFilePatch(): string; ``` +Getting the path to the template file that is currently being worked on -
    Getting the path to the template file that is currently being worked on
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L58) ```php public function getDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `setCurrentDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L37) ```php public function setCurrentDocumentedEntityWrapper(\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper $currentDocumentedEntityWrapper): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$currentDocumentedEntityWrapper | [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $currentDocumentedEntityWrapper\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper-
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Return value: void - - -
    -
    -
    - - +--- +# `setCurrentTemplateFilePatch` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L24) ```php public function setCurrentTemplateFilePatch(string $currentTemplateFilePath): void; ``` +Saving the path to the template file that is currently being worked on in the context -
    Saving the path to the template file that is currently being worked on in the context
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $currentTemplateFilePathstring-
    +***Parameters:*** -Return value: void +| Name | Type | Description | +|:-|:-|:-| +$currentTemplateFilePath | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/RootEntityInterface.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/RootEntityInterface.md index 5a9d1055..6575494f 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/RootEntityInterface.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/RootEntityInterface.md @@ -1,469 +1,218 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / RootEntityInterface
    - -

    - RootEntityInterface class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +RootEntityInterface +--- +# [RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L11) class: ```php namespace BumbleDocGen\Core\Parser\Entity; interface RootEntityInterface extends \BumbleDocGen\Core\Parser\Entity\EntityInterface ``` +Since the documentation generator supports several programming languages, +their entities need to correspond to the same interfaces -
    Since the documentation generator supports several programming languages, -their entities need to correspond to the same interfaces
    - - - - - - - -

    Methods:

    - -
      -
    1. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    2. -
    3. - getEntityDependencies -
    4. -
    5. - getFileContent -
    6. -
    7. - getFileSourceLink -
    8. -
    9. - getName - - Full name of the entity
    10. -
    11. - getObjectId - - Entity object ID
    12. -
    13. - getRelativeFileName - - File name relative to project_root configuration parameter
    14. -
    15. - getRootEntityCollection - - Get parent collection of entities
    16. -
    17. - getShortName - - Short name of the entity
    18. -
    19. - isEntityCacheOutdated -
    20. -
    21. - isEntityDataCanBeLoaded - - Checking if it is possible to get the entity data
    22. -
    23. - isEntityNameValid - - Check if entity name is valid
    24. -
    25. - isExternalLibraryEntity - - The entity is loaded from a third party library and should not be treated the same as a standard one
    26. -
    27. - isInGit - - The entity file is in the git repository
    28. -
    29. - normalizeClassName -
    30. -
    +## Methods +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getEntityDependencies](#mgetentitydependencies) +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getName](#mgetname) - Full name of the entity +1. [getObjectId](#mgetobjectid) - Entity object ID +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get parent collection of entities +1. [getShortName](#mgetshortname) - Short name of the entity +1. [isEntityCacheOutdated](#misentitycacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) - Checking if it is possible to get the entity data +1. [isEntityNameValid](#misentitynamevalid) - Check if entity name is valid +1. [isExternalLibraryEntity](#misexternallibraryentity) - The entity is loaded from a third party library and should not be treated the same as a standard one +1. [isInGit](#misingit) - The entity file is in the git repository +1. [normalizeClassName](#mnormalizeclassname) +## Methods details: - - - - -

    Method details:

    - -
    - - - +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L53) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L33) ```php public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L40) ```php public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getFileSourceLink` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L42) ```php public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L30) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L16) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getObjectId(): string; ``` +Entity object ID -
    Entity object ID
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -
    -
    -
    - - +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L46) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration_2.md#mgetprojectroot) +--- - -See: - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getRootEntityCollection(): \BumbleDocGen\Core\Parser\Entity\RootEntityCollection; ``` +Get parent collection of entities -
    Get parent collection of entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityCollection +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) +--- -
    -
    -
    - - - +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L37) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L58) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function isEntityCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L23) ```php public function isEntityDataCanBeLoaded(): bool; ``` +Checking if it is possible to get the entity data -
    Checking if it is possible to get the entity data
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L18) ```php public static function isEntityNameValid(string $entityName): bool; ``` +Check if entity name is valid -
    Check if entity name is valid
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isExternalLibraryEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L28) ```php public function isExternalLibraryEntity(): bool; ``` +The entity is loaded from a third party library and should not be treated the same as a standard one -
    The entity is loaded from a third party library and should not be treated the same as a standard one
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInGit` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L38) ```php public function isInGit(): bool; ``` +The entity file is in the git repository -
    The entity file is in the git repository
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L13) ```php public static function normalizeClassName(string $name): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    +--- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md b/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md index 278c0591..09ac6394 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md @@ -1,6 +1,13 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / Front Matter
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +Front Matter -

    Front Matter

    +--- + + +# Front Matter Front Matter is a special block at the top of a document template or generated document that contains certain important meta information. @@ -18,13 +25,13 @@ some template content ... The content of this block must be in YAML format. During the template generation process, this block is parsed, and all values become available in the form of twig variables. -By default, this block is hidden from generated MD files, but it can be displayed by enabling the special option render_with_front_matter in the configuration +By default, this block is hidden from generated MD files, but it can be displayed by enabling the special option [render_with_front_matter](/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration.md#mrenderwithfrontmatter) in the configuration -Some Front Matter block variables are used internally in our system, for example `title` and `prevPage` are used to generate breadcrumbs and documentation menus. +Some Front Matter block variables are used internally in our system, for example `title` and `prevPage` are used to generate [breadcrumbs](/docs/tech/03_renderer/02_breadcrumbs.md) and [documentation menus](/docs/tech/03_renderer/01_howToCreateTemplates/classes/DrawDocumentationMenu.md). This block is also used when generating HTML documentation. You can learn about the variables used in this block when generating HTML content [in the documentation of the library](https://daux.io/Features/Front_Matter.html) that we use to create HTML pages. -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Fri Jan 12 18:53:16 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/readme.md b/docs/tech/03_renderer/01_howToCreateTemplates/readme.md index 95f8c7c0..1ddbb98e 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/readme.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/readme.md @@ -1,106 +1,105 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates?
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +How to create documentation templates? -

    How to create documentation templates?

    +--- + + +# How to create documentation templates? Templates are `twig` files in which you can write both static text and dynamic blocks that will change from code changes or other required parameters. **You can read more about template parts here:** - -

    Examples

    +- [Front Matter](/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md) +- [Templates dynamic blocks](/docs/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md) +- [Linking templates](/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md) +- [Templates variables](/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md) + +## Examples -

    1) An example of a template with fully static text:

    +### 1) An example of a template with fully static text: ```twig - Some static text - This text does not change when the code is changed +Some static text +This text does not change when the code is changed ``` - After generating the documentation, this page will look exactly like a template. -

    2) An example of a template with static text and dynamic blocks:

    +### 2) An example of a template with static text and dynamic blocks: ```twig - --- - title: Some page - prevPage: Technical description of the project - --- - {{ generatePageBreadcrumbs(title, _self) }} - - Some static text... - - Dynamic block: - - {{ printEntityCollectionAsList(phpEntities.filterByInterfaces(['\\BumbleDocGen\\Core\\Parser\\SourceLocator\\SourceLocatorInterface']).getOnlyInstantiable()) }} - - More static text... - -``` +--- +title: Some page +prevPage: Technical description of the project +--- +{{ generatePageBreadcrumbs(title, _self) }} +Some static text... -Result after starting the documentation generation process: +Dynamic block: -```html - BumbleDocGen / Technical description of the project / Some page
    - - Some static text... - - Dynamic block: - - - - More static text... - -
    -
    - Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Sat Jul 29 17:43:49 2023 +0300
    Page content update date: Sun Jul 30 2023
    Made with Bumble Documentation Generator
    - +{{ printEntityCollectionAsList(phpEntities.filterByInterfaces(['\\BumbleDocGen\\Core\\Parser\\SourceLocator\\SourceLocatorInterface']).getOnlyInstantiable()) }} + +More static text... ``` +Result after starting the documentation generation process: + +```md + BumbleDocGen / Technical description of the project / Some page
    + +Some static text... + +Dynamic block: + + + +More static text... + +
    +
    +Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Sat Jul 29 17:43:49 2023 +0300
    Page content update date: Sun Jul 30 2023
    Made with Bumble Documentation Generator
    +``` This is how it looks on the GitHub: -

    3) Another example of a dynamic block:

    +### 3) Another example of a dynamic block: Output method description as a dynamic block: ```twig - Some static text... - - Dynamic block: - - {{ phpEntities - .get('\\BumbleDocGen\\LanguageHandler\\LanguageHandlerInterface') - .getMethod('getLanguageKey') - .getDescription() - }} - - More static text... - -``` +Some static text... +Dynamic block: -Result after starting the documentation generation process: +{{ phpEntities + .get('\\BumbleDocGen\\LanguageHandler\\LanguageHandlerInterface') + .getMethod('getLanguageKey') + .getDescription() +}} +More static text... +``` +Result after starting the documentation generation process: ```twig - Some static text... - - Dynamic block: - - Unique language handler key - - More static text... - +Some static text... + +Dynamic block: + +Unique language handler key + +More static text... ``` +--- -
    \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md b/docs/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md index 2af0eedd..3a6a9dc2 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md @@ -1,6 +1,13 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / Templates dynamic blocks
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +Templates dynamic blocks -

    Templates dynamic blocks

    +--- + + +# Templates dynamic blocks There are several ways to create dynamic blocks in templates. @@ -8,22 +15,19 @@ There are several ways to create dynamic blocks in templates. You can use the built-in functions and filters or add your own, so you can implement any logic for generating dynamically changing content. ```twig - {{ printEntityCollectionAsList(phpEntities.filterByInterfaces(['\\BumbleDocGen\\Core\\Parser\\SourceLocator\\SourceLocatorInterface']).getOnlyInstantiable()) }} +{{ printEntityCollectionAsList(phpEntities.filterByInterfaces(['\\BumbleDocGen\\Core\\Parser\\SourceLocator\\SourceLocatorInterface']).getOnlyInstantiable()) }} ``` - * The second way is to output data from variables directly to the template. For example, you can display a list of classes or methods of documented code according to certain rules. ```twig - {% for entity in phpEntities.filterByInterfaces(['\\BumbleDocGen\\Core\\Parser\\SourceLocator\\SourceLocatorInterface']).getOnlyInstantiable() %} - * {{ entity.getName() }} - {% endfor %} - +{% for entity in phpEntities.filterByInterfaces(['\\BumbleDocGen\\Core\\Parser\\SourceLocator\\SourceLocatorInterface']).getOnlyInstantiable() %} + * {{ entity.getName() }} +{% endfor %} ``` +--- -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Thu Jan 11 00:14:41 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md b/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md index 70c54f40..de6f8cf1 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md @@ -1,13 +1,20 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / Linking templates
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +Linking templates -

    Linking templates

    +--- + + +# Linking templates One of the main requirements of the documentation is to be able to easily and quickly implement linking between pages. We have several options for this, such as using special functions or using a special document linking mechanism (`completing blank links`) -

    Completing blank links

    +## Completing blank links -Plugin PageHtmlLinkerPlugin have been added to the basic configuration, +Plugin [PageHtmlLinkerPlugin](/docs/tech/03_renderer/01_howToCreateTemplates/classes/PageHtmlLinkerPlugin.md) have been added to the basic configuration, which process the text of the filled template before its result is written to a file, and fill in all empty links. For example, an empty link: @@ -29,13 +36,13 @@ Examples:
    [a x-title="test"]Existent page name[/a] => <a href="/docs/some/page/targetPage.md">test</a>
    -

    Generating links through functions

    +## Generating links through functions The second way to relink templates is to generate links through functions. -There are a number of functions that allow you to get a link to an entity, for example GetDocumentedEntityUrl, and there are also functions for getting a link to other documents, for example GetDocumentationPageUrl. +There are a number of functions that allow you to get a link to an entity, for example [GetDocumentedEntityUrl](/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl.md), and there are also functions for getting a link to other documents, for example [GetDocumentationPageUrl](/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentationPageUrl.md). You can also implement your own functions for relinking if necessary. -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Fri Jan 12 01:40:01 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md b/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md index b409bc19..c00708f1 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md @@ -1,16 +1,23 @@ - BumbleDocGen / Technical description of the project / Renderer / How to create documentation templates? / Templates variables
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +Templates variables -

    Templates variables

    +--- + + +# Templates variables There are several variables available in each processed template. 1) Firstly, these are built-in twig variables, for example `_self`, which returns the path to the processed template. -2) Secondly, variables with collections of processed programming languages are available in the template (see LanguageHandlerInterface). For example, when processing a PHP project collection, a collection PhpEntitiesCollection will be available in the template under the name phpEntities +2) Secondly, variables with collections of processed programming languages are available in the template (see [LanguageHandlerInterface](/docs/tech/03_renderer/01_howToCreateTemplates/classes/LanguageHandlerInterface.md)). For example, when processing a PHP project collection, a collection [PhpEntitiesCollection](/docs/tech/03_renderer/01_howToCreateTemplates/classes/PhpEntitiesCollection.md) will be available in the template under the name phpEntities 3) Thirdly, all variables specified in **Front Matter** are automatically converted into template variables and are available in it -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Fri Jan 12 18:53:16 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/02_breadcrumbs.md b/docs/tech/03_renderer/02_breadcrumbs.md index 4af6af8e..d5479a8a 100644 --- a/docs/tech/03_renderer/02_breadcrumbs.md +++ b/docs/tech/03_renderer/02_breadcrumbs.md @@ -1,11 +1,17 @@ - BumbleDocGen / Technical description of the project / Renderer / Documentation structure and breadcrumbs
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +Documentation structure and breadcrumbs -

    Documentation structure and breadcrumbs

    +--- -To work with breadcrumbs and get the structure of the documentation, we use the inner class BreadcrumbsHelper. + +# Documentation structure and breadcrumbs + +To work with breadcrumbs and get the structure of the documentation, we use the inner class [BreadcrumbsHelper](/docs/tech/03_renderer/classes/BreadcrumbsHelper.md). To build the documentation structure, twig templates from the `templates_dir` configuration are used. -

    Project structure definitions

    +## Project structure definitions To determine the structure of the project, the actual location of the files in the templates directory is used first of all. For each directory there is an index file ( readme.md or index.md ), and they are used to determine the exact input of each level of nesting. @@ -16,43 +22,40 @@ But in addition to building the documentation structure using the actual locatio you can explicitly specify the parent page in each template using the special front matter variable `prevPage`: ```markdown - --- - prevPage: Prev page name - --- +--- +prevPage: Prev page name +--- ``` - In this way, complex documentation structures can be created with less file nesting: -

    Displaying breadcrumbs in documents

    +## Displaying breadcrumbs in documents -There is a built-in function to generate breadcrumbs in templates GeneratePageBreadcrumbs. +There is a built-in function to generate breadcrumbs in templates [GeneratePageBreadcrumbs](/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs_2.md). Here is how it is used in twig templates: ```twig - {{ generatePageBreadcrumbs(title, _self) }} +{{ generatePageBreadcrumbs(title, _self) }} ``` - To build breadcrumbs, the previously compiled project structure and the names of each template are used. The template name can be specified using the `title` front matter variable: ```markdown - --- - title: Some page title - --- +--- +title: Some page title +--- ``` - Here is an example of the result of the `generatePageBreadcrumbs` function: ```twig - BumbleDocGen / Technical description of the project / Renderer / Some page title
    + BumbleDocGen / Technical description of the project / Renderer / Some page title
    ``` -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Fri Jan 12 18:53:16 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/03_documentStructure.md b/docs/tech/03_renderer/03_documentStructure.md index b8d84d88..c4cc36ef 100644 --- a/docs/tech/03_renderer/03_documentStructure.md +++ b/docs/tech/03_renderer/03_documentStructure.md @@ -1,6 +1,12 @@ - BumbleDocGen / Technical description of the project / Renderer / Document structure of generated entities
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +Document structure of generated entities -

    Document structure of generated entities

    +--- + + +# Document structure of generated entities *By default, the documentation generator offers two options for organizing the structure of generated entity documents:* @@ -17,6 +23,6 @@ plugins: ``` -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/04_twigCustomFilters.md b/docs/tech/03_renderer/04_twigCustomFilters.md index 84d544ee..4270e3b3 100644 --- a/docs/tech/03_renderer/04_twigCustomFilters.md +++ b/docs/tech/03_renderer/04_twigCustomFilters.md @@ -1,6 +1,12 @@ - BumbleDocGen / Technical description of the project / Renderer / Template filters
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +Template filters -

    Template filters

    +--- + + +# Template filters When generating pages, you can use filters that allow you to modify the content. Filters available during page generation are defined in the configuration ( `twig_filters` parameter ) @@ -8,7 +14,7 @@ Filters available during page generation are defined in int + [int](https://www.php.net/manual/en/language.types.integer.php) Indent size @@ -78,7 +84,7 @@ Here is a list of filters available by default: $skipFirstIdent - bool + [bool](https://www.php.net/manual/en/language.types.boolean.php) Skip indent for first line in text or not @@ -98,7 +104,7 @@ Here is a list of filters available by default: $size - int + [int](https://www.php.net/manual/en/language.types.integer.php) Required string size @@ -110,7 +116,7 @@ Here is a list of filters available by default: $symbol - string + [string](https://www.php.net/manual/en/language.types.string.php) The character to be used to complete the string @@ -130,7 +136,7 @@ Here is a list of filters available by default: $separator - string + [string](https://www.php.net/manual/en/language.types.string.php) Element separator in result string @@ -150,7 +156,7 @@ Here is a list of filters available by default: $pattern - string + [string](https://www.php.net/manual/en/language.types.string.php) The pattern to search for, as a string. @@ -185,7 +191,7 @@ Here is a list of filters available by default:   - + strTypeToUrl
    The filter converts the string with the data type into a link to the documented entity, if possible.
    :warning: This filter initiates the creation of documents for the displayed entities
    @@ -197,7 +203,7 @@ Here is a list of filters available by default: $rootEntityCollection - RootEntityCollection + [RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) @@ -209,7 +215,7 @@ Here is a list of filters available by default: $useShortLinkVersion - bool + [bool](https://www.php.net/manual/en/language.types.boolean.php) Shorten or not the link name. When shortening, only the shortName of the entity will be shown @@ -221,49 +227,21 @@ Here is a list of filters available by default: $createDocument - bool + [bool](https://www.php.net/manual/en/language.types.boolean.php) If true, creates an entity document. Otherwise, just gives a reference to the entity code - -   - - - - textToCodeBlock
    - Convert text to code block - - $codeBlockType - - - string - - Code block type (e.g. php or console ) - - -   - - - - textToHeading
    - Convert text to html header - - - - - - - $headingType + $separator - string + [string](https://www.php.net/manual/en/language.types.string.php) - Choose heading type: H1, H2, H3 + Separator between types   @@ -272,6 +250,6 @@ Here is a list of filters available by default: -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/05_twigCustomFunctions.md b/docs/tech/03_renderer/05_twigCustomFunctions.md index b3449148..6cb01a7e 100644 --- a/docs/tech/03_renderer/05_twigCustomFunctions.md +++ b/docs/tech/03_renderer/05_twigCustomFunctions.md @@ -1,6 +1,12 @@ - BumbleDocGen / Technical description of the project / Renderer / Template functions
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +Template functions -

    Template functions

    +--- + + +# Template functions When generating pages, you can use functions that allow you to modify the content. Functions available during page generation are defined in the configuration ( `twig_functions` parameter ) @@ -8,13 +14,13 @@ Functions available during page generation are defined in string | null + [string](https://www.php.net/manual/en/language.types.string.php) | [null](https://www.php.net/manual/en/language.types.null.php) Relative path to the page from which the menu will be generated (only child pages will be taken into account). By default, the main documentation page (readme.md) is used. @@ -72,7 +78,7 @@ Here is a list of functions available by default: $maxDeep - int | null + [int](https://www.php.net/manual/en/language.types.integer.php) | [null](https://www.php.net/manual/en/language.types.null.php) Maximum parsing depth of documented links starting from the current page. By default, this restriction is disabled. @@ -88,7 +94,7 @@ Here is a list of functions available by default: $entity - RootEntityInterface + [RootEntityInterface](/docs/tech/03_renderer/classes/RootEntityInterface.md) The entity for which we want to get the link @@ -100,7 +106,7 @@ Here is a list of functions available by default: $cursor - string + [string](https://www.php.net/manual/en/language.types.string.php) Reference to an element inside an entity, for example, the name of a function/constant/property @@ -112,7 +118,7 @@ Here is a list of functions available by default: $useShortName - bool + [bool](https://www.php.net/manual/en/language.types.boolean.php) Use the full or short entity name in the link @@ -128,7 +134,7 @@ Here is a list of functions available by default: $resourceName - string + [string](https://www.php.net/manual/en/language.types.string.php) Resource name, url or path to the resource. The path can contain shortcodes with parameters from the configuration (%param_name%) @@ -144,7 +150,7 @@ Here is a list of functions available by default: $currentPageTitle - string + [string](https://www.php.net/manual/en/language.types.string.php) Title of the current page @@ -156,7 +162,7 @@ Here is a list of functions available by default: $templatePath - string + [string](https://www.php.net/manual/en/language.types.string.php) Path to the template from which the breadcrumbs will be generated @@ -168,7 +174,7 @@ Here is a list of functions available by default: $skipFirstTemplatePage - bool + [bool](https://www.php.net/manual/en/language.types.boolean.php) If set to true, the page from which parsing starts will not participate in the formation of breadcrumbs This option is useful when working with the _self value in a template, as it returns the full path to the current template, and the reference to it in breadcrumbs should not be clickable. @@ -184,7 +190,7 @@ Here is a list of functions available by default: $key - string + [string](https://www.php.net/manual/en/language.types.string.php) The key by which to look up the URL of the page. Can be the title of a page, a path to a template, or a generated document @@ -200,7 +206,7 @@ Here is a list of functions available by default: $rootEntityCollection - RootEntityCollection + [RootEntityCollection](/docs/tech/03_renderer/classes/RootEntityCollection.md) Processed entity collection @@ -212,7 +218,7 @@ Here is a list of functions available by default: $entityName - string + [string](https://www.php.net/manual/en/language.types.string.php) The full name of the entity for which the URL will be retrieved. If the entity is not found, the DEFAULT_URL value will be returned. @@ -224,7 +230,7 @@ Here is a list of functions available by default: $cursor - string + [string](https://www.php.net/manual/en/language.types.string.php) Cursor on the page of the documented entity (for example, the name of a method or property) @@ -236,7 +242,7 @@ Here is a list of functions available by default: $createDocument - bool + [bool](https://www.php.net/manual/en/language.types.boolean.php) If true, creates an entity document. Otherwise, just gives a reference to the entity code @@ -252,7 +258,7 @@ Here is a list of functions available by default: $content - string + [string](https://www.php.net/manual/en/language.types.string.php) Content to be processed by plugins @@ -264,7 +270,7 @@ Here is a list of functions available by default: $entity - RootEntityInterface + [RootEntityInterface](/docs/tech/03_renderer/classes/RootEntityInterface.md) The entity for which we process the content block @@ -276,7 +282,7 @@ Here is a list of functions available by default: $blockType - string + [string](https://www.php.net/manual/en/language.types.string.php) Content block type. @see BaseTemplatePluginInterface::BLOCK_* @@ -286,13 +292,13 @@ Here is a list of functions available by default: printEntityCollectionAsList
    - Outputting entity data as HTML list + Outputting entity data as MD list
    :warning: This function initiates the creation of documents for the displayed entities
    $rootEntityCollection - RootEntityCollection + [RootEntityCollection](/docs/tech/03_renderer/classes/RootEntityCollection.md) Processed entity collection @@ -304,7 +310,7 @@ Here is a list of functions available by default: $type - string + [string](https://www.php.net/manual/en/language.types.string.php) List tag type (<ul>/<ol>) @@ -316,7 +322,7 @@ Here is a list of functions available by default: $skipDescription - bool + [bool](https://www.php.net/manual/en/language.types.boolean.php) Don't print description of this entities @@ -328,7 +334,7 @@ Here is a list of functions available by default: $useFullName - bool + [bool](https://www.php.net/manual/en/language.types.boolean.php) Use the full name of the entity in the list @@ -344,7 +350,7 @@ Here is a list of functions available by default: $className - string + [string](https://www.php.net/manual/en/language.types.string.php) Name of the class for which API methods need to be displayed @@ -360,7 +366,7 @@ Here is a list of functions available by default: $entitiesCollections - PhpEntitiesCollection + [PhpEntitiesCollection](/docs/tech/03_renderer/classes/PhpEntitiesCollection.md) The collection of entities for which the class map will be generated @@ -376,7 +382,7 @@ Here is a list of functions available by default: $className - string + [string](https://www.php.net/manual/en/language.types.string.php) The name of the class whose methods are to be retrieved @@ -388,7 +394,7 @@ Here is a list of functions available by default: $methodsNames - array + [array](https://www.php.net/manual/en/language.types.array.php) List of class methods whose code needs to be retrieved @@ -399,6 +405,6 @@ Here is a list of functions available by default: -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/classes/AddIndentFromLeft.md b/docs/tech/03_renderer/classes/AddIndentFromLeft.md index 18504932..fc7e63f6 100644 --- a/docs/tech/03_renderer/classes/AddIndentFromLeft.md +++ b/docs/tech/03_renderer/classes/AddIndentFromLeft.md @@ -1,22 +1,20 @@ - BumbleDocGen / Technical description of the project / Renderer / Template filters / AddIndentFromLeft
    - -

    - AddIndentFromLeft class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template filters](/docs/tech/03_renderer/04_twigCustomFilters.md) **/** +AddIndentFromLeft +--- +# [AddIndentFromLeft](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/AddIndentFromLeft.php#L10) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Filter; final class AddIndentFromLeft implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface ``` - -
    Filter adds indent from left
    - - +Filter adds indent from left

    Settings:

    @@ -32,119 +30,45 @@ final class AddIndentFromLeft implements \BumbleDocGen\Core\Renderer\Twig\Filter +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) +## Methods details: - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/AddIndentFromLeft.php#L18) ```php public function __invoke(string $text, int $identLength = 4, bool $skipFirstIdent = false): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$text | [string](https://www.php.net/manual/en/language.types.string.php) | Processed text | +$identLength | [int](https://www.php.net/manual/en/language.types.integer.php) | Indent size | +$skipFirstIdent | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Skip indent for first line in text or not | -Parameters: +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstringProcessed text
    $identLengthintIndent size
    $skipFirstIdentboolSkip indent for first line in text or not
    - -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/AddIndentFromLeft.php#L24) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/AddIndentFromLeft.php#L29) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/BreadcrumbsHelper.md b/docs/tech/03_renderer/classes/BreadcrumbsHelper.md index 534edc34..de0ca634 100644 --- a/docs/tech/03_renderer/classes/BreadcrumbsHelper.md +++ b/docs/tech/03_renderer/classes/BreadcrumbsHelper.md @@ -1,625 +1,204 @@ - BumbleDocGen / Technical description of the project / Renderer / Documentation structure and breadcrumbs / BreadcrumbsHelper
    - -

    - BreadcrumbsHelper class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Documentation structure and breadcrumbs](/docs/tech/03_renderer/02_breadcrumbs.md) **/** +BreadcrumbsHelper +--- +# [BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php#L26) class: ```php namespace BumbleDocGen\Core\Renderer\Breadcrumbs; final class BreadcrumbsHelper ``` +Helper entity for working with breadcrumbs -
    Helper entity for working with breadcrumbs
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getAllPageLinks -
    2. -
    3. - getBreadcrumbs - - Get breadcrumbs as an array
    4. -
    5. - getBreadcrumbsForTemplates -
    6. -
    7. - getNearestIndexFile -
    8. -
    9. - getPageDataByKey -
    10. -
    11. - getPageDocFileByKey -
    12. -
    13. - getPageLinkByKey -
    14. -
    15. - getTemplateFrontMatter -
    16. -
    17. - getTemplateLinkKey -
    18. -
    19. - getTemplateTitle - - Get the name of a template by its URL.
    20. -
    21. - renderBreadcrumbs - - Returns an HTML string with rendered breadcrumbs
    22. -
    - +## Initialization methods -

    Constants:

    - +1. [__construct](#m-construct) +## Methods +1. [getAllPageLinks](#mgetallpagelinks) +1. [getBreadcrumbs](#mgetbreadcrumbs) - Get breadcrumbs as an array +1. [getBreadcrumbsForTemplates](#mgetbreadcrumbsfortemplates) +1. [getNearestIndexFile](#mgetnearestindexfile) +1. [getPageDataByKey](#mgetpagedatabykey) +1. [getPageDocFileByKey](#mgetpagedocfilebykey) +1. [getPageLinkByKey](#mgetpagelinkbykey) +1. [getTemplateFrontMatter](#mgettemplatefrontmatter) +1. [getTemplateLinkKey](#mgettemplatelinkkey) +1. [getTemplateTitle](#mgettemplatetitle) - Get the name of a template by its URL. +1. [renderBreadcrumbs](#mrenderbreadcrumbs) - Returns an HTML string with rendered breadcrumbs +## Methods details: - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php#L38) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsTwigEnvironment $breadcrumbsTwig, \BumbleDocGen\Core\Plugin\PluginEventDispatcher $pluginEventDispatcher, string $prevPageNameTemplate = self::DEFAULT_PREV_PAGE_NAME_TEMPLATE); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$breadcrumbsTwig | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsTwigEnvironment](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsTwigEnvironment.php) | - | +$pluginEventDispatcher | [\BumbleDocGen\Core\Plugin\PluginEventDispatcher](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginEventDispatcher.php) | - | +$prevPageNameTemplate | [string](https://www.php.net/manual/en/language.types.string.php) | Index page for each child section | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $breadcrumbsTwig\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsTwigEnvironment-
    $pluginEventDispatcher\BumbleDocGen\Core\Plugin\PluginEventDispatcher-
    $prevPageNameTemplatestringIndex page for each child section
    - - - -
    -
    -
    - - +--- +# `getAllPageLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php#L240) ```php public function getAllPageLinks(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -Throws: - - -
    -
    -
    - - - +# `getBreadcrumbs` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php#L191) ```php public function getBreadcrumbs(string $filePatch, bool $fromCurrent = true): array; ``` +Get breadcrumbs as an array -
    Get breadcrumbs as an array
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $filePatchstring-
    $fromCurrentbool-
    - -Return value: array - - -Throws: - - -
    -
    -
    - - - -```php -public function getBreadcrumbsForTemplates(string $filePatch, bool $fromCurrent = true): array; -``` - - - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $filePatchstring-
    $fromCurrentbool-
    +***Parameters:*** -Return value: array +| Name | Type | Description | +|:-|:-|:-| +$filePatch | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$fromCurrent | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$filePatch | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$fromCurrent | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getNearestIndexFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php#L86) ```php public function getNearestIndexFile(string $templateName): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$templateName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $templateNamestring-
    - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getPageDataByKey` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php#L307) ```php public function getPageDataByKey(string $key): null|array; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: null | array +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [array](https://www.php.net/manual/en/language.types.array.php) +--- -Throws: - - -
    -
    -
    - - - +# `getPageDocFileByKey` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php#L333) ```php public function getPageDocFileByKey(string $key): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getPageLinkByKey` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php#L322) ```php public function getPageLinkByKey(string $key): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getTemplateFrontMatter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php#L156) ```php public function getTemplateFrontMatter(string $templateName): array; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$templateName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $templateNamestring-
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Return value: array - - -Throws: - - -
    -
    -
    - - +--- +# `getTemplateLinkKey` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php#L147) ```php public function getTemplateLinkKey(string $templateName): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$templateName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $templateNamestring-
    - -Return value: null | string - - -Throws: - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getTemplateTitle` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php#L138) ```php public function getTemplateTitle(string $templateName): string; ``` +Get the name of a template by its URL. -
    Get the name of a template by its URL.
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$templateName | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $templateNamestring-
    - -Return value: string - - -Throws: - - - - -Examples of using: +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +***Examples of using:*** ```php # Front matter in template: # --- @@ -629,75 +208,22 @@ public function getTemplateTitle(string $templateName): string; $breadcrumbsHelper->getTemplateTitle() == 'Some template title'; // is true ``` -
    -
    -
    - - +--- +# `renderBreadcrumbs` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php#L349) ```php public function renderBreadcrumbs(string $currentPageTitle, string $filePatch, bool $fromCurrent = true): string; ``` +Returns an HTML string with rendered breadcrumbs + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$currentPageTitle | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$filePatch | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$fromCurrent | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    Returns an HTML string with rendered breadcrumbs
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $currentPageTitlestring-
    $filePatchstring-
    $fromCurrentbool-
    - -Return value: string - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/Configuration.md b/docs/tech/03_renderer/classes/Configuration.md index 111dc8b0..4d04753e 100644 --- a/docs/tech/03_renderer/classes/Configuration.md +++ b/docs/tech/03_renderer/classes/Configuration.md @@ -1,763 +1,245 @@ - BumbleDocGen / Technical description of the project / Renderer / Configuration
    - -

    - Configuration class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +Configuration +--- +# [Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L30) class: ```php namespace BumbleDocGen\Core\Configuration; final class Configuration ``` - -
    Configuration project documentation
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getAdditionalConsoleCommands -
    2. -
    3. - getCacheDir -
    4. -
    5. - getConfigurationVersion -
    6. -
    7. - getDocGenLibDir -
    8. -
    9. - getGitClientPath -
    10. -
    11. - getIfExists -
    12. -
    13. - getLanguageHandlersCollection -
    14. -
    15. - getOutputDir -
    16. -
    17. - getOutputDirBaseUrl -
    18. -
    19. - getPageLinkProcessor -
    20. -
    21. - getPlugins -
    22. -
    23. - getProjectRoot -
    24. -
    25. - getSourceLocators -
    26. -
    27. - getTemplatesDir -
    28. -
    29. - getTwigFilters -
    30. -
    31. - getTwigFunctions -
    32. -
    33. - getWorkingDir -
    34. -
    35. - isCheckFileInGitBeforeCreatingDocEnabled -
    36. -
    37. - renderWithFrontMatter -
    38. -
    39. - useSharedCache -
    40. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Configuration project documentation + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [getAdditionalConsoleCommands](#mgetadditionalconsolecommands) +1. [getCacheDir](#mgetcachedir) +1. [getConfigurationVersion](#mgetconfigurationversion) +1. [getDocGenLibDir](#mgetdocgenlibdir) +1. [getGitClientPath](#mgetgitclientpath) +1. [getIfExists](#mgetifexists) +1. [getLanguageHandlersCollection](#mgetlanguagehandlerscollection) +1. [getOutputDir](#mgetoutputdir) +1. [getOutputDirBaseUrl](#mgetoutputdirbaseurl) +1. [getPageLinkProcessor](#mgetpagelinkprocessor) +1. [getPlugins](#mgetplugins) +1. [getProjectRoot](#mgetprojectroot) +1. [getSourceLocators](#mgetsourcelocators) +1. [getTemplatesDir](#mgettemplatesdir) +1. [getTwigFilters](#mgettwigfilters) +1. [getTwigFunctions](#mgettwigfunctions) +1. [getWorkingDir](#mgetworkingdir) +1. [isCheckFileInGitBeforeCreatingDocEnabled](#mischeckfileingitbeforecreatingdocenabled) +1. [renderWithFrontMatter](#mrenderwithfrontmatter) +1. [useSharedCache](#musesharedcache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L34) ```php public function __construct(\BumbleDocGen\Core\Configuration\ConfigurationParameterBag $parameterBag, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$parameterBag | [\BumbleDocGen\Core\Configuration\ConfigurationParameterBag](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/ConfigurationParameterBag.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parameterBag\BumbleDocGen\Core\Configuration\ConfigurationParameterBag-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `getAdditionalConsoleCommands` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L377) ```php public function getAdditionalConsoleCommands(): \BumbleDocGen\Console\Command\AdditionalCommandCollection; ``` +***Return value:*** [\BumbleDocGen\Console\Command\AdditionalCommandCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/Command/AdditionalCommandCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Console\Command\AdditionalCommandCollection - - -Throws: - - -
    -
    -
    - - - +# `getCacheDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L205) ```php public function getCacheDir(): null|string; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    - - - +# `getConfigurationVersion` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L42) ```php public function getConfigurationVersion(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getDocGenLibDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L367) ```php public function getDocGenLibDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getGitClientPath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L256) ```php public function getGitClientPath(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getIfExists` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L395) ```php public function getIfExists(mixed $key): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keymixed-
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getLanguageHandlersCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L166) ```php public function getLanguageHandlersCollection(): \BumbleDocGen\LanguageHandler\LanguageHandlersCollection; ``` +***Return value:*** [\BumbleDocGen\LanguageHandler\LanguageHandlersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/LanguageHandlersCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\LanguageHandlersCollection - - -Throws: - - -
    -
    -
    - - - +# `getOutputDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L112) ```php public function getOutputDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getOutputDirBaseUrl` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L150) ```php public function getOutputDirBaseUrl(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getPageLinkProcessor` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L238) ```php public function getPageLinkProcessor(): \BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/PageLinkProcessor/PageLinkProcessorInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface - - -Throws: - - -
    -
    -
    - - - +# `getPlugins` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L187) ```php public function getPlugins(): \BumbleDocGen\Core\Plugin\PluginsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Plugin\PluginsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Plugin\PluginsCollection - - -Throws: - - -
    -
    -
    - - - +# `getProjectRoot` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L50) ```php public function getProjectRoot(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getSourceLocators` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L66) ```php public function getSourceLocators(): \BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/SourceLocatorsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection - - -Throws: - - -
    -
    -
    - - - +# `getTemplatesDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L84) ```php public function getTemplatesDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getTwigFilters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L295) ```php public function getTwigFilters(): \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/CustomFiltersCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection - - -Throws: - - -
    -
    -
    - - - +# `getTwigFunctions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L272) ```php public function getTwigFunctions(): \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/CustomFunctionsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection - - -Throws: - - -
    -
    -
    - - - +# `getWorkingDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L358) ```php public function getWorkingDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - isCheckFileInGitBeforeCreatingDocEnabled - | source code
    • -
    - +# `isCheckFileInGitBeforeCreatingDocEnabled` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L344) ```php public function isCheckFileInGitBeforeCreatingDocEnabled(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `renderWithFrontMatter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L330) ```php public function renderWithFrontMatter(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `useSharedCache` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L316) ```php public function useSharedCache(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/CustomFunctionInterface.md b/docs/tech/03_renderer/classes/CustomFunctionInterface.md index 105d7b9d..6f9da1fe 100644 --- a/docs/tech/03_renderer/classes/CustomFunctionInterface.md +++ b/docs/tech/03_renderer/classes/CustomFunctionInterface.md @@ -1,12 +1,13 @@ - BumbleDocGen / Technical description of the project / Renderer / Template functions / CustomFunctionInterface
    - -

    - CustomFunctionInterface class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +CustomFunctionInterface +--- +# [CustomFunctionInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/CustomFunctionInterface.php#L5) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; @@ -14,72 +15,27 @@ namespace BumbleDocGen\Core\Renderer\Twig\Function; interface CustomFunctionInterface ``` +## Methods +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) +## Methods details: - - - - - -

    Methods:

    - -
      -
    1. - getName -
    2. -
    3. - getOptions -
    4. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/CustomFunctionInterface.php#L7) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/CustomFunctionInterface.php#L9) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/DisplayClassApiMethods.md b/docs/tech/03_renderer/classes/DisplayClassApiMethods.md index 8a7238d7..616abfec 100644 --- a/docs/tech/03_renderer/classes/DisplayClassApiMethods.md +++ b/docs/tech/03_renderer/classes/DisplayClassApiMethods.md @@ -1,32 +1,27 @@ - BumbleDocGen / Technical description of the project / Renderer / Template functions / DisplayClassApiMethods
    - -

    - DisplayClassApiMethods class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +DisplayClassApiMethods +--- +# [DisplayClassApiMethods](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DisplayClassApiMethods.php#L20) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Renderer\Twig\Function; final class DisplayClassApiMethods implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Display all API methods of a class -
    Display all API methods of a class
    - - -Examples of using: - +***Examples of using:*** ```php {{ displayClassApiMethods('\\BumbleDocGen\\LanguageHandler\\Php\\Parser\\Entity\\ClassEntity') }} - ``` - -

    Settings:

    @@ -36,171 +31,60 @@ final class DisplayClassApiMethods implements \BumbleDocGen\Core\Renderer\Twig\F
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DisplayClassApiMethods.php#L22) ```php public function __construct(\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | +$getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rootEntityCollectionsGroup\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup-
    $getDocumentedEntityUrlFunction\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DisplayClassApiMethods.php#L45) ```php public function __invoke(string $className): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$className | [string](https://www.php.net/manual/en/language.types.string.php) | Name of the class for which API methods need to be displayed | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classNamestringName of the class for which API methods need to be displayed
    - -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DisplayClassApiMethods.php#L28) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DisplayClassApiMethods.php#L33) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/DocumentedEntityWrapper.md b/docs/tech/03_renderer/classes/DocumentedEntityWrapper.md index 4a94b8bd..2e7c952c 100644 --- a/docs/tech/03_renderer/classes/DocumentedEntityWrapper.md +++ b/docs/tech/03_renderer/classes/DocumentedEntityWrapper.md @@ -1,300 +1,129 @@ - BumbleDocGen / Technical description of the project / Renderer / DocumentedEntityWrapper
    - -

    - DocumentedEntityWrapper class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +DocumentedEntityWrapper +--- +# [DocumentedEntityWrapper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L14) class: ```php namespace BumbleDocGen\Core\Renderer\Context; final class DocumentedEntityWrapper ``` +Wrapper for the entity that was requested for documentation -
    Wrapper for the entity that was requested for documentation
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getDocRender -
    2. -
    3. - getDocUrl - - Get the relative path to the document to be generated
    4. -
    5. - getDocumentTransformableEntity - - Get entity that is allowed to be documented
    6. -
    7. - getEntityName -
    8. -
    9. - getFileName - - The name of the file to be generated
    10. -
    11. - getKey - - Get document key
    12. -
    13. - getParentDocFilePath -
    14. -
    15. - setParentDocFilePath -
    16. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [getDocRender](#mgetdocrender) +1. [getDocUrl](#mgetdocurl) - Get the relative path to the document to be generated +1. [getDocumentTransformableEntity](#mgetdocumenttransformableentity) - Get entity that is allowed to be documented +1. [getEntityName](#mgetentityname) +1. [getFileName](#mgetfilename) - The name of the file to be generated +1. [getKey](#mgetkey) - Get document key +1. [getParentDocFilePath](#mgetparentdocfilepath) +1. [setParentDocFilePath](#msetparentdocfilepath) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L20) ```php public function __construct(\BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface $documentTransformableEntity, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, string $parentDocFilePath); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$documentTransformableEntity | [\BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentTransformableEntityInterface.php) | An entity that is allowed to be documented | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$parentDocFilePath | [string](https://www.php.net/manual/en/language.types.string.php) | The file in which the documentation of the entity was requested | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $documentTransformableEntity\BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterfaceAn entity that is allowed to be documented
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $parentDocFilePathstringThe file in which the documentation of the entity was requested
    - - - -
    -
    -
    - - +--- +# `getDocRender` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L27) ```php public function getDocRender(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRendererInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface - - -
    -
    -
    - - - +# `getDocUrl` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L88) ```php public function getDocUrl(): string; ``` +Get the relative path to the document to be generated -
    Get the relative path to the document to be generated
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getDocumentTransformableEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L80) ```php public function getDocumentTransformableEntity(): \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface; ``` +Get entity that is allowed to be documented -
    Get entity that is allowed to be documented
    +***Return value:*** [\BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentTransformableEntityInterface.php) -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface - - -
    -
    -
    - - +--- +# `getEntityName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L40) ```php public function getEntityName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L72) ```php public function getFileName(): string; ``` +The name of the file to be generated -
    The name of the file to be generated
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getKey` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L35) ```php public function getKey(): string; ``` +Get document key -
    Get document key
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -
    -
    -
    - - +--- +# `getParentDocFilePath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L96) ```php public function getParentDocFilePath(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `setParentDocFilePath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L101) ```php public function setParentDocFilePath(string $parentDocFilePath): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$parentDocFilePath | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentDocFilePathstring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/DocumentedEntityWrappersCollection.md b/docs/tech/03_renderer/classes/DocumentedEntityWrappersCollection.md index 5fea8107..0356a132 100644 --- a/docs/tech/03_renderer/classes/DocumentedEntityWrappersCollection.md +++ b/docs/tech/03_renderer/classes/DocumentedEntityWrappersCollection.md @@ -1,12 +1,12 @@ - BumbleDocGen / Technical description of the project / Renderer / DocumentedEntityWrappersCollection
    - -

    - DocumentedEntityWrappersCollection class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +DocumentedEntityWrappersCollection +--- +# [DocumentedEntityWrappersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L14) class: ```php namespace BumbleDocGen\Core\Renderer\Context; @@ -14,203 +14,72 @@ namespace BumbleDocGen\Core\Renderer\Context; final class DocumentedEntityWrappersCollection implements \IteratorAggregate, \Countable ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [count](#mcount) +1. [createAndAddDocumentedEntityWrapper](#mcreateandadddocumentedentitywrapper) +1. [getDocumentedEntitiesRelations](#mgetdocumentedentitiesrelations) +1. [getIterator](#mgetiterator) +## Methods details: - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - count -
    2. -
    3. - createAndAddDocumentedEntityWrapper -
    4. -
    5. - getDocumentedEntitiesRelations -
    6. -
    7. - getIterator -
    8. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L21) ```php public function __construct(\BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Plugin\PluginEventDispatcher $pluginEventDispatcher); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rendererContext | [\BumbleDocGen\Core\Renderer\Context\RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$pluginEventDispatcher | [\BumbleDocGen\Core\Plugin\PluginEventDispatcher](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginEventDispatcher.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rendererContext\BumbleDocGen\Core\Renderer\Context\RendererContext-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $pluginEventDispatcher\BumbleDocGen\Core\Plugin\PluginEventDispatcher-
    - - - -
    -
    -
    - - +--- +# `count` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L76) ```php public function count(): int; ``` +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) +--- -Parameters: not specified - -Return value: int - - -
    -
    -
    - - - +# `createAndAddDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L42) ```php public function createAndAddDocumentedEntityWrapper(\BumbleDocGen\Core\Parser\Entity\RootEntityInterface $rootEntity): \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rootEntity | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rootEntity\BumbleDocGen\Core\Parser\Entity\RootEntityInterface-
    - -Return value: \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper - - -Throws: - - -
    -
    -
    +***Return value:*** [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php) - +--- +# `getDocumentedEntitiesRelations` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L71) ```php public function getDocumentedEntitiesRelations(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getIterator` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L29) ```php public function getIterator(): \Generator; ``` +***Return value:*** [\Generator](https://www.php.net/manual/en/language.generators.overview.php) - -Parameters: not specified - -Return value: \Generator - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/DrawClassMap.md b/docs/tech/03_renderer/classes/DrawClassMap.md index 52bd63fe..7b064fad 100644 --- a/docs/tech/03_renderer/classes/DrawClassMap.md +++ b/docs/tech/03_renderer/classes/DrawClassMap.md @@ -1,37 +1,30 @@ - BumbleDocGen / Technical description of the project / Renderer / Template functions / DrawClassMap
    - -

    - DrawClassMap class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +DrawClassMap +--- +# [DrawClassMap](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DrawClassMap.php#L24) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Renderer\Twig\Function; final class DrawClassMap implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Generate class map in HTML format -
    Generate class map in HTML format
    - - -Examples of using: - +***Examples of using:*** ```php {{ drawClassMap(phpEntities.filterByPaths(['/src/Renderer'])) }} - ``` - ```php {{ drawClassMap(phpEntities) }} - ``` - -

    Settings:

    @@ -41,276 +34,94 @@ final class DrawClassMap implements \BumbleDocGen\Core\Renderer\Twig\Function\Cu
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [convertDirectoryStructureToFormattedString](#mconvertdirectorystructuretoformattedstring) +1. [getDirectoryStructure](#mgetdirectorystructure) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - convertDirectoryStructureToFormattedString -
    4. -
    5. - getDirectoryStructure -
    6. -
    7. - getName -
    8. -
    9. - getOptions -
    10. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DrawClassMap.php#L29) ```php public function __construct(\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | +$rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $getDocumentedEntityUrlFunction\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl-
    $rootEntityCollectionsGroup\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DrawClassMap.php#L57) ```php public function __invoke(\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection ...$entitiesCollections): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entitiesCollections (variadic) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | The collection of entities for which the class map will be generated | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entitiesCollections (variadic)\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollectionThe collection of entities for which the class map will be generated
    - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - convertDirectoryStructureToFormattedString - | source code
    • -
    +--- +# `convertDirectoryStructureToFormattedString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DrawClassMap.php#L132) ```php public function convertDirectoryStructureToFormattedString(array $structure, string $prefix = '│', string $path = '/'): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$structure | [array](https://www.php.net/manual/en/language.types.array.php) | - | +$prefix | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$path | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $structurearray-
    $prefixstring-
    $pathstring-
    - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getDirectoryStructure` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DrawClassMap.php#L97) ```php public function getDirectoryStructure(\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection ...$entitiesCollections): array; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entitiesCollections (variadic) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entitiesCollections (variadic)\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection-
    - -Return value: array - - -Throws: - - -
    -
    -
    +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DrawClassMap.php#L35) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DrawClassMap.php#L40) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/DrawDocumentationMenu.md b/docs/tech/03_renderer/classes/DrawDocumentationMenu.md index 48dd97cd..b12f9c82 100644 --- a/docs/tech/03_renderer/classes/DrawDocumentationMenu.md +++ b/docs/tech/03_renderer/classes/DrawDocumentationMenu.md @@ -1,54 +1,40 @@ - BumbleDocGen / Technical description of the project / Renderer / Template functions / DrawDocumentationMenu
    - -

    - DrawDocumentationMenu class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +DrawDocumentationMenu +--- +# [DrawDocumentationMenu](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L29) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class DrawDocumentationMenu implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Generate documentation menu in MD format. To generate the menu, the start page is taken, +and all links with this page are recursively collected for it, after which the html menu is created. -
    Generate documentation menu in HTML format. To generate the menu, the start page is taken, -and all links with this page are recursively collected for it, after which the html menu is created.
    - -See: - - - -Examples of using: +***Links:*** +- [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](/docs/tech/03_renderer/classes/GetDocumentedEntityUrl_2.md) +***Examples of using:*** ```php {{ drawDocumentationMenu() }} - The menu contains links to all documents - ``` - ```php {{ drawDocumentationMenu('/render/index.md') }} - The menu contains links to all child documents from the /render/index.md file (for example /render/test/index.md) - ``` - ```php {{ drawDocumentationMenu(_self) }} - The menu contains links to all child documents from the file where this function was called - ``` - ```php {{ drawDocumentationMenu(_self, 2) }} - The menu contains links to all child documents from the file where this function was called, but no more than 2 in depth - ``` - -

    Settings:

    @@ -58,188 +44,65 @@ See:
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L31) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$rendererContext | [\BumbleDocGen\Core\Renderer\Context\RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php) | - | +$dependencyFactory | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/Dependency/RendererDependencyFactory.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $rendererContext\BumbleDocGen\Core\Renderer\Context\RendererContext-
    $dependencyFactory\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L64) ```php public function __invoke(string|null $startPageKey = null, int|null $maxDeep = null): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$startPageKey | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Relative path to the page from which the menu will be generated (only child pages will be taken into account). + By default, the main documentation page (readme.md) is used. | +$maxDeep | [int](https://www.php.net/manual/en/language.types.integer.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Maximum parsing depth of documented links starting from the current page. + By default, this restriction is disabled. | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $startPageKeystring | nullRelative path to the page from which the menu will be generated (only child pages will be taken into account). - By default, the main documentation page (readme.md) is used.
    $maxDeepint | nullMaximum parsing depth of documented links starting from the current page. - By default, this restriction is disabled.
    - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L39) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L44) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/DrawDocumentedEntityLink.md b/docs/tech/03_renderer/classes/DrawDocumentedEntityLink.md index 2a73a6a7..9b7fe4cd 100644 --- a/docs/tech/03_renderer/classes/DrawDocumentedEntityLink.md +++ b/docs/tech/03_renderer/classes/DrawDocumentedEntityLink.md @@ -1,42 +1,33 @@ - BumbleDocGen / Technical description of the project / Renderer / Template functions / DrawDocumentedEntityLink
    - -

    - DrawDocumentedEntityLink class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +DrawDocumentedEntityLink +--- +# [DrawDocumentedEntityLink](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php#L21) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class DrawDocumentedEntityLink implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Creates an entity link by object -
    Creates an entity link by object
    - - -Examples of using: - +***Examples of using:*** ```php {{ drawDocumentedEntityLink($entity, 'getFunctions()') }} - ``` - ```php {{ drawDocumentedEntityLink($entity) }} - ``` - ```php {{ drawDocumentedEntityLink($entity, '', false) }} - ``` - -

    Settings:

    @@ -46,176 +37,61 @@ final class DrawDocumentedEntityLink implements \BumbleDocGen\Core\Renderer\Twig
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php#L23) ```php public function __construct(\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $getDocumentedEntityUrlFunction\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php#L50) ```php public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityInterface $entity, string $cursor = '', bool $useShortName = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) | The entity for which we want to get the link | +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | Reference to an element inside an entity, for example, the name of a function/constant/property | +$useShortName | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Use the full or short entity name in the link | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\RootEntityInterfaceThe entity for which we want to get the link
    $cursorstringReference to an element inside an entity, for example, the name of a function/constant/property
    $useShortNameboolUse the full or short entity name in the link
    - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php#L27) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php#L32) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/FileGetContents.md b/docs/tech/03_renderer/classes/FileGetContents.md index 1758b51e..84e46c29 100644 --- a/docs/tech/03_renderer/classes/FileGetContents.md +++ b/docs/tech/03_renderer/classes/FileGetContents.md @@ -1,43 +1,33 @@ - BumbleDocGen / Technical description of the project / Renderer / Template functions / FileGetContents
    - -

    - FileGetContents class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +FileGetContents +--- +# [FileGetContents](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/FileGetContents.php#L17) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class FileGetContents implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Displaying the content of a file or web resource -
    Displaying the content of a file or web resource
    - -See: - - - -Examples of using: +***Links:*** +- [https://www.php.net/manual/en/function.file-get-contents.php](https://www.php.net/manual/en/function.file-get-contents.php) +***Examples of using:*** ```php {{ fileGetContents('https://www.php.net/manual/en/function.file-get-contents.php') }} - ``` - ```php {{ fileGetContents('%templates_dir%/../config.yaml') }} - ``` - -

    Settings:

    @@ -47,154 +37,60 @@ See:
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/FileGetContents.php#L19) ```php public function __construct(\BumbleDocGen\Core\Configuration\ConfigurationParameterBag $parameterBag); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$parameterBag | [\BumbleDocGen\Core\Configuration\ConfigurationParameterBag](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/ConfigurationParameterBag.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parameterBag\BumbleDocGen\Core\Configuration\ConfigurationParameterBag-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/FileGetContents.php#L41) ```php public function __invoke(string $resourceName): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$resourceName | [string](https://www.php.net/manual/en/language.types.string.php) | Resource name, url or path to the resource. + The path can contain shortcodes with parameters from the configuration (%param_name%) | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $resourceNamestringResource name, url or path to the resource. - The path can contain shortcodes with parameters from the configuration (%param_name%)
    - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/FileGetContents.php#L23) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/FileGetContents.php#L28) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/FixStrSize.md b/docs/tech/03_renderer/classes/FixStrSize.md index 029a7bd7..b6ef738a 100644 --- a/docs/tech/03_renderer/classes/FixStrSize.md +++ b/docs/tech/03_renderer/classes/FixStrSize.md @@ -1,22 +1,20 @@ - BumbleDocGen / Technical description of the project / Renderer / Template filters / FixStrSize
    - -

    - FixStrSize class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template filters](/docs/tech/03_renderer/04_twigCustomFilters.md) **/** +FixStrSize +--- +# [FixStrSize](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/FixStrSize.php#L12) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Filter; final class FixStrSize implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface ``` - -
    The filter pads the string with the specified characters on the right to the specified size
    - - +The filter pads the string with the specified characters on the right to the specified size

    Settings:

    @@ -32,119 +30,45 @@ final class FixStrSize implements \BumbleDocGen\Core\Renderer\Twig\Filter\Custom +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) +## Methods details: - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/FixStrSize.php#L20) ```php public function __invoke(string $text, int $size, string $symbol = ' '): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$text | [string](https://www.php.net/manual/en/language.types.string.php) | Processed text | +$size | [int](https://www.php.net/manual/en/language.types.integer.php) | Required string size | +$symbol | [string](https://www.php.net/manual/en/language.types.string.php) | The character to be used to complete the string | -Parameters: +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstringProcessed text
    $sizeintRequired string size
    $symbolstringThe character to be used to complete the string
    - -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/FixStrSize.php#L31) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/FixStrSize.php#L36) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs.md b/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs.md index 0109274b..72e86839 100644 --- a/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs.md +++ b/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs.md @@ -1,22 +1,20 @@ - BumbleDocGen / Technical description of the project / Renderer / Template functions / GeneratePageBreadcrumbs
    - -

    - GeneratePageBreadcrumbs class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +GeneratePageBreadcrumbs +--- +# [GeneratePageBreadcrumbs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L20) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class GeneratePageBreadcrumbs implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` - -
    Function to generate breadcrumbs on the page
    - - +Function to generate breadcrumbs on the page

    Settings:

    @@ -28,197 +26,65 @@ final class GeneratePageBreadcrumbs implements \BumbleDocGen\Core\Renderer\Twig\ +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L22) ```php public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$rendererContext | [\BumbleDocGen\Core\Renderer\Context\RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php) | - | +$dependencyFactory | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/Dependency/RendererDependencyFactory.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $rendererContext\BumbleDocGen\Core\Renderer\Context\RendererContext-
    $dependencyFactory\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L57) ```php public function __invoke(string $currentPageTitle, string $templatePath, bool $skipFirstTemplatePage = true): string; ``` +***Parameters:*** - -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $currentPageTitlestringTitle of the current page
    $templatePathstringPath to the template from which the breadcrumbs will be generated
    $skipFirstTemplatePageboolIf set to true, the page from which parsing starts will not participate in the formation of breadcrumbs +| Name | Type | Description | +|:-|:-|:-| +$currentPageTitle | [string](https://www.php.net/manual/en/language.types.string.php) | Title of the current page | +$templatePath | [string](https://www.php.net/manual/en/language.types.string.php) | Path to the template from which the breadcrumbs will be generated | +$skipFirstTemplatePage | [bool](https://www.php.net/manual/en/language.types.boolean.php) | If set to true, the page from which parsing starts will not participate in the formation of breadcrumbs This option is useful when working with the _self value in a template, as it returns the full path to the - current template, and the reference to it in breadcrumbs should not be clickable.
    - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L29) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L34) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs_2.md b/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs_2.md index 39ccc052..319ab36b 100644 --- a/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs_2.md +++ b/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs_2.md @@ -1,22 +1,20 @@ - BumbleDocGen / Technical description of the project / Renderer / Documentation structure and breadcrumbs / GeneratePageBreadcrumbs
    - -

    - GeneratePageBreadcrumbs class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Documentation structure and breadcrumbs](/docs/tech/03_renderer/02_breadcrumbs.md) **/** +GeneratePageBreadcrumbs +--- +# [GeneratePageBreadcrumbs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L20) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class GeneratePageBreadcrumbs implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` - -
    Function to generate breadcrumbs on the page
    - - +Function to generate breadcrumbs on the page

    Settings:

    @@ -28,197 +26,65 @@ final class GeneratePageBreadcrumbs implements \BumbleDocGen\Core\Renderer\Twig\ +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L22) ```php public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$rendererContext | [\BumbleDocGen\Core\Renderer\Context\RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php) | - | +$dependencyFactory | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/Dependency/RendererDependencyFactory.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $rendererContext\BumbleDocGen\Core\Renderer\Context\RendererContext-
    $dependencyFactory\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L57) ```php public function __invoke(string $currentPageTitle, string $templatePath, bool $skipFirstTemplatePage = true): string; ``` +***Parameters:*** - -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $currentPageTitlestringTitle of the current page
    $templatePathstringPath to the template from which the breadcrumbs will be generated
    $skipFirstTemplatePageboolIf set to true, the page from which parsing starts will not participate in the formation of breadcrumbs +| Name | Type | Description | +|:-|:-|:-| +$currentPageTitle | [string](https://www.php.net/manual/en/language.types.string.php) | Title of the current page | +$templatePath | [string](https://www.php.net/manual/en/language.types.string.php) | Path to the template from which the breadcrumbs will be generated | +$skipFirstTemplatePage | [bool](https://www.php.net/manual/en/language.types.boolean.php) | If set to true, the page from which parsing starts will not participate in the formation of breadcrumbs This option is useful when working with the _self value in a template, as it returns the full path to the - current template, and the reference to it in breadcrumbs should not be clickable.
    - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L29) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L34) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/GetClassMethodsBodyCode.md b/docs/tech/03_renderer/classes/GetClassMethodsBodyCode.md index 0ae3a972..471c2954 100644 --- a/docs/tech/03_renderer/classes/GetClassMethodsBodyCode.md +++ b/docs/tech/03_renderer/classes/GetClassMethodsBodyCode.md @@ -1,32 +1,27 @@ - BumbleDocGen / Technical description of the project / Renderer / Template functions / GetClassMethodsBodyCode
    - -

    - GetClassMethodsBodyCode class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +GetClassMethodsBodyCode +--- +# [GetClassMethodsBodyCode](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/GetClassMethodsBodyCode.php#L20) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Renderer\Twig\Function; final class GetClassMethodsBodyCode implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Get the code of the specified class methods as a formatted string -
    Get the code of the specified class methods as a formatted string
    - - -Examples of using: - +***Examples of using:*** ```php {{ getClassMethodsBodyCode('\\BumbleDocGen\\Renderer\\Twig\\MainExtension', ['getFunctions']) }} - ``` - -

    Settings:

    @@ -36,171 +31,60 @@ final class GetClassMethodsBodyCode implements \BumbleDocGen\Core\Renderer\Twig\
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/GetClassMethodsBodyCode.php#L22) ```php public function __construct(\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rootEntityCollectionsGroup\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/GetClassMethodsBodyCode.php#L49) ```php public function __invoke(string $className, array $methodsNames): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$className | [string](https://www.php.net/manual/en/language.types.string.php) | The name of the class whose methods are to be retrieved | +$methodsNames | [array](https://www.php.net/manual/en/language.types.array.php) | List of class methods whose code needs to be retrieved | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classNamestringThe name of the class whose methods are to be retrieved
    $methodsNamesarrayList of class methods whose code needs to be retrieved
    - -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/GetClassMethodsBodyCode.php#L26) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/GetClassMethodsBodyCode.php#L31) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/GetDocumentationPageUrl.md b/docs/tech/03_renderer/classes/GetDocumentationPageUrl.md index af605e97..b518c69f 100644 --- a/docs/tech/03_renderer/classes/GetDocumentationPageUrl.md +++ b/docs/tech/03_renderer/classes/GetDocumentationPageUrl.md @@ -1,47 +1,36 @@ - BumbleDocGen / Technical description of the project / Renderer / Template functions / GetDocumentationPageUrl
    - -

    - GetDocumentationPageUrl class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +GetDocumentationPageUrl +--- +# [GetDocumentationPageUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php#L21) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class GetDocumentationPageUrl implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Creates an entity link by object -
    Creates an entity link by object
    - - -Examples of using: - +***Examples of using:*** ```php {{ getDocumentationPageUrl('Page name') }} - ``` - ```php {{ getDocumentationPageUrl('/someDir/someTemplate.md.twig') }} - ``` - ```php {{ getDocumentationPageUrl('/docs/someDir/someDocFile.md') }} - ``` - ```php {{ getDocumentationPageUrl('readme.md') }} - ``` - -

    Settings:

    @@ -51,179 +40,61 @@ final class GetDocumentationPageUrl implements \BumbleDocGen\Core\Renderer\Twig\
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php#L25) ```php public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php#L53) ```php public function __invoke(string $key): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | The key by which to look up the URL of the page. + Can be the title of a page, a path to a template, or a generated document | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystringThe key by which to look up the URL of the page. - Can be the title of a page, a path to a template, or a generated document
    - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php#L31) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php#L36) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/GetDocumentedEntityUrl.md b/docs/tech/03_renderer/classes/GetDocumentedEntityUrl.md index 5fd48c82..aca51be5 100644 --- a/docs/tech/03_renderer/classes/GetDocumentedEntityUrl.md +++ b/docs/tech/03_renderer/classes/GetDocumentedEntityUrl.md @@ -1,56 +1,42 @@ - BumbleDocGen / Technical description of the project / Renderer / Template functions / GetDocumentedEntityUrl
    - -

    - GetDocumentedEntityUrl class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +GetDocumentedEntityUrl +--- +# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L37) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class GetDocumentedEntityUrl implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Get the URL of a documented entity by its name. If the entity is found, next to the file where this method was called, +the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created -
    Get the URL of a documented entity by its name. If the entity is found, next to the file where this method was called, -the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created
    - -See: - - - -Examples of using: +***Links:*** +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/03_renderer/classes/DocumentedEntityWrapper.md) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/03_renderer/classes/DocumentedEntityWrappersCollection.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/03_renderer/classes/RendererContext.md) +***Examples of using:*** ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension', 'getFunctions') }} The function returns a reference to the documented entity, anchored to the getFunctions method - ``` - ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension') }} The function returns a reference to the documented entity MainExtension - ``` - ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension', '', false) }} The function returns a link to the file MainExtension - ``` - -

    Settings:

    @@ -60,204 +46,66 @@ The function returns a link to the file MainExtension
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L41) ```php public function __construct(\BumbleDocGen\Core\Renderer\RendererHelper $rendererHelper, \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection $documentedEntityWrappersCollection, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Monolog\Logger $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rendererHelper | [\BumbleDocGen\Core\Renderer\RendererHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/RendererHelper.php) | - | +$documentedEntityWrappersCollection | [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/Monolog/Logger.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rendererHelper\BumbleDocGen\Core\Renderer\RendererHelper-
    $documentedEntityWrappersCollection\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection-
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $logger\Monolog\Logger-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L76) ```php public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | Processed entity collection | +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | The full name of the entity for which the URL will be retrieved. + If the entity is not found, the DEFAULT_URL value will be returned. | +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | Cursor on the page of the documented entity (for example, the name of a method or property) | +$createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | If true, creates an entity document. Otherwise, just gives a reference to the entity code | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rootEntityCollection\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionProcessed entity collection
    $entityNamestringThe full name of the entity for which the URL will be retrieved. - If the entity is not found, the DEFAULT_URL value will be returned.
    $cursorstringCursor on the page of the documented entity (for example, the name of a method or property)
    $createDocumentboolIf true, creates an entity document. Otherwise, just gives a reference to the entity code
    - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L49) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L54) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/GetDocumentedEntityUrl_2.md b/docs/tech/03_renderer/classes/GetDocumentedEntityUrl_2.md index 1030ccf4..c583a7d0 100644 --- a/docs/tech/03_renderer/classes/GetDocumentedEntityUrl_2.md +++ b/docs/tech/03_renderer/classes/GetDocumentedEntityUrl_2.md @@ -1,56 +1,41 @@ - BumbleDocGen / Technical description of the project / Renderer / GetDocumentedEntityUrl
    - -

    - GetDocumentedEntityUrl class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +GetDocumentedEntityUrl +--- +# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L37) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class GetDocumentedEntityUrl implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Get the URL of a documented entity by its name. If the entity is found, next to the file where this method was called, +the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created -
    Get the URL of a documented entity by its name. If the entity is found, next to the file where this method was called, -the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created
    - -See: - - - -Examples of using: +***Links:*** +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/03_renderer/classes/DocumentedEntityWrapper.md) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/03_renderer/classes/DocumentedEntityWrappersCollection.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/03_renderer/classes/RendererContext.md) +***Examples of using:*** ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension', 'getFunctions') }} The function returns a reference to the documented entity, anchored to the getFunctions method - ``` - ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension') }} The function returns a reference to the documented entity MainExtension - ``` - ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension', '', false) }} The function returns a link to the file MainExtension - ``` - -

    Settings:

    @@ -60,204 +45,66 @@ The function returns a link to the file MainExtension
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L41) ```php public function __construct(\BumbleDocGen\Core\Renderer\RendererHelper $rendererHelper, \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection $documentedEntityWrappersCollection, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Monolog\Logger $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rendererHelper | [\BumbleDocGen\Core\Renderer\RendererHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/RendererHelper.php) | - | +$documentedEntityWrappersCollection | [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/Monolog/Logger.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rendererHelper\BumbleDocGen\Core\Renderer\RendererHelper-
    $documentedEntityWrappersCollection\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection-
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $logger\Monolog\Logger-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L76) ```php public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | Processed entity collection | +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | The full name of the entity for which the URL will be retrieved. + If the entity is not found, the DEFAULT_URL value will be returned. | +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | Cursor on the page of the documented entity (for example, the name of a method or property) | +$createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | If true, creates an entity document. Otherwise, just gives a reference to the entity code | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rootEntityCollection\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionProcessed entity collection
    $entityNamestringThe full name of the entity for which the URL will be retrieved. - If the entity is not found, the DEFAULT_URL value will be returned.
    $cursorstringCursor on the page of the documented entity (for example, the name of a method or property)
    $createDocumentboolIf true, creates an entity document. Otherwise, just gives a reference to the entity code
    - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L49) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L54) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/Implode.md b/docs/tech/03_renderer/classes/Implode.md index 66445405..df92158a 100644 --- a/docs/tech/03_renderer/classes/Implode.md +++ b/docs/tech/03_renderer/classes/Implode.md @@ -1,28 +1,23 @@ - BumbleDocGen / Technical description of the project / Renderer / Template filters / Implode
    - -

    - Implode class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template filters](/docs/tech/03_renderer/04_twigCustomFilters.md) **/** +Implode +--- +# [Implode](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/Implode.php#L10) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Filter; final class Implode implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface ``` +Join array elements with a string -
    Join array elements with a string
    - -See: - - - +***Links:*** +- [https://www.php.net/manual/en/function.implode.php](https://www.php.net/manual/en/function.implode.php)

    Settings:

    @@ -38,114 +33,44 @@ See: +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) +## Methods details: - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/Implode.php#L17) ```php public function __invoke(array $elements, string $separator = ', '): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$elements | [array](https://www.php.net/manual/en/language.types.array.php) | The array to implode | +$separator | [string](https://www.php.net/manual/en/language.types.string.php) | Element separator in result string | -Parameters: +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $elementsarrayThe array to implode
    $separatorstringElement separator in result string
    - -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/Implode.php#L22) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/Implode.php#L27) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/InvalidConfigurationParameterException.md b/docs/tech/03_renderer/classes/InvalidConfigurationParameterException.md deleted file mode 100644 index 79d6a3b3..00000000 --- a/docs/tech/03_renderer/classes/InvalidConfigurationParameterException.md +++ /dev/null @@ -1,31 +0,0 @@ - BumbleDocGen / Technical description of the project / Renderer / InvalidConfigurationParameterException
    - -

    - InvalidConfigurationParameterException class: -

    - - - - - -```php -namespace BumbleDocGen\Core\Configuration\Exception; - -final class InvalidConfigurationParameterException extends \Exception -``` - - - - - - - - - - - - - - - - diff --git a/docs/tech/03_renderer/classes/LoadPluginsContent.md b/docs/tech/03_renderer/classes/LoadPluginsContent.md index c2dff34a..8cf304cc 100644 --- a/docs/tech/03_renderer/classes/LoadPluginsContent.md +++ b/docs/tech/03_renderer/classes/LoadPluginsContent.md @@ -1,32 +1,27 @@ - BumbleDocGen / Technical description of the project / Renderer / Template functions / LoadPluginsContent
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +LoadPluginsContent -

    - LoadPluginsContent class: -

    +--- - - -:warning: Is internal +# [LoadPluginsContent](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/LoadPluginsContent.php#L18) class: +⚠️ Internal ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class LoadPluginsContent implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Process entity template blocks with plugins. The method returns the content processed by plugins. -
    Process entity template blocks with plugins. The method returns the content processed by plugins.
    - - -Examples of using: - +***Examples of using:*** ```php {{ loadPluginsContent('some text', entity, constant('BumbleDocGen\\Plugin\\BaseTemplatePluginInterface::BLOCK_AFTER_HEADER')) }} - ``` - -

    Settings:

    @@ -36,163 +31,61 @@ final class LoadPluginsContent implements \BumbleDocGen\Core\Renderer\Twig\Funct
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/LoadPluginsContent.php#L20) ```php public function __construct(\BumbleDocGen\Core\Plugin\PluginEventDispatcher $pluginEventDispatcher); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$pluginEventDispatcher | [\BumbleDocGen\Core\Plugin\PluginEventDispatcher](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginEventDispatcher.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginEventDispatcher\BumbleDocGen\Core\Plugin\PluginEventDispatcher-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/LoadPluginsContent.php#L42) ```php public function __invoke(string $content, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface $entity, string $blockType): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$content | [string](https://www.php.net/manual/en/language.types.string.php) | Content to be processed by plugins | +$entity | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) | The entity for which we process the content block | +$blockType | [string](https://www.php.net/manual/en/language.types.string.php) | Content block type. @see BaseTemplatePluginInterface::BLOCK_* | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $contentstringContent to be processed by plugins
    $entity\BumbleDocGen\Core\Parser\Entity\RootEntityInterfaceThe entity for which we process the content block
    $blockTypestringContent block type. @see BaseTemplatePluginInterface::BLOCK_*
    - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/LoadPluginsContent.php#L24) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/LoadPluginsContent.php#L29) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/PhpEntitiesCollection.md b/docs/tech/03_renderer/classes/PhpEntitiesCollection.md index da8bcd02..869fec21 100644 --- a/docs/tech/03_renderer/classes/PhpEntitiesCollection.md +++ b/docs/tech/03_renderer/classes/PhpEntitiesCollection.md @@ -1,883 +1,352 @@ - BumbleDocGen / Technical description of the project / Renderer / Template functions / PhpEntitiesCollection
    - -

    - PhpEntitiesCollection class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +PhpEntitiesCollection +--- +# [PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L43) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Parser\Entity; final class PhpEntitiesCollection extends \BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection implements \IteratorAggregate ``` - -
    Collection of php root entities
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - add - - Add an entity to the collection
    2. -
    3. - clearOperationsLogCollection -
    4. -
    5. - filterByInterfaces - - Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity)
    6. -
    7. - filterByNameRegularExpression - - Get a copy of the current collection with only entities whose names match the regular expression
    8. -
    9. - filterByParentClassNames - - Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity)
    10. -
    11. - filterByPaths - - Get a copy of the current collection only with entities filtered by file paths (from project_root)
    12. -
    13. - findEntity - - Find an entity in a collection
    14. -
    15. - get - - Get an entity from a collection (only previously added)
    16. -
    17. - getEntityCollectionName - - Get collection name
    18. -
    19. - getEntityLinkData -
    20. -
    21. - getIterator -
    22. -
    23. - getLoadedOrCreateNew - - Get an entity from the collection or create a new one if it has not yet been added
    24. -
    25. - getOnlyAbstractClasses - - Get a copy of the current collection with only abstract classes
    26. -
    27. - getOnlyInstantiable - - Get a copy of the current collection with only instantiable entities
    28. -
    29. - getOnlyInterfaces - - Get a copy of the current collection with only interfaces
    30. -
    31. - getOnlyTraits - - Get a copy of the current collection with only traits
    32. -
    33. - getOperationsLogCollection -
    34. -
    35. - has - - Check if an entity has been added to the collection
    36. -
    37. - internalFindEntity -
    38. -
    39. - internalGetLoadedOrCreateNew -
    40. -
    41. - isEmpty - - Check if the collection is empty or not
    42. -
    43. - loadEntities - - Load entities into a collection
    44. -
    45. - loadEntitiesByConfiguration - - Load entities into a collection by configuration
    46. -
    47. - remove - - Remove an entity from a collection
    48. -
    49. - removeAllNotLoadedEntities -
    50. -
    51. - toArray - - Convert collection to array
    52. -
    53. - updateEntitiesCache -
    54. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Collection of php root entities + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [add](#madd) - Add an entity to the collection +1. [clearOperationsLogCollection](#mclearoperationslogcollection) +1. [filterByInterfaces](#mfilterbyinterfaces) - Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity) +1. [filterByNameRegularExpression](#mfilterbynameregularexpression) - Get a copy of the current collection with only entities whose names match the regular expression +1. [filterByParentClassNames](#mfilterbyparentclassnames) - Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity) +1. [filterByPaths](#mfilterbypaths) - Get a copy of the current collection only with entities filtered by file paths (from project_root) +1. [findEntity](#mfindentity) - Find an entity in a collection +1. [get](#mget) - Get an entity from a collection (only previously added) +1. [getEntityCollectionName](#mgetentitycollectionname) - Get collection name +1. [getEntityLinkData](#mgetentitylinkdata) +1. [getIterator](#mgetiterator) +1. [getLoadedOrCreateNew](#mgetloadedorcreatenew) - Get an entity from the collection or create a new one if it has not yet been added +1. [getOnlyAbstractClasses](#mgetonlyabstractclasses) - Get a copy of the current collection with only abstract classes +1. [getOnlyInstantiable](#mgetonlyinstantiable) - Get a copy of the current collection with only instantiable entities +1. [getOnlyInterfaces](#mgetonlyinterfaces) - Get a copy of the current collection with only interfaces +1. [getOnlyTraits](#mgetonlytraits) - Get a copy of the current collection with only traits +1. [getOperationsLogCollection](#mgetoperationslogcollection) +1. [has](#mhas) - Check if an entity has been added to the collection +1. [internalFindEntity](#minternalfindentity) +1. [internalGetLoadedOrCreateNew](#minternalgetloadedorcreatenew) +1. [isEmpty](#misempty) - Check if the collection is empty or not +1. [loadEntities](#mloadentities) - Load entities into a collection +1. [loadEntitiesByConfiguration](#mloadentitiesbyconfiguration) - Load entities into a collection by configuration +1. [remove](#mremove) - Remove an entity from a collection +1. [removeAllNotLoadedEntities](#mremoveallnotloadedentities) +1. [toArray](#mtoarray) - Convert collection to array +1. [updateEntitiesCache](#mupdateentitiescache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L50) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings, \BumbleDocGen\Core\Plugin\PluginEventDispatcher $pluginEventDispatcher, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory $cacheablePhpEntityFactory, \BumbleDocGen\LanguageHandler\Php\Renderer\EntityDocRenderer\EntityDocRendererHelper $docRendererHelper, \BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper $phpParserHelper, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | +$pluginEventDispatcher | [\BumbleDocGen\Core\Plugin\PluginEventDispatcher](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginEventDispatcher.php) | - | +$cacheablePhpEntityFactory | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/Cache/CacheablePhpEntityFactory.php) | - | +$docRendererHelper | [\BumbleDocGen\LanguageHandler\Php\Renderer\EntityDocRenderer\EntityDocRendererHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/EntityDocRenderer/EntityDocRendererHelper.php) | - | +$phpParserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/PhpParser/PhpParserHelper.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $phpHandlerSettings\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings-
    $pluginEventDispatcher\BumbleDocGen\Core\Plugin\PluginEventDispatcher-
    $cacheablePhpEntityFactory\BumbleDocGen\LanguageHandler\Php\Parser\Entity\Cache\CacheablePhpEntityFactory-
    $docRendererHelper\BumbleDocGen\LanguageHandler\Php\Renderer\EntityDocRenderer\EntityDocRendererHelper-
    $phpParserHelper\BumbleDocGen\LanguageHandler\Php\Parser\PhpParser\PhpParserHelper-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `add` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L190) ```php public function add(\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity $classEntity, bool $reload = false): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Add an entity to the collection -
    Add an entity to the collection
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity-
    $reloadbool-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -Throws: - - -
    -
    -
    - - +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$classEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) | - | +$reload | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | + +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) + +--- + +# `clearOperationsLogCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L28) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function clearOperationsLogCollection(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -
    -
    -
    - - - +# `filterByInterfaces` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L244) ```php public function filterByInterfaces(array $interfaces): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity) -
    Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity)
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $interfacesstring[]-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Parameters:*** -Throws: - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `filterByNameRegularExpression` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L321) ```php public function filterByNameRegularExpression(string $regexPattern): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection with only entities whose names match the regular expression -
    Get a copy of the current collection with only entities whose names match the regular expression
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $regexPatternstring-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$regexPattern | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) - +--- +# `filterByParentClassNames` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L270) ```php public function filterByParentClassNames(array $parentClassNames): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity) -
    Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity)
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentClassNamesarray-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Parameters:*** -Throws: - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `filterByPaths` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L298) ```php public function filterByPaths(array $paths): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection only with entities filtered by file paths (from project_root) -
    Get a copy of the current collection only with entities filtered by file paths (from project_root)
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pathsarray-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$paths | [array](https://www.php.net/manual/en/language.types.array.php) | - | -Throws: - - -
    -
    -
    - - +--- +# `findEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L118) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function findEntity(string $search, bool $useUnsafeKeys = true): null|\BumbleDocGen\Core\Parser\Entity\RootEntityInterface; ``` +Find an entity in a collection + +***Parameters:*** -
    Find an entity in a collection
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $searchstring-
    $useUnsafeKeysbool-
    - -Return value: null | \BumbleDocGen\Core\Parser\Entity\RootEntityInterface - - -
    -
    -
    - - +| Name | Type | Description | +|:-|:-|:-| +$search | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$useUnsafeKeys | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) + +--- + +# `get` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L86) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function get(string $objectName): null|\BumbleDocGen\Core\Parser\Entity\RootEntityInterface; ``` +Get an entity from a collection (only previously added) -
    Get an entity from a collection (only previously added)
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    +***Parameters:*** -Return value: null | \BumbleDocGen\Core\Parser\Entity\RootEntityInterface +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) -
    -
    -
    - - +--- +# `getEntityCollectionName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L66) ```php public function getEntityCollectionName(): string; ``` +Get collection name -
    Get collection name
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - getEntityLinkData - :warning: Is internal | source code
    • -
    +--- +# `getEntityLinkData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L508) ```php public function getEntityLinkData(string $rawLink, string|null $defaultEntityName = null, bool $useUnsafeKeys = true): array; ``` +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$rawLink | [string](https://www.php.net/manual/en/language.types.string.php) | Raw link to an entity or entity element | +$defaultEntityName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Entity name to use if the link does not contain a valid or existing entity name, + but only a cursor on an entity element | +$useUnsafeKeys | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rawLinkstringRaw link to an entity or entity element
    $defaultEntityNamestring | nullEntity name to use if the link does not contain a valid or existing entity name, - but only a cursor on an entity element
    $useUnsafeKeysbool-
    - -Return value: array - - -
    -
    -
    - - +--- +# `getIterator` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L46) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function getIterator(): \Generator; ``` +***Return value:*** [\Generator](https://www.php.net/manual/en/language.generators.overview.php) +--- -Parameters: not specified - -Return value: \Generator - - -
    -
    -
    - - - +# `getLoadedOrCreateNew` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L102) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function getLoadedOrCreateNew(string $objectName, bool $withAddClassEntityToCollectionEvent = false): \BumbleDocGen\Core\Parser\Entity\RootEntityInterface; ``` +Get an entity from the collection or create a new one if it has not yet been added -
    Get an entity from the collection or create a new one if it has not yet been added
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    $withAddClassEntityToCollectionEventbool-
    - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityInterface - - - -See: - -
    -
    -
    - - +***Parameters:*** -```php -public function getOnlyAbstractClasses(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; -``` - -
    Get a copy of the current collection with only abstract classes
    +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$withAddClassEntityToCollectionEvent | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: not specified +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection +***Links:*** +- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](/docs/tech/03_renderer/classes/RootEntityInterface_2.md#misentitydatacanbeloaded) +--- -Throws: - +# `getOnlyAbstractClasses` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L388) +```php +public function getOnlyAbstractClasses(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; +``` +Get a copy of the current collection with only abstract classes -
    -
    -
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) - +--- +# `getOnlyInstantiable` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L338) ```php public function getOnlyInstantiable(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection with only instantiable entities -
    Get a copy of the current collection with only instantiable entities
    +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -
    -
    -
    - - +--- +# `getOnlyInterfaces` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L354) ```php public function getOnlyInterfaces(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection with only interfaces -
    Get a copy of the current collection with only interfaces
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `getOnlyTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L370) ```php public function getOnlyTraits(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +Get a copy of the current collection with only traits -
    Get a copy of the current collection with only traits
    - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) -
    -
    -
    - - +--- +# `getOperationsLogCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/LoggableRootEntityCollection.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\LoggableRootEntityCollection public function getOperationsLogCollection(): \BumbleDocGen\Core\Parser\Entity\CollectionLogOperation\OperationsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionLogOperation\OperationsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionLogOperation/OperationsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionLogOperation\OperationsCollection - - -
    -
    -
    - - - +# `has` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L42) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function has(string $objectName): bool; ``` +Check if an entity has been added to the collection -
    Check if an entity has been added to the collection
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    +***Parameters:*** -Return value: bool +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - -
      -
    • # - internalFindEntity - :warning: Is internal | source code
    • -
    +--- +# `internalFindEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L421) ```php public function internalFindEntity(string $search, bool $useUnsafeKeys = true): null|\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Parameters:*** - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $searchstringSearch query. For the search, only the main part is taken, up to the characters: `::`, `->`, `#`. +| Name | Type | Description | +|:-|:-|:-| +$search | [string](https://www.php.net/manual/en/language.types.string.php) | Search query. For the search, only the main part is taken, up to the characters: `::`, `->`, `#`. If the request refers to multiple existing entities and if unsafe keys are allowed, - a warning will be shown and the first entity found will be used.
    $useUnsafeKeysboolWhether to use search keys that can be used to find several entities
    - -Return value: null | \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity + a warning will be shown and the first entity found will be used. | +$useUnsafeKeys | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Whether to use search keys that can be used to find several entities | +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) - - -Examples of using: - +***Examples of using:*** ```php $entitiesCollection->findEntity('App'); // class name $entitiesCollection->findEntity('BumbleDocGen\Console\App'); // class with namespace @@ -889,318 +358,118 @@ $entitiesCollection->findEntity('/Users/someuser/Desktop/projects/bumble-doc-gen $entitiesCollection->findEntity('https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/App.php'); // source link ``` -
    -
    -
    - -
      -
    • # - internalGetLoadedOrCreateNew - :warning: Is internal | source code
    • -
    +--- +# `internalGetLoadedOrCreateNew` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L214) ```php public function internalGetLoadedOrCreateNew(string $objectName, bool $withAddClassEntityToCollectionEvent = false): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$withAddClassEntityToCollectionEvent | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    $withAddClassEntityToCollectionEventbool-
    - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -Throws: - - -
    -
    -
    - - +--- +# `isEmpty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L52) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function isEmpty(): bool; ``` +Check if the collection is empty or not -
    Check if the collection is empty or not
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `loadEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php#L100) ```php public function loadEntities(\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection $sourceLocatorsCollection, \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface|null $filters = null, \BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface|null $progressBar = null): \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult; ``` +Load entities into a collection -
    Load entities into a collection
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $sourceLocatorsCollection\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection-
    $filters\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface | null-
    $progressBar\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface | null-
    - -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult - - -Throws: - - -
    -
    -
    - -
      -
    • # - loadEntitiesByConfiguration - :warning: Is internal | source code
    • -
    - -```php -public function loadEntitiesByConfiguration(\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface|null $progressBar = null): \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult; -``` - -
    Load entities into a collection by configuration
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $progressBar\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface | null-
    +***Parameters:*** -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult +| Name | Type | Description | +|:-|:-|:-| +$sourceLocatorsCollection | [\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/SourceLocatorsCollection.php) | - | +$filters | [\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | +$progressBar | [\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntitiesLoaderProgressBarInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionLoadEntitiesResult.php) -Throws: - +| Name | Type | Description | +|:-|:-|:-| +$progressBar | [\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntitiesLoaderProgressBarInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -
    -
    -
    +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionLoadEntitiesResult.php) - +--- +# `remove` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L32) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function remove(string $objectName): void; ``` +Remove an entity from a collection -
    Remove an entity from a collection
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    - -Return value: void +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - +--- +# `removeAllNotLoadedEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L132) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\RootEntityCollection public function removeAllNotLoadedEntities(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -
    -
    -
    - - - +# `toArray` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L127) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\RootEntityCollection public function toArray(): array; ``` +Convert collection to array -
    Convert collection to array
    - -Parameters: not specified - -Return value: array - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) -
    -
    -
    - -
      -
    • # - updateEntitiesCache - :warning: Is internal | source code
    • -
    +--- +# `updateEntitiesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L97) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\RootEntityCollection public function updateEntitiesCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/PregMatch.md b/docs/tech/03_renderer/classes/PregMatch.md index 0e2f971b..921d145c 100644 --- a/docs/tech/03_renderer/classes/PregMatch.md +++ b/docs/tech/03_renderer/classes/PregMatch.md @@ -1,28 +1,23 @@ - BumbleDocGen / Technical description of the project / Renderer / Template filters / PregMatch
    - -

    - PregMatch class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template filters](/docs/tech/03_renderer/04_twigCustomFilters.md) **/** +PregMatch +--- +# [PregMatch](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/PregMatch.php#L12) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Filter; final class PregMatch implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface ``` +Perform a regular expression match -
    Perform a regular expression match
    - -See: - - - +***Links:*** +- [https://www.php.net/manual/en/function.preg-match.php](https://www.php.net/manual/en/function.preg-match.php)

    Settings:

    @@ -38,114 +33,44 @@ See: +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) +## Methods details: - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/PregMatch.php#L20) ```php public function __invoke(string $text, string $pattern): array; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$text | [string](https://www.php.net/manual/en/language.types.string.php) | Processed text | +$pattern | [string](https://www.php.net/manual/en/language.types.string.php) | The pattern to search for, as a string. | -Parameters: +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstringProcessed text
    $patternstringThe pattern to search for, as a string.
    - -Return value: array - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/PregMatch.php#L26) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/PregMatch.php#L31) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/PrepareSourceLink.md b/docs/tech/03_renderer/classes/PrepareSourceLink.md index abb9f147..44e8fdbb 100644 --- a/docs/tech/03_renderer/classes/PrepareSourceLink.md +++ b/docs/tech/03_renderer/classes/PrepareSourceLink.md @@ -1,22 +1,20 @@ - BumbleDocGen / Technical description of the project / Renderer / Template filters / PrepareSourceLink
    - -

    - PrepareSourceLink class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template filters](/docs/tech/03_renderer/04_twigCustomFilters.md) **/** +PrepareSourceLink +--- +# [PrepareSourceLink](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/PrepareSourceLink.php#L12) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Filter; final class PrepareSourceLink implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface ``` - -
    The filter converts the string into an anchor that can be used in a GitHub document link
    - - +The filter converts the string into an anchor that can be used in a GitHub document link

    Settings:

    @@ -32,109 +30,43 @@ final class PrepareSourceLink implements \BumbleDocGen\Core\Renderer\Twig\Filter +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) +## Methods details: - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/PrepareSourceLink.php#L17) ```php public function __invoke(string $text): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$text | [string](https://www.php.net/manual/en/language.types.string.php) | Processed text | -Parameters: +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstringProcessed text
    - -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/PrepareSourceLink.php#L22) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/PrepareSourceLink.php#L27) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/PrintEntityCollectionAsList.md b/docs/tech/03_renderer/classes/PrintEntityCollectionAsList.md index d05b2538..6a1df20d 100644 --- a/docs/tech/03_renderer/classes/PrintEntityCollectionAsList.md +++ b/docs/tech/03_renderer/classes/PrintEntityCollectionAsList.md @@ -1,39 +1,32 @@ - BumbleDocGen / Technical description of the project / Renderer / Template functions / PrintEntityCollectionAsList
    - -

    - PrintEntityCollectionAsList class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +PrintEntityCollectionAsList +--- +# [PrintEntityCollectionAsList](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php#L22) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class PrintEntityCollectionAsList implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Outputting entity data as MD list -
    Outputting entity data as HTML list
    - - -Examples of using: - +***Examples of using:*** ```php {{ printEntityCollectionAsList(phpEntities.filterByInterfaces(['ScriptFramework\\ScriptInterface', 'ScriptFramework\\TestScriptInterface'])) }} The function will output a list of PHP classes that match the ScriptFramework\ScriptInterface and ScriptFramework\TestScriptInterface interfaces - ``` - ```php {{ printEntityCollectionAsList(phpEntities) }} The function will list all documented PHP classes - ``` - -

    Settings:

    @@ -43,175 +36,63 @@ The function will list all documented PHP classes
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php#L24) ```php -public function __construct(\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction); +public function __construct(\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \BumbleDocGen\Core\Renderer\Twig\Filter\RemoveLineBrakes $removeLineBrakes); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | +$removeLineBrakes | [\BumbleDocGen\Core\Renderer\Twig\Filter\RemoveLineBrakes](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/RemoveLineBrakes.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $getDocumentedEntityUrlFunction\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php#L50) ```php public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $type = 'ul', bool $skipDescription = false, bool $useFullName = false): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | Processed entity collection | +$type | [string](https://www.php.net/manual/en/language.types.string.php) | List tag type (
      /
        ) | +$skipDescription | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Don't print description of this entities | +$useFullName | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Use the full name of the entity in the list | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
        NameTypeDescription
        $rootEntityCollection\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionProcessed entity collection
        $typestringList tag type (
          /
            )
        $skipDescriptionboolDon't print description of this entities
        $useFullNameboolUse the full name of the entity in the list
        - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php#L30) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php#L35) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/Quotemeta.md b/docs/tech/03_renderer/classes/Quotemeta.md index 1f61c598..3a103586 100644 --- a/docs/tech/03_renderer/classes/Quotemeta.md +++ b/docs/tech/03_renderer/classes/Quotemeta.md @@ -1,28 +1,23 @@ - BumbleDocGen / Technical description of the project / Renderer / Template filters / Quotemeta
    - -

    - Quotemeta class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template filters](/docs/tech/03_renderer/04_twigCustomFilters.md) **/** +Quotemeta +--- +# [Quotemeta](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/Quotemeta.php#L10) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Filter; final class Quotemeta implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface ``` +Quote meta characters -
    Quote meta characters
    - -See: - - - +***Links:*** +- [https://www.php.net/manual/en/function.quotemeta.php](https://www.php.net/manual/en/function.quotemeta.php)

    Settings:

    @@ -38,109 +33,43 @@ See: +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) +## Methods details: - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/Quotemeta.php#L15) ```php public function __invoke(string $text): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$text | [string](https://www.php.net/manual/en/language.types.string.php) | Processed text | -Parameters: +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstringProcessed text
    - -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/Quotemeta.php#L20) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/Quotemeta.php#L25) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/RemoveLineBrakes.md b/docs/tech/03_renderer/classes/RemoveLineBrakes.md index 6e98af5f..8e4a1cac 100644 --- a/docs/tech/03_renderer/classes/RemoveLineBrakes.md +++ b/docs/tech/03_renderer/classes/RemoveLineBrakes.md @@ -1,22 +1,20 @@ - BumbleDocGen / Technical description of the project / Renderer / Template filters / RemoveLineBrakes
    - -

    - RemoveLineBrakes class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template filters](/docs/tech/03_renderer/04_twigCustomFilters.md) **/** +RemoveLineBrakes +--- +# [RemoveLineBrakes](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/RemoveLineBrakes.php#L10) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Filter; final class RemoveLineBrakes implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface ``` - -
    The filter replaces all line breaks with a space
    - - +The filter replaces all line breaks with a space

    Settings:

    @@ -32,109 +30,43 @@ final class RemoveLineBrakes implements \BumbleDocGen\Core\Renderer\Twig\Filter\ +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) +## Methods details: - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/RemoveLineBrakes.php#L15) ```php public function __invoke(string $text): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$text | [string](https://www.php.net/manual/en/language.types.string.php) | Processed text | -Parameters: +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstringProcessed text
    - -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/RemoveLineBrakes.php#L20) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/RemoveLineBrakes.php#L25) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/RendererContext.md b/docs/tech/03_renderer/classes/RendererContext.md index 90e8f0a4..b29a2711 100644 --- a/docs/tech/03_renderer/classes/RendererContext.md +++ b/docs/tech/03_renderer/classes/RendererContext.md @@ -1,256 +1,111 @@ - BumbleDocGen / Technical description of the project / Renderer / RendererContext
    - -

    - RendererContext class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +RendererContext +--- +# [RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L12) class: ```php namespace BumbleDocGen\Core\Renderer\Context; final class RendererContext ``` +Document rendering context -
    Document rendering context
    - - - - - - - -

    Methods:

    - -
      -
    1. - addDependency -
    2. -
    3. - clearDependencies -
    4. -
    5. - getCurrentDocumentedEntityWrapper -
    6. -
    7. - getCurrentTemplateFilePatch - - Getting the path to the template file that is currently being worked on
    8. -
    9. - getDependencies -
    10. -
    11. - setCurrentDocumentedEntityWrapper -
    12. -
    13. - setCurrentTemplateFilePatch - - Saving the path to the template file that is currently being worked on in the context
    14. -
    - - +## Methods +1. [addDependency](#madddependency) +1. [clearDependencies](#mcleardependencies) +1. [getCurrentDocumentedEntityWrapper](#mgetcurrentdocumentedentitywrapper) +1. [getCurrentTemplateFilePatch](#mgetcurrenttemplatefilepatch) - Getting the path to the template file that is currently being worked on +1. [getDependencies](#mgetdependencies) +1. [setCurrentDocumentedEntityWrapper](#msetcurrentdocumentedentitywrapper) +1. [setCurrentTemplateFilePatch](#msetcurrenttemplatefilepatch) - Saving the path to the template file that is currently being worked on in the context +## Methods details: - - -

    Method details:

    - -
    - - - +# `addDependency` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L53) ```php public function addDependency(\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyInterface $dependency): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$dependency | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/Dependency/RendererDependencyInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $dependency\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyInterface-
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Return value: void - - -
    -
    -
    - - +--- +# `clearDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L48) ```php public function clearDependencies(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -
    -
    -
    - - - +# `getCurrentDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L43) ```php public function getCurrentDocumentedEntityWrapper(): null|\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper - - -
    -
    -
    - - - +# `getCurrentTemplateFilePatch` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L32) ```php public function getCurrentTemplateFilePatch(): string; ``` +Getting the path to the template file that is currently being worked on -
    Getting the path to the template file that is currently being worked on
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L58) ```php public function getDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `setCurrentDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L37) ```php public function setCurrentDocumentedEntityWrapper(\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper $currentDocumentedEntityWrapper): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$currentDocumentedEntityWrapper | [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $currentDocumentedEntityWrapper\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper-
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Return value: void - - -
    -
    -
    - - +--- +# `setCurrentTemplateFilePatch` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L24) ```php public function setCurrentTemplateFilePatch(string $currentTemplateFilePath): void; ``` +Saving the path to the template file that is currently being worked on in the context -
    Saving the path to the template file that is currently being worked on in the context
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $currentTemplateFilePathstring-
    +***Parameters:*** -Return value: void +| Name | Type | Description | +|:-|:-|:-| +$currentTemplateFilePath | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/RootEntityCollection.md b/docs/tech/03_renderer/classes/RootEntityCollection.md index 2ba67046..9edaf7f8 100644 --- a/docs/tech/03_renderer/classes/RootEntityCollection.md +++ b/docs/tech/03_renderer/classes/RootEntityCollection.md @@ -1,12 +1,13 @@ - BumbleDocGen / Technical description of the project / Renderer / Template functions / RootEntityCollection
    - -

    - RootEntityCollection class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +RootEntityCollection +--- +# [RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L18) class: ```php namespace BumbleDocGen\Core\Parser\Entity; @@ -14,548 +15,221 @@ namespace BumbleDocGen\Core\Parser\Entity; abstract class RootEntityCollection extends \BumbleDocGen\Core\Parser\Entity\BaseEntityCollection implements \IteratorAggregate ``` - - - - - - - - -

    Methods:

    - -
      -
    1. - findEntity - - Find an entity in a collection
    2. -
    3. - get - - Get an entity from a collection (only previously added)
    4. -
    5. - getEntityCollectionName - - Get collection name
    6. -
    7. - getEntityLinkData -
    8. -
    9. - getIterator -
    10. -
    11. - getLoadedOrCreateNew - - Get an entity from the collection or create a new one if it has not yet been added
    12. -
    13. - has - - Check if an entity has been added to the collection
    14. -
    15. - isEmpty - - Check if the collection is empty or not
    16. -
    17. - loadEntities -
    18. -
    19. - loadEntitiesByConfiguration -
    20. -
    21. - remove - - Remove an entity from a collection
    22. -
    23. - removeAllNotLoadedEntities -
    24. -
    25. - toArray - - Convert collection to array
    26. -
    27. - updateEntitiesCache -
    28. -
    - - - - - - - -

    Method details:

    - -
    - - - +## Methods + +1. [findEntity](#mfindentity) - Find an entity in a collection +1. [get](#mget) - Get an entity from a collection (only previously added) +1. [getEntityCollectionName](#mgetentitycollectionname) - Get collection name +1. [getEntityLinkData](#mgetentitylinkdata) +1. [getIterator](#mgetiterator) +1. [getLoadedOrCreateNew](#mgetloadedorcreatenew) - Get an entity from the collection or create a new one if it has not yet been added +1. [has](#mhas) - Check if an entity has been added to the collection +1. [isEmpty](#misempty) - Check if the collection is empty or not +1. [loadEntities](#mloadentities) +1. [loadEntitiesByConfiguration](#mloadentitiesbyconfiguration) +1. [remove](#mremove) - Remove an entity from a collection +1. [removeAllNotLoadedEntities](#mremoveallnotloadedentities) +1. [toArray](#mtoarray) - Convert collection to array +1. [updateEntitiesCache](#mupdateentitiescache) + +## Methods details: + +# `findEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L76) ```php public function findEntity(string $search, bool $useUnsafeKeys = true): null|\BumbleDocGen\Core\Parser\Entity\RootEntityInterface; ``` +Find an entity in a collection -
    Find an entity in a collection
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $searchstring-
    $useUnsafeKeysbool-
    - -Return value: null | \BumbleDocGen\Core\Parser\Entity\RootEntityInterface - - -
    -
    -
    - - +***Parameters:*** -```php -public function get(string $objectName): null|\BumbleDocGen\Core\Parser\Entity\RootEntityInterface; -``` +| Name | Type | Description | +|:-|:-|:-| +$search | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$useUnsafeKeys | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -
    Get an entity from a collection (only previously added)
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) -Parameters: +--- - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    +# `get` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L49) +```php +public function get(string $objectName): null|\BumbleDocGen\Core\Parser\Entity\RootEntityInterface; +``` +Get an entity from a collection (only previously added) -Return value: null | \BumbleDocGen\Core\Parser\Entity\RootEntityInterface +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) - +--- +# `getEntityCollectionName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L39) ```php public function getEntityCollectionName(): string; ``` +Get collection name -
    Get collection name
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -
    -
    -
    - -
      -
    • # - getEntityLinkData - :warning: Is internal | source code
    • -
    +--- +# `getEntityLinkData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L90) ```php public function getEntityLinkData(string $rawLink, string|null $defaultEntityName = null, bool $useUnsafeKeys = true): array; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rawLink | [string](https://www.php.net/manual/en/language.types.string.php) | Raw link to an entity or entity element | +$defaultEntityName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Entity name to use if the link does not contain a valid or existing entity name, + but only a cursor on an entity element | +$useUnsafeKeys | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rawLinkstringRaw link to an entity or entity element
    $defaultEntityNamestring | nullEntity name to use if the link does not contain a valid or existing entity name, - but only a cursor on an entity element
    $useUnsafeKeysbool-
    - -Return value: array - - -
    -
    -
    - - +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- + +# `getIterator` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L11) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function getIterator(): \Generator; ``` +***Return value:*** [\Generator](https://www.php.net/manual/en/language.generators.overview.php) +--- -Parameters: not specified - -Return value: \Generator +# `getLoadedOrCreateNew` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L67) +```php +public function getLoadedOrCreateNew(string $objectName, bool $withAddClassEntityToCollectionEvent = false): \BumbleDocGen\Core\Parser\Entity\RootEntityInterface; +``` +Get an entity from the collection or create a new one if it has not yet been added +***Parameters:*** -
    -
    -
    +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$withAddClassEntityToCollectionEvent | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | - +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) -```php -public function getLoadedOrCreateNew(string $objectName, bool $withAddClassEntityToCollectionEvent = false): \BumbleDocGen\Core\Parser\Entity\RootEntityInterface; -``` +***Links:*** +- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](/docs/tech/03_renderer/classes/RootEntityInterface_2.md#misentitydatacanbeloaded) -
    Get an entity from the collection or create a new one if it has not yet been added
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    $withAddClassEntityToCollectionEventbool-
    - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityInterface - - - -See: - -
    -
    -
    - - +--- +# `has` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L42) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function has(string $objectName): bool; ``` +Check if an entity has been added to the collection -
    Check if an entity has been added to the collection
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isEmpty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L52) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function isEmpty(): bool; ``` +Check if the collection is empty or not -
    Check if the collection is empty or not
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `loadEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L28) ```php public function loadEntities(\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection $sourceLocatorsCollection, \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface|null $filters = null, \BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface|null $progressBar = null): \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$sourceLocatorsCollection | [\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/SourceLocatorsCollection.php) | - | +$filters | [\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | +$progressBar | [\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntitiesLoaderProgressBarInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $sourceLocatorsCollection\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection-
    $filters\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface | null-
    $progressBar\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface | null-
    - -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult - - -
    -
    -
    - - +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionLoadEntitiesResult.php) +--- + +# `loadEntitiesByConfiguration` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L26) ```php public function loadEntitiesByConfiguration(\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface|null $progressBar = null): \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$progressBar | [\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntitiesLoaderProgressBarInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $progressBar\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface | null-
    +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionLoadEntitiesResult.php) -Return value: \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult - - -
    -
    -
    - - +--- +# `remove` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L32) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection public function remove(string $objectName): void; ``` +Remove an entity from a collection -
    Remove an entity from a collection
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $objectNamestring-
    +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Return value: void +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -
    -
    -
    - - - +# `removeAllNotLoadedEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L132) ```php public function removeAllNotLoadedEntities(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -
    -
    -
    - - - +# `toArray` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L127) ```php public function toArray(): array; ``` +Convert collection to array -
    Convert collection to array
    - -Parameters: not specified - -Return value: array +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -
    -
    -
    - -
      -
    • # - updateEntitiesCache - :warning: Is internal | source code
    • -
    - +# `updateEntitiesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L97) ```php public function updateEntitiesCache(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/RootEntityInterface.md b/docs/tech/03_renderer/classes/RootEntityInterface.md index d1d84406..04300e3f 100644 --- a/docs/tech/03_renderer/classes/RootEntityInterface.md +++ b/docs/tech/03_renderer/classes/RootEntityInterface.md @@ -1,469 +1,218 @@ - BumbleDocGen / Technical description of the project / Renderer / Template functions / RootEntityInterface
    - -

    - RootEntityInterface class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +RootEntityInterface +--- +# [RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L11) class: ```php namespace BumbleDocGen\Core\Parser\Entity; interface RootEntityInterface extends \BumbleDocGen\Core\Parser\Entity\EntityInterface ``` +Since the documentation generator supports several programming languages, +their entities need to correspond to the same interfaces -
    Since the documentation generator supports several programming languages, -their entities need to correspond to the same interfaces
    - - - - - - - -

    Methods:

    - -
      -
    1. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    2. -
    3. - getEntityDependencies -
    4. -
    5. - getFileContent -
    6. -
    7. - getFileSourceLink -
    8. -
    9. - getName - - Full name of the entity
    10. -
    11. - getObjectId - - Entity object ID
    12. -
    13. - getRelativeFileName - - File name relative to project_root configuration parameter
    14. -
    15. - getRootEntityCollection - - Get parent collection of entities
    16. -
    17. - getShortName - - Short name of the entity
    18. -
    19. - isEntityCacheOutdated -
    20. -
    21. - isEntityDataCanBeLoaded - - Checking if it is possible to get the entity data
    22. -
    23. - isEntityNameValid - - Check if entity name is valid
    24. -
    25. - isExternalLibraryEntity - - The entity is loaded from a third party library and should not be treated the same as a standard one
    26. -
    27. - isInGit - - The entity file is in the git repository
    28. -
    29. - normalizeClassName -
    30. -
    +## Methods +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getEntityDependencies](#mgetentitydependencies) +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getName](#mgetname) - Full name of the entity +1. [getObjectId](#mgetobjectid) - Entity object ID +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get parent collection of entities +1. [getShortName](#mgetshortname) - Short name of the entity +1. [isEntityCacheOutdated](#misentitycacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) - Checking if it is possible to get the entity data +1. [isEntityNameValid](#misentitynamevalid) - Check if entity name is valid +1. [isExternalLibraryEntity](#misexternallibraryentity) - The entity is loaded from a third party library and should not be treated the same as a standard one +1. [isInGit](#misingit) - The entity file is in the git repository +1. [normalizeClassName](#mnormalizeclassname) +## Methods details: - - - - -

    Method details:

    - -
    - - - +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L53) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L33) ```php public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L40) ```php public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getFileSourceLink` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L42) ```php public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L30) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L16) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getObjectId(): string; ``` +Entity object ID -
    Entity object ID
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -
    -
    -
    - - +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L46) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/03_renderer/classes/Configuration.md#mgetprojectroot) +--- - -See: - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getRootEntityCollection(): \BumbleDocGen\Core\Parser\Entity\RootEntityCollection; ``` +Get parent collection of entities -
    Get parent collection of entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityCollection +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) +--- -
    -
    -
    - - - +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L37) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L58) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function isEntityCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L23) ```php public function isEntityDataCanBeLoaded(): bool; ``` +Checking if it is possible to get the entity data -
    Checking if it is possible to get the entity data
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L18) ```php public static function isEntityNameValid(string $entityName): bool; ``` +Check if entity name is valid -
    Check if entity name is valid
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isExternalLibraryEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L28) ```php public function isExternalLibraryEntity(): bool; ``` +The entity is loaded from a third party library and should not be treated the same as a standard one -
    The entity is loaded from a third party library and should not be treated the same as a standard one
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInGit` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L38) ```php public function isInGit(): bool; ``` +The entity file is in the git repository -
    The entity file is in the git repository
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L13) ```php public static function normalizeClassName(string $name): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/RootEntityInterface_2.md b/docs/tech/03_renderer/classes/RootEntityInterface_2.md index 2e9bf66c..2de3adf4 100644 --- a/docs/tech/03_renderer/classes/RootEntityInterface_2.md +++ b/docs/tech/03_renderer/classes/RootEntityInterface_2.md @@ -1,469 +1,217 @@ - BumbleDocGen / Technical description of the project / Renderer / RootEntityInterface
    - -

    - RootEntityInterface class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +RootEntityInterface +--- +# [RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L11) class: ```php namespace BumbleDocGen\Core\Parser\Entity; interface RootEntityInterface extends \BumbleDocGen\Core\Parser\Entity\EntityInterface ``` +Since the documentation generator supports several programming languages, +their entities need to correspond to the same interfaces -
    Since the documentation generator supports several programming languages, -their entities need to correspond to the same interfaces
    - - - - - - - -

    Methods:

    - -
      -
    1. - getAbsoluteFileName - - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    2. -
    3. - getEntityDependencies -
    4. -
    5. - getFileContent -
    6. -
    7. - getFileSourceLink -
    8. -
    9. - getName - - Full name of the entity
    10. -
    11. - getObjectId - - Entity object ID
    12. -
    13. - getRelativeFileName - - File name relative to project_root configuration parameter
    14. -
    15. - getRootEntityCollection - - Get parent collection of entities
    16. -
    17. - getShortName - - Short name of the entity
    18. -
    19. - isEntityCacheOutdated -
    20. -
    21. - isEntityDataCanBeLoaded - - Checking if it is possible to get the entity data
    22. -
    23. - isEntityNameValid - - Check if entity name is valid
    24. -
    25. - isExternalLibraryEntity - - The entity is loaded from a third party library and should not be treated the same as a standard one
    26. -
    27. - isInGit - - The entity file is in the git repository
    28. -
    29. - normalizeClassName -
    30. -
    +## Methods +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getEntityDependencies](#mgetentitydependencies) +1. [getFileContent](#mgetfilecontent) +1. [getFileSourceLink](#mgetfilesourcelink) +1. [getName](#mgetname) - Full name of the entity +1. [getObjectId](#mgetobjectid) - Entity object ID +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get parent collection of entities +1. [getShortName](#mgetshortname) - Short name of the entity +1. [isEntityCacheOutdated](#misentitycacheoutdated) +1. [isEntityDataCanBeLoaded](#misentitydatacanbeloaded) - Checking if it is possible to get the entity data +1. [isEntityNameValid](#misentitynamevalid) - Check if entity name is valid +1. [isExternalLibraryEntity](#misexternallibraryentity) - The entity is loaded from a third party library and should not be treated the same as a standard one +1. [isInGit](#misingit) - The entity file is in the git repository +1. [normalizeClassName](#mnormalizeclassname) +## Methods details: - - - - -

    Method details:

    - -
    - - - +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L53) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getAbsoluteFileName(): null|string; ``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -
    Returns the absolute path to a file if it can be retrieved and if the file is in the project directory
    - -Parameters: not specified - -Return value: null | string - +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getEntityDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L33) ```php public function getEntityDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getFileContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L40) ```php public function getFileContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getFileSourceLink` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L42) ```php public function getFileSourceLink(bool $withLine = true): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $withLinebool-
    - -Return value: null | string - - -
    -
    -
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L30) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getName(): string; ``` +Full name of the entity -
    Full name of the entity
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L16) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getObjectId(): string; ``` +Entity object ID -
    Entity object ID
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -
    -
    -
    - - +--- +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L46) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getRelativeFileName(): null|string; ``` +File name relative to project_root configuration parameter -
    File name relative to project_root configuration parameter
    - -Parameters: not specified +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/03_renderer/classes/Configuration.md#mgetprojectroot) +--- - -See: - -
    -
    -
    - - - +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L23) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getRootEntityCollection(): \BumbleDocGen\Core\Parser\Entity\RootEntityCollection; ``` +Get parent collection of entities -
    Get parent collection of entities
    - -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityCollection +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) +--- -
    -
    -
    - - - +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L37) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function getShortName(): string; ``` +Short name of the entity -
    Short name of the entity
    - -Parameters: not specified - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - -
      -
    • # - isEntityCacheOutdated - :warning: Is internal | source code
    • -
    +--- +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L58) ```php // Implemented in BumbleDocGen\Core\Parser\Entity\EntityInterface public function isEntityCacheOutdated(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -
    -
    -
    - - - +# `isEntityDataCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L23) ```php public function isEntityDataCanBeLoaded(): bool; ``` +Checking if it is possible to get the entity data -
    Checking if it is possible to get the entity data
    - -Parameters: not specified - -Return value: bool - - -
    -
    -
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - +--- +# `isEntityNameValid` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L18) ```php public static function isEntityNameValid(string $entityName): bool; ``` +Check if entity name is valid -
    Check if entity name is valid
    +***Parameters:*** -Parameters: +| Name | Type | Description | +|:-|:-|:-| +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entityNamestring-
    +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -Return value: bool - - -
    -
    -
    - - +--- +# `isExternalLibraryEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L28) ```php public function isExternalLibraryEntity(): bool; ``` +The entity is loaded from a third party library and should not be treated the same as a standard one -
    The entity is loaded from a third party library and should not be treated the same as a standard one
    - -Parameters: not specified - -Return value: bool +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -
    -
    -
    - - - +# `isInGit` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L38) ```php public function isInGit(): bool; ``` +The entity file is in the git repository -
    The entity file is in the git repository
    - -Parameters: not specified - -Return value: bool - +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) -
    -
    -
    - - +--- +# `normalizeClassName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php#L13) ```php public static function normalizeClassName(string $name): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/StrTypeToUrl.md b/docs/tech/03_renderer/classes/StrTypeToUrl.md index 19669341..117ee51b 100644 --- a/docs/tech/03_renderer/classes/StrTypeToUrl.md +++ b/docs/tech/03_renderer/classes/StrTypeToUrl.md @@ -1,28 +1,23 @@ - BumbleDocGen / Technical description of the project / Renderer / Template filters / StrTypeToUrl
    - -

    - StrTypeToUrl class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Renderer](/docs/tech/03_renderer/readme.md) **/** +[Template filters](/docs/tech/03_renderer/04_twigCustomFilters.md) **/** +StrTypeToUrl +--- +# [StrTypeToUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php#L18) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Filter; final class StrTypeToUrl implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface ``` +The filter converts the string with the data type into a link to the documented entity, if possible. -
    The filter converts the string with the data type into a link to the documented entity, if possible.
    - -See: - - - +***Links:*** +- [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](/docs/tech/03_renderer/classes/GetDocumentedEntityUrl_2.md)

    Settings:

    @@ -38,178 +33,65 @@ See: +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php#L20) ```php public function __construct(\BumbleDocGen\Core\Renderer\RendererHelper $rendererHelper, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \Monolog\Logger $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rendererHelper | [\BumbleDocGen\Core\Renderer\RendererHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/RendererHelper.php) | - | +$getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | +$logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/Monolog/Logger.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rendererHelper\BumbleDocGen\Core\Renderer\RendererHelper-
    $getDocumentedEntityUrlFunction\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl-
    $logger\Monolog\Logger-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php#L50) ```php -public function __invoke(string $text, \BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, bool $useShortLinkVersion = false, bool $createDocument = false): string; +public function __invoke(string $text, \BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, bool $useShortLinkVersion = false, bool $createDocument = false, string $separator = ' | '): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$text | [string](https://www.php.net/manual/en/language.types.string.php) | Processed text | +$rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | - | +$useShortLinkVersion | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Shorten or not the link name. When shortening, only the shortName of the entity will be shown | +$createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | If true, creates an entity document. Otherwise, just gives a reference to the entity code | +$separator | [string](https://www.php.net/manual/en/language.types.string.php) | Separator between types | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstringProcessed text
    $rootEntityCollection\BumbleDocGen\Core\Parser\Entity\RootEntityCollection-
    $useShortLinkVersionboolShorten or not the link name. When shortening, only the shortName of the entity will be shown
    $createDocumentboolIf true, creates an entity document. Otherwise, just gives a reference to the entity code
    - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php#L27) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php#L32) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/03_renderer/classes/TextToCodeBlock.md b/docs/tech/03_renderer/classes/TextToCodeBlock.md deleted file mode 100644 index 60d661ef..00000000 --- a/docs/tech/03_renderer/classes/TextToCodeBlock.md +++ /dev/null @@ -1,145 +0,0 @@ - BumbleDocGen / Technical description of the project / Renderer / Template filters / TextToCodeBlock
    - -

    - TextToCodeBlock class: -

    - - - - - -```php -namespace BumbleDocGen\Core\Renderer\Twig\Filter; - -final class TextToCodeBlock implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface -``` - -
    Convert text to code block
    - - - - -

    Settings:

    - - - - - - - - - - -
    namevalue
    Filter name:textToCodeBlock
    - - - - - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - -```php -public function __invoke(string $text, string $codeBlockType): string; -``` - - - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstringProcessed text
    $codeBlockTypestringCode block type (e.g. php or console )
    - -Return value: string - - -
    -
    -
    - - - -```php -public static function getName(): string; -``` - - - -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - -```php -public static function getOptions(): array; -``` - - - -Parameters: not specified - -Return value: array - - -
    -
    diff --git a/docs/tech/03_renderer/classes/TextToHeading.md b/docs/tech/03_renderer/classes/TextToHeading.md deleted file mode 100644 index e0b5cf0a..00000000 --- a/docs/tech/03_renderer/classes/TextToHeading.md +++ /dev/null @@ -1,145 +0,0 @@ - BumbleDocGen / Technical description of the project / Renderer / Template filters / TextToHeading
    - -

    - TextToHeading class: -

    - - - - - -```php -namespace BumbleDocGen\Core\Renderer\Twig\Filter; - -final class TextToHeading implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface -``` - -
    Convert text to html header
    - - - - -

    Settings:

    - - - - - - - - - - -
    namevalue
    Filter name:textToHeading
    - - - - - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - -```php -public function __invoke(string $text, string $headingType): string; -``` - - - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstring-
    $headingTypestringChoose heading type: H1, H2, H3
    - -Return value: string - - -
    -
    -
    - - - -```php -public static function getName(): string; -``` - - - -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - -```php -public static function getOptions(): array; -``` - - - -Parameters: not specified - -Return value: array - - -
    -
    diff --git a/docs/tech/03_renderer/readme.md b/docs/tech/03_renderer/readme.md index 63222f4f..409048ca 100644 --- a/docs/tech/03_renderer/readme.md +++ b/docs/tech/03_renderer/readme.md @@ -1,6 +1,11 @@ - BumbleDocGen / Technical description of the project / Renderer
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +Renderer -

    Documentation renderer

    +--- + + +# Documentation renderer Render passes through all files from the directory specified in configuration param `templates_dir` @@ -8,21 +13,29 @@ If the file ends with **.twig** then the file is processed, otherwise it is simp to the target directory obtained from configuration param `output_dir`. We use twig to process templates. -

    More detailed description of renderer components

    +## More detailed description of renderer components + - +- [How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) + - [Front Matter](/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md) + - [Templates dynamic blocks](/docs/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md) + - [Linking templates](/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md) + - [Templates variables](/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md) +- [Documentation structure and breadcrumbs](/docs/tech/03_renderer/02_breadcrumbs.md) +- [Document structure of generated entities](/docs/tech/03_renderer/03_documentStructure.md) +- [Template filters](/docs/tech/03_renderer/04_twigCustomFilters.md) +- [Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) -

    Starting the rendering process

    +## Starting the rendering process ```php - $renderer = new Renderer(...); - - // Starting the process of filling templates with data and saving finished documents - $renderer->run(); -``` +$renderer = new Renderer(...); +// Starting the process of filling templates with data and saving finished documents +$renderer->run(); +``` -

    How it works

    +## How it works The process of rendering documents is divided into several stages. We separately generate documentation for templates that were pre-prepared by the user, and then create documentation for classes that the user refers to from document templates. @@ -58,6 +71,6 @@ This process is presented in the form of a diagram below. style EntityProcessing stroke:#f66,stroke-width:2px,color:#fff,stroke-dasharray: 5 5 ``` -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Fri Jan 12 18:53:16 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/04_pluginSystem.md b/docs/tech/04_pluginSystem.md index d9276374..c946ab08 100644 --- a/docs/tech/04_pluginSystem.md +++ b/docs/tech/04_pluginSystem.md @@ -1,12 +1,17 @@ - BumbleDocGen / Technical description of the project / Plugin system
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +Plugin system -

    Plugin system

    +--- + + +# Plugin system The documentation generator includes the ability to expand the functionality using plugins that allow you to add the necessary functionality to the system without changing its core. -The system is built on the basis of an event model, each plugin class must implement PluginInterface. +The system is built on the basis of an event model, each plugin class must implement [a]PluginInterface[/a]. -

    Configuration example

    +## Configuration example You can add your plugins to the configuration like this: @@ -16,163 +21,47 @@ plugins: - class: \SelfDocConfig\Plugin\TwigFunctionClassParser\TwigFunctionClassParserPlugin ``` -

    Default plugins

    +## Default plugins Below are the plugins that are available by default when working with the library. Plugins for any programming languages work regardless of which language handler is configured in the configuration. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    PluginPLHandles eventsDescription
    LastPageCommitterany - - Plugin for adding a block with information about the last commit and date of page update to the generated document
    PageHtmlLinkerPluginany - - Adds URLs to empty links in HTML format; - Links may contain: - 1) Short entity name - 2) Full entity name - 3) Relative link to the entity file from the root directory of the project - 4) Page title ( title ) - 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) - 6) Relative reference to the entity document from the root directory of the documentation
    PageLinkerPluginany - - Adds URLs to empty links in HTML format; - Links may contain: - 1) Short entity name - 2) Full entity name - 3) Relative link to the entity file from the root directory of the project - 4) Page title ( title ) - 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) - 6) Relative reference to the entity document from the root directory of the documentation
    PageRstLinkerPluginany - - Adds URLs to empty links in rst format; - Links may contain: - 1) Short entity name - 2) Full entity name - 3) Relative link to the entity file from the root directory of the project - 4) Page title ( title ) - 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) - 6) Relative reference to the entity document from the root directory of the documentation
    BasePhpStubberPluginPHP - - Adding links to type documentation and documentation of built-in PHP classes
    PhpDocumentorStubberPluginPHP - - Adding links to the documentation of PHP classes in the \phpDocumentor namespace
    PhpUnitStubberPluginPHP - - Adding links to the documentation of PHP classes in the \PHPUnit namespace
    StubberPluginPHP - - The plugin allows you to automatically provide links to github repositories for documented classes from libraries included in composer
    DauxPHP - -
    EntityDocUnifiedPlacePluginPHP - - This plugin changes the algorithm for saving entity documents. The standard system stores each file -in a directory next to the file where it was requested. This behavior changes and all documents are saved -in a separate directory structure, so they are not duplicated.
    - -

    Default events

    - - - -

    Adding a new plugin

    +| Plugin | PL | Handles events | Description | +|-|-|-|-| +| LastPageCommitter | any |
    • [BeforeCreatingDocFile](/docs/tech/classes/BeforeCreatingDocFile.md)
    | Plugin for adding a block with information about the last commit and date of page update to the generated document | +| PageHtmlLinkerPlugin | any |
    • [BeforeCreatingDocFile](/docs/tech/classes/BeforeCreatingDocFile.md)
    | Adds URLs to empty links in HTML format; Links may contain: 1) Short entity name 2) Full entity name 3) Relative link to the entity file from the root directory of the project 4) Page title ( title ) 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) 6) Relative reference to the entity document from the root directory of the documentation | +| PageLinkerPlugin | any |
    • [BeforeCreatingDocFile](/docs/tech/classes/BeforeCreatingDocFile.md)
    | Adds URLs to empty links in MD format; Links may contain: 1) Short entity name 2) Full entity name 3) Relative link to the entity file from the root directory of the project 4) Page title ( title ) 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) 6) Relative reference to the entity document from the root directory of the documentation | +| PageRstLinkerPlugin | any |
    • [BeforeCreatingDocFile](/docs/tech/classes/BeforeCreatingDocFile.md)
    | Adds URLs to empty links in rst format; Links may contain: 1) Short entity name 2) Full entity name 3) Relative link to the entity file from the root directory of the project 4) Page title ( title ) 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) 6) Relative reference to the entity document from the root directory of the documentation | +| BasePhpStubberPlugin | PHP |
    • [OnGettingResourceLink](/docs/tech/classes/OnGettingResourceLink.md)
    • [OnCheckIsEntityCanBeLoaded](/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md)
    | Adding links to type documentation and documentation of built-in PHP classes | +| PhpDocumentorStubberPlugin | PHP |
    • [OnGettingResourceLink](/docs/tech/classes/OnGettingResourceLink.md)
    • [OnCheckIsEntityCanBeLoaded](/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md)
    | Adding links to the documentation of PHP classes in the \phpDocumentor namespace | +| PhpUnitStubberPlugin | PHP |
    • [OnGettingResourceLink](/docs/tech/classes/OnGettingResourceLink.md)
    • [OnCheckIsEntityCanBeLoaded](/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md)
    | Adding links to the documentation of PHP classes in the \PHPUnit namespace | +| StubberPlugin | PHP |
    • [OnGettingResourceLink](/docs/tech/classes/OnGettingResourceLink.md)
    • [OnCheckIsEntityCanBeLoaded](/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md)
    | The plugin allows you to automatically provide links to github repositories for documented classes from libraries included in composer | +| Daux | PHP |
    • [OnCreateDocumentedEntityWrapper](/docs/tech/classes/OnCreateDocumentedEntityWrapper.md)
    • [OnGetTemplatePathByRelativeDocPath](/docs/tech/classes/OnGetTemplatePathByRelativeDocPath.md)
    • [OnGetProjectTemplatesDirs](/docs/tech/classes/OnGetProjectTemplatesDirs.md)
    • [BeforeCreatingDocFile](/docs/tech/classes/BeforeCreatingDocFile.md)
    • [BeforeCreatingEntityDocFile](/docs/tech/classes/BeforeCreatingEntityDocFile.md)
    • [AfterRenderingEntities](/docs/tech/classes/AfterRenderingEntities.md)
    | | +| EntityDocUnifiedPlacePlugin | PHP |
    • [OnCreateDocumentedEntityWrapper](/docs/tech/classes/OnCreateDocumentedEntityWrapper.md)
    • [OnGetTemplatePathByRelativeDocPath](/docs/tech/classes/OnGetTemplatePathByRelativeDocPath.md)
    • [OnGetProjectTemplatesDirs](/docs/tech/classes/OnGetProjectTemplatesDirs.md)
    | This plugin changes the algorithm for saving entity documents. The standard system stores each file in a directory next to the file where it was requested. This behavior changes and all documents are saved in a separate directory structure, so they are not duplicated. | + +## Default events + +- [BeforeParsingProcess](/docs/tech/classes/BeforeParsingProcess.md) +- [AfterRenderingEntities](/docs/tech/classes/AfterRenderingEntities.md) +- [BeforeCreatingDocFile](/docs/tech/classes/BeforeCreatingDocFile.md) - Called before the content of the documentation document is saved to a file +- [BeforeCreatingEntityDocFile](/docs/tech/classes/BeforeCreatingEntityDocFile.md) +- [BeforeRenderingDocFiles](/docs/tech/classes/BeforeRenderingDocFiles.md) - The event occurs before the main documents begin rendering +- [BeforeRenderingEntities](/docs/tech/classes/BeforeRenderingEntities.md) - The event occurs before the rendering of entity documents begins, after the main documents have been created +- [OnCreateDocumentedEntityWrapper](/docs/tech/classes/OnCreateDocumentedEntityWrapper.md) - The event occurs when an entity is added to the list for documentation +- [OnGetProjectTemplatesDirs](/docs/tech/classes/OnGetProjectTemplatesDirs.md) - This event occurs when all directories containing document templates are retrieved +- [OnGetTemplatePathByRelativeDocPath](/docs/tech/classes/OnGetTemplatePathByRelativeDocPath.md) - The event occurs when the path to the template file is obtained relative to the path to the document +- [OnGettingResourceLink](/docs/tech/classes/OnGettingResourceLink.md) - Event occurs when a reference to an entity (resource) is received +- [OnLoadEntityDocPluginContent](/docs/tech/classes/OnLoadEntityDocPluginContent.md) - Called when entity documentation is generated (plugin content loading) +- [OnCheckIsEntityCanBeLoaded](/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md) +- [AfterLoadingPhpEntitiesCollection](/docs/tech/classes/AfterLoadingPhpEntitiesCollection.md) - The event is called after the initial creation of a collection of PHP entities +- [OnAddClassEntityToCollection](/docs/tech/classes/OnAddClassEntityToCollection.md) - Called when each class entity is added to the entity collection + + +## Adding a new plugin If you decide to add a new plugin, there are a few things you need to do: -

    1) Add plugin class and implement events handling

    +### 1) Add plugin class and implement events handling ```php namespace Demo\Plugin\DemoFakeResourceLinkPlugin; @@ -195,7 +84,7 @@ final class DemoFakeResourceLinkPlugin implements \BumbleDocGen\Core\Plugin\Plug } ``` -

    2) Add the new plugin to the configuration

    +### 2) Add the new plugin to the configuration ```yaml plugins: @@ -203,6 +92,6 @@ plugins: ``` -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Wed Jan 10 23:55:33 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 17:19:08 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/05_console.md b/docs/tech/05_console.md index bcc4148b..43c7a01a 100644 --- a/docs/tech/05_console.md +++ b/docs/tech/05_console.md @@ -1,8 +1,13 @@ - BumbleDocGen / Technical description of the project / Console app
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +Console app -

    Console app

    +--- -The documentation generator provides the ability to work through a built-in console application. + +# Console app + +The documentation generator provides the ability to work through a built-in [console application](/docs/tech/classes/App.md). It is available via composer: ```console vendor/bin/bumbleDocGen list @@ -10,58 +15,25 @@ vendor/bin/bumbleDocGen list We use [Symfony Console](https://github.com/symfony/console) as the basis of the console application. -

    Built-in console commands

    +## Built-in console commands - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    CommandParametersDescription
    help[--format FORMAT]
    [--raw]
    [<command_name>]
    Display help for a command
    list[--raw]
    [--format FORMAT]
    [--short]
    [<namespace>]
    List commands
    generate[--as-html]
    [--project_root [PROJECT_ROOT]]
    [--templates_dir [TEMPLATES_DIR]]
    [--output_dir [OUTPUT_DIR]]
    [--cache_dir [CACHE_DIR]]
    [--use_shared_cache [USE_SHARED_CACHE]]
    Generate documentation
    serve[--as-html]
    [--dev-server-host [DEV-SERVER-HOST]]
    [--dev-server-port [DEV-SERVER-PORT]]
    [--project_root [PROJECT_ROOT]]
    [--templates_dir [TEMPLATES_DIR]]
    [--use_shared_cache [USE_SHARED_CACHE]]
    Serve documentation
    ai:generate-readme-template[--project_root [PROJECT_ROOT]]
    [--templates_dir [TEMPLATES_DIR]]
    [--cache_dir [CACHE_DIR]]
    [--ai_provider [AI_PROVIDER]]
    [--ai_api_key [AI_API_KEY]]
    [--ai_model [AI_MODEL]]
    Leverage AI to generate content for a project readme.md file.
    ai:add-doc-blocks[--project_root [PROJECT_ROOT]]
    [--templates_dir [TEMPLATES_DIR]]
    [--cache_dir [CACHE_DIR]]
    [--ai_provider [AI_PROVIDER]]
    [--ai_api_key [AI_API_KEY]]
    [--ai_model [AI_MODEL]]
    Leverage AI to insert missing doc blocks in code.
    configuration[<key>]Display list of configured plugins, programming language handlers, etc
    +| Command | Parameters | Description | +|-|-|-| +| [help](https://github.com/symfony/console/blob/master/Command/HelpCommand.php) | [--format FORMAT]
    [--raw]
    [<command_name>] | Display help for a command | +| [list](https://github.com/symfony/console/blob/master/Command/ListCommand.php) | [--raw]
    [--format FORMAT]
    [--short]
    [<namespace>] | List commands | +| [generate](/docs/tech/classes/GenerateCommand.md) | [--as-html]
    [--project_root [PROJECT_ROOT]]
    [--templates_dir [TEMPLATES_DIR]]
    [--output_dir [OUTPUT_DIR]]
    [--cache_dir [CACHE_DIR]]
    [--use_shared_cache [USE_SHARED_CACHE]] | Generate documentation | +| [serve](/docs/tech/classes/ServeCommand.md) | [--as-html]
    [--dev-server-host [DEV-SERVER-HOST]]
    [--dev-server-port [DEV-SERVER-PORT]]
    [--project_root [PROJECT_ROOT]]
    [--templates_dir [TEMPLATES_DIR]]
    [--use_shared_cache [USE_SHARED_CACHE]] | Serve documentation | +| [ai:generate-readme-template](/docs/tech/classes/GenerateReadMeTemplateCommand.md) | [--project_root [PROJECT_ROOT]]
    [--templates_dir [TEMPLATES_DIR]]
    [--cache_dir [CACHE_DIR]]
    [--ai_provider [AI_PROVIDER]]
    [--ai_api_key [AI_API_KEY]]
    [--ai_model [AI_MODEL]] | Leverage AI to generate content for a project readme.md file. | +| [ai:add-doc-blocks](/docs/tech/classes/AddDocBlocksCommand.md) | [--project_root [PROJECT_ROOT]]
    [--templates_dir [TEMPLATES_DIR]]
    [--cache_dir [CACHE_DIR]]
    [--ai_provider [AI_PROVIDER]]
    [--ai_api_key [AI_API_KEY]]
    [--ai_model [AI_MODEL]] | Leverage AI to insert missing doc blocks in code. | +| [configuration](/docs/tech/classes/ConfigurationCommand.md) | [<key>] | Display list of configured plugins, programming language handlers, etc | -

    Adding a custom command

    +## Adding a custom command The system allows you to add custom commands to a standard console application. -This can be done using a special configuration option additional_console_commands (see Configuration page). +This can be done using a special configuration option [additional_console_commands](/docs/tech/classes/Configuration.md#mgetadditionalconsolecommands) (see [Configuration](/docs/tech/01_configuration.md) page). After adding a new command to the configuration, it will be available in the application. Each added command must inherit the `\Symfony\Component\Console\Command\Command` class -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Thu Jan 11 13:50:48 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 17:19:08 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/06_debugging.md b/docs/tech/06_debugging.md index 7fa6640b..3d8e362b 100644 --- a/docs/tech/06_debugging.md +++ b/docs/tech/06_debugging.md @@ -1,6 +1,11 @@ - BumbleDocGen / Technical description of the project / Debug documents
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +Debug documents -

    Debug documents

    +--- + + +# Debug documents Our tool provides several options for debugging documentation. @@ -20,6 +25,6 @@ Our tool provides several options for debugging documentation. 3) Logs are saved to a special file `last_run.log` which is located in the working directory -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Fri Jan 12 01:11:04 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/07_outputFormat.md b/docs/tech/07_outputFormat.md index c36f6c2b..1e4a7451 100644 --- a/docs/tech/07_outputFormat.md +++ b/docs/tech/07_outputFormat.md @@ -1,11 +1,16 @@ - BumbleDocGen / Technical description of the project / Output formats
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +Output formats -

    Output formats

    +--- + + +# Output formats At the moment, the documentation generator is focused on creating documentation in two formats: [GitHub Flavored Markdown](https://github.github.com/gfm/) and HTML. However, it is possible to create other files with some restrictions. -1) Creating **GFM** documentation is possible both using a console application and using the built-in commands of the documentation generator. +1) Creating **GFM** documentation is possible both using a [console application](/docs/tech/05_console.md) and using the [built-in commands](/docs/tech/classes/DocGenerator.md#mgenerate) of the documentation generator. * Generate GFM doc by console command: ```bash @@ -24,7 +29,7 @@ However, it is possible to create other files with some restrictions. (new DocGeneratorFactory())->create($configFile)->serve(); ``` -2) Creating **HTML** documentation is only possible through a console application. The [Daux.io](https://daux.io/) library is used to generate HTML pages. +2) Creating **HTML** documentation is only possible through a [console application](/docs/tech/05_console.md). The [Daux.io](https://daux.io/) library is used to generate HTML pages. * Generate HTML doc by console command: ```bash # Generate static HTML files ( see {output_dir}/html) @@ -35,6 +40,6 @@ However, it is possible to create other files with some restrictions. ``` -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Fri Jan 12 18:54:20 2024 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/classes/AddDocBlocksCommand.md b/docs/tech/classes/AddDocBlocksCommand.md index 63cd8403..e1379352 100644 --- a/docs/tech/classes/AddDocBlocksCommand.md +++ b/docs/tech/classes/AddDocBlocksCommand.md @@ -1,12 +1,12 @@ - BumbleDocGen / Technical description of the project / Console app / AddDocBlocksCommand
    - -

    - AddDocBlocksCommand class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Console app](/docs/tech/05_console.md) **/** +AddDocBlocksCommand +--- +# [AddDocBlocksCommand](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/AI/Console/AddDocBlocksCommand.php#L17) class: ```php namespace BumbleDocGen\AI\Console; @@ -14,78 +14,27 @@ namespace BumbleDocGen\AI\Console; final class AddDocBlocksCommand extends \BumbleDocGen\Console\Command\BaseCommand ``` +## Initialization methods +1. [__construct](#m-construct) +## Traits: +1. [\BumbleDocGen\AI\Traits\SharedCommandLogicTrait](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/AI/Traits/SharedCommandLogicTrait.php) +## Methods details: - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - - -

    Traits:

    - - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/Command/BaseCommand.php#L21) ```php // Implemented in BumbleDocGen\Console\Command\BaseCommand public function __construct(string $name = null); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    - - - -
    -
    +--- diff --git a/docs/tech/classes/AddIndentFromLeft.md b/docs/tech/classes/AddIndentFromLeft.md index 28632e5e..ed916eb6 100644 --- a/docs/tech/classes/AddIndentFromLeft.md +++ b/docs/tech/classes/AddIndentFromLeft.md @@ -1,22 +1,19 @@ - BumbleDocGen / Technical description of the project / Configuration / AddIndentFromLeft
    - -

    - AddIndentFromLeft class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +AddIndentFromLeft +--- +# [AddIndentFromLeft](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/AddIndentFromLeft.php#L10) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Filter; final class AddIndentFromLeft implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface ``` - -
    Filter adds indent from left
    - - +Filter adds indent from left

    Settings:

    @@ -32,119 +29,45 @@ final class AddIndentFromLeft implements \BumbleDocGen\Core\Renderer\Twig\Filter +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) +## Methods details: - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/AddIndentFromLeft.php#L18) ```php public function __invoke(string $text, int $identLength = 4, bool $skipFirstIdent = false): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$text | [string](https://www.php.net/manual/en/language.types.string.php) | Processed text | +$identLength | [int](https://www.php.net/manual/en/language.types.integer.php) | Indent size | +$skipFirstIdent | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Skip indent for first line in text or not | -Parameters: +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstringProcessed text
    $identLengthintIndent size
    $skipFirstIdentboolSkip indent for first line in text or not
    - -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/AddIndentFromLeft.php#L24) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/AddIndentFromLeft.php#L29) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/AfterLoadingPhpEntitiesCollection.md b/docs/tech/classes/AfterLoadingPhpEntitiesCollection.md index 966601ce..261e94f9 100644 --- a/docs/tech/classes/AfterLoadingPhpEntitiesCollection.md +++ b/docs/tech/classes/AfterLoadingPhpEntitiesCollection.md @@ -1,105 +1,47 @@ - BumbleDocGen / Technical description of the project / Plugin system / AfterLoadingPhpEntitiesCollection
    - -

    - AfterLoadingPhpEntitiesCollection class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +AfterLoadingPhpEntitiesCollection +--- +# [AfterLoadingPhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Parser/AfterLoadingPhpEntitiesCollection.php#L13) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Plugin\Event\Parser; final class AfterLoadingPhpEntitiesCollection extends \Symfony\Contracts\EventDispatcher\Event ``` +The event is called after the initial creation of a collection of PHP entities -
    The event is called after the initial creation of a collection of PHP entities
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getPhpEntitiesCollection -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [getPhpEntitiesCollection](#mgetphpentitiescollection) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Parser/AfterLoadingPhpEntitiesCollection.php#L15) ```php public function __construct(\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection $entitiesCollection); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entitiesCollection | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entitiesCollection\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection-
    - - - -
    -
    -
    - - +--- +# `getPhpEntitiesCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Parser/AfterLoadingPhpEntitiesCollection.php#L19) ```php public function getPhpEntitiesCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) - -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -
    -
    +--- diff --git a/docs/tech/classes/AfterRenderingEntities.md b/docs/tech/classes/AfterRenderingEntities.md index 3c6ad6c5..e05e71e6 100644 --- a/docs/tech/classes/AfterRenderingEntities.md +++ b/docs/tech/classes/AfterRenderingEntities.md @@ -1,12 +1,12 @@ - BumbleDocGen / Technical description of the project / Plugin system / AfterRenderingEntities
    - -

    - AfterRenderingEntities class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +AfterRenderingEntities +--- +# [AfterRenderingEntities](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/AfterRenderingEntities.php#L9) class: ```php namespace BumbleDocGen\Core\Plugin\Event\Renderer; @@ -15,17 +15,3 @@ final class AfterRenderingEntities extends \Symfony\Contracts\EventDispatcher\Ev ``` - - - - - - - - - - - - - - diff --git a/docs/tech/classes/App.md b/docs/tech/classes/App.md index 9983c68f..09ef0dd5 100644 --- a/docs/tech/classes/App.md +++ b/docs/tech/classes/App.md @@ -1,12 +1,12 @@ - BumbleDocGen / Technical description of the project / Console app / App
    - -

    - App class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Console app](/docs/tech/05_console.md) **/** +App +--- +# [App](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/App.php#L20) class: ```php namespace BumbleDocGen\Console; @@ -14,47 +14,15 @@ namespace BumbleDocGen\Console; class App extends \Symfony\Component\Console\Application ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods details: - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/App.php#L22) ```php public function __construct(); ``` - - -Parameters: not specified - - - -
    -
    +--- diff --git a/docs/tech/classes/BasePageLinkProcessor.md b/docs/tech/classes/BasePageLinkProcessor.md index 99837dc9..63ca546a 100644 --- a/docs/tech/classes/BasePageLinkProcessor.md +++ b/docs/tech/classes/BasePageLinkProcessor.md @@ -1,12 +1,12 @@ - BumbleDocGen / Technical description of the project / Configuration / BasePageLinkProcessor
    - -

    - BasePageLinkProcessor class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +BasePageLinkProcessor +--- +# [BasePageLinkProcessor](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/PageLinkProcessor/BasePageLinkProcessor.php#L9) class: ```php namespace BumbleDocGen\Core\Renderer\PageLinkProcessor; @@ -14,109 +14,39 @@ namespace BumbleDocGen\Core\Renderer\PageLinkProcessor; class BasePageLinkProcessor implements \BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [getAbsoluteUrl](#mgetabsoluteurl) +## Methods details: - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getAbsoluteUrl -
    2. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/PageLinkProcessor/BasePageLinkProcessor.php#L11) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    - - - -
    -
    -
    - - +--- +# `getAbsoluteUrl` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/PageLinkProcessor/BasePageLinkProcessor.php#L15) ```php public function getAbsoluteUrl(string $relativeUrl): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$relativeUrl | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $relativeUrlstring-
    - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    +--- diff --git a/docs/tech/classes/BasePhpStubberPlugin.md b/docs/tech/classes/BasePhpStubberPlugin.md index 73144fff..21bf5ea9 100644 --- a/docs/tech/classes/BasePhpStubberPlugin.md +++ b/docs/tech/classes/BasePhpStubberPlugin.md @@ -1,143 +1,63 @@ - BumbleDocGen / Technical description of the project / Plugin system / BasePhpStubberPlugin
    - -

    - BasePhpStubberPlugin class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +BasePhpStubberPlugin +--- +# [BasePhpStubberPlugin](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/BasePhpStubber/BasePhpStubberPlugin.php#L15) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Plugin\CorePlugin\BasePhpStubber; final class BasePhpStubberPlugin implements \BumbleDocGen\Core\Plugin\PluginInterface, \Symfony\Component\EventDispatcher\EventSubscriberInterface ``` +Adding links to type documentation and documentation of built-in PHP classes -
    Adding links to type documentation and documentation of built-in PHP classes
    - - - - - - - -

    Methods:

    - -
      -
    1. - getSubscribedEvents -
    2. -
    3. - onCheckIsEntityCanBeLoaded -
    4. -
    5. - onGettingResourceLink -
    6. -
    - - - - - +## Methods +1. [getSubscribedEvents](#mgetsubscribedevents) +1. [onCheckIsEntityCanBeLoaded](#moncheckisentitycanbeloaded) +1. [onGettingResourceLink](#mongettingresourcelink) -

    Method details:

    - -
    - - +## Methods details: +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/BasePhpStubber/BasePhpStubberPlugin.php#L146) ```php public static function getSubscribedEvents(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `onCheckIsEntityCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/BasePhpStubber/BasePhpStubberPlugin.php#L169) ```php public function onCheckIsEntityCanBeLoaded(\BumbleDocGen\LanguageHandler\Php\Plugin\Event\Entity\OnCheckIsEntityCanBeLoaded $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\LanguageHandler\Php\Plugin\Event\Entity\OnCheckIsEntityCanBeLoaded](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Entity/OnCheckIsEntityCanBeLoaded.php) | - | -Parameters: +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\LanguageHandler\Php\Plugin\Event\Entity\OnCheckIsEntityCanBeLoaded-
    - -Return value: void - - -
    -
    -
    - - +--- +# `onGettingResourceLink` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/BasePhpStubber/BasePhpStubberPlugin.php#L154) ```php public function onGettingResourceLink(\BumbleDocGen\Core\Plugin\Event\Renderer\OnGettingResourceLink $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\OnGettingResourceLink](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGettingResourceLink.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\OnGettingResourceLink-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/classes/BeforeCreatingDocFile.md b/docs/tech/classes/BeforeCreatingDocFile.md index 82c24d16..a28a9055 100644 --- a/docs/tech/classes/BeforeCreatingDocFile.md +++ b/docs/tech/classes/BeforeCreatingDocFile.md @@ -1,216 +1,90 @@ - BumbleDocGen / Technical description of the project / Plugin system / BeforeCreatingDocFile
    - -

    - BeforeCreatingDocFile class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +BeforeCreatingDocFile +--- +# [BeforeCreatingDocFile](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingDocFile.php#L12) class: ```php namespace BumbleDocGen\Core\Plugin\Event\Renderer; final class BeforeCreatingDocFile extends \Symfony\Contracts\EventDispatcher\Event ``` +Called before the content of the documentation document is saved to a file -
    Called before the content of the documentation document is saved to a file
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    +## Initialization methods -
      -
    1. - getContent -
    2. -
    3. - getOutputFilePatch -
    4. -
    5. - setContent -
    6. -
    7. - setOutputFilePatch -
    8. -
    +1. [__construct](#m-construct) +## Methods +1. [getContent](#mgetcontent) +1. [getOutputFilePatch](#mgetoutputfilepatch) +1. [setContent](#msetcontent) +1. [setOutputFilePatch](#msetoutputfilepatch) +## Methods details: - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingDocFile.php#L14) ```php public function __construct(string $content, string $outputFilePatch); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$content | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$outputFilePatch | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $contentstring-
    $outputFilePatchstring-
    - - - -
    -
    -
    - - +--- +# `getContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingDocFile.php#L20) ```php public function getContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOutputFilePatch` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingDocFile.php#L30) ```php public function getOutputFilePatch(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `setContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingDocFile.php#L25) ```php public function setContent(string $content): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$content | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $contentstring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - - +--- +# `setOutputFilePatch` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingDocFile.php#L35) ```php public function setOutputFilePatch(string $outputFilePatch): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$outputFilePatch | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $outputFilePatchstring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/classes/BeforeCreatingEntityDocFile.md b/docs/tech/classes/BeforeCreatingEntityDocFile.md index 7271253d..da8a3ca1 100644 --- a/docs/tech/classes/BeforeCreatingEntityDocFile.md +++ b/docs/tech/classes/BeforeCreatingEntityDocFile.md @@ -1,12 +1,12 @@ - BumbleDocGen / Technical description of the project / Plugin system / BeforeCreatingEntityDocFile
    - -

    - BeforeCreatingEntityDocFile class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +BeforeCreatingEntityDocFile +--- +# [BeforeCreatingEntityDocFile](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingEntityDocFile.php#L9) class: ```php namespace BumbleDocGen\Core\Plugin\Event\Renderer; @@ -14,203 +14,76 @@ namespace BumbleDocGen\Core\Plugin\Event\Renderer; final class BeforeCreatingEntityDocFile extends \Symfony\Contracts\EventDispatcher\Event ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [getContent](#mgetcontent) +1. [getOutputFilePatch](#mgetoutputfilepatch) +1. [setContent](#msetcontent) +1. [setOutputFilePatch](#msetoutputfilepatch) +## Methods details: - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getContent -
    2. -
    3. - getOutputFilePatch -
    4. -
    5. - setContent -
    6. -
    7. - setOutputFilePatch -
    8. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingEntityDocFile.php#L11) ```php public function __construct(string $content, string $outputFilePatch); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$content | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$outputFilePatch | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $contentstring-
    $outputFilePatchstring-
    - - - -
    -
    -
    - - +--- +# `getContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingEntityDocFile.php#L17) ```php public function getContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOutputFilePatch` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingEntityDocFile.php#L27) ```php public function getOutputFilePatch(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `setContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingEntityDocFile.php#L22) ```php public function setContent(string $content): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$content | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $contentstring-
    - -Return value: void +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -
    -
    -
    - - - +# `setOutputFilePatch` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingEntityDocFile.php#L32) ```php public function setOutputFilePatch(string $outputFilePatch): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$outputFilePatch | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $outputFilePatchstring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/classes/BeforeParsingProcess.md b/docs/tech/classes/BeforeParsingProcess.md index 17b80f01..2f1a2e57 100644 --- a/docs/tech/classes/BeforeParsingProcess.md +++ b/docs/tech/classes/BeforeParsingProcess.md @@ -1,12 +1,12 @@ - BumbleDocGen / Technical description of the project / Plugin system / BeforeParsingProcess
    - -

    - BeforeParsingProcess class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +BeforeParsingProcess +--- +# [BeforeParsingProcess](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Parser/BeforeParsingProcess.php#L9) class: ```php namespace BumbleDocGen\Core\Plugin\Event\Parser; @@ -14,47 +14,15 @@ namespace BumbleDocGen\Core\Plugin\Event\Parser; final class BeforeParsingProcess extends \Symfony\Contracts\EventDispatcher\Event ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods details: - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Parser/BeforeParsingProcess.php#L11) ```php public function __construct(); ``` - - -Parameters: not specified - - - -
    -
    +--- diff --git a/docs/tech/classes/BeforeRenderingDocFiles.md b/docs/tech/classes/BeforeRenderingDocFiles.md index 7a23f72c..cfb20b2c 100644 --- a/docs/tech/classes/BeforeRenderingDocFiles.md +++ b/docs/tech/classes/BeforeRenderingDocFiles.md @@ -1,31 +1,18 @@ - BumbleDocGen / Technical description of the project / Plugin system / BeforeRenderingDocFiles
    - -

    - BeforeRenderingDocFiles class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +BeforeRenderingDocFiles +--- +# [BeforeRenderingDocFiles](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeRenderingDocFiles.php#L12) class: ```php namespace BumbleDocGen\Core\Plugin\Event\Renderer; final class BeforeRenderingDocFiles extends \Symfony\Contracts\EventDispatcher\Event ``` - -
    The event occurs before the main documents begin rendering
    - - - - - - - - - - - - +The event occurs before the main documents begin rendering diff --git a/docs/tech/classes/BeforeRenderingEntities.md b/docs/tech/classes/BeforeRenderingEntities.md index 1647e0f6..5d28cfad 100644 --- a/docs/tech/classes/BeforeRenderingEntities.md +++ b/docs/tech/classes/BeforeRenderingEntities.md @@ -1,31 +1,18 @@ - BumbleDocGen / Technical description of the project / Plugin system / BeforeRenderingEntities
    - -

    - BeforeRenderingEntities class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +BeforeRenderingEntities +--- +# [BeforeRenderingEntities](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeRenderingEntities.php#L12) class: ```php namespace BumbleDocGen\Core\Plugin\Event\Renderer; final class BeforeRenderingEntities extends \Symfony\Contracts\EventDispatcher\Event ``` - -
    The event occurs before the rendering of entity documents begins, after the main documents have been created
    - - - - - - - - - - - - +The event occurs before the rendering of entity documents begins, after the main documents have been created diff --git a/docs/tech/classes/Configuration.md b/docs/tech/classes/Configuration.md index e8777dd1..39ff4250 100644 --- a/docs/tech/classes/Configuration.md +++ b/docs/tech/classes/Configuration.md @@ -1,763 +1,245 @@ - BumbleDocGen / Technical description of the project / Console app / Configuration
    - -

    - Configuration class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Console app](/docs/tech/05_console.md) **/** +Configuration +--- +# [Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L30) class: ```php namespace BumbleDocGen\Core\Configuration; final class Configuration ``` - -
    Configuration project documentation
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getAdditionalConsoleCommands -
    2. -
    3. - getCacheDir -
    4. -
    5. - getConfigurationVersion -
    6. -
    7. - getDocGenLibDir -
    8. -
    9. - getGitClientPath -
    10. -
    11. - getIfExists -
    12. -
    13. - getLanguageHandlersCollection -
    14. -
    15. - getOutputDir -
    16. -
    17. - getOutputDirBaseUrl -
    18. -
    19. - getPageLinkProcessor -
    20. -
    21. - getPlugins -
    22. -
    23. - getProjectRoot -
    24. -
    25. - getSourceLocators -
    26. -
    27. - getTemplatesDir -
    28. -
    29. - getTwigFilters -
    30. -
    31. - getTwigFunctions -
    32. -
    33. - getWorkingDir -
    34. -
    35. - isCheckFileInGitBeforeCreatingDocEnabled -
    36. -
    37. - renderWithFrontMatter -
    38. -
    39. - useSharedCache -
    40. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +Configuration project documentation + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [getAdditionalConsoleCommands](#mgetadditionalconsolecommands) +1. [getCacheDir](#mgetcachedir) +1. [getConfigurationVersion](#mgetconfigurationversion) +1. [getDocGenLibDir](#mgetdocgenlibdir) +1. [getGitClientPath](#mgetgitclientpath) +1. [getIfExists](#mgetifexists) +1. [getLanguageHandlersCollection](#mgetlanguagehandlerscollection) +1. [getOutputDir](#mgetoutputdir) +1. [getOutputDirBaseUrl](#mgetoutputdirbaseurl) +1. [getPageLinkProcessor](#mgetpagelinkprocessor) +1. [getPlugins](#mgetplugins) +1. [getProjectRoot](#mgetprojectroot) +1. [getSourceLocators](#mgetsourcelocators) +1. [getTemplatesDir](#mgettemplatesdir) +1. [getTwigFilters](#mgettwigfilters) +1. [getTwigFunctions](#mgettwigfunctions) +1. [getWorkingDir](#mgetworkingdir) +1. [isCheckFileInGitBeforeCreatingDocEnabled](#mischeckfileingitbeforecreatingdocenabled) +1. [renderWithFrontMatter](#mrenderwithfrontmatter) +1. [useSharedCache](#musesharedcache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L34) ```php public function __construct(\BumbleDocGen\Core\Configuration\ConfigurationParameterBag $parameterBag, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$parameterBag | [\BumbleDocGen\Core\Configuration\ConfigurationParameterBag](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/ConfigurationParameterBag.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parameterBag\BumbleDocGen\Core\Configuration\ConfigurationParameterBag-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `getAdditionalConsoleCommands` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L377) ```php public function getAdditionalConsoleCommands(): \BumbleDocGen\Console\Command\AdditionalCommandCollection; ``` +***Return value:*** [\BumbleDocGen\Console\Command\AdditionalCommandCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/Command/AdditionalCommandCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Console\Command\AdditionalCommandCollection - - -Throws: - - -
    -
    -
    - - - +# `getCacheDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L205) ```php public function getCacheDir(): null|string; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: null | string - - -Throws: - - -
    -
    -
    - - - +# `getConfigurationVersion` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L42) ```php public function getConfigurationVersion(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getDocGenLibDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L367) ```php public function getDocGenLibDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getGitClientPath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L256) ```php public function getGitClientPath(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getIfExists` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L395) ```php public function getIfExists(mixed $key): null|string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keymixed-
    +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) -Return value: null | string - - -Throws: - - -
    -
    -
    - - +--- +# `getLanguageHandlersCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L166) ```php public function getLanguageHandlersCollection(): \BumbleDocGen\LanguageHandler\LanguageHandlersCollection; ``` +***Return value:*** [\BumbleDocGen\LanguageHandler\LanguageHandlersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/LanguageHandlersCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\LanguageHandlersCollection - - -Throws: - - -
    -
    -
    - - - +# `getOutputDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L112) ```php public function getOutputDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getOutputDirBaseUrl` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L150) ```php public function getOutputDirBaseUrl(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getPageLinkProcessor` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L238) ```php public function getPageLinkProcessor(): \BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/PageLinkProcessor/PageLinkProcessorInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface - - -Throws: - - -
    -
    -
    - - - +# `getPlugins` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L187) ```php public function getPlugins(): \BumbleDocGen\Core\Plugin\PluginsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Plugin\PluginsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Plugin\PluginsCollection - - -Throws: - - -
    -
    -
    - - - +# `getProjectRoot` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L50) ```php public function getProjectRoot(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getSourceLocators` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L66) ```php public function getSourceLocators(): \BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/SourceLocatorsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection - - -Throws: - - -
    -
    -
    - - - +# `getTemplatesDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L84) ```php public function getTemplatesDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - - - +# `getTwigFilters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L295) ```php public function getTwigFilters(): \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/CustomFiltersCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection - - -Throws: - - -
    -
    -
    - - - +# `getTwigFunctions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L272) ```php public function getTwigFunctions(): \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/CustomFunctionsCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection - - -Throws: - - -
    -
    -
    - - - +# `getWorkingDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L358) ```php public function getWorkingDir(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -Throws: - - -
    -
    -
    - -
      -
    • # - isCheckFileInGitBeforeCreatingDocEnabled - | source code
    • -
    - +# `isCheckFileInGitBeforeCreatingDocEnabled` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L344) ```php public function isCheckFileInGitBeforeCreatingDocEnabled(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `renderWithFrontMatter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L330) ```php public function renderWithFrontMatter(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) +--- -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    -
    - - - +# `useSharedCache` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L316) ```php public function useSharedCache(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - -Parameters: not specified - -Return value: bool - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/classes/ConfigurationCommand.md b/docs/tech/classes/ConfigurationCommand.md index d398575c..801c9627 100644 --- a/docs/tech/classes/ConfigurationCommand.md +++ b/docs/tech/classes/ConfigurationCommand.md @@ -1,12 +1,12 @@ - BumbleDocGen / Technical description of the project / Console app / ConfigurationCommand
    - -

    - ConfigurationCommand class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Console app](/docs/tech/05_console.md) **/** +ConfigurationCommand +--- +# [ConfigurationCommand](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/Command/ConfigurationCommand.php#L14) class: ```php namespace BumbleDocGen\Console\Command; @@ -14,66 +14,23 @@ namespace BumbleDocGen\Console\Command; final class ConfigurationCommand extends \BumbleDocGen\Console\Command\BaseCommand ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods details: - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/Command/BaseCommand.php#L21) ```php // Implemented in BumbleDocGen\Console\Command\BaseCommand public function __construct(string $name = null); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    - - - -
    -
    +--- diff --git a/docs/tech/classes/Daux.md b/docs/tech/classes/Daux.md index 9f6f0b59..5ebe40e3 100644 --- a/docs/tech/classes/Daux.md +++ b/docs/tech/classes/Daux.md @@ -1,319 +1,121 @@ - BumbleDocGen / Technical description of the project / Plugin system / Daux
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +Daux -

    - Daux class: -

    +--- - - -:warning: Is internal +# [Daux](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L21) class: +⚠️ Internal ```php namespace BumbleDocGen\LanguageHandler\Php\Plugin\CorePlugin\Daux; final class Daux implements \BumbleDocGen\Core\Plugin\PluginInterface, \Symfony\Component\EventDispatcher\EventSubscriberInterface ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [afterRenderingEntities](#mafterrenderingentities) +1. [beforeCreatingDocFile](#mbeforecreatingdocfile) +1. [getSubscribedEvents](#mgetsubscribedevents) +1. [onCreateDocumentedEntityWrapper](#moncreatedocumentedentitywrapper) +1. [onGetProjectTemplatesDirs](#mongetprojecttemplatesdirs) +1. [onGetTemplatePathByRelativeDocPath](#mongettemplatepathbyrelativedocpath) +## Methods details: - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - afterRenderingEntities -
    2. -
    3. - beforeCreatingDocFile -
    4. -
    5. - getSubscribedEvents -
    6. -
    7. - onCreateDocumentedEntityWrapper -
    8. -
    9. - onGetProjectTemplatesDirs -
    10. -
    11. - onGetTemplatePathByRelativeDocPath -
    12. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L26) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    - - - -
    -
    -
    - - +--- +# `afterRenderingEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L95) ```php public function afterRenderingEntities(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - - - +# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L47) ```php public function beforeCreatingDocFile(\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile|\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingEntityDocFile $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingDocFile.php) \| [\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingEntityDocFile](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingEntityDocFile.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile | \BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingEntityDocFile-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Throws: - - -
    -
    -
    - - +--- +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L32) ```php public static function getSubscribedEvents(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `onCreateDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L71) ```php public function onCreateDocumentedEntityWrapper(\BumbleDocGen\Core\Plugin\Event\Renderer\OnCreateDocumentedEntityWrapper $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\OnCreateDocumentedEntityWrapper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnCreateDocumentedEntityWrapper.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\OnCreateDocumentedEntityWrapper-
    - -Return value: void +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -
    -
    -
    - - - +# `onGetProjectTemplatesDirs` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L87) ```php public function onGetProjectTemplatesDirs(\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetProjectTemplatesDirs $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetProjectTemplatesDirs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGetProjectTemplatesDirs.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetProjectTemplatesDirs-
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Return value: void - - -
    -
    -
    - - +--- +# `onGetTemplatePathByRelativeDocPath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L78) ```php public function onGetTemplatePathByRelativeDocPath(\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetTemplatePathByRelativeDocPath $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetTemplatePathByRelativeDocPath](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGetTemplatePathByRelativeDocPath.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetTemplatePathByRelativeDocPath-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/classes/DocGenerator.md b/docs/tech/classes/DocGenerator.md index 9fb2b361..b795b419 100644 --- a/docs/tech/classes/DocGenerator.md +++ b/docs/tech/classes/DocGenerator.md @@ -1,577 +1,175 @@ - BumbleDocGen / Technical description of the project / Output formats / DocGenerator
    - -

    - DocGenerator class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Output formats](/docs/tech/07_outputFormat.md) **/** +DocGenerator +--- +# [DocGenerator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L46) class: ```php namespace BumbleDocGen; final class DocGenerator ``` +Class for generating documentation. -
    Class for generating documentation.
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - addDocBlocks - - Generate missing docBlocks with LLM for project class methods that are available for documentation
    2. -
    3. - addPlugin -
    4. -
    5. - generate - - Generates documentation using configuration
    6. -
    7. - generateReadmeTemplate - - Creates a `README.md` template filled with basic information using LLM
    8. -
    9. - getConfiguration -
    10. -
    11. - getConfigurationKey -
    12. -
    13. - getConfigurationKeys -
    14. -
    15. - parseAndGetRootEntityCollectionsGroup -
    16. -
    17. - serve - - Serve documentation
    18. -
    +## Initialization methods +1. [__construct](#m-construct) +## Methods -

    Constants:

    - +1. [addDocBlocks](#madddocblocks) - Generate missing docBlocks with LLM for project class methods that are available for documentation +1. [addPlugin](#maddplugin) +1. [generate](#mgenerate) - Generates documentation using configuration +1. [generateReadmeTemplate](#mgeneratereadmetemplate) - Creates a `README.md` template filled with basic information using LLM +1. [getConfiguration](#mgetconfiguration) +1. [getConfigurationKey](#mgetconfigurationkey) +1. [getConfigurationKeys](#mgetconfigurationkeys) +1. [parseAndGetRootEntityCollectionsGroup](#mparseandgetrootentitycollectionsgroup) +1. [serve](#mserve) - Serve documentation +## Methods details: - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L56) ```php public function __construct(\Symfony\Component\Console\Style\OutputStyle $io, \BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Plugin\PluginEventDispatcher $pluginEventDispatcher, \BumbleDocGen\Core\Parser\ProjectParser $parser, \BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper $parserHelper, \BumbleDocGen\Core\Renderer\Renderer $renderer, \BumbleDocGen\Core\Logger\Handler\GenerationErrorsHandler $generationErrorsHandler, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Console\ProgressBar\ProgressBarFactory $progressBarFactory, \DI\Container $diContainer, \BumbleDocGen\Core\Cache\SharedCompressedDocumentFileCache $sharedCompressedDocumentFileCache, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Monolog\Logger $logger); ``` - - -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $io\Symfony\Component\Console\Style\OutputStyle-
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $pluginEventDispatcher\BumbleDocGen\Core\Plugin\PluginEventDispatcher-
    $parser\BumbleDocGen\Core\Parser\ProjectParser-
    $parserHelper\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper-
    $renderer\BumbleDocGen\Core\Renderer\Renderer-
    $generationErrorsHandler\BumbleDocGen\Core\Logger\Handler\GenerationErrorsHandler-
    $rootEntityCollectionsGroup\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup-
    $progressBarFactory\BumbleDocGen\Console\ProgressBar\ProgressBarFactory-
    $diContainer\DI\Container-
    $sharedCompressedDocumentFileCache\BumbleDocGen\Core\Cache\SharedCompressedDocumentFileCache-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $logger\Monolog\Logger-
    - - - -Throws: - - -
    -
    -
    - - - +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$io | [\Symfony\Component\Console\Style\OutputStyle](https://github.com/symfony/console/blob/master/Style/OutputStyle.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$pluginEventDispatcher | [\BumbleDocGen\Core\Plugin\PluginEventDispatcher](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginEventDispatcher.php) | - | +$parser | [\BumbleDocGen\Core\Parser\ProjectParser](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/ProjectParser.php) | - | +$parserHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ParserHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ParserHelper.php) | - | +$renderer | [\BumbleDocGen\Core\Renderer\Renderer](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Renderer.php) | - | +$generationErrorsHandler | [\BumbleDocGen\Core\Logger\Handler\GenerationErrorsHandler](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Logger/Handler/GenerationErrorsHandler.php) | - | +$rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | +$progressBarFactory | [\BumbleDocGen\Console\ProgressBar\ProgressBarFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/ProgressBar/ProgressBarFactory.php) | - | +$diContainer | [\DI\Container](https://github.com/PHP-DI/PHP-DI/blob/master/src/Container.php) | - | +$sharedCompressedDocumentFileCache | [\BumbleDocGen\Core\Cache\SharedCompressedDocumentFileCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/SharedCompressedDocumentFileCache.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/Monolog/Logger.php) | - | + +--- + +# `addDocBlocks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L116) ```php public function addDocBlocks(\BumbleDocGen\AI\ProviderInterface $aiProvider): void; ``` +Generate missing docBlocks with LLM for project class methods that are available for documentation -
    Generate missing docBlocks with LLM for project class methods that are available for documentation
    - -Parameters: +***Parameters:*** - - - - - - - - - - - - - - - -
    NameTypeDescription
    $aiProvider\BumbleDocGen\AI\ProviderInterface-
    +| Name | Type | Description | +|:-|:-|:-| +$aiProvider | [\BumbleDocGen\AI\ProviderInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/AI/ProviderInterface.php) | - | -Return value: void +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Throws: - - -
    -
    -
    - - - +# `addPlugin` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L85) ```php public function addPlugin(\BumbleDocGen\Core\Plugin\PluginInterface|string $plugin): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$plugin | [\BumbleDocGen\Core\Plugin\PluginInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginInterface.php) \| [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $plugin\BumbleDocGen\Core\Plugin\PluginInterface | string-
    - -Return value: void - - -Throws: - - -
    -
    -
    - - +--- +# `generate` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L287) ```php public function generate(): void; ``` +Generates documentation using configuration -
    Generates documentation using configuration
    - -Parameters: not specified - -Return value: void - - -Throws: - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - - +--- +# `generateReadmeTemplate` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L200) ```php public function generateReadmeTemplate(\BumbleDocGen\AI\ProviderInterface $aiProvider): void; ``` +Creates a `README.md` template filled with basic information using LLM -
    Creates a `README.md` template filled with basic information using LLM
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $aiProvider\BumbleDocGen\AI\ProviderInterface-
    - -Return value: void - - -Throws: - - -
    -
    -
    - - +--- +# `getConfiguration` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L534) ```php public function getConfiguration(): \BumbleDocGen\Core\Configuration\Configuration; ``` +***Return value:*** [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Configuration\Configuration - - -
    -
    -
    - - - +# `getConfigurationKey` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L431) ```php public function getConfigurationKey(string $key): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystring-
    - -Return value: void - - -Throws: - - -
    -
    -
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - +--- +# `getConfigurationKeys` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L419) ```php public function getConfigurationKeys(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -Throws: - - -
    -
    -
    - -
      -
    • # - parseAndGetRootEntityCollectionsGroup - | source code
    • -
    - +# `parseAndGetRootEntityCollectionsGroup` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L100) ```php public function parseAndGetRootEntityCollectionsGroup(): \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup - - -Throws: - - -
    -
    -
    - - - +# `serve` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/DocGenerator.php#L340) ```php public function serve(callable|null $afterPreparation = null, callable|null $afterDocChanged = null, int $timeout = 1000000): void; ``` +Serve documentation + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$afterPreparation | [callable](https://www.php.net/manual/en/language.types.callable.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | +$afterDocChanged | [callable](https://www.php.net/manual/en/language.types.callable.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | +$timeout | [int](https://www.php.net/manual/en/language.types.integer.php) | - | + +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    Serve documentation
    - -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $afterPreparationcallable | null-
    $afterDocChangedcallable | null-
    $timeoutint-
    - -Return value: void - - -Throws: - - -
    -
    +--- diff --git a/docs/tech/classes/DocumentedEntityWrapper.md b/docs/tech/classes/DocumentedEntityWrapper.md index fa9c1245..949f6f9e 100644 --- a/docs/tech/classes/DocumentedEntityWrapper.md +++ b/docs/tech/classes/DocumentedEntityWrapper.md @@ -1,300 +1,128 @@ - BumbleDocGen / Technical description of the project / DocumentedEntityWrapper
    - -

    - DocumentedEntityWrapper class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +DocumentedEntityWrapper +--- +# [DocumentedEntityWrapper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L14) class: ```php namespace BumbleDocGen\Core\Renderer\Context; final class DocumentedEntityWrapper ``` +Wrapper for the entity that was requested for documentation -
    Wrapper for the entity that was requested for documentation
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getDocRender -
    2. -
    3. - getDocUrl - - Get the relative path to the document to be generated
    4. -
    5. - getDocumentTransformableEntity - - Get entity that is allowed to be documented
    6. -
    7. - getEntityName -
    8. -
    9. - getFileName - - The name of the file to be generated
    10. -
    11. - getKey - - Get document key
    12. -
    13. - getParentDocFilePath -
    14. -
    15. - setParentDocFilePath -
    16. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [getDocRender](#mgetdocrender) +1. [getDocUrl](#mgetdocurl) - Get the relative path to the document to be generated +1. [getDocumentTransformableEntity](#mgetdocumenttransformableentity) - Get entity that is allowed to be documented +1. [getEntityName](#mgetentityname) +1. [getFileName](#mgetfilename) - The name of the file to be generated +1. [getKey](#mgetkey) - Get document key +1. [getParentDocFilePath](#mgetparentdocfilepath) +1. [setParentDocFilePath](#msetparentdocfilepath) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L20) ```php public function __construct(\BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface $documentTransformableEntity, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, string $parentDocFilePath); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$documentTransformableEntity | [\BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentTransformableEntityInterface.php) | An entity that is allowed to be documented | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$parentDocFilePath | [string](https://www.php.net/manual/en/language.types.string.php) | The file in which the documentation of the entity was requested | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $documentTransformableEntity\BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterfaceAn entity that is allowed to be documented
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $parentDocFilePathstringThe file in which the documentation of the entity was requested
    - - - -
    -
    -
    - - +--- +# `getDocRender` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L27) ```php public function getDocRender(): \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/EntityDocRenderer/EntityDocRendererInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface - - -
    -
    -
    - - - +# `getDocUrl` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L88) ```php public function getDocUrl(): string; ``` +Get the relative path to the document to be generated -
    Get the relative path to the document to be generated
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getDocumentTransformableEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L80) ```php public function getDocumentTransformableEntity(): \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface; ``` +Get entity that is allowed to be documented -
    Get entity that is allowed to be documented
    +***Return value:*** [\BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentTransformableEntityInterface.php) -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface - - -
    -
    -
    - - +--- +# `getEntityName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L40) ```php public function getEntityName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L72) ```php public function getFileName(): string; ``` +The name of the file to be generated -
    The name of the file to be generated
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getKey` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L35) ```php public function getKey(): string; ``` +Get document key -
    Get document key
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Parameters: not specified - -Return value: string - - -
    -
    -
    - - +--- +# `getParentDocFilePath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L96) ```php public function getParentDocFilePath(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `setParentDocFilePath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php#L101) ```php public function setParentDocFilePath(string $parentDocFilePath): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$parentDocFilePath | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parentDocFilePathstring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/classes/DocumentedEntityWrappersCollection.md b/docs/tech/classes/DocumentedEntityWrappersCollection.md index e592e977..9a55c623 100644 --- a/docs/tech/classes/DocumentedEntityWrappersCollection.md +++ b/docs/tech/classes/DocumentedEntityWrappersCollection.md @@ -1,12 +1,11 @@ - BumbleDocGen / Technical description of the project / DocumentedEntityWrappersCollection
    - -

    - DocumentedEntityWrappersCollection class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +DocumentedEntityWrappersCollection +--- +# [DocumentedEntityWrappersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L14) class: ```php namespace BumbleDocGen\Core\Renderer\Context; @@ -14,203 +13,72 @@ namespace BumbleDocGen\Core\Renderer\Context; final class DocumentedEntityWrappersCollection implements \IteratorAggregate, \Countable ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [count](#mcount) +1. [createAndAddDocumentedEntityWrapper](#mcreateandadddocumentedentitywrapper) +1. [getDocumentedEntitiesRelations](#mgetdocumentedentitiesrelations) +1. [getIterator](#mgetiterator) +## Methods details: - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - count -
    2. -
    3. - createAndAddDocumentedEntityWrapper -
    4. -
    5. - getDocumentedEntitiesRelations -
    6. -
    7. - getIterator -
    8. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L21) ```php public function __construct(\BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Plugin\PluginEventDispatcher $pluginEventDispatcher); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rendererContext | [\BumbleDocGen\Core\Renderer\Context\RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$pluginEventDispatcher | [\BumbleDocGen\Core\Plugin\PluginEventDispatcher](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginEventDispatcher.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rendererContext\BumbleDocGen\Core\Renderer\Context\RendererContext-
    $localObjectCache\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache-
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $pluginEventDispatcher\BumbleDocGen\Core\Plugin\PluginEventDispatcher-
    - - - -
    -
    -
    - - +--- +# `count` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L76) ```php public function count(): int; ``` +***Return value:*** [int](https://www.php.net/manual/en/language.types.integer.php) +--- -Parameters: not specified - -Return value: int - - -
    -
    -
    - - - +# `createAndAddDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L42) ```php public function createAndAddDocumentedEntityWrapper(\BumbleDocGen\Core\Parser\Entity\RootEntityInterface $rootEntity): \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rootEntity | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rootEntity\BumbleDocGen\Core\Parser\Entity\RootEntityInterface-
    - -Return value: \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper - - -Throws: - - -
    -
    -
    +***Return value:*** [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php) - +--- +# `getDocumentedEntitiesRelations` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L71) ```php public function getDocumentedEntitiesRelations(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getIterator` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php#L29) ```php public function getIterator(): \Generator; ``` +***Return value:*** [\Generator](https://www.php.net/manual/en/language.generators.overview.php) - -Parameters: not specified - -Return value: \Generator - - -
    -
    +--- diff --git a/docs/tech/classes/DrawDocumentationMenu.md b/docs/tech/classes/DrawDocumentationMenu.md index fa98e83c..edae909a 100644 --- a/docs/tech/classes/DrawDocumentationMenu.md +++ b/docs/tech/classes/DrawDocumentationMenu.md @@ -1,54 +1,39 @@ - BumbleDocGen / Technical description of the project / Configuration / DrawDocumentationMenu
    - -

    - DrawDocumentationMenu class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +DrawDocumentationMenu +--- +# [DrawDocumentationMenu](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L29) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class DrawDocumentationMenu implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Generate documentation menu in MD format. To generate the menu, the start page is taken, +and all links with this page are recursively collected for it, after which the html menu is created. -
    Generate documentation menu in HTML format. To generate the menu, the start page is taken, -and all links with this page are recursively collected for it, after which the html menu is created.
    - -See: - - - -Examples of using: +***Links:*** +- [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](/docs/tech/classes/GetDocumentedEntityUrl_2.md) +***Examples of using:*** ```php {{ drawDocumentationMenu() }} - The menu contains links to all documents - ``` - ```php {{ drawDocumentationMenu('/render/index.md') }} - The menu contains links to all child documents from the /render/index.md file (for example /render/test/index.md) - ``` - ```php {{ drawDocumentationMenu(_self) }} - The menu contains links to all child documents from the file where this function was called - ``` - ```php {{ drawDocumentationMenu(_self, 2) }} - The menu contains links to all child documents from the file where this function was called, but no more than 2 in depth - ``` - -

    Settings:

    @@ -58,188 +43,65 @@ See:
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L31) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$rendererContext | [\BumbleDocGen\Core\Renderer\Context\RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php) | - | +$dependencyFactory | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/Dependency/RendererDependencyFactory.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $rendererContext\BumbleDocGen\Core\Renderer\Context\RendererContext-
    $dependencyFactory\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L64) ```php public function __invoke(string|null $startPageKey = null, int|null $maxDeep = null): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$startPageKey | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Relative path to the page from which the menu will be generated (only child pages will be taken into account). + By default, the main documentation page (readme.md) is used. | +$maxDeep | [int](https://www.php.net/manual/en/language.types.integer.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Maximum parsing depth of documented links starting from the current page. + By default, this restriction is disabled. | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $startPageKeystring | nullRelative path to the page from which the menu will be generated (only child pages will be taken into account). - By default, the main documentation page (readme.md) is used.
    $maxDeepint | nullMaximum parsing depth of documented links starting from the current page. - By default, this restriction is disabled.
    - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L39) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L44) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/DrawDocumentedEntityLink.md b/docs/tech/classes/DrawDocumentedEntityLink.md index ea1f469a..84f6518a 100644 --- a/docs/tech/classes/DrawDocumentedEntityLink.md +++ b/docs/tech/classes/DrawDocumentedEntityLink.md @@ -1,42 +1,32 @@ - BumbleDocGen / Technical description of the project / Configuration / DrawDocumentedEntityLink
    - -

    - DrawDocumentedEntityLink class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +DrawDocumentedEntityLink +--- +# [DrawDocumentedEntityLink](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php#L21) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class DrawDocumentedEntityLink implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Creates an entity link by object -
    Creates an entity link by object
    - - -Examples of using: - +***Examples of using:*** ```php {{ drawDocumentedEntityLink($entity, 'getFunctions()') }} - ``` - ```php {{ drawDocumentedEntityLink($entity) }} - ``` - ```php {{ drawDocumentedEntityLink($entity, '', false) }} - ``` - -

    Settings:

    @@ -46,176 +36,61 @@ final class DrawDocumentedEntityLink implements \BumbleDocGen\Core\Renderer\Twig
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php#L23) ```php public function __construct(\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $getDocumentedEntityUrlFunction\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php#L50) ```php public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityInterface $entity, string $cursor = '', bool $useShortName = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) | The entity for which we want to get the link | +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | Reference to an element inside an entity, for example, the name of a function/constant/property | +$useShortName | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Use the full or short entity name in the link | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\RootEntityInterfaceThe entity for which we want to get the link
    $cursorstringReference to an element inside an entity, for example, the name of a function/constant/property
    $useShortNameboolUse the full or short entity name in the link
    - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php#L27) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php#L32) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/EntityDocUnifiedPlacePlugin.md b/docs/tech/classes/EntityDocUnifiedPlacePlugin.md index f382d939..e190bd1e 100644 --- a/docs/tech/classes/EntityDocUnifiedPlacePlugin.md +++ b/docs/tech/classes/EntityDocUnifiedPlacePlugin.md @@ -1,193 +1,81 @@ - BumbleDocGen / Technical description of the project / Plugin system / EntityDocUnifiedPlacePlugin
    - -

    - EntityDocUnifiedPlacePlugin class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +EntityDocUnifiedPlacePlugin +--- +# [EntityDocUnifiedPlacePlugin](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php#L17) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Plugin\CorePlugin\EntityDocUnifiedPlace; final class EntityDocUnifiedPlacePlugin implements \BumbleDocGen\Core\Plugin\PluginInterface, \Symfony\Component\EventDispatcher\EventSubscriberInterface ``` - -
    This plugin changes the algorithm for saving entity documents. The standard system stores each file +This plugin changes the algorithm for saving entity documents. The standard system stores each file in a directory next to the file where it was requested. This behavior changes and all documents are saved -in a separate directory structure, so they are not duplicated.
    - - - - - - - -

    Methods:

    - -
      -
    1. - getSubscribedEvents -
    2. -
    3. - onCreateDocumentedEntityWrapper -
    4. -
    5. - onGetProjectTemplatesDirs -
    6. -
    7. - onGetTemplatePathByRelativeDocPath -
    8. -
    - - -

    Constants:

    - - - - - +in a separate directory structure, so they are not duplicated. -

    Method details:

    +## Methods -
    +1. [getSubscribedEvents](#mgetsubscribedevents) +1. [onCreateDocumentedEntityWrapper](#moncreatedocumentedentitywrapper) +1. [onGetProjectTemplatesDirs](#mongetprojecttemplatesdirs) +1. [onGetTemplatePathByRelativeDocPath](#mongettemplatepathbyrelativedocpath) - +## Methods details: +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php#L22) ```php public static function getSubscribedEvents(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `onCreateDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php#L31) ```php public function onCreateDocumentedEntityWrapper(\BumbleDocGen\Core\Plugin\Event\Renderer\OnCreateDocumentedEntityWrapper $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\OnCreateDocumentedEntityWrapper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnCreateDocumentedEntityWrapper.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\OnCreateDocumentedEntityWrapper-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - - +--- +# `onGetProjectTemplatesDirs` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php#L47) ```php public function onGetProjectTemplatesDirs(\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetProjectTemplatesDirs $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetProjectTemplatesDirs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGetProjectTemplatesDirs.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetProjectTemplatesDirs-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - - +--- +# `onGetTemplatePathByRelativeDocPath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php#L38) ```php public function onGetTemplatePathByRelativeDocPath(\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetTemplatePathByRelativeDocPath $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetTemplatePathByRelativeDocPath](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGetTemplatePathByRelativeDocPath.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetTemplatePathByRelativeDocPath-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/classes/FileGetContents.md b/docs/tech/classes/FileGetContents.md index 2a0337f8..05a9630f 100644 --- a/docs/tech/classes/FileGetContents.md +++ b/docs/tech/classes/FileGetContents.md @@ -1,43 +1,32 @@ - BumbleDocGen / Technical description of the project / Configuration / FileGetContents
    - -

    - FileGetContents class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +FileGetContents +--- +# [FileGetContents](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/FileGetContents.php#L17) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class FileGetContents implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Displaying the content of a file or web resource -
    Displaying the content of a file or web resource
    - -See: - - - -Examples of using: +***Links:*** +- [https://www.php.net/manual/en/function.file-get-contents.php](https://www.php.net/manual/en/function.file-get-contents.php) +***Examples of using:*** ```php {{ fileGetContents('https://www.php.net/manual/en/function.file-get-contents.php') }} - ``` - ```php {{ fileGetContents('%templates_dir%/../config.yaml') }} - ``` - -

    Settings:

    @@ -47,154 +36,60 @@ See:
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/FileGetContents.php#L19) ```php public function __construct(\BumbleDocGen\Core\Configuration\ConfigurationParameterBag $parameterBag); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$parameterBag | [\BumbleDocGen\Core\Configuration\ConfigurationParameterBag](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/ConfigurationParameterBag.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $parameterBag\BumbleDocGen\Core\Configuration\ConfigurationParameterBag-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/FileGetContents.php#L41) ```php public function __invoke(string $resourceName): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$resourceName | [string](https://www.php.net/manual/en/language.types.string.php) | Resource name, url or path to the resource. + The path can contain shortcodes with parameters from the configuration (%param_name%) | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $resourceNamestringResource name, url or path to the resource. - The path can contain shortcodes with parameters from the configuration (%param_name%)
    - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/FileGetContents.php#L23) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/FileGetContents.php#L28) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/FixStrSize.md b/docs/tech/classes/FixStrSize.md index 4592ad8c..6ab2f5b6 100644 --- a/docs/tech/classes/FixStrSize.md +++ b/docs/tech/classes/FixStrSize.md @@ -1,22 +1,19 @@ - BumbleDocGen / Technical description of the project / Configuration / FixStrSize
    - -

    - FixStrSize class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +FixStrSize +--- +# [FixStrSize](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/FixStrSize.php#L12) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Filter; final class FixStrSize implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface ``` - -
    The filter pads the string with the specified characters on the right to the specified size
    - - +The filter pads the string with the specified characters on the right to the specified size

    Settings:

    @@ -32,119 +29,45 @@ final class FixStrSize implements \BumbleDocGen\Core\Renderer\Twig\Filter\Custom +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) +## Methods details: - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/FixStrSize.php#L20) ```php public function __invoke(string $text, int $size, string $symbol = ' '): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$text | [string](https://www.php.net/manual/en/language.types.string.php) | Processed text | +$size | [int](https://www.php.net/manual/en/language.types.integer.php) | Required string size | +$symbol | [string](https://www.php.net/manual/en/language.types.string.php) | The character to be used to complete the string | -Parameters: +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstringProcessed text
    $sizeintRequired string size
    $symbolstringThe character to be used to complete the string
    - -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/FixStrSize.php#L31) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/FixStrSize.php#L36) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/GenerateCommand.md b/docs/tech/classes/GenerateCommand.md index a4a8406b..185c075e 100644 --- a/docs/tech/classes/GenerateCommand.md +++ b/docs/tech/classes/GenerateCommand.md @@ -1,12 +1,12 @@ - BumbleDocGen / Technical description of the project / Console app / GenerateCommand
    - -

    - GenerateCommand class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Console app](/docs/tech/05_console.md) **/** +GenerateCommand +--- +# [GenerateCommand](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/Command/GenerateCommand.php#L18) class: ```php namespace BumbleDocGen\Console\Command; @@ -14,66 +14,23 @@ namespace BumbleDocGen\Console\Command; final class GenerateCommand extends \BumbleDocGen\Console\Command\BaseCommand ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods details: - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/Command/BaseCommand.php#L21) ```php // Implemented in BumbleDocGen\Console\Command\BaseCommand public function __construct(string $name = null); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    - - - -
    -
    +--- diff --git a/docs/tech/classes/GeneratePageBreadcrumbs.md b/docs/tech/classes/GeneratePageBreadcrumbs.md index 9eab4df2..2ccc6c1f 100644 --- a/docs/tech/classes/GeneratePageBreadcrumbs.md +++ b/docs/tech/classes/GeneratePageBreadcrumbs.md @@ -1,22 +1,19 @@ - BumbleDocGen / Technical description of the project / Configuration / GeneratePageBreadcrumbs
    - -

    - GeneratePageBreadcrumbs class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +GeneratePageBreadcrumbs +--- +# [GeneratePageBreadcrumbs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L20) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class GeneratePageBreadcrumbs implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` - -
    Function to generate breadcrumbs on the page
    - - +Function to generate breadcrumbs on the page

    Settings:

    @@ -28,197 +25,65 @@ final class GeneratePageBreadcrumbs implements \BumbleDocGen\Core\Renderer\Twig\ +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L22) ```php public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$rendererContext | [\BumbleDocGen\Core\Renderer\Context\RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php) | - | +$dependencyFactory | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/Dependency/RendererDependencyFactory.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $rendererContext\BumbleDocGen\Core\Renderer\Context\RendererContext-
    $dependencyFactory\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L57) ```php public function __invoke(string $currentPageTitle, string $templatePath, bool $skipFirstTemplatePage = true): string; ``` +***Parameters:*** - -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $currentPageTitlestringTitle of the current page
    $templatePathstringPath to the template from which the breadcrumbs will be generated
    $skipFirstTemplatePageboolIf set to true, the page from which parsing starts will not participate in the formation of breadcrumbs +| Name | Type | Description | +|:-|:-|:-| +$currentPageTitle | [string](https://www.php.net/manual/en/language.types.string.php) | Title of the current page | +$templatePath | [string](https://www.php.net/manual/en/language.types.string.php) | Path to the template from which the breadcrumbs will be generated | +$skipFirstTemplatePage | [bool](https://www.php.net/manual/en/language.types.boolean.php) | If set to true, the page from which parsing starts will not participate in the formation of breadcrumbs This option is useful when working with the _self value in a template, as it returns the full path to the - current template, and the reference to it in breadcrumbs should not be clickable.
    - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L29) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L34) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/GenerateReadMeTemplateCommand.md b/docs/tech/classes/GenerateReadMeTemplateCommand.md index 590d8ba4..528fc63e 100644 --- a/docs/tech/classes/GenerateReadMeTemplateCommand.md +++ b/docs/tech/classes/GenerateReadMeTemplateCommand.md @@ -1,12 +1,12 @@ - BumbleDocGen / Technical description of the project / Console app / GenerateReadMeTemplateCommand
    - -

    - GenerateReadMeTemplateCommand class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Console app](/docs/tech/05_console.md) **/** +GenerateReadMeTemplateCommand +--- +# [GenerateReadMeTemplateCommand](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/AI/Console/GenerateReadMeTemplateCommand.php#L17) class: ```php namespace BumbleDocGen\AI\Console; @@ -14,78 +14,27 @@ namespace BumbleDocGen\AI\Console; final class GenerateReadMeTemplateCommand extends \BumbleDocGen\Console\Command\BaseCommand ``` +## Initialization methods +1. [__construct](#m-construct) +## Traits: +1. [\BumbleDocGen\AI\Traits\SharedCommandLogicTrait](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/AI/Traits/SharedCommandLogicTrait.php) +## Methods details: - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - - -

    Traits:

    - - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/Command/BaseCommand.php#L21) ```php // Implemented in BumbleDocGen\Console\Command\BaseCommand public function __construct(string $name = null); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    - - - -
    -
    +--- diff --git a/docs/tech/classes/GetDocumentationPageUrl.md b/docs/tech/classes/GetDocumentationPageUrl.md index 54a9df97..8a06ca80 100644 --- a/docs/tech/classes/GetDocumentationPageUrl.md +++ b/docs/tech/classes/GetDocumentationPageUrl.md @@ -1,47 +1,35 @@ - BumbleDocGen / Technical description of the project / Configuration / GetDocumentationPageUrl
    - -

    - GetDocumentationPageUrl class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +GetDocumentationPageUrl +--- +# [GetDocumentationPageUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php#L21) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class GetDocumentationPageUrl implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Creates an entity link by object -
    Creates an entity link by object
    - - -Examples of using: - +***Examples of using:*** ```php {{ getDocumentationPageUrl('Page name') }} - ``` - ```php {{ getDocumentationPageUrl('/someDir/someTemplate.md.twig') }} - ``` - ```php {{ getDocumentationPageUrl('/docs/someDir/someDocFile.md') }} - ``` - ```php {{ getDocumentationPageUrl('readme.md') }} - ``` - -

    Settings:

    @@ -51,179 +39,61 @@ final class GetDocumentationPageUrl implements \BumbleDocGen\Core\Renderer\Twig\
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php#L25) ```php public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php#L53) ```php public function __invoke(string $key): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$key | [string](https://www.php.net/manual/en/language.types.string.php) | The key by which to look up the URL of the page. + Can be the title of a page, a path to a template, or a generated document | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $keystringThe key by which to look up the URL of the page. - Can be the title of a page, a path to a template, or a generated document
    - -Return value: string - - -Throws: - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php#L31) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php#L36) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/GetDocumentedEntityUrl.md b/docs/tech/classes/GetDocumentedEntityUrl.md index 7dffaff6..eb8a0d75 100644 --- a/docs/tech/classes/GetDocumentedEntityUrl.md +++ b/docs/tech/classes/GetDocumentedEntityUrl.md @@ -1,56 +1,41 @@ - BumbleDocGen / Technical description of the project / Configuration / GetDocumentedEntityUrl
    - -

    - GetDocumentedEntityUrl class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +GetDocumentedEntityUrl +--- +# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L37) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class GetDocumentedEntityUrl implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Get the URL of a documented entity by its name. If the entity is found, next to the file where this method was called, +the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created -
    Get the URL of a documented entity by its name. If the entity is found, next to the file where this method was called, -the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created
    - -See: - - - -Examples of using: +***Links:*** +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/classes/DocumentedEntityWrapper.md) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/classes/DocumentedEntityWrappersCollection.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/classes/RendererContext.md) +***Examples of using:*** ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension', 'getFunctions') }} The function returns a reference to the documented entity, anchored to the getFunctions method - ``` - ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension') }} The function returns a reference to the documented entity MainExtension - ``` - ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension', '', false) }} The function returns a link to the file MainExtension - ``` - -

    Settings:

    @@ -60,204 +45,66 @@ The function returns a link to the file MainExtension
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L41) ```php public function __construct(\BumbleDocGen\Core\Renderer\RendererHelper $rendererHelper, \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection $documentedEntityWrappersCollection, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Monolog\Logger $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rendererHelper | [\BumbleDocGen\Core\Renderer\RendererHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/RendererHelper.php) | - | +$documentedEntityWrappersCollection | [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/Monolog/Logger.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rendererHelper\BumbleDocGen\Core\Renderer\RendererHelper-
    $documentedEntityWrappersCollection\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection-
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $logger\Monolog\Logger-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L76) ```php public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | Processed entity collection | +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | The full name of the entity for which the URL will be retrieved. + If the entity is not found, the DEFAULT_URL value will be returned. | +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | Cursor on the page of the documented entity (for example, the name of a method or property) | +$createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | If true, creates an entity document. Otherwise, just gives a reference to the entity code | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rootEntityCollection\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionProcessed entity collection
    $entityNamestringThe full name of the entity for which the URL will be retrieved. - If the entity is not found, the DEFAULT_URL value will be returned.
    $cursorstringCursor on the page of the documented entity (for example, the name of a method or property)
    $createDocumentboolIf true, creates an entity document. Otherwise, just gives a reference to the entity code
    - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L49) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L54) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/GetDocumentedEntityUrl_2.md b/docs/tech/classes/GetDocumentedEntityUrl_2.md index d7de8173..f3c761fd 100644 --- a/docs/tech/classes/GetDocumentedEntityUrl_2.md +++ b/docs/tech/classes/GetDocumentedEntityUrl_2.md @@ -1,56 +1,40 @@ - BumbleDocGen / Technical description of the project / GetDocumentedEntityUrl
    - -

    - GetDocumentedEntityUrl class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +GetDocumentedEntityUrl +--- +# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L37) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class GetDocumentedEntityUrl implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Get the URL of a documented entity by its name. If the entity is found, next to the file where this method was called, +the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created -
    Get the URL of a documented entity by its name. If the entity is found, next to the file where this method was called, -the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created
    - -See: - - - -Examples of using: +***Links:*** +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/classes/DocumentedEntityWrapper.md) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/classes/DocumentedEntityWrappersCollection.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/classes/RendererContext.md) +***Examples of using:*** ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension', 'getFunctions') }} The function returns a reference to the documented entity, anchored to the getFunctions method - ``` - ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension') }} The function returns a reference to the documented entity MainExtension - ``` - ```php {{ getDocumentedEntityUrl(phpEntities, '\\BumbleDocGen\\Renderer\\Twig\\MainExtension', '', false) }} The function returns a link to the file MainExtension - ``` - -

    Settings:

    @@ -60,204 +44,66 @@ The function returns a link to the file MainExtension
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - -

    Constants:

    - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L41) ```php public function __construct(\BumbleDocGen\Core\Renderer\RendererHelper $rendererHelper, \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection $documentedEntityWrappersCollection, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Monolog\Logger $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rendererHelper | [\BumbleDocGen\Core\Renderer\RendererHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/RendererHelper.php) | - | +$documentedEntityWrappersCollection | [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrappersCollection.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | +$logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/Monolog/Logger.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rendererHelper\BumbleDocGen\Core\Renderer\RendererHelper-
    $documentedEntityWrappersCollection\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection-
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    $logger\Monolog\Logger-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L76) ```php public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | Processed entity collection | +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | The full name of the entity for which the URL will be retrieved. + If the entity is not found, the DEFAULT_URL value will be returned. | +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | Cursor on the page of the documented entity (for example, the name of a method or property) | +$createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | If true, creates an entity document. Otherwise, just gives a reference to the entity code | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rootEntityCollection\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionProcessed entity collection
    $entityNamestringThe full name of the entity for which the URL will be retrieved. - If the entity is not found, the DEFAULT_URL value will be returned.
    $cursorstringCursor on the page of the documented entity (for example, the name of a method or property)
    $createDocumentboolIf true, creates an entity document. Otherwise, just gives a reference to the entity code
    - -Return value: string - - -Throws: - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L49) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L54) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/Implode.md b/docs/tech/classes/Implode.md index 5e6494a8..d8106d94 100644 --- a/docs/tech/classes/Implode.md +++ b/docs/tech/classes/Implode.md @@ -1,28 +1,22 @@ - BumbleDocGen / Technical description of the project / Configuration / Implode
    - -

    - Implode class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +Implode +--- +# [Implode](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/Implode.php#L10) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Filter; final class Implode implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface ``` +Join array elements with a string -
    Join array elements with a string
    - -See: - - - +***Links:*** +- [https://www.php.net/manual/en/function.implode.php](https://www.php.net/manual/en/function.implode.php)

    Settings:

    @@ -38,114 +32,44 @@ See: +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) +## Methods details: - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/Implode.php#L17) ```php public function __invoke(array $elements, string $separator = ', '): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$elements | [array](https://www.php.net/manual/en/language.types.array.php) | The array to implode | +$separator | [string](https://www.php.net/manual/en/language.types.string.php) | Element separator in result string | -Parameters: +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $elementsarrayThe array to implode
    $separatorstringElement separator in result string
    - -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/Implode.php#L22) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/Implode.php#L27) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/InvalidConfigurationParameterException.md b/docs/tech/classes/InvalidConfigurationParameterException.md deleted file mode 100644 index cc00b206..00000000 --- a/docs/tech/classes/InvalidConfigurationParameterException.md +++ /dev/null @@ -1,31 +0,0 @@ - BumbleDocGen / Technical description of the project / InvalidConfigurationParameterException
    - -

    - InvalidConfigurationParameterException class: -

    - - - - - -```php -namespace BumbleDocGen\Core\Configuration\Exception; - -final class InvalidConfigurationParameterException extends \Exception -``` - - - - - - - - - - - - - - - - diff --git a/docs/tech/classes/LastPageCommitter.md b/docs/tech/classes/LastPageCommitter.md index 94264247..f1c3484b 100644 --- a/docs/tech/classes/LastPageCommitter.md +++ b/docs/tech/classes/LastPageCommitter.md @@ -1,151 +1,64 @@ - BumbleDocGen / Technical description of the project / Plugin system / LastPageCommitter
    - -

    - LastPageCommitter class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +LastPageCommitter +--- +# [LastPageCommitter](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/LastPageCommitter/LastPageCommitter.php#L15) class: ```php namespace BumbleDocGen\Core\Plugin\CorePlugin\LastPageCommitter; final class LastPageCommitter implements \BumbleDocGen\Core\Plugin\PluginInterface, \Symfony\Component\EventDispatcher\EventSubscriberInterface ``` +Plugin for adding a block with information about the last commit and date of page update to the generated document -
    Plugin for adding a block with information about the last commit and date of page update to the generated document
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - beforeCreatingDocFile -
    2. -
    3. - getSubscribedEvents -
    4. -
    - - - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [beforeCreatingDocFile](#mbeforecreatingdocfile) +1. [getSubscribedEvents](#mgetsubscribedevents) -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/LastPageCommitter/LastPageCommitter.php#L17) ```php public function __construct(\BumbleDocGen\Core\Renderer\Context\RendererContext $context, \BumbleDocGen\Core\Configuration\Configuration $configuration); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$context | [\BumbleDocGen\Core\Renderer\Context\RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $context\BumbleDocGen\Core\Renderer\Context\RendererContext-
    $configuration\BumbleDocGen\Core\Configuration\Configuration-
    - - - -
    -
    -
    - - +--- +# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/LastPageCommitter/LastPageCommitter.php#L30) ```php public function beforeCreatingDocFile(\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingDocFile.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile-
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Return value: void - - -
    -
    -
    - - +--- +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/LastPageCommitter/LastPageCommitter.php#L23) ```php public static function getSubscribedEvents(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/LoadPluginsContent.md b/docs/tech/classes/LoadPluginsContent.md index a40c7e0d..47907318 100644 --- a/docs/tech/classes/LoadPluginsContent.md +++ b/docs/tech/classes/LoadPluginsContent.md @@ -1,32 +1,26 @@ - BumbleDocGen / Technical description of the project / Configuration / LoadPluginsContent
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +LoadPluginsContent -

    - LoadPluginsContent class: -

    +--- - - -:warning: Is internal +# [LoadPluginsContent](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/LoadPluginsContent.php#L18) class: +⚠️ Internal ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class LoadPluginsContent implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Process entity template blocks with plugins. The method returns the content processed by plugins. -
    Process entity template blocks with plugins. The method returns the content processed by plugins.
    - - -Examples of using: - +***Examples of using:*** ```php {{ loadPluginsContent('some text', entity, constant('BumbleDocGen\\Plugin\\BaseTemplatePluginInterface::BLOCK_AFTER_HEADER')) }} - ``` - -

    Settings:

    @@ -36,163 +30,61 @@ final class LoadPluginsContent implements \BumbleDocGen\Core\Renderer\Twig\Funct
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/LoadPluginsContent.php#L20) ```php public function __construct(\BumbleDocGen\Core\Plugin\PluginEventDispatcher $pluginEventDispatcher); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$pluginEventDispatcher | [\BumbleDocGen\Core\Plugin\PluginEventDispatcher](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginEventDispatcher.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginEventDispatcher\BumbleDocGen\Core\Plugin\PluginEventDispatcher-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/LoadPluginsContent.php#L42) ```php public function __invoke(string $content, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface $entity, string $blockType): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$content | [string](https://www.php.net/manual/en/language.types.string.php) | Content to be processed by plugins | +$entity | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) | The entity for which we process the content block | +$blockType | [string](https://www.php.net/manual/en/language.types.string.php) | Content block type. @see BaseTemplatePluginInterface::BLOCK_* | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $contentstringContent to be processed by plugins
    $entity\BumbleDocGen\Core\Parser\Entity\RootEntityInterfaceThe entity for which we process the content block
    $blockTypestringContent block type. @see BaseTemplatePluginInterface::BLOCK_*
    - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/LoadPluginsContent.php#L24) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/LoadPluginsContent.php#L29) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/LoadPluginsContent_2.md b/docs/tech/classes/LoadPluginsContent_2.md index 8ac665ef..a09939f2 100644 --- a/docs/tech/classes/LoadPluginsContent_2.md +++ b/docs/tech/classes/LoadPluginsContent_2.md @@ -1,32 +1,25 @@ - BumbleDocGen / Technical description of the project / LoadPluginsContent
    +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +LoadPluginsContent -

    - LoadPluginsContent class: -

    +--- - - -:warning: Is internal +# [LoadPluginsContent](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/LoadPluginsContent.php#L18) class: +⚠️ Internal ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class LoadPluginsContent implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Process entity template blocks with plugins. The method returns the content processed by plugins. -
    Process entity template blocks with plugins. The method returns the content processed by plugins.
    - - -Examples of using: - +***Examples of using:*** ```php {{ loadPluginsContent('some text', entity, constant('BumbleDocGen\\Plugin\\BaseTemplatePluginInterface::BLOCK_AFTER_HEADER')) }} - ``` - -

    Settings:

    @@ -36,163 +29,61 @@ final class LoadPluginsContent implements \BumbleDocGen\Core\Renderer\Twig\Funct
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/LoadPluginsContent.php#L20) ```php public function __construct(\BumbleDocGen\Core\Plugin\PluginEventDispatcher $pluginEventDispatcher); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$pluginEventDispatcher | [\BumbleDocGen\Core\Plugin\PluginEventDispatcher](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginEventDispatcher.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginEventDispatcher\BumbleDocGen\Core\Plugin\PluginEventDispatcher-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/LoadPluginsContent.php#L42) ```php public function __invoke(string $content, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface $entity, string $blockType): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$content | [string](https://www.php.net/manual/en/language.types.string.php) | Content to be processed by plugins | +$entity | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) | The entity for which we process the content block | +$blockType | [string](https://www.php.net/manual/en/language.types.string.php) | Content block type. @see BaseTemplatePluginInterface::BLOCK_* | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $contentstringContent to be processed by plugins
    $entity\BumbleDocGen\Core\Parser\Entity\RootEntityInterfaceThe entity for which we process the content block
    $blockTypestringContent block type. @see BaseTemplatePluginInterface::BLOCK_*
    - -Return value: string +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -
    -
    -
    - - - +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/LoadPluginsContent.php#L24) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/LoadPluginsContent.php#L29) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/OnAddClassEntityToCollection.md b/docs/tech/classes/OnAddClassEntityToCollection.md index 9af8d0dd..f20bb085 100644 --- a/docs/tech/classes/OnAddClassEntityToCollection.md +++ b/docs/tech/classes/OnAddClassEntityToCollection.md @@ -1,158 +1,68 @@ - BumbleDocGen / Technical description of the project / Plugin system / OnAddClassEntityToCollection
    - -

    - OnAddClassEntityToCollection class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +OnAddClassEntityToCollection +--- +# [OnAddClassEntityToCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Parser/OnAddClassEntityToCollection.php#L15) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Plugin\Event\Parser; final class OnAddClassEntityToCollection extends \Symfony\Contracts\EventDispatcher\Event implements \BumbleDocGen\Core\Plugin\OnlySingleExecutionEvent ``` +Called when each class entity is added to the entity collection -
    Called when each class entity is added to the entity collection
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    +## Initialization methods -

    Methods:

    +1. [__construct](#m-construct) +## Methods -
      -
    1. - getClassEntityCollection -
    2. -
    3. - getRootEntity -
    4. -
    5. - getUniqueExecutionId -
    6. -
    +1. [getClassEntityCollection](#mgetclassentitycollection) +1. [getRootEntity](#mgetrootentity) +1. [getUniqueExecutionId](#mgetuniqueexecutionid) +## Methods details: - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Parser/OnAddClassEntityToCollection.php#L17) ```php public function __construct(\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity $classEntity, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection $entitiesCollection); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$classEntity | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) | - | +$entitiesCollection | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $classEntity\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity-
    $entitiesCollection\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection-
    - - - -
    -
    -
    - - +--- +# `getClassEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Parser/OnAddClassEntityToCollection.php#L28) ```php public function getClassEntityCollection(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection; ``` +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection - - -
    -
    -
    - - - +# `getRootEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Parser/OnAddClassEntityToCollection.php#L33) ```php public function getRootEntity(): \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; ``` +***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity - - -
    -
    -
    - - - +# `getUniqueExecutionId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Parser/OnAddClassEntityToCollection.php#L23) ```php public function getUniqueExecutionId(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - -Parameters: not specified - -Return value: string - - -
    -
    +--- diff --git a/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md b/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md index a4728fee..3b95c454 100644 --- a/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md +++ b/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md @@ -1,12 +1,12 @@ - BumbleDocGen / Technical description of the project / Plugin system / OnCheckIsEntityCanBeLoaded
    - -

    - OnCheckIsEntityCanBeLoaded class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +OnCheckIsEntityCanBeLoaded +--- +# [OnCheckIsEntityCanBeLoaded](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Entity/OnCheckIsEntityCanBeLoaded.php#L10) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Plugin\Event\Entity; @@ -14,159 +14,67 @@ namespace BumbleDocGen\LanguageHandler\Php\Plugin\Event\Entity; final class OnCheckIsEntityCanBeLoaded extends \Symfony\Contracts\EventDispatcher\Event ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [disableEntityLoading](#mdisableentityloading) +1. [getEntity](#mgetentity) +1. [isEntityCanBeLoaded](#misentitycanbeloaded) +## Properties: +1. [isEntityCanBeLoaded](#pisentitycanbeloaded) +## Constants: +## Properties details: - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - disableEntityLoading -
    2. -
    3. - getEntity -
    4. -
    5. - isEntityCanBeLoaded -
    6. -
    - - - -

    Properties:

    - -
      -
    1. - isEntityCanBeLoaded
    2. -
    - - - -

    Property details:

    - - -* # - $isEntityCanBeLoaded - **|** source code +# `isEntityCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Entity/OnCheckIsEntityCanBeLoaded.php#L12) ```php public bool $isEntityCanBeLoaded; ``` +--- +## Methods details: - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Entity/OnCheckIsEntityCanBeLoaded.php#L14) ```php public function __construct(\BumbleDocGen\Core\Parser\Entity\RootEntityInterface $entity); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$entity | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $entity\BumbleDocGen\Core\Parser\Entity\RootEntityInterface-
    - - - -
    -
    -
    - - +--- +# `disableEntityLoading` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Entity/OnCheckIsEntityCanBeLoaded.php#L23) ```php public function disableEntityLoading(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -
    -
    -
    - - - +# `getEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Entity/OnCheckIsEntityCanBeLoaded.php#L18) ```php public function getEntity(): \BumbleDocGen\Core\Parser\Entity\RootEntityInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) +--- -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityInterface - - -
    -
    -
    - - - +# `isEntityCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Entity/OnCheckIsEntityCanBeLoaded.php#L28) ```php public function isEntityCanBeLoaded(): bool; ``` +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) - -Parameters: not specified - -Return value: bool - - -
    -
    +--- diff --git a/docs/tech/classes/OnCreateDocumentedEntityWrapper.md b/docs/tech/classes/OnCreateDocumentedEntityWrapper.md index 7e9dea4d..821cae9a 100644 --- a/docs/tech/classes/OnCreateDocumentedEntityWrapper.md +++ b/docs/tech/classes/OnCreateDocumentedEntityWrapper.md @@ -1,105 +1,47 @@ - BumbleDocGen / Technical description of the project / Plugin system / OnCreateDocumentedEntityWrapper
    - -

    - OnCreateDocumentedEntityWrapper class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +OnCreateDocumentedEntityWrapper +--- +# [OnCreateDocumentedEntityWrapper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnCreateDocumentedEntityWrapper.php#L13) class: ```php namespace BumbleDocGen\Core\Plugin\Event\Renderer; final class OnCreateDocumentedEntityWrapper extends \Symfony\Contracts\EventDispatcher\Event ``` +The event occurs when an entity is added to the list for documentation -
    The event occurs when an entity is added to the list for documentation
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - getDocumentedEntityWrapper -
    2. -
    - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [getDocumentedEntityWrapper](#mgetdocumentedentitywrapper) +## Methods details: - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnCreateDocumentedEntityWrapper.php#L15) ```php public function __construct(\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper $documentedEntityWrapper); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$documentedEntityWrapper | [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $documentedEntityWrapper\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper-
    - - - -
    -
    -
    - - +--- +# `getDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnCreateDocumentedEntityWrapper.php#L20) ```php public function getDocumentedEntityWrapper(): \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper; ``` +***Return value:*** [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php) - -Parameters: not specified - -Return value: \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper - - -
    -
    +--- diff --git a/docs/tech/classes/OnGetProjectTemplatesDirs.md b/docs/tech/classes/OnGetProjectTemplatesDirs.md index db1c1275..60cad2d4 100644 --- a/docs/tech/classes/OnGetProjectTemplatesDirs.md +++ b/docs/tech/classes/OnGetProjectTemplatesDirs.md @@ -1,146 +1,63 @@ - BumbleDocGen / Technical description of the project / Plugin system / OnGetProjectTemplatesDirs
    - -

    - OnGetProjectTemplatesDirs class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +OnGetProjectTemplatesDirs +--- +# [OnGetProjectTemplatesDirs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGetProjectTemplatesDirs.php#L12) class: ```php namespace BumbleDocGen\Core\Plugin\Event\Renderer; final class OnGetProjectTemplatesDirs extends \Symfony\Contracts\EventDispatcher\Event ``` +This event occurs when all directories containing document templates are retrieved -
    This event occurs when all directories containing document templates are retrieved
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - addTemplatesDir -
    2. -
    3. - getTemplatesDirs -
    4. -
    - - - - +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [addTemplatesDir](#maddtemplatesdir) +1. [getTemplatesDirs](#mgettemplatesdirs) -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGetProjectTemplatesDirs.php#L14) ```php public function __construct(array $templatesDirs); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$templatesDirs | [array](https://www.php.net/manual/en/language.types.array.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $templatesDirsarray-
    - - - -
    -
    -
    - - +--- +# `addTemplatesDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGetProjectTemplatesDirs.php#L23) ```php public function addTemplatesDir(string $dirName): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$dirName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $dirNamestring-
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Return value: void - - -
    -
    -
    - - +--- +# `getTemplatesDirs` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGetProjectTemplatesDirs.php#L18) ```php public function getTemplatesDirs(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/OnGetTemplatePathByRelativeDocPath.md b/docs/tech/classes/OnGetTemplatePathByRelativeDocPath.md index 0ee6845a..48157641 100644 --- a/docs/tech/classes/OnGetTemplatePathByRelativeDocPath.md +++ b/docs/tech/classes/OnGetTemplatePathByRelativeDocPath.md @@ -1,170 +1,73 @@ - BumbleDocGen / Technical description of the project / Plugin system / OnGetTemplatePathByRelativeDocPath
    - -

    - OnGetTemplatePathByRelativeDocPath class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +OnGetTemplatePathByRelativeDocPath +--- +# [OnGetTemplatePathByRelativeDocPath](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGetTemplatePathByRelativeDocPath.php#L12) class: ```php namespace BumbleDocGen\Core\Plugin\Event\Renderer; final class OnGetTemplatePathByRelativeDocPath extends \Symfony\Contracts\EventDispatcher\Event ``` +The event occurs when the path to the template file is obtained relative to the path to the document -
    The event occurs when the path to the template file is obtained relative to the path to the document
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    +## Initialization methods -

    Methods:

    +1. [__construct](#m-construct) +## Methods -
      -
    1. - getCustomTemplateFilePath -
    2. -
    3. - getTemplateName -
    4. -
    5. - setCustomTemplateFilePath -
    6. -
    +1. [getCustomTemplateFilePath](#mgetcustomtemplatefilepath) +1. [getTemplateName](#mgettemplatename) +1. [setCustomTemplateFilePath](#msetcustomtemplatefilepath) +## Methods details: - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGetTemplatePathByRelativeDocPath.php#L16) ```php public function __construct(string $templateName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$templateName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $templateNamestring-
    - - - -
    -
    -
    - - +--- +# `getCustomTemplateFilePath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGetTemplatePathByRelativeDocPath.php#L30) ```php public function getCustomTemplateFilePath(): null|string; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: null | string - - -
    -
    -
    - - - +# `getTemplateName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGetTemplatePathByRelativeDocPath.php#L20) ```php public function getTemplateName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `setCustomTemplateFilePath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGetTemplatePathByRelativeDocPath.php#L25) ```php public function setCustomTemplateFilePath(string|null $customTemplateFilePath): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$customTemplateFilePath | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $customTemplateFilePathstring | null-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/classes/OnGettingResourceLink.md b/docs/tech/classes/OnGettingResourceLink.md index a11b45e7..23f15319 100644 --- a/docs/tech/classes/OnGettingResourceLink.md +++ b/docs/tech/classes/OnGettingResourceLink.md @@ -1,170 +1,73 @@ - BumbleDocGen / Technical description of the project / Plugin system / OnGettingResourceLink
    - -

    - OnGettingResourceLink class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +OnGettingResourceLink +--- +# [OnGettingResourceLink](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGettingResourceLink.php#L12) class: ```php namespace BumbleDocGen\Core\Plugin\Event\Renderer; final class OnGettingResourceLink extends \Symfony\Contracts\EventDispatcher\Event ``` +Event occurs when a reference to an entity (resource) is received -
    Event occurs when a reference to an entity (resource) is received
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    +## Initialization methods -

    Methods:

    +1. [__construct](#m-construct) +## Methods -
      -
    1. - getResourceName -
    2. -
    3. - getResourceUrl -
    4. -
    5. - setResourceUrl -
    6. -
    +1. [getResourceName](#mgetresourcename) +1. [getResourceUrl](#mgetresourceurl) +1. [setResourceUrl](#msetresourceurl) +## Methods details: - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGettingResourceLink.php#L16) ```php public function __construct(string $resourceName); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$resourceName | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $resourceNamestring-
    - - - -
    -
    -
    - - +--- +# `getResourceName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGettingResourceLink.php#L20) ```php public function getResourceName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getResourceUrl` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGettingResourceLink.php#L25) ```php public function getResourceUrl(): null|string; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: null | string - - -
    -
    -
    - - - +# `setResourceUrl` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGettingResourceLink.php#L30) ```php public function setResourceUrl(string|null $resourceUrl): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$resourceUrl | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $resourceUrlstring | null-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/classes/OnLoadEntityDocPluginContent.md b/docs/tech/classes/OnLoadEntityDocPluginContent.md index 9cb57f4d..5e1ebc77 100644 --- a/docs/tech/classes/OnLoadEntityDocPluginContent.md +++ b/docs/tech/classes/OnLoadEntityDocPluginContent.md @@ -1,234 +1,98 @@ - BumbleDocGen / Technical description of the project / Plugin system / OnLoadEntityDocPluginContent
    - -

    - OnLoadEntityDocPluginContent class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +OnLoadEntityDocPluginContent +--- +# [OnLoadEntityDocPluginContent](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnLoadEntityDocPluginContent.php#L16) class: ```php namespace BumbleDocGen\Core\Plugin\Event\Renderer; final class OnLoadEntityDocPluginContent extends \Symfony\Contracts\EventDispatcher\Event ``` +Called when entity documentation is generated (plugin content loading) -
    Called when entity documentation is generated (plugin content loading)
    - -See: - - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    +***Links:*** +- [\BumbleDocGen\Core\Renderer\Twig\Function\LoadPluginsContent](/docs/tech/classes/LoadPluginsContent_2.md) -

    Methods:

    +## Initialization methods -
      -
    1. - addBlockContentPluginResult -
    2. -
    3. - getBlockContent -
    4. -
    5. - getBlockContentPluginResults -
    6. -
    7. - getBlockType -
    8. -
    9. - getEntity -
    10. -
    +1. [__construct](#m-construct) +## Methods +1. [addBlockContentPluginResult](#maddblockcontentpluginresult) +1. [getBlockContent](#mgetblockcontent) +1. [getBlockContentPluginResults](#mgetblockcontentpluginresults) +1. [getBlockType](#mgetblocktype) +1. [getEntity](#mgetentity) +## Methods details: - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnLoadEntityDocPluginContent.php#L20) ```php public function __construct(string $blockContent, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface $entity, string $blockType); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$blockContent | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$entity | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) | - | +$blockType | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $blockContentstring-
    $entity\BumbleDocGen\Core\Parser\Entity\RootEntityInterface-
    $blockTypestring-
    - - - -
    -
    -
    - - +--- +# `addBlockContentPluginResult` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnLoadEntityDocPluginContent.php#L42) ```php public function addBlockContentPluginResult(string $pluginResult): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$pluginResult | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $pluginResultstring-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    -
    - - +--- +# `getBlockContent` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnLoadEntityDocPluginContent.php#L32) ```php public function getBlockContent(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getBlockContentPluginResults` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnLoadEntityDocPluginContent.php#L47) ```php public function getBlockContentPluginResults(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `getBlockType` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnLoadEntityDocPluginContent.php#L37) ```php public function getBlockType(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnLoadEntityDocPluginContent.php#L27) ```php public function getEntity(): \BumbleDocGen\Core\Parser\Entity\RootEntityInterface; ``` +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) - -Parameters: not specified - -Return value: \BumbleDocGen\Core\Parser\Entity\RootEntityInterface - - -
    -
    +--- diff --git a/docs/tech/classes/PageHtmlLinkerPlugin.md b/docs/tech/classes/PageHtmlLinkerPlugin.md index c1d8724f..0b5ade4f 100644 --- a/docs/tech/classes/PageHtmlLinkerPlugin.md +++ b/docs/tech/classes/PageHtmlLinkerPlugin.md @@ -1,210 +1,93 @@ - BumbleDocGen / Technical description of the project / Plugin system / PageHtmlLinkerPlugin
    - -

    - PageHtmlLinkerPlugin class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +PageHtmlLinkerPlugin +--- +# [PageHtmlLinkerPlugin](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/PageHtmlLinkerPlugin.php#L29) class: ```php namespace BumbleDocGen\Core\Plugin\CorePlugin\PageLinker; final class PageHtmlLinkerPlugin extends \BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker implements \BumbleDocGen\Core\Plugin\PluginInterface, \Symfony\Component\EventDispatcher\EventSubscriberInterface ``` - -
    Adds URLs to empty links in HTML format; +Adds URLs to empty links in HTML format; Links may contain: 1) Short entity name 2) Full entity name 3) Relative link to the entity file from the root directory of the project 4) Page title ( title ) 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) - 6) Relative reference to the entity document from the root directory of the documentation
    - - -Examples of using: + 6) Relative reference to the entity document from the root directory of the documentation +***Examples of using:*** ```php Existent page name => Existent page name - ``` - ```php \Namespace\ClassName => Custom title - ``` - ```php \Namespace\ClassName => \Namespace\ClassName - ``` - ```php Non-existent page name => Non-existent page name - ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [beforeCreatingDocFile](#mbeforecreatingdocfile) +1. [getSubscribedEvents](#mgetsubscribedevents) +## Methods details: - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - beforeCreatingDocFile -
    2. -
    3. - getSubscribedEvents -
    4. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L19) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | +$getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $rootEntityCollectionsGroup\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup-
    $getDocumentedEntityUrlFunction\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L71) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public function beforeCreatingDocFile(\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingDocFile.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Throws: - - -
    -
    -
    - - +--- +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L59) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public static function getSubscribedEvents(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/PageHtmlLinkerPlugin_2.md b/docs/tech/classes/PageHtmlLinkerPlugin_2.md index a9550bf2..363a0b85 100644 --- a/docs/tech/classes/PageHtmlLinkerPlugin_2.md +++ b/docs/tech/classes/PageHtmlLinkerPlugin_2.md @@ -1,210 +1,93 @@ - BumbleDocGen / Technical description of the project / Configuration / PageHtmlLinkerPlugin
    - -

    - PageHtmlLinkerPlugin class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +PageHtmlLinkerPlugin +--- +# [PageHtmlLinkerPlugin](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/PageHtmlLinkerPlugin.php#L29) class: ```php namespace BumbleDocGen\Core\Plugin\CorePlugin\PageLinker; final class PageHtmlLinkerPlugin extends \BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker implements \BumbleDocGen\Core\Plugin\PluginInterface, \Symfony\Component\EventDispatcher\EventSubscriberInterface ``` - -
    Adds URLs to empty links in HTML format; +Adds URLs to empty links in HTML format; Links may contain: 1) Short entity name 2) Full entity name 3) Relative link to the entity file from the root directory of the project 4) Page title ( title ) 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) - 6) Relative reference to the entity document from the root directory of the documentation
    - - -Examples of using: + 6) Relative reference to the entity document from the root directory of the documentation +***Examples of using:*** ```php Existent page name => Existent page name - ``` - ```php \Namespace\ClassName => Custom title - ``` - ```php \Namespace\ClassName => \Namespace\ClassName - ``` - ```php Non-existent page name => Non-existent page name - ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [beforeCreatingDocFile](#mbeforecreatingdocfile) +1. [getSubscribedEvents](#mgetsubscribedevents) +## Methods details: - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - beforeCreatingDocFile -
    2. -
    3. - getSubscribedEvents -
    4. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L19) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | +$getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $rootEntityCollectionsGroup\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup-
    $getDocumentedEntityUrlFunction\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L71) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public function beforeCreatingDocFile(\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingDocFile.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Throws: - - -
    -
    -
    - - +--- +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L59) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public static function getSubscribedEvents(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/PageLinkerPlugin.md b/docs/tech/classes/PageLinkerPlugin.md index 94884832..8b9d8eef 100644 --- a/docs/tech/classes/PageLinkerPlugin.md +++ b/docs/tech/classes/PageLinkerPlugin.md @@ -1,210 +1,93 @@ - BumbleDocGen / Technical description of the project / Plugin system / PageLinkerPlugin
    - -

    - PageLinkerPlugin class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +PageLinkerPlugin +--- +# [PageLinkerPlugin](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/PageLinkerPlugin.php#L29) class: ```php namespace BumbleDocGen\Core\Plugin\CorePlugin\PageLinker; final class PageLinkerPlugin extends \BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker implements \BumbleDocGen\Core\Plugin\PluginInterface, \Symfony\Component\EventDispatcher\EventSubscriberInterface ``` - -
    Adds URLs to empty links in HTML format; +Adds URLs to empty links in MD format; Links may contain: 1) Short entity name 2) Full entity name 3) Relative link to the entity file from the root directory of the project 4) Page title ( title ) 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) - 6) Relative reference to the entity document from the root directory of the documentation
    - - -Examples of using: + 6) Relative reference to the entity document from the root directory of the documentation +***Examples of using:*** ```php -[a]Existent page name[/a] => Existent page name - +[a]Existent page name[/a] => [Existent page name](/docs/some/page/targetPage.md) ``` - ```php -[a x-title="Custom title"]\Namespace\ClassName[/a] => Custom title - +[a x-title="Custom title"]\Namespace\ClassName[/a] => [Custom title](/docs/some/page/ClassName.md) ``` - ```php -[a]\Namespace\ClassName[/a] => \Namespace\ClassName - +[a]\Namespace\ClassName[/a] => [\Namespace\ClassName](/docs/some/page/ClassName.md) ``` - ```php [a]Non-existent page name[/a] => Non-existent page name - ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [beforeCreatingDocFile](#mbeforecreatingdocfile) +1. [getSubscribedEvents](#mgetsubscribedevents) +## Methods details: - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - beforeCreatingDocFile -
    2. -
    3. - getSubscribedEvents -
    4. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L19) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | +$getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $rootEntityCollectionsGroup\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup-
    $getDocumentedEntityUrlFunction\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L71) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public function beforeCreatingDocFile(\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingDocFile.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Throws: - - -
    -
    -
    - - +--- +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L59) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public static function getSubscribedEvents(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/PageLinkerPlugin_2.md b/docs/tech/classes/PageLinkerPlugin_2.md index 6806c5aa..039f5351 100644 --- a/docs/tech/classes/PageLinkerPlugin_2.md +++ b/docs/tech/classes/PageLinkerPlugin_2.md @@ -1,210 +1,93 @@ - BumbleDocGen / Technical description of the project / Configuration / PageLinkerPlugin
    - -

    - PageLinkerPlugin class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +PageLinkerPlugin +--- +# [PageLinkerPlugin](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/PageLinkerPlugin.php#L29) class: ```php namespace BumbleDocGen\Core\Plugin\CorePlugin\PageLinker; final class PageLinkerPlugin extends \BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker implements \BumbleDocGen\Core\Plugin\PluginInterface, \Symfony\Component\EventDispatcher\EventSubscriberInterface ``` - -
    Adds URLs to empty links in HTML format; +Adds URLs to empty links in MD format; Links may contain: 1) Short entity name 2) Full entity name 3) Relative link to the entity file from the root directory of the project 4) Page title ( title ) 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) - 6) Relative reference to the entity document from the root directory of the documentation
    - - -Examples of using: + 6) Relative reference to the entity document from the root directory of the documentation +***Examples of using:*** ```php -[a]Existent page name[/a] => Existent page name - +[a]Existent page name[/a] => [Existent page name](/docs/some/page/targetPage.md) ``` - ```php -[a x-title="Custom title"]\Namespace\ClassName[/a] => Custom title - +[a x-title="Custom title"]\Namespace\ClassName[/a] => [Custom title](/docs/some/page/ClassName.md) ``` - ```php -[a]\Namespace\ClassName[/a] => \Namespace\ClassName - +[a]\Namespace\ClassName[/a] => [\Namespace\ClassName](/docs/some/page/ClassName.md) ``` - ```php [a]Non-existent page name[/a] => Non-existent page name - ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [beforeCreatingDocFile](#mbeforecreatingdocfile) +1. [getSubscribedEvents](#mgetsubscribedevents) +## Methods details: - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - beforeCreatingDocFile -
    2. -
    3. - getSubscribedEvents -
    4. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L19) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | +$getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $rootEntityCollectionsGroup\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup-
    $getDocumentedEntityUrlFunction\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L71) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public function beforeCreatingDocFile(\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingDocFile.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Throws: - - -
    -
    -
    - - +--- +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L59) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public static function getSubscribedEvents(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/PageRstLinkerPlugin.md b/docs/tech/classes/PageRstLinkerPlugin.md index db29a47c..f1785175 100644 --- a/docs/tech/classes/PageRstLinkerPlugin.md +++ b/docs/tech/classes/PageRstLinkerPlugin.md @@ -1,200 +1,87 @@ - BumbleDocGen / Technical description of the project / Plugin system / PageRstLinkerPlugin
    - -

    - PageRstLinkerPlugin class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +PageRstLinkerPlugin +--- +# [PageRstLinkerPlugin](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/PageRstLinkerPlugin.php#L23) class: ```php namespace BumbleDocGen\Core\Plugin\CorePlugin\PageLinker; final class PageRstLinkerPlugin extends \BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker implements \BumbleDocGen\Core\Plugin\PluginInterface, \Symfony\Component\EventDispatcher\EventSubscriberInterface ``` - -
    Adds URLs to empty links in rst format; +Adds URLs to empty links in rst format; Links may contain: 1) Short entity name 2) Full entity name 3) Relative link to the entity file from the root directory of the project 4) Page title ( title ) 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) - 6) Relative reference to the entity document from the root directory of the documentation
    - - -Examples of using: + 6) Relative reference to the entity document from the root directory of the documentation +***Examples of using:*** ```php `Existent page name`_ => `Existent page name `_ - ``` - ```php `Non-existent page name`_ => Non-existent page name - ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [beforeCreatingDocFile](#mbeforecreatingdocfile) +1. [getSubscribedEvents](#mgetsubscribedevents) +## Methods details: - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - beforeCreatingDocFile -
    2. -
    3. - getSubscribedEvents -
    4. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L19) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \Psr\Log\LoggerInterface $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | +$getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $breadcrumbsHelper\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper-
    $rootEntityCollectionsGroup\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup-
    $getDocumentedEntityUrlFunction\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl-
    $logger\Psr\Log\LoggerInterface-
    - - - -
    -
    -
    - - +--- +# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L71) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public function beforeCreatingDocFile(\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/BeforeCreatingDocFile.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile-
    - -Return value: void - - -Throws: - - -
    -
    -
    - - +--- +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L59) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker public static function getSubscribedEvents(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/PhpDocumentorStubberPlugin.md b/docs/tech/classes/PhpDocumentorStubberPlugin.md index 41917541..d3afed70 100644 --- a/docs/tech/classes/PhpDocumentorStubberPlugin.md +++ b/docs/tech/classes/PhpDocumentorStubberPlugin.md @@ -1,143 +1,63 @@ - BumbleDocGen / Technical description of the project / Plugin system / PhpDocumentorStubberPlugin
    - -

    - PhpDocumentorStubberPlugin class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +PhpDocumentorStubberPlugin +--- +# [PhpDocumentorStubberPlugin](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/BasePhpStubber/PhpDocumentorStubberPlugin.php#L23) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Plugin\CorePlugin\BasePhpStubber; final class PhpDocumentorStubberPlugin implements \BumbleDocGen\Core\Plugin\PluginInterface, \Symfony\Component\EventDispatcher\EventSubscriberInterface ``` +Adding links to the documentation of PHP classes in the \phpDocumentor namespace -
    Adding links to the documentation of PHP classes in the \phpDocumentor namespace
    - - - - - - - -

    Methods:

    - -
      -
    1. - getSubscribedEvents -
    2. -
    3. - onCheckIsEntityCanBeLoaded -
    4. -
    5. - onGettingResourceLink -
    6. -
    - - - - - +## Methods +1. [getSubscribedEvents](#mgetsubscribedevents) +1. [onCheckIsEntityCanBeLoaded](#moncheckisentitycanbeloaded) +1. [onGettingResourceLink](#mongettingresourcelink) -

    Method details:

    - -
    - - +## Methods details: +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/BasePhpStubber/PhpDocumentorStubberPlugin.php#L25) ```php public static function getSubscribedEvents(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `onCheckIsEntityCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/BasePhpStubber/PhpDocumentorStubberPlugin.php#L73) ```php public function onCheckIsEntityCanBeLoaded(\BumbleDocGen\LanguageHandler\Php\Plugin\Event\Entity\OnCheckIsEntityCanBeLoaded $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\LanguageHandler\Php\Plugin\Event\Entity\OnCheckIsEntityCanBeLoaded](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Entity/OnCheckIsEntityCanBeLoaded.php) | - | -Parameters: +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\LanguageHandler\Php\Plugin\Event\Entity\OnCheckIsEntityCanBeLoaded-
    - -Return value: void - - -
    -
    -
    - - +--- +# `onGettingResourceLink` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/BasePhpStubber/PhpDocumentorStubberPlugin.php#L33) ```php public function onGettingResourceLink(\BumbleDocGen\Core\Plugin\Event\Renderer\OnGettingResourceLink $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\OnGettingResourceLink](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGettingResourceLink.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\OnGettingResourceLink-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/classes/PhpUnitStubberPlugin.md b/docs/tech/classes/PhpUnitStubberPlugin.md index baaea168..f7d66e9d 100644 --- a/docs/tech/classes/PhpUnitStubberPlugin.md +++ b/docs/tech/classes/PhpUnitStubberPlugin.md @@ -1,143 +1,63 @@ - BumbleDocGen / Technical description of the project / Plugin system / PhpUnitStubberPlugin
    - -

    - PhpUnitStubberPlugin class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +PhpUnitStubberPlugin +--- +# [PhpUnitStubberPlugin](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/BasePhpStubber/PhpUnitStubberPlugin.php#L14) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Plugin\CorePlugin\BasePhpStubber; final class PhpUnitStubberPlugin implements \BumbleDocGen\Core\Plugin\PluginInterface, \Symfony\Component\EventDispatcher\EventSubscriberInterface ``` +Adding links to the documentation of PHP classes in the \PHPUnit namespace -
    Adding links to the documentation of PHP classes in the \PHPUnit namespace
    - - - - - - - -

    Methods:

    - -
      -
    1. - getSubscribedEvents -
    2. -
    3. - onCheckIsEntityCanBeLoaded -
    4. -
    5. - onGettingResourceLink -
    6. -
    - - - - - +## Methods +1. [getSubscribedEvents](#mgetsubscribedevents) +1. [onCheckIsEntityCanBeLoaded](#moncheckisentitycanbeloaded) +1. [onGettingResourceLink](#mongettingresourcelink) -

    Method details:

    - -
    - - +## Methods details: +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/BasePhpStubber/PhpUnitStubberPlugin.php#L16) ```php public static function getSubscribedEvents(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `onCheckIsEntityCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/BasePhpStubber/PhpUnitStubberPlugin.php#L39) ```php public function onCheckIsEntityCanBeLoaded(\BumbleDocGen\LanguageHandler\Php\Plugin\Event\Entity\OnCheckIsEntityCanBeLoaded $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\LanguageHandler\Php\Plugin\Event\Entity\OnCheckIsEntityCanBeLoaded](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Entity/OnCheckIsEntityCanBeLoaded.php) | - | -Parameters: +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\LanguageHandler\Php\Plugin\Event\Entity\OnCheckIsEntityCanBeLoaded-
    - -Return value: void - - -
    -
    -
    - - +--- +# `onGettingResourceLink` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/BasePhpStubber/PhpUnitStubberPlugin.php#L24) ```php public function onGettingResourceLink(\BumbleDocGen\Core\Plugin\Event\Renderer\OnGettingResourceLink $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\OnGettingResourceLink](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGettingResourceLink.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\OnGettingResourceLink-
    - -Return value: void - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/classes/PluginInterface.md b/docs/tech/classes/PluginInterface.md deleted file mode 100644 index f940bb33..00000000 --- a/docs/tech/classes/PluginInterface.md +++ /dev/null @@ -1,31 +0,0 @@ - BumbleDocGen / Technical description of the project / Plugin system / PluginInterface
    - -

    - PluginInterface class: -

    - - - - - -```php -namespace BumbleDocGen\Core\Plugin; - -interface PluginInterface extends \Symfony\Component\EventDispatcher\EventSubscriberInterface -``` - - - - - - - - - - - - - - - - diff --git a/docs/tech/classes/PregMatch.md b/docs/tech/classes/PregMatch.md index 18159999..b415414d 100644 --- a/docs/tech/classes/PregMatch.md +++ b/docs/tech/classes/PregMatch.md @@ -1,28 +1,22 @@ - BumbleDocGen / Technical description of the project / Configuration / PregMatch
    - -

    - PregMatch class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +PregMatch +--- +# [PregMatch](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/PregMatch.php#L12) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Filter; final class PregMatch implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface ``` +Perform a regular expression match -
    Perform a regular expression match
    - -See: - - - +***Links:*** +- [https://www.php.net/manual/en/function.preg-match.php](https://www.php.net/manual/en/function.preg-match.php)

    Settings:

    @@ -38,114 +32,44 @@ See: +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) +## Methods details: - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/PregMatch.php#L20) ```php public function __invoke(string $text, string $pattern): array; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$text | [string](https://www.php.net/manual/en/language.types.string.php) | Processed text | +$pattern | [string](https://www.php.net/manual/en/language.types.string.php) | The pattern to search for, as a string. | -Parameters: +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstringProcessed text
    $patternstringThe pattern to search for, as a string.
    - -Return value: array - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/PregMatch.php#L26) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/PregMatch.php#L31) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/PrepareSourceLink.md b/docs/tech/classes/PrepareSourceLink.md index 9e834b34..d742b24a 100644 --- a/docs/tech/classes/PrepareSourceLink.md +++ b/docs/tech/classes/PrepareSourceLink.md @@ -1,22 +1,19 @@ - BumbleDocGen / Technical description of the project / Configuration / PrepareSourceLink
    - -

    - PrepareSourceLink class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +PrepareSourceLink +--- +# [PrepareSourceLink](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/PrepareSourceLink.php#L12) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Filter; final class PrepareSourceLink implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface ``` - -
    The filter converts the string into an anchor that can be used in a GitHub document link
    - - +The filter converts the string into an anchor that can be used in a GitHub document link

    Settings:

    @@ -32,109 +29,43 @@ final class PrepareSourceLink implements \BumbleDocGen\Core\Renderer\Twig\Filter +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) +## Methods details: - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/PrepareSourceLink.php#L17) ```php public function __invoke(string $text): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$text | [string](https://www.php.net/manual/en/language.types.string.php) | Processed text | -Parameters: +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstringProcessed text
    - -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/PrepareSourceLink.php#L22) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/PrepareSourceLink.php#L27) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/PrintEntityCollectionAsList.md b/docs/tech/classes/PrintEntityCollectionAsList.md index 46347db8..c0c5e14b 100644 --- a/docs/tech/classes/PrintEntityCollectionAsList.md +++ b/docs/tech/classes/PrintEntityCollectionAsList.md @@ -1,39 +1,31 @@ - BumbleDocGen / Technical description of the project / Configuration / PrintEntityCollectionAsList
    - -

    - PrintEntityCollectionAsList class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +PrintEntityCollectionAsList +--- +# [PrintEntityCollectionAsList](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php#L22) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; final class PrintEntityCollectionAsList implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` +Outputting entity data as MD list -
    Outputting entity data as HTML list
    - - -Examples of using: - +***Examples of using:*** ```php {{ printEntityCollectionAsList(phpEntities.filterByInterfaces(['ScriptFramework\\ScriptInterface', 'ScriptFramework\\TestScriptInterface'])) }} The function will output a list of PHP classes that match the ScriptFramework\ScriptInterface and ScriptFramework\TestScriptInterface interfaces - ``` - ```php {{ printEntityCollectionAsList(phpEntities) }} The function will list all documented PHP classes - ``` - -

    Settings:

    @@ -43,175 +35,63 @@ The function will list all documented PHP classes
    +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php#L24) ```php -public function __construct(\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction); +public function __construct(\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \BumbleDocGen\Core\Renderer\Twig\Filter\RemoveLineBrakes $removeLineBrakes); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | +$removeLineBrakes | [\BumbleDocGen\Core\Renderer\Twig\Filter\RemoveLineBrakes](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/RemoveLineBrakes.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $getDocumentedEntityUrlFunction\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php#L50) ```php public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $type = 'ul', bool $skipDescription = false, bool $useFullName = false): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | Processed entity collection | +$type | [string](https://www.php.net/manual/en/language.types.string.php) | List tag type (
      /
        ) | +$skipDescription | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Don't print description of this entities | +$useFullName | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Use the full name of the entity in the list | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
        NameTypeDescription
        $rootEntityCollection\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionProcessed entity collection
        $typestringList tag type (
          /
            )
        $skipDescriptionboolDon't print description of this entities
        $useFullNameboolUse the full name of the entity in the list
        - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -Throws: - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php#L30) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php#L35) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/Quotemeta.md b/docs/tech/classes/Quotemeta.md index 34599b99..518c0496 100644 --- a/docs/tech/classes/Quotemeta.md +++ b/docs/tech/classes/Quotemeta.md @@ -1,28 +1,22 @@ - BumbleDocGen / Technical description of the project / Configuration / Quotemeta
    - -

    - Quotemeta class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +Quotemeta +--- +# [Quotemeta](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/Quotemeta.php#L10) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Filter; final class Quotemeta implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface ``` +Quote meta characters -
    Quote meta characters
    - -See: - - - +***Links:*** +- [https://www.php.net/manual/en/function.quotemeta.php](https://www.php.net/manual/en/function.quotemeta.php)

    Settings:

    @@ -38,109 +32,43 @@ See: +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) +## Methods details: - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/Quotemeta.php#L15) ```php public function __invoke(string $text): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$text | [string](https://www.php.net/manual/en/language.types.string.php) | Processed text | -Parameters: +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstringProcessed text
    - -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/Quotemeta.php#L20) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/Quotemeta.php#L25) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/RemoveLineBrakes.md b/docs/tech/classes/RemoveLineBrakes.md index d7191502..0979d315 100644 --- a/docs/tech/classes/RemoveLineBrakes.md +++ b/docs/tech/classes/RemoveLineBrakes.md @@ -1,22 +1,19 @@ - BumbleDocGen / Technical description of the project / Configuration / RemoveLineBrakes
    - -

    - RemoveLineBrakes class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +RemoveLineBrakes +--- +# [RemoveLineBrakes](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/RemoveLineBrakes.php#L10) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Filter; final class RemoveLineBrakes implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface ``` - -
    The filter replaces all line breaks with a space
    - - +The filter replaces all line breaks with a space

    Settings:

    @@ -32,109 +29,43 @@ final class RemoveLineBrakes implements \BumbleDocGen\Core\Renderer\Twig\Filter\ +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) +## Methods details: - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/RemoveLineBrakes.php#L15) ```php public function __invoke(string $text): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$text | [string](https://www.php.net/manual/en/language.types.string.php) | Processed text | -Parameters: +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstringProcessed text
    - -Return value: string - - -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/RemoveLineBrakes.php#L20) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/RemoveLineBrakes.php#L25) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/RendererContext.md b/docs/tech/classes/RendererContext.md index b0f4450e..6a558f3d 100644 --- a/docs/tech/classes/RendererContext.md +++ b/docs/tech/classes/RendererContext.md @@ -1,256 +1,110 @@ - BumbleDocGen / Technical description of the project / RendererContext
    - -

    - RendererContext class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +RendererContext +--- +# [RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L12) class: ```php namespace BumbleDocGen\Core\Renderer\Context; final class RendererContext ``` +Document rendering context -
    Document rendering context
    - - - - - - - -

    Methods:

    - -
      -
    1. - addDependency -
    2. -
    3. - clearDependencies -
    4. -
    5. - getCurrentDocumentedEntityWrapper -
    6. -
    7. - getCurrentTemplateFilePatch - - Getting the path to the template file that is currently being worked on
    8. -
    9. - getDependencies -
    10. -
    11. - setCurrentDocumentedEntityWrapper -
    12. -
    13. - setCurrentTemplateFilePatch - - Saving the path to the template file that is currently being worked on in the context
    14. -
    - - +## Methods +1. [addDependency](#madddependency) +1. [clearDependencies](#mcleardependencies) +1. [getCurrentDocumentedEntityWrapper](#mgetcurrentdocumentedentitywrapper) +1. [getCurrentTemplateFilePatch](#mgetcurrenttemplatefilepatch) - Getting the path to the template file that is currently being worked on +1. [getDependencies](#mgetdependencies) +1. [setCurrentDocumentedEntityWrapper](#msetcurrentdocumentedentitywrapper) +1. [setCurrentTemplateFilePatch](#msetcurrenttemplatefilepatch) - Saving the path to the template file that is currently being worked on in the context +## Methods details: - - -

    Method details:

    - -
    - - - +# `addDependency` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L53) ```php public function addDependency(\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyInterface $dependency): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$dependency | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/Dependency/RendererDependencyInterface.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $dependency\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyInterface-
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Return value: void - - -
    -
    -
    - - +--- +# `clearDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L48) ```php public function clearDependencies(): void; ``` +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Parameters: not specified - -Return value: void - - -
    -
    -
    - - - +# `getCurrentDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L43) ```php public function getCurrentDocumentedEntityWrapper(): null|\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper; ``` +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php) +--- -Parameters: not specified - -Return value: null | \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper - - -
    -
    -
    - - - +# `getCurrentTemplateFilePatch` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L32) ```php public function getCurrentTemplateFilePatch(): string; ``` +Getting the path to the template file that is currently being worked on -
    Getting the path to the template file that is currently being worked on
    - -Parameters: not specified - -Return value: string - - -
    -
    -
    +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - +--- +# `getDependencies` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L58) ```php public function getDependencies(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `setCurrentDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L37) ```php public function setCurrentDocumentedEntityWrapper(\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper $currentDocumentedEntityWrapper): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$currentDocumentedEntityWrapper | [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/DocumentedEntityWrapper.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $currentDocumentedEntityWrapper\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper-
    +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -Return value: void - - -
    -
    -
    - - +--- +# `setCurrentTemplateFilePatch` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php#L24) ```php public function setCurrentTemplateFilePatch(string $currentTemplateFilePath): void; ``` +Saving the path to the template file that is currently being worked on in the context -
    Saving the path to the template file that is currently being worked on in the context
    - -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $currentTemplateFilePathstring-
    +***Parameters:*** -Return value: void +| Name | Type | Description | +|:-|:-|:-| +$currentTemplateFilePath | [string](https://www.php.net/manual/en/language.types.string.php) | - | +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/classes/ServeCommand.md b/docs/tech/classes/ServeCommand.md index 690c7964..10075e3b 100644 --- a/docs/tech/classes/ServeCommand.md +++ b/docs/tech/classes/ServeCommand.md @@ -1,12 +1,12 @@ - BumbleDocGen / Technical description of the project / Console app / ServeCommand
    - -

    - ServeCommand class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Console app](/docs/tech/05_console.md) **/** +ServeCommand +--- +# [ServeCommand](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/Command/ServeCommand.php#L20) class: ```php namespace BumbleDocGen\Console\Command; @@ -14,66 +14,23 @@ namespace BumbleDocGen\Console\Command; final class ServeCommand extends \BumbleDocGen\Console\Command\BaseCommand ``` +## Initialization methods +1. [__construct](#m-construct) +## Methods details: - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - - - - - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/Command/BaseCommand.php#L21) ```php // Implemented in BumbleDocGen\Console\Command\BaseCommand public function __construct(string $name = null); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$name | [string](https://www.php.net/manual/en/language.types.string.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $namestring-
    - - - -
    -
    +--- diff --git a/docs/tech/classes/StrTypeToUrl.md b/docs/tech/classes/StrTypeToUrl.md index d4f1dc39..38c1c8dd 100644 --- a/docs/tech/classes/StrTypeToUrl.md +++ b/docs/tech/classes/StrTypeToUrl.md @@ -1,28 +1,22 @@ - BumbleDocGen / Technical description of the project / Configuration / StrTypeToUrl
    - -

    - StrTypeToUrl class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Configuration](/docs/tech/01_configuration.md) **/** +StrTypeToUrl +--- +# [StrTypeToUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php#L18) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Filter; final class StrTypeToUrl implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface ``` +The filter converts the string with the data type into a link to the documented entity, if possible. -
    The filter converts the string with the data type into a link to the documented entity, if possible.
    - -See: - - - +***Links:*** +- [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](/docs/tech/classes/GetDocumentedEntityUrl_2.md)

    Settings:

    @@ -38,178 +32,65 @@ See: +## Initialization methods +1. [__construct](#m-construct) +## Methods +1. [__invoke](#m-invoke) +1. [getName](#mgetname) +1. [getOptions](#mgetoptions) -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - +## Methods details: +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php#L20) ```php public function __construct(\BumbleDocGen\Core\Renderer\RendererHelper $rendererHelper, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \Monolog\Logger $logger); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$rendererHelper | [\BumbleDocGen\Core\Renderer\RendererHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/RendererHelper.php) | - | +$getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | +$logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/Monolog/Logger.php) | - | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $rendererHelper\BumbleDocGen\Core\Renderer\RendererHelper-
    $getDocumentedEntityUrlFunction\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl-
    $logger\Monolog\Logger-
    - - - -
    -
    -
    - - +--- +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php#L50) ```php -public function __invoke(string $text, \BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, bool $useShortLinkVersion = false, bool $createDocument = false): string; +public function __invoke(string $text, \BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, bool $useShortLinkVersion = false, bool $createDocument = false, string $separator = ' | '): string; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$text | [string](https://www.php.net/manual/en/language.types.string.php) | Processed text | +$rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | - | +$useShortLinkVersion | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Shorten or not the link name. When shortening, only the shortName of the entity will be shown | +$createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | If true, creates an entity document. Otherwise, just gives a reference to the entity code | +$separator | [string](https://www.php.net/manual/en/language.types.string.php) | Separator between types | -Parameters: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstringProcessed text
    $rootEntityCollection\BumbleDocGen\Core\Parser\Entity\RootEntityCollection-
    $useShortLinkVersionboolShorten or not the link name. When shortening, only the shortName of the entity will be shown
    $createDocumentboolIf true, creates an entity document. Otherwise, just gives a reference to the entity code
    - -Return value: string - +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) -
    -
    -
    - - +--- +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php#L27) ```php public static function getName(): string; ``` +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) +--- -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php#L32) ```php public static function getOptions(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - -Parameters: not specified - -Return value: array - - -
    -
    +--- diff --git a/docs/tech/classes/StubberPlugin.md b/docs/tech/classes/StubberPlugin.md index 17e5683d..e30cedea 100644 --- a/docs/tech/classes/StubberPlugin.md +++ b/docs/tech/classes/StubberPlugin.md @@ -1,201 +1,79 @@ - BumbleDocGen / Technical description of the project / Plugin system / StubberPlugin
    - -

    - StubberPlugin class: -

    - +[BumbleDocGen](/docs/README.md) **/** +[Technical description of the project](/docs/tech/readme.md) **/** +[Plugin system](/docs/tech/04_pluginSystem.md) **/** +StubberPlugin +--- +# [StubberPlugin](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/ComposerPackagesStubber/StubberPlugin.php#L15) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Plugin\CorePlugin\ComposerPackagesStubber; final class StubberPlugin implements \BumbleDocGen\Core\Plugin\PluginInterface, \Symfony\Component\EventDispatcher\EventSubscriberInterface ``` +The plugin allows you to automatically provide links to github repositories for documented classes from libraries included in composer -
    The plugin allows you to automatically provide links to github repositories for documented classes from libraries included in composer
    - - - - - - -

    Initialization methods:

    - -
      -
    1. - __construct -
    2. -
    - -

    Methods:

    +## Initialization methods -
      -
    1. - getSubscribedEvents -
    2. -
    3. - onCheckIsEntityCanBeLoaded -
    4. -
    5. - onGettingResourceLink -
    6. -
    +1. [__construct](#m-construct) +## Methods +1. [getSubscribedEvents](#mgetsubscribedevents) +1. [onCheckIsEntityCanBeLoaded](#moncheckisentitycanbeloaded) +1. [onGettingResourceLink](#mongettingresourcelink) +## Methods details: - - - - -

    Method details:

    - -
    - - - +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/ComposerPackagesStubber/StubberPlugin.php#L19) ```php public function __construct(\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper $composerHelper); ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$composerHelper | [\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/ComposerHelper.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $composerHelper\BumbleDocGen\LanguageHandler\Php\Parser\ComposerHelper-
    - - - -
    -
    -
    - - +--- +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/ComposerPackagesStubber/StubberPlugin.php#L23) ```php public static function getSubscribedEvents(): array; ``` +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) +--- -Parameters: not specified - -Return value: array - - -
    -
    -
    - - - +# `onCheckIsEntityCanBeLoaded` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/ComposerPackagesStubber/StubberPlugin.php#L60) ```php public function onCheckIsEntityCanBeLoaded(\BumbleDocGen\LanguageHandler\Php\Plugin\Event\Entity\OnCheckIsEntityCanBeLoaded $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\LanguageHandler\Php\Plugin\Event\Entity\OnCheckIsEntityCanBeLoaded](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/Event/Entity/OnCheckIsEntityCanBeLoaded.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\LanguageHandler\Php\Plugin\Event\Entity\OnCheckIsEntityCanBeLoaded-
    - -Return value: void +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) +--- -Throws: - - -
    -
    -
    - - - +# `onGettingResourceLink` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/ComposerPackagesStubber/StubberPlugin.php#L34) ```php public function onGettingResourceLink(\BumbleDocGen\Core\Plugin\Event\Renderer\OnGettingResourceLink $event): void; ``` +***Parameters:*** +| Name | Type | Description | +|:-|:-|:-| +$event | [\BumbleDocGen\Core\Plugin\Event\Renderer\OnGettingResourceLink](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/Event/Renderer/OnGettingResourceLink.php) | - | -Parameters: - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $event\BumbleDocGen\Core\Plugin\Event\Renderer\OnGettingResourceLink-
    - -Return value: void - - -Throws: - +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) -
    -
    +--- diff --git a/docs/tech/classes/TextToCodeBlock.md b/docs/tech/classes/TextToCodeBlock.md deleted file mode 100644 index 195e471b..00000000 --- a/docs/tech/classes/TextToCodeBlock.md +++ /dev/null @@ -1,145 +0,0 @@ - BumbleDocGen / Technical description of the project / Configuration / TextToCodeBlock
    - -

    - TextToCodeBlock class: -

    - - - - - -```php -namespace BumbleDocGen\Core\Renderer\Twig\Filter; - -final class TextToCodeBlock implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface -``` - -
    Convert text to code block
    - - - - -

    Settings:

    - - - - - - - - - - -
    namevalue
    Filter name:textToCodeBlock
    - - - - - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - -```php -public function __invoke(string $text, string $codeBlockType): string; -``` - - - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstringProcessed text
    $codeBlockTypestringCode block type (e.g. php or console )
    - -Return value: string - - -
    -
    -
    - - - -```php -public static function getName(): string; -``` - - - -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - -```php -public static function getOptions(): array; -``` - - - -Parameters: not specified - -Return value: array - - -
    -
    diff --git a/docs/tech/classes/TextToHeading.md b/docs/tech/classes/TextToHeading.md deleted file mode 100644 index 285a8efc..00000000 --- a/docs/tech/classes/TextToHeading.md +++ /dev/null @@ -1,145 +0,0 @@ - BumbleDocGen / Technical description of the project / Configuration / TextToHeading
    - -

    - TextToHeading class: -

    - - - - - -```php -namespace BumbleDocGen\Core\Renderer\Twig\Filter; - -final class TextToHeading implements \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFilterInterface -``` - -
    Convert text to html header
    - - - - -

    Settings:

    - - - - - - - - - - -
    namevalue
    Filter name:textToHeading
    - - - - - -

    Methods:

    - -
      -
    1. - __invoke -
    2. -
    3. - getName -
    4. -
    5. - getOptions -
    6. -
    - - - - - - - -

    Method details:

    - -
    - - - -```php -public function __invoke(string $text, string $headingType): string; -``` - - - -Parameters: - - - - - - - - - - - - - - - - - - - - - -
    NameTypeDescription
    $textstring-
    $headingTypestringChoose heading type: H1, H2, H3
    - -Return value: string - - -
    -
    -
    - - - -```php -public static function getName(): string; -``` - - - -Parameters: not specified - -Return value: string - - -
    -
    -
    - - - -```php -public static function getOptions(): array; -``` - - - -Parameters: not specified - -Return value: array - - -
    -
    diff --git a/docs/tech/readme.md b/docs/tech/readme.md index 48729cc9..f4c1f8d6 100644 --- a/docs/tech/readme.md +++ b/docs/tech/readme.md @@ -1,14 +1,25 @@ - BumbleDocGen / Technical description of the project
    +[BumbleDocGen](/docs/README.md) **/** +Technical description of the project -

    Technical description of the project

    +--- + + +# Technical description of the project This documentation generator is a library that allows you to create handwritten documentation with dynamic blocks that are loaded from the project code or other places. -

    Documentation sections

    +## Documentation sections + - +- [Configuration](/docs/tech/01_configuration.md) +- [Parser](/docs/tech/02_parser/readme.md) +- [Renderer](/docs/tech/03_renderer/readme.md) +- [Plugin system](/docs/tech/04_pluginSystem.md) +- [Console app](/docs/tech/05_console.md) +- [Debug documents](/docs/tech/06_debugging.md) +- [Output formats](/docs/tech/07_outputFormat.md) -

    How it works

    +## How it works ```mermaid graph TD; @@ -28,20 +39,18 @@ This documentation generator is a library that allows you to create handwritten To start the documentation generation process, you need to call the following command: ```php - (new DocGeneratorFactory())->create($configFile)->generate() +(new DocGeneratorFactory())->create($configFile)->generate(); ``` - or ```php - (new DocGeneratorFactory())->createByConfigArray($configArray)->generate() +(new DocGeneratorFactory())->createByConfigArray($configArray)->generate(); ``` - After that, the process of parsing the project code according to the configuration will start, and then filling the templates with data and saving the finished result as final documents. -
    -
    -Last page committer: fshcherbanich <filipp.shcherbanich@team.bumble.com>
    Last modified date: Sat Dec 23 23:00:37 2023 +0300
    Page content update date: Mon Jan 15 2024
    Made with Bumble Documentation Generator
    \ No newline at end of file +--- + +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
    **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
    **Page content update date:** Thu Jan 18 2024
    Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file From 55ab8593a6eb96b4b7e3be10493b819331a27643 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Fri, 19 Jan 2024 13:35:48 +0300 Subject: [PATCH 17/32] Using MD instead of HTML --- src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php b/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php index 88eec3a2..90654a48 100644 --- a/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php +++ b/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php @@ -20,7 +20,7 @@ */ final class DrawDocumentedEntityLink implements CustomFunctionInterface { - public function __construct(private GetDocumentedEntityUrl $getDocumentedEntityUrlFunction) + public function __construct(private readonly GetDocumentedEntityUrl $getDocumentedEntityUrlFunction) { } @@ -55,6 +55,6 @@ public function __invoke( $getDocumentedEntityUrlFunction = $this->getDocumentedEntityUrlFunction; $url = $getDocumentedEntityUrlFunction($entity->getRootEntityCollection(), $entity->getName(), $cursor); $name = $useShortName ? $entity->getShortName() : $entity->getName(); - return "{$name}"; + return "[{$name}]({$url})"; } } From 485f97dd512f3a59011e40b4f1ec9d3f798cce3d Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Fri, 19 Jan 2024 13:36:25 +0300 Subject: [PATCH 18/32] Mark properties as readonly --- src/Core/Renderer/Twig/Function/FileGetContents.php | 2 +- .../Renderer/Twig/Function/GetDocumentationPageUrl.php | 4 ++-- .../Renderer/Twig/Function/GetDocumentedEntityUrl.php | 8 ++++---- src/Core/Renderer/Twig/Function/LoadPluginsContent.php | 2 +- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/src/Core/Renderer/Twig/Function/FileGetContents.php b/src/Core/Renderer/Twig/Function/FileGetContents.php index 659e1263..88915bdd 100644 --- a/src/Core/Renderer/Twig/Function/FileGetContents.php +++ b/src/Core/Renderer/Twig/Function/FileGetContents.php @@ -16,7 +16,7 @@ */ final class FileGetContents implements CustomFunctionInterface { - public function __construct(private ConfigurationParameterBag $parameterBag) + public function __construct(private readonly ConfigurationParameterBag $parameterBag) { } diff --git a/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php b/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php index 15c22fa2..90309477 100644 --- a/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php +++ b/src/Core/Renderer/Twig/Function/GetDocumentationPageUrl.php @@ -23,8 +23,8 @@ final class GetDocumentationPageUrl implements CustomFunctionInterface public const DEFAULT_URL = '#'; public function __construct( - private BreadcrumbsHelper $breadcrumbsHelper, - private LoggerInterface $logger, + private readonly BreadcrumbsHelper $breadcrumbsHelper, + private readonly LoggerInterface $logger, ) { } diff --git a/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php b/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php index 925b6e5f..25dbccf9 100644 --- a/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php +++ b/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php @@ -39,10 +39,10 @@ final class GetDocumentedEntityUrl implements CustomFunctionInterface public const DEFAULT_URL = '#'; public function __construct( - private RendererHelper $rendererHelper, - private DocumentedEntityWrappersCollection $documentedEntityWrappersCollection, - private Configuration $configuration, - private Logger $logger + private readonly RendererHelper $rendererHelper, + private readonly DocumentedEntityWrappersCollection $documentedEntityWrappersCollection, + private readonly Configuration $configuration, + private readonly Logger $logger ) { } diff --git a/src/Core/Renderer/Twig/Function/LoadPluginsContent.php b/src/Core/Renderer/Twig/Function/LoadPluginsContent.php index 2599c7eb..a9118bf6 100644 --- a/src/Core/Renderer/Twig/Function/LoadPluginsContent.php +++ b/src/Core/Renderer/Twig/Function/LoadPluginsContent.php @@ -17,7 +17,7 @@ */ final class LoadPluginsContent implements CustomFunctionInterface { - public function __construct(private PluginEventDispatcher $pluginEventDispatcher) + public function __construct(private readonly PluginEventDispatcher $pluginEventDispatcher) { } From 694581507c04e71b1ce2154026646f14d6cc9dc1 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Fri, 19 Jan 2024 19:31:37 +0300 Subject: [PATCH 19/32] Adding new func to get relative url --- src/Core/utils.php | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/src/Core/utils.php b/src/Core/utils.php index b665d2e2..1f5ffaff 100644 --- a/src/Core/utils.php +++ b/src/Core/utils.php @@ -19,3 +19,23 @@ function get_class_short(string $className): string return end($classNameParts); } } + +if (!function_exists('BumbleDocGen\Core\get_relative_path')) { + function get_relative_path(string $from, string $to): string + { + $from = explode('/', $from); + $to = explode('/', $to); + + array_pop($from); + $toFileName = array_pop($to); + + $commonParts = array_intersect_assoc($from, $to); + $diffFrom = array_diff_assoc($from, $commonParts); + + $wayToCommonPath = implode('/', array_fill(0, count($diffFrom), '..')); + $diffTo = array_diff_assoc($to, $commonParts); + $newPath = $diffTo ? implode('/', $diffTo) . '/' . $toFileName : $toFileName; + + return ltrim("{$wayToCommonPath}/{$newPath}", '/'); + } +} From ea03e97b7d4fafd5b898816c9554b7fa02083838 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Fri, 19 Jan 2024 19:33:44 +0300 Subject: [PATCH 20/32] Change method to generate entities breadcrumbs --- .../Function/GenerateEntityBreadcrumbs.php | 81 +++++++++++++++++++ .../PhpClassRendererTwigEnvironment.php | 12 ++- .../PhpClassToMd/PhpClassToMdDocRenderer.php | 9 ++- .../PhpClassToMd/templates/class.md.twig | 4 +- 4 files changed, 100 insertions(+), 6 deletions(-) create mode 100644 src/Core/Renderer/Twig/Function/GenerateEntityBreadcrumbs.php diff --git a/src/Core/Renderer/Twig/Function/GenerateEntityBreadcrumbs.php b/src/Core/Renderer/Twig/Function/GenerateEntityBreadcrumbs.php new file mode 100644 index 00000000..dd762ea0 --- /dev/null +++ b/src/Core/Renderer/Twig/Function/GenerateEntityBreadcrumbs.php @@ -0,0 +1,81 @@ + ['html'], + ]; + } + + /** + * @throws RuntimeError + * @throws LoaderError + * @throws DependencyException + * @throws SyntaxError + * @throws NotFoundException + * @throws InvalidConfigurationParameterException + */ + public function __invoke( + string $currentPageTitle, + string $docUrl, + string $templatePath, + ): string { + + $templatesBreadcrumbs = $this->breadcrumbsHelper->getBreadcrumbs($templatePath); + foreach ($templatesBreadcrumbs as $k => $breadcrumb) { + $templatesBreadcrumbs[$k]['url'] = get_relative_path($docUrl, $breadcrumb['url']); + } + + $content = $this->breadcrumbsTwig->render('breadcrumbs.md.twig', [ + 'currentPageTitle' => $currentPageTitle, + 'breadcrumbs' => $templatesBreadcrumbs, + ]); + + $templatesBreadcrumbs = $this->breadcrumbsHelper->getBreadcrumbsForTemplates($templatePath); + foreach ($templatesBreadcrumbs as $templateBreadcrumb) { + $fileDependency = $this->dependencyFactory->createFileDependency( + filePath: $templateBreadcrumb['template'], + contentFilterRegex: '/^---([^-]+)(---)/', + matchIndex: 1 + ); + $this->rendererContext->addDependency($fileDependency); + } + + return $content; + } +} diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/PhpClassRendererTwigEnvironment.php b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/PhpClassRendererTwigEnvironment.php index 48edf8f5..90a269a1 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/PhpClassRendererTwigEnvironment.php +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/PhpClassRendererTwigEnvironment.php @@ -4,6 +4,7 @@ namespace BumbleDocGen\LanguageHandler\Php\Renderer\EntityDocRenderer\PhpClassToMd; +use BumbleDocGen\Core\Renderer\Twig\Function\GenerateEntityBreadcrumbs; use BumbleDocGen\Core\Renderer\Twig\MainExtension; use Twig\Environment; use Twig\Error\LoaderError; @@ -15,13 +16,20 @@ final class PhpClassRendererTwigEnvironment { private Environment $twig; - public function __construct(MainExtension $mainExtension) - { + public function __construct( + MainExtension $mainExtension, + GenerateEntityBreadcrumbs $generateEntityBreadcrumbsFunction + ) { $loader = new FilesystemLoader([ __DIR__ . '/templates', ]); $this->twig = new Environment($loader); $this->twig->addExtension($mainExtension); + $this->twig->addFunction(new \Twig\TwigFunction( + $generateEntityBreadcrumbsFunction->getName(), + $generateEntityBreadcrumbsFunction, + $generateEntityBreadcrumbsFunction->getOptions() + )); } /** diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/PhpClassToMdDocRenderer.php b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/PhpClassToMdDocRenderer.php index 908297ff..f3a51886 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/PhpClassToMdDocRenderer.php +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/PhpClassToMdDocRenderer.php @@ -4,6 +4,8 @@ namespace BumbleDocGen\LanguageHandler\Php\Renderer\EntityDocRenderer\PhpClassToMd; +use BumbleDocGen\Core\Configuration\Configuration; +use BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException; use BumbleDocGen\Core\Parser\Entity\RootEntityInterface; use BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper; use BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; @@ -22,7 +24,8 @@ class PhpClassToMdDocRenderer implements EntityDocRendererInterface public const BLOCK_BEFORE_DETAILS = 'before_details'; public function __construct( - private PhpClassRendererTwigEnvironment $classRendererTwig + private readonly PhpClassRendererTwigEnvironment $classRendererTwig, + private readonly Configuration $configuration ) { } @@ -45,12 +48,14 @@ public function isAvailableForEntity(RootEntityInterface $entity): bool * @throws RuntimeError * @throws SyntaxError * @throws LoaderError + * @throws InvalidConfigurationParameterException */ public function getRenderedText(DocumentedEntityWrapper $entityWrapper): string { return $this->classRendererTwig->render('class.md.twig', [ 'classEntity' => $entityWrapper->getDocumentTransformableEntity(), - 'parentDocFilePath' => $entityWrapper->getParentDocFilePath() + 'parentDocFilePath' => $entityWrapper->getParentDocFilePath(), + 'docUrl' => $this->configuration->getOutputDirBaseUrl() . $entityWrapper->getDocUrl() ]); } } diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/class.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/class.md.twig index a61cdb26..c2e21437 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/class.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/class.md.twig @@ -1,4 +1,4 @@ -{{ generatePageBreadcrumbs(classEntity.getShortName(), parentDocFilePath, false) }} +{{ generateEntityBreadcrumbs(classEntity.getShortName(), docUrl, parentDocFilePath, false) }} {% include '_classHeader.md.twig' with {'classEntity': classEntity} only %} {{ loadPluginsContent('', classEntity, constant('BumbleDocGen\\LanguageHandler\\Php\\Renderer\\EntityDocRenderer\\PhpClassToMd\\PhpClassToMdDocRenderer::BLOCK_AFTER_HEADER')) }} @@ -12,4 +12,4 @@ {% include '_constants.md.twig' with {'classEntity': classEntity} only %} {{ loadPluginsContent('', classEntity, constant('BumbleDocGen\\LanguageHandler\\Php\\Renderer\\EntityDocRenderer\\PhpClassToMd\\PhpClassToMdDocRenderer::BLOCK_BEFORE_DETAILS')) }} {% include '_property_details.md.twig' with {'classEntity': classEntity} only %} -{% include '_method_details.md.twig' with {'methodEntitiesCollection': classEntity.getMethodEntitiesCollection()} only %} +{% include '_method_details.md.twig' with {'methodEntitiesCollection': classEntity.getMethodEntitiesCollection(), 'classEntity': classEntity} only %} From d89610ec74b851322ed26cf7426eb96fd6ef87b2 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Fri, 19 Jan 2024 19:34:09 +0300 Subject: [PATCH 21/32] Change method generate links --- .../PhpClassToMd/templates/_classMainInfo.md.twig | 2 +- .../PhpClassToMd/templates/_method_details.md.twig | 2 +- .../PhpClassToMd/templates/_property_details.md.twig | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_classMainInfo.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_classMainInfo.md.twig index 78163c63..5a7c8a06 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_classMainInfo.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_classMainInfo.md.twig @@ -16,7 +16,7 @@ namespace {{ classEntity.getNamespaceName() }}; ***Links:*** {% for link in classEntity.getDescriptionLinks() %} -- {% if link.url %}[{{ link.name }}]({{ link.url }}){% else %}{{ link.name }}{% endif %}{% if link.description %} - {{ link.description | removeLineBrakes }} {% endif %} +- {% if link.url %}[{{ link.name }}]({{ link.url }}){% elseif link.className %}{{ link.className|strTypeToUrl(classEntity.getRootEntityCollection(), false, true) }}{% else %}{{ link.name }}{% endif %}{% if link.description %} - {{ link.description | removeLineBrakes }} {% endif %} {% endfor %} {% endif %} diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_method_details.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_method_details.md.twig index 6de0c1c5..49964b89 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_method_details.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_method_details.md.twig @@ -36,7 +36,7 @@ ${{ parameter.name }}{% if parameter.isVariadic %} (variadic){% endif %} ***Links:*** {% for link in methodEntity.getDescriptionLinks() %} -- {% if link.url %}[{{ link.name }}]({{ link.url }}){% else %}{{ link.name }}{% endif %}{% if link.description %} - {{ link.description | removeLineBrakes }} {% endif %} +- {% if link.url %}[{{ link.name }}]({{ link.url }}){% elseif link.className %}{{ link.className|strTypeToUrl(classEntity.getRootEntityCollection(), false, true) }}{% else %}{{ link.name }}{% endif %}{% if link.description %} - {{ link.description | removeLineBrakes }} {% endif %} {% endfor %} {% endif %} diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_property_details.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_property_details.md.twig index a64ebaec..65d588f4 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_property_details.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_property_details.md.twig @@ -19,7 +19,7 @@ ***Links:*** {% for link in propertyEntity.getDescriptionLinks() %} -- {% if link.url %}[{{ link.name }}]({{ link.url }}){% else %}{{ link.name }}{% endif %}{% if link.description %} - {{ link.description | removeLineBrakes }} {% endif %} +- {% if link.url %}[{{ link.name }}]({{ link.url }}){% elseif link.className %}{{ link.className|strTypeToUrl(classEntity.getRootEntityCollection(), false, true) }}{% else %}{{ link.name }}{% endif %}{% if link.description %} - {{ link.description | removeLineBrakes }} {% endif %} {% endfor %} {% endif %} From 40725cb2e0fd5b5030c9eb0484b9288ed65646f6 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Fri, 19 Jan 2024 19:35:24 +0300 Subject: [PATCH 22/32] Fix url changer --- src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php index 26524b7f..a8e9e073 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php @@ -60,7 +60,9 @@ final public function beforeCreatingDocFile(BeforeCreatingDocFile|BeforeCreating return explode('?', $elements[0])[0]; }, $content); - $content = preg_replace('/(\/readme.md)("|\')/i', '/index.md$2', $content); + $content = preg_replace('/(\/readme.md)("|\')(>)/i', '/index.md$2>', $content); + $content = preg_replace('/("|\')(readme.md)("|\')(>)/i', '$1index.md$1>', $content); + $event->setContent($content); $outputFileName = $event->getOutputFilePatch(); From cb597a7ec8693629936862161e2c06be74975922 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Fri, 19 Jan 2024 19:36:05 +0300 Subject: [PATCH 23/32] Change linking method --- .../PrintClassCollectionAsGroupedTable.php | 7 +- .../CorePlugin/PageLinker/BasePageLinker.php | 21 ++-- .../Breadcrumbs/BreadcrumbsHelper.php | 22 ---- .../Renderer/Twig/Filter/StrTypeToUrl.php | 12 +- .../Function/DrawDocumentedEntityLink.php | 4 +- .../Twig/Function/GeneratePageBreadcrumbs.php | 22 +++- .../Twig/Function/GetDocumentedEntityUrl.php | 42 ++++++- .../Function/PrintEntityCollectionAsList.php | 5 +- .../Renderer/Twig/MainTwigEnvironment.php | 3 +- .../Php/Parser/Entity/BaseEntity.php | 113 +++--------------- .../Twig/Function/DisplayClassApiMethods.php | 11 +- .../Renderer/Twig/Function/DrawClassMap.php | 18 +-- 12 files changed, 123 insertions(+), 157 deletions(-) diff --git a/selfdoc/Twig/CustomFunction/PrintClassCollectionAsGroupedTable.php b/selfdoc/Twig/CustomFunction/PrintClassCollectionAsGroupedTable.php index 5d0708a5..54e6d0f4 100644 --- a/selfdoc/Twig/CustomFunction/PrintClassCollectionAsGroupedTable.php +++ b/selfdoc/Twig/CustomFunction/PrintClassCollectionAsGroupedTable.php @@ -26,6 +26,7 @@ public static function getOptions(): array { return [ 'is_safe' => ['html'], + 'needs_context' => true, ]; } @@ -34,7 +35,7 @@ public static function getOptions(): array * @throws DependencyException * @throws InvalidConfigurationParameterException */ - public function __invoke(PhpEntitiesCollection $rootEntityCollection): string + public function __invoke(array $context, PhpEntitiesCollection $rootEntityCollection): string { $groups = $this->groupEntities($rootEntityCollection); $getDocumentedEntityUrlFunction = $this->getDocumentedEntityUrlFunction; @@ -44,9 +45,9 @@ public function __invoke(PhpEntitiesCollection $rootEntityCollection): string foreach ($groups as $groupKey => $entities) { $firstEntity = array_shift($entities); - $table .= "| **{$groupKey}** | [{$firstEntity->getShortName()}]({$getDocumentedEntityUrlFunction($rootEntityCollection, $firstEntity->getName())}) | {$firstEntity->getDescription()} |\n"; + $table .= "| **{$groupKey}** | [{$firstEntity->getShortName()}]({$getDocumentedEntityUrlFunction($context, $rootEntityCollection, $firstEntity->getName())}) | {$firstEntity->getDescription()} |\n"; foreach ($entities as $entity) { - $table .= "| | [{$entity->getShortName()}]({$getDocumentedEntityUrlFunction($rootEntityCollection, $entity->getName())}) | {$entity->getDescription()} |\n"; + $table .= "| | [{$entity->getShortName()}]({$getDocumentedEntityUrlFunction($context, $rootEntityCollection, $entity->getName())}) | {$entity->getDescription()} |\n"; } $table .= "| | | |\n"; } diff --git a/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php b/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php index 6db5f216..c5327b08 100644 --- a/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php +++ b/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php @@ -4,6 +4,7 @@ namespace BumbleDocGen\Core\Plugin\CorePlugin\PageLinker; +use BumbleDocGen\Core\Configuration\Configuration; use BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException; use BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup; use BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile; @@ -17,10 +18,11 @@ abstract class BasePageLinker implements PluginInterface { public function __construct( - private BreadcrumbsHelper $breadcrumbsHelper, - private RootEntityCollectionsGroup $rootEntityCollectionsGroup, - private GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, - private LoggerInterface $logger, + private readonly BreadcrumbsHelper $breadcrumbsHelper, + private readonly RootEntityCollectionsGroup $rootEntityCollectionsGroup, + private readonly GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, + private readonly Configuration $configuration, + private readonly LoggerInterface $logger, ) { } @@ -70,9 +72,11 @@ public static function getSubscribedEvents(): array */ final public function beforeCreatingDocFile(BeforeCreatingDocFile $event): void { + $docRelativeFilePath = str_replace($this->configuration->getOutputDir(), '', $event->getOutputFilePatch()); + $content = preg_replace_callback( $this->getLinkRegEx(), - function (array $matches) { + function (array $matches) use ($docRelativeFilePath) { $match = $matches[0] ?? ''; $linkString = $this->getUrlFromMatch($match); $pageData = $this->breadcrumbsHelper->getPageDataByKey($linkString); @@ -85,11 +89,12 @@ function (array $matches) { foreach ($this->rootEntityCollectionsGroup as $rootEntityCollection) { $entityUrlData = $rootEntityCollection->getEntityLinkData($linkString); if ($entityUrlData['entityName'] ?? null) { - $getDocumentedEntityUrl = $this->getDocumentedEntityUrlFunction; - $entityUrlData['url'] = $getDocumentedEntityUrl( + $entityUrlData['url'] = $this->getDocumentedEntityUrlFunction->process( $rootEntityCollection, $entityUrlData['entityName'], - $entityUrlData['cursor'] + $entityUrlData['cursor'], + true, + "{$docRelativeFilePath}.twig" ); return $this->getFilledOutputTemplate( $this->getCustomTitleFromMatch($match) ?: $entityUrlData['title'], diff --git a/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php b/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php index 8d4edc8f..791644b2 100644 --- a/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php +++ b/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php @@ -16,9 +16,6 @@ use DI\NotFoundException; use Symfony\Component\Finder\Finder; use Symfony\Component\Yaml\Yaml; -use Twig\Error\LoaderError; -use Twig\Error\RuntimeError; -use Twig\Error\SyntaxError; /** * Helper entity for working with breadcrumbs @@ -38,7 +35,6 @@ final class BreadcrumbsHelper public function __construct( private readonly Configuration $configuration, private readonly LocalObjectCache $localObjectCache, - private readonly BreadcrumbsTwigEnvironment $breadcrumbsTwig, private readonly PluginEventDispatcher $pluginEventDispatcher, private readonly string $prevPageNameTemplate = self::DEFAULT_PREV_PAGE_NAME_TEMPLATE ) { @@ -335,22 +331,4 @@ public function getPageDocFileByKey(string $key): ?string $pageData = $this->getPageDataByKey($key); return $pageData['doc_file'] ?? null; } - - /** - * Returns an HTML string with rendered breadcrumbs - * - * @throws SyntaxError - * @throws NotFoundException - * @throws RuntimeError - * @throws DependencyException - * @throws LoaderError - * @throws InvalidConfigurationParameterException - */ - public function renderBreadcrumbs(string $currentPageTitle, string $filePatch, bool $fromCurrent = true): string - { - return $this->breadcrumbsTwig->render('breadcrumbs.md.twig', [ - 'currentPageTitle' => $currentPageTitle, - 'breadcrumbs' => $this->getBreadcrumbs($filePatch, $fromCurrent), - ]); - } } diff --git a/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php b/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php index 5d40a248..c0e2bc88 100644 --- a/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php +++ b/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php @@ -33,11 +33,12 @@ public static function getOptions(): array { return [ 'is_safe' => ['html'], + 'needs_context' => true, ]; } - /** + * @param array $context * @param string $text Processed text * @param RootEntityCollection $rootEntityCollection * @param bool $useShortLinkVersion Shorten or not the link name. When shortening, only the shortName of the entity will be shown @@ -48,6 +49,7 @@ public static function getOptions(): array * @return string */ public function __invoke( + array $context, string $text, RootEntityCollection $rootEntityCollection, bool $useShortLinkVersion = false, @@ -59,6 +61,10 @@ public function __invoke( $preparedTypes = []; $types = explode('|', $text); foreach ($types as $type) { + $name = $type; + $data = explode('::', $type); + $type = $data[0]; + $cursor = $data[1] ?? ''; $preloadResourceLink = $this->rendererHelper->getPreloadResourceLink($type); if ($preloadResourceLink) { if ($useShortLinkVersion) { @@ -71,7 +77,7 @@ public function __invoke( $entityOfLink = $rootEntityCollection->getLoadedOrCreateNew($type); if (!$entityOfLink->isExternalLibraryEntity() && $entityOfLink->isEntityDataCanBeLoaded()) { if ($entityOfLink->getAbsoluteFileName()) { - $link = $getDocumentedEntityUrlFunction($rootEntityCollection, $type, '', $createDocument); + $link = $getDocumentedEntityUrlFunction($context, $rootEntityCollection, $type, $cursor, $createDocument); if ($useShortLinkVersion) { $type = $entityOfLink->getShortName(); @@ -80,7 +86,7 @@ public function __invoke( } if ($link && $link !== '#') { - $preparedTypes[] = "[$type]({$link})"; + $preparedTypes[] = "[$name]({$link})"; } else { $preparedTypes[] = $type; } diff --git a/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php b/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php index 90654a48..1c57bbb9 100644 --- a/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php +++ b/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php @@ -33,6 +33,7 @@ public static function getOptions(): array { return [ 'is_safe' => ['html'], + 'needs_context' => true, ]; } @@ -48,12 +49,13 @@ public static function getOptions(): array * @throws InvalidConfigurationParameterException */ public function __invoke( + array $context, RootEntityInterface $entity, string $cursor = '', bool $useShortName = true ): string { $getDocumentedEntityUrlFunction = $this->getDocumentedEntityUrlFunction; - $url = $getDocumentedEntityUrlFunction($entity->getRootEntityCollection(), $entity->getName(), $cursor); + $url = $getDocumentedEntityUrlFunction($context, $entity->getRootEntityCollection(), $entity->getName(), $cursor); $name = $useShortName ? $entity->getShortName() : $entity->getName(); return "[{$name}]({$url})"; } diff --git a/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php b/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php index 51c85514..e5ba3a96 100644 --- a/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php +++ b/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php @@ -4,8 +4,10 @@ namespace BumbleDocGen\Core\Renderer\Twig\Function; +use BumbleDocGen\Core\Configuration\Configuration; use BumbleDocGen\Core\Configuration\Exception\InvalidConfigurationParameterException; use BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper; +use BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsTwigEnvironment; use BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory; use BumbleDocGen\Core\Renderer\Context\RendererContext; use DI\DependencyException; @@ -14,6 +16,8 @@ use Twig\Error\RuntimeError; use Twig\Error\SyntaxError; +use function BumbleDocGen\Core\get_relative_path; + /** * Function to generate breadcrumbs on the page */ @@ -21,7 +25,9 @@ final class GeneratePageBreadcrumbs implements CustomFunctionInterface { public function __construct( private readonly BreadcrumbsHelper $breadcrumbsHelper, + private readonly BreadcrumbsTwigEnvironment $breadcrumbsTwig, private readonly RendererContext $rendererContext, + private readonly Configuration $configuration, private readonly RendererDependencyFactory $dependencyFactory, ) { } @@ -59,11 +65,17 @@ public function __invoke( string $templatePath, bool $skipFirstTemplatePage = true ): string { - $content = $this->breadcrumbsHelper->renderBreadcrumbs( - $currentPageTitle, - $templatePath, - !$skipFirstTemplatePage - ); + + $docUrl = $this->configuration->getOutputDirBaseUrl() . $templatePath; + $breadcrumbs = $this->breadcrumbsHelper->getBreadcrumbs($templatePath, false); + foreach ($breadcrumbs as $k => $breadcrumb) { + $breadcrumbs[$k]['url'] = get_relative_path($docUrl, $breadcrumb['url']); + } + + $content = $this->breadcrumbsTwig->render('breadcrumbs.md.twig', [ + 'currentPageTitle' => $currentPageTitle, + 'breadcrumbs' => $breadcrumbs, + ]); $templatesBreadcrumbs = $this->breadcrumbsHelper->getBreadcrumbsForTemplates($templatePath, !$skipFirstTemplatePage); foreach ($templatesBreadcrumbs as $templateBreadcrumb) { diff --git a/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php b/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php index 25dbccf9..1434814f 100644 --- a/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php +++ b/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php @@ -12,10 +12,13 @@ use BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection; use BumbleDocGen\Core\Renderer\Context\DocumentTransformableEntityInterface; use BumbleDocGen\Core\Renderer\RendererHelper; +use BumbleDocGen\Core\Renderer\Twig\MainTwigEnvironment; use DI\DependencyException; use DI\NotFoundException; use Monolog\Logger; +use function BumbleDocGen\Core\get_relative_path; + /** * Get the URL of a documented entity by its name. If the entity is found, next to the file where this method was called, * the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created @@ -55,10 +58,12 @@ public static function getOptions(): array { return [ 'is_safe' => ['html'], + 'needs_context' => true, ]; } /** + * @param array $context * @param RootEntityCollection $rootEntityCollection Processed entity collection * @param string $entityName * The full name of the entity for which the URL will be retrieved. @@ -73,8 +78,34 @@ public static function getOptions(): array * @throws InvalidConfigurationParameterException * @throws NotFoundException */ - public function __invoke(RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string - { + public function __invoke( + array $context, + RootEntityCollection $rootEntityCollection, + string $entityName, + string $cursor = '', + bool $createDocument = true + ): string { + return $this->process( + $rootEntityCollection, + $entityName, + $cursor, + $createDocument, + $context[MainTwigEnvironment::CURRENT_TEMPLATE_NAME_KEY] ?? null, + ); + } + + /** + * @throws NotFoundException + * @throws DependencyException + * @throws InvalidConfigurationParameterException + */ + public function process( + RootEntityCollection $rootEntityCollection, + string $entityName, + string $cursor = '', + bool $createDocument = true, + ?string $callingTemplate = null + ): string { if (str_contains($entityName, ' ')) { return self::DEFAULT_URL; } @@ -90,13 +121,18 @@ public function __invoke(RootEntityCollection $rootEntityCollection, string $ent $documentedEntity = $this->documentedEntityWrappersCollection->createAndAddDocumentedEntityWrapper($entity); $rootEntityCollection->add($entity); $url = $this->configuration->getPageLinkProcessor()->getAbsoluteUrl($documentedEntity->getDocUrl()); + $url = $url . $entity->cursorToDocAttributeLinkFragment($cursor); + + $callingTemplate = "{$this->configuration->getOutputDirBaseUrl()}{$callingTemplate}"; + $url = get_relative_path($callingTemplate, $url); } else { $url = $entity->getFileSourceLink(false); + $url = $url . $entity->cursorToDocAttributeLinkFragment($cursor, false); } if (!$url) { return self::DEFAULT_URL; } - return $url . $entity->cursorToDocAttributeLinkFragment($cursor); + return $url; } else { $this->logger->warning( "GetDocumentedEntityUrl: Entity {$entityName} not found in specified sources" diff --git a/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php b/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php index f9512760..d0c743ec 100644 --- a/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php +++ b/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php @@ -36,18 +36,20 @@ public static function getOptions(): array { return [ 'is_safe' => ['html'], + 'needs_context' => true, ]; } /** + * @param array $context * @param RootEntityCollection $rootEntityCollection Processed entity collection * @param string $type List tag type (
      /
        ) * @param bool $skipDescription Don't print description of this entities * @param bool $useFullName Use the full name of the entity in the list * @return string - * @throws InvalidConfigurationParameterException */ public function __invoke( + array $context, RootEntityCollection $rootEntityCollection, string $type = 'ul', bool $skipDescription = false, @@ -62,6 +64,7 @@ public function __invoke( $description = $entity->getDescription(); $descriptionText = call_user_func($this->removeLineBrakes, !$skipDescription && $description ? " - {$description}" : ''); $entityDocUrl = call_user_func_array($this->getDocumentedEntityUrlFunction, [ + $context, $rootEntityCollection, $entity->getName() ]); diff --git a/src/Core/Renderer/Twig/MainTwigEnvironment.php b/src/Core/Renderer/Twig/MainTwigEnvironment.php index e691f8f9..b8e2ec4d 100644 --- a/src/Core/Renderer/Twig/MainTwigEnvironment.php +++ b/src/Core/Renderer/Twig/MainTwigEnvironment.php @@ -17,7 +17,7 @@ final class MainTwigEnvironment { - public const TMP_TEMPLATE_PREFIX = '~bumbleDocGen'; + public const CURRENT_TEMPLATE_NAME_KEY = '__templateName'; private Environment $twig; private bool $isEnvLoaded = false; @@ -78,6 +78,7 @@ public function render($name, array $context = []): string $reflectionProperty->setValue($this->twig, "__TwigTemplate_" . md5($this->twigTemplatePrefixKey)); } + $context[self::CURRENT_TEMPLATE_NAME_KEY] = $name; return $this->twig->render($name, $context); } } diff --git a/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php b/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php index 332d998b..26ba5ebf 100644 --- a/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php +++ b/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php @@ -23,6 +23,8 @@ use BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings; use BumbleDocGen\LanguageHandler\Php\Plugin\Event\Entity\OnCheckIsEntityCanBeLoaded; use DI\Attribute\Inject; +use DI\DependencyException; +use DI\NotFoundException; use phpDocumentor\Reflection\DocBlock; use Psr\Cache\InvalidArgumentException; use Psr\Log\LoggerInterface; @@ -271,15 +273,20 @@ public function isDeprecated(): bool */ public function hasDescriptionLinks(): bool { - return count($this->getDescriptionDocBlockLinks()) > 0; + return count($this->getDescriptionLinks()) > 0; } /** + * Get parsed links from description and doc blocks `see` and `link` + * * @return DocBlockLink[] * + * @api + * + * @throws InvalidConfigurationParameterException * @throws \Exception */ - #[CacheableMethod] protected function getDescriptionDocBlockLinks(): array + #[CacheableMethod] public function getDescriptionLinks(): array { $links = []; $docBlock = $this->getDocBlock(); @@ -406,22 +413,6 @@ className: $className, return $links; } - /** - * Get parsed links from description and doc blocks `see` and `link` - * - * @return DocBlockLink[] - * - * @api - * - * @throws InvalidConfigurationParameterException - * @throws \Exception - */ - public function getDescriptionLinks(): array - { - $linksData = $this->getDescriptionDocBlockLinks(); - return $this->getPreparedDocBlockLinks($linksData); - } - /** * Checking if an entity has `throws` docBlock * @@ -436,11 +427,15 @@ public function hasThrows(): bool } /** + * Get parsed throws from `throws` doc block + * * @return DocBlockLink[] * + * @api + * * @throws InvalidConfigurationParameterException */ - #[CacheableMethod] public function getThrowsDocBlockLinks(): array + #[CacheableMethod] public function getThrows(): array { $throws = []; $implementingClassEntity = $this->getDocCommentEntity()->getCurrentRootEntity(); @@ -473,86 +468,6 @@ className: $className, return $throws; } - /** - * Get parsed throws from `throws` doc block - * - * @return DocBlockLink[] - * - * @api - * - * @throws InvalidConfigurationParameterException - */ - public function getThrows(): array - { - $throwsData = $this->getThrowsDocBlockLinks(); - return $this->getPreparedDocBlockLinks($throwsData); - } - - /** - * @param DocBlockLink[] $docBlockLinks - * - * @return DocBlockLink[] - * - * @throws InvalidConfigurationParameterException - */ - private function getPreparedDocBlockLinks(array $docBlockLinks): array - { - $preparedDocBlockLinksLinks = []; - foreach ($docBlockLinks as $data) { - if ($data->url) { - $preparedDocBlockLinksLinks[] = $data; - continue; - } - - $className = $data->className; - $name = $data->name; - $url = null; - if ($data->className) { - $entityData = $this->getRootEntityCollection()->getEntityLinkData( - $data->className, - $this->getImplementingClass()->getName(), - false - ); - if (!$entityData['entityName'] && !str_contains($data->className, '\\')) { - try { - $className = $this->getDocCommentEntity()->getCurrentRootEntity()->getNamespaceName() . "\\{$data->className}"; - $entityData = $this->getRootEntityCollection()->getEntityLinkData( - $className, - $this->getDocCommentEntity()->getCurrentRootEntity()->getName(), - false - ); - } catch (\Exception $e) { - $this->logger->error($e->getMessage()); - } - } - - if ($entityData['entityName']) { - $url = call_user_func( - $this->documentedEntityUrlFunction, - $this->getRootEntityCollection(), - $entityData['entityName'], - $entityData['cursor'] - ); - } else { - $preloadResourceLink = $this->rendererHelper->getPreloadResourceLink($data->className); - if ($preloadResourceLink) { - $url = $preloadResourceLink; - } else { - $this->logger->warning("Unable to get URL data for entity `{$data->className}`"); - } - } - $name = $entityData['title']; - } - $preparedDocBlockLinksLinks[] = new DocBlockLink( - name: $name, - description: $data->description, - className: $className, - url: $url - ); - } - return $preparedDocBlockLinksLinks; - } - /** * Checking if an entity has `example` docBlock * diff --git a/src/LanguageHandler/Php/Renderer/Twig/Function/DisplayClassApiMethods.php b/src/LanguageHandler/Php/Renderer/Twig/Function/DisplayClassApiMethods.php index b9ef5162..1298c6de 100644 --- a/src/LanguageHandler/Php/Renderer/Twig/Function/DisplayClassApiMethods.php +++ b/src/LanguageHandler/Php/Renderer/Twig/Function/DisplayClassApiMethods.php @@ -20,8 +20,8 @@ final class DisplayClassApiMethods implements CustomFunctionInterface { public function __construct( - private RootEntityCollectionsGroup $rootEntityCollectionsGroup, - private GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, + private readonly RootEntityCollectionsGroup $rootEntityCollectionsGroup, + private readonly GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, ) { } @@ -32,7 +32,9 @@ public static function getName(): string public static function getOptions(): array { - return []; + return [ + 'needs_context' => true, + ]; } /** @@ -42,7 +44,7 @@ public static function getOptions(): array * @throws NotFoundException * @throws InvalidConfigurationParameterException */ - public function __invoke(string $className): ?string + public function __invoke(array $context, string $className): ?string { $entitiesCollection = $this->rootEntityCollectionsGroup->get(PhpEntitiesCollection::NAME); if (!$entitiesCollection) { @@ -55,6 +57,7 @@ public function __invoke(string $className): ?string if ($method->isApi()) { $description = $method->getDescription(); $entityDocUrl = call_user_func_array($this->getDocumentedEntityUrlFunction, [ + $context, $entitiesCollection, $classEntity->getName(), $method->getName() diff --git a/src/LanguageHandler/Php/Renderer/Twig/Function/DrawClassMap.php b/src/LanguageHandler/Php/Renderer/Twig/Function/DrawClassMap.php index e7af807b..c5d3dc3f 100644 --- a/src/LanguageHandler/Php/Renderer/Twig/Function/DrawClassMap.php +++ b/src/LanguageHandler/Php/Renderer/Twig/Function/DrawClassMap.php @@ -27,8 +27,8 @@ final class DrawClassMap implements CustomFunctionInterface private array $fileClassmap; public function __construct( - private GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, - private RootEntityCollectionsGroup $rootEntityCollectionsGroup, + private readonly GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, + private readonly RootEntityCollectionsGroup $rootEntityCollectionsGroup, ) { } @@ -41,24 +41,27 @@ public static function getOptions(): array { return [ 'is_safe' => ['html'], + 'needs_context' => true, ]; } /** + * @param array $context * @param PhpEntitiesCollection ...$entitiesCollections * The collection of entities for which the class map will be generated * @return string * - * @throws NotFoundException * @throws DependencyException * @throws InvalidConfigurationParameterException + * @throws NotFoundException */ public function __invoke( + array $context, PhpEntitiesCollection ...$entitiesCollections, ): string { $structure = $this->convertDirectoryStructureToFormattedString( - $this->getDirectoryStructure(...$entitiesCollections), + $this->getDirectoryStructure($context, ...$entitiesCollections), ); return "
        {$structure}
        "; } @@ -66,12 +69,13 @@ public function __invoke( /** * @throws InvalidConfigurationParameterException */ - protected function appendClassToDirectoryStructure(array $directoryStructure, ClassLikeEntity $classEntity): array + protected function appendClassToDirectoryStructure(array $context, array $directoryStructure, ClassLikeEntity $classEntity): array { $entitiesCollection = $this->rootEntityCollectionsGroup->get(PhpEntitiesCollection::NAME); $this->fileClassmap[$classEntity->getRelativeFileName()] = call_user_func_array( callback: $this->getDocumentedEntityUrlFunction, args: [ + $context, $entitiesCollection, $classEntity->getName() ] @@ -94,7 +98,7 @@ protected function appendClassToDirectoryStructure(array $directoryStructure, Cl * @throws DependencyException * @throws InvalidConfigurationParameterException */ - public function getDirectoryStructure(PhpEntitiesCollection ...$entitiesCollections): array + public function getDirectoryStructure(array $context, PhpEntitiesCollection ...$entitiesCollections): array { $entities = []; foreach ($entitiesCollections as $entitiesCollection) { @@ -108,7 +112,7 @@ public function getDirectoryStructure(PhpEntitiesCollection ...$entitiesCollecti ksort($entities, SORT_STRING); $directoryStructure = []; foreach ($entities as $classEntity) { - $directoryStructure = $this->appendClassToDirectoryStructure($directoryStructure, $classEntity); + $directoryStructure = $this->appendClassToDirectoryStructure($context, $directoryStructure, $classEntity); } return $directoryStructure; } From 1011d7bb84c2df52e2ea106c643d7bb42f5c7415 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Fri, 19 Jan 2024 23:15:40 +0300 Subject: [PATCH 24/32] Change linking method --- .../Twig/Function/DrawDocumentationMenu.php | 27 +++++++++++++++---- .../Twig/Function/GetDocumentedEntityUrl.php | 6 +++-- 2 files changed, 26 insertions(+), 7 deletions(-) diff --git a/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php b/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php index e9cde08e..9637091b 100644 --- a/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php +++ b/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php @@ -10,10 +10,13 @@ use BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory; use BumbleDocGen\Core\Renderer\Context\RendererContext; use BumbleDocGen\Core\Renderer\Twig\Filter\AddIndentFromLeft; +use BumbleDocGen\Core\Renderer\Twig\MainTwigEnvironment; use DI\DependencyException; use DI\NotFoundException; use Symfony\Component\Finder\Finder; +use function BumbleDocGen\Core\get_relative_path; + /** * Generate documentation menu in MD format. To generate the menu, the start page is taken, * and all links with this page are recursively collected for it, after which the html menu is created. @@ -45,10 +48,12 @@ public static function getOptions(): array { return [ 'is_safe' => ['html'], + 'needs_context' => true, ]; } /** + * @param array $context * @param null|string $startPageKey * Relative path to the page from which the menu will be generated (only child pages will be taken into account). * By default, the main documentation page (readme.md) is used. @@ -57,12 +62,15 @@ public static function getOptions(): array * By default, this restriction is disabled. * * @return string - * @throws NotFoundException * @throws DependencyException * @throws InvalidConfigurationParameterException + * @throws NotFoundException */ - public function __invoke(?string $startPageKey = null, ?int $maxDeep = null): string - { + public function __invoke( + array $context, + ?string $startPageKey = null, + ?int $maxDeep = null + ): string { if ($startPageKey) { $startPageKey = str_replace('.twig', '', $startPageKey); } @@ -94,12 +102,21 @@ public function __invoke(?string $startPageKey = null, ?int $maxDeep = null): st } } - $drawPages = function (array $pagesData, int $currentDeep = 1) use ($structure, $maxDeep, &$drawPages): string { + $callingTemplate = $context[MainTwigEnvironment::CURRENT_TEMPLATE_NAME_KEY] ?? null; + if ($callingTemplate) { + $callingTemplate = "{$this->configuration->getOutputDirBaseUrl()}{$callingTemplate}"; + } + + $drawPages = function (array $pagesData, int $currentDeep = 1) use ($callingTemplate, $structure, $maxDeep, &$drawPages): string { $addIndentFromLeft = new AddIndentFromLeft(); $md = ''; foreach ($pagesData as $pageData) { $md .= "\n- "; - $md .= "[{$pageData['title']}]({$pageData['url']})"; + $url = $pageData['url']; + if ($callingTemplate) { + $url = get_relative_path($callingTemplate, $pageData['url']); + } + $md .= "[{$pageData['title']}]({$url})"; if ($structure[$pageData['url']]) { $nextDeep = $currentDeep + 1; if (!$maxDeep || $nextDeep <= $maxDeep) { diff --git a/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php b/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php index 1434814f..31bcaa54 100644 --- a/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php +++ b/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php @@ -123,8 +123,10 @@ public function process( $url = $this->configuration->getPageLinkProcessor()->getAbsoluteUrl($documentedEntity->getDocUrl()); $url = $url . $entity->cursorToDocAttributeLinkFragment($cursor); - $callingTemplate = "{$this->configuration->getOutputDirBaseUrl()}{$callingTemplate}"; - $url = get_relative_path($callingTemplate, $url); + if ($callingTemplate) { + $callingTemplate = "{$this->configuration->getOutputDirBaseUrl()}{$callingTemplate}"; + $url = get_relative_path($callingTemplate, $url); + } } else { $url = $entity->getFileSourceLink(false); $url = $url . $entity->cursorToDocAttributeLinkFragment($cursor, false); From a1aae73f484ea8a5bda97cd5b87fe5fdb02b6ce1 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Fri, 19 Jan 2024 23:16:37 +0300 Subject: [PATCH 25/32] Updating doc --- docs/README.md | 24 +- docs/classes/DocGenerator.md | 2 +- docs/classes/DocGeneratorFactory.md | 2 +- docs/shared_c.cache | 2 +- docs/tech/01_configuration.md | 14 +- .../ClassConstantEntitiesCollection.md | 8 +- .../02_parser/classes/ClassConstantEntity.md | 68 +++-- .../classes/ClassConstantEntity_2.md | 66 ++--- docs/tech/02_parser/classes/ClassEntity.md | 64 ++--- .../tech/02_parser/classes/ClassLikeEntity.md | 62 ++--- docs/tech/02_parser/classes/ConditionGroup.md | 8 +- .../02_parser/classes/ConditionInterface.md | 8 +- docs/tech/02_parser/classes/Configuration.md | 6 +- .../classes/DirectoriesSourceLocator.md | 8 +- .../02_parser/classes/DynamicMethodEntity.md | 8 +- .../tech/02_parser/classes/EntityInterface.md | 100 ++++++++ docs/tech/02_parser/classes/EnumEntity.md | 64 ++--- docs/tech/02_parser/classes/FalseCondition.md | 8 +- .../classes/FileIteratorSourceLocator.md | 8 +- .../classes/FileTextContainsCondition.md | 8 +- .../tech/02_parser/classes/InterfaceEntity.md | 64 ++--- .../02_parser/classes/IsPrivateCondition.md | 8 +- .../02_parser/classes/IsPrivateCondition_2.md | 8 +- .../02_parser/classes/IsPrivateCondition_3.md | 8 +- .../02_parser/classes/IsProtectedCondition.md | 8 +- .../classes/IsProtectedCondition_2.md | 8 +- .../classes/IsProtectedCondition_3.md | 8 +- .../02_parser/classes/IsPublicCondition.md | 8 +- .../02_parser/classes/IsPublicCondition_2.md | 8 +- .../02_parser/classes/IsPublicCondition_3.md | 8 +- .../02_parser/classes/LocatedInCondition.md | 8 +- .../classes/LocatedNotInCondition.md | 8 +- .../classes/MethodEntitiesCollection.md | 8 +- docs/tech/02_parser/classes/MethodEntity.md | 64 ++--- .../classes/OnlyFromCurrentClassCondition.md | 8 +- .../OnlyFromCurrentClassCondition_2.md | 8 +- .../classes/PhpEntitiesCollection.md | 8 +- .../02_parser/classes/PhpHandlerSettings.md | 6 +- docs/tech/02_parser/classes/ProjectParser.md | 6 +- .../classes/PropertyEntitiesCollection.md | 8 +- docs/tech/02_parser/classes/PropertyEntity.md | 66 ++--- .../RecursiveDirectoriesSourceLocator.md | 8 +- .../02_parser/classes/RootEntityCollection.md | 235 ++++++++++++++++++ .../02_parser/classes/RootEntityInterface.md | 6 +- .../classes/SingleFileSourceLocator.md | 8 +- .../classes/SourceLocatorInterface.md | 8 +- docs/tech/02_parser/classes/TraitEntity.md | 64 ++--- docs/tech/02_parser/classes/TrueCondition.md | 8 +- .../02_parser/classes/VisibilityCondition.md | 8 +- .../classes/VisibilityCondition_2.md | 8 +- .../classes/VisibilityCondition_3.md | 8 +- docs/tech/02_parser/entity.md | 30 +-- docs/tech/02_parser/entityFilterCondition.md | 50 ++-- docs/tech/02_parser/readme.md | 34 +-- .../classes/RootEntityCollectionsGroup.md | 8 +- .../php/classes/ClassConstantEntity.md | 72 +++--- .../php/classes/ClassConstantEntity_2.md | 70 +++--- .../reflectionApi/php/classes/ClassEntity.md | 68 +++-- .../php/classes/ClassLikeEntity.md | 68 +++-- .../php/classes/ClassLikeEntity_2.md | 68 +++-- .../php/classes/ClassLikeEntity_3.md | 68 +++-- .../php/classes/ClassLikeEntity_4.md | 68 +++-- .../php/classes/ClassLikeEntity_5.md | 66 ++--- .../php/classes/Configuration.md | 10 +- .../reflectionApi/php/classes/EnumEntity.md | 68 +++-- .../php/classes/InterfaceEntity.md | 68 +++-- .../reflectionApi/php/classes/MethodEntity.md | 68 +++-- .../php/classes/PhpEntitiesCollection.md | 12 +- .../php/classes/PhpHandlerSettings.md | 10 +- .../php/classes/PropertyEntity.md | 70 +++--- .../php/classes/RootEntityInterface.md | 10 +- .../reflectionApi/php/classes/TraitEntity.md | 68 +++-- .../php/phpClassConstantReflectionApi.md | 74 +++--- .../php/phpClassMethodReflectionApi.md | 100 ++++---- .../php/phpClassPropertyReflectionApi.md | 82 +++--- .../php/phpClassReflectionApi.md | 138 +++++----- .../php/phpEntitiesCollection.md | 48 ++-- .../reflectionApi/php/phpEnumReflectionApi.md | 142 +++++------ .../php/phpInterfaceReflectionApi.md | 136 +++++----- .../php/phpTraitReflectionApi.md | 136 +++++----- .../02_parser/reflectionApi/php/readme.md | 10 +- docs/tech/02_parser/reflectionApi/readme.md | 10 +- docs/tech/02_parser/sourceLocator.md | 18 +- .../classes/Configuration.md | 10 +- .../classes/Configuration_2.md | 8 +- .../classes/DocumentedEntityWrapper.md | 8 +- .../DocumentedEntityWrappersCollection.md | 8 +- .../classes/DrawDocumentationMenu.md | 23 +- .../classes/GetDocumentationPageUrl.md | 10 +- .../classes/GetDocumentedEntityUrl.md | 45 +++- .../classes/GetDocumentedEntityUrl_2.md | 43 +++- .../classes/LanguageHandlerInterface.md | 10 +- .../classes/PageHtmlLinkerPlugin.md | 19 +- .../classes/PhpEntitiesCollection.md | 10 +- .../classes/RendererContext.md | 8 +- .../classes/RootEntityInterface.md | 8 +- .../01_howToCreateTemplates/frontMatter.md | 14 +- .../01_howToCreateTemplates/readme.md | 16 +- .../templatesDynamicBlocks.md | 10 +- .../templatesLinking.md | 14 +- .../templatesVariables.md | 12 +- docs/tech/03_renderer/02_breadcrumbs.md | 12 +- docs/tech/03_renderer/03_documentStructure.md | 8 +- docs/tech/03_renderer/04_twigCustomFilters.md | 40 +-- .../03_renderer/05_twigCustomFunctions.md | 128 +++++++--- .../03_renderer/classes/AddIndentFromLeft.md | 8 +- .../03_renderer/classes/BreadcrumbsHelper.md | 54 ++-- .../tech/03_renderer/classes/Configuration.md | 6 +- .../classes/CustomFunctionInterface.md | 8 +- .../classes/DisplayClassApiMethods.md | 13 +- .../classes/DocumentedEntityWrapper.md | 6 +- .../DocumentedEntityWrappersCollection.md | 6 +- docs/tech/03_renderer/classes/DrawClassMap.md | 20 +- .../classes/DrawDocumentationMenu.md | 21 +- .../classes/DrawDocumentedEntityLink.md | 13 +- .../03_renderer/classes/FileGetContents.md | 8 +- docs/tech/03_renderer/classes/FixStrSize.md | 8 +- .../classes/GeneratePageBreadcrumbs.md | 22 +- .../classes/GeneratePageBreadcrumbs_2.md | 22 +- .../classes/GetClassMethodsBodyCode.md | 8 +- .../classes/GetDocumentationPageUrl.md | 8 +- .../classes/GetDocumentedEntityUrl.md | 43 +++- .../classes/GetDocumentedEntityUrl_2.md | 41 ++- docs/tech/03_renderer/classes/Implode.md | 8 +- .../03_renderer/classes/LoadPluginsContent.md | 8 +- .../classes/PhpEntitiesCollection.md | 8 +- docs/tech/03_renderer/classes/PregMatch.md | 8 +- .../03_renderer/classes/PrepareSourceLink.md | 8 +- .../classes/PrintEntityCollectionAsList.md | 13 +- docs/tech/03_renderer/classes/Quotemeta.md | 8 +- .../03_renderer/classes/RemoveLineBrakes.md | 8 +- .../03_renderer/classes/RendererContext.md | 6 +- .../classes/RootEntityCollection.md | 8 +- .../classes/RootEntityInterface.md | 8 +- .../classes/RootEntityInterface_2.md | 6 +- docs/tech/03_renderer/classes/StrTypeToUrl.md | 13 +- docs/tech/03_renderer/readme.md | 24 +- docs/tech/04_pluginSystem.md | 56 ++--- docs/tech/05_console.md | 20 +- docs/tech/06_debugging.md | 8 +- docs/tech/07_outputFormat.md | 8 +- docs/tech/classes/AddDocBlocksCommand.md | 8 +- docs/tech/classes/AddIndentFromLeft.md | 6 +- .../AfterLoadingPhpEntitiesCollection.md | 6 +- docs/tech/classes/AfterRenderingEntities.md | 6 +- docs/tech/classes/App.md | 6 +- docs/tech/classes/BasePageLinkProcessor.md | 6 +- docs/tech/classes/BasePhpStubberPlugin.md | 6 +- docs/tech/classes/BeforeCreatingDocFile.md | 6 +- .../classes/BeforeCreatingEntityDocFile.md | 6 +- docs/tech/classes/BeforeParsingProcess.md | 6 +- docs/tech/classes/BeforeRenderingDocFiles.md | 6 +- docs/tech/classes/BeforeRenderingEntities.md | 6 +- docs/tech/classes/Configuration.md | 6 +- docs/tech/classes/ConfigurationCommand.md | 6 +- docs/tech/classes/Daux.md | 14 +- docs/tech/classes/DocGenerator.md | 6 +- docs/tech/classes/DocumentedEntityWrapper.md | 4 +- .../DocumentedEntityWrappersCollection.md | 4 +- docs/tech/classes/DrawDocumentationMenu.md | 19 +- docs/tech/classes/DrawDocumentedEntityLink.md | 11 +- .../classes/EntityDocUnifiedPlacePlugin.md | 6 +- docs/tech/classes/FileGetContents.md | 6 +- docs/tech/classes/FixStrSize.md | 6 +- docs/tech/classes/GenerateCommand.md | 6 +- docs/tech/classes/GeneratePageBreadcrumbs.md | 20 +- .../classes/GenerateReadMeTemplateCommand.md | 8 +- docs/tech/classes/GetDocumentationPageUrl.md | 6 +- docs/tech/classes/GetDocumentedEntityUrl.md | 41 ++- docs/tech/classes/GetDocumentedEntityUrl_2.md | 39 ++- docs/tech/classes/Implode.md | 6 +- docs/tech/classes/LastPageCommitter.md | 6 +- docs/tech/classes/LoadPluginsContent.md | 6 +- docs/tech/classes/LoadPluginsContent_2.md | 4 +- .../classes/OnAddClassEntityToCollection.md | 6 +- .../classes/OnCheckIsEntityCanBeLoaded.md | 6 +- .../OnCreateDocumentedEntityWrapper.md | 6 +- .../tech/classes/OnGetProjectTemplatesDirs.md | 6 +- .../OnGetTemplatePathByRelativeDocPath.md | 6 +- docs/tech/classes/OnGettingResourceLink.md | 6 +- .../classes/OnLoadEntityDocPluginContent.md | 6 +- docs/tech/classes/PageHtmlLinkerPlugin.md | 15 +- docs/tech/classes/PageHtmlLinkerPlugin_2.md | 15 +- docs/tech/classes/PageLinkerPlugin.md | 15 +- docs/tech/classes/PageLinkerPlugin_2.md | 15 +- docs/tech/classes/PageRstLinkerPlugin.md | 15 +- .../classes/PhpDocumentorStubberPlugin.md | 6 +- docs/tech/classes/PhpUnitStubberPlugin.md | 6 +- docs/tech/classes/PluginInterface.md | 17 ++ docs/tech/classes/PregMatch.md | 6 +- docs/tech/classes/PrepareSourceLink.md | 6 +- .../classes/PrintEntityCollectionAsList.md | 11 +- docs/tech/classes/Quotemeta.md | 6 +- docs/tech/classes/RemoveLineBrakes.md | 6 +- docs/tech/classes/RendererContext.md | 4 +- docs/tech/classes/ServeCommand.md | 6 +- docs/tech/classes/StrTypeToUrl.md | 11 +- docs/tech/classes/StubberPlugin.md | 6 +- docs/tech/readme.md | 18 +- selfdoc/templates/tech/06_debugging.md.twig | 2 +- 200 files changed, 2510 insertions(+), 2208 deletions(-) create mode 100644 docs/tech/02_parser/classes/EntityInterface.md create mode 100644 docs/tech/02_parser/classes/RootEntityCollection.md create mode 100644 docs/tech/classes/PluginInterface.md diff --git a/docs/README.md b/docs/README.md index 8270416f..77ef7327 100644 --- a/docs/README.md +++ b/docs/README.md @@ -31,21 +31,21 @@ composer require bumble-tech/bumble-doc-gen ### Entry points -BumbleDocGen's interface consists of mainly two classes: [DocGenerator](/docs/classes/DocGenerator.md) and [DocGeneratorFactory](/docs/classes/DocGeneratorFactory.md). +BumbleDocGen's interface consists of mainly two classes: [DocGenerator](classes/DocGenerator.md) and [DocGeneratorFactory](classes/DocGeneratorFactory.md). -- [DocGenerator](/docs/classes/DocGenerator.md) provides main operations for generating the documents. +- [DocGenerator](classes/DocGenerator.md) provides main operations for generating the documents. - - [addDocBlocks()](/docs/classes/DocGenerator.md#madddocblocks): Generate missing docBlocks with LLM for project class methods that are available for documentation - - [generate()](/docs/classes/DocGenerator.md#mgenerate): Generates documentation using configuration - - [generateReadmeTemplate()](/docs/classes/DocGenerator.md#mgeneratereadmetemplate): Creates a `README.md` template filled with basic information using LLM - - [serve()](/docs/classes/DocGenerator.md#mserve): Serve documentation + - [addDocBlocks()](classes/DocGenerator.md#madddocblocks): Generate missing docBlocks with LLM for project class methods that are available for documentation + - [generate()](classes/DocGenerator.md#mgenerate): Generates documentation using configuration + - [generateReadmeTemplate()](classes/DocGenerator.md#mgeneratereadmetemplate): Creates a `README.md` template filled with basic information using LLM + - [serve()](classes/DocGenerator.md#mserve): Serve documentation -- [DocGeneratorFactory](/docs/classes/DocGeneratorFactory.md) provides a method for creating `DocGenerator` instance. +- [DocGeneratorFactory](classes/DocGeneratorFactory.md) provides a method for creating `DocGenerator` instance. - - [create()](/docs/classes/DocGeneratorFactory.md#mcreate): Creates a documentation generator instance using configuration files - - [createByConfigArray()](/docs/classes/DocGeneratorFactory.md#mcreatebyconfigarray): Creates a documentation generator instance using an array containing the configuration - - [createConfiguration()](/docs/classes/DocGeneratorFactory.md#mcreateconfiguration): Creating a project configuration instance - - [createRootEntitiesCollection()](/docs/classes/DocGeneratorFactory.md#mcreaterootentitiescollection): Creating a collection of entities (see `ReflectionAPI`) + - [create()](classes/DocGeneratorFactory.md#mcreate): Creates a documentation generator instance using configuration files + - [createByConfigArray()](classes/DocGeneratorFactory.md#mcreatebyconfigarray): Creates a documentation generator instance using an array containing the configuration + - [createConfiguration()](classes/DocGeneratorFactory.md#mcreateconfiguration): Creating a project configuration instance + - [createRootEntitiesCollection()](classes/DocGeneratorFactory.md#mcreaterootentitiescollection): Creating a collection of entities (see `ReflectionAPI`) ### Examples of usage @@ -91,4 +91,4 @@ To update this documentation, run the following command: --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/classes/DocGenerator.md b/docs/classes/DocGenerator.md index 3357fd25..91dac04e 100644 --- a/docs/classes/DocGenerator.md +++ b/docs/classes/DocGenerator.md @@ -1,4 +1,4 @@ -[BumbleDocGen](/docs/README.md) **/** +[BumbleDocGen](../README.md) **/** DocGenerator --- diff --git a/docs/classes/DocGeneratorFactory.md b/docs/classes/DocGeneratorFactory.md index d5ca67f1..86a443f9 100644 --- a/docs/classes/DocGeneratorFactory.md +++ b/docs/classes/DocGeneratorFactory.md @@ -1,4 +1,4 @@ -[BumbleDocGen](/docs/README.md) **/** +[BumbleDocGen](../README.md) **/** DocGeneratorFactory --- diff --git a/docs/shared_c.cache b/docs/shared_c.cache index 69f561b5..b4dea85c 100644 --- a/docs/shared_c.cache +++ b/docs/shared_c.cache @@ -1 +1 @@ -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 \ No newline at end of file +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 \ No newline at end of file diff --git a/docs/tech/01_configuration.md b/docs/tech/01_configuration.md index f9501371..732dc2b5 100644 --- a/docs/tech/01_configuration.md +++ b/docs/tech/01_configuration.md @@ -1,5 +1,5 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** +[BumbleDocGen](../README.md) **/** +[Technical description of the project](readme.md) **/** Configuration --- @@ -85,17 +85,17 @@ The inheritance algorithm is as follows: scalar types can be overwritten by each | **`git_client_path`** | string | 'git' | Path to git client | | **`render_with_front_matter`** | bool | false | Do not remove the front matter block from templates when creating documents | | **`check_file_in_git_before_creating_doc`** | bool | true | Checking if a document exists in GIT before creating a document | -| **`page_link_processor`** | PageLinkProcessorInterface | [BasePageLinkProcessor](/docs/tech/classes/BasePageLinkProcessor.md) | Link handler class on documentation pages | +| **`page_link_processor`** | PageLinkProcessorInterface | [BasePageLinkProcessor](classes/BasePageLinkProcessor.md) | Link handler class on documentation pages | | **`language_handlers`** | array<LanguageHandlerInterface> | NULL | List of programming language handlers | | **`source_locators`** | array<SourceLocatorInterface> | NULL | List of source locators | | **`use_shared_cache`** | bool | true | Enable cache usage of generated documents | -| **`twig_functions`** | array<CustomFunctionInterface> |
        • [DrawDocumentationMenu](/docs/tech/classes/DrawDocumentationMenu.md)
        • [DrawDocumentedEntityLink](/docs/tech/classes/DrawDocumentedEntityLink.md)
        • [GeneratePageBreadcrumbs](/docs/tech/classes/GeneratePageBreadcrumbs.md)
        • [GetDocumentedEntityUrl](/docs/tech/classes/GetDocumentedEntityUrl.md)
        • [LoadPluginsContent](/docs/tech/classes/LoadPluginsContent.md)
        • [PrintEntityCollectionAsList](/docs/tech/classes/PrintEntityCollectionAsList.md)
        • [GetDocumentationPageUrl](/docs/tech/classes/GetDocumentationPageUrl.md)
        • [FileGetContents](/docs/tech/classes/FileGetContents.md)
        | Functions that can be used in document templates | -| **`twig_filters`** | array<CustomFilterInterface> |
        • [AddIndentFromLeft](/docs/tech/classes/AddIndentFromLeft.md)
        • [FixStrSize](/docs/tech/classes/FixStrSize.md)
        • [PrepareSourceLink](/docs/tech/classes/PrepareSourceLink.md)
        • [Quotemeta](/docs/tech/classes/Quotemeta.md)
        • [RemoveLineBrakes](/docs/tech/classes/RemoveLineBrakes.md)
        • [StrTypeToUrl](/docs/tech/classes/StrTypeToUrl.md)
        • [PregMatch](/docs/tech/classes/PregMatch.md)
        • [Implode](/docs/tech/classes/Implode.md)
        | Filters that can be used in document templates | -| **`plugins`** | array<PluginInterface> \| null |
        • [PageHtmlLinkerPlugin](/docs/tech/classes/PageHtmlLinkerPlugin_2.md)
        • [PageLinkerPlugin](/docs/tech/classes/PageLinkerPlugin_2.md)
        | List of plugins | +| **`twig_functions`** | array<CustomFunctionInterface> |
        • [DrawDocumentationMenu](classes/DrawDocumentationMenu.md)
        • [DrawDocumentedEntityLink](classes/DrawDocumentedEntityLink.md)
        • [GeneratePageBreadcrumbs](classes/GeneratePageBreadcrumbs.md)
        • [GetDocumentedEntityUrl](classes/GetDocumentedEntityUrl.md)
        • [LoadPluginsContent](classes/LoadPluginsContent.md)
        • [PrintEntityCollectionAsList](classes/PrintEntityCollectionAsList.md)
        • [GetDocumentationPageUrl](classes/GetDocumentationPageUrl.md)
        • [FileGetContents](classes/FileGetContents.md)
        | Functions that can be used in document templates | +| **`twig_filters`** | array<CustomFilterInterface> |
        • [AddIndentFromLeft](classes/AddIndentFromLeft.md)
        • [FixStrSize](classes/FixStrSize.md)
        • [PrepareSourceLink](classes/PrepareSourceLink.md)
        • [Quotemeta](classes/Quotemeta.md)
        • [RemoveLineBrakes](classes/RemoveLineBrakes.md)
        • [StrTypeToUrl](classes/StrTypeToUrl.md)
        • [PregMatch](classes/PregMatch.md)
        • [Implode](classes/Implode.md)
        | Filters that can be used in document templates | +| **`plugins`** | array<PluginInterface> \| null |
        • [PageHtmlLinkerPlugin](classes/PageHtmlLinkerPlugin_2.md)
        • [PageLinkerPlugin](classes/PageLinkerPlugin_2.md)
        | List of plugins | | **`additional_console_commands`** | array<Command> | NULL | Additional console commands | --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 17:19:08 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 17:19:08 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/classes/ClassConstantEntitiesCollection.md b/docs/tech/02_parser/classes/ClassConstantEntitiesCollection.md index 5d41bec8..47b303cb 100644 --- a/docs/tech/02_parser/classes/ClassConstantEntitiesCollection.md +++ b/docs/tech/02_parser/classes/ClassConstantEntitiesCollection.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entities and entities collections](../entity.md) **/** ClassConstantEntitiesCollection --- diff --git a/docs/tech/02_parser/classes/ClassConstantEntity.md b/docs/tech/02_parser/classes/ClassConstantEntity.md index 83b92e99..538e25f0 100644 --- a/docs/tech/02_parser/classes/ClassConstantEntity.md +++ b/docs/tech/02_parser/classes/ClassConstantEntity.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entities and entities collections](../entity.md) **/** ClassConstantEntity --- @@ -49,7 +49,6 @@ Class constant entity 1. [getShortName](#mgetshortname) - Constant short name 1. [getStartLine](#mgetstartline) - Get the line number of the beginning of the constant code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getType](#mgettype) - Get current class constant type 1. [getValue](#mgetvalue) - Get the compiled value of a constant 1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description @@ -89,7 +88,7 @@ $implementingClassName | [string](https://www.php.net/manual/en/language.types.s --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -122,7 +121,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -133,7 +132,7 @@ public function getCachedEntityDependencies(): array; --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -144,7 +143,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -156,7 +155,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -168,7 +167,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -180,7 +179,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -202,7 +201,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -214,7 +213,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -236,7 +235,7 @@ Get the line number of the end of a constant's code in a file --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -248,7 +247,7 @@ Get parsed examples from `examples` doc block --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -265,7 +264,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -326,7 +325,7 @@ Get the name of the namespace where the current class is implemented --- -# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L185) +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L187) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -338,7 +337,7 @@ Get entity unique ID --- -# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L90) +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L92) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -396,7 +395,7 @@ Get the line number of the beginning of the constant code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -408,17 +407,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getType` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L191) ```php public function getType(): string; @@ -439,7 +427,7 @@ Get the compiled value of a constant --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -451,7 +439,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -463,7 +451,7 @@ Checking if an entity has `example` docBlock --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -475,7 +463,7 @@ Checking if an entity has `throws` docBlock --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -487,7 +475,7 @@ Checking if an entity has `api` docBlock --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -499,7 +487,7 @@ Checking if an entity has `deprecated` docBlock --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -522,7 +510,7 @@ public function isEntityDataCacheOutdated(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -534,7 +522,7 @@ Checking if entity data can be retrieved --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -576,7 +564,7 @@ Check if a constant is a public constant --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/classes/ClassConstantEntity_2.md b/docs/tech/02_parser/classes/ClassConstantEntity_2.md index 61ae7cc9..71578adb 100644 --- a/docs/tech/02_parser/classes/ClassConstantEntity_2.md +++ b/docs/tech/02_parser/classes/ClassConstantEntity_2.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** ClassConstantEntity --- @@ -48,7 +48,6 @@ Class constant entity 1. [getShortName](#mgetshortname) - Constant short name 1. [getStartLine](#mgetstartline) - Get the line number of the beginning of the constant code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getType](#mgettype) - Get current class constant type 1. [getValue](#mgetvalue) - Get the compiled value of a constant 1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description @@ -88,7 +87,7 @@ $implementingClassName | [string](https://www.php.net/manual/en/language.types.s --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -121,7 +120,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -132,7 +131,7 @@ public function getCachedEntityDependencies(): array; --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -143,7 +142,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -155,7 +154,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -167,7 +166,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -179,7 +178,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -201,7 +200,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -213,7 +212,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -235,7 +234,7 @@ Get the line number of the end of a constant's code in a file --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -247,7 +246,7 @@ Get parsed examples from `examples` doc block --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -264,7 +263,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -325,7 +324,7 @@ Get the name of the namespace where the current class is implemented --- -# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L185) +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L187) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -337,7 +336,7 @@ Get entity unique ID --- -# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L90) +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L92) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -395,7 +394,7 @@ Get the line number of the beginning of the constant code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -407,17 +406,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getType` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L191) ```php public function getType(): string; @@ -438,7 +426,7 @@ Get the compiled value of a constant --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -450,7 +438,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -462,7 +450,7 @@ Checking if an entity has `example` docBlock --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -474,7 +462,7 @@ Checking if an entity has `throws` docBlock --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -486,7 +474,7 @@ Checking if an entity has `api` docBlock --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -498,7 +486,7 @@ Checking if an entity has `deprecated` docBlock --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -521,7 +509,7 @@ public function isEntityDataCacheOutdated(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -533,7 +521,7 @@ Checking if entity data can be retrieved --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -575,7 +563,7 @@ Check if a constant is a public constant --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/classes/ClassEntity.md b/docs/tech/02_parser/classes/ClassEntity.md index ecbd0aa9..d7631fd0 100644 --- a/docs/tech/02_parser/classes/ClassEntity.md +++ b/docs/tech/02_parser/classes/ClassEntity.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entities and entities collections](../entity.md) **/** ClassEntity --- @@ -77,7 +77,6 @@ PHP Class 1. [getShortName](#mgetshortname) - Short name of the entity 1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getTraits](#mgettraits) - Get a list of trait entities of the current class 1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names 1. [hasConstant](#mhasconstant) - Check if a constant exists in a class @@ -178,7 +177,7 @@ $isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -213,7 +212,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -330,7 +329,7 @@ $flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get v --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -341,7 +340,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -353,7 +352,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -365,7 +364,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -377,7 +376,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -401,7 +400,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -413,7 +412,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -459,7 +458,7 @@ public function getEntityDependencies(): array; --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -482,7 +481,7 @@ public function getFileContent(): string; --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -499,7 +498,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -860,7 +859,7 @@ Get the line number of the start of a class code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -872,17 +871,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity @@ -926,7 +914,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -938,7 +926,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1006,7 +994,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1058,7 +1046,7 @@ Check that an entity is abstract --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1101,7 +1089,7 @@ public function isClassLoad(): bool; --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1124,7 +1112,7 @@ public function isDocumentCreationAllowed(): bool; --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1158,7 +1146,7 @@ public function isEntityDataCanBeLoaded(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1246,7 +1234,7 @@ Check if an entity is an Interface --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1306,7 +1294,7 @@ $name | [string](https://www.php.net/manual/en/language.types.string.php) | - | --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/classes/ClassLikeEntity.md b/docs/tech/02_parser/classes/ClassLikeEntity.md index e1dd320a..99f06afc 100644 --- a/docs/tech/02_parser/classes/ClassLikeEntity.md +++ b/docs/tech/02_parser/classes/ClassLikeEntity.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** ClassLikeEntity --- @@ -72,7 +72,6 @@ abstract class ClassLikeEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\ 1. [getShortName](#mgetshortname) - Short name of the entity 1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getTraits](#mgettraits) - Get a list of trait entities of the current class 1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names 1. [hasConstant](#mhasconstant) - Check if a constant exists in a class @@ -166,7 +165,7 @@ $isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -199,7 +198,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -304,7 +303,7 @@ $flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get v --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -315,7 +314,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -327,7 +326,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -339,7 +338,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -351,7 +350,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -373,7 +372,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -385,7 +384,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -425,7 +424,7 @@ public function getEntityDependencies(): array; --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -446,7 +445,7 @@ public function getFileContent(): string; --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -463,7 +462,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -782,7 +781,7 @@ Get the line number of the start of a class code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -794,17 +793,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php public function getTraits(): array; @@ -842,7 +830,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -854,7 +842,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -916,7 +904,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -964,7 +952,7 @@ Check that an entity is abstract --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -995,7 +983,7 @@ public function isClassLoad(): bool; --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1016,7 +1004,7 @@ public function isDocumentCreationAllowed(): bool; --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1048,7 +1036,7 @@ public function isEntityDataCanBeLoaded(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1126,7 +1114,7 @@ Check if an entity is an Interface --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1180,7 +1168,7 @@ $name | [string](https://www.php.net/manual/en/language.types.string.php) | - | --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/classes/ConditionGroup.md b/docs/tech/02_parser/classes/ConditionGroup.md index 963588df..d904a5c2 100644 --- a/docs/tech/02_parser/classes/ConditionGroup.md +++ b/docs/tech/02_parser/classes/ConditionGroup.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** ConditionGroup --- diff --git a/docs/tech/02_parser/classes/ConditionInterface.md b/docs/tech/02_parser/classes/ConditionInterface.md index ba535df4..ed7d6748 100644 --- a/docs/tech/02_parser/classes/ConditionInterface.md +++ b/docs/tech/02_parser/classes/ConditionInterface.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** ConditionInterface --- diff --git a/docs/tech/02_parser/classes/Configuration.md b/docs/tech/02_parser/classes/Configuration.md index 04578f83..d9b5884b 100644 --- a/docs/tech/02_parser/classes/Configuration.md +++ b/docs/tech/02_parser/classes/Configuration.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** Configuration --- diff --git a/docs/tech/02_parser/classes/DirectoriesSourceLocator.md b/docs/tech/02_parser/classes/DirectoriesSourceLocator.md index 5dc8786e..f9d3f726 100644 --- a/docs/tech/02_parser/classes/DirectoriesSourceLocator.md +++ b/docs/tech/02_parser/classes/DirectoriesSourceLocator.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Source locators](/docs/tech/02_parser/sourceLocator.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Source locators](../sourceLocator.md) **/** DirectoriesSourceLocator --- diff --git a/docs/tech/02_parser/classes/DynamicMethodEntity.md b/docs/tech/02_parser/classes/DynamicMethodEntity.md index 94405f4d..db67d050 100644 --- a/docs/tech/02_parser/classes/DynamicMethodEntity.md +++ b/docs/tech/02_parser/classes/DynamicMethodEntity.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entities and entities collections](../entity.md) **/** DynamicMethodEntity --- diff --git a/docs/tech/02_parser/classes/EntityInterface.md b/docs/tech/02_parser/classes/EntityInterface.md new file mode 100644 index 00000000..bdaa85e3 --- /dev/null +++ b/docs/tech/02_parser/classes/EntityInterface.md @@ -0,0 +1,100 @@ +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entities and entities collections](../entity.md) **/** +EntityInterface + +--- + + +# [EntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L9) class: + +```php +namespace BumbleDocGen\Core\Parser\Entity; + +interface EntityInterface +``` + +## Methods + +1. [getAbsoluteFileName](#mgetabsolutefilename) - Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +1. [getName](#mgetname) - Full name of the entity +1. [getObjectId](#mgetobjectid) - Entity object ID +1. [getRelativeFileName](#mgetrelativefilename) - File name relative to project_root configuration parameter +1. [getRootEntityCollection](#mgetrootentitycollection) - Get parent collection of entities +1. [getShortName](#mgetshortname) - Short name of the entity +1. [isEntityCacheOutdated](#misentitycacheoutdated) + +## Methods details: + +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L53) +```php +public function getAbsoluteFileName(): null|string; +``` +Returns the absolute path to a file if it can be retrieved and if the file is in the project directory + +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) + +--- + +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L30) +```php +public function getName(): string; +``` +Full name of the entity + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- + +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L16) +```php +public function getObjectId(): string; +``` +Entity object ID + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- + +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L46) +```php +public function getRelativeFileName(): null|string; +``` +File name relative to project_root configuration parameter + +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) + +***Links:*** +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) + +--- + +# `getRootEntityCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L23) +```php +public function getRootEntityCollection(): \BumbleDocGen\Core\Parser\Entity\RootEntityCollection; +``` +Get parent collection of entities + +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) + +--- + +# `getShortName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L37) +```php +public function getShortName(): string; +``` +Short name of the entity + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- + +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntityInterface.php#L58) +```php +public function isEntityCacheOutdated(): bool; +``` + +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) + +--- diff --git a/docs/tech/02_parser/classes/EnumEntity.md b/docs/tech/02_parser/classes/EnumEntity.md index 3b58894e..392f4de4 100644 --- a/docs/tech/02_parser/classes/EnumEntity.md +++ b/docs/tech/02_parser/classes/EnumEntity.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entities and entities collections](../entity.md) **/** EnumEntity --- @@ -80,7 +80,6 @@ Enumeration 1. [getShortName](#mgetshortname) - Short name of the entity 1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getTraits](#mgettraits) - Get a list of trait entities of the current class 1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names 1. [hasConstant](#mhasconstant) - Check if a constant exists in a class @@ -180,7 +179,7 @@ $isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -215,7 +214,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -342,7 +341,7 @@ $flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get v --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -353,7 +352,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -365,7 +364,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -377,7 +376,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -389,7 +388,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -413,7 +412,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -425,7 +424,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -497,7 +496,7 @@ Get enum cases values --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -520,7 +519,7 @@ public function getFileContent(): string; --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -537,7 +536,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -902,7 +901,7 @@ Get the line number of the start of a class code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -914,17 +913,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity @@ -968,7 +956,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -980,7 +968,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1048,7 +1036,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1102,7 +1090,7 @@ Check that an entity is abstract --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1137,7 +1125,7 @@ public function isClassLoad(): bool; --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1160,7 +1148,7 @@ public function isDocumentCreationAllowed(): bool; --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1194,7 +1182,7 @@ public function isEntityDataCanBeLoaded(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1282,7 +1270,7 @@ Check if an entity is an Interface --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1342,7 +1330,7 @@ $name | [string](https://www.php.net/manual/en/language.types.string.php) | - | --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/classes/FalseCondition.md b/docs/tech/02_parser/classes/FalseCondition.md index da95a718..1d396c76 100644 --- a/docs/tech/02_parser/classes/FalseCondition.md +++ b/docs/tech/02_parser/classes/FalseCondition.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** FalseCondition --- diff --git a/docs/tech/02_parser/classes/FileIteratorSourceLocator.md b/docs/tech/02_parser/classes/FileIteratorSourceLocator.md index 83d0afc1..8e6fbcd2 100644 --- a/docs/tech/02_parser/classes/FileIteratorSourceLocator.md +++ b/docs/tech/02_parser/classes/FileIteratorSourceLocator.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Source locators](/docs/tech/02_parser/sourceLocator.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Source locators](../sourceLocator.md) **/** FileIteratorSourceLocator --- diff --git a/docs/tech/02_parser/classes/FileTextContainsCondition.md b/docs/tech/02_parser/classes/FileTextContainsCondition.md index b27c9505..9113eb5b 100644 --- a/docs/tech/02_parser/classes/FileTextContainsCondition.md +++ b/docs/tech/02_parser/classes/FileTextContainsCondition.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** FileTextContainsCondition --- diff --git a/docs/tech/02_parser/classes/InterfaceEntity.md b/docs/tech/02_parser/classes/InterfaceEntity.md index 7466a3b9..b76fa59d 100644 --- a/docs/tech/02_parser/classes/InterfaceEntity.md +++ b/docs/tech/02_parser/classes/InterfaceEntity.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entities and entities collections](../entity.md) **/** InterfaceEntity --- @@ -77,7 +77,6 @@ Object interface 1. [getShortName](#mgetshortname) - Short name of the entity 1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getTraits](#mgettraits) - Get a list of trait entities of the current class 1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names 1. [hasConstant](#mhasconstant) - Check if a constant exists in a class @@ -177,7 +176,7 @@ $isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -212,7 +211,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -329,7 +328,7 @@ $flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get v --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -340,7 +339,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -352,7 +351,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -364,7 +363,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -376,7 +375,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -400,7 +399,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -412,7 +411,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -458,7 +457,7 @@ public function getEntityDependencies(): array; --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -481,7 +480,7 @@ public function getFileContent(): string; --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -498,7 +497,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -865,7 +864,7 @@ Get the line number of the start of a class code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -877,17 +876,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity @@ -929,7 +917,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -941,7 +929,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1009,7 +997,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1061,7 +1049,7 @@ Check that an entity is abstract --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1096,7 +1084,7 @@ public function isClassLoad(): bool; --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1119,7 +1107,7 @@ public function isDocumentCreationAllowed(): bool; --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1153,7 +1141,7 @@ public function isEntityDataCanBeLoaded(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1241,7 +1229,7 @@ Check if an entity is an Interface --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1301,7 +1289,7 @@ $name | [string](https://www.php.net/manual/en/language.types.string.php) | - | --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/classes/IsPrivateCondition.md b/docs/tech/02_parser/classes/IsPrivateCondition.md index 27ca44a1..af9d9e88 100644 --- a/docs/tech/02_parser/classes/IsPrivateCondition.md +++ b/docs/tech/02_parser/classes/IsPrivateCondition.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** IsPrivateCondition --- diff --git a/docs/tech/02_parser/classes/IsPrivateCondition_2.md b/docs/tech/02_parser/classes/IsPrivateCondition_2.md index 92a10b6c..71cab7e6 100644 --- a/docs/tech/02_parser/classes/IsPrivateCondition_2.md +++ b/docs/tech/02_parser/classes/IsPrivateCondition_2.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** IsPrivateCondition --- diff --git a/docs/tech/02_parser/classes/IsPrivateCondition_3.md b/docs/tech/02_parser/classes/IsPrivateCondition_3.md index a566f9fa..e0c3c7f4 100644 --- a/docs/tech/02_parser/classes/IsPrivateCondition_3.md +++ b/docs/tech/02_parser/classes/IsPrivateCondition_3.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** IsPrivateCondition --- diff --git a/docs/tech/02_parser/classes/IsProtectedCondition.md b/docs/tech/02_parser/classes/IsProtectedCondition.md index 968cd669..c93dc86d 100644 --- a/docs/tech/02_parser/classes/IsProtectedCondition.md +++ b/docs/tech/02_parser/classes/IsProtectedCondition.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** IsProtectedCondition --- diff --git a/docs/tech/02_parser/classes/IsProtectedCondition_2.md b/docs/tech/02_parser/classes/IsProtectedCondition_2.md index 276e0a64..7aa7c3d0 100644 --- a/docs/tech/02_parser/classes/IsProtectedCondition_2.md +++ b/docs/tech/02_parser/classes/IsProtectedCondition_2.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** IsProtectedCondition --- diff --git a/docs/tech/02_parser/classes/IsProtectedCondition_3.md b/docs/tech/02_parser/classes/IsProtectedCondition_3.md index 0b790cf3..8fbbb322 100644 --- a/docs/tech/02_parser/classes/IsProtectedCondition_3.md +++ b/docs/tech/02_parser/classes/IsProtectedCondition_3.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** IsProtectedCondition --- diff --git a/docs/tech/02_parser/classes/IsPublicCondition.md b/docs/tech/02_parser/classes/IsPublicCondition.md index 92386e8e..8f21b19b 100644 --- a/docs/tech/02_parser/classes/IsPublicCondition.md +++ b/docs/tech/02_parser/classes/IsPublicCondition.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** IsPublicCondition --- diff --git a/docs/tech/02_parser/classes/IsPublicCondition_2.md b/docs/tech/02_parser/classes/IsPublicCondition_2.md index d5a3b5af..1dda1957 100644 --- a/docs/tech/02_parser/classes/IsPublicCondition_2.md +++ b/docs/tech/02_parser/classes/IsPublicCondition_2.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** IsPublicCondition --- diff --git a/docs/tech/02_parser/classes/IsPublicCondition_3.md b/docs/tech/02_parser/classes/IsPublicCondition_3.md index 94df41ce..8d8efa2b 100644 --- a/docs/tech/02_parser/classes/IsPublicCondition_3.md +++ b/docs/tech/02_parser/classes/IsPublicCondition_3.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** IsPublicCondition --- diff --git a/docs/tech/02_parser/classes/LocatedInCondition.md b/docs/tech/02_parser/classes/LocatedInCondition.md index 2a66b34a..ca0ef1c3 100644 --- a/docs/tech/02_parser/classes/LocatedInCondition.md +++ b/docs/tech/02_parser/classes/LocatedInCondition.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** LocatedInCondition --- diff --git a/docs/tech/02_parser/classes/LocatedNotInCondition.md b/docs/tech/02_parser/classes/LocatedNotInCondition.md index d55a8bbf..80caae69 100644 --- a/docs/tech/02_parser/classes/LocatedNotInCondition.md +++ b/docs/tech/02_parser/classes/LocatedNotInCondition.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** LocatedNotInCondition --- diff --git a/docs/tech/02_parser/classes/MethodEntitiesCollection.md b/docs/tech/02_parser/classes/MethodEntitiesCollection.md index 9d3c00a7..044ecdc4 100644 --- a/docs/tech/02_parser/classes/MethodEntitiesCollection.md +++ b/docs/tech/02_parser/classes/MethodEntitiesCollection.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entities and entities collections](../entity.md) **/** MethodEntitiesCollection --- diff --git a/docs/tech/02_parser/classes/MethodEntity.md b/docs/tech/02_parser/classes/MethodEntity.md index 88796e0c..88557582 100644 --- a/docs/tech/02_parser/classes/MethodEntity.md +++ b/docs/tech/02_parser/classes/MethodEntity.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entities and entities collections](../entity.md) **/** MethodEntity --- @@ -57,7 +57,6 @@ Class method entity 1. [getStartColumn](#mgetstartcolumn) - Get the column number of the beginning of the method code in a file 1. [getStartLine](#mgetstartline) - Get the line number of the beginning of the entity code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description 1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock 1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock @@ -101,7 +100,7 @@ $implementingClassName | [string](https://www.php.net/manual/en/language.types.s --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -144,7 +143,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -155,7 +154,7 @@ public function getCachedEntityDependencies(): array; --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -166,7 +165,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -178,7 +177,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -190,7 +189,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -202,7 +201,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -233,7 +232,7 @@ public function getDocCommentLine(): null|int; --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -255,7 +254,7 @@ Get the line number of the end of a method's code in a file --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -267,7 +266,7 @@ Get parsed examples from `examples` doc block --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -284,7 +283,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -356,7 +355,7 @@ Namespace of the class that contains this method --- -# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L185) +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L187) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -480,7 +479,7 @@ Get the line number of the beginning of the entity code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -492,18 +491,7 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -515,7 +503,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -527,7 +515,7 @@ Checking if an entity has `example` docBlock --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -539,7 +527,7 @@ Checking if an entity has `throws` docBlock --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -561,7 +549,7 @@ Checking that a method is a constructor --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -583,7 +571,7 @@ Check if a method is a dynamic method, that is, implementable using __call or __ --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -606,7 +594,7 @@ public function isEntityDataCacheOutdated(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -638,7 +626,7 @@ Check if a method is an initialization method --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -690,7 +678,7 @@ Check if this method is static --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition.md b/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition.md index 0901bb75..424a7719 100644 --- a/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition.md +++ b/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** OnlyFromCurrentClassCondition --- diff --git a/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition_2.md b/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition_2.md index a212ea6b..24c32a32 100644 --- a/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition_2.md +++ b/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition_2.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** OnlyFromCurrentClassCondition --- diff --git a/docs/tech/02_parser/classes/PhpEntitiesCollection.md b/docs/tech/02_parser/classes/PhpEntitiesCollection.md index 7c4ecb6b..cbe197f4 100644 --- a/docs/tech/02_parser/classes/PhpEntitiesCollection.md +++ b/docs/tech/02_parser/classes/PhpEntitiesCollection.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entities and entities collections](../entity.md) **/** PhpEntitiesCollection --- diff --git a/docs/tech/02_parser/classes/PhpHandlerSettings.md b/docs/tech/02_parser/classes/PhpHandlerSettings.md index 06fe9c9b..4b932fc7 100644 --- a/docs/tech/02_parser/classes/PhpHandlerSettings.md +++ b/docs/tech/02_parser/classes/PhpHandlerSettings.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** PhpHandlerSettings --- diff --git a/docs/tech/02_parser/classes/ProjectParser.md b/docs/tech/02_parser/classes/ProjectParser.md index 57e20108..3ca2966a 100644 --- a/docs/tech/02_parser/classes/ProjectParser.md +++ b/docs/tech/02_parser/classes/ProjectParser.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** ProjectParser --- diff --git a/docs/tech/02_parser/classes/PropertyEntitiesCollection.md b/docs/tech/02_parser/classes/PropertyEntitiesCollection.md index 057c5797..a200eaa0 100644 --- a/docs/tech/02_parser/classes/PropertyEntitiesCollection.md +++ b/docs/tech/02_parser/classes/PropertyEntitiesCollection.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entities and entities collections](../entity.md) **/** PropertyEntitiesCollection --- diff --git a/docs/tech/02_parser/classes/PropertyEntity.md b/docs/tech/02_parser/classes/PropertyEntity.md index 8cb54eff..ae916554 100644 --- a/docs/tech/02_parser/classes/PropertyEntity.md +++ b/docs/tech/02_parser/classes/PropertyEntity.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entities and entities collections](../entity.md) **/** PropertyEntity --- @@ -50,7 +50,6 @@ Class property entity 1. [getShortName](#mgetshortname) - Short name of the entity 1. [getStartLine](#mgetstartline) - Get the line number of the beginning of the entity code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getType](#mgettype) - Get current property type 1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description 1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock @@ -90,7 +89,7 @@ $implementingClassName | [string](https://www.php.net/manual/en/language.types.s --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -123,7 +122,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -134,7 +133,7 @@ public function getCachedEntityDependencies(): array; --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -155,7 +154,7 @@ Get the compiled default value of a property --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -167,7 +166,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -179,7 +178,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -191,7 +190,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -213,7 +212,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -225,7 +224,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -247,7 +246,7 @@ Get the line number of the end of a property's code in a file --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -259,7 +258,7 @@ Get parsed examples from `examples` doc block --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -276,7 +275,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -338,7 +337,7 @@ Namespace of the class that contains this property --- -# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L185) +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L187) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -402,7 +401,7 @@ Get the line number of the beginning of the entity code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -414,17 +413,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getType` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L231) ```php public function getType(): string; @@ -435,7 +423,7 @@ Get current property type --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -447,7 +435,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -459,7 +447,7 @@ Checking if an entity has `example` docBlock --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -471,7 +459,7 @@ Checking if an entity has `throws` docBlock --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -483,7 +471,7 @@ Checking if an entity has `api` docBlock --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -495,7 +483,7 @@ Checking if an entity has `deprecated` docBlock --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -518,7 +506,7 @@ public function isEntityDataCacheOutdated(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -540,7 +528,7 @@ Check if this property is implemented in the parent class --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -582,7 +570,7 @@ Check if a property is a public property --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/classes/RecursiveDirectoriesSourceLocator.md b/docs/tech/02_parser/classes/RecursiveDirectoriesSourceLocator.md index e2deb84a..9ba79b42 100644 --- a/docs/tech/02_parser/classes/RecursiveDirectoriesSourceLocator.md +++ b/docs/tech/02_parser/classes/RecursiveDirectoriesSourceLocator.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Source locators](/docs/tech/02_parser/sourceLocator.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Source locators](../sourceLocator.md) **/** RecursiveDirectoriesSourceLocator --- diff --git a/docs/tech/02_parser/classes/RootEntityCollection.md b/docs/tech/02_parser/classes/RootEntityCollection.md new file mode 100644 index 00000000..1eb28dc3 --- /dev/null +++ b/docs/tech/02_parser/classes/RootEntityCollection.md @@ -0,0 +1,235 @@ +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entities and entities collections](../entity.md) **/** +RootEntityCollection + +--- + + +# [RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L18) class: + +```php +namespace BumbleDocGen\Core\Parser\Entity; + +abstract class RootEntityCollection extends \BumbleDocGen\Core\Parser\Entity\BaseEntityCollection implements \IteratorAggregate +``` + +## Methods + +1. [findEntity](#mfindentity) - Find an entity in a collection +1. [get](#mget) - Get an entity from a collection (only previously added) +1. [getEntityCollectionName](#mgetentitycollectionname) - Get collection name +1. [getEntityLinkData](#mgetentitylinkdata) +1. [getIterator](#mgetiterator) +1. [getLoadedOrCreateNew](#mgetloadedorcreatenew) - Get an entity from the collection or create a new one if it has not yet been added +1. [has](#mhas) - Check if an entity has been added to the collection +1. [isEmpty](#misempty) - Check if the collection is empty or not +1. [loadEntities](#mloadentities) +1. [loadEntitiesByConfiguration](#mloadentitiesbyconfiguration) +1. [remove](#mremove) - Remove an entity from a collection +1. [removeAllNotLoadedEntities](#mremoveallnotloadedentities) +1. [toArray](#mtoarray) - Convert collection to array +1. [updateEntitiesCache](#mupdateentitiescache) + +## Methods details: + +# `findEntity` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L76) +```php +public function findEntity(string $search, bool $useUnsafeKeys = true): null|\BumbleDocGen\Core\Parser\Entity\RootEntityInterface; +``` +Find an entity in a collection + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$search | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$useUnsafeKeys | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | + +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) + +--- + +# `get` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L49) +```php +public function get(string $objectName): null|\BumbleDocGen\Core\Parser\Entity\RootEntityInterface; +``` +Get an entity from a collection (only previously added) + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | + +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) + +--- + +# `getEntityCollectionName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L39) +```php +public function getEntityCollectionName(): string; +``` +Get collection name + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- + +# `getEntityLinkData` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L90) +```php +public function getEntityLinkData(string $rawLink, string|null $defaultEntityName = null, bool $useUnsafeKeys = true): array; +``` + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$rawLink | [string](https://www.php.net/manual/en/language.types.string.php) | Raw link to an entity or entity element | +$defaultEntityName | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Entity name to use if the link does not contain a valid or existing entity name, + but only a cursor on an entity element | +$useUnsafeKeys | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | + +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) + +--- + +# `getIterator` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L11) +```php +// Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection + +public function getIterator(): \Generator; +``` + +***Return value:*** [\Generator](https://www.php.net/manual/en/language.generators.overview.php) + +--- + +# `getLoadedOrCreateNew` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L67) +```php +public function getLoadedOrCreateNew(string $objectName, bool $withAddClassEntityToCollectionEvent = false): \BumbleDocGen\Core\Parser\Entity\RootEntityInterface; +``` +Get an entity from the collection or create a new one if it has not yet been added + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$withAddClassEntityToCollectionEvent | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | + +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) + +***Links:*** +- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](/docs/tech/02_parser/classes/RootEntityInterface.md#misentitydatacanbeloaded) + +--- + +# `has` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L42) +```php +// Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection + +public function has(string $objectName): bool; +``` +Check if an entity has been added to the collection + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | + +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) + +--- + +# `isEmpty` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L52) +```php +// Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection + +public function isEmpty(): bool; +``` +Check if the collection is empty or not + +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) + +--- + +# `loadEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L28) +```php +public function loadEntities(\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection $sourceLocatorsCollection, \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface|null $filters = null, \BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface|null $progressBar = null): \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult; +``` + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$sourceLocatorsCollection | [\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/SourceLocatorsCollection.php) | - | +$filters | [\BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/FilterCondition/ConditionInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | +$progressBar | [\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntitiesLoaderProgressBarInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | + +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionLoadEntitiesResult.php) + +--- + +# `loadEntitiesByConfiguration` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L26) +```php +public function loadEntitiesByConfiguration(\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface|null $progressBar = null): \BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult; +``` + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$progressBar | [\BumbleDocGen\Core\Parser\Entity\EntitiesLoaderProgressBarInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/EntitiesLoaderProgressBarInterface.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | + +***Return value:*** [\BumbleDocGen\Core\Parser\Entity\CollectionLoadEntitiesResult](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/CollectionLoadEntitiesResult.php) + +--- + +# `remove` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/BaseEntityCollection.php#L32) +```php +// Implemented in BumbleDocGen\Core\Parser\Entity\BaseEntityCollection + +public function remove(string $objectName): void; +``` +Remove an entity from a collection + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$objectName | [string](https://www.php.net/manual/en/language.types.string.php) | - | + +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) + +--- + +# `removeAllNotLoadedEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L132) +```php +public function removeAllNotLoadedEntities(): void; +``` + +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) + +--- + +# `toArray` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L127) +```php +public function toArray(): array; +``` +Convert collection to array + +***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) + +--- + +# `updateEntitiesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php#L97) +```php +public function updateEntitiesCache(): void; +``` + +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) + +--- diff --git a/docs/tech/02_parser/classes/RootEntityInterface.md b/docs/tech/02_parser/classes/RootEntityInterface.md index c8c6a137..6e23542a 100644 --- a/docs/tech/02_parser/classes/RootEntityInterface.md +++ b/docs/tech/02_parser/classes/RootEntityInterface.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** RootEntityInterface --- diff --git a/docs/tech/02_parser/classes/SingleFileSourceLocator.md b/docs/tech/02_parser/classes/SingleFileSourceLocator.md index 06464283..9627512f 100644 --- a/docs/tech/02_parser/classes/SingleFileSourceLocator.md +++ b/docs/tech/02_parser/classes/SingleFileSourceLocator.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Source locators](/docs/tech/02_parser/sourceLocator.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Source locators](../sourceLocator.md) **/** SingleFileSourceLocator --- diff --git a/docs/tech/02_parser/classes/SourceLocatorInterface.md b/docs/tech/02_parser/classes/SourceLocatorInterface.md index 169743cb..6ea09a51 100644 --- a/docs/tech/02_parser/classes/SourceLocatorInterface.md +++ b/docs/tech/02_parser/classes/SourceLocatorInterface.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Source locators](/docs/tech/02_parser/sourceLocator.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Source locators](../sourceLocator.md) **/** SourceLocatorInterface --- diff --git a/docs/tech/02_parser/classes/TraitEntity.md b/docs/tech/02_parser/classes/TraitEntity.md index 82b35b1f..1072a329 100644 --- a/docs/tech/02_parser/classes/TraitEntity.md +++ b/docs/tech/02_parser/classes/TraitEntity.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entities and entities collections](/docs/tech/02_parser/entity.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entities and entities collections](../entity.md) **/** TraitEntity --- @@ -77,7 +77,6 @@ Trait 1. [getShortName](#mgetshortname) - Short name of the entity 1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getTraits](#mgettraits) - Get a list of trait entities of the current class 1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names 1. [hasConstant](#mhasconstant) - Check if a constant exists in a class @@ -177,7 +176,7 @@ $isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -212,7 +211,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -329,7 +328,7 @@ $flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get v --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -340,7 +339,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -352,7 +351,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -364,7 +363,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -376,7 +375,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -400,7 +399,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -412,7 +411,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -458,7 +457,7 @@ public function getEntityDependencies(): array; --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -481,7 +480,7 @@ public function getFileContent(): string; --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -498,7 +497,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -863,7 +862,7 @@ Get the line number of the start of a class code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -875,17 +874,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity @@ -929,7 +917,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -941,7 +929,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1009,7 +997,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1063,7 +1051,7 @@ Check that an entity is abstract --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1098,7 +1086,7 @@ public function isClassLoad(): bool; --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1121,7 +1109,7 @@ public function isDocumentCreationAllowed(): bool; --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1155,7 +1143,7 @@ public function isEntityDataCanBeLoaded(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1245,7 +1233,7 @@ Check if an entity is an Interface --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1301,7 +1289,7 @@ $name | [string](https://www.php.net/manual/en/language.types.string.php) | - | --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/classes/TrueCondition.md b/docs/tech/02_parser/classes/TrueCondition.md index 856c8ed5..033e6975 100644 --- a/docs/tech/02_parser/classes/TrueCondition.md +++ b/docs/tech/02_parser/classes/TrueCondition.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** TrueCondition --- diff --git a/docs/tech/02_parser/classes/VisibilityCondition.md b/docs/tech/02_parser/classes/VisibilityCondition.md index f3395bfa..2a418c5d 100644 --- a/docs/tech/02_parser/classes/VisibilityCondition.md +++ b/docs/tech/02_parser/classes/VisibilityCondition.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** VisibilityCondition --- diff --git a/docs/tech/02_parser/classes/VisibilityCondition_2.md b/docs/tech/02_parser/classes/VisibilityCondition_2.md index fdce542c..a7e85599 100644 --- a/docs/tech/02_parser/classes/VisibilityCondition_2.md +++ b/docs/tech/02_parser/classes/VisibilityCondition_2.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** VisibilityCondition --- diff --git a/docs/tech/02_parser/classes/VisibilityCondition_3.md b/docs/tech/02_parser/classes/VisibilityCondition_3.md index 820e80bc..ee1cfa7b 100644 --- a/docs/tech/02_parser/classes/VisibilityCondition_3.md +++ b/docs/tech/02_parser/classes/VisibilityCondition_3.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** +[Entity filter conditions](../entityFilterCondition.md) **/** VisibilityCondition --- diff --git a/docs/tech/02_parser/entity.md b/docs/tech/02_parser/entity.md index b9df364d..328c0460 100644 --- a/docs/tech/02_parser/entity.md +++ b/docs/tech/02_parser/entity.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Parser](readme.md) **/** Entities and entities collections --- @@ -55,29 +55,29 @@ Entities are always handled through collections. Collections are the result of t To further facilitate the handling of these entities, we utilize entity collections. These collections not only group relevant entities together but also provide convenient methods for filtering and manipulating these entities. -The root collections ([a]RootEntityCollection[/a]), which are directly accessible in your templates, are as follows: +The root collections ([RootEntityCollection](classes/RootEntityCollection.md)), which are directly accessible in your templates, are as follows: | Collection class | Name in twig template | PL | Description | |-|-|-|-| -| PhpEntitiesCollection | **phpEntities** | PHP | Collection of php root entities | +| [PhpEntitiesCollection](classes/PhpEntitiesCollection.md) | **phpEntities** | PHP | Collection of php root entities | ## Available entities -Following is the list of available entities that are consistent with [a]EntityInterface[/a] and can be created. +Following is the list of available entities that are consistent with [EntityInterface](classes/EntityInterface.md) and can be created. These classes are a convenient wrapper for accessing data in templates: | Entity name | Collection name | Is root | PL | Description | |-|-|-|-|-| -| ClassEntity | PhpEntitiesCollection | yes | PHP | PHP Class | -| EnumEntity | PhpEntitiesCollection | yes | PHP | Enumeration | -| InterfaceEntity | PhpEntitiesCollection | yes | PHP | Object interface | -| TraitEntity | PhpEntitiesCollection | yes | PHP | Trait | -| ClassConstantEntity | ClassConstantEntitiesCollection | no | PHP | Class constant entity | -| DynamicMethodEntity | MethodEntitiesCollection | no | PHP | Method obtained by parsing the "method" annotation | -| MethodEntity | MethodEntitiesCollection | no | PHP | Class method entity | -| PropertyEntity | PropertyEntitiesCollection | no | PHP | Class property entity | +| [ClassEntity](classes/ClassEntity.md) | [PhpEntitiesCollection](classes/PhpEntitiesCollection.md) | yes | PHP | PHP Class | +| [EnumEntity](classes/EnumEntity.md) | [PhpEntitiesCollection](classes/PhpEntitiesCollection.md) | yes | PHP | Enumeration | +| [InterfaceEntity](classes/InterfaceEntity.md) | [PhpEntitiesCollection](classes/PhpEntitiesCollection.md) | yes | PHP | Object interface | +| [TraitEntity](classes/TraitEntity.md) | [PhpEntitiesCollection](classes/PhpEntitiesCollection.md) | yes | PHP | Trait | +| [ClassConstantEntity](classes/ClassConstantEntity.md) | [ClassConstantEntitiesCollection](classes/ClassConstantEntitiesCollection.md) | no | PHP | Class constant entity | +| [DynamicMethodEntity](classes/DynamicMethodEntity.md) | [MethodEntitiesCollection](classes/MethodEntitiesCollection.md) | no | PHP | Method obtained by parsing the "method" annotation | +| [MethodEntity](classes/MethodEntity.md) | [MethodEntitiesCollection](classes/MethodEntitiesCollection.md) | no | PHP | Class method entity | +| [PropertyEntity](classes/PropertyEntity.md) | [PropertyEntitiesCollection](classes/PropertyEntitiesCollection.md) | no | PHP | Class property entity | --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 17:19:08 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 17:19:08 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/entityFilterCondition.md b/docs/tech/02_parser/entityFilterCondition.md index 2e0a7c6b..2877d19d 100644 --- a/docs/tech/02_parser/entityFilterCondition.md +++ b/docs/tech/02_parser/entityFilterCondition.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Parser](readme.md) **/** Entity filter conditions --- @@ -13,7 +13,7 @@ These rules facilitate a strategic extraction of elements, such as classes, meth By implementing these filters, users are endowed with the capability to customize the documentation output, ensuring that it precisely aligns with their requirements and expectations. This level of granularity not only streamlines the documentation process but also guarantees that the resultant documents are devoid of superfluous details, focusing solely on pertinent information. -All filter conditions implement the [ConditionInterface](/docs/tech/02_parser/classes/ConditionInterface.md) interface. +All filter conditions implement the [ConditionInterface](classes/ConditionInterface.md) interface. ## Mechanism for adding entities to the collection @@ -74,38 +74,38 @@ language_handlers: Common filtering conditions that are available for any entity: -- [FalseCondition](/docs/tech/02_parser/classes/FalseCondition.md) - False conditions, any object is not available -- [FileTextContainsCondition](/docs/tech/02_parser/classes/FileTextContainsCondition.md) - Checking if a file contains a substring -- [LocatedInCondition](/docs/tech/02_parser/classes/LocatedInCondition.md) - Checking the existence of an entity in the specified directories -- [LocatedNotInCondition](/docs/tech/02_parser/classes/LocatedNotInCondition.md) - Checking the existence of an entity not in the specified directories -- [TrueCondition](/docs/tech/02_parser/classes/TrueCondition.md) - True conditions, any object is available -- [ConditionGroup](/docs/tech/02_parser/classes/ConditionGroup.md) - Filter condition to group other filter conditions. A group can have an OR/AND condition test; In the case of OR, it is enough to successfully check at least one condition, in the case of AND, all checks must be successfully completed. +- [FalseCondition](classes/FalseCondition.md) - False conditions, any object is not available +- [FileTextContainsCondition](classes/FileTextContainsCondition.md) - Checking if a file contains a substring +- [LocatedInCondition](classes/LocatedInCondition.md) - Checking the existence of an entity in the specified directories +- [LocatedNotInCondition](classes/LocatedNotInCondition.md) - Checking the existence of an entity not in the specified directories +- [TrueCondition](classes/TrueCondition.md) - True conditions, any object is available +- [ConditionGroup](classes/ConditionGroup.md) - Filter condition to group other filter conditions. A group can have an OR/AND condition test; In the case of OR, it is enough to successfully check at least one condition, in the case of AND, all checks must be successfully completed. Filter condition for working with entities PHP language handler: | Group name | Class short name | Description | |-|-|-| -| **ClassConstantFilterCondition** | [IsPrivateCondition](/docs/tech/02_parser/classes/IsPrivateCondition.md) | Check is a private constant or not | -| | [IsProtectedCondition](/docs/tech/02_parser/classes/IsProtectedCondition.md) | Check is a protected constant or not | -| | [IsPublicCondition](/docs/tech/02_parser/classes/IsPublicCondition.md) | Check is a public constant or not | -| | [VisibilityCondition](/docs/tech/02_parser/classes/VisibilityCondition.md) | Constant access modifier check | +| **ClassConstantFilterCondition** | [IsPrivateCondition](classes/IsPrivateCondition.md) | Check is a private constant or not | +| | [IsProtectedCondition](classes/IsProtectedCondition.md) | Check is a protected constant or not | +| | [IsPublicCondition](classes/IsPublicCondition.md) | Check is a public constant or not | +| | [VisibilityCondition](classes/VisibilityCondition.md) | Constant access modifier check | | | | | -| **MethodFilterCondition** | [IsPrivateCondition](/docs/tech/02_parser/classes/IsPrivateCondition_2.md) | Check is a private method or not | -| | [IsProtectedCondition](/docs/tech/02_parser/classes/IsProtectedCondition_2.md) | Check is a protected method or not | -| | [IsPublicCondition](/docs/tech/02_parser/classes/IsPublicCondition_2.md) | Check is a public method or not | -| | [OnlyFromCurrentClassCondition](/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition.md) | Only methods that belong to the current class (not parent) | -| | [VisibilityCondition](/docs/tech/02_parser/classes/VisibilityCondition_2.md) | Method access modifier check | +| **MethodFilterCondition** | [IsPrivateCondition](classes/IsPrivateCondition_2.md) | Check is a private method or not | +| | [IsProtectedCondition](classes/IsProtectedCondition_2.md) | Check is a protected method or not | +| | [IsPublicCondition](classes/IsPublicCondition_2.md) | Check is a public method or not | +| | [OnlyFromCurrentClassCondition](classes/OnlyFromCurrentClassCondition.md) | Only methods that belong to the current class (not parent) | +| | [VisibilityCondition](classes/VisibilityCondition_2.md) | Method access modifier check | | | | | -| **PropertyFilterCondition** | [IsPrivateCondition](/docs/tech/02_parser/classes/IsPrivateCondition_3.md) | Check is a private property or not | -| | [IsProtectedCondition](/docs/tech/02_parser/classes/IsProtectedCondition_3.md) | Check is a protected property or not | -| | [IsPublicCondition](/docs/tech/02_parser/classes/IsPublicCondition_3.md) | Check is a public property or not | -| | [OnlyFromCurrentClassCondition](/docs/tech/02_parser/classes/OnlyFromCurrentClassCondition_2.md) | Only properties that belong to the current class (not parent) | -| | [VisibilityCondition](/docs/tech/02_parser/classes/VisibilityCondition_3.md) | Property access modifier check | +| **PropertyFilterCondition** | [IsPrivateCondition](classes/IsPrivateCondition_3.md) | Check is a private property or not | +| | [IsProtectedCondition](classes/IsProtectedCondition_3.md) | Check is a protected property or not | +| | [IsPublicCondition](classes/IsPublicCondition_3.md) | Check is a public property or not | +| | [OnlyFromCurrentClassCondition](classes/OnlyFromCurrentClassCondition_2.md) | Only properties that belong to the current class (not parent) | +| | [VisibilityCondition](classes/VisibilityCondition_3.md) | Property access modifier check | | | | | --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/readme.md b/docs/tech/02_parser/readme.md index 8c600502..2aa9466a 100644 --- a/docs/tech/02_parser/readme.md +++ b/docs/tech/02_parser/readme.md @@ -1,5 +1,5 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** Parser --- @@ -7,7 +7,7 @@ Parser # Documentation parser -Most often, we need [ProjectParser](/docs/tech/02_parser/classes/ProjectParser.md) in order to get a list of entities for documentation. +Most often, we need [ProjectParser](classes/ProjectParser.md) in order to get a list of entities for documentation. But this is not the only use of this tool. The result of the parser's work (a collection of entities) can be used to programmatically analyze the project and perform any operations based on this analysis. For example, in our documentation generator, we also use the result of the parser in the tasks of generating documentation using AI tools. You can also use the parser for your own purposes other than generating documentation. @@ -17,19 +17,19 @@ In this section, we show how the parser works and what components it consists of ## Description of the main components of the parser -- [Entities and entities collections](/docs/tech/02_parser/entity.md) -- [Entity filter conditions](/docs/tech/02_parser/entityFilterCondition.md) -- [Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) - - [Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) - - [PHP class constant reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md) - - [PHP class method reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md) - - [PHP class property reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md) - - [PHP class reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md) - - [PHP entities collection](/docs/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md) - - [PHP enum reflection API](/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md) - - [PHP interface reflection API](/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md) - - [PHP trait reflection API](/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md) -- [Source locators](/docs/tech/02_parser/sourceLocator.md) +- [Entities and entities collections](entity.md) +- [Entity filter conditions](entityFilterCondition.md) +- [Reflection API](reflectionApi/readme.md) + - [Reflection API for PHP](reflectionApi/php/readme.md) + - [PHP class constant reflection API](reflectionApi/php/phpClassConstantReflectionApi.md) + - [PHP class method reflection API](reflectionApi/php/phpClassMethodReflectionApi.md) + - [PHP class property reflection API](reflectionApi/php/phpClassPropertyReflectionApi.md) + - [PHP class reflection API](reflectionApi/php/phpClassReflectionApi.md) + - [PHP entities collection](reflectionApi/php/phpEntitiesCollection.md) + - [PHP enum reflection API](reflectionApi/php/phpEnumReflectionApi.md) + - [PHP interface reflection API](reflectionApi/php/phpInterfaceReflectionApi.md) + - [PHP trait reflection API](reflectionApi/php/phpTraitReflectionApi.md) +- [Source locators](sourceLocator.md) ## Starting the parsing process @@ -59,4 +59,4 @@ $rootEntityCollectionsGroup = $this->parser->getRootEntityCollectionsGroup(); --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/classes/RootEntityCollectionsGroup.md b/docs/tech/02_parser/reflectionApi/classes/RootEntityCollectionsGroup.md index 29b6ce38..4ea1432c 100644 --- a/docs/tech/02_parser/reflectionApi/classes/RootEntityCollectionsGroup.md +++ b/docs/tech/02_parser/reflectionApi/classes/RootEntityCollectionsGroup.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Parser](../../readme.md) **/** +[Reflection API](../readme.md) **/** RootEntityCollectionsGroup --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md index 044f4972..9133a9c0 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md @@ -1,9 +1,9 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** -[PHP class constant reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md) **/** +[BumbleDocGen](../../../../../README.md) **/** +[Technical description of the project](../../../../readme.md) **/** +[Parser](../../../readme.md) **/** +[Reflection API](../../readme.md) **/** +[Reflection API for PHP](../readme.md) **/** +[PHP class constant reflection API](../phpClassConstantReflectionApi.md) **/** ClassConstantEntity --- @@ -51,7 +51,6 @@ Class constant entity 1. [getShortName](#mgetshortname) - Constant short name 1. [getStartLine](#mgetstartline) - Get the line number of the beginning of the constant code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getType](#mgettype) - Get current class constant type 1. [getValue](#mgetvalue) - Get the compiled value of a constant 1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description @@ -91,7 +90,7 @@ $implementingClassName | [string](https://www.php.net/manual/en/language.types.s --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -124,7 +123,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -135,7 +134,7 @@ public function getCachedEntityDependencies(): array; --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -146,7 +145,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -158,7 +157,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -170,7 +169,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -182,7 +181,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -204,7 +203,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -216,7 +215,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -238,7 +237,7 @@ Get the line number of the end of a constant's code in a file --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -250,7 +249,7 @@ Get parsed examples from `examples` doc block --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -267,7 +266,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -328,7 +327,7 @@ Get the name of the namespace where the current class is implemented --- -# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L185) +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L187) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -340,7 +339,7 @@ Get entity unique ID --- -# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L90) +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L92) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -398,7 +397,7 @@ Get the line number of the beginning of the constant code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -410,17 +409,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getType` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L191) ```php public function getType(): string; @@ -441,7 +429,7 @@ Get the compiled value of a constant --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -453,7 +441,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -465,7 +453,7 @@ Checking if an entity has `example` docBlock --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -477,7 +465,7 @@ Checking if an entity has `throws` docBlock --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -489,7 +477,7 @@ Checking if an entity has `api` docBlock --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -501,7 +489,7 @@ Checking if an entity has `deprecated` docBlock --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -524,7 +512,7 @@ public function isEntityDataCacheOutdated(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -536,7 +524,7 @@ Checking if entity data can be retrieved --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -578,7 +566,7 @@ Check if a constant is a public constant --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity_2.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity_2.md index 3118a62d..c08d7815 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity_2.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity_2.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[BumbleDocGen](../../../../../README.md) **/** +[Technical description of the project](../../../../readme.md) **/** +[Parser](../../../readme.md) **/** +[Reflection API](../../readme.md) **/** +[Reflection API for PHP](../readme.md) **/** ClassConstantEntity --- @@ -50,7 +50,6 @@ Class constant entity 1. [getShortName](#mgetshortname) - Constant short name 1. [getStartLine](#mgetstartline) - Get the line number of the beginning of the constant code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getType](#mgettype) - Get current class constant type 1. [getValue](#mgetvalue) - Get the compiled value of a constant 1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description @@ -90,7 +89,7 @@ $implementingClassName | [string](https://www.php.net/manual/en/language.types.s --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -123,7 +122,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -134,7 +133,7 @@ public function getCachedEntityDependencies(): array; --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -145,7 +144,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -157,7 +156,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -169,7 +168,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -181,7 +180,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -203,7 +202,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -215,7 +214,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -237,7 +236,7 @@ Get the line number of the end of a constant's code in a file --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -249,7 +248,7 @@ Get parsed examples from `examples` doc block --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -266,7 +265,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -327,7 +326,7 @@ Get the name of the namespace where the current class is implemented --- -# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L185) +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L187) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -339,7 +338,7 @@ Get entity unique ID --- -# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L90) +# `getRelativeFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L92) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -397,7 +396,7 @@ Get the line number of the beginning of the constant code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -409,17 +408,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getType` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntity.php#L191) ```php public function getType(): string; @@ -440,7 +428,7 @@ Get the compiled value of a constant --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -452,7 +440,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -464,7 +452,7 @@ Checking if an entity has `example` docBlock --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -476,7 +464,7 @@ Checking if an entity has `throws` docBlock --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -488,7 +476,7 @@ Checking if an entity has `api` docBlock --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -500,7 +488,7 @@ Checking if an entity has `deprecated` docBlock --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -523,7 +511,7 @@ public function isEntityDataCacheOutdated(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -535,7 +523,7 @@ Checking if entity data can be retrieved --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -577,7 +565,7 @@ Check if a constant is a public constant --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md index efc264e5..4c4e88a5 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md @@ -1,9 +1,9 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** -[PHP class reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md) **/** +[BumbleDocGen](../../../../../README.md) **/** +[Technical description of the project](../../../../readme.md) **/** +[Parser](../../../readme.md) **/** +[Reflection API](../../readme.md) **/** +[Reflection API for PHP](../readme.md) **/** +[PHP class reflection API](../phpClassReflectionApi.md) **/** ClassEntity --- @@ -79,7 +79,6 @@ PHP Class 1. [getShortName](#mgetshortname) - Short name of the entity 1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getTraits](#mgettraits) - Get a list of trait entities of the current class 1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names 1. [hasConstant](#mhasconstant) - Check if a constant exists in a class @@ -180,7 +179,7 @@ $isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -215,7 +214,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -332,7 +331,7 @@ $flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get v --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -343,7 +342,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -355,7 +354,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -367,7 +366,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -379,7 +378,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -403,7 +402,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -415,7 +414,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -461,7 +460,7 @@ public function getEntityDependencies(): array; --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -484,7 +483,7 @@ public function getFileContent(): string; --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -501,7 +500,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -862,7 +861,7 @@ Get the line number of the start of a class code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -874,17 +873,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity @@ -928,7 +916,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -940,7 +928,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1008,7 +996,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1060,7 +1048,7 @@ Check that an entity is abstract --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1103,7 +1091,7 @@ public function isClassLoad(): bool; --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1126,7 +1114,7 @@ public function isDocumentCreationAllowed(): bool; --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1160,7 +1148,7 @@ public function isEntityDataCanBeLoaded(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1248,7 +1236,7 @@ Check if an entity is an Interface --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1308,7 +1296,7 @@ $name | [string](https://www.php.net/manual/en/language.types.string.php) | - | --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity.md index bf560140..50fe18a4 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity.md @@ -1,9 +1,9 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** -[PHP trait reflection API](/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md) **/** +[BumbleDocGen](../../../../../README.md) **/** +[Technical description of the project](../../../../readme.md) **/** +[Parser](../../../readme.md) **/** +[Reflection API](../../readme.md) **/** +[Reflection API for PHP](../readme.md) **/** +[PHP trait reflection API](../phpTraitReflectionApi.md) **/** ClassLikeEntity --- @@ -75,7 +75,6 @@ abstract class ClassLikeEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\ 1. [getShortName](#mgetshortname) - Short name of the entity 1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getTraits](#mgettraits) - Get a list of trait entities of the current class 1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names 1. [hasConstant](#mhasconstant) - Check if a constant exists in a class @@ -169,7 +168,7 @@ $isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -202,7 +201,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -307,7 +306,7 @@ $flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get v --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -318,7 +317,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -330,7 +329,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -342,7 +341,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -354,7 +353,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -376,7 +375,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -388,7 +387,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -428,7 +427,7 @@ public function getEntityDependencies(): array; --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -449,7 +448,7 @@ public function getFileContent(): string; --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -466,7 +465,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -785,7 +784,7 @@ Get the line number of the start of a class code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -797,17 +796,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php public function getTraits(): array; @@ -845,7 +833,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -857,7 +845,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -919,7 +907,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -967,7 +955,7 @@ Check that an entity is abstract --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -998,7 +986,7 @@ public function isClassLoad(): bool; --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1019,7 +1007,7 @@ public function isDocumentCreationAllowed(): bool; --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1051,7 +1039,7 @@ public function isEntityDataCanBeLoaded(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1129,7 +1117,7 @@ Check if an entity is an Interface --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1183,7 +1171,7 @@ $name | [string](https://www.php.net/manual/en/language.types.string.php) | - | --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_2.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_2.md index 416546c8..79c5eeeb 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_2.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_2.md @@ -1,9 +1,9 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** -[PHP interface reflection API](/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md) **/** +[BumbleDocGen](../../../../../README.md) **/** +[Technical description of the project](../../../../readme.md) **/** +[Parser](../../../readme.md) **/** +[Reflection API](../../readme.md) **/** +[Reflection API for PHP](../readme.md) **/** +[PHP interface reflection API](../phpInterfaceReflectionApi.md) **/** ClassLikeEntity --- @@ -75,7 +75,6 @@ abstract class ClassLikeEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\ 1. [getShortName](#mgetshortname) - Short name of the entity 1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getTraits](#mgettraits) - Get a list of trait entities of the current class 1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names 1. [hasConstant](#mhasconstant) - Check if a constant exists in a class @@ -169,7 +168,7 @@ $isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -202,7 +201,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -307,7 +306,7 @@ $flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get v --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -318,7 +317,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -330,7 +329,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -342,7 +341,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -354,7 +353,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -376,7 +375,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -388,7 +387,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -428,7 +427,7 @@ public function getEntityDependencies(): array; --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -449,7 +448,7 @@ public function getFileContent(): string; --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -466,7 +465,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -785,7 +784,7 @@ Get the line number of the start of a class code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -797,17 +796,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php public function getTraits(): array; @@ -845,7 +833,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -857,7 +845,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -919,7 +907,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -967,7 +955,7 @@ Check that an entity is abstract --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -998,7 +986,7 @@ public function isClassLoad(): bool; --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1019,7 +1007,7 @@ public function isDocumentCreationAllowed(): bool; --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1051,7 +1039,7 @@ public function isEntityDataCanBeLoaded(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1129,7 +1117,7 @@ Check if an entity is an Interface --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1183,7 +1171,7 @@ $name | [string](https://www.php.net/manual/en/language.types.string.php) | - | --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_3.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_3.md index 246b4ad0..fa02fd34 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_3.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_3.md @@ -1,9 +1,9 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** -[PHP enum reflection API](/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md) **/** +[BumbleDocGen](../../../../../README.md) **/** +[Technical description of the project](../../../../readme.md) **/** +[Parser](../../../readme.md) **/** +[Reflection API](../../readme.md) **/** +[Reflection API for PHP](../readme.md) **/** +[PHP enum reflection API](../phpEnumReflectionApi.md) **/** ClassLikeEntity --- @@ -75,7 +75,6 @@ abstract class ClassLikeEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\ 1. [getShortName](#mgetshortname) - Short name of the entity 1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getTraits](#mgettraits) - Get a list of trait entities of the current class 1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names 1. [hasConstant](#mhasconstant) - Check if a constant exists in a class @@ -169,7 +168,7 @@ $isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -202,7 +201,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -307,7 +306,7 @@ $flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get v --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -318,7 +317,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -330,7 +329,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -342,7 +341,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -354,7 +353,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -376,7 +375,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -388,7 +387,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -428,7 +427,7 @@ public function getEntityDependencies(): array; --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -449,7 +448,7 @@ public function getFileContent(): string; --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -466,7 +465,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -785,7 +784,7 @@ Get the line number of the start of a class code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -797,17 +796,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php public function getTraits(): array; @@ -845,7 +833,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -857,7 +845,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -919,7 +907,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -967,7 +955,7 @@ Check that an entity is abstract --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -998,7 +986,7 @@ public function isClassLoad(): bool; --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1019,7 +1007,7 @@ public function isDocumentCreationAllowed(): bool; --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1051,7 +1039,7 @@ public function isEntityDataCanBeLoaded(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1129,7 +1117,7 @@ Check if an entity is an Interface --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1183,7 +1171,7 @@ $name | [string](https://www.php.net/manual/en/language.types.string.php) | - | --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_4.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_4.md index d3733a22..827531ab 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_4.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_4.md @@ -1,9 +1,9 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** -[PHP class reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md) **/** +[BumbleDocGen](../../../../../README.md) **/** +[Technical description of the project](../../../../readme.md) **/** +[Parser](../../../readme.md) **/** +[Reflection API](../../readme.md) **/** +[Reflection API for PHP](../readme.md) **/** +[PHP class reflection API](../phpClassReflectionApi.md) **/** ClassLikeEntity --- @@ -75,7 +75,6 @@ abstract class ClassLikeEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\ 1. [getShortName](#mgetshortname) - Short name of the entity 1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getTraits](#mgettraits) - Get a list of trait entities of the current class 1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names 1. [hasConstant](#mhasconstant) - Check if a constant exists in a class @@ -169,7 +168,7 @@ $isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -202,7 +201,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -307,7 +306,7 @@ $flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get v --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -318,7 +317,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -330,7 +329,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -342,7 +341,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -354,7 +353,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -376,7 +375,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -388,7 +387,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -428,7 +427,7 @@ public function getEntityDependencies(): array; --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -449,7 +448,7 @@ public function getFileContent(): string; --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -466,7 +465,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -785,7 +784,7 @@ Get the line number of the start of a class code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -797,17 +796,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php public function getTraits(): array; @@ -845,7 +833,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -857,7 +845,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -919,7 +907,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -967,7 +955,7 @@ Check that an entity is abstract --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -998,7 +986,7 @@ public function isClassLoad(): bool; --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1019,7 +1007,7 @@ public function isDocumentCreationAllowed(): bool; --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1051,7 +1039,7 @@ public function isEntityDataCanBeLoaded(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1129,7 +1117,7 @@ Check if an entity is an Interface --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1183,7 +1171,7 @@ $name | [string](https://www.php.net/manual/en/language.types.string.php) | - | --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md index 971a6cfb..5476ac6f 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[BumbleDocGen](../../../../../README.md) **/** +[Technical description of the project](../../../../readme.md) **/** +[Parser](../../../readme.md) **/** +[Reflection API](../../readme.md) **/** +[Reflection API for PHP](../readme.md) **/** ClassLikeEntity --- @@ -74,7 +74,6 @@ abstract class ClassLikeEntity extends \BumbleDocGen\LanguageHandler\Php\Parser\ 1. [getShortName](#mgetshortname) - Short name of the entity 1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getTraits](#mgettraits) - Get a list of trait entities of the current class 1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names 1. [hasConstant](#mhasconstant) - Check if a constant exists in a class @@ -168,7 +167,7 @@ $isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -201,7 +200,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -306,7 +305,7 @@ $flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get v --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -317,7 +316,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -329,7 +328,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -341,7 +340,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -353,7 +352,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -375,7 +374,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -387,7 +386,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -427,7 +426,7 @@ public function getEntityDependencies(): array; --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -448,7 +447,7 @@ public function getFileContent(): string; --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -465,7 +464,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -784,7 +783,7 @@ Get the line number of the start of a class code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -796,17 +795,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php public function getTraits(): array; @@ -844,7 +832,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -856,7 +844,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -918,7 +906,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -966,7 +954,7 @@ Check that an entity is abstract --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -997,7 +985,7 @@ public function isClassLoad(): bool; --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1018,7 +1006,7 @@ public function isDocumentCreationAllowed(): bool; --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1050,7 +1038,7 @@ public function isEntityDataCanBeLoaded(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1128,7 +1116,7 @@ Check if an entity is an Interface --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1182,7 +1170,7 @@ $name | [string](https://www.php.net/manual/en/language.types.string.php) | - | --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md b/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md index 2fbd6a3d..4d5a93db 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[BumbleDocGen](../../../../../README.md) **/** +[Technical description of the project](../../../../readme.md) **/** +[Parser](../../../readme.md) **/** +[Reflection API](../../readme.md) **/** +[Reflection API for PHP](../readme.md) **/** Configuration --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md index 852d7845..277adca0 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md @@ -1,9 +1,9 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** -[PHP enum reflection API](/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md) **/** +[BumbleDocGen](../../../../../README.md) **/** +[Technical description of the project](../../../../readme.md) **/** +[Parser](../../../readme.md) **/** +[Reflection API](../../readme.md) **/** +[Reflection API for PHP](../readme.md) **/** +[PHP enum reflection API](../phpEnumReflectionApi.md) **/** EnumEntity --- @@ -82,7 +82,6 @@ Enumeration 1. [getShortName](#mgetshortname) - Short name of the entity 1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getTraits](#mgettraits) - Get a list of trait entities of the current class 1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names 1. [hasConstant](#mhasconstant) - Check if a constant exists in a class @@ -182,7 +181,7 @@ $isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -217,7 +216,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -344,7 +343,7 @@ $flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get v --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -355,7 +354,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -367,7 +366,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -379,7 +378,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -391,7 +390,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -415,7 +414,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -427,7 +426,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -499,7 +498,7 @@ Get enum cases values --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -522,7 +521,7 @@ public function getFileContent(): string; --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -539,7 +538,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -904,7 +903,7 @@ Get the line number of the start of a class code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -916,17 +915,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity @@ -970,7 +958,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -982,7 +970,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1050,7 +1038,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1104,7 +1092,7 @@ Check that an entity is abstract --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1139,7 +1127,7 @@ public function isClassLoad(): bool; --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1162,7 +1150,7 @@ public function isDocumentCreationAllowed(): bool; --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1196,7 +1184,7 @@ public function isEntityDataCanBeLoaded(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1284,7 +1272,7 @@ Check if an entity is an Interface --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1344,7 +1332,7 @@ $name | [string](https://www.php.net/manual/en/language.types.string.php) | - | --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md index 0bb671a5..c38d7d13 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md @@ -1,9 +1,9 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** -[PHP interface reflection API](/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md) **/** +[BumbleDocGen](../../../../../README.md) **/** +[Technical description of the project](../../../../readme.md) **/** +[Parser](../../../readme.md) **/** +[Reflection API](../../readme.md) **/** +[Reflection API for PHP](../readme.md) **/** +[PHP interface reflection API](../phpInterfaceReflectionApi.md) **/** InterfaceEntity --- @@ -79,7 +79,6 @@ Object interface 1. [getShortName](#mgetshortname) - Short name of the entity 1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getTraits](#mgettraits) - Get a list of trait entities of the current class 1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names 1. [hasConstant](#mhasconstant) - Check if a constant exists in a class @@ -179,7 +178,7 @@ $isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -214,7 +213,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -331,7 +330,7 @@ $flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get v --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -342,7 +341,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -354,7 +353,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -366,7 +365,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -378,7 +377,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -402,7 +401,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -414,7 +413,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -460,7 +459,7 @@ public function getEntityDependencies(): array; --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -483,7 +482,7 @@ public function getFileContent(): string; --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -500,7 +499,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -867,7 +866,7 @@ Get the line number of the start of a class code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -879,17 +878,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity @@ -931,7 +919,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -943,7 +931,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1011,7 +999,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1063,7 +1051,7 @@ Check that an entity is abstract --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1098,7 +1086,7 @@ public function isClassLoad(): bool; --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1121,7 +1109,7 @@ public function isDocumentCreationAllowed(): bool; --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1155,7 +1143,7 @@ public function isEntityDataCanBeLoaded(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1243,7 +1231,7 @@ Check if an entity is an Interface --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1303,7 +1291,7 @@ $name | [string](https://www.php.net/manual/en/language.types.string.php) | - | --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md index 487a9b75..01600b0d 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md @@ -1,9 +1,9 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** -[PHP class method reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md) **/** +[BumbleDocGen](../../../../../README.md) **/** +[Technical description of the project](../../../../readme.md) **/** +[Parser](../../../readme.md) **/** +[Reflection API](../../readme.md) **/** +[Reflection API for PHP](../readme.md) **/** +[PHP class method reflection API](../phpClassMethodReflectionApi.md) **/** MethodEntity --- @@ -59,7 +59,6 @@ Class method entity 1. [getStartColumn](#mgetstartcolumn) - Get the column number of the beginning of the method code in a file 1. [getStartLine](#mgetstartline) - Get the line number of the beginning of the entity code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description 1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock 1. [hasThrows](#mhasthrows) - Checking if an entity has `throws` docBlock @@ -103,7 +102,7 @@ $implementingClassName | [string](https://www.php.net/manual/en/language.types.s --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -146,7 +145,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -157,7 +156,7 @@ public function getCachedEntityDependencies(): array; --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -168,7 +167,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -180,7 +179,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -192,7 +191,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -204,7 +203,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -235,7 +234,7 @@ public function getDocCommentLine(): null|int; --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -257,7 +256,7 @@ Get the line number of the end of a method's code in a file --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -269,7 +268,7 @@ Get parsed examples from `examples` doc block --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -286,7 +285,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -358,7 +357,7 @@ Namespace of the class that contains this method --- -# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L185) +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L187) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -482,7 +481,7 @@ Get the line number of the beginning of the entity code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -494,18 +493,7 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -517,7 +505,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -529,7 +517,7 @@ Checking if an entity has `example` docBlock --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -541,7 +529,7 @@ Checking if an entity has `throws` docBlock --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -563,7 +551,7 @@ Checking that a method is a constructor --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -585,7 +573,7 @@ Check if a method is a dynamic method, that is, implementable using __call or __ --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -608,7 +596,7 @@ public function isEntityDataCacheOutdated(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -640,7 +628,7 @@ Check if a method is an initialization method --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -692,7 +680,7 @@ Check if this method is static --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md b/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md index 93fcf638..c493926f 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md @@ -1,9 +1,9 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** -[PHP entities collection](/docs/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md) **/** +[BumbleDocGen](../../../../../README.md) **/** +[Technical description of the project](../../../../readme.md) **/** +[Parser](../../../readme.md) **/** +[Reflection API](../../readme.md) **/** +[Reflection API for PHP](../readme.md) **/** +[PHP entities collection](../phpEntitiesCollection.md) **/** PhpEntitiesCollection --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md b/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md index a568152f..7f393f0f 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[BumbleDocGen](../../../../../README.md) **/** +[Technical description of the project](../../../../readme.md) **/** +[Parser](../../../readme.md) **/** +[Reflection API](../../readme.md) **/** +[Reflection API for PHP](../readme.md) **/** PhpHandlerSettings --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md index a86da0ba..eacf97d0 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md @@ -1,9 +1,9 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** -[PHP class property reflection API](/docs/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md) **/** +[BumbleDocGen](../../../../../README.md) **/** +[Technical description of the project](../../../../readme.md) **/** +[Parser](../../../readme.md) **/** +[Reflection API](../../readme.md) **/** +[Reflection API for PHP](../readme.md) **/** +[PHP class property reflection API](../phpClassPropertyReflectionApi.md) **/** PropertyEntity --- @@ -52,7 +52,6 @@ Class property entity 1. [getShortName](#mgetshortname) - Short name of the entity 1. [getStartLine](#mgetstartline) - Get the line number of the beginning of the entity code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getType](#mgettype) - Get current property type 1. [hasDescriptionLinks](#mhasdescriptionlinks) - Checking if an entity has links in its description 1. [hasExamples](#mhasexamples) - Checking if an entity has `example` docBlock @@ -92,7 +91,7 @@ $implementingClassName | [string](https://www.php.net/manual/en/language.types.s --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -125,7 +124,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -136,7 +135,7 @@ public function getCachedEntityDependencies(): array; --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -157,7 +156,7 @@ Get the compiled default value of a property --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -169,7 +168,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -181,7 +180,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -193,7 +192,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -215,7 +214,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -227,7 +226,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -249,7 +248,7 @@ Get the line number of the end of a property's code in a file --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -261,7 +260,7 @@ Get parsed examples from `examples` doc block --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -278,7 +277,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -340,7 +339,7 @@ Namespace of the class that contains this property --- -# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L185) +# `getObjectId` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L187) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -404,7 +403,7 @@ Get the line number of the beginning of the entity code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -416,17 +415,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getType` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntity.php#L231) ```php public function getType(): string; @@ -437,7 +425,7 @@ Get current property type --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -449,7 +437,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -461,7 +449,7 @@ Checking if an entity has `example` docBlock --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -473,7 +461,7 @@ Checking if an entity has `throws` docBlock --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -485,7 +473,7 @@ Checking if an entity has `api` docBlock --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -497,7 +485,7 @@ Checking if an entity has `deprecated` docBlock --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -520,7 +508,7 @@ public function isEntityDataCacheOutdated(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -542,7 +530,7 @@ Check if this property is implemented in the parent class --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -584,7 +572,7 @@ Check if a property is a public property --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/reflectionApi/php/classes/RootEntityInterface.md b/docs/tech/02_parser/reflectionApi/php/classes/RootEntityInterface.md index c4996fd9..558412c3 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/RootEntityInterface.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/RootEntityInterface.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[BumbleDocGen](../../../../../README.md) **/** +[Technical description of the project](../../../../readme.md) **/** +[Parser](../../../readme.md) **/** +[Reflection API](../../readme.md) **/** +[Reflection API for PHP](../readme.md) **/** RootEntityInterface --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md index 3d49c047..e2341194 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md @@ -1,9 +1,9 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** -[PHP trait reflection API](/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md) **/** +[BumbleDocGen](../../../../../README.md) **/** +[Technical description of the project](../../../../readme.md) **/** +[Parser](../../../readme.md) **/** +[Reflection API](../../readme.md) **/** +[Reflection API for PHP](../readme.md) **/** +[PHP trait reflection API](../phpTraitReflectionApi.md) **/** TraitEntity --- @@ -79,7 +79,6 @@ Trait 1. [getShortName](#mgetshortname) - Short name of the entity 1. [getStartLine](#mgetstartline) - Get the line number of the start of a class code in a file 1. [getThrows](#mgetthrows) - Get parsed throws from `throws` doc block -1. [getThrowsDocBlockLinks](#mgetthrowsdocblocklinks) 1. [getTraits](#mgettraits) - Get a list of trait entities of the current class 1. [getTraitsNames](#mgettraitsnames) - Get a list of class traits names 1. [hasConstant](#mhasconstant) - Check if a constant exists in a class @@ -179,7 +178,7 @@ $isForDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php --- -# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L102) +# `getAbsoluteFileName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L104) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -214,7 +213,7 @@ public function getCacheKey(): string; --- -# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L658) +# `getCachedEntityDependencies` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L573) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -331,7 +330,7 @@ $flags | [int](https://www.php.net/manual/en/language.types.integer.php) | Get v --- -# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L634) +# `getCurrentRootEntity` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L549) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -342,7 +341,7 @@ public function getCurrentRootEntity(): null|\BumbleDocGen\LanguageHandler\Php\P --- -# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L127) +# `getDescription` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L129) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -354,7 +353,7 @@ Get entity description --- -# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L419) +# `getDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L289) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -366,7 +365,7 @@ Get parsed links from description and doc blocks `see` and `link` --- -# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L213) +# `getDocBlock` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L215) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -378,7 +377,7 @@ Get DocBlock for current entity --- -# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L625) +# `getDocComment` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L540) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -402,7 +401,7 @@ Link to an entity where docBlock is implemented for this entity --- -# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L200) +# `getDocCommentLine` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L202) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -414,7 +413,7 @@ Get the code line number where the docBlock of the current entity begins --- -# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L612) +# `getDocNote` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L527) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -460,7 +459,7 @@ public function getEntityDependencies(): array; --- -# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L578) +# `getExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L493) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -483,7 +482,7 @@ public function getFileContent(): string; --- -# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L171) +# `getFileSourceLink` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L173) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -500,7 +499,7 @@ $withLine | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - --- -# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L599) +# `getFirstExample` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L514) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -865,7 +864,7 @@ Get the line number of the start of a class code in a file --- -# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L485) +# `getThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L438) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -877,17 +876,6 @@ Get parsed throws from `throws` doc block --- -# `getThrowsDocBlockLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L443) -```php -// Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity - -public function getThrowsDocBlockLinks(): array; -``` - -***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) - ---- - # `getTraits` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/ClassLikeEntity.php#L629) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity @@ -931,7 +919,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L272) +# `hasDescriptionLinks` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L274) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -943,7 +931,7 @@ Checking if an entity has links in its description --- -# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L563) +# `hasExamples` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L478) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1011,7 +999,7 @@ $unsafe | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Che --- -# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L432) +# `hasThrows` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L423) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1065,7 +1053,7 @@ Check that an entity is abstract --- -# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L244) +# `isApi` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L246) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1100,7 +1088,7 @@ public function isClassLoad(): bool; --- -# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L258) +# `isDeprecated` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L260) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1123,7 +1111,7 @@ public function isDocumentCreationAllowed(): bool; --- -# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L761) +# `isEntityCacheOutdated` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L676) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1157,7 +1145,7 @@ public function isEntityDataCanBeLoaded(): bool; --- -# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L115) +# `isEntityFileCanBeLoad` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L117) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1247,7 +1235,7 @@ Check if an entity is an Interface --- -# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L230) +# `isInternal` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L232) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity @@ -1303,7 +1291,7 @@ $name | [string](https://www.php.net/manual/en/language.types.string.php) | - | --- -# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L678) +# `reloadEntityDependenciesCache` ⚠️ Internal **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/BaseEntity.php#L593) ```php // Implemented in BumbleDocGen\LanguageHandler\Php\Parser\Entity\BaseEntity diff --git a/docs/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md index 447fe407..c8bcb6a6 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Parser](../../readme.md) **/** +[Reflection API](../readme.md) **/** +[Reflection API for PHP](readme.md) **/** PHP class constant reflection API --- @@ -10,7 +10,7 @@ PHP class constant reflection API # PHP class constant reflection API -Class constant reflection entity class: [ClassConstantEntity](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md). +Class constant reflection entity class: [ClassConstantEntity](classes/ClassConstantEntity.md). **Example of creating class constant reflection:** @@ -24,37 +24,37 @@ $constantReflection = $classReflection->getConstant('constantName'); **Class constant reflection API methods:** -- [getAbsoluteFileName()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetabsolutefilename): Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -- [getAst()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetast): Get AST for this entity -- [getDescription()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetdescription): Get entity description -- [getDescriptionLinks()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetdescriptionlinks): Get parsed links from description and doc blocks `see` and `link` -- [getDocComment()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetdoccomment): Get the doc comment of an entity -- [getDocCommentLine()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetdoccommentline): Get the code line number where the docBlock of the current entity begins -- [getDocNote()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetdocnote): Get the note annotation value -- [getEndLine()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetendline): Get the line number of the end of a constant's code in a file -- [getExamples()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetexamples): Get parsed examples from `examples` doc block -- [getFirstExample()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetfirstexample): Get first example from `examples` doc block -- [getImplementingClass()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetimplementingclass): Get the class like entity in which the current entity was implemented -- [getModifiersString()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetmodifiersstring): Get a text representation of class constant modifiers -- [getNamespaceName()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetnamespacename): Get the name of the namespace where the current class is implemented -- [getObjectId()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetobjectid): Get entity unique ID -- [getRelativeFileName()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetrelativefilename): File name relative to project_root configuration parameter -- [getRootEntityCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetrootentitycollection): Get the collection of root entities to which this entity belongs -- [getStartLine()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetstartline): Get the line number of the beginning of the constant code in a file -- [getThrows()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetthrows): Get parsed throws from `throws` doc block -- [getType()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgettype): Get current class constant type -- [getValue()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mgetvalue): Get the compiled value of a constant -- [hasDescriptionLinks()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mhasdescriptionlinks): Checking if an entity has links in its description -- [hasExamples()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mhasexamples): Checking if an entity has `example` docBlock -- [hasThrows()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mhasthrows): Checking if an entity has `throws` docBlock -- [isApi()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#misapi): Checking if an entity has `api` docBlock -- [isDeprecated()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#misdeprecated): Checking if an entity has `deprecated` docBlock -- [isEntityFileCanBeLoad()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#misentityfilecanbeload): Checking if entity data can be retrieved -- [isInternal()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#misinternal): Checking if an entity has `internal` docBlock -- [isPrivate()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#misprivate): Check if a constant is a private constant -- [isProtected()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#misprotected): Check if a constant is a protected constant -- [isPublic()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md#mispublic): Check if a constant is a public constant +- [getAbsoluteFileName()](classes/ClassConstantEntity.md#mgetabsolutefilename): Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +- [getAst()](classes/ClassConstantEntity.md#mgetast): Get AST for this entity +- [getDescription()](classes/ClassConstantEntity.md#mgetdescription): Get entity description +- [getDescriptionLinks()](classes/ClassConstantEntity.md#mgetdescriptionlinks): Get parsed links from description and doc blocks `see` and `link` +- [getDocComment()](classes/ClassConstantEntity.md#mgetdoccomment): Get the doc comment of an entity +- [getDocCommentLine()](classes/ClassConstantEntity.md#mgetdoccommentline): Get the code line number where the docBlock of the current entity begins +- [getDocNote()](classes/ClassConstantEntity.md#mgetdocnote): Get the note annotation value +- [getEndLine()](classes/ClassConstantEntity.md#mgetendline): Get the line number of the end of a constant's code in a file +- [getExamples()](classes/ClassConstantEntity.md#mgetexamples): Get parsed examples from `examples` doc block +- [getFirstExample()](classes/ClassConstantEntity.md#mgetfirstexample): Get first example from `examples` doc block +- [getImplementingClass()](classes/ClassConstantEntity.md#mgetimplementingclass): Get the class like entity in which the current entity was implemented +- [getModifiersString()](classes/ClassConstantEntity.md#mgetmodifiersstring): Get a text representation of class constant modifiers +- [getNamespaceName()](classes/ClassConstantEntity.md#mgetnamespacename): Get the name of the namespace where the current class is implemented +- [getObjectId()](classes/ClassConstantEntity.md#mgetobjectid): Get entity unique ID +- [getRelativeFileName()](classes/ClassConstantEntity.md#mgetrelativefilename): File name relative to project_root configuration parameter +- [getRootEntityCollection()](classes/ClassConstantEntity.md#mgetrootentitycollection): Get the collection of root entities to which this entity belongs +- [getStartLine()](classes/ClassConstantEntity.md#mgetstartline): Get the line number of the beginning of the constant code in a file +- [getThrows()](classes/ClassConstantEntity.md#mgetthrows): Get parsed throws from `throws` doc block +- [getType()](classes/ClassConstantEntity.md#mgettype): Get current class constant type +- [getValue()](classes/ClassConstantEntity.md#mgetvalue): Get the compiled value of a constant +- [hasDescriptionLinks()](classes/ClassConstantEntity.md#mhasdescriptionlinks): Checking if an entity has links in its description +- [hasExamples()](classes/ClassConstantEntity.md#mhasexamples): Checking if an entity has `example` docBlock +- [hasThrows()](classes/ClassConstantEntity.md#mhasthrows): Checking if an entity has `throws` docBlock +- [isApi()](classes/ClassConstantEntity.md#misapi): Checking if an entity has `api` docBlock +- [isDeprecated()](classes/ClassConstantEntity.md#misdeprecated): Checking if an entity has `deprecated` docBlock +- [isEntityFileCanBeLoad()](classes/ClassConstantEntity.md#misentityfilecanbeload): Checking if entity data can be retrieved +- [isInternal()](classes/ClassConstantEntity.md#misinternal): Checking if an entity has `internal` docBlock +- [isPrivate()](classes/ClassConstantEntity.md#misprivate): Check if a constant is a private constant +- [isProtected()](classes/ClassConstantEntity.md#misprotected): Check if a constant is a protected constant +- [isPublic()](classes/ClassConstantEntity.md#mispublic): Check if a constant is a public constant --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md index 37f9288b..a892aa18 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Parser](../../readme.md) **/** +[Reflection API](../readme.md) **/** +[Reflection API for PHP](readme.md) **/** PHP class method reflection API --- @@ -10,7 +10,7 @@ PHP class method reflection API # PHP class method reflection API -Method reflection entity class: [MethodEntity](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md). +Method reflection entity class: [MethodEntity](classes/MethodEntity.md). **Example of creating class method reflection:** @@ -24,50 +24,50 @@ $methodReflection = $classReflection->getMethod('methodName'); **Class method reflection API methods:** -- [getAbsoluteFileName()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetabsolutefilename): Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -- [getAst()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetast): Get AST for this entity -- [getBodyCode()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetbodycode): Get the code for this method -- [getDescription()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetdescription): Get entity description -- [getDescriptionLinks()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetdescriptionlinks): Get parsed links from description and doc blocks `see` and `link` -- [getDocComment()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetdoccomment): Get the doc comment of an entity -- [getDocNote()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetdocnote): Get the note annotation value -- [getEndLine()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetendline): Get the line number of the end of a method's code in a file -- [getExamples()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetexamples): Get parsed examples from `examples` doc block -- [getFirstExample()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetfirstexample): Get first example from `examples` doc block -- [getFirstReturnValue()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetfirstreturnvalue): Get the compiled first return value of a method (if possible) -- [getImplementingClass()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetimplementingclass): Get the class like entity in which the current entity was implemented -- [getImplementingClassName()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetimplementingclassname): Get the name of the class in which this method is implemented -- [getModifiersString()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetmodifiersstring): Get a text representation of method modifiers -- [getName()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetname): Full name of the entity -- [getNamespaceName()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetnamespacename): Namespace of the class that contains this method -- [getObjectId()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetobjectid): Get entity unique ID -- [getParameters()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetparameters): Get a list of method parameters -- [getParametersString()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetparametersstring): Get a list of method parameters as a string -- [getParentMethod()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetparentmethod): Get the parent method for this method -- [getRelativeFileName()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetrelativefilename): File name relative to project_root configuration parameter -- [getReturnType()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetreturntype): Get the return type of method -- [getRootEntityCollection()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetrootentitycollection): Get the collection of root entities to which this entity belongs -- [getShortName()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetshortname): Short name of the entity -- [getSignature()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetsignature): Get the method signature as a string -- [getStartColumn()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetstartcolumn): Get the column number of the beginning of the method code in a file -- [getStartLine()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetstartline): Get the line number of the beginning of the entity code in a file -- [getThrows()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mgetthrows): Get parsed throws from `throws` doc block -- [hasDescriptionLinks()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mhasdescriptionlinks): Checking if an entity has links in its description -- [hasExamples()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mhasexamples): Checking if an entity has `example` docBlock -- [hasThrows()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mhasthrows): Checking if an entity has `throws` docBlock -- [isApi()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#misapi): Checking if an entity has `api` docBlock -- [isConstructor()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#misconstructor): Checking that a method is a constructor -- [isDeprecated()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#misdeprecated): Checking if an entity has `deprecated` docBlock -- [isDynamic()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#misdynamic): Check if a method is a dynamic method, that is, implementable using __call or __callStatic -- [isEntityFileCanBeLoad()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#misentityfilecanbeload): Checking if entity data can be retrieved -- [isImplementedInParentClass()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#misimplementedinparentclass): Check if this method is implemented in the parent class -- [isInitialization()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#misinitialization): Check if a method is an initialization method -- [isInternal()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#misinternal): Checking if an entity has `internal` docBlock -- [isPrivate()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#misprivate): Check if a method is a private method -- [isProtected()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#misprotected): Check if a method is a protected method -- [isPublic()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#mispublic): Check if a method is a public method -- [isStatic()](/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md#misstatic): Check if this method is static +- [getAbsoluteFileName()](classes/MethodEntity.md#mgetabsolutefilename): Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +- [getAst()](classes/MethodEntity.md#mgetast): Get AST for this entity +- [getBodyCode()](classes/MethodEntity.md#mgetbodycode): Get the code for this method +- [getDescription()](classes/MethodEntity.md#mgetdescription): Get entity description +- [getDescriptionLinks()](classes/MethodEntity.md#mgetdescriptionlinks): Get parsed links from description and doc blocks `see` and `link` +- [getDocComment()](classes/MethodEntity.md#mgetdoccomment): Get the doc comment of an entity +- [getDocNote()](classes/MethodEntity.md#mgetdocnote): Get the note annotation value +- [getEndLine()](classes/MethodEntity.md#mgetendline): Get the line number of the end of a method's code in a file +- [getExamples()](classes/MethodEntity.md#mgetexamples): Get parsed examples from `examples` doc block +- [getFirstExample()](classes/MethodEntity.md#mgetfirstexample): Get first example from `examples` doc block +- [getFirstReturnValue()](classes/MethodEntity.md#mgetfirstreturnvalue): Get the compiled first return value of a method (if possible) +- [getImplementingClass()](classes/MethodEntity.md#mgetimplementingclass): Get the class like entity in which the current entity was implemented +- [getImplementingClassName()](classes/MethodEntity.md#mgetimplementingclassname): Get the name of the class in which this method is implemented +- [getModifiersString()](classes/MethodEntity.md#mgetmodifiersstring): Get a text representation of method modifiers +- [getName()](classes/MethodEntity.md#mgetname): Full name of the entity +- [getNamespaceName()](classes/MethodEntity.md#mgetnamespacename): Namespace of the class that contains this method +- [getObjectId()](classes/MethodEntity.md#mgetobjectid): Get entity unique ID +- [getParameters()](classes/MethodEntity.md#mgetparameters): Get a list of method parameters +- [getParametersString()](classes/MethodEntity.md#mgetparametersstring): Get a list of method parameters as a string +- [getParentMethod()](classes/MethodEntity.md#mgetparentmethod): Get the parent method for this method +- [getRelativeFileName()](classes/MethodEntity.md#mgetrelativefilename): File name relative to project_root configuration parameter +- [getReturnType()](classes/MethodEntity.md#mgetreturntype): Get the return type of method +- [getRootEntityCollection()](classes/MethodEntity.md#mgetrootentitycollection): Get the collection of root entities to which this entity belongs +- [getShortName()](classes/MethodEntity.md#mgetshortname): Short name of the entity +- [getSignature()](classes/MethodEntity.md#mgetsignature): Get the method signature as a string +- [getStartColumn()](classes/MethodEntity.md#mgetstartcolumn): Get the column number of the beginning of the method code in a file +- [getStartLine()](classes/MethodEntity.md#mgetstartline): Get the line number of the beginning of the entity code in a file +- [getThrows()](classes/MethodEntity.md#mgetthrows): Get parsed throws from `throws` doc block +- [hasDescriptionLinks()](classes/MethodEntity.md#mhasdescriptionlinks): Checking if an entity has links in its description +- [hasExamples()](classes/MethodEntity.md#mhasexamples): Checking if an entity has `example` docBlock +- [hasThrows()](classes/MethodEntity.md#mhasthrows): Checking if an entity has `throws` docBlock +- [isApi()](classes/MethodEntity.md#misapi): Checking if an entity has `api` docBlock +- [isConstructor()](classes/MethodEntity.md#misconstructor): Checking that a method is a constructor +- [isDeprecated()](classes/MethodEntity.md#misdeprecated): Checking if an entity has `deprecated` docBlock +- [isDynamic()](classes/MethodEntity.md#misdynamic): Check if a method is a dynamic method, that is, implementable using __call or __callStatic +- [isEntityFileCanBeLoad()](classes/MethodEntity.md#misentityfilecanbeload): Checking if entity data can be retrieved +- [isImplementedInParentClass()](classes/MethodEntity.md#misimplementedinparentclass): Check if this method is implemented in the parent class +- [isInitialization()](classes/MethodEntity.md#misinitialization): Check if a method is an initialization method +- [isInternal()](classes/MethodEntity.md#misinternal): Checking if an entity has `internal` docBlock +- [isPrivate()](classes/MethodEntity.md#misprivate): Check if a method is a private method +- [isProtected()](classes/MethodEntity.md#misprotected): Check if a method is a protected method +- [isPublic()](classes/MethodEntity.md#mispublic): Check if a method is a public method +- [isStatic()](classes/MethodEntity.md#misstatic): Check if this method is static --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md index 7e9d599b..269bc3e2 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Parser](../../readme.md) **/** +[Reflection API](../readme.md) **/** +[Reflection API for PHP](readme.md) **/** PHP class property reflection API --- @@ -10,7 +10,7 @@ PHP class property reflection API # PHP class property reflection API -Property reflection entity class: [PropertyEntity](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md). +Property reflection entity class: [PropertyEntity](classes/PropertyEntity.md). **Example of creating class property reflection:** @@ -24,41 +24,41 @@ $propertyReflection = $classReflection->getProperty('propertyName'); **Class property reflection API methods:** -- [getAbsoluteFileName()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetabsolutefilename): Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -- [getAst()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetast): Get AST for this entity -- [getDefaultValue()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetdefaultvalue): Get the compiled default value of a property -- [getDescription()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetdescription): Get entity description -- [getDescriptionLinks()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetdescriptionlinks): Get parsed links from description and doc blocks `see` and `link` -- [getDocComment()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetdoccomment): Get the doc comment of an entity -- [getDocCommentLine()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetdoccommentline): Get the code line number where the docBlock of the current entity begins -- [getDocNote()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetdocnote): Get the note annotation value -- [getEndLine()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetendline): Get the line number of the end of a property's code in a file -- [getExamples()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetexamples): Get parsed examples from `examples` doc block -- [getFirstExample()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetfirstexample): Get first example from `examples` doc block -- [getImplementingClass()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetimplementingclass): Get the class like entity in which the current entity was implemented -- [getImplementingClassName()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetimplementingclassname): Get the name of the class in which this property is implemented -- [getModifiersString()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetmodifiersstring): Get a text representation of property modifiers -- [getName()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetname): Full name of the entity -- [getNamespaceName()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetnamespacename): Namespace of the class that contains this property -- [getObjectId()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetobjectid): Get entity unique ID -- [getRelativeFileName()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetrelativefilename): File name relative to project_root configuration parameter -- [getRootEntityCollection()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetrootentitycollection): Get the collection of root entities to which this entity belongs -- [getShortName()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetshortname): Short name of the entity -- [getStartLine()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetstartline): Get the line number of the beginning of the entity code in a file -- [getThrows()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgetthrows): Get parsed throws from `throws` doc block -- [getType()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mgettype): Get current property type -- [hasDescriptionLinks()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mhasdescriptionlinks): Checking if an entity has links in its description -- [hasExamples()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mhasexamples): Checking if an entity has `example` docBlock -- [hasThrows()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mhasthrows): Checking if an entity has `throws` docBlock -- [isApi()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#misapi): Checking if an entity has `api` docBlock -- [isDeprecated()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#misdeprecated): Checking if an entity has `deprecated` docBlock -- [isEntityFileCanBeLoad()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#misentityfilecanbeload): Checking if entity data can be retrieved -- [isImplementedInParentClass()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#misimplementedinparentclass): Check if this property is implemented in the parent class -- [isInternal()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#misinternal): Checking if an entity has `internal` docBlock -- [isPrivate()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#misprivate): Check if a private is a public private -- [isProtected()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#misprotected): Check if a protected is a public protected -- [isPublic()](/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md#mispublic): Check if a property is a public property +- [getAbsoluteFileName()](classes/PropertyEntity.md#mgetabsolutefilename): Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +- [getAst()](classes/PropertyEntity.md#mgetast): Get AST for this entity +- [getDefaultValue()](classes/PropertyEntity.md#mgetdefaultvalue): Get the compiled default value of a property +- [getDescription()](classes/PropertyEntity.md#mgetdescription): Get entity description +- [getDescriptionLinks()](classes/PropertyEntity.md#mgetdescriptionlinks): Get parsed links from description and doc blocks `see` and `link` +- [getDocComment()](classes/PropertyEntity.md#mgetdoccomment): Get the doc comment of an entity +- [getDocCommentLine()](classes/PropertyEntity.md#mgetdoccommentline): Get the code line number where the docBlock of the current entity begins +- [getDocNote()](classes/PropertyEntity.md#mgetdocnote): Get the note annotation value +- [getEndLine()](classes/PropertyEntity.md#mgetendline): Get the line number of the end of a property's code in a file +- [getExamples()](classes/PropertyEntity.md#mgetexamples): Get parsed examples from `examples` doc block +- [getFirstExample()](classes/PropertyEntity.md#mgetfirstexample): Get first example from `examples` doc block +- [getImplementingClass()](classes/PropertyEntity.md#mgetimplementingclass): Get the class like entity in which the current entity was implemented +- [getImplementingClassName()](classes/PropertyEntity.md#mgetimplementingclassname): Get the name of the class in which this property is implemented +- [getModifiersString()](classes/PropertyEntity.md#mgetmodifiersstring): Get a text representation of property modifiers +- [getName()](classes/PropertyEntity.md#mgetname): Full name of the entity +- [getNamespaceName()](classes/PropertyEntity.md#mgetnamespacename): Namespace of the class that contains this property +- [getObjectId()](classes/PropertyEntity.md#mgetobjectid): Get entity unique ID +- [getRelativeFileName()](classes/PropertyEntity.md#mgetrelativefilename): File name relative to project_root configuration parameter +- [getRootEntityCollection()](classes/PropertyEntity.md#mgetrootentitycollection): Get the collection of root entities to which this entity belongs +- [getShortName()](classes/PropertyEntity.md#mgetshortname): Short name of the entity +- [getStartLine()](classes/PropertyEntity.md#mgetstartline): Get the line number of the beginning of the entity code in a file +- [getThrows()](classes/PropertyEntity.md#mgetthrows): Get parsed throws from `throws` doc block +- [getType()](classes/PropertyEntity.md#mgettype): Get current property type +- [hasDescriptionLinks()](classes/PropertyEntity.md#mhasdescriptionlinks): Checking if an entity has links in its description +- [hasExamples()](classes/PropertyEntity.md#mhasexamples): Checking if an entity has `example` docBlock +- [hasThrows()](classes/PropertyEntity.md#mhasthrows): Checking if an entity has `throws` docBlock +- [isApi()](classes/PropertyEntity.md#misapi): Checking if an entity has `api` docBlock +- [isDeprecated()](classes/PropertyEntity.md#misdeprecated): Checking if an entity has `deprecated` docBlock +- [isEntityFileCanBeLoad()](classes/PropertyEntity.md#misentityfilecanbeload): Checking if entity data can be retrieved +- [isImplementedInParentClass()](classes/PropertyEntity.md#misimplementedinparentclass): Check if this property is implemented in the parent class +- [isInternal()](classes/PropertyEntity.md#misinternal): Checking if an entity has `internal` docBlock +- [isPrivate()](classes/PropertyEntity.md#misprivate): Check if a private is a public private +- [isProtected()](classes/PropertyEntity.md#misprotected): Check if a protected is a public protected +- [isPublic()](classes/PropertyEntity.md#mispublic): Check if a property is a public property --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md index 9b53ba47..93b74235 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Parser](../../readme.md) **/** +[Reflection API](../readme.md) **/** +[Reflection API for PHP](readme.md) **/** PHP class reflection API --- @@ -10,7 +10,7 @@ PHP class reflection API # PHP class reflection API -PHP class reflection [ClassEntity](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md) inherits from [ClassLikeEntity](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_4.md). +PHP class reflection [ClassEntity](classes/ClassEntity.md) inherits from [ClassLikeEntity](classes/ClassLikeEntity_4.md). **Source class formats:** @@ -28,70 +28,70 @@ $classReflection = $entitiesCollection->getLoadedOrCreateNew('SomeClassName'); / **Class reflection API methods:** -- [getAbsoluteFileName()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetabsolutefilename): Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -- [getAst()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetast): Get AST for this entity -- [getConstant()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetconstant): Get the method entity by its name -- [getConstantEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetconstantentitiescollection): Get a collection of constant entities -- [getConstantValue()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetconstantvalue): Get the compiled value of a constant -- [getConstants()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetconstants): Get all constants that are available according to the configuration as an array -- [getConstantsValues()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetconstantsvalues): Get class constant compiled values according to filters -- [getDescription()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetdescription): Get entity description -- [getDescriptionLinks()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetdescriptionlinks): Get parsed links from description and doc blocks `see` and `link` -- [getDocComment()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetdoccomment): Get the doc comment of an entity -- [getDocCommentLine()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetdoccommentline): Get the code line number where the docBlock of the current entity begins -- [getDocNote()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetdocnote): Get the note annotation value -- [getEndLine()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetendline): Get the line number of the end of a class code in a file -- [getExamples()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetexamples): Get parsed examples from `examples` doc block -- [getFirstExample()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetfirstexample): Get first example from `examples` doc block -- [getImplementingClass()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetimplementingclass): Get the class like entity in which the current entity was implemented -- [getInterfaceNames()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetinterfacenames): Get a list of class interface names -- [getInterfacesEntities()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetinterfacesentities): Get a list of interface entities that the current class implements -- [getMethod()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetmethod): Get the method entity by its name -- [getMethodEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetmethodentitiescollection): Get a collection of method entities -- [getMethods()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetmethods): Get all methods that are available according to the configuration as an array -- [getName()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetname): Full name of the entity -- [getNamespaceName()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetnamespacename): Get the entity namespace name -- [getObjectId()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetobjectid): Get entity unique ID -- [getParentClass()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetparentclass): Get the entity of the parent class if it exists -- [getParentClassEntities()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetparentclassentities): Get a list of parent class entities -- [getParentClassName()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetparentclassname): Get the name of the parent class entity if it exists -- [getParentClassNames()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetparentclassnames): Get a list of entity names of parent classes -- [getPluginData()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetplugindata): Get additional information added using the plugin -- [getProperties()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetproperties): Get all properties that are available according to the configuration as an array -- [getProperty()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetproperty): Get the property entity by its name -- [getPropertyDefaultValue()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetpropertydefaultvalue): Get the compiled value of a property -- [getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetpropertyentitiescollection): Get a collection of property entities -- [getRelativeFileName()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetrelativefilename): File name relative to project_root configuration parameter -- [getRootEntityCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetrootentitycollection): Get the collection of root entities to which this entity belongs -- [getShortName()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetshortname): Short name of the entity -- [getStartLine()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetstartline): Get the line number of the start of a class code in a file -- [getThrows()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgetthrows): Get parsed throws from `throws` doc block -- [getTraits()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgettraits): Get a list of trait entities of the current class -- [getTraitsNames()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mgettraitsnames): Get a list of class traits names -- [hasConstant()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mhasconstant): Check if a constant exists in a class -- [hasDescriptionLinks()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mhasdescriptionlinks): Checking if an entity has links in its description -- [hasExamples()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mhasexamples): Checking if an entity has `example` docBlock -- [hasMethod()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mhasmethod): Check if a method exists in a class -- [hasParentClass()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mhasparentclass): Check if a certain parent class exists in a chain of parent classes -- [hasProperty()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mhasproperty): Check if a property exists in a class -- [hasThrows()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mhasthrows): Checking if an entity has `throws` docBlock -- [hasTraits()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mhastraits): Check if the class contains traits -- [implementsInterface()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mimplementsinterface): Check if a class implements an interface -- [isAbstract()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#misabstract): Check that an entity is abstract -- [isApi()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#misapi): Checking if an entity has `api` docBlock -- [isAttribute()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#misattribute): Check if a class is an attribute -- [isClass()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#misclass): Check if an entity is a Class -- [isDeprecated()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#misdeprecated): Checking if an entity has `deprecated` docBlock -- [isEntityFileCanBeLoad()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#misentityfilecanbeload): Checking if entity data can be retrieved -- [isEnum()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#misenum): Check if an entity is an Enum -- [isInstantiable()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#misinstantiable): Check that an entity is instantiable -- [isInterface()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#misinterface): Check if an entity is an Interface -- [isInternal()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#misinternal): Checking if an entity has `internal` docBlock -- [isSubclassOf()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#missubclassof): Whether the given class is a subclass of the specified class -- [isTrait()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mistrait): Check if an entity is a Trait -- [normalizeClassName()](/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md#mnormalizeclassname): Bring the class name to the standard format used in the system +- [getAbsoluteFileName()](classes/ClassEntity.md#mgetabsolutefilename): Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +- [getAst()](classes/ClassEntity.md#mgetast): Get AST for this entity +- [getConstant()](classes/ClassEntity.md#mgetconstant): Get the method entity by its name +- [getConstantEntitiesCollection()](classes/ClassEntity.md#mgetconstantentitiescollection): Get a collection of constant entities +- [getConstantValue()](classes/ClassEntity.md#mgetconstantvalue): Get the compiled value of a constant +- [getConstants()](classes/ClassEntity.md#mgetconstants): Get all constants that are available according to the configuration as an array +- [getConstantsValues()](classes/ClassEntity.md#mgetconstantsvalues): Get class constant compiled values according to filters +- [getDescription()](classes/ClassEntity.md#mgetdescription): Get entity description +- [getDescriptionLinks()](classes/ClassEntity.md#mgetdescriptionlinks): Get parsed links from description and doc blocks `see` and `link` +- [getDocComment()](classes/ClassEntity.md#mgetdoccomment): Get the doc comment of an entity +- [getDocCommentLine()](classes/ClassEntity.md#mgetdoccommentline): Get the code line number where the docBlock of the current entity begins +- [getDocNote()](classes/ClassEntity.md#mgetdocnote): Get the note annotation value +- [getEndLine()](classes/ClassEntity.md#mgetendline): Get the line number of the end of a class code in a file +- [getExamples()](classes/ClassEntity.md#mgetexamples): Get parsed examples from `examples` doc block +- [getFirstExample()](classes/ClassEntity.md#mgetfirstexample): Get first example from `examples` doc block +- [getImplementingClass()](classes/ClassEntity.md#mgetimplementingclass): Get the class like entity in which the current entity was implemented +- [getInterfaceNames()](classes/ClassEntity.md#mgetinterfacenames): Get a list of class interface names +- [getInterfacesEntities()](classes/ClassEntity.md#mgetinterfacesentities): Get a list of interface entities that the current class implements +- [getMethod()](classes/ClassEntity.md#mgetmethod): Get the method entity by its name +- [getMethodEntitiesCollection()](classes/ClassEntity.md#mgetmethodentitiescollection): Get a collection of method entities +- [getMethods()](classes/ClassEntity.md#mgetmethods): Get all methods that are available according to the configuration as an array +- [getName()](classes/ClassEntity.md#mgetname): Full name of the entity +- [getNamespaceName()](classes/ClassEntity.md#mgetnamespacename): Get the entity namespace name +- [getObjectId()](classes/ClassEntity.md#mgetobjectid): Get entity unique ID +- [getParentClass()](classes/ClassEntity.md#mgetparentclass): Get the entity of the parent class if it exists +- [getParentClassEntities()](classes/ClassEntity.md#mgetparentclassentities): Get a list of parent class entities +- [getParentClassName()](classes/ClassEntity.md#mgetparentclassname): Get the name of the parent class entity if it exists +- [getParentClassNames()](classes/ClassEntity.md#mgetparentclassnames): Get a list of entity names of parent classes +- [getPluginData()](classes/ClassEntity.md#mgetplugindata): Get additional information added using the plugin +- [getProperties()](classes/ClassEntity.md#mgetproperties): Get all properties that are available according to the configuration as an array +- [getProperty()](classes/ClassEntity.md#mgetproperty): Get the property entity by its name +- [getPropertyDefaultValue()](classes/ClassEntity.md#mgetpropertydefaultvalue): Get the compiled value of a property +- [getPropertyEntitiesCollection()](classes/ClassEntity.md#mgetpropertyentitiescollection): Get a collection of property entities +- [getRelativeFileName()](classes/ClassEntity.md#mgetrelativefilename): File name relative to project_root configuration parameter +- [getRootEntityCollection()](classes/ClassEntity.md#mgetrootentitycollection): Get the collection of root entities to which this entity belongs +- [getShortName()](classes/ClassEntity.md#mgetshortname): Short name of the entity +- [getStartLine()](classes/ClassEntity.md#mgetstartline): Get the line number of the start of a class code in a file +- [getThrows()](classes/ClassEntity.md#mgetthrows): Get parsed throws from `throws` doc block +- [getTraits()](classes/ClassEntity.md#mgettraits): Get a list of trait entities of the current class +- [getTraitsNames()](classes/ClassEntity.md#mgettraitsnames): Get a list of class traits names +- [hasConstant()](classes/ClassEntity.md#mhasconstant): Check if a constant exists in a class +- [hasDescriptionLinks()](classes/ClassEntity.md#mhasdescriptionlinks): Checking if an entity has links in its description +- [hasExamples()](classes/ClassEntity.md#mhasexamples): Checking if an entity has `example` docBlock +- [hasMethod()](classes/ClassEntity.md#mhasmethod): Check if a method exists in a class +- [hasParentClass()](classes/ClassEntity.md#mhasparentclass): Check if a certain parent class exists in a chain of parent classes +- [hasProperty()](classes/ClassEntity.md#mhasproperty): Check if a property exists in a class +- [hasThrows()](classes/ClassEntity.md#mhasthrows): Checking if an entity has `throws` docBlock +- [hasTraits()](classes/ClassEntity.md#mhastraits): Check if the class contains traits +- [implementsInterface()](classes/ClassEntity.md#mimplementsinterface): Check if a class implements an interface +- [isAbstract()](classes/ClassEntity.md#misabstract): Check that an entity is abstract +- [isApi()](classes/ClassEntity.md#misapi): Checking if an entity has `api` docBlock +- [isAttribute()](classes/ClassEntity.md#misattribute): Check if a class is an attribute +- [isClass()](classes/ClassEntity.md#misclass): Check if an entity is a Class +- [isDeprecated()](classes/ClassEntity.md#misdeprecated): Checking if an entity has `deprecated` docBlock +- [isEntityFileCanBeLoad()](classes/ClassEntity.md#misentityfilecanbeload): Checking if entity data can be retrieved +- [isEnum()](classes/ClassEntity.md#misenum): Check if an entity is an Enum +- [isInstantiable()](classes/ClassEntity.md#misinstantiable): Check that an entity is instantiable +- [isInterface()](classes/ClassEntity.md#misinterface): Check if an entity is an Interface +- [isInternal()](classes/ClassEntity.md#misinternal): Checking if an entity has `internal` docBlock +- [isSubclassOf()](classes/ClassEntity.md#missubclassof): Whether the given class is a subclass of the specified class +- [isTrait()](classes/ClassEntity.md#mistrait): Check if an entity is a Trait +- [normalizeClassName()](classes/ClassEntity.md#mnormalizeclassname): Bring the class name to the standard format used in the system --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md b/docs/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md index 5f27bb4f..092b3021 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md +++ b/docs/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Parser](../../readme.md) **/** +[Reflection API](../readme.md) **/** +[Reflection API for PHP](readme.md) **/** PHP entities collection --- @@ -12,25 +12,25 @@ PHP entities collection **PHP entities collection API methods:** -- [add()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#madd): Add an entity to the collection -- [filterByInterfaces()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mfilterbyinterfaces): Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity) -- [filterByNameRegularExpression()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mfilterbynameregularexpression): Get a copy of the current collection with only entities whose names match the regular expression -- [filterByParentClassNames()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mfilterbyparentclassnames): Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity) -- [filterByPaths()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mfilterbypaths): Get a copy of the current collection only with entities filtered by file paths (from project_root) -- [findEntity()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mfindentity): Find an entity in a collection -- [get()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mget): Get an entity from a collection (only previously added) -- [getEntityCollectionName()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mgetentitycollectionname): Get collection name -- [getLoadedOrCreateNew()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mgetloadedorcreatenew): Get an entity from the collection or create a new one if it has not yet been added -- [getOnlyAbstractClasses()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mgetonlyabstractclasses): Get a copy of the current collection with only abstract classes -- [getOnlyInstantiable()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mgetonlyinstantiable): Get a copy of the current collection with only instantiable entities -- [getOnlyInterfaces()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mgetonlyinterfaces): Get a copy of the current collection with only interfaces -- [getOnlyTraits()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mgetonlytraits): Get a copy of the current collection with only traits -- [has()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mhas): Check if an entity has been added to the collection -- [isEmpty()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#misempty): Check if the collection is empty or not -- [loadEntities()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mloadentities): Load entities into a collection -- [remove()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mremove): Remove an entity from a collection -- [toArray()](/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md#mtoarray): Convert collection to array +- [add()](classes/PhpEntitiesCollection.md#madd): Add an entity to the collection +- [filterByInterfaces()](classes/PhpEntitiesCollection.md#mfilterbyinterfaces): Get a copy of the current collection only with entities filtered by interfaces names (filtering is only available for ClassLikeEntity) +- [filterByNameRegularExpression()](classes/PhpEntitiesCollection.md#mfilterbynameregularexpression): Get a copy of the current collection with only entities whose names match the regular expression +- [filterByParentClassNames()](classes/PhpEntitiesCollection.md#mfilterbyparentclassnames): Get a copy of the current collection only with entities filtered by parent classes names (filtering is only available for ClassLikeEntity) +- [filterByPaths()](classes/PhpEntitiesCollection.md#mfilterbypaths): Get a copy of the current collection only with entities filtered by file paths (from project_root) +- [findEntity()](classes/PhpEntitiesCollection.md#mfindentity): Find an entity in a collection +- [get()](classes/PhpEntitiesCollection.md#mget): Get an entity from a collection (only previously added) +- [getEntityCollectionName()](classes/PhpEntitiesCollection.md#mgetentitycollectionname): Get collection name +- [getLoadedOrCreateNew()](classes/PhpEntitiesCollection.md#mgetloadedorcreatenew): Get an entity from the collection or create a new one if it has not yet been added +- [getOnlyAbstractClasses()](classes/PhpEntitiesCollection.md#mgetonlyabstractclasses): Get a copy of the current collection with only abstract classes +- [getOnlyInstantiable()](classes/PhpEntitiesCollection.md#mgetonlyinstantiable): Get a copy of the current collection with only instantiable entities +- [getOnlyInterfaces()](classes/PhpEntitiesCollection.md#mgetonlyinterfaces): Get a copy of the current collection with only interfaces +- [getOnlyTraits()](classes/PhpEntitiesCollection.md#mgetonlytraits): Get a copy of the current collection with only traits +- [has()](classes/PhpEntitiesCollection.md#mhas): Check if an entity has been added to the collection +- [isEmpty()](classes/PhpEntitiesCollection.md#misempty): Check if the collection is empty or not +- [loadEntities()](classes/PhpEntitiesCollection.md#mloadentities): Load entities into a collection +- [remove()](classes/PhpEntitiesCollection.md#mremove): Remove an entity from a collection +- [toArray()](classes/PhpEntitiesCollection.md#mtoarray): Convert collection to array --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md index bfa984d8..50db531e 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Parser](../../readme.md) **/** +[Reflection API](../readme.md) **/** +[Reflection API for PHP](readme.md) **/** PHP enum reflection API --- @@ -10,7 +10,7 @@ PHP enum reflection API # PHP enum reflection API -PHP enum reflection [EnumEntity](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md) inherits from [ClassLikeEntity](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_3.md). +PHP enum reflection [EnumEntity](classes/EnumEntity.md) inherits from [ClassLikeEntity](classes/ClassLikeEntity_3.md). **Source enum formats:** @@ -26,71 +26,71 @@ $enumReflection = $entitiesCollection->getLoadedOrCreateNew('SomeEnumName'); // **Enum reflection API methods:** -- [getAbsoluteFileName()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetabsolutefilename): Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -- [getAst()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetast): Get AST for this entity -- [getCasesNames()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetcasesnames): Get enum cases names -- [getConstant()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetconstant): Get the method entity by its name -- [getConstantEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetconstantentitiescollection): Get a collection of constant entities -- [getConstantValue()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetconstantvalue): Get the compiled value of a constant -- [getConstants()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetconstants): Get all constants that are available according to the configuration as an array -- [getConstantsValues()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetconstantsvalues): Get class constant compiled values according to filters -- [getDescription()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetdescription): Get entity description -- [getDescriptionLinks()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetdescriptionlinks): Get parsed links from description and doc blocks `see` and `link` -- [getDocComment()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetdoccomment): Get the doc comment of an entity -- [getDocCommentLine()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetdoccommentline): Get the code line number where the docBlock of the current entity begins -- [getDocNote()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetdocnote): Get the note annotation value -- [getEndLine()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetendline): Get the line number of the end of a class code in a file -- [getEnumCaseValue()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetenumcasevalue): Get enum case value -- [getEnumCases()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetenumcases): Get enum cases values -- [getExamples()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetexamples): Get parsed examples from `examples` doc block -- [getFirstExample()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetfirstexample): Get first example from `examples` doc block -- [getImplementingClass()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetimplementingclass): Get the class like entity in which the current entity was implemented -- [getInterfaceNames()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetinterfacenames): Get a list of class interface names -- [getInterfacesEntities()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetinterfacesentities): Get a list of interface entities that the current class implements -- [getMethod()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetmethod): Get the method entity by its name -- [getMethodEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetmethodentitiescollection): Get a collection of method entities -- [getMethods()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetmethods): Get all methods that are available according to the configuration as an array -- [getName()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetname): Full name of the entity -- [getNamespaceName()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetnamespacename): Get the entity namespace name -- [getObjectId()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetobjectid): Get entity unique ID -- [getParentClass()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetparentclass): Get the entity of the parent class if it exists -- [getParentClassEntities()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetparentclassentities): Get a list of parent class entities -- [getParentClassName()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetparentclassname): Get the name of the parent class entity if it exists -- [getParentClassNames()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetparentclassnames): Get a list of entity names of parent classes -- [getPluginData()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetplugindata): Get additional information added using the plugin -- [getProperties()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetproperties): Get all properties that are available according to the configuration as an array -- [getProperty()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetproperty): Get the property entity by its name -- [getPropertyDefaultValue()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetpropertydefaultvalue): Get the compiled value of a property -- [getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetpropertyentitiescollection): Get a collection of property entities -- [getRelativeFileName()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetrelativefilename): File name relative to project_root configuration parameter -- [getRootEntityCollection()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetrootentitycollection): Get the collection of root entities to which this entity belongs -- [getShortName()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetshortname): Short name of the entity -- [getStartLine()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetstartline): Get the line number of the start of a class code in a file -- [getThrows()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgetthrows): Get parsed throws from `throws` doc block -- [getTraits()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgettraits): Get a list of trait entities of the current class -- [getTraitsNames()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mgettraitsnames): Get a list of class traits names -- [hasConstant()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mhasconstant): Check if a constant exists in a class -- [hasDescriptionLinks()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mhasdescriptionlinks): Checking if an entity has links in its description -- [hasExamples()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mhasexamples): Checking if an entity has `example` docBlock -- [hasMethod()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mhasmethod): Check if a method exists in a class -- [hasParentClass()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mhasparentclass): Check if a certain parent class exists in a chain of parent classes -- [hasProperty()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mhasproperty): Check if a property exists in a class -- [hasThrows()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mhasthrows): Checking if an entity has `throws` docBlock -- [hasTraits()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mhastraits): Check if the class contains traits -- [implementsInterface()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mimplementsinterface): Check if a class implements an interface -- [isAbstract()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#misabstract): Check that an entity is abstract -- [isApi()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#misapi): Checking if an entity has `api` docBlock -- [isClass()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#misclass): Check if an entity is a Class -- [isDeprecated()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#misdeprecated): Checking if an entity has `deprecated` docBlock -- [isEntityFileCanBeLoad()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#misentityfilecanbeload): Checking if entity data can be retrieved -- [isEnum()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#misenum): Check if an entity is an Enum -- [isInstantiable()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#misinstantiable): Check that an entity is instantiable -- [isInterface()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#misinterface): Check if an entity is an Interface -- [isInternal()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#misinternal): Checking if an entity has `internal` docBlock -- [isSubclassOf()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#missubclassof): Whether the given class is a subclass of the specified class -- [isTrait()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mistrait): Check if an entity is a Trait -- [normalizeClassName()](/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md#mnormalizeclassname): Bring the class name to the standard format used in the system +- [getAbsoluteFileName()](classes/EnumEntity.md#mgetabsolutefilename): Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +- [getAst()](classes/EnumEntity.md#mgetast): Get AST for this entity +- [getCasesNames()](classes/EnumEntity.md#mgetcasesnames): Get enum cases names +- [getConstant()](classes/EnumEntity.md#mgetconstant): Get the method entity by its name +- [getConstantEntitiesCollection()](classes/EnumEntity.md#mgetconstantentitiescollection): Get a collection of constant entities +- [getConstantValue()](classes/EnumEntity.md#mgetconstantvalue): Get the compiled value of a constant +- [getConstants()](classes/EnumEntity.md#mgetconstants): Get all constants that are available according to the configuration as an array +- [getConstantsValues()](classes/EnumEntity.md#mgetconstantsvalues): Get class constant compiled values according to filters +- [getDescription()](classes/EnumEntity.md#mgetdescription): Get entity description +- [getDescriptionLinks()](classes/EnumEntity.md#mgetdescriptionlinks): Get parsed links from description and doc blocks `see` and `link` +- [getDocComment()](classes/EnumEntity.md#mgetdoccomment): Get the doc comment of an entity +- [getDocCommentLine()](classes/EnumEntity.md#mgetdoccommentline): Get the code line number where the docBlock of the current entity begins +- [getDocNote()](classes/EnumEntity.md#mgetdocnote): Get the note annotation value +- [getEndLine()](classes/EnumEntity.md#mgetendline): Get the line number of the end of a class code in a file +- [getEnumCaseValue()](classes/EnumEntity.md#mgetenumcasevalue): Get enum case value +- [getEnumCases()](classes/EnumEntity.md#mgetenumcases): Get enum cases values +- [getExamples()](classes/EnumEntity.md#mgetexamples): Get parsed examples from `examples` doc block +- [getFirstExample()](classes/EnumEntity.md#mgetfirstexample): Get first example from `examples` doc block +- [getImplementingClass()](classes/EnumEntity.md#mgetimplementingclass): Get the class like entity in which the current entity was implemented +- [getInterfaceNames()](classes/EnumEntity.md#mgetinterfacenames): Get a list of class interface names +- [getInterfacesEntities()](classes/EnumEntity.md#mgetinterfacesentities): Get a list of interface entities that the current class implements +- [getMethod()](classes/EnumEntity.md#mgetmethod): Get the method entity by its name +- [getMethodEntitiesCollection()](classes/EnumEntity.md#mgetmethodentitiescollection): Get a collection of method entities +- [getMethods()](classes/EnumEntity.md#mgetmethods): Get all methods that are available according to the configuration as an array +- [getName()](classes/EnumEntity.md#mgetname): Full name of the entity +- [getNamespaceName()](classes/EnumEntity.md#mgetnamespacename): Get the entity namespace name +- [getObjectId()](classes/EnumEntity.md#mgetobjectid): Get entity unique ID +- [getParentClass()](classes/EnumEntity.md#mgetparentclass): Get the entity of the parent class if it exists +- [getParentClassEntities()](classes/EnumEntity.md#mgetparentclassentities): Get a list of parent class entities +- [getParentClassName()](classes/EnumEntity.md#mgetparentclassname): Get the name of the parent class entity if it exists +- [getParentClassNames()](classes/EnumEntity.md#mgetparentclassnames): Get a list of entity names of parent classes +- [getPluginData()](classes/EnumEntity.md#mgetplugindata): Get additional information added using the plugin +- [getProperties()](classes/EnumEntity.md#mgetproperties): Get all properties that are available according to the configuration as an array +- [getProperty()](classes/EnumEntity.md#mgetproperty): Get the property entity by its name +- [getPropertyDefaultValue()](classes/EnumEntity.md#mgetpropertydefaultvalue): Get the compiled value of a property +- [getPropertyEntitiesCollection()](classes/EnumEntity.md#mgetpropertyentitiescollection): Get a collection of property entities +- [getRelativeFileName()](classes/EnumEntity.md#mgetrelativefilename): File name relative to project_root configuration parameter +- [getRootEntityCollection()](classes/EnumEntity.md#mgetrootentitycollection): Get the collection of root entities to which this entity belongs +- [getShortName()](classes/EnumEntity.md#mgetshortname): Short name of the entity +- [getStartLine()](classes/EnumEntity.md#mgetstartline): Get the line number of the start of a class code in a file +- [getThrows()](classes/EnumEntity.md#mgetthrows): Get parsed throws from `throws` doc block +- [getTraits()](classes/EnumEntity.md#mgettraits): Get a list of trait entities of the current class +- [getTraitsNames()](classes/EnumEntity.md#mgettraitsnames): Get a list of class traits names +- [hasConstant()](classes/EnumEntity.md#mhasconstant): Check if a constant exists in a class +- [hasDescriptionLinks()](classes/EnumEntity.md#mhasdescriptionlinks): Checking if an entity has links in its description +- [hasExamples()](classes/EnumEntity.md#mhasexamples): Checking if an entity has `example` docBlock +- [hasMethod()](classes/EnumEntity.md#mhasmethod): Check if a method exists in a class +- [hasParentClass()](classes/EnumEntity.md#mhasparentclass): Check if a certain parent class exists in a chain of parent classes +- [hasProperty()](classes/EnumEntity.md#mhasproperty): Check if a property exists in a class +- [hasThrows()](classes/EnumEntity.md#mhasthrows): Checking if an entity has `throws` docBlock +- [hasTraits()](classes/EnumEntity.md#mhastraits): Check if the class contains traits +- [implementsInterface()](classes/EnumEntity.md#mimplementsinterface): Check if a class implements an interface +- [isAbstract()](classes/EnumEntity.md#misabstract): Check that an entity is abstract +- [isApi()](classes/EnumEntity.md#misapi): Checking if an entity has `api` docBlock +- [isClass()](classes/EnumEntity.md#misclass): Check if an entity is a Class +- [isDeprecated()](classes/EnumEntity.md#misdeprecated): Checking if an entity has `deprecated` docBlock +- [isEntityFileCanBeLoad()](classes/EnumEntity.md#misentityfilecanbeload): Checking if entity data can be retrieved +- [isEnum()](classes/EnumEntity.md#misenum): Check if an entity is an Enum +- [isInstantiable()](classes/EnumEntity.md#misinstantiable): Check that an entity is instantiable +- [isInterface()](classes/EnumEntity.md#misinterface): Check if an entity is an Interface +- [isInternal()](classes/EnumEntity.md#misinternal): Checking if an entity has `internal` docBlock +- [isSubclassOf()](classes/EnumEntity.md#missubclassof): Whether the given class is a subclass of the specified class +- [isTrait()](classes/EnumEntity.md#mistrait): Check if an entity is a Trait +- [normalizeClassName()](classes/EnumEntity.md#mnormalizeclassname): Bring the class name to the standard format used in the system --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md index b269b0e4..71dbc524 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Parser](../../readme.md) **/** +[Reflection API](../readme.md) **/** +[Reflection API for PHP](readme.md) **/** PHP interface reflection API --- @@ -10,7 +10,7 @@ PHP interface reflection API # PHP interface reflection API -PHP interface reflection [InterfaceEntity](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md) inherits from [ClassLikeEntity](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_2.md). +PHP interface reflection [InterfaceEntity](classes/InterfaceEntity.md) inherits from [ClassLikeEntity](classes/ClassLikeEntity_2.md). **Source interface formats:** @@ -26,68 +26,68 @@ $interfaceReflection = $entitiesCollection->getLoadedOrCreateNew('SomeInterfaceN **Interface reflection API methods:** -- [getAbsoluteFileName()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetabsolutefilename): Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -- [getAst()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetast): Get AST for this entity -- [getConstant()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetconstant): Get the method entity by its name -- [getConstantEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetconstantentitiescollection): Get a collection of constant entities -- [getConstantValue()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetconstantvalue): Get the compiled value of a constant -- [getConstants()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetconstants): Get all constants that are available according to the configuration as an array -- [getConstantsValues()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetconstantsvalues): Get class constant compiled values according to filters -- [getDescription()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetdescription): Get entity description -- [getDescriptionLinks()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetdescriptionlinks): Get parsed links from description and doc blocks `see` and `link` -- [getDocComment()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetdoccomment): Get the doc comment of an entity -- [getDocCommentLine()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetdoccommentline): Get the code line number where the docBlock of the current entity begins -- [getDocNote()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetdocnote): Get the note annotation value -- [getEndLine()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetendline): Get the line number of the end of a class code in a file -- [getExamples()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetexamples): Get parsed examples from `examples` doc block -- [getFirstExample()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetfirstexample): Get first example from `examples` doc block -- [getImplementingClass()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetimplementingclass): Get the class like entity in which the current entity was implemented -- [getInterfaceNames()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetinterfacenames): Get a list of class interface names -- [getInterfacesEntities()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetinterfacesentities): Get a list of interface entities that the current class implements -- [getMethod()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetmethod): Get the method entity by its name -- [getMethodEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetmethodentitiescollection): Get a collection of method entities -- [getMethods()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetmethods): Get all methods that are available according to the configuration as an array -- [getName()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetname): Full name of the entity -- [getNamespaceName()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetnamespacename): Get the entity namespace name -- [getObjectId()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetobjectid): Get entity unique ID -- [getParentClass()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetparentclass): Get the entity of the parent class if it exists -- [getParentClassEntities()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetparentclassentities): Get a list of parent class entities -- [getParentClassName()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetparentclassname): Get the name of the parent class entity if it exists -- [getParentClassNames()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetparentclassnames): Get a list of entity names of parent classes -- [getPluginData()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetplugindata): Get additional information added using the plugin -- [getProperties()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetproperties): Get all properties that are available according to the configuration as an array -- [getProperty()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetproperty): Get the property entity by its name -- [getPropertyDefaultValue()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetpropertydefaultvalue): Get the compiled value of a property -- [getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetpropertyentitiescollection): Get a collection of property entities -- [getRelativeFileName()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetrelativefilename): File name relative to project_root configuration parameter -- [getRootEntityCollection()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetrootentitycollection): Get the collection of root entities to which this entity belongs -- [getShortName()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetshortname): Short name of the entity -- [getStartLine()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetstartline): Get the line number of the start of a class code in a file -- [getThrows()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgetthrows): Get parsed throws from `throws` doc block -- [getTraits()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgettraits): Get a list of trait entities of the current class -- [getTraitsNames()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mgettraitsnames): Get a list of class traits names -- [hasConstant()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mhasconstant): Check if a constant exists in a class -- [hasDescriptionLinks()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mhasdescriptionlinks): Checking if an entity has links in its description -- [hasExamples()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mhasexamples): Checking if an entity has `example` docBlock -- [hasMethod()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mhasmethod): Check if a method exists in a class -- [hasParentClass()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mhasparentclass): Check if a certain parent class exists in a chain of parent classes -- [hasProperty()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mhasproperty): Check if a property exists in a class -- [hasThrows()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mhasthrows): Checking if an entity has `throws` docBlock -- [hasTraits()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mhastraits): Check if the class contains traits -- [implementsInterface()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mimplementsinterface): Check if a class implements an interface -- [isAbstract()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#misabstract): Check that an entity is abstract -- [isApi()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#misapi): Checking if an entity has `api` docBlock -- [isClass()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#misclass): Check if an entity is a Class -- [isDeprecated()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#misdeprecated): Checking if an entity has `deprecated` docBlock -- [isEntityFileCanBeLoad()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#misentityfilecanbeload): Checking if entity data can be retrieved -- [isEnum()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#misenum): Check if an entity is an Enum -- [isInstantiable()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#misinstantiable): Check that an entity is instantiable -- [isInterface()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#misinterface): Check if an entity is an Interface -- [isInternal()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#misinternal): Checking if an entity has `internal` docBlock -- [isSubclassOf()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#missubclassof): Whether the given class is a subclass of the specified class -- [isTrait()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mistrait): Check if an entity is a Trait -- [normalizeClassName()](/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md#mnormalizeclassname): Bring the class name to the standard format used in the system +- [getAbsoluteFileName()](classes/InterfaceEntity.md#mgetabsolutefilename): Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +- [getAst()](classes/InterfaceEntity.md#mgetast): Get AST for this entity +- [getConstant()](classes/InterfaceEntity.md#mgetconstant): Get the method entity by its name +- [getConstantEntitiesCollection()](classes/InterfaceEntity.md#mgetconstantentitiescollection): Get a collection of constant entities +- [getConstantValue()](classes/InterfaceEntity.md#mgetconstantvalue): Get the compiled value of a constant +- [getConstants()](classes/InterfaceEntity.md#mgetconstants): Get all constants that are available according to the configuration as an array +- [getConstantsValues()](classes/InterfaceEntity.md#mgetconstantsvalues): Get class constant compiled values according to filters +- [getDescription()](classes/InterfaceEntity.md#mgetdescription): Get entity description +- [getDescriptionLinks()](classes/InterfaceEntity.md#mgetdescriptionlinks): Get parsed links from description and doc blocks `see` and `link` +- [getDocComment()](classes/InterfaceEntity.md#mgetdoccomment): Get the doc comment of an entity +- [getDocCommentLine()](classes/InterfaceEntity.md#mgetdoccommentline): Get the code line number where the docBlock of the current entity begins +- [getDocNote()](classes/InterfaceEntity.md#mgetdocnote): Get the note annotation value +- [getEndLine()](classes/InterfaceEntity.md#mgetendline): Get the line number of the end of a class code in a file +- [getExamples()](classes/InterfaceEntity.md#mgetexamples): Get parsed examples from `examples` doc block +- [getFirstExample()](classes/InterfaceEntity.md#mgetfirstexample): Get first example from `examples` doc block +- [getImplementingClass()](classes/InterfaceEntity.md#mgetimplementingclass): Get the class like entity in which the current entity was implemented +- [getInterfaceNames()](classes/InterfaceEntity.md#mgetinterfacenames): Get a list of class interface names +- [getInterfacesEntities()](classes/InterfaceEntity.md#mgetinterfacesentities): Get a list of interface entities that the current class implements +- [getMethod()](classes/InterfaceEntity.md#mgetmethod): Get the method entity by its name +- [getMethodEntitiesCollection()](classes/InterfaceEntity.md#mgetmethodentitiescollection): Get a collection of method entities +- [getMethods()](classes/InterfaceEntity.md#mgetmethods): Get all methods that are available according to the configuration as an array +- [getName()](classes/InterfaceEntity.md#mgetname): Full name of the entity +- [getNamespaceName()](classes/InterfaceEntity.md#mgetnamespacename): Get the entity namespace name +- [getObjectId()](classes/InterfaceEntity.md#mgetobjectid): Get entity unique ID +- [getParentClass()](classes/InterfaceEntity.md#mgetparentclass): Get the entity of the parent class if it exists +- [getParentClassEntities()](classes/InterfaceEntity.md#mgetparentclassentities): Get a list of parent class entities +- [getParentClassName()](classes/InterfaceEntity.md#mgetparentclassname): Get the name of the parent class entity if it exists +- [getParentClassNames()](classes/InterfaceEntity.md#mgetparentclassnames): Get a list of entity names of parent classes +- [getPluginData()](classes/InterfaceEntity.md#mgetplugindata): Get additional information added using the plugin +- [getProperties()](classes/InterfaceEntity.md#mgetproperties): Get all properties that are available according to the configuration as an array +- [getProperty()](classes/InterfaceEntity.md#mgetproperty): Get the property entity by its name +- [getPropertyDefaultValue()](classes/InterfaceEntity.md#mgetpropertydefaultvalue): Get the compiled value of a property +- [getPropertyEntitiesCollection()](classes/InterfaceEntity.md#mgetpropertyentitiescollection): Get a collection of property entities +- [getRelativeFileName()](classes/InterfaceEntity.md#mgetrelativefilename): File name relative to project_root configuration parameter +- [getRootEntityCollection()](classes/InterfaceEntity.md#mgetrootentitycollection): Get the collection of root entities to which this entity belongs +- [getShortName()](classes/InterfaceEntity.md#mgetshortname): Short name of the entity +- [getStartLine()](classes/InterfaceEntity.md#mgetstartline): Get the line number of the start of a class code in a file +- [getThrows()](classes/InterfaceEntity.md#mgetthrows): Get parsed throws from `throws` doc block +- [getTraits()](classes/InterfaceEntity.md#mgettraits): Get a list of trait entities of the current class +- [getTraitsNames()](classes/InterfaceEntity.md#mgettraitsnames): Get a list of class traits names +- [hasConstant()](classes/InterfaceEntity.md#mhasconstant): Check if a constant exists in a class +- [hasDescriptionLinks()](classes/InterfaceEntity.md#mhasdescriptionlinks): Checking if an entity has links in its description +- [hasExamples()](classes/InterfaceEntity.md#mhasexamples): Checking if an entity has `example` docBlock +- [hasMethod()](classes/InterfaceEntity.md#mhasmethod): Check if a method exists in a class +- [hasParentClass()](classes/InterfaceEntity.md#mhasparentclass): Check if a certain parent class exists in a chain of parent classes +- [hasProperty()](classes/InterfaceEntity.md#mhasproperty): Check if a property exists in a class +- [hasThrows()](classes/InterfaceEntity.md#mhasthrows): Checking if an entity has `throws` docBlock +- [hasTraits()](classes/InterfaceEntity.md#mhastraits): Check if the class contains traits +- [implementsInterface()](classes/InterfaceEntity.md#mimplementsinterface): Check if a class implements an interface +- [isAbstract()](classes/InterfaceEntity.md#misabstract): Check that an entity is abstract +- [isApi()](classes/InterfaceEntity.md#misapi): Checking if an entity has `api` docBlock +- [isClass()](classes/InterfaceEntity.md#misclass): Check if an entity is a Class +- [isDeprecated()](classes/InterfaceEntity.md#misdeprecated): Checking if an entity has `deprecated` docBlock +- [isEntityFileCanBeLoad()](classes/InterfaceEntity.md#misentityfilecanbeload): Checking if entity data can be retrieved +- [isEnum()](classes/InterfaceEntity.md#misenum): Check if an entity is an Enum +- [isInstantiable()](classes/InterfaceEntity.md#misinstantiable): Check that an entity is instantiable +- [isInterface()](classes/InterfaceEntity.md#misinterface): Check if an entity is an Interface +- [isInternal()](classes/InterfaceEntity.md#misinternal): Checking if an entity has `internal` docBlock +- [isSubclassOf()](classes/InterfaceEntity.md#missubclassof): Whether the given class is a subclass of the specified class +- [isTrait()](classes/InterfaceEntity.md#mistrait): Check if an entity is a Trait +- [normalizeClassName()](classes/InterfaceEntity.md#mnormalizeclassname): Bring the class name to the standard format used in the system --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md index e0491fe5..47bcaed1 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** -[Reflection API for PHP](/docs/tech/02_parser/reflectionApi/php/readme.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Parser](../../readme.md) **/** +[Reflection API](../readme.md) **/** +[Reflection API for PHP](readme.md) **/** PHP trait reflection API --- @@ -10,7 +10,7 @@ PHP trait reflection API # PHP trait reflection API -PHP trait reflection [TraitEntity](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md) inherits from [ClassLikeEntity](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity.md). +PHP trait reflection [TraitEntity](classes/TraitEntity.md) inherits from [ClassLikeEntity](classes/ClassLikeEntity.md). **Source trait formats:** @@ -26,68 +26,68 @@ $traitReflection = $entitiesCollection->getLoadedOrCreateNew('SomeTraitName'); / **Trait reflection API methods:** -- [getAbsoluteFileName()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetabsolutefilename): Returns the absolute path to a file if it can be retrieved and if the file is in the project directory -- [getAst()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetast): Get AST for this entity -- [getConstant()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetconstant): Get the method entity by its name -- [getConstantEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetconstantentitiescollection): Get a collection of constant entities -- [getConstantValue()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetconstantvalue): Get the compiled value of a constant -- [getConstants()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetconstants): Get all constants that are available according to the configuration as an array -- [getConstantsValues()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetconstantsvalues): Get class constant compiled values according to filters -- [getDescription()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetdescription): Get entity description -- [getDescriptionLinks()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetdescriptionlinks): Get parsed links from description and doc blocks `see` and `link` -- [getDocComment()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetdoccomment): Get the doc comment of an entity -- [getDocCommentLine()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetdoccommentline): Get the code line number where the docBlock of the current entity begins -- [getDocNote()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetdocnote): Get the note annotation value -- [getEndLine()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetendline): Get the line number of the end of a class code in a file -- [getExamples()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetexamples): Get parsed examples from `examples` doc block -- [getFirstExample()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetfirstexample): Get first example from `examples` doc block -- [getImplementingClass()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetimplementingclass): Get the class like entity in which the current entity was implemented -- [getInterfaceNames()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetinterfacenames): Get a list of class interface names -- [getInterfacesEntities()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetinterfacesentities): Get a list of interface entities that the current class implements -- [getMethod()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetmethod): Get the method entity by its name -- [getMethodEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetmethodentitiescollection): Get a collection of method entities -- [getMethods()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetmethods): Get all methods that are available according to the configuration as an array -- [getName()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetname): Full name of the entity -- [getNamespaceName()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetnamespacename): Get the entity namespace name -- [getObjectId()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetobjectid): Get entity unique ID -- [getParentClass()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetparentclass): Get the entity of the parent class if it exists -- [getParentClassEntities()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetparentclassentities): Get a list of parent class entities -- [getParentClassName()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetparentclassname): Get the name of the parent class entity if it exists -- [getParentClassNames()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetparentclassnames): Get a list of entity names of parent classes -- [getPluginData()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetplugindata): Get additional information added using the plugin -- [getProperties()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetproperties): Get all properties that are available according to the configuration as an array -- [getProperty()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetproperty): Get the property entity by its name -- [getPropertyDefaultValue()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetpropertydefaultvalue): Get the compiled value of a property -- [getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetpropertyentitiescollection): Get a collection of property entities -- [getRelativeFileName()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetrelativefilename): File name relative to project_root configuration parameter -- [getRootEntityCollection()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetrootentitycollection): Get the collection of root entities to which this entity belongs -- [getShortName()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetshortname): Short name of the entity -- [getStartLine()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetstartline): Get the line number of the start of a class code in a file -- [getThrows()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgetthrows): Get parsed throws from `throws` doc block -- [getTraits()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgettraits): Get a list of trait entities of the current class -- [getTraitsNames()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mgettraitsnames): Get a list of class traits names -- [hasConstant()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mhasconstant): Check if a constant exists in a class -- [hasDescriptionLinks()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mhasdescriptionlinks): Checking if an entity has links in its description -- [hasExamples()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mhasexamples): Checking if an entity has `example` docBlock -- [hasMethod()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mhasmethod): Check if a method exists in a class -- [hasParentClass()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mhasparentclass): Check if a certain parent class exists in a chain of parent classes -- [hasProperty()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mhasproperty): Check if a property exists in a class -- [hasThrows()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mhasthrows): Checking if an entity has `throws` docBlock -- [hasTraits()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mhastraits): Check if the class contains traits -- [implementsInterface()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mimplementsinterface): Check if a class implements an interface -- [isAbstract()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#misabstract): Check that an entity is abstract -- [isApi()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#misapi): Checking if an entity has `api` docBlock -- [isClass()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#misclass): Check if an entity is a Class -- [isDeprecated()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#misdeprecated): Checking if an entity has `deprecated` docBlock -- [isEntityFileCanBeLoad()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#misentityfilecanbeload): Checking if entity data can be retrieved -- [isEnum()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#misenum): Check if an entity is an Enum -- [isInstantiable()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#misinstantiable): Check that an entity is instantiable -- [isInterface()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#misinterface): Check if an entity is an Interface -- [isInternal()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#misinternal): Checking if an entity has `internal` docBlock -- [isSubclassOf()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#missubclassof): Whether the given class is a subclass of the specified class -- [isTrait()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mistrait): Check if an entity is a Trait -- [normalizeClassName()](/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md#mnormalizeclassname): Bring the class name to the standard format used in the system +- [getAbsoluteFileName()](classes/TraitEntity.md#mgetabsolutefilename): Returns the absolute path to a file if it can be retrieved and if the file is in the project directory +- [getAst()](classes/TraitEntity.md#mgetast): Get AST for this entity +- [getConstant()](classes/TraitEntity.md#mgetconstant): Get the method entity by its name +- [getConstantEntitiesCollection()](classes/TraitEntity.md#mgetconstantentitiescollection): Get a collection of constant entities +- [getConstantValue()](classes/TraitEntity.md#mgetconstantvalue): Get the compiled value of a constant +- [getConstants()](classes/TraitEntity.md#mgetconstants): Get all constants that are available according to the configuration as an array +- [getConstantsValues()](classes/TraitEntity.md#mgetconstantsvalues): Get class constant compiled values according to filters +- [getDescription()](classes/TraitEntity.md#mgetdescription): Get entity description +- [getDescriptionLinks()](classes/TraitEntity.md#mgetdescriptionlinks): Get parsed links from description and doc blocks `see` and `link` +- [getDocComment()](classes/TraitEntity.md#mgetdoccomment): Get the doc comment of an entity +- [getDocCommentLine()](classes/TraitEntity.md#mgetdoccommentline): Get the code line number where the docBlock of the current entity begins +- [getDocNote()](classes/TraitEntity.md#mgetdocnote): Get the note annotation value +- [getEndLine()](classes/TraitEntity.md#mgetendline): Get the line number of the end of a class code in a file +- [getExamples()](classes/TraitEntity.md#mgetexamples): Get parsed examples from `examples` doc block +- [getFirstExample()](classes/TraitEntity.md#mgetfirstexample): Get first example from `examples` doc block +- [getImplementingClass()](classes/TraitEntity.md#mgetimplementingclass): Get the class like entity in which the current entity was implemented +- [getInterfaceNames()](classes/TraitEntity.md#mgetinterfacenames): Get a list of class interface names +- [getInterfacesEntities()](classes/TraitEntity.md#mgetinterfacesentities): Get a list of interface entities that the current class implements +- [getMethod()](classes/TraitEntity.md#mgetmethod): Get the method entity by its name +- [getMethodEntitiesCollection()](classes/TraitEntity.md#mgetmethodentitiescollection): Get a collection of method entities +- [getMethods()](classes/TraitEntity.md#mgetmethods): Get all methods that are available according to the configuration as an array +- [getName()](classes/TraitEntity.md#mgetname): Full name of the entity +- [getNamespaceName()](classes/TraitEntity.md#mgetnamespacename): Get the entity namespace name +- [getObjectId()](classes/TraitEntity.md#mgetobjectid): Get entity unique ID +- [getParentClass()](classes/TraitEntity.md#mgetparentclass): Get the entity of the parent class if it exists +- [getParentClassEntities()](classes/TraitEntity.md#mgetparentclassentities): Get a list of parent class entities +- [getParentClassName()](classes/TraitEntity.md#mgetparentclassname): Get the name of the parent class entity if it exists +- [getParentClassNames()](classes/TraitEntity.md#mgetparentclassnames): Get a list of entity names of parent classes +- [getPluginData()](classes/TraitEntity.md#mgetplugindata): Get additional information added using the plugin +- [getProperties()](classes/TraitEntity.md#mgetproperties): Get all properties that are available according to the configuration as an array +- [getProperty()](classes/TraitEntity.md#mgetproperty): Get the property entity by its name +- [getPropertyDefaultValue()](classes/TraitEntity.md#mgetpropertydefaultvalue): Get the compiled value of a property +- [getPropertyEntitiesCollection()](classes/TraitEntity.md#mgetpropertyentitiescollection): Get a collection of property entities +- [getRelativeFileName()](classes/TraitEntity.md#mgetrelativefilename): File name relative to project_root configuration parameter +- [getRootEntityCollection()](classes/TraitEntity.md#mgetrootentitycollection): Get the collection of root entities to which this entity belongs +- [getShortName()](classes/TraitEntity.md#mgetshortname): Short name of the entity +- [getStartLine()](classes/TraitEntity.md#mgetstartline): Get the line number of the start of a class code in a file +- [getThrows()](classes/TraitEntity.md#mgetthrows): Get parsed throws from `throws` doc block +- [getTraits()](classes/TraitEntity.md#mgettraits): Get a list of trait entities of the current class +- [getTraitsNames()](classes/TraitEntity.md#mgettraitsnames): Get a list of class traits names +- [hasConstant()](classes/TraitEntity.md#mhasconstant): Check if a constant exists in a class +- [hasDescriptionLinks()](classes/TraitEntity.md#mhasdescriptionlinks): Checking if an entity has links in its description +- [hasExamples()](classes/TraitEntity.md#mhasexamples): Checking if an entity has `example` docBlock +- [hasMethod()](classes/TraitEntity.md#mhasmethod): Check if a method exists in a class +- [hasParentClass()](classes/TraitEntity.md#mhasparentclass): Check if a certain parent class exists in a chain of parent classes +- [hasProperty()](classes/TraitEntity.md#mhasproperty): Check if a property exists in a class +- [hasThrows()](classes/TraitEntity.md#mhasthrows): Checking if an entity has `throws` docBlock +- [hasTraits()](classes/TraitEntity.md#mhastraits): Check if the class contains traits +- [implementsInterface()](classes/TraitEntity.md#mimplementsinterface): Check if a class implements an interface +- [isAbstract()](classes/TraitEntity.md#misabstract): Check that an entity is abstract +- [isApi()](classes/TraitEntity.md#misapi): Checking if an entity has `api` docBlock +- [isClass()](classes/TraitEntity.md#misclass): Check if an entity is a Class +- [isDeprecated()](classes/TraitEntity.md#misdeprecated): Checking if an entity has `deprecated` docBlock +- [isEntityFileCanBeLoad()](classes/TraitEntity.md#misentityfilecanbeload): Checking if entity data can be retrieved +- [isEnum()](classes/TraitEntity.md#misenum): Check if an entity is an Enum +- [isInstantiable()](classes/TraitEntity.md#misinstantiable): Check that an entity is instantiable +- [isInterface()](classes/TraitEntity.md#misinterface): Check if an entity is an Interface +- [isInternal()](classes/TraitEntity.md#misinternal): Checking if an entity has `internal` docBlock +- [isSubclassOf()](classes/TraitEntity.md#missubclassof): Whether the given class is a subclass of the specified class +- [isTrait()](classes/TraitEntity.md#mistrait): Check if an entity is a Trait +- [normalizeClassName()](classes/TraitEntity.md#mnormalizeclassname): Bring the class name to the standard format used in the system --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/readme.md b/docs/tech/02_parser/reflectionApi/php/readme.md index 949a3b90..453d797e 100644 --- a/docs/tech/02_parser/reflectionApi/php/readme.md +++ b/docs/tech/02_parser/reflectionApi/php/readme.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** -[Reflection API](/docs/tech/02_parser/reflectionApi/readme.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Parser](../../readme.md) **/** +[Reflection API](../readme.md) **/** Reflection API for PHP --- @@ -95,4 +95,4 @@ $firstMethodReturnValue = $methodReflection->getFirstReturnValue(); --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/readme.md b/docs/tech/02_parser/reflectionApi/readme.md index a8d3cc24..3cb6390f 100644 --- a/docs/tech/02_parser/reflectionApi/readme.md +++ b/docs/tech/02_parser/reflectionApi/readme.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Parser](../readme.md) **/** Reflection API --- @@ -61,9 +61,9 @@ The only difference with the first example is that the first option is more conv The settings for which entities will be available to the reflector in this case are taken from the configuration file or configuration array, depending on the method of creating the documentation generator instance. -In addition, [RootEntityCollectionsGroup](/docs/tech/02_parser/reflectionApi/classes/RootEntityCollectionsGroup.md) is always available through DI, for example when you implement some twig function or plugin. +In addition, [RootEntityCollectionsGroup](classes/RootEntityCollectionsGroup.md) is always available through DI, for example when you implement some twig function or plugin. --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/sourceLocator.md b/docs/tech/02_parser/sourceLocator.md index c301a2a0..b74684d6 100644 --- a/docs/tech/02_parser/sourceLocator.md +++ b/docs/tech/02_parser/sourceLocator.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Parser](/docs/tech/02_parser/readme.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Parser](readme.md) **/** Source locators --- @@ -21,17 +21,17 @@ source_locators: - "%project_root%/selfdoc" ``` -You can create your own source locators or use any existing ones. All source locators must implement the [SourceLocatorInterface](/docs/tech/02_parser/classes/SourceLocatorInterface.md) interface. +You can create your own source locators or use any existing ones. All source locators must implement the [SourceLocatorInterface](classes/SourceLocatorInterface.md) interface. ## Built-in source locators -- [DirectoriesSourceLocator](/docs/tech/02_parser/classes/DirectoriesSourceLocator.md) - Loads all files from the specified directory -- [FileIteratorSourceLocator](/docs/tech/02_parser/classes/FileIteratorSourceLocator.md) - Loads all files using an iterator -- [RecursiveDirectoriesSourceLocator](/docs/tech/02_parser/classes/RecursiveDirectoriesSourceLocator.md) - Loads all files from the specified directories, which are traversed recursively -- [SingleFileSourceLocator](/docs/tech/02_parser/classes/SingleFileSourceLocator.md) - Loads one specific file by its path +- [DirectoriesSourceLocator](classes/DirectoriesSourceLocator.md) - Loads all files from the specified directory +- [FileIteratorSourceLocator](classes/FileIteratorSourceLocator.md) - Loads all files using an iterator +- [RecursiveDirectoriesSourceLocator](classes/RecursiveDirectoriesSourceLocator.md) - Loads all files from the specified directories, which are traversed recursively +- [SingleFileSourceLocator](classes/SingleFileSourceLocator.md) - Loads one specific file by its path --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration.md index 568f73a0..28881e38 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** -[Front Matter](/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Renderer](../../readme.md) **/** +[How to create documentation templates?](../readme.md) **/** +[Front Matter](../frontMatter.md) **/** Configuration --- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration_2.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration_2.md index b4493c61..e7b4e4f0 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration_2.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration_2.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Renderer](../../readme.md) **/** +[How to create documentation templates?](../readme.md) **/** Configuration --- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrapper.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrapper.md index fbc0d92a..83408b62 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrapper.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrapper.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Renderer](../../readme.md) **/** +[How to create documentation templates?](../readme.md) **/** DocumentedEntityWrapper --- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrappersCollection.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrappersCollection.md index 13e60b39..efd89bf6 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrappersCollection.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrappersCollection.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Renderer](../../readme.md) **/** +[How to create documentation templates?](../readme.md) **/** DocumentedEntityWrappersCollection --- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/DrawDocumentationMenu.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/DrawDocumentationMenu.md index 5cc6a413..070b58ce 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/DrawDocumentationMenu.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/DrawDocumentationMenu.md @@ -1,14 +1,14 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** -[Front Matter](/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Renderer](../../readme.md) **/** +[How to create documentation templates?](../readme.md) **/** +[Front Matter](../frontMatter.md) **/** DrawDocumentationMenu --- -# [DrawDocumentationMenu](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L29) class: +# [DrawDocumentationMenu](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L32) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; @@ -56,7 +56,7 @@ and all links with this page are recursively collected for it, after which the h ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L31) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L34) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); ``` @@ -72,15 +72,16 @@ $dependencyFactory | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDep --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L64) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L69) ```php -public function __invoke(string|null $startPageKey = null, int|null $maxDeep = null): string; +public function __invoke(array $context, string|null $startPageKey = null, int|null $maxDeep = null): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $startPageKey | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Relative path to the page from which the menu will be generated (only child pages will be taken into account). By default, the main documentation page (readme.md) is used. | $maxDeep | [int](https://www.php.net/manual/en/language.types.integer.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Maximum parsing depth of documented links starting from the current page. @@ -90,7 +91,7 @@ $maxDeep | [int](https://www.php.net/manual/en/language.types.integer.php) \| [n --- -# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L39) +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L42) ```php public static function getName(): string; ``` @@ -99,7 +100,7 @@ public static function getName(): string; --- -# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L44) +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L47) ```php public static function getOptions(): array; ``` diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentationPageUrl.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentationPageUrl.md index 08cb13a9..8a92ee16 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentationPageUrl.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentationPageUrl.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** -[Linking templates](/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Renderer](../../readme.md) **/** +[How to create documentation templates?](../readme.md) **/** +[Linking templates](../templatesLinking.md) **/** GetDocumentationPageUrl --- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl.md index e196660f..bd03bd8e 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl.md @@ -1,14 +1,14 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** -[Linking templates](/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Renderer](../../readme.md) **/** +[How to create documentation templates?](../readme.md) **/** +[Linking templates](../templatesLinking.md) **/** GetDocumentedEntityUrl --- -# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L37) class: +# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L40) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; @@ -21,7 +21,7 @@ the `EntityDocRendererInterface::getDocFileExtension()` directory will be create ***Links:*** - [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrapper.md) - [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrappersCollection.md) -- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/03_renderer/01_howToCreateTemplates/classes/RendererContext.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/03_renderer/01_howToCreateTemplates/classes/RendererContext.md#pentitywrapperscollection) ***Examples of using:*** ```php @@ -55,10 +55,11 @@ The function returns a link to the file MainExtension 1. [__invoke](#m-invoke) 1. [getName](#mgetname) 1. [getOptions](#mgetoptions) +1. [process](#mprocess) ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L41) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L44) ```php public function __construct(\BumbleDocGen\Core\Renderer\RendererHelper $rendererHelper, \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection $documentedEntityWrappersCollection, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Monolog\Logger $logger); ``` @@ -74,15 +75,16 @@ $logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/M --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L76) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L81) ```php -public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; +public function __invoke(array $context, \BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | Processed entity collection | $entityName | [string](https://www.php.net/manual/en/language.types.string.php) | The full name of the entity for which the URL will be retrieved. If the entity is not found, the DEFAULT_URL value will be returned. | @@ -93,7 +95,7 @@ $createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.ph --- -# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L49) +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L52) ```php public static function getName(): string; ``` @@ -102,7 +104,7 @@ public static function getName(): string; --- -# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L54) +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L57) ```php public static function getOptions(): array; ``` @@ -110,3 +112,22 @@ public static function getOptions(): array; ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) --- + +# `process` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L102) +```php +public function process(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true, string|null $callingTemplate = null): string; +``` + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | - | +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | +$callingTemplate | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl_2.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl_2.md index b7fb2ada..1d3b2752 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl_2.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl_2.md @@ -1,13 +1,13 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Renderer](../../readme.md) **/** +[How to create documentation templates?](../readme.md) **/** GetDocumentedEntityUrl --- -# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L37) class: +# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L40) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; @@ -20,7 +20,7 @@ the `EntityDocRendererInterface::getDocFileExtension()` directory will be create ***Links:*** - [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrapper.md) - [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrappersCollection.md) -- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/03_renderer/01_howToCreateTemplates/classes/RendererContext.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/03_renderer/01_howToCreateTemplates/classes/RendererContext.md#pentitywrapperscollection) ***Examples of using:*** ```php @@ -54,10 +54,11 @@ The function returns a link to the file MainExtension 1. [__invoke](#m-invoke) 1. [getName](#mgetname) 1. [getOptions](#mgetoptions) +1. [process](#mprocess) ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L41) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L44) ```php public function __construct(\BumbleDocGen\Core\Renderer\RendererHelper $rendererHelper, \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection $documentedEntityWrappersCollection, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Monolog\Logger $logger); ``` @@ -73,15 +74,16 @@ $logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/M --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L76) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L81) ```php -public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; +public function __invoke(array $context, \BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | Processed entity collection | $entityName | [string](https://www.php.net/manual/en/language.types.string.php) | The full name of the entity for which the URL will be retrieved. If the entity is not found, the DEFAULT_URL value will be returned. | @@ -92,7 +94,7 @@ $createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.ph --- -# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L49) +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L52) ```php public static function getName(): string; ``` @@ -101,7 +103,7 @@ public static function getName(): string; --- -# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L54) +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L57) ```php public static function getOptions(): array; ``` @@ -109,3 +111,22 @@ public static function getOptions(): array; ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) --- + +# `process` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L102) +```php +public function process(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true, string|null $callingTemplate = null): string; +``` + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | - | +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | +$callingTemplate | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/LanguageHandlerInterface.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/LanguageHandlerInterface.md index 15248528..6aa1704e 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/LanguageHandlerInterface.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/LanguageHandlerInterface.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** -[Templates variables](/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Renderer](../../readme.md) **/** +[How to create documentation templates?](../readme.md) **/** +[Templates variables](../templatesVariables.md) **/** LanguageHandlerInterface --- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/PageHtmlLinkerPlugin.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/PageHtmlLinkerPlugin.md index 0ab9fe7f..73c526c9 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/PageHtmlLinkerPlugin.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/PageHtmlLinkerPlugin.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** -[Linking templates](/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Renderer](../../readme.md) **/** +[How to create documentation templates?](../readme.md) **/** +[Linking templates](../templatesLinking.md) **/** PageHtmlLinkerPlugin --- @@ -48,11 +48,11 @@ Adds URLs to empty links in HTML format; ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L19) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L20) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker -public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \Psr\Log\LoggerInterface $logger); +public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Psr\Log\LoggerInterface $logger); ``` ***Parameters:*** @@ -62,11 +62,12 @@ public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsH $breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | $rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | $getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | $logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | --- -# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L71) +# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L73) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker @@ -83,7 +84,7 @@ $event | [\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile](https: --- -# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L59) +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L61) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/PhpEntitiesCollection.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/PhpEntitiesCollection.md index 6ad2bd07..d4579dec 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/PhpEntitiesCollection.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/PhpEntitiesCollection.md @@ -1,8 +1,8 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** -[Templates variables](/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Renderer](../../readme.md) **/** +[How to create documentation templates?](../readme.md) **/** +[Templates variables](../templatesVariables.md) **/** PhpEntitiesCollection --- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/RendererContext.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/RendererContext.md index b6b18a7a..2de8bc62 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/RendererContext.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/RendererContext.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Renderer](../../readme.md) **/** +[How to create documentation templates?](../readme.md) **/** RendererContext --- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/RootEntityInterface.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/RootEntityInterface.md index 6575494f..c2f41d6b 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/RootEntityInterface.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/RootEntityInterface.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +[BumbleDocGen](../../../../README.md) **/** +[Technical description of the project](../../../readme.md) **/** +[Renderer](../../readme.md) **/** +[How to create documentation templates?](../readme.md) **/** RootEntityInterface --- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md b/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md index 09ac6394..d492eccf 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[How to create documentation templates?](readme.md) **/** Front Matter --- @@ -25,13 +25,13 @@ some template content ... The content of this block must be in YAML format. During the template generation process, this block is parsed, and all values become available in the form of twig variables. -By default, this block is hidden from generated MD files, but it can be displayed by enabling the special option [render_with_front_matter](/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration.md#mrenderwithfrontmatter) in the configuration +By default, this block is hidden from generated MD files, but it can be displayed by enabling the special option [render_with_front_matter](classes/Configuration.md#mrenderwithfrontmatter) in the configuration -Some Front Matter block variables are used internally in our system, for example `title` and `prevPage` are used to generate [breadcrumbs](/docs/tech/03_renderer/02_breadcrumbs.md) and [documentation menus](/docs/tech/03_renderer/01_howToCreateTemplates/classes/DrawDocumentationMenu.md). +Some Front Matter block variables are used internally in our system, for example `title` and `prevPage` are used to generate [breadcrumbs](/docs/tech/03_renderer/02_breadcrumbs.md) and [documentation menus](classes/DrawDocumentationMenu.md). This block is also used when generating HTML documentation. You can learn about the variables used in this block when generating HTML content [in the documentation of the library](https://daux.io/Features/Front_Matter.html) that we use to create HTML pages. --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/readme.md b/docs/tech/03_renderer/01_howToCreateTemplates/readme.md index 1ddbb98e..e77bb291 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/readme.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/readme.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** How to create documentation templates? --- @@ -13,10 +13,10 @@ Templates are `twig` files in which you can write both static text and dynamic b **You can read more about template parts here:** -- [Front Matter](/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md) -- [Templates dynamic blocks](/docs/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md) -- [Linking templates](/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md) -- [Templates variables](/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md) +- [Front Matter](frontMatter.md) +- [Templates dynamic blocks](templatesDynamicBlocks.md) +- [Linking templates](templatesLinking.md) +- [Templates variables](templatesVariables.md) ## Examples @@ -102,4 +102,4 @@ More static text... --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md b/docs/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md index 3a6a9dc2..a8288d3d 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[How to create documentation templates?](readme.md) **/** Templates dynamic blocks --- @@ -30,4 +30,4 @@ You can use the built-in functions and filters or add your own, so you can imple --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md b/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md index de6f8cf1..1862c943 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[How to create documentation templates?](readme.md) **/** Linking templates --- @@ -14,7 +14,7 @@ We have several options for this, such as using special functions or using a spe ## Completing blank links -Plugin [PageHtmlLinkerPlugin](/docs/tech/03_renderer/01_howToCreateTemplates/classes/PageHtmlLinkerPlugin.md) have been added to the basic configuration, +Plugin [PageHtmlLinkerPlugin](classes/PageHtmlLinkerPlugin.md) have been added to the basic configuration, which process the text of the filled template before its result is written to a file, and fill in all empty links. For example, an empty link: @@ -40,9 +40,9 @@ Examples: The second way to relink templates is to generate links through functions. -There are a number of functions that allow you to get a link to an entity, for example [GetDocumentedEntityUrl](/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl.md), and there are also functions for getting a link to other documents, for example [GetDocumentationPageUrl](/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentationPageUrl.md). +There are a number of functions that allow you to get a link to an entity, for example [GetDocumentedEntityUrl](classes/GetDocumentedEntityUrl.md), and there are also functions for getting a link to other documents, for example [GetDocumentationPageUrl](classes/GetDocumentationPageUrl.md). You can also implement your own functions for relinking if necessary. --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md b/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md index c00708f1..661d1361 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[How to create documentation templates?](readme.md) **/** Templates variables --- @@ -13,11 +13,11 @@ There are several variables available in each processed template. 1) Firstly, these are built-in twig variables, for example `_self`, which returns the path to the processed template. -2) Secondly, variables with collections of processed programming languages are available in the template (see [LanguageHandlerInterface](/docs/tech/03_renderer/01_howToCreateTemplates/classes/LanguageHandlerInterface.md)). For example, when processing a PHP project collection, a collection [PhpEntitiesCollection](/docs/tech/03_renderer/01_howToCreateTemplates/classes/PhpEntitiesCollection.md) will be available in the template under the name phpEntities +2) Secondly, variables with collections of processed programming languages are available in the template (see [LanguageHandlerInterface](classes/LanguageHandlerInterface.md)). For example, when processing a PHP project collection, a collection [PhpEntitiesCollection](classes/PhpEntitiesCollection.md) will be available in the template under the name phpEntities 3) Thirdly, all variables specified in **Front Matter** are automatically converted into template variables and are available in it --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/02_breadcrumbs.md b/docs/tech/03_renderer/02_breadcrumbs.md index d5479a8a..cf406862 100644 --- a/docs/tech/03_renderer/02_breadcrumbs.md +++ b/docs/tech/03_renderer/02_breadcrumbs.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Renderer](readme.md) **/** Documentation structure and breadcrumbs --- @@ -8,7 +8,7 @@ Documentation structure and breadcrumbs # Documentation structure and breadcrumbs -To work with breadcrumbs and get the structure of the documentation, we use the inner class [BreadcrumbsHelper](/docs/tech/03_renderer/classes/BreadcrumbsHelper.md). +To work with breadcrumbs and get the structure of the documentation, we use the inner class [BreadcrumbsHelper](classes/BreadcrumbsHelper.md). To build the documentation structure, twig templates from the `templates_dir` configuration are used. ## Project structure definitions @@ -33,7 +33,7 @@ In this way, complex documentation structures can be created with less file nest ## Displaying breadcrumbs in documents -There is a built-in function to generate breadcrumbs in templates [GeneratePageBreadcrumbs](/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs_2.md). +There is a built-in function to generate breadcrumbs in templates [GeneratePageBreadcrumbs](classes/GeneratePageBreadcrumbs_2.md). Here is how it is used in twig templates: ```twig @@ -58,4 +58,4 @@ Here is an example of the result of the `generatePageBreadcrumbs` function: --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/03_documentStructure.md b/docs/tech/03_renderer/03_documentStructure.md index c4cc36ef..e2a1c5ba 100644 --- a/docs/tech/03_renderer/03_documentStructure.md +++ b/docs/tech/03_renderer/03_documentStructure.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Renderer](readme.md) **/** Document structure of generated entities --- @@ -25,4 +25,4 @@ plugins: --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/04_twigCustomFilters.md b/docs/tech/03_renderer/04_twigCustomFilters.md index 4270e3b3..c2ca53b8 100644 --- a/docs/tech/03_renderer/04_twigCustomFilters.md +++ b/docs/tech/03_renderer/04_twigCustomFilters.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Renderer](readme.md) **/** Template filters --- @@ -61,7 +61,7 @@ Here is a list of filters available by default: - addIndentFromLeft
        + addIndentFromLeft
        Filter adds indent from left @@ -93,7 +93,7 @@ Here is a list of filters available by default: - fixStrSize
        + fixStrSize
        The filter pads the string with the specified characters on the right to the specified size @@ -125,7 +125,7 @@ Here is a list of filters available by default: - implode
        + implode
        Join array elements with a string @@ -145,7 +145,7 @@ Here is a list of filters available by default: - preg_match
        + preg_match
        Perform a regular expression match @@ -165,7 +165,7 @@ Here is a list of filters available by default: - prepareSourceLink
        + prepareSourceLink
        The filter converts the string into an anchor that can be used in a GitHub document link The filter does not accept any additional parameters @@ -174,7 +174,7 @@ Here is a list of filters available by default: - quotemeta
        + quotemeta
        Quote meta characters The filter does not accept any additional parameters @@ -183,7 +183,7 @@ Here is a list of filters available by default: - removeLineBrakes
        + removeLineBrakes
        The filter replaces all line breaks with a space The filter does not accept any additional parameters @@ -191,19 +191,31 @@ Here is a list of filters available by default:   - - strTypeToUrl
        + + strTypeToUrl
        The filter converts the string with the data type into a link to the documented entity, if possible.
        :warning: This filter initiates the creation of documents for the displayed entities
        + + + + $text + + + [string](https://www.php.net/manual/en/language.types.string.php) + + Processed text + + + $rootEntityCollection - [RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) + [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) @@ -252,4 +264,4 @@ Here is a list of filters available by default: --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Thu Jan 18 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
        **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
        **Page content update date:** Fri Jan 19 2024
        Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/05_twigCustomFunctions.md b/docs/tech/03_renderer/05_twigCustomFunctions.md index 6cb01a7e..45768fc2 100644 --- a/docs/tech/03_renderer/05_twigCustomFunctions.md +++ b/docs/tech/03_renderer/05_twigCustomFunctions.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Renderer](readme.md) **/** Template functions --- @@ -14,7 +14,7 @@ Functions available during page generation are defined in # `renderBreadcrumbs` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php#L349) -```php -public function renderBreadcrumbs(string $currentPageTitle, string $filePatch, bool $fromCurrent = true): string; -``` -Returns an HTML string with rendered breadcrumbs - -***Parameters:*** - -| Name | Type | Description | -|:-|:-|:-| -$currentPageTitle | [string](https://www.php.net/manual/en/language.types.string.php) | - | -$filePatch | [string](https://www.php.net/manual/en/language.types.string.php) | - | -$fromCurrent | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | - -***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) - ---- diff --git a/docs/tech/03_renderer/classes/Configuration.md b/docs/tech/03_renderer/classes/Configuration.md index 4d04753e..157c9c92 100644 --- a/docs/tech/03_renderer/classes/Configuration.md +++ b/docs/tech/03_renderer/classes/Configuration.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** Configuration --- diff --git a/docs/tech/03_renderer/classes/CustomFunctionInterface.md b/docs/tech/03_renderer/classes/CustomFunctionInterface.md index 6f9da1fe..6dbe2833 100644 --- a/docs/tech/03_renderer/classes/CustomFunctionInterface.md +++ b/docs/tech/03_renderer/classes/CustomFunctionInterface.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template functions](../05_twigCustomFunctions.md) **/** CustomFunctionInterface --- diff --git a/docs/tech/03_renderer/classes/DisplayClassApiMethods.md b/docs/tech/03_renderer/classes/DisplayClassApiMethods.md index 616abfec..a7a86955 100644 --- a/docs/tech/03_renderer/classes/DisplayClassApiMethods.md +++ b/docs/tech/03_renderer/classes/DisplayClassApiMethods.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template functions](../05_twigCustomFunctions.md) **/** DisplayClassApiMethods --- @@ -56,15 +56,16 @@ $getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\Get --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DisplayClassApiMethods.php#L45) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DisplayClassApiMethods.php#L47) ```php -public function __invoke(string $className): null|string; +public function __invoke(array $context, string $className): null|string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $className | [string](https://www.php.net/manual/en/language.types.string.php) | Name of the class for which API methods need to be displayed | ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) diff --git a/docs/tech/03_renderer/classes/DocumentedEntityWrapper.md b/docs/tech/03_renderer/classes/DocumentedEntityWrapper.md index 2e7c952c..d9c60bfd 100644 --- a/docs/tech/03_renderer/classes/DocumentedEntityWrapper.md +++ b/docs/tech/03_renderer/classes/DocumentedEntityWrapper.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** DocumentedEntityWrapper --- diff --git a/docs/tech/03_renderer/classes/DocumentedEntityWrappersCollection.md b/docs/tech/03_renderer/classes/DocumentedEntityWrappersCollection.md index 0356a132..adc3bddd 100644 --- a/docs/tech/03_renderer/classes/DocumentedEntityWrappersCollection.md +++ b/docs/tech/03_renderer/classes/DocumentedEntityWrappersCollection.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** DocumentedEntityWrappersCollection --- diff --git a/docs/tech/03_renderer/classes/DrawClassMap.md b/docs/tech/03_renderer/classes/DrawClassMap.md index 7b064fad..96a98d15 100644 --- a/docs/tech/03_renderer/classes/DrawClassMap.md +++ b/docs/tech/03_renderer/classes/DrawClassMap.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template functions](../05_twigCustomFunctions.md) **/** DrawClassMap --- @@ -61,22 +61,23 @@ $rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollec --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DrawClassMap.php#L57) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DrawClassMap.php#L59) ```php -public function __invoke(\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection ...$entitiesCollections): string; +public function __invoke(array $context, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection ...$entitiesCollections): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $entitiesCollections (variadic) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | The collection of entities for which the class map will be generated | ***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) --- -# `convertDirectoryStructureToFormattedString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DrawClassMap.php#L132) +# `convertDirectoryStructureToFormattedString` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DrawClassMap.php#L136) ```php public function convertDirectoryStructureToFormattedString(array $structure, string $prefix = '│', string $path = '/'): string; ``` @@ -93,15 +94,16 @@ $path | [string](https://www.php.net/manual/en/language.types.string.php) | - | --- -# `getDirectoryStructure` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DrawClassMap.php#L97) +# `getDirectoryStructure` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Renderer/Twig/Function/DrawClassMap.php#L101) ```php -public function getDirectoryStructure(\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection ...$entitiesCollections): array; +public function getDirectoryStructure(array $context, \BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection ...$entitiesCollections): array; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $entitiesCollections (variadic) | [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\PhpEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/PhpEntitiesCollection.php) | - | ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) diff --git a/docs/tech/03_renderer/classes/DrawDocumentationMenu.md b/docs/tech/03_renderer/classes/DrawDocumentationMenu.md index b12f9c82..b107a58a 100644 --- a/docs/tech/03_renderer/classes/DrawDocumentationMenu.md +++ b/docs/tech/03_renderer/classes/DrawDocumentationMenu.md @@ -1,13 +1,13 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template functions](../05_twigCustomFunctions.md) **/** DrawDocumentationMenu --- -# [DrawDocumentationMenu](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L29) class: +# [DrawDocumentationMenu](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L32) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; @@ -55,7 +55,7 @@ and all links with this page are recursively collected for it, after which the h ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L31) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L34) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); ``` @@ -71,15 +71,16 @@ $dependencyFactory | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDep --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L64) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L69) ```php -public function __invoke(string|null $startPageKey = null, int|null $maxDeep = null): string; +public function __invoke(array $context, string|null $startPageKey = null, int|null $maxDeep = null): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $startPageKey | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Relative path to the page from which the menu will be generated (only child pages will be taken into account). By default, the main documentation page (readme.md) is used. | $maxDeep | [int](https://www.php.net/manual/en/language.types.integer.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Maximum parsing depth of documented links starting from the current page. @@ -89,7 +90,7 @@ $maxDeep | [int](https://www.php.net/manual/en/language.types.integer.php) \| [n --- -# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L39) +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L42) ```php public static function getName(): string; ``` @@ -98,7 +99,7 @@ public static function getName(): string; --- -# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L44) +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L47) ```php public static function getOptions(): array; ``` diff --git a/docs/tech/03_renderer/classes/DrawDocumentedEntityLink.md b/docs/tech/03_renderer/classes/DrawDocumentedEntityLink.md index 9b7fe4cd..fad16562 100644 --- a/docs/tech/03_renderer/classes/DrawDocumentedEntityLink.md +++ b/docs/tech/03_renderer/classes/DrawDocumentedEntityLink.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template functions](../05_twigCustomFunctions.md) **/** DrawDocumentedEntityLink --- @@ -61,15 +61,16 @@ $getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\Get --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php#L50) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php#L51) ```php -public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityInterface $entity, string $cursor = '', bool $useShortName = true): string; +public function __invoke(array $context, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface $entity, string $cursor = '', bool $useShortName = true): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $entity | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) | The entity for which we want to get the link | $cursor | [string](https://www.php.net/manual/en/language.types.string.php) | Reference to an element inside an entity, for example, the name of a function/constant/property | $useShortName | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Use the full or short entity name in the link | diff --git a/docs/tech/03_renderer/classes/FileGetContents.md b/docs/tech/03_renderer/classes/FileGetContents.md index 84e46c29..e66b1957 100644 --- a/docs/tech/03_renderer/classes/FileGetContents.md +++ b/docs/tech/03_renderer/classes/FileGetContents.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template functions](../05_twigCustomFunctions.md) **/** FileGetContents --- diff --git a/docs/tech/03_renderer/classes/FixStrSize.md b/docs/tech/03_renderer/classes/FixStrSize.md index b6ef738a..a4eae2b2 100644 --- a/docs/tech/03_renderer/classes/FixStrSize.md +++ b/docs/tech/03_renderer/classes/FixStrSize.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template filters](/docs/tech/03_renderer/04_twigCustomFilters.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template filters](../04_twigCustomFilters.md) **/** FixStrSize --- diff --git a/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs.md b/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs.md index 72e86839..3e2cac1f 100644 --- a/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs.md +++ b/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs.md @@ -1,13 +1,13 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template functions](../05_twigCustomFunctions.md) **/** GeneratePageBreadcrumbs --- -# [GeneratePageBreadcrumbs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L20) class: +# [GeneratePageBreadcrumbs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L24) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; @@ -37,9 +37,9 @@ Function to generate breadcrumbs on the page ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L22) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L26) ```php -public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); +public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsTwigEnvironment $breadcrumbsTwig, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); ``` ***Parameters:*** @@ -47,12 +47,14 @@ public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsH | Name | Type | Description | |:-|:-|:-| $breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$breadcrumbsTwig | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsTwigEnvironment](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsTwigEnvironment.php) | - | $rendererContext | [\BumbleDocGen\Core\Renderer\Context\RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | $dependencyFactory | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/Dependency/RendererDependencyFactory.php) | - | --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L57) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L63) ```php public function __invoke(string $currentPageTitle, string $templatePath, bool $skipFirstTemplatePage = true): string; ``` @@ -71,7 +73,7 @@ $skipFirstTemplatePage | [bool](https://www.php.net/manual/en/language.types.boo --- -# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L29) +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L35) ```php public static function getName(): string; ``` @@ -80,7 +82,7 @@ public static function getName(): string; --- -# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L34) +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L40) ```php public static function getOptions(): array; ``` diff --git a/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs_2.md b/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs_2.md index 319ab36b..94ddb768 100644 --- a/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs_2.md +++ b/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs_2.md @@ -1,13 +1,13 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Documentation structure and breadcrumbs](/docs/tech/03_renderer/02_breadcrumbs.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Documentation structure and breadcrumbs](../02_breadcrumbs.md) **/** GeneratePageBreadcrumbs --- -# [GeneratePageBreadcrumbs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L20) class: +# [GeneratePageBreadcrumbs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L24) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; @@ -37,9 +37,9 @@ Function to generate breadcrumbs on the page ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L22) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L26) ```php -public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); +public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsTwigEnvironment $breadcrumbsTwig, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); ``` ***Parameters:*** @@ -47,12 +47,14 @@ public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsH | Name | Type | Description | |:-|:-|:-| $breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$breadcrumbsTwig | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsTwigEnvironment](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsTwigEnvironment.php) | - | $rendererContext | [\BumbleDocGen\Core\Renderer\Context\RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | $dependencyFactory | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/Dependency/RendererDependencyFactory.php) | - | --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L57) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L63) ```php public function __invoke(string $currentPageTitle, string $templatePath, bool $skipFirstTemplatePage = true): string; ``` @@ -71,7 +73,7 @@ $skipFirstTemplatePage | [bool](https://www.php.net/manual/en/language.types.boo --- -# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L29) +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L35) ```php public static function getName(): string; ``` @@ -80,7 +82,7 @@ public static function getName(): string; --- -# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L34) +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L40) ```php public static function getOptions(): array; ``` diff --git a/docs/tech/03_renderer/classes/GetClassMethodsBodyCode.md b/docs/tech/03_renderer/classes/GetClassMethodsBodyCode.md index 471c2954..a46906a5 100644 --- a/docs/tech/03_renderer/classes/GetClassMethodsBodyCode.md +++ b/docs/tech/03_renderer/classes/GetClassMethodsBodyCode.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template functions](../05_twigCustomFunctions.md) **/** GetClassMethodsBodyCode --- diff --git a/docs/tech/03_renderer/classes/GetDocumentationPageUrl.md b/docs/tech/03_renderer/classes/GetDocumentationPageUrl.md index b518c69f..e25e39b9 100644 --- a/docs/tech/03_renderer/classes/GetDocumentationPageUrl.md +++ b/docs/tech/03_renderer/classes/GetDocumentationPageUrl.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template functions](../05_twigCustomFunctions.md) **/** GetDocumentationPageUrl --- diff --git a/docs/tech/03_renderer/classes/GetDocumentedEntityUrl.md b/docs/tech/03_renderer/classes/GetDocumentedEntityUrl.md index aca51be5..d0fc04cb 100644 --- a/docs/tech/03_renderer/classes/GetDocumentedEntityUrl.md +++ b/docs/tech/03_renderer/classes/GetDocumentedEntityUrl.md @@ -1,13 +1,13 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template functions](../05_twigCustomFunctions.md) **/** GetDocumentedEntityUrl --- -# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L37) class: +# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L40) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; @@ -20,7 +20,7 @@ the `EntityDocRendererInterface::getDocFileExtension()` directory will be create ***Links:*** - [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/03_renderer/classes/DocumentedEntityWrapper.md) - [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/03_renderer/classes/DocumentedEntityWrappersCollection.md) -- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/03_renderer/classes/RendererContext.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/03_renderer/classes/RendererContext.md#pentitywrapperscollection) ***Examples of using:*** ```php @@ -54,10 +54,11 @@ The function returns a link to the file MainExtension 1. [__invoke](#m-invoke) 1. [getName](#mgetname) 1. [getOptions](#mgetoptions) +1. [process](#mprocess) ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L41) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L44) ```php public function __construct(\BumbleDocGen\Core\Renderer\RendererHelper $rendererHelper, \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection $documentedEntityWrappersCollection, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Monolog\Logger $logger); ``` @@ -73,15 +74,16 @@ $logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/M --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L76) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L81) ```php -public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; +public function __invoke(array $context, \BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | Processed entity collection | $entityName | [string](https://www.php.net/manual/en/language.types.string.php) | The full name of the entity for which the URL will be retrieved. If the entity is not found, the DEFAULT_URL value will be returned. | @@ -92,7 +94,7 @@ $createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.ph --- -# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L49) +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L52) ```php public static function getName(): string; ``` @@ -101,7 +103,7 @@ public static function getName(): string; --- -# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L54) +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L57) ```php public static function getOptions(): array; ``` @@ -109,3 +111,22 @@ public static function getOptions(): array; ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) --- + +# `process` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L102) +```php +public function process(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true, string|null $callingTemplate = null): string; +``` + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | - | +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | +$callingTemplate | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- diff --git a/docs/tech/03_renderer/classes/GetDocumentedEntityUrl_2.md b/docs/tech/03_renderer/classes/GetDocumentedEntityUrl_2.md index c583a7d0..05c4de2d 100644 --- a/docs/tech/03_renderer/classes/GetDocumentedEntityUrl_2.md +++ b/docs/tech/03_renderer/classes/GetDocumentedEntityUrl_2.md @@ -1,12 +1,12 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** GetDocumentedEntityUrl --- -# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L37) class: +# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L40) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; @@ -19,7 +19,7 @@ the `EntityDocRendererInterface::getDocFileExtension()` directory will be create ***Links:*** - [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/03_renderer/classes/DocumentedEntityWrapper.md) - [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/03_renderer/classes/DocumentedEntityWrappersCollection.md) -- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/03_renderer/classes/RendererContext.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/03_renderer/classes/RendererContext.md#pentitywrapperscollection) ***Examples of using:*** ```php @@ -53,10 +53,11 @@ The function returns a link to the file MainExtension 1. [__invoke](#m-invoke) 1. [getName](#mgetname) 1. [getOptions](#mgetoptions) +1. [process](#mprocess) ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L41) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L44) ```php public function __construct(\BumbleDocGen\Core\Renderer\RendererHelper $rendererHelper, \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection $documentedEntityWrappersCollection, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Monolog\Logger $logger); ``` @@ -72,15 +73,16 @@ $logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/M --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L76) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L81) ```php -public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; +public function __invoke(array $context, \BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | Processed entity collection | $entityName | [string](https://www.php.net/manual/en/language.types.string.php) | The full name of the entity for which the URL will be retrieved. If the entity is not found, the DEFAULT_URL value will be returned. | @@ -91,7 +93,7 @@ $createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.ph --- -# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L49) +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L52) ```php public static function getName(): string; ``` @@ -100,7 +102,7 @@ public static function getName(): string; --- -# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L54) +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L57) ```php public static function getOptions(): array; ``` @@ -108,3 +110,22 @@ public static function getOptions(): array; ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) --- + +# `process` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L102) +```php +public function process(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true, string|null $callingTemplate = null): string; +``` + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | - | +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | +$callingTemplate | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- diff --git a/docs/tech/03_renderer/classes/Implode.md b/docs/tech/03_renderer/classes/Implode.md index df92158a..b31f329b 100644 --- a/docs/tech/03_renderer/classes/Implode.md +++ b/docs/tech/03_renderer/classes/Implode.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template filters](/docs/tech/03_renderer/04_twigCustomFilters.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template filters](../04_twigCustomFilters.md) **/** Implode --- diff --git a/docs/tech/03_renderer/classes/LoadPluginsContent.md b/docs/tech/03_renderer/classes/LoadPluginsContent.md index 8cf304cc..040cc7c5 100644 --- a/docs/tech/03_renderer/classes/LoadPluginsContent.md +++ b/docs/tech/03_renderer/classes/LoadPluginsContent.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template functions](../05_twigCustomFunctions.md) **/** LoadPluginsContent --- diff --git a/docs/tech/03_renderer/classes/PhpEntitiesCollection.md b/docs/tech/03_renderer/classes/PhpEntitiesCollection.md index 869fec21..109f2933 100644 --- a/docs/tech/03_renderer/classes/PhpEntitiesCollection.md +++ b/docs/tech/03_renderer/classes/PhpEntitiesCollection.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template functions](../05_twigCustomFunctions.md) **/** PhpEntitiesCollection --- diff --git a/docs/tech/03_renderer/classes/PregMatch.md b/docs/tech/03_renderer/classes/PregMatch.md index 921d145c..3ae03066 100644 --- a/docs/tech/03_renderer/classes/PregMatch.md +++ b/docs/tech/03_renderer/classes/PregMatch.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template filters](/docs/tech/03_renderer/04_twigCustomFilters.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template filters](../04_twigCustomFilters.md) **/** PregMatch --- diff --git a/docs/tech/03_renderer/classes/PrepareSourceLink.md b/docs/tech/03_renderer/classes/PrepareSourceLink.md index 44e8fdbb..55cce779 100644 --- a/docs/tech/03_renderer/classes/PrepareSourceLink.md +++ b/docs/tech/03_renderer/classes/PrepareSourceLink.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template filters](/docs/tech/03_renderer/04_twigCustomFilters.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template filters](../04_twigCustomFilters.md) **/** PrepareSourceLink --- diff --git a/docs/tech/03_renderer/classes/PrintEntityCollectionAsList.md b/docs/tech/03_renderer/classes/PrintEntityCollectionAsList.md index 6a1df20d..d3f8581c 100644 --- a/docs/tech/03_renderer/classes/PrintEntityCollectionAsList.md +++ b/docs/tech/03_renderer/classes/PrintEntityCollectionAsList.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template functions](../05_twigCustomFunctions.md) **/** PrintEntityCollectionAsList --- @@ -61,15 +61,16 @@ $removeLineBrakes | [\BumbleDocGen\Core\Renderer\Twig\Filter\RemoveLineBrakes](h --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php#L50) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php#L51) ```php -public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $type = 'ul', bool $skipDescription = false, bool $useFullName = false): string; +public function __invoke(array $context, \BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $type = 'ul', bool $skipDescription = false, bool $useFullName = false): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | Processed entity collection | $type | [string](https://www.php.net/manual/en/language.types.string.php) | List tag type (
          /
            ) | $skipDescription | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Don't print description of this entities | diff --git a/docs/tech/03_renderer/classes/Quotemeta.md b/docs/tech/03_renderer/classes/Quotemeta.md index 3a103586..08b96be6 100644 --- a/docs/tech/03_renderer/classes/Quotemeta.md +++ b/docs/tech/03_renderer/classes/Quotemeta.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template filters](/docs/tech/03_renderer/04_twigCustomFilters.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template filters](../04_twigCustomFilters.md) **/** Quotemeta --- diff --git a/docs/tech/03_renderer/classes/RemoveLineBrakes.md b/docs/tech/03_renderer/classes/RemoveLineBrakes.md index 8e4a1cac..5586e65e 100644 --- a/docs/tech/03_renderer/classes/RemoveLineBrakes.md +++ b/docs/tech/03_renderer/classes/RemoveLineBrakes.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template filters](/docs/tech/03_renderer/04_twigCustomFilters.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template filters](../04_twigCustomFilters.md) **/** RemoveLineBrakes --- diff --git a/docs/tech/03_renderer/classes/RendererContext.md b/docs/tech/03_renderer/classes/RendererContext.md index b29a2711..97c045d0 100644 --- a/docs/tech/03_renderer/classes/RendererContext.md +++ b/docs/tech/03_renderer/classes/RendererContext.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** RendererContext --- diff --git a/docs/tech/03_renderer/classes/RootEntityCollection.md b/docs/tech/03_renderer/classes/RootEntityCollection.md index 9edaf7f8..f9c022e7 100644 --- a/docs/tech/03_renderer/classes/RootEntityCollection.md +++ b/docs/tech/03_renderer/classes/RootEntityCollection.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template functions](../05_twigCustomFunctions.md) **/** RootEntityCollection --- diff --git a/docs/tech/03_renderer/classes/RootEntityInterface.md b/docs/tech/03_renderer/classes/RootEntityInterface.md index 04300e3f..4495a2e6 100644 --- a/docs/tech/03_renderer/classes/RootEntityInterface.md +++ b/docs/tech/03_renderer/classes/RootEntityInterface.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template functions](../05_twigCustomFunctions.md) **/** RootEntityInterface --- diff --git a/docs/tech/03_renderer/classes/RootEntityInterface_2.md b/docs/tech/03_renderer/classes/RootEntityInterface_2.md index 2de3adf4..a8e78f31 100644 --- a/docs/tech/03_renderer/classes/RootEntityInterface_2.md +++ b/docs/tech/03_renderer/classes/RootEntityInterface_2.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** RootEntityInterface --- diff --git a/docs/tech/03_renderer/classes/StrTypeToUrl.md b/docs/tech/03_renderer/classes/StrTypeToUrl.md index 117ee51b..f3c4d17d 100644 --- a/docs/tech/03_renderer/classes/StrTypeToUrl.md +++ b/docs/tech/03_renderer/classes/StrTypeToUrl.md @@ -1,7 +1,7 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Renderer](/docs/tech/03_renderer/readme.md) **/** -[Template filters](/docs/tech/03_renderer/04_twigCustomFilters.md) **/** +[BumbleDocGen](../../../README.md) **/** +[Technical description of the project](../../readme.md) **/** +[Renderer](../readme.md) **/** +[Template filters](../04_twigCustomFilters.md) **/** StrTypeToUrl --- @@ -59,15 +59,16 @@ $logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/M --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php#L50) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php#L51) ```php -public function __invoke(string $text, \BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, bool $useShortLinkVersion = false, bool $createDocument = false, string $separator = ' | '): string; +public function __invoke(array $context, string $text, \BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, bool $useShortLinkVersion = false, bool $createDocument = false, string $separator = ' | '): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $text | [string](https://www.php.net/manual/en/language.types.string.php) | Processed text | $rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | - | $useShortLinkVersion | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Shorten or not the link name. When shortening, only the shortName of the entity will be shown | diff --git a/docs/tech/03_renderer/readme.md b/docs/tech/03_renderer/readme.md index 409048ca..566240be 100644 --- a/docs/tech/03_renderer/readme.md +++ b/docs/tech/03_renderer/readme.md @@ -1,5 +1,5 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** Renderer --- @@ -16,15 +16,15 @@ We use twig to process templates. ## More detailed description of renderer components -- [How to create documentation templates?](/docs/tech/03_renderer/01_howToCreateTemplates/readme.md) - - [Front Matter](/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md) - - [Templates dynamic blocks](/docs/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md) - - [Linking templates](/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md) - - [Templates variables](/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md) -- [Documentation structure and breadcrumbs](/docs/tech/03_renderer/02_breadcrumbs.md) -- [Document structure of generated entities](/docs/tech/03_renderer/03_documentStructure.md) -- [Template filters](/docs/tech/03_renderer/04_twigCustomFilters.md) -- [Template functions](/docs/tech/03_renderer/05_twigCustomFunctions.md) +- [How to create documentation templates?](01_howToCreateTemplates/readme.md) + - [Front Matter](01_howToCreateTemplates/frontMatter.md) + - [Templates dynamic blocks](01_howToCreateTemplates/templatesDynamicBlocks.md) + - [Linking templates](01_howToCreateTemplates/templatesLinking.md) + - [Templates variables](01_howToCreateTemplates/templatesVariables.md) +- [Documentation structure and breadcrumbs](02_breadcrumbs.md) +- [Document structure of generated entities](03_documentStructure.md) +- [Template filters](04_twigCustomFilters.md) +- [Template functions](05_twigCustomFunctions.md) ## Starting the rendering process @@ -73,4 +73,4 @@ This process is presented in the form of a diagram below. --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
            **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
            **Page content update date:** Thu Jan 18 2024
            Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
            **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
            **Page content update date:** Fri Jan 19 2024
            Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/04_pluginSystem.md b/docs/tech/04_pluginSystem.md index c946ab08..2d276f48 100644 --- a/docs/tech/04_pluginSystem.md +++ b/docs/tech/04_pluginSystem.md @@ -1,5 +1,5 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** +[BumbleDocGen](../README.md) **/** +[Technical description of the project](readme.md) **/** Plugin system --- @@ -9,7 +9,7 @@ Plugin system The documentation generator includes the ability to expand the functionality using plugins that allow you to add the necessary functionality to the system without changing its core. -The system is built on the basis of an event model, each plugin class must implement [a]PluginInterface[/a]. +The system is built on the basis of an event model, each plugin class must implement [PluginInterface](classes/PluginInterface.md). ## Configuration example @@ -28,33 +28,33 @@ Plugins for any programming languages work regardless of which language handler | Plugin | PL | Handles events | Description | |-|-|-|-| -| LastPageCommitter | any |
            • [BeforeCreatingDocFile](/docs/tech/classes/BeforeCreatingDocFile.md)
            | Plugin for adding a block with information about the last commit and date of page update to the generated document | -| PageHtmlLinkerPlugin | any |
            • [BeforeCreatingDocFile](/docs/tech/classes/BeforeCreatingDocFile.md)
            | Adds URLs to empty links in HTML format; Links may contain: 1) Short entity name 2) Full entity name 3) Relative link to the entity file from the root directory of the project 4) Page title ( title ) 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) 6) Relative reference to the entity document from the root directory of the documentation | -| PageLinkerPlugin | any |
            • [BeforeCreatingDocFile](/docs/tech/classes/BeforeCreatingDocFile.md)
            | Adds URLs to empty links in MD format; Links may contain: 1) Short entity name 2) Full entity name 3) Relative link to the entity file from the root directory of the project 4) Page title ( title ) 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) 6) Relative reference to the entity document from the root directory of the documentation | -| PageRstLinkerPlugin | any |
            • [BeforeCreatingDocFile](/docs/tech/classes/BeforeCreatingDocFile.md)
            | Adds URLs to empty links in rst format; Links may contain: 1) Short entity name 2) Full entity name 3) Relative link to the entity file from the root directory of the project 4) Page title ( title ) 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) 6) Relative reference to the entity document from the root directory of the documentation | -| BasePhpStubberPlugin | PHP |
            • [OnGettingResourceLink](/docs/tech/classes/OnGettingResourceLink.md)
            • [OnCheckIsEntityCanBeLoaded](/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md)
            | Adding links to type documentation and documentation of built-in PHP classes | -| PhpDocumentorStubberPlugin | PHP |
            • [OnGettingResourceLink](/docs/tech/classes/OnGettingResourceLink.md)
            • [OnCheckIsEntityCanBeLoaded](/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md)
            | Adding links to the documentation of PHP classes in the \phpDocumentor namespace | -| PhpUnitStubberPlugin | PHP |
            • [OnGettingResourceLink](/docs/tech/classes/OnGettingResourceLink.md)
            • [OnCheckIsEntityCanBeLoaded](/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md)
            | Adding links to the documentation of PHP classes in the \PHPUnit namespace | -| StubberPlugin | PHP |
            • [OnGettingResourceLink](/docs/tech/classes/OnGettingResourceLink.md)
            • [OnCheckIsEntityCanBeLoaded](/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md)
            | The plugin allows you to automatically provide links to github repositories for documented classes from libraries included in composer | -| Daux | PHP |
            • [OnCreateDocumentedEntityWrapper](/docs/tech/classes/OnCreateDocumentedEntityWrapper.md)
            • [OnGetTemplatePathByRelativeDocPath](/docs/tech/classes/OnGetTemplatePathByRelativeDocPath.md)
            • [OnGetProjectTemplatesDirs](/docs/tech/classes/OnGetProjectTemplatesDirs.md)
            • [BeforeCreatingDocFile](/docs/tech/classes/BeforeCreatingDocFile.md)
            • [BeforeCreatingEntityDocFile](/docs/tech/classes/BeforeCreatingEntityDocFile.md)
            • [AfterRenderingEntities](/docs/tech/classes/AfterRenderingEntities.md)
            | | -| EntityDocUnifiedPlacePlugin | PHP |
            • [OnCreateDocumentedEntityWrapper](/docs/tech/classes/OnCreateDocumentedEntityWrapper.md)
            • [OnGetTemplatePathByRelativeDocPath](/docs/tech/classes/OnGetTemplatePathByRelativeDocPath.md)
            • [OnGetProjectTemplatesDirs](/docs/tech/classes/OnGetProjectTemplatesDirs.md)
            | This plugin changes the algorithm for saving entity documents. The standard system stores each file in a directory next to the file where it was requested. This behavior changes and all documents are saved in a separate directory structure, so they are not duplicated. | +| [LastPageCommitter](classes/LastPageCommitter.md) | any |
            • [BeforeCreatingDocFile](classes/BeforeCreatingDocFile.md)
            | Plugin for adding a block with information about the last commit and date of page update to the generated document | +| [PageHtmlLinkerPlugin](classes/PageHtmlLinkerPlugin.md) | any |
            • [BeforeCreatingDocFile](classes/BeforeCreatingDocFile.md)
            | Adds URLs to empty links in HTML format; Links may contain: 1) Short entity name 2) Full entity name 3) Relative link to the entity file from the root directory of the project 4) Page title ( title ) 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) 6) Relative reference to the entity document from the root directory of the documentation | +| [PageLinkerPlugin](classes/PageLinkerPlugin.md) | any |
            • [BeforeCreatingDocFile](classes/BeforeCreatingDocFile.md)
            | Adds URLs to empty links in MD format; Links may contain: 1) Short entity name 2) Full entity name 3) Relative link to the entity file from the root directory of the project 4) Page title ( title ) 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) 6) Relative reference to the entity document from the root directory of the documentation | +| [PageRstLinkerPlugin](classes/PageRstLinkerPlugin.md) | any |
            • [BeforeCreatingDocFile](classes/BeforeCreatingDocFile.md)
            | Adds URLs to empty links in rst format; Links may contain: 1) Short entity name 2) Full entity name 3) Relative link to the entity file from the root directory of the project 4) Page title ( title ) 5) Template key ( BreadcrumbsHelper::getTemplateLinkKey() ) 6) Relative reference to the entity document from the root directory of the documentation | +| [BasePhpStubberPlugin](classes/BasePhpStubberPlugin.md) | PHP |
            • [OnGettingResourceLink](classes/OnGettingResourceLink.md)
            • [OnCheckIsEntityCanBeLoaded](classes/OnCheckIsEntityCanBeLoaded.md)
            | Adding links to type documentation and documentation of built-in PHP classes | +| [PhpDocumentorStubberPlugin](classes/PhpDocumentorStubberPlugin.md) | PHP |
            • [OnGettingResourceLink](classes/OnGettingResourceLink.md)
            • [OnCheckIsEntityCanBeLoaded](classes/OnCheckIsEntityCanBeLoaded.md)
            | Adding links to the documentation of PHP classes in the \phpDocumentor namespace | +| [PhpUnitStubberPlugin](classes/PhpUnitStubberPlugin.md) | PHP |
            • [OnGettingResourceLink](classes/OnGettingResourceLink.md)
            • [OnCheckIsEntityCanBeLoaded](classes/OnCheckIsEntityCanBeLoaded.md)
            | Adding links to the documentation of PHP classes in the \PHPUnit namespace | +| [StubberPlugin](classes/StubberPlugin.md) | PHP |
            • [OnGettingResourceLink](classes/OnGettingResourceLink.md)
            • [OnCheckIsEntityCanBeLoaded](classes/OnCheckIsEntityCanBeLoaded.md)
            | The plugin allows you to automatically provide links to github repositories for documented classes from libraries included in composer | +| [Daux](classes/Daux.md) | PHP |
            • [OnCreateDocumentedEntityWrapper](classes/OnCreateDocumentedEntityWrapper.md)
            • [OnGetTemplatePathByRelativeDocPath](classes/OnGetTemplatePathByRelativeDocPath.md)
            • [OnGetProjectTemplatesDirs](classes/OnGetProjectTemplatesDirs.md)
            • [BeforeCreatingDocFile](classes/BeforeCreatingDocFile.md)
            • [BeforeCreatingEntityDocFile](classes/BeforeCreatingEntityDocFile.md)
            • [AfterRenderingEntities](classes/AfterRenderingEntities.md)
            | | +| [EntityDocUnifiedPlacePlugin](classes/EntityDocUnifiedPlacePlugin.md) | PHP |
            • [OnCreateDocumentedEntityWrapper](classes/OnCreateDocumentedEntityWrapper.md)
            • [OnGetTemplatePathByRelativeDocPath](classes/OnGetTemplatePathByRelativeDocPath.md)
            • [OnGetProjectTemplatesDirs](classes/OnGetProjectTemplatesDirs.md)
            | This plugin changes the algorithm for saving entity documents. The standard system stores each file in a directory next to the file where it was requested. This behavior changes and all documents are saved in a separate directory structure, so they are not duplicated. | ## Default events -- [BeforeParsingProcess](/docs/tech/classes/BeforeParsingProcess.md) -- [AfterRenderingEntities](/docs/tech/classes/AfterRenderingEntities.md) -- [BeforeCreatingDocFile](/docs/tech/classes/BeforeCreatingDocFile.md) - Called before the content of the documentation document is saved to a file -- [BeforeCreatingEntityDocFile](/docs/tech/classes/BeforeCreatingEntityDocFile.md) -- [BeforeRenderingDocFiles](/docs/tech/classes/BeforeRenderingDocFiles.md) - The event occurs before the main documents begin rendering -- [BeforeRenderingEntities](/docs/tech/classes/BeforeRenderingEntities.md) - The event occurs before the rendering of entity documents begins, after the main documents have been created -- [OnCreateDocumentedEntityWrapper](/docs/tech/classes/OnCreateDocumentedEntityWrapper.md) - The event occurs when an entity is added to the list for documentation -- [OnGetProjectTemplatesDirs](/docs/tech/classes/OnGetProjectTemplatesDirs.md) - This event occurs when all directories containing document templates are retrieved -- [OnGetTemplatePathByRelativeDocPath](/docs/tech/classes/OnGetTemplatePathByRelativeDocPath.md) - The event occurs when the path to the template file is obtained relative to the path to the document -- [OnGettingResourceLink](/docs/tech/classes/OnGettingResourceLink.md) - Event occurs when a reference to an entity (resource) is received -- [OnLoadEntityDocPluginContent](/docs/tech/classes/OnLoadEntityDocPluginContent.md) - Called when entity documentation is generated (plugin content loading) -- [OnCheckIsEntityCanBeLoaded](/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md) -- [AfterLoadingPhpEntitiesCollection](/docs/tech/classes/AfterLoadingPhpEntitiesCollection.md) - The event is called after the initial creation of a collection of PHP entities -- [OnAddClassEntityToCollection](/docs/tech/classes/OnAddClassEntityToCollection.md) - Called when each class entity is added to the entity collection +- [BeforeParsingProcess](classes/BeforeParsingProcess.md) +- [AfterRenderingEntities](classes/AfterRenderingEntities.md) +- [BeforeCreatingDocFile](classes/BeforeCreatingDocFile.md) - Called before the content of the documentation document is saved to a file +- [BeforeCreatingEntityDocFile](classes/BeforeCreatingEntityDocFile.md) +- [BeforeRenderingDocFiles](classes/BeforeRenderingDocFiles.md) - The event occurs before the main documents begin rendering +- [BeforeRenderingEntities](classes/BeforeRenderingEntities.md) - The event occurs before the rendering of entity documents begins, after the main documents have been created +- [OnCreateDocumentedEntityWrapper](classes/OnCreateDocumentedEntityWrapper.md) - The event occurs when an entity is added to the list for documentation +- [OnGetProjectTemplatesDirs](classes/OnGetProjectTemplatesDirs.md) - This event occurs when all directories containing document templates are retrieved +- [OnGetTemplatePathByRelativeDocPath](classes/OnGetTemplatePathByRelativeDocPath.md) - The event occurs when the path to the template file is obtained relative to the path to the document +- [OnGettingResourceLink](classes/OnGettingResourceLink.md) - Event occurs when a reference to an entity (resource) is received +- [OnLoadEntityDocPluginContent](classes/OnLoadEntityDocPluginContent.md) - Called when entity documentation is generated (plugin content loading) +- [OnCheckIsEntityCanBeLoaded](classes/OnCheckIsEntityCanBeLoaded.md) +- [AfterLoadingPhpEntitiesCollection](classes/AfterLoadingPhpEntitiesCollection.md) - The event is called after the initial creation of a collection of PHP entities +- [OnAddClassEntityToCollection](classes/OnAddClassEntityToCollection.md) - Called when each class entity is added to the entity collection ## Adding a new plugin @@ -94,4 +94,4 @@ plugins: --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
            **Last modified date:** Thu Jan 18 17:19:08 2024 +0300
            **Page content update date:** Thu Jan 18 2024
            Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
            **Last modified date:** Thu Jan 18 17:19:08 2024 +0300
            **Page content update date:** Fri Jan 19 2024
            Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/05_console.md b/docs/tech/05_console.md index 43c7a01a..2a2546d1 100644 --- a/docs/tech/05_console.md +++ b/docs/tech/05_console.md @@ -1,5 +1,5 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** +[BumbleDocGen](../README.md) **/** +[Technical description of the project](readme.md) **/** Console app --- @@ -7,7 +7,7 @@ Console app # Console app -The documentation generator provides the ability to work through a built-in [console application](/docs/tech/classes/App.md). +The documentation generator provides the ability to work through a built-in [console application](classes/App.md). It is available via composer: ```console vendor/bin/bumbleDocGen list @@ -21,19 +21,19 @@ We use [Symfony Console](https://github.com/symfony/console) as the basis of the |-|-|-| | [help](https://github.com/symfony/console/blob/master/Command/HelpCommand.php) | [--format FORMAT]
            [--raw]
            [<command_name>] | Display help for a command | | [list](https://github.com/symfony/console/blob/master/Command/ListCommand.php) | [--raw]
            [--format FORMAT]
            [--short]
            [<namespace>] | List commands | -| [generate](/docs/tech/classes/GenerateCommand.md) | [--as-html]
            [--project_root [PROJECT_ROOT]]
            [--templates_dir [TEMPLATES_DIR]]
            [--output_dir [OUTPUT_DIR]]
            [--cache_dir [CACHE_DIR]]
            [--use_shared_cache [USE_SHARED_CACHE]] | Generate documentation | -| [serve](/docs/tech/classes/ServeCommand.md) | [--as-html]
            [--dev-server-host [DEV-SERVER-HOST]]
            [--dev-server-port [DEV-SERVER-PORT]]
            [--project_root [PROJECT_ROOT]]
            [--templates_dir [TEMPLATES_DIR]]
            [--use_shared_cache [USE_SHARED_CACHE]] | Serve documentation | -| [ai:generate-readme-template](/docs/tech/classes/GenerateReadMeTemplateCommand.md) | [--project_root [PROJECT_ROOT]]
            [--templates_dir [TEMPLATES_DIR]]
            [--cache_dir [CACHE_DIR]]
            [--ai_provider [AI_PROVIDER]]
            [--ai_api_key [AI_API_KEY]]
            [--ai_model [AI_MODEL]] | Leverage AI to generate content for a project readme.md file. | -| [ai:add-doc-blocks](/docs/tech/classes/AddDocBlocksCommand.md) | [--project_root [PROJECT_ROOT]]
            [--templates_dir [TEMPLATES_DIR]]
            [--cache_dir [CACHE_DIR]]
            [--ai_provider [AI_PROVIDER]]
            [--ai_api_key [AI_API_KEY]]
            [--ai_model [AI_MODEL]] | Leverage AI to insert missing doc blocks in code. | -| [configuration](/docs/tech/classes/ConfigurationCommand.md) | [<key>] | Display list of configured plugins, programming language handlers, etc | +| [generate](classes/GenerateCommand.md) | [--as-html]
            [--project_root [PROJECT_ROOT]]
            [--templates_dir [TEMPLATES_DIR]]
            [--output_dir [OUTPUT_DIR]]
            [--cache_dir [CACHE_DIR]]
            [--use_shared_cache [USE_SHARED_CACHE]] | Generate documentation | +| [serve](classes/ServeCommand.md) | [--as-html]
            [--dev-server-host [DEV-SERVER-HOST]]
            [--dev-server-port [DEV-SERVER-PORT]]
            [--project_root [PROJECT_ROOT]]
            [--templates_dir [TEMPLATES_DIR]]
            [--use_shared_cache [USE_SHARED_CACHE]] | Serve documentation | +| [ai:generate-readme-template](classes/GenerateReadMeTemplateCommand.md) | [--project_root [PROJECT_ROOT]]
            [--templates_dir [TEMPLATES_DIR]]
            [--cache_dir [CACHE_DIR]]
            [--ai_provider [AI_PROVIDER]]
            [--ai_api_key [AI_API_KEY]]
            [--ai_model [AI_MODEL]] | Leverage AI to generate content for a project readme.md file. | +| [ai:add-doc-blocks](classes/AddDocBlocksCommand.md) | [--project_root [PROJECT_ROOT]]
            [--templates_dir [TEMPLATES_DIR]]
            [--cache_dir [CACHE_DIR]]
            [--ai_provider [AI_PROVIDER]]
            [--ai_api_key [AI_API_KEY]]
            [--ai_model [AI_MODEL]] | Leverage AI to insert missing doc blocks in code. | +| [configuration](classes/ConfigurationCommand.md) | [<key>] | Display list of configured plugins, programming language handlers, etc | ## Adding a custom command The system allows you to add custom commands to a standard console application. -This can be done using a special configuration option [additional_console_commands](/docs/tech/classes/Configuration.md#mgetadditionalconsolecommands) (see [Configuration](/docs/tech/01_configuration.md) page). +This can be done using a special configuration option [additional_console_commands](classes/Configuration.md#mgetadditionalconsolecommands) (see [Configuration](/docs/tech/01_configuration.md) page). After adding a new command to the configuration, it will be available in the application. Each added command must inherit the `\Symfony\Component\Console\Command\Command` class --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
            **Last modified date:** Thu Jan 18 17:19:08 2024 +0300
            **Page content update date:** Thu Jan 18 2024
            Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
            **Last modified date:** Thu Jan 18 17:19:08 2024 +0300
            **Page content update date:** Fri Jan 19 2024
            Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/06_debugging.md b/docs/tech/06_debugging.md index 3d8e362b..ccd53fbe 100644 --- a/docs/tech/06_debugging.md +++ b/docs/tech/06_debugging.md @@ -1,5 +1,5 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** +[BumbleDocGen](../README.md) **/** +[Technical description of the project](readme.md) **/** Debug documents --- @@ -13,7 +13,7 @@ Our tool provides several options for debugging documentation. **Here is an example of error output:** - + 2) To track exactly how documentation is generated, you can use the interactive mode: @@ -27,4 +27,4 @@ Our tool provides several options for debugging documentation. --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
            **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
            **Page content update date:** Thu Jan 18 2024
            Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
            **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
            **Page content update date:** Fri Jan 19 2024
            Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/07_outputFormat.md b/docs/tech/07_outputFormat.md index 1e4a7451..0d8c724e 100644 --- a/docs/tech/07_outputFormat.md +++ b/docs/tech/07_outputFormat.md @@ -1,5 +1,5 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** +[BumbleDocGen](../README.md) **/** +[Technical description of the project](readme.md) **/** Output formats --- @@ -10,7 +10,7 @@ Output formats At the moment, the documentation generator is focused on creating documentation in two formats: [GitHub Flavored Markdown](https://github.github.com/gfm/) and HTML. However, it is possible to create other files with some restrictions. -1) Creating **GFM** documentation is possible both using a [console application](/docs/tech/05_console.md) and using the [built-in commands](/docs/tech/classes/DocGenerator.md#mgenerate) of the documentation generator. +1) Creating **GFM** documentation is possible both using a [console application](/docs/tech/05_console.md) and using the [built-in commands](classes/DocGenerator.md#mgenerate) of the documentation generator. * Generate GFM doc by console command: ```bash @@ -42,4 +42,4 @@ However, it is possible to create other files with some restrictions. --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
            **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
            **Page content update date:** Thu Jan 18 2024
            Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
            **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
            **Page content update date:** Fri Jan 19 2024
            Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/classes/AddDocBlocksCommand.md b/docs/tech/classes/AddDocBlocksCommand.md index e1379352..1a7c0fd8 100644 --- a/docs/tech/classes/AddDocBlocksCommand.md +++ b/docs/tech/classes/AddDocBlocksCommand.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Console app](/docs/tech/05_console.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Console app](../05_console.md) **/** AddDocBlocksCommand --- @@ -19,7 +19,7 @@ final class AddDocBlocksCommand extends \BumbleDocGen\Console\Command\BaseComman 1. [__construct](#m-construct) ## Traits: -1. [\BumbleDocGen\AI\Traits\SharedCommandLogicTrait](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/AI/Traits/SharedCommandLogicTrait.php) +1. [BumbleDocGen\AI\Traits\SharedCommandLogicTrait](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/AI/Traits/SharedCommandLogicTrait.php) ## Methods details: diff --git a/docs/tech/classes/AddIndentFromLeft.md b/docs/tech/classes/AddIndentFromLeft.md index ed916eb6..c84d3092 100644 --- a/docs/tech/classes/AddIndentFromLeft.md +++ b/docs/tech/classes/AddIndentFromLeft.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** AddIndentFromLeft --- diff --git a/docs/tech/classes/AfterLoadingPhpEntitiesCollection.md b/docs/tech/classes/AfterLoadingPhpEntitiesCollection.md index 261e94f9..a9517138 100644 --- a/docs/tech/classes/AfterLoadingPhpEntitiesCollection.md +++ b/docs/tech/classes/AfterLoadingPhpEntitiesCollection.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** AfterLoadingPhpEntitiesCollection --- diff --git a/docs/tech/classes/AfterRenderingEntities.md b/docs/tech/classes/AfterRenderingEntities.md index e05e71e6..cf7ef177 100644 --- a/docs/tech/classes/AfterRenderingEntities.md +++ b/docs/tech/classes/AfterRenderingEntities.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** AfterRenderingEntities --- diff --git a/docs/tech/classes/App.md b/docs/tech/classes/App.md index 09ef0dd5..b7480b79 100644 --- a/docs/tech/classes/App.md +++ b/docs/tech/classes/App.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Console app](/docs/tech/05_console.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Console app](../05_console.md) **/** App --- diff --git a/docs/tech/classes/BasePageLinkProcessor.md b/docs/tech/classes/BasePageLinkProcessor.md index 63ca546a..7eee8d18 100644 --- a/docs/tech/classes/BasePageLinkProcessor.md +++ b/docs/tech/classes/BasePageLinkProcessor.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** BasePageLinkProcessor --- diff --git a/docs/tech/classes/BasePhpStubberPlugin.md b/docs/tech/classes/BasePhpStubberPlugin.md index 21bf5ea9..975aeeb5 100644 --- a/docs/tech/classes/BasePhpStubberPlugin.md +++ b/docs/tech/classes/BasePhpStubberPlugin.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** BasePhpStubberPlugin --- diff --git a/docs/tech/classes/BeforeCreatingDocFile.md b/docs/tech/classes/BeforeCreatingDocFile.md index a28a9055..a6a89d37 100644 --- a/docs/tech/classes/BeforeCreatingDocFile.md +++ b/docs/tech/classes/BeforeCreatingDocFile.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** BeforeCreatingDocFile --- diff --git a/docs/tech/classes/BeforeCreatingEntityDocFile.md b/docs/tech/classes/BeforeCreatingEntityDocFile.md index da8a3ca1..a72b05a5 100644 --- a/docs/tech/classes/BeforeCreatingEntityDocFile.md +++ b/docs/tech/classes/BeforeCreatingEntityDocFile.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** BeforeCreatingEntityDocFile --- diff --git a/docs/tech/classes/BeforeParsingProcess.md b/docs/tech/classes/BeforeParsingProcess.md index 2f1a2e57..f4aa3ca6 100644 --- a/docs/tech/classes/BeforeParsingProcess.md +++ b/docs/tech/classes/BeforeParsingProcess.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** BeforeParsingProcess --- diff --git a/docs/tech/classes/BeforeRenderingDocFiles.md b/docs/tech/classes/BeforeRenderingDocFiles.md index cfb20b2c..01b4c3f6 100644 --- a/docs/tech/classes/BeforeRenderingDocFiles.md +++ b/docs/tech/classes/BeforeRenderingDocFiles.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** BeforeRenderingDocFiles --- diff --git a/docs/tech/classes/BeforeRenderingEntities.md b/docs/tech/classes/BeforeRenderingEntities.md index 5d28cfad..1e0fd9ba 100644 --- a/docs/tech/classes/BeforeRenderingEntities.md +++ b/docs/tech/classes/BeforeRenderingEntities.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** BeforeRenderingEntities --- diff --git a/docs/tech/classes/Configuration.md b/docs/tech/classes/Configuration.md index 39ff4250..02c63760 100644 --- a/docs/tech/classes/Configuration.md +++ b/docs/tech/classes/Configuration.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Console app](/docs/tech/05_console.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Console app](../05_console.md) **/** Configuration --- diff --git a/docs/tech/classes/ConfigurationCommand.md b/docs/tech/classes/ConfigurationCommand.md index 801c9627..4ae2d4cb 100644 --- a/docs/tech/classes/ConfigurationCommand.md +++ b/docs/tech/classes/ConfigurationCommand.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Console app](/docs/tech/05_console.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Console app](../05_console.md) **/** ConfigurationCommand --- diff --git a/docs/tech/classes/Daux.md b/docs/tech/classes/Daux.md index 5ebe40e3..02d9bdd3 100644 --- a/docs/tech/classes/Daux.md +++ b/docs/tech/classes/Daux.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** Daux --- @@ -42,7 +42,7 @@ $breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper] --- -# `afterRenderingEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L95) +# `afterRenderingEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L97) ```php public function afterRenderingEntities(): void; ``` @@ -75,7 +75,7 @@ public static function getSubscribedEvents(): array; --- -# `onCreateDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L71) +# `onCreateDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L73) ```php public function onCreateDocumentedEntityWrapper(\BumbleDocGen\Core\Plugin\Event\Renderer\OnCreateDocumentedEntityWrapper $event): void; ``` @@ -90,7 +90,7 @@ $event | [\BumbleDocGen\Core\Plugin\Event\Renderer\OnCreateDocumentedEntityWrapp --- -# `onGetProjectTemplatesDirs` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L87) +# `onGetProjectTemplatesDirs` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L89) ```php public function onGetProjectTemplatesDirs(\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetProjectTemplatesDirs $event): void; ``` @@ -105,7 +105,7 @@ $event | [\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetProjectTemplatesDirs](ht --- -# `onGetTemplatePathByRelativeDocPath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L78) +# `onGetTemplatePathByRelativeDocPath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L80) ```php public function onGetTemplatePathByRelativeDocPath(\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetTemplatePathByRelativeDocPath $event): void; ``` diff --git a/docs/tech/classes/DocGenerator.md b/docs/tech/classes/DocGenerator.md index b795b419..64ac0a7e 100644 --- a/docs/tech/classes/DocGenerator.md +++ b/docs/tech/classes/DocGenerator.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Output formats](/docs/tech/07_outputFormat.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Output formats](../07_outputFormat.md) **/** DocGenerator --- diff --git a/docs/tech/classes/DocumentedEntityWrapper.md b/docs/tech/classes/DocumentedEntityWrapper.md index 949f6f9e..55647a15 100644 --- a/docs/tech/classes/DocumentedEntityWrapper.md +++ b/docs/tech/classes/DocumentedEntityWrapper.md @@ -1,5 +1,5 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** DocumentedEntityWrapper --- diff --git a/docs/tech/classes/DocumentedEntityWrappersCollection.md b/docs/tech/classes/DocumentedEntityWrappersCollection.md index 9a55c623..7740c323 100644 --- a/docs/tech/classes/DocumentedEntityWrappersCollection.md +++ b/docs/tech/classes/DocumentedEntityWrappersCollection.md @@ -1,5 +1,5 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** DocumentedEntityWrappersCollection --- diff --git a/docs/tech/classes/DrawDocumentationMenu.md b/docs/tech/classes/DrawDocumentationMenu.md index edae909a..aa58657d 100644 --- a/docs/tech/classes/DrawDocumentationMenu.md +++ b/docs/tech/classes/DrawDocumentationMenu.md @@ -1,12 +1,12 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** DrawDocumentationMenu --- -# [DrawDocumentationMenu](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L29) class: +# [DrawDocumentationMenu](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L32) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; @@ -54,7 +54,7 @@ and all links with this page are recursively collected for it, after which the h ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L31) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L34) ```php public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); ``` @@ -70,15 +70,16 @@ $dependencyFactory | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDep --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L64) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L69) ```php -public function __invoke(string|null $startPageKey = null, int|null $maxDeep = null): string; +public function __invoke(array $context, string|null $startPageKey = null, int|null $maxDeep = null): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $startPageKey | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Relative path to the page from which the menu will be generated (only child pages will be taken into account). By default, the main documentation page (readme.md) is used. | $maxDeep | [int](https://www.php.net/manual/en/language.types.integer.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Maximum parsing depth of documented links starting from the current page. @@ -88,7 +89,7 @@ $maxDeep | [int](https://www.php.net/manual/en/language.types.integer.php) \| [n --- -# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L39) +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L42) ```php public static function getName(): string; ``` @@ -97,7 +98,7 @@ public static function getName(): string; --- -# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L44) +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php#L47) ```php public static function getOptions(): array; ``` diff --git a/docs/tech/classes/DrawDocumentedEntityLink.md b/docs/tech/classes/DrawDocumentedEntityLink.md index 84f6518a..1a5d4233 100644 --- a/docs/tech/classes/DrawDocumentedEntityLink.md +++ b/docs/tech/classes/DrawDocumentedEntityLink.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** DrawDocumentedEntityLink --- @@ -60,15 +60,16 @@ $getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\Get --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php#L50) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawDocumentedEntityLink.php#L51) ```php -public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityInterface $entity, string $cursor = '', bool $useShortName = true): string; +public function __invoke(array $context, \BumbleDocGen\Core\Parser\Entity\RootEntityInterface $entity, string $cursor = '', bool $useShortName = true): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $entity | [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) | The entity for which we want to get the link | $cursor | [string](https://www.php.net/manual/en/language.types.string.php) | Reference to an element inside an entity, for example, the name of a function/constant/property | $useShortName | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Use the full or short entity name in the link | diff --git a/docs/tech/classes/EntityDocUnifiedPlacePlugin.md b/docs/tech/classes/EntityDocUnifiedPlacePlugin.md index e190bd1e..78c97fc3 100644 --- a/docs/tech/classes/EntityDocUnifiedPlacePlugin.md +++ b/docs/tech/classes/EntityDocUnifiedPlacePlugin.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** EntityDocUnifiedPlacePlugin --- diff --git a/docs/tech/classes/FileGetContents.md b/docs/tech/classes/FileGetContents.md index 05a9630f..c8d74ace 100644 --- a/docs/tech/classes/FileGetContents.md +++ b/docs/tech/classes/FileGetContents.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** FileGetContents --- diff --git a/docs/tech/classes/FixStrSize.md b/docs/tech/classes/FixStrSize.md index 6ab2f5b6..f095014b 100644 --- a/docs/tech/classes/FixStrSize.md +++ b/docs/tech/classes/FixStrSize.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** FixStrSize --- diff --git a/docs/tech/classes/GenerateCommand.md b/docs/tech/classes/GenerateCommand.md index 185c075e..121dde01 100644 --- a/docs/tech/classes/GenerateCommand.md +++ b/docs/tech/classes/GenerateCommand.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Console app](/docs/tech/05_console.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Console app](../05_console.md) **/** GenerateCommand --- diff --git a/docs/tech/classes/GeneratePageBreadcrumbs.md b/docs/tech/classes/GeneratePageBreadcrumbs.md index 2ccc6c1f..099070f6 100644 --- a/docs/tech/classes/GeneratePageBreadcrumbs.md +++ b/docs/tech/classes/GeneratePageBreadcrumbs.md @@ -1,12 +1,12 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** GeneratePageBreadcrumbs --- -# [GeneratePageBreadcrumbs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L20) class: +# [GeneratePageBreadcrumbs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L24) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; @@ -36,9 +36,9 @@ Function to generate breadcrumbs on the page ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L22) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L26) ```php -public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); +public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsTwigEnvironment $breadcrumbsTwig, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); ``` ***Parameters:*** @@ -46,12 +46,14 @@ public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsH | Name | Type | Description | |:-|:-|:-| $breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$breadcrumbsTwig | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsTwigEnvironment](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsTwigEnvironment.php) | - | $rendererContext | [\BumbleDocGen\Core\Renderer\Context\RendererContext](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/RendererContext.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | $dependencyFactory | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Context/Dependency/RendererDependencyFactory.php) | - | --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L57) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L63) ```php public function __invoke(string $currentPageTitle, string $templatePath, bool $skipFirstTemplatePage = true): string; ``` @@ -70,7 +72,7 @@ $skipFirstTemplatePage | [bool](https://www.php.net/manual/en/language.types.boo --- -# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L29) +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L35) ```php public static function getName(): string; ``` @@ -79,7 +81,7 @@ public static function getName(): string; --- -# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L34) +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L40) ```php public static function getOptions(): array; ``` diff --git a/docs/tech/classes/GenerateReadMeTemplateCommand.md b/docs/tech/classes/GenerateReadMeTemplateCommand.md index 528fc63e..f59e25e8 100644 --- a/docs/tech/classes/GenerateReadMeTemplateCommand.md +++ b/docs/tech/classes/GenerateReadMeTemplateCommand.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Console app](/docs/tech/05_console.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Console app](../05_console.md) **/** GenerateReadMeTemplateCommand --- @@ -19,7 +19,7 @@ final class GenerateReadMeTemplateCommand extends \BumbleDocGen\Console\Command\ 1. [__construct](#m-construct) ## Traits: -1. [\BumbleDocGen\AI\Traits\SharedCommandLogicTrait](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/AI/Traits/SharedCommandLogicTrait.php) +1. [BumbleDocGen\AI\Traits\SharedCommandLogicTrait](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/AI/Traits/SharedCommandLogicTrait.php) ## Methods details: diff --git a/docs/tech/classes/GetDocumentationPageUrl.md b/docs/tech/classes/GetDocumentationPageUrl.md index 8a06ca80..7e8150dd 100644 --- a/docs/tech/classes/GetDocumentationPageUrl.md +++ b/docs/tech/classes/GetDocumentationPageUrl.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** GetDocumentationPageUrl --- diff --git a/docs/tech/classes/GetDocumentedEntityUrl.md b/docs/tech/classes/GetDocumentedEntityUrl.md index eb8a0d75..9cce207f 100644 --- a/docs/tech/classes/GetDocumentedEntityUrl.md +++ b/docs/tech/classes/GetDocumentedEntityUrl.md @@ -1,12 +1,12 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** GetDocumentedEntityUrl --- -# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L37) class: +# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L40) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; @@ -19,7 +19,7 @@ the `EntityDocRendererInterface::getDocFileExtension()` directory will be create ***Links:*** - [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/classes/DocumentedEntityWrapper.md) - [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/classes/DocumentedEntityWrappersCollection.md) -- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/classes/RendererContext.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/classes/RendererContext.md#pentitywrapperscollection) ***Examples of using:*** ```php @@ -53,10 +53,11 @@ The function returns a link to the file MainExtension 1. [__invoke](#m-invoke) 1. [getName](#mgetname) 1. [getOptions](#mgetoptions) +1. [process](#mprocess) ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L41) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L44) ```php public function __construct(\BumbleDocGen\Core\Renderer\RendererHelper $rendererHelper, \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection $documentedEntityWrappersCollection, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Monolog\Logger $logger); ``` @@ -72,15 +73,16 @@ $logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/M --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L76) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L81) ```php -public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; +public function __invoke(array $context, \BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | Processed entity collection | $entityName | [string](https://www.php.net/manual/en/language.types.string.php) | The full name of the entity for which the URL will be retrieved. If the entity is not found, the DEFAULT_URL value will be returned. | @@ -91,7 +93,7 @@ $createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.ph --- -# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L49) +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L52) ```php public static function getName(): string; ``` @@ -100,7 +102,7 @@ public static function getName(): string; --- -# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L54) +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L57) ```php public static function getOptions(): array; ``` @@ -108,3 +110,22 @@ public static function getOptions(): array; ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) --- + +# `process` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L102) +```php +public function process(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true, string|null $callingTemplate = null): string; +``` + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | - | +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | +$callingTemplate | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- diff --git a/docs/tech/classes/GetDocumentedEntityUrl_2.md b/docs/tech/classes/GetDocumentedEntityUrl_2.md index f3c761fd..2950b9ec 100644 --- a/docs/tech/classes/GetDocumentedEntityUrl_2.md +++ b/docs/tech/classes/GetDocumentedEntityUrl_2.md @@ -1,11 +1,11 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** GetDocumentedEntityUrl --- -# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L37) class: +# [GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L40) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; @@ -18,7 +18,7 @@ the `EntityDocRendererInterface::getDocFileExtension()` directory will be create ***Links:*** - [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/classes/DocumentedEntityWrapper.md) - [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/classes/DocumentedEntityWrappersCollection.md) -- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/classes/RendererContext.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/classes/RendererContext.md#pentitywrapperscollection) ***Examples of using:*** ```php @@ -52,10 +52,11 @@ The function returns a link to the file MainExtension 1. [__invoke](#m-invoke) 1. [getName](#mgetname) 1. [getOptions](#mgetoptions) +1. [process](#mprocess) ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L41) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L44) ```php public function __construct(\BumbleDocGen\Core\Renderer\RendererHelper $rendererHelper, \BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection $documentedEntityWrappersCollection, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Monolog\Logger $logger); ``` @@ -71,15 +72,16 @@ $logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/M --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L76) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L81) ```php -public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; +public function __invoke(array $context, \BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | Processed entity collection | $entityName | [string](https://www.php.net/manual/en/language.types.string.php) | The full name of the entity for which the URL will be retrieved. If the entity is not found, the DEFAULT_URL value will be returned. | @@ -90,7 +92,7 @@ $createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.ph --- -# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L49) +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L52) ```php public static function getName(): string; ``` @@ -99,7 +101,7 @@ public static function getName(): string; --- -# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L54) +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L57) ```php public static function getOptions(): array; ``` @@ -107,3 +109,22 @@ public static function getOptions(): array; ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) --- + +# `process` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php#L102) +```php +public function process(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $entityName, string $cursor = '', bool $createDocument = true, string|null $callingTemplate = null): string; +``` + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | - | +$entityName | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$cursor | [string](https://www.php.net/manual/en/language.types.string.php) | - | +$createDocument | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | +$callingTemplate | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | - | + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- diff --git a/docs/tech/classes/Implode.md b/docs/tech/classes/Implode.md index d8106d94..3c9d56c8 100644 --- a/docs/tech/classes/Implode.md +++ b/docs/tech/classes/Implode.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** Implode --- diff --git a/docs/tech/classes/LastPageCommitter.md b/docs/tech/classes/LastPageCommitter.md index f1c3484b..97c2d9ff 100644 --- a/docs/tech/classes/LastPageCommitter.md +++ b/docs/tech/classes/LastPageCommitter.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** LastPageCommitter --- diff --git a/docs/tech/classes/LoadPluginsContent.md b/docs/tech/classes/LoadPluginsContent.md index 47907318..26f06d1f 100644 --- a/docs/tech/classes/LoadPluginsContent.md +++ b/docs/tech/classes/LoadPluginsContent.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** LoadPluginsContent --- diff --git a/docs/tech/classes/LoadPluginsContent_2.md b/docs/tech/classes/LoadPluginsContent_2.md index a09939f2..8f652906 100644 --- a/docs/tech/classes/LoadPluginsContent_2.md +++ b/docs/tech/classes/LoadPluginsContent_2.md @@ -1,5 +1,5 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** LoadPluginsContent --- diff --git a/docs/tech/classes/OnAddClassEntityToCollection.md b/docs/tech/classes/OnAddClassEntityToCollection.md index f20bb085..eb156778 100644 --- a/docs/tech/classes/OnAddClassEntityToCollection.md +++ b/docs/tech/classes/OnAddClassEntityToCollection.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** OnAddClassEntityToCollection --- diff --git a/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md b/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md index 3b95c454..1182a5eb 100644 --- a/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md +++ b/docs/tech/classes/OnCheckIsEntityCanBeLoaded.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** OnCheckIsEntityCanBeLoaded --- diff --git a/docs/tech/classes/OnCreateDocumentedEntityWrapper.md b/docs/tech/classes/OnCreateDocumentedEntityWrapper.md index 821cae9a..01d0c71e 100644 --- a/docs/tech/classes/OnCreateDocumentedEntityWrapper.md +++ b/docs/tech/classes/OnCreateDocumentedEntityWrapper.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** OnCreateDocumentedEntityWrapper --- diff --git a/docs/tech/classes/OnGetProjectTemplatesDirs.md b/docs/tech/classes/OnGetProjectTemplatesDirs.md index 60cad2d4..43c189ae 100644 --- a/docs/tech/classes/OnGetProjectTemplatesDirs.md +++ b/docs/tech/classes/OnGetProjectTemplatesDirs.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** OnGetProjectTemplatesDirs --- diff --git a/docs/tech/classes/OnGetTemplatePathByRelativeDocPath.md b/docs/tech/classes/OnGetTemplatePathByRelativeDocPath.md index 48157641..28f696c5 100644 --- a/docs/tech/classes/OnGetTemplatePathByRelativeDocPath.md +++ b/docs/tech/classes/OnGetTemplatePathByRelativeDocPath.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** OnGetTemplatePathByRelativeDocPath --- diff --git a/docs/tech/classes/OnGettingResourceLink.md b/docs/tech/classes/OnGettingResourceLink.md index 23f15319..fe1ea5cf 100644 --- a/docs/tech/classes/OnGettingResourceLink.md +++ b/docs/tech/classes/OnGettingResourceLink.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** OnGettingResourceLink --- diff --git a/docs/tech/classes/OnLoadEntityDocPluginContent.md b/docs/tech/classes/OnLoadEntityDocPluginContent.md index 5e1ebc77..55ab6168 100644 --- a/docs/tech/classes/OnLoadEntityDocPluginContent.md +++ b/docs/tech/classes/OnLoadEntityDocPluginContent.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** OnLoadEntityDocPluginContent --- diff --git a/docs/tech/classes/PageHtmlLinkerPlugin.md b/docs/tech/classes/PageHtmlLinkerPlugin.md index 0b5ade4f..a42cb001 100644 --- a/docs/tech/classes/PageHtmlLinkerPlugin.md +++ b/docs/tech/classes/PageHtmlLinkerPlugin.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** PageHtmlLinkerPlugin --- @@ -46,11 +46,11 @@ Adds URLs to empty links in HTML format; ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L19) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L20) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker -public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \Psr\Log\LoggerInterface $logger); +public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Psr\Log\LoggerInterface $logger); ``` ***Parameters:*** @@ -60,11 +60,12 @@ public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsH $breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | $rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | $getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | $logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | --- -# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L71) +# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L73) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker @@ -81,7 +82,7 @@ $event | [\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile](https: --- -# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L59) +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L61) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker diff --git a/docs/tech/classes/PageHtmlLinkerPlugin_2.md b/docs/tech/classes/PageHtmlLinkerPlugin_2.md index 363a0b85..916ce440 100644 --- a/docs/tech/classes/PageHtmlLinkerPlugin_2.md +++ b/docs/tech/classes/PageHtmlLinkerPlugin_2.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** PageHtmlLinkerPlugin --- @@ -46,11 +46,11 @@ Adds URLs to empty links in HTML format; ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L19) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L20) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker -public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \Psr\Log\LoggerInterface $logger); +public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Psr\Log\LoggerInterface $logger); ``` ***Parameters:*** @@ -60,11 +60,12 @@ public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsH $breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | $rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | $getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | $logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | --- -# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L71) +# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L73) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker @@ -81,7 +82,7 @@ $event | [\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile](https: --- -# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L59) +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L61) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker diff --git a/docs/tech/classes/PageLinkerPlugin.md b/docs/tech/classes/PageLinkerPlugin.md index 8b9d8eef..830f59ff 100644 --- a/docs/tech/classes/PageLinkerPlugin.md +++ b/docs/tech/classes/PageLinkerPlugin.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** PageLinkerPlugin --- @@ -46,11 +46,11 @@ Adds URLs to empty links in MD format; ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L19) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L20) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker -public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \Psr\Log\LoggerInterface $logger); +public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Psr\Log\LoggerInterface $logger); ``` ***Parameters:*** @@ -60,11 +60,12 @@ public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsH $breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | $rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | $getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | $logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | --- -# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L71) +# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L73) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker @@ -81,7 +82,7 @@ $event | [\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile](https: --- -# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L59) +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L61) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker diff --git a/docs/tech/classes/PageLinkerPlugin_2.md b/docs/tech/classes/PageLinkerPlugin_2.md index 039f5351..1bd6b8fb 100644 --- a/docs/tech/classes/PageLinkerPlugin_2.md +++ b/docs/tech/classes/PageLinkerPlugin_2.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** PageLinkerPlugin --- @@ -46,11 +46,11 @@ Adds URLs to empty links in MD format; ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L19) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L20) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker -public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \Psr\Log\LoggerInterface $logger); +public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Psr\Log\LoggerInterface $logger); ``` ***Parameters:*** @@ -60,11 +60,12 @@ public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsH $breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | $rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | $getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | $logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | --- -# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L71) +# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L73) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker @@ -81,7 +82,7 @@ $event | [\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile](https: --- -# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L59) +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L61) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker diff --git a/docs/tech/classes/PageRstLinkerPlugin.md b/docs/tech/classes/PageRstLinkerPlugin.md index f1785175..c97fee75 100644 --- a/docs/tech/classes/PageRstLinkerPlugin.md +++ b/docs/tech/classes/PageRstLinkerPlugin.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** PageRstLinkerPlugin --- @@ -40,11 +40,11 @@ Adds URLs to empty links in rst format; ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L19) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L20) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker -public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \Psr\Log\LoggerInterface $logger); +public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup $rootEntityCollectionsGroup, \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl $getDocumentedEntityUrlFunction, \BumbleDocGen\Core\Configuration\Configuration $configuration, \Psr\Log\LoggerInterface $logger); ``` ***Parameters:*** @@ -54,11 +54,12 @@ public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsH $breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | $rootEntityCollectionsGroup | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollectionsGroup](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollectionsGroup.php) | - | $getDocumentedEntityUrlFunction | [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php) | - | +$configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | $logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | --- -# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L71) +# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L73) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker @@ -75,7 +76,7 @@ $event | [\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile](https: --- -# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L59) +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/CorePlugin/PageLinker/BasePageLinker.php#L61) ```php // Implemented in BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\BasePageLinker diff --git a/docs/tech/classes/PhpDocumentorStubberPlugin.md b/docs/tech/classes/PhpDocumentorStubberPlugin.md index d3afed70..7e9cb95f 100644 --- a/docs/tech/classes/PhpDocumentorStubberPlugin.md +++ b/docs/tech/classes/PhpDocumentorStubberPlugin.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** PhpDocumentorStubberPlugin --- diff --git a/docs/tech/classes/PhpUnitStubberPlugin.md b/docs/tech/classes/PhpUnitStubberPlugin.md index f7d66e9d..d6e034c1 100644 --- a/docs/tech/classes/PhpUnitStubberPlugin.md +++ b/docs/tech/classes/PhpUnitStubberPlugin.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** PhpUnitStubberPlugin --- diff --git a/docs/tech/classes/PluginInterface.md b/docs/tech/classes/PluginInterface.md new file mode 100644 index 00000000..d9b22ef4 --- /dev/null +++ b/docs/tech/classes/PluginInterface.md @@ -0,0 +1,17 @@ +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** +PluginInterface + +--- + + +# [PluginInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginInterface.php#L9) class: + +```php +namespace BumbleDocGen\Core\Plugin; + +interface PluginInterface extends \Symfony\Component\EventDispatcher\EventSubscriberInterface +``` + + diff --git a/docs/tech/classes/PregMatch.md b/docs/tech/classes/PregMatch.md index b415414d..79235233 100644 --- a/docs/tech/classes/PregMatch.md +++ b/docs/tech/classes/PregMatch.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** PregMatch --- diff --git a/docs/tech/classes/PrepareSourceLink.md b/docs/tech/classes/PrepareSourceLink.md index d742b24a..f17123ab 100644 --- a/docs/tech/classes/PrepareSourceLink.md +++ b/docs/tech/classes/PrepareSourceLink.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** PrepareSourceLink --- diff --git a/docs/tech/classes/PrintEntityCollectionAsList.md b/docs/tech/classes/PrintEntityCollectionAsList.md index c0c5e14b..e736631e 100644 --- a/docs/tech/classes/PrintEntityCollectionAsList.md +++ b/docs/tech/classes/PrintEntityCollectionAsList.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** PrintEntityCollectionAsList --- @@ -60,15 +60,16 @@ $removeLineBrakes | [\BumbleDocGen\Core\Renderer\Twig\Filter\RemoveLineBrakes](h --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php#L50) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/PrintEntityCollectionAsList.php#L51) ```php -public function __invoke(\BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $type = 'ul', bool $skipDescription = false, bool $useFullName = false): string; +public function __invoke(array $context, \BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, string $type = 'ul', bool $skipDescription = false, bool $useFullName = false): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | Processed entity collection | $type | [string](https://www.php.net/manual/en/language.types.string.php) | List tag type (
              /
                ) | $skipDescription | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Don't print description of this entities | diff --git a/docs/tech/classes/Quotemeta.md b/docs/tech/classes/Quotemeta.md index 518c0496..462223a3 100644 --- a/docs/tech/classes/Quotemeta.md +++ b/docs/tech/classes/Quotemeta.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** Quotemeta --- diff --git a/docs/tech/classes/RemoveLineBrakes.md b/docs/tech/classes/RemoveLineBrakes.md index 0979d315..df705abd 100644 --- a/docs/tech/classes/RemoveLineBrakes.md +++ b/docs/tech/classes/RemoveLineBrakes.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** RemoveLineBrakes --- diff --git a/docs/tech/classes/RendererContext.md b/docs/tech/classes/RendererContext.md index 6a558f3d..eb0b22cc 100644 --- a/docs/tech/classes/RendererContext.md +++ b/docs/tech/classes/RendererContext.md @@ -1,5 +1,5 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** RendererContext --- diff --git a/docs/tech/classes/ServeCommand.md b/docs/tech/classes/ServeCommand.md index 10075e3b..3001479c 100644 --- a/docs/tech/classes/ServeCommand.md +++ b/docs/tech/classes/ServeCommand.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Console app](/docs/tech/05_console.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Console app](../05_console.md) **/** ServeCommand --- diff --git a/docs/tech/classes/StrTypeToUrl.md b/docs/tech/classes/StrTypeToUrl.md index 38c1c8dd..1d1f0e27 100644 --- a/docs/tech/classes/StrTypeToUrl.md +++ b/docs/tech/classes/StrTypeToUrl.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Configuration](/docs/tech/01_configuration.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Configuration](../01_configuration.md) **/** StrTypeToUrl --- @@ -58,15 +58,16 @@ $logger | [\Monolog\Logger](https://github.com/Seldaek/monolog/blob/master/src/M --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php#L50) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/StrTypeToUrl.php#L51) ```php -public function __invoke(string $text, \BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, bool $useShortLinkVersion = false, bool $createDocument = false, string $separator = ' | '): string; +public function __invoke(array $context, string $text, \BumbleDocGen\Core\Parser\Entity\RootEntityCollection $rootEntityCollection, bool $useShortLinkVersion = false, bool $createDocument = false, string $separator = ' | '): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | $text | [string](https://www.php.net/manual/en/language.types.string.php) | Processed text | $rootEntityCollection | [\BumbleDocGen\Core\Parser\Entity\RootEntityCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityCollection.php) | - | $useShortLinkVersion | [bool](https://www.php.net/manual/en/language.types.boolean.php) | Shorten or not the link name. When shortening, only the shortName of the entity will be shown | diff --git a/docs/tech/classes/StubberPlugin.md b/docs/tech/classes/StubberPlugin.md index e30cedea..c43cdd56 100644 --- a/docs/tech/classes/StubberPlugin.md +++ b/docs/tech/classes/StubberPlugin.md @@ -1,6 +1,6 @@ -[BumbleDocGen](/docs/README.md) **/** -[Technical description of the project](/docs/tech/readme.md) **/** -[Plugin system](/docs/tech/04_pluginSystem.md) **/** +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Plugin system](../04_pluginSystem.md) **/** StubberPlugin --- diff --git a/docs/tech/readme.md b/docs/tech/readme.md index f4c1f8d6..d5bf4d03 100644 --- a/docs/tech/readme.md +++ b/docs/tech/readme.md @@ -1,4 +1,4 @@ -[BumbleDocGen](/docs/README.md) **/** +[BumbleDocGen](../README.md) **/** Technical description of the project --- @@ -11,13 +11,13 @@ This documentation generator is a library that allows you to create handwritten ## Documentation sections -- [Configuration](/docs/tech/01_configuration.md) -- [Parser](/docs/tech/02_parser/readme.md) -- [Renderer](/docs/tech/03_renderer/readme.md) -- [Plugin system](/docs/tech/04_pluginSystem.md) -- [Console app](/docs/tech/05_console.md) -- [Debug documents](/docs/tech/06_debugging.md) -- [Output formats](/docs/tech/07_outputFormat.md) +- [Configuration](01_configuration.md) +- [Parser](02_parser/readme.md) +- [Renderer](03_renderer/readme.md) +- [Plugin system](04_pluginSystem.md) +- [Console app](05_console.md) +- [Debug documents](06_debugging.md) +- [Output formats](07_outputFormat.md) ## How it works @@ -53,4 +53,4 @@ After that, the process of parsing the project code according to the configurati --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Thu Jan 18 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/selfdoc/templates/tech/06_debugging.md.twig b/selfdoc/templates/tech/06_debugging.md.twig index b12f414c..1d9554db 100644 --- a/selfdoc/templates/tech/06_debugging.md.twig +++ b/selfdoc/templates/tech/06_debugging.md.twig @@ -12,7 +12,7 @@ Our tool provides several options for debugging documentation. **Here is an example of error output:** - + 2) To track exactly how documentation is generated, you can use the interactive mode: From ef85387dcfb238d8bdd2445f3afcf6981c4b60fc Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Fri, 19 Jan 2024 23:21:14 +0300 Subject: [PATCH 26/32] Updating doc --- docs/shared_c.cache | 2 +- docs/tech/03_renderer/01_howToCreateTemplates/readme.md | 2 +- docs/tech/03_renderer/02_breadcrumbs.md | 6 +++--- .../tech/03_renderer/01_howToCreateTemplates/readme.md.twig | 2 +- selfdoc/templates/tech/03_renderer/02_breadcrumbs.md.twig | 4 ++-- 5 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/shared_c.cache b/docs/shared_c.cache index b4dea85c..3cb32af5 100644 --- a/docs/shared_c.cache +++ b/docs/shared_c.cache @@ -1 +1 @@ -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 \ No newline at end of file +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 \ No newline at end of file diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/readme.md b/docs/tech/03_renderer/01_howToCreateTemplates/readme.md index e77bb291..c6884a29 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/readme.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/readme.md @@ -67,7 +67,7 @@ More static text... This is how it looks on the GitHub: - + ### 3) Another example of a dynamic block: diff --git a/docs/tech/03_renderer/02_breadcrumbs.md b/docs/tech/03_renderer/02_breadcrumbs.md index cf406862..a743bf15 100644 --- a/docs/tech/03_renderer/02_breadcrumbs.md +++ b/docs/tech/03_renderer/02_breadcrumbs.md @@ -16,7 +16,7 @@ To build the documentation structure, twig templates from the `templates_dir` co To determine the structure of the project, the actual location of the files in the templates directory is used first of all. For each directory there is an index file ( readme.md or index.md ), and they are used to determine the exact input of each level of nesting. - + But in addition to building the documentation structure using the actual location of template files in directories, you can explicitly specify the parent page in each template using the special front matter variable `prevPage`: @@ -29,11 +29,11 @@ prevPage: Prev page name In this way, complex documentation structures can be created with less file nesting: - + ## Displaying breadcrumbs in documents -There is a built-in function to generate breadcrumbs in templates [GeneratePageBreadcrumbs](classes/GeneratePageBreadcrumbs_2.md). +There is a built-in function to generate breadcrumbs in templates [GeneratePageBreadcrumbs](classes/GeneratePageBreadcrumbs.md). Here is how it is used in twig templates: ```twig diff --git a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/readme.md.twig b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/readme.md.twig index eb7a3a87..e28bc65a 100644 --- a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/readme.md.twig +++ b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/readme.md.twig @@ -60,7 +60,7 @@ More static text... This is how it looks on the GitHub: - + ### 3) Another example of a dynamic block: diff --git a/selfdoc/templates/tech/03_renderer/02_breadcrumbs.md.twig b/selfdoc/templates/tech/03_renderer/02_breadcrumbs.md.twig index 5e8551f4..9664ea49 100644 --- a/selfdoc/templates/tech/03_renderer/02_breadcrumbs.md.twig +++ b/selfdoc/templates/tech/03_renderer/02_breadcrumbs.md.twig @@ -14,7 +14,7 @@ To build the documentation structure, twig templates from the `templates_dir` co To determine the structure of the project, the actual location of the files in the templates directory is used first of all. For each directory there is an index file ( readme.md or index.md ), and they are used to determine the exact input of each level of nesting. - + But in addition to building the documentation structure using the actual location of template files in directories, you can explicitly specify the parent page in each template using the special front matter variable `prevPage`: @@ -27,7 +27,7 @@ prevPage: Prev page name In this way, complex documentation structures can be created with less file nesting: - + ## Displaying breadcrumbs in documents From 147c223be8829181f1f15e8ec9ebf701d79237e4 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Sat, 20 Jan 2024 00:20:10 +0300 Subject: [PATCH 27/32] Adding a new setting for documenting internal links --- .../Php/PhpHandlerSettings.php | 27 +++++++++++++++++-- .../Php/Plugin/CorePlugin/Daux/Daux.php | 5 +++- .../EntityDocUnifiedPlacePlugin.php | 7 +++++ .../PhpClassToMd/PhpClassToMdDocRenderer.php | 9 +++++-- .../templates/_method_details.md.twig | 4 +-- .../PhpClassToMd/templates/_traits.md.twig | 2 +- .../PhpClassToMd/templates/class.md.twig | 20 +++++++------- .../Php/phpHandlerDefaultSettings.yaml | 2 ++ 8 files changed, 58 insertions(+), 18 deletions(-) diff --git a/src/LanguageHandler/Php/PhpHandlerSettings.php b/src/LanguageHandler/Php/PhpHandlerSettings.php index 10cd084b..90b55844 100644 --- a/src/LanguageHandler/Php/PhpHandlerSettings.php +++ b/src/LanguageHandler/Php/PhpHandlerSettings.php @@ -24,8 +24,8 @@ final class PhpHandlerSettings public const DEFAULT_SETTINGS_FILE = __DIR__ . '/phpHandlerDefaultSettings.yaml'; public function __construct( - private ConfigurationParameterBag $parameterBag, - private LocalObjectCache $localObjectCache + private readonly ConfigurationParameterBag $parameterBag, + private readonly LocalObjectCache $localObjectCache ) { $parameterBag->addValueFromFileIfNotExists('', self::DEFAULT_SETTINGS_FILE); } @@ -154,6 +154,29 @@ public function getFileSourceBaseUrl(): ?string return $fileSourceBaseUrl; } + /** + * If `true` - parameters and properties in class documents refer to generated documents and not to external sources + * + * @throws InvalidConfigurationParameterException + */ + public function getPropRefsInternalLinksMode(): bool + { + try { + return $this->localObjectCache->getMethodCachedResult(__METHOD__, ''); + } catch (ObjectNotFoundException) { + } + $propRefsInternalLinksMode = $this->parameterBag->validateAndGetBooleanValue( + $this->getSettingsKey('prop_refs_internal_links_mode') + ); + $this->localObjectCache->cacheMethodResult(__METHOD__, '', $propRefsInternalLinksMode); + return $propRefsInternalLinksMode; + } + + final public function changePropRefsInternalLinksMode(bool $propRefsInternalLinksMode): void + { + $this->localObjectCache->cacheMethodResult(__CLASS__ . '::getPropRefsInternalLinksMode', '', $propRefsInternalLinksMode); + } + /** * @throws InvalidConfigurationParameterException */ diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php index a8e9e073..e047a5ba 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php @@ -14,6 +14,7 @@ use BumbleDocGen\Core\Plugin\Event\Renderer\OnGetTemplatePathByRelativeDocPath; use BumbleDocGen\Core\Plugin\PluginInterface; use BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper; +use BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings; /** * @internal @@ -25,8 +26,10 @@ final class Daux implements PluginInterface public function __construct( private readonly Configuration $configuration, - private readonly BreadcrumbsHelper $breadcrumbsHelper + private readonly BreadcrumbsHelper $breadcrumbsHelper, + PhpHandlerSettings $phpHandlerSettings ) { + $phpHandlerSettings->changePropRefsInternalLinksMode(true); } public static function getSubscribedEvents(): array diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php index ed17c712..171fbb07 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php @@ -8,6 +8,7 @@ use BumbleDocGen\Core\Plugin\Event\Renderer\OnCreateDocumentedEntityWrapper; use BumbleDocGen\Core\Plugin\Event\Renderer\OnGetTemplatePathByRelativeDocPath; use BumbleDocGen\Core\Plugin\PluginInterface; +use BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings; /** * This plugin changes the algorithm for saving entity documents. The standard system stores each file @@ -19,6 +20,12 @@ final class EntityDocUnifiedPlacePlugin implements PluginInterface private const TEMPLATES_FOLDER = __DIR__ . DIRECTORY_SEPARATOR . 'templates'; public const ENTITY_DOC_STRUCTURE_DIR_NAME = '__structure'; + public function __construct( + PhpHandlerSettings $phpHandlerSettings + ) { + $phpHandlerSettings->changePropRefsInternalLinksMode(true); + } + public static function getSubscribedEvents(): array { return [ diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/PhpClassToMdDocRenderer.php b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/PhpClassToMdDocRenderer.php index f3a51886..f1942cb4 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/PhpClassToMdDocRenderer.php +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/PhpClassToMdDocRenderer.php @@ -9,7 +9,9 @@ use BumbleDocGen\Core\Parser\Entity\RootEntityInterface; use BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper; use BumbleDocGen\Core\Renderer\EntityDocRenderer\EntityDocRendererInterface; +use BumbleDocGen\Core\Renderer\Twig\MainTwigEnvironment; use BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity; +use BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings; use Twig\Error\LoaderError; use Twig\Error\RuntimeError; use Twig\Error\SyntaxError; @@ -25,7 +27,8 @@ class PhpClassToMdDocRenderer implements EntityDocRendererInterface public function __construct( private readonly PhpClassRendererTwigEnvironment $classRendererTwig, - private readonly Configuration $configuration + private readonly Configuration $configuration, + private readonly PhpHandlerSettings $phpHandlerSettings ) { } @@ -55,7 +58,9 @@ public function getRenderedText(DocumentedEntityWrapper $entityWrapper): string return $this->classRendererTwig->render('class.md.twig', [ 'classEntity' => $entityWrapper->getDocumentTransformableEntity(), 'parentDocFilePath' => $entityWrapper->getParentDocFilePath(), - 'docUrl' => $this->configuration->getOutputDirBaseUrl() . $entityWrapper->getDocUrl() + 'docUrl' => $this->configuration->getOutputDirBaseUrl() . $entityWrapper->getDocUrl(), + MainTwigEnvironment::CURRENT_TEMPLATE_NAME_KEY => $entityWrapper->getDocUrl() . '.twig', + 'propRefsInternalLinksMode' => $this->phpHandlerSettings->getPropRefsInternalLinksMode() ]); } } diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_method_details.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_method_details.md.twig index 49964b89..d72ae9ba 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_method_details.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_method_details.md.twig @@ -25,12 +25,12 @@ | Name | Type | Description | |:-|:-|:-| {% for parameter in methodEntity.getParameters() %} -${{ parameter.name }}{% if parameter.isVariadic %} (variadic){% endif %} | {{ parameter.expectedType | strTypeToUrl(methodEntity.getRootEntityCollection(), false, false, ' \\| ') }} | {% if parameter.description %}{{ parameter.description | addIndentFromLeft(1, true) }}{% else %}-{% endif %} | +${{ parameter.name }}{% if parameter.isVariadic %} (variadic){% endif %} | {{ parameter.expectedType | strTypeToUrl(methodEntity.getRootEntityCollection(), false, propRefsInternalLinksMode, ' \\| ') }} | {% if parameter.description %}{{ parameter.description | addIndentFromLeft(1, true) }}{% else %}-{% endif %} | {% endfor %} {% endif %} {% if not methodEntity.isConstructor() and methodEntity.getReturnType() %} -***Return value:*** {{ methodEntity.getReturnType() | strTypeToUrl(methodEntity.getRootEntityCollection()) }} +***Return value:*** {{ methodEntity.getReturnType() | strTypeToUrl(methodEntity.getRootEntityCollection(), false, propRefsInternalLinksMode) }} {% endif %} {% if methodEntity.hasDescriptionLinks() %} diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_traits.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_traits.md.twig index e9d1decb..11e9b895 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_traits.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/_traits.md.twig @@ -2,7 +2,7 @@ ## Traits: {% for traitName in classEntity.getTraitsNames() %} -1. {{ traitName | strTypeToUrl(classEntity.getRootEntityCollection()) }} +1. {{ traitName | strTypeToUrl(classEntity.getRootEntityCollection(), false, propRefsInternalLinksMode) }} {% endfor %} {% endif %} \ No newline at end of file diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/class.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/class.md.twig index c2e21437..65f72f5a 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/class.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/class.md.twig @@ -1,15 +1,15 @@ {{ generateEntityBreadcrumbs(classEntity.getShortName(), docUrl, parentDocFilePath, false) }} -{% include '_classHeader.md.twig' with {'classEntity': classEntity} only %} +{% include '_classHeader.md.twig' %} {{ loadPluginsContent('', classEntity, constant('BumbleDocGen\\LanguageHandler\\Php\\Renderer\\EntityDocRenderer\\PhpClassToMd\\PhpClassToMdDocRenderer::BLOCK_AFTER_HEADER')) }} -{% include '_classMainInfo.md.twig' with {'classEntity': classEntity} only %} +{% include '_classMainInfo.md.twig' %} {{ loadPluginsContent('', classEntity, constant('BumbleDocGen\\LanguageHandler\\Php\\Renderer\\EntityDocRenderer\\PhpClassToMd\\PhpClassToMdDocRenderer::BLOCK_AFTER_MAIN_INFO')) }} -{% include '_enumCases.md.twig' with {'classEntity': classEntity} only %} -{% include '_methods.md.twig' with {'blockName': 'Initialization methods', 'methodEntitiesCollection': classEntity.getMethodEntitiesCollection().getInitializations()} only %} -{% include '_methods.md.twig' with {'blockName': 'Methods', 'methodEntitiesCollection': classEntity.getMethodEntitiesCollection().getAllExceptInitializations()} only %} -{% include '_traits.md.twig' with {'classEntity': classEntity} only %} -{% include '_properties.md.twig' with {'classEntity': classEntity} only %} -{% include '_constants.md.twig' with {'classEntity': classEntity} only %} +{% include '_enumCases.md.twig' %} +{% include '_methods.md.twig' with {'blockName': 'Initialization methods', 'methodEntitiesCollection': classEntity.getMethodEntitiesCollection().getInitializations()} %} +{% include '_methods.md.twig' with {'blockName': 'Methods', 'methodEntitiesCollection': classEntity.getMethodEntitiesCollection().getAllExceptInitializations()} %} +{% include '_traits.md.twig' %} +{% include '_properties.md.twig' %} +{% include '_constants.md.twig' %} {{ loadPluginsContent('', classEntity, constant('BumbleDocGen\\LanguageHandler\\Php\\Renderer\\EntityDocRenderer\\PhpClassToMd\\PhpClassToMdDocRenderer::BLOCK_BEFORE_DETAILS')) }} -{% include '_property_details.md.twig' with {'classEntity': classEntity} only %} -{% include '_method_details.md.twig' with {'methodEntitiesCollection': classEntity.getMethodEntitiesCollection(), 'classEntity': classEntity} only %} +{% include '_property_details.md.twig' %} +{% include '_method_details.md.twig' with {'methodEntitiesCollection': classEntity.getMethodEntitiesCollection()} %} diff --git a/src/LanguageHandler/Php/phpHandlerDefaultSettings.yaml b/src/LanguageHandler/Php/phpHandlerDefaultSettings.yaml index 5f4bc695..13c1f9a7 100644 --- a/src/LanguageHandler/Php/phpHandlerDefaultSettings.yaml +++ b/src/LanguageHandler/Php/phpHandlerDefaultSettings.yaml @@ -33,6 +33,8 @@ language_handlers: file_source_base_url: null + prop_refs_internal_links_mode: false + use_composer_autoload: true # whether to use composer to load the class map or not composer_config_file: "%project_root%/composer.json" composer_vendor_dir: "%project_root%/vendor" From 363dbc25ef3c9cad98ae582c3303e31ab3fa3476 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Sat, 20 Jan 2024 00:23:16 +0300 Subject: [PATCH 28/32] Renaming relative url calculator function --- src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php | 4 ++-- src/Core/Renderer/Twig/Function/GenerateEntityBreadcrumbs.php | 4 ++-- src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php | 4 ++-- src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php | 4 ++-- src/Core/utils.php | 4 ++-- 5 files changed, 10 insertions(+), 10 deletions(-) diff --git a/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php b/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php index 9637091b..4f592f0e 100644 --- a/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php +++ b/src/Core/Renderer/Twig/Function/DrawDocumentationMenu.php @@ -15,7 +15,7 @@ use DI\NotFoundException; use Symfony\Component\Finder\Finder; -use function BumbleDocGen\Core\get_relative_path; +use function BumbleDocGen\Core\calculate_relative_url; /** * Generate documentation menu in MD format. To generate the menu, the start page is taken, @@ -114,7 +114,7 @@ public function __invoke( $md .= "\n- "; $url = $pageData['url']; if ($callingTemplate) { - $url = get_relative_path($callingTemplate, $pageData['url']); + $url = calculate_relative_url($callingTemplate, $pageData['url']); } $md .= "[{$pageData['title']}]({$url})"; if ($structure[$pageData['url']]) { diff --git a/src/Core/Renderer/Twig/Function/GenerateEntityBreadcrumbs.php b/src/Core/Renderer/Twig/Function/GenerateEntityBreadcrumbs.php index dd762ea0..7f43a775 100644 --- a/src/Core/Renderer/Twig/Function/GenerateEntityBreadcrumbs.php +++ b/src/Core/Renderer/Twig/Function/GenerateEntityBreadcrumbs.php @@ -15,7 +15,7 @@ use Twig\Error\RuntimeError; use Twig\Error\SyntaxError; -use function BumbleDocGen\Core\get_relative_path; +use function BumbleDocGen\Core\calculate_relative_url; /** * @internal @@ -58,7 +58,7 @@ public function __invoke( $templatesBreadcrumbs = $this->breadcrumbsHelper->getBreadcrumbs($templatePath); foreach ($templatesBreadcrumbs as $k => $breadcrumb) { - $templatesBreadcrumbs[$k]['url'] = get_relative_path($docUrl, $breadcrumb['url']); + $templatesBreadcrumbs[$k]['url'] = calculate_relative_url($docUrl, $breadcrumb['url']); } $content = $this->breadcrumbsTwig->render('breadcrumbs.md.twig', [ diff --git a/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php b/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php index e5ba3a96..a5376842 100644 --- a/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php +++ b/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php @@ -16,7 +16,7 @@ use Twig\Error\RuntimeError; use Twig\Error\SyntaxError; -use function BumbleDocGen\Core\get_relative_path; +use function BumbleDocGen\Core\calculate_relative_url; /** * Function to generate breadcrumbs on the page @@ -69,7 +69,7 @@ public function __invoke( $docUrl = $this->configuration->getOutputDirBaseUrl() . $templatePath; $breadcrumbs = $this->breadcrumbsHelper->getBreadcrumbs($templatePath, false); foreach ($breadcrumbs as $k => $breadcrumb) { - $breadcrumbs[$k]['url'] = get_relative_path($docUrl, $breadcrumb['url']); + $breadcrumbs[$k]['url'] = calculate_relative_url($docUrl, $breadcrumb['url']); } $content = $this->breadcrumbsTwig->render('breadcrumbs.md.twig', [ diff --git a/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php b/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php index 31bcaa54..6d1657f8 100644 --- a/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php +++ b/src/Core/Renderer/Twig/Function/GetDocumentedEntityUrl.php @@ -17,7 +17,7 @@ use DI\NotFoundException; use Monolog\Logger; -use function BumbleDocGen\Core\get_relative_path; +use function BumbleDocGen\Core\calculate_relative_url; /** * Get the URL of a documented entity by its name. If the entity is found, next to the file where this method was called, @@ -125,7 +125,7 @@ public function process( if ($callingTemplate) { $callingTemplate = "{$this->configuration->getOutputDirBaseUrl()}{$callingTemplate}"; - $url = get_relative_path($callingTemplate, $url); + $url = calculate_relative_url($callingTemplate, $url); } } else { $url = $entity->getFileSourceLink(false); diff --git a/src/Core/utils.php b/src/Core/utils.php index 1f5ffaff..b01019a8 100644 --- a/src/Core/utils.php +++ b/src/Core/utils.php @@ -20,8 +20,8 @@ function get_class_short(string $className): string } } -if (!function_exists('BumbleDocGen\Core\get_relative_path')) { - function get_relative_path(string $from, string $to): string +if (!function_exists('BumbleDocGen\Core\calculate_relative_url')) { + function calculate_relative_url(string $from, string $to): string { $from = explode('/', $from); $to = explode('/', $to); From e09278c4dbc049183d57d1a8fbc985326b0d1b70 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Sat, 20 Jan 2024 00:24:40 +0300 Subject: [PATCH 29/32] Updating doc --- docs/shared_c.cache | 2 +- .../02_parser/classes/ClassConstantEntity.md | 4 +- .../classes/ClassConstantEntity_2.md | 4 +- docs/tech/02_parser/classes/ClassEntity.md | 20 +++++----- .../tech/02_parser/classes/ClassLikeEntity.md | 20 +++++----- .../02_parser/classes/DynamicMethodEntity.md | 2 +- .../tech/02_parser/classes/EntityInterface.md | 2 +- docs/tech/02_parser/classes/EnumEntity.md | 20 +++++----- .../tech/02_parser/classes/InterfaceEntity.md | 20 +++++----- .../classes/MethodEntitiesCollection.md | 2 +- docs/tech/02_parser/classes/MethodEntity.md | 2 +- .../classes/PhpEntitiesCollection.md | 2 +- .../02_parser/classes/PhpHandlerSettings.md | 39 ++++++++++++++++--- .../classes/PropertyEntitiesCollection.md | 2 +- docs/tech/02_parser/classes/PropertyEntity.md | 2 +- .../02_parser/classes/RootEntityCollection.md | 2 +- .../02_parser/classes/RootEntityInterface.md | 2 +- docs/tech/02_parser/classes/TraitEntity.md | 20 +++++----- .../php/classes/ClassConstantEntity.md | 4 +- .../php/classes/ClassConstantEntity_2.md | 4 +- .../reflectionApi/php/classes/ClassEntity.md | 20 +++++----- .../php/classes/ClassLikeEntity.md | 20 +++++----- .../php/classes/ClassLikeEntity_2.md | 20 +++++----- .../php/classes/ClassLikeEntity_3.md | 20 +++++----- .../php/classes/ClassLikeEntity_4.md | 20 +++++----- .../php/classes/ClassLikeEntity_5.md | 20 +++++----- .../reflectionApi/php/classes/EnumEntity.md | 20 +++++----- .../php/classes/InterfaceEntity.md | 20 +++++----- .../reflectionApi/php/classes/MethodEntity.md | 2 +- .../php/classes/PhpEntitiesCollection.md | 2 +- .../php/classes/PhpHandlerSettings.md | 39 ++++++++++++++++--- .../php/classes/PropertyEntity.md | 2 +- .../php/classes/RootEntityInterface.md | 2 +- .../reflectionApi/php/classes/TraitEntity.md | 20 +++++----- .../classes/DrawDocumentationMenu.md | 2 +- .../classes/GetDocumentedEntityUrl.md | 6 +-- .../classes/GetDocumentedEntityUrl_2.md | 6 +-- .../classes/PhpEntitiesCollection.md | 2 +- .../classes/RootEntityInterface.md | 2 +- .../01_howToCreateTemplates/readme.md | 2 +- docs/tech/03_renderer/02_breadcrumbs.md | 4 +- .../classes/DrawDocumentationMenu.md | 2 +- .../classes/GetDocumentedEntityUrl.md | 6 +-- .../classes/GetDocumentedEntityUrl_2.md | 6 +-- .../classes/PhpEntitiesCollection.md | 2 +- .../classes/RootEntityCollection.md | 2 +- .../classes/RootEntityInterface.md | 2 +- .../classes/RootEntityInterface_2.md | 2 +- docs/tech/03_renderer/classes/StrTypeToUrl.md | 2 +- docs/tech/06_debugging.md | 2 +- docs/tech/classes/Daux.md | 19 ++++----- docs/tech/classes/DrawDocumentationMenu.md | 2 +- .../classes/EntityDocUnifiedPlacePlugin.md | 26 ++++++++++--- docs/tech/classes/GetDocumentedEntityUrl.md | 6 +-- docs/tech/classes/GetDocumentedEntityUrl_2.md | 6 +-- .../classes/OnLoadEntityDocPluginContent.md | 2 +- docs/tech/classes/StrTypeToUrl.md | 2 +- 57 files changed, 293 insertions(+), 222 deletions(-) diff --git a/docs/shared_c.cache b/docs/shared_c.cache index 3cb32af5..a91397ea 100644 --- a/docs/shared_c.cache +++ b/docs/shared_c.cache @@ -1 +1 @@ -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 \ No newline at end of file +eJztvWlz20iaLjq/pSJOxDlxY6ZyX9yfvNQWYXdpbPfMh+t7HLnK7JJEBUm52tPR//0muMgUBSYBYhEEvNNTFkmJmcCLJ989nzQvKOMv/rl8QfmLH+a3YWFWs/nN8vPV/PLzj6vgvvy4CMZfh/+49v+x+nN2+cNfzAtc/D3GL364/XL7081qtpqF5Q9/+f2FTEO8uru2V+HN3P0Sbj69ni/CpwuzWIbFp/UffksfXV0FV8zxdn75+26+T/evlt//4IftRGj/wor50Yt//utf/0qXrF/8EGdXYfnZh9tw48ONS1dy9LLpi3/OXqB0nQKVXef7YoRFutLX85tV+Mfq05vdoN8+/Zxm+f72hxdsfWFiM/1v6c8XN+bq7ezmjx/+ki5Lvvjhn/9rFa5vr8yquLjZ4n/9q/yi0iDqxQ+umPBmlSZJA70Pl+EfP/zlr3/Z3Pm1Wbkvv6V5t5+xFz98Mcsv63nIix+Y95xqzjwWRGCCuI5M+4CJC4ErQn74y79mL3AP90zK7vn9Ty/fvPupyu1ufvPj//33f//3//3//t9////+n//zv9PL//PjDyViKG7okSCQ1DgShwUzOggpnOZEaOoF9SZ459aCIIUgSkGaE8Sb2SIBcr74ti8NUkhDpYn/rfFg/5aEdShPXIah4hcStzLlvuisEl4Qrbn0TGtrjCMh+hgU9kQx45Po0mJj7Ih+QPLz/G51e7f6eb5Ij2lIimL9MU+3eBlWb+fGB//74nVag6vw1/AnjgobzCWJPGDHPcYicqKpJgRHbGhxocUDPvNCP8xuLq/C5m8+BLNwX+5/t11LmpU+yqaj/9vd0lyG1/O7m1WxVgj9S3dThfWnfzXXoQATOXysmx/FH88XxR9o0c1lxLub9RfuLwSVP/Lid0p1cw1mcbnDXGFlTkrjX/9a2zCmMjYss7T6MmZMHDVmR6+usVWLjjHkuULRckpIMmoEK2w1xUx5YgJYtUdW7Rm4NI2lISKmjDARNaHcc40wEZG5aCWTDIe4NVT4mKESaY3Zu8vLtIqHZKV27mzywzOq4MjF96YH6HE9UHppjZWAJMaZiDEPXChFbRSeCMQNNT6ZZ+RBCYASOKoEitCwXAnwz+mylvOrQUW0MueoGs+iZ0IZYqjgWpkgGQqEWOI0jSSOxFHFvfmpRShzMMkaEenn9bW58Z+2blrYvp+c61pfQMWaO4pfiYgRKDgqpKI+qQoSQtSBc8w15RrwWxe/+MTj+RAWX6cL3nrSySHXYW0FxVQkk6MRkem3FiXLw7nX3mAJyK2JXE4PhPXyt/vHs9Mp75OCeBc+bt2MqaK4gaRyiJbSUWYjJjZE4zgz3Jikgn2kXipGAiC6ri7OPKeX3qcPX13N3R/LqeK4tnxy6A3KGRJZAquykXCPgoraGYSQUzFi8IRro1efsJXpfZxd3m2+PFkMnyelHJKpSyE9CdHJBN0imjWIahuIpIZTbDgguW7t4VjI8vL2dnKAzQsjh0uNkZEaYaV1TI6vtcgiFYJVwXKphRoJLll/RTFWmkJ6oDEevpscWs+Q0K54RnMZ89JMX2/5cnw8X15yYY2z5Z4HaaMOwjoUMI/CSyS4ZgSlzxlzkC2HbPnxktnR3g72+fbq7nJ28+HbMt3KkFLmZC19kqTsruY34f67IkW0QSmmPCWiuCDx2HurekGvH4y8feCqvAPnjAFLnCVFWxv8UNfjjbJM4Hr17cKsvizX7US8tfkO9LopWqQ2Cj49gB+XC/djMfTuRgvLs/7wrbm5vEti+DX5zFdhsQGkbk/G8zJQ9d2DlIOpCApgugdT9R2ma50ajQudY/W7M1JqFS7WSnD74/6qpodVYwNgdQ+reu0+/35zlaC6XJk0lknTdATWok9kfHBjCW6z1TqfvXMjpPLYoYijFAF7wgOhkTDDaGQs4g0E5fkQ/O3hbHtgXDf1NhHwsaHLYKk7mCbcO2KmkPc/N/3CR/VZ8Xr78q1Zri7W13h9PVul8R9/Ulx5oSKFrDZk8eXCG05jFS9/XV1fbd5ufr8ThDjMEFcb7nAoUgwlzhrq/XJ1OFqRH1CHox24Kp8uvtyWDP7KLEP6zYfVnbXpjx6+/T4DKxyjw0zKWTOkl+nrd9fp4c8Xj+bhrd1Jevm3m9nq0Qximyw4Y4aErdt5wvuFcX+kP17upno0hyye7qFprjbHG3P3j/U/xThqHTidN9BmTaavJCnEWfAXV8kHKP/0+4XrTa7iX9uMxbG8mzfaK+xkjI4ozqj2mFAdosLYOS7tSPJuqre0W6t6b2IJuVZll0M95s5oS5yLUuFi35LHXCGPY2RSJds/EtTjHgt6tcKXieG6fmx3VF0ncBJBoqFBImyRKnzTpKpD8lK5kGgswEU9AfevU4MiTxN9+HYd5zffNk7QTRLHp5++pn/fzJa3RVq3mLB4/+HOLt1iltyhiuDk3GKKtfOKW2OsdVZ6p6xgljLB5Wi0al/gTJ5nziCuH9L3usGrENMv1w8jjZ/+vqgaTE7VtiCxbGOmlN4zQlAIjCHK0j8qGuQIQhojNpaWYt0fwtuK6aeG87bklvU2olAoEm+YEjJBPKKk3aXFVruYosOxNG2S/qLDrHoqf2zrZMj92+kBvbnEsgpdRa65DppaH5RLv6QUMxxJcNRyNJbN+D0q9DayqlPDeBsyy6HcpmjRcG8iNkRYhaQuKhtEOWs5ZuPZyddfvqOtjP/UkN6S2PKbpwRBliiDpDPOCaFUpK5gWpHGBD+WHEl/TkuX9aiJ4b9LUebWRApNWVoCXklJqbTIekuQi5pRbrkRY2n7H4gjf5Bn+P3ml7AqUgzvw3J+t3Bh16o5Kei3ILEcwgUxSEftDRXeW24RNTbFqo4FIywKY4lVeyxkHja6ZFTV5vFtZ/795vWX4P74bbl5/9rcvAqbxzU5zHciw6yjj1MAy4IX0RfN+J46lNYEJSJIk7yfsaTg+1sF3XfKTGxJdC/QrB9klXVIY5sigmLjI9IkRcMBcaQiTv/B+niS2KC8w2tiK6NLUebWBAmYIstTMCAYjsYxFYLjkhEReRR4LCnQHsu23TYlTm1ZdCrM3MJgzlsWDbVYBC9TXKGJKcoFknqWfrKxLAzRX9TcuJN2YuBvLrAsQRrjhkunoolEOeel5cFG74Sm6X98NJvuh9H8+yjHsXkOOz82+M0M/70wt7cTLPS2Krsc6pU3KAatOLOooKIi2ihjLSVIyMD1WFree0T9Y9aPfGZvxxxW7AZ+9e19SK9nX4svFx9MD/gtiy9L/4Ot0MojjJBKgHckau0dtcJ4qjweS22sP+yXn+qReXgXi/nf04y7Z7h8M1ssJwf5lqSWjWpNoDxG7TRmUroYODXEEqZMEDhEMxKkk2F0amY7azejT7YjuS25ZVvvDfGaSRekjx5Fa4V3MnrJMBICxbHk/XtEe7mwSp/ay7gmzine7Z7aLExQqbcgsixFHKIFFZxhkWEaMcWRGeMCt1IqIexYMI77A3mPG5InthZ6lGyxZDLUKZEqDNQpwEa1ezVQhp8oIgWY7mkxtg/TRdLbr6/Mcln8uj9OquIwm++bRW9WC+NWy/LNotMDrBEOAAuUVB1TUpGoUeReByRoCM6qIJhCnBLLuaA+AiVVJUqq9dLih5XkxwHKdspNHF68SU7fxWLuwnJ5z0LVQpizJaBqvld5Sz/VVophwz+V3Y5UOtz9LW5HWu6SsA2G2pcWb7s+tCGPaikNuWGJajuNv+niaqFrerP7T5wG/95ARfR0j43NH73e0ATft9J00tu63cNVpxXqwcJdL7hisGLdfucH3tfp2whbHQq26hS/37z0fu2Mba7/4/xgdFqNeUswzJUSRBljgxEEESxCUuzSWsGFICNJZ/RVipkck0tN57zCoc/HObeHcOjzsatrzGAfuAvRsGBJxMw7Z4KnXDqtnZXYFkeiAIM9MNgfY7CXxxjs6efFViCPrvrpSex3Rz9znFMI2VtgfekEfVwnZC6w+cEWKETkWWCcRSEJC5EQyxTmzjFlBQW1AGqhXC0UUdTvR4KLnDRSNJGW7XzxbV8k6zi88ANLnIqag/1bktihUHGZUHetjC1MuS86q4QXRGsuPdPaGuNIiD4GhT1RzGy3thUh40mNivjn4km/vluu5tc/b92z5ZA0bEJxNoGo9fZUK0ggPnVhpsDmfWXmxx3Cf/yYkPTjDlv32kCWF2x+TOHi0a9OKzWutadQy5kN5mQRUZqYulfkBVY/7bD66aFGneyJIwnDGsrmUN7puryDuPUIa6Q1Cd7bglmUqygt4lRFsdliBuWdk+Wd9d2UF2aO6Lk3C/PnrjqwHvBduLm7L/HkXffjI+3qDLvEe3H3vJTy6shgRUD0S1htc+3L/PkiR8b4ZXtK++ZSXhWxkVukLy/v6zt1DMJutIKG62AsVn+s1QOZF2P+bXG1q/CUF4tOj7WT+naoorLDS9fMkaGKPO4m07/cK3LIo0WTI8NcLGY3q21N4x7ML5dvZ8v7Pfmyyl7WYzibLVOM9m1deXh5O3sXVl/mfnm0vFNn5ITg9bDvzG298s7xZ7MZb3ONr+Y+ScSHbXmn2rkkOinFoLHSTklFuLZSs8hiEWd7HeVIqiM9Eha2oB0nVmFpQ2TZjYg8YB0tM1gESoT1MUYnSHBMRqQYYLw2xtux21ODeTtSy7buU+alccwrSq3GUWIsY/SSUFNwLo+FNr+/bYe8vC3kwSTv5/OtOzLdk3fOllOWYJZjIYRKsZrkoTj9nDNZnCgVEFEBhdHwgvSH5kYh0tQg3UhYWfJASYSL0XAVPDdR04hdcDhQXDDgqNEQQfXnj7QSaE8M3+0ILet3O4KR49YxjZnh6TU1BAtJ0jvsDOC8Y5wfSQIBzs8QWt7rDiwYg1zS4QnW3HFnKTNSphfppwOc18V5GwnKqcG8DZnlUB6kLLQ2QS5IppUkiKFoPWJeSMzsWIi/e4wtKwjre8y0X0+bGLTPF1R2X4DRxkrJVGCCkJjiSYy44IjbhGwhx0JR3GN02bQWNDVYN5VXlpaJFh6J9JQxwmhU1nlaNNQKKSnjeDQkHv35JK2VKCcG8/YEl+UQVk54GblNOt3yaIl13EgWLbVCYQI1nrp476KEPjHkdyHCPDmZEpEir6RGSiquWPJrSJSyOJ4Ej4Zm+Al1/tnNHhNDfnuCy+I9eeyeECw1lb74VxmGmKJe8YDQaA4g7JGMr9IRAA/mPLL5G/B+puCydSMTcRGuMpz+TwmaXPmEeRtwNDGIKEaC9x59nC567yYG/U5kmO/m4kwG5JygRDuOSUBc6+TrCIxlIGMhHB5oVenovpWJwb6tzT7r5tyCV6jS7vDT2zH72i1eNLNV2C1+6oIb7x6XIeDiPyV8VFxK45mnxGpNkPYhWNg9DrvHs7vHnxmpQmPJRIWYNNgKgqhASmIjEcGeE+ci9d5tN4fjKpvD2f7iXl/lsLaGoxObD6NQEjYfDmJrOMpsDV9f0T2cefWN4dsvTmxLbTQUCA9mw9kWnrcwG09xfXmf9jXpdLeERyMN4Be2hHe8JdwRZQnjKXQIOkrMqQqmKB8SyY0gFhh/K20JV2vC3yqt8hsV99L7wjtNXu1ifv02xNVuLzir0g2xGePn2T8+rBYfZv9zT+/Pql/Ab8kV3+6RLRLrrEp1evPNi0W4fFe417v93TVuO3331izChwd0saze/P95N0+BRFiZ3T5uXmVD2ea778P1/GsxcXi1MH9syH7X+7dL9+2UDpFE/vHbbfg4327/ltU2GEcbtKZC2iCxjx57w320JlolLNYOkta126waLbaJpemaCStbfETKcEOlCMEgrbWKRFjDnWLFcdZiLMXH/nB9pgGYGKDPlFL2dGqHOWfUKE6xNlwGry0OSEiNPMVsLI3dPSL5DG9kajA+Q0TZ83ZJVNFZjImJlHCiqbOcRhoIT0GlhaJgbQyf5RdPDcVnCSlLx+MjIkqhoLQjmEfhBDFKYWO4EsJxwHF33nJJjDYxPDcTVjYKDAoLSqki2CAcOLJYUU+tkcI4Fj3gujv9vJc3mBiezxNSdlsN5iwqLrCLwnPkmGCImkCFCDxFhLCtprZ+bpLDmhicG8kquxXSaRqRKjJ1BSsqMslvVkI7nLzn5FPDBvbaqD43rTo1RJ8rJ9io3uO2ANioXhXODTaqbxpBedVG0BOtV721gdJqbaDZy23cBGo0JVpRLKRjTAvviIhEI+pM0N4UXhk0gUITKDSBdtIESj/7LZVMMtF3bnW3GOQJbNVV64kbGppqzV5uc9UaCUVpCXmU1o5PbhTVgiOkRKFq1mVOUK2gWkG11lStRSh/WrWSz/Y71+KQlOq6he1Y/CWZsaI4V2XNaMoN8gYxpbxPgZhmHqg4Wq5h7PFx7r/+NVzdFt3vU4vBGgkLaHuHuvH0F6DtbZW2d9O0qas6xUdNUV/uMD/u91S50MaOMArcOOuxMsY4JKVJfiBh0qHgVSAOjikGRxgc4fqOsKp0CjH+/GX+58f5RuN+3N3kj/e3+19msd4T83ycZIR04SMjjUnSJw4RQ1zAwhKNqTVmLCe19OgkH/IfH/KQHLyfLnVFA0kBG9fQ2OeAjatbNq61m6wq87OcZah4Ty60qsjZcsZNNM8zU8+E1VExLLF3wTBOuZSIYoUVIgLca3Cvwb2u514XO0w7l4ysWKY6olR6lBiXQXgfVUDeM55cb0osZiQabz1FiG8DkkpFz1MqspBOMllDCkdoLhxxUiahEIJCYAxRlv5R0SBHUpyCEYNwpLbzJkuFtWbwX7/eviwycwVYCq+k8FBW11ebt5vfT893a0tucGATHNg0bKR3fWATHL/3tPUqOH6vzeP3NoF45SauMxy03sLwZh7z8VtoHISrYDl2DBFNPJFJYUjuA/FSeMJ4is4hCIcgHIJwCMK7D8JlG0H4m2835nrmXl3N3R+DqgzuepILErh2zNnRW+3NqFVbm+feSGPTxopTHrFDlhqusBJEIMISBJWjQuliAzqYNjBtYNrAtHVs2mST/PLh3QzHlMmmkdnjW+vLdPWGsKqlUI+IMizioLwWkkrJraHYMpaWI9MRTBWYKjBVZ5mqPIFGiWTezBZJAc4X3/bFs27sKzKnJQm0moP9W5LeoYBxGdzWiqqcM7rulPuis0p4QbTm0jOtrTGOhOgLtiZPFDN+a7NEA5sVF+my3plVuskhGa5sd6bGyMi0wpTWkWJqLbJIhWCLBJnUAk5SrZs6Z6VPNQE2zi7vtqM9eDe5PPkZEsoSCWqNdNAJwU5JRbi2UrPIYmEuvI6wCa928adUWJkzbB8UMt6Fm7vJQboNke0KP6hheHHECvUWY6hGMUbp1bfQc8mS0feIMm4cVzxFrNQk5RADoilwNRBoQKABgQbkxDrPiRVOTHl8QT7frs3Sj8sN0ezcmRTNDC6OOH6alaMuYDjNajinsZUyDm7n+LAPsofvJnscm2OEMwDwEx6SeY/dwhx8PyRzM/YE4SjgzNYZnA7Y8emAyiPhDZfWKBcVNsgnb8VbK5hlKS4IcDrgsWnCvRNmNiurvNG51OTu0tXp6w9+sTsksLyZtHSowqHeXON88Wis4uZlLvv1cKz3wd0tlrOvIXd95GjGo9y7WGdSiqt8NBKtdrIedTpQxzg13DAjCEYoCoyiVhhHbiKk+Oqm+Jr7hlPL8LXhTW9ALnIJvtNhYG80ROx46H3qKptzEClHMWEkRdRGahsNjdQHQqTBEiMDnQGQsHvShF2Gout+bfQoF+ac1Zx7bJ1KUaz0InCRXDgnI2WS6m3ySZ9MPi1C3KrKl7ezATZh4VwtW0gqPLHBEeON1TKgaIQ0Xie0eCsIuAk13QReeqrQaZb/5S+L+d3t5HyEpuLaHY1AKzkIp5Zqb+zduJIuzF1s8+1cRFvDvSCUBqEip4GnYCHZCJY+wNSCuwDuArgLNd0FcZSw8MiyTj7BAF2G+2MRstRWtW6pr14KkaGxqnHBjdVr9NIpL6INJL0gBgkkDRFUMMoRFbBbFtQrqNda6rWX5olOPbPGUvLKWeaQ4FR6a5w3yHGUZCUsIUFFsW3IVmcYofTfx4WZrd7v/2ZINknlwljqCdXIaKSTdEQwhZic4kbTqIU3bCRhrJJPF8eepslc42fzGuLYmuLKlXKwTo4EJ0hIhZggNpmMgBn3iilGBRlLtzbXrL9izqG4Tj+u11dmuXw7+yNMFOFtiCx/zLBFkgYUnUYcJ3cIi+Q1IoMoNyRIOxKUU8L70+GHdHmnH9krs5wqwBtKK3vocOCuOEBbSY8NY4gQIaOiycFNoZAnfiTYVsNKs7827kvY/Fs0PW0+XVvd6WG7obiyits7z4sD3CwlimJksdfRMalRQDoBfyTgxro3cMv8wef3Me52Q1R6RjfLOF9cf39s0206aVV2eZpY5qVxzCtKrcZRYixj9JJQo5wPYyFFJrQ/nZ7rF3pUC5wuxM+WUw7OLiIUWUh/J6UQzhdHGUqJMLU4oVuMhQ9WqN7gzMrJqh9MMnUonyWjHIyNJNYGRq2jOGJlMA6YIsGUUcgKPhZPu8cgMtu1nHMdp4vqNkS229pOzqzAnszni764H9FZBdkT1998ezt2TkkipSIkSsoU0ZzQpDtCNN5J6JaF+izUZ6E+23p9dvaCj6AJprGktMBIcqQj8sjZmGJmoTAiSeUIi5IG2jI9n976X2o57u3o86xmI29E8lm5lpgKbzTG3EuGGKISSUOhmt1Hve8eQxMth7QhMqhqv2AYqtrjQjlUtUuKI7LHziSoag+jqj2Rwl9/+hvqflD3Gwrqe+xSgrIflP269k8IlP0GBGUo+52ZMYGq33BB3U7Vb/JNpBRBE+kwAd68iXRT0q5G5nRmYr+3snYVqqez7qF5adthGpI/Z7ByjBimPdOcUY2k5EpLOM0QSttQ2obSNpS2n7K0LY8eYpy3Hj/d3F0/z6p2EgTG0SNEonDERKMJYTrJJZklEcNoGElRf7mGM5L7BX6gFHKOtKCY/YLhJ8xAQDEbitlQzIZiNhSzm2hwKGY/A5xDMRuK2eNGOBSzG/gnUMweEpShmA3F7NGBGorZUMweNcDbKmbj84vZ2VR+X3VsmTlH+ezLb1zCToqAMmWjFF4HgVN4YhgnzIroSeQ2QAkbSthQwoYSNpSwn7KEfSbP+E/byvR3Mz6kGjbP1bA5w8gTgqVOGCr+VYYhpqhXPKAkrJG4rbjPTav1mbMvyjA0OQ+2PcHlAjVOiedEWq85tlRFLDyL1ift6VzyScZyQJzqj+aw3Lo8nCQNfVmEHGVHn00P6I0Fls1EFI2yzhDkgmRaSYIYSgBHzAuJmQ1jAXiPNe0K0gJgNxJUVmMbmUJEFRFzXApqPdYhKWoVHXaMSDUSQPP++JirPKfvfQYA6DMElS1SJ8VsGBfe0BBJMC69IgnTxEphdRwLoHFfueK/Tg2WWL744bdV8ev54uXl5SJcpotohWIzH8oOn2Izd/3NT5jVBCsiKNYycM6kUCpa6qNjLLqIMCRxIYkLSVxI4kIS9xkmcdeN489zIxLCIpkhjjhGjgatcNSKYUo98YRbZsbiT/bYJ3bG8YdrAG1eTy9Oaigu2Ir0gvW4zQ62ItXP2cJWJNiKNGaAw1Yk2Io0BZzDViTYijRuhMNWpAb+CWxFGhKUYSsSbEUaHahhK1IrGIetSEMFeFtbkRrUsfPZ/OHXsXPX37iObaVCyMsonBTGU4aLPUlcWiuSR6e5gDo21LGhjg11bKhjP+VRkaJBHftiUXx19W2w9ezspiRjNaNOJOxoZZiOkYSgOeM66WeO3FiOi8S8vzBNHS6609n9D3d2+2qHpvsXEy2RdCNEqAomhdpjFhmqgsOoCkIqDlJxTw3vrlNxUDWBqskIqiaQUYaM8hgyyho1zCifjKt7yyyrRpnlE/fR/MQmEiixxpioEZEWOyuIkSzFMc5RKyRkmCHDDBlmyDBDhvkpM8ysQYb5XVh9mfvB5pdFLr8shCZeUuUEpcZF7bAKqKiDEikwlmPZL0Vof2GZFA1SoxssbX9MNNHWvgAhr/wCa8grDxPuHeaVAytaWWhwTguruDIUJ1ebm+RMKevIWPivcI9Hl6lDq91QOU03NdehJCEP/YL1p+4hDw3d+5057gJqhsNFNbTvQ7Fl1ABvq31fNSy2nEgx9VZqEY1KLdm7aFxoicRLRZ2W0SJHPOORWRdsxISkiMdFKLRAoQUKLVBogULLc23lT0JcrszNarCllmwrv4qSBWctZhgFFIqgTabHw5XhNkjDR+LMYtofebdu0oX+AFIP3000E921OKEMA+39gwU/tPc3xXZ/eh9SdYNL1U2krNIfxqGqAt39kHCeGqKH0t1/MtR+Jt39J+6jcdK5SDJbwzh2XNMUyGMbgsLeCqMEs4ZC0hmSzpB0hqQzJJ2fMOnMeIWk88NrfvpcMs7lkj2XWBNOgrcsBocsD0IT55L5QVHgsZzci3tzU2nO77pYzP+eRt+8m5xLWkc0W/eT6Yru5+GiYz15lS3bxYrOopdcGkUtCzZYFbW3PsWYGEVDmNIWDs0DZzHvLJaanpw03swWaXXOF9/2RUIKkRTWoUR91Bzs35LEDoWKy4S63hiFW5nyAX2nEl4QrZMnybS2xjgSoo9FCEYUM35j/wU6af831mDzXNN1+Fnxp0NyB9YPjSTRuqv5Tbj/quDGBKU4wSKua2RCn309rx+MvF06qvyhnTFgiW1XtLXBD00n3rTcpcf56nvyb7mGIW9t0gNbuZ/HyT2GA5h9un91kKXU7cl+Xoa1vr3ZHHw9cQDfPfjqtef3+81VQu86gzUrcn0d4Re9+Oe44HZSW3pnAG57cKPfteWFWX3pT1GmB/DjcuF+LIYep9YrYo3Zqvg47BwH62IkOHKirfSUECw9oc5jHphEfANNeT40f3s42x5I1+uiiYCPDV0GV93BNOHe9doSG8hcCfCxob2+nt8cfvqzuVqG+7fF5aNtfN104BRyfEwebeHYmlmBmL051iLKHU9UbY63c5cE5X+7eTB4wXZQcFq0M/hf56uD8elfSrbp1x//4+LuoeCLc+N4bnEedZ1+WczvbjeHcG2TEBn1TzDGoP6HoP4L5bjW/wfdVj9efLn9cTPVjwfPfDJWAulgCbdaeBm5QUYxESjyKBSE4CnaffZWgvRhJfAmA4Ro9fa+R0pmv5J8+MvflheL2dd0GY8sCEY1drjXnnO+ShIJ/pFNwajG8bx1Z72zVzP3yNJgdGhq2pryv2bLmZ1dJQw8Mj+6BkvM4bCbjWjVnuT6KNMaZ3pXn6vsCa67gxvA5uhsj5+cWD+5Gl2v1eYqQtafF/Pr13eLRVqHu8f7fd71qcetT3sEKarh09uxQ1bDil6LtEYXfZ3pShc8aijMzISPEYM3+uXQ5LQw3UnQbGiVO5j5CG4w3biR/9o6k0dPtlUEMeyIDczKwHkwRkUivKKYRYGgEFu7X7Bp4nRi1dkWEs1rgAtWqWR7sk7SVwVXlNYw611t44KuTEtfcaU98yRaRhMQgsaUkmCNQt5AQRcKutD9V6f7r1q31mZdD6o8e6riIKOHisO+8WT7Kad7p6/4dY9V2gqe2ffj4fezQ2NMQWXQqzhngF4oz3ZdFxNFLYzKgLmn2DnmDFGYaSUU4oyxZ5/x7KUutpauqJH02M558d107sOiUJWnA2HOMPLF09NU+uJfZRhiinrFA0IejSUQ7m/nXHtPcGIhcXuCO1FGVMpHsIrP0Kf7TtwwZZ/OGwnoBZ+uY58uaGopt8RExYW0NnItInKapphfcwo+XSWfjrXv09UsFW8HrE749GhKXNZV1Yz0/dEc6zJRk7sqP5v60Tx0zyVmBfno7GZLQx8IUTbGaJMX7J1K/6EUzkTrGGFW29EQWfXnB9d/nGswvp398QRcVhjtg6FfvzfZxk9NJXXK5Q0ygNMwMJe3jRUyRue3xBuJGFluuCu2XCKDQvJHnBVYOqyExwo6r6t7I4+oaiqiboe4s2n3frq5u/4+CD5vAdxXwL+PVPgOZ9zUmnnn+yj0LycyZQgLSz1HHCNHg1Y4asUwpZ54wi0by5F7PbaMNATixNJjTcWVwzY1CuPoESJRuBTyGU0I08QbKbmIIQK262K7mXqcGrSbSSurtb0RSDCuJabCG40x95IhhqhE0mzSGIDsbsO6RzZ7YvBuQ2RZ7e0J1chopB0SIpiChcopbjSNOmEeMN6DZ/LAm5wYvpuKK1ufNpIIrSJijktBrcc6JO9ERYcdI1KNBNukP4Li8wttU4N1o4rk0Z0HQTLDeNLLNESSlHV6RRKmiZXC6jgWQNOe8PzXqaGyoGnaJHvmi5eXl4twmS4iDzlCEOIpuMPIW6ccQdRESWTyhpkL2suRQA73d0RHrxW4qQG8T9nmls1UDn7qbdXAsU+tLpSnPPbJkpiCTsu8kkgwaYSSBjOjKI7pvR7L2iD9tY1222ExsaXRrTAfN494zlUIzkimFMHaEuVxcZJOwFYZxCF/Xns11OBSqPAAn+asnSfsKSnO66zbU1JVgCdaTbSJsOdoNhhG0w5X0kR6T5TkKDBECr8Gq+A8Su6O4AILoxFVAnpPqvSebNira7A5HQPjm2835nrm9jG5a0p5RG3XEOsb4ZzoC8HJ/Y2aciGdFlIyiow3iOAQgkbeQF9IbdvfFUim5gR3JcfsecBCEy+pcoJS46J2SWMiTxkmUmAsYTXUXQ3t67SJLYP2BZi1BiRwHYlCxQnBXMkQjdIEcxWRcWo82wj6y7V3vy1kYguie4FmD9W2mhVEqMlQKMN0jCT5SZxx7TTnyEGzSm13qUkauPxxTs9IdCPE7JHFUhrsDEEuSKaVJIihaD1iXkjMbIB1UHMdnE8KNDGsN2NPmvhB8v3hGQ6S7+wg+TqHHW4eymAPOzy8vMbcmNrxghBXiyiRZ1zyiIJj2PMilreMADcmcGMCN2Zr3Jj4c7qsOLu82/xuSNyYWGePMvYs3XiMTPFAiu5sktYLT/9zyEU+mg6QHjfWlJ7Lc79wLtJVFYsgxRguLJfzxbr3+NGnk3MB2hJbzrf1WiMdNFbaKakI11ZqFlkstJ/XcTQNtP1hvVRY9w/tY9KAn37eou3Tm4X5M/3Z3XUaYz3Yu3BzNz2ctyCybLcrD1hHywwWgRJhUwAXnSDJ95MRKQYYr43x/KnPxx9Y2BYadi7PtGDejtSyvauSCFekJ1TwvCjdR+yCw4Fim7CvIFNRG+mlJxYeeWbp9+tukcIEvyocdbdIX11OD+itCC2704wGFoxBLmHbGcodd5YyI2V6kX46wHldnB82VOQf2epQNf1tcTU9mLchs2zDidHGSslUYIKQiALDiAuOuE1RqZDQel27jlLaynjkiRWP4+Lq7nJzSm6RXpkcwhvLK7t1kxYaXHrKGGE0Kus8dY4pISVlfHMaLqC7CTt77mldLGY3j8pgL5dvZ8vpwbw9wWWjUEcwctw6pjEza6o1Q7CQJL3DyYkBvHfrm9/b3/VYhbs5SaelFaFlq+UcCyEUIUjyEKSNnEnMnQmIqJB8GMB5Xa8lnwZ++MiKilN6bFsLPL3Ys5mwcriONmhNhbRBYh899ob7aE20SlisnQBcd4HrdUXz00vvi0rlzao4kfdtiNPzUZoJK0tDhZThhkoRgkFa6+KwYGu4U4w5b8Vojknqr7upStS0eVQ/z/7xYbX4MPufCfY3nSelbC3Tx+RjKBSUTr42j8IJYpTCxnAlhIO6fYca+mIRbs0ifJjfLVyYZHmnmbCynkdQWFBKFcEG4cCRxYp6ao0UxrHoAdd1NXSVgH/zqP7zbr4K12FlJofn84SUzfhhzoojl7CLwhcbYgRD1AQqRODJC4GMX239XKWivHlE78P1/Guha8KrhfkjTDAwbCKrbJWmODgMqSI65CpKZGggSmiHCTcWY6hF1kY1rvykklv48dtt+DifYirvbDllCbdJVNEl3BITKeFEU2c5jQnT3ARlYZN7h75Gcgsv3xVd2ZOD8nlCyu7FdZhzRo3iFGvDZfDa4oCE1MhTzGAPYm0cVw9vfru+vZr7CaY0zhBRtpIipfeMEBQCS54yS/+oaJAjCGmMmAYM18SwKN9Tt25aWL/evtz10IdNk/2vq+urzdvN7ycH7NbklkW7KvbW6OJwXh+US7+kSVHjSIKjliOoj9dGe2l/2smnNm2ktyGzSrtwM7vj6AB24R69vMa7cNmaTJYwyYKRkrFgraeOKhGJNzrCLlzYhXtkF26xptDj3aZmuQyr5Y9hsZgvPod/mHQf4T9ubwax0RS9+OdGF7ByXXDi2vtRA6UL4fiVNdYAVhJEBGUyUm7TT2uZDVw57YmVmtLto8ZHH7Wfu8/L1eLOre4WgQzuWfPssz568f08bJp52GWX1vhpC4epDFpbhxAhhvi0oI112FljNSXk5MJ+cFWDe9j5hX3s2p9+YZdcWeNHTSS1VFKnJY7OkYgowZZJTnA02hm1edRUZR/1UDU4Ofmgn0p/oxOPuV3tzax0JPkrLnluSGGaDDdxShPijBUBb2uAtGQ9H/pWT/9wSY4GAkeFDeaSRB6w4x5jEYuEeLpVHPFoGrZZX+eZpRDv8LFufhR/PEF6hxPSyFKxcqMiRxZxQ4RPnpRgyiSli4Nnyo+mx5qz3qBJD6W1/zB+Ni79Oz3qyGpC2aY76BFPqFTr92IYm0b4VcMZl/xbyyKR1gfHjaMsymQ2nFWWS++OOriZxf/0phFTsI1ppYFtfG62UWNkpEZYaR0pptYmM6lCsCqk1ajFWE6h7c80slKN83o/Pfzw3eTQeoaEcghGzKb4inktfEBFudexSENkWggnKR3LTiPyxL0Lu1LO+sdPX9NX3syWt4WtD9NTuOeIKLsXg0usCSfBJ88oOGR5EJo4h21AUWACGK4boJS2SG0nuVjM/55G37ybHHbriCYbVWOPWUSGGK+9CIamGNtJzLGggUk1lv1D/WH2ER175uiBzY9fw9XtBBF8vqCy+4a8UIxZKhwNKrIUjVKVHOCkiiVFwoIOrq2D83sIdi8mB9/KcsnuDkrvtbUsQVNyRqWIyVsg1BkpAuOjyWn2qH1LXbo02GWaZKdYtkF1+vZPRaV/uf18chBuJqzs/iBJhSc2uARwY7VM/q8RMrkYmlBvxVi0cH/5CJ5z97aTlB3ysvxlMb+7nR6yG4ore9KTpq4oQAlrsUGKc24dIUKm98RJPpY0cI86+/Gerpvl/CoUYczlIiyXr8xi//VUK1NnyymrqSNnKhLMOREIGxGlC4gZYRHGJtqx7LPvEc2l+wZeG/clfPrwxSyCfz2/vi0eUfBvtkRjRYVv/RfTw3QzaWU5fowMRFKCZfCOWGVodNGTqChiVBtAdgt6+v5ZvZ07c7X38ndbJKAmiulz5ZRDszRcaRqSF02ccooZ5ZFVLFBNvSZkLIxVPTa/HO56eflbYTy/zlLYPt0T+CpKJd+n5YxOrrCLUmGm0y8xV8jjGJlUIoyF8aTHSl5px9CDMtV0AVtPONu2LVnetnW0+WK3f01+nt+tbu9WP88X12b1FNvXnscGrj52sj2XDVy9bGcrKtnHdjUeA22HYsFRGBk5MVZzLWV0yKAgreLCoGInzNaA6Hx34C68TRHAtbnx96embN8PoWEw2y8orS06siIyzAYlrEM2/SMJKjomox5LANJjL32Jsn8IkeIwwHt4gCXMCCd/lr2LJmBGgyNCaM8EEowKIbnABW/dSIDLe8LtXyeHxKSQP3y7jvObYrzr2/lNEscjOFaCovEsJvwpQwwVXCsTJEOBkBRfaBrJWI4DEv2p0MdnIZywslMDb20BbYOK4gpPBRUnxtrFGbwgoij+EEIMCDGGEmLg4yFGCV47lIiNJDBLk5LgRlDMI0veNAk2eBKUitu9R0VzQ53o4kNYfIXQYlhmkT5pkg1CCwgtzgUuhBbDDy0kIkag4KiQivpk0UkIUQfOMdeUj4Vpsr/dnOxYf0q5iZ0gcmtIZxdUlPMqVR4IIgqIKCCiaCeiEI85nA5L5buluIvr36en+i583N7igKILBtEFRBdDsYytRRc0EEQo1Yg4KVVginBKOfdSc6nRaFpPeswWH+4QSTru48LMVsvv3ZnFY0nDz9z6F9ND7xkigggZIuRnECE7rG1yh6hI/mLSqTL91qLkNiaNqr3BciRQ7E+d8pLuyoou48RQ3EBS28hZy9ORc9VBIYqGKBqi6JbqctWj6Je+2PPz6mru/lhC7Dwomwmx8zDsJMTOg3X2IHaG2Bli5+eFx/ZiZykdZTZiYkM0jjPDjaFc+0i9VIyM5SzOHtVpJiIsdRSnht268tlVmOvFySVDQXQM0TFExy3VmFm9rtUHDMsDipGhezW5aT3SlUOMDN2rEF8MHontxRdBOUMiS+GESpaFexRU1M4ghJyKEY9lY1yPKlSf0BLlpnZqCD5PSruaHK3fzVo2IEQcEHFAxNFOxEErsnC8vL0dQmCRPb2SpRumSjItOdLUcROQEMISx6QmTlgwiuCfZdnPZM4/SyvgauY2jztfSnNJL5MQnUzOWKGSDKLaFmSUhlNsxhImkB4Piju2KX+tlSaG0rwwtq6WqMFGkL4HHhV4VOBRtZTDPXHq6Vo62YPynt7NSp9k/KyJHDeJRY+bZ+HAyVOph3YPnHQRBWYYD0WDkxHIY8Y1E0Y64ZPnBgdO1kXwESr3488nzZ++mtTzK3M5OTQ3lBYQ3wPx/fAw3QXxPdUo8EiMtNjp5JFbJmN6o1lQSGIEx+3URvPjU78eZtxfej8rvpee1+aTPX9xcpBuJKwsTb4q8Gu1s0Rjg4VNgFZOaIK8kIyNhX6mR1wf+oeH54kevF9OGdZNZJVDtaKCIRa1FoELYRQWznNlnU8fYubgQMu6qJalNvU+t3KRrqrIk1ws5i4sl/OST6Z7NkSrssseoiYctlwRYxQyiHPEkUeUWKxskNSDLq+dDSkX1v6pHlNW33XFk6fBo1FHpCWOPohgk++BCA0YIams12M5qrU/7IrDRvz9ST7M7xYuFBHQan7wbsqAbkVm2e04yDorMdM6WE4cii4QYYk1GDsajQGU10V5qbDubevHP2eXnzbFl0+v75ar+fXmzaRB3oLIchhHngoZtNLMaaEikcRj66gKklmKyFjoWnrEeOn56AcPbIu03SPbvp00zlsS226Dmq7SyZBPnkN7A7Q3QHtDO+0N6uTBCt9jkeL19uVbs1xdrPX49fVstVrnmA4+GULjg8j1PXijvcJOxuiI4oxqjwnVIarkRToux9Jf2mPbQ3mK5kz0TMzOtio7ONG3t21vcKJv3e2aGeHkcOsTNokg0dAgEbZIMRpZUtXrvh8h4cz0erid3HaAgqru8XaAn76mf9/MlreFO1VMWLz/cGeXbjGzlU9Jp5pJwaMN1HBvFTXKxYhJdJZh6owbCTZ7LP9W89J3H2zfT067niumHJYn0g7cY/kLmoH7bQbm3GKKtfOKW2NsUSvwTlmRomEmuByLh9tj6jQXm6wt5ned8yrE9Mv1s0jjp78v0ieTQ3QLEtsmTHFxP5UypmfFirtcKvt8u/7Oh2/LVbiGhCokVIeSUBXHE6rHQNuhWGRwSHFmtRHUGi68cQr7qBNYgtdEb7Oq5Kys6q5jadvO9Ovq+mrzdvP74WdUo1AoEm+YEpIgFFGywtIWfbHROT4WmkzSH49N1o6UI6fgv/r+FixvfYllW0+YsYJTFXGg2HKDvEFMKe8JYpp5KMvXjvTz9eVXhclzi/QHy/3Xv4ar2wmCu5mwsk2vkgpPbHDEeGO1DCgaIY3Xyfx7K6BxsDau1WlhvZ/PV5uX36db/rKY302PBqOpuLIZLRpYMAY5h4MzlDvuLGVGyvQi/YTsbG2vpLTB80hP0C9hlf7q7joNEfxm9L8triYH8FZkBnlbyNsOCNOQtx02giFv+4R5211C64y87Yk8EORsIWcLOdu2c7byxFGG1dYq5GsHaHAhX/tMLS7kawfnU0K+FvK1o8Q15GshXztSbEO+FvK140c55GshX/u8EQz52qfM15K28rWQq4VcLeRqO+2vxW3kat8vV0NL1ypI176QaBgGF9K1/adrJ0JO0GNQBOQEmXgIyAmGiVsgJ2iRnABKYFACgxIY4BpKYFACmyy2oQR2RqwHJbBnhnIogUEJ7HkjGEpgT1kC422VwA5S61AFgyoYVMHaroJhdKIMdngO3MWX25Klu87Pf7n9sLqzdpeuv387nNIYz5XG0noiyBJlkHTGOSGUitRhx700aVmNJf8qcW+GWB3mbVoE08QsdJeihGIaMH0PA+VQTBsobqGY1mIxTRCDdNTeUOG95RZRY520jgUjLApj6cHpL+CXurpx3ESz25l/v3n9Jbg/fltu8+vm5lXYPK7Jqd5OZJg9nI5plrxrr6SkVFpkvSXIRc0ot9wIDqugw7TX7ze/hFWRv3kflpvjM7dB7KQw34LEdmkvWiHt1ZrLDqkwSIVBKqz9VJjsIBWWXu5qmvPF80qIWRw8ZcGL6APm0VOHktdKiQjSSGPGEvsL3ZuJ1ofSah1SE7Pg3QsUkmOQHBsG1iE5NlDcQnIMkmPDTQtAcgySY7AKIDn2hMmx4kD7TpJjxx13SJFBigxSZM+jWyy9/NvNbPW8kmPIKuuQxjZSh6i2SBOFZEAcqYjTfyOx0D0mx9ppcSoH08Rsd5eihIQYJMSGgXJIiA0Ut5AQg4TYcFMBkBCDhBisAkiIjbFbrMxlh1QYpMIgFdZ+Koy2kQpbe4tJUV0Y90f64+VuIQ8uGZY9BIoETJHlyRwLhpNLy1QIjkuW8MSjwHQk1ln1mAw7JAZqFU4Ts9zdChMSYsBFOgycQ0JsoLiFhFiLCTHkmGPMOu4NY8REZgOKXlhBCUfICsBmTZ3KWRXzuJlzZxOnykTaQFSQ5IUk77MCOyR5n/sqgCTvUyZ5ZVtJ3kqBKKR5Ic0Lad6207xFerV5lveNufvH+p8hZHIxzqVymfOWpbjfYhF8wY6viVGRa0k9Sz/ZSGww5qI/K3y4rmqDZmpGuLHAICf7gkNOdghYhpzsQHELOdkWc7JwCkPbOhVOYTilWNs9hQFOOGu7qgAnnNXQzZ2dcBa5i8RbgXnQwlMjiA9ROs6oDF45A7iui+vDDGFpcPLldvv2wyZFuJwepM+VE5yVM9AKAZyV09pZOZlWShMoj0UaEjMpXQycGmIJUyYIHCLo69oIl+c+r83ok8V5W3LLod0wbrh0KppIlHNeWh5s9E5omv7HIW6s3fdQq365eQ5vDs5c/O+FuZ2iE96q7HKoTwGm0MojjJCiBDkStfaOWmE8VR6PJZPXo44vL50dr9pfLOZ/TzN+3BUj38wW0/PQW5JaDunKGxSDLuqsyKSgk2ijktueQC9k4NoC0uvq98MGxFPPbPewLszqy6tv70N6PftafLn4YHKQb1t8u14fpNvq9bkvYkI/D/TzQD9P69s2cSsNPfchzt9uZnEW/MWVcaH80+Fs4ZS5vh+NaFGpMywyTBPCcGQmXT23Uioh7Fgyaxiz3mx1cu/P6mM5A1wTM+M9ShY6iaCTaBigh06igeIWOola7CSCejXUq8dTr4b6BtQ3BoNwqG88V9RDfQPqG9NAOtQ3BlnfYK3VN2qnYKAOAnUQqIO0vq/5BHvlY72xVVabVq/iTdJLyWC6sFwOobhBcsUNwTBXShBljA1GEESwCJwSaa3gQpCRmGng9+/IrFK9n/C6WS2MWy3LE14nKgbGi+QfEiQxI4E6qZDCQWmdVLsT48kH9Fdk44fcnjU118SQ3FRc9w0vFchtag0Nbh64eeDmte7mybpu3r28Xsb11Rbvdj39a5fu6V29LH/NRFy9vjIy4OrlXb2NNcQVDritvdTAIoJFBIvYukUUZ1vEI7s5n94gQu5j9kKCQRyEQZz83n3cY/IDdu8/ye79rdOHGjl9paODzwc+H/h8bft8hVVpxee7L1OD5zccgwue39A9v4lw2vTq+QGrzXn+X3usNlsvULToBT6YA3xB8AXBF2w9/6ca+oL3efrtMoWS2EDML5TEhuEHbu0iacEuPlprYBPBJoJNHK5N/G77wCaCTQSb2KVN3K0psIlgE8Emtl4zOL9P5OTe6ae3jRRs44u+krVgG8+tG0yEPYPp3soGQJ/xDOgzItXaGyWEDDZ5LYES561jyaNRmkquxwL73lBfvunpsX8DQM/sEasurl24Q5o1SJ1YQxD2QNgDYU/rYQ9qEPYcpdB5+oAHGqWAD3P4Ac9EiNNkj31SwJx2TpdUW8xp27w3a+gIHpkBXEBwAcEFbN0F1M1cwBOUcuALDsEEC/AFB+4LToRaFCPcX/YbyEWHSC5KaHP3MDsV+IngJ4KfOCAmjfWSLTa8vA/L+d3ChY0gwDUcgkUG13DoriFimjnsvJKSUmmR9ZYgFzWj3HIj+EiA2KdrWIcX4oj2mhiaW5BYS0wapaODzwc+H/h8recGa9PG763SQl9tlEsRl63/6PXmVobg+jFw/V701YgIrt+5rp9XMVDhEEOUcCs881QkT9ATaWRgdDRUGrxH1+80JXpFJTYxULcnuBzihdHGSslUYIKQiALDiAuOeIp5mJBxJIjva6deErTO+jUfk6fx6ect3j4Vj2PzsJZThXljeeXQrSnz0jjmFaU2uekSYxmjl4Qa5XyAXu/a6C4PSx9M8n4+X21eTvc08bPldB+0n3UCSCWDALE7xO4Qu7cduxf6Nxe7Z85v3KzdrVb4/eb1l+D++G25ef/a3LwKG102hDAedrbOXigI4wcexgtikI7aGyq8t9wiaqyT1rGESotCGAkQMemxuefQTW9Dn00M353IEMIfCH8Gh/TG4Q9RjU7Errh6IBKCSAgiobYjIYxww1BoqyjWB7cVKzWpnovv8c5emAIR0aQMMERE50ZEzjmDqUTBB4kNITpGrALHnhqTfMGxbHfokeunYDDrSqtNDOVdijJ7ZBrDyBOCpabSF/8qwxBT1CseEPJj2Q/e43bww5J16YN8MCesgNJa/9mC2wVQlLcQQFVdZhBHQRwFcVTrFaUTO4CqLt/fb156//rKLLcJkI/zYUVQHCIo2BU0+AiKMaaiMjZabRFikerAOLfEIEsUEm4kQMR9VTeTUizt/NpqsN9vrr5th/pHcHfF17cPaWIAPlNKOShLm4Ie6wSNVFhPiVJYFdVRZCJ3LIwl7lE9JgMO6x3t2OaJQb0jKeaWAtbKC16QfijEBLHJPw2Yca+YYlQQOZKl0GMK4FBYpyPZ9YN7O/tjO/7kYN+GyCDNBWmuZ4D09tNcFfY2t2FFIMMFGS7IcLWd4eK8+n7nzY+9VqGnT1yhF//8147Ssc5ejYNbAd0CugV0S+v8WbKCbjmyzfDNwvz5Znsuxvr778LN3RA0jsylyjUNLBiDnMPBGcodd5YyI2V6kX6OJUPZ31ZeQWtsTf0lrN4cHKXyt8XV9Fz8NmSWpWjQGumgsdJOSUW4tlKzyGKhFb2OY8nYEPR0KZszVOPUUN6CyLLsxJwzGZImF5RoxzEJiGutGBEYy0BGw0PSoy4vZdc98sRe3y1X8+vd2+lu42hHaNkdShgZmRxbpXWkmFqLLFIhWBUsl1qM5QzK/nDOSj3RFAHE2eXddrQH7yYH6jMklC2mMmMFpyriQLHlBnmDmFLek4JH1I/GH+kNwfywG/ih0nlVBOBukf5guf/613B1O8XDJBsJK3tYlmZS8GgDNdxbVewYjRGT6CzD1EE0WR/X1ZI0uw+276eH6DPFlK2AUkPS/7uEW0m11FxogbhKvnW0CuuxMDr3h+Xyw5pzCcfd775/9LNxq/lieuX+VmVXpw5aO0bdFSbo58X2Wz8i/rnI7z709Zf7tQoGtQqoVTxhrUIfr1Xs4bhHyUSFmDTYCoKoQEpiIxHBnhPnIvV+gxPavWSKUycrSObUCu9QUkEZrhhK1pmE5HGmpaWEIGlxseClI6zGGcoV1Nwu4zyUw1GyDNmKB5ycFWawCJQI62OMTpDgmIxIsdFEmT1mvUsfa23cTMx5aUlqkPuG3PfQkd597hvq9VCvf3KYd12vnwgHXY95ROCgq5ZIbMpBR6senFrT/YG0CqRVIK0CaZVhpVVEpfNmT2vPgSdSXEQoJrfbBSmFcD5Gw6VEmFqcvBNBR+KOiB638cvT0pq6L3KWjMCrfiHBrR4alBu41dAG2J9ShjbAftsAkzthsDMEJceCaSUJYihaj5gXEjM7liMnetTHFYT1Xc9MeFP9+YK6P2us8v7VU1oeUhuQ2oDUBqQ2hpXakCfOI8glcQuB/RJW26MTl0PIb2RPHHAcCyEUIUjyEKSNnEnMnQmIqIACG4sf0l+jyIkW+xNwmZoz0khY0BYCbSEDB3j3bSGuOITdMB6k5tII5DHjmgkjnfDRSTESoPcYSZYmXzORfpo/fTU9rFfmcnIAbyit+wPcWLPi+YFtgMASAksILCGwHFhgqc8PLNPviy+Gi2QU97bmDiHAzLJMWUmEK6rmKnhuoqYRu+DWm9+xCGosBfQ+dyLUcSmPwmZibko7QoOAEwLOMQH9rIATGEyAwWSwGcMGDCbIqpj8E4exEQE7KU1yVRiWJgUHhOCx9Ej1qL/zm/+OPKpCQ/1083W2mN8UnfCTA3hLUgOuHuDqGRq0u+DqgVZAaAV83q2AwDYFbFODwXY3bFOkWXHnSD4GijxQ5IEiDxR5xlTkuSdM2NbKL8OaMeHpizzZLkLlCEaOW8c0Zoan18mhwUKS9A47A0Weros8R2AzMeelHaFBkQeKPGMCOhR5hhCUQpGnxyJPW2FnqYWAsBPCTgg7IewcWNipWgk7H/D0PX3UqXJRZ6Rae5OEIYNNqiVQ4nwRggahNJUcCva1fZTD89aPLLUDrPz3wtxO0ktpKK7ssZVKGiSpxIKaZEFUjAFbxIP3sdCQYwk0WX9xpm7ysPZ11dRg3qLkoCkFmlKGBu9OmlImQtXdH2sgcHWfobi75uqGbDhkw4eA886z4Z4zlGJusk5TMB6loBxpjhAihstIRgL0HpsM821GuxcTTX/XlA60x0J77JDQC0yZg86EAFNm1ciwMVMmxa1VIPeccihAQgESCpBQgBxWAVLIBgeC7CvPp686ZglNJuKP6B4ZM8Eh6d4hyew/MzIZSBURc1wKaj3WwWiiosOOETmWEJH2l6yu8pxemWUAQJ8tKDjs5kWPeIazbqrBuYuzboykUUekJY4+iJAcd4YIDRghqazXkHtup5S4neTD/G7hwtu5M6v5wbtJ94C0IbOszlbJj8aO2MCsDJwHY1QkIqlwzKJAgPLaOru0a2c7ySY+TJGrn+3SsZtXE9bdTeWV90iUQMmnFsZa6gJxQmkvlbeRqGDdWDySHrv5SjeIPJxklzlYP43FxWJ+uQjL5SuzmC7I2xJbvikkcGG0KjpBLKdShPTSGKy0xZ7FCFivi/XS/OPxSYzfPcL3YXl3Nb2OvuYCu2elRw1POvs+DRRtoGgDRRso2gyraCPZ+bvGCsV5cXV3OStqKus7GELtJnuae/JLjJWSqcAEIcXBOThJiCNuU/Qp5Fh8kz5PO8tvDjmNmIn5Jo3lBf3Y0I89cIx334+NmE1eIvNa+ICQI8ixSENkWggnKYUzz2p3tZYnBta6Z/vjp6/pK29my9vC85hiU/YZIoIqZZ8Zb6hSdl2l3GZFZLOu1sduDSRHIDkCyRFIjgwrOaLo+cmRi8Xs5lEO+OXy7Ww5iCwJz2VJCC32rktPWVpnNCrrPHWOKSElZRzjsXgmPbK55pliakBnYr5Ke4KDvAnkTYYO9s7zJlPhJekP50BLUh/mXdOSEMxZVFxgF4XnyDHBEDWBChE4R2o0/kt/mZX8kXSbJ7Z20NOH1/OvIUUC4dXC/BGmd9BwI1nBPvg+UQ3bzipCuvk+eNEsY5jx7CF1CKlDSB1C6nBYqUN9InX41txc3iWz96u58VdJbhdfbo/pvqKeeGW+vb4yy+XL29m7sPoy98shJBGzrVZMOeFl5NZYaXm0xDpuJIuWWqEwGcsBIoL35q/Iw1xYCyCamCfThQghsfiCUEgsDhn23ScWhaTCExscMd5YnTAfjZDG6+Rp+eRVjAXo/QWnpYWP0zHX8pfF/O52cghvKi5ImkPSfNAAbylpvknHsArpmMaeESRmIDEDiRlIzAwrMXOqp6uO2luYP9c67525HUI6JtvTxY0SkSKvpE4oUklShEQSpfTUIczHQvKGMX66pq6zsTM1X6Y1wUHu5QXpkYgCci9DzL1AfArx6dPDvOumLsgwQoZxrBlGzjDyhGCpqfTFv8owxBT1igeEPBoJtnv0VKp4mA/nvPgetE241as9wdVp/TrT/4cMI2QYIcMIGcbnn2GspFGfPsOY5JdLMVKSUCOt1xxbqiIWnkXrnTfOJR00Fg+d9rhttAKRZRr60qS/gE71VgQGbvoLzAeWQwdHvVtHffJ7jgQcvjk4gMNZV018FDEoQMNZV40EBed7w/neAwJyy+d7R+4i8VZgHrTw1AjiQ5SOMyqDV240dfr+NPIhv1+pa/jldvv2Q1it0tjT2wx0tpyAmRaYaYcE5LaZaSnXghFhsZfGe8Gx1cmrkELIKIU1FjBcE8OVth0ezGnSc9r8WySrdrH7t5+NW80X3yaH8S5EmOUQYiQG5wIPxDjmrIqRUcQVjdJriYBDqO4aUIcNQtmi72bE9JfHP/k1XN1OUNl3JsdslKmpDSoyjy0j2hmhtUDSOYk5Co5BlFk7730YQ2XUWXp5+Gqi2G9JaicShIFISnAKPh2xytDooidRUcSoNh6Q3jQa3WQL1ra5OCT4au/l7/bvaa71B5PD9tlyyqEZa5X8d4KEVIgJYjERATPuFVOMivGQsPSntw+FVcENLbrV3s7+2I4/OWC3ITI4R+WFemKNfazyNt2dPQ3OUTmOZmeosMIGJExg6V8dIvJUUq1c8sDdWCruPeZeWu6NmxrKW5dfDv1G0qgj0hJHH0SwkjFEaMAISWX9aFoIn3or23aSD/O7hQuFR7maH7ybMuJbkVnWY1EEMZyiy8CsDJwHY1QkIjkwmEWBAOW1PZbSQ1W3k2x6wF/Pb/xsPez9qwl7Lk3llffHlUBGE2GspS4QJ5T2UnkbiQrWjcUf73EzW3l578Ek6x+zsFw/jcXFYn65CMvlK7OYLsjbElueYyJwYbQqiCUsp1KE9NIYrLTFnsWxnCfeI9YrNPDvT2L87hG+D8u7qwkekNVYYE03alZoMoeNmrBRs6o0YKMmbNTsiaOftUYF90tYbTalb6gvX839t9dzH4awZ5PmtmxaEzFTgTGc/k8JKiVN7rsNOJoYRBxLt2KfJP2HoVUbKJqYT9OJDIEqDmj6B457oOl/fplHINHql0RrS2AuWyUVOmI0IGyFsBXCVghbhxW2Ft5xLmw9y2l4+jgV5+LUiTjoDLicB+2+tOWgbxPupNmhuEcmAK8FvBbwWsBrGZjXgut7LevL/PTS+2L6dNmL+fXbEFdD8FZIzluJNmhNhbRBYh899ob7aE20Slis3Viy6rjHNEtpL0dVuEzMS2kmrOx2ImUNUhpZZ4hXwkWBAiKEae5ooHgsrV09AvuE9dh/Vlvdvn4zYRe8scB27jc50/0+snLK3G62b5TX3wOnG5xucLoH73TTak53dn13KCdJg+TWMMF04DYGI5XX3LBohKBBb4uA4kR/y3Hl9vPsHx9Wiw+z/xlEZjDra3OUwg9TdN4Gg7TWxUYKa7hTjDlvxWg4mftzSVjp5oCTOJmYH3KmlMC7Bu96wKhuz7vGvIl3/X3JgFsNbjW41eBWD8itPjuT/Vu68YF0hWd9auMw54waxZPXYbgMXlsckJAaeYrZWDgo+vSpq6dk70EyMdfjHBGBNw3e9IAh3aI33ShXvV0v4EqDKw2uNLjSA3KlTxyVeVylXSzC5bviIgbvTFMSVXQ2qXATKeFEU2c5jTQQbkLyUcAPqe1Ml24iOQWTifke5wkJHGpwqAcM6hYdatbEob5fMeBSg0sNLjW41MNxqc/vs05K7dYswpbSci2UgbvW3kdElEJBaUcwj8IJYpTCxnAlhOPgkXTYZ10Cl4l5I82EBa42uNoDBvdQ+qwfrRxwucHlBpcbXO7huNznZ7H/826ebj6szOBd7RgUFpRSRbBBOHBksaKeWiOFcSyO5Vi0YWax92AyMS/kPCGBaw2u9YBBPZQs9v2KAZcaXGpwqcGlHo5LLdG5LvX7cD3/WiQKwquF+SMsB+9ZE8xZVFzg5Ip4jlySDKImUCEC50iN5aD5PpPYpY+1Ilom5os0khX42eBnDxjbLaawcRM/+3DhgLsN7ja42+BuD8fdLo7KO8/d/rBafPx2Gz7O/7a4GoKrzXOutqaBBWOQczg4Q7njzlJmpEwv0k83Ep+kRxLh0pNyj5Psp7+6u05DhM0hdN/WoJmaV9KGzLJnfDhNI1IFByVXUSJDA1FCO0y4sRiPBeUE9RdQ4sqO5EN9ODFony0nCCQhkBwwrtsIJDNdrJwhIQhZO7GMRykoR5ojhIjhMsKZTLUr63k1tHvxa7hKA0wOzDWlk0NukCkES2oZuSCZVpIghqL1iHkhMbNj4QnpMXNdQVhlx2NNDsTnC+q+dF7hBLFq7guk8yCdB+k8SOcNJ51Xbw/Yq+I5u0X6g+X+650D8PQ5PZbL6UlmrOBURZyCQcsN8gYxpbxPzohmXo7FBxH9nd17Yl/TCbxMzRNpJKycd60xMjLZCKV1pJhaiyxSIVgVLJdaqLEgu7+4sFRfJZMRZ5d329EevJscmM+QUA7B3MhAJCVYJl+PWGVodNGTqChiVJuxbBroMT4sjd1fG/clfHo7d+Zq7+Xv9u9prvUHk8Px2XLKoRkxm0IY5rXwASFHkGORhsi0EE5SOpZTvXrUx6Wm8+Lq7nJ2s/3x09f0lTez5W3hGE/QuzhHRPcZDlE3w5F1VsrSHOSz/f5nkOCABAckOAae4ODHcVJlZXcoIS0x0gZRy5kg3vloIuLKSOaYTYJTG+OMyZlbnr53VNwU2jZcJJu3p+NAu4F2A+0G2u1ptZtQ+cTtW3NzeZcU16/mxl8leR2832s4ePqsbbYTEyFdJG2RxsQY5xAxxAUsLNGYWmNG09SDemxSO+wrrA6WiQVVDSSVyw9QzaTg0QZquLeKGuVixCQ6yzB10F1cH9HVjMXug+376cH5TDHlsCyRdVZipnWwyYqj6AJJ2jmZKuxoNGMhLe+x57JUWCdbCPcN7dRw3YbIsvlcT4UMWmnmtFCRSOKxdVQFySxFZDSV4/4wXoUPcxeHbx/Z9u2kcd6S2KBTEzo1h4fu5p2arMLm66oefFmaD3/+Mv/z43wjno+73MGP91mE/zKLmUlTPUgBckgBQgoQUoDDSwHKih2cR1Z9jxLjMgjvowrIe8YV0pRYzEg03nqKEF9LjHUvMcUbSSynJzuUnrHCc8ljRJorSqjFThDLEfcYUxrdtlzEKxTBD43HxZfbAwN18T2F+t1CgS0BWwK2BGwJ2JKp2BJasfVg259VvN61aiXzUsiosC6FpVldX23ebn5/jikpvp8CMTAkYEjAkIAhGZshaSax41qyQ9mpyClG3mrlcUJX5M4rZil2zGsXhN6akWKZNOtgK+MEAhMCJgRMCJgQMCETMCFFy0dLJmRdtiliErAhYEPAhoANARsyDRtCqm4PzGz/rmEw4iLd6zuzSjcKtgJsBdgKsBUjsxVSNZJYqYLsEmgiFogyWlFFmQxWGaVtxFwIQwlCu2xV1aLHkVDjzcL8+SDWeBdu7sBugN0AuwF2A+zGWO2GPLGTdb8L+MP8buFCQcazmi8+vZktgksvkpV58Ish7Gml2T2tNChKo3GCO0IDlRQLHa0TWlBN+Fj2tFLxl6clIixFzSuzDAdwmVqjfSNhZTe2Oh2oY5wabpgRBCMUBUZRK4wjN3EkwMayN2CLUn6y0mf14N1092y3ILEcxIlmJASHk4dNrdYkoIARcVox70kgdCwQf+qjoWpa/KmBvA2Z3Z9ZWbVGWGv8XeROPt+uv/bjcv+3QJIEEfpQIvQMFdA9eHuUC3POas6LLeaKES69CFxYK5yMKYqiujeKJFZBLkcWdZdRpdUmcIUFx8oyFoI0wVChXfoUKcK2UaU+N6osZPTbqvjmfAFh5QBdE6IhrByiTwJh5TM62A/CymGFlRRTkvQ1DzxyYgOn1DCkEKFMUWs5HwvEewwrWeUHljH5U0N5K0K7Dywr8HGcMQFElhBZQmQJkeXTRJZKnhtZvg/ubrGcfQ1QuBy2lwIR5jC9E4gwIcIcL7o7jjCR8FpR4lAKMjV2yHHkjFHWYqOkU6OBeH8RpsxJq7bpnxja2xXefcRZdcf8eRNB5AmRJ0SeEHk+UU3z7Mhzo5kLSUG8OUCfBeLNYfooEG9CvDledHccb2KsLWWBEI55VJFg5azVzjrqA/EaKpr1IV49ZDpq8KeG8RZEdn9KcqPY8sjwEFFCRAkRJUSUTxRRirMjyiMewdMHlDgXUE7E7ybgdw/YJ2nD7966JKqRS1I6Ongk4JGARwIeyRN5JLS6R7LVyWVnwi1/WczvbofgjoicO6KDZIZx4Q0NkQTj0iuigyFWCqujGok70ld6+69TcyVwUoG7FumXl5eLcJkuIp+WE5IKT2xwxHhjtQwoGiGN10mbeyvISCBHCO+vpqLOO7hyp6QmBtqm4oLTa1/0l3OG02urorrB6bWZIopSSOKibEI0NlhYFpRyQhOUAM3YaArg/eH50O07cR7wlI8bbySrHKo1VQIZTYSxlrpAnFDaS+VtJCpYB6iunYTLNSpsJ9kFP+unsbhYzJO7uFy+MlPOxLUkthzWTSziXa6clklxB8lFQFpqRgXhSal7wHpdrNcK3Nc+Y/FQds/xfVjeXa2mB/V2pHbfZ03qJZ5PuvWPss6LELd/8PJ29iiNB8lnSD5D8nmAyeeiuFVBLrm13aGUvHKWOSQ4ld4a502xCyrJSlhCgoqiWg769CnwHxdmtlV0Q8hBk2xNHGvlBSdISIWYIDatqIAZ94qpwkuRI/FQOFP9+SiH4joNmddXZrl8O/sj7GAzNQelBZFl897OIkkDik4jjpO1wCIZVWQQ5YYEaUeCckL7QzmXtR9Z0SY/UYA3lFY26x24UzZoJT02jCFChIyKJvufPEVPxhJj0h7ThBVqFK+N+xI2/xq7G3Zt+aeH7YbiyicLmZfGMa8otSkUkhjLGL0k1Cjnw1iShT2elZDrP3sUqE83O3i2nHJodhGhyEL6OymFcD5Gw6VEmFqcwC3GQh9P+qtQskO7eiyJO2EonyWjbFZbEmsDo9ZRHLEyGAdMkWDKKGQFH4vHgfvTytmdSjkTOl1UtyGyrOeRwkOpEVZaR5o0tEUWqRCsCpZLLcbSndejqi7Nd2VODZ4cpM+QUA7BkbtIvBUF5ZPw1AjiQ5SOMyqDV86MBME97sF95BSWRvFfbrdvP4TVKo29nByQz5ZTDs6cYeQJwVJT6Yt/lWGIKeoVDwh5NBI497ij/DBuP52Tuvhewphwa1R7gstTKHjMIjLEeO1FMFQlhS4xT3FiYFKNhUKhx7RejSLD5sev4SqNNTl8ny+oLAWlY44x67g3jBETmQ0oemEFJRyluBHwXBfPh3T9mcf0en59O58wohuIKhskamqDisxjy4h2RmgtkHSFmkbBsbEEiU/Y35dTPV9uD19NFN4tSS3rfRsZiKTJ/Q7eEasMjS56EhVFjGozlpxfj9q7tMCwyVgVO3Ov9l7+bv+e5lp/MDlsny2nHJpVlCw4a3GKKQMKRRJbBuO5MtwGacC3rotmfdhYeDok+nBnd7MXrTyv5zfLlblZPXy3+YvJgb5rcWbPuCYIcY8QRt465QiiJkoivdHMBe3H0hHY39rAqH53W/WnOe1UTK+yza0aqxBS2BFjVFQKYR4DixoRpWgMRI0l2d7fqpGldv++VX0zRPrV8U+mWxttVXZZJmNPqEZGI+2QEMEUDfZOcaNp1MIbNhLU99hVWz+1/GC7wcSA3lRc2Z5xoYmXVDlBqXFRO6wC8pRhIgXGEjR6bY1+uOG2jql+F1Zf5n77Y6Job1+AWY+GxKTdLfNKIsGkEUoazIyiOKb3o6Hw7g//qr6yyj2+aTv+3Qoz2/1oNaNO+GQflGE6RhKC5oxrpzlHbiw+T4/rokmy42IxT8PuvZiobehGiNn+BBK4jkQVtVvOlQzRKE0wVxEZp+xo9tT1l0Ntksoof4TTthHdC3THiMEqnHVfKzQ5wYhx++W2+G/9hff7v9knyRBAkgEkGUCSASQZLZNkFD2q3UuJ15ZSoRR7lJQWGEmOdEQeORupUUJhRJLKERYlDbSWFO9eUoXnd4akTpiPDgXnMGZEUm6V5sYhH6wIBEfrIyHMI1LtvMszGCIGwMWCgIvlBedPuLEOuFiAiwW4WICL5XxpARcLcLEMF9vAxQJcLKMDNXCxABfLOKAMXCzAxTI+VAMXSysgBy6W4UAauFjOUtPAxTI0IAMXy3NQyMDFcq7rAVwsz7HXCbhYqqpv4GJ5FngGLhbgYhkZpoGL5SyHBLhYnh3SgYulSSEGuFiGhWbgYml3FwFwsYxnbQAXS3cLBbhYxrpqgIvlGXCxAF9F26gHvoqG0Ae+iueMf+CraHEtAF/FeNYF8FUAXwWsA+CraD3T1B9fBW+Dr+Jg2x9wVgBnBXBWAGcFcFYAZwVwVpzHWXGf69t5tAPgrMDAWfGCs/528wNnRW3PGTgr2okdgbNioAAHzgrgrBgttoGzAjgrRgdq4KwAzopxQBk4K4CzYnyoBs6KVkAOnBXDgTRwVpylpoGzYmhABs6K56CQgbPiXNcDOCueY78TcFZUVd/AWfEs8AycFcBZMTJMA2fFWQ4JcFY8O6QDZ0WTQgxwVgwLzcBZ0e5OAuCsGM/aAM6K7hYKcFaMddUAZwVwVkwQ9cBZ0RD6wFnxnPEPnBUtroWn46xA3oi0ALiWmIoUOWDMvWSIISqRNHQsnBWD3lP0aCvaxNDfhsiAlwV4WZ4X6oGX5dmvA+BlaTub2h8vi26Dl+XADFXjZbn/EnCzADcLcLMANwtws0yUm4Wdy81yyoR0KDyJKIuBWGF9kAlaVCuluZVaO5IEajcuaEv29SzeM7CvYF/BvoJ9BfsK9nWs9lWSpvxnP93cXe+SRkB9NojEFedoyGUKoD4D6jOgPhsxwIH6DKjPRovtDqnPkoOLcfQIkSgcMdFoQphO/q6UXMQirhwHuHvkPquvifb92alhu5m0gNUPWP2Gh2lg9QNWv3FAGVj9gNVvfKgGVr9WQA6sfsOBNLD6naWmgdVvaEAGVr/noJCB1e9c1wNY/Z5jtzyw+lVV38Dq9yzwDKx+wOo3MkwDq99ZDgmw+j07pAOrX5NCDLD6DQvNwOrX7j5UYPUbz9oAVr/uFgqw+o111QCrH7D6TRD1wOrXEPrA6vec8Q+sfi2uhadj9QPGs7bXBTCeAeMZrANgPGs909Qb4xlthZHl+8aRamQsxd8DDwvwsAAPC/CwAA/LNHlYpD6XhyVjPTqUm5UpUEqiCsQzZgzBODglkfIUYUPWCFtTnLEnozgDqwpWFawqWFWwqmBVR2ZVi36j5la1tN+/qm09/B4YVzCuYFzBuIJxnYxxLUoV5xrX4+ajQ8FxpATmjhusg5bJyDJv0soUgRhLbUFtsqYNpU1pQ9fh6q70Aryhgyj/cNZfAQh4Q2uXeIA3tJ0iJ/CGDhTgwBsKvKGjxXaHvKFArtjLnr6HkwC5IpArNnJDgFxxSFBunVwRYWGp58mTRo4mxwNHrRimNDkbhFs2mi0VPbJ21W+DfpBlmBiim4oLmEOBOXTQAAfm0FZADsyhw4E0MIeepaaBOXRoQAbm0OegkIE59FzXA5hDn+OuM2AOraq+gTn0WeAZmEOBOXRkmAbm0LMcEmAOfXZIB+bQJlVGYA4dFpqBObRdPgdgDh3P2gDm0O4WCjCHjnXVAHMoMIdOEPXAHNoQ+sAc+pzxD8yhLa4FYA4dz7oA5lBgDoV1AMyhrWeaemMOZa1Qsuw1KVcjYll/AVjOgIgFiFiAiAWIWICIpR4RS858dCg4h3RwTpgkKIQY0YFj6nk0jolkSKndkYfyJyMPBbsKdhXsKthVsKtgV8dmVzVvSnBWIW/09LRn6ZN/Tj6HmwwWZHGfU8aq/yzuVKjRGFCjDRPyQI0G1GijxXaH1GhAJtU6iQOQSfVPJgV8O61vMwO+HeDbeRKQA9/OcCDdMt/ORHji+wsSgSW+uZZumSUeSEnajhaBlKRinNgJKQlsa28bz7CtvRqcu9jWPhGKtP7QDBRp5/ohLVKkbdqHZSvtwycrQTWan3ZfhCYoaIKCJihogoImqIk2QalGTVAnzEiXpz3ytBIljowzJr13MXjkqY3FgcqWKbdthsLtNUOVbrAeQCNU9vzHiZAcYIR686uB5uBZ0RxMpQEKzoYcKNy7bIBiXFpLg3NaWMWVoTjFLNwkr1RZR8JIsI1Zj22uNehIqyin6RbdO5QkNAVCU+BgcQ9NgdAUOC5EQ1MgNAWOD9XQFNgKyKEpcDiQhqZAaAocGaShKbAdjxqaAoeGbGgKfB54hqbAanCGpsBngGZoChxMU6Bohf8smzKv0RC4+Rq0A0I7ILQDQjsgtANOtB1QNGoHzBqRLpsBKfVWM5lidqEks56zoGXkgTMTcTRbxlHUIjVahYPqBtAbmCVJm8hBkrhHaig4SrJVp/spj5KcSt8g6zGVAn2DA+kbhB4p6JGCHqlnDe7+nBpokYIWKWiRmiKqoUWqFZBDi9RwIA0tUsN2NqBFqrmWhhapYRfhoUWqapgILVLPAs/QIlUNztAi9QzQDC1Sg2mRUi3zpp0sCdVomNp9EVqmoGUKWqagZQpapibaMtWMQe2EGelQgFYbgYV3gUYktCYyGkZiTKqLWxMD27qdNN8zte9LXCzmhdO6eTeE/ieZa3/yXGJNOAneshgcsjwITZzDNqAoMBmJ46x5b54zzVV1D8AxMd+4jmigYtJjtAcVk54rJojZFCQwr4UPCDmCHIs0RKZFcgUpFYDgugg+pFPcTHJ1dzm72f746Wv6ypvZ8rbwCSaofc8RUbY3VFLhiQ2OGG+slslhMEIan7wo6q0Yi+vQX926Sj/Y+/l8m6X5Pt3yl8X87nZyeG4qrmxvqJQGO5P0cpBMK0kQQ9F6xLyQOOnukWD7Cat9FR/W9FB9tqCyHjNVAhlNhLGWukCcUNpL5W0kyWl2GvBctz5SbkwftzqmYH/9NBYpvrlchOXylVlMuJeuJbFlm0Yjx8py5bRUTgTJRUBa6qITiVuiobJdG+u1ElVr61o8lN1zfB+Wd1fT6+5vSWrbKmBx2aeKgEezKSUFvYcZavOCQp0O6nRQp6tRpysOViHVywKb60ty8rNtsuj6en5z+OnP5moZ7t8OoXpAc9UDrVJghB2xgVkZOA/GqEiEVxSzKNBYUgC4v+oB1xlpPcbQ9tV0HcrG8sp5khILp7gLniFpjbceM4ZYcAEpRpkfS52hR3jL3A6x81TkxADfgQRhH2mfhQrYR9rVPtJNuyQj9SKlc9bMo4Bq84wPvrQfXzGIryC+gvhqcH2Qpcul3uLusr1PM6mQ1QZ5FLCjyipMIvImBVfJ+uodpVeN9rSK6i7J6mMSbCFfMysCRQhJB+WwYAoh6UC9l05DUoWxQwwpzmyKQC1mGplkVCiXQmFvxnKULdW9wVvl2ggaa8uJYb9bYUKgCoHqoODeKFAtNhV0EKgeWz4Qs0LMCjErxKzDiFkLM9FuyFoQBqyC/+1mULEqh1i1zy5TCFWHE6oyjx0OklrKGdYqvTHcS02k95ZTP5aeUyb7C1VLqVMaa8mJgb4jKcKGRdiwOCCUt7xh0UUUmGE8SM2lEchjxjUTRjrho5OwYbG2q1KaOsg8nzR/+mpSQ6/M5eTQ3FBakDiExOGg8Nysw0V0kTh87NNAxhAyhpAxhIzhQDKGuqOM4V/nK0gaTthfgaThgJKGwSnrnSYWYa4wUgYjWxw0Z7gnmIWxEC/0mTRkbaW7DhXlxHDfnSAhdQipwwEBHVKHw0YwpA4hdThOZEPqsOvUoe4wdfjQrYHsIWQPIXsI2cOBZA9x29nDj4s7YGoZmquCIW04VL+l07QhlZF76ikVPBKZlCYnUjDvnYlGG8rGAu8emVpyTI1naciJ4b19AUIoCqHooCDeLBStcKxdwyUDISiEoBCCQgg6jBBUoiYh6PbV9uwCiDaH4I0AL+hgXZNum1TSqo4IS0EiozYE6Q1DmnESqZTWj4VhnuH+4J3TWqeU4dSg3URWEENCDDkoNDeKIYs7aBZD7q8OCBchXIRwEcLFYYSLuJglFy++NTeXd8mw/Wpu/FWS2sWX26N6bv+Q7cNf/ra8WMy+JkFBNXNgngqQfA7Wbek0vrTKEu+IJ8EyxKO0hsaImfQOYU8lxJe14b2mSO5Ne05sLfQrXIhgIYIdFPwbRbCiwrl+3a0miHgh4oWIFyLegUS85ESFtE1FOE/CWQUPMe/AfBuIeQfr6HQb82Kkk4Hx3DuGDDM8BbzcWRKN1S7GscC715j3UG11qz8nthr6Fi/EvRD3DmoBNIp7ZYXKbZfrCSJfiHwh8oXIdyCRL5a9Rb539mrmIOwdmGsDYe9g/ZxOw15OjNBBRi0wd4YLHzCPmhorVEyadSzw7jXsPRRXh8pzYkuhV9lCwAsB76DQ36zQK3sNeB8uJoh2IdqFaBei3aFEuyeo3NvSg/81W87s7CoJA+LdgXk2EO8O1s3plqjJJaVtJEmawRpOJdEcY6QpIoSzAFtnz4l3D3nJO1WfE1sMPUsXYl6IeQeF/2YxbwW24Q6XE0S9EPVC1AtR71Ci3hMUxDU04buw+jL3sJH3ufg0EO0O1sHpNtoVBimFqVMGK4oUUREJrEVwxCuu9Ujg3WO0qw9ZdTvRmhNbA/0IFWJbiG0HBftmsW0F+uIOlhHEtBDTQkwLMe1QYlraQ0wLW3WH6c1AVDtY16bTqJYhr5hGkWoimJTUCO2M5Mm4cGliHM0Z3T1GtaqLAGzyW3T7EitEthDZDgr4zSJb2lNkC3tyIbaF2BZi26HGtu2xUR3VgbAZd4jODAS2g/Vsug1sHYrEUCm8V8IQ5ohzRAmZXCIbEVcjgXefgW0DjqTKSnNiS6AXmUJICyHtoFDfLKRtl22q4iqCeBbiWYhnIZ4dSDxLSMfx7O83V99+XsyvX98tFukmd9s1ILYdkleD+3NrILYdUGwriOIieuSZwQQTTaI3LtKkR4nWCo+lFbnHI5kxOnRJu9agE1sP/QsYol6Iege1BJpxLJMeot7sioIIGCJgiIAhAh5IBIy7joCBcGqwfg3UdAfr5HQa9yqriSFEKcW0U8Qkq2ssY0mB8uBoGEvc22dNt/WoDIimepMqRLgQ4Q4K983qun1EuMAsBXEtxLUQ1w44rm1vF+7Fohjo0d0Ct9Rg3RkIbAfr23Qa2BIRkFfYGMKIMBRLHyTFybIoiZCEwPaMwLbBdtE6enNiq6AvsUJoC6HtoIA/pF241RcSxLYQ20JsC7HtUGJb3ktsCxxTw/RoILodrHvTaXTrhDE6Bom1Rsp4z4MOLLrIGaWSczkSePd6TtChuelMdU5sIfQoWYhxIcYdFPabxbi8txgXuKYgyoUoF6LcoUa57XUmZ7QgsE0N0aGBEHew3k2nIa4mUQhFGAnWMa9UCEYGRbgVgkhnxgLvZ9KZXENtTmwR9CRVCG0htB0U7ofUmVx5HUFcC3EtxLUQ1w4kriWs87gWWKeegWcDrFODdXM6jXGtRl46L4m2zHmBXAK5i4Lp6CJFMY4F3n2yTh0+r+516MRWxFOIGKJfiH4HtQiaMU+xXqJf4J6CSBgiYYiEn0MkjLuPhIF9arC+DdR4B+vodBr/xoBE5MnARql0oRtkIAgL7LRUyhkxEnj3WePtIDYD/qke5QqRLkS6g0J+szpvP5EucFBBfAvxLcS3g41v5Ynwtq5T/fRhK4Gw9QWBsu1QvZZud9+CHw5++LPyw0kFP7zeCgH/Gvxr8K/Bvx6Gf42LWRokGrb68+K7L/1dZR/RdKDaQLWBahu0aqskl8PV3ClegmU+RQqKYKIktp44LjXFxksUCN/qMtSKLlu3+2xegwYDDQYaDDRYfxpMtqHBfrq5uwYFBgoMFBgosJ4VGG62P3mrwO6TZaDFQIuBFgMt9iwDyY8LM1uBBgMNBhoMNFjPGoyhNjTYhzu7nxRLslyuzM3q4TvQcKDhQMOBhus70pRnb3yrrd0elDWH0EQoc02EhCDEPUIY+QQtRxA1URLpjWYuaD+WMw4wYn/pjx3jUF4dwmti/Vm9yjbXnciNTGZaRcSSvhHUeqyD0URFhx0jUo1m3aDe1g2vIK5XZrkda8KL4HxBZamAg2SGceENDZEE49IrkkBNrBRWx7EgmvSE579ODZWFj/Xbqvj1fPHy8nIRLtNF5CGHtfKCEySkQkwQm5z9gBn3iilGBRmL89EX5DZthud0sLyd/bEdf3LKtA2RZXffcxeJtwLzoIWnRhAfonScURm8cgYwXtdNwFUe2Jfb7dsPYbVKYy8nB+yz5ZRDM+VaMCIs9tL4pLux1cgiKYSMyUswFtBcE82yxsHkuzmN+xI2/5r0vV079befjUumd3oavAsR5taAipIFZy1mGAUUIlZGBuO5MtwGafhI1oDobQ3oGkcX1i82TG49dC3O3XY33kr7zpnZGSghQQkJSkhQQuqrhKRVexWkd2H1Ze4/vfl2Y65nbvNup1yfvlykcuWiwLi0lgbntLAquTxJTMFzk0CkrCNhJL4PUf2Vi9Thcz0DSvsYmu7m/Q4lCUQVxX6T3tYEUFV0RlWRycYzaaKmXMik3KVkFBlvEMEhBI28GUumkqP+sjuKNtdIpW7CxLDemRyzBVGMjEzhg9I60qTNLbJIhWBVsMk/FGMpiPbn6bBSDzbFE3F2ebcd7cG7yeH8DAllNTr2mEVkiPE6hXuGqsidxDw5JYFJNZZMZY+1pxrFws2PX8NVGmtyQD5fUNAv0GPmHfoFaiO7634BITTxkionKDUuaodVQJ4yTKTAWI7FC++xwirazQpMDvHtCzCH/yClwc4Q5IJkWkmCGIrWI+aFxMyOJsM4qLba9/P5trwHbbVnCGpXEaW03Yro8cgVyp9Q/oTyJ5Q/+yp/YkRbr3/u6bPB7ZnLFkEtiZ7QJDUlkWDSCJVcFmYUxTG912NJqySF2l+ivH4PXw08TcyR6VaYsCsOdsUNEfWwK+4ZhKOwKw52xfWeAYEs9+Cy3BPZFdefAw274ip6CbAr7hlobNgV9+x2xU2lMxz6wp/dUniivvCJVPL783Ggkj/ASv628tkKCXLlLCSUP6H8CeVPKH/2Vv4komv9Bi0doNNAp4FO60+n0ZZp3y8WRQ/F3gvQa6DXQK+BXnuCcxHbalUr12mDa1fLUrxjEriORCFkBedKhmiUJpiriIxTdizVCYz7y83qJizklTA1scxU9wKFtjVoWxsi8qFt7RlU46BtDdrWeoYctK1B29r4S7rQtlbRS4C2tWegsaFt7dm1rRmrGU3esUjxn2E6Jmc5aM64dppz5NhI1kB/lDKqCfv4kRLC5FZBN0LcNeuwlonbK+RfoAgERSAoAkERqL8iUAUdV5HfBXQX6C7QXaC7+tJdRRIrV78uUVubH3v7Ep6+JE1zJempUObz/nIPQJn/BJT5E6EI7xHFQBHeL0U40G0+QeMD0G02EtQ2j6XlWSHegYKH6A6iO4juILrrK7pTuEJ0dy+ji2TEivu9WMxdWC7ni3Uv2KNPBx/wKSoYYlHrAivCKJyCPq6sS45GxGw0ZTbcX51NHnYEnALOo0+mGwe2Krucd+09S6oyRqZ4IEV3MUkWlqf/OeQiHw1TLNW9wV4cUhicqS8nhvi2xAbJEEiGDAjWZyVDNk0QO6/yZPRYd5HsAkr82e3PvB9QUggoIaAcZkB5FLUdygVzg6x1RCHLtUJCsiQPapxgGjHB7bakj6uW9O8F9TFd+aeft4rr05uF+TP92d11uoH1zb0LN3ewWmG1wmrtYrXy9lZr2FLkFCKBBQsLFhZsFwuWNVuw6feFn752iF8Vj90t0leXsF5hvcJ67WK9VjhsML9eV4f29W+LK1iusFxhuXawXJFutlyLRNvF1d3lrCjGrW8DliosVViqXVjWCmTWuaV6sZjdPGpberl8O1vCmoU1C2t2mNHr6kFuuIhiwR2G9QrrtSN3uHb59eF6LWSU1uzWFYYsE6xTWKdDWqfra/300vviGtK1L+bXb0ME/xfWKazTDtapPjO7tFmmP8/+8WG1+DD7nwDrE9YnrM/B2dGLRbg1i/BhfrdwAbogYJ3COu3Ijp6Z+t0s0/+8m6cbDisDyxOWJyzPLszomV2Fm/X5PlzPvxb2M7xamD8CZI1gmcIy7WSZ4ibLNMWiH7/dho9zKMDAEoUlOkBHN8Wjl++KC4HlCcsTlmcHy7NRuui3dLNzD8lcWJywODtpNqrMPLZu2F2/3r7cbRff7if/dXV9tXm7+T0sWViysGSfcrfMySULyxWWKyzXbpdrIZRTq3Xzo9hyWnCuHAL9niQGFt5GpOzEqej74rw/OevpWQV59mRzblTkyCJuiPCUScGUkTji4JnyYTSsgqw/WkF6KK5SXEyMZqqaULKH40aFDeaSRB6w4x5jETnRVBOS4GrGcuBBfweHkkP9s/9IJgfQE9IA1j5g7RsQWls+wkAwbGkUKgjHg0yKVhHJhMLYKi2Tww0IrongR4cNlzyf9yHuNrbezja/mhyOz5YTHMgBB3IMEM5ND+QQFdLiJZ4zBO8ng/dzt3ecJA85zIiZFwQkD/nK0nxlG6yOedIp+nmx/VoJMCGRDsB8ykS6Pp5Iz+C2Q8lEhVjyFa0giAqkJDYSEew5cS5S73emo2qtOhN/wfqE9Qnrs5v1KWmd86DupXRgRP97YW7TIEOo2LBcxSZSrb1RQshg01oJlDhvHUvrSGkquR5JdKtQf+GtqrasjgFmakFuQ3FlE5G+ONTMe2IpURQji72OjkmNAtKBu5GAu78iz4lzug4f1seFuVnG+eLa2N34cMZZK7LLoZ4bGYikBMuk0IlVhkYXPYmKIka18SNB/ZOn3437Ej69nTtztffyd/v3NNf6g8kh/Gw55dBsFUIKO2KMikohzGNgUSOiFI2BKANobleHb4ZIvzr+CejwVmR3f/BZhd66Wk4RZAcgOwDZgW6yA4q1mB3Yj94HkCiQuUSBV9IgSSUW1CQEqRgDtogH72MhobHYYdZfokDoJpHvcsKF8RYll3M9qWZS8GgDNdxbRY1yMWISnWWYOjOW9EGPgVQ1m7L7YPt+cvA+V0yQFICkwPDA3EVSQDJjBacq4kCx5QZ5g5gqMr2Iaeahw7Q2mvPH0e8dH7j/+tdwNcmSRSNh5XCNmE0hKvNa+ICQI8ixSENkWggnKRWA65q4ZqWParePeP3jp6/pK29my9siQJwgms8RUXb/Ck0K2DjmFaVW4ygxljF6SQr/2YexVJSf2tM41gY83eTs2XLKoXki/RE9ohnaI/ptj9gUGUhtAsjqWRSoN0C9AeoN3dQbBD+n3vAoNfT0xQWaKy5MJNMqeuxChFTrU6VaHQ9UB2KwxoQHlxa2IJ5zlRY5w47ikYC5x44VWtc07H73/aPphkUtSw+CpR77bSFYepJgCZFzg6UDQwGREURGEBl1ExlhVJlB9FQKEJYpLFNYph0tU1KZm/uMZYrw5y/zPz/ON/7Gx510SpYvg+ULyxeWb63lO3tBu5dMEZ9WkEzVld6hxLgMwvuoAvKecYU0JRYzEo23niLEtwqPsu73c4DeA70Heg/03pD0HqtNRdWoxAwqEFQgqEBQgUNSgaT2KXHVE8eg70Dfgb4DfTckfUcb0uBWZh8F5QfKD5QfKL8BKT8h8p2Zb83N5V1xoqi58VdJfhdfbov/tm8/hNVqdnPfvzBc3ofIXSTeCsyDFp4WvWwhSscZlcErNxbeB0zIX55sQ09VqEytnedcOWW7MyMKzDAepObSCOQx45oJI53w0UnYYlkbzbLm4UFp/vTVpK9fmQkeUdNMWkDx8OQbL4HioReKB60IYjjhODArA+ehIIAkwiuKWRSIjATNqj80l5ImbSfZONBJ8fjZTgVtXk23b76xvLIEJsg6KzHTOtgUiaHoAhGWWIOxo9GMxavuT1eLUmEdpJ3WD+3T67vlan69eTNpFrUWRJYlM/FUyKCVZk6LpLsl8dg6qoJkliICJD21MZ7nnXmYWt0+su3bSeO8JbHlD+1lyFFb5F95kXBj1CKCGWWRU6M57Plrec/fZog3OablKUO+ZendM1VXKPdUy9HsSjzk8+365n9c7B/L+uPtl9uS0g6H0g6Udp6wtHNcGvs47k0uzDmrOS+cKsUIl14ELqwVTkbKJNV9FXYEriSX/fXdo5S8cpY5JDiV3hrnDXIcJVmlaIsEFcVaSqwHKfHaUirTgh1KSguMJEc6Io+cjdQooTAiSeUIi5IG2tX8KxxXUGoEHlq5K7Ncvp39sbVoYA/AHoA9AHsA9uDZ2QNcdRt2psgF6h/UP6h/UP+g/p+f+q/aAlx5ez8YATACYATACIAReDZGoCBea54T+nBn97NDSbrLlblZPXwH+SKwFWArwFaArXimtgJVPYngnIABSPtA5YPKb6Lyqy7Rs/s8YInCEoUl2nSJ4goU1W1U4WG1wmqF1dpwteqqzGj1SqSwNmFtwtpsaklZK/1szXKXsJJhJcNKbhy2Vu1EOoeN6vEiJbBIYZGWLtLC5atQETsinSwJOMAQYFgDhhjVZug7gcPHpMwASYBkHc1Ywd8ul045Ry7AD+BXRyNWPgm9QjIGGEoBns8uuAOG0okwlBaThC2faLr8q++Mn0QVciAJCdvbk5/nd6vbu9XP80WafF9brTlD0zXdvyaHrKSbHwUXwXyxNb/LNZ1p2KS7bnbMCPkvpu/wQlz33uXue4+YUddkBITdXzz/nIS8nF+FY9e9Jjhl7BF41l9KP6+vzY3/tL2WsH2fu5X6Y9W4uzT8Y0K1h8N/CIuvla6z3kC1LpIfcky8/O1++N3tv09L4t39EqlwwQ0GrSfhzDwvvU8fvrqauz+WVWRcd6h6F/qYhezhE3zgl1S53PMGrHXR5NjyeHl7m9UQ2e/Vk1spd3LGpcvKrP5gdbXZd1XMPt9e3V3Obj58WyZTdBDX3Ku0pEzTG1nKvHix/v769fblW7NcXayJfK6vZ6tkiB5/krv/Vqep9RhFKV3q45mLOQozXtRmijrN6vpq83bz+9zNtTZFvRsrZeg5OWvlm2pj+Ho3VMqydXLG98tV5XtqaYZat6UOJy0tBT66hldmGdJvPqzurE1/9PDt6VvtctZat68POcvOupD0cpdNnC8qC6H7uZ8ACenl325mq56RUD5rvdtXZ11IUvy382Wa07g/0h8vd1dUXQCdzltPxR2Gn9Uu5Y25+8f6n6xyazx2rVvB6Lz5ftrxxCU4xVnwF1fGhfJPTz/aHi+iXmRzCLl9Q/PT13QXu+aPVyEWl5XezG4uLxZzF5bLbHjTcOR6cC3nm9yf7D518jKusxPFuzTf92EygG1h9Hq3k3NCDybcSG+doEkTpr8v8kDZu2k+eHt+bXa+e5ifvKW2pmjPry2d9R4X2wnzqGtj+L5uqNIyamP4WjeUDeYOZvz9ZpPkPFILPjtmrDtNvSdWfmzSkZl/CaukXotDCe4zuW9mi/wza2eCek/tcWokP+dusguz+vLq2/t19vdr8eXig+yDa3mmzpT8evJCX70Py/ndwoVNHr8dJX9k8Ho3c9ra781XMAbfa97NH73e1A6y99TaHPXgeJhFzHhum6vYTFss9S/B/fHbcvP+tbl5FTZcyVlMdjFdZ9HfA0du7fsUUxZ+3PdB9+mV24n+6s5a7/YrHcVVciG/37z0ft0EvXkCH+cV77ybCevlkEvLjbss0/rH3nEfmfRxrXHqZI7b1THrkln5sSdHOmaL8TbDLCvoqsZD10yqM3WfVN8v3/LPRUL9gOh/P88u9kue6zx7paMydlf+ZmH+3Hky62rAu3BzVz+Uqjd6Cx5ShQl3jtlJS9vOBPWi9nLrfopEIAvYc4esd+F1zqcoQpjkmWyXRD7Z0GjceoAq9RmPttlv6rhFcv5V0TThFumreY+7lfG7vKXVgzVZTP23xVWLt3Rk/BZC2VqbIeqHsjWHr7dyKpyo8n19VnM8zh+z3qWPw8wec0COzHaxmN08ktzL5dvZ8owg55w56gU5VUoPx4zabJmC4m9rR/Tl7exdWH2Z+6yO62K2Zk+yzgUkG76e/Z3Jdni0N0f7t/ZwjdeO1dqbo/1I/LgS3gh0g5dXc5+WjM+6RJ1M151hfujlV3L62hm/ZhTXSnyxjt9GZuSbOfZriTynVrDWnh9dx/J5u3lip1f9Qmb1keut+LxDU33DWhbY7U1SzxGs1tN+sPcp+2zOHLHmqmzge28STc8zXm/Zm3jWoihybKI0x8b2c2ybY2OPdbKutyJUylVszqJ96X2xNeJm9fNifv02xPxaaDRuvWxxlbBrM9XPs398WC0+zP4nnzY+b8B6F11dPr9d316dcA7PGa3e5VYJBDcTXCzC5btiH032gs8ar/3s3v0Ut2YRPlQqZjYbtyup/+fdfBWuw8q0JPW98epJvUoCejPF+3A9/1qIJbxamD/y3RqNhm0hm106U1r5H7/dho/zE6772UO24a5XuvJRBjDbQmKJkSSf7ff09LG9a6SCedzLcu+//jVcnXLjG4077RLBzhOsvkH0fmfpf5nFzKQrPeoTbR76IVIP3cyD99X8wvMHhYwb+P+PV0C5/39qBRReyOzm8hj+19mLie39erYWboS1UsjDQR7uWeThti2z1TVwXKRpUhyb9H3W+XhGSfORtWdBOegE4As6n0My0m2P9twVXCLHQil+XCBbx+jD/jCf3swW6YLmizT1g1+csZ+j3vAtGN/SGYsmr99WG8KV6nfUyvj1atq52sLDKd8Hd7dYFvsNznhY7c7TgsoqnfpDcpSvQiHb6s+shdHr3U4u3DiYcP9dtYp888HrJmzYYxWTP4GshCjpyGbPkxWy5S+L+V22i6bpyHU9DHpKGuk7xX8fF2a2er//mwNS84MER/04ej3D5nUtAdUcudlSrn3uSq2lfMboNRO4jR8LLU1qVDsxqlZSo+qQ032ez8qTb034AEAA4LlUXKIkvCi1dvfuRXWLd4bs72fp5Mk+Gn26QD3vfkoeDyifwTzT56V8wPoBAJ/c+pGK1u+nm7vrGqHeYaHttNiLCSpEes0Gni4y/9XCQwFFM5jH+bwUDVg6AOCTW7qqWc3d977nUY9VTjcVN+h8mkbnU1X8rFdVp1nxPbqblrPiD0aernI7Lyt+8FjAWA3meT4vYwXeEgDwqb0lietYu4vF/DYsVt+OWr1HXpOqRAV95Mjt3XT3L04/727mq7equ7rnZ7frfdtbWh1fGwaJ6uiSlXgUj0h6M9n2x2lktT9XPVR1ca/PEVH1NFZx0tDK3BzvXnmEKd1k9T6Y8+G70wjreuZ6eOtJDs8IfYCN7726qGwRlpyI+nBt0VyD25ZNe/MuJ4s6o9QMBs9PWzw7VQrRB0QfTwxAMDFgYo6amELQhyZmc8UbloE0vJ8dZu0f7LDfhAjlW0E3t3Ew0qfiOMP5zeGnP5urZbh/m40R2p+sFngeHap1xvyzq/Ax/GPNGGw27KGn77vbeeuJIGfCq13KeptB8L/dVLv3biasd9O5vTy1ruGv81XV++5szlq3/igsrn8ZHxd3FZd363PVutVylpqj029fnd510mTYWjeA0SmWij0T82jmfZty+MvflheL2df1sdEVnmO/11FTRIdPo81Lmyd7mhZcRSH1eyU1xVTDs657cXf2auYqyqjHy6gpoEP13NaV/ddsObOzq1mxAa2SiHq9kHq+do2U6uHsm1RqMz3Uz/z1RFKjHF79kuronb6uoJ5YGujCoxdVXc/0Mn1N/VKjybTaJf1+c/Wt4Oh8fbdYpPvfrf0qKqbva6mHndavrqYK7ukCetMzu8poQ+Xb0xXUXFY1kjB1rqqe59fbRfS2kDKXVUMN93MBNRFT6QzFehfVQBX3fzX1MNTB9dVVx31dQr3kQik/16ksQLXO3aZDt1Cc3FzSg1Txg+okG3WL92i6j6e632zIu8VHQvcChbf6mbXaV1NZTfZ6GfVqLTVyx48ubNuH9+ZbmmHmqrYedjZls+JiswbEylDodt5mxaax9ptOsHE76eEmKqf8EiqDvPu569n053sCK8v1YNy7bqvD/r2j/T7nDFevDQp2X8JuPGhHfPp2RODNAOw9o15soCgDALao/IAdFsAHGwGGIhTIR97vpu4u3/YM92x1nYQrjx+fhxKHTdLAQPDYtPSQ1Hvmi2bCR76fmSx8duvgYVcE/uz2hzq6ZVuvmyLyZ8nujlBMK8SF5XK++PTKLMOjT7POcUszNPP3n/PZYmnCUvxUmHB3Ytepc8lbmqDeTY3tbOHRndt2rLnryIxv58ZvjlYtgoJVmrh+31iNoes9mSqn1+9mu1jMbh7Zw5cpXF9m76i9ObpcR8M/x/XkCecPpyz2Fqdpt7jIu1yNxm3/FtbdkZ9eev9b+vhmVbTBvg0xv2wajVsvy1RlhW6m+nn2jw+rxYfZ/+SrrecN2JXcLxbh1ix2J+idsJDNxq0n9yp6ZDPVf97NV+E6rExW7GeNV0/qVfyHzRTvw/X8ayGWZGfNHyG/XpsMW+8GSiOS0pkSLj9+uw0f5yf05tlDdgWWhMvLd2blvrQElr3x6l1y9aX02/Xt1dznlcoZo9Wzr9M60f7krJVvqo3hG9ZZzwr7RnkEc2t3tCkENjzBvkZXeM2R662A9o6tzzzq9iapZ9LOPMk+82zOHLFmwvJ8UzzKlfuvzR//+P6nl2/e/XSUD6t4TQ79pc2PzdneuZs68cVauKOHSnh/rJ9NcQx3tkBZ7ft186PfT8iinxfbh1VCaklaRBBoStCUT6Apx0loug3tH69hhD9/mf/5cf46LeZV+BiSj59+Lo+t7SnJDDQZaLLnoMm2aYzTvO+P1/QamUB1DB2OT9teOymjAv2c0M95VJGT+0aUx8q6zfAcXBJwSbp0Sf61+XjTSvX5i1l+2eUmAlOceYVdNN4zHKWnEXPrcfSak4DXf5e+OivU/I25+uyM+5Is+uflt+UqXH/+mqS5FuPsBfnLv/5/OmAi4Q== \ No newline at end of file diff --git a/docs/tech/02_parser/classes/ClassConstantEntity.md b/docs/tech/02_parser/classes/ClassConstantEntity.md index 538e25f0..08afe7a6 100644 --- a/docs/tech/02_parser/classes/ClassConstantEntity.md +++ b/docs/tech/02_parser/classes/ClassConstantEntity.md @@ -348,7 +348,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- @@ -381,7 +381,7 @@ Constant short name ***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::getName()](/docs/tech/02_parser/classes/ClassConstantEntity_2.md#mgetname) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::getName()](ClassConstantEntity_2.md#mgetname) --- diff --git a/docs/tech/02_parser/classes/ClassConstantEntity_2.md b/docs/tech/02_parser/classes/ClassConstantEntity_2.md index 71578adb..4301ad87 100644 --- a/docs/tech/02_parser/classes/ClassConstantEntity_2.md +++ b/docs/tech/02_parser/classes/ClassConstantEntity_2.md @@ -347,7 +347,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- @@ -380,7 +380,7 @@ Constant short name ***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::getName()](/docs/tech/02_parser/classes/ClassConstantEntity_2.md#mgetname) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::getName()](ClassConstantEntity_2.md#mgetname) --- diff --git a/docs/tech/02_parser/classes/ClassEntity.md b/docs/tech/02_parser/classes/ClassEntity.md index d7631fd0..456262d1 100644 --- a/docs/tech/02_parser/classes/ClassEntity.md +++ b/docs/tech/02_parser/classes/ClassEntity.md @@ -253,7 +253,7 @@ Get a collection of constant entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -286,8 +286,8 @@ Get all constants that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetconstantentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](ClassLikeEntity.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -576,7 +576,7 @@ Get a collection of method entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -591,8 +591,8 @@ Get all methods that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetmethodentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](ClassLikeEntity.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -732,8 +732,8 @@ Get all properties that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetpropertyentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](ClassLikeEntity.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -804,7 +804,7 @@ Get a collection of property entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -819,7 +819,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/classes/ClassLikeEntity.md b/docs/tech/02_parser/classes/ClassLikeEntity.md index 99f06afc..c368148b 100644 --- a/docs/tech/02_parser/classes/ClassLikeEntity.md +++ b/docs/tech/02_parser/classes/ClassLikeEntity.md @@ -235,7 +235,7 @@ Get a collection of constant entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -264,8 +264,8 @@ Get all constants that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetconstantentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](ClassLikeEntity.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -530,7 +530,7 @@ Get a collection of method entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -543,8 +543,8 @@ Get all methods that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetmethodentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](ClassLikeEntity.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -670,8 +670,8 @@ Get all properties that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetpropertyentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](ClassLikeEntity.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -734,7 +734,7 @@ Get a collection of property entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -747,7 +747,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/classes/DynamicMethodEntity.md b/docs/tech/02_parser/classes/DynamicMethodEntity.md index db67d050..76baa2d3 100644 --- a/docs/tech/02_parser/classes/DynamicMethodEntity.md +++ b/docs/tech/02_parser/classes/DynamicMethodEntity.md @@ -219,7 +219,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/classes/EntityInterface.md b/docs/tech/02_parser/classes/EntityInterface.md index bdaa85e3..98373367 100644 --- a/docs/tech/02_parser/classes/EntityInterface.md +++ b/docs/tech/02_parser/classes/EntityInterface.md @@ -66,7 +66,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/classes/EnumEntity.md b/docs/tech/02_parser/classes/EnumEntity.md index 392f4de4..00ba0591 100644 --- a/docs/tech/02_parser/classes/EnumEntity.md +++ b/docs/tech/02_parser/classes/EnumEntity.md @@ -265,7 +265,7 @@ Get a collection of constant entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -298,8 +298,8 @@ Get all constants that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetconstantentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](ClassLikeEntity.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -612,7 +612,7 @@ Get a collection of method entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -627,8 +627,8 @@ Get all methods that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetmethodentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](ClassLikeEntity.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -774,8 +774,8 @@ Get all properties that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetpropertyentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](ClassLikeEntity.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -846,7 +846,7 @@ Get a collection of property entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -861,7 +861,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/classes/InterfaceEntity.md b/docs/tech/02_parser/classes/InterfaceEntity.md index b76fa59d..4e4dfa14 100644 --- a/docs/tech/02_parser/classes/InterfaceEntity.md +++ b/docs/tech/02_parser/classes/InterfaceEntity.md @@ -252,7 +252,7 @@ Get a collection of constant entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -285,8 +285,8 @@ Get all constants that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetconstantentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](ClassLikeEntity.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -575,7 +575,7 @@ Get a collection of method entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -590,8 +590,8 @@ Get all methods that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetmethodentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](ClassLikeEntity.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -737,8 +737,8 @@ Get all properties that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetpropertyentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](ClassLikeEntity.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -809,7 +809,7 @@ Get a collection of property entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -824,7 +824,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/classes/MethodEntitiesCollection.md b/docs/tech/02_parser/classes/MethodEntitiesCollection.md index 044ecdc4..cf745920 100644 --- a/docs/tech/02_parser/classes/MethodEntitiesCollection.md +++ b/docs/tech/02_parser/classes/MethodEntitiesCollection.md @@ -153,7 +153,7 @@ Load method entities into the collection according to the project configuration ***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- diff --git a/docs/tech/02_parser/classes/MethodEntity.md b/docs/tech/02_parser/classes/MethodEntity.md index 88557582..1ecce588 100644 --- a/docs/tech/02_parser/classes/MethodEntity.md +++ b/docs/tech/02_parser/classes/MethodEntity.md @@ -406,7 +406,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/classes/PhpEntitiesCollection.md b/docs/tech/02_parser/classes/PhpEntitiesCollection.md index cbe197f4..29398213 100644 --- a/docs/tech/02_parser/classes/PhpEntitiesCollection.md +++ b/docs/tech/02_parser/classes/PhpEntitiesCollection.md @@ -257,7 +257,7 @@ $withAddClassEntityToCollectionEvent | [bool](https://www.php.net/manual/en/lang ***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) ***Links:*** -- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](/docs/tech/02_parser/classes/RootEntityInterface.md#misentitydatacanbeloaded) +- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](RootEntityInterface.md#misentitydatacanbeloaded) --- diff --git a/docs/tech/02_parser/classes/PhpHandlerSettings.md b/docs/tech/02_parser/classes/PhpHandlerSettings.md index 4b932fc7..400be619 100644 --- a/docs/tech/02_parser/classes/PhpHandlerSettings.md +++ b/docs/tech/02_parser/classes/PhpHandlerSettings.md @@ -19,6 +19,7 @@ final class PhpHandlerSettings 1. [__construct](#m-construct) ## Methods +1. [changePropRefsInternalLinksMode](#mchangeproprefsinternallinksmode) 1. [getClassConstantEntityFilter](#mgetclassconstantentityfilter) 1. [getClassEntityFilter](#mgetclassentityfilter) 1. [getComposerConfigFile](#mgetcomposerconfigfile) @@ -28,6 +29,7 @@ final class PhpHandlerSettings 1. [getEntityDocRenderersCollection](#mgetentitydocrendererscollection) 1. [getFileSourceBaseUrl](#mgetfilesourcebaseurl) 1. [getMethodEntityFilter](#mgetmethodentityfilter) +1. [getPropRefsInternalLinksMode](#mgetproprefsinternallinksmode) - If `true` - parameters and properties in class documents refer to generated documents and not to external sources 1. [getPropertyEntityFilter](#mgetpropertyentityfilter) 1. [getPsr4Map](#mgetpsr4map) 1. [getUseComposerAutoload](#mgetusecomposerautoload) @@ -48,6 +50,21 @@ $localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https --- +# `changePropRefsInternalLinksMode` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L175) +```php +public function changePropRefsInternalLinksMode(bool $propRefsInternalLinksMode): void; +``` + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$propRefsInternalLinksMode | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | + +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) + +--- + # `getClassConstantEntityFilter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L63) ```php public function getClassConstantEntityFilter(): \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface; @@ -66,7 +83,7 @@ public function getClassEntityFilter(): \BumbleDocGen\Core\Parser\FilterConditio --- -# `getComposerConfigFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L176) +# `getComposerConfigFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L199) ```php public function getComposerConfigFile(): null|string; ``` @@ -75,7 +92,7 @@ public function getComposerConfigFile(): null|string; --- -# `getComposerVendorDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L193) +# `getComposerVendorDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L216) ```php public function getComposerVendorDir(): null|string; ``` @@ -84,7 +101,7 @@ public function getComposerVendorDir(): null|string; --- -# `getCustomTwigFilters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L250) +# `getCustomTwigFilters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L273) ```php public function getCustomTwigFilters(): \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection; ``` @@ -93,7 +110,7 @@ public function getCustomTwigFilters(): \BumbleDocGen\Core\Renderer\Twig\Filter\ --- -# `getCustomTwigFunctions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L227) +# `getCustomTwigFunctions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L250) ```php public function getCustomTwigFunctions(): \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection; ``` @@ -129,6 +146,16 @@ public function getMethodEntityFilter(): \BumbleDocGen\Core\Parser\FilterConditi --- +# `getPropRefsInternalLinksMode` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L162) +```php +public function getPropRefsInternalLinksMode(): bool; +``` +If `true` - parameters and properties in class documents refer to generated documents and not to external sources + +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) + +--- + # `getPropertyEntityFilter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L103) ```php public function getPropertyEntityFilter(): \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface; @@ -138,7 +165,7 @@ public function getPropertyEntityFilter(): \BumbleDocGen\Core\Parser\FilterCondi --- -# `getPsr4Map` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L209) +# `getPsr4Map` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L232) ```php public function getPsr4Map(): array; ``` @@ -147,7 +174,7 @@ public function getPsr4Map(): array; --- -# `getUseComposerAutoload` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L160) +# `getUseComposerAutoload` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L183) ```php public function getUseComposerAutoload(): bool; ``` diff --git a/docs/tech/02_parser/classes/PropertyEntitiesCollection.md b/docs/tech/02_parser/classes/PropertyEntitiesCollection.md index a200eaa0..5fbe018c 100644 --- a/docs/tech/02_parser/classes/PropertyEntitiesCollection.md +++ b/docs/tech/02_parser/classes/PropertyEntitiesCollection.md @@ -129,7 +129,7 @@ Load property entities into the collection according to the project configuratio ***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- diff --git a/docs/tech/02_parser/classes/PropertyEntity.md b/docs/tech/02_parser/classes/PropertyEntity.md index ae916554..b2ca8024 100644 --- a/docs/tech/02_parser/classes/PropertyEntity.md +++ b/docs/tech/02_parser/classes/PropertyEntity.md @@ -358,7 +358,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/classes/RootEntityCollection.md b/docs/tech/02_parser/classes/RootEntityCollection.md index 1eb28dc3..abbc8612 100644 --- a/docs/tech/02_parser/classes/RootEntityCollection.md +++ b/docs/tech/02_parser/classes/RootEntityCollection.md @@ -122,7 +122,7 @@ $withAddClassEntityToCollectionEvent | [bool](https://www.php.net/manual/en/lang ***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) ***Links:*** -- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](/docs/tech/02_parser/classes/RootEntityInterface.md#misentitydatacanbeloaded) +- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](RootEntityInterface.md#misentitydatacanbeloaded) --- diff --git a/docs/tech/02_parser/classes/RootEntityInterface.md b/docs/tech/02_parser/classes/RootEntityInterface.md index 6e23542a..e5c932ac 100644 --- a/docs/tech/02_parser/classes/RootEntityInterface.md +++ b/docs/tech/02_parser/classes/RootEntityInterface.md @@ -116,7 +116,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/classes/TraitEntity.md b/docs/tech/02_parser/classes/TraitEntity.md index 1072a329..f5286785 100644 --- a/docs/tech/02_parser/classes/TraitEntity.md +++ b/docs/tech/02_parser/classes/TraitEntity.md @@ -252,7 +252,7 @@ Get a collection of constant entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -285,8 +285,8 @@ Get all constants that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetconstantentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](ClassLikeEntity.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -573,7 +573,7 @@ Get a collection of method entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -588,8 +588,8 @@ Get all methods that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetmethodentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](ClassLikeEntity.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -735,8 +735,8 @@ Get all properties that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/classes/ClassLikeEntity.md#mgetpropertyentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](ClassLikeEntity.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -807,7 +807,7 @@ Get a collection of property entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -822,7 +822,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md index 9133a9c0..b50acec7 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity.md @@ -350,7 +350,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- @@ -383,7 +383,7 @@ Constant short name ***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::getName()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity_2.md#mgetname) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::getName()](ClassConstantEntity_2.md#mgetname) --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity_2.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity_2.md index c08d7815..b69a1610 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity_2.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity_2.md @@ -349,7 +349,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- @@ -382,7 +382,7 @@ Constant short name ***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::getName()](/docs/tech/02_parser/reflectionApi/php/classes/ClassConstantEntity_2.md#mgetname) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntity::getName()](ClassConstantEntity_2.md#mgetname) --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md index 4c4e88a5..e1b20340 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassEntity.md @@ -255,7 +255,7 @@ Get a collection of constant entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -288,8 +288,8 @@ Get all constants that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetconstantentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](ClassLikeEntity_5.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -578,7 +578,7 @@ Get a collection of method entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -593,8 +593,8 @@ Get all methods that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetmethodentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](ClassLikeEntity_5.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -734,8 +734,8 @@ Get all properties that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -806,7 +806,7 @@ Get a collection of property entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -821,7 +821,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity.md index 50fe18a4..3eb970e4 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity.md @@ -238,7 +238,7 @@ Get a collection of constant entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -267,8 +267,8 @@ Get all constants that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetconstantentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](ClassLikeEntity_5.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -533,7 +533,7 @@ Get a collection of method entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -546,8 +546,8 @@ Get all methods that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetmethodentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](ClassLikeEntity_5.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -673,8 +673,8 @@ Get all properties that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -737,7 +737,7 @@ Get a collection of property entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -750,7 +750,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_2.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_2.md index 79c5eeeb..b39f1ccd 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_2.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_2.md @@ -238,7 +238,7 @@ Get a collection of constant entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -267,8 +267,8 @@ Get all constants that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetconstantentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](ClassLikeEntity_5.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -533,7 +533,7 @@ Get a collection of method entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -546,8 +546,8 @@ Get all methods that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetmethodentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](ClassLikeEntity_5.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -673,8 +673,8 @@ Get all properties that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -737,7 +737,7 @@ Get a collection of property entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -750,7 +750,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_3.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_3.md index fa02fd34..205123f0 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_3.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_3.md @@ -238,7 +238,7 @@ Get a collection of constant entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -267,8 +267,8 @@ Get all constants that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetconstantentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](ClassLikeEntity_5.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -533,7 +533,7 @@ Get a collection of method entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -546,8 +546,8 @@ Get all methods that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetmethodentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](ClassLikeEntity_5.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -673,8 +673,8 @@ Get all properties that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -737,7 +737,7 @@ Get a collection of property entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -750,7 +750,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_4.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_4.md index 827531ab..0511ddb3 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_4.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_4.md @@ -238,7 +238,7 @@ Get a collection of constant entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -267,8 +267,8 @@ Get all constants that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetconstantentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](ClassLikeEntity_5.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -533,7 +533,7 @@ Get a collection of method entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -546,8 +546,8 @@ Get all methods that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetmethodentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](ClassLikeEntity_5.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -673,8 +673,8 @@ Get all properties that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -737,7 +737,7 @@ Get a collection of property entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -750,7 +750,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md index 5476ac6f..898b8430 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md @@ -237,7 +237,7 @@ Get a collection of constant entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -266,8 +266,8 @@ Get all constants that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetconstantentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](ClassLikeEntity_5.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -532,7 +532,7 @@ Get a collection of method entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -545,8 +545,8 @@ Get all methods that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetmethodentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](ClassLikeEntity_5.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -672,8 +672,8 @@ Get all properties that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -736,7 +736,7 @@ Get a collection of property entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -749,7 +749,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md index 277adca0..a6a78ea3 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/EnumEntity.md @@ -267,7 +267,7 @@ Get a collection of constant entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -300,8 +300,8 @@ Get all constants that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetconstantentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](ClassLikeEntity_5.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -614,7 +614,7 @@ Get a collection of method entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -629,8 +629,8 @@ Get all methods that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetmethodentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](ClassLikeEntity_5.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -776,8 +776,8 @@ Get all properties that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -848,7 +848,7 @@ Get a collection of property entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -863,7 +863,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md index c38d7d13..74b5271d 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/InterfaceEntity.md @@ -254,7 +254,7 @@ Get a collection of constant entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -287,8 +287,8 @@ Get all constants that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetconstantentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](ClassLikeEntity_5.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -577,7 +577,7 @@ Get a collection of method entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -592,8 +592,8 @@ Get all methods that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetmethodentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](ClassLikeEntity_5.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -739,8 +739,8 @@ Get all properties that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -811,7 +811,7 @@ Get a collection of property entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -826,7 +826,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md index 01600b0d..7fdb1ac4 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/MethodEntity.md @@ -408,7 +408,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md b/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md index c493926f..acf43998 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/PhpEntitiesCollection.md @@ -259,7 +259,7 @@ $withAddClassEntityToCollectionEvent | [bool](https://www.php.net/manual/en/lang ***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) ***Links:*** -- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](/docs/tech/02_parser/reflectionApi/php/classes/RootEntityInterface.md#misentitydatacanbeloaded) +- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](RootEntityInterface.md#misentitydatacanbeloaded) --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md b/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md index 7f393f0f..913ab33d 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md @@ -21,6 +21,7 @@ final class PhpHandlerSettings 1. [__construct](#m-construct) ## Methods +1. [changePropRefsInternalLinksMode](#mchangeproprefsinternallinksmode) 1. [getClassConstantEntityFilter](#mgetclassconstantentityfilter) 1. [getClassEntityFilter](#mgetclassentityfilter) 1. [getComposerConfigFile](#mgetcomposerconfigfile) @@ -30,6 +31,7 @@ final class PhpHandlerSettings 1. [getEntityDocRenderersCollection](#mgetentitydocrendererscollection) 1. [getFileSourceBaseUrl](#mgetfilesourcebaseurl) 1. [getMethodEntityFilter](#mgetmethodentityfilter) +1. [getPropRefsInternalLinksMode](#mgetproprefsinternallinksmode) - If `true` - parameters and properties in class documents refer to generated documents and not to external sources 1. [getPropertyEntityFilter](#mgetpropertyentityfilter) 1. [getPsr4Map](#mgetpsr4map) 1. [getUseComposerAutoload](#mgetusecomposerautoload) @@ -50,6 +52,21 @@ $localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https --- +# `changePropRefsInternalLinksMode` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L175) +```php +public function changePropRefsInternalLinksMode(bool $propRefsInternalLinksMode): void; +``` + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$propRefsInternalLinksMode | [bool](https://www.php.net/manual/en/language.types.boolean.php) | - | + +***Return value:*** [void](https://www.php.net/manual/en/language.types.void.php) + +--- + # `getClassConstantEntityFilter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L63) ```php public function getClassConstantEntityFilter(): \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface; @@ -68,7 +85,7 @@ public function getClassEntityFilter(): \BumbleDocGen\Core\Parser\FilterConditio --- -# `getComposerConfigFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L176) +# `getComposerConfigFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L199) ```php public function getComposerConfigFile(): null|string; ``` @@ -77,7 +94,7 @@ public function getComposerConfigFile(): null|string; --- -# `getComposerVendorDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L193) +# `getComposerVendorDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L216) ```php public function getComposerVendorDir(): null|string; ``` @@ -86,7 +103,7 @@ public function getComposerVendorDir(): null|string; --- -# `getCustomTwigFilters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L250) +# `getCustomTwigFilters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L273) ```php public function getCustomTwigFilters(): \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection; ``` @@ -95,7 +112,7 @@ public function getCustomTwigFilters(): \BumbleDocGen\Core\Renderer\Twig\Filter\ --- -# `getCustomTwigFunctions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L227) +# `getCustomTwigFunctions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L250) ```php public function getCustomTwigFunctions(): \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection; ``` @@ -131,6 +148,16 @@ public function getMethodEntityFilter(): \BumbleDocGen\Core\Parser\FilterConditi --- +# `getPropRefsInternalLinksMode` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L162) +```php +public function getPropRefsInternalLinksMode(): bool; +``` +If `true` - parameters and properties in class documents refer to generated documents and not to external sources + +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) + +--- + # `getPropertyEntityFilter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L103) ```php public function getPropertyEntityFilter(): \BumbleDocGen\Core\Parser\FilterCondition\ConditionInterface; @@ -140,7 +167,7 @@ public function getPropertyEntityFilter(): \BumbleDocGen\Core\Parser\FilterCondi --- -# `getPsr4Map` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L209) +# `getPsr4Map` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L232) ```php public function getPsr4Map(): array; ``` @@ -149,7 +176,7 @@ public function getPsr4Map(): array; --- -# `getUseComposerAutoload` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L160) +# `getUseComposerAutoload` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php#L183) ```php public function getUseComposerAutoload(): bool; ``` diff --git a/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md index eacf97d0..acf80258 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/PropertyEntity.md @@ -360,7 +360,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/RootEntityInterface.md b/docs/tech/02_parser/reflectionApi/php/classes/RootEntityInterface.md index 558412c3..17dda1e1 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/RootEntityInterface.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/RootEntityInterface.md @@ -118,7 +118,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md b/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md index e2341194..1809b0f5 100644 --- a/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md +++ b/docs/tech/02_parser/reflectionApi/php/classes/TraitEntity.md @@ -254,7 +254,7 @@ Get a collection of constant entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\ClassConstant\ClassConstantEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/ClassConstant/ClassConstantEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -287,8 +287,8 @@ Get all constants that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetconstantentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetclassconstantentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getConstantEntitiesCollection()](ClassLikeEntity_5.md#mgetconstantentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getClassConstantEntityFilter()](PhpHandlerSettings.md#mgetclassconstantentityfilter) --- @@ -575,7 +575,7 @@ Get a collection of method entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Method\MethodEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Method/MethodEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -590,8 +590,8 @@ Get all methods that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetmethodentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetmethodentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getMethodEntitiesCollection()](ClassLikeEntity_5.md#mgetmethodentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getMethodEntityFilter()](PhpHandlerSettings.md#mgetmethodentityfilter) --- @@ -737,8 +737,8 @@ Get all properties that are available according to the configuration as an array ***Return value:*** [array](https://www.php.net/manual/en/language.types.array.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](/docs/tech/02_parser/reflectionApi/php/classes/ClassLikeEntity_5.md#mgetpropertyentitiescollection) -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\ClassLikeEntity::getPropertyEntitiesCollection()](ClassLikeEntity_5.md#mgetpropertyentitiescollection) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -809,7 +809,7 @@ Get a collection of property entities ***Return value:*** [\BumbleDocGen\LanguageHandler\Php\Parser\Entity\SubEntity\Property\PropertyEntitiesCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Parser/Entity/SubEntity/Property/PropertyEntitiesCollection.php) ***Links:*** -- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](/docs/tech/02_parser/reflectionApi/php/classes/PhpHandlerSettings.md#mgetpropertyentityfilter) +- [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings::getPropertyEntityFilter()](PhpHandlerSettings.md#mgetpropertyentityfilter) --- @@ -824,7 +824,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/02_parser/reflectionApi/php/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/DrawDocumentationMenu.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/DrawDocumentationMenu.md index 070b58ce..750856a8 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/DrawDocumentationMenu.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/DrawDocumentationMenu.md @@ -19,7 +19,7 @@ Generate documentation menu in MD format. To generate the menu, the start page i and all links with this page are recursively collected for it, after which the html menu is created. ***Links:*** -- [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl_2.md) +- [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](GetDocumentedEntityUrl_2.md) ***Examples of using:*** ```php diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl.md index bd03bd8e..474c6f03 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl.md @@ -19,9 +19,9 @@ Get the URL of a documented entity by its name. If the entity is found, next to the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created ***Links:*** -- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrapper.md) -- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrappersCollection.md) -- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/03_renderer/01_howToCreateTemplates/classes/RendererContext.md#pentitywrapperscollection) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](DocumentedEntityWrapper.md) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](DocumentedEntityWrappersCollection.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](RendererContext.md#pentitywrapperscollection) ***Examples of using:*** ```php diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl_2.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl_2.md index 1d3b2752..3cdfcc43 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl_2.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/GetDocumentedEntityUrl_2.md @@ -18,9 +18,9 @@ Get the URL of a documented entity by its name. If the entity is found, next to the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created ***Links:*** -- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrapper.md) -- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/03_renderer/01_howToCreateTemplates/classes/DocumentedEntityWrappersCollection.md) -- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/03_renderer/01_howToCreateTemplates/classes/RendererContext.md#pentitywrapperscollection) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](DocumentedEntityWrapper.md) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](DocumentedEntityWrappersCollection.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](RendererContext.md#pentitywrapperscollection) ***Examples of using:*** ```php diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/PhpEntitiesCollection.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/PhpEntitiesCollection.md index d4579dec..486ca19c 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/PhpEntitiesCollection.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/PhpEntitiesCollection.md @@ -258,7 +258,7 @@ $withAddClassEntityToCollectionEvent | [bool](https://www.php.net/manual/en/lang ***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) ***Links:*** -- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](/docs/tech/03_renderer/01_howToCreateTemplates/classes/RootEntityInterface.md#misentitydatacanbeloaded) +- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](RootEntityInterface.md#misentitydatacanbeloaded) --- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/classes/RootEntityInterface.md b/docs/tech/03_renderer/01_howToCreateTemplates/classes/RootEntityInterface.md index c2f41d6b..c9e67d65 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/classes/RootEntityInterface.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/classes/RootEntityInterface.md @@ -117,7 +117,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/03_renderer/01_howToCreateTemplates/classes/Configuration_2.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration_2.md#mgetprojectroot) --- diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/readme.md b/docs/tech/03_renderer/01_howToCreateTemplates/readme.md index c6884a29..08c47d92 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/readme.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/readme.md @@ -102,4 +102,4 @@ More static text... --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Fri Jan 19 23:21:14 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/02_breadcrumbs.md b/docs/tech/03_renderer/02_breadcrumbs.md index a743bf15..250d3ef8 100644 --- a/docs/tech/03_renderer/02_breadcrumbs.md +++ b/docs/tech/03_renderer/02_breadcrumbs.md @@ -33,7 +33,7 @@ In this way, complex documentation structures can be created with less file nest ## Displaying breadcrumbs in documents -There is a built-in function to generate breadcrumbs in templates [GeneratePageBreadcrumbs](classes/GeneratePageBreadcrumbs.md). +There is a built-in function to generate breadcrumbs in templates [GeneratePageBreadcrumbs](classes/GeneratePageBreadcrumbs_2.md). Here is how it is used in twig templates: ```twig @@ -58,4 +58,4 @@ Here is an example of the result of the `generatePageBreadcrumbs` function: --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Fri Jan 19 23:21:14 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/classes/DrawDocumentationMenu.md b/docs/tech/03_renderer/classes/DrawDocumentationMenu.md index b107a58a..f7deea77 100644 --- a/docs/tech/03_renderer/classes/DrawDocumentationMenu.md +++ b/docs/tech/03_renderer/classes/DrawDocumentationMenu.md @@ -18,7 +18,7 @@ Generate documentation menu in MD format. To generate the menu, the start page i and all links with this page are recursively collected for it, after which the html menu is created. ***Links:*** -- [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](/docs/tech/03_renderer/classes/GetDocumentedEntityUrl_2.md) +- [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](GetDocumentedEntityUrl_2.md) ***Examples of using:*** ```php diff --git a/docs/tech/03_renderer/classes/GetDocumentedEntityUrl.md b/docs/tech/03_renderer/classes/GetDocumentedEntityUrl.md index d0fc04cb..65b932e6 100644 --- a/docs/tech/03_renderer/classes/GetDocumentedEntityUrl.md +++ b/docs/tech/03_renderer/classes/GetDocumentedEntityUrl.md @@ -18,9 +18,9 @@ Get the URL of a documented entity by its name. If the entity is found, next to the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created ***Links:*** -- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/03_renderer/classes/DocumentedEntityWrapper.md) -- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/03_renderer/classes/DocumentedEntityWrappersCollection.md) -- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/03_renderer/classes/RendererContext.md#pentitywrapperscollection) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](DocumentedEntityWrapper.md) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](DocumentedEntityWrappersCollection.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](RendererContext.md#pentitywrapperscollection) ***Examples of using:*** ```php diff --git a/docs/tech/03_renderer/classes/GetDocumentedEntityUrl_2.md b/docs/tech/03_renderer/classes/GetDocumentedEntityUrl_2.md index 05c4de2d..9b2b0d2d 100644 --- a/docs/tech/03_renderer/classes/GetDocumentedEntityUrl_2.md +++ b/docs/tech/03_renderer/classes/GetDocumentedEntityUrl_2.md @@ -17,9 +17,9 @@ Get the URL of a documented entity by its name. If the entity is found, next to the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created ***Links:*** -- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/03_renderer/classes/DocumentedEntityWrapper.md) -- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/03_renderer/classes/DocumentedEntityWrappersCollection.md) -- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/03_renderer/classes/RendererContext.md#pentitywrapperscollection) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](DocumentedEntityWrapper.md) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](DocumentedEntityWrappersCollection.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](RendererContext.md#pentitywrapperscollection) ***Examples of using:*** ```php diff --git a/docs/tech/03_renderer/classes/PhpEntitiesCollection.md b/docs/tech/03_renderer/classes/PhpEntitiesCollection.md index 109f2933..af1c5e80 100644 --- a/docs/tech/03_renderer/classes/PhpEntitiesCollection.md +++ b/docs/tech/03_renderer/classes/PhpEntitiesCollection.md @@ -257,7 +257,7 @@ $withAddClassEntityToCollectionEvent | [bool](https://www.php.net/manual/en/lang ***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) ***Links:*** -- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](/docs/tech/03_renderer/classes/RootEntityInterface_2.md#misentitydatacanbeloaded) +- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](RootEntityInterface_2.md#misentitydatacanbeloaded) --- diff --git a/docs/tech/03_renderer/classes/RootEntityCollection.md b/docs/tech/03_renderer/classes/RootEntityCollection.md index f9c022e7..c15ff710 100644 --- a/docs/tech/03_renderer/classes/RootEntityCollection.md +++ b/docs/tech/03_renderer/classes/RootEntityCollection.md @@ -122,7 +122,7 @@ $withAddClassEntityToCollectionEvent | [bool](https://www.php.net/manual/en/lang ***Return value:*** [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/Entity/RootEntityInterface.php) ***Links:*** -- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](/docs/tech/03_renderer/classes/RootEntityInterface_2.md#misentitydatacanbeloaded) +- [\BumbleDocGen\Core\Parser\Entity\RootEntityInterface::isEntityDataCanBeLoaded()](RootEntityInterface_2.md#misentitydatacanbeloaded) --- diff --git a/docs/tech/03_renderer/classes/RootEntityInterface.md b/docs/tech/03_renderer/classes/RootEntityInterface.md index 4495a2e6..264e02b2 100644 --- a/docs/tech/03_renderer/classes/RootEntityInterface.md +++ b/docs/tech/03_renderer/classes/RootEntityInterface.md @@ -117,7 +117,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/03_renderer/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/03_renderer/classes/RootEntityInterface_2.md b/docs/tech/03_renderer/classes/RootEntityInterface_2.md index a8e78f31..e309a3c6 100644 --- a/docs/tech/03_renderer/classes/RootEntityInterface_2.md +++ b/docs/tech/03_renderer/classes/RootEntityInterface_2.md @@ -116,7 +116,7 @@ File name relative to project_root configuration parameter ***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) ***Links:*** -- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](/docs/tech/03_renderer/classes/Configuration.md#mgetprojectroot) +- [\BumbleDocGen\Core\Configuration\Configuration::getProjectRoot()](Configuration.md#mgetprojectroot) --- diff --git a/docs/tech/03_renderer/classes/StrTypeToUrl.md b/docs/tech/03_renderer/classes/StrTypeToUrl.md index f3c4d17d..2b47cb0f 100644 --- a/docs/tech/03_renderer/classes/StrTypeToUrl.md +++ b/docs/tech/03_renderer/classes/StrTypeToUrl.md @@ -17,7 +17,7 @@ final class StrTypeToUrl implements \BumbleDocGen\Core\Renderer\Twig\Filter\Cust The filter converts the string with the data type into a link to the documented entity, if possible. ***Links:*** -- [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](/docs/tech/03_renderer/classes/GetDocumentedEntityUrl_2.md) +- [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](GetDocumentedEntityUrl_2.md)

                Settings:

                diff --git a/docs/tech/06_debugging.md b/docs/tech/06_debugging.md index ccd53fbe..379dc3d2 100644 --- a/docs/tech/06_debugging.md +++ b/docs/tech/06_debugging.md @@ -27,4 +27,4 @@ Our tool provides several options for debugging documentation. --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Fri Jan 19 23:16:37 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/classes/Daux.md b/docs/tech/classes/Daux.md index 02d9bdd3..d25c4aae 100644 --- a/docs/tech/classes/Daux.md +++ b/docs/tech/classes/Daux.md @@ -6,7 +6,7 @@ Daux --- -# [Daux](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L21) class: +# [Daux](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L22) class: ⚠️ Internal ```php namespace BumbleDocGen\LanguageHandler\Php\Plugin\CorePlugin\Daux; @@ -28,9 +28,9 @@ final class Daux implements \BumbleDocGen\Core\Plugin\PluginInterface, \Symfony\ ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L26) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L27) ```php -public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper); +public function __construct(\BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings); ``` ***Parameters:*** @@ -39,10 +39,11 @@ public function __construct(\BumbleDocGen\Core\Configuration\Configuration $conf |:-|:-|:-| $configuration | [\BumbleDocGen\Core\Configuration\Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php) | - | $breadcrumbsHelper | [\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Breadcrumbs/BreadcrumbsHelper.php) | - | +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | --- -# `afterRenderingEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L97) +# `afterRenderingEntities` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L100) ```php public function afterRenderingEntities(): void; ``` @@ -51,7 +52,7 @@ public function afterRenderingEntities(): void; --- -# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L47) +# `beforeCreatingDocFile` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L50) ```php public function beforeCreatingDocFile(\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile|\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingEntityDocFile $event): void; ``` @@ -66,7 +67,7 @@ $event | [\BumbleDocGen\Core\Plugin\Event\Renderer\BeforeCreatingDocFile](https: --- -# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L32) +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L35) ```php public static function getSubscribedEvents(): array; ``` @@ -75,7 +76,7 @@ public static function getSubscribedEvents(): array; --- -# `onCreateDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L73) +# `onCreateDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L76) ```php public function onCreateDocumentedEntityWrapper(\BumbleDocGen\Core\Plugin\Event\Renderer\OnCreateDocumentedEntityWrapper $event): void; ``` @@ -90,7 +91,7 @@ $event | [\BumbleDocGen\Core\Plugin\Event\Renderer\OnCreateDocumentedEntityWrapp --- -# `onGetProjectTemplatesDirs` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L89) +# `onGetProjectTemplatesDirs` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L92) ```php public function onGetProjectTemplatesDirs(\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetProjectTemplatesDirs $event): void; ``` @@ -105,7 +106,7 @@ $event | [\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetProjectTemplatesDirs](ht --- -# `onGetTemplatePathByRelativeDocPath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L80) +# `onGetTemplatePathByRelativeDocPath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/Daux.php#L83) ```php public function onGetTemplatePathByRelativeDocPath(\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetTemplatePathByRelativeDocPath $event): void; ``` diff --git a/docs/tech/classes/DrawDocumentationMenu.md b/docs/tech/classes/DrawDocumentationMenu.md index aa58657d..917e17fd 100644 --- a/docs/tech/classes/DrawDocumentationMenu.md +++ b/docs/tech/classes/DrawDocumentationMenu.md @@ -17,7 +17,7 @@ Generate documentation menu in MD format. To generate the menu, the start page i and all links with this page are recursively collected for it, after which the html menu is created. ***Links:*** -- [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](/docs/tech/classes/GetDocumentedEntityUrl_2.md) +- [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](GetDocumentedEntityUrl_2.md) ***Examples of using:*** ```php diff --git a/docs/tech/classes/EntityDocUnifiedPlacePlugin.md b/docs/tech/classes/EntityDocUnifiedPlacePlugin.md index 78c97fc3..3828c709 100644 --- a/docs/tech/classes/EntityDocUnifiedPlacePlugin.md +++ b/docs/tech/classes/EntityDocUnifiedPlacePlugin.md @@ -6,7 +6,7 @@ EntityDocUnifiedPlacePlugin --- -# [EntityDocUnifiedPlacePlugin](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php#L17) class: +# [EntityDocUnifiedPlacePlugin](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php#L18) class: ```php namespace BumbleDocGen\LanguageHandler\Php\Plugin\CorePlugin\EntityDocUnifiedPlace; @@ -17,6 +17,9 @@ This plugin changes the algorithm for saving entity documents. The standard syst in a directory next to the file where it was requested. This behavior changes and all documents are saved in a separate directory structure, so they are not duplicated. +## Initialization methods + +1. [__construct](#m-construct) ## Methods 1. [getSubscribedEvents](#mgetsubscribedevents) @@ -26,7 +29,20 @@ in a separate directory structure, so they are not duplicated. ## Methods details: -# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php#L22) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php#L23) +```php +public function __construct(\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings $phpHandlerSettings); +``` + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$phpHandlerSettings | [\BumbleDocGen\LanguageHandler\Php\PhpHandlerSettings](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/PhpHandlerSettings.php) | - | + +--- + +# `getSubscribedEvents` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php#L29) ```php public static function getSubscribedEvents(): array; ``` @@ -35,7 +51,7 @@ public static function getSubscribedEvents(): array; --- -# `onCreateDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php#L31) +# `onCreateDocumentedEntityWrapper` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php#L38) ```php public function onCreateDocumentedEntityWrapper(\BumbleDocGen\Core\Plugin\Event\Renderer\OnCreateDocumentedEntityWrapper $event): void; ``` @@ -50,7 +66,7 @@ $event | [\BumbleDocGen\Core\Plugin\Event\Renderer\OnCreateDocumentedEntityWrapp --- -# `onGetProjectTemplatesDirs` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php#L47) +# `onGetProjectTemplatesDirs` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php#L54) ```php public function onGetProjectTemplatesDirs(\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetProjectTemplatesDirs $event): void; ``` @@ -65,7 +81,7 @@ $event | [\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetProjectTemplatesDirs](ht --- -# `onGetTemplatePathByRelativeDocPath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php#L38) +# `onGetTemplatePathByRelativeDocPath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/EntityDocUnifiedPlacePlugin.php#L45) ```php public function onGetTemplatePathByRelativeDocPath(\BumbleDocGen\Core\Plugin\Event\Renderer\OnGetTemplatePathByRelativeDocPath $event): void; ``` diff --git a/docs/tech/classes/GetDocumentedEntityUrl.md b/docs/tech/classes/GetDocumentedEntityUrl.md index 9cce207f..fd3f0384 100644 --- a/docs/tech/classes/GetDocumentedEntityUrl.md +++ b/docs/tech/classes/GetDocumentedEntityUrl.md @@ -17,9 +17,9 @@ Get the URL of a documented entity by its name. If the entity is found, next to the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created ***Links:*** -- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/classes/DocumentedEntityWrapper.md) -- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/classes/DocumentedEntityWrappersCollection.md) -- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/classes/RendererContext.md#pentitywrapperscollection) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](DocumentedEntityWrapper.md) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](DocumentedEntityWrappersCollection.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](RendererContext.md#pentitywrapperscollection) ***Examples of using:*** ```php diff --git a/docs/tech/classes/GetDocumentedEntityUrl_2.md b/docs/tech/classes/GetDocumentedEntityUrl_2.md index 2950b9ec..692dbc5a 100644 --- a/docs/tech/classes/GetDocumentedEntityUrl_2.md +++ b/docs/tech/classes/GetDocumentedEntityUrl_2.md @@ -16,9 +16,9 @@ Get the URL of a documented entity by its name. If the entity is found, next to the `EntityDocRendererInterface::getDocFileExtension()` directory will be created, in which the documented entity file will be created ***Links:*** -- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](/docs/tech/classes/DocumentedEntityWrapper.md) -- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](/docs/tech/classes/DocumentedEntityWrappersCollection.md) -- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](/docs/tech/classes/RendererContext.md#pentitywrapperscollection) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrapper](DocumentedEntityWrapper.md) +- [\BumbleDocGen\Core\Renderer\Context\DocumentedEntityWrappersCollection](DocumentedEntityWrappersCollection.md) +- [\BumbleDocGen\Core\Renderer\Context\RendererContext::$entityWrappersCollection](RendererContext.md#pentitywrapperscollection) ***Examples of using:*** ```php diff --git a/docs/tech/classes/OnLoadEntityDocPluginContent.md b/docs/tech/classes/OnLoadEntityDocPluginContent.md index 55ab6168..e656607f 100644 --- a/docs/tech/classes/OnLoadEntityDocPluginContent.md +++ b/docs/tech/classes/OnLoadEntityDocPluginContent.md @@ -16,7 +16,7 @@ final class OnLoadEntityDocPluginContent extends \Symfony\Contracts\EventDispatc Called when entity documentation is generated (plugin content loading) ***Links:*** -- [\BumbleDocGen\Core\Renderer\Twig\Function\LoadPluginsContent](/docs/tech/classes/LoadPluginsContent_2.md) +- [\BumbleDocGen\Core\Renderer\Twig\Function\LoadPluginsContent](LoadPluginsContent_2.md) ## Initialization methods diff --git a/docs/tech/classes/StrTypeToUrl.md b/docs/tech/classes/StrTypeToUrl.md index 1d1f0e27..47736dad 100644 --- a/docs/tech/classes/StrTypeToUrl.md +++ b/docs/tech/classes/StrTypeToUrl.md @@ -16,7 +16,7 @@ final class StrTypeToUrl implements \BumbleDocGen\Core\Renderer\Twig\Filter\Cust The filter converts the string with the data type into a link to the documented entity, if possible. ***Links:*** -- [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](/docs/tech/classes/GetDocumentedEntityUrl_2.md) +- [\BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl](GetDocumentedEntityUrl_2.md)

                Settings:

                From 6683b93473e73f931b4bacd3e968ee8346c3a205 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Sat, 20 Jan 2024 00:42:48 +0300 Subject: [PATCH 30/32] Renaming function to generate breadcrumbs --- UPGRADE.md | 2 +- demo/demo1/templates/classMap/index.md.twig | 2 +- .../classListExample/index.md.twig | 2 +- .../sectionWithSubsections/index.md.twig | 2 +- .../pageLinkingExample/index.md.twig | 2 +- .../templates/tech/01_configuration.md.twig | 2 +- .../templates/tech/02_parser/entity.md.twig | 2 +- .../02_parser/entityFilterCondition.md.twig | 2 +- .../templates/tech/02_parser/readme.md.twig | 2 +- .../php/phpClassConstantReflectionApi.md.twig | 2 +- .../php/phpClassMethodReflectionApi.md.twig | 2 +- .../php/phpClassPropertyReflectionApi.md.twig | 2 +- .../php/phpClassReflectionApi.md.twig | 2 +- .../php/phpEntitiesCollection.md.twig | 2 +- .../php/phpEnumReflectionApi.md.twig | 2 +- .../php/phpInterfaceReflectionApi.md.twig | 2 +- .../php/phpTraitReflectionApi.md.twig | 2 +- .../reflectionApi/php/readme.md.twig | 2 +- .../02_parser/reflectionApi/readme.md.twig | 2 +- .../tech/02_parser/sourceLocator.md.twig | 2 +- .../frontMatter.md.twig | 2 +- .../01_howToCreateTemplates/readme.md.twig | 4 +-- .../templatesDynamicBlocks.md.twig | 2 +- .../templatesLinking.md.twig | 2 +- .../templatesVariables.md.twig | 2 +- .../tech/03_renderer/02_breadcrumbs.md.twig | 8 ++--- .../03_renderer/03_documentStructure.md.twig | 2 +- .../03_renderer/04_twigCustomFilters.md.twig | 2 +- .../05_twigCustomFunctions.md.twig | 2 +- .../templates/tech/03_renderer/readme.md.twig | 2 +- .../templates/tech/04_pluginSystem.md.twig | 2 +- selfdoc/templates/tech/05_console.md.twig | 2 +- selfdoc/templates/tech/06_debugging.md.twig | 2 +- .../templates/tech/07_outputFormat.md.twig | 2 +- selfdoc/templates/tech/readme.md.twig | 2 +- .../Configuration/defaultConfiguration.yaml | 2 +- ...adcrumbs.php => DrawEntityBreadcrumbs.php} | 4 +-- ...readcrumbs.php => DrawPageBreadcrumbs.php} | 29 +++++++++---------- .../-Project_Structure/Entities_Map.md.twig | 2 +- .../Project_Classes.md.twig | 2 +- .../Project_Interfaces.md.twig | 2 +- .../-Project_Structure/Project_Traits.md.twig | 2 +- .../-Project_Structure/index.md.twig | 2 +- .../templates/__structure/classes.md.twig | 2 +- .../templates/__structure/interfaces.md.twig | 2 +- .../templates/__structure/map.md.twig | 2 +- .../templates/__structure/readme.md.twig | 2 +- .../templates/__structure/traits.md.twig | 2 +- .../PhpClassRendererTwigEnvironment.php | 10 +++---- .../PhpClassToMd/templates/class.md.twig | 2 +- 50 files changed, 72 insertions(+), 73 deletions(-) rename src/Core/Renderer/Twig/Function/{GenerateEntityBreadcrumbs.php => DrawEntityBreadcrumbs.php} (95%) rename src/Core/Renderer/Twig/Function/{GeneratePageBreadcrumbs.php => DrawPageBreadcrumbs.php} (76%) diff --git a/UPGRADE.md b/UPGRADE.md index c835a756..2a837b8f 100644 --- a/UPGRADE.md +++ b/UPGRADE.md @@ -36,4 +36,4 @@ This document serves as a reference for updating your current version of the Bum * Twig filter `\BumbleDocGen\Core\Renderer\Twig\Filter\TextToCodeBlock` removed * Twig filter `\BumbleDocGen\Core\Renderer\Twig\Filter\TextToHeading` removed * Plugin `\BumbleDocGen\Core\Plugin\CorePlugin\PageLinker\PageLinkerPlugin` now generates MD instead of HTML -* Twig filter `\BumbleDocGen\Core\Renderer\Twig\Function\GeneratePageBreadcrumbs` now generates MD instead of HTML +* Twig function `\BumbleDocGen\Core\Renderer\Twig\Function\GeneratePageBreadcrumbs` removed. Use `\BumbleDocGen\Core\Renderer\Twig\Function\DrawPageBreadcrumbs` function instead diff --git a/demo/demo1/templates/classMap/index.md.twig b/demo/demo1/templates/classMap/index.md.twig index 79f5b281..240ee0c8 100644 --- a/demo/demo1/templates/classMap/index.md.twig +++ b/demo/demo1/templates/classMap/index.md.twig @@ -1,7 +1,7 @@ --- title: Class map --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Class map example diff --git a/demo/demo1/templates/sectionWithSubsections/classListExample/index.md.twig b/demo/demo1/templates/sectionWithSubsections/classListExample/index.md.twig index 38957350..634a25ca 100644 --- a/demo/demo1/templates/sectionWithSubsections/classListExample/index.md.twig +++ b/demo/demo1/templates/sectionWithSubsections/classListExample/index.md.twig @@ -1,7 +1,7 @@ --- title: Class list example --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Class list diff --git a/demo/demo1/templates/sectionWithSubsections/index.md.twig b/demo/demo1/templates/sectionWithSubsections/index.md.twig index 5affb6ce..6b8ba2cb 100644 --- a/demo/demo1/templates/sectionWithSubsections/index.md.twig +++ b/demo/demo1/templates/sectionWithSubsections/index.md.twig @@ -1,7 +1,7 @@ --- title: Section with subsections --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Section with subsections example diff --git a/demo/demo1/templates/sectionWithSubsections/pageLinkingExample/index.md.twig b/demo/demo1/templates/sectionWithSubsections/pageLinkingExample/index.md.twig index 1e5121a8..86f2c314 100644 --- a/demo/demo1/templates/sectionWithSubsections/pageLinkingExample/index.md.twig +++ b/demo/demo1/templates/sectionWithSubsections/pageLinkingExample/index.md.twig @@ -1,7 +1,7 @@ --- title: Page linking example --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Page linking example diff --git a/selfdoc/templates/tech/01_configuration.md.twig b/selfdoc/templates/tech/01_configuration.md.twig index 54f0fb0b..9efb2e9e 100644 --- a/selfdoc/templates/tech/01_configuration.md.twig +++ b/selfdoc/templates/tech/01_configuration.md.twig @@ -2,7 +2,7 @@ title: Configuration prevPage: Technical description of the project --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Configuration diff --git a/selfdoc/templates/tech/02_parser/entity.md.twig b/selfdoc/templates/tech/02_parser/entity.md.twig index 39e4eb9e..4aa06356 100644 --- a/selfdoc/templates/tech/02_parser/entity.md.twig +++ b/selfdoc/templates/tech/02_parser/entity.md.twig @@ -2,7 +2,7 @@ title: Entities and entities collections prevPage: Parser --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Entities and entities collections diff --git a/selfdoc/templates/tech/02_parser/entityFilterCondition.md.twig b/selfdoc/templates/tech/02_parser/entityFilterCondition.md.twig index 0a905715..adf982c1 100644 --- a/selfdoc/templates/tech/02_parser/entityFilterCondition.md.twig +++ b/selfdoc/templates/tech/02_parser/entityFilterCondition.md.twig @@ -2,7 +2,7 @@ title: Entity filter conditions prevPage: Parser --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Entity filter conditions diff --git a/selfdoc/templates/tech/02_parser/readme.md.twig b/selfdoc/templates/tech/02_parser/readme.md.twig index e70eb778..8b7e9665 100644 --- a/selfdoc/templates/tech/02_parser/readme.md.twig +++ b/selfdoc/templates/tech/02_parser/readme.md.twig @@ -1,7 +1,7 @@ --- title: Parser --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Documentation parser diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md.twig index aaa89e22..6f3569a3 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md.twig @@ -2,7 +2,7 @@ title: PHP class constant reflection API prevPage: Reflection API for PHP --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # PHP class constant reflection API diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md.twig index f19fe3c7..54f5d5d7 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md.twig @@ -2,7 +2,7 @@ title: PHP class method reflection API prevPage: Reflection API for PHP --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # PHP class method reflection API diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md.twig index 10bae6c8..4d87b911 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md.twig @@ -2,7 +2,7 @@ title: PHP class property reflection API prevPage: Reflection API for PHP --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # PHP class property reflection API diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md.twig index 338e6a76..81b35ce4 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md.twig @@ -2,7 +2,7 @@ title: PHP class reflection API prevPage: Reflection API for PHP --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # PHP class reflection API diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md.twig index 57cb2b0c..4d23d2c2 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md.twig @@ -2,7 +2,7 @@ title: PHP entities collection prevPage: Reflection API for PHP --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # PHP entities collection diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md.twig index 80ff741d..a94acb1f 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md.twig @@ -2,7 +2,7 @@ title: PHP enum reflection API prevPage: Reflection API for PHP --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # PHP enum reflection API diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md.twig index e3c8b7ad..f9c017a0 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md.twig @@ -2,7 +2,7 @@ title: PHP interface reflection API prevPage: Reflection API for PHP --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # PHP interface reflection API diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md.twig index 73b2595b..48a4ae59 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md.twig @@ -2,7 +2,7 @@ title: PHP trait reflection API prevPage: Reflection API for PHP --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # PHP trait reflection API diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/php/readme.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/php/readme.md.twig index f98bf7b8..4fdb4d6f 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/php/readme.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/php/readme.md.twig @@ -1,7 +1,7 @@ --- title: Reflection API for PHP --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Reflection API for PHP diff --git a/selfdoc/templates/tech/02_parser/reflectionApi/readme.md.twig b/selfdoc/templates/tech/02_parser/reflectionApi/readme.md.twig index 41f32923..a0d4b55f 100644 --- a/selfdoc/templates/tech/02_parser/reflectionApi/readme.md.twig +++ b/selfdoc/templates/tech/02_parser/reflectionApi/readme.md.twig @@ -1,7 +1,7 @@ --- title: Reflection API --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Reflection API diff --git a/selfdoc/templates/tech/02_parser/sourceLocator.md.twig b/selfdoc/templates/tech/02_parser/sourceLocator.md.twig index 20cb81a0..73b89dcb 100644 --- a/selfdoc/templates/tech/02_parser/sourceLocator.md.twig +++ b/selfdoc/templates/tech/02_parser/sourceLocator.md.twig @@ -2,7 +2,7 @@ title: Source locators prevPage: Parser --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Source locators diff --git a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/frontMatter.md.twig b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/frontMatter.md.twig index ca00ac21..e10a3107 100644 --- a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/frontMatter.md.twig +++ b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/frontMatter.md.twig @@ -2,7 +2,7 @@ title: Front Matter prevPage: How to create documentation templates? --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Front Matter diff --git a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/readme.md.twig b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/readme.md.twig index e28bc65a..aae5228c 100644 --- a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/readme.md.twig +++ b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/readme.md.twig @@ -1,7 +1,7 @@ --- title: How to create documentation templates? --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # How to create documentation templates? @@ -29,7 +29,7 @@ After generating the documentation, this page will look exactly like a template. title: Some page prevPage: Technical description of the project --- -{{ "{{ generatePageBreadcrumbs(title, _self) }}" }} +{{ "{{ drawPageBreadcrumbs() }}" }} Some static text... diff --git a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md.twig b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md.twig index 30a19a2b..fe5ff344 100644 --- a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md.twig +++ b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md.twig @@ -2,7 +2,7 @@ title: Templates dynamic blocks prevPage: How to create documentation templates? --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Templates dynamic blocks diff --git a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md.twig b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md.twig index ec613d68..be856426 100644 --- a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md.twig +++ b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md.twig @@ -2,7 +2,7 @@ title: Linking templates prevPage: How to create documentation templates? --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Linking templates diff --git a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md.twig b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md.twig index d925bc78..85d59e9b 100644 --- a/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md.twig +++ b/selfdoc/templates/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md.twig @@ -2,7 +2,7 @@ title: Templates variables prevPage: How to create documentation templates? --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Templates variables diff --git a/selfdoc/templates/tech/03_renderer/02_breadcrumbs.md.twig b/selfdoc/templates/tech/03_renderer/02_breadcrumbs.md.twig index 9664ea49..9c5bca15 100644 --- a/selfdoc/templates/tech/03_renderer/02_breadcrumbs.md.twig +++ b/selfdoc/templates/tech/03_renderer/02_breadcrumbs.md.twig @@ -2,7 +2,7 @@ title: Documentation structure and breadcrumbs prevPage: Renderer --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Documentation structure and breadcrumbs @@ -31,11 +31,11 @@ In this way, complex documentation structures can be created with less file nest ## Displaying breadcrumbs in documents -There is a built-in function to generate breadcrumbs in templates [a]GeneratePageBreadcrumbs[/a]. +There is a built-in function to generate breadcrumbs in templates [a]DrawPageBreadcrumbs[/a]. Here is how it is used in twig templates: ```twig -{{ '{{ generatePageBreadcrumbs(title, _self) }}' }} +{{ '{{ drawPageBreadcrumbs() }}' }} ``` To build breadcrumbs, the previously compiled project structure and the names of each template are used. @@ -47,7 +47,7 @@ title: Some page title --- ``` -Here is an example of the result of the `generatePageBreadcrumbs` function: +Here is an example of the result of the `drawPageBreadcrumbs` function: ```twig {{ ' BumbleDocGen / Technical description of the project / Renderer / Some page title
                ' }} diff --git a/selfdoc/templates/tech/03_renderer/03_documentStructure.md.twig b/selfdoc/templates/tech/03_renderer/03_documentStructure.md.twig index 2d2e27ce..68c203b7 100644 --- a/selfdoc/templates/tech/03_renderer/03_documentStructure.md.twig +++ b/selfdoc/templates/tech/03_renderer/03_documentStructure.md.twig @@ -2,7 +2,7 @@ title: Document structure of generated entities prevPage: Renderer --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Document structure of generated entities diff --git a/selfdoc/templates/tech/03_renderer/04_twigCustomFilters.md.twig b/selfdoc/templates/tech/03_renderer/04_twigCustomFilters.md.twig index 4434b72c..f954cf9c 100644 --- a/selfdoc/templates/tech/03_renderer/04_twigCustomFilters.md.twig +++ b/selfdoc/templates/tech/03_renderer/04_twigCustomFilters.md.twig @@ -2,7 +2,7 @@ title: Template filters prevPage: Renderer --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Template filters diff --git a/selfdoc/templates/tech/03_renderer/05_twigCustomFunctions.md.twig b/selfdoc/templates/tech/03_renderer/05_twigCustomFunctions.md.twig index ee35b1da..5f8f4d5d 100644 --- a/selfdoc/templates/tech/03_renderer/05_twigCustomFunctions.md.twig +++ b/selfdoc/templates/tech/03_renderer/05_twigCustomFunctions.md.twig @@ -2,7 +2,7 @@ title: Template functions prevPage: Renderer --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Template functions diff --git a/selfdoc/templates/tech/03_renderer/readme.md.twig b/selfdoc/templates/tech/03_renderer/readme.md.twig index 058fa2d8..b502d9d6 100644 --- a/selfdoc/templates/tech/03_renderer/readme.md.twig +++ b/selfdoc/templates/tech/03_renderer/readme.md.twig @@ -1,7 +1,7 @@ --- title: Renderer --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Documentation renderer diff --git a/selfdoc/templates/tech/04_pluginSystem.md.twig b/selfdoc/templates/tech/04_pluginSystem.md.twig index a8656722..256e92da 100644 --- a/selfdoc/templates/tech/04_pluginSystem.md.twig +++ b/selfdoc/templates/tech/04_pluginSystem.md.twig @@ -2,7 +2,7 @@ title: Plugin system prevPage: Technical description of the project --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Plugin system diff --git a/selfdoc/templates/tech/05_console.md.twig b/selfdoc/templates/tech/05_console.md.twig index 0e6edde8..0fa0743e 100644 --- a/selfdoc/templates/tech/05_console.md.twig +++ b/selfdoc/templates/tech/05_console.md.twig @@ -2,7 +2,7 @@ title: Console app prevPage: Technical description of the project --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Console app diff --git a/selfdoc/templates/tech/06_debugging.md.twig b/selfdoc/templates/tech/06_debugging.md.twig index 1d9554db..f4215534 100644 --- a/selfdoc/templates/tech/06_debugging.md.twig +++ b/selfdoc/templates/tech/06_debugging.md.twig @@ -2,7 +2,7 @@ title: Debug documents prevPage: Technical description of the project --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Debug documents diff --git a/selfdoc/templates/tech/07_outputFormat.md.twig b/selfdoc/templates/tech/07_outputFormat.md.twig index ccf7e7d5..fa8e8d08 100644 --- a/selfdoc/templates/tech/07_outputFormat.md.twig +++ b/selfdoc/templates/tech/07_outputFormat.md.twig @@ -2,7 +2,7 @@ title: Output formats prevPage: Technical description of the project --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Output formats diff --git a/selfdoc/templates/tech/readme.md.twig b/selfdoc/templates/tech/readme.md.twig index 33a26434..d8422e25 100644 --- a/selfdoc/templates/tech/readme.md.twig +++ b/selfdoc/templates/tech/readme.md.twig @@ -1,7 +1,7 @@ --- title: Technical description of the project --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Technical description of the project diff --git a/src/Core/Configuration/defaultConfiguration.yaml b/src/Core/Configuration/defaultConfiguration.yaml index 4787d329..eef952b3 100644 --- a/src/Core/Configuration/defaultConfiguration.yaml +++ b/src/Core/Configuration/defaultConfiguration.yaml @@ -15,7 +15,7 @@ use_shared_cache: true # (bool) Enable cache usage of generated docum twig_functions: # (array) Functions that can be used in document templates - class: \BumbleDocGen\Core\Renderer\Twig\Function\DrawDocumentationMenu - class: \BumbleDocGen\Core\Renderer\Twig\Function\DrawDocumentedEntityLink - - class: \BumbleDocGen\Core\Renderer\Twig\Function\GeneratePageBreadcrumbs + - class: \BumbleDocGen\Core\Renderer\Twig\Function\DrawPageBreadcrumbs - class: \BumbleDocGen\Core\Renderer\Twig\Function\GetDocumentedEntityUrl - class: \BumbleDocGen\Core\Renderer\Twig\Function\LoadPluginsContent - class: \BumbleDocGen\Core\Renderer\Twig\Function\PrintEntityCollectionAsList diff --git a/src/Core/Renderer/Twig/Function/GenerateEntityBreadcrumbs.php b/src/Core/Renderer/Twig/Function/DrawEntityBreadcrumbs.php similarity index 95% rename from src/Core/Renderer/Twig/Function/GenerateEntityBreadcrumbs.php rename to src/Core/Renderer/Twig/Function/DrawEntityBreadcrumbs.php index 7f43a775..f81b4ad3 100644 --- a/src/Core/Renderer/Twig/Function/GenerateEntityBreadcrumbs.php +++ b/src/Core/Renderer/Twig/Function/DrawEntityBreadcrumbs.php @@ -20,7 +20,7 @@ /** * @internal */ -final class GenerateEntityBreadcrumbs implements CustomFunctionInterface +final class DrawEntityBreadcrumbs implements CustomFunctionInterface { public function __construct( private readonly BreadcrumbsTwigEnvironment $breadcrumbsTwig, @@ -32,7 +32,7 @@ public function __construct( public static function getName(): string { - return 'generateEntityBreadcrumbs'; + return 'drawEntityBreadcrumbs'; } public static function getOptions(): array diff --git a/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php b/src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php similarity index 76% rename from src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php rename to src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php index a5376842..72f1f4b9 100644 --- a/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php +++ b/src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php @@ -10,6 +10,7 @@ use BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsTwigEnvironment; use BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory; use BumbleDocGen\Core\Renderer\Context\RendererContext; +use BumbleDocGen\Core\Renderer\Twig\MainTwigEnvironment; use DI\DependencyException; use DI\NotFoundException; use Twig\Error\LoaderError; @@ -21,7 +22,7 @@ /** * Function to generate breadcrumbs on the page */ -final class GeneratePageBreadcrumbs implements CustomFunctionInterface +final class DrawPageBreadcrumbs implements CustomFunctionInterface { public function __construct( private readonly BreadcrumbsHelper $breadcrumbsHelper, @@ -34,50 +35,48 @@ public function __construct( public static function getName(): string { - return 'generatePageBreadcrumbs'; + return 'drawPageBreadcrumbs'; } public static function getOptions(): array { return [ 'is_safe' => ['html'], + 'needs_context' => true, ]; } /** - * @param string $currentPageTitle Title of the current page - * @param string $templatePath Path to the template from which the breadcrumbs will be generated - * @param bool $skipFirstTemplatePage - * If set to true, the page from which parsing starts will not participate in the formation of breadcrumbs - * This option is useful when working with the _self value in a template, as it returns the full path to the - * current template, and the reference to it in breadcrumbs should not be clickable. + * @param array $context + * @param string|null $customPageTitle Custom title of the current page * * @return string - * @throws RuntimeError * @throws DependencyException + * @throws InvalidConfigurationParameterException * @throws LoaderError - * @throws SyntaxError * @throws NotFoundException - * @throws InvalidConfigurationParameterException + * @throws RuntimeError + * @throws SyntaxError */ public function __invoke( - string $currentPageTitle, - string $templatePath, - bool $skipFirstTemplatePage = true + array $context, + ?string $customPageTitle = null ): string { + $templatePath = $context[MainTwigEnvironment::CURRENT_TEMPLATE_NAME_KEY] ?? ''; $docUrl = $this->configuration->getOutputDirBaseUrl() . $templatePath; $breadcrumbs = $this->breadcrumbsHelper->getBreadcrumbs($templatePath, false); foreach ($breadcrumbs as $k => $breadcrumb) { $breadcrumbs[$k]['url'] = calculate_relative_url($docUrl, $breadcrumb['url']); } + $currentPageTitle = $customPageTitle ?: $this->breadcrumbsHelper->getTemplateTitle($templatePath); $content = $this->breadcrumbsTwig->render('breadcrumbs.md.twig', [ 'currentPageTitle' => $currentPageTitle, 'breadcrumbs' => $breadcrumbs, ]); - $templatesBreadcrumbs = $this->breadcrumbsHelper->getBreadcrumbsForTemplates($templatePath, !$skipFirstTemplatePage); + $templatesBreadcrumbs = $this->breadcrumbsHelper->getBreadcrumbsForTemplates($templatePath); foreach ($templatesBreadcrumbs as $templateBreadcrumb) { $fileDependency = $this->dependencyFactory->createFileDependency( filePath: $templateBreadcrumb['template'], diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Entities_Map.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Entities_Map.md.twig index 356c08a3..e1ab12fc 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Entities_Map.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Entities_Map.md.twig @@ -2,7 +2,7 @@ title: Project entities map prevPage: Project structure --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Entities map diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Classes.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Classes.md.twig index 0be48680..8823806a 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Classes.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Classes.md.twig @@ -2,7 +2,7 @@ title: Project classes prevPage: Project structure --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Project classes diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Interfaces.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Interfaces.md.twig index ae2e5cff..1174f6a7 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Interfaces.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Interfaces.md.twig @@ -2,7 +2,7 @@ title: Project interfaces prevPage: Project structure --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Project interfaces diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Traits.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Traits.md.twig index afc78600..a8ce20be 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Traits.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/Project_Traits.md.twig @@ -2,7 +2,7 @@ title: Project traits prevPage: Project structure --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Project traits diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/index.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/index.md.twig index e8f94804..6a795e55 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/index.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/Daux/templates/-Project_Structure/index.md.twig @@ -2,7 +2,7 @@ title: Project structure prevPage: / --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Project structure diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/classes.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/classes.md.twig index 0be48680..8823806a 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/classes.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/classes.md.twig @@ -2,7 +2,7 @@ title: Project classes prevPage: Project structure --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Project classes diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/interfaces.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/interfaces.md.twig index ae2e5cff..1174f6a7 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/interfaces.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/interfaces.md.twig @@ -2,7 +2,7 @@ title: Project interfaces prevPage: Project structure --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Project interfaces diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/map.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/map.md.twig index 356c08a3..e1ab12fc 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/map.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/map.md.twig @@ -2,7 +2,7 @@ title: Project entities map prevPage: Project structure --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Entities map diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/readme.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/readme.md.twig index e8f94804..6a795e55 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/readme.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/readme.md.twig @@ -2,7 +2,7 @@ title: Project structure prevPage: / --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Project structure diff --git a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/traits.md.twig b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/traits.md.twig index afc78600..a8ce20be 100644 --- a/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/traits.md.twig +++ b/src/LanguageHandler/Php/Plugin/CorePlugin/EntityDocUnifiedPlace/templates/__structure/traits.md.twig @@ -2,7 +2,7 @@ title: Project traits prevPage: Project structure --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} # Project traits diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/PhpClassRendererTwigEnvironment.php b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/PhpClassRendererTwigEnvironment.php index 90a269a1..db1071a8 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/PhpClassRendererTwigEnvironment.php +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/PhpClassRendererTwigEnvironment.php @@ -4,7 +4,7 @@ namespace BumbleDocGen\LanguageHandler\Php\Renderer\EntityDocRenderer\PhpClassToMd; -use BumbleDocGen\Core\Renderer\Twig\Function\GenerateEntityBreadcrumbs; +use BumbleDocGen\Core\Renderer\Twig\Function\DrawEntityBreadcrumbs; use BumbleDocGen\Core\Renderer\Twig\MainExtension; use Twig\Environment; use Twig\Error\LoaderError; @@ -18,7 +18,7 @@ final class PhpClassRendererTwigEnvironment public function __construct( MainExtension $mainExtension, - GenerateEntityBreadcrumbs $generateEntityBreadcrumbsFunction + DrawEntityBreadcrumbs $drawEntityBreadcrumbsFunction ) { $loader = new FilesystemLoader([ __DIR__ . '/templates', @@ -26,9 +26,9 @@ public function __construct( $this->twig = new Environment($loader); $this->twig->addExtension($mainExtension); $this->twig->addFunction(new \Twig\TwigFunction( - $generateEntityBreadcrumbsFunction->getName(), - $generateEntityBreadcrumbsFunction, - $generateEntityBreadcrumbsFunction->getOptions() + $drawEntityBreadcrumbsFunction->getName(), + $drawEntityBreadcrumbsFunction, + $drawEntityBreadcrumbsFunction->getOptions() )); } diff --git a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/class.md.twig b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/class.md.twig index 65f72f5a..86516b5d 100644 --- a/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/class.md.twig +++ b/src/LanguageHandler/Php/Renderer/EntityDocRenderer/PhpClassToMd/templates/class.md.twig @@ -1,4 +1,4 @@ -{{ generateEntityBreadcrumbs(classEntity.getShortName(), docUrl, parentDocFilePath, false) }} +{{ drawEntityBreadcrumbs(classEntity.getShortName(), docUrl, parentDocFilePath, false) }} {% include '_classHeader.md.twig' %} {{ loadPluginsContent('', classEntity, constant('BumbleDocGen\\LanguageHandler\\Php\\Renderer\\EntityDocRenderer\\PhpClassToMd\\PhpClassToMdDocRenderer::BLOCK_AFTER_HEADER')) }} From a727e64e2fe34fb6111198f31744a18f9488a465 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Sat, 20 Jan 2024 00:45:03 +0300 Subject: [PATCH 31/32] Fixing template --- selfdoc/templates/tech/01_configuration.md.twig | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/selfdoc/templates/tech/01_configuration.md.twig b/selfdoc/templates/tech/01_configuration.md.twig index 9efb2e9e..6756d82e 100644 --- a/selfdoc/templates/tech/01_configuration.md.twig +++ b/selfdoc/templates/tech/01_configuration.md.twig @@ -1,10 +1,10 @@ --- -title: Configuration +title: About configuration prevPage: Technical description of the project --- {{ drawPageBreadcrumbs() }} -# Configuration +# About configuration Documentation generator configuration can be stored in special files. They can be in different formats: yaml, json, php arrays, ini, xml From a5a19d8f18b1241d839b5171c5d852e2ef50bb77 Mon Sep 17 00:00:00 2001 From: fshcherbanich Date: Sat, 20 Jan 2024 00:45:28 +0300 Subject: [PATCH 32/32] Updating doc --- docs/shared_c.cache | 2 +- docs/tech/01_configuration.md | 12 +- docs/tech/02_parser/entity.md | 2 +- docs/tech/02_parser/entityFilterCondition.md | 2 +- docs/tech/02_parser/readme.md | 2 +- .../php/phpClassConstantReflectionApi.md | 2 +- .../php/phpClassMethodReflectionApi.md | 2 +- .../php/phpClassPropertyReflectionApi.md | 2 +- .../php/phpClassReflectionApi.md | 2 +- .../php/phpEntitiesCollection.md | 2 +- .../reflectionApi/php/phpEnumReflectionApi.md | 2 +- .../php/phpInterfaceReflectionApi.md | 2 +- .../php/phpTraitReflectionApi.md | 2 +- .../02_parser/reflectionApi/php/readme.md | 2 +- docs/tech/02_parser/reflectionApi/readme.md | 2 +- docs/tech/02_parser/sourceLocator.md | 2 +- .../01_howToCreateTemplates/frontMatter.md | 2 +- .../01_howToCreateTemplates/readme.md | 4 +- .../templatesDynamicBlocks.md | 2 +- .../templatesLinking.md | 2 +- .../templatesVariables.md | 2 +- docs/tech/03_renderer/02_breadcrumbs.md | 8 +- docs/tech/03_renderer/03_documentStructure.md | 2 +- docs/tech/03_renderer/04_twigCustomFilters.md | 2 +- .../03_renderer/05_twigCustomFunctions.md | 52 ++-- ...eBreadcrumbs.md => DrawPageBreadcrumbs.md} | 25 +- ...adcrumbs_2.md => DrawPageBreadcrumbs_2.md} | 25 +- docs/tech/03_renderer/readme.md | 2 +- docs/tech/04_pluginSystem.md | 2 +- docs/tech/05_console.md | 2 +- docs/tech/06_debugging.md | 2 +- docs/tech/07_outputFormat.md | 2 +- docs/tech/classes/AddIndentFromLeft.md | 2 +- docs/tech/classes/BasePageLinkProcessor.md | 2 +- docs/tech/classes/Configuration.md | 2 +- docs/tech/classes/Configuration_2.md | 245 ++++++++++++++++++ docs/tech/classes/DrawDocumentationMenu.md | 2 +- docs/tech/classes/DrawDocumentedEntityLink.md | 2 +- ...eBreadcrumbs.md => DrawPageBreadcrumbs.md} | 27 +- docs/tech/classes/FileGetContents.md | 2 +- docs/tech/classes/FixStrSize.md | 2 +- docs/tech/classes/GetDocumentationPageUrl.md | 2 +- docs/tech/classes/GetDocumentedEntityUrl.md | 2 +- docs/tech/classes/Implode.md | 2 +- docs/tech/classes/LoadPluginsContent.md | 2 +- docs/tech/classes/PageHtmlLinkerPlugin.md | 2 +- docs/tech/classes/PageLinkerPlugin.md | 2 +- docs/tech/classes/PregMatch.md | 2 +- docs/tech/classes/PrepareSourceLink.md | 2 +- .../classes/PrintEntityCollectionAsList.md | 2 +- docs/tech/classes/Quotemeta.md | 2 +- docs/tech/classes/RemoveLineBrakes.md | 2 +- docs/tech/classes/StrTypeToUrl.md | 2 +- docs/tech/readme.md | 2 +- 54 files changed, 357 insertions(+), 133 deletions(-) rename docs/tech/03_renderer/classes/{GeneratePageBreadcrumbs.md => DrawPageBreadcrumbs.md} (68%) rename docs/tech/03_renderer/classes/{GeneratePageBreadcrumbs_2.md => DrawPageBreadcrumbs_2.md} (68%) create mode 100644 docs/tech/classes/Configuration_2.md rename docs/tech/classes/{GeneratePageBreadcrumbs.md => DrawPageBreadcrumbs.md} (66%) diff --git a/docs/shared_c.cache b/docs/shared_c.cache index a91397ea..44020963 100644 --- a/docs/shared_c.cache +++ b/docs/shared_c.cache @@ -1 +1 @@ -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 \ No newline at end of file +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 \ No newline at end of file diff --git a/docs/tech/01_configuration.md b/docs/tech/01_configuration.md index 732dc2b5..0c236b5e 100644 --- a/docs/tech/01_configuration.md +++ b/docs/tech/01_configuration.md @@ -1,18 +1,18 @@ [BumbleDocGen](../README.md) **/** [Technical description of the project](readme.md) **/** -Configuration +About configuration --- -# Configuration +# About configuration Documentation generator configuration can be stored in special files. They can be in different formats: yaml, json, php arrays, ini, xml But it is not necessary to use files to store the configuration; you can also initialize the documentation generator instance by passing there an array of configuration parameters (see demo-5) -During the instance creation process, configuration data is loaded into [Configuration](/docs/tech/01_configuration.md) class, and the code works directly with it. +During the instance creation process, configuration data is loaded into [Configuration](classes/Configuration.md) class, and the code works directly with it. # Configuration file example @@ -89,13 +89,13 @@ The inheritance algorithm is as follows: scalar types can be overwritten by each | **`language_handlers`** | array<LanguageHandlerInterface> | NULL | List of programming language handlers | | **`source_locators`** | array<SourceLocatorInterface> | NULL | List of source locators | | **`use_shared_cache`** | bool | true | Enable cache usage of generated documents | -| **`twig_functions`** | array<CustomFunctionInterface> |
                • [DrawDocumentationMenu](classes/DrawDocumentationMenu.md)
                • [DrawDocumentedEntityLink](classes/DrawDocumentedEntityLink.md)
                • [GeneratePageBreadcrumbs](classes/GeneratePageBreadcrumbs.md)
                • [GetDocumentedEntityUrl](classes/GetDocumentedEntityUrl.md)
                • [LoadPluginsContent](classes/LoadPluginsContent.md)
                • [PrintEntityCollectionAsList](classes/PrintEntityCollectionAsList.md)
                • [GetDocumentationPageUrl](classes/GetDocumentationPageUrl.md)
                • [FileGetContents](classes/FileGetContents.md)
                | Functions that can be used in document templates | +| **`twig_functions`** | array<CustomFunctionInterface> |
                • [DrawDocumentationMenu](classes/DrawDocumentationMenu.md)
                • [DrawDocumentedEntityLink](classes/DrawDocumentedEntityLink.md)
                • [DrawPageBreadcrumbs](classes/DrawPageBreadcrumbs.md)
                • [GetDocumentedEntityUrl](classes/GetDocumentedEntityUrl.md)
                • [LoadPluginsContent](classes/LoadPluginsContent.md)
                • [PrintEntityCollectionAsList](classes/PrintEntityCollectionAsList.md)
                • [GetDocumentationPageUrl](classes/GetDocumentationPageUrl.md)
                • [FileGetContents](classes/FileGetContents.md)
                | Functions that can be used in document templates | | **`twig_filters`** | array<CustomFilterInterface> |
                • [AddIndentFromLeft](classes/AddIndentFromLeft.md)
                • [FixStrSize](classes/FixStrSize.md)
                • [PrepareSourceLink](classes/PrepareSourceLink.md)
                • [Quotemeta](classes/Quotemeta.md)
                • [RemoveLineBrakes](classes/RemoveLineBrakes.md)
                • [StrTypeToUrl](classes/StrTypeToUrl.md)
                • [PregMatch](classes/PregMatch.md)
                • [Implode](classes/Implode.md)
                | Filters that can be used in document templates | -| **`plugins`** | array<PluginInterface> \| null |
                • [PageHtmlLinkerPlugin](classes/PageHtmlLinkerPlugin_2.md)
                • [PageLinkerPlugin](classes/PageLinkerPlugin_2.md)
                | List of plugins | +| **`plugins`** | array<PluginInterface> \| null |
                • [PageHtmlLinkerPlugin](classes/PageHtmlLinkerPlugin.md)
                • [PageLinkerPlugin](classes/PageLinkerPlugin.md)
                | List of plugins | | **`additional_console_commands`** | array<Command> | NULL | Additional console commands | --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 17:19:08 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:45:03 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/entity.md b/docs/tech/02_parser/entity.md index 328c0460..17fd1306 100644 --- a/docs/tech/02_parser/entity.md +++ b/docs/tech/02_parser/entity.md @@ -80,4 +80,4 @@ These classes are a convenient wrapper for accessing data in templates: --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 17:19:08 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/entityFilterCondition.md b/docs/tech/02_parser/entityFilterCondition.md index 2877d19d..e69a3381 100644 --- a/docs/tech/02_parser/entityFilterCondition.md +++ b/docs/tech/02_parser/entityFilterCondition.md @@ -108,4 +108,4 @@ Filter condition for working with entities PHP language handler: --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/readme.md b/docs/tech/02_parser/readme.md index 2aa9466a..30192a2a 100644 --- a/docs/tech/02_parser/readme.md +++ b/docs/tech/02_parser/readme.md @@ -59,4 +59,4 @@ $rootEntityCollectionsGroup = $this->parser->getRootEntityCollectionsGroup(); --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md index c8bcb6a6..ca1be811 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpClassConstantReflectionApi.md @@ -57,4 +57,4 @@ $constantReflection = $classReflection->getConstant('constantName'); --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md index a892aa18..4c88784f 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpClassMethodReflectionApi.md @@ -70,4 +70,4 @@ $methodReflection = $classReflection->getMethod('methodName'); --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md index 269bc3e2..98044883 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpClassPropertyReflectionApi.md @@ -61,4 +61,4 @@ $propertyReflection = $classReflection->getProperty('propertyName'); --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md index 93b74235..4f3465c7 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpClassReflectionApi.md @@ -94,4 +94,4 @@ $classReflection = $entitiesCollection->getLoadedOrCreateNew('SomeClassName'); / --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md b/docs/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md index 092b3021..d4dbeeb7 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md +++ b/docs/tech/02_parser/reflectionApi/php/phpEntitiesCollection.md @@ -33,4 +33,4 @@ PHP entities collection --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md index 50db531e..8f455f7b 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpEnumReflectionApi.md @@ -93,4 +93,4 @@ $enumReflection = $entitiesCollection->getLoadedOrCreateNew('SomeEnumName'); // --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md index 71dbc524..533269a8 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpInterfaceReflectionApi.md @@ -90,4 +90,4 @@ $interfaceReflection = $entitiesCollection->getLoadedOrCreateNew('SomeInterfaceN --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md b/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md index 47bcaed1..88175a3f 100644 --- a/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md +++ b/docs/tech/02_parser/reflectionApi/php/phpTraitReflectionApi.md @@ -90,4 +90,4 @@ $traitReflection = $entitiesCollection->getLoadedOrCreateNew('SomeTraitName'); / --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/php/readme.md b/docs/tech/02_parser/reflectionApi/php/readme.md index 453d797e..5694ced1 100644 --- a/docs/tech/02_parser/reflectionApi/php/readme.md +++ b/docs/tech/02_parser/reflectionApi/php/readme.md @@ -95,4 +95,4 @@ $firstMethodReturnValue = $methodReflection->getFirstReturnValue(); --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/reflectionApi/readme.md b/docs/tech/02_parser/reflectionApi/readme.md index 3cb6390f..643c51c7 100644 --- a/docs/tech/02_parser/reflectionApi/readme.md +++ b/docs/tech/02_parser/reflectionApi/readme.md @@ -66,4 +66,4 @@ In addition, [RootEntityCollectionsGroup](classes/RootEntityCollectionsGroup.md) --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/02_parser/sourceLocator.md b/docs/tech/02_parser/sourceLocator.md index b74684d6..62e0189e 100644 --- a/docs/tech/02_parser/sourceLocator.md +++ b/docs/tech/02_parser/sourceLocator.md @@ -34,4 +34,4 @@ You can create your own source locators or use any existing ones. All source loc --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md b/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md index d492eccf..775ee369 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/frontMatter.md @@ -34,4 +34,4 @@ This block is also used when generating HTML documentation. You can learn about --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/readme.md b/docs/tech/03_renderer/01_howToCreateTemplates/readme.md index 08c47d92..1b5fe4dd 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/readme.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/readme.md @@ -36,7 +36,7 @@ After generating the documentation, this page will look exactly like a template. title: Some page prevPage: Technical description of the project --- -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} Some static text... @@ -102,4 +102,4 @@ More static text... --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Fri Jan 19 23:21:14 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md b/docs/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md index a8288d3d..b32feb31 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/templatesDynamicBlocks.md @@ -30,4 +30,4 @@ You can use the built-in functions and filters or add your own, so you can imple --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md b/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md index 1862c943..0f435d63 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/templatesLinking.md @@ -45,4 +45,4 @@ You can also implement your own functions for relinking if necessary. --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md b/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md index 661d1361..d2f9eb6f 100644 --- a/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md +++ b/docs/tech/03_renderer/01_howToCreateTemplates/templatesVariables.md @@ -20,4 +20,4 @@ There are several variables available in each processed template. --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/02_breadcrumbs.md b/docs/tech/03_renderer/02_breadcrumbs.md index 250d3ef8..50816b8e 100644 --- a/docs/tech/03_renderer/02_breadcrumbs.md +++ b/docs/tech/03_renderer/02_breadcrumbs.md @@ -33,11 +33,11 @@ In this way, complex documentation structures can be created with less file nest ## Displaying breadcrumbs in documents -There is a built-in function to generate breadcrumbs in templates [GeneratePageBreadcrumbs](classes/GeneratePageBreadcrumbs_2.md). +There is a built-in function to generate breadcrumbs in templates [DrawPageBreadcrumbs](classes/DrawPageBreadcrumbs_2.md). Here is how it is used in twig templates: ```twig -{{ generatePageBreadcrumbs(title, _self) }} +{{ drawPageBreadcrumbs() }} ``` To build breadcrumbs, the previously compiled project structure and the names of each template are used. @@ -49,7 +49,7 @@ title: Some page title --- ``` -Here is an example of the result of the `generatePageBreadcrumbs` function: +Here is an example of the result of the `drawPageBreadcrumbs` function: ```twig BumbleDocGen / Technical description of the project / Renderer / Some page title
                @@ -58,4 +58,4 @@ Here is an example of the result of the `generatePageBreadcrumbs` function: --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Fri Jan 19 23:21:14 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/03_documentStructure.md b/docs/tech/03_renderer/03_documentStructure.md index e2a1c5ba..0bb672fb 100644 --- a/docs/tech/03_renderer/03_documentStructure.md +++ b/docs/tech/03_renderer/03_documentStructure.md @@ -25,4 +25,4 @@ plugins: --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/04_twigCustomFilters.md b/docs/tech/03_renderer/04_twigCustomFilters.md index c2ca53b8..5bcbc532 100644 --- a/docs/tech/03_renderer/04_twigCustomFilters.md +++ b/docs/tech/03_renderer/04_twigCustomFilters.md @@ -264,4 +264,4 @@ Here is a list of filters available by default: --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/05_twigCustomFunctions.md b/docs/tech/03_renderer/05_twigCustomFunctions.md index 45768fc2..0c1982da 100644 --- a/docs/tech/03_renderer/05_twigCustomFunctions.md +++ b/docs/tech/03_renderer/05_twigCustomFunctions.md @@ -148,59 +148,47 @@ Here is a list of functions available by default:   - - - - fileGetContents
                - Displaying the content of a file or web resource - - - $resourceName - - - [string](https://www.php.net/manual/en/language.types.string.php) - - Resource name, url or path to the resource. The path can contain shortcodes with parameters from the configuration (%param_name%) - - -   - - generatePageBreadcrumbs
                + + drawPageBreadcrumbs
                Function to generate breadcrumbs on the page - $currentPageTitle + $context - [string](https://www.php.net/manual/en/language.types.string.php) + [array](https://www.php.net/manual/en/language.types.array.php) - Title of the current page + - $templatePath + $customPageTitle - [string](https://www.php.net/manual/en/language.types.string.php) + [string](https://www.php.net/manual/en/language.types.string.php) | [null](https://www.php.net/manual/en/language.types.null.php) - Path to the template from which the breadcrumbs will be generated - - - + Custom title of the current page - + +   + + + + fileGetContents
                + Displaying the content of a file or web resource + - $skipFirstTemplatePage + $resourceName - [bool](https://www.php.net/manual/en/language.types.boolean.php) + [string](https://www.php.net/manual/en/language.types.string.php) - If set to true, the page from which parsing starts will not participate in the formation of breadcrumbs This option is useful when working with the _self value in a template, as it returns the full path to the current template, and the reference to it in breadcrumbs should not be clickable. + Resource name, url or path to the resource. The path can contain shortcodes with parameters from the configuration (%param_name%)   @@ -479,4 +467,4 @@ Here is a list of functions available by default: --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs.md b/docs/tech/03_renderer/classes/DrawPageBreadcrumbs.md similarity index 68% rename from docs/tech/03_renderer/classes/GeneratePageBreadcrumbs.md rename to docs/tech/03_renderer/classes/DrawPageBreadcrumbs.md index 3e2cac1f..560130af 100644 --- a/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs.md +++ b/docs/tech/03_renderer/classes/DrawPageBreadcrumbs.md @@ -2,17 +2,17 @@ [Technical description of the project](../../readme.md) **/** [Renderer](../readme.md) **/** [Template functions](../05_twigCustomFunctions.md) **/** -GeneratePageBreadcrumbs +DrawPageBreadcrumbs --- -# [GeneratePageBreadcrumbs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L24) class: +# [DrawPageBreadcrumbs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php#L25) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; -final class GeneratePageBreadcrumbs implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface +final class DrawPageBreadcrumbs implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` Function to generate breadcrumbs on the page @@ -22,7 +22,7 @@ Function to generate breadcrumbs on the page - +
                Function name:generatePageBreadcrumbsdrawPageBreadcrumbs
                @@ -37,7 +37,7 @@ Function to generate breadcrumbs on the page ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L26) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php#L27) ```php public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsTwigEnvironment $breadcrumbsTwig, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); ``` @@ -54,26 +54,23 @@ $dependencyFactory | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDep --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L63) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php#L61) ```php -public function __invoke(string $currentPageTitle, string $templatePath, bool $skipFirstTemplatePage = true): string; +public function __invoke(array $context, string|null $customPageTitle = null): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| -$currentPageTitle | [string](https://www.php.net/manual/en/language.types.string.php) | Title of the current page | -$templatePath | [string](https://www.php.net/manual/en/language.types.string.php) | Path to the template from which the breadcrumbs will be generated | -$skipFirstTemplatePage | [bool](https://www.php.net/manual/en/language.types.boolean.php) | If set to true, the page from which parsing starts will not participate in the formation of breadcrumbs - This option is useful when working with the _self value in a template, as it returns the full path to the - current template, and the reference to it in breadcrumbs should not be clickable. | +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | +$customPageTitle | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Custom title of the current page | ***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) --- -# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L35) +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php#L36) ```php public static function getName(): string; ``` @@ -82,7 +79,7 @@ public static function getName(): string; --- -# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L40) +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php#L41) ```php public static function getOptions(): array; ``` diff --git a/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs_2.md b/docs/tech/03_renderer/classes/DrawPageBreadcrumbs_2.md similarity index 68% rename from docs/tech/03_renderer/classes/GeneratePageBreadcrumbs_2.md rename to docs/tech/03_renderer/classes/DrawPageBreadcrumbs_2.md index 94ddb768..7a09cdd1 100644 --- a/docs/tech/03_renderer/classes/GeneratePageBreadcrumbs_2.md +++ b/docs/tech/03_renderer/classes/DrawPageBreadcrumbs_2.md @@ -2,17 +2,17 @@ [Technical description of the project](../../readme.md) **/** [Renderer](../readme.md) **/** [Documentation structure and breadcrumbs](../02_breadcrumbs.md) **/** -GeneratePageBreadcrumbs +DrawPageBreadcrumbs --- -# [GeneratePageBreadcrumbs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L24) class: +# [DrawPageBreadcrumbs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php#L25) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; -final class GeneratePageBreadcrumbs implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface +final class DrawPageBreadcrumbs implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` Function to generate breadcrumbs on the page @@ -22,7 +22,7 @@ Function to generate breadcrumbs on the page - +
                Function name:generatePageBreadcrumbsdrawPageBreadcrumbs
                @@ -37,7 +37,7 @@ Function to generate breadcrumbs on the page ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L26) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php#L27) ```php public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsTwigEnvironment $breadcrumbsTwig, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); ``` @@ -54,26 +54,23 @@ $dependencyFactory | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDep --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L63) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php#L61) ```php -public function __invoke(string $currentPageTitle, string $templatePath, bool $skipFirstTemplatePage = true): string; +public function __invoke(array $context, string|null $customPageTitle = null): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| -$currentPageTitle | [string](https://www.php.net/manual/en/language.types.string.php) | Title of the current page | -$templatePath | [string](https://www.php.net/manual/en/language.types.string.php) | Path to the template from which the breadcrumbs will be generated | -$skipFirstTemplatePage | [bool](https://www.php.net/manual/en/language.types.boolean.php) | If set to true, the page from which parsing starts will not participate in the formation of breadcrumbs - This option is useful when working with the _self value in a template, as it returns the full path to the - current template, and the reference to it in breadcrumbs should not be clickable. | +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | +$customPageTitle | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Custom title of the current page | ***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) --- -# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L35) +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php#L36) ```php public static function getName(): string; ``` @@ -82,7 +79,7 @@ public static function getName(): string; --- -# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L40) +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php#L41) ```php public static function getOptions(): array; ``` diff --git a/docs/tech/03_renderer/readme.md b/docs/tech/03_renderer/readme.md index 566240be..b4aabe56 100644 --- a/docs/tech/03_renderer/readme.md +++ b/docs/tech/03_renderer/readme.md @@ -73,4 +73,4 @@ This process is presented in the form of a diagram below. --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/04_pluginSystem.md b/docs/tech/04_pluginSystem.md index 2d276f48..ea6d300c 100644 --- a/docs/tech/04_pluginSystem.md +++ b/docs/tech/04_pluginSystem.md @@ -94,4 +94,4 @@ plugins: --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 17:19:08 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/05_console.md b/docs/tech/05_console.md index 2a2546d1..2f695681 100644 --- a/docs/tech/05_console.md +++ b/docs/tech/05_console.md @@ -36,4 +36,4 @@ After adding a new command to the configuration, it will be available in the app --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 17:19:08 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/06_debugging.md b/docs/tech/06_debugging.md index 379dc3d2..299542b9 100644 --- a/docs/tech/06_debugging.md +++ b/docs/tech/06_debugging.md @@ -27,4 +27,4 @@ Our tool provides several options for debugging documentation. --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Fri Jan 19 23:16:37 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/07_outputFormat.md b/docs/tech/07_outputFormat.md index 0d8c724e..78f88c1f 100644 --- a/docs/tech/07_outputFormat.md +++ b/docs/tech/07_outputFormat.md @@ -42,4 +42,4 @@ However, it is possible to create other files with some restrictions. --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file diff --git a/docs/tech/classes/AddIndentFromLeft.md b/docs/tech/classes/AddIndentFromLeft.md index c84d3092..0646aab6 100644 --- a/docs/tech/classes/AddIndentFromLeft.md +++ b/docs/tech/classes/AddIndentFromLeft.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Configuration](../01_configuration.md) **/** +[About configuration](../01_configuration.md) **/** AddIndentFromLeft --- diff --git a/docs/tech/classes/BasePageLinkProcessor.md b/docs/tech/classes/BasePageLinkProcessor.md index 7eee8d18..790a433f 100644 --- a/docs/tech/classes/BasePageLinkProcessor.md +++ b/docs/tech/classes/BasePageLinkProcessor.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Configuration](../01_configuration.md) **/** +[About configuration](../01_configuration.md) **/** BasePageLinkProcessor --- diff --git a/docs/tech/classes/Configuration.md b/docs/tech/classes/Configuration.md index 02c63760..6b105faa 100644 --- a/docs/tech/classes/Configuration.md +++ b/docs/tech/classes/Configuration.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Console app](../05_console.md) **/** +[About configuration](../01_configuration.md) **/** Configuration --- diff --git a/docs/tech/classes/Configuration_2.md b/docs/tech/classes/Configuration_2.md new file mode 100644 index 00000000..02c63760 --- /dev/null +++ b/docs/tech/classes/Configuration_2.md @@ -0,0 +1,245 @@ +[BumbleDocGen](../../README.md) **/** +[Technical description of the project](../readme.md) **/** +[Console app](../05_console.md) **/** +Configuration + +--- + + +# [Configuration](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L30) class: + +```php +namespace BumbleDocGen\Core\Configuration; + +final class Configuration +``` +Configuration project documentation + +## Initialization methods + +1. [__construct](#m-construct) +## Methods + +1. [getAdditionalConsoleCommands](#mgetadditionalconsolecommands) +1. [getCacheDir](#mgetcachedir) +1. [getConfigurationVersion](#mgetconfigurationversion) +1. [getDocGenLibDir](#mgetdocgenlibdir) +1. [getGitClientPath](#mgetgitclientpath) +1. [getIfExists](#mgetifexists) +1. [getLanguageHandlersCollection](#mgetlanguagehandlerscollection) +1. [getOutputDir](#mgetoutputdir) +1. [getOutputDirBaseUrl](#mgetoutputdirbaseurl) +1. [getPageLinkProcessor](#mgetpagelinkprocessor) +1. [getPlugins](#mgetplugins) +1. [getProjectRoot](#mgetprojectroot) +1. [getSourceLocators](#mgetsourcelocators) +1. [getTemplatesDir](#mgettemplatesdir) +1. [getTwigFilters](#mgettwigfilters) +1. [getTwigFunctions](#mgettwigfunctions) +1. [getWorkingDir](#mgetworkingdir) +1. [isCheckFileInGitBeforeCreatingDocEnabled](#mischeckfileingitbeforecreatingdocenabled) +1. [renderWithFrontMatter](#mrenderwithfrontmatter) +1. [useSharedCache](#musesharedcache) + +## Methods details: + +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L34) +```php +public function __construct(\BumbleDocGen\Core\Configuration\ConfigurationParameterBag $parameterBag, \BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache $localObjectCache, \Psr\Log\LoggerInterface $logger); +``` + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$parameterBag | [\BumbleDocGen\Core\Configuration\ConfigurationParameterBag](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/ConfigurationParameterBag.php) | - | +$localObjectCache | [\BumbleDocGen\Core\Cache\LocalCache\LocalObjectCache](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Cache/LocalCache/LocalObjectCache.php) | - | +$logger | [\Psr\Log\LoggerInterface](https://github.com/php-fig/log/blob/master/src/LoggerInterface.php) | - | + +--- + +# `getAdditionalConsoleCommands` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L377) +```php +public function getAdditionalConsoleCommands(): \BumbleDocGen\Console\Command\AdditionalCommandCollection; +``` + +***Return value:*** [\BumbleDocGen\Console\Command\AdditionalCommandCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Console/Command/AdditionalCommandCollection.php) + +--- + +# `getCacheDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L205) +```php +public function getCacheDir(): null|string; +``` + +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) + +--- + +# `getConfigurationVersion` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L42) +```php +public function getConfigurationVersion(): string; +``` + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- + +# `getDocGenLibDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L367) +```php +public function getDocGenLibDir(): string; +``` + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- + +# `getGitClientPath` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L256) +```php +public function getGitClientPath(): string; +``` + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- + +# `getIfExists` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L395) +```php +public function getIfExists(mixed $key): null|string; +``` + +***Parameters:*** + +| Name | Type | Description | +|:-|:-|:-| +$key | [mixed](https://www.php.net/manual/en/language.types.mixed.php) | - | + +***Return value:*** [null](https://www.php.net/manual/en/language.types.null.php) | [string](https://www.php.net/manual/en/language.types.string.php) + +--- + +# `getLanguageHandlersCollection` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L166) +```php +public function getLanguageHandlersCollection(): \BumbleDocGen\LanguageHandler\LanguageHandlersCollection; +``` + +***Return value:*** [\BumbleDocGen\LanguageHandler\LanguageHandlersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/LanguageHandler/LanguageHandlersCollection.php) + +--- + +# `getOutputDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L112) +```php +public function getOutputDir(): string; +``` + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- + +# `getOutputDirBaseUrl` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L150) +```php +public function getOutputDirBaseUrl(): string; +``` + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- + +# `getPageLinkProcessor` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L238) +```php +public function getPageLinkProcessor(): \BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface; +``` + +***Return value:*** [\BumbleDocGen\Core\Renderer\PageLinkProcessor\PageLinkProcessorInterface](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/PageLinkProcessor/PageLinkProcessorInterface.php) + +--- + +# `getPlugins` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L187) +```php +public function getPlugins(): \BumbleDocGen\Core\Plugin\PluginsCollection; +``` + +***Return value:*** [\BumbleDocGen\Core\Plugin\PluginsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Plugin/PluginsCollection.php) + +--- + +# `getProjectRoot` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L50) +```php +public function getProjectRoot(): string; +``` + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- + +# `getSourceLocators` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L66) +```php +public function getSourceLocators(): \BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection; +``` + +***Return value:*** [\BumbleDocGen\Core\Parser\SourceLocator\SourceLocatorsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Parser/SourceLocator/SourceLocatorsCollection.php) + +--- + +# `getTemplatesDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L84) +```php +public function getTemplatesDir(): string; +``` + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- + +# `getTwigFilters` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L295) +```php +public function getTwigFilters(): \BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection; +``` + +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Filter\CustomFiltersCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Filter/CustomFiltersCollection.php) + +--- + +# `getTwigFunctions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L272) +```php +public function getTwigFunctions(): \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection; +``` + +***Return value:*** [\BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionsCollection](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/CustomFunctionsCollection.php) + +--- + +# `getWorkingDir` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L358) +```php +public function getWorkingDir(): string; +``` + +***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) + +--- + +# `isCheckFileInGitBeforeCreatingDocEnabled` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L344) +```php +public function isCheckFileInGitBeforeCreatingDocEnabled(): bool; +``` + +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) + +--- + +# `renderWithFrontMatter` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L330) +```php +public function renderWithFrontMatter(): bool; +``` + +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) + +--- + +# `useSharedCache` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Configuration/Configuration.php#L316) +```php +public function useSharedCache(): bool; +``` + +***Return value:*** [bool](https://www.php.net/manual/en/language.types.boolean.php) + +--- diff --git a/docs/tech/classes/DrawDocumentationMenu.md b/docs/tech/classes/DrawDocumentationMenu.md index 917e17fd..749a7e02 100644 --- a/docs/tech/classes/DrawDocumentationMenu.md +++ b/docs/tech/classes/DrawDocumentationMenu.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Configuration](../01_configuration.md) **/** +[About configuration](../01_configuration.md) **/** DrawDocumentationMenu --- diff --git a/docs/tech/classes/DrawDocumentedEntityLink.md b/docs/tech/classes/DrawDocumentedEntityLink.md index 1a5d4233..aee5bb41 100644 --- a/docs/tech/classes/DrawDocumentedEntityLink.md +++ b/docs/tech/classes/DrawDocumentedEntityLink.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Configuration](../01_configuration.md) **/** +[About configuration](../01_configuration.md) **/** DrawDocumentedEntityLink --- diff --git a/docs/tech/classes/GeneratePageBreadcrumbs.md b/docs/tech/classes/DrawPageBreadcrumbs.md similarity index 66% rename from docs/tech/classes/GeneratePageBreadcrumbs.md rename to docs/tech/classes/DrawPageBreadcrumbs.md index 099070f6..c5d9929f 100644 --- a/docs/tech/classes/GeneratePageBreadcrumbs.md +++ b/docs/tech/classes/DrawPageBreadcrumbs.md @@ -1,17 +1,17 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Configuration](../01_configuration.md) **/** -GeneratePageBreadcrumbs +[About configuration](../01_configuration.md) **/** +DrawPageBreadcrumbs --- -# [GeneratePageBreadcrumbs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L24) class: +# [DrawPageBreadcrumbs](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php#L25) class: ```php namespace BumbleDocGen\Core\Renderer\Twig\Function; -final class GeneratePageBreadcrumbs implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface +final class DrawPageBreadcrumbs implements \BumbleDocGen\Core\Renderer\Twig\Function\CustomFunctionInterface ``` Function to generate breadcrumbs on the page @@ -21,7 +21,7 @@ Function to generate breadcrumbs on the page - +
                Function name:generatePageBreadcrumbsdrawPageBreadcrumbs
                @@ -36,7 +36,7 @@ Function to generate breadcrumbs on the page ## Methods details: -# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L26) +# `__construct` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php#L27) ```php public function __construct(\BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsHelper $breadcrumbsHelper, \BumbleDocGen\Core\Renderer\Breadcrumbs\BreadcrumbsTwigEnvironment $breadcrumbsTwig, \BumbleDocGen\Core\Renderer\Context\RendererContext $rendererContext, \BumbleDocGen\Core\Configuration\Configuration $configuration, \BumbleDocGen\Core\Renderer\Context\Dependency\RendererDependencyFactory $dependencyFactory); ``` @@ -53,26 +53,23 @@ $dependencyFactory | [\BumbleDocGen\Core\Renderer\Context\Dependency\RendererDep --- -# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L63) +# `__invoke` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php#L61) ```php -public function __invoke(string $currentPageTitle, string $templatePath, bool $skipFirstTemplatePage = true): string; +public function __invoke(array $context, string|null $customPageTitle = null): string; ``` ***Parameters:*** | Name | Type | Description | |:-|:-|:-| -$currentPageTitle | [string](https://www.php.net/manual/en/language.types.string.php) | Title of the current page | -$templatePath | [string](https://www.php.net/manual/en/language.types.string.php) | Path to the template from which the breadcrumbs will be generated | -$skipFirstTemplatePage | [bool](https://www.php.net/manual/en/language.types.boolean.php) | If set to true, the page from which parsing starts will not participate in the formation of breadcrumbs - This option is useful when working with the _self value in a template, as it returns the full path to the - current template, and the reference to it in breadcrumbs should not be clickable. | +$context | [array](https://www.php.net/manual/en/language.types.array.php) | - | +$customPageTitle | [string](https://www.php.net/manual/en/language.types.string.php) \| [null](https://www.php.net/manual/en/language.types.null.php) | Custom title of the current page | ***Return value:*** [string](https://www.php.net/manual/en/language.types.string.php) --- -# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L35) +# `getName` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php#L36) ```php public static function getName(): string; ``` @@ -81,7 +78,7 @@ public static function getName(): string; --- -# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/GeneratePageBreadcrumbs.php#L40) +# `getOptions` **|** [source code](https://github.com/bumble-tech/bumble-doc-gen/blob/master/src/Core/Renderer/Twig/Function/DrawPageBreadcrumbs.php#L41) ```php public static function getOptions(): array; ``` diff --git a/docs/tech/classes/FileGetContents.md b/docs/tech/classes/FileGetContents.md index c8d74ace..506deff5 100644 --- a/docs/tech/classes/FileGetContents.md +++ b/docs/tech/classes/FileGetContents.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Configuration](../01_configuration.md) **/** +[About configuration](../01_configuration.md) **/** FileGetContents --- diff --git a/docs/tech/classes/FixStrSize.md b/docs/tech/classes/FixStrSize.md index f095014b..94c955b2 100644 --- a/docs/tech/classes/FixStrSize.md +++ b/docs/tech/classes/FixStrSize.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Configuration](../01_configuration.md) **/** +[About configuration](../01_configuration.md) **/** FixStrSize --- diff --git a/docs/tech/classes/GetDocumentationPageUrl.md b/docs/tech/classes/GetDocumentationPageUrl.md index 7e8150dd..df1596fb 100644 --- a/docs/tech/classes/GetDocumentationPageUrl.md +++ b/docs/tech/classes/GetDocumentationPageUrl.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Configuration](../01_configuration.md) **/** +[About configuration](../01_configuration.md) **/** GetDocumentationPageUrl --- diff --git a/docs/tech/classes/GetDocumentedEntityUrl.md b/docs/tech/classes/GetDocumentedEntityUrl.md index fd3f0384..a3e009c7 100644 --- a/docs/tech/classes/GetDocumentedEntityUrl.md +++ b/docs/tech/classes/GetDocumentedEntityUrl.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Configuration](../01_configuration.md) **/** +[About configuration](../01_configuration.md) **/** GetDocumentedEntityUrl --- diff --git a/docs/tech/classes/Implode.md b/docs/tech/classes/Implode.md index 3c9d56c8..ca7058ea 100644 --- a/docs/tech/classes/Implode.md +++ b/docs/tech/classes/Implode.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Configuration](../01_configuration.md) **/** +[About configuration](../01_configuration.md) **/** Implode --- diff --git a/docs/tech/classes/LoadPluginsContent.md b/docs/tech/classes/LoadPluginsContent.md index 26f06d1f..0214f70e 100644 --- a/docs/tech/classes/LoadPluginsContent.md +++ b/docs/tech/classes/LoadPluginsContent.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Configuration](../01_configuration.md) **/** +[About configuration](../01_configuration.md) **/** LoadPluginsContent --- diff --git a/docs/tech/classes/PageHtmlLinkerPlugin.md b/docs/tech/classes/PageHtmlLinkerPlugin.md index a42cb001..861e0c28 100644 --- a/docs/tech/classes/PageHtmlLinkerPlugin.md +++ b/docs/tech/classes/PageHtmlLinkerPlugin.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Plugin system](../04_pluginSystem.md) **/** +[About configuration](../01_configuration.md) **/** PageHtmlLinkerPlugin --- diff --git a/docs/tech/classes/PageLinkerPlugin.md b/docs/tech/classes/PageLinkerPlugin.md index 830f59ff..a34ead81 100644 --- a/docs/tech/classes/PageLinkerPlugin.md +++ b/docs/tech/classes/PageLinkerPlugin.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Plugin system](../04_pluginSystem.md) **/** +[About configuration](../01_configuration.md) **/** PageLinkerPlugin --- diff --git a/docs/tech/classes/PregMatch.md b/docs/tech/classes/PregMatch.md index 79235233..6aa8dde1 100644 --- a/docs/tech/classes/PregMatch.md +++ b/docs/tech/classes/PregMatch.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Configuration](../01_configuration.md) **/** +[About configuration](../01_configuration.md) **/** PregMatch --- diff --git a/docs/tech/classes/PrepareSourceLink.md b/docs/tech/classes/PrepareSourceLink.md index f17123ab..3df3c6a4 100644 --- a/docs/tech/classes/PrepareSourceLink.md +++ b/docs/tech/classes/PrepareSourceLink.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Configuration](../01_configuration.md) **/** +[About configuration](../01_configuration.md) **/** PrepareSourceLink --- diff --git a/docs/tech/classes/PrintEntityCollectionAsList.md b/docs/tech/classes/PrintEntityCollectionAsList.md index e736631e..11fc4a54 100644 --- a/docs/tech/classes/PrintEntityCollectionAsList.md +++ b/docs/tech/classes/PrintEntityCollectionAsList.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Configuration](../01_configuration.md) **/** +[About configuration](../01_configuration.md) **/** PrintEntityCollectionAsList --- diff --git a/docs/tech/classes/Quotemeta.md b/docs/tech/classes/Quotemeta.md index 462223a3..dd60d16e 100644 --- a/docs/tech/classes/Quotemeta.md +++ b/docs/tech/classes/Quotemeta.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Configuration](../01_configuration.md) **/** +[About configuration](../01_configuration.md) **/** Quotemeta --- diff --git a/docs/tech/classes/RemoveLineBrakes.md b/docs/tech/classes/RemoveLineBrakes.md index df705abd..9fd06ecf 100644 --- a/docs/tech/classes/RemoveLineBrakes.md +++ b/docs/tech/classes/RemoveLineBrakes.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Configuration](../01_configuration.md) **/** +[About configuration](../01_configuration.md) **/** RemoveLineBrakes --- diff --git a/docs/tech/classes/StrTypeToUrl.md b/docs/tech/classes/StrTypeToUrl.md index 47736dad..e89eda10 100644 --- a/docs/tech/classes/StrTypeToUrl.md +++ b/docs/tech/classes/StrTypeToUrl.md @@ -1,6 +1,6 @@ [BumbleDocGen](../../README.md) **/** [Technical description of the project](../readme.md) **/** -[Configuration](../01_configuration.md) **/** +[About configuration](../01_configuration.md) **/** StrTypeToUrl --- diff --git a/docs/tech/readme.md b/docs/tech/readme.md index d5bf4d03..6102614a 100644 --- a/docs/tech/readme.md +++ b/docs/tech/readme.md @@ -53,4 +53,4 @@ After that, the process of parsing the project code according to the configurati --- -**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Thu Jan 18 14:38:29 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file +**Last page committer:** fshcherbanich <filipp.shcherbanich@team.bumble.com>
                **Last modified date:** Sat Jan 20 00:42:48 2024 +0300
                **Page content update date:** Fri Jan 19 2024
                Made with [Bumble Documentation Generator](https://github.com/bumble-tech/bumble-doc-gen/blob/master/docs/README.md) \ No newline at end of file