Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
ChoiceList	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Command	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Console	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
DependencyInjection	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Event	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Exception	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Extension	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Guess	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Resources	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Test	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Util	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
.htaccess	237 B	-r-xr-xr-x	2026-08-17 03:12
AbstractExtension.php	4.46 KB	-rwxrwxr-x	2026-03-13 14:59
AbstractRendererEngine.php	7.79 KB	-rwxrwxr-x	2026-03-13 14:59
AbstractType.php	1.3 KB	-rwxrwxr-x	2026-03-13 14:59
AbstractTypeExtension.php	970 B	-rwxrwxr-x	2026-03-13 14:59
Button.php	7.93 KB	-rwxrwxr-x	2026-03-13 14:59
ButtonBuilder.php	15.71 KB	-rwxrwxr-x	2026-03-13 14:59
ButtonTypeInterface.php	462 B	-rwxrwxr-x	2026-03-13 14:59
CHANGELOG.md	32.58 KB	-rwxrwxr-x	2026-03-13 14:59
CallbackTransformer.php	832 B	-rwxrwxr-x	2026-03-13 14:59
ClearableErrorsInterface.php	648 B	-rwxrwxr-x	2026-03-13 14:59
ClickableInterface.php	501 B	-rwxrwxr-x	2026-03-13 14:59
DataAccessorInterface.php	1.57 KB	-rwxrwxr-x	2026-03-13 14:59
DataMapperInterface.php	2.47 KB	-rwxrwxr-x	2026-03-13 14:59
DataTransformerInterface.php	3.89 KB	-rwxrwxr-x	2026-03-13 14:59
FileUploadError.php	338 B	-rwxrwxr-x	2026-03-13 14:59
Form.php	36.11 KB	-rwxrwxr-x	2026-03-13 14:59
FormBuilder.php	6.85 KB	-rwxrwxr-x	2026-03-13 14:59
FormBuilderInterface.php	1.86 KB	-rwxrwxr-x	2026-03-13 14:59
FormConfigBuilder.php	18.16 KB	-rwxrwxr-x	2026-03-13 14:59
FormConfigBuilderInterface.php	7.15 KB	-rwxrwxr-x	2026-03-13 14:59
FormConfigInterface.php	5.13 KB	-rwxrwxr-x	2026-03-13 14:59
FormError.php	3.14 KB	-rwxrwxr-x	2026-03-13 14:59
FormErrorIterator.php	7.39 KB	-rwxrwxr-x	2026-03-13 14:59
FormEvent.php	1.05 KB	-rwxrwxr-x	2026-03-13 14:59
FormEvents.php	4.02 KB	-rwxrwxr-x	2026-03-13 14:59
FormExtensionInterface.php	1.4 KB	-rwxrwxr-x	2026-03-13 14:59
FormFactory.php	3.76 KB	-rwxrwxr-x	2026-03-13 14:59
FormFactoryBuilder.php	3.85 KB	-rwxrwxr-x	2026-03-13 14:59
FormFactoryBuilderInterface.php	2.35 KB	-rwxrwxr-x	2026-03-13 14:59
FormFactoryInterface.php	3.06 KB	-rwxrwxr-x	2026-03-13 14:59
FormInterface.php	9.26 KB	-rwxrwxr-x	2026-03-13 14:59
FormRegistry.php	4.57 KB	-rwxrwxr-x	2026-03-13 14:59
FormRegistryInterface.php	1.13 KB	-rwxrwxr-x	2026-03-13 14:59
FormRenderer.php	11.84 KB	-rwxrwxr-x	2026-03-13 14:59
FormRendererEngineInterface.php	6.11 KB	-rwxrwxr-x	2026-03-13 14:59
FormRendererInterface.php	3 KB	-rwxrwxr-x	2026-03-13 14:59
FormTypeExtensionInterface.php	1.71 KB	-rwxrwxr-x	2026-03-13 14:59
FormTypeGuesserChain.php	2.55 KB	-rwxrwxr-x	2026-03-13 14:59
FormTypeGuesserInterface.php	1.09 KB	-rwxrwxr-x	2026-03-13 14:59
FormTypeInterface.php	2.89 KB	-rwxrwxr-x	2026-03-13 14:59
FormView.php	3.46 KB	-rwxrwxr-x	2026-03-13 14:59
Forms.php	2.73 KB	-rwxrwxr-x	2026-03-13 14:59
LICENSE	1.04 KB	-rwxrwxr-x	2026-03-13 14:59
NativeRequestHandler.php	7.33 KB	-rwxrwxr-x	2026-03-13 14:59
PreloadedExtension.php	1.97 KB	-rwxrwxr-x	2026-03-13 14:59
README.md	483 B	-rwxrwxr-x	2026-03-13 14:59
RequestHandlerInterface.php	705 B	-rwxrwxr-x	2026-03-13 14:59
ResolvedFormType.php	5.32 KB	-rwxrwxr-x	2026-03-13 14:59
ResolvedFormTypeFactory.php	649 B	-rwxrwxr-x	2026-03-13 14:59
ResolvedFormTypeFactoryInterface.php	1.15 KB	-rwxrwxr-x	2026-03-13 14:59
ResolvedFormTypeInterface.php	2.17 KB	-rwxrwxr-x	2026-03-13 14:59
ReversedTransformer.php	1008 B	-rwxrwxr-x	2026-03-13 14:59
SubmitButton.php	1.07 KB	-rwxrwxr-x	2026-03-13 14:59
SubmitButtonBuilder.php	592 B	-rwxrwxr-x	2026-03-13 14:59
SubmitButtonTypeInterface.php	474 B	-rwxrwxr-x	2026-03-13 14:59
composer.json	2.25 KB	-rwxrwxr-x	2026-03-13 14:59

