Ubuntu
* @psalm-var ServiceRef[]
*/
protected $dependencies;
/**
* Constructor.
*
* @param array $dependencies A list of dependencies, where each is a callable definition or a key.
* @psalm-param ServiceRef[] $dependencies
*/
public function __construct(array $dependencies)
{
$this->dependencies = $dependencies;
}
/**
* Retrieves the keys of dependent services.
*
* @return array A list containing a mix of callable definitions and string keys.
* @psalm-return ServiceRef[]
*/
public function getDependencies(): array
{
return $this->dependencies;
}
/**
* Creates a copy of this service with different dependency keys.
*
* @param array $dependencies A list of dependencies, where each is a callable definition or a key.
* @psalm-param ServiceRef[] $dependencies
*
* @return static The newly created service instance.
*/
public function withDependencies(array $dependencies)
{
$instance = clone $this;
$instance->dependencies = $dependencies;
return $instance;
}
/**
* Retrieves a service definition from a file.
*
* @param string $path The path to the file. This file MUST return a service definition.
* @return Service The service definition.
*
* @throws RuntimeException If problem retrieving.
*/
public static function fromFile(string $path): Service
{
if (!is_file($path) || !is_readable($path)) {
throw new RuntimeException(sprintf('Service file "%1$s" is not a file or is not readable', $path));
}
$definition = require $path;
if (!$definition instanceof Service) {
throw new UnexpectedValueException(sprintf('Service file "%1$s" does not contain a valid service', $path));
}
return $definition;
}
/**
* Creates a value for this service using a given container for dependency resolution.
*
* @param ContainerInterface $c The container to use to resolve dependencies.
*
* @return mixed The created service value.
*/
abstract public function __invoke(ContainerInterface $c);
}