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

orchestral / testbench-core / 16923704582

12 Aug 2025 11:54PM UTC coverage: 92.387%. Remained the same
16923704582

push

github

crynobone
wip

Signed-off-by: Mior Muhammad Zaki <crynobone@gmail.com>

1 of 1 new or added line in 1 file covered. (100.0%)

7 existing lines in 1 file now uncovered.

1517 of 1642 relevant lines covered (92.39%)

75.17 hits per line

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

91.46
/src/Foundation/Application.php
1
<?php
2

3
namespace Orchestra\Testbench\Foundation;
4

5
use Illuminate\Console\Application as Artisan;
6
use Illuminate\Console\Scheduling\ScheduleListCommand;
7
use Illuminate\Console\Signals;
8
use Illuminate\Database\Eloquent\Factories\Factory;
9
use Illuminate\Database\Eloquent\Model;
10
use Illuminate\Database\Migrations\Migrator;
11
use Illuminate\Database\Schema\Builder as SchemaBuilder;
12
use Illuminate\Foundation\Bootstrap\HandleExceptions;
13
use Illuminate\Foundation\Bootstrap\LoadEnvironmentVariables;
14
use Illuminate\Foundation\Bootstrap\RegisterProviders;
15
use Illuminate\Foundation\Console\AboutCommand;
16
use Illuminate\Foundation\Console\ChannelListCommand;
17
use Illuminate\Foundation\Console\RouteListCommand;
18
use Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull;
19
use Illuminate\Foundation\Http\Middleware\PreventRequestsDuringMaintenance;
20
use Illuminate\Foundation\Http\Middleware\TrimStrings;
21
use Illuminate\Foundation\Http\Middleware\ValidateCsrfToken;
22
use Illuminate\Http\Middleware\TrustHosts;
23
use Illuminate\Http\Middleware\TrustProxies;
24
use Illuminate\Http\Resources\Json\JsonResource;
25
use Illuminate\Mail\Markdown;
26
use Illuminate\Queue\Console\WorkCommand;
27
use Illuminate\Queue\Queue;
28
use Illuminate\Routing\Middleware\ThrottleRequests;
29
use Illuminate\Support\Arr;
30
use Illuminate\Support\EncodedHtmlString;
31
use Illuminate\Support\Once;
32
use Illuminate\Support\Sleep;
33
use Illuminate\View\Component;
34
use Orchestra\Testbench\Concerns\CreatesApplication;
35
use Orchestra\Testbench\Console\Commander;
36
use Orchestra\Testbench\Contracts\Config as ConfigContract;
37
use Orchestra\Testbench\Workbench\Workbench;
38

39
use function Orchestra\Sidekick\join_paths;
40

41
/**
42
 * @api
43
 *
44
 * @phpstan-import-type TExtraConfig from \Orchestra\Testbench\Foundation\Config
45
 * @phpstan-import-type TOptionalExtraConfig from \Orchestra\Testbench\Foundation\Config
46
 *
47
 * @phpstan-type TConfig array{
48
 *   extra?: TOptionalExtraConfig,
49
 *   load_environment_variables?: bool,
50
 *   enabled_package_discoveries?: bool
51
 * }
52
 */
