• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

nette / bootstrap / 20711206346

05 Jan 2026 09:37AM UTC coverage: 90.278% (+6.9%) from 83.333%
20711206346

push

github

dg
added CLAUDE.md

130 of 144 relevant lines covered (90.28%)

0.9 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

89.68
/src/Bootstrap/Configurator.php
1
<?php
2

3
/**
4
 * This file is part of the Nette Framework (https://nette.org)
5
 * Copyright (c) 2004 David Grudl (https://davidgrudl.com)
6
 */
7

8
declare(strict_types=1);
9

10
namespace Nette\Bootstrap;
11

12
use Composer\Autoload\ClassLoader;
13
use Composer\InstalledVersions;
14
use Latte;
15
use Nette;
16
use Nette\DI;
17
use Nette\DI\Definitions\Statement;
18
use Tracy;
19
use function in_array, is_array, is_string;
20
use const PHP_RELEASE_VERSION, PHP_SAPI, PHP_VERSION_ID;
21

22

23
/**
24
 * Initial system DI container generator.
25
 */
26
class Configurator
27
{
28
        public const CookieSecret = 'nette-debug';
29

30
        /** @deprecated  use Configurator::CookieSecret */
31
        public const COOKIE_SECRET = self::CookieSecret;
32

33

34
        /** @var array<callable(self, DI\Compiler): void>  Occurs after the compiler is created */
35
        public array $onCompile = [];
36

37
        public array $defaultExtensions = [
38
                'application' => [Nette\Bridges\ApplicationDI\ApplicationExtension::class, ['%debugMode%', ['%appDir%'], '%tempDir%/cache/nette.application']],
39
                'assets' => [Nette\Bridges\AssetsDI\DIExtension::class, ['%baseUrl%', '%wwwDir%', '%debugMode%']],
40
                'cache' => [Nette\Bridges\CacheDI\CacheExtension::class, ['%tempDir%/cache']],
41
                'constants' => Extensions\ConstantsExtension::class,
42
                'database' => [Nette\Bridges\DatabaseDI\DatabaseExtension::class, ['%debugMode%']],
43
                'decorator' => Nette\DI\Extensions\DecoratorExtension::class,
44
                'di' => [Nette\DI\Extensions\DIExtension::class, ['%debugMode%']],
45
                'extensions' => Nette\DI\Extensions\ExtensionsExtension::class,
46
                'forms' => Nette\Bridges\FormsDI\FormsExtension::class,
47
                'http' => [Nette\Bridges\HttpDI\HttpExtension::class, ['%consoleMode%']],
48
                'inject' => Nette\DI\Extensions\InjectExtension::class,
49
                'latte' => [Nette\Bridges\ApplicationDI\LatteExtension::class, ['%tempDir%/cache/latte', '%debugMode%']],
50
                'mail' => Nette\Bridges\MailDI\MailExtension::class,
51
                'php' => Extensions\PhpIniExtension::class,
52
                'routing' => [Nette\Bridges\ApplicationDI\RoutingExtension::class, ['%debugMode%']],
53
                'search' => [Nette\DI\Extensions\SearchExtension::class, ['%tempDir%/cache/nette.search']],
54
                'security' => [Nette\Bridges\SecurityDI\SecurityExtension::class, ['%debugMode%']],
55
                'session' => [Nette\Bridges\HttpDI\SessionExtension::class, ['%debugMode%', '%consoleMode%']],
56
                'tracy' => [Tracy\Bridges\Nette\TracyExtension::class, ['%debugMode%', '%consoleMode%']],
57
        ];
58

59
        /** @var string[] of classes which shouldn't be autowired */
60
        public array $autowireExcludedClasses = [
61
                \ArrayAccess::class,
62
                \Countable::class,
63
                \IteratorAggregate::class,
64
                \stdClass::class,
65
                \Traversable::class,
66
        ];
67

68
        protected array $staticParameters;
69
        protected array $dynamicParameters = [];
70
        protected array $services = [];
71

72
        /** @var array<string|array> */
73
        protected array $configs = [];
74

75

76
        public function __construct()
77
        {
78
                $this->staticParameters = $this->getDefaultParameters();
1✔
79

80
                if (class_exists(InstalledVersions::class) // back compatibility
1✔
81
                        && InstalledVersions::isInstalled('nette/caching')
1✔
82
                        && version_compare(InstalledVersions::getVersion('nette/caching'), '3.3.0', '<')
1✔
83
                ) {
84
                        $this->defaultExtensions['cache'][1][0] = '%tempDir%';
×
85
                }
86
        }
1✔
87

88

89
        /**
90
         * Set parameter %debugMode%.
91
         */
92
        public function setDebugMode(bool|string|array $value): static
1✔
93
        {
94
                if (is_string($value) || is_array($value)) {
1✔
95
                        $value = static::detectDebugMode($value);
1✔
96
                }
97

98
                $this->staticParameters['debugMode'] = $value;
1✔
99
                $this->staticParameters['productionMode'] = !$this->staticParameters['debugMode']; // compatibility
1✔
100
                return $this;
1✔
101
        }
102

103

104
        public function isDebugMode(): bool
105
        {
106
                return $this->staticParameters['debugMode'];
1✔
107
        }
108

109

110
        /**
111
         * Sets path to temporary directory.
112
         */
113
        public function setTempDirectory(string $path): static
1✔
114
        {
115
                $this->staticParameters['tempDir'] = $path;
1✔
116
                return $this;
1✔
117
        }
118

119

120
        /**
121
         * Sets the default timezone.
122
         */
123
        public function setTimeZone(string $timezone): static
1✔
124
        {
125
                date_default_timezone_set($timezone);
1✔
126
                @ini_set('date.timezone', $timezone); // @ - function may be disabled
1✔
127
                return $this;
1✔
128
        }
129

130

131
        /** @deprecated use addStaticParameters() */
132
        public function addParameters(array $params): static
1✔
133
        {
134
                return $this->addStaticParameters($params);
1✔
135
        }
136

137

138
        /**
139
         * Adds new static parameters.
140
         */
141
        public function addStaticParameters(array $params): static
1✔
142
        {
143
                $this->staticParameters = DI\Config\Helpers::merge($params, $this->staticParameters);
1✔
144
                return $this;
1✔
145
        }
146

147

148
        /**
149
         * Adds new dynamic parameters.
150
         */
151
        public function addDynamicParameters(array $params): static
1✔
152
        {
153
                $this->dynamicParameters = $params + $this->dynamicParameters;
1✔
154
                return $this;
1✔
155
        }
156

157

158
        /**
159
         * Add instances of services.
160
         */
161
        public function addServices(array $services): static
1✔
162
        {
163
                $this->services = $services + $this->services;
1✔
164
                return $this;
1✔
165
        }
166

167

168
        protected function getDefaultParameters(): array
169
        {
170
                $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
1✔
171
                $last = end($trace);
1✔
172
                $debugMode = static::detectDebugMode();
1✔
173
                $loaderRc = class_exists(ClassLoader::class)
1✔
174
                        ? new \ReflectionClass(ClassLoader::class)
1✔
175
                        : null;
×
176
                $rootDir = class_exists(InstalledVersions::class) && ($tmp = InstalledVersions::getRootPackage()['install_path'] ?? null)
1✔
177
                        ? rtrim(Nette\Utils\FileSystem::normalizePath($tmp), '\/')
1✔
178
                        : null;
×
179
                $baseUrl = new Statement('trim($this->getByType(?)->getUrl()->getBaseUrl(), "/")', [Nette\Http\IRequest::class]);
1✔
180
                return [
181
                        'appDir' => isset($trace[1]['file']) ? dirname($trace[1]['file']) : null,
1✔
182
                        'wwwDir' => isset($last['file']) ? dirname($last['file']) : null,
1✔
183
                        'vendorDir' => $loaderRc ? dirname($loaderRc->getFileName(), 2) : null,
1✔
184
                        'rootDir' => $rootDir,
1✔
185
                        'debugMode' => $debugMode,
1✔
186
                        'productionMode' => !$debugMode,
1✔
187
                        'consoleMode' => PHP_SAPI === 'cli',
188
                        'baseUrl' => $baseUrl,
1✔
189
                ];
190
        }
191

192

193
        public function enableTracy(?string $logDirectory = null, ?string $email = null): void
194
        {
195
                if (!class_exists(Tracy\Debugger::class)) {
×
196
                        throw new Nette\NotSupportedException('Tracy not found, do you have `tracy/tracy` package installed?');
×
197
                }
198

199
                Tracy\Debugger::$strictMode = true;
×
200
                Tracy\Debugger::enable(!$this->staticParameters['debugMode'], $logDirectory, $email);
×
201
                Tracy\Bridges\Nette\Bridge::initialize();
×
202
                if (class_exists(Latte\Bridges\Tracy\BlueScreenPanel::class)) {
×
203
                        Latte\Bridges\Tracy\BlueScreenPanel::initialize();
×
204
                }
205
        }
206

207

208
        /** @deprecated use enableTracy() */
209
        public function enableDebugger(?string $logDirectory = null, ?string $email = null): void
210
        {
211
                $this->enableTracy($logDirectory, $email);
×
212
        }
213

214

215
        /**
216
         * @throws Nette\NotSupportedException if RobotLoader is not available
217
         */
218
        public function createRobotLoader(): Nette\Loaders\RobotLoader
219
        {
220
                if (!class_exists(Nette\Loaders\RobotLoader::class)) {
1✔
221
                        throw new Nette\NotSupportedException('RobotLoader not found, do you have `nette/robot-loader` package installed?');
×
222
                }
223

224
                $loader = new Nette\Loaders\RobotLoader;
1✔
225
                $loader->setTempDirectory($this->getCacheDirectory() . '/nette.robotLoader');
1✔
226
                $loader->setAutoRefresh($this->staticParameters['debugMode']);
1✔
227

228
                if (isset($this->defaultExtensions['application'])) {
1✔
229
                        $this->defaultExtensions['application'][1][1] = null;
1✔
230
                        $this->defaultExtensions['application'][1][3] = $loader;
1✔
231
                }
232

233
                return $loader;
1✔
234
        }
235

236

237
        /**
238
         * Adds configuration file.
239
         */
240
        public function addConfig(string|array $config): static
1✔
241
        {
242
                $this->configs[] = $config;
1✔
243
                return $this;
1✔
244
        }
245

246

247
        /**
248
         * Returns system DI container.
249
         */
250
        public function createContainer(bool $initialize = true): DI\Container
1✔
251
        {
252
                $class = $this->loadContainer();
1✔
253
                $container = new $class($this->dynamicParameters);
1✔
254
                foreach ($this->services as $name => $service) {
1✔
255
                        $container->addService($name, $service);
1✔
256
                }
257

258
                if ($initialize) {
1✔
259
                        $container->initialize();
1✔
260
                }
261

262
                return $container;
1✔
263
        }
264

265

266
        /**
267
         * Loads system DI container class and returns its name.
268
         */
269
        public function loadContainer(): string
270
        {
271
                $loader = new DI\ContainerLoader(
1✔
272
                        $this->getCacheDirectory() . '/nette.configurator',
1✔
273
                        $this->staticParameters['debugMode'],
1✔
274
                );
275
                return $loader->load(
1✔
276
                        $this->generateContainer(...),
1✔
277
                        $this->generateContainerKey(),
1✔
278
                );
279
        }
280

281

282
        /**
283
         * @internal
284
         */
285
        public function generateContainer(DI\Compiler $compiler): void
1✔
286
        {
287
                $loader = $this->createLoader();
1✔
288
                $loader->setParameters($this->staticParameters);
1✔
289

290
                foreach ($this->configs as $config) {
1✔
291
                        if (is_string($config)) {
1✔
292
                                $compiler->loadConfig($config, $loader);
1✔
293
                        } else {
294
                                $compiler->addConfig($config);
×
295
                        }
296
                }
297

298
                $compiler->addConfig(['parameters' => DI\Helpers::escape($this->staticParameters)]);
1✔
299
                $compiler->setDynamicParameterNames(array_merge(array_keys($this->dynamicParameters), ['baseUrl']));
1✔
300

301
                $builder = $compiler->getContainerBuilder();
1✔
302
                $builder->addExcludedClasses($this->autowireExcludedClasses);
1✔
303

304
                foreach ($this->defaultExtensions as $name => $extension) {
1✔
305
                        [$class, $args] = is_string($extension)
1✔
306
                                ? [$extension, []]
1✔
307
                                : $extension;
1✔
308
                        if (class_exists($class)) {
1✔
309
                                $args = DI\Helpers::expand($args, $this->staticParameters);
1✔
310
                                $compiler->addExtension($name, (new \ReflectionClass($class))->newInstanceArgs($args));
1✔
311
                        }
312
                }
313

314
                Nette\Utils\Arrays::invoke($this->onCompile, $this, $compiler);
1✔
315
        }
1✔
316

317

318
        protected function createLoader(): DI\Config\Loader
319
        {
320
                return new DI\Config\Loader;
1✔
321
        }
322

323

324
        protected function generateContainerKey(): array
325
        {
326
                return [
327
                        $this->staticParameters,
1✔
328
                        array_keys($this->dynamicParameters),
1✔
329
                        $this->configs,
1✔
330
                        PHP_VERSION_ID - PHP_RELEASE_VERSION, // minor PHP version
331
                        class_exists(ClassLoader::class) // composer update
1✔
332
                                ? filemtime((new \ReflectionClass(ClassLoader::class))->getFilename())
1✔
333
                                : null,
334
                ];
335
        }
336

337

338
        protected function getCacheDirectory(): string
339
        {
340
                if (empty($this->staticParameters['tempDir'])) {
1✔
341
                        throw new Nette\InvalidStateException('Set path to temporary directory using setTempDirectory().');
1✔
342
                }
343

344
                $dir = $this->staticParameters['tempDir'] . '/cache';
1✔
345
                Nette\Utils\FileSystem::createDir($dir);
1✔
346
                return $dir;
1✔
347
        }
348

349

350
        /**
351
         * Detects debug mode by IP addresses or computer names whitelist detection.
352
         */
353
        public static function detectDebugMode(string|array|null $list = null): bool
1✔
354
        {
355
                $addr = $_SERVER['REMOTE_ADDR'] ?? php_uname('n');
1✔
356
                $secret = is_string($_COOKIE[self::CookieSecret] ?? null)
1✔
357
                        ? $_COOKIE[self::CookieSecret]
1✔
358
                        : null;
1✔
359
                $list = is_string($list)
1✔
360
                        ? preg_split('#[,\s]+#', $list)
1✔
361
                        : (array) $list;
1✔
362
                if (!isset($_SERVER['HTTP_X_FORWARDED_FOR']) && !isset($_SERVER['HTTP_FORWARDED'])) {
1✔
363
                        $list[] = '127.0.0.1';
1✔
364
                        $list[] = '::1';
1✔
365
                }
366

367
                return in_array($addr, $list, strict: true) || in_array("$secret@$addr", $list, strict: true);
1✔
368
        }
369
}
370

371

372
class_exists(Nette\Configurator::class);
1✔
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc