ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: home / fengshp / www / wp-content / plugins / spotlight-social-photo-feeds / vendor / dhii / services / src

<?php

declare(strict_types=1);

namespace Dhii\Services;

use Psr\Container\ContainerInterface;
use RuntimeException;
use UnexpectedValueException;

/**
 * Partial implementation of a service.
 *
 * This class represents a DI service in functor form. Instances of this class or its derivations are invocable via
 * the magic {@link __invoke()} method. The signature of this method is equivalent to that of regular service definition
 * functions, in that they accept a {@link ContainerInterface} instance.
 *
 * Services are also aware of any services that they depend on, by key. These keys may be used by derivations of this
 * class to achieve some automation, be it during run-time or for static analysis purposes.
 *
 * @see   __invoke()
 * @see   ContainerInterface
 */
abstract class Service
{
    /**
     * @var string[]
     */
    protected $dependencies;

/**
     * Constructor.
     *
     * @param string[] $dependencies A list of keys that correspond to other services that this service depends on.
     */
    public function __construct(array $dependencies)
    {
        $this->dependencies = $dependencies;
    }

/**
     * Retrieves the keys of dependent services.
     *
     * @return string[] A list of strings each representing the key of a service.
     */
    public function getDependencies(): array
    {
        return $this->dependencies;
    }

/**
     * Creates a copy of this service with different dependency keys.
     *
     * @param array $dependencies The new service dependency keys.
     *
     * @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);
}

[+] ..
[-] Factory.php [edit]
[-] Extension.php [edit]
[-] ResolveKeysCapableTrait.php [edit]
[+] Factories
[-] Service.php [edit]
[+] Extensions