-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
0 parents
commit f8f2b48
Showing
7 changed files
with
1,653 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,183 @@ | ||
<?php | ||
|
||
namespace IgniteKit\Backports\Container; | ||
|
||
use Closure; | ||
use ReflectionMethod; | ||
use ReflectionFunction; | ||
use InvalidArgumentException; | ||
|
||
class BoundMethod | ||
{ | ||
/** | ||
* Call the given Closure / class@method and inject its dependencies. | ||
* | ||
* @param \IgniteKit\Backports\Container\Container $container | ||
* @param callable|string $callback | ||
* @param array $parameters | ||
* @param string|null $defaultMethod | ||
* @return mixed | ||
* | ||
* @throws \ReflectionException | ||
* @throws \InvalidArgumentException | ||
*/ | ||
public static function call($container, $callback, array $parameters = [], $defaultMethod = null) | ||
{ | ||
if (static::isCallableWithAtSign($callback) || $defaultMethod) { | ||
return static::callClass($container, $callback, $parameters, $defaultMethod); | ||
} | ||
|
||
return static::callBoundMethod($container, $callback, function () use ($container, $callback, $parameters) { | ||
return call_user_func_array( | ||
$callback, static::getMethodDependencies($container, $callback, $parameters) | ||
); | ||
}); | ||
} | ||
|
||
/** | ||
* Call a string reference to a class using Class@method syntax. | ||
* | ||
* @param \IgniteKit\Backports\Container\Container $container | ||
* @param string $target | ||
* @param array $parameters | ||
* @param string|null $defaultMethod | ||
* @return mixed | ||
* | ||
* @throws \InvalidArgumentException | ||
*/ | ||
protected static function callClass($container, $target, array $parameters = [], $defaultMethod = null) | ||
{ | ||
$segments = explode('@', $target); | ||
|
||
// We will assume an @ sign is used to delimit the class name from the method | ||
// name. We will split on this @ sign and then build a callable array that | ||
// we can pass right back into the "call" method for dependency binding. | ||
$method = count($segments) === 2 | ||
? $segments[1] : $defaultMethod; | ||
|
||
if (is_null($method)) { | ||
throw new InvalidArgumentException('Method not provided.'); | ||
} | ||
|
||
return static::call( | ||
$container, [$container->make($segments[0]), $method], $parameters | ||
); | ||
} | ||
|
||
/** | ||
* Call a method that has been bound to the container. | ||
* | ||
* @param \IgniteKit\Backports\Container\Container $container | ||
* @param callable $callback | ||
* @param mixed $default | ||
* @return mixed | ||
*/ | ||
protected static function callBoundMethod($container, $callback, $default) | ||
{ | ||
if (! is_array($callback)) { | ||
return $default instanceof Closure ? $default() : $default; | ||
} | ||
|
||
// Here we need to turn the array callable into a Class@method string we can use to | ||
// examine the container and see if there are any method bindings for this given | ||
// method. If there are, we can call this method binding callback immediately. | ||
$method = static::normalizeMethod($callback); | ||
|
||
if ($container->hasMethodBinding($method)) { | ||
return $container->callMethodBinding($method, $callback[0]); | ||
} | ||
|
||
return $default instanceof Closure ? $default() : $default; | ||
} | ||
|
||
/** | ||
* Normalize the given callback into a Class@method string. | ||
* | ||
* @param callable $callback | ||
* @return string | ||
*/ | ||
protected static function normalizeMethod($callback) | ||
{ | ||
$class = is_string($callback[0]) ? $callback[0] : get_class($callback[0]); | ||
|
||
return "{$class}@{$callback[1]}"; | ||
} | ||
|
||
/** | ||
* Get all dependencies for a given method. | ||
* | ||
* @param \IgniteKit\Backports\Container\Container $container | ||
* @param callable|string $callback | ||
* @param array $parameters | ||
* @return array | ||
* | ||
* @throws \ReflectionException | ||
*/ | ||
protected static function getMethodDependencies($container, $callback, array $parameters = []) | ||
{ | ||
$dependencies = []; | ||
|
||
foreach (static::getCallReflector($callback)->getParameters() as $parameter) { | ||
static::addDependencyForCallParameter($container, $parameter, $parameters, $dependencies); | ||
} | ||
|
||
return array_merge($dependencies, $parameters); | ||
} | ||
|
||
/** | ||
* Get the proper reflection instance for the given callback. | ||
* | ||
* @param callable|string $callback | ||
* @return \ReflectionFunctionAbstract | ||
* | ||
* @throws \ReflectionException | ||
*/ | ||
protected static function getCallReflector($callback) | ||
{ | ||
if (is_string($callback) && strpos($callback, '::') !== false) { | ||
$callback = explode('::', $callback); | ||
} | ||
|
||
return is_array($callback) | ||
? new ReflectionMethod($callback[0], $callback[1]) | ||
: new ReflectionFunction($callback); | ||
} | ||
|
||
/** | ||
* Get the dependency for the given call parameter. | ||
* | ||
* @param \IgniteKit\Backports\Container\Container $container | ||
* @param \ReflectionParameter $parameter | ||
* @param array $parameters | ||
* @param array $dependencies | ||
* @return void | ||
*/ | ||
protected static function addDependencyForCallParameter($container, $parameter, | ||
array &$parameters, &$dependencies) | ||
{ | ||
if (array_key_exists($parameter->name, $parameters)) { | ||
$dependencies[] = $parameters[$parameter->name]; | ||
|
||
unset($parameters[$parameter->name]); | ||
} elseif ($parameter->getClass() && array_key_exists($parameter->getClass()->name, $parameters)) { | ||
$dependencies[] = $parameters[$parameter->getClass()->name]; | ||
|
||
unset($parameters[$parameter->getClass()->name]); | ||
} elseif ($parameter->getClass()) { | ||
$dependencies[] = $container->make($parameter->getClass()->name); | ||
} elseif ($parameter->isDefaultValueAvailable()) { | ||
$dependencies[] = $parameter->getDefaultValue(); | ||
} | ||
} | ||
|
||
/** | ||
* Determine if the given string is in Class@method syntax. | ||
* | ||
* @param mixed $callback | ||
* @return bool | ||
*/ | ||
protected static function isCallableWithAtSign($callback) | ||
{ | ||
return is_string($callback) && strpos($callback, '@') !== false; | ||
} | ||
} |
Oops, something went wrong.