Twig_Node_Expression_Call Class Reference

Inheritance diagram for Twig_Node_Expression_Call:

Collaboration diagram for Twig_Node_Expression_Call:

Protected Member Functions
	compileCallable (Twig_Compiler $compiler)
	compileArguments (Twig_Compiler $compiler)
	getArguments ($callable, $arguments)
	normalizeName ($name)

Private Member Functions
	getCallableParameters ($callable, $isVariadic)
	reflectCallable ($callable)

Private Attributes
	$reflector

Additional Inherited Members
Public Member Functions inherited from Twig_Node
	__construct (array $nodes=array(), array $attributes=array(), $lineno=0, $tag=null)
	Constructor. More...
	__toString ()
	toXml ($asDom=false)
	compile (Twig_Compiler $compiler)
	Compiles the node to PHP. More...
	getTemplateLine ()
	getLine ()
	getNodeTag ()
	hasAttribute ($name)
	getAttribute ($name)
	setAttribute ($name, $value)
	removeAttribute ($name)
	hasNode ($name)
	getNode ($name)
	setNode ($name, $node=null)
	removeNode ($name)
	count ()
	getIterator ()
	setTemplateName ($name)
	getTemplateName ()
	setFilename ($name)
	getFilename ()
Protected Attributes inherited from Twig_Node
	$nodes
	$attributes
	$lineno
	$tag

Detailed Description

Definition at line 11 of file Call.php.

Member Function Documentation

compileArguments()

Twig_Node_Expression_Call::compileArguments ( Twig_Compiler  $compiler )

protected

Definition at line 48 of file Call.php.

References getArguments(), Twig_Node\getAttribute(), Twig_Node\getNode(), Twig_Node\hasAttribute(), Twig_Node\hasNode(), Twig_Compiler\raw(), Twig_Compiler\string(), and Twig_Compiler\subcompile().

Referenced by compileCallable().

    {
        $compiler->raw('(');

        $first = true;

        if ($this->hasAttribute('needs_environment') && $this->getAttribute('needs_environment')) {
            $compiler->raw('$this->env');
            $first = false;
        }

        if ($this->hasAttribute('needs_context') && $this->getAttribute('needs_context')) {
            if (!$first) {
                $compiler->raw(', ');
            }
            $compiler->raw('$context');
            $first = false;
        }

        if ($this->hasAttribute('arguments')) {
            foreach ($this->getAttribute('arguments') as $argument) {
                if (!$first) {
                    $compiler->raw(', ');
                }
                $compiler->string($argument);
                $first = false;
            }
        }

        if ($this->hasNode('node')) {
            if (!$first) {
                $compiler->raw(', ');
            }
            $compiler->subcompile($this->getNode('node'));
            $first = false;
        }

        if ($this->hasNode('arguments')) {
            $callable = $this->hasAttribute('callable') ? $this->getAttribute('callable') : null;

            $arguments = $this->getArguments($callable, $this->getNode('arguments'));

            foreach ($arguments as $node) {
                if (!$first) {
                    $compiler->raw(', ');
                }
                $compiler->subcompile($node);
                $first = false;
            }
        }

        $compiler->raw(')');
    }

Here is the call graph for this function:

Here is the caller graph for this function:

compileCallable()

Twig_Node_Expression_Call::compileCallable ( Twig_Compiler  $compiler )

protected

Definition at line 15 of file Call.php.

References $r, $type, Twig_Node\compile(), compileArguments(), Twig_Node\getAttribute(), Twig_Node\hasAttribute(), Twig_Compiler\raw(), and reflectCallable().

