• Navigation
• Constructor
• Static constructor
• Adding Arguments
• Raw
• Dependency
• Parameter
• From array
• get all
• Resolving

Service Arguments

There are currently 3 types of service arguments available.

1. Raw arguments
   Simple scalar data. (strings, numbers, booleans)
   

2. Dependencies
   In other words a reference to another service.

3. Parameters
   A reference to a value from a container parameter.

These types are also defined as constants in the ServiceArguments class:

ServiceArguments::RAW
ServiceArguments::DEPENDENCY
ServiceArguments::PARAMETER

#  Constructor

public function __construct(array $arguments = [])

The constructor takes in an array, to allow an easier / lazier way to define the arguments:

use ClanCats\Container\ServiceArguments;

$arguments = new ServiceArguments(['Hello', 'World']);

When you want do define a dependency in the array manner you can simply prefix the dependencies name with an @ char.

$mailerArguments = new ServiceArguments(['@mailer.smtp', '@queue']);

Same goes for parameters just with a : character.

$smtpArguments = new ServiceArguments([
    ':smtp.host',
    ':smtp.port',
    ...
]);

But what if I need a string that starts with an @??

The construcotr makes use of the addArgumentsFromArray method. You are still able to define the arguments directly.

$onlyRawArgs = (new ServiceArguments())
    ->addRaw('@this is still a string')
    ->addRaw(':nope not a parameter');

#  Static constructor

ServiceArguments::from([
    '@session.storage.redis',
    ':session_token',
    600, // session lifetime
])

public static function from(array $arguments) : ServiceArguments

#  Adding Arguments

#  Raw

$args = (new ServiceArguments())
    ->addRaw('a string')
    ->addRaw(42);

public function addRaw($argumentValue) : ServiceArguments

#  Dependency

$args = (new ServiceArguments())
    ->addDependency('logger');

public function addDependency($argumentValue) : ServiceArguments

#  Parameter

$args = (new ServiceArguments())
    ->addParameter('auth_token');

public function addParameter($argumentValue) : ServiceArguments

#  From array

public function addArgumentsFromArray(array $argumentsArray)

#  get all

public function getAll() : array

#  Resolving

public function resolve(Container $container) : array