Update to Drupal 8.0-dev-2015-11-17. Commits through da81cd220, Tue Nov 17 15:53:49 2015 +0000, Issue #2617224 by Wim Leers: Move around/fix some documentation.

This commit is contained in:
Pantheon Automation 2015-11-17 13:42:33 -08:00 committed by Greg Anderson
parent 4afb23bbd3
commit 7784f4c23d
929 changed files with 19798 additions and 5304 deletions

View file

@ -11,9 +11,6 @@
namespace Symfony\Component\DependencyInjection;
/**
* @api
*/
class Alias
{
private $id;
@ -24,8 +21,6 @@ class Alias
*
* @param string $id Alias identifier
* @param bool $public If this alias is public
*
* @api
*/
public function __construct($id, $public = true)
{
@ -37,8 +32,6 @@ class Alias
* Checks if this DI Alias should be public or not.
*
* @return bool
*
* @api
*/
public function isPublic()
{
@ -49,8 +42,6 @@ class Alias
* Sets if this Alias is public.
*
* @param bool $boolean If this Alias should be public
*
* @api
*/
public function setPublic($boolean)
{
@ -61,8 +52,6 @@ class Alias
* Returns the Id of this alias.
*
* @return string The alias id
*
* @api
*/
public function __toString()
{

View file

@ -64,7 +64,6 @@ class CheckReferenceValidityPass implements CompilerPassInterface
}
$this->currentId = $id;
$this->currentDefinition = $definition;
$this->currentScope = $scope = $definition->getScope();
if (ContainerInterface::SCOPE_CONTAINER === $scope) {

View file

@ -17,8 +17,6 @@ use Symfony\Component\DependencyInjection\ContainerBuilder;
* This class is used to remove circular dependencies between individual passes.
*
* @author Johannes M. Schmitt <schmittjoh@gmail.com>
*
* @api
*/
class Compiler
{
@ -41,8 +39,6 @@ class Compiler
* Returns the PassConfig.
*
* @return PassConfig The PassConfig instance
*
* @api
*/
public function getPassConfig()
{
@ -53,8 +49,6 @@ class Compiler
* Returns the ServiceReferenceGraph.
*
* @return ServiceReferenceGraph The ServiceReferenceGraph instance
*
* @api
*/
public function getServiceReferenceGraph()
{
@ -76,8 +70,6 @@ class Compiler
*
* @param CompilerPassInterface $pass A compiler pass
* @param string $type The type of the pass
*
* @api
*/
public function addPass(CompilerPassInterface $pass, $type = PassConfig::TYPE_BEFORE_OPTIMIZATION)
{
@ -108,8 +100,6 @@ class Compiler
* Run the Compiler and process all Passes.
*
* @param ContainerBuilder $container
*
* @api
*/
public function compile(ContainerBuilder $container)
{

View file

@ -17,8 +17,6 @@ use Symfony\Component\DependencyInjection\ContainerBuilder;
* Interface that must be implemented by compilation passes.
*
* @author Johannes M. Schmitt <schmittjoh@gmail.com>
*
* @api
*/
interface CompilerPassInterface
{
@ -26,8 +24,6 @@ interface CompilerPassInterface
* You can modify the container here before it is dumped to PHP code.
*
* @param ContainerBuilder $container
*
* @api
*/
public function process(ContainerBuilder $container);
}

View file

@ -1,5 +1,14 @@
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Symfony\Component\DependencyInjection\Compiler;
use Symfony\Component\DependencyInjection\ContainerBuilder;

View file

@ -19,8 +19,6 @@ use Symfony\Component\DependencyInjection\Exception\InvalidArgumentException;
* This class has a default configuration embedded.
*
* @author Johannes M. Schmitt <schmittjoh@gmail.com>
*
* @api
*/
class PassConfig
{
@ -75,8 +73,6 @@ class PassConfig
* Returns all passes in order to be processed.
*
* @return array An array of all passes to process
*
* @api
*/
public function getPasses()
{
@ -97,8 +93,6 @@ class PassConfig
* @param string $type The pass type
*
* @throws InvalidArgumentException when a pass type doesn't exist
*
* @api
*/
public function addPass(CompilerPassInterface $pass, $type = self::TYPE_BEFORE_OPTIMIZATION)
{
@ -115,8 +109,6 @@ class PassConfig
* Gets all passes for the AfterRemoving pass.
*
* @return array An array of passes
*
* @api
*/
public function getAfterRemovingPasses()
{
@ -127,8 +119,6 @@ class PassConfig
* Gets all passes for the BeforeOptimization pass.
*
* @return array An array of passes
*
* @api
*/
public function getBeforeOptimizationPasses()
{
@ -139,8 +129,6 @@ class PassConfig
* Gets all passes for the BeforeRemoving pass.
*
* @return array An array of passes
*
* @api
*/
public function getBeforeRemovingPasses()
{
@ -151,8 +139,6 @@ class PassConfig
* Gets all passes for the Optimization pass.
*
* @return array An array of passes
*
* @api
*/
public function getOptimizationPasses()
{
@ -163,8 +149,6 @@ class PassConfig
* Gets all passes for the Removing pass.
*
* @return array An array of passes
*
* @api
*/
public function getRemovingPasses()
{
@ -175,8 +159,6 @@ class PassConfig
* Gets all passes for the Merge pass.
*
* @return array An array of passes
*
* @api
*/
public function getMergePass()
{
@ -187,8 +169,6 @@ class PassConfig
* Sets the Merge Pass.
*
* @param CompilerPassInterface $pass The merge pass
*
* @api
*/
public function setMergePass(CompilerPassInterface $pass)
{
@ -199,8 +179,6 @@ class PassConfig
* Sets the AfterRemoving passes.
*
* @param array $passes An array of passes
*
* @api
*/
public function setAfterRemovingPasses(array $passes)
{
@ -211,8 +189,6 @@ class PassConfig
* Sets the BeforeOptimization passes.
*
* @param array $passes An array of passes
*
* @api
*/
public function setBeforeOptimizationPasses(array $passes)
{
@ -223,8 +199,6 @@ class PassConfig
* Sets the BeforeRemoving passes.
*
* @param array $passes An array of passes
*
* @api
*/
public function setBeforeRemovingPasses(array $passes)
{
@ -235,8 +209,6 @@ class PassConfig
* Sets the Optimization passes.
*
* @param array $passes An array of passes
*
* @api
*/
public function setOptimizationPasses(array $passes)
{
@ -247,8 +219,6 @@ class PassConfig
* Sets the Removing passes.
*
* @param array $passes An array of passes
*
* @api
*/
public function setRemovingPasses(array $passes)
{

View file

@ -57,8 +57,6 @@ use Symfony\Component\DependencyInjection\ParameterBag\FrozenParameterBag;
*
* @author Fabien Potencier <fabien@symfony.com>
* @author Johannes M. Schmitt <schmittjoh@gmail.com>
*
* @api
*/
class Container implements IntrospectableContainerInterface
{
@ -82,8 +80,6 @@ class Container implements IntrospectableContainerInterface
* Constructor.
*
* @param ParameterBagInterface $parameterBag A ParameterBagInterface instance
*
* @api
*/
public function __construct(ParameterBagInterface $parameterBag = null)
{
@ -97,8 +93,6 @@ class Container implements IntrospectableContainerInterface
*
* * Parameter values are resolved;
* * The parameter bag is frozen.
*
* @api
*/
public function compile()
{
@ -111,8 +105,6 @@ class Container implements IntrospectableContainerInterface
* Returns true if the container parameter bag are frozen.
*
* @return bool true if the container parameter bag are frozen, false otherwise
*
* @api
*/
public function isFrozen()
{
@ -123,8 +115,6 @@ class Container implements IntrospectableContainerInterface
* Gets the service container parameter bag.
*
* @return ParameterBagInterface A ParameterBagInterface instance
*
* @api
*/
public function getParameterBag()
{
@ -139,8 +129,6 @@ class Container implements IntrospectableContainerInterface
* @return mixed The parameter value
*
* @throws InvalidArgumentException if the parameter is not defined
*
* @api
*/
public function getParameter($name)
{
@ -153,8 +141,6 @@ class Container implements IntrospectableContainerInterface
* @param string $name The parameter name
*
* @return bool The presence of parameter in container
*
* @api
*/
public function hasParameter($name)
{
@ -166,8 +152,6 @@ class Container implements IntrospectableContainerInterface
*
* @param string $name The parameter name
* @param mixed $value The parameter value
*
* @api
*/
public function setParameter($name, $value)
{
@ -186,8 +170,6 @@ class Container implements IntrospectableContainerInterface
*
* @throws RuntimeException When trying to set a service in an inactive scope
* @throws InvalidArgumentException When trying to set a service in the prototype scope
*
* @api
*/
public function set($id, $service, $scope = self::SCOPE_CONTAINER)
{
@ -232,8 +214,6 @@ class Container implements IntrospectableContainerInterface
* @param string $id The service identifier
*
* @return bool true if the service is defined, false otherwise
*
* @api
*/
public function has($id)
{
@ -269,8 +249,6 @@ class Container implements IntrospectableContainerInterface
* @throws \Exception if an exception has been thrown when the service has been resolved
*
* @see Reference
*
* @api
*/
public function get($id, $invalidBehavior = self::EXCEPTION_ON_INVALID_REFERENCE)
{
@ -395,8 +373,6 @@ class Container implements IntrospectableContainerInterface
*
* @throws RuntimeException When the parent scope is inactive
* @throws InvalidArgumentException When the scope does not exist
*
* @api
*/
public function enterScope($name)
{
@ -443,8 +419,6 @@ class Container implements IntrospectableContainerInterface
* @param string $name The name of the scope to leave
*
* @throws InvalidArgumentException if the scope is not active
*
* @api
*/
public function leaveScope($name)
{
@ -490,8 +464,6 @@ class Container implements IntrospectableContainerInterface
* @param ScopeInterface $scope
*
* @throws InvalidArgumentException
*
* @api
*/
public function addScope(ScopeInterface $scope)
{
@ -524,8 +496,6 @@ class Container implements IntrospectableContainerInterface
* @param string $name The name of the scope
*
* @return bool
*
* @api
*/
public function hasScope($name)
{
@ -540,8 +510,6 @@ class Container implements IntrospectableContainerInterface
* @param string $name
*
* @return bool
*
* @api
*/
public function isScopeActive($name)
{

View file

@ -15,15 +15,11 @@ namespace Symfony\Component\DependencyInjection;
* A simple implementation of ContainerAwareInterface.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @api
*/
abstract class ContainerAware implements ContainerAwareInterface
{
/**
* @var ContainerInterface
*
* @api
*/
protected $container;
@ -31,8 +27,6 @@ abstract class ContainerAware implements ContainerAwareInterface
* Sets the Container associated with this Controller.
*
* @param ContainerInterface $container A ContainerInterface instance
*
* @api
*/
public function setContainer(ContainerInterface $container = null)
{

View file

@ -15,8 +15,6 @@ namespace Symfony\Component\DependencyInjection;
* ContainerAwareInterface should be implemented by classes that depends on a Container.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @api
*/
interface ContainerAwareInterface
{
@ -24,8 +22,6 @@ interface ContainerAwareInterface
* Sets the Container.
*
* @param ContainerInterface|null $container A ContainerInterface instance or null
*
* @api
*/
public function setContainer(ContainerInterface $container = null);
}

View file

@ -31,8 +31,6 @@ use Symfony\Component\ExpressionLanguage\ExpressionFunctionProviderInterface;
* ContainerBuilder is a DI container that provides an API to easily describe services.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @api
*/
class ContainerBuilder extends Container implements TaggedContainerInterface
{
@ -127,8 +125,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* Registers an extension.
*
* @param ExtensionInterface $extension An extension instance
*
* @api
*/
public function registerExtension(ExtensionInterface $extension)
{
@ -147,8 +143,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @return ExtensionInterface An extension instance
*
* @throws LogicException if the extension is not registered
*
* @api
*/
public function getExtension($name)
{
@ -167,8 +161,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* Returns all registered extensions.
*
* @return ExtensionInterface[] An array of ExtensionInterface
*
* @api
*/
public function getExtensions()
{
@ -181,8 +173,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @param string $name The name of the extension
*
* @return bool If the extension exists
*
* @api
*/
public function hasExtension($name)
{
@ -193,8 +183,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* Returns an array of resources loaded to build this configuration.
*
* @return ResourceInterface[] An array of resources
*
* @api
*/
public function getResources()
{
@ -207,8 +195,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @param ResourceInterface $resource A resource instance
*
* @return ContainerBuilder The current instance
*
* @api
*/
public function addResource(ResourceInterface $resource)
{
@ -227,8 +213,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @param ResourceInterface[] $resources An array of resources
*
* @return ContainerBuilder The current instance
*
* @api
*/
public function setResources(array $resources)
{
@ -247,8 +231,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @param object $object An object instance
*
* @return ContainerBuilder The current instance
*
* @api
*/
public function addObjectResource($object)
{
@ -289,8 +271,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
*
* @throws BadMethodCallException When this ContainerBuilder is frozen
* @throws \LogicException if the container is frozen
*
* @api
*/
public function loadFromExtension($extension, array $values = array())
{
@ -312,8 +292,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @param string $type The type of compiler pass
*
* @return ContainerBuilder The current instance
*
* @api
*/
public function addCompilerPass(CompilerPassInterface $pass, $type = PassConfig::TYPE_BEFORE_OPTIMIZATION)
{
@ -328,8 +306,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* Returns the compiler pass config which can then be modified.
*
* @return PassConfig The compiler pass config
*
* @api
*/
public function getCompilerPassConfig()
{
@ -340,8 +316,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* Returns the compiler.
*
* @return Compiler The compiler
*
* @api
*/
public function getCompiler()
{
@ -356,8 +330,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* Returns all Scopes.
*
* @return array An array of scopes
*
* @api
*/
public function getScopes()
{
@ -368,8 +340,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* Returns all Scope children.
*
* @return array An array of scope children.
*
* @api
*/
public function getScopeChildren()
{
@ -384,8 +354,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @param string $scope The scope
*
* @throws BadMethodCallException When this ContainerBuilder is frozen
*
* @api
*/
public function set($id, $service, $scope = self::SCOPE_CONTAINER)
{
@ -421,8 +389,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* Removes a service definition.
*
* @param string $id The service identifier
*
* @api
*/
public function removeDefinition($id)
{
@ -435,8 +401,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @param string $id The service identifier
*
* @return bool true if the service is defined, false otherwise
*
* @api
*/
public function has($id)
{
@ -459,8 +423,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @throws \Exception
*
* @see Reference
*
* @api
*/
public function get($id, $invalidBehavior = ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE)
{
@ -524,8 +486,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @param ContainerBuilder $container The ContainerBuilder instance to merge.
*
* @throws BadMethodCallException When this ContainerBuilder is frozen
*
* @api
*/
public function merge(ContainerBuilder $container)
{
@ -558,8 +518,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @param string $name The name of the extension
*
* @return array An array of configuration
*
* @api
*/
public function getExtensionConfig($name)
{
@ -598,8 +556,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* * Parameter values are resolved;
* * The parameter bag is frozen;
* * Extension loading is disabled.
*
* @api
*/
public function compile()
{
@ -640,8 +596,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* Adds the service aliases.
*
* @param array $aliases An array of aliases
*
* @api
*/
public function addAliases(array $aliases)
{
@ -654,8 +608,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* Sets the service aliases.
*
* @param array $aliases An array of aliases
*
* @api
*/
public function setAliases(array $aliases)
{
@ -671,8 +623,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
*
* @throws InvalidArgumentException if the id is not a string or an Alias
* @throws InvalidArgumentException if the alias is for itself
*
* @api
*/
public function setAlias($alias, $id)
{
@ -697,8 +647,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* Removes an alias.
*
* @param string $alias The alias to remove
*
* @api
*/
public function removeAlias($alias)
{
@ -711,8 +659,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @param string $id The service identifier
*
* @return bool true if the alias exists, false otherwise
*
* @api
*/
public function hasAlias($id)
{
@ -723,8 +669,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* Gets all defined aliases.
*
* @return Alias[] An array of aliases
*
* @api
*/
public function getAliases()
{
@ -739,8 +683,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @return Alias An Alias instance
*
* @throws InvalidArgumentException if the alias does not exist
*
* @api
*/
public function getAlias($id)
{
@ -763,8 +705,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @param string $class The service class
*
* @return Definition A Definition instance
*
* @api
*/
public function register($id, $class = null)
{
@ -775,8 +715,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* Adds the service definitions.
*
* @param Definition[] $definitions An array of service definitions
*
* @api
*/
public function addDefinitions(array $definitions)
{
@ -789,8 +727,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* Sets the service definitions.
*
* @param Definition[] $definitions An array of service definitions
*
* @api
*/
public function setDefinitions(array $definitions)
{
@ -802,8 +738,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* Gets all service definitions.
*
* @return Definition[] An array of Definition instances
*
* @api
*/
public function getDefinitions()
{
@ -819,8 +753,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @return Definition the service definition
*
* @throws BadMethodCallException When this ContainerBuilder is frozen
*
* @api
*/
public function setDefinition($id, Definition $definition)
{
@ -841,8 +773,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @param string $id The service identifier
*
* @return bool true if the service definition exists, false otherwise
*
* @api
*/
public function hasDefinition($id)
{
@ -857,8 +787,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @return Definition A Definition instance
*
* @throws InvalidArgumentException if the service definition does not exist
*
* @api
*/
public function getDefinition($id)
{
@ -881,8 +809,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @return Definition A Definition instance
*
* @throws InvalidArgumentException if the service definition does not exist
*
* @api
*/
public function findDefinition($id)
{
@ -1012,7 +938,9 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
public function resolveServices($value)
{
if (is_array($value)) {
$value = array_map(array($this, 'resolveServices'), $value);
foreach ($value as $k => $v) {
$value[$k] = $this->resolveServices($v);
}
} elseif ($value instanceof Reference) {
$value = $this->get((string) $value, $value->getInvalidBehavior());
} elseif ($value instanceof Definition) {
@ -1041,8 +969,6 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
* @param string $name The tag name
*
* @return array An array of tags with the tagged service as key, holding a list of attribute arrays.
*
* @api
*/
public function findTaggedServiceIds($name)
{

View file

@ -20,8 +20,6 @@ use Symfony\Component\DependencyInjection\Exception\ServiceNotFoundException;
*
* @author Fabien Potencier <fabien@symfony.com>
* @author Johannes M. Schmitt <schmittjoh@gmail.com>
*
* @api
*/
interface ContainerInterface
{
@ -37,8 +35,6 @@ interface ContainerInterface
* @param string $id The service identifier
* @param object $service The service instance
* @param string $scope The scope of the service
*
* @api
*/
public function set($id, $service, $scope = self::SCOPE_CONTAINER);
@ -54,8 +50,6 @@ interface ContainerInterface
* @throws ServiceNotFoundException When the service is not defined
*
* @see Reference
*
* @api
*/
public function get($id, $invalidBehavior = self::EXCEPTION_ON_INVALID_REFERENCE);
@ -65,8 +59,6 @@ interface ContainerInterface
* @param string $id The service identifier
*
* @return bool true if the service is defined, false otherwise
*
* @api
*/
public function has($id);
@ -78,8 +70,6 @@ interface ContainerInterface
* @return mixed The parameter value
*
* @throws InvalidArgumentException if the parameter is not defined
*
* @api
*/
public function getParameter($name);
@ -89,8 +79,6 @@ interface ContainerInterface
* @param string $name The parameter name
*
* @return bool The presence of parameter in container
*
* @api
*/
public function hasParameter($name);
@ -99,8 +87,6 @@ interface ContainerInterface
*
* @param string $name The parameter name
* @param mixed $value The parameter value
*
* @api
*/
public function setParameter($name, $value);
@ -108,8 +94,6 @@ interface ContainerInterface
* Enters the given scope.
*
* @param string $name
*
* @api
*/
public function enterScope($name);
@ -117,8 +101,6 @@ interface ContainerInterface
* Leaves the current scope, and re-enters the parent scope.
*
* @param string $name
*
* @api
*/
public function leaveScope($name);
@ -126,8 +108,6 @@ interface ContainerInterface
* Adds a scope to the container.
*
* @param ScopeInterface $scope
*
* @api
*/
public function addScope(ScopeInterface $scope);
@ -137,8 +117,6 @@ interface ContainerInterface
* @param string $name
*
* @return bool
*
* @api
*/
public function hasScope($name);
@ -150,8 +128,6 @@ interface ContainerInterface
* @param string $name
*
* @return bool
*
* @api
*/
public function isScopeActive($name);
}

View file

@ -18,8 +18,6 @@ use Symfony\Component\DependencyInjection\Exception\OutOfBoundsException;
* Definition represents a service definition.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @api
*/
class Definition
{
@ -48,8 +46,6 @@ class Definition
*
* @param string|null $class The service class
* @param array $arguments An array of arguments to pass to the service constructor
*
* @api
*/
public function __construct($class = null, array $arguments = array())
{
@ -93,8 +89,6 @@ class Definition
*
* @return Definition The current instance
*
* @api
*
* @deprecated since version 2.6, to be removed in 3.0.
*/
public function setFactoryClass($factoryClass)
@ -111,8 +105,6 @@ class Definition
*
* @return string|null The factory class name
*
* @api
*
* @deprecated since version 2.6, to be removed in 3.0.
*/
public function getFactoryClass($triggerDeprecationError = true)
@ -131,8 +123,6 @@ class Definition
*
* @return Definition The current instance
*
* @api
*
* @deprecated since version 2.6, to be removed in 3.0.
*/
public function setFactoryMethod($factoryMethod)
@ -184,8 +174,6 @@ class Definition
*
* @return string|null The factory method name
*
* @api
*
* @deprecated since version 2.6, to be removed in 3.0.
*/
public function getFactoryMethod($triggerDeprecationError = true)
@ -204,8 +192,6 @@ class Definition
*
* @return Definition The current instance
*
* @api
*
* @deprecated since version 2.6, to be removed in 3.0.
*/
public function setFactoryService($factoryService)
@ -222,8 +208,6 @@ class Definition
*
* @return string|null The factory service id
*
* @api
*
* @deprecated since version 2.6, to be removed in 3.0.
*/
public function getFactoryService($triggerDeprecationError = true)
@ -241,8 +225,6 @@ class Definition
* @param string $class The service class
*
* @return Definition The current instance
*
* @api
*/
public function setClass($class)
{
@ -255,8 +237,6 @@ class Definition
* Gets the service class.
*
* @return string|null The service class
*
* @api
*/
public function getClass()
{
@ -269,8 +249,6 @@ class Definition
* @param array $arguments An array of arguments
*
* @return Definition The current instance
*
* @api
*/
public function setArguments(array $arguments)
{
@ -279,9 +257,6 @@ class Definition
return $this;
}
/**
* @api
*/
public function setProperties(array $properties)
{
$this->properties = $properties;
@ -289,17 +264,11 @@ class Definition
return $this;
}
/**
* @api
*/
public function getProperties()
{
return $this->properties;
}
/**
* @api
*/
public function setProperty($name, $value)
{
$this->properties[$name] = $value;
@ -313,8 +282,6 @@ class Definition
* @param mixed $argument An argument
*
* @return Definition The current instance
*
* @api
*/
public function addArgument($argument)
{
@ -332,8 +299,6 @@ class Definition
* @return Definition The current instance
*
* @throws OutOfBoundsException When the replaced argument does not exist
*
* @api
*/
public function replaceArgument($index, $argument)
{
@ -350,8 +315,6 @@ class Definition
* Gets the arguments to pass to the service constructor/factory method.
*
* @return array The array of arguments
*
* @api
*/
public function getArguments()
{
@ -366,8 +329,6 @@ class Definition
* @return mixed The argument value
*
* @throws OutOfBoundsException When the argument does not exist
*
* @api
*/
public function getArgument($index)
{
@ -384,8 +345,6 @@ class Definition
* @param array $calls An array of method calls
*
* @return Definition The current instance
*
* @api
*/
public function setMethodCalls(array $calls = array())
{
@ -406,8 +365,6 @@ class Definition
* @return Definition The current instance
*
* @throws InvalidArgumentException on empty $method param
*
* @api
*/
public function addMethodCall($method, array $arguments = array())
{
@ -425,8 +382,6 @@ class Definition
* @param string $method The method name to remove
*
* @return Definition The current instance
*
* @api
*/
public function removeMethodCall($method)
{
@ -446,8 +401,6 @@ class Definition
* @param string $method The method name to search for
*
* @return bool
*
* @api
*/
public function hasMethodCall($method)
{
@ -464,8 +417,6 @@ class Definition
* Gets the methods to call after service initialization.
*
* @return array An array of method calls
*
* @api
*/
public function getMethodCalls()
{
@ -478,8 +429,6 @@ class Definition
* @param array $tags
*
* @return Definition the current instance
*
* @api
*/
public function setTags(array $tags)
{
@ -492,8 +441,6 @@ class Definition
* Returns all tags.
*
* @return array An array of tags
*
* @api
*/
public function getTags()
{
@ -506,8 +453,6 @@ class Definition
* @param string $name The tag name
*
* @return array An array of attributes
*
* @api
*/
public function getTag($name)
{
@ -521,8 +466,6 @@ class Definition
* @param array $attributes An array of attributes
*
* @return Definition The current instance
*
* @api
*/
public function addTag($name, array $attributes = array())
{
@ -537,8 +480,6 @@ class Definition
* @param string $name
*
* @return bool
*
* @api
*/
public function hasTag($name)
{
@ -565,8 +506,6 @@ class Definition
* Clears the tags for this definition.
*
* @return Definition The current instance
*
* @api
*/
public function clearTags()
{
@ -581,8 +520,6 @@ class Definition
* @param string $file A full pathname to include
*
* @return Definition The current instance
*
* @api
*/
public function setFile($file)
{
@ -595,8 +532,6 @@ class Definition
* Gets the file to require before creating the service.
*
* @return string|null The full pathname to include
*
* @api
*/
public function getFile()
{
@ -609,8 +544,6 @@ class Definition
* @param string $scope Whether the service must be shared or not
*
* @return Definition The current instance
*
* @api
*/
public function setScope($scope)
{
@ -623,8 +556,6 @@ class Definition
* Returns the scope of the service.
*
* @return string
*
* @api
*/
public function getScope()
{
@ -637,8 +568,6 @@ class Definition
* @param bool $boolean
*
* @return Definition The current instance
*
* @api
*/
public function setPublic($boolean)
{
@ -651,8 +580,6 @@ class Definition
* Whether this service is public facing.
*
* @return bool
*
* @api
*/
public function isPublic()
{
@ -666,8 +593,6 @@ class Definition
*
* @return Definition The current instance
*
* @api
*
* @deprecated since version 2.7, will be removed in 3.0.
*/
public function setSynchronized($boolean, $triggerDeprecationError = true)
@ -686,8 +611,6 @@ class Definition
*
* @return bool
*
* @api
*
* @deprecated since version 2.7, will be removed in 3.0.
*/
public function isSynchronized($triggerDeprecationError = true)
@ -730,8 +653,6 @@ class Definition
* @param bool $boolean
*
* @return Definition the current instance
*
* @api
*/
public function setSynthetic($boolean)
{
@ -745,8 +666,6 @@ class Definition
* container, but dynamically injected.
*
* @return bool
*
* @api
*/
public function isSynthetic()
{
@ -760,8 +679,6 @@ class Definition
* @param bool $boolean
*
* @return Definition the current instance
*
* @api
*/
public function setAbstract($boolean)
{
@ -775,8 +692,6 @@ class Definition
* template for other definitions.
*
* @return bool
*
* @api
*/
public function isAbstract()
{
@ -789,8 +704,6 @@ class Definition
* @param callable $callable A PHP callable
*
* @return Definition The current instance
*
* @api
*/
public function setConfigurator($callable)
{
@ -803,8 +716,6 @@ class Definition
* Gets the configurator to call after the service is fully initialized.
*
* @return callable|null The PHP callable to call
*
* @api
*/
public function getConfigurator()
{

View file

@ -18,8 +18,6 @@ use Symfony\Component\DependencyInjection\Exception\OutOfBoundsException;
* This definition decorates another definition.
*
* @author Johannes M. Schmitt <schmittjoh@gmail.com>
*
* @api
*/
class DefinitionDecorator extends Definition
{
@ -30,8 +28,6 @@ class DefinitionDecorator extends Definition
* Constructor.
*
* @param string $parent The id of Definition instance to decorate.
*
* @api
*/
public function __construct($parent)
{
@ -44,8 +40,6 @@ class DefinitionDecorator extends Definition
* Returns the Definition being decorated.
*
* @return string
*
* @api
*/
public function getParent()
{
@ -56,8 +50,6 @@ class DefinitionDecorator extends Definition
* Returns all changes tracked for the Definition object.
*
* @return array An array of changes for this Definition
*
* @api
*/
public function getChanges()
{
@ -66,8 +58,6 @@ class DefinitionDecorator extends Definition
/**
* {@inheritdoc}
*
* @api
*/
public function setClass($class)
{
@ -89,7 +79,6 @@ class DefinitionDecorator extends Definition
/**
* {@inheritdoc}
*
* @api
*/
public function setFactoryClass($class)
{
@ -100,8 +89,6 @@ class DefinitionDecorator extends Definition
/**
* {@inheritdoc}
*
* @api
*/
public function setFactoryMethod($method)
{
@ -112,8 +99,6 @@ class DefinitionDecorator extends Definition
/**
* {@inheritdoc}
*
* @api
*/
public function setFactoryService($service)
{
@ -124,8 +109,6 @@ class DefinitionDecorator extends Definition
/**
* {@inheritdoc}
*
* @api
*/
public function setConfigurator($callable)
{
@ -136,8 +119,6 @@ class DefinitionDecorator extends Definition
/**
* {@inheritdoc}
*
* @api
*/
public function setFile($file)
{
@ -148,8 +129,6 @@ class DefinitionDecorator extends Definition
/**
* {@inheritdoc}
*
* @api
*/
public function setPublic($boolean)
{
@ -160,8 +139,6 @@ class DefinitionDecorator extends Definition
/**
* {@inheritdoc}
*
* @api
*/
public function setLazy($boolean)
{
@ -191,8 +168,6 @@ class DefinitionDecorator extends Definition
* @return mixed The argument value
*
* @throws OutOfBoundsException When the argument does not exist
*
* @api
*/
public function getArgument($index)
{
@ -223,8 +198,6 @@ class DefinitionDecorator extends Definition
* @return DefinitionDecorator the current instance
*
* @throws InvalidArgumentException when $index isn't an integer
*
* @api
*/
public function replaceArgument($index, $value)
{

View file

@ -17,8 +17,6 @@ use Symfony\Component\DependencyInjection\ContainerBuilder;
* Dumper is the abstract class for all built-in dumpers.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @api
*/
abstract class Dumper implements DumperInterface
{
@ -28,8 +26,6 @@ abstract class Dumper implements DumperInterface
* Constructor.
*
* @param ContainerBuilder $container The service container to dump
*
* @api
*/
public function __construct(ContainerBuilder $container)
{

View file

@ -15,8 +15,6 @@ namespace Symfony\Component\DependencyInjection\Dumper;
* DumperInterface is the interface implemented by service container dumper classes.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @api
*/
interface DumperInterface
{
@ -26,8 +24,6 @@ interface DumperInterface
* @param array $options An array of options
*
* @return string The representation of the service container
*
* @api
*/
public function dump(array $options = array());
}

View file

@ -32,8 +32,6 @@ use Symfony\Component\ExpressionLanguage\ExpressionFunctionProviderInterface;
*
* @author Fabien Potencier <fabien@symfony.com>
* @author Johannes M. Schmitt <schmittjoh@gmail.com>
*
* @api
*/
class PhpDumper extends Dumper
{
@ -72,8 +70,6 @@ class PhpDumper extends Dumper
/**
* {@inheritdoc}
*
* @api
*/
public function __construct(ContainerBuilder $container)
{
@ -104,8 +100,6 @@ class PhpDumper extends Dumper
* @param array $options An array of options
*
* @return string A PHP class representing of the service container
*
* @api
*/
public function dump(array $options = array())
{

View file

@ -24,8 +24,6 @@ use Symfony\Component\ExpressionLanguage\Expression;
*
* @author Fabien Potencier <fabien@symfony.com>
* @author Martin Hasoň <martin.hason@gmail.com>
*
* @api
*/
class XmlDumper extends Dumper
{
@ -40,8 +38,6 @@ class XmlDumper extends Dumper
* @param array $options An array of options
*
* @return string An xml string representing of the service container
*
* @api
*/
public function dump(array $options = array())
{

View file

@ -24,8 +24,6 @@ use Symfony\Component\ExpressionLanguage\Expression;
* YamlDumper dumps a service container as a YAML string.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @api
*/
class YamlDumper extends Dumper
{
@ -37,8 +35,6 @@ class YamlDumper extends Dumper
* @param array $options An array of options
*
* @return string A YAML string representing of the service container
*
* @api
*/
public function dump(array $options = array())
{
@ -166,10 +162,10 @@ class YamlDumper extends Dumper
private function addServiceAlias($alias, $id)
{
if ($id->isPublic()) {
return sprintf(" %s: @%s\n", $alias, $id);
} else {
return sprintf(" %s:\n alias: %s\n public: false", $alias, $id);
return sprintf(" %s: '@%s'\n", $alias, $id);
}
return sprintf(" %s:\n alias: %s\n public: false", $alias, $id);
}
/**

View file

@ -17,8 +17,6 @@ use Symfony\Component\DependencyInjection\ContainerBuilder;
* ExtensionInterface is the interface implemented by container extension classes.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @api
*/
interface ExtensionInterface
{
@ -29,8 +27,6 @@ interface ExtensionInterface
* @param ContainerBuilder $container A ContainerBuilder instance
*
* @throws \InvalidArgumentException When provided tag is not defined in this extension
*
* @api
*/
public function load(array $config, ContainerBuilder $container);
@ -38,8 +34,6 @@ interface ExtensionInterface
* Returns the namespace to be used for this extension (XML namespace).
*
* @return string The XML namespace
*
* @api
*/
public function getNamespace();
@ -47,8 +41,6 @@ interface ExtensionInterface
* Returns the base path for the XSD files.
*
* @return string The XSD base path
*
* @api
*/
public function getXsdValidationBasePath();
@ -58,8 +50,6 @@ interface ExtensionInterface
* This alias is also the mandatory prefix to use when using YAML.
*
* @return string The alias
*
* @api
*/
public function getAlias();
}

View file

@ -15,8 +15,6 @@ namespace Symfony\Component\DependencyInjection;
* Parameter represents a parameter reference.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @api
*/
class Parameter
{

View file

@ -17,8 +17,6 @@ use Symfony\Component\DependencyInjection\Exception\LogicException;
* Holds read-only parameters.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @api
*/
class FrozenParameterBag extends ParameterBag
{
@ -31,8 +29,6 @@ class FrozenParameterBag extends ParameterBag
* This is always the case when used internally.
*
* @param array $parameters An array of parameters
*
* @api
*/
public function __construct(array $parameters = array())
{
@ -42,8 +38,6 @@ class FrozenParameterBag extends ParameterBag
/**
* {@inheritdoc}
*
* @api
*/
public function clear()
{
@ -52,8 +46,6 @@ class FrozenParameterBag extends ParameterBag
/**
* {@inheritdoc}
*
* @api
*/
public function add(array $parameters)
{
@ -62,8 +54,6 @@ class FrozenParameterBag extends ParameterBag
/**
* {@inheritdoc}
*
* @api
*/
public function set($name, $value)
{
@ -72,8 +62,6 @@ class FrozenParameterBag extends ParameterBag
/**
* {@inheritdoc}
*
* @api
*/
public function remove($name)
{

View file

@ -19,8 +19,6 @@ use Symfony\Component\DependencyInjection\Exception\RuntimeException;
* Holds parameters.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @api
*/
class ParameterBag implements ParameterBagInterface
{
@ -31,8 +29,6 @@ class ParameterBag implements ParameterBagInterface
* Constructor.
*
* @param array $parameters An array of parameters
*
* @api
*/
public function __construct(array $parameters = array())
{
@ -41,8 +37,6 @@ class ParameterBag implements ParameterBagInterface
/**
* Clears all parameters.
*
* @api
*/
public function clear()
{
@ -53,8 +47,6 @@ class ParameterBag implements ParameterBagInterface
* Adds parameters to the service container parameters.
*
* @param array $parameters An array of parameters
*
* @api
*/
public function add(array $parameters)
{
@ -67,8 +59,6 @@ class ParameterBag implements ParameterBagInterface
* Gets the service container parameters.
*
* @return array An array of parameters
*
* @api
*/
public function all()
{
@ -83,8 +73,6 @@ class ParameterBag implements ParameterBagInterface
* @return mixed The parameter value
*
* @throws ParameterNotFoundException if the parameter is not defined
*
* @api
*/
public function get($name)
{
@ -114,8 +102,6 @@ class ParameterBag implements ParameterBagInterface
*
* @param string $name The parameter name
* @param mixed $value The parameter value
*
* @api
*/
public function set($name, $value)
{
@ -128,8 +114,6 @@ class ParameterBag implements ParameterBagInterface
* @param string $name The parameter name
*
* @return bool true if the parameter name is defined, false otherwise
*
* @api
*/
public function has($name)
{
@ -140,8 +124,6 @@ class ParameterBag implements ParameterBagInterface
* Removes a parameter.
*
* @param string $name The parameter name
*
* @api
*/
public function remove($name)
{

View file

@ -18,8 +18,6 @@ use Symfony\Component\DependencyInjection\Exception\ParameterNotFoundException;
* ParameterBagInterface.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @api
*/
interface ParameterBagInterface
{
@ -27,8 +25,6 @@ interface ParameterBagInterface
* Clears all parameters.
*
* @throws LogicException if the ParameterBagInterface can not be cleared
*
* @api
*/
public function clear();
@ -38,8 +34,6 @@ interface ParameterBagInterface
* @param array $parameters An array of parameters
*
* @throws LogicException if the parameter can not be added
*
* @api
*/
public function add(array $parameters);
@ -47,8 +41,6 @@ interface ParameterBagInterface
* Gets the service container parameters.
*
* @return array An array of parameters
*
* @api
*/
public function all();
@ -60,8 +52,6 @@ interface ParameterBagInterface
* @return mixed The parameter value
*
* @throws ParameterNotFoundException if the parameter is not defined
*
* @api
*/
public function get($name);
@ -72,8 +62,6 @@ interface ParameterBagInterface
* @param mixed $value The parameter value
*
* @throws LogicException if the parameter can not be set
*
* @api
*/
public function set($name, $value);
@ -83,8 +71,6 @@ interface ParameterBagInterface
* @param string $name The parameter name
*
* @return bool true if the parameter name is defined, false otherwise
*
* @api
*/
public function has($name);

View file

@ -15,8 +15,6 @@ namespace Symfony\Component\DependencyInjection;
* Reference represents a service reference.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @api
*/
class Reference
{

View file

@ -15,34 +15,23 @@ namespace Symfony\Component\DependencyInjection;
* Scope class.
*
* @author Johannes M. Schmitt <schmittjoh@gmail.com>
*
* @api
*/
class Scope implements ScopeInterface
{
private $name;
private $parentName;
/**
* @api
*/
public function __construct($name, $parentName = ContainerInterface::SCOPE_CONTAINER)
{
$this->name = $name;
$this->parentName = $parentName;
}
/**
* @api
*/
public function getName()
{
return $this->name;
}
/**
* @api
*/
public function getParentName()
{
return $this->parentName;

View file

@ -15,18 +15,10 @@ namespace Symfony\Component\DependencyInjection;
* Scope Interface.
*
* @author Johannes M. Schmitt <schmittjoh@gmail.com>
*
* @api
*/
interface ScopeInterface
{
/**
* @api
*/
public function getName();
/**
* @api
*/
public function getParentName();
}

View file

@ -15,8 +15,6 @@ namespace Symfony\Component\DependencyInjection;
* TaggedContainerInterface is the interface implemented when a container knows how to deals with tags.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @api
*/
interface TaggedContainerInterface extends ContainerInterface
{
@ -26,8 +24,6 @@ interface TaggedContainerInterface extends ContainerInterface
* @param string $name The tag name
*
* @return array An array of tags
*
* @api
*/
public function findTaggedServiceIds($name);
}

View file

@ -19,7 +19,6 @@
"php": ">=5.3.9"
},
"require-dev": {
"symfony/phpunit-bridge": "~2.7",
"symfony/yaml": "~2.1",
"symfony/config": "~2.2",
"symfony/expression-language": "~2.6"