Wala shell

Advanced PHP File Manager

Server IP: 127.0.0.1 | PHP Version: 8.3.30 | Domains Hosted: 54

Name	Size	Last Modified	Actions
📁 ..	-	2025-05-25 12:37
📄 ArrayNode.php <?php /* * This file is part of the Symfony package. * * (c) Fabien Potencier <fabien@symfony.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace Symfony\Component\Config\Definition; use Symfony\Component\Config\Definition\Exception\InvalidConfigurationException; use Symfony\Component\Config\Definition\Exception\InvalidTypeException; use Symfony\Component\Config\Definition\Exception\UnsetKeyException; /* * Represents an Array node in the config tree. * * @author Johannes M. Schmitt <schmittjoh@gmail.com> / class ArrayNode extends BaseNode implements PrototypeNodeInterface { protected $xmlRemappings = array(); protected $children = array(); protected $allowFalse = false; protected $allowNewKeys = true; protected $addIfNotSet = false; protected $performDeepMerging = true; protected $ignoreExtraKeys = false; protected $normalizeKeys = true; public function setNormalizeKeys($normalizeKeys) { $this->normalizeKeys = (Boolean) $normalizeKeys; } /* * Normalizes keys between the different configuration formats. * * Namely, you mostly have foo_bar in YAML while you have foo-bar in XML. * After running this method, all keys are normalized to foo_bar. * * If you have a mixed key like foo-bar_moo, it will not be altered. * The key will also not be altered if the target key already exists. * * @param mixed $value * * @return array The value with normalized keys / protected function preNormalize($value) { if (!$this->normalizeKeys \|\| !is_array($value)) { return $value; } foreach ($value as $k => $v) { if (false !== strpos($k, '-') && false === strpos($k, '_') && !array_key_exists($normalizedKey = str_replace('-', '_', $k), $value)) { $value[$normalizedKey] = $v; unset($value[$k]); } } return $value; } /* * Retrieves the children of this node. * * @return array The children / public function getChildren() { return $this->children; } /* * Sets the xml remappings that should be performed. * * @param array $remappings an array of the form array(array(string, string)) / public function setXmlRemappings(array $remappings) { $this->xmlRemappings = $remappings; } /* * Gets the xml remappings that should be performed. * * @return array $remappings an array of the form array(array(string, string)) / public function getXmlRemappings() { return $this->xmlRemappings; } /* * Sets whether to add default values for this array if it has not been * defined in any of the configuration files. * * @param Boolean $boolean / public function setAddIfNotSet($boolean) { $this->addIfNotSet = (Boolean) $boolean; } /* * Sets whether false is allowed as value indicating that the array should be unset. * * @param Boolean $allow / public function setAllowFalse($allow) { $this->allowFalse = (Boolean) $allow; } /* * Sets whether new keys can be defined in subsequent configurations. * * @param Boolean $allow / public function setAllowNewKeys($allow) { $this->allowNewKeys = (Boolean) $allow; } /* * Sets if deep merging should occur. * * @param Boolean $boolean / public function setPerformDeepMerging($boolean) { $this->performDeepMerging = (Boolean) $boolean; } /* * Whether extra keys should just be ignore without an exception. * * @param Boolean $boolean To allow extra keys / public function setIgnoreExtraKeys($boolean) { $this->ignoreExtraKeys = (Boolean) $boolean; } /* * Sets the node Name. * * @param string $name The node's name / public function setName($name) { $this->name = $name; } /* * Checks if the node has a default value. * * @return Boolean / public function hasDefaultValue() { return $this->addIfNotSet; } /* * Retrieves the default value. * * @return array The default value * * @throws \RuntimeException if the node has no default value / public function getDefaultValue() { if (!$this->hasDefaultValue()) { throw new \RuntimeException(sprintf('The node at path "%s" has no default value.', $this->getPath())); } $defaults = array(); foreach ($this->children as $name => $child) { if ($child->hasDefaultValue()) { $defaults[$name] = $child->getDefaultValue(); } } return $defaults; } /* * Adds a child node. * * @param NodeInterface $node The child node to add * * @throws \InvalidArgumentException when the child node has no name * @throws \InvalidArgumentException when the child node's name is not unique / public function addChild(NodeInterface $node) { $name = $node->getName(); if (!strlen($name)) { throw new \InvalidArgumentException('Child nodes must be named.'); } if (isset($this->children[$name])) { throw new \InvalidArgumentException(sprintf('A child node named "%s" already exists.', $name)); } $this->children[$name] = $node; } /* * Finalizes the value of this node. * * @param mixed $value * * @return mixed The finalised value * * @throws UnsetKeyException * @throws InvalidConfigurationException if the node doesn't have enough children / protected function finalizeValue($value) { if (false === $value) { $msg = sprintf('Unsetting key for path "%s", value: %s', $this->getPath(), json_encode($value)); throw new UnsetKeyException($msg); } foreach ($this->children as $name => $child) { if (!array_key_exists($name, $value)) { if ($child->isRequired()) { $msg = sprintf('The child node "%s" at path "%s" must be configured.', $name, $this->getPath()); $ex = new InvalidConfigurationException($msg); $ex->setPath($this->getPath()); throw $ex; } if ($child->hasDefaultValue()) { $value[$name] = $child->getDefaultValue(); } continue; } try { $value[$name] = $child->finalize($value[$name]); } catch (UnsetKeyException $unset) { unset($value[$name]); } } return $value; } /* * Validates the type of the value. * * @param mixed $value * * @throws InvalidTypeException / protected function validateType($value) { if (!is_array($value) && (!$this->allowFalse \|\| false !== $value)) { $ex = new InvalidTypeException(sprintf( 'Invalid type for path "%s". Expected array, but got %s', $this->getPath(), gettype($value) )); $ex->setPath($this->getPath()); throw $ex; } } /* * Normalizes the value. * * @param mixed $value The value to normalize * * @return mixed The normalized value * * @throws InvalidConfigurationException / protected function normalizeValue($value) { if (false === $value) { return $value; } $value = $this->remapXml($value); $normalized = array(); foreach ($value as $name => $val) { if (isset($this->children[$name])) { $normalized[$name] = $this->children[$name]->normalize($val); unset($value[$name]); } } // if extra fields are present, throw exception if (count($value) && !$this->ignoreExtraKeys) { $msg = sprintf('Unrecognized options "%s" under "%s"', implode(', ', array_keys($value)), $this->getPath()); $ex = new InvalidConfigurationException($msg); $ex->setPath($this->getPath()); throw $ex; } return $normalized; } /* * Remaps multiple singular values to a single plural value. * * @param array $value The source values * * @return array The remapped values / protected function remapXml($value) { foreach ($this->xmlRemappings as $transformation) { list($singular, $plural) = $transformation; if (!isset($value[$singular])) { continue; } $value[$plural] = Processor::normalizeConfig($value, $singular, $plural); unset($value[$singular]); } return $value; } /* * Merges values together. * * @param mixed $leftSide The left side to merge. * @param mixed $rightSide The right side to merge. * * @return mixed The merged values * * @throws InvalidConfigurationException * @throws \RuntimeException */ protected function mergeValues($leftSide, $rightSide) { if (false === $rightSide) { // if this is still false after the last config has been merged the // finalization pass will take care of removing this key entirely return false; } if (false === $leftSide \|\| !$this->performDeepMerging) { return $rightSide; } foreach ($rightSide as $k => $v) { // no conflict if (!array_key_exists($k, $leftSide)) { if (!$this->allowNewKeys) { $ex = new InvalidConfigurationException(sprintf( 'You are not allowed to define new elements for path "%s". ' .'Please define all elements for this path in one config file. ' .'If you are trying to overwrite an element, make sure you redefine it ' .'with the same name.', $this->getPath() )); $ex->setPath($this->getPath()); throw $ex; } $leftSide[$k] = $v; continue; } if (!isset($this->children[$k])) { throw new \RuntimeException('merge() expects a normalized config array.'); } $leftSide[$k] = $this->children[$k]->merge($leftSide[$k], $v); } return $leftSide; } }	10.73 KB	2024-07-17 10:22
📄 BaseNode.php <?php /* * This file is part of the Symfony package. * * (c) Fabien Potencier <fabien@symfony.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace Symfony\Component\Config\Definition; use Symfony\Component\Config\Definition\Exception\Exception; use Symfony\Component\Config\Definition\Exception\ForbiddenOverwriteException; use Symfony\Component\Config\Definition\Exception\InvalidConfigurationException; /* * The base node class * * @author Johannes M. Schmitt <schmittjoh@gmail.com> / abstract class BaseNode implements NodeInterface { protected $name; protected $parent; protected $normalizationClosures = array(); protected $finalValidationClosures = array(); protected $allowOverwrite = true; protected $required = false; protected $equivalentValues = array(); protected $attributes = array(); /* * Constructor. * * @param string $name The name of the node * @param NodeInterface $parent The parent of this node * * @throws \InvalidArgumentException if the name contains a period. / public function __construct($name, NodeInterface $parent = null) { if (false !== strpos($name, '.')) { throw new \InvalidArgumentException('The name must not contain ".".'); } $this->name = $name; $this->parent = $parent; } public function setAttribute($key, $value) { $this->attributes[$key] = $value; } public function getAttribute($key, $default = null) { return isset($this->attributes[$key]) ? $this->attributes[$key] : $default; } public function hasAttribute($key) { return isset($this->attributes[$key]); } public function getAttributes() { return $this->attributes; } public function setAttributes(array $attributes) { $this->attributes = $attributes; } public function removeAttribute($key) { unset($this->attributes[$key]); } /* * Sets an info message. * * @param string $info / public function setInfo($info) { $this->setAttribute('info', $info); } /* * Returns info message. * * @return string The info text / public function getInfo() { return $this->getAttribute('info'); } /* * Sets the example configuration for this node. * * @param string\|array $example / public function setExample($example) { $this->setAttribute('example', $example); } /* * Retrieves the example configuration for this node. * * @return string\|array The example / public function getExample() { return $this->getAttribute('example'); } /* * Adds an equivalent value. * * @param mixed $originalValue * @param mixed $equivalentValue / public function addEquivalentValue($originalValue, $equivalentValue) { $this->equivalentValues[] = array($originalValue, $equivalentValue); } /* * Set this node as required. * * @param Boolean $boolean Required node / public function setRequired($boolean) { $this->required = (Boolean) $boolean; } /* * Sets if this node can be overridden. * * @param Boolean $allow / public function setAllowOverwrite($allow) { $this->allowOverwrite = (Boolean) $allow; } /* * Sets the closures used for normalization. * * @param \Closure[] $closures An array of Closures used for normalization / public function setNormalizationClosures(array $closures) { $this->normalizationClosures = $closures; } /* * Sets the closures used for final validation. * * @param \Closure[] $closures An array of Closures used for final validation / public function setFinalValidationClosures(array $closures) { $this->finalValidationClosures = $closures; } /* * Checks if this node is required. * * @return Boolean / public function isRequired() { return $this->required; } /* * Returns the name of this node * * @return string The Node's name. / public function getName() { return $this->name; } /* * Retrieves the path of this node. * * @return string The Node's path / public function getPath() { $path = $this->name; if (null !== $this->parent) { $path = $this->parent->getPath().'.'.$path; } return $path; } /* * Merges two values together. * * @param mixed $leftSide * @param mixed $rightSide * * @return mixed The merged value * * @throws ForbiddenOverwriteException / final public function merge($leftSide, $rightSide) { if (!$this->allowOverwrite) { throw new ForbiddenOverwriteException(sprintf( 'Configuration path "%s" cannot be overwritten. You have to ' .'define all options for this path, and any of its sub-paths in ' .'one configuration section.', $this->getPath() )); } $this->validateType($leftSide); $this->validateType($rightSide); return $this->mergeValues($leftSide, $rightSide); } /* * Normalizes a value, applying all normalization closures. * * @param mixed $value Value to normalize. * * @return mixed The normalized value. / final public function normalize($value) { $value = $this->preNormalize($value); // run custom normalization closures foreach ($this->normalizationClosures as $closure) { $value = $closure($value); } // replace value with their equivalent foreach ($this->equivalentValues as $data) { if ($data[0] === $value) { $value = $data[1]; } } // validate type $this->validateType($value); // normalize value return $this->normalizeValue($value); } /* * Normalizes the value before any other normalization is applied. * * @param $value * * @return $value The normalized array value / protected function preNormalize($value) { return $value; } /* * Returns parent node for this node. * * @return NodeInterface\|null / public function getParent() { return $this->parent; } /* * Finalizes a value, applying all finalization closures. * * @param mixed $value The value to finalize * * @return mixed The finalized value * * @throws InvalidConfigurationException / final public function finalize($value) { $this->validateType($value); $value = $this->finalizeValue($value); // Perform validation on the final value if a closure has been set. // The closure is also allowed to return another value. foreach ($this->finalValidationClosures as $closure) { try { $value = $closure($value); } catch (Exception $correctEx) { throw $correctEx; } catch (\Exception $invalid) { throw new InvalidConfigurationException(sprintf( 'Invalid configuration for path "%s": %s', $this->getPath(), $invalid->getMessage() ), $invalid->getCode(), $invalid); } } return $value; } /* * Validates the type of a Node. * * @param mixed $value The value to validate * * @throws InvalidTypeException when the value is invalid / abstract protected function validateType($value); /* * Normalizes the value. * * @param mixed $value The value to normalize. * * @return mixed The normalized value / abstract protected function normalizeValue($value); /* * Merges two values together. * * @param mixed $leftSide * @param mixed $rightSide * * @return mixed The merged value / abstract protected function mergeValues($leftSide, $rightSide); /* * Finalizes a value. * * @param mixed $value The value to finalize * * @return mixed The finalized value */ abstract protected function finalizeValue($value); }	8.51 KB	2024-07-17 10:22
📄 BooleanNode.php <?php /* * This file is part of the Symfony package. * * (c) Fabien Potencier <fabien@symfony.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace Symfony\Component\Config\Definition; use Symfony\Component\Config\Definition\Exception\InvalidTypeException; /* * This node represents a Boolean value in the config tree. * * @author Johannes M. Schmitt <schmittjoh@gmail.com> / class BooleanNode extends ScalarNode { /* * {@inheritDoc} */ protected function validateType($value) { if (!is_bool($value)) { $ex = new InvalidTypeException(sprintf( 'Invalid type for path "%s". Expected boolean, but got %s.', $this->getPath(), gettype($value) )); $ex->setPath($this->getPath()); throw $ex; } } }	939 B	2024-07-17 10:22
📁 Builder	-	2025-05-25 12:37
📄 ConfigurationInterface.php <?php /* * This file is part of the Symfony package. * * (c) Fabien Potencier <fabien@symfony.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace Symfony\Component\Config\Definition; /* * Configuration interface * * @author Victor Berchet <victor@suumit.com> / interface ConfigurationInterface { /* * Generates the configuration tree builder. * * @return \Symfony\Component\Config\Definition\Builder\TreeBuilder The tree builder */ public function getConfigTreeBuilder(); }	612 B	2024-07-17 10:22
📁 Dumper	-	2025-05-25 12:37
📄 EnumNode.php <?php /* * This file is part of the Symfony package. * * (c) Fabien Potencier <fabien@symfony.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace Symfony\Component\Config\Definition; use Symfony\Component\Config\Definition\Exception\InvalidConfigurationException; /* * Node which only allows a finite set of values. * * @author Johannes M. Schmitt <schmittjoh@gmail.com> */ class EnumNode extends ScalarNode { private $values; public function __construct($name, NodeInterface $parent = null, array $values = array()) { $values = array_unique($values); if (count($values) <= 1) { throw new \InvalidArgumentException('$values must contain at least two distinct elements.'); } parent::__construct($name, $parent); $this->values = $values; } public function getValues() { return $this->values; } protected function finalizeValue($value) { $value = parent::finalizeValue($value); if (!in_array($value, $this->values, true)) { $ex = new InvalidConfigurationException(sprintf( 'The value %s is not allowed for path "%s". Permissible values: %s', json_encode($value), $this->getPath(), implode(', ', array_map('json_encode', $this->values)))); $ex->setPath($this->getPath()); throw $ex; } return $value; } }	1.51 KB	2024-07-17 10:22
📁 Exception	-	2025-05-25 12:37
📄 FloatNode.php <?php /* * This file is part of the Symfony package. * * (c) Fabien Potencier <fabien@symfony.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace Symfony\Component\Config\Definition; use Symfony\Component\Config\Definition\Exception\InvalidTypeException; /* * This node represents a float value in the config tree. * * @author Jeanmonod David <david.jeanmonod@gmail.com> / class FloatNode extends NumericNode { /* * {@inheritDoc} */ protected function validateType($value) { // Integers are also accepted, we just cast them if (is_int($value)) { $value = (float) $value; } if (!is_float($value)) { $ex = new InvalidTypeException(sprintf('Invalid type for path "%s". Expected float, but got %s.', $this->getPath(), gettype($value))); $ex->setPath($this->getPath()); throw $ex; } } }	1009 B	2024-07-17 10:22
📄 IntegerNode.php <?php /* * This file is part of the Symfony package. * * (c) Fabien Potencier <fabien@symfony.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace Symfony\Component\Config\Definition; use Symfony\Component\Config\Definition\Exception\InvalidTypeException; /* * This node represents an integer value in the config tree. * * @author Jeanmonod David <david.jeanmonod@gmail.com> / class IntegerNode extends NumericNode { /* * {@inheritDoc} */ protected function validateType($value) { if (!is_int($value)) { $ex = new InvalidTypeException(sprintf('Invalid type for path "%s". Expected int, but got %s.', $this->getPath(), gettype($value))); $ex->setPath($this->getPath()); throw $ex; } } }	875 B	2024-07-17 10:22
📄 NodeInterface.php <?php /* * This file is part of the Symfony package. * * (c) Fabien Potencier <fabien@symfony.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace Symfony\Component\Config\Definition; /* * Common Interface among all nodes. * * In most cases, it is better to inherit from BaseNode instead of implementing * this interface yourself. * * @author Johannes M. Schmitt <schmittjoh@gmail.com> / interface NodeInterface { /* * Returns the name of the node. * * @return string The name of the node / public function getName(); /* * Returns the path of the node. * * @return string The node path / public function getPath(); /* * Returns true when the node is required. * * @return Boolean If the node is required / public function isRequired(); /* * Returns true when the node has a default value. * * @return Boolean If the node has a default value / public function hasDefaultValue(); /* * Returns the default value of the node. * * @return mixed The default value * @throws \RuntimeException if the node has no default value / public function getDefaultValue(); /* * Normalizes the supplied value. * * @param mixed $value The value to normalize * * @return mixed The normalized value / public function normalize($value); /* * Merges two values together. * * @param mixed $leftSide * @param mixed $rightSide * * @return mixed The merged values / public function merge($leftSide, $rightSide); /* * Finalizes a value. * * @param mixed $value The value to finalize * * @return mixed The finalized value */ public function finalize($value); }	1.88 KB	2024-07-17 10:22
📄 NumericNode.php <?php /* * This file is part of the Symfony package. * * (c) Fabien Potencier <fabien@symfony.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace Symfony\Component\Config\Definition; use Symfony\Component\Config\Definition\Exception\InvalidConfigurationException; /* * This node represents a numeric value in the config tree * * @author David Jeanmonod <david.jeanmonod@gmail.com> / class NumericNode extends ScalarNode { protected $min; protected $max; public function __construct($name, NodeInterface $parent = null, $min = null, $max = null) { parent::__construct($name, $parent); $this->min = $min; $this->max = $max; } /* * {@inheritDoc} */ protected function finalizeValue($value) { $value = parent::finalizeValue($value); $errorMsg = null; if (isset($this->min) && $value < $this->min) { $errorMsg = sprintf('The value %s is too small for path "%s". Should be greater than or equal to %s', $value, $this->getPath(), $this->min); } if (isset($this->max) && $value > $this->max) { $errorMsg = sprintf('The value %s is too big for path "%s". Should be less than or equal to %s', $value, $this->getPath(), $this->max); } if (isset($errorMsg)) { $ex = new InvalidConfigurationException($errorMsg); $ex->setPath($this->getPath()); throw $ex; } return $value; } }	1.54 KB	2024-07-17 10:22
📄 Processor.php <?php /* * This file is part of the Symfony package. * * (c) Fabien Potencier <fabien@symfony.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace Symfony\Component\Config\Definition; /* * This class is the entry point for config normalization/merging/finalization. * * @author Johannes M. Schmitt <schmittjoh@gmail.com> / class Processor { /* * Processes an array of configurations. * * @param NodeInterface $configTree The node tree describing the configuration * @param array $configs An array of configuration items to process * * @return array The processed configuration / public function process(NodeInterface $configTree, array $configs) { $currentConfig = array(); foreach ($configs as $config) { $config = $configTree->normalize($config); $currentConfig = $configTree->merge($currentConfig, $config); } return $configTree->finalize($currentConfig); } /* * Processes an array of configurations. * * @param ConfigurationInterface $configuration The configuration class * @param array $configs An array of configuration items to process * * @return array The processed configuration / public function processConfiguration(ConfigurationInterface $configuration, array $configs) { return $this->process($configuration->getConfigTreeBuilder()->buildTree(), $configs); } /* * Normalizes a configuration entry. * * This method returns a normalize configuration array for a given key * to remove the differences due to the original format (YAML and XML mainly). * * Here is an example. * * The configuration in XML: * * <twig:extension>twig.extension.foo</twig:extension> * <twig:extension>twig.extension.bar</twig:extension> * * And the same configuration in YAML: * * extensions: ['twig.extension.foo', 'twig.extension.bar'] * * @param array $config A config array * @param string $key The key to normalize * @param string $plural The plural form of the key if it is irregular * * @return array */ public static function normalizeConfig($config, $key, $plural = null) { if (null === $plural) { $plural = $key.'s'; } if (isset($config[$plural])) { return $config[$plural]; } if (isset($config[$key])) { if (is_string($config[$key]) \|\| !is_int(key($config[$key]))) { // only one return array($config[$key]); } return $config[$key]; } return array(); } }	2.79 KB	2024-07-17 10:22
📄 PrototypeNodeInterface.php <?php /* * This file is part of the Symfony package. * * (c) Fabien Potencier <fabien@symfony.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace Symfony\Component\Config\Definition; /* * This interface must be implemented by nodes which can be used as prototypes. * * @author Johannes M. Schmitt <schmittjoh@gmail.com> / interface PrototypeNodeInterface extends NodeInterface { /* * Sets the name of the node. * * @param string $name The name of the node */ public function setName($name); }	631 B	2024-07-17 10:22
📄 PrototypedArrayNode.php <?php /* * This file is part of the Symfony package. * * (c) Fabien Potencier <fabien@symfony.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace Symfony\Component\Config\Definition; use Symfony\Component\Config\Definition\Exception\InvalidConfigurationException; use Symfony\Component\Config\Definition\Exception\DuplicateKeyException; use Symfony\Component\Config\Definition\Exception\UnsetKeyException; use Symfony\Component\Config\Definition\Exception\Exception; /* * Represents a prototyped Array node in the config tree. * * @author Johannes M. Schmitt <schmittjoh@gmail.com> / class PrototypedArrayNode extends ArrayNode { protected $prototype; protected $keyAttribute; protected $removeKeyAttribute = false; protected $minNumberOfElements = 0; protected $defaultValue = array(); protected $defaultChildren; /* * Sets the minimum number of elements that a prototype based node must * contain. By default this is zero, meaning no elements. * * @param integer $number / public function setMinNumberOfElements($number) { $this->minNumberOfElements = $number; } /* * Sets the attribute which value is to be used as key. * * This is useful when you have an indexed array that should be an * associative array. You can select an item from within the array * to be the key of the particular item. For example, if "id" is the * "key", then: * * array( * array('id' => 'my_name', 'foo' => 'bar'), * ); * * becomes * * array( * 'my_name' => array('foo' => 'bar'), * ); * * If you'd like "'id' => 'my_name'" to still be present in the resulting * array, then you can set the second argument of this method to false. * * @param string $attribute The name of the attribute which value is to be used as a key * @param Boolean $remove Whether or not to remove the key / public function setKeyAttribute($attribute, $remove = true) { $this->keyAttribute = $attribute; $this->removeKeyAttribute = $remove; } /* * Retrieves the name of the attribute which value should be used as key. * * @return string The name of the attribute / public function getKeyAttribute() { return $this->keyAttribute; } /* * Sets the default value of this node. * * @param string $value * * @throws \InvalidArgumentException if the default value is not an array / public function setDefaultValue($value) { if (!is_array($value)) { throw new \InvalidArgumentException($this->getPath().': the default value of an array node has to be an array.'); } $this->defaultValue = $value; } /* * Checks if the node has a default value. * * @return Boolean / public function hasDefaultValue() { return true; } /* * Adds default children when none are set. * * @param integer\|string\|array\|null $children The number of children\|The child name\|The children names to be added / public function setAddChildrenIfNoneSet($children = array('defaults')) { if (null === $children) { $this->defaultChildren = array('defaults'); } else { $this->defaultChildren = is_integer($children) && $children > 0 ? range(1, $children) : (array) $children; } } /* * Retrieves the default value. * * The default value could be either explicited or derived from the prototype * default value. * * @return array The default value / public function getDefaultValue() { if (null !== $this->defaultChildren) { $default = $this->prototype->hasDefaultValue() ? $this->prototype->getDefaultValue() : array(); $defaults = array(); foreach (array_values($this->defaultChildren) as $i => $name) { $defaults[null === $this->keyAttribute ? $i : $name] = $default; } return $defaults; } return $this->defaultValue; } /* * Sets the node prototype. * * @param PrototypeNodeInterface $node / public function setPrototype(PrototypeNodeInterface $node) { $this->prototype = $node; } /* * Retrieves the prototype * * @return PrototypeNodeInterface The prototype / public function getPrototype() { return $this->prototype; } /* * Disable adding concrete children for prototyped nodes. * * @param NodeInterface $node The child node to add * * @throws Exception / public function addChild(NodeInterface $node) { throw new Exception('A prototyped array node can not have concrete children.'); } /* * Finalizes the value of this node. * * @param mixed $value * * @return mixed The finalized value * * @throws UnsetKeyException * @throws InvalidConfigurationException if the node doesn't have enough children / protected function finalizeValue($value) { if (false === $value) { $msg = sprintf('Unsetting key for path "%s", value: %s', $this->getPath(), json_encode($value)); throw new UnsetKeyException($msg); } foreach ($value as $k => $v) { $this->prototype->setName($k); try { $value[$k] = $this->prototype->finalize($v); } catch (UnsetKeyException $unset) { unset($value[$k]); } } if (count($value) < $this->minNumberOfElements) { $msg = sprintf('The path "%s" should have at least %d element(s) defined.', $this->getPath(), $this->minNumberOfElements); $ex = new InvalidConfigurationException($msg); $ex->setPath($this->getPath()); throw $ex; } return $value; } /* * Normalizes the value. * * @param mixed $value The value to normalize * * @return mixed The normalized value * * @throws InvalidConfigurationException * @throws DuplicateKeyException / protected function normalizeValue($value) { if (false === $value) { return $value; } $value = $this->remapXml($value); $isAssoc = array_keys($value) !== range(0, count($value) -1); $normalized = array(); foreach ($value as $k => $v) { if (null !== $this->keyAttribute && is_array($v)) { if (!isset($v[$this->keyAttribute]) && is_int($k) && !$isAssoc) { $msg = sprintf('The attribute "%s" must be set for path "%s".', $this->keyAttribute, $this->getPath()); $ex = new InvalidConfigurationException($msg); $ex->setPath($this->getPath()); throw $ex; } elseif (isset($v[$this->keyAttribute])) { $k = $v[$this->keyAttribute]; // remove the key attribute when required if ($this->removeKeyAttribute) { unset($v[$this->keyAttribute]); } // if only "value" is left if (1 == count($v) && isset($v['value'])) { $v = $v['value']; } } if (array_key_exists($k, $normalized)) { $msg = sprintf('Duplicate key "%s" for path "%s".', $k, $this->getPath()); $ex = new DuplicateKeyException($msg); $ex->setPath($this->getPath()); throw $ex; } } $this->prototype->setName($k); if (null !== $this->keyAttribute \|\| $isAssoc) { $normalized[$k] = $this->prototype->normalize($v); } else { $normalized[] = $this->prototype->normalize($v); } } return $normalized; } /* * Merges values together. * * @param mixed $leftSide The left side to merge. * @param mixed $rightSide The right side to merge. * * @return mixed The merged values * * @throws InvalidConfigurationException * @throws \RuntimeException */ protected function mergeValues($leftSide, $rightSide) { if (false === $rightSide) { // if this is still false after the last config has been merged the // finalization pass will take care of removing this key entirely return false; } if (false === $leftSide \|\| !$this->performDeepMerging) { return $rightSide; } foreach ($rightSide as $k => $v) { // prototype, and key is irrelevant, so simply append the element if (null === $this->keyAttribute) { $leftSide[] = $v; continue; } // no conflict if (!array_key_exists($k, $leftSide)) { if (!$this->allowNewKeys) { $ex = new InvalidConfigurationException(sprintf( 'You are not allowed to define new elements for path "%s". ' . 'Please define all elements for this path in one config file.', $this->getPath() )); $ex->setPath($this->getPath()); throw $ex; } $leftSide[$k] = $v; continue; } $this->prototype->setName($k); $leftSide[$k] = $this->prototype->merge($leftSide[$k], $v); } return $leftSide; } }	9.78 KB	2024-07-17 10:22
📄 ReferenceDumper.php <?php /* * This file is part of the Symfony package. * * (c) Fabien Potencier <fabien@symfony.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace Symfony\Component\Config\Definition; use Symfony\Component\Config\Definition\Dumper\YamlReferenceDumper; /* * @deprecated Deprecated since version 2.4, to be removed in 3.0. Use Symfony\Component\Config\Definition\Dumper\YamlReferenceDumper instead. */ class ReferenceDumper extends YamlReferenceDumper { }	560 B	2024-07-17 10:22
📄 ScalarNode.php <?php /* * This file is part of the Symfony package. * * (c) Fabien Potencier <fabien@symfony.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace Symfony\Component\Config\Definition; use Symfony\Component\Config\Definition\Exception\InvalidTypeException; /* * This node represents a scalar value in the config tree. * * The following values are considered scalars: * * booleans * * strings * * null * * integers * * floats * * @author Johannes M. Schmitt <schmittjoh@gmail.com> / class ScalarNode extends VariableNode { /* * {@inheritDoc} */ protected function validateType($value) { if (!is_scalar($value) && null !== $value) { $ex = new InvalidTypeException(sprintf( 'Invalid type for path "%s". Expected scalar, but got %s.', $this->getPath(), gettype($value) )); $ex->setPath($this->getPath()); throw $ex; } } }	1.06 KB	2024-07-17 10:22
📄 VariableNode.php <?php /* * This file is part of the Symfony package. * * (c) Fabien Potencier <fabien@symfony.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. / namespace Symfony\Component\Config\Definition; use Symfony\Component\Config\Definition\Exception\InvalidConfigurationException; /* * This node represents a value of variable type in the config tree. * * This node is intended for values of arbitrary type. * Any PHP type is accepted as a value. * * @author Jeremy Mikola <jmikola@gmail.com> / class VariableNode extends BaseNode implements PrototypeNodeInterface { protected $defaultValueSet = false; protected $defaultValue; protected $allowEmptyValue = true; /* * {@inheritDoc} / public function setDefaultValue($value) { $this->defaultValueSet = true; $this->defaultValue = $value; } /* * {@inheritDoc} / public function hasDefaultValue() { return $this->defaultValueSet; } /* * {@inheritDoc} / public function getDefaultValue() { return $this->defaultValue instanceof \Closure ? call_user_func($this->defaultValue) : $this->defaultValue; } /* * Sets if this node is allowed to have an empty value. * * @param Boolean $boolean True if this entity will accept empty values. / public function setAllowEmptyValue($boolean) { $this->allowEmptyValue = (Boolean) $boolean; } /* * {@inheritDoc} / public function setName($name) { $this->name = $name; } /* * {@inheritDoc} / protected function validateType($value) { } /* * {@inheritDoc} / protected function finalizeValue($value) { if (!$this->allowEmptyValue && empty($value)) { $ex = new InvalidConfigurationException(sprintf( 'The path "%s" cannot contain an empty value, but got %s.', $this->getPath(), json_encode($value) )); $ex->setPath($this->getPath()); throw $ex; } return $value; } /* * {@inheritDoc} / protected function normalizeValue($value) { return $value; } /* * {@inheritDoc} */ protected function mergeValues($leftSide, $rightSide) { return $rightSide; } }	2.43 KB	2024-07-17 10:22

Terminal