├── src ├── public │ ├── favicon.ico │ ├── robots.txt │ ├── .htaccess │ └── index.php ├── resources │ ├── css │ │ └── app.css │ ├── js │ │ ├── app.js │ │ └── bootstrap.js │ └── views │ │ ├── post.blade.php │ │ └── welcome.blade.php ├── database │ ├── .gitignore │ ├── seeders │ │ └── DatabaseSeeder.php │ ├── migrations │ │ ├── 2023_07_19_225321_create_posts_table.php │ │ ├── 2023_08_09_051124_create_customer_mongo_db_table.php │ │ ├── 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 │ │ ├── 2023_08_03_202445_create_customer_s_q_l_s_table.php │ │ └── 2019_12_14_000001_create_personal_access_tokens_table.php │ └── factories │ │ └── UserFactory.php ├── bootstrap │ ├── cache │ │ └── .gitignore │ └── app.php ├── storage │ ├── logs │ │ └── .gitignore │ ├── app │ │ ├── public │ │ │ └── .gitignore │ │ └── .gitignore │ └── framework │ │ ├── sessions │ │ └── .gitignore │ │ ├── testing │ │ └── .gitignore │ │ ├── views │ │ └── .gitignore │ │ ├── cache │ │ ├── data │ │ │ └── .gitignore │ │ └── .gitignore │ │ └── .gitignore ├── .gitattributes ├── tests │ ├── TestCase.php │ ├── Unit │ │ └── ExampleTest.php │ ├── Feature │ │ └── ExampleTest.php │ └── CreatesApplication.php ├── .styleci.yml ├── app │ ├── Models │ │ ├── Author.php │ │ ├── Book.php │ │ ├── CustomerMongoDB.php │ │ ├── CustomerSQL.php │ │ ├── Post.php │ │ └── User.php │ ├── Http │ │ ├── Middleware │ │ │ ├── EncryptCookies.php │ │ │ ├── VerifyCsrfToken.php │ │ │ ├── PreventRequestsDuringMaintenance.php │ │ │ ├── TrustHosts.php │ │ │ ├── TrimStrings.php │ │ │ ├── Authenticate.php │ │ │ ├── TrustProxies.php │ │ │ └── RedirectIfAuthenticated.php │ │ ├── Controllers │ │ │ ├── Controller.php │ │ │ └── PostController.php │ │ └── Kernel.php │ ├── Providers │ │ ├── BroadcastServiceProvider.php │ │ ├── AppServiceProvider.php │ │ ├── AuthServiceProvider.php │ │ ├── EventServiceProvider.php │ │ └── RouteServiceProvider.php │ ├── Console │ │ └── Kernel.php │ └── Exceptions │ │ └── Handler.php ├── .gitignore ├── .editorconfig ├── init_repo.sh ├── package.json ├── lang │ ├── en │ │ ├── pagination.php │ │ ├── auth.php │ │ ├── passwords.php │ │ └── validation.php │ └── en.json ├── webpack.mix.js ├── routes │ ├── channels.php │ ├── console.php │ ├── web.php │ └── api.php ├── config │ ├── cors.php │ ├── services.php │ ├── view.php │ ├── hashing.php │ ├── broadcasting.php │ ├── sanctum.php │ ├── filesystems.php │ ├── queue.php │ ├── cache.php │ ├── mail.php │ ├── auth.php │ ├── logging.php │ ├── database.php │ ├── session.php │ └── app.php ├── phpunit.xml ├── .env.example ├── artisan └── composer.json ├── .devcontainer ├── .gitignore ├── .docker │ ├── php │ │ ├── docker-php.ini │ │ ├── xdebug.ini │ │ └── Dockerfile │ └── nginx │ │ └── conf.d │ │ ├── error_reporting.ini │ │ └── nginx-webserver.conf ├── .env ├── devcontainer.json └── docker-compose.yml ├── DockerSetup.md ├── .vscode └── launch.json └── README.md /src/public/favicon.ico: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /src/resources/css/app.css: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /src/database/.gitignore: -------------------------------------------------------------------------------- 1 | *.sqlite* 2 | -------------------------------------------------------------------------------- /.devcontainer/.gitignore: -------------------------------------------------------------------------------- 1 | /data/ 2 | /www/ -------------------------------------------------------------------------------- /src/bootstrap/cache/.gitignore: -------------------------------------------------------------------------------- 1 | * 2 | !.gitignore 3 | -------------------------------------------------------------------------------- /src/public/robots.txt: -------------------------------------------------------------------------------- 1 | User-agent: * 2 | Disallow: 3 | -------------------------------------------------------------------------------- /src/resources/js/app.js: -------------------------------------------------------------------------------- 1 | require('./bootstrap'); 2 | -------------------------------------------------------------------------------- /src/storage/logs/.gitignore: -------------------------------------------------------------------------------- 1 | * 2 | !.gitignore 3 | -------------------------------------------------------------------------------- /.devcontainer/.docker/php/docker-php.ini: -------------------------------------------------------------------------------- 1 | # hubert stuff -------------------------------------------------------------------------------- /src/storage/app/public/.gitignore: -------------------------------------------------------------------------------- 1 | * 2 | !.gitignore 3 | -------------------------------------------------------------------------------- /src/storage/app/.gitignore: -------------------------------------------------------------------------------- 1 | * 2 | !public/ 3 | !.gitignore 4 | -------------------------------------------------------------------------------- /src/storage/framework/sessions/.gitignore: -------------------------------------------------------------------------------- 1 | * 2 | !.gitignore 3 | -------------------------------------------------------------------------------- /src/storage/framework/testing/.gitignore: -------------------------------------------------------------------------------- 1 | * 2 | !.gitignore 3 | -------------------------------------------------------------------------------- /src/storage/framework/views/.gitignore: -------------------------------------------------------------------------------- 1 | * 2 | !.gitignore 3 | -------------------------------------------------------------------------------- /src/storage/framework/cache/data/.gitignore: -------------------------------------------------------------------------------- 1 | * 2 | !.gitignore 3 | -------------------------------------------------------------------------------- /src/storage/framework/cache/.gitignore: -------------------------------------------------------------------------------- 1 | * 2 | !data/ 3 | !.gitignore 4 | -------------------------------------------------------------------------------- /.devcontainer/.docker/nginx/conf.d/error_reporting.ini: -------------------------------------------------------------------------------- 1 | error_reporting=E_ALL -------------------------------------------------------------------------------- /src/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 | -------------------------------------------------------------------------------- /src/.gitattributes: -------------------------------------------------------------------------------- 1 | * text=auto 2 | 3 | *.blade.php diff=html 4 | *.css diff=css 5 | *.html diff=html 6 | *.md diff=markdown 7 | *.php diff=php 8 | 9 | /.github export-ignore 10 | CHANGELOG.md export-ignore 11 | -------------------------------------------------------------------------------- /src/tests/TestCase.php: -------------------------------------------------------------------------------- 1 | assertTrue(true); 17 | } 18 | } 19 | -------------------------------------------------------------------------------- /src/app/Http/Middleware/EncryptCookies.php: -------------------------------------------------------------------------------- 1 | 13 | */ 14 | protected $except = [ 15 | // 16 | ]; 17 | } 18 | -------------------------------------------------------------------------------- /src/app/Http/Middleware/VerifyCsrfToken.php: -------------------------------------------------------------------------------- 1 | 13 | */ 14 | protected $except = [ 15 | // 16 | ]; 17 | } 18 | -------------------------------------------------------------------------------- /src/app/Http/Controllers/Controller.php: -------------------------------------------------------------------------------- 1 | create(); 18 | } 19 | } 20 | -------------------------------------------------------------------------------- /src/init_repo.sh: -------------------------------------------------------------------------------- 1 | #!/bin/sh 2 | 3 | # Navigate to your application directory 4 | cd /var/www/htdoc 5 | 6 | # displays the current path, for debugging 7 | # pwd 8 | 9 | # Check if the vendor directory does not exist 10 | if [ ! -d "vendor" ]; then 11 | # Run composer install 12 | composer install 13 | cp .env.example .env 14 | php artisan key:generate 15 | fi 16 | 17 | # Then, execute the main command, e.g., starting PHP-FPM 18 | # exec php-fpm 19 | -------------------------------------------------------------------------------- /src/app/Http/Middleware/PreventRequestsDuringMaintenance.php: -------------------------------------------------------------------------------- 1 | 13 | */ 14 | protected $except = [ 15 | // 16 | ]; 17 | } 18 | -------------------------------------------------------------------------------- /src/app/Http/Middleware/TrustHosts.php: -------------------------------------------------------------------------------- 1 | 13 | */ 14 | public function hosts() 15 | { 16 | return [ 17 | $this->allSubdomainsOfApplicationUrl(), 18 | ]; 19 | } 20 | } 21 | -------------------------------------------------------------------------------- /src/app/Http/Middleware/TrimStrings.php: -------------------------------------------------------------------------------- 1 | 13 | */ 14 | protected $except = [ 15 | 'current_password', 16 | 'password', 17 | 'password_confirmation', 18 | ]; 19 | } 20 | -------------------------------------------------------------------------------- /src/tests/Feature/ExampleTest.php: -------------------------------------------------------------------------------- 1 | get('/'); 18 | 19 | $response->assertStatus(200); 20 | } 21 | } 22 | -------------------------------------------------------------------------------- /src/tests/CreatesApplication.php: -------------------------------------------------------------------------------- 1 | make(Kernel::class)->bootstrap(); 19 | 20 | return $app; 21 | } 22 | } 23 | -------------------------------------------------------------------------------- /src/app/Providers/BroadcastServiceProvider.php: -------------------------------------------------------------------------------- 1 | first(); 16 | 17 | // generated the view defined in [/resources/views]/post.blade.php 18 | return view('post', [ 'post_data' => $query_result ]); 19 | } 20 | } 21 | -------------------------------------------------------------------------------- /src/package.json: -------------------------------------------------------------------------------- 1 | { 2 | "private": true, 3 | "scripts": { 4 | "dev": "npm run development", 5 | "development": "mix", 6 | "watch": "mix watch", 7 | "watch-poll": "mix watch -- --watch-options-poll=1000", 8 | "hot": "mix watch --hot", 9 | "prod": "npm run production", 10 | "production": "mix --production" 11 | }, 12 | "devDependencies": { 13 | "axios": "^0.25", 14 | "laravel-mix": "^6.0.6", 15 | "lodash": "^4.17.19", 16 | "postcss": "^8.1.14" 17 | } 18 | } 19 | -------------------------------------------------------------------------------- /src/app/Providers/AppServiceProvider.php: -------------------------------------------------------------------------------- 1 | expectsJson()) { 18 | return route('login'); 19 | } 20 | } 21 | } 22 | -------------------------------------------------------------------------------- /src/lang/en/pagination.php: -------------------------------------------------------------------------------- 1 | '« Previous', 17 | 'next' => 'Next »', 18 | 19 | ]; 20 | -------------------------------------------------------------------------------- /src/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 | -------------------------------------------------------------------------------- /src/routes/channels.php: -------------------------------------------------------------------------------- 1 | id === (int) $id; 18 | }); 19 | -------------------------------------------------------------------------------- /src/app/Models/CustomerMongoDB.php: -------------------------------------------------------------------------------- 1 | comment(Inspiring::quote()); 19 | })->purpose('Display an inspiring quote'); 20 | -------------------------------------------------------------------------------- /src/lang/en.json: -------------------------------------------------------------------------------- 1 | { 2 | "The :attribute must contain at least one letter.": "The :attribute must contain at least one letter.", 3 | "The :attribute must contain at least one number.": "The :attribute must contain at least one number.", 4 | "The :attribute must contain at least one symbol.": "The :attribute must contain at least one symbol.", 5 | "The :attribute must contain at least one uppercase and one lowercase letter.": "The :attribute must contain at least one uppercase and one lowercase letter.", 6 | "The given :attribute has appeared in a data leak. Please choose a different :attribute.": "The given :attribute has appeared in a data leak. Please choose a different :attribute." 7 | } 8 | -------------------------------------------------------------------------------- /src/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 | -------------------------------------------------------------------------------- /DockerSetup.md: -------------------------------------------------------------------------------- 1 | # proposed directory structure to integrate Docker and .devcontainer 2 | 3 | /repository-root 4 | │ 5 | ├── .devcontainer/ 6 | │ ├── devcontainer.json 7 | │ └── Dockerfile 8 | │ 9 | ├── docker/ 10 | │ ├── nginx/ 11 | │ │ └── default.conf 12 | │ ├── mysql/ 13 | │ │ └── my.cnf 14 | │ └── php/ 15 | │ └── Dockerfile 16 | │ 17 | ├── docker-compose.yml 18 | │ 19 | ├── src/ 20 | │ ├── app/ 21 | │ ├── bootstrap/ 22 | │ ├── config/ 23 | │ ├── database/ 24 | │ ├── public/ 25 | │ ├── resources/ 26 | │ ├── routes/ 27 | │ ├── storage/ 28 | │ ├── tests/ 29 | │ ├── .env.example 30 | │ ├── .gitignore 31 | │ ├── composer.json 32 | │ ├── phpunit.xml 33 | │ └── ... 34 | │ 35 | └── README.md -------------------------------------------------------------------------------- /src/app/Models/CustomerSQL.php: -------------------------------------------------------------------------------- 1 | id(); 18 | $table->timestamps(); 19 | }); 20 | } 21 | 22 | /** 23 | * Reverse the migrations. 24 | * 25 | * @return void 26 | */ 27 | public function down() 28 | { 29 | Schema::dropIfExists('posts'); 30 | } 31 | }; 32 | -------------------------------------------------------------------------------- /src/lang/en/auth.php: -------------------------------------------------------------------------------- 1 | 'These credentials do not match our records.', 17 | 'password' => 'The provided password is incorrect.', 18 | 'throttle' => 'Too many login attempts. Please try again in :seconds seconds.', 19 | 20 | ]; 21 | -------------------------------------------------------------------------------- /.devcontainer/.env: -------------------------------------------------------------------------------- 1 | # PATHs are relative to docker-compose.yml 2 | 3 | NGINX_IMAGE=nginx:alpine 4 | NGINX_HOST_PORT=80 5 | NGINX_CONTAINER_PORT=80 6 | NGINX_HOST_CONFD_DIR=./.docker/nginx/conf.d 7 | NGINX_CONTAINER_CONFD_DIR=/etc/nginx/conf.d 8 | 9 | PHP_WEBROOT_HOST_PATH=../src/ 10 | PHP_WEBROOT_CONTAINER_PATH=/var/www/htdoc 11 | 12 | NGINX_WEBROOT_HOST_PATH=../src/ 13 | NGINX_WEBROOT_CONTAINER_PATH=/var/www/htdoc 14 | 15 | MYSQL_IMAGE=mysql:5.7 16 | MYSQL_DATA_HOST_PATH=./data/mysql 17 | MYSQL_DATA_CONTAINER_PATH=/var/lib/mysql 18 | MYSQL_HOST_PORT=3306 19 | MYSQL_CONTAINER_PORT=3306 20 | 21 | MYSQL_ROOT_PASSWORD=rootpassword 22 | MYSQL_DATABASE=mydatabase 23 | 24 | PHP_IMAGE=php:8.2-fpm 25 | 26 | 27 | REDIS_DATA_HOST_PATH=./data/redis 28 | REDIS_DATA_CONTAINER_PATH=/etc/data -------------------------------------------------------------------------------- /src/app/Providers/AuthServiceProvider.php: -------------------------------------------------------------------------------- 1 | 14 | */ 15 | protected $policies = [ 16 | // 'App\Models\Model' => 'App\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 | -------------------------------------------------------------------------------- /src/app/Http/Middleware/TrustProxies.php: -------------------------------------------------------------------------------- 1 | |string|null 14 | */ 15 | protected $proxies; 16 | 17 | /** 18 | * The headers that should be used to detect proxies. 19 | * 20 | * @var int 21 | */ 22 | protected $headers = 23 | Request::HEADER_X_FORWARDED_FOR | 24 | Request::HEADER_X_FORWARDED_HOST | 25 | Request::HEADER_X_FORWARDED_PORT | 26 | Request::HEADER_X_FORWARDED_PROTO | 27 | Request::HEADER_X_FORWARDED_AWS_ELB; 28 | } 29 | -------------------------------------------------------------------------------- /src/app/Console/Kernel.php: -------------------------------------------------------------------------------- 1 | command('inspire')->hourly(); 19 | } 20 | 21 | /** 22 | * Register the commands for the application. 23 | * 24 | * @return void 25 | */ 26 | protected function commands() 27 | { 28 | $this->load(__DIR__.'/Commands'); 29 | 30 | require base_path('routes/console.php'); 31 | } 32 | } 33 | -------------------------------------------------------------------------------- /src/database/migrations/2023_08_09_051124_create_customer_mongo_db_table.php: -------------------------------------------------------------------------------- 1 | create('laracoll', function ($collection) { 17 | $collection->unique('guid'); // Ensure the guid is unique since it will be used as a primary key. 18 | }); 19 | } 20 | 21 | /** 22 | * Reverse the migrations. 23 | * 24 | * @return void 25 | */ 26 | public function down() 27 | { 28 | Schema::dropIfExists('laracoll'); 29 | } 30 | }; 31 | -------------------------------------------------------------------------------- /src/lang/en/passwords.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 | -------------------------------------------------------------------------------- /src/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/routes/web.php: -------------------------------------------------------------------------------- 1 | > 16 | */ 17 | protected $listen = [ 18 | Registered::class => [ 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 | -------------------------------------------------------------------------------- /src/resources/views/post.blade.php: -------------------------------------------------------------------------------- 1 | 16 | 17 | 18 | 19 | 20 | 21 | Post Page 22 | 23 | 24 |