Rename

<?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\Form;

use Symfony\Component\EventDispatcher\EventDispatcherInterface;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;
use Symfony\Component\EventDispatcher\ImmutableEventDispatcher;
use Symfony\Component\Form\Exception\BadMethodCallException;
use Symfony\Component\Form\Exception\InvalidArgumentException;
use Symfony\Component\PropertyAccess\PropertyPath;
use Symfony\Component\PropertyAccess\PropertyPathInterface;

/**
 * A basic form configuration.
 *
 * @author Bernhard Schussek <bschussek@gmail.com>
 */
class FormConfigBuilder implements FormConfigBuilderInterface
{
    /**
     * Caches a globally unique {@link NativeRequestHandler} instance.
     */
    private static NativeRequestHandler $nativeRequestHandler;

/** @var bool */
    protected $locked = false;

private EventDispatcherInterface $dispatcher;
    private string $name;
    private ?PropertyPathInterface $propertyPath = null;
    private bool $mapped = true;
    private bool $byReference = true;
    private bool $inheritData = false;
    private bool $compound = false;
    private ResolvedFormTypeInterface $type;
    private array $viewTransformers = [];
    private array $modelTransformers = [];
    private ?DataMapperInterface $dataMapper = null;
    private bool $required = true;
    private bool $disabled = false;
    private bool $errorBubbling = false;
    private mixed $emptyData = null;
    private array $attributes = [];
    private mixed $data = null;
    private ?string $dataClass;
    private bool $dataLocked = false;
    private FormFactoryInterface $formFactory;
    private string $action = '';
    private string $method = 'POST';
    private RequestHandlerInterface $requestHandler;
    private bool $autoInitialize = false;
    private array $options;
    private ?\Closure $isEmptyCallback = null;

/**
     * Creates an empty form configuration.
     *
     * @param string|null $name      The form name
     * @param string|null $dataClass The class of the form's data
     *
     * @throws InvalidArgumentException if the data class is not a valid class or if
     *                                  the name contains invalid characters
     */
    public function __construct(?string $name, ?string $dataClass, EventDispatcherInterface $dispatcher, array $options = [])
    {
        self::validateName($name);

if (null !== $dataClass && !class_exists($dataClass) && !interface_exists($dataClass, false)) {
            throw new InvalidArgumentException(\sprintf('Class "%s" not found. Is the "data_class" form option set correctly?', $dataClass));
        }

$this->name = (string) $name;
        $this->dataClass = $dataClass;
        $this->dispatcher = $dispatcher;
        $this->options = $options;
    }

public function addEventListener(string $eventName, callable $listener, int $priority = 0): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->dispatcher->addListener($eventName, $listener, $priority);

return $this;
    }

