├── public
├── favicon.ico
├── robots.txt
├── .htaccess
├── web.config
└── index.php
├── src
├── Data
│ ├── .gitkeep
│ └── Repositories
│ │ └── Repository.php
├── Policies
│ └── .gitkeep
├── Services
│ └── .gitkeep
├── Foundation
│ └── ServiceProvider.php
└── Domains
│ └── Http
│ └── Jobs
│ ├── RespondWithViewJob.php
│ ├── RespondWithJsonErrorJob.php
│ └── RespondWithJsonJob.php
├── resources
├── css
│ └── app.css
├── js
│ ├── app.js
│ └── bootstrap.js
├── lang
│ └── en
│ │ ├── pagination.php
│ │ ├── auth.php
│ │ ├── passwords.php
│ │ └── validation.php
└── views
│ └── welcome.blade.php
├── bootstrap
├── cache
│ └── .gitignore
└── app.php
├── storage
├── logs
│ └── .gitignore
├── app
│ ├── public
│ │ └── .gitignore
│ └── .gitignore
└── framework
│ ├── testing
│ └── .gitignore
│ ├── views
│ └── .gitignore
│ ├── cache
│ ├── data
│ │ └── .gitignore
│ └── .gitignore
│ ├── sessions
│ └── .gitignore
│ └── .gitignore
├── database
├── .gitignore
├── seeders
│ └── DatabaseSeeder.php
├── migrations
│ ├── 2014_10_12_100000_create_password_resets_table.php
│ ├── 2014_10_12_000000_create_users_table.php
│ └── 2019_08_19_000000_create_failed_jobs_table.php
└── factories
│ └── UserFactory.php
├── .gitattributes
├── tests
├── TestCase.php
├── Unit
│ └── ExampleTest.php
├── Feature
│ └── ExampleTest.php
└── CreatesApplication.php
├── .gitignore
├── .styleci.yml
├── .editorconfig
├── app
├── Http
│ ├── Middleware
│ │ ├── EncryptCookies.php
│ │ ├── VerifyCsrfToken.php
│ │ ├── TrimStrings.php
│ │ ├── TrustHosts.php
│ │ ├── PreventRequestsDuringMaintenance.php
│ │ ├── TrustProxies.php
│ │ ├── Authenticate.php
│ │ └── RedirectIfAuthenticated.php
│ ├── Controllers
│ │ └── Controller.php
│ └── Kernel.php
├── Providers
│ ├── BroadcastServiceProvider.php
│ ├── AppServiceProvider.php
│ ├── AuthServiceProvider.php
│ ├── EventServiceProvider.php
│ └── RouteServiceProvider.php
├── Exceptions
│ └── Handler.php
├── Console
│ └── Kernel.php
└── Models
│ └── User.php
├── routes
├── web.php
├── channels.php
├── api.php
└── console.php
├── webpack.mix.js
├── server.php
├── .github
└── FUNDING.yml
├── config
├── cors.php
├── services.php
├── view.php
├── hashing.php
├── broadcasting.php
├── filesystems.php
├── queue.php
├── logging.php
├── cache.php
├── mail.php
├── auth.php
├── database.php
├── session.php
└── app.php
├── .env.example
├── package.json
├── phpunit.xml
├── artisan
├── composer.json
└── readme.md
/public/favicon.ico:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/src/Data/.gitkeep:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/resources/css/app.css:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/src/Policies/.gitkeep:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/src/Services/.gitkeep:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/bootstrap/cache/.gitignore:
--------------------------------------------------------------------------------
1 | *
2 | !.gitignore
3 |
--------------------------------------------------------------------------------
/resources/js/app.js:
--------------------------------------------------------------------------------
1 | require('./bootstrap');
2 |
--------------------------------------------------------------------------------
/storage/logs/.gitignore:
--------------------------------------------------------------------------------
1 | *
2 | !.gitignore
3 |
--------------------------------------------------------------------------------
/database/.gitignore:
--------------------------------------------------------------------------------
1 | *.sqlite
2 | *.sqlite-journal
3 |
--------------------------------------------------------------------------------
/public/robots.txt:
--------------------------------------------------------------------------------
1 | User-agent: *
2 | Disallow:
3 |
--------------------------------------------------------------------------------
/storage/app/public/.gitignore:
--------------------------------------------------------------------------------
1 | *
2 | !.gitignore
3 |
--------------------------------------------------------------------------------
/storage/app/.gitignore:
--------------------------------------------------------------------------------
1 | *
2 | !public/
3 | !.gitignore
4 |
--------------------------------------------------------------------------------
/storage/framework/testing/.gitignore:
--------------------------------------------------------------------------------
1 | *
2 | !.gitignore
3 |
--------------------------------------------------------------------------------
/storage/framework/views/.gitignore:
--------------------------------------------------------------------------------
1 | *
2 | !.gitignore
3 |
--------------------------------------------------------------------------------
/storage/framework/cache/data/.gitignore:
--------------------------------------------------------------------------------
1 | *
2 | !.gitignore
3 |
--------------------------------------------------------------------------------
/storage/framework/sessions/.gitignore:
--------------------------------------------------------------------------------
1 | *
2 | !.gitignore
3 |
--------------------------------------------------------------------------------
/storage/framework/cache/.gitignore:
--------------------------------------------------------------------------------
1 | *
2 | !data/
3 | !.gitignore
4 |
--------------------------------------------------------------------------------
/.gitattributes:
--------------------------------------------------------------------------------
1 | * text=auto
2 | *.css linguist-vendored
3 | *.scss linguist-vendored
4 | *.js linguist-vendored
5 | CHANGELOG.md export-ignore
6 |
--------------------------------------------------------------------------------
/storage/framework/.gitignore:
--------------------------------------------------------------------------------
1 | compiled.php
2 | config.php
3 | down
4 | events.scanned.php
5 | maintenance.php
6 | routes.php
7 | routes.scanned.php
8 | schedule-*
9 | services.json
10 |
--------------------------------------------------------------------------------
/tests/TestCase.php:
--------------------------------------------------------------------------------
1 | assertTrue(true);
17 | }
18 | }
19 |
--------------------------------------------------------------------------------
/database/seeders/DatabaseSeeder.php:
--------------------------------------------------------------------------------
1 | create();
17 | }
18 | }
19 |
--------------------------------------------------------------------------------
/app/Http/Middleware/EncryptCookies.php:
--------------------------------------------------------------------------------
1 | app->register('full namespace here')
13 | }
14 | }
15 |
--------------------------------------------------------------------------------
/app/Http/Controllers/Controller.php:
--------------------------------------------------------------------------------
1 | get('/');
18 |
19 | $response->assertStatus(200);
20 | }
21 | }
22 |
--------------------------------------------------------------------------------
/app/Http/Middleware/TrustHosts.php:
--------------------------------------------------------------------------------
1 | allSubdomainsOfApplicationUrl(),
18 | ];
19 | }
20 | }
21 |
--------------------------------------------------------------------------------
/app/Http/Middleware/PreventRequestsDuringMaintenance.php:
--------------------------------------------------------------------------------
1 | make(Kernel::class)->bootstrap();
19 |
20 | return $app;
21 | }
22 | }
23 |
--------------------------------------------------------------------------------
/app/Providers/BroadcastServiceProvider.php:
--------------------------------------------------------------------------------
1 | expectsJson()) {
18 | return route('login');
19 | }
20 | }
21 | }
22 |
--------------------------------------------------------------------------------
/resources/lang/en/pagination.php:
--------------------------------------------------------------------------------
1 | '« Previous',
17 | 'next' => 'Next »',
18 |
19 | ];
20 |
--------------------------------------------------------------------------------
/webpack.mix.js:
--------------------------------------------------------------------------------
1 | const mix = require('laravel-mix');
2 |
3 | /*
4 | |--------------------------------------------------------------------------
5 | | Mix Asset Management
6 | |--------------------------------------------------------------------------
7 | |
8 | | Mix provides a clean, fluent API for defining some Webpack build steps
9 | | for your Laravel applications. By default, we are compiling the CSS
10 | | file for the application as well as bundling up all the JS files.
11 | |
12 | */
13 |
14 | mix.js('resources/js/app.js', 'public/js')
15 | .postCss('resources/css/app.css', 'public/css', [
16 | //
17 | ]);
18 |
--------------------------------------------------------------------------------
/routes/channels.php:
--------------------------------------------------------------------------------
1 | id === (int) $id;
18 | });
19 |
--------------------------------------------------------------------------------
/routes/api.php:
--------------------------------------------------------------------------------
1 | get('/user', function (Request $request) {
18 | return $request->user();
19 | });
20 |
--------------------------------------------------------------------------------
/server.php:
--------------------------------------------------------------------------------
1 |
8 | */
9 |
10 | $uri = urldecode(
11 | parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH)
12 | );
13 |
14 | // This file allows us to emulate Apache's "mod_rewrite" functionality from the
15 | // built-in PHP web server. This provides a convenient way to test a Laravel
16 | // application without having installed a "real" web server software here.
17 | if ($uri !== '/' && file_exists(__DIR__.'/public'.$uri)) {
18 | return false;
19 | }
20 |
21 | require_once __DIR__.'/public/index.php';
22 |
--------------------------------------------------------------------------------
/routes/console.php:
--------------------------------------------------------------------------------
1 | comment(Inspiring::quote());
19 | })->purpose('Display an inspiring quote');
20 |
--------------------------------------------------------------------------------
/public/.htaccess:
--------------------------------------------------------------------------------
1 |
2 |
3 | Options -MultiViews -Indexes
4 |
5 |
6 | RewriteEngine On
7 |
8 | # Handle Authorization Header
9 | RewriteCond %{HTTP:Authorization} .
10 | RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
11 |
12 | # Redirect Trailing Slashes If Not A Folder...
13 | RewriteCond %{REQUEST_FILENAME} !-d
14 | RewriteCond %{REQUEST_URI} (.+)/$
15 | RewriteRule ^ %1 [L,R=301]
16 |
17 | # Send Requests To Front Controller...
18 | RewriteCond %{REQUEST_FILENAME} !-d
19 | RewriteCond %{REQUEST_FILENAME} !-f
20 | RewriteRule ^ index.php [L]
21 |
22 |
--------------------------------------------------------------------------------
/resources/lang/en/auth.php:
--------------------------------------------------------------------------------
1 | 'These credentials do not match our records.',
17 | 'throttle' => 'Too many login attempts. Please try again in :seconds seconds.',
18 |
19 | ];
20 |
--------------------------------------------------------------------------------
/app/Providers/AuthServiceProvider.php:
--------------------------------------------------------------------------------
1 | 'Framework\Policies\ModelPolicy',
17 | ];
18 |
19 | /**
20 | * Register any authentication / authorization services.
21 | *
22 | * @return void
23 | */
24 | public function boot()
25 | {
26 | $this->registerPolicies();
27 |
28 | //
29 | }
30 | }
31 |
--------------------------------------------------------------------------------
/.github/FUNDING.yml:
--------------------------------------------------------------------------------
1 | # These are supported funding model platforms
2 |
3 | github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
4 | patreon: mulkave # Replace with a single Patreon username
5 | open_collective: # Replace with a single Open Collective username
6 | ko_fi: # Replace with a single Ko-fi username
7 | tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
8 | community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
9 | liberapay: # Replace with a single Liberapay username
10 | issuehunt: # Replace with a single IssueHunt username
11 | otechie: # Replace with a single Otechie username
12 | custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
13 |
--------------------------------------------------------------------------------
/src/Domains/Http/Jobs/RespondWithViewJob.php:
--------------------------------------------------------------------------------
1 | template = $template;
18 | $this->data = $data;
19 | $this->status = $status;
20 | $this->headers = $headers;
21 | }
22 |
23 | public function handle(ResponseFactory $factory)
24 | {
25 | return $factory->view($this->template, $this->data, $this->status, $this->headers);
26 | }
27 | }
--------------------------------------------------------------------------------
/app/Exceptions/Handler.php:
--------------------------------------------------------------------------------
1 | 'Your password has been reset!',
17 | 'sent' => 'We have emailed your password reset link!',
18 | 'throttled' => 'Please wait before retrying.',
19 | 'token' => 'This password reset token is invalid.',
20 | 'user' => "We can't find a user with that email address.",
21 |
22 | ];
23 |
--------------------------------------------------------------------------------
/app/Providers/EventServiceProvider.php:
--------------------------------------------------------------------------------
1 | [
19 | SendEmailVerificationNotification::class,
20 | ],
21 | ];
22 |
23 | /**
24 | * Register any events for your application.
25 | *
26 | * @return void
27 | */
28 | public function boot()
29 | {
30 | //
31 | }
32 | }
33 |
--------------------------------------------------------------------------------
/database/migrations/2014_10_12_100000_create_password_resets_table.php:
--------------------------------------------------------------------------------
1 | string('email')->index();
18 | $table->string('token');
19 | $table->timestamp('created_at')->nullable();
20 | });
21 | }
22 |
23 | /**
24 | * Reverse the migrations.
25 | *
26 | * @return void
27 | */
28 | public function down()
29 | {
30 | Schema::dropIfExists('password_resets');
31 | }
32 | }
33 |
--------------------------------------------------------------------------------
/src/Domains/Http/Jobs/RespondWithJsonErrorJob.php:
--------------------------------------------------------------------------------
1 | content = [
12 | 'status' => $status,
13 | 'error' => [
14 | 'code' => $code,
15 | 'message' => $message,
16 | ],
17 | ];
18 |
19 | $this->status = $status;
20 | $this->headers = $headers;
21 | $this->options = $options;
22 | }
23 |
24 | public function handle(ResponseFactory $response)
25 | {
26 | return $response->json($this->content, $this->status, $this->headers, $this->options);
27 | }
28 | }
29 |
--------------------------------------------------------------------------------
/app/Http/Middleware/RedirectIfAuthenticated.php:
--------------------------------------------------------------------------------
1 | check()) {
26 | return redirect(RouteServiceProvider::HOME);
27 | }
28 | }
29 |
30 | return $next($request);
31 | }
32 | }
33 |
--------------------------------------------------------------------------------
/src/Domains/Http/Jobs/RespondWithJsonJob.php:
--------------------------------------------------------------------------------
1 | content = $content;
18 | $this->status = $status;
19 | $this->headers = $headers;
20 | $this->options = $options;
21 | }
22 |
23 | public function handle(ResponseFactory $factory)
24 | {
25 | $response = [
26 | 'data' => $this->content,
27 | 'status' => $this->status,
28 | ];
29 |
30 | return $factory->json($response, $this->status, $this->headers, $this->options);
31 | }
32 | }
33 |
--------------------------------------------------------------------------------
/database/factories/UserFactory.php:
--------------------------------------------------------------------------------
1 | $this->faker->name,
27 | 'email' => $this->faker->unique()->safeEmail,
28 | 'email_verified_at' => now(),
29 | 'password' => '$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi', // password
30 | 'remember_token' => Str::random(10),
31 | ];
32 | }
33 | }
34 |
--------------------------------------------------------------------------------
/config/cors.php:
--------------------------------------------------------------------------------
1 | ['api/*'],
19 |
20 | 'allowed_methods' => ['*'],
21 |
22 | 'allowed_origins' => ['*'],
23 |
24 | 'allowed_origins_patterns' => [],
25 |
26 | 'allowed_headers' => ['*'],
27 |
28 | 'exposed_headers' => [],
29 |
30 | 'max_age' => 0,
31 |
32 | 'supports_credentials' => false,
33 |
34 | ];
35 |
--------------------------------------------------------------------------------
/resources/js/bootstrap.js:
--------------------------------------------------------------------------------
1 | window._ = require('lodash');
2 |
3 | /**
4 | * We'll load the axios HTTP library which allows us to easily issue requests
5 | * to our Laravel back-end. This library automatically handles sending the
6 | * CSRF token as a header based on the value of the "XSRF" token cookie.
7 | */
8 |
9 | window.axios = require('axios');
10 |
11 | window.axios.defaults.headers.common['X-Requested-With'] = 'XMLHttpRequest';
12 |
13 | /**
14 | * Echo exposes an expressive API for subscribing to channels and listening
15 | * for events that are broadcast by Laravel. Echo and event broadcasting
16 | * allows your team to easily build robust real-time web applications.
17 | */
18 |
19 | // import Echo from 'laravel-echo';
20 |
21 | // window.Pusher = require('pusher-js');
22 |
23 | // window.Echo = new Echo({
24 | // broadcaster: 'pusher',
25 | // key: process.env.MIX_PUSHER_APP_KEY,
26 | // cluster: process.env.MIX_PUSHER_APP_CLUSTER,
27 | // forceTLS: true
28 | // });
29 |
--------------------------------------------------------------------------------
/.env.example:
--------------------------------------------------------------------------------
1 | APP_NAME=Laravel
2 | APP_ENV=local
3 | APP_KEY=
4 | APP_DEBUG=true
5 | APP_URL=http://localhost
6 |
7 | LOG_CHANNEL=stack
8 | LOG_LEVEL=debug
9 |
10 | DB_CONNECTION=mysql
11 | DB_HOST=127.0.0.1
12 | DB_PORT=3306
13 | DB_DATABASE=laravel
14 | DB_USERNAME=root
15 | DB_PASSWORD=
16 |
17 | BROADCAST_DRIVER=log
18 | CACHE_DRIVER=file
19 | QUEUE_CONNECTION=sync
20 | SESSION_DRIVER=file
21 | SESSION_LIFETIME=120
22 |
23 | REDIS_HOST=127.0.0.1
24 | REDIS_PASSWORD=null
25 | REDIS_PORT=6379
26 |
27 | MAIL_MAILER=smtp
28 | MAIL_HOST=smtp.mailtrap.io
29 | MAIL_PORT=2525
30 | MAIL_USERNAME=null
31 | MAIL_PASSWORD=null
32 | MAIL_ENCRYPTION=null
33 | MAIL_FROM_ADDRESS=null
34 | MAIL_FROM_NAME="${APP_NAME}"
35 |
36 | AWS_ACCESS_KEY_ID=
37 | AWS_SECRET_ACCESS_KEY=
38 | AWS_DEFAULT_REGION=us-east-1
39 | AWS_BUCKET=
40 |
41 | PUSHER_APP_ID=
42 | PUSHER_APP_KEY=
43 | PUSHER_APP_SECRET=
44 | PUSHER_APP_CLUSTER=mt1
45 |
46 | MIX_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
47 | MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"
48 |
--------------------------------------------------------------------------------
/database/migrations/2014_10_12_000000_create_users_table.php:
--------------------------------------------------------------------------------
1 | id();
18 | $table->string('name');
19 | $table->string('email')->unique();
20 | $table->timestamp('email_verified_at')->nullable();
21 | $table->string('password');
22 | $table->rememberToken();
23 | $table->timestamps();
24 | });
25 | }
26 |
27 | /**
28 | * Reverse the migrations.
29 | *
30 | * @return void
31 | */
32 | public function down()
33 | {
34 | Schema::dropIfExists('users');
35 | }
36 | }
37 |
--------------------------------------------------------------------------------
/app/Console/Kernel.php:
--------------------------------------------------------------------------------
1 | command('inspire')->hourly();
28 | }
29 |
30 | /**
31 | * Register the commands for the application.
32 | *
33 | * @return void
34 | */
35 | protected function commands()
36 | {
37 | $this->load(__DIR__.'/Commands');
38 |
39 | require base_path('routes/console.php');
40 | }
41 | }
42 |
--------------------------------------------------------------------------------
/database/migrations/2019_08_19_000000_create_failed_jobs_table.php:
--------------------------------------------------------------------------------
1 | id();
18 | $table->string('uuid')->unique();
19 | $table->text('connection');
20 | $table->text('queue');
21 | $table->longText('payload');
22 | $table->longText('exception');
23 | $table->timestamp('failed_at')->useCurrent();
24 | });
25 | }
26 |
27 | /**
28 | * Reverse the migrations.
29 | *
30 | * @return void
31 | */
32 | public function down()
33 | {
34 | Schema::dropIfExists('failed_jobs');
35 | }
36 | }
37 |
--------------------------------------------------------------------------------
/app/Models/User.php:
--------------------------------------------------------------------------------
1 | 'datetime',
42 | ];
43 | }
44 |
--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "private": true,
3 | "scripts": {
4 | "dev": "npm run development",
5 | "development": "cross-env NODE_ENV=development node_modules/webpack/bin/webpack.js --progress --hide-modules --config=node_modules/laravel-mix/setup/webpack.config.js",
6 | "watch": "npm run development -- --watch",
7 | "watch-poll": "npm run watch -- --watch-poll",
8 | "hot": "cross-env NODE_ENV=development node_modules/webpack-dev-server/bin/webpack-dev-server.js --inline --hot --disable-host-check --config=node_modules/laravel-mix/setup/webpack.config.js",
9 | "prod": "npm run production",
10 | "production": "cross-env NODE_ENV=production node_modules/webpack/bin/webpack.js --no-progress --hide-modules --config=node_modules/laravel-mix/setup/webpack.config.js"
11 | },
12 | "devDependencies": {
13 | "axios": "^0.19",
14 | "cross-env": "^7.0",
15 | "laravel-mix": "^5.0.1",
16 | "lodash": "^4.17.19",
17 | "resolve-url-loader": "^3.1.0"
18 | }
19 | }
20 |
--------------------------------------------------------------------------------
/config/services.php:
--------------------------------------------------------------------------------
1 | [
18 | 'domain' => env('MAILGUN_DOMAIN'),
19 | 'secret' => env('MAILGUN_SECRET'),
20 | 'endpoint' => env('MAILGUN_ENDPOINT', 'api.mailgun.net'),
21 | ],
22 |
23 | 'postmark' => [
24 | 'token' => env('POSTMARK_TOKEN'),
25 | ],
26 |
27 | 'ses' => [
28 | 'key' => env('AWS_ACCESS_KEY_ID'),
29 | 'secret' => env('AWS_SECRET_ACCESS_KEY'),
30 | 'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
31 | ],
32 |
33 | ];
34 |
--------------------------------------------------------------------------------
/config/view.php:
--------------------------------------------------------------------------------
1 | [
17 | resource_path('views'),
18 | ],
19 |
20 | /*
21 | |--------------------------------------------------------------------------
22 | | Compiled View Path
23 | |--------------------------------------------------------------------------
24 | |
25 | | This option determines where all the compiled Blade templates will be
26 | | stored for your application. Typically, this is within the storage
27 | | directory. However, as usual, you are free to change this value.
28 | |
29 | */
30 |
31 | 'compiled' => env(
32 | 'VIEW_COMPILED_PATH',
33 | realpath(storage_path('framework/views'))
34 | ),
35 |
36 | ];
37 |
--------------------------------------------------------------------------------
/public/web.config:
--------------------------------------------------------------------------------
1 |
6 |
7 |
8 |
9 |
10 |
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
23 |
24 |
25 |
26 |
27 |
28 |
29 |
--------------------------------------------------------------------------------
/phpunit.xml:
--------------------------------------------------------------------------------
1 |
2 |
7 |
8 |
9 | ./tests/Unit
10 |
11 |
12 | ./tests/Feature
13 |
14 |
15 | ./src/Services/*/Tests
16 |
17 |
18 | ./src/Domains/*/Tests
19 |
20 |
21 |
22 |
23 | ./app
24 |
25 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
35 |
36 |
37 |
38 |
--------------------------------------------------------------------------------
/config/hashing.php:
--------------------------------------------------------------------------------
1 | 'bcrypt',
19 |
20 | /*
21 | |--------------------------------------------------------------------------
22 | | Bcrypt Options
23 | |--------------------------------------------------------------------------
24 | |
25 | | Here you may specify the configuration options that should be used when
26 | | passwords are hashed using the Bcrypt algorithm. This will allow you
27 | | to control the amount of time it takes to hash the given password.
28 | |
29 | */
30 |
31 | 'bcrypt' => [
32 | 'rounds' => env('BCRYPT_ROUNDS', 10),
33 | ],
34 |
35 | /*
36 | |--------------------------------------------------------------------------
37 | | Argon Options
38 | |--------------------------------------------------------------------------
39 | |
40 | | Here you may specify the configuration options that should be used when
41 | | passwords are hashed using the Argon algorithm. These will allow you
42 | | to control the amount of time it takes to hash the given password.
43 | |
44 | */
45 |
46 | 'argon' => [
47 | 'memory' => 1024,
48 | 'threads' => 2,
49 | 'time' => 2,
50 | ],
51 |
52 | ];
53 |
--------------------------------------------------------------------------------
/config/broadcasting.php:
--------------------------------------------------------------------------------
1 | env('BROADCAST_DRIVER', 'null'),
19 |
20 | /*
21 | |--------------------------------------------------------------------------
22 | | Broadcast Connections
23 | |--------------------------------------------------------------------------
24 | |
25 | | Here you may define all of the broadcast connections that will be used
26 | | to broadcast events to other systems or over websockets. Samples of
27 | | each available type of connection are provided inside this array.
28 | |
29 | */
30 |
31 | 'connections' => [
32 |
33 | 'pusher' => [
34 | 'driver' => 'pusher',
35 | 'key' => env('PUSHER_APP_KEY'),
36 | 'secret' => env('PUSHER_APP_SECRET'),
37 | 'app_id' => env('PUSHER_APP_ID'),
38 | 'options' => [
39 | 'cluster' => env('PUSHER_APP_CLUSTER'),
40 | 'useTLS' => true,
41 | ],
42 | ],
43 |
44 | 'redis' => [
45 | 'driver' => 'redis',
46 | 'connection' => 'default',
47 | ],
48 |
49 | 'log' => [
50 | 'driver' => 'log',
51 | ],
52 |
53 | 'null' => [
54 | 'driver' => 'null',
55 | ],
56 |
57 | ],
58 |
59 | ];
60 |
--------------------------------------------------------------------------------
/bootstrap/app.php:
--------------------------------------------------------------------------------
1 | singleton(
30 | Illuminate\Contracts\Http\Kernel::class,
31 | Framework\Http\Kernel::class
32 | );
33 |
34 | $app->singleton(
35 | Illuminate\Contracts\Console\Kernel::class,
36 | Framework\Console\Kernel::class
37 | );
38 |
39 | $app->singleton(
40 | Illuminate\Contracts\Debug\ExceptionHandler::class,
41 | Framework\Exceptions\Handler::class
42 | );
43 |
44 | /*
45 | |--------------------------------------------------------------------------
46 | | Return The Application
47 | |--------------------------------------------------------------------------
48 | |
49 | | This script returns the application instance. The instance is given to
50 | | the calling script so we can separate the building of the instances
51 | | from the actual running of the application and sending responses.
52 | |
53 | */
54 |
55 | return $app;
56 |
--------------------------------------------------------------------------------
/artisan:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env php
2 | make(Illuminate\Contracts\Console\Kernel::class);
34 |
35 | $status = $kernel->handle(
36 | $input = new Symfony\Component\Console\Input\ArgvInput,
37 | new Symfony\Component\Console\Output\ConsoleOutput
38 | );
39 |
40 | /*
41 | |--------------------------------------------------------------------------
42 | | Shutdown The Application
43 | |--------------------------------------------------------------------------
44 | |
45 | | Once Artisan has finished running, we will fire off the shutdown events
46 | | so that any final work may be done by the application before we shut
47 | | down the process. This is the last thing to happen to the request.
48 | |
49 | */
50 |
51 | $kernel->terminate($input, $status);
52 |
53 | exit($status);
54 |
--------------------------------------------------------------------------------
/app/Providers/RouteServiceProvider.php:
--------------------------------------------------------------------------------
1 | configureRateLimiting();
39 |
40 | $this->routes(function () {
41 | Route::prefix('api')
42 | ->middleware('api')
43 | ->namespace($this->namespace)
44 | ->group(base_path('routes/api.php'));
45 |
46 | Route::middleware('web')
47 | ->namespace($this->namespace)
48 | ->group(base_path('routes/web.php'));
49 | });
50 | }
51 |
52 | /**
53 | * Configure the rate limiters for the application.
54 | *
55 | * @return void
56 | */
57 | protected function configureRateLimiting()
58 | {
59 | RateLimiter::for('api', function (Request $request) {
60 | return Limit::perMinute(60);
61 | });
62 | }
63 | }
64 |
--------------------------------------------------------------------------------
/public/index.php:
--------------------------------------------------------------------------------
1 | make(Kernel::class);
50 |
51 | $response = tap($kernel->handle(
52 | $request = Request::capture()
53 | ))->send();
54 |
55 | $kernel->terminate($request, $response);
56 |
--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "laravel/laravel",
3 | "type": "project",
4 | "description": "The Laravel Framework.",
5 | "keywords": [
6 | "framework",
7 | "laravel"
8 | ],
9 | "license": "MIT",
10 | "require": {
11 | "php": "^7.3",
12 | "fideloper/proxy": "^4.2",
13 | "fruitcake/laravel-cors": "^2.0",
14 | "guzzlehttp/guzzle": "^7.0.1",
15 | "laravel/framework": "^8.0",
16 | "laravel/tinker": "^2.0",
17 | "lucid-arch/laravel-foundation": "^8.0"
18 | },
19 | "require-dev": {
20 | "facade/ignition": "^2.3.6",
21 | "fzaninotto/faker": "^1.9.1",
22 | "mockery/mockery": "^1.3.1",
23 | "nunomaduro/collision": "^5.0",
24 | "phpunit/phpunit": "^9.3",
25 | "lucid-arch/laravel-console": "^7.0"
26 | },
27 | "config": {
28 | "optimize-autoloader": true,
29 | "preferred-install": "dist",
30 | "sort-packages": true
31 | },
32 | "extra": {
33 | "laravel": {
34 | "dont-discover": []
35 | }
36 | },
37 | "autoload": {
38 | "psr-4": {
39 | "App\\": "src/",
40 | "Framework\\": "app/",
41 | "Database\\Factories\\": "database/factories/",
42 | "Database\\Seeders\\": "database/seeders/"
43 | }
44 | },
45 | "autoload-dev": {
46 | "psr-4": {
47 | "Tests\\": "tests/"
48 | }
49 | },
50 | "minimum-stability": "dev",
51 | "prefer-stable": true,
52 | "scripts": {
53 | "post-autoload-dump": [
54 | "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
55 | "@php artisan package:discover --ansi"
56 | ],
57 | "post-root-package-install": [
58 | "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
59 | ],
60 | "post-create-project-cmd": [
61 | "@php artisan key:generate --ansi"
62 | ]
63 | }
64 | }
65 |
--------------------------------------------------------------------------------
/app/Http/Kernel.php:
--------------------------------------------------------------------------------
1 | [
33 | \Framework\Http\Middleware\EncryptCookies::class,
34 | \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
35 | \Illuminate\Session\Middleware\StartSession::class,
36 | // \Illuminate\Session\Middleware\AuthenticateSession::class,
37 | \Illuminate\View\Middleware\ShareErrorsFromSession::class,
38 | \Framework\Http\Middleware\VerifyCsrfToken::class,
39 | \Illuminate\Routing\Middleware\SubstituteBindings::class,
40 | ],
41 |
42 | 'api' => [
43 | 'throttle:api',
44 | \Illuminate\Routing\Middleware\SubstituteBindings::class,
45 | ],
46 | ];
47 |
48 | /**
49 | * The application's route middleware.
50 | *
51 | * These middleware may be assigned to groups or used individually.
52 | *
53 | * @var array
54 | */
55 | protected $routeMiddleware = [
56 | 'auth' => \Framework\Http\Middleware\Authenticate::class,
57 | 'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
58 | 'cache.headers' => \Illuminate\Http\Middleware\SetCacheHeaders::class,
59 | 'can' => \Illuminate\Auth\Middleware\Authorize::class,
60 | 'guest' => \Framework\Http\Middleware\RedirectIfAuthenticated::class,
61 | 'password.confirm' => \Illuminate\Auth\Middleware\RequirePassword::class,
62 | 'signed' => \Illuminate\Routing\Middleware\ValidateSignature::class,
63 | 'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
64 | 'verified' => \Illuminate\Auth\Middleware\EnsureEmailIsVerified::class,
65 | ];
66 | }
67 |
--------------------------------------------------------------------------------
/config/filesystems.php:
--------------------------------------------------------------------------------
1 | env('FILESYSTEM_DRIVER', 'local'),
17 |
18 | /*
19 | |--------------------------------------------------------------------------
20 | | Default Cloud Filesystem Disk
21 | |--------------------------------------------------------------------------
22 | |
23 | | Many applications store files both locally and in the cloud. For this
24 | | reason, you may specify a default "cloud" driver here. This driver
25 | | will be bound as the Cloud disk implementation in the container.
26 | |
27 | */
28 |
29 | 'cloud' => env('FILESYSTEM_CLOUD', 's3'),
30 |
31 | /*
32 | |--------------------------------------------------------------------------
33 | | Filesystem Disks
34 | |--------------------------------------------------------------------------
35 | |
36 | | Here you may configure as many filesystem "disks" as you wish, and you
37 | | may even configure multiple disks of the same driver. Defaults have
38 | | been setup for each driver as an example of the required options.
39 | |
40 | | Supported Drivers: "local", "ftp", "sftp", "s3"
41 | |
42 | */
43 |
44 | 'disks' => [
45 |
46 | 'local' => [
47 | 'driver' => 'local',
48 | 'root' => storage_path('app'),
49 | ],
50 |
51 | 'public' => [
52 | 'driver' => 'local',
53 | 'root' => storage_path('app/public'),
54 | 'url' => env('APP_URL').'/storage',
55 | 'visibility' => 'public',
56 | ],
57 |
58 | 's3' => [
59 | 'driver' => 's3',
60 | 'key' => env('AWS_ACCESS_KEY_ID'),
61 | 'secret' => env('AWS_SECRET_ACCESS_KEY'),
62 | 'region' => env('AWS_DEFAULT_REGION'),
63 | 'bucket' => env('AWS_BUCKET'),
64 | 'url' => env('AWS_URL'),
65 | 'endpoint' => env('AWS_ENDPOINT'),
66 | ],
67 |
68 | ],
69 |
70 | /*
71 | |--------------------------------------------------------------------------
72 | | Symbolic Links
73 | |--------------------------------------------------------------------------
74 | |
75 | | Here you may configure the symbolic links that will be created when the
76 | | `storage:link` Artisan command is executed. The array keys should be
77 | | the locations of the links and the values should be their targets.
78 | |
79 | */
80 |
81 | 'links' => [
82 | public_path('storage') => storage_path('app/public'),
83 | ],
84 |
85 | ];
86 |
--------------------------------------------------------------------------------
/config/queue.php:
--------------------------------------------------------------------------------
1 | env('QUEUE_CONNECTION', 'sync'),
17 |
18 | /*
19 | |--------------------------------------------------------------------------
20 | | Queue Connections
21 | |--------------------------------------------------------------------------
22 | |
23 | | Here you may configure the connection information for each server that
24 | | is used by your application. A default configuration has been added
25 | | for each back-end shipped with Laravel. You are free to add more.
26 | |
27 | | Drivers: "sync", "database", "beanstalkd", "sqs", "redis", "null"
28 | |
29 | */
30 |
31 | 'connections' => [
32 |
33 | 'sync' => [
34 | 'driver' => 'sync',
35 | ],
36 |
37 | 'database' => [
38 | 'driver' => 'database',
39 | 'table' => 'jobs',
40 | 'queue' => 'default',
41 | 'retry_after' => 90,
42 | ],
43 |
44 | 'beanstalkd' => [
45 | 'driver' => 'beanstalkd',
46 | 'host' => 'localhost',
47 | 'queue' => 'default',
48 | 'retry_after' => 90,
49 | 'block_for' => 0,
50 | ],
51 |
52 | 'sqs' => [
53 | 'driver' => 'sqs',
54 | 'key' => env('AWS_ACCESS_KEY_ID'),
55 | 'secret' => env('AWS_SECRET_ACCESS_KEY'),
56 | 'prefix' => env('SQS_PREFIX', 'https://sqs.us-east-1.amazonaws.com/your-account-id'),
57 | 'queue' => env('SQS_QUEUE', 'your-queue-name'),
58 | 'suffix' => env('SQS_SUFFIX'),
59 | 'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
60 | ],
61 |
62 | 'redis' => [
63 | 'driver' => 'redis',
64 | 'connection' => 'default',
65 | 'queue' => env('REDIS_QUEUE', 'default'),
66 | 'retry_after' => 90,
67 | 'block_for' => null,
68 | ],
69 |
70 | ],
71 |
72 | /*
73 | |--------------------------------------------------------------------------
74 | | Failed Queue Jobs
75 | |--------------------------------------------------------------------------
76 | |
77 | | These options configure the behavior of failed queue job logging so you
78 | | can control which database and table are used to store the jobs that
79 | | have failed. You may change them to any database / table you wish.
80 | |
81 | */
82 |
83 | 'failed' => [
84 | 'driver' => env('QUEUE_FAILED_DRIVER', 'database-uuids'),
85 | 'database' => env('DB_CONNECTION', 'mysql'),
86 | 'table' => 'failed_jobs',
87 | ],
88 |
89 | ];
90 |
--------------------------------------------------------------------------------
/config/logging.php:
--------------------------------------------------------------------------------
1 | env('LOG_CHANNEL', 'stack'),
21 |
22 | /*
23 | |--------------------------------------------------------------------------
24 | | Log Channels
25 | |--------------------------------------------------------------------------
26 | |
27 | | Here you may configure the log channels for your application. Out of
28 | | the box, Laravel uses the Monolog PHP logging library. This gives
29 | | you a variety of powerful log handlers / formatters to utilize.
30 | |
31 | | Available Drivers: "single", "daily", "slack", "syslog",
32 | | "errorlog", "monolog",
33 | | "custom", "stack"
34 | |
35 | */
36 |
37 | 'channels' => [
38 | 'stack' => [
39 | 'driver' => 'stack',
40 | 'channels' => ['single'],
41 | 'ignore_exceptions' => false,
42 | ],
43 |
44 | 'single' => [
45 | 'driver' => 'single',
46 | 'path' => storage_path('logs/laravel.log'),
47 | 'level' => env('LOG_LEVEL', 'debug'),
48 | ],
49 |
50 | 'daily' => [
51 | 'driver' => 'daily',
52 | 'path' => storage_path('logs/laravel.log'),
53 | 'level' => env('LOG_LEVEL', 'debug'),
54 | 'days' => 14,
55 | ],
56 |
57 | 'slack' => [
58 | 'driver' => 'slack',
59 | 'url' => env('LOG_SLACK_WEBHOOK_URL'),
60 | 'username' => 'Laravel Log',
61 | 'emoji' => ':boom:',
62 | 'level' => env('LOG_LEVEL', 'critical'),
63 | ],
64 |
65 | 'papertrail' => [
66 | 'driver' => 'monolog',
67 | 'level' => env('LOG_LEVEL', 'debug'),
68 | 'handler' => SyslogUdpHandler::class,
69 | 'handler_with' => [
70 | 'host' => env('PAPERTRAIL_URL'),
71 | 'port' => env('PAPERTRAIL_PORT'),
72 | ],
73 | ],
74 |
75 | 'stderr' => [
76 | 'driver' => 'monolog',
77 | 'handler' => StreamHandler::class,
78 | 'formatter' => env('LOG_STDERR_FORMATTER'),
79 | 'with' => [
80 | 'stream' => 'php://stderr',
81 | ],
82 | ],
83 |
84 | 'syslog' => [
85 | 'driver' => 'syslog',
86 | 'level' => env('LOG_LEVEL', 'debug'),
87 | ],
88 |
89 | 'errorlog' => [
90 | 'driver' => 'errorlog',
91 | 'level' => env('LOG_LEVEL', 'debug'),
92 | ],
93 |
94 | 'null' => [
95 | 'driver' => 'monolog',
96 | 'handler' => NullHandler::class,
97 | ],
98 |
99 | 'emergency' => [
100 | 'path' => storage_path('logs/laravel.log'),
101 | ],
102 | ],
103 |
104 | ];
105 |
--------------------------------------------------------------------------------
/config/cache.php:
--------------------------------------------------------------------------------
1 | env('CACHE_DRIVER', 'file'),
22 |
23 | /*
24 | |--------------------------------------------------------------------------
25 | | Cache Stores
26 | |--------------------------------------------------------------------------
27 | |
28 | | Here you may define all of the cache "stores" for your application as
29 | | well as their drivers. You may even define multiple stores for the
30 | | same cache driver to group types of items stored in your caches.
31 | |
32 | */
33 |
34 | 'stores' => [
35 |
36 | 'apc' => [
37 | 'driver' => 'apc',
38 | ],
39 |
40 | 'array' => [
41 | 'driver' => 'array',
42 | 'serialize' => false,
43 | ],
44 |
45 | 'database' => [
46 | 'driver' => 'database',
47 | 'table' => 'cache',
48 | 'connection' => null,
49 | ],
50 |
51 | 'file' => [
52 | 'driver' => 'file',
53 | 'path' => storage_path('framework/cache/data'),
54 | ],
55 |
56 | 'memcached' => [
57 | 'driver' => 'memcached',
58 | 'persistent_id' => env('MEMCACHED_PERSISTENT_ID'),
59 | 'sasl' => [
60 | env('MEMCACHED_USERNAME'),
61 | env('MEMCACHED_PASSWORD'),
62 | ],
63 | 'options' => [
64 | // Memcached::OPT_CONNECT_TIMEOUT => 2000,
65 | ],
66 | 'servers' => [
67 | [
68 | 'host' => env('MEMCACHED_HOST', '127.0.0.1'),
69 | 'port' => env('MEMCACHED_PORT', 11211),
70 | 'weight' => 100,
71 | ],
72 | ],
73 | ],
74 |
75 | 'redis' => [
76 | 'driver' => 'redis',
77 | 'connection' => 'cache',
78 | ],
79 |
80 | 'dynamodb' => [
81 | 'driver' => 'dynamodb',
82 | 'key' => env('AWS_ACCESS_KEY_ID'),
83 | 'secret' => env('AWS_SECRET_ACCESS_KEY'),
84 | 'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
85 | 'table' => env('DYNAMODB_CACHE_TABLE', 'cache'),
86 | 'endpoint' => env('DYNAMODB_ENDPOINT'),
87 | ],
88 |
89 | ],
90 |
91 | /*
92 | |--------------------------------------------------------------------------
93 | | Cache Key Prefix
94 | |--------------------------------------------------------------------------
95 | |
96 | | When utilizing a RAM based store such as APC or Memcached, there might
97 | | be other applications utilizing the same cache. So, we'll specify a
98 | | value to get prefixed to all our keys so we can avoid collisions.
99 | |
100 | */
101 |
102 | 'prefix' => env('CACHE_PREFIX', Str::slug(env('APP_NAME', 'laravel'), '_').'_cache'),
103 |
104 | ];
105 |
--------------------------------------------------------------------------------
/config/mail.php:
--------------------------------------------------------------------------------
1 | env('MAIL_MAILER', 'smtp'),
17 |
18 | /*
19 | |--------------------------------------------------------------------------
20 | | Mailer Configurations
21 | |--------------------------------------------------------------------------
22 | |
23 | | Here you may configure all of the mailers used by your application plus
24 | | their respective settings. Several examples have been configured for
25 | | you and you are free to add your own as your application requires.
26 | |
27 | | Laravel supports a variety of mail "transport" drivers to be used while
28 | | sending an e-mail. You will specify which one you are using for your
29 | | mailers below. You are free to add additional mailers as required.
30 | |
31 | | Supported: "smtp", "sendmail", "mailgun", "ses",
32 | | "postmark", "log", "array"
33 | |
34 | */
35 |
36 | 'mailers' => [
37 | 'smtp' => [
38 | 'transport' => 'smtp',
39 | 'host' => env('MAIL_HOST', 'smtp.mailgun.org'),
40 | 'port' => env('MAIL_PORT', 587),
41 | 'encryption' => env('MAIL_ENCRYPTION', 'tls'),
42 | 'username' => env('MAIL_USERNAME'),
43 | 'password' => env('MAIL_PASSWORD'),
44 | 'timeout' => null,
45 | 'auth_mode' => null,
46 | ],
47 |
48 | 'ses' => [
49 | 'transport' => 'ses',
50 | ],
51 |
52 | 'mailgun' => [
53 | 'transport' => 'mailgun',
54 | ],
55 |
56 | 'postmark' => [
57 | 'transport' => 'postmark',
58 | ],
59 |
60 | 'sendmail' => [
61 | 'transport' => 'sendmail',
62 | 'path' => '/usr/sbin/sendmail -bs',
63 | ],
64 |
65 | 'log' => [
66 | 'transport' => 'log',
67 | 'channel' => env('MAIL_LOG_CHANNEL'),
68 | ],
69 |
70 | 'array' => [
71 | 'transport' => 'array',
72 | ],
73 | ],
74 |
75 | /*
76 | |--------------------------------------------------------------------------
77 | | Global "From" Address
78 | |--------------------------------------------------------------------------
79 | |
80 | | You may wish for all e-mails sent by your application to be sent from
81 | | the same address. Here, you may specify a name and address that is
82 | | used globally for all e-mails that are sent by your application.
83 | |
84 | */
85 |
86 | 'from' => [
87 | 'address' => env('MAIL_FROM_ADDRESS', 'hello@example.com'),
88 | 'name' => env('MAIL_FROM_NAME', 'Example'),
89 | ],
90 |
91 | /*
92 | |--------------------------------------------------------------------------
93 | | Markdown Mail Settings
94 | |--------------------------------------------------------------------------
95 | |
96 | | If you are using Markdown based email rendering, you may configure your
97 | | theme and component paths here, allowing you to customize the design
98 | | of the emails. Or, you may simply stick with the Laravel defaults!
99 | |
100 | */
101 |
102 | 'markdown' => [
103 | 'theme' => 'default',
104 |
105 | 'paths' => [
106 | resource_path('views/vendor/mail'),
107 | ],
108 | ],
109 |
110 | ];
111 |
--------------------------------------------------------------------------------
/config/auth.php:
--------------------------------------------------------------------------------
1 | [
17 | 'guard' => 'web',
18 | 'passwords' => 'users',
19 | ],
20 |
21 | /*
22 | |--------------------------------------------------------------------------
23 | | Authentication Guards
24 | |--------------------------------------------------------------------------
25 | |
26 | | Next, you may define every authentication guard for your application.
27 | | Of course, a great default configuration has been defined for you
28 | | here which uses session storage and the Eloquent user provider.
29 | |
30 | | All authentication drivers have a user provider. This defines how the
31 | | users are actually retrieved out of your database or other storage
32 | | mechanisms used by this application to persist your user's data.
33 | |
34 | | Supported: "session", "token"
35 | |
36 | */
37 |
38 | 'guards' => [
39 | 'web' => [
40 | 'driver' => 'session',
41 | 'provider' => 'users',
42 | ],
43 |
44 | 'api' => [
45 | 'driver' => 'token',
46 | 'provider' => 'users',
47 | 'hash' => false,
48 | ],
49 | ],
50 |
51 | /*
52 | |--------------------------------------------------------------------------
53 | | User Providers
54 | |--------------------------------------------------------------------------
55 | |
56 | | All authentication drivers have a user provider. This defines how the
57 | | users are actually retrieved out of your database or other storage
58 | | mechanisms used by this application to persist your user's data.
59 | |
60 | | If you have multiple user tables or models you may configure multiple
61 | | sources which represent each model / table. These sources may then
62 | | be assigned to any extra authentication guards you have defined.
63 | |
64 | | Supported: "database", "eloquent"
65 | |
66 | */
67 |
68 | 'providers' => [
69 | 'users' => [
70 | 'driver' => 'eloquent',
71 | 'model' => Framework\Models\User::class,
72 | ],
73 |
74 | // 'users' => [
75 | // 'driver' => 'database',
76 | // 'table' => 'users',
77 | // ],
78 | ],
79 |
80 | /*
81 | |--------------------------------------------------------------------------
82 | | Resetting Passwords
83 | |--------------------------------------------------------------------------
84 | |
85 | | You may specify multiple password reset configurations if you have more
86 | | than one user table or model in the application and you want to have
87 | | separate password reset settings based on the specific user types.
88 | |
89 | | The expire time is the number of minutes that the reset token should be
90 | | considered valid. This security feature keeps tokens short-lived so
91 | | they have less time to be guessed. You may change this as needed.
92 | |
93 | */
94 |
95 | 'passwords' => [
96 | 'users' => [
97 | 'provider' => 'users',
98 | 'table' => 'password_resets',
99 | 'expire' => 60,
100 | 'throttle' => 60,
101 | ],
102 | ],
103 |
104 | /*
105 | |--------------------------------------------------------------------------
106 | | Password Confirmation Timeout
107 | |--------------------------------------------------------------------------
108 | |
109 | | Here you may define the amount of seconds before a password confirmation
110 | | times out and the user is prompted to re-enter their password via the
111 | | confirmation screen. By default, the timeout lasts for three hours.
112 | |
113 | */
114 |
115 | 'password_timeout' => 10800,
116 |
117 | ];
118 |
--------------------------------------------------------------------------------
/config/database.php:
--------------------------------------------------------------------------------
1 | env('DB_CONNECTION', 'mysql'),
19 |
20 | /*
21 | |--------------------------------------------------------------------------
22 | | Database Connections
23 | |--------------------------------------------------------------------------
24 | |
25 | | Here are each of the database connections setup for your application.
26 | | Of course, examples of configuring each database platform that is
27 | | supported by Laravel is shown below to make development simple.
28 | |
29 | |
30 | | All database work in Laravel is done through the PHP PDO facilities
31 | | so make sure you have the driver for your particular database of
32 | | choice installed on your machine before you begin development.
33 | |
34 | */
35 |
36 | 'connections' => [
37 |
38 | 'sqlite' => [
39 | 'driver' => 'sqlite',
40 | 'url' => env('DATABASE_URL'),
41 | 'database' => env('DB_DATABASE', database_path('database.sqlite')),
42 | 'prefix' => '',
43 | 'foreign_key_constraints' => env('DB_FOREIGN_KEYS', true),
44 | ],
45 |
46 | 'mysql' => [
47 | 'driver' => 'mysql',
48 | 'url' => env('DATABASE_URL'),
49 | 'host' => env('DB_HOST', '127.0.0.1'),
50 | 'port' => env('DB_PORT', '3306'),
51 | 'database' => env('DB_DATABASE', 'forge'),
52 | 'username' => env('DB_USERNAME', 'forge'),
53 | 'password' => env('DB_PASSWORD', ''),
54 | 'unix_socket' => env('DB_SOCKET', ''),
55 | 'charset' => 'utf8mb4',
56 | 'collation' => 'utf8mb4_unicode_ci',
57 | 'prefix' => '',
58 | 'prefix_indexes' => true,
59 | 'strict' => true,
60 | 'engine' => null,
61 | 'options' => extension_loaded('pdo_mysql') ? array_filter([
62 | PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
63 | ]) : [],
64 | ],
65 |
66 | 'pgsql' => [
67 | 'driver' => 'pgsql',
68 | 'url' => env('DATABASE_URL'),
69 | 'host' => env('DB_HOST', '127.0.0.1'),
70 | 'port' => env('DB_PORT', '5432'),
71 | 'database' => env('DB_DATABASE', 'forge'),
72 | 'username' => env('DB_USERNAME', 'forge'),
73 | 'password' => env('DB_PASSWORD', ''),
74 | 'charset' => 'utf8',
75 | 'prefix' => '',
76 | 'prefix_indexes' => true,
77 | 'schema' => 'public',
78 | 'sslmode' => 'prefer',
79 | ],
80 |
81 | 'sqlsrv' => [
82 | 'driver' => 'sqlsrv',
83 | 'url' => env('DATABASE_URL'),
84 | 'host' => env('DB_HOST', 'localhost'),
85 | 'port' => env('DB_PORT', '1433'),
86 | 'database' => env('DB_DATABASE', 'forge'),
87 | 'username' => env('DB_USERNAME', 'forge'),
88 | 'password' => env('DB_PASSWORD', ''),
89 | 'charset' => 'utf8',
90 | 'prefix' => '',
91 | 'prefix_indexes' => true,
92 | ],
93 |
94 | ],
95 |
96 | /*
97 | |--------------------------------------------------------------------------
98 | | Migration Repository Table
99 | |--------------------------------------------------------------------------
100 | |
101 | | This table keeps track of all the migrations that have already run for
102 | | your application. Using this information, we can determine which of
103 | | the migrations on disk haven't actually been run in the database.
104 | |
105 | */
106 |
107 | 'migrations' => 'migrations',
108 |
109 | /*
110 | |--------------------------------------------------------------------------
111 | | Redis Databases
112 | |--------------------------------------------------------------------------
113 | |
114 | | Redis is an open source, fast, and advanced key-value store that also
115 | | provides a richer body of commands than a typical key-value system
116 | | such as APC or Memcached. Laravel makes it easy to dig right in.
117 | |
118 | */
119 |
120 | 'redis' => [
121 |
122 | 'client' => env('REDIS_CLIENT', 'phpredis'),
123 |
124 | 'options' => [
125 | 'cluster' => env('REDIS_CLUSTER', 'redis'),
126 | 'prefix' => env('REDIS_PREFIX', Str::slug(env('APP_NAME', 'laravel'), '_').'_database_'),
127 | ],
128 |
129 | 'default' => [
130 | 'url' => env('REDIS_URL'),
131 | 'host' => env('REDIS_HOST', '127.0.0.1'),
132 | 'password' => env('REDIS_PASSWORD', null),
133 | 'port' => env('REDIS_PORT', '6379'),
134 | 'database' => env('REDIS_DB', '0'),
135 | ],
136 |
137 | 'cache' => [
138 | 'url' => env('REDIS_URL'),
139 | 'host' => env('REDIS_HOST', '127.0.0.1'),
140 | 'password' => env('REDIS_PASSWORD', null),
141 | 'port' => env('REDIS_PORT', '6379'),
142 | 'database' => env('REDIS_CACHE_DB', '1'),
143 | ],
144 |
145 | ],
146 |
147 | ];
148 |
--------------------------------------------------------------------------------
/src/Data/Repositories/Repository.php:
--------------------------------------------------------------------------------
1 | model = $model;
20 | }
21 |
22 | /**
23 | * Returns the first record in the database.
24 | *
25 | * @return \Illuminate\Database\Eloquent\Model
26 | */
27 | public function first()
28 | {
29 | return $this->model->first();
30 | }
31 |
32 | /**
33 | * Returns all the records.
34 | *
35 | * @return \Illuminate\Database\Eloquent\Collection
36 | */
37 | public function all()
38 | {
39 | return $this->model->all();
40 | }
41 |
42 | /**
43 | * Returns the count of all the records.
44 | *
45 | * @return int
46 | */
47 | public function count()
48 | {
49 | return $this->model->count();
50 | }
51 |
52 | /**
53 | * Returns a range of records bounded by pagination parameters.
54 | *
55 | * @param int limit
56 | * @param int $offset
57 | *
58 | * @return \Illuminate\Database\Eloquent\Collection
59 | */
60 | public function page($limit = 10, $offset = 0, array $relations = [], $orderBy = 'updated_at', $sorting = 'desc')
61 | {
62 | return $this->model->with($relations)->take($limit)->skip($offset)->orderBy($orderBy, $sorting)->get();
63 | }
64 |
65 | /**
66 | * Find a record by its identifier.
67 | *
68 | * @param string $id
69 | * @param array $relations
70 | *
71 | * @return \Illuminate\Database\Eloquent\Model
72 | */
73 | public function find($id, $relations = null)
74 | {
75 | return $this->findBy($this->model->getKeyName(), $id, $relations);
76 | }
77 |
78 | /**
79 | * Find a record by an attribute.
80 | * Fails if no model is found.
81 | *
82 | * @param string $attribute
83 | * @param string $value
84 | * @param array $relations
85 | *
86 | * @return \Illuminate\Database\Eloquent\Model
87 | */
88 | public function findBy($attribute, $value, $relations = null)
89 | {
90 | $query = $this->model->where($attribute, $value);
91 |
92 | if ($relations && is_array($relations)) {
93 | foreach ($relations as $relation) {
94 | $query->with($relation);
95 | }
96 | }
97 |
98 | return $query->firstOrFail();
99 | }
100 |
101 | /**
102 | * Get all records by an associative array of attributes.
103 | * Two operators values are handled: AND | OR.
104 | *
105 | * @param array $attributes
106 | * @param string $operator
107 | * @param array $relations
108 | *
109 | * @return \Illuminate\Support\Collection
110 | */
111 | public function getByAttributes(array $attributes, $operator = 'AND', $relations = null)
112 | {
113 |
114 | // In the following it doesn't matter wivh element to start with, in all cases all attributes will be appended to the
115 | // builder.
116 |
117 | // Get the last value of the associative array
118 | $lastValue = end($attributes);
119 |
120 | // Get the last key of the associative array
121 | $lastKey = key($attributes);
122 |
123 | // Builder
124 | $query = $this->model->where($lastKey, $lastValue);
125 |
126 | // Pop the last key value pair of the associative array now that it has been added to Builder already
127 | array_pop($attributes);
128 |
129 | $method = 'where';
130 |
131 | if (strtoupper($operator) === 'OR') {
132 | $method = 'orWhere';
133 | }
134 |
135 | foreach ($attributes as $key => $value) {
136 | $query->$method($key, $value);
137 | }
138 |
139 | if ($relations && is_array($relations)) {
140 | foreach ($relations as $relation) {
141 | $query->with($relation);
142 | }
143 | }
144 |
145 | return $query->get();
146 | }
147 |
148 | /**
149 | * Fills out an instance of the model
150 | * with $attributes.
151 | *
152 | * @param array $attributes
153 | *
154 | * @return \Illuminate\Database\Eloquent\Model
155 | */
156 | public function fill($attributes)
157 | {
158 | return $this->model->fill($attributes);
159 | }
160 |
161 | /**
162 | * Fills out an instance of the model
163 | * and saves it, pretty much like mass assignment.
164 | *
165 | * @param array $attributes
166 | *
167 | * @return \Illuminate\Database\Eloquent\Model
168 | */
169 | public function fillAndSave($attributes)
170 | {
171 | $this->model->fill($attributes);
172 | $this->model->save();
173 |
174 | return $this->model;
175 | }
176 |
177 | /**
178 | * Remove a selected record.
179 | *
180 | * @param string $key
181 | *
182 | * @return bool
183 | */
184 | public function remove($key)
185 | {
186 | return $this->model->where($this->model->getKeyName(), $key)->delete();
187 | }
188 |
189 | /**
190 | * Implement a convenience call to findBy
191 | * which allows finding by an attribute name
192 | * as follows: findByName or findByAlias.
193 | *
194 | * @param string $method
195 | * @param array $arguments
196 | *
197 | * @return mixed
198 | */
199 | public function __call($method, $arguments)
200 | {
201 | /*
202 | * findBy convenience calling to be available
203 | * through findByName and findByTitle etc.
204 | */
205 |
206 | if (preg_match('/^findBy/', $method)) {
207 | $attribute = strtolower(substr($method, 6));
208 | array_unshift($arguments, $attribute);
209 |
210 | return call_user_func_array(array($this, 'findBy'), $arguments);
211 | }
212 | }
213 | }
214 |
--------------------------------------------------------------------------------
/config/session.php:
--------------------------------------------------------------------------------
1 | env('SESSION_DRIVER', 'file'),
22 |
23 | /*
24 | |--------------------------------------------------------------------------
25 | | Session Lifetime
26 | |--------------------------------------------------------------------------
27 | |
28 | | Here you may specify the number of minutes that you wish the session
29 | | to be allowed to remain idle before it expires. If you want them
30 | | to immediately expire on the browser closing, set that option.
31 | |
32 | */
33 |
34 | 'lifetime' => env('SESSION_LIFETIME', 120),
35 |
36 | 'expire_on_close' => false,
37 |
38 | /*
39 | |--------------------------------------------------------------------------
40 | | Session Encryption
41 | |--------------------------------------------------------------------------
42 | |
43 | | This option allows you to easily specify that all of your session data
44 | | should be encrypted before it is stored. All encryption will be run
45 | | automatically by Laravel and you can use the Session like normal.
46 | |
47 | */
48 |
49 | 'encrypt' => false,
50 |
51 | /*
52 | |--------------------------------------------------------------------------
53 | | Session File Location
54 | |--------------------------------------------------------------------------
55 | |
56 | | When using the native session driver, we need a location where session
57 | | files may be stored. A default has been set for you but a different
58 | | location may be specified. This is only needed for file sessions.
59 | |
60 | */
61 |
62 | 'files' => storage_path('framework/sessions'),
63 |
64 | /*
65 | |--------------------------------------------------------------------------
66 | | Session Database Connection
67 | |--------------------------------------------------------------------------
68 | |
69 | | When using the "database" or "redis" session drivers, you may specify a
70 | | connection that should be used to manage these sessions. This should
71 | | correspond to a connection in your database configuration options.
72 | |
73 | */
74 |
75 | 'connection' => env('SESSION_CONNECTION', null),
76 |
77 | /*
78 | |--------------------------------------------------------------------------
79 | | Session Database Table
80 | |--------------------------------------------------------------------------
81 | |
82 | | When using the "database" session driver, you may specify the table we
83 | | should use to manage the sessions. Of course, a sensible default is
84 | | provided for you; however, you are free to change this as needed.
85 | |
86 | */
87 |
88 | 'table' => 'sessions',
89 |
90 | /*
91 | |--------------------------------------------------------------------------
92 | | Session Cache Store
93 | |--------------------------------------------------------------------------
94 | |
95 | | While using one of the framework's cache driven session backends you may
96 | | list a cache store that should be used for these sessions. This value
97 | | must match with one of the application's configured cache "stores".
98 | |
99 | | Affects: "apc", "dynamodb", "memcached", "redis"
100 | |
101 | */
102 |
103 | 'store' => env('SESSION_STORE', null),
104 |
105 | /*
106 | |--------------------------------------------------------------------------
107 | | Session Sweeping Lottery
108 | |--------------------------------------------------------------------------
109 | |
110 | | Some session drivers must manually sweep their storage location to get
111 | | rid of old sessions from storage. Here are the chances that it will
112 | | happen on a given request. By default, the odds are 2 out of 100.
113 | |
114 | */
115 |
116 | 'lottery' => [2, 100],
117 |
118 | /*
119 | |--------------------------------------------------------------------------
120 | | Session Cookie Name
121 | |--------------------------------------------------------------------------
122 | |
123 | | Here you may change the name of the cookie used to identify a session
124 | | instance by ID. The name specified here will get used every time a
125 | | new session cookie is created by the framework for every driver.
126 | |
127 | */
128 |
129 | 'cookie' => env(
130 | 'SESSION_COOKIE',
131 | Str::slug(env('APP_NAME', 'laravel'), '_').'_session'
132 | ),
133 |
134 | /*
135 | |--------------------------------------------------------------------------
136 | | Session Cookie Path
137 | |--------------------------------------------------------------------------
138 | |
139 | | The session cookie path determines the path for which the cookie will
140 | | be regarded as available. Typically, this will be the root path of
141 | | your application but you are free to change this when necessary.
142 | |
143 | */
144 |
145 | 'path' => '/',
146 |
147 | /*
148 | |--------------------------------------------------------------------------
149 | | Session Cookie Domain
150 | |--------------------------------------------------------------------------
151 | |
152 | | Here you may change the domain of the cookie used to identify a session
153 | | in your application. This will determine which domains the cookie is
154 | | available to in your application. A sensible default has been set.
155 | |
156 | */
157 |
158 | 'domain' => env('SESSION_DOMAIN', null),
159 |
160 | /*
161 | |--------------------------------------------------------------------------
162 | | HTTPS Only Cookies
163 | |--------------------------------------------------------------------------
164 | |
165 | | By setting this option to true, session cookies will only be sent back
166 | | to the server if the browser has a HTTPS connection. This will keep
167 | | the cookie from being sent to you if it can not be done securely.
168 | |
169 | */
170 |
171 | 'secure' => env('SESSION_SECURE_COOKIE'),
172 |
173 | /*
174 | |--------------------------------------------------------------------------
175 | | HTTP Access Only
176 | |--------------------------------------------------------------------------
177 | |
178 | | Setting this value to true will prevent JavaScript from accessing the
179 | | value of the cookie and the cookie will only be accessible through
180 | | the HTTP protocol. You are free to modify this option if needed.
181 | |
182 | */
183 |
184 | 'http_only' => true,
185 |
186 | /*
187 | |--------------------------------------------------------------------------
188 | | Same-Site Cookies
189 | |--------------------------------------------------------------------------
190 | |
191 | | This option determines how your cookies behave when cross-site requests
192 | | take place, and can be used to mitigate CSRF attacks. By default, we
193 | | will set this value to "lax" since this is a secure default value.
194 | |
195 | | Supported: "lax", "strict", "none", null
196 | |
197 | */
198 |
199 | 'same_site' => 'lax',
200 |
201 | ];
202 |
--------------------------------------------------------------------------------
/resources/lang/en/validation.php:
--------------------------------------------------------------------------------
1 | 'The :attribute must be accepted.',
17 | 'active_url' => 'The :attribute is not a valid URL.',
18 | 'after' => 'The :attribute must be a date after :date.',
19 | 'after_or_equal' => 'The :attribute must be a date after or equal to :date.',
20 | 'alpha' => 'The :attribute may only contain letters.',
21 | 'alpha_dash' => 'The :attribute may only contain letters, numbers, dashes and underscores.',
22 | 'alpha_num' => 'The :attribute may only contain letters and numbers.',
23 | 'array' => 'The :attribute must be an array.',
24 | 'before' => 'The :attribute must be a date before :date.',
25 | 'before_or_equal' => 'The :attribute must be a date before or equal to :date.',
26 | 'between' => [
27 | 'numeric' => 'The :attribute must be between :min and :max.',
28 | 'file' => 'The :attribute must be between :min and :max kilobytes.',
29 | 'string' => 'The :attribute must be between :min and :max characters.',
30 | 'array' => 'The :attribute must have between :min and :max items.',
31 | ],
32 | 'boolean' => 'The :attribute field must be true or false.',
33 | 'confirmed' => 'The :attribute confirmation does not match.',
34 | 'date' => 'The :attribute is not a valid date.',
35 | 'date_equals' => 'The :attribute must be a date equal to :date.',
36 | 'date_format' => 'The :attribute does not match the format :format.',
37 | 'different' => 'The :attribute and :other must be different.',
38 | 'digits' => 'The :attribute must be :digits digits.',
39 | 'digits_between' => 'The :attribute must be between :min and :max digits.',
40 | 'dimensions' => 'The :attribute has invalid image dimensions.',
41 | 'distinct' => 'The :attribute field has a duplicate value.',
42 | 'email' => 'The :attribute must be a valid email address.',
43 | 'ends_with' => 'The :attribute must end with one of the following: :values.',
44 | 'exists' => 'The selected :attribute is invalid.',
45 | 'file' => 'The :attribute must be a file.',
46 | 'filled' => 'The :attribute field must have a value.',
47 | 'gt' => [
48 | 'numeric' => 'The :attribute must be greater than :value.',
49 | 'file' => 'The :attribute must be greater than :value kilobytes.',
50 | 'string' => 'The :attribute must be greater than :value characters.',
51 | 'array' => 'The :attribute must have more than :value items.',
52 | ],
53 | 'gte' => [
54 | 'numeric' => 'The :attribute must be greater than or equal :value.',
55 | 'file' => 'The :attribute must be greater than or equal :value kilobytes.',
56 | 'string' => 'The :attribute must be greater than or equal :value characters.',
57 | 'array' => 'The :attribute must have :value items or more.',
58 | ],
59 | 'image' => 'The :attribute must be an image.',
60 | 'in' => 'The selected :attribute is invalid.',
61 | 'in_array' => 'The :attribute field does not exist in :other.',
62 | 'integer' => 'The :attribute must be an integer.',
63 | 'ip' => 'The :attribute must be a valid IP address.',
64 | 'ipv4' => 'The :attribute must be a valid IPv4 address.',
65 | 'ipv6' => 'The :attribute must be a valid IPv6 address.',
66 | 'json' => 'The :attribute must be a valid JSON string.',
67 | 'lt' => [
68 | 'numeric' => 'The :attribute must be less than :value.',
69 | 'file' => 'The :attribute must be less than :value kilobytes.',
70 | 'string' => 'The :attribute must be less than :value characters.',
71 | 'array' => 'The :attribute must have less than :value items.',
72 | ],
73 | 'lte' => [
74 | 'numeric' => 'The :attribute must be less than or equal :value.',
75 | 'file' => 'The :attribute must be less than or equal :value kilobytes.',
76 | 'string' => 'The :attribute must be less than or equal :value characters.',
77 | 'array' => 'The :attribute must not have more than :value items.',
78 | ],
79 | 'max' => [
80 | 'numeric' => 'The :attribute may not be greater than :max.',
81 | 'file' => 'The :attribute may not be greater than :max kilobytes.',
82 | 'string' => 'The :attribute may not be greater than :max characters.',
83 | 'array' => 'The :attribute may not have more than :max items.',
84 | ],
85 | 'mimes' => 'The :attribute must be a file of type: :values.',
86 | 'mimetypes' => 'The :attribute must be a file of type: :values.',
87 | 'min' => [
88 | 'numeric' => 'The :attribute must be at least :min.',
89 | 'file' => 'The :attribute must be at least :min kilobytes.',
90 | 'string' => 'The :attribute must be at least :min characters.',
91 | 'array' => 'The :attribute must have at least :min items.',
92 | ],
93 | 'multiple_of' => 'The :attribute must be a multiple of :value',
94 | 'not_in' => 'The selected :attribute is invalid.',
95 | 'not_regex' => 'The :attribute format is invalid.',
96 | 'numeric' => 'The :attribute must be a number.',
97 | 'password' => 'The password is incorrect.',
98 | 'present' => 'The :attribute field must be present.',
99 | 'regex' => 'The :attribute format is invalid.',
100 | 'required' => 'The :attribute field is required.',
101 | 'required_if' => 'The :attribute field is required when :other is :value.',
102 | 'required_unless' => 'The :attribute field is required unless :other is in :values.',
103 | 'required_with' => 'The :attribute field is required when :values is present.',
104 | 'required_with_all' => 'The :attribute field is required when :values are present.',
105 | 'required_without' => 'The :attribute field is required when :values is not present.',
106 | 'required_without_all' => 'The :attribute field is required when none of :values are present.',
107 | 'same' => 'The :attribute and :other must match.',
108 | 'size' => [
109 | 'numeric' => 'The :attribute must be :size.',
110 | 'file' => 'The :attribute must be :size kilobytes.',
111 | 'string' => 'The :attribute must be :size characters.',
112 | 'array' => 'The :attribute must contain :size items.',
113 | ],
114 | 'starts_with' => 'The :attribute must start with one of the following: :values.',
115 | 'string' => 'The :attribute must be a string.',
116 | 'timezone' => 'The :attribute must be a valid zone.',
117 | 'unique' => 'The :attribute has already been taken.',
118 | 'uploaded' => 'The :attribute failed to upload.',
119 | 'url' => 'The :attribute format is invalid.',
120 | 'uuid' => 'The :attribute must be a valid UUID.',
121 |
122 | /*
123 | |--------------------------------------------------------------------------
124 | | Custom Validation Language Lines
125 | |--------------------------------------------------------------------------
126 | |
127 | | Here you may specify custom validation messages for attributes using the
128 | | convention "attribute.rule" to name the lines. This makes it quick to
129 | | specify a specific custom language line for a given attribute rule.
130 | |
131 | */
132 |
133 | 'custom' => [
134 | 'attribute-name' => [
135 | 'rule-name' => 'custom-message',
136 | ],
137 | ],
138 |
139 | /*
140 | |--------------------------------------------------------------------------
141 | | Custom Validation Attributes
142 | |--------------------------------------------------------------------------
143 | |
144 | | The following language lines are used to swap our attribute placeholder
145 | | with something more reader friendly such as "E-Mail Address" instead
146 | | of "email". This simply helps us make our message more expressive.
147 | |
148 | */
149 |
150 | 'attributes' => [],
151 |
152 | ];
153 |
--------------------------------------------------------------------------------
/config/app.php:
--------------------------------------------------------------------------------
1 | env('APP_NAME', 'Laravel'),
17 |
18 | /*
19 | |--------------------------------------------------------------------------
20 | | Application Environment
21 | |--------------------------------------------------------------------------
22 | |
23 | | This value determines the "environment" your application is currently
24 | | running in. This may determine how you prefer to configure various
25 | | services the application utilizes. Set this in your ".env" file.
26 | |
27 | */
28 |
29 | 'env' => env('APP_ENV', 'production'),
30 |
31 | /*
32 | |--------------------------------------------------------------------------
33 | | Application Debug Mode
34 | |--------------------------------------------------------------------------
35 | |
36 | | When your application is in debug mode, detailed error messages with
37 | | stack traces will be shown on every error that occurs within your
38 | | application. If disabled, a simple generic error page is shown.
39 | |
40 | */
41 |
42 | 'debug' => (bool) env('APP_DEBUG', false),
43 |
44 | /*
45 | |--------------------------------------------------------------------------
46 | | Application URL
47 | |--------------------------------------------------------------------------
48 | |
49 | | This URL is used by the console to properly generate URLs when using
50 | | the Artisan command line tool. You should set this to the root of
51 | | your application so that it is used when running Artisan tasks.
52 | |
53 | */
54 |
55 | 'url' => env('APP_URL', 'http://localhost'),
56 |
57 | 'asset_url' => env('ASSET_URL', null),
58 |
59 | /*
60 | |--------------------------------------------------------------------------
61 | | Application Timezone
62 | |--------------------------------------------------------------------------
63 | |
64 | | Here you may specify the default timezone for your application, which
65 | | will be used by the PHP date and date-time functions. We have gone
66 | | ahead and set this to a sensible default for you out of the box.
67 | |
68 | */
69 |
70 | 'timezone' => 'UTC',
71 |
72 | /*
73 | |--------------------------------------------------------------------------
74 | | Application Locale Configuration
75 | |--------------------------------------------------------------------------
76 | |
77 | | The application locale determines the default locale that will be used
78 | | by the translation service provider. You are free to set this value
79 | | to any of the locales which will be supported by the application.
80 | |
81 | */
82 |
83 | 'locale' => 'en',
84 |
85 | /*
86 | |--------------------------------------------------------------------------
87 | | Application Fallback Locale
88 | |--------------------------------------------------------------------------
89 | |
90 | | The fallback locale determines the locale to use when the current one
91 | | is not available. You may change the value to correspond to any of
92 | | the language folders that are provided through your application.
93 | |
94 | */
95 |
96 | 'fallback_locale' => 'en',
97 |
98 | /*
99 | |--------------------------------------------------------------------------
100 | | Faker Locale
101 | |--------------------------------------------------------------------------
102 | |
103 | | This locale will be used by the Faker PHP library when generating fake
104 | | data for your database seeds. For example, this will be used to get
105 | | localized telephone numbers, street address information and more.
106 | |
107 | */
108 |
109 | 'faker_locale' => 'en_US',
110 |
111 | /*
112 | |--------------------------------------------------------------------------
113 | | Encryption Key
114 | |--------------------------------------------------------------------------
115 | |
116 | | This key is used by the Illuminate encrypter service and should be set
117 | | to a random, 32 character string, otherwise these encrypted strings
118 | | will not be safe. Please do this before deploying an application!
119 | |
120 | */
121 |
122 | 'key' => env('APP_KEY'),
123 |
124 | 'cipher' => 'AES-256-CBC',
125 |
126 | /*
127 | |--------------------------------------------------------------------------
128 | | Autoloaded Service Providers
129 | |--------------------------------------------------------------------------
130 | |
131 | | The service providers listed here will be automatically loaded on the
132 | | request to your application. Feel free to add your own services to
133 | | this array to grant expanded functionality to your applications.
134 | |
135 | */
136 |
137 | 'providers' => [
138 |
139 | /*
140 | * Laravel Framework Service Providers...
141 | */
142 | Illuminate\Auth\AuthServiceProvider::class,
143 | Illuminate\Broadcasting\BroadcastServiceProvider::class,
144 | Illuminate\Bus\BusServiceProvider::class,
145 | Illuminate\Cache\CacheServiceProvider::class,
146 | Illuminate\Foundation\Providers\ConsoleSupportServiceProvider::class,
147 | Illuminate\Cookie\CookieServiceProvider::class,
148 | Illuminate\Database\DatabaseServiceProvider::class,
149 | Illuminate\Encryption\EncryptionServiceProvider::class,
150 | Illuminate\Filesystem\FilesystemServiceProvider::class,
151 | Illuminate\Foundation\Providers\FoundationServiceProvider::class,
152 | Illuminate\Hashing\HashServiceProvider::class,
153 | Illuminate\Mail\MailServiceProvider::class,
154 | Illuminate\Notifications\NotificationServiceProvider::class,
155 | Illuminate\Pagination\PaginationServiceProvider::class,
156 | Illuminate\Pipeline\PipelineServiceProvider::class,
157 | Illuminate\Queue\QueueServiceProvider::class,
158 | Illuminate\Redis\RedisServiceProvider::class,
159 | Illuminate\Auth\Passwords\PasswordResetServiceProvider::class,
160 | Illuminate\Session\SessionServiceProvider::class,
161 | Illuminate\Translation\TranslationServiceProvider::class,
162 | Illuminate\Validation\ValidationServiceProvider::class,
163 | Illuminate\View\ViewServiceProvider::class,
164 |
165 | /*
166 | * Package Service Providers...
167 | */
168 |
169 | /*
170 | * Application Service Providers...
171 | */
172 | Framework\Providers\AppServiceProvider::class,
173 | Framework\Providers\AuthServiceProvider::class,
174 | // Framework\Providers\BroadcastServiceProvider::class,
175 | Framework\Providers\EventServiceProvider::class,
176 | Framework\Providers\RouteServiceProvider::class,
177 |
178 | ],
179 |
180 | /*
181 | |--------------------------------------------------------------------------
182 | | Class Aliases
183 | |--------------------------------------------------------------------------
184 | |
185 | | This array of class aliases will be registered when this application
186 | | is started. However, feel free to register as many as you wish as
187 | | the aliases are "lazy" loaded so they don't hinder performance.
188 | |
189 | */
190 |
191 | 'aliases' => [
192 |
193 | 'App' => Illuminate\Support\Facades\App::class,
194 | 'Arr' => Illuminate\Support\Arr::class,
195 | 'Artisan' => Illuminate\Support\Facades\Artisan::class,
196 | 'Auth' => Illuminate\Support\Facades\Auth::class,
197 | 'Blade' => Illuminate\Support\Facades\Blade::class,
198 | 'Broadcast' => Illuminate\Support\Facades\Broadcast::class,
199 | 'Bus' => Illuminate\Support\Facades\Bus::class,
200 | 'Cache' => Illuminate\Support\Facades\Cache::class,
201 | 'Config' => Illuminate\Support\Facades\Config::class,
202 | 'Cookie' => Illuminate\Support\Facades\Cookie::class,
203 | 'Crypt' => Illuminate\Support\Facades\Crypt::class,
204 | 'DB' => Illuminate\Support\Facades\DB::class,
205 | 'Eloquent' => Illuminate\Database\Eloquent\Model::class,
206 | 'Event' => Illuminate\Support\Facades\Event::class,
207 | 'File' => Illuminate\Support\Facades\File::class,
208 | 'Gate' => Illuminate\Support\Facades\Gate::class,
209 | 'Hash' => Illuminate\Support\Facades\Hash::class,
210 | 'Http' => Illuminate\Support\Facades\Http::class,
211 | 'Lang' => Illuminate\Support\Facades\Lang::class,
212 | 'Log' => Illuminate\Support\Facades\Log::class,
213 | 'Mail' => Illuminate\Support\Facades\Mail::class,
214 | 'Notification' => Illuminate\Support\Facades\Notification::class,
215 | 'Password' => Illuminate\Support\Facades\Password::class,
216 | 'Queue' => Illuminate\Support\Facades\Queue::class,
217 | 'Redirect' => Illuminate\Support\Facades\Redirect::class,
218 | 'Redis' => Illuminate\Support\Facades\Redis::class,
219 | 'Request' => Illuminate\Support\Facades\Request::class,
220 | 'Response' => Illuminate\Support\Facades\Response::class,
221 | 'Route' => Illuminate\Support\Facades\Route::class,
222 | 'Schema' => Illuminate\Support\Facades\Schema::class,
223 | 'Session' => Illuminate\Support\Facades\Session::class,
224 | 'Storage' => Illuminate\Support\Facades\Storage::class,
225 | 'Str' => Illuminate\Support\Str::class,
226 | 'URL' => Illuminate\Support\Facades\URL::class,
227 | 'Validator' => Illuminate\Support\Facades\Validator::class,
228 | 'View' => Illuminate\Support\Facades\View::class,
229 |
230 | ],
231 |
232 | ];
233 |
--------------------------------------------------------------------------------
/resources/views/welcome.blade.php:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 | Laravel
8 |
9 |
10 |
11 |
12 |
13 |
16 |
17 |
22 |
23 |
24 |
25 | @if (Route::has('login'))
26 |
27 | @auth
28 |
Home
29 | @else
30 |
Login
31 |
32 | @if (Route::has('register'))
33 |
Register
34 | @endif
35 | @endif
36 |
37 | @endif
38 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
46 |
47 |
48 |
49 |
50 |
51 |
55 |
56 |
57 |
58 | Laravel has wonderful, thorough documentation covering every aspect of the framework. Whether you are new to the framework or have previous experience with Laravel, we recommend reading all of the documentation from beginning to end.
59 |
60 |
61 |
62 |
63 |
64 |
68 |
69 |
70 |
71 | Laracasts offers thousands of video tutorials on Laravel, PHP, and JavaScript development. Check them out, see for yourself, and massively level up your development skills in the process.
72 |
73 |
74 |
75 |
76 |
77 |
81 |
82 |
83 |
84 | Laravel News is a community driven portal and newsletter aggregating all of the latest and most important news in the Laravel ecosystem, including new package releases and tutorials.
85 |
86 |
87 |
88 |
89 |
90 |
91 |
92 |
Vibrant Ecosystem
93 |
94 |
95 |
96 |
97 | Laravel's robust library of first-party tools and libraries, such as
Forge ,
Vapor ,
Nova , and
Envoyer help you take your projects to the next level. Pair them with powerful open source libraries like
Cashier ,
Dusk ,
Echo ,
Horizon ,
Sanctum ,
Telescope , and more.
98 |
99 |
100 |
101 |
102 |
103 |
104 |
105 |
124 |
125 |
126 | Build v{{ Illuminate\Foundation\Application::VERSION }}
127 |
128 |
129 |
130 |
131 |
132 |
133 |
--------------------------------------------------------------------------------
/readme.md:
--------------------------------------------------------------------------------
1 | ## Lucid
2 |
3 | The Lucid Architecture is a software architecture that consolidates code-base maintenance as the application scales,
4 | from becoming overwhelming to handle, gets us rid of rotting code that will later become legacy code, and translate
5 | the day-to-day language such as Feature and Service into actual, physical code.
6 |
7 | Read more about the [Lucid Architecture Concept](https://medium.com/vine-lab/the-lucid-architecture-concept-ad8e9ed0258f).
8 |
9 | If you prefer a video, watch the announcement of The Lucid Architecture at LaraconEU 2016:
10 |
11 | ##### The Lucid Architecture for Building Scalable Applications - Laracon EU 2016
12 | [](http://www.youtube.com/watch?v=wSnM4JkyxPw "Abed Halawi - The Lucid Architecture for Building Scalable Applications")
13 |
14 |
15 | ### Join The Community on Slack
16 | [](https://lucid-slack.herokuapp.com)
17 |
18 | ## Index
19 | - [Installation](#installation)
20 | - [Introduction](#introduction)
21 | - [Components](#components)
22 | - [Service](#service)
23 | - [Feature](#feature)
24 | - [Job](#job)
25 | - [Data](#data)
26 | - [Foundation](#foundation)
27 | - [Getting Started](#getting-started)
28 | - [Microservices](#microservices)
29 |
30 | ## Installation
31 |
32 | ### 8.x
33 | To start your project with Lucid right away, run the following command:
34 |
35 | ```
36 | composer create-project lucid-arch/laravel my-project
37 | ```
38 |
39 | This will give you a Laravel 8 installation with Lucid out-of-the-box. If you wish to download other versions of Laravel you may specify it as well:
40 |
41 |
42 | #### 7.x
43 |
44 | ```
45 | composer create-project lucid-arch/laravel=7.x my-project-7.x
46 | ```
47 |
48 | ##### 6.x
49 | ```
50 | composer create-project lucid-arch/laravel=6.x my-project-6.x
51 | ```
52 |
53 | ##### 5.5
54 | ```
55 | composer create-project lucid-arch/laravel=5.5.x my-project-5.5
56 | ```
57 |
58 | ## Introduction
59 |
60 | ### Directory Structure
61 | ```
62 | src
63 | ├── Data
64 | ├── Domains
65 | └── * domain name *
66 | ├── Jobs
67 | ├── Foundation
68 | └── Services
69 | └── * service name *
70 | ├── Console
71 | ├── Features
72 | ├── Http
73 | ├── Providers
74 | ├── Tests
75 | ├── database
76 | └── resources
77 | ```
78 |
79 | ### Components
80 | | Component | Path | Description |
81 | |---------|--------| ----------- |
82 | | Service | src/Service/[service] | Place for the [Services](#service) |
83 | | Feature | src/Services/[service]/Features/[feature] | Place for the [Features](#feature) of [Services](#service) |
84 | | Job | src/Domains/[domain]/Jobs/[job] | Place for the [Jobs](#job) that expose the functionalities of Domains |
85 | | Data | src/Data | Place for models, repositories, value objects and anything data-related |
86 | | Foundation | src/Foundation | Place for foundational (abstract) elements used across the application |
87 |
88 |
89 | #### Service
90 | Each part of an application is a service (i.e. Api, Web, Backend). Typically, each of these will have their way of
91 | handling and responding to requests, implementing different features of our application, hence, each of them will have
92 | their own routes, controllers, features and operations. A Service will seem like a sub-installation of a Laravel
93 | application, though it is just a logical grouping than anything else.
94 |
95 | To better understand the concept behind Services, think of the terminology as:
96 | "Our application exposes data through an Api service", "You can manipulate and manage the data through the Backend service".
97 |
98 | One other perk of using Lucid is that it makes the transition process to a Microservices architecture simpler,
99 | when the application requires it. See [Microservices](#microservices).
100 |
101 | ##### Service Directory Structure
102 |
103 | Imagine we have generated a service called **Api**, can be done using the `lucid` cli by running:
104 |
105 | > You might want to [Setup](#setup) to be able to use the `lucid` command.
106 |
107 | ```
108 | lucid make:service api
109 | ```
110 |
111 | We will get the following directory structure:
112 |
113 | ```
114 | src
115 | └── Services
116 | └── Api
117 | ├── Console
118 | ├── Features
119 | ├── Http
120 | │ ├── Controllers
121 | │ ├── Middleware
122 | │ ├── Requests
123 | │ └── routes.php
124 | ├── Providers
125 | │ ├── ApiServiceProvider.php
126 | │ └── RouteServiceProvider.php
127 | ├── Tests
128 | │ └── Features
129 | ├── database
130 | │ ├── migrations
131 | │ └── seeds
132 | └── resources
133 | ├── lang
134 | └── views
135 | └── welcome.blade.php
136 | ```
137 |
138 | #### Feature
139 |
140 | A Feature is exactly what a feature is in our application (think Login feature, Search for hotel feature, etc.) as a class.
141 | Features are what the Services' controllers will serve, so our controllers will end up having only one line in our methods, hence,
142 | the thinnest controllers ever! Here's an example of generating a feature and serving it through a controller:
143 |
144 | > You might want to [Setup](#setup) to be able to use the `lucid` command.
145 |
146 | > IMPORTANT! You need at least one service to be able to host your features. In this example we are using the Api
147 | service generated previously, referred to as `api` in the commands.
148 |
149 | ```
150 | lucid make:feature SearchUsers api
151 | ```
152 |
153 | And we will have `src/Services/Api/Features/SearchUsersFeature.php` and its test `src/Services/Api/Tests/Features/SearchUsersFeatureTest.php`.
154 |
155 | Inside the Feature class, there's a `handle` method which is the method that will be called when we dispatch that feature,
156 | and it supports dependency injection, which is the perfect place to define your dependencies.
157 |
158 | Now we need a controller to serve that feature:
159 | ```
160 | lucid make:controller user api
161 | ```
162 |
163 | And our `UserController` is in `src/Services/Api/Http/Controllers/UserController.php` and to serve that feature,
164 | in a controller method we need to call its `serve` method as such:
165 |
166 | ```
167 | namespace App\Services\Api\Http\Controllers;
168 |
169 | use App\Services\Api\Features\SearchUsersFeature;
170 |
171 | class UserController extends Controller
172 | {
173 | public function index()
174 | {
175 | return $this->serve(SearchUsersFeature::class);
176 | }
177 | }
178 | ```
179 | #### Views
180 | To access a service's view file, prepend the file's name with the service name followed by two colons `::`
181 |
182 | Example extending view file in blade:
183 | ```
184 | @extends('servicename::index')
185 | ```
186 |
187 | Usage with jobs is similar:
188 | ```php
189 | new RespondWithViewJob('servicename::user.login')
190 | ```
191 |
192 | `RespondWithJsonJob` accepts the following parameters:
193 | ```php
194 | RespondWithViewJob($template, $data = [], $status = 200, array $headers = []);
195 | ```
196 |
197 | Usage of template with data:
198 | ```php
199 | $this->run(new RespondWithViewJob('servicename::user.list', ['users' => $users]));
200 | ```
201 | Or
202 | ```php
203 | $this->run(RespondWithViewJob::class, [
204 | 'template' => 'servicename::user.list',
205 | 'data' => [
206 | 'users' => $users
207 | ],
208 | ]);
209 | ```
210 |
211 | #### Job
212 | A Job is responsible for one element of execution in the application, and play the role of a step in the accomplishment
213 | of a feature. They are the stewards of reusability in our code.
214 |
215 | Jobs live inside Domains, which requires them to be abstract, isolated and independent from any other job be it
216 | in the same domain or another - whatever the case, no Job should dispatch another Job.
217 |
218 | They can be ran by any Feature from any Service, and it is the *only way* of communication between services and domains.
219 |
220 | *Example:* Our `SearchUsersFeature` has to perform the following steps:
221 |
222 | - Validate user search query
223 | - Log the query somewhere we can look at later
224 | - If results were found
225 | - Log the results for later reference (async)
226 | - Increment the number of searches on the found elements (async)
227 | - Return results
228 | - If no results were found
229 | - Log the query in a "high priority" log so that it can be given more attention
230 |
231 | Each of these steps will have a job in its name, implementing only that step. They must be generated in their corresponding
232 | domains that they implement the functionality of, i.e. our `ValidateUserSearchQueryJob` has to do with user input,
233 | hence it should be in the `User` domain. While logging has nothing to do with users and might be used in several other
234 | places so it gets a domain of its own and we generate the `LogSearchResultsJob` in that `Log` domain.
235 |
236 | To generate a Job, use the `make:job ` command:
237 |
238 | ```
239 | lucid make:job SearchUsersByName user
240 | ```
241 |
242 | Similar to Features, Jobs also implement the `handle` method that gets its dependencies resolved, but sometimes
243 | we might want to pass in input that doesn't necessarily have to do with dependencies, those are the params of the job's
244 | constructor, specified here in `src/Domains/User/Jobs/SearchUsersByNameJob.php`:
245 |
246 | ```php
247 | namespace App\Domains\User\Jobs;
248 |
249 | use Lucid\Foundation\Job;
250 |
251 | class SearchUsersByNameJob extends Job
252 | {
253 | private $query;
254 | private $limit;
255 |
256 | public function __construct($query, $limit = 25)
257 | {
258 | $this->query = $query;
259 | $this->limit = $limit;
260 | }
261 |
262 | public function handle(User $user)
263 | {
264 | return $user->where('name', $this->query)->take($this->limit)->get();
265 | }
266 | }
267 | ```
268 |
269 | Now we need to run this and the rest of the steps we mentioned in `SearchUsersFeature::handle`:
270 |
271 | ```php
272 | public function handle(Request $request)
273 | {
274 | // validate input - if not valid the validator should
275 | // throw an exception of InvalidArgumentException
276 | $this->run(new ValidateUserSearchQueryJob($request->input()));
277 |
278 | $results = $this->run(SearchUsersJob::class, [
279 | 'query' => $request->input('query'),
280 | ]);
281 |
282 | if (empty($results)) {
283 | $this->run(LogEmptySearchResultsJob::class, [
284 | 'date' => new DateTime(),
285 | 'query' => $request->query(),
286 | ]);
287 |
288 | $response = $this->run(new RespondWithJsonErrorJob('No users found'));
289 | } else {
290 | // this job is queueable so it will automatically get queued
291 | // and dispatched later.
292 | $this->run(LogUserSearchJob::class, [
293 | 'date' => new DateTime(),
294 | 'query' => $request->input(),
295 | 'results' => $results->lists('id'), // only the ids of the results are required
296 | ]);
297 |
298 | $response = $this->run(new RespondWithJsonJob($results));
299 | }
300 |
301 | return $response;
302 | }
303 | ```
304 |
305 | As you can see, the sequence of steps is clearly readable with the least effort possible when following each `$this->run`
306 | call, and the signatures of each Job are easy to understand.
307 |
308 | A few things to note regarding the implementation above:
309 |
310 | - There is no difference between running a job by instantiating it like `$this->run(new SomeJob)` and
311 | passing its class name `$this->run(SomeJob::class)`
312 | it is simply a personal preference for readability and writing less code, when a Job takes only one parameter
313 | it's instantiated.
314 | - The order of parameters that we use when calling a job with its class name is irrelevant to their order in the
315 | Job's constructor signature. i.e.
316 | ```php
317 | $this->run(LogUserSearchJob::class, [
318 | 'date' => new DateTime(),
319 | 'query' => $request->input(),
320 | 'resultIds' => $results->lists('id'), // only the ids of the results are required
321 | ]);
322 | ```
323 | ```php
324 | class LogUserSearchJob
325 | {
326 | public function __construct($query, array $resultIds, DateTime $date)
327 | {
328 | // ...
329 | }
330 | }
331 | ```
332 | This will work perfectly fine, as long as the key name (`'resultIds' => ...`) is the same as the variable's name in the constructor (`$resultIds`)
333 | - Of course, we need to create and import (`use`) our Job classes with the correct namespaces, but we won't do that here
334 | since this is only to showcase and not intended to be running, for a working example see [Getting Started](#getting-started).
335 |
336 | ## Data
337 | Data is not really a component, more like a directory for all your data-related classes such as Models, Repositories,
338 | Value Objects and anything that has to do with data (algorithms etc.).
339 |
340 | ## Foundation
341 | This is a place for foundational elements that act as the most abstract classes that do not belong in any of the
342 | components, currently holds the `ServiceProvider` which is the link between the services and the framework (Laravel).
343 | You might never need or use this directory for anything else, but in case you encountered a case where a class
344 | needs to be shared across all components and does belong in any, feel free to use this one.
345 |
346 | Every service must be registered inside the foundation's service provider after being created for Laravel to know about it,
347 | simply add `$this->app->register([service name]ServiceProvider::class);` to the `register` methods of the
348 | foundation's `ServiceProvider`. For example, with an Api Service:
349 |
350 | ```php
351 | // ...
352 | use App\Services\Api\Providers\ApiServiceProvider;
353 | // ...
354 | public function register()
355 | {
356 | $this->app->register(ApiServiceProvider::class);
357 | }
358 | ```
359 |
360 | ## Getting Started
361 | This project ships with the [Lucid Console](https://github.com/lucid-architecture/laravel-console) which provides an interactive
362 | user interface and a command line interface that are useful for scaffolding and exploring Services, Features, and Jobs.
363 |
364 | ### Setup
365 | The `lucid` executable will be in `vendor/bin`. If you don't have `./vendor/bin/` as part of your `PATH` you will
366 | need to execute it using `./vendor/bin/lucid`, otherwise add it with the following command to be able to simply
367 | call `lucid`:
368 |
369 | ```
370 | export PATH="./vendor/bin:$PATH"
371 | ```
372 |
373 | For a list of all the commands that are available run `lucid` or see the [CLI Reference](https://github.com/lucid-architecture/laravel-console).
374 |
375 | #### Launching the Interactive Console (UI)
376 |
377 | 1. Serve Application
378 | One way is to use the built-in server by running:
379 | ```bash
380 | php artisan serve
381 | ```
382 | > Any other method would also work (Apache, Nginx, etc...)
383 | 2. Run `php artisan vendor:publish --provider="Lucid\Console\LucidServiceProvider"`
384 | 3. Visit your application at */lucid/dashboard*
385 |
386 | ### 1. Create a Service
387 |
388 | ##### CLI
389 | ```
390 | lucid make:service Api
391 | ```
392 |
393 | ##### UI
394 |
395 |
396 |
397 | Using one of the methods above, a new service folder must've been created under `src/Services` with the name `Api`.
398 |
399 | The **Api** directory will initially contain the following directories:
400 |
401 | ```
402 | src/Services/Api
403 | ├── Console # Everything that has to do with the Console (i.e. Commands)
404 | ├── Features # Contains the Api's Features classes
405 | ├── Http # Routes, controllers and middlewares
406 | ├── Providers # Service providers and binding
407 | ├── database # Database migrations and seeders
408 | └── resources # Assets, Lang and Views
409 | ```
410 |
411 | One more step is required for Laravel to recognize the service we just created.
412 |
413 | #### Register Service
414 |
415 | - Open `src/Foundation/Providers/ServiceProvider`
416 | - Add `use App\Services\Api\Providers\ApiServiceProvider`
417 | - In the `register` method add `$this->app->register(ApiServiceProvider::class)`
418 |
419 | ### 2. Create a Feature
420 |
421 | ##### CLI
422 | ```
423 | lucid make:feature ListUsers api
424 | ```
425 |
426 | ##### UI
427 |
428 | Using one of the methods above, the new Feature can be found at `src/Services/Api/Features/ListUsersFeature.php`.
429 | Now you can fill up a bunch of jobs in its `handle` method.
430 |
431 | ### 3. Create a Job
432 | This project ships with a couple of jobs that can be found in their corresponding domains under `src/Domains`
433 |
434 | ##### CLI
435 | ```
436 | lucid make:job GetUsers user
437 | ```
438 |
439 | ##### UI
440 |
441 | Using one of the methods above, the new Job can be found at `src/Domains/User/Jobs/GetUsers` and now you can fill
442 | it with functionality in the `handle` method. For this example we will just add a static `return` statement:
443 |
444 | ```php
445 | public function handle()
446 | {
447 | return [
448 | ['name' => 'John Doe'],
449 | ['name' => 'Jane Doe'],
450 | ['name' => 'Tommy Atkins'],
451 | ];
452 | }
453 | ```
454 |
455 | ### 4. All Together
456 | Back to the Feature we generated earlier, add `$this->run(GetUsersJob)` (remember to `use` the job with the correct
457 | namespace `App\Domains\User\Jobs\GetUsersJob`).
458 |
459 | ##### Run The Job
460 | In **ListUsersFeature::handle(Request $request)**
461 |
462 | ```php
463 | public function handle(Request $request)
464 | {
465 | $users = $this->run(GetUsersJob::class);
466 |
467 | return $this->run(new RespondWithJsonJob($users));
468 | }
469 | ```
470 |
471 | The `RespondWithJsonJob` is one of the Jobs that were shipped with this project, it lives in the `Http` domain and is
472 | used to respond to a request in a structured JSON format.
473 |
474 | ##### Serve The Feature
475 | To be able to serve that Feature we need to create a route and a controller that does so.
476 |
477 | Generate a plain controller with the following command
478 |
479 | ```
480 | lucid make:controller user api --plain
481 | ```
482 |
483 | Add the `get` method to it:
484 |
485 | ```php
486 | class UserController extends Controller
487 | {
488 | public function get()
489 | {
490 | return $this->serve(ListUsersFeature::class);
491 | }
492 | }
493 | ```
494 |
495 | We just need to create a route that would delegate the request to our `get` method:
496 |
497 | In `src/Services/Api/Http/routes.php` you will find the route group `Route::group(['prefix' => 'api'], function() {...`
498 | Add the `/users` route within that group.
499 |
500 | ```php
501 | Route::get('/users', 'UserController@get');
502 | ```
503 |
504 | Now if you visit `/api/users` you should see the JSON structure.
505 |
506 | ## Microservices
507 | If you have been hearing about microservices lately, and wondering how that works and would like to plan your next project
508 | based on microservices, or build your application armed and ready for the shift when it occurs, Lucid is your best bet.
509 | It has been designed with scale at the core and the microservice transition in mind, it is no coincidence that the
510 | different parts of the application that will (most probably) later on become the different services with the microservice
511 | architecture are called **Service**. However, [it is recommended](http://martinfowler.com/bliki/MonolithFirst.html)
512 | that only when your monolith application grow so large that it becomes crucial to use microservices for the sake of
513 | the progression and maintenance of the project, to do the shift; because once you've built your application using Lucid,
514 | the transition to a microservice architecture will be logically simpler to plan and physically straight-forward
515 | to implement. There is a [microservice counterpart](https://github.com/lucid-architecture/laravel-microservice)
516 | to Lucid that you can check out [here](https://github.com/lucid-architecture/laravel-microservice).
517 |
518 | With more on the means of transitioning from a monolith to a microservice.
519 |
520 | ### Event Hooks
521 |
522 | Lucid exposes event hooks that allow you to listen on each dispatched feature, operation or job. This is especially useful for tracing:
523 |
524 | ```php
525 | use Illuminate\Support\Facades\Event;
526 | use Lucid\Foundation\Events\FeatureStarted;
527 | use Lucid\Foundation\Events\OperationStarted;
528 | use Lucid\Foundation\Events\JobStarted;
529 |
530 | Event::listen(FeatureStarted::class, function (FeatureStarted $event) {
531 | // $event->name
532 | // $event->arguments
533 | });
534 |
535 | Event::listen(OperationStarted::class, function (OperationStarted $event) {
536 | // $event->name
537 | // $event->arguments
538 | });
539 |
540 | Event::listen(JobStarted::class, function (JobStarted $event) {
541 | // $event->name
542 | // $event->arguments
543 | });
544 | ```
545 |
--------------------------------------------------------------------------------