1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
---
layout: documentation
current_menu: container-configuration
---
# Configuring the container
## Getting started
PHP-DI's container is preconfigured for "plug and play". You can start using it simply like so:
```php
$container = new Container();
```
By default, [Autowiring](definition.md) will be enabled. [Attributes](attributes.md) are disabled by default.
To register [definitions using an array](php-definitions.md):
```php
$container = new DI\Container([
// place your definitions here
]);
```
To change options on the container you can use the `ContainerBuilder` class:
```php
$builder = new \DI\ContainerBuilder();
$container = $builder->build();
```
## Production environment
In production environment, you will of course favor speed:
```php
$builder = new \DI\ContainerBuilder();
$builder->enableCompilation(__DIR__ . '/tmp');
$builder->writeProxiesToFile(true, __DIR__ . '/tmp/proxies');
$container = $builder->build();
```
Read [the performances documentation](performances.md) to learn more.
## Lightweight container
If you want to use PHP-DI's container as a simple container (no autowiring or annotation support), you will want to disable all extra features.
```php
$builder = new \DI\ContainerBuilder();
$builder->useAutowiring(false);
$builder->useAttributes(false);
$container = $builder->build();
```
Note that this doesn't necessarily means that the container will be faster, since everything can be cached anyway.
Read more about this in [the performances documentation](performances.md).
## Using PHP-DI with other containers
If you want to use several containers at once, for example to use PHP-DI in ZF2 or Symfony 2, you can
use a tool like [Acclimate](https://github.com/jeremeamia/acclimate).
You will just need to tell PHP-DI to look into the composite container, else PHP-DI will be unaware
of Symfony's container entries.
Example with Acclimate:
```php
$container = new Acclimate\Container\CompositeContainer();
// Add Symfony's container
$container->addContainer($acclimate->adaptContainer($symfonyContainer));
// Configure PHP-DI container
$builder = new \DI\ContainerBuilder();
$builder->wrapContainer($container);
// Add PHP-DI container
$phpdiContainer = $builder->build();
$container->addContainer($phpdiContainer);
// Good to go!
$foo = $container->get('foo');
```
|
