TYPO3-translation/cms-core
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

TYPO3 v15 dev-main snapshot ()

Browse Source
This commit is contained in:
wappler
2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Classes/Configuration/Processor/Placeholder/EnvPlaceholderProcessor.php
+130
View File
@@ -0,0 +1,130 @@
<?php
declare(strict_types=1);
/*
* This file is part of the TYPO3 CMS project.
*
* It is free software; you can redistribute it and/or modify it under
* the terms of the GNU General Public License, either version 2
* of the License, or any later version.
*
* For the full copyright and license information, please read the
* LICENSE.txt file that was distributed with this source code.
*
* The TYPO3 project - inspiring people to share!
*/
namespace TYPO3\CMS\Core\Configuration\Processor\Placeholder;
use TYPO3\CMS\Core\Configuration\Processor\PlaceholderProcessorList;
use TYPO3\CMS\Core\Utility\GeneralUtility;
/**
* Can process a string consisting of one or multiple %env(...)% YAML
* placeholders, and replace them with their evaluated values.
* This in contrast to the EnvVariableProcessor, which only evaluates
* a single ENV value (without the placeholders), and is also utilized
* for the actual expansion here by means of the PlaceholderProcessorList.
*/
class EnvPlaceholderProcessor
{
// see also YamlFileLoader
public const PATTERN_PARTS = '%[^(%]+?\([\'"]?([^(]*?)[\'"]?\)%|%([^%()]*?)%';
protected array $processorList = [];
public function __construct(
) {
$processorList = GeneralUtility::makeInstance(
PlaceholderProcessorList::class,
$GLOBALS['TYPO3_CONF_VARS']['SYS']['yamlLoader']['placeholderProcessors']
);
$this->processorList = $processorList->compile();
}
public function canProcess(mixed $placeholder): bool
{
// only strings may be candidates for $placeholder substitution
if (!is_string($placeholder)) {
return false;
}
return str_contains($placeholder, '%env(');
}
public function process(string $value): string
{
return $this->processPlaceholderLine($value);
}
/**
* The following methods are taken from YamlFileLoader, but adapted
* for isolated usage and preventing circular dependencies.
*/
protected function processPlaceholderLine(string $line): string
{
$parts = $this->getParts($line);
foreach ($parts as $partKey => $part) {
$result = $this->processSinglePlaceholder($partKey, $part);
// Replace whole content if placeholder is the only thing in this line
if ($line === $partKey) {
$line = $result;
} elseif (is_string($result) || is_numeric($result)) {
$line = str_replace($partKey, $result, $line);
} else {
throw new \UnexpectedValueException(
'ENV Placeholder can not be substituted if result is not string or numeric',
1770965068
);
}
if ($result !== $partKey && $this->containsPlaceholder($line)) {
$line = $this->processPlaceholderLine($line);
}
}
return $line;
}
protected function processSinglePlaceholder(string $placeholder, string $value): mixed
{
foreach ($this->processorList as $processor) {
if ($processor->canProcess($placeholder, [])) {
try {
$result = $processor->process($value, []);
} catch (\UnexpectedValueException) {
$result = $placeholder;
}
break;
}
}
return $result ?? $placeholder;
}
// These two methods are used just as in YamlFileLoader and
// might be moved to utility classes; however for now they
// are replicated to be able to be adapted.
protected function getParts(string $placeholders): array
{
// find occurrences of placeholders like %some()% and %array.access%.
// Only find the innermost ones, so we can nest them.
preg_match_all(
'/' . self::PATTERN_PARTS . '/',
$placeholders,
$parts,
PREG_UNMATCHED_AS_NULL
);
$matches = array_filter(
array_merge($parts[1], $parts[2])
);
return array_combine($parts[0], $matches);
}
/**
* Finds possible placeholders.
* May find false positives for complexer structures, but they will be sorted later on.
*/
protected function containsPlaceholder(mixed $value): bool
{
return is_string($value) && substr_count($value, '%') >= 2;
}
}
Classes/Configuration/Processor/Placeholder/EnvVariableProcessor.php
+39
View File
@@ -0,0 +1,39 @@
<?php
/*
* This file is part of the TYPO3 CMS project.
*
* It is free software; you can redistribute it and/or modify it under
* the terms of the GNU General Public License, either version 2
* of the License, or any later version.
*
* For the full copyright and license information, please read the
* LICENSE.txt file that was distributed with this source code.
*
* The TYPO3 project - inspiring people to share!
*/
namespace TYPO3\CMS\Core\Configuration\Processor\Placeholder;
/**
* Return value from environment variable
*
* Environment variables may only contain word characters and underscores (a-zA-Z0-9_)
* to be compatible to shell environments.
*/
readonly class EnvVariableProcessor implements PlaceholderProcessorInterface
{
public function canProcess(string $placeholder, array $referenceArray): bool
{
return str_contains($placeholder, '%env(');
}
public function process(string $value, array $referenceArray)
{
$envVar = getenv($value);
if ($envVar === false) {
throw new \UnexpectedValueException('Value not found', 1581501124);
}
return $envVar;
}
}
Classes/Configuration/Processor/Placeholder/PlaceholderProcessorInterface.php
+26
View File
@@ -0,0 +1,26 @@
<?php
/*
* This file is part of the TYPO3 CMS project.
*
* It is free software; you can redistribute it and/or modify it under
* the terms of the GNU General Public License, either version 2
* of the License, or any later version.
*
* For the full copyright and license information, please read the
* LICENSE.txt file that was distributed with this source code.
*
* The TYPO3 project - inspiring people to share!
*/
namespace TYPO3\CMS\Core\Configuration\Processor\Placeholder;
interface PlaceholderProcessorInterface
{
public function canProcess(string $placeholder, array $referenceArray): bool;
/**
* @return mixed
*/
public function process(string $value, array $referenceArray);
}
Classes/Configuration/Processor/Placeholder/ValueFromReferenceArrayProcessor.php
+50
View File
@@ -0,0 +1,50 @@
<?php
/*
* This file is part of the TYPO3 CMS project.
*
* It is free software; you can redistribute it and/or modify it under
* the terms of the GNU General Public License, either version 2
* of the License, or any later version.
*
* For the full copyright and license information, please read the
* LICENSE.txt file that was distributed with this source code.
*
* The TYPO3 project - inspiring people to share!
*/
namespace TYPO3\CMS\Core\Configuration\Processor\Placeholder;
/**
* Returns the value for a placeholder as fetched from the referenceArray
*/
readonly class ValueFromReferenceArrayProcessor implements PlaceholderProcessorInterface
{
public function canProcess(string $placeholder, array $referenceArray): bool
{
return !str_contains($placeholder, '(');
}
/**
* Returns the value for a placeholder as fetched from the referenceArray
*
* @param string $value the string to search for
* @param array $referenceArray the main configuration array where to look up the data
*
* @return array|mixed|string
*/
public function process(string $value, array $referenceArray)
{
$parts = explode('.', $value);
$referenceData = $referenceArray;
foreach ($parts as $part) {
if (isset($referenceData[$part])) {
$referenceData = $referenceData[$part];
} else {
// return unsubstituted placeholder
throw new \UnexpectedValueException('Value not found', 1581501216);
}
}
return $referenceData;
}
}
Classes/Configuration/Processor/PlaceholderProcessorList.php
+62
View File
@@ -0,0 +1,62 @@
<?php
/*
* This file is part of the TYPO3 CMS project.
*
* It is free software; you can redistribute it and/or modify it under
* the terms of the GNU General Public License, either version 2
* of the License, or any later version.
*
* For the full copyright and license information, please read the
* LICENSE.txt file that was distributed with this source code.
*
* The TYPO3 project - inspiring people to share!
*/
namespace TYPO3\CMS\Core\Configuration\Processor;
use TYPO3\CMS\Core\Configuration\Processor\Placeholder\PlaceholderProcessorInterface;
use TYPO3\CMS\Core\Service\DependencyOrderingService;
use TYPO3\CMS\Core\Utility\GeneralUtility;
/**
* Orders and returns given PlaceholderProcessors
*/
class PlaceholderProcessorList
{
/**
* @var PlaceholderProcessorInterface[]
*/
protected $processors;
public function __construct($processorList = [])
{
$this->processors = $processorList;
}
/**
* @return PlaceholderProcessorInterface[]
*/
public function compile(): array
{
$processors = [];
$orderingService = GeneralUtility::makeInstance(DependencyOrderingService::class);
$orderedProcessors = $orderingService->orderByDependencies($this->processors, 'before', 'after');
foreach ($orderedProcessors as $processorClassName => $providerConfig) {
if (isset($providerConfig['disabled']) && $providerConfig['disabled'] === true) {
continue;
}
$processor = GeneralUtility::makeInstance($processorClassName);
if (!$processor instanceof PlaceholderProcessorInterface) {
throw new \UnexpectedValueException(
'Placeholder processor ' . $processorClassName . ' must implement PlaceholderProcessorInterface',
1581343410
);
}
$processors[] = $processor;
}
return $processors;
}
}