53
class Application
54
{
55
    use CreatesApplication {
56
        resolveApplicationResolvingCallback as protected resolveApplicationResolvingCallbackFromTrait;
57
        resolveApplicationConfiguration as protected resolveApplicationConfigurationFromTrait;
58
    }
59

60
    /**
61
     * The Illuminate application instance.
62
     *
63
     * @var \Illuminate\Foundation\Application|null
64
     */
65
    protected $app;
66

67
    /**
68
     * List of configurations.
69
     *
70
     * @var array<string, mixed>
71
     *
72
     * @phpstan-var TExtraConfig
73
     */
74
    protected array $config = [
75
        'env' => [],
76
        'providers' => [],
77
        'dont-discover' => [],
78
        'bootstrappers' => [],
79
    ];
80

81
    /**
82
     * The application resolving callback.
83
     *
84
     * @var (callable(\Illuminate\Foundation\Application):(void))|null
85
     */
86
    protected $resolvingCallback;
87

88
    /**
89
     * Load Environment variables.
90
     *
91
     * @var bool
92
     */
93
    protected bool $loadEnvironmentVariables = false;
94

95
    /**
96
     * Create new application resolver.
97
     *
98
     * @param  string|null  $basePath
99
     * @param  (callable(\Illuminate\Foundation\Application):(void))|null  $resolvingCallback
100
     */
101
    public function __construct(
102
        protected readonly ?string $basePath = null,
103
        ?callable $resolvingCallback = null
104
    ) {
105
        $this->resolvingCallback = $resolvingCallback;
15✔
106
    }
107

108
    /**
109
     * Create new application resolver.
110
     *
111
     * @param  string|null  $basePath
112
     * @param  (callable(\Illuminate\Foundation\Application):(void))|null  $resolvingCallback
113
     * @param  array<string, mixed>  $options
114
     *
115
     * @phpstan-param TConfig  $options
116
     *
117
     * @return static
118
     */
119
    public static function make(?string $basePath = null, ?callable $resolvingCallback = null, array $options = [])
120
    {
121
        return (new static($basePath, $resolvingCallback))->configure($options);
13✔
122
    }
123

124
    /**
125
     * Create new application resolver from configuration file.
126
     *
127
     * @param  \Orchestra\Testbench\Contracts\Config  $config
128
     * @param  (callable(\Illuminate\Foundation\Application):(void))|null  $resolvingCallback
129
     * @param  array<string, mixed>  $options
130
     *
131
     * @phpstan-param TConfig  $options
132
     *
133
     * @return static
134
     */
135
    public static function makeFromConfig(ConfigContract $config, ?callable $resolvingCallback = null, array $options = [])
136
    {
137
        $basePath = $config['laravel'] ?? static::applicationBasePath();
1✔
138

139
        return (new static($config['laravel'], $resolvingCallback))->configure(array_merge($options, [
1✔
140
            'load_environment_variables' => is_file("{$basePath}/.env"),
1✔
141
            'extra' => $config->getExtraAttributes(),
1✔
142
        ]));
1✔
143
    }
144

145
    /**
146
     * Create symlink to vendor path via new application instance.
147
     *
148
     * @param  string|null  $basePath
149
     * @param  string  $workingVendorPath
150
     * @return \Illuminate\Foundation\Application
151
     *
152
     * @codeCoverageIgnore
153
     */
154
    public static function createVendorSymlink(?string $basePath, string $workingVendorPath)
155
    {
156
        $app = static::create(basePath: $basePath, options: ['extra' => ['dont-discover' => ['*']]]);
157

158
        (new Actions\CreateVendorSymlink($workingVendorPath))->handle($app);
159

160
        return $app;
161
    }
162

163
    /**
164
     * Delete symlink to vendor path via new application instance.
165
     *
166
     * @param  string|null  $basePath
167
     * @return \Illuminate\Foundation\Application
168
     *
169
     * @codeCoverageIgnore
170
     */
171
    public static function deleteVendorSymlink(?string $basePath)
172
    {
173
        $app = static::create(basePath: $basePath, options: ['extra' => ['dont-discover' => ['*']]]);
174

175
        (new Actions\DeleteVendorSymlink)->handle($app);
176

177
        return $app;
178
    }
179

180
    /**
181
     * Create new application instance.
182
     *
183
     * @param  string|null  $basePath
184
     * @param  (callable(\Illuminate\Foundation\Application):(void))|null  $resolvingCallback
185
     * @param  array<string, mixed>  $options
186
     *
187
     * @phpstan-param TConfig  $options
188
     *
189
     * @return \Illuminate\Foundation\Application
190
     */
191
    public static function create(?string $basePath = null, ?callable $resolvingCallback = null, array $options = [])
192
    {
193
        return static::make($basePath, $resolvingCallback, $options)->createApplication();
10✔
194
    }
195

196
    /**
197
     * Create new application instance from configuration file.
198
     *
199
     * @param  \Orchestra\Testbench\Contracts\Config  $config
200
     * @param  (callable(\Illuminate\Foundation\Application):(void))|null  $resolvingCallback
201
     * @param  array<string, mixed>  $options
202
     *
203
     * @phpstan-param TConfig  $options
204
     *
205
     * @return \Illuminate\Foundation\Application
206
     */
207
    public static function createFromConfig(ConfigContract $config, ?callable $resolvingCallback = null, array $options = [])
208
    {
209
        return static::makeFromConfig($config, $resolvingCallback, $options)->createApplication();
1✔
210
    }
211

212
    /**
213
     * Flush the application states.
214
     *
215
     * @param  \Orchestra\Testbench\Console\Commander|\Orchestra\Testbench\PHPUnit\TestCase  $instance
216
     * @return void
217
     */
218
    public static function flushState(object $instance): void
219
    {
220
        AboutCommand::flushState();
192✔
221
        Artisan::forgetBootstrappers();
192✔
222
        ChannelListCommand::resolveTerminalWidthUsing(null);
192✔
223
        Component::flushCache();
192✔
224
        Component::forgetComponentsResolver();
192✔
225
        Component::forgetFactory();
192✔
226
        ConvertEmptyStringsToNull::flushState();
192✔
227
        Factory::flushState();
192✔
228
        EncodedHtmlString::flushState();
192✔
229

230
        if (! $instance instanceof Commander) {
192✔
231
            HandleExceptions::flushState($instance);
192✔
232
        }
233

234
        JsonResource::wrap('data');
192✔
235
        Markdown::flushState();
192✔
236
        Migrator::withoutMigrations([]);
192✔
237
        Model::handleDiscardedAttributeViolationUsing(null);
192✔
238
        Model::handleLazyLoadingViolationUsing(null);
192✔
239
        Model::handleMissingAttributeViolationUsing(null);
192✔
240
        Model::preventAccessingMissingAttributes(false);
192✔
241
        Model::preventLazyLoading(false);
192✔
242
        Model::preventSilentlyDiscardingAttributes(false);
192✔
243
        Once::flush();
192✔
244
        PreventRequestsDuringMaintenance::flushState();
192✔
245
        Queue::createPayloadUsing(null);
192✔
246
        RegisterProviders::flushState();
192✔
247
        RouteListCommand::resolveTerminalWidthUsing(null);
192✔
248
        ScheduleListCommand::resolveTerminalWidthUsing(null);
192✔
249
        SchemaBuilder::$defaultStringLength = 255;
192✔
250
        SchemaBuilder::$defaultMorphKeyType = 'int';
192✔
251
        Signals::resolveAvailabilityUsing(null); // @phpstan-ignore argument.type
192✔
252
        Sleep::fake(false);
192✔
253
        ThrottleRequests::shouldHashKeys();
192✔
254
        TrimStrings::flushState();
192✔
255
        TrustProxies::flushState();
192✔
256
        TrustHosts::flushState();
192✔
257
        ValidateCsrfToken::flushState();
192✔
258
        WorkCommand::flushState();
192✔
259
    }
260

261
    /**
262
     * Configure the application options.
263
     *
264
     * @param  array<string, mixed>  $options
265
     *
266
     * @phpstan-param TConfig  $options
267
     *
268
     * @return $this
269
     */
270
    public function configure(array $options)
271
    {
272
        if (isset($options['load_environment_variables']) && \is_bool($options['load_environment_variables'])) {
14✔
273
            $this->loadEnvironmentVariables = $options['load_environment_variables'];
1✔
274
        }
275

276
        if (isset($options['enables_package_discoveries']) && \is_bool($options['enables_package_discoveries'])) {
14✔
UNCOV
277
            Arr::set($options, 'extra.dont-discover', []);
×
278
        }
279

280
        /** @var TExtraConfig $config */
281
        $config = Arr::only($options['extra'] ?? [], array_keys($this->config));
14✔
282

283
        $this->config = $config;
14✔
284

285
        return $this;
14✔
286
    }
287

288
    /**
289
     * Ignore package discovery from.
290
     *
291
     * @api
292
     *
293
     * @return array<int, string>
294
     */
295
    public function ignorePackageDiscoveriesFrom()
296
    {
297
        return $this->config['dont-discover'] ?? [];
15✔
298
    }
299

300
    /**
301
     * Get package providers.
302
     *
303
     * @api
304
     *
305
     * @param  \Illuminate\Foundation\Application  $app
306
     * @return array<int, class-string>
307
     */
308
    protected function getPackageProviders($app)
309
    {
310
        return $this->config['providers'] ?? [];
15✔
311
    }
312

313
    /**
314
     * Get package bootstrapper.
315
     *
316
     * @api
317
     *
318
     * @param  \Illuminate\Foundation\Application  $app
319
     * @return array<int, class-string>
320
     */
321
    protected function getPackageBootstrappers($app)
322
    {
323
        if (\is_null($bootstrappers = ($this->config['bootstrappers'] ?? null))) {
15✔
324
            return [];
13✔
325
        }
326

327
        return Arr::wrap($bootstrappers);
2✔
328
    }
329

330
    /**
331
     * Resolve application resolving callback.
332
     *
333
     * @internal
334
     *
335
     * @param  \Illuminate\Foundation\Application  $app
336
     * @return void
337
     */
338
    protected function resolveApplicationResolvingCallback($app): void
339
    {
340
        $this->resolveApplicationResolvingCallbackFromTrait($app);
15✔
341

342
        if (\is_callable($this->resolvingCallback)) {
15✔
UNCOV
343
            \call_user_func($this->resolvingCallback, $app);
×
344
        }
345
    }
346

347
    /**
348
     * Resolve the application's base path.
349
     *
350
     * @api
351
     *
352
     * @internal
353
     *
354
     * @return string
355
     */
356
    protected function getApplicationBasePath()
357
    {
358
        return $this->basePath ?? static::applicationBasePath();
15✔
359
    }
360

361
    /**
362
     * Resolve application core environment variables implementation.
363
     *
364
     * @internal
365
     *
366
     * @param  \Illuminate\Foundation\Application  $app
367
     * @return void
368
     */
369
    protected function resolveApplicationEnvironmentVariables($app)
370
    {
371
        Env::disablePutenv();
15✔
372

373
        $app->terminating(static function () {
15✔
374
            Env::enablePutenv();
1✔
375
        });
15✔
376

377
        if ($this->loadEnvironmentVariables === true) {
15✔
UNCOV
378
            $app->make(LoadEnvironmentVariables::class)->bootstrap($app);
×
379
        }
380

381
        (new Bootstrap\LoadEnvironmentVariablesFromArray($this->config['env'] ?? []))->bootstrap($app);
15✔
382
    }
383

384
    /**
385
     * Resolve application core configuration implementation.
386
     *
387
     * @internal
388
     *
389
     * @param  \Illuminate\Foundation\Application  $app
390
     * @return void
391
     */
392
    protected function resolveApplicationConfiguration($app)
393
    {
394
        $this->resolveApplicationConfigurationFromTrait($app);
15✔
395

396
        (new Bootstrap\EnsuresDefaultConfiguration)->bootstrap($app);
15✔
397
    }
398

399
    /**
400
     * Resolve application Console Kernel implementation.
401
     *
402
     * @api
403
     *
404
     * @param  \Illuminate\Foundation\Application  $app
405
     * @return void
406
     */
407
    protected function resolveApplicationConsoleKernel($app)
408
    {
409
        if ($this->hasCustomApplicationKernels() === true) {
15✔
UNCOV
410
            return;
×
411
        }
412

413
        $kernel = Workbench::applicationConsoleKernel() ?? 'Orchestra\Testbench\Console\Kernel';
15✔
414

415
        if (is_file($app->basePath(join_paths('app', 'Console', 'Kernel.php'))) && class_exists('App\Console\Kernel')) {
15✔
UNCOV
416
            $kernel = 'App\Console\Kernel';
×
417
        }
418

419
        $app->singleton('Illuminate\Contracts\Console\Kernel', $kernel);
15✔
420
    }
421

422
    /**
423
     * Resolve application HTTP Kernel implementation.
424
     *
425
     * @api
426
     *
427
     * @param  \Illuminate\Foundation\Application  $app
428
     * @return void
429
     */
430
    protected function resolveApplicationHttpKernel($app)
431
    {
432
        if ($this->hasCustomApplicationKernels() === true) {
15✔
UNCOV
433
            return;
×
434
        }
435

436
        $kernel = Workbench::applicationHttpKernel() ?? 'Orchestra\Testbench\Http\Kernel';
15✔
437

438
        if (is_file($app->basePath(join_paths('app', 'Http', 'Kernel.php'))) && class_exists('App\Http\Kernel')) {
15✔
UNCOV
439
            $kernel = 'App\Http\Kernel';
×
440
        }
441

442
        $app->singleton('Illuminate\Contracts\Http\Kernel', $kernel);
15✔
443
    }
444
}
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