public function addEventSubscriber(EventSubscriberInterface $subscriber): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->dispatcher->addSubscriber($subscriber);

return $this;
    }

public function addViewTransformer(DataTransformerInterface $viewTransformer, bool $forcePrepend = false): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

if ($forcePrepend) {
            array_unshift($this->viewTransformers, $viewTransformer);
        } else {
            $this->viewTransformers[] = $viewTransformer;
        }

return $this;
    }

public function resetViewTransformers(): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->viewTransformers = [];

return $this;
    }

public function addModelTransformer(DataTransformerInterface $modelTransformer, bool $forceAppend = false): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

if ($forceAppend) {
            $this->modelTransformers[] = $modelTransformer;
        } else {
            array_unshift($this->modelTransformers, $modelTransformer);
        }

return $this;
    }

public function resetModelTransformers(): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->modelTransformers = [];

return $this;
    }

public function getEventDispatcher(): EventDispatcherInterface
    {
        if ($this->locked && !$this->dispatcher instanceof ImmutableEventDispatcher) {
            $this->dispatcher = new ImmutableEventDispatcher($this->dispatcher);
        }

return $this->dispatcher;
    }

public function getName(): string
    {
        return $this->name;
    }

public function getPropertyPath(): ?PropertyPathInterface
    {
        return $this->propertyPath;
    }

public function getMapped(): bool
    {
        return $this->mapped;
    }

public function getByReference(): bool
    {
        return $this->byReference;
    }

public function getInheritData(): bool
    {
        return $this->inheritData;
    }

public function getCompound(): bool
    {
        return $this->compound;
    }

public function getType(): ResolvedFormTypeInterface
    {
        return $this->type;
    }

public function getViewTransformers(): array
    {
        return $this->viewTransformers;
    }

public function getModelTransformers(): array
    {
        return $this->modelTransformers;
    }

public function getDataMapper(): ?DataMapperInterface
    {
        return $this->dataMapper;
    }

public function getRequired(): bool
    {
        return $this->required;
    }

public function getDisabled(): bool
    {
        return $this->disabled;
    }

public function getErrorBubbling(): bool
    {
        return $this->errorBubbling;
    }

public function getEmptyData(): mixed
    {
        return $this->emptyData;
    }

public function getAttributes(): array
    {
        return $this->attributes;
    }

public function hasAttribute(string $name): bool
    {
        return \array_key_exists($name, $this->attributes);
    }

public function getAttribute(string $name, mixed $default = null): mixed
    {
        return \array_key_exists($name, $this->attributes) ? $this->attributes[$name] : $default;
    }

public function getData(): mixed
    {
        return $this->data;
    }

public function getDataClass(): ?string
    {
        return $this->dataClass;
    }

public function getDataLocked(): bool
    {
        return $this->dataLocked;
    }

public function getFormFactory(): FormFactoryInterface
    {
        if (!isset($this->formFactory)) {
            throw new BadMethodCallException('The form factory must be set before retrieving it.');
        }

return $this->formFactory;
    }

public function getAction(): string
    {
        return $this->action;
    }

public function getMethod(): string
    {
        return $this->method;
    }

public function getRequestHandler(): RequestHandlerInterface
    {
        return $this->requestHandler ??= self::$nativeRequestHandler ??= new NativeRequestHandler();
    }

public function getAutoInitialize(): bool
    {
        return $this->autoInitialize;
    }

public function getOptions(): array
    {
        return $this->options;
    }

public function hasOption(string $name): bool
    {
        return \array_key_exists($name, $this->options);
    }

public function getOption(string $name, mixed $default = null): mixed
    {
        return \array_key_exists($name, $this->options) ? $this->options[$name] : $default;
    }

public function getIsEmptyCallback(): ?callable
    {
        return $this->isEmptyCallback;
    }

/**
     * @return $this
     */
    public function setAttribute(string $name, mixed $value): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->attributes[$name] = $value;

return $this;
    }

/**
     * @return $this
     */
    public function setAttributes(array $attributes): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->attributes = $attributes;

return $this;
    }