Referenced by Twig_Node_Expression_Function\compile(), Twig_Node_Expression_Filter\compile(), and Twig_Node_Expression_Test\compile().

    {
        $closingParenthesis = false;
        if ($this->hasAttribute('callable') && $callable = $this->getAttribute('callable')) {
            if (is_string($callable) && false === strpos($callable, '::')) {
                $compiler->raw($callable);
            } else {
                list($r, $callable) = $this->reflectCallable($callable);
                if ($r instanceof ReflectionMethod && is_string($callable[0])) {
                    if ($r->isStatic()) {
                        $compiler->raw(sprintf('%s::%s', $callable[0], $callable[1]));
                    } else {
                        $compiler->raw(sprintf('$this->env->getRuntime(\'%s\')->%s', $callable[0], $callable[1]));
                    }
                } elseif ($r instanceof ReflectionMethod && $callable[0] instanceof Twig_ExtensionInterface) {
                    $compiler->raw(sprintf('$this->env->getExtension(\'%s\')->%s', get_class($callable[0]), $callable[1]));
                } else {
                    $type = ucfirst($this->getAttribute('type'));
                    $compiler->raw(sprintf('call_user_func_array($this->env->get%s(\'%s\')->getCallable(), array', $type, $this->getAttribute('name')));
                    $closingParenthesis = true;
                }
            }
        } else {
            $compiler->raw($this->getAttribute('thing')->compile());
        }

        $this->compileArguments($compiler);

        if ($closingParenthesis) {
            $compiler->raw(')');
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getArguments()

Twig_Node_Expression_Call::getArguments (   $callable,   $arguments  )

protected

Definition at line 102 of file Call.php.

References $key, $message, Twig_Node\$name, Twig_Node\count(), Twig_Node\getAttribute(), getCallableParameters(), Twig_Node\hasAttribute(), and normalizeName().

Referenced by compileArguments().

    {
        $callType = $this->getAttribute('type');
        $callName = $this->getAttribute('name');

        $parameters = array();
        $named = false;
        foreach ($arguments as $name => $node) {
            if (!is_int($name)) {
                $named = true;
                $name = $this->normalizeName($name);
            } elseif ($named) {
                throw new Twig_Error_Syntax(sprintf('Positional arguments cannot be used after named arguments for %s "%s".', $callType, $callName));
            }

            $parameters[$name] = $node;
        }

        $isVariadic = $this->hasAttribute('is_variadic') && $this->getAttribute('is_variadic');
        if (!$named && !$isVariadic) {
            return $parameters;
        }

        if (!$callable) {
            if ($named) {
                $message = sprintf('Named arguments are not supported for %s "%s".', $callType, $callName);
            } else {
                $message = sprintf('Arbitrary positional arguments are not supported for %s "%s".', $callType, $callName);
            }

            throw new LogicException($message);
        }

        $callableParameters = $this->getCallableParameters($callable, $isVariadic);
        $arguments = array();
        $names = array();
        $missingArguments = array();
        $optionalArguments = array();
        $pos = 0;
        foreach ($callableParameters as $callableParameter) {
            $names[] = $name = $this->normalizeName($callableParameter->name);

            if (array_key_exists($name, $parameters)) {
                if (array_key_exists($pos, $parameters)) {
                    throw new Twig_Error_Syntax(sprintf('Argument "%s" is defined twice for %s "%s".', $name, $callType, $callName));
                }

                if (count($missingArguments)) {
                    throw new Twig_Error_Syntax(sprintf(
                        'Argument "%s" could not be assigned for %s "%s(%s)" because it is mapped to an internal PHP function which cannot determine default value for optional argument%s "%s".',
                        $name, $callType, $callName, implode(', ', $names), count($missingArguments) > 1 ? 's' : '', implode('", "', $missingArguments))
                    );
                }

                $arguments = array_merge($arguments, $optionalArguments);
                $arguments[] = $parameters[$name];
                unset($parameters[$name]);
                $optionalArguments = array();
            } elseif (array_key_exists($pos, $parameters)) {
                $arguments = array_merge($arguments, $optionalArguments);
                $arguments[] = $parameters[$pos];
                unset($parameters[$pos]);
                $optionalArguments = array();
                ++$pos;
            } elseif ($callableParameter->isDefaultValueAvailable()) {
                $optionalArguments[] = new Twig_Node_Expression_Constant($callableParameter->getDefaultValue(), -1);
            } elseif ($callableParameter->isOptional()) {
                if (empty($parameters)) {
                    break;
                } else {
                    $missingArguments[] = $name;
                }
            } else {
                throw new Twig_Error_Syntax(sprintf('Value for argument "%s" is required for %s "%s".', $name, $callType, $callName));
            }
        }

        if ($isVariadic) {
            $arbitraryArguments = new Twig_Node_Expression_Array(array(), -1);
            foreach ($parameters as $key => $value) {
                if (is_int($key)) {
                    $arbitraryArguments->addElement($value);
                } else {
                    $arbitraryArguments->addElement($value, new Twig_Node_Expression_Constant($key, -1));
                }
                unset($parameters[$key]);
            }

            if ($arbitraryArguments->count()) {
                $arguments = array_merge($arguments, $optionalArguments);
                $arguments[] = $arbitraryArguments;
            }
        }

        if (!empty($parameters)) {
            $unknownParameter = null;
            foreach ($parameters as $parameter) {
                if ($parameter instanceof Twig_Node) {
                    $unknownParameter = $parameter;
                    break;
                }
            }

            throw new Twig_Error_Syntax(sprintf(
                'Unknown argument%s "%s" for %s "%s(%s)".',
                count($parameters) > 1 ? 's' : '', implode('", "', array_keys($parameters)), $callType, $callName, implode(', ', $names)
            ), $unknownParameter ? $unknownParameter->getTemplateLine() : -1);
        }

        return $arguments;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getCallableParameters()

Twig_Node_Expression_Call::getCallableParameters (   $callable,   $isVariadic  )

private

Definition at line 219 of file Call.php.

References $r, Twig_Node\getAttribute(), Twig_Node\hasAttribute(), Twig_Node\hasNode(), and reflectCallable().

Referenced by getArguments().

    {
        list($r) = $this->reflectCallable($callable);
        if (null === $r) {
            return array();
        }

        $parameters = $r->getParameters();
        if ($this->hasNode('node')) {
            array_shift($parameters);
        }
        if ($this->hasAttribute('needs_environment') && $this->getAttribute('needs_environment')) {
            array_shift($parameters);
        }
        if ($this->hasAttribute('needs_context') && $this->getAttribute('needs_context')) {
            array_shift($parameters);
        }
        if ($this->hasAttribute('arguments') && null !== $this->getAttribute('arguments')) {
            foreach ($this->getAttribute('arguments') as $argument) {
                array_shift($parameters);
            }
        }
        if ($isVariadic) {
            $argument = end($parameters);
            if ($argument && $argument->isArray() && $argument->isDefaultValueAvailable() && array() === $argument->getDefaultValue()) {
                array_pop($parameters);
            } else {
                $callableName = $r->name;
                if ($r instanceof ReflectionMethod) {
                    $callableName = $r->getDeclaringClass()->name.'::'.$callableName;
                }

                throw new LogicException(sprintf('The last parameter of "%s" for %s "%s" must be an array with default value, eg. "array $arg = array()".', $callableName, $this->getAttribute('type'), $this->getAttribute('name')));
            }
        }

        return $parameters;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

normalizeName()

Twig_Node_Expression_Call::normalizeName (   $name )

protected

Definition at line 214 of file Call.php.

References Twig_Node\$name.

Referenced by getArguments().

    {
        return strtolower(preg_replace(array('/([A-Z]+)([A-Z][a-z])/', '/([a-z\d])([A-Z])/'), array('\\1_\\2', '\\1_\\2'), $name));
    }

Here is the caller graph for this function:

reflectCallable()

Twig_Node_Expression_Call::reflectCallable (   $callable )

private

Definition at line 258 of file Call.php.

References $r, and $reflector.

Referenced by compileCallable(), and getCallableParameters().

    {
        if (null !== $this->reflector) {
            return $this->reflector;
        }

        if (is_array($callable)) {
            if (!method_exists($callable[0], $callable[1])) {
                // __call()
                return array(null, array());
            }
            $r = new ReflectionMethod($callable[0], $callable[1]);
        } elseif (is_object($callable) && !$callable instanceof Closure) {
            $r = new ReflectionObject($callable);
            $r = $r->getMethod('__invoke');
            $callable = array($callable, '__invoke');
        } elseif (is_string($callable) && false !== $pos = strpos($callable, '::')) {
            $class = substr($callable, 0, $pos);
            $method = substr($callable, $pos + 2);
            if (!method_exists($class, $method)) {
                // __staticCall()
                return array(null, array());
            }
            $r = new ReflectionMethod($callable);
            $callable = array($class, $method);
        } else {
            $r = new ReflectionFunction($callable);
        }

        return $this->reflector = array($r, $callable);
    }

Here is the caller graph for this function:

Field Documentation

$reflector

Twig_Node_Expression_Call::$reflector

private

Definition at line 13 of file Call.php.

Referenced by reflectCallable().

---

The documentation for this class was generated from the following file:

• libs/composer/vendor/twig/twig/lib/Twig/Node/Expression/Call.php