{{$post_data->post_title}}

25 | 26 | 27 |
{!! $post_data->post_content !!}
28 | 29 |
{{ $post_data->mdb_post_date }}
30 | 31 | 35 |
First Taxonomy: {{ $post_data->mdb_post_taxonomies[0]['name'] }}
36 | 37 |
RAW Object: {{$post_data}}
38 | 39 | -------------------------------------------------------------------------------- /src/app/Models/Post.php: -------------------------------------------------------------------------------- 1 | ['guid' => 1], 'options' => ['unique' => true]], 29 | ]; 30 | } 31 | -------------------------------------------------------------------------------- /src/config/cors.php: -------------------------------------------------------------------------------- 1 | ['api/*', 'sanctum/csrf-cookie'], 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 | -------------------------------------------------------------------------------- /src/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 | -------------------------------------------------------------------------------- /src/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 | -------------------------------------------------------------------------------- /src/app/Exceptions/Handler.php: -------------------------------------------------------------------------------- 1 | > 14 | */ 15 | protected $dontReport = [ 16 | // 17 | ]; 18 | 19 | /** 20 | * A list of the inputs that are never flashed for validation exceptions. 21 | * 22 | * @var array 23 | */ 24 | protected $dontFlash = [ 25 | 'current_password', 26 | 'password', 27 | 'password_confirmation', 28 | ]; 29 | 30 | /** 31 | * Register the exception handling callbacks for the application. 32 | * 33 | * @return void 34 | */ 35 | public function register() 36 | { 37 | $this->reportable(function (Throwable $e) { 38 | // 39 | }); 40 | } 41 | } 42 | -------------------------------------------------------------------------------- /src/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 | -------------------------------------------------------------------------------- /src/database/migrations/2023_08_03_202445_create_customer_s_q_l_s_table.php: -------------------------------------------------------------------------------- 1 | create('customer_sql', function (Blueprint $table) { 17 | $table->id(); 18 | $table->uuid('guid')->unique(); 19 | $table->string('first_name'); 20 | $table->string('family_name'); 21 | $table->string('email'); 22 | $table->text('address'); 23 | $table->timestamps(); 24 | }); 25 | } 26 | 27 | /** 28 | * Reverse the migrations. 29 | * 30 | * @return void 31 | */ 32 | public function down() 33 | { 34 | Schema::dropIfExists('customer_s_q_l_s'); 35 | } 36 | }; 37 | -------------------------------------------------------------------------------- /src/app/Http/Middleware/RedirectIfAuthenticated.php: -------------------------------------------------------------------------------- 1 | check()) { 26 | return redirect(RouteServiceProvider::HOME); 27 | } 28 | } 29 | 30 | return $next($request); 31 | } 32 | } 33 | -------------------------------------------------------------------------------- /src/database/migrations/2019_12_14_000001_create_personal_access_tokens_table.php: -------------------------------------------------------------------------------- 1 | id(); 18 | $table->morphs('tokenable'); 19 | $table->string('name'); 20 | $table->string('token', 64)->unique(); 21 | $table->text('abilities')->nullable(); 22 | $table->timestamp('last_used_at')->nullable(); 23 | $table->timestamps(); 24 | }); 25 | } 26 | 27 | /** 28 | * Reverse the migrations. 29 | * 30 | * @return void 31 | */ 32 | public function down() 33 | { 34 | Schema::dropIfExists('personal_access_tokens'); 35 | } 36 | }; 37 | -------------------------------------------------------------------------------- /src/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 | -------------------------------------------------------------------------------- /.devcontainer/.docker/nginx/conf.d/nginx-webserver.conf: -------------------------------------------------------------------------------- 1 | # this server config works with Laravel too 2 | server { 3 | listen 80; 4 | listen [::]:80 default_server; 5 | 6 | # not needed for now 7 | # server_name example.com; 8 | 9 | root /var/www/htdoc/public; 10 | 11 | add_header X-Frame-Options "SAMEORIGIN"; 12 | add_header X-Content-Type-Options "nosniff"; 13 | 14 | index index.php; 15 | 16 | charset utf-8; 17 | 18 | location / { 19 | try_files $uri $uri/ /index.php?$query_string; 20 | } 21 | 22 | location = /favicon.ico { access_log off; log_not_found off; } 23 | location = /robots.txt { access_log off; log_not_found off; } 24 | 25 | error_page 404 /index.php; 26 | 27 | location ~* \.php$ { 28 | fastcgi_pass php:9000; 29 | 30 | include fastcgi_params; 31 | fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; 32 | fastcgi_param SCRIPT_NAME $fastcgi_script_name; 33 | } 34 | 35 | location ~ /\.(?!well-known).* { 36 | deny all; 37 | } 38 | } -------------------------------------------------------------------------------- /src/app/Models/User.php: -------------------------------------------------------------------------------- 1 | 19 | */ 20 | protected $fillable = [ 21 | 'name', 22 | 'email', 23 | 'password', 24 | ]; 25 | 26 | /** 27 | * The attributes that should be hidden for serialization. 28 | * 29 | * @var array 30 | */ 31 | protected $hidden = [ 32 | 'password', 33 | 'remember_token', 34 | ]; 35 | 36 | /** 37 | * The attributes that should be cast. 38 | * 39 | * @var array 40 | */ 41 | protected $casts = [ 42 | 'email_verified_at' => 'datetime', 43 | ]; 44 | } 45 | -------------------------------------------------------------------------------- /src/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 | -------------------------------------------------------------------------------- /src/phpunit.xml: -------------------------------------------------------------------------------- 1 | 2 | 7 | 8 | 9 | ./tests/Unit 10 | 11 | 12 | ./tests/Feature 13 | 14 | 15 | 16 | 17 | ./app 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | -------------------------------------------------------------------------------- /src/database/factories/UserFactory.php: -------------------------------------------------------------------------------- 1 | 10 | */ 11 | class UserFactory extends Factory 12 | { 13 | /** 14 | * Define the model's default state. 15 | * 16 | * @return array 17 | */ 18 | public function definition() 19 | { 20 | return [ 21 | 'name' => $this->faker->name(), 22 | 'email' => $this->faker->unique()->safeEmail(), 23 | 'email_verified_at' => now(), 24 | 'password' => '$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi', // password 25 | 'remember_token' => Str::random(10), 26 | ]; 27 | } 28 | 29 | /** 30 | * Indicate that the model's email address should be unverified. 31 | * 32 | * @return \Illuminate\Database\Eloquent\Factories\Factory 33 | */ 34 | public function unverified() 35 | { 36 | return $this->state(function (array $attributes) { 37 | return [ 38 | 'email_verified_at' => null, 39 | ]; 40 | }); 41 | } 42 | } 43 | -------------------------------------------------------------------------------- /src/.env.example: -------------------------------------------------------------------------------- 1 | MONGODB_URI='mongodb://127.0.0.1:27017/' # replace with your live MongoDB Atlas cluster! 2 | 3 | APP_NAME="Laravel MongoDB Tutorial" 4 | APP_ENV=local 5 | APP_KEY= 6 | APP_DEBUG=true 7 | APP_URL=http://localhost 8 | 9 | LOG_CHANNEL=stack 10 | LOG_DEPRECATIONS_CHANNEL=null 11 | LOG_LEVEL=debug 12 | 13 | DB_CONNECTION=mysql # 'mysql' is the Laravel connection name defined in config/database/php 14 | DB_HOST=mysql_service # 'mysql_service' refers to the Docker environment's 'mysql_service' container in lieu of the IP. It is defined in the docker-compose.yml file 15 | DB_PORT=3306 16 | DB_DATABASE=mydatabase # arbitrary database name for this project 17 | DB_USERNAME=root # our docker MySQL root username and password, defined in docker-compose.yml 18 | DB_PASSWORD=rootpassword 19 | 20 | BROADCAST_DRIVER=log 21 | CACHE_DRIVER=file 22 | FILESYSTEM_DISK=local 23 | QUEUE_CONNECTION=sync 24 | SESSION_DRIVER=file 25 | SESSION_LIFETIME=120 26 | 27 | MEMCACHED_HOST=127.0.0.1 28 | 29 | REDIS_HOST=127.0.0.1 30 | REDIS_PASSWORD=null 31 | REDIS_PORT=6379 32 | 33 | MAIL_MAILER=smtp 34 | MAIL_HOST=mailhog 35 | MAIL_PORT=1025 36 | MAIL_USERNAME=null 37 | MAIL_PASSWORD=null 38 | MAIL_ENCRYPTION=null 39 | MAIL_FROM_ADDRESS=null 40 | MAIL_FROM_NAME="${APP_NAME}" 41 | 42 | AWS_ACCESS_KEY_ID= 43 | AWS_SECRET_ACCESS_KEY= 44 | AWS_DEFAULT_REGION=us-east-1 45 | AWS_BUCKET= 46 | AWS_USE_PATH_STYLE_ENDPOINT=false 47 | 48 | PUSHER_APP_ID= 49 | PUSHER_APP_KEY= 50 | PUSHER_APP_SECRET= 51 | PUSHER_APP_CLUSTER=mt1 52 | 53 | MIX_PUSHER_APP_KEY="${PUSHER_APP_KEY}" 54 | MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}" 55 | -------------------------------------------------------------------------------- /.devcontainer/devcontainer.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "laravel9-mongodb-tutorial", 3 | 4 | // Mandatory definition for .devcontainer 5 | // 6 | // which service AS DEFINED IN .devcontainer/docker-compose.yml 7 | // do we want VS Code to attach to? 8 | // here, we choose the "php" service since that's where our code is executed 9 | "service": "php", 10 | 11 | // we have multiple containers (nginx, PHP, MySQL, redis) 12 | // so we'll use a compose .yml file instead of defining the services in devcontainer.json 13 | "dockerComposeFile": "./docker-compose.yml", 14 | 15 | "shutdownAction": "stopCompose", 16 | 17 | // Mandatory definition for .devcontainer 18 | // 19 | // workspaceFolder describes the CONTAINER folder 20 | // in which the "service" (php here) is configured to mount the project 21 | // in our case, "/var/www/htdoc" refers to 22 | // ${WEBROOT_HOST_PATH}:${WEBROOT_CONTAINER_PATH} in our "php" service "volumeS" 23 | // these are defined in .devcontainer/.env as follows: 24 | // WEBROOT_HOST_PATH=../src 25 | // WEBROOT_CONTAINER_PATH=/var/www/htdoc 26 | "workspaceFolder": "/var/www/htdoc", 27 | 28 | // NOT REQUIRED, because our mounts are defined in the .yml file 29 | // 30 | // mount defined in docker-compose.yml 31 | //"mounts": [ 32 | // "source=${localWorkspaceFolder},target=/src,type=bind" 33 | //], 34 | 35 | // "xdebug.php-debug" = official XDEBUG extension 36 | "customizations": { 37 | "vscode": { 38 | "extensions": [ 39 | "xdebug.php-debug" 40 | ] 41 | } 42 | }, 43 | 44 | "forwardPorts": [80], 45 | 46 | // execute our one-time repo init if /vendor/ does not exist 47 | "postCreateCommand": "sh init_repo.sh" 48 | } -------------------------------------------------------------------------------- /src/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' => 65536, 48 | 'threads' => 1, 49 | 'time' => 4, 50 | ], 51 | 52 | ]; 53 | -------------------------------------------------------------------------------- /src/bootstrap/app.php: -------------------------------------------------------------------------------- 1 | singleton( 30 | Illuminate\Contracts\Http\Kernel::class, 31 | App\Http\Kernel::class 32 | ); 33 | 34 | $app->singleton( 35 | Illuminate\Contracts\Console\Kernel::class, 36 | App\Console\Kernel::class 37 | ); 38 | 39 | $app->singleton( 40 | Illuminate\Contracts\Debug\ExceptionHandler::class, 41 | App\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 | -------------------------------------------------------------------------------- /src/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 | -------------------------------------------------------------------------------- /.devcontainer/.docker/php/xdebug.ini: -------------------------------------------------------------------------------- 1 | ; already loaded in /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini 2 | ;zend_extension=xdebug 3 | 4 | ; FIXME : should be elsewhere, like docker-php.ini 5 | error_log = /var/log/php-errors.log 6 | catch_workers_output = yes 7 | 8 | [xdebug] 9 | ; 'debug' means we're enabling step-by-step debugging 10 | xdebug.mode=debug 11 | 12 | xdebug.client_port=9003 13 | 14 | ; xdebug.client_host is the IP address of the system where VS Code runs 15 | ; that IP address is DIFFERENT depending on WHERE VS Code is launched in Windows/Mac, WSL, Container/devcontainer/codespaces 16 | ; 17 | ; the PHP container sends debugging data OUT to xdebug.client_host:xdebug.client_port 18 | 19 | 20 | ; localhost is used when running btoh VS Code and PHP from within **the same PHP container** 21 | ; after opening the project in the Container 22 | xdebug.client_host=localhost 23 | 24 | ; if using Docker Desktop 'host.docker.internal' is supposed to hold the IP Address of 25 | ; the Docker host, but that's not always true. DOUBLE-CHECK 26 | 27 | ;xdebug.client_host=host.docker.internal 28 | 29 | ; 'yes': This will always initiate a debugging, profiling, or tracing session as soon as a request is received, without needing any specific trigger 30 | ; 'no' : This will never initiate a session regardless of the presence of any trigger 31 | ; 'trigger' : This will initiate a session only if a specific trigger, like a GET/POST variable or a cookie, is present in the request. 32 | xdebug.start_with_request=yes 33 | 34 | ; OPTIONAL: idekey 35 | ; in the browser add a URL param , if not using a browser utility 36 | ; url.to.debug?XDEBUG_SESSION_START=PHPSTORM 37 | ; sets up a coockie called "XDEBUG_SESSION_START" with the value "PHPSTORM", which is the "trigger" 38 | ; xdebug.idekey=PHPSTORM 39 | 40 | ; defines a log file. This is created, with touch, and initialized (permissions) in the PHP container Dockerfile 41 | xdebug.log=/tmp/xdebug.log -------------------------------------------------------------------------------- /.vscode/launch.json: -------------------------------------------------------------------------------- 1 | { 2 | // Use IntelliSense to learn about possible attributes. 3 | // Hover to view descriptions of existing attributes. 4 | // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387 5 | "version": "0.2.0", 6 | "configurations": [ 7 | { 8 | "name": "Listen for Xdebug", 9 | "type": "php", 10 | "request": "launch", 11 | "port": 9003, 12 | // ${workspaceFolder} == directory where /.vscode/ is 13 | // the syntax is SERVER_PATH : LOCAL_PATH 14 | "pathMappings": { 15 | "/var/www/htdoc": "${workspaceFolder}/src" 16 | } 17 | }, 18 | { 19 | "name": "Launch currently open script", 20 | "type": "php", 21 | "request": "launch", 22 | "program": "${file}", 23 | "cwd": "${fileDirname}", 24 | "port": 0, 25 | "runtimeArgs": [ 26 | "-dxdebug.start_with_request=yes" 27 | ], 28 | "env": { 29 | "XDEBUG_MODE": "debug,develop", 30 | "XDEBUG_CONFIG": "client_port=${port}" 31 | } 32 | }, 33 | { 34 | "name": "Launch Built-in web server", 35 | "type": "php", 36 | "request": "launch", 37 | "runtimeArgs": [ 38 | "-dxdebug.mode=debug", 39 | "-dxdebug.start_with_request=yes", 40 | "-S", 41 | "localhost:0" 42 | ], 43 | "program": "", 44 | "cwd": "${workspaceRoot}", 45 | "port": 9003, 46 | "serverReadyAction": { 47 | "pattern": "Development Server \\(http://localhost:([0-9]+)\\) started", 48 | "uriFormat": "http://localhost:%s", 49 | "action": "openExternally" 50 | } 51 | } 52 | ] 53 | } -------------------------------------------------------------------------------- /src/public/index.php: -------------------------------------------------------------------------------- 1 | make(Kernel::class); 52 | 53 | $response = $kernel->handle( 54 | $request = Request::capture() 55 | )->send(); 56 | 57 | $kernel->terminate($request, $response); 58 | 59 | -------------------------------------------------------------------------------- /src/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)->by($request->user()?->id ?: $request->ip()); 61 | }); 62 | } 63 | } 64 | -------------------------------------------------------------------------------- /src/composer.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "mongodb-developer/laravel9-mongodb-tutorial", 3 | "type": "project", 4 | "description": "A tutorial to shows how to connect and use Laravel with MongoDB", 5 | "keywords": ["framework", "laravel"], 6 | "license": "MIT", 7 | "require": { 8 | "php": "^8.1", 9 | "guzzlehttp/guzzle": "^7.2", 10 | "mongodb/laravel-mongodb": "4.0.0", 11 | "laravel/framework": "^10.0", 12 | "laravel/sanctum": "^3.3", 13 | "laravel/tinker": "^2.8" 14 | }, 15 | "require-dev": { 16 | "fakerphp/faker": "^1.23", 17 | "laravel/sail": "^1.25", 18 | "mockery/mockery": "^1.6", 19 | "nunomaduro/collision": "^7.8", 20 | "phpunit/phpunit": "^10.0", 21 | "spatie/laravel-ignition": "^2.3" 22 | }, 23 | "autoload": { 24 | "psr-4": { 25 | "App\\": "app/", 26 | "Database\\Factories\\": "database/factories/", 27 | "Database\\Seeders\\": "database/seeders/" 28 | } 29 | }, 30 | "autoload-dev": { 31 | "psr-4": { 32 | "Tests\\": "tests/" 33 | } 34 | }, 35 | "scripts": { 36 | "post-autoload-dump": [ 37 | "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump", 38 | "@php artisan package:discover --ansi" 39 | ], 40 | "post-update-cmd": [ 41 | "@php artisan vendor:publish --tag=laravel-assets --ansi --force" 42 | ], 43 | "post-root-package-install": [ 44 | "@php -r \"file_exists('.env') || copy('.env.example', '.env');\"" 45 | ], 46 | "post-create-project-cmd": [ 47 | "@php artisan key:generate --ansi" 48 | ] 49 | }, 50 | "extra": { 51 | "laravel": { 52 | "dont-discover": [] 53 | } 54 | }, 55 | "config": { 56 | "optimize-autoloader": true, 57 | "preferred-install": "dist", 58 | "sort-packages": true 59 | }, 60 | "minimum-stability": "dev", 61 | "prefer-stable": true 62 | } 63 | -------------------------------------------------------------------------------- /src/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 | 'client_options' => [ 43 | // Guzzle client options: https://docs.guzzlephp.org/en/stable/request-options.html 44 | ], 45 | ], 46 | 47 | 'ably' => [ 48 | 'driver' => 'ably', 49 | 'key' => env('ABLY_KEY'), 50 | ], 51 | 52 | 'redis' => [ 53 | 'driver' => 'redis', 54 | 'connection' => 'default', 55 | ], 56 | 57 | 'log' => [ 58 | 'driver' => 'log', 59 | ], 60 | 61 | 'null' => [ 62 | 'driver' => 'null', 63 | ], 64 | 65 | ], 66 | 67 | ]; 68 | -------------------------------------------------------------------------------- /src/config/sanctum.php: -------------------------------------------------------------------------------- 1 | explode(',', env('SANCTUM_STATEFUL_DOMAINS', sprintf( 17 | '%s%s', 18 | 'localhost,localhost:3000,127.0.0.1,127.0.0.1:8000,::1', 19 | env('APP_URL') ? ','.parse_url(env('APP_URL'), PHP_URL_HOST) : '' 20 | ))), 21 | 22 | /* 23 | |-------------------------------------------------------------------------- 24 | | Sanctum Guards 25 | |-------------------------------------------------------------------------- 26 | | 27 | | This array contains the authentication guards that will be checked when 28 | | Sanctum is trying to authenticate a request. If none of these guards 29 | | are able to authenticate the request, Sanctum will use the bearer 30 | | token that's present on an incoming request for authentication. 31 | | 32 | */ 33 | 34 | 'guard' => ['web'], 35 | 36 | /* 37 | |-------------------------------------------------------------------------- 38 | | Expiration Minutes 39 | |-------------------------------------------------------------------------- 40 | | 41 | | This value controls the number of minutes until an issued token will be 42 | | considered expired. If this value is null, personal access tokens do 43 | | not expire. This won't tweak the lifetime of first-party sessions. 44 | | 45 | */ 46 | 47 | 'expiration' => null, 48 | 49 | /* 50 | |-------------------------------------------------------------------------- 51 | | Sanctum Middleware 52 | |-------------------------------------------------------------------------- 53 | | 54 | | When authenticating your first-party SPA with Sanctum you may need to 55 | | customize some of the middleware Sanctum uses while processing the 56 | | request. You may change the middleware listed below as required. 57 | | 58 | */ 59 | 60 | 'middleware' => [ 61 | 'verify_csrf_token' => App\Http\Middleware\VerifyCsrfToken::class, 62 | 'encrypt_cookies' => App\Http\Middleware\EncryptCookies::class, 63 | ], 64 | 65 | ]; 66 | -------------------------------------------------------------------------------- /src/config/filesystems.php: -------------------------------------------------------------------------------- 1 | env('FILESYSTEM_DISK', 'local'), 17 | 18 | /* 19 | |-------------------------------------------------------------------------- 20 | | Filesystem Disks 21 | |-------------------------------------------------------------------------- 22 | | 23 | | Here you may configure as many filesystem "disks" as you wish, and you 24 | | may even configure multiple disks of the same driver. Defaults have 25 | | been setup for each driver as an example of the required options. 26 | | 27 | | Supported Drivers: "local", "ftp", "sftp", "s3" 28 | | 29 | */ 30 | 31 | 'disks' => [ 32 | 33 | 'local' => [ 34 | 'driver' => 'local', 35 | 'root' => storage_path('app'), 36 | ], 37 | 38 | 'public' => [ 39 | 'driver' => 'local', 40 | 'root' => storage_path('app/public'), 41 | 'url' => env('APP_URL').'/storage', 42 | 'visibility' => 'public', 43 | ], 44 | 45 | 's3' => [ 46 | 'driver' => 's3', 47 | 'key' => env('AWS_ACCESS_KEY_ID'), 48 | 'secret' => env('AWS_SECRET_ACCESS_KEY'), 49 | 'region' => env('AWS_DEFAULT_REGION'), 50 | 'bucket' => env('AWS_BUCKET'), 51 | 'url' => env('AWS_URL'), 52 | 'endpoint' => env('AWS_ENDPOINT'), 53 | 'use_path_style_endpoint' => env('AWS_USE_PATH_STYLE_ENDPOINT', false), 54 | ], 55 | 56 | ], 57 | 58 | /* 59 | |-------------------------------------------------------------------------- 60 | | Symbolic Links 61 | |-------------------------------------------------------------------------- 62 | | 63 | | Here you may configure the symbolic links that will be created when the 64 | | `storage:link` Artisan command is executed. The array keys should be 65 | | the locations of the links and the values should be their targets. 66 | | 67 | */ 68 | 69 | 'links' => [ 70 | public_path('storage') => storage_path('app/public'), 71 | ], 72 | 73 | ]; 74 | -------------------------------------------------------------------------------- /.devcontainer/.docker/php/Dockerfile: -------------------------------------------------------------------------------- 1 | # defined in docker-compose.yml, from docker-env.env 2 | ARG RUNTIME_PHP_IMAGE 3 | 4 | # Use the specified image as the base 5 | FROM ${RUNTIME_PHP_IMAGE} 6 | 7 | # create the log file and provide permission to the www-data user 8 | RUN touch /tmp/xdebug.log && chown www-data:www-data /tmp/xdebug.log 9 | 10 | # same thing for the PHP error log 11 | RUN touch /var/log/php-errors.log && chown www-data:www-data /var/log/php-errors.log 12 | 13 | # Update the packages 14 | # Install system packages required for MongoDB extension 15 | # 'mysql-client' so we can log into mysql from the PHP container with the command 'mysql -h mysql -u root -p' where mysql is the service name 16 | # 'iputils-ping' to get the ping command 17 | RUN apt-get update \ 18 | && apt-get install -y libssl-dev wget git unzip default-mysql-client iputils-ping 19 | 20 | RUN pecl apt update \ 21 | && apt install libzip-dev -y \ 22 | && docker-php-ext-install zip \ 23 | && rm -rf /var/lib/apt/lists/* 24 | 25 | # Required for MySQL to work in PHP 26 | RUN docker-php-ext-install mysqli && \ 27 | docker-php-ext-install pdo_mysql 28 | 29 | # Test if already installed and 30 | # install the mongodb PHP extension 31 | # RUN pecl install mongodb && docker-php-ext-enable mongodb 32 | RUN bash -c '[[ -n "$(pecl list | grep mongodb)" ]]\ 33 | || (pecl install mongodb && docker-php-ext-enable mongodb)' 34 | 35 | # Test if already installed and 36 | # install and enable XDEBUG 37 | # RUN pecl install xdebug && docker-php-ext-enable xdebug 38 | RUN bash -c '[[ -n "$(pecl list | grep xdebug)" ]]\ 39 | || (pecl install xdebug && docker-php-ext-enable xdebug)' 40 | 41 | # install Redis PHP driver 42 | RUN pecl install -o -f redis \ 43 | && rm -rf /tmp/pear \ 44 | && docker-php-ext-enable redis \ 45 | && docker-php-ext-enable pdo_mysql 46 | 47 | # Task: copy rep's PHP .ini files to be automatically parsed 48 | # 49 | # directory is related to the PHP service context 50 | # dot NOT use ./filename.ext for root files 51 | # use filename.ext 52 | COPY docker-php.ini /usr/local/etc/php/conf.d/ 53 | COPY xdebug.ini /usr/local/etc/php/conf.d/ 54 | 55 | # Install Composer 56 | # ---------------------------------------------------------- 57 | # download composer 58 | RUN curl -sS https://getcomposer.org/installer | php 59 | # copy composer to a place where it can be globally executed 60 | RUN mv composer.phar /usr/local/bin/composer 61 | 62 | # our repo is in var/www/htdoc 63 | # COPY init_repo.sh /var/www/htdoc/ 64 | 65 | # Set the working directory in the container 66 | WORKDIR /var/www/htdoc 67 | 68 | # start out script that runs composer install, but ONLY if /vendor/ does not exist 69 | # WARNING: the commands below crash CodeSpaces. Not using for now. 70 | #RUN chmod +x /var/www/htdoc/init_repo.sh 71 | #ENTRYPOINT ["/var/www/htdoc/init_repo.sh"] -------------------------------------------------------------------------------- /src/app/Http/Kernel.php: -------------------------------------------------------------------------------- 1 | 15 | */ 16 | protected $middleware = [ 17 | // \App\Http\Middleware\TrustHosts::class, 18 | \App\Http\Middleware\TrustProxies::class, 19 | \App\Http\Middleware\PreventRequestsDuringMaintenance::class, 20 | \Illuminate\Http\Middleware\HandleCors::class, 21 | \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class, 22 | \App\Http\Middleware\TrimStrings::class, 23 | \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class, 24 | ]; 25 | 26 | /** 27 | * The application's route middleware groups. 28 | * 29 | * @var array> 30 | */ 31 | protected $middlewareGroups = [ 32 | 'web' => [ 33 | \App\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 | \App\Http\Middleware\VerifyCsrfToken::class, 39 | \Illuminate\Routing\Middleware\SubstituteBindings::class, 40 | ], 41 | 42 | 'api' => [ 43 | // \Laravel\Sanctum\Http\Middleware\EnsureFrontendRequestsAreStateful::class, 44 | 'throttle:api', 45 | \Illuminate\Routing\Middleware\SubstituteBindings::class, 46 | ], 47 | ]; 48 | 49 | /** 50 | * The application's route middleware. 51 | * 52 | * These middleware may be assigned to groups or used individually. 53 | * 54 | * @var array 55 | */ 56 | protected $routeMiddleware = [ 57 | 'auth' => \App\Http\Middleware\Authenticate::class, 58 | 'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class, 59 | 'cache.headers' => \Illuminate\Http\Middleware\SetCacheHeaders::class, 60 | 'can' => \Illuminate\Auth\Middleware\Authorize::class, 61 | 'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class, 62 | 'password.confirm' => \Illuminate\Auth\Middleware\RequirePassword::class, 63 | 'signed' => \Illuminate\Routing\Middleware\ValidateSignature::class, 64 | 'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class, 65 | 'verified' => \Illuminate\Auth\Middleware\EnsureEmailIsVerified::class, 66 | ]; 67 | } 68 | -------------------------------------------------------------------------------- /.devcontainer/docker-compose.yml: -------------------------------------------------------------------------------- 1 | # build command: docker compose build 2 | # docker uses the .env file BY DEFAULT. Any other name and you'll have to specify it in the command line 3 | # docker compose --env-file FILENAME.env build 4 | 5 | # docker compose version 6 | version: '3.4' 7 | 8 | # Services 9 | services: 10 | 11 | # Nginx Service 12 | nginx: 13 | 14 | image: ${NGINX_IMAGE} 15 | ports: 16 | - ${NGINX_HOST_PORT}:${NGINX_CONTAINER_PORT} 17 | 18 | # path is relative to where the docker-compose.yml file is. 19 | # local-path : container-path 20 | # 21 | volumes: 22 | # public web files 23 | - ${NGINX_WEBROOT_HOST_PATH}:${NGINX_WEBROOT_CONTAINER_PATH} 24 | # .ini location 25 | - ${NGINX_HOST_CONFD_DIR}:${NGINX_CONTAINER_CONFD_DIR} 26 | depends_on: 27 | - php 28 | - mysql_service 29 | 30 | # PHP Service 31 | php: 32 | build: 33 | context: ./.docker/php 34 | dockerfile: Dockerfile 35 | args: 36 | RUNTIME_PHP_IMAGE: ${PHP_IMAGE} 37 | image: ${PHP_IMAGE} 38 | # container-path 39 | working_dir: ${PHP_WEBROOT_CONTAINER_PATH} 40 | # disk local-path 41 | volumes: 42 | - ${PHP_WEBROOT_HOST_PATH}:${PHP_WEBROOT_CONTAINER_PATH} 43 | # we don't need to expose the port 9003 here for Xdebug because the 44 | # connection comes from inside the PHP container to the IDE via port 9003 45 | environment: 46 | # laravel's default mysql config looks for the DATABASE_URL environment variable 47 | - DATABASE_URL=mysql://root:${MYSQL_ROOT_PASSWORD}@mysql_service:3306/${MYSQL_DATABASE} 48 | depends_on: 49 | - mysql_service 50 | 51 | # MySQL Service 52 | mysql_service: 53 | image: ${MYSQL_IMAGE} 54 | 55 | environment: 56 | MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD} 57 | MYSQL_DATABASE: ${MYSQL_DATABASE} 58 | 59 | # the two variales below don't seem to be used at all. Commenting out for now 60 | #MYSQL_USER: myuser 61 | #MYSQL_PASSWORD: mypassword 62 | 63 | # do NOT try mounting a volume in CodeSpaces as it will fail and MySQL will not launch (try pinging mysql_service) 64 | # this is only useful when working locally on a website with a non-ephemeral database 65 | #volumes: 66 | # map local /data/ folder to container /var/lib/mysql for MySQL data persistence 67 | # - ${MYSQL_DATA_HOST_PATH}:${MYSQL_DATA_CONTAINER_PATH} 68 | 69 | ports: 70 | - "3306:3306" 71 | # syntax = host_port:container_port 72 | 73 | 74 | # redis: 75 | # image: redis:latest 76 | # ports: 77 | # - "6379:6379" 78 | # volumes: 79 | # - ${REDIS_DATA_HOST_PATH}:${REDIS_DATA_CONTAINER_PATH} 80 | 81 | # Notes: 82 | # 83 | # From Docker Compose version 3.4 the name of the volume can be dynamically generated from environment variables placed in an .env file (this file has to be in the same folder as docker-compose.yml is). 84 | # 85 | -------------------------------------------------------------------------------- /src/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 | 'after_commit' => false, 43 | ], 44 | 45 | 'beanstalkd' => [ 46 | 'driver' => 'beanstalkd', 47 | 'host' => 'localhost', 48 | 'queue' => 'default', 49 | 'retry_after' => 90, 50 | 'block_for' => 0, 51 | 'after_commit' => false, 52 | ], 53 | 54 | 'sqs' => [ 55 | 'driver' => 'sqs', 56 | 'key' => env('AWS_ACCESS_KEY_ID'), 57 | 'secret' => env('AWS_SECRET_ACCESS_KEY'), 58 | 'prefix' => env('SQS_PREFIX', 'https://sqs.us-east-1.amazonaws.com/your-account-id'), 59 | 'queue' => env('SQS_QUEUE', 'default'), 60 | 'suffix' => env('SQS_SUFFIX'), 61 | 'region' => env('AWS_DEFAULT_REGION', 'us-east-1'), 62 | 'after_commit' => false, 63 | ], 64 | 65 | 'redis' => [ 66 | 'driver' => 'redis', 67 | 'connection' => 'default', 68 | 'queue' => env('REDIS_QUEUE', 'default'), 69 | 'retry_after' => 90, 70 | 'block_for' => null, 71 | 'after_commit' => false, 72 | ], 73 | 74 | ], 75 | 76 | /* 77 | |-------------------------------------------------------------------------- 78 | | Failed Queue Jobs 79 | |-------------------------------------------------------------------------- 80 | | 81 | | These options configure the behavior of failed queue job logging so you 82 | | can control which database and table are used to store the jobs that 83 | | have failed. You may change them to any database / table you wish. 84 | | 85 | */ 86 | 87 | 'failed' => [ 88 | 'driver' => env('QUEUE_FAILED_DRIVER', 'database-uuids'), 89 | 'database' => env('DB_CONNECTION', 'mysql'), 90 | 'table' => 'failed_jobs', 91 | ], 92 | 93 | ]; 94 | -------------------------------------------------------------------------------- /src/config/cache.php: -------------------------------------------------------------------------------- 1 | env('CACHE_DRIVER', 'file'), 19 | 20 | /* 21 | |-------------------------------------------------------------------------- 22 | | Cache Stores 23 | |-------------------------------------------------------------------------- 24 | | 25 | | Here you may define all of the cache "stores" for your application as 26 | | well as their drivers. You may even define multiple stores for the 27 | | same cache driver to group types of items stored in your caches. 28 | | 29 | | Supported drivers: "apc", "array", "database", "file", 30 | | "memcached", "redis", "dynamodb", "octane", "null" 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 | 'lock_connection' => null, 50 | ], 51 | 52 | 'file' => [ 53 | 'driver' => 'file', 54 | 'path' => storage_path('framework/cache/data'), 55 | ], 56 | 57 | 'memcached' => [ 58 | 'driver' => 'memcached', 59 | 'persistent_id' => env('MEMCACHED_PERSISTENT_ID'), 60 | 'sasl' => [ 61 | env('MEMCACHED_USERNAME'), 62 | env('MEMCACHED_PASSWORD'), 63 | ], 64 | 'options' => [ 65 | // Memcached::OPT_CONNECT_TIMEOUT => 2000, 66 | ], 67 | 'servers' => [ 68 | [ 69 | 'host' => env('MEMCACHED_HOST', '127.0.0.1'), 70 | 'port' => env('MEMCACHED_PORT', 11211), 71 | 'weight' => 100, 72 | ], 73 | ], 74 | ], 75 | 76 | 'redis' => [ 77 | 'driver' => 'redis', 78 | 'connection' => 'cache', 79 | 'lock_connection' => 'default', 80 | ], 81 | 82 | 'dynamodb' => [ 83 | 'driver' => 'dynamodb', 84 | 'key' => env('AWS_ACCESS_KEY_ID'), 85 | 'secret' => env('AWS_SECRET_ACCESS_KEY'), 86 | 'region' => env('AWS_DEFAULT_REGION', 'us-east-1'), 87 | 'table' => env('DYNAMODB_CACHE_TABLE', 'cache'), 88 | 'endpoint' => env('DYNAMODB_ENDPOINT'), 89 | ], 90 | 91 | 'octane' => [ 92 | 'driver' => 'octane', 93 | ], 94 | 95 | ], 96 | 97 | /* 98 | |-------------------------------------------------------------------------- 99 | | Cache Key Prefix 100 | |-------------------------------------------------------------------------- 101 | | 102 | | When utilizing a RAM based store such as APC or Memcached, there might 103 | | be other applications utilizing the same cache. So, we'll specify a 104 | | value to get prefixed to all our keys so we can avoid collisions. 105 | | 106 | */ 107 | 108 | 'prefix' => env('CACHE_PREFIX', Str::slug(env('APP_NAME', 'laravel'), '_').'_cache'), 109 | 110 | ]; 111 | -------------------------------------------------------------------------------- /src/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", "failover" 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 | ], 46 | 47 | 'ses' => [ 48 | 'transport' => 'ses', 49 | ], 50 | 51 | 'mailgun' => [ 52 | 'transport' => 'mailgun', 53 | ], 54 | 55 | 'postmark' => [ 56 | 'transport' => 'postmark', 57 | ], 58 | 59 | 'sendmail' => [ 60 | 'transport' => 'sendmail', 61 | 'path' => env('MAIL_SENDMAIL_PATH', '/usr/sbin/sendmail -t -i'), 62 | ], 63 | 64 | 'log' => [ 65 | 'transport' => 'log', 66 | 'channel' => env('MAIL_LOG_CHANNEL'), 67 | ], 68 | 69 | 'array' => [ 70 | 'transport' => 'array', 71 | ], 72 | 73 | 'failover' => [ 74 | 'transport' => 'failover', 75 | 'mailers' => [ 76 | 'smtp', 77 | 'log', 78 | ], 79 | ], 80 | ], 81 | 82 | /* 83 | |-------------------------------------------------------------------------- 84 | | Global "From" Address 85 | |-------------------------------------------------------------------------- 86 | | 87 | | You may wish for all e-mails sent by your application to be sent from 88 | | the same address. Here, you may specify a name and address that is 89 | | used globally for all e-mails that are sent by your application. 90 | | 91 | */ 92 | 93 | 'from' => [ 94 | 'address' => env('MAIL_FROM_ADDRESS', 'hello@example.com'), 95 | 'name' => env('MAIL_FROM_NAME', 'Example'), 96 | ], 97 | 98 | /* 99 | |-------------------------------------------------------------------------- 100 | | Markdown Mail Settings 101 | |-------------------------------------------------------------------------- 102 | | 103 | | If you are using Markdown based email rendering, you may configure your 104 | | theme and component paths here, allowing you to customize the design 105 | | of the emails. Or, you may simply stick with the Laravel defaults! 106 | | 107 | */ 108 | 109 | 'markdown' => [ 110 | 'theme' => 'default', 111 | 112 | 'paths' => [ 113 | resource_path('views/vendor/mail'), 114 | ], 115 | ], 116 | 117 | ]; 118 | -------------------------------------------------------------------------------- /src/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" 35 | | 36 | */ 37 | 38 | 'guards' => [ 39 | 'web' => [ 40 | 'driver' => 'session', 41 | 'provider' => 'users', 42 | ], 43 | ], 44 | 45 | /* 46 | |-------------------------------------------------------------------------- 47 | | User Providers 48 | |-------------------------------------------------------------------------- 49 | | 50 | | All authentication drivers have a user provider. This defines how the 51 | | users are actually retrieved out of your database or other storage 52 | | mechanisms used by this application to persist your user's data. 53 | | 54 | | If you have multiple user tables or models you may configure multiple 55 | | sources which represent each model / table. These sources may then 56 | | be assigned to any extra authentication guards you have defined. 57 | | 58 | | Supported: "database", "eloquent" 59 | | 60 | */ 61 | 62 | 'providers' => [ 63 | 'users' => [ 64 | 'driver' => 'eloquent', 65 | 'model' => App\Models\User::class, 66 | ], 67 | 68 | // 'users' => [ 69 | // 'driver' => 'database', 70 | // 'table' => 'users', 71 | // ], 72 | ], 73 | 74 | /* 75 | |-------------------------------------------------------------------------- 76 | | Resetting Passwords 77 | |-------------------------------------------------------------------------- 78 | | 79 | | You may specify multiple password reset configurations if you have more 80 | | than one user table or model in the application and you want to have 81 | | separate password reset settings based on the specific user types. 82 | | 83 | | The expire time is the number of minutes that each reset token will be 84 | | considered valid. This security feature keeps tokens short-lived so 85 | | they have less time to be guessed. You may change this as needed. 86 | | 87 | */ 88 | 89 | 'passwords' => [ 90 | 'users' => [ 91 | 'provider' => 'users', 92 | 'table' => 'password_resets', 93 | 'expire' => 60, 94 | 'throttle' => 60, 95 | ], 96 | ], 97 | 98 | /* 99 | |-------------------------------------------------------------------------- 100 | | Password Confirmation Timeout 101 | |-------------------------------------------------------------------------- 102 | | 103 | | Here you may define the amount of seconds before a password confirmation 104 | | times out and the user is prompted to re-enter their password via the 105 | | confirmation screen. By default, the timeout lasts for three hours. 106 | | 107 | */ 108 | 109 | 'password_timeout' => 10800, 110 | 111 | ]; 112 | -------------------------------------------------------------------------------- /src/config/logging.php: -------------------------------------------------------------------------------- 1 | env('LOG_CHANNEL', 'stack'), 21 | 22 | /* 23 | |-------------------------------------------------------------------------- 24 | | Deprecations Log Channel 25 | |-------------------------------------------------------------------------- 26 | | 27 | | This option controls the log channel that should be used to log warnings 28 | | regarding deprecated PHP and library features. This allows you to get 29 | | your application ready for upcoming major versions of dependencies. 30 | | 31 | */ 32 | 33 | 'deprecations' => env('LOG_DEPRECATIONS_CHANNEL', 'null'), 34 | 35 | /* 36 | |-------------------------------------------------------------------------- 37 | | Log Channels 38 | |-------------------------------------------------------------------------- 39 | | 40 | | Here you may configure the log channels for your application. Out of 41 | | the box, Laravel uses the Monolog PHP logging library. This gives 42 | | you a variety of powerful log handlers / formatters to utilize. 43 | | 44 | | Available Drivers: "single", "daily", "slack", "syslog", 45 | | "errorlog", "monolog", 46 | | "custom", "stack" 47 | | 48 | */ 49 | 50 | 'channels' => [ 51 | 'stack' => [ 52 | 'driver' => 'stack', 53 | 'channels' => ['single'], 54 | 'ignore_exceptions' => false, 55 | ], 56 | 57 | 'single' => [ 58 | 'driver' => 'single', 59 | 'path' => storage_path('logs/laravel.log'), 60 | 'level' => env('LOG_LEVEL', 'debug'), 61 | ], 62 | 63 | 'daily' => [ 64 | 'driver' => 'daily', 65 | 'path' => storage_path('logs/laravel.log'), 66 | 'level' => env('LOG_LEVEL', 'debug'), 67 | 'days' => 14, 68 | ], 69 | 70 | 'slack' => [ 71 | 'driver' => 'slack', 72 | 'url' => env('LOG_SLACK_WEBHOOK_URL'), 73 | 'username' => 'Laravel Log', 74 | 'emoji' => ':boom:', 75 | 'level' => env('LOG_LEVEL', 'critical'), 76 | ], 77 | 78 | 'papertrail' => [ 79 | 'driver' => 'monolog', 80 | 'level' => env('LOG_LEVEL', 'debug'), 81 | 'handler' => env('LOG_PAPERTRAIL_HANDLER', SyslogUdpHandler::class), 82 | 'handler_with' => [ 83 | 'host' => env('PAPERTRAIL_URL'), 84 | 'port' => env('PAPERTRAIL_PORT'), 85 | 'connectionString' => 'tls://'.env('PAPERTRAIL_URL').':'.env('PAPERTRAIL_PORT'), 86 | ], 87 | ], 88 | 89 | 'stderr' => [ 90 | 'driver' => 'monolog', 91 | 'level' => env('LOG_LEVEL', 'debug'), 92 | 'handler' => StreamHandler::class, 93 | 'formatter' => env('LOG_STDERR_FORMATTER'), 94 | 'with' => [ 95 | 'stream' => 'php://stderr', 96 | ], 97 | ], 98 | 99 | 'syslog' => [ 100 | 'driver' => 'syslog', 101 | 'level' => env('LOG_LEVEL', 'debug'), 102 | ], 103 | 104 | 'errorlog' => [ 105 | 'driver' => 'errorlog', 106 | 'level' => env('LOG_LEVEL', 'debug'), 107 | ], 108 | 109 | 'null' => [ 110 | 'driver' => 'monolog', 111 | 'handler' => NullHandler::class, 112 | ], 113 | 114 | 'emergency' => [ 115 | 'path' => storage_path('logs/laravel.log'), 116 | ], 117 | ], 118 | 119 | ]; 120 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # How To Build a Laravel + MongoDB Back End Service 2 | 3 | This code was written to accompany [this tutorial article](https://www.mongodb.com/developer/languages/php/laravel-mongodb-tutorial/?utm_campaign=devrel). 4 | 5 | ## Prerequisites 6 | You'll need the following installed on your computer to follow along with this tutorial: 7 | 8 | - A MongoDB Atlas cluster 9 | - [Create a **free** cluster](https://www.mongodb.com/try?utm_campaign=devrel) and [load the MongoDB sample data](https://www.mongodb.com/basics/sample-database?utm_campaign=devrel). 10 | - A GitHub account if you want to use GitHub Codespaces (a 1-click experience) 11 | - The `master` repo has all the code, but we also have a `starter` branch if you want to follow the project from scratch and build the migrations etc. 12 | - A code editor of your choice for local development 13 | - We suggeest [Visual Studio Code](https://code.visualstudio.com/download). Check the optional [MongoDB for VS Code](https://www.mongodb.com/products/vs-code?utm_campaign=devrel) extension. 14 | 15 | The article mentions several ways to get a Laravel development environment up and running. 16 | 17 | # 🚀 Launch this repo in CodeSpaces 18 | 19 | 20 | 21 | ⏳Codespaces will build the app's container(s). This may take **~3 minutes**. 22 | 23 | 24 | 25 | ✅Done! We now have our project running inside CodeSpaces. We can proceed to setting up Laravel 26 | 27 | 28 | 29 |

30 | 31 | # 👋 Before you run this Laravel app 32 | 33 | ## 1. Final Laravel app setup 34 | 35 | After cloning the code repo or launching a Docker/CodeSpaces instance, a script called `init_repo.sh` will be automatically executed (as setup in devcontainer.json) to: 36 | 37 | - install dependencies via Composer 38 | - create a new .env file 39 | - generate a new Laravel App Key 40 | 41 | 1. All you need to do is to **add your MongoDB credentials in Laravel's .env file**, using the MONGODB_URI environment variable. Here's [how to get your credentials](https://www.mongodb.com/docs/guides/atlas/connection-string/?utm_campaign=devrel) It looks something like this: 42 | 43 | ``` 44 | MONGODB_URI=mongodb+srv://USERNAME:PASSWORD@clustername.subdomain.mongodb.net/?retryWrites=true&w=majority 45 | ``` 46 | 47 | ❗Note that this branch already has the Laravel Model and Migrations already created and ready, but the tables have been initialized yet. 48 | 49 | 2. You can test your credentials by using the code's API endpoint 50 | 51 | ``` 52 | /api/test_mongodb/ 53 | ``` 54 | 55 | Find the site's root URL by going to the "Ports" tab and click on the globe icon of port 80 56 | 57 | 58 | 59 | 3. If the MongoDB ping test worked, use this command in the terminal to initialize the tables 60 | 61 | `php artisan migrate:refresh` 62 | 63 |

64 | 65 | ## 2. Ready! 66 | 67 | 68 | 69 | Our base Laravel app is ready 🥳. 70 | 71 | **Next**, try some of the things we talked about in our [How To Build a Laravel + MongoDB Back End Service](https://www.mongodb.com/developer/languages/php/laravel-mongodb-tutorial/) 72 | 73 | # 🚀 Launch locally with Docker 74 | 75 | Assuming that you already have Docker Desktop installed on Windows/Mac or Docker on Linux, 76 | 77 | - clone the repository to a local directory 78 | - navigate to the ./devcontainer folder 79 | - execute `docker compose up` 80 | - in the PHP container, execute `sh init_repo.sh` 81 | - initialize your .env file as instructed above 82 | 83 | Once the container(s) are up, visit http://localhost 84 | 85 | # Optional: Xdebug 86 | 87 | The xdebug.php-debug VS Code extension is automatically installed if you launch via devcontainer.json. 88 | 89 | 👀 **Important**: our `.devcontainer/.docker/php/xdebug.ini` file is setup by default with `xdebug.client_host=localhost`, which should works for **CodeSpaces** and Devcontainers. 90 | 91 | For **local development**, you need to replace `localhost` with the IP where your code IDE runs or a dns name that maps to it. That's because your PHP container and the IDE host tend to have different IPs. 92 | 93 | If you are using our container directly (docker compose up), or via VS Code (devcontainer), we suggest the following Xdebug configs visual studio. Note the difference in path mapping. 94 | 95 | ## CodeSpaces and (inside a Devcontainer) 96 | 97 | ```json 98 | { 99 | "name": "Listen for Xdebug", 100 | "type": "php", 101 | "request": "launch", 102 | "port": 9003, 103 | "pathMappings": { 104 | "/var/www/htdoc": "${workspaceFolder}" 105 | } 106 | }, 107 | ``` 108 | 109 | ## local development with Docker 110 | 111 | The debug config file is located in `/.vscode/launch.json` 112 | 113 | ```json 114 | { 115 | "name": "Listen for Xdebug", 116 | "type": "php", 117 | "request": "launch", 118 | "port": 9003, 119 | "pathMappings": { 120 | "/var/www/htdoc": "${workspaceFolder}/src" 121 | } 122 | }, 123 | ``` 124 | 125 | # Disclaimer 126 | 127 | Use at your own risk; not a supported MongoDB product 128 | -------------------------------------------------------------------------------- /src/config/database.php: -------------------------------------------------------------------------------- 1 | env('DB_CONNECTION', 'mongodb'), 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 | 'mongodb' => [ 39 | 'driver' => 'mongodb', 40 | 'dsn' => env('MONGODB_URI'), 41 | 'database' => 'bigsearch', // replace 'bigsearch' with your database name 42 | ], 43 | 44 | 'mongodb_mflix' => [ 45 | 'driver' => 'mongodb', 46 | 'dsn' => env('MONGODB_URI'), 47 | 'database' => 'sample_mflix', 48 | ], 49 | 50 | 51 | 'sqlite' => [ 52 | 'driver' => 'sqlite', 53 | 'url' => env('DATABASE_URL'), 54 | 'database' => env('DB_DATABASE', database_path('database.sqlite')), 55 | 'prefix' => '', 56 | 'foreign_key_constraints' => env('DB_FOREIGN_KEYS', true), 57 | ], 58 | 59 | 'mysql' => [ 60 | 'driver' => 'mysql', 61 | 'url' => env('DATABASE_URL'), 62 | 'host' => env('DB_HOST', '127.0.0.1'), 63 | 'port' => env('DB_PORT', '3306'), 64 | 'database' => env('DB_DATABASE', ''), 65 | 'username' => env('DB_USERNAME', ''), 66 | 'password' => env('DB_PASSWORD', ''), 67 | 'unix_socket' => env('DB_SOCKET', ''), 68 | 'charset' => 'utf8mb4', 69 | 'collation' => 'utf8mb4_unicode_ci', 70 | 'prefix' => '', 71 | 'prefix_indexes' => true, 72 | 'strict' => true, 73 | 'engine' => null, 74 | 'options' => extension_loaded('pdo_mysql') ? array_filter([ 75 | PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'), 76 | ]) : [], 77 | ], 78 | 79 | 'pgsql' => [ 80 | 'driver' => 'pgsql', 81 | 'url' => env('DATABASE_URL'), 82 | 'host' => env('DB_HOST', '127.0.0.1'), 83 | 'port' => env('DB_PORT', '5432'), 84 | 'database' => env('DB_DATABASE', 'forge'), 85 | 'username' => env('DB_USERNAME', 'forge'), 86 | 'password' => env('DB_PASSWORD', ''), 87 | 'charset' => 'utf8', 88 | 'prefix' => '', 89 | 'prefix_indexes' => true, 90 | 'search_path' => 'public', 91 | 'sslmode' => 'prefer', 92 | ], 93 | 94 | 'sqlsrv' => [ 95 | 'driver' => 'sqlsrv', 96 | 'url' => env('DATABASE_URL'), 97 | 'host' => env('DB_HOST', 'localhost'), 98 | 'port' => env('DB_PORT', '1433'), 99 | 'database' => env('DB_DATABASE', 'forge'), 100 | 'username' => env('DB_USERNAME', 'forge'), 101 | 'password' => env('DB_PASSWORD', ''), 102 | 'charset' => 'utf8', 103 | 'prefix' => '', 104 | 'prefix_indexes' => true, 105 | ], 106 | 107 | ], 108 | 109 | /* 110 | |-------------------------------------------------------------------------- 111 | | Migration Repository Table 112 | |-------------------------------------------------------------------------- 113 | | 114 | | This table keeps track of all the migrations that have already run for 115 | | your application. Using this information, we can determine which of 116 | | the migrations on disk haven't actually been run in the database. 117 | | 118 | */ 119 | 120 | 'migrations' => 'migrations', 121 | 122 | /* 123 | |-------------------------------------------------------------------------- 124 | | Redis Databases 125 | |-------------------------------------------------------------------------- 126 | | 127 | | Redis is an open source, fast, and advanced key-value store that also 128 | | provides a richer body of commands than a typical key-value system 129 | | such as APC or Memcached. Laravel makes it easy to dig right in. 130 | | 131 | */ 132 | 133 | 'redis' => [ 134 | 135 | 'client' => env('REDIS_CLIENT', 'phpredis'), 136 | 137 | 'options' => [ 138 | 'cluster' => env('REDIS_CLUSTER', 'redis'), 139 | 'prefix' => env('REDIS_PREFIX', Str::slug(env('APP_NAME', 'laravel'), '_').'_database_'), 140 | ], 141 | 142 | 'default' => [ 143 | 'url' => env('REDIS_URL'), 144 | 'host' => env('REDIS_HOST', '127.0.0.1'), 145 | 'password' => env('REDIS_PASSWORD'), 146 | 'port' => env('REDIS_PORT', '6379'), 147 | 'database' => env('REDIS_DB', '0'), 148 | ], 149 | 150 | 'cache' => [ 151 | 'url' => env('REDIS_URL'), 152 | 'host' => env('REDIS_HOST', '127.0.0.1'), 153 | 'password' => env('REDIS_PASSWORD'), 154 | 'port' => env('REDIS_PORT', '6379'), 155 | 'database' => env('REDIS_CACHE_DB', '1'), 156 | ], 157 | 158 | ], 159 | 160 | ]; -------------------------------------------------------------------------------- /src/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'), 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'), 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'), 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 when it can't 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 | -------------------------------------------------------------------------------- /src/config/app.php: -------------------------------------------------------------------------------- 1 | env('APP_NAME', 'Laravel'), 19 | 20 | /* 21 | |-------------------------------------------------------------------------- 22 | | Application Environment 23 | |-------------------------------------------------------------------------- 24 | | 25 | | This value determines the "environment" your application is currently 26 | | running in. This may determine how you prefer to configure various 27 | | services the application utilizes. Set this in your ".env" file. 28 | | 29 | */ 30 | 31 | 'env' => env('APP_ENV', 'production'), 32 | 33 | /* 34 | |-------------------------------------------------------------------------- 35 | | Application Debug Mode 36 | |-------------------------------------------------------------------------- 37 | | 38 | | When your application is in debug mode, detailed error messages with 39 | | stack traces will be shown on every error that occurs within your 40 | | application. If disabled, a simple generic error page is shown. 41 | | 42 | */ 43 | 44 | 'debug' => (bool) env('APP_DEBUG', false), 45 | 46 | /* 47 | |-------------------------------------------------------------------------- 48 | | Application URL 49 | |-------------------------------------------------------------------------- 50 | | 51 | | This URL is used by the console to properly generate URLs when using 52 | | the Artisan command line tool. You should set this to the root of 53 | | your application so that it is used when running Artisan tasks. 54 | | 55 | */ 56 | 57 | 'url' => env('APP_URL', 'http://localhost'), 58 | 59 | 'asset_url' => env('ASSET_URL', null), 60 | 61 | /* 62 | |-------------------------------------------------------------------------- 63 | | Application Timezone 64 | |-------------------------------------------------------------------------- 65 | | 66 | | Here you may specify the default timezone for your application, which 67 | | will be used by the PHP date and date-time functions. We have gone 68 | | ahead and set this to a sensible default for you out of the box. 69 | | 70 | */ 71 | 72 | 'timezone' => 'UTC', 73 | 74 | /* 75 | |-------------------------------------------------------------------------- 76 | | Application Locale Configuration 77 | |-------------------------------------------------------------------------- 78 | | 79 | | The application locale determines the default locale that will be used 80 | | by the translation service provider. You are free to set this value 81 | | to any of the locales which will be supported by the application. 82 | | 83 | */ 84 | 85 | 'locale' => 'en', 86 | 87 | /* 88 | |-------------------------------------------------------------------------- 89 | | Application Fallback Locale 90 | |-------------------------------------------------------------------------- 91 | | 92 | | The fallback locale determines the locale to use when the current one 93 | | is not available. You may change the value to correspond to any of 94 | | the language folders that are provided through your application. 95 | | 96 | */ 97 | 98 | 'fallback_locale' => 'en', 99 | 100 | /* 101 | |-------------------------------------------------------------------------- 102 | | Faker Locale 103 | |-------------------------------------------------------------------------- 104 | | 105 | | This locale will be used by the Faker PHP library when generating fake 106 | | data for your database seeds. For example, this will be used to get 107 | | localized telephone numbers, street address information and more. 108 | | 109 | */ 110 | 111 | 'faker_locale' => 'en_US', 112 | 113 | /* 114 | |-------------------------------------------------------------------------- 115 | | Encryption Key 116 | |-------------------------------------------------------------------------- 117 | | 118 | | This key is used by the Illuminate encrypter service and should be set 119 | | to a random, 32 character string, otherwise these encrypted strings 120 | | will not be safe. Please do this before deploying an application! 121 | | 122 | */ 123 | 124 | 'key' => env('APP_KEY'), 125 | 126 | 'cipher' => 'AES-256-CBC', 127 | 128 | /* 129 | |-------------------------------------------------------------------------- 130 | | Autoloaded Service Providers 131 | |-------------------------------------------------------------------------- 132 | | 133 | | The service providers listed here will be automatically loaded on the 134 | | request to your application. Feel free to add your own services to 135 | | this array to grant expanded functionality to your applications. 136 | | 137 | */ 138 | 139 | 'providers' => [ 140 | 141 | /* 142 | * Laravel Framework Service Providers... 143 | */ 144 | Illuminate\Auth\AuthServiceProvider::class, 145 | Illuminate\Broadcasting\BroadcastServiceProvider::class, 146 | Illuminate\Bus\BusServiceProvider::class, 147 | Illuminate\Cache\CacheServiceProvider::class, 148 | Illuminate\Foundation\Providers\ConsoleSupportServiceProvider::class, 149 | Illuminate\Cookie\CookieServiceProvider::class, 150 | Illuminate\Database\DatabaseServiceProvider::class, 151 | Illuminate\Encryption\EncryptionServiceProvider::class, 152 | Illuminate\Filesystem\FilesystemServiceProvider::class, 153 | Illuminate\Foundation\Providers\FoundationServiceProvider::class, 154 | Illuminate\Hashing\HashServiceProvider::class, 155 | Illuminate\Mail\MailServiceProvider::class, 156 | Illuminate\Notifications\NotificationServiceProvider::class, 157 | Illuminate\Pagination\PaginationServiceProvider::class, 158 | Illuminate\Pipeline\PipelineServiceProvider::class, 159 | Illuminate\Queue\QueueServiceProvider::class, 160 | Illuminate\Redis\RedisServiceProvider::class, 161 | Illuminate\Auth\Passwords\PasswordResetServiceProvider::class, 162 | Illuminate\Session\SessionServiceProvider::class, 163 | Illuminate\Translation\TranslationServiceProvider::class, 164 | Illuminate\Validation\ValidationServiceProvider::class, 165 | Illuminate\View\ViewServiceProvider::class, 166 | 167 | MongoDB\Laravel\MongoDBServiceProvider::class, 168 | 169 | /* 170 | * Package Service Providers... 171 | */ 172 | 173 | /* 174 | * Application Service Providers... 175 | */ 176 | App\Providers\AppServiceProvider::class, 177 | App\Providers\AuthServiceProvider::class, 178 | // App\Providers\BroadcastServiceProvider::class, 179 | App\Providers\EventServiceProvider::class, 180 | App\Providers\RouteServiceProvider::class, 181 | 182 | ], 183 | 184 | /* 185 | |-------------------------------------------------------------------------- 186 | | Class Aliases 187 | |-------------------------------------------------------------------------- 188 | | 189 | | This array of class aliases will be registered when this application 190 | | is started. However, feel free to register as many as you wish as 191 | | the aliases are "lazy" loaded so they don't hinder performance. 192 | | 193 | */ 194 | 195 | 'aliases' => Facade::defaultAliases()->merge([ 196 | // ... 197 | ])->toArray(), 198 | 199 | ]; 200 | -------------------------------------------------------------------------------- /src/lang/en/validation.php: -------------------------------------------------------------------------------- 1 | 'The :attribute must be accepted.', 17 | 'accepted_if' => 'The :attribute must be accepted when :other is :value.', 18 | 'active_url' => 'The :attribute is not a valid URL.', 19 | 'after' => 'The :attribute must be a date after :date.', 20 | 'after_or_equal' => 'The :attribute must be a date after or equal to :date.', 21 | 'alpha' => 'The :attribute must only contain letters.', 22 | 'alpha_dash' => 'The :attribute must only contain letters, numbers, dashes and underscores.', 23 | 'alpha_num' => 'The :attribute must only contain letters and numbers.', 24 | 'array' => 'The :attribute must be an array.', 25 | 'before' => 'The :attribute must be a date before :date.', 26 | 'before_or_equal' => 'The :attribute must be a date before or equal to :date.', 27 | 'between' => [ 28 | 'numeric' => 'The :attribute must be between :min and :max.', 29 | 'file' => 'The :attribute must be between :min and :max kilobytes.', 30 | 'string' => 'The :attribute must be between :min and :max characters.', 31 | 'array' => 'The :attribute must have between :min and :max items.', 32 | ], 33 | 'boolean' => 'The :attribute field must be true or false.', 34 | 'confirmed' => 'The :attribute confirmation does not match.', 35 | 'current_password' => 'The password is incorrect.', 36 | 'date' => 'The :attribute is not a valid date.', 37 | 'date_equals' => 'The :attribute must be a date equal to :date.', 38 | 'date_format' => 'The :attribute does not match the format :format.', 39 | 'declined' => 'The :attribute must be declined.', 40 | 'declined_if' => 'The :attribute must be declined when :other is :value.', 41 | 'different' => 'The :attribute and :other must be different.', 42 | 'digits' => 'The :attribute must be :digits digits.', 43 | 'digits_between' => 'The :attribute must be between :min and :max digits.', 44 | 'dimensions' => 'The :attribute has invalid image dimensions.', 45 | 'distinct' => 'The :attribute field has a duplicate value.', 46 | 'email' => 'The :attribute must be a valid email address.', 47 | 'ends_with' => 'The :attribute must end with one of the following: :values.', 48 | 'enum' => 'The selected :attribute is invalid.', 49 | 'exists' => 'The selected :attribute is invalid.', 50 | 'file' => 'The :attribute must be a file.', 51 | 'filled' => 'The :attribute field must have a value.', 52 | 'gt' => [ 53 | 'numeric' => 'The :attribute must be greater than :value.', 54 | 'file' => 'The :attribute must be greater than :value kilobytes.', 55 | 'string' => 'The :attribute must be greater than :value characters.', 56 | 'array' => 'The :attribute must have more than :value items.', 57 | ], 58 | 'gte' => [ 59 | 'numeric' => 'The :attribute must be greater than or equal to :value.', 60 | 'file' => 'The :attribute must be greater than or equal to :value kilobytes.', 61 | 'string' => 'The :attribute must be greater than or equal to :value characters.', 62 | 'array' => 'The :attribute must have :value items or more.', 63 | ], 64 | 'image' => 'The :attribute must be an image.', 65 | 'in' => 'The selected :attribute is invalid.', 66 | 'in_array' => 'The :attribute field does not exist in :other.', 67 | 'integer' => 'The :attribute must be an integer.', 68 | 'ip' => 'The :attribute must be a valid IP address.', 69 | 'ipv4' => 'The :attribute must be a valid IPv4 address.', 70 | 'ipv6' => 'The :attribute must be a valid IPv6 address.', 71 | 'json' => 'The :attribute must be a valid JSON string.', 72 | 'lt' => [ 73 | 'numeric' => 'The :attribute must be less than :value.', 74 | 'file' => 'The :attribute must be less than :value kilobytes.', 75 | 'string' => 'The :attribute must be less than :value characters.', 76 | 'array' => 'The :attribute must have less than :value items.', 77 | ], 78 | 'lte' => [ 79 | 'numeric' => 'The :attribute must be less than or equal to :value.', 80 | 'file' => 'The :attribute must be less than or equal to :value kilobytes.', 81 | 'string' => 'The :attribute must be less than or equal to :value characters.', 82 | 'array' => 'The :attribute must not have more than :value items.', 83 | ], 84 | 'mac_address' => 'The :attribute must be a valid MAC address.', 85 | 'max' => [ 86 | 'numeric' => 'The :attribute must not be greater than :max.', 87 | 'file' => 'The :attribute must not be greater than :max kilobytes.', 88 | 'string' => 'The :attribute must not be greater than :max characters.', 89 | 'array' => 'The :attribute must not have more than :max items.', 90 | ], 91 | 'mimes' => 'The :attribute must be a file of type: :values.', 92 | 'mimetypes' => 'The :attribute must be a file of type: :values.', 93 | 'min' => [ 94 | 'numeric' => 'The :attribute must be at least :min.', 95 | 'file' => 'The :attribute must be at least :min kilobytes.', 96 | 'string' => 'The :attribute must be at least :min characters.', 97 | 'array' => 'The :attribute must have at least :min items.', 98 | ], 99 | 'multiple_of' => 'The :attribute must be a multiple of :value.', 100 | 'not_in' => 'The selected :attribute is invalid.', 101 | 'not_regex' => 'The :attribute format is invalid.', 102 | 'numeric' => 'The :attribute must be a number.', 103 | 'password' => 'The password is incorrect.', 104 | 'present' => 'The :attribute field must be present.', 105 | 'prohibited' => 'The :attribute field is prohibited.', 106 | 'prohibited_if' => 'The :attribute field is prohibited when :other is :value.', 107 | 'prohibited_unless' => 'The :attribute field is prohibited unless :other is in :values.', 108 | 'prohibits' => 'The :attribute field prohibits :other from being present.', 109 | 'regex' => 'The :attribute format is invalid.', 110 | 'required' => 'The :attribute field is required.', 111 | 'required_array_keys' => 'The :attribute field must contain entries for: :values.', 112 | 'required_if' => 'The :attribute field is required when :other is :value.', 113 | 'required_unless' => 'The :attribute field is required unless :other is in :values.', 114 | 'required_with' => 'The :attribute field is required when :values is present.', 115 | 'required_with_all' => 'The :attribute field is required when :values are present.', 116 | 'required_without' => 'The :attribute field is required when :values is not present.', 117 | 'required_without_all' => 'The :attribute field is required when none of :values are present.', 118 | 'same' => 'The :attribute and :other must match.', 119 | 'size' => [ 120 | 'numeric' => 'The :attribute must be :size.', 121 | 'file' => 'The :attribute must be :size kilobytes.', 122 | 'string' => 'The :attribute must be :size characters.', 123 | 'array' => 'The :attribute must contain :size items.', 124 | ], 125 | 'starts_with' => 'The :attribute must start with one of the following: :values.', 126 | 'string' => 'The :attribute must be a string.', 127 | 'timezone' => 'The :attribute must be a valid timezone.', 128 | 'unique' => 'The :attribute has already been taken.', 129 | 'uploaded' => 'The :attribute failed to upload.', 130 | 'url' => 'The :attribute must be a valid URL.', 131 | 'uuid' => 'The :attribute must be a valid UUID.', 132 | 133 | /* 134 | |-------------------------------------------------------------------------- 135 | | Custom Validation Language Lines 136 | |-------------------------------------------------------------------------- 137 | | 138 | | Here you may specify custom validation messages for attributes using the 139 | | convention "attribute.rule" to name the lines. This makes it quick to 140 | | specify a specific custom language line for a given attribute rule. 141 | | 142 | */ 143 | 144 | 'custom' => [ 145 | 'attribute-name' => [ 146 | 'rule-name' => 'custom-message', 147 | ], 148 | ], 149 | 150 | /* 151 | |-------------------------------------------------------------------------- 152 | | Custom Validation Attributes 153 | |-------------------------------------------------------------------------- 154 | | 155 | | The following language lines are used to swap our attribute placeholder 156 | | with something more reader friendly such as "E-Mail Address" instead 157 | | of "email". This simply helps us make our message more expressive. 158 | | 159 | */ 160 | 161 | 'attributes' => [], 162 | 163 | ]; 164 | -------------------------------------------------------------------------------- /src/routes/api.php: -------------------------------------------------------------------------------- 1 | get('/user', function (Request $request) { 25 | return $request->user(); 26 | }); 27 | 28 | 29 | /* 30 | Just a test 31 | */ 32 | Route::get('/hello_world/', function (Request $request) { 33 | return ['msg' => 'hello_world']; 34 | }); 35 | 36 | /* 37 | Send a ping to our MongoDB cluster to see if our connection settings are correct 38 | */ 39 | Route::get('/test_mongodb/', function (Request $request) { 40 | 41 | $connection = DB::connection('mongodb'); 42 | $msg = 'MongoDB is accessible!'; 43 | try { 44 | $connection->command(['ping' => 1]); 45 | } catch (\Exception $e) { 46 | $msg = 'MongoDB is not accessible. Error: ' . $e->getMessage(); 47 | } 48 | 49 | return ['msg' => $msg]; 50 | }); 51 | 52 | /* 53 | Laravel check on the MySQL connection 54 | */ 55 | Route::get('/test_mysql/', function (Request $request) { 56 | try { 57 | DB::connection()->getPdo(); 58 | return ['status' => 'executed', 'data' => 'Successfully connected to the DB.' ]; 59 | } catch (\Exception $e) { 60 | return ['status' => 'FAIL. exception', 'data' => $e ]; 61 | } 62 | }); 63 | 64 | /* 65 | Create a new "customer" in our SQL database 66 | This is just to show the code looks identical to the MongoDB version 67 | */ 68 | Route::get('/create_eloquent_sql/', function (Request $request) { 69 | 70 | try { 71 | $success = CustomerSQL::create([ 72 | 'guid' => 'cust_0000', 73 | 'first_name' => 'John', 74 | 'family_name' => 'Doe', 75 | 'email' => 'j.doe@gmail.com', 76 | 'address' => '123 my street, my city, zip, state, country' 77 | ]); 78 | $msg = "OK"; 79 | } 80 | catch (\Exception $e) { 81 | $msg = 'Create user via Eloquent SQL model. Error: ' . $e->getMessage(); 82 | } 83 | 84 | return ['status' => 'executed', 'msg' => $msg]; 85 | }); 86 | 87 | /* 88 | Create a new "customer" in our SQL database 89 | This is just to show the code looks identical to the MongoDB version 90 | */ 91 | Route::get('/create_eloquent_mongo/', function (Request $request) { 92 | try { 93 | $success = CustomerMongoDB::create([ 94 | 'guid' => 'cust_1111', 95 | 'first_name' => 'John', 96 | 'family_name' => 'Doe', 97 | 'email' => 'j.doe@gmail.com', 98 | 'address' => '123 my street, my city, zip, state, country' 99 | ]); 100 | $msg = "OK"; 101 | } 102 | catch (\Exception $e) { 103 | $msg = 'Create user via Eloquent MongoDB model. Error: ' . $e->getMessage(); 104 | } 105 | 106 | return ['status' => 'executed', 'data' => $msg]; 107 | }); 108 | 109 | /* 110 | Find a record using Eloquent + MongoDB 111 | */ 112 | Route::get('/find_eloquent/', function (Request $request) { 113 | 114 | $customer = CustomerMongoDB::where('guid', 'cust_1111')->get(); 115 | 116 | return ['status' => 'executed', 'data' => $customer]; 117 | }); 118 | 119 | /* 120 | Update a record using Eloquent + MongoDB 121 | */ 122 | Route::get('/update_eloquent/', function (Request $request) { 123 | $result = CustomerMongoDB::where('guid', 'cust_1111')->update( ['first_name' => 'Jimmy'] ); 124 | 125 | return ['status' => 'executed', 'data' => $result]; 126 | }); 127 | 128 | /* 129 | Delete a record using Eloquent + MongoDB 130 | */ 131 | Route::get('/delete_eloquent/', function (Request $request) { 132 | $result = CustomerMongoDB::where('guid', 'cust_1111')->delete(); 133 | 134 | return ['status' => 'executed', 'data' => $result]; 135 | }); 136 | 137 | /* 138 | Create a new record with nested data, using Eloquent 139 | */ 140 | Route::get('/create_nested/', function (Request $request) { 141 | $message = "executed"; 142 | $success = null; 143 | 144 | $address = new stdClass; 145 | $address->street = '123 my street name'; 146 | $address->city = 'my city'; 147 | $address->zip = '12345'; 148 | 149 | $emails = ['j.doe@gmail.com', 'j.doe@work.com']; 150 | 151 | try { 152 | $customer = new CustomerMongoDB(); 153 | $customer->guid = 'cust_2222'; 154 | $customer->first_name = 'John'; 155 | $customer->family_name = 'Doe'; 156 | $customer->email = $emails; 157 | $customer->address = $address; 158 | $success = $customer->save(); // save() returns 1 or 0 159 | } 160 | catch (\Exception $e) { 161 | $message = $e->getMessage(); 162 | } 163 | 164 | return ['status' => $message, 'data' => $success]; 165 | }); 166 | 167 | /* 168 | Find records using a native MongoDB Query 169 | 1 - with Model->whereRaw() 170 | 2 - with native Collection->findOne() 171 | 3 - with native Collection->find() 172 | */ 173 | Route::get('/find_native/', function (Request $request) { 174 | 175 | // a simple MongoDB query that looks for a customer based on the guid 176 | $mongodbquery = ['guid' => 'cust_2222']; 177 | 178 | // Option #1 179 | //========== 180 | // use Eloquent's whereRaw() function. This is the easiest way to stay close to the Laravel paradigm 181 | // returns an "Illuminate\Database\Eloquent\Collection" Object 182 | $results = CustomerMongoDB::whereRaw( $mongodbquery )->get(); 183 | 184 | // Option #2 & #3 185 | //========== 186 | // use the native MongoDB driver Collection object. with it, you can use the native MongoDB Query API 187 | // 188 | $mdb_collection = DB::connection('mongodb')->getCollection('laracoll'); 189 | 190 | // find the first document that matches the query 191 | $mdb_bsondoc = $mdb_collection->findOne( $mongodbquery ); // returns a "MongoDB\Model\BSONDocument" Object 192 | 193 | // if we want to convert the MongoDB Document to a Laravel Model, use the Model's newFromBuilder() method 194 | $cust = new CustomerMongoDB(); 195 | $one_doc = $cust->newFromBuilder((array) $mdb_bsondoc); 196 | 197 | // find all documents that matches the query 198 | // Note: we're using find without any arguments, so ALL documents will be returned 199 | $mdb_cursor = $mdb_collection->find( ); // returns a "MongoDB\Driver\Cursor" object 200 | $cust_array = array(); 201 | foreach ($mdb_cursor->toArray() as $bson) { 202 | $cust_array[] = $cust->newFromBuilder( $bson ); 203 | } 204 | 205 | return ['status' => 'executed', 'whereraw' => $results, 'document' => $one_doc, 'cursor_array' => $cust_array]; 206 | }); 207 | 208 | /* 209 | Update a record using a native MongoDB Query 210 | */ 211 | Route::get('/update_native/', function (Request $request) { 212 | $mdb_collection = DB::connection('mongodb')->getCollection('laracoll'); 213 | 214 | $match = ['guid' => 'cust_2222']; 215 | $update = ['$set' => ['first_name' => 'Henry', 'address.street' => '777 new street name'] ]; 216 | $result = $mdb_collection->updateOne($match, $update ); 217 | 218 | return ['status' => 'executed', 'matched_docs' => $result->getMatchedCount(), 'modified_docs' => $result->getModifiedCount()]; 219 | }); 220 | 221 | /* 222 | Find and delete the first record that matches the query 223 | */ 224 | Route::get('/delete_native/', function (Request $request) { 225 | $mdb_collection = DB::connection('mongodb')->getCollection('laracoll'); 226 | 227 | $match = ['guid' => 'cust_2222']; 228 | $result = $mdb_collection->deleteOne( $match ); 229 | 230 | return ['status' => 'executed', 'deleted_docs' => $result->getDeletedCount() ]; 231 | }); 232 | 233 | /* 234 | Executes an aggregation pipeline 235 | */ 236 | Route::get('/aggregate/', function (Request $request) { 237 | 238 | $mdb_collection = DB::connection('mongodb_mflix')->getCollection('movies'); 239 | 240 | $stage0 = ['$unwind' => ['path' => '$genres']]; 241 | $stage1 = ['$group' => ['_id' => '$genres', 'averageGenreRating' => ['$avg' => '$imdb.rating']]]; 242 | $stage2 = ['$sort' => ['averageGenreRating' => -1]]; 243 | 244 | $aggregation = [$stage0, $stage1, $stage2]; 245 | 246 | $mdb_cursor = $mdb_collection->aggregate( $aggregation ); 247 | 248 | return ['status' => 'executed', 'data' => $mdb_cursor->toArray() ]; 249 | }); 250 | 251 | /* 252 | Create an index with a primary key 253 | */ 254 | Route::get('/create_index/', function (Request $request) { 255 | 256 | $indexKeys = ["guid" => 1]; 257 | $indexOptions = ["unique" => true]; 258 | $result = DB::connection('mongodb')->getCollection('laracoll')->createIndex($indexKeys, $indexOptions); 259 | 260 | return ['status' => 'executed', 'data' => $result ]; 261 | }); 262 | -------------------------------------------------------------------------------- /src/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 | 37 | @endif 38 | 39 |
40 |
41 | 42 | 43 | 44 | 45 | 46 |
47 | 48 |
49 |
50 |
51 |
52 | 53 |
Documentation
54 |
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 |
65 | 66 |
Laracasts
67 |
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 |
78 | 79 |
Laravel News
80 |
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 |
106 |
107 | 108 | 109 | 110 | 111 | 112 | Shop 113 | 114 | 115 | 116 | 117 | 118 | 119 | 120 | Sponsor 121 | 122 |
123 |
124 | 125 |
126 | Laravel v{{ Illuminate\Foundation\Application::VERSION }} (PHP v{{ PHP_VERSION }}) 127 |
128 |
129 |
130 |
131 | 132 | 133 | --------------------------------------------------------------------------------