/**
     * @return $this
     */
    public function setDataMapper(?DataMapperInterface $dataMapper = null): static
    {
        if (1 > \func_num_args()) {
            trigger_deprecation('symfony/form', '6.2', 'Calling "%s()" without any arguments is deprecated, pass null explicitly instead.', __METHOD__);
        }
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->dataMapper = $dataMapper;

return $this;
    }

/**
     * @return $this
     */
    public function setDisabled(bool $disabled): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->disabled = $disabled;

return $this;
    }

/**
     * @return $this
     */
    public function setEmptyData(mixed $emptyData): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->emptyData = $emptyData;

return $this;
    }

/**
     * @return $this
     */
    public function setErrorBubbling(bool $errorBubbling): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->errorBubbling = $errorBubbling;

return $this;
    }

/**
     * @return $this
     */
    public function setRequired(bool $required): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->required = $required;

return $this;
    }

/**
     * @return $this
     */
    public function setPropertyPath(string|PropertyPathInterface|null $propertyPath): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

if (null !== $propertyPath && !$propertyPath instanceof PropertyPathInterface) {
            $propertyPath = new PropertyPath($propertyPath);
        }

$this->propertyPath = $propertyPath;

return $this;
    }

/**
     * @return $this
     */
    public function setMapped(bool $mapped): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->mapped = $mapped;

return $this;
    }

/**
     * @return $this
     */
    public function setByReference(bool $byReference): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->byReference = $byReference;

return $this;
    }

/**
     * @return $this
     */
    public function setInheritData(bool $inheritData): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->inheritData = $inheritData;

return $this;
    }

/**
     * @return $this
     */
    public function setCompound(bool $compound): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->compound = $compound;

return $this;
    }

/**
     * @return $this
     */
    public function setType(ResolvedFormTypeInterface $type): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->type = $type;

return $this;
    }

/**
     * @return $this
     */
    public function setData(mixed $data): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->data = $data;

return $this;
    }

/**
     * @return $this
     */
    public function setDataLocked(bool $locked): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->dataLocked = $locked;

return $this;
    }

/**
     * @return $this
     */
    public function setFormFactory(FormFactoryInterface $formFactory)
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->formFactory = $formFactory;

return $this;
    }

/**
     * @return $this
     */
    public function setAction(string $action): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('The config builder cannot be modified anymore.');
        }

$this->action = $action;

return $this;
    }

/**
     * @return $this
     */
    public function setMethod(string $method): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('The config builder cannot be modified anymore.');
        }

$this->method = strtoupper($method);

return $this;
    }

/**
     * @return $this
     */
    public function setRequestHandler(RequestHandlerInterface $requestHandler): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('The config builder cannot be modified anymore.');
        }

$this->requestHandler = $requestHandler;

return $this;
    }

/**
     * @return $this
     */
    public function setAutoInitialize(bool $initialize): static
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

$this->autoInitialize = $initialize;

return $this;
    }

public function getFormConfig(): FormConfigInterface
    {
        if ($this->locked) {
            throw new BadMethodCallException('FormConfigBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance.');
        }

// This method should be idempotent, so clone the builder
        $config = clone $this;
        $config->locked = true;

return $config;
    }

/**
     * @return $this
     */
    public function setIsEmptyCallback(?callable $isEmptyCallback): static
    {
        $this->isEmptyCallback = null === $isEmptyCallback ? null : $isEmptyCallback(...);

return $this;
    }

/**
     * Validates whether the given variable is a valid form name.
     *
     * @throws InvalidArgumentException if the name contains invalid characters
     *
     * @internal
     */
    final public static function validateName(?string $name): void
    {
        if (!self::isValidName($name)) {
            throw new InvalidArgumentException(\sprintf('The name "%s" contains illegal characters. Names should start with a letter, digit or underscore and only contain letters, digits, numbers, underscores ("_"), hyphens ("-") and colons (":").', $name));
        }
    }

/**
     * Returns whether the given variable contains a valid form name.
     *
     * A name is accepted if it
     *
     *   * is empty
     *   * starts with a letter, digit or underscore
     *   * contains only letters, digits, numbers, underscores ("_"),
     *     hyphens ("-") and colons (":")
     */
    final public static function isValidName(?string $name): bool
    {
        return '' === $name || null === $name || preg_match('/^[a-zA-Z0-9_][a-zA-Z0-9_\-:]*$/D', $name);
    }
}