1 | <?php |
||
2 | /** |
||
3 | * @link https://www.yiiframework.com/ |
||
4 | * @copyright Copyright (c) 2008 Yii Software LLC |
||
5 | * @license https://www.yiiframework.com/license/ |
||
6 | */ |
||
7 | |||
8 | namespace yii\base; |
||
9 | |||
10 | use Yii; |
||
11 | |||
12 | /** |
||
13 | * Application is the base class for all application classes. |
||
14 | * |
||
15 | * For more details and usage information on Application, see the [guide article on applications](guide:structure-applications). |
||
16 | * |
||
17 | * @property-read \yii\web\AssetManager $assetManager The asset manager application component. |
||
18 | * @property-read \yii\rbac\ManagerInterface|null $authManager The auth manager application component or null |
||
19 | * if it's not configured. |
||
20 | * @property string $basePath The root directory of the application. |
||
21 | * @property-read \yii\caching\CacheInterface|null $cache The cache application component. Null if the |
||
22 | * component is not enabled. |
||
23 | * @property-write array $container Values given in terms of name-value pairs. |
||
24 | * @property-read \yii\db\Connection $db The database connection. |
||
25 | * @property-read \yii\web\ErrorHandler|\yii\console\ErrorHandler $errorHandler The error handler application |
||
26 | * component. |
||
27 | * @property-read \yii\i18n\Formatter $formatter The formatter application component. |
||
28 | * @property-read \yii\i18n\I18N $i18n The internationalization application component. |
||
29 | * @property-read \yii\log\Dispatcher $log The log dispatcher application component. |
||
30 | * @property-read \yii\mail\MailerInterface $mailer The mailer application component. |
||
31 | * @property-read \yii\web\Request|\yii\console\Request $request The request component. |
||
32 | * @property-read \yii\web\Response|\yii\console\Response $response The response component. |
||
33 | * @property string $runtimePath The directory that stores runtime files. Defaults to the "runtime" |
||
34 | * subdirectory under [[basePath]]. |
||
35 | * @property-read \yii\base\Security $security The security application component. |
||
36 | * @property string $timeZone The time zone used by this application. |
||
37 | * @property-read string $uniqueId The unique ID of the module. |
||
38 | * @property-read \yii\web\UrlManager $urlManager The URL manager for this application. |
||
39 | * @property string $vendorPath The directory that stores vendor files. Defaults to "vendor" directory under |
||
40 | * [[basePath]]. |
||
41 | * @property-read View|\yii\web\View $view The view application component that is used to render various view |
||
42 | * files. |
||
43 | * |
||
44 | * @author Qiang Xue <[email protected]> |
||
45 | * @since 2.0 |
||
46 | */ |
||
47 | abstract class Application extends Module |
||
48 | { |
||
49 | /** |
||
50 | * @event Event an event raised before the application starts to handle a request. |
||
51 | */ |
||
52 | const EVENT_BEFORE_REQUEST = 'beforeRequest'; |
||
53 | /** |
||
54 | * @event Event an event raised after the application successfully handles a request (before the response is sent out). |
||
55 | */ |
||
56 | const EVENT_AFTER_REQUEST = 'afterRequest'; |
||
57 | /** |
||
58 | * Application state used by [[state]]: application just started. |
||
59 | */ |
||
60 | const STATE_BEGIN = 0; |
||
61 | /** |
||
62 | * Application state used by [[state]]: application is initializing. |
||
63 | */ |
||
64 | const STATE_INIT = 1; |
||
65 | /** |
||
66 | * Application state used by [[state]]: application is triggering [[EVENT_BEFORE_REQUEST]]. |
||
67 | */ |
||
68 | const STATE_BEFORE_REQUEST = 2; |
||
69 | /** |
||
70 | * Application state used by [[state]]: application is handling the request. |
||
71 | */ |
||
72 | const STATE_HANDLING_REQUEST = 3; |
||
73 | /** |
||
74 | * Application state used by [[state]]: application is triggering [[EVENT_AFTER_REQUEST]].. |
||
75 | */ |
||
76 | const STATE_AFTER_REQUEST = 4; |
||
77 | /** |
||
78 | * Application state used by [[state]]: application is about to send response. |
||
79 | */ |
||
80 | const STATE_SENDING_RESPONSE = 5; |
||
81 | /** |
||
82 | * Application state used by [[state]]: application has ended. |
||
83 | */ |
||
84 | const STATE_END = 6; |
||
85 | |||
86 | /** |
||
87 | * @var string the namespace that controller classes are located in. |
||
88 | * This namespace will be used to load controller classes by prepending it to the controller class name. |
||
89 | * The default namespace is `app\controllers`. |
||
90 | * |
||
91 | * Please refer to the [guide about class autoloading](guide:concept-autoloading.md) for more details. |
||
92 | */ |
||
93 | public $controllerNamespace = 'app\\controllers'; |
||
94 | /** |
||
95 | * @var string the application name. |
||
96 | */ |
||
97 | public $name = 'My Application'; |
||
98 | /** |
||
99 | * @var string the charset currently used for the application. |
||
100 | */ |
||
101 | public $charset = 'UTF-8'; |
||
102 | /** |
||
103 | * @var string the language that is meant to be used for end users. It is recommended that you |
||
104 | * use [IETF language tags](https://en.wikipedia.org/wiki/IETF_language_tag). For example, `en` stands |
||
105 | * for English, while `en-US` stands for English (United States). |
||
106 | * @see sourceLanguage |
||
107 | */ |
||
108 | public $language = 'en-US'; |
||
109 | /** |
||
110 | * @var string the language that the application is written in. This mainly refers to |
||
111 | * the language that the messages and view files are written in. |
||
112 | * @see language |
||
113 | */ |
||
114 | public $sourceLanguage = 'en-US'; |
||
115 | /** |
||
116 | * @var Controller the currently active controller instance |
||
117 | */ |
||
118 | public $controller; |
||
119 | /** |
||
120 | * @var string|bool the layout that should be applied for views in this application. Defaults to 'main'. |
||
121 | * If this is false, layout will be disabled. |
||
122 | */ |
||
123 | public $layout = 'main'; |
||
124 | /** |
||
125 | * @var string the requested route |
||
126 | */ |
||
127 | public $requestedRoute; |
||
128 | /** |
||
129 | * @var Action|null the requested Action. If null, it means the request cannot be resolved into an action. |
||
130 | */ |
||
131 | public $requestedAction; |
||
132 | /** |
||
133 | * @var array the parameters supplied to the requested action. |
||
134 | */ |
||
135 | public $requestedParams; |
||
136 | /** |
||
137 | * @var array|null list of installed Yii extensions. Each array element represents a single extension |
||
138 | * with the following structure: |
||
139 | * |
||
140 | * ```php |
||
141 | * [ |
||
142 | * 'name' => 'extension name', |
||
143 | * 'version' => 'version number', |
||
144 | * 'bootstrap' => 'BootstrapClassName', // optional, may also be a configuration array |
||
145 | * 'alias' => [ |
||
146 | * '@alias1' => 'to/path1', |
||
147 | * '@alias2' => 'to/path2', |
||
148 | * ], |
||
149 | * ] |
||
150 | * ``` |
||
151 | * |
||
152 | * The "bootstrap" class listed above will be instantiated during the application |
||
153 | * [[bootstrap()|bootstrapping process]]. If the class implements [[BootstrapInterface]], |
||
154 | * its [[BootstrapInterface::bootstrap()|bootstrap()]] method will be also be called. |
||
155 | * |
||
156 | * If not set explicitly in the application config, this property will be populated with the contents of |
||
157 | * `@vendor/yiisoft/extensions.php`. |
||
158 | */ |
||
159 | public $extensions; |
||
160 | /** |
||
161 | * @var array list of components that should be run during the application [[bootstrap()|bootstrapping process]]. |
||
162 | * |
||
163 | * Each component may be specified in one of the following formats: |
||
164 | * |
||
165 | * - an application component ID as specified via [[components]]. |
||
166 | * - a module ID as specified via [[modules]]. |
||
167 | * - a class name. |
||
168 | * - a configuration array. |
||
169 | * - a Closure |
||
170 | * |
||
171 | * During the bootstrapping process, each component will be instantiated. If the component class |
||
172 | * implements [[BootstrapInterface]], its [[BootstrapInterface::bootstrap()|bootstrap()]] method |
||
173 | * will be also be called. |
||
174 | */ |
||
175 | public $bootstrap = []; |
||
176 | /** |
||
177 | * @var int the current application state during a request handling life cycle. |
||
178 | * This property is managed by the application. Do not modify this property. |
||
179 | */ |
||
180 | public $state; |
||
181 | /** |
||
182 | * @var array list of loaded modules indexed by their class names. |
||
183 | */ |
||
184 | public $loadedModules = []; |
||
185 | |||
186 | |||
187 | /** |
||
188 | * Constructor. |
||
189 | * @param array $config name-value pairs that will be used to initialize the object properties. |
||
190 | * Note that the configuration must contain both [[id]] and [[basePath]]. |
||
191 | * @throws InvalidConfigException if either [[id]] or [[basePath]] configuration is missing. |
||
192 | */ |
||
193 | 4525 | public function __construct($config = []) |
|
194 | { |
||
195 | 4525 | Yii::$app = $this; |
|
196 | 4525 | static::setInstance($this); |
|
197 | |||
198 | 4525 | $this->state = self::STATE_BEGIN; |
|
199 | |||
200 | 4525 | $this->preInit($config); |
|
201 | |||
202 | 4525 | $this->registerErrorHandler($config); |
|
203 | |||
204 | 4525 | Component::__construct($config); |
|
205 | } |
||
206 | |||
207 | /** |
||
208 | * Pre-initializes the application. |
||
209 | * This method is called at the beginning of the application constructor. |
||
210 | * It initializes several important application properties. |
||
211 | * If you override this method, please make sure you call the parent implementation. |
||
212 | * @param array $config the application configuration |
||
213 | * @throws InvalidConfigException if either [[id]] or [[basePath]] configuration is missing. |
||
214 | */ |
||
215 | 4525 | public function preInit(&$config) |
|
216 | { |
||
217 | 4525 | if (!isset($config['id'])) { |
|
218 | throw new InvalidConfigException('The "id" configuration for the Application is required.'); |
||
219 | } |
||
220 | 4525 | if (isset($config['basePath'])) { |
|
221 | 4525 | $this->setBasePath($config['basePath']); |
|
222 | 4525 | unset($config['basePath']); |
|
223 | } else { |
||
224 | throw new InvalidConfigException('The "basePath" configuration for the Application is required.'); |
||
225 | } |
||
226 | |||
227 | 4525 | if (isset($config['vendorPath'])) { |
|
228 | 4518 | $this->setVendorPath($config['vendorPath']); |
|
229 | 4518 | unset($config['vendorPath']); |
|
230 | } else { |
||
231 | // set "@vendor" |
||
232 | 24 | $this->getVendorPath(); |
|
233 | } |
||
234 | 4525 | if (isset($config['runtimePath'])) { |
|
235 | $this->setRuntimePath($config['runtimePath']); |
||
236 | unset($config['runtimePath']); |
||
237 | } else { |
||
238 | // set "@runtime" |
||
239 | 4525 | $this->getRuntimePath(); |
|
240 | } |
||
241 | |||
242 | 4525 | if (isset($config['timeZone'])) { |
|
243 | 800 | $this->setTimeZone($config['timeZone']); |
|
244 | 800 | unset($config['timeZone']); |
|
245 | 3731 | } elseif (!ini_get('date.timezone')) { |
|
246 | $this->setTimeZone('UTC'); |
||
247 | } |
||
248 | |||
249 | 4525 | if (isset($config['container'])) { |
|
250 | 9 | $this->setContainer($config['container']); |
|
251 | |||
252 | 9 | unset($config['container']); |
|
253 | } |
||
254 | |||
255 | // merge core components with custom components |
||
256 | 4525 | foreach ($this->coreComponents() as $id => $component) { |
|
257 | 4525 | if (!isset($config['components'][$id])) { |
|
258 | 4525 | $config['components'][$id] = $component; |
|
259 | 675 | } elseif (is_array($config['components'][$id]) && !isset($config['components'][$id]['class'])) { |
|
260 | 465 | $config['components'][$id]['class'] = $component['class']; |
|
261 | } |
||
262 | } |
||
263 | } |
||
264 | |||
265 | /** |
||
266 | * {@inheritdoc} |
||
267 | */ |
||
268 | 4525 | public function init() |
|
269 | { |
||
270 | 4525 | $this->state = self::STATE_INIT; |
|
271 | 4525 | $this->bootstrap(); |
|
272 | } |
||
273 | |||
274 | /** |
||
275 | * Initializes extensions and executes bootstrap components. |
||
276 | * This method is called by [[init()]] after the application has been fully configured. |
||
277 | * If you override this method, make sure you also call the parent implementation. |
||
278 | */ |
||
279 | 4525 | protected function bootstrap() |
|
280 | { |
||
281 | 4525 | if ($this->extensions === null) { |
|
282 | 4525 | $file = Yii::getAlias('@vendor/yiisoft/extensions.php'); |
|
283 | 4525 | $this->extensions = is_file($file) ? include $file : []; |
|
284 | } |
||
285 | 4525 | foreach ($this->extensions as $extension) { |
|
286 | if (!empty($extension['alias'])) { |
||
287 | foreach ($extension['alias'] as $name => $path) { |
||
288 | Yii::setAlias($name, $path); |
||
289 | } |
||
290 | } |
||
291 | if (isset($extension['bootstrap'])) { |
||
292 | $component = Yii::createObject($extension['bootstrap']); |
||
293 | if ($component instanceof BootstrapInterface) { |
||
294 | Yii::debug('Bootstrap with ' . get_class($component) . '::bootstrap()', __METHOD__); |
||
295 | $component->bootstrap($this); |
||
296 | } else { |
||
297 | Yii::debug('Bootstrap with ' . get_class($component), __METHOD__); |
||
298 | } |
||
299 | } |
||
300 | } |
||
301 | |||
302 | 4525 | foreach ($this->bootstrap as $mixed) { |
|
303 | 2 | $component = null; |
|
304 | 2 | if ($mixed instanceof \Closure) { |
|
305 | 1 | Yii::debug('Bootstrap with Closure', __METHOD__); |
|
306 | 1 | if (!$component = call_user_func($mixed, $this)) { |
|
307 | 1 | continue; |
|
308 | } |
||
309 | 2 | } elseif (is_string($mixed)) { |
|
310 | 2 | if ($this->has($mixed)) { |
|
311 | 2 | $component = $this->get($mixed); |
|
312 | 1 | } elseif ($this->hasModule($mixed)) { |
|
313 | 1 | $component = $this->getModule($mixed); |
|
314 | } elseif (strpos($mixed, '\\') === false) { |
||
315 | throw new InvalidConfigException("Unknown bootstrapping component ID: $mixed"); |
||
316 | } |
||
317 | } |
||
318 | |||
319 | 2 | if (!isset($component)) { |
|
320 | $component = Yii::createObject($mixed); |
||
321 | } |
||
322 | |||
323 | 2 | if ($component instanceof BootstrapInterface) { |
|
324 | 1 | Yii::debug('Bootstrap with ' . get_class($component) . '::bootstrap()', __METHOD__); |
|
325 | 1 | $component->bootstrap($this); |
|
326 | } else { |
||
327 | 2 | Yii::debug('Bootstrap with ' . get_class($component), __METHOD__); |
|
328 | } |
||
329 | } |
||
330 | } |
||
331 | |||
332 | /** |
||
333 | * Registers the errorHandler component as a PHP error handler. |
||
334 | * @param array $config application config |
||
335 | */ |
||
336 | 4525 | protected function registerErrorHandler(&$config) |
|
337 | { |
||
338 | 4525 | if (YII_ENABLE_ERROR_HANDLER) { |
|
339 | if (!isset($config['components']['errorHandler']['class'])) { |
||
340 | echo "Error: no errorHandler component is configured.\n"; |
||
341 | exit(1); |
||
342 | } |
||
343 | $this->set('errorHandler', $config['components']['errorHandler']); |
||
344 | unset($config['components']['errorHandler']); |
||
345 | $this->getErrorHandler()->register(); |
||
346 | } |
||
347 | } |
||
348 | |||
349 | /** |
||
350 | * Returns an ID that uniquely identifies this module among all modules within the current application. |
||
351 | * Since this is an application instance, it will always return an empty string. |
||
352 | * @return string the unique ID of the module. |
||
353 | */ |
||
354 | 2 | public function getUniqueId() |
|
355 | { |
||
356 | 2 | return ''; |
|
357 | } |
||
358 | |||
359 | /** |
||
360 | * Sets the root directory of the application and the @app alias. |
||
361 | * This method can only be invoked at the beginning of the constructor. |
||
362 | * @param string $path the root directory of the application. |
||
363 | * @property string the root directory of the application. |
||
364 | * @throws InvalidArgumentException if the directory does not exist. |
||
365 | */ |
||
366 | 4525 | public function setBasePath($path) |
|
367 | { |
||
368 | 4525 | parent::setBasePath($path); |
|
369 | 4525 | Yii::setAlias('@app', $this->getBasePath()); |
|
370 | } |
||
371 | |||
372 | /** |
||
373 | * Runs the application. |
||
374 | * This is the main entrance of an application. |
||
375 | * @return int the exit status (0 means normal, non-zero values mean abnormal) |
||
376 | */ |
||
377 | public function run() |
||
378 | { |
||
379 | try { |
||
380 | $this->state = self::STATE_BEFORE_REQUEST; |
||
381 | $this->trigger(self::EVENT_BEFORE_REQUEST); |
||
382 | |||
383 | $this->state = self::STATE_HANDLING_REQUEST; |
||
384 | $response = $this->handleRequest($this->getRequest()); |
||
385 | |||
386 | $this->state = self::STATE_AFTER_REQUEST; |
||
387 | $this->trigger(self::EVENT_AFTER_REQUEST); |
||
388 | |||
389 | $this->state = self::STATE_SENDING_RESPONSE; |
||
390 | $response->send(); |
||
391 | |||
392 | $this->state = self::STATE_END; |
||
393 | |||
394 | return $response->exitStatus; |
||
395 | } catch (ExitException $e) { |
||
396 | $this->end($e->statusCode, isset($response) ? $response : null); |
||
397 | return $e->statusCode; |
||
398 | } |
||
399 | } |
||
400 | |||
401 | /** |
||
402 | * Handles the specified request. |
||
403 | * |
||
404 | * This method should return an instance of [[Response]] or its child class |
||
405 | * which represents the handling result of the request. |
||
406 | * |
||
407 | * @param Request $request the request to be handled |
||
408 | * @return Response the resulting response |
||
409 | */ |
||
410 | abstract public function handleRequest($request); |
||
411 | |||
412 | private $_runtimePath; |
||
413 | |||
414 | /** |
||
415 | * Returns the directory that stores runtime files. |
||
416 | * @return string the directory that stores runtime files. |
||
417 | * Defaults to the "runtime" subdirectory under [[basePath]]. |
||
418 | */ |
||
419 | 4525 | public function getRuntimePath() |
|
420 | { |
||
421 | 4525 | if ($this->_runtimePath === null) { |
|
422 | 4525 | $this->setRuntimePath($this->getBasePath() . DIRECTORY_SEPARATOR . 'runtime'); |
|
423 | } |
||
424 | |||
425 | 4525 | return $this->_runtimePath; |
|
426 | } |
||
427 | |||
428 | /** |
||
429 | * Sets the directory that stores runtime files. |
||
430 | * @param string $path the directory that stores runtime files. |
||
431 | */ |
||
432 | 4525 | public function setRuntimePath($path) |
|
433 | { |
||
434 | 4525 | $this->_runtimePath = Yii::getAlias($path); |
|
435 | 4525 | Yii::setAlias('@runtime', $this->_runtimePath); |
|
436 | } |
||
437 | |||
438 | private $_vendorPath; |
||
439 | |||
440 | /** |
||
441 | * Returns the directory that stores vendor files. |
||
442 | * @return string the directory that stores vendor files. |
||
443 | * Defaults to "vendor" directory under [[basePath]]. |
||
444 | */ |
||
445 | 24 | public function getVendorPath() |
|
446 | { |
||
447 | 24 | if ($this->_vendorPath === null) { |
|
448 | 24 | $this->setVendorPath($this->getBasePath() . DIRECTORY_SEPARATOR . 'vendor'); |
|
449 | } |
||
450 | |||
451 | 24 | return $this->_vendorPath; |
|
452 | } |
||
453 | |||
454 | /** |
||
455 | * Sets the directory that stores vendor files. |
||
456 | * @param string $path the directory that stores vendor files. |
||
457 | */ |
||
458 | 4525 | public function setVendorPath($path) |
|
459 | { |
||
460 | 4525 | $this->_vendorPath = Yii::getAlias($path); |
|
461 | 4525 | Yii::setAlias('@vendor', $this->_vendorPath); |
|
462 | 4525 | Yii::setAlias('@bower', $this->_vendorPath . DIRECTORY_SEPARATOR . 'bower'); |
|
0 ignored issues
–
show
Bug
introduced
by
Loading history...
|
|||
463 | 4525 | Yii::setAlias('@npm', $this->_vendorPath . DIRECTORY_SEPARATOR . 'npm'); |
|
464 | } |
||
465 | |||
466 | /** |
||
467 | * Returns the time zone used by this application. |
||
468 | * This is a simple wrapper of PHP function date_default_timezone_get(). |
||
469 | * If time zone is not configured in php.ini or application config, |
||
470 | * it will be set to UTC by default. |
||
471 | * @return string the time zone used by this application. |
||
472 | * @see https://www.php.net/manual/en/function.date-default-timezone-get.php |
||
473 | */ |
||
474 | 414 | public function getTimeZone() |
|
475 | { |
||
476 | 414 | return date_default_timezone_get(); |
|
477 | } |
||
478 | |||
479 | /** |
||
480 | * Sets the time zone used by this application. |
||
481 | * This is a simple wrapper of PHP function date_default_timezone_set(). |
||
482 | * Refer to the [php manual](https://www.php.net/manual/en/timezones.php) for available timezones. |
||
483 | * @param string $value the time zone used by this application. |
||
484 | * @see https://www.php.net/manual/en/function.date-default-timezone-set.php |
||
485 | */ |
||
486 | 800 | public function setTimeZone($value) |
|
487 | { |
||
488 | 800 | date_default_timezone_set($value); |
|
489 | } |
||
490 | |||
491 | /** |
||
492 | * Returns the database connection component. |
||
493 | * @return \yii\db\Connection the database connection. |
||
494 | */ |
||
495 | 112 | public function getDb() |
|
496 | { |
||
497 | 112 | return $this->get('db'); |
|
0 ignored issues
–
show
|
|||
498 | } |
||
499 | |||
500 | /** |
||
501 | * Returns the log dispatcher component. |
||
502 | * @return \yii\log\Dispatcher the log dispatcher application component. |
||
503 | */ |
||
504 | 6 | public function getLog() |
|
505 | { |
||
506 | 6 | return $this->get('log'); |
|
0 ignored issues
–
show
|
|||
507 | } |
||
508 | |||
509 | /** |
||
510 | * Returns the error handler component. |
||
511 | * @return \yii\web\ErrorHandler|\yii\console\ErrorHandler the error handler application component. |
||
512 | */ |
||
513 | public function getErrorHandler() |
||
514 | { |
||
515 | return $this->get('errorHandler'); |
||
516 | } |
||
517 | |||
518 | /** |
||
519 | * Returns the cache component. |
||
520 | * @return \yii\caching\CacheInterface|null the cache application component. Null if the component is not enabled. |
||
521 | */ |
||
522 | public function getCache() |
||
523 | { |
||
524 | return $this->get('cache', false); |
||
0 ignored issues
–
show
|
|||
525 | } |
||
526 | |||
527 | /** |
||
528 | * Returns the formatter component. |
||
529 | * @return \yii\i18n\Formatter the formatter application component. |
||
530 | */ |
||
531 | 26 | public function getFormatter() |
|
532 | { |
||
533 | 26 | return $this->get('formatter'); |
|
0 ignored issues
–
show
|
|||
534 | } |
||
535 | |||
536 | /** |
||
537 | * Returns the request component. |
||
538 | * @return \yii\web\Request|\yii\console\Request the request component. |
||
539 | */ |
||
540 | public function getRequest() |
||
541 | { |
||
542 | return $this->get('request'); |
||
0 ignored issues
–
show
|
|||
543 | } |
||
544 | |||
545 | /** |
||
546 | * Returns the response component. |
||
547 | * @return \yii\web\Response|\yii\console\Response the response component. |
||
548 | */ |
||
549 | public function getResponse() |
||
550 | { |
||
551 | return $this->get('response'); |
||
0 ignored issues
–
show
|
|||
552 | } |
||
553 | |||
554 | /** |
||
555 | * Returns the view object. |
||
556 | * @return View|\yii\web\View the view application component that is used to render various view files. |
||
557 | */ |
||
558 | 124 | public function getView() |
|
559 | { |
||
560 | 124 | return $this->get('view'); |
|
0 ignored issues
–
show
|
|||
561 | } |
||
562 | |||
563 | /** |
||
564 | * Returns the URL manager for this application. |
||
565 | * @return \yii\web\UrlManager the URL manager for this application. |
||
566 | */ |
||
567 | 60 | public function getUrlManager() |
|
568 | { |
||
569 | 60 | return $this->get('urlManager'); |
|
0 ignored issues
–
show
|
|||
570 | } |
||
571 | |||
572 | /** |
||
573 | * Returns the internationalization (i18n) component. |
||
574 | * @return \yii\i18n\I18N the internationalization application component. |
||
575 | */ |
||
576 | 771 | public function getI18n() |
|
577 | { |
||
578 | 771 | return $this->get('i18n'); |
|
0 ignored issues
–
show
|
|||
579 | } |
||
580 | |||
581 | /** |
||
582 | * Returns the mailer component. |
||
583 | * @return \yii\mail\MailerInterface the mailer application component. |
||
584 | * @throws InvalidConfigException If this component is not configured. |
||
585 | */ |
||
586 | public function getMailer() |
||
587 | { |
||
588 | return $this->get('mailer'); |
||
589 | } |
||
590 | |||
591 | /** |
||
592 | * Returns the auth manager for this application. |
||
593 | * @return \yii\rbac\ManagerInterface|null the auth manager application component or null if it's not configured. |
||
594 | */ |
||
595 | 2 | public function getAuthManager() |
|
596 | { |
||
597 | 2 | return $this->get('authManager', false); |
|
0 ignored issues
–
show
|
|||
598 | } |
||
599 | |||
600 | /** |
||
601 | * Returns the asset manager. |
||
602 | * @return \yii\web\AssetManager the asset manager application component. |
||
603 | */ |
||
604 | 13 | public function getAssetManager() |
|
605 | { |
||
606 | 13 | return $this->get('assetManager'); |
|
0 ignored issues
–
show
|
|||
607 | } |
||
608 | |||
609 | /** |
||
610 | * Returns the security component. |
||
611 | * @return \yii\base\Security the security application component. |
||
612 | */ |
||
613 | 94 | public function getSecurity() |
|
614 | { |
||
615 | 94 | return $this->get('security'); |
|
616 | } |
||
617 | |||
618 | /** |
||
619 | * Returns the configuration of core application components. |
||
620 | * @return array |
||
621 | * @see set() |
||
622 | */ |
||
623 | 4525 | public function coreComponents() |
|
624 | { |
||
625 | 4525 | $components = [ |
|
626 | 4525 | 'log' => ['class' => 'yii\log\Dispatcher'], |
|
627 | 4525 | 'view' => ['class' => 'yii\web\View'], |
|
628 | 4525 | 'formatter' => ['class' => 'yii\i18n\Formatter'], |
|
629 | 4525 | 'i18n' => ['class' => 'yii\i18n\I18N'], |
|
630 | 4525 | 'urlManager' => ['class' => 'yii\web\UrlManager'], |
|
631 | 4525 | 'assetManager' => ['class' => 'yii\web\AssetManager'], |
|
632 | 4525 | 'security' => ['class' => 'yii\base\Security'], |
|
633 | 4525 | ]; |
|
634 | 4525 | if (class_exists('yii\swiftmailer\Mailer')) { |
|
635 | $components['mailer'] = ['class' => 'yii\swiftmailer\Mailer']; |
||
636 | } |
||
637 | |||
638 | 4525 | return $components; |
|
639 | } |
||
640 | |||
641 | /** |
||
642 | * Terminates the application. |
||
643 | * This method replaces the `exit()` function by ensuring the application life cycle is completed |
||
644 | * before terminating the application. |
||
645 | * @param int $status the exit status (value 0 means normal exit while other values mean abnormal exit). |
||
646 | * @param Response|null $response the response to be sent. If not set, the default application [[response]] component will be used. |
||
647 | * @throws ExitException if the application is in testing mode |
||
648 | */ |
||
649 | 3 | public function end($status = 0, $response = null) |
|
650 | { |
||
651 | 3 | if ($this->state === self::STATE_BEFORE_REQUEST || $this->state === self::STATE_HANDLING_REQUEST) { |
|
652 | $this->state = self::STATE_AFTER_REQUEST; |
||
653 | $this->trigger(self::EVENT_AFTER_REQUEST); |
||
654 | } |
||
655 | |||
656 | 3 | if ($this->state !== self::STATE_SENDING_RESPONSE && $this->state !== self::STATE_END) { |
|
657 | 3 | $this->state = self::STATE_END; |
|
658 | 3 | $response = $response ?: $this->getResponse(); |
|
659 | 3 | $response->send(); |
|
660 | } |
||
661 | |||
662 | 3 | if (YII_ENV_TEST) { |
|
663 | 3 | throw new ExitException($status); |
|
664 | } |
||
665 | |||
666 | exit($status); |
||
667 | } |
||
668 | |||
669 | /** |
||
670 | * Configures [[Yii::$container]] with the $config. |
||
671 | * |
||
672 | * @param array $config values given in terms of name-value pairs |
||
673 | * @since 2.0.11 |
||
674 | */ |
||
675 | 9 | public function setContainer($config) |
|
676 | { |
||
677 | 9 | Yii::configure(Yii::$container, $config); |
|
678 | } |
||
679 | } |
||
680 |