Files
Christian Flothmann c52ab90ae3 Merge branch '7.4' into 8.0
* 7.4:
  deprecate passing an associative array to GroupSequence
  [Uid] Add `MockUuidFactory` for deterministic UUID generation in tests
  deprecate extending RememberMeDetails using legacy constructor signature
  [Notifier][LOX24] Add Lox24 webhook request parser support
  [WebProfilerBundle] Upgrade mermaid to v11.12.0
  [MonologBridge] Deprecate `NotFoundActivationStrategy`
  Simplify ConsoleFormatterTest
  deprecate implicit constraint option names in YAML/XML mapping files
  [Security] Fix preload warning in `AuthorizationChecker`
  [Notifier] Add support for building SmsEvent by dlr_code and RemoteEvent for other LOX24 webhook event types
  allow protocols to be passed as a string
  Fix merge
  fix high deps tests
2025-09-26 09:52:19 +02:00

80 lines
3.1 KiB
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\Validator\Constraints;
use Symfony\Component\Validator\Constraint;
use Symfony\Component\Validator\Exception\InvalidArgumentException;
/**
* Validates that a value is a valid URL string.
*
* @author Bernhard Schussek <bschussek@gmail.com>
*/
#[\Attribute(\Attribute::TARGET_PROPERTY | \Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
class Url extends Constraint
{
public const INVALID_URL_ERROR = '57c2f299-1154-4870-89bb-ef3b1f5ad229';
public const MISSING_TLD_ERROR = '8a5d387f-0716-46b4-844b-67367faf435a';
protected const ERROR_NAMES = [
self::INVALID_URL_ERROR => 'INVALID_URL_ERROR',
self::MISSING_TLD_ERROR => 'MISSING_TLD_ERROR',
];
public string $message = 'This value is not a valid URL.';
public string $tldMessage = 'This URL is missing a top-level domain.';
public array $protocols = ['http', 'https'];
public bool $relativeProtocol = false;
public bool $requireTld = true;
/** @var callable|null */
public $normalizer;
/**
* @param string[]|string|null $protocols The protocols considered to be valid for the URL (e.g. http, https, ftp, etc.) (defaults to ['http', 'https']; use '*' to allow any protocol)
* @param bool|null $relativeProtocol Whether to accept URL without the protocol (i.e. //example.com) (defaults to false)
* @param string[]|null $groups
* @param bool|null $requireTld Whether to require the URL to include a top-level domain (defaults to false)
*/
public function __construct(
?array $options = null,
?string $message = null,
array|string|null $protocols = null,
?bool $relativeProtocol = null,
?callable $normalizer = null,
?array $groups = null,
mixed $payload = null,
?bool $requireTld = null,
?string $tldMessage = null,
) {
if (null !== $options) {
throw new InvalidArgumentException(\sprintf('Passing an array of options to configure the "%s" constraint is no longer supported.', static::class));
}
parent::__construct(null, $groups, $payload);
if (\is_string($protocols)) {
$protocols = (array) $protocols;
}
$this->message = $message ?? $this->message;
$this->protocols = $protocols ?? $this->protocols;
$this->relativeProtocol = $relativeProtocol ?? $this->relativeProtocol;
$this->normalizer = $normalizer;
$this->requireTld = $requireTld ?? $this->requireTld;
$this->tldMessage = $tldMessage ?? $this->tldMessage;
if (null !== $this->normalizer && !\is_callable($this->normalizer)) {
throw new InvalidArgumentException(\sprintf('The "normalizer" option must be a valid callable ("%s" given).', get_debug_type($this->normalizer)));
}
}
}