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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
<?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\HttpKernel;
use Symfony\Component\Config\Loader\LoaderInterface;
use Symfony\Component\DependencyInjection\ContainerInterface;
use Symfony\Component\HttpKernel\Bundle\BundleInterface;
/**
* The Kernel is the heart of the Symfony system.
*
* It manages an environment made of application kernel and bundles.
*
* @author Fabien Potencier <fabien@symfony.com>
*
* @method string getProjectDir() Gets the project dir (path of the project's composer file) - not defining it is deprecated since Symfony 4.2
*/
interface KernelInterface extends HttpKernelInterface
{
/**
* Returns an array of bundles to register.
*
* @return iterable|BundleInterface[] An iterable of bundle instances
*/
public function registerBundles();
/**
* Loads the container configuration.
*/
public function registerContainerConfiguration(LoaderInterface $loader);
/**
* Boots the current kernel.
*/
public function boot();
/**
* Shutdowns the kernel.
*
* This method is mainly useful when doing functional testing.
*/
public function shutdown();
/**
* Gets the registered bundle instances.
*
* @return BundleInterface[] An array of registered bundle instances
*/
public function getBundles();
/**
* Returns a bundle.
*
* @param string $name Bundle name
*
* @return BundleInterface A BundleInterface instance
*
* @throws \InvalidArgumentException when the bundle is not enabled
*/
public function getBundle($name);
/**
* Returns the file path for a given bundle resource.
*
* A Resource can be a file or a directory.
*
* The resource name must follow the following pattern:
*
* "@BundleName/path/to/a/file.something"
*
* where BundleName is the name of the bundle
* and the remaining part is the relative path in the bundle.
*
* @param string $name A resource name to locate
*
* @return string|array The absolute path of the resource or an array if $first is false (array return value is deprecated)
*
* @throws \InvalidArgumentException if the file cannot be found or the name is not valid
* @throws \RuntimeException if the name contains invalid/unsafe characters
*/
public function locateResource($name/* , $dir = null, $first = true */);
/**
* Gets the name of the kernel.
*
* @return string The kernel name
*
* @deprecated since Symfony 4.2
*/
public function getName();
/**
* Gets the environment.
*
* @return string The current environment
*/
public function getEnvironment();
/**
* Checks if debug mode is enabled.
*
* @return bool true if debug mode is enabled, false otherwise
*/
public function isDebug();
/**
* Gets the application root dir (path of the project's Kernel class).
*
* @return string The Kernel root dir
*
* @deprecated since Symfony 4.2
*/
public function getRootDir();
/**
* Gets the current container.
*
* @return ContainerInterface
*/
public function getContainer();
/**
* Gets the request start time (not available if debug is disabled).
*
* @return float The request start timestamp
*/
public function getStartTime();
/**
* Gets the cache directory.
*
* @return string The cache directory
*/
public function getCacheDir();
/**
* Gets the log directory.
*
* @return string The log directory
*/
public function getLogDir();
/**
* Gets the charset of the application.
*
* @return string The charset
*/
public function getCharset();
}
|
