Add optional params to make() method

[feryardiant]

Add ability to optionally pass additional params to its callback and throws InvalidArgumentException if it was invalid, obviously.

Specs:

• 2nd param must be an array or closure
  

  container/test/spec/Container.spec.php

  Lines 185 to 189 in 512222e

  	expect(function () {
  	$this->c->make(Stubs\SomeClass::class, 'string');
  	})->toThrow(new InvalidArgumentException(
  	'Expect parameter 2 to be an array or Closure, string given'
  	));

  • If it was an array, treat it as arguments for the callback handler
  • If it was a closure, treat it as condition of method should handled by the callback handler
• 3rd param must be a closure, condition of method should handled by the callback handler
  

  container/test/spec/Container.spec.php

  Lines 213 to 217 in 512222e

  	expect(
  	$this->c->make(Stubs\SomeClass::class, ['new value'], function ($instance) {
  	return [$instance, 'shouldCalled'];
  	})
  	)->toEqual('new value');

• do nothing if no additional params present
• no more than 3 params for make()
  

  container/test/spec/Container.spec.php

  Lines 203 to 207 in 512222e

  	expect(function () {
  	$this->c->make(Stubs\SomeClass::class, ['string'], 'condition', 'more');
  	})->toThrow(new InvalidArgumentException(
  	'Could not accept more than 3 arguments, 4 given'
  	));

[feryardiant]

Note

The array of second arguments will only be passed to callback method not the class constructor.

$container->make(SomeClass::class, ['value']); // returns 'value'

class SomeClass
{
    // The $param will call $container->get('param')
    public function __construct($param) {}

    // The $param will get 'value'
    public function __invoke($param) {
        return $param
    }
}

$container->make('AnotherClass::theMethod', ['value']); // returns 'value', OR
$container->make(['AnotherClass', 'theMethod'], ['value']); // returns 'value'

class AnotherClass
{
    // The $param will call $container->get('param')
    public function __construct($param) {}

    // The $param will get 'value'
    public function theMethod($param) {
        return $param
    }
}

If the 1st param is not callable or conditionally call a method from 3rd param, the array parameter will be ignored and make method will return the instance of the class.

// The 'value' will be ignored since this class doesn't have `__invoke` method.
$container->make(SomeClass::class, ['value']); // returns instance of SomeClass

class SomeClass
{
    // The $param will remain call $container->get('param')
    public function __construct($param) {}

    public function someMethod($param) {
        return $param
    }
}

[feryardiant]

If the 1st param is a closure, the 2nd param will passed to the callback

container/test/spec/Container.spec.php

Lines 241 to 243 in b685fde

	expect($this->c->make(function ($param) {
	return $param;
	}, ['value']))->toEqual('value');

Unless it overrided by the 3rd param

container/test/spec/Container.spec.php

Lines 245 to 253 in b685fde

	expect($this->c->make(function () {
	return new Stubs\SomeClass;
	}, ['value'], function ($closure) {
	$instance = $closure();
	return $instance instanceof Stubs\CertainInterface
	? [$instance, 'shouldCalled'] // `shouldCalled` method will get the 'value'
	: $closure;
	}))->toEqual('value');