* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace RectorPrefix20210707\Symfony\Component\DependencyInjection; use RectorPrefix20210707\Symfony\Component\DependencyInjection\Exception\InvalidArgumentException; class Alias { private const DEFAULT_DEPRECATION_TEMPLATE = 'The "%alias_id%" service alias is deprecated. You should stop using it, as it will be removed in the future.'; private $id; private $public; private $deprecation = []; public function __construct(string $id, bool $public = \false) { $this->id = $id; $this->public = $public; } /** * Checks if this DI Alias should be public or not. * * @return bool */ public function isPublic() { return $this->public; } /** * Sets if this Alias is public. * * @return $this * @param bool $boolean */ public function setPublic($boolean) { $this->public = $boolean; return $this; } /** * Sets if this Alias is private. * * @return $this * * @deprecated since Symfony 5.2, use setPublic() instead * @param bool $boolean */ public function setPrivate($boolean) { trigger_deprecation('symfony/dependency-injection', '5.2', 'The "%s()" method is deprecated, use "setPublic()" instead.', __METHOD__); return $this->setPublic(!$boolean); } /** * Whether this alias is private. * * @return bool */ public function isPrivate() { return !$this->public; } /** * Whether this alias is deprecated, that means it should not be referenced * anymore. * * @param string $package The name of the composer package that is triggering the deprecation * @param string $version The version of the package that introduced the deprecation * @param string $message The deprecation message to use * * @return $this * * @throws InvalidArgumentException when the message template is invalid */ public function setDeprecated() { $args = \func_get_args(); if (\func_num_args() < 3) { trigger_deprecation('symfony/dependency-injection', '5.1', 'The signature of method "%s()" requires 3 arguments: "string $package, string $version, string $message", not defining them is deprecated.', __METHOD__); $status = $args[0] ?? \true; if (!$status) { trigger_deprecation('symfony/dependency-injection', '5.1', 'Passing a null message to un-deprecate a node is deprecated.'); } $message = (string) ($args[1] ?? null); $package = $version = ''; } else { $status = \true; $package = (string) $args[0]; $version = (string) $args[1]; $message = (string) $args[2]; } if ('' !== $message) { if (\preg_match('#[\\r\\n]|\\*/#', $message)) { throw new \RectorPrefix20210707\Symfony\Component\DependencyInjection\Exception\InvalidArgumentException('Invalid characters found in deprecation template.'); } if (\false === \strpos($message, '%alias_id%')) { throw new \RectorPrefix20210707\Symfony\Component\DependencyInjection\Exception\InvalidArgumentException('The deprecation template must contain the "%alias_id%" placeholder.'); } } $this->deprecation = $status ? ['package' => $package, 'version' => $version, 'message' => $message ?: self::DEFAULT_DEPRECATION_TEMPLATE] : []; return $this; } public function isDeprecated() : bool { return (bool) $this->deprecation; } /** * @deprecated since Symfony 5.1, use "getDeprecation()" instead. * @param string $id */ public function getDeprecationMessage($id) : string { trigger_deprecation('symfony/dependency-injection', '5.1', 'The "%s()" method is deprecated, use "getDeprecation()" instead.', __METHOD__); return $this->getDeprecation($id)['message']; } /** * @param string $id Service id relying on this definition */ public function getDeprecation($id) : array { return ['package' => $this->deprecation['package'], 'version' => $this->deprecation['version'], 'message' => \str_replace('%alias_id%', $id, $this->deprecation['message'])]; } /** * Returns the Id of this alias. * * @return string The alias id */ public function __toString() { return $this->id; } }