* @copyright Since 2007 PrestaShop SA and Contributors * @license https://opensource.org/licenses/AFL-3.0 Academic Free License version 3.0 */ declare(strict_types=1); namespace PrestaShop\Module\Mbo\Traits; use PrestaShop\Module\Mbo\Exception\ExpectedServiceNotFoundException; if (!defined('_PS_VERSION_')) { exit; } trait ResolvesServices { /** * Resolve a required service from the container. * * Use a `::class` reference when the service is registered by class name; PS-core * ids without a class alias (e.g. the `router` service) are passed as a string id, * in which case the caller must keep its own `@var` annotation for type narrowing. * * @template T of object * * @param class-string|string $serviceId * * @return ($serviceId is class-string ? T : object) * * @throws ExpectedServiceNotFoundException when the service is not found */ protected function getRequiredService(string $serviceId): object { $service = $this->get($serviceId); if (null === $service) { throw new ExpectedServiceNotFoundException(sprintf('Service "%s" not found', $serviceId)); } return $service; } }