hrustbb2
/
exampleapp
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

first commit

This commit is contained in:
Ваше Имя 2025-07-20 19:34:37 +05:00
commit 04e8b7e4fd
92 changed files with 11860 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
.editorconfig Normal file
View File

@ -0,0 +1,18 @@
root = true
[*]
charset = utf-8
end_of_line = lf
indent_size = 4
indent_style = space
insert_final_newline = true
trim_trailing_whitespace = true
[*.md]
trim_trailing_whitespace = false
[*.{yml,yaml}]
indent_size = 2
[docker-compose.yml]
indent_size = 4

65
.env.example Normal file
View File

@ -0,0 +1,65 @@
APP_NAME=Laravel
APP_ENV=local
APP_KEY=
APP_DEBUG=true
APP_URL=http://localhost
APP_LOCALE=en
APP_FALLBACK_LOCALE=en
APP_FAKER_LOCALE=en_US
APP_MAINTENANCE_DRIVER=file
# APP_MAINTENANCE_STORE=database
PHP_CLI_SERVER_WORKERS=4
BCRYPT_ROUNDS=12
LOG_CHANNEL=stack
LOG_STACK=single
LOG_DEPRECATIONS_CHANNEL=null
LOG_LEVEL=debug
DB_CONNECTION=sqlite
# DB_HOST=127.0.0.1
# DB_PORT=3306
# DB_DATABASE=laravel
# DB_USERNAME=root
# DB_PASSWORD=
SESSION_DRIVER=database
SESSION_LIFETIME=120
SESSION_ENCRYPT=false
SESSION_PATH=/
SESSION_DOMAIN=null
BROADCAST_CONNECTION=log
FILESYSTEM_DISK=local
QUEUE_CONNECTION=database
CACHE_STORE=database
# CACHE_PREFIX=
MEMCACHED_HOST=127.0.0.1
REDIS_CLIENT=phpredis
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
MAIL_MAILER=log
MAIL_SCHEME=null
MAIL_HOST=127.0.0.1
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_FROM_ADDRESS="hello@example.com"
MAIL_FROM_NAME="${APP_NAME}"
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=
AWS_USE_PATH_STYLE_ENDPOINT=false
VITE_APP_NAME="${APP_NAME}"

11
.gitattributes vendored Normal file
View File

@ -0,0 +1,11 @@
* text=auto eol=lf
*.blade.php diff=html
*.css diff=css
*.html diff=html
*.md diff=markdown
*.php diff=php
/.github export-ignore
CHANGELOG.md export-ignore
.styleci.yml export-ignore

12
.github/workflows/issues.yml vendored Normal file
View File

@ -0,0 +1,12 @@
name: Issues
on:
issues:
types: [labeled]
permissions:
issues: write
jobs:
help-wanted:
uses: laravel/.github/.github/workflows/issues.yml@main

12
.github/workflows/pull-requests.yml vendored Normal file
View File

@ -0,0 +1,12 @@
name: Pull Requests
on:
pull_request_target:
types: [opened]
permissions:
pull-requests: write
jobs:
uneditable:
uses: laravel/.github/.github/workflows/pull-requests.yml@main

47
.github/workflows/tests.yml vendored Normal file
View File

@ -0,0 +1,47 @@
name: Tests
on:
push:
branches:
- master
- '*.x'
pull_request:
schedule:
- cron: '0 0 * * *'
permissions:
contents: read
jobs:
tests:
runs-on: ubuntu-latest
strategy:
fail-fast: true
matrix:
php: [8.2, 8.3, 8.4]
name: PHP ${{ matrix.php }}
steps:
- name: Checkout code
uses: actions/checkout@v4
- name: Setup PHP
uses: shivammathur/setup-php@v2
with:
php-version: ${{ matrix.php }}
extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite
coverage: none
- name: Install Composer dependencies
run: composer install --prefer-dist --no-interaction --no-progress
- name: Copy environment file
run: cp .env.example .env
- name: Generate app key
run: php artisan key:generate
- name: Execute tests
run: php artisan test

13
.github/workflows/update-changelog.yml vendored Normal file
View File

@ -0,0 +1,13 @@
name: Update Changelog
on:
release:
types: [released]
permissions: {}
jobs:
update:
permissions:
contents: write
uses: laravel/.github/.github/workflows/update-changelog.yml@main

24
.gitignore vendored Normal file
View File

@ -0,0 +1,24 @@
*.log
.DS_Store
.env
.env.backup
.env.production
.phpactor.json
.phpunit.result.cache
/.fleet
/.idea
/.nova
/.phpunit.cache
/.vscode
/.zed
/auth.json
/node_modules
/public/build
/public/hot
/public/storage
/storage/*.key
/storage/pail
/vendor
Homestead.json
Homestead.yaml
Thumbs.db

9
.styleci.yml Normal file
View File

@ -0,0 +1,9 @@
php:
preset: laravel
disabled:
- no_unused_imports
finder:
not-name:
- index.php
js: true
css: true

62
CHANGELOG.md Normal file
View File

@ -0,0 +1,62 @@
# Release Notes
## [Unreleased](https://github.com/laravel/laravel/compare/v12.0.11...12.x)
## [v12.0.11](https://github.com/laravel/laravel/compare/v12.0.10...v12.0.11) - 2025-06-10
**Full Changelog**: https://github.com/laravel/laravel/compare/v12.0.10...v12.0.11
## [v12.0.10](https://github.com/laravel/laravel/compare/v12.0.9...v12.0.10) - 2025-06-09
* fix alphabetical order by [@Khuthaily](https://github.com/Khuthaily) in https://github.com/laravel/laravel/pull/6627
* [12.x] Reduce redundancy and keeps the .gitignore file cleaner by [@AhmedAlaa4611](https://github.com/AhmedAlaa4611) in https://github.com/laravel/laravel/pull/6629
* [12.x] Fix: Add void return type to satisfy Rector analysis by [@Aluisio-Pires](https://github.com/Aluisio-Pires) in https://github.com/laravel/laravel/pull/6628
## [v12.0.9](https://github.com/laravel/laravel/compare/v12.0.8...v12.0.9) - 2025-05-26
* [12.x] Remove apc by [@AhmedAlaa4611](https://github.com/AhmedAlaa4611) in https://github.com/laravel/laravel/pull/6611
* [12.x] Add JSON Schema to package.json by [@martinbean](https://github.com/martinbean) in https://github.com/laravel/laravel/pull/6613
* Minor language update by [@woganmay](https://github.com/woganmay) in https://github.com/laravel/laravel/pull/6615
* Enhance .gitignore to exclude common OS and log files by [@mohammadRezaei1380](https://github.com/mohammadRezaei1380) in https://github.com/laravel/laravel/pull/6619
## [v12.0.8](https://github.com/laravel/laravel/compare/v12.0.7...v12.0.8) - 2025-05-12
* [12.x] Clean up URL formatting in README by [@AhmedAlaa4611](https://github.com/AhmedAlaa4611) in https://github.com/laravel/laravel/pull/6601
## [v12.0.7](https://github.com/laravel/laravel/compare/v12.0.6...v12.0.7) - 2025-04-15
* Add `composer run test` command by [@crynobone](https://github.com/crynobone) in https://github.com/laravel/laravel/pull/6598
* Partner Directory Changes in ReadME by [@joshcirre](https://github.com/joshcirre) in https://github.com/laravel/laravel/pull/6599
## [v12.0.6](https://github.com/laravel/laravel/compare/v12.0.5...v12.0.6) - 2025-04-08
**Full Changelog**: https://github.com/laravel/laravel/compare/v12.0.5...v12.0.6
## [v12.0.5](https://github.com/laravel/laravel/compare/v12.0.4...v12.0.5) - 2025-04-02
* [12.x] Update `config/mail.php` to match the latest core configuration by [@AhmedAlaa4611](https://github.com/AhmedAlaa4611) in https://github.com/laravel/laravel/pull/6594
## [v12.0.4](https://github.com/laravel/laravel/compare/v12.0.3...v12.0.4) - 2025-03-31
* Bump vite from 6.0.11 to 6.2.3 - Vulnerability patch by [@abdel-aouby](https://github.com/abdel-aouby) in https://github.com/laravel/laravel/pull/6586
* Bump vite from 6.2.3 to 6.2.4 by [@thinkverse](https://github.com/thinkverse) in https://github.com/laravel/laravel/pull/6590
## [v12.0.3](https://github.com/laravel/laravel/compare/v12.0.2...v12.0.3) - 2025-03-17
* Remove reverted change from CHANGELOG.md by [@AJenbo](https://github.com/AJenbo) in https://github.com/laravel/laravel/pull/6565
* Improves clarity in app.css file by [@AhmedAlaa4611](https://github.com/AhmedAlaa4611) in https://github.com/laravel/laravel/pull/6569
* [12.x] Refactor: Structural improvement for clarity by [@AhmedAlaa4611](https://github.com/AhmedAlaa4611) in https://github.com/laravel/laravel/pull/6574
* Bump axios from 1.7.9 to 1.8.2 - Vulnerability patch by [@abdel-aouby](https://github.com/abdel-aouby) in https://github.com/laravel/laravel/pull/6572
* [12.x] Remove Unnecessarily [@source](https://github.com/source) by [@AhmedAlaa4611](https://github.com/AhmedAlaa4611) in https://github.com/laravel/laravel/pull/6584
## [v12.0.2](https://github.com/laravel/laravel/compare/v12.0.1...v12.0.2) - 2025-03-04
* Make the github test action run out of the box independent of the choice of testing framework by [@ndeblauw](https://github.com/ndeblauw) in https://github.com/laravel/laravel/pull/6555
## [v12.0.1](https://github.com/laravel/laravel/compare/v12.0.0...v12.0.1) - 2025-02-24
* [12.x] prefer stable stability by [@pataar](https://github.com/pataar) in https://github.com/laravel/laravel/pull/6548
## [v12.0.0 (2025-??-??)](https://github.com/laravel/laravel/compare/v11.0.2...v12.0.0)
Laravel 12 includes a variety of changes to the application skeleton. Please consult the diff to see what's new.

127
README.md Normal file
View File

@ -0,0 +1,127 @@
### **Пример приложения**
Код разделен на модули. Позволит проще распараллелить задачи между несколькими разработчиками. Позволит переиспользовать готовые модули в разных проектах.
Модули в папке ``./modules`` [Подробней](./modules/Readme.md)
Тесты в папке ``./tests``
### **Запуск тестов:**
Все тесты
``php artisan test``
Только юнит-тесты
``php artisan test --testsuite=Unit``
Конкретный тест
``php artisan test tests/Unit/UserTest.php``
С покрытием кода
``php artisan test --coverage``
### **В результате получаем**
#### **① Контроль над SQL-запросами**
**Проблема Eloquent:**
- Генерирует сложные SQL, которые трудно оптимизировать
- N+1 проблема (ленивая загрузка отношений)
**Решение:**
```php
public function getList(int $limit, int $offset, array $dsl = []): array
{
$data = $this->tasksQuery->select($dsl)->limit($limit, $offset)->all();
// ...
}
```
**Преимущества:**
- Явный контроль над запросами через `TasksQuery`
- Четкое разделение на простые запросы (`select()`, `limit()`)
- Нет "магии", которую трудно дебажить
---
#### **② Производительность**
**Проблема Eloquent:**
- Гибертность моделей (каждая сущность — объект с оверхедом)
- Проблемы с большими выборками
**Решение:**
```php
private function receiveAdditionalData(array &$data, array $dsl): void
{
if (in_array('options', $dsl)) {
$tasksIds = $this->pluck('id', $data);
$otherData = $this->otherQuery->getForTasks($tasksIds); // Один запрос для всех задач
// ...
}
}
```
**Преимущества:**
- Работа с массивами вместо объектов (меньше потребление памяти)
- Явная загрузка связанных данных за 1 запрос (не N+1)
---
#### **③ Тестируемость**
**Проблема Eloquent:**
- Трудно мокировать (глобальные scope, трейты)
- Зависимость от статики (`DB::shouldReceive`)
**Решение:**
```php
public function setTasksQuery(TasksQuery $query): void {
$this->tasksQuery = $query; // Легко подменить mock-объектом
}
```
**Преимущества:**
- Чистые зависимости (интерфейсы или конкретные классы)
- Проще писать unit-тесты
---
#### **④ Гибкость архитектуры**
**Проблема Eloquent:**
- Жесткая привязка к ActiveRecord
- Сложно разделить на слои (логика в моделях)
**Ваше решение:**
```php
class TasksStorage {
// Слой хранилища
private TasksQuery $tasksQuery; // Отдельный класс для запросов
private OtherQuery $otherQuery; // Отдельный класс для связей
}
```
**Преимущества:**
- Четкое разделение:
- `TasksQuery` — построение SQL
- `TasksStorage` — бизнес-логика доступа к данным
- DTO — передача данных между слоями
---
### **3. Наглядное сравнение**
| Критерий | Eloquent | Данный подход |
|-------------------|-------------------|-------------------|
| Производительность | Низкая (N+1, оверхед) | Высокая (оптимизированные запросы) |
| Тестируемость | Сложная | Простая (DI) |
| Контроль SQL | Ограниченный | Полный |
| Поддержка | Легкая для простых проектов | Лучше для сложных систем |
---
**Данный подход — это "прозрачность и контроль", где:**
- Каждая операция предсказуема
- Легко оптимизировать под нагрузку
- Архитектура готова к масштабированию

8
app/Http/Controllers/Controller.php Normal file
View File

@ -0,0 +1,8 @@
<?php
namespace App\Http\Controllers;
abstract class Controller
{
//
}

48
app/Models/User.php Normal file
View File

@ -0,0 +1,48 @@
<?php
namespace App\Models;
// use Illuminate\Contracts\Auth\MustVerifyEmail;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
class User extends Authenticatable
{
/** @use HasFactory<\Database\Factories\UserFactory> */
use HasFactory, Notifiable;
/**
* The attributes that are mass assignable.
*
* @var list<string>
*/
protected $fillable = [
'name',
'email',
'password',
];
/**
* The attributes that should be hidden for serialization.
*
* @var list<string>
*/
protected $hidden = [
'password',
'remember_token',
];
/**
* Get the attributes that should be cast.
*
* @return array<string, string>
*/
protected function casts(): array
{
return [
'email_verified_at' => 'datetime',
'password' => 'hashed',
];
}
}

24
app/Providers/AppServiceProvider.php Normal file
View File

@ -0,0 +1,24 @@
<?php
namespace App\Providers;
use Illuminate\Support\ServiceProvider;
class AppServiceProvider extends ServiceProvider
{
/**
* Register any application services.
*/
public function register(): void
{
//
}
/**
* Bootstrap any application services.
*/
public function boot(): void
{
//
}
}

18
artisan Executable file
View File

@ -0,0 +1,18 @@
#!/usr/bin/env php
<?php
use Illuminate\Foundation\Application;
use Symfony\Component\Console\Input\ArgvInput;
define('LARAVEL_START', microtime(true));
// Register the Composer autoloader...
require __DIR__.'/vendor/autoload.php';
// Bootstrap Laravel and handle the command...
/** @var Application $app */
$app = require_once __DIR__.'/bootstrap/app.php';
$status = $app->handleCommand(new ArgvInput);
exit($status);

18
bootstrap/app.php Normal file
View File

@ -0,0 +1,18 @@
<?php
use Illuminate\Foundation\Application;
use Illuminate\Foundation\Configuration\Exceptions;
use Illuminate\Foundation\Configuration\Middleware;
return Application::configure(basePath: dirname(__DIR__))
->withRouting(
web: __DIR__.'/../routes/web.php',
commands: __DIR__.'/../routes/console.php',
health: '/up',
)
->withMiddleware(function (Middleware $middleware): void {
//
})
->withExceptions(function (Exceptions $exceptions): void {
//
})->create();

2
bootstrap/cache/.gitignore vendored Normal file
View File

@ -0,0 +1,2 @@
*
!.gitignore

5
bootstrap/providers.php Normal file
View File

@ -0,0 +1,5 @@
<?php
return [
App\Providers\AppServiceProvider::class,
];

79
composer.json Normal file
View File

@ -0,0 +1,79 @@
{
"$schema": "https://getcomposer.org/schema.json",
"name": "laravel/laravel",
"type": "project",
"description": "The skeleton application for the Laravel framework.",
"keywords": [
"laravel",
"framework"
],
"license": "MIT",
"require": {
"php": "^8.2",
"laravel/framework": "^12.0",
"laravel/tinker": "^2.10.1"
},
"require-dev": {
"fakerphp/faker": "^1.23",
"laravel/pail": "^1.2.2",
"laravel/pint": "^1.13",
"laravel/sail": "^1.41",
"mockery/mockery": "^1.6",
"nunomaduro/collision": "^8.6",
"phpunit/phpunit": "^11.5"
},
"autoload": {
"psr-4": {
"App\\": "app/",
"Modules\\": "modules/",
"Database\\Factories\\": "database/factories/",
"Database\\Seeders\\": "database/seeders/"
}
},
"autoload-dev": {
"psr-4": {
"Tests\\": "tests/"
}
},
"scripts": {
"post-autoload-dump": [
"Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
"@php artisan package:discover --ansi"
],
"post-update-cmd": [
"@php artisan vendor:publish --tag=laravel-assets --ansi --force"
],
"post-root-package-install": [
"@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
],
"post-create-project-cmd": [
"@php artisan key:generate --ansi",
"@php -r \"file_exists('database/database.sqlite') || touch('database/database.sqlite');\"",
"@php artisan migrate --graceful --ansi"
],
"dev": [
"Composer\\Config::disableProcessTimeout",
"npx concurrently -c \"#93c5fd,#c4b5fd,#fb7185,#fdba74\" \"php artisan serve\" \"php artisan queue:listen --tries=1\" \"php artisan pail --timeout=0\" \"npm run dev\" --names=server,queue,logs,vite"
],
"test": [
"@php artisan config:clear --ansi",
"@php artisan test"
]
},
"extra": {
"laravel": {
"dont-discover": []
}
},
"config": {
"optimize-autoloader": true,
"preferred-install": "dist",
"sort-packages": true,
"allow-plugins": {
"pestphp/pest-plugin": true,
"php-http/discovery": true
}
},
"minimum-stability": "stable",
"prefer-stable": true
}

8105
composer.lock generated Normal file
View File

File diff suppressed because it is too large Load Diff

126
config/app.php Normal file
View File

@ -0,0 +1,126 @@
<?php
return [
/*
|--------------------------------------------------------------------------
| Application Name
|--------------------------------------------------------------------------
|
| This value is the name of your application, which will be used when the
| framework needs to place the application's name in a notification or
| other UI elements where an application name needs to be displayed.
|
*/
'name' => env('APP_NAME', 'Laravel'),
/*
|--------------------------------------------------------------------------
| Application Environment
|--------------------------------------------------------------------------
|
| This value determines the "environment" your application is currently
| running in. This may determine how you prefer to configure various
| services the application utilizes. Set this in your ".env" file.
|
*/
'env' => env('APP_ENV', 'production'),
/*
|--------------------------------------------------------------------------
| Application Debug Mode
|--------------------------------------------------------------------------
|
| When your application is in debug mode, detailed error messages with
| stack traces will be shown on every error that occurs within your
| application. If disabled, a simple generic error page is shown.
|
*/
'debug' => (bool) env('APP_DEBUG', false),
/*
|--------------------------------------------------------------------------
| Application URL
|--------------------------------------------------------------------------
|
| This URL is used by the console to properly generate URLs when using
| the Artisan command line tool. You should set this to the root of
| the application so that it's available within Artisan commands.
|
*/
'url' => env('APP_URL', 'http://localhost'),
/*
|--------------------------------------------------------------------------
| Application Timezone
|--------------------------------------------------------------------------
|
| Here you may specify the default timezone for your application, which
| will be used by the PHP date and date-time functions. The timezone
| is set to "UTC" by default as it is suitable for most use cases.
|
*/
'timezone' => 'UTC',
/*
|--------------------------------------------------------------------------
| Application Locale Configuration
|--------------------------------------------------------------------------
|
| The application locale determines the default locale that will be used
| by Laravel's translation / localization methods. This option can be
| set to any locale for which you plan to have translation strings.
|
*/
'locale' => env('APP_LOCALE', 'en'),
'fallback_locale' => env('APP_FALLBACK_LOCALE', 'en'),
'faker_locale' => env('APP_FAKER_LOCALE', 'en_US'),
/*
|--------------------------------------------------------------------------
| Encryption Key
|--------------------------------------------------------------------------
|
| This key is utilized by Laravel's encryption services and should be set
| to a random, 32 character string to ensure that all encrypted values
| are secure. You should do this prior to deploying the application.
|
*/
'cipher' => 'AES-256-CBC',
'key' => env('APP_KEY'),
'previous_keys' => [
...array_filter(
explode(',', (string) env('APP_PREVIOUS_KEYS', ''))
),
],
/*
|--------------------------------------------------------------------------
| Maintenance Mode Driver
|--------------------------------------------------------------------------
|
| These configuration options determine the driver used to determine and
| manage Laravel's "maintenance mode" status. The "cache" driver will
| allow maintenance mode to be controlled across multiple machines.
|
| Supported drivers: "file", "cache"
|
*/
'maintenance' => [
'driver' => env('APP_MAINTENANCE_DRIVER', 'file'),
'store' => env('APP_MAINTENANCE_STORE', 'database'),
],
];

115
config/auth.php Normal file
View File

@ -0,0 +1,115 @@
<?php
return [
/*
|--------------------------------------------------------------------------
| Authentication Defaults
|--------------------------------------------------------------------------
|
| This option defines the default authentication "guard" and password
| reset "broker" for your application. You may change these values
| as required, but they're a perfect start for most applications.
|
*/
'defaults' => [
'guard' => env('AUTH_GUARD', 'web'),
'passwords' => env('AUTH_PASSWORD_BROKER', 'users'),
],
/*
|--------------------------------------------------------------------------
| Authentication Guards
|--------------------------------------------------------------------------
|
| Next, you may define every authentication guard for your application.
| Of course, a great default configuration has been defined for you
| which utilizes session storage plus the Eloquent user provider.
|
| All authentication guards have a user provider, which defines how the
| users are actually retrieved out of your database or other storage
| system used by the application. Typically, Eloquent is utilized.
|
| Supported: "session"
|
*/
'guards' => [
'web' => [
'driver' => 'session',
'provider' => 'users',
],
],
/*
|--------------------------------------------------------------------------
| User Providers
|--------------------------------------------------------------------------
|
| All authentication guards have a user provider, which defines how the
| users are actually retrieved out of your database or other storage
| system used by the application. Typically, Eloquent is utilized.
|
| If you have multiple user tables or models you may configure multiple
| providers to represent the model / table. These providers may then
| be assigned to any extra authentication guards you have defined.
|
| Supported: "database", "eloquent"
|
*/
'providers' => [
'users' => [
'driver' => 'eloquent',
'model' => env('AUTH_MODEL', App\Models\User::class),
],
// 'users' => [
// 'driver' => 'database',
// 'table' => 'users',
// ],
],
/*
|--------------------------------------------------------------------------
| Resetting Passwords
|--------------------------------------------------------------------------
|
| These configuration options specify the behavior of Laravel's password
| reset functionality, including the table utilized for token storage
| and the user provider that is invoked to actually retrieve users.
|
| The expiry time is the number of minutes that each reset token will be
| considered valid. This security feature keeps tokens short-lived so
| they have less time to be guessed. You may change this as needed.
|
| The throttle setting is the number of seconds a user must wait before
| generating more password reset tokens. This prevents the user from
| quickly generating a very large amount of password reset tokens.
|
*/
'passwords' => [
'users' => [
'provider' => 'users',
'table' => env('AUTH_PASSWORD_RESET_TOKEN_TABLE', 'password_reset_tokens'),
'expire' => 60,
'throttle' => 60,
],
],
/*
|--------------------------------------------------------------------------
| Password Confirmation Timeout
|--------------------------------------------------------------------------
|
| Here you may define the number of seconds before a password confirmation
| window expires and users are asked to re-enter their password via the
| confirmation screen. By default, the timeout lasts for three hours.
|
*/
'password_timeout' => env('AUTH_PASSWORD_TIMEOUT', 10800),
];

108
config/cache.php Normal file
View File

@ -0,0 +1,108 @@
<?php
use Illuminate\Support\Str;
return [
/*
|--------------------------------------------------------------------------
| Default Cache Store
|--------------------------------------------------------------------------
|
| This option controls the default cache store that will be used by the
| framework. This connection is utilized if another isn't explicitly
| specified when running a cache operation inside the application.
|
*/
'default' => env('CACHE_STORE', 'database'),
/*
|--------------------------------------------------------------------------
| Cache Stores
|--------------------------------------------------------------------------
|
| Here you may define all of the cache "stores" for your application as
| well as their drivers. You may even define multiple stores for the
| same cache driver to group types of items stored in your caches.
|
| Supported drivers: "array", "database", "file", "memcached",
| "redis", "dynamodb", "octane", "null"
|
*/
'stores' => [
'array' => [
'driver' => 'array',
'serialize' => false,
],
'database' => [
'driver' => 'database',
'connection' => env('DB_CACHE_CONNECTION'),
'table' => env('DB_CACHE_TABLE', 'cache'),
'lock_connection' => env('DB_CACHE_LOCK_CONNECTION'),
'lock_table' => env('DB_CACHE_LOCK_TABLE'),
],
'file' => [
'driver' => 'file',
'path' => storage_path('framework/cache/data'),
'lock_path' => storage_path('framework/cache/data'),
],
'memcached' => [
'driver' => 'memcached',
'persistent_id' => env('MEMCACHED_PERSISTENT_ID'),
'sasl' => [
env('MEMCACHED_USERNAME'),
env('MEMCACHED_PASSWORD'),
],
'options' => [
// Memcached::OPT_CONNECT_TIMEOUT => 2000,
],
'servers' => [
[
'host' => env('MEMCACHED_HOST', '127.0.0.1'),
'port' => env('MEMCACHED_PORT', 11211),
'weight' => 100,
],
],
],
'redis' => [
'driver' => 'redis',
'connection' => env('REDIS_CACHE_CONNECTION', 'cache'),
'lock_connection' => env('REDIS_CACHE_LOCK_CONNECTION', 'default'),
],
'dynamodb' => [
'driver' => 'dynamodb',
'key' => env('AWS_ACCESS_KEY_ID'),
'secret' => env('AWS_SECRET_ACCESS_KEY'),
'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
'table' => env('DYNAMODB_CACHE_TABLE', 'cache'),
'endpoint' => env('DYNAMODB_ENDPOINT'),
],
'octane' => [
'driver' => 'octane',
],
],
/*
|--------------------------------------------------------------------------
| Cache Key Prefix
|--------------------------------------------------------------------------
|
| When utilizing the APC, database, memcached, Redis, and DynamoDB cache
| stores, there might be other applications using the same cache. For
| that reason, you may prefix every cache key to avoid collisions.
|
*/
'prefix' => env('CACHE_PREFIX', Str::slug((string) env('APP_NAME', 'laravel')).'-cache-'),
];

174
config/database.php Normal file
View File

@ -0,0 +1,174 @@
<?php
use Illuminate\Support\Str;
return [
/*
|--------------------------------------------------------------------------
| Default Database Connection Name
|--------------------------------------------------------------------------
|
| Here you may specify which of the database connections below you wish
| to use as your default connection for database operations. This is
| the connection which will be utilized unless another connection
| is explicitly specified when you execute a query / statement.
|
*/
'default' => env('DB_CONNECTION', 'sqlite'),
/*
|--------------------------------------------------------------------------
| Database Connections
|--------------------------------------------------------------------------
|
| Below are all of the database connections defined for your application.
| An example configuration is provided for each database system which
| is supported by Laravel. You're free to add / remove connections.
|
*/
'connections' => [
'sqlite' => [
'driver' => 'sqlite',
'url' => env('DB_URL'),
'database' => env('DB_DATABASE', database_path('database.sqlite')),
'prefix' => '',
'foreign_key_constraints' => env('DB_FOREIGN_KEYS', true),
'busy_timeout' => null,
'journal_mode' => null,
'synchronous' => null,
],
'mysql' => [
'driver' => 'mysql',
'url' => env('DB_URL'),
'host' => env('DB_HOST', '127.0.0.1'),
'port' => env('DB_PORT', '3306'),
'database' => env('DB_DATABASE', 'laravel'),
'username' => env('DB_USERNAME', 'root'),
'password' => env('DB_PASSWORD', ''),
'unix_socket' => env('DB_SOCKET', ''),
'charset' => env('DB_CHARSET', 'utf8mb4'),
'collation' => env('DB_COLLATION', 'utf8mb4_unicode_ci'),
'prefix' => '',
'prefix_indexes' => true,
'strict' => true,
'engine' => null,
'options' => extension_loaded('pdo_mysql') ? array_filter([
PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
]) : [],
],
'mariadb' => [
'driver' => 'mariadb',
'url' => env('DB_URL'),
'host' => env('DB_HOST', '127.0.0.1'),
'port' => env('DB_PORT', '3306'),
'database' => env('DB_DATABASE', 'laravel'),
'username' => env('DB_USERNAME', 'root'),
'password' => env('DB_PASSWORD', ''),
'unix_socket' => env('DB_SOCKET', ''),
'charset' => env('DB_CHARSET', 'utf8mb4'),
'collation' => env('DB_COLLATION', 'utf8mb4_unicode_ci'),
'prefix' => '',
'prefix_indexes' => true,
'strict' => true,
'engine' => null,
'options' => extension_loaded('pdo_mysql') ? array_filter([
PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
]) : [],
],
'pgsql' => [
'driver' => 'pgsql',
'url' => env('DB_URL'),
'host' => env('DB_HOST', '127.0.0.1'),
'port' => env('DB_PORT', '5432'),
'database' => env('DB_DATABASE', 'laravel'),
'username' => env('DB_USERNAME', 'root'),
'password' => env('DB_PASSWORD', ''),
'charset' => env('DB_CHARSET', 'utf8'),
'prefix' => '',
'prefix_indexes' => true,
'search_path' => 'public',
'sslmode' => 'prefer',
],
'sqlsrv' => [
'driver' => 'sqlsrv',
'url' => env('DB_URL'),
'host' => env('DB_HOST', 'localhost'),
'port' => env('DB_PORT', '1433'),
'database' => env('DB_DATABASE', 'laravel'),
'username' => env('DB_USERNAME', 'root'),
'password' => env('DB_PASSWORD', ''),
'charset' => env('DB_CHARSET', 'utf8'),
'prefix' => '',
'prefix_indexes' => true,
// 'encrypt' => env('DB_ENCRYPT', 'yes'),
// 'trust_server_certificate' => env('DB_TRUST_SERVER_CERTIFICATE', 'false'),
],
],
/*
|--------------------------------------------------------------------------
| Migration Repository Table
|--------------------------------------------------------------------------
|
| This table keeps track of all the migrations that have already run for
| your application. Using this information, we can determine which of
| the migrations on disk haven't actually been run on the database.
|
*/
'migrations' => [
'table' => 'migrations',
'update_date_on_publish' => true,
],
/*
|--------------------------------------------------------------------------
| Redis Databases
|--------------------------------------------------------------------------
|
| Redis is an open source, fast, and advanced key-value store that also
| provides a richer body of commands than a typical key-value system
| such as Memcached. You may define your connection settings here.
|
*/
'redis' => [
'client' => env('REDIS_CLIENT', 'phpredis'),
'options' => [
'cluster' => env('REDIS_CLUSTER', 'redis'),
'prefix' => env('REDIS_PREFIX', Str::slug((string) env('APP_NAME', 'laravel')).'-database-'),
'persistent' => env('REDIS_PERSISTENT', false),
],
'default' => [
'url' => env('REDIS_URL'),
'host' => env('REDIS_HOST', '127.0.0.1'),
'username' => env('REDIS_USERNAME'),
'password' => env('REDIS_PASSWORD'),
'port' => env('REDIS_PORT', '6379'),
'database' => env('REDIS_DB', '0'),
],
'cache' => [
'url' => env('REDIS_URL'),
'host' => env('REDIS_HOST', '127.0.0.1'),
'username' => env('REDIS_USERNAME'),
'password' => env('REDIS_PASSWORD'),
'port' => env('REDIS_PORT', '6379'),
'database' => env('REDIS_CACHE_DB', '1'),
],
],
];

80
config/filesystems.php Normal file
View File

@ -0,0 +1,80 @@
<?php
return [
/*
|--------------------------------------------------------------------------
| Default Filesystem Disk
|--------------------------------------------------------------------------
|
| Here you may specify the default filesystem disk that should be used
| by the framework. The "local" disk, as well as a variety of cloud
| based disks are available to your application for file storage.
|
*/
'default' => env('FILESYSTEM_DISK', 'local'),
/*
|--------------------------------------------------------------------------
| Filesystem Disks
|--------------------------------------------------------------------------
|
| Below you may configure as many filesystem disks as necessary, and you
| may even configure multiple disks for the same driver. Examples for
| most supported storage drivers are configured here for reference.
|
| Supported drivers: "local", "ftp", "sftp", "s3"
|
*/
'disks' => [
'local' => [
'driver' => 'local',
'root' => storage_path('app/private'),
'serve' => true,
'throw' => false,
'report' => false,
],
'public' => [
'driver' => 'local',
'root' => storage_path('app/public'),
'url' => env('APP_URL').'/storage',
'visibility' => 'public',
'throw' => false,
'report' => false,
],
's3' => [
'driver' => 's3',
'key' => env('AWS_ACCESS_KEY_ID'),
'secret' => env('AWS_SECRET_ACCESS_KEY'),
'region' => env('AWS_DEFAULT_REGION'),
'bucket' => env('AWS_BUCKET'),
'url' => env('AWS_URL'),
'endpoint' => env('AWS_ENDPOINT'),
'use_path_style_endpoint' => env('AWS_USE_PATH_STYLE_ENDPOINT', false),
'throw' => false,
'report' => false,
],
],
/*
|--------------------------------------------------------------------------
| Symbolic Links
|--------------------------------------------------------------------------
|
| Here you may configure the symbolic links that will be created when the
| `storage:link` Artisan command is executed. The array keys should be
| the locations of the links and the values should be their targets.
|
*/
'links' => [
public_path('storage') => storage_path('app/public'),
],
];

132
config/logging.php Normal file
View File

@ -0,0 +1,132 @@
<?php
use Monolog\Handler\NullHandler;
use Monolog\Handler\StreamHandler;
use Monolog\Handler\SyslogUdpHandler;
use Monolog\Processor\PsrLogMessageProcessor;
return [
/*
|--------------------------------------------------------------------------
| Default Log Channel
|--------------------------------------------------------------------------
|
| This option defines the default log channel that is utilized to write
| messages to your logs. The value provided here should match one of
| the channels present in the list of "channels" configured below.
|
*/
'default' => env('LOG_CHANNEL', 'stack'),
/*
|--------------------------------------------------------------------------
| Deprecations Log Channel
|--------------------------------------------------------------------------
|
| This option controls the log channel that should be used to log warnings
| regarding deprecated PHP and library features. This allows you to get
| your application ready for upcoming major versions of dependencies.
|
*/
'deprecations' => [
'channel' => env('LOG_DEPRECATIONS_CHANNEL', 'null'),
'trace' => env('LOG_DEPRECATIONS_TRACE', false),
],
/*
|--------------------------------------------------------------------------
| Log Channels
|--------------------------------------------------------------------------
|
| Here you may configure the log channels for your application. Laravel
| utilizes the Monolog PHP logging library, which includes a variety
| of powerful log handlers and formatters that you're free to use.
|
| Available drivers: "single", "daily", "slack", "syslog",
| "errorlog", "monolog", "custom", "stack"
|
*/
'channels' => [
'stack' => [
'driver' => 'stack',
'channels' => explode(',', (string) env('LOG_STACK', 'single')),
'ignore_exceptions' => false,
],
'single' => [
'driver' => 'single',
'path' => storage_path('logs/laravel.log'),
'level' => env('LOG_LEVEL', 'debug'),
'replace_placeholders' => true,
],
'daily' => [
'driver' => 'daily',
'path' => storage_path('logs/laravel.log'),
'level' => env('LOG_LEVEL', 'debug'),
'days' => env('LOG_DAILY_DAYS', 14),
'replace_placeholders' => true,
],
'slack' => [
'driver' => 'slack',
'url' => env('LOG_SLACK_WEBHOOK_URL'),
'username' => env('LOG_SLACK_USERNAME', 'Laravel Log'),
'emoji' => env('LOG_SLACK_EMOJI', ':boom:'),
'level' => env('LOG_LEVEL', 'critical'),
'replace_placeholders' => true,
],
'papertrail' => [
'driver' => 'monolog',
'level' => env('LOG_LEVEL', 'debug'),
'handler' => env('LOG_PAPERTRAIL_HANDLER', SyslogUdpHandler::class),
'handler_with' => [
'host' => env('PAPERTRAIL_URL'),
'port' => env('PAPERTRAIL_PORT'),
'connectionString' => 'tls://'.env('PAPERTRAIL_URL').':'.env('PAPERTRAIL_PORT'),
],
'processors' => [PsrLogMessageProcessor::class],
],
'stderr' => [
'driver' => 'monolog',
'level' => env('LOG_LEVEL', 'debug'),
'handler' => StreamHandler::class,
'handler_with' => [
'stream' => 'php://stderr',
],
'formatter' => env('LOG_STDERR_FORMATTER'),
'processors' => [PsrLogMessageProcessor::class],
],
'syslog' => [
'driver' => 'syslog',
'level' => env('LOG_LEVEL', 'debug'),
'facility' => env('LOG_SYSLOG_FACILITY', LOG_USER),
'replace_placeholders' => true,
],
'errorlog' => [
'driver' => 'errorlog',
'level' => env('LOG_LEVEL', 'debug'),
'replace_placeholders' => true,
],
'null' => [
'driver' => 'monolog',
'handler' => NullHandler::class,
],
'emergency' => [
'path' => storage_path('logs/laravel.log'),
],
],
];

118
config/mail.php Normal file
View File

@ -0,0 +1,118 @@
<?php
return [
/*
|--------------------------------------------------------------------------
| Default Mailer
|--------------------------------------------------------------------------
|
| This option controls the default mailer that is used to send all email
| messages unless another mailer is explicitly specified when sending
| the message. All additional mailers can be configured within the
| "mailers" array. Examples of each type of mailer are provided.
|
*/
'default' => env('MAIL_MAILER', 'log'),
/*
|--------------------------------------------------------------------------
| Mailer Configurations
|--------------------------------------------------------------------------
|
| Here you may configure all of the mailers used by your application plus
| their respective settings. Several examples have been configured for
| you and you are free to add your own as your application requires.
|
| Laravel supports a variety of mail "transport" drivers that can be used
| when delivering an email. You may specify which one you're using for
| your mailers below. You may also add additional mailers if needed.
|
| Supported: "smtp", "sendmail", "mailgun", "ses", "ses-v2",
| "postmark", "resend", "log", "array",
| "failover", "roundrobin"
|
*/
'mailers' => [
'smtp' => [
'transport' => 'smtp',
'scheme' => env('MAIL_SCHEME'),
'url' => env('MAIL_URL'),
'host' => env('MAIL_HOST', '127.0.0.1'),
'port' => env('MAIL_PORT', 2525),
'username' => env('MAIL_USERNAME'),
'password' => env('MAIL_PASSWORD'),
'timeout' => null,
'local_domain' => env('MAIL_EHLO_DOMAIN', parse_url((string) env('APP_URL', 'http://localhost'), PHP_URL_HOST)),
],
'ses' => [
'transport' => 'ses',
],
'postmark' => [
'transport' => 'postmark',
// 'message_stream_id' => env('POSTMARK_MESSAGE_STREAM_ID'),
// 'client' => [
// 'timeout' => 5,
// ],
],
'resend' => [
'transport' => 'resend',
],
'sendmail' => [
'transport' => 'sendmail',
'path' => env('MAIL_SENDMAIL_PATH', '/usr/sbin/sendmail -bs -i'),
],
'log' => [
'transport' => 'log',
'channel' => env('MAIL_LOG_CHANNEL'),
],
'array' => [
'transport' => 'array',
],
'failover' => [
'transport' => 'failover',
'mailers' => [
'smtp',
'log',
],
'retry_after' => 60,
],
'roundrobin' => [
'transport' => 'roundrobin',
'mailers' => [
'ses',
'postmark',
],
'retry_after' => 60,
],
],
/*
|--------------------------------------------------------------------------
| Global "From" Address
|--------------------------------------------------------------------------
|
| You may wish for all emails sent by your application to be sent from
| the same address. Here you may specify a name and address that is
| used globally for all emails that are sent by your application.
|
*/
'from' => [
'address' => env('MAIL_FROM_ADDRESS', 'hello@example.com'),
'name' => env('MAIL_FROM_NAME', 'Example'),
],
];

112
config/queue.php Normal file
View File

@ -0,0 +1,112 @@
<?php
return [
/*
|--------------------------------------------------------------------------
| Default Queue Connection Name
|--------------------------------------------------------------------------
|
| Laravel's queue supports a variety of backends via a single, unified
| API, giving you convenient access to each backend using identical
| syntax for each. The default queue connection is defined below.
|
*/
'default' => env('QUEUE_CONNECTION', 'database'),
/*
|--------------------------------------------------------------------------
| Queue Connections
|--------------------------------------------------------------------------
|
| Here you may configure the connection options for every queue backend
| used by your application. An example configuration is provided for
| each backend supported by Laravel. You're also free to add more.
|
| Drivers: "sync", "database", "beanstalkd", "sqs", "redis", "null"
|
*/
'connections' => [
'sync' => [
'driver' => 'sync',
],
'database' => [
'driver' => 'database',
'connection' => env('DB_QUEUE_CONNECTION'),
'table' => env('DB_QUEUE_TABLE', 'jobs'),
'queue' => env('DB_QUEUE', 'default'),
'retry_after' => (int) env('DB_QUEUE_RETRY_AFTER', 90),
'after_commit' => false,
],
'beanstalkd' => [
'driver' => 'beanstalkd',
'host' => env('BEANSTALKD_QUEUE_HOST', 'localhost'),
'queue' => env('BEANSTALKD_QUEUE', 'default'),
'retry_after' => (int) env('BEANSTALKD_QUEUE_RETRY_AFTER', 90),
'block_for' => 0,
'after_commit' => false,
],
'sqs' => [
'driver' => 'sqs',
'key' => env('AWS_ACCESS_KEY_ID'),
'secret' => env('AWS_SECRET_ACCESS_KEY'),
'prefix' => env('SQS_PREFIX', 'https://sqs.us-east-1.amazonaws.com/your-account-id'),
'queue' => env('SQS_QUEUE', 'default'),
'suffix' => env('SQS_SUFFIX'),
'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
'after_commit' => false,
],
'redis' => [
'driver' => 'redis',
'connection' => env('REDIS_QUEUE_CONNECTION', 'default'),
'queue' => env('REDIS_QUEUE', 'default'),
'retry_after' => (int) env('REDIS_QUEUE_RETRY_AFTER', 90),
'block_for' => null,
'after_commit' => false,
],
],
/*
|--------------------------------------------------------------------------
| Job Batching
|--------------------------------------------------------------------------
|
| The following options configure the database and table that store job
| batching information. These options can be updated to any database
| connection and table which has been defined by your application.
|
*/
'batching' => [
'database' => env('DB_CONNECTION', 'sqlite'),
'table' => 'job_batches',
],
/*
|--------------------------------------------------------------------------
| Failed Queue Jobs
|--------------------------------------------------------------------------
|
| These options configure the behavior of failed queue job logging so you
| can control how and where failed jobs are stored. Laravel ships with
| support for storing failed jobs in a simple file or in a database.
|
| Supported drivers: "database-uuids", "dynamodb", "file", "null"
|
*/
'failed' => [
'driver' => env('QUEUE_FAILED_DRIVER', 'database-uuids'),
'database' => env('DB_CONNECTION', 'sqlite'),
'table' => 'failed_jobs',
],
];

38
config/services.php Normal file
View File

@ -0,0 +1,38 @@
<?php
return [
/*
|--------------------------------------------------------------------------
| Third Party Services
|--------------------------------------------------------------------------
|
| This file is for storing the credentials for third party services such
| as Mailgun, Postmark, AWS and more. This file provides the de facto
| location for this type of information, allowing packages to have
| a conventional file to locate the various service credentials.
|
*/
'postmark' => [
'token' => env('POSTMARK_TOKEN'),
],
'resend' => [
'key' => env('RESEND_KEY'),
],
'ses' => [
'key' => env('AWS_ACCESS_KEY_ID'),
'secret' => env('AWS_SECRET_ACCESS_KEY'),
'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
],
'slack' => [
'notifications' => [
'bot_user_oauth_token' => env('SLACK_BOT_USER_OAUTH_TOKEN'),
'channel' => env('SLACK_BOT_USER_DEFAULT_CHANNEL'),
],
],
];

217
config/session.php Normal file
View File

@ -0,0 +1,217 @@
<?php
use Illuminate\Support\Str;
return [
/*
|--------------------------------------------------------------------------
| Default Session Driver
|--------------------------------------------------------------------------
|
| This option determines the default session driver that is utilized for
| incoming requests. Laravel supports a variety of storage options to
| persist session data. Database storage is a great default choice.
|
| Supported: "file", "cookie", "database", "memcached",
| "redis", "dynamodb", "array"
|
*/
'driver' => env('SESSION_DRIVER', 'database'),
/*
|--------------------------------------------------------------------------
| Session Lifetime
|--------------------------------------------------------------------------
|
| Here you may specify the number of minutes that you wish the session
| to be allowed to remain idle before it expires. If you want them
| to expire immediately when the browser is closed then you may
| indicate that via the expire_on_close configuration option.
|
*/
'lifetime' => (int) env('SESSION_LIFETIME', 120),
'expire_on_close' => env('SESSION_EXPIRE_ON_CLOSE', false),
/*
|--------------------------------------------------------------------------
| Session Encryption
|--------------------------------------------------------------------------
|
| This option allows you to easily specify that all of your session data
| should be encrypted before it's stored. All encryption is performed
| automatically by Laravel and you may use the session like normal.
|
*/
'encrypt' => env('SESSION_ENCRYPT', false),
/*
|--------------------------------------------------------------------------
| Session File Location
|--------------------------------------------------------------------------
|
| When utilizing the "file" session driver, the session files are placed
| on disk. The default storage location is defined here; however, you
| are free to provide another location where they should be stored.
|
*/
'files' => storage_path('framework/sessions'),
/*
|--------------------------------------------------------------------------
| Session Database Connection
|--------------------------------------------------------------------------
|
| When using the "database" or "redis" session drivers, you may specify a
| connection that should be used to manage these sessions. This should
| correspond to a connection in your database configuration options.
|
*/
'connection' => env('SESSION_CONNECTION'),
/*
|--------------------------------------------------------------------------
| Session Database Table
|--------------------------------------------------------------------------
|
| When using the "database" session driver, you may specify the table to
| be used to store sessions. Of course, a sensible default is defined
| for you; however, you're welcome to change this to another table.
|
*/
'table' => env('SESSION_TABLE', 'sessions'),
/*
|--------------------------------------------------------------------------
| Session Cache Store
|--------------------------------------------------------------------------
|
| When using one of the framework's cache driven session backends, you may
| define the cache store which should be used to store the session data
| between requests. This must match one of your defined cache stores.
|
| Affects: "dynamodb", "memcached", "redis"
|
*/
'store' => env('SESSION_STORE'),
/*
|--------------------------------------------------------------------------
| Session Sweeping Lottery
|--------------------------------------------------------------------------
|
| Some session drivers must manually sweep their storage location to get
| rid of old sessions from storage. Here are the chances that it will
| happen on a given request. By default, the odds are 2 out of 100.
|
*/
'lottery' => [2, 100],
/*
|--------------------------------------------------------------------------
| Session Cookie Name
|--------------------------------------------------------------------------
|
| Here you may change the name of the session cookie that is created by
| the framework. Typically, you should not need to change this value
| since doing so does not grant a meaningful security improvement.
|
*/
'cookie' => env(
'SESSION_COOKIE',
Str::snake((string) env('APP_NAME', 'laravel')).'_session'
),
/*
|--------------------------------------------------------------------------
| Session Cookie Path
|--------------------------------------------------------------------------
|
| The session cookie path determines the path for which the cookie will
| be regarded as available. Typically, this will be the root path of
| your application, but you're free to change this when necessary.
|
*/
'path' => env('SESSION_PATH', '/'),
/*
|--------------------------------------------------------------------------
| Session Cookie Domain
|--------------------------------------------------------------------------
|
| This value determines the domain and subdomains the session cookie is
| available to. By default, the cookie will be available to the root
| domain and all subdomains. Typically, this shouldn't be changed.
|
*/
'domain' => env('SESSION_DOMAIN'),
/*
|--------------------------------------------------------------------------
| HTTPS Only Cookies
|--------------------------------------------------------------------------
|
| By setting this option to true, session cookies will only be sent back
| to the server if the browser has a HTTPS connection. This will keep
| the cookie from being sent to you when it can't be done securely.
|
*/
'secure' => env('SESSION_SECURE_COOKIE'),
/*
|--------------------------------------------------------------------------
| HTTP Access Only
|--------------------------------------------------------------------------
|
| Setting this value to true will prevent JavaScript from accessing the
| value of the cookie and the cookie will only be accessible through
| the HTTP protocol. It's unlikely you should disable this option.
|
*/
'http_only' => env('SESSION_HTTP_ONLY', true),
/*
|--------------------------------------------------------------------------
| Same-Site Cookies
|--------------------------------------------------------------------------
|
| This option determines how your cookies behave when cross-site requests
| take place, and can be used to mitigate CSRF attacks. By default, we
| will set this value to "lax" to permit secure cross-site requests.
|
| See: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#samesitesamesite-value
|
| Supported: "lax", "strict", "none", null
|
*/
'same_site' => env('SESSION_SAME_SITE', 'lax'),
/*
|--------------------------------------------------------------------------
| Partitioned Cookies
|--------------------------------------------------------------------------
|
| Setting this value to true will tie the cookie to the top-level site for
| a cross-site context. Partitioned cookies are accepted by the browser
| when flagged "secure" and the Same-Site attribute is set to "none".
|
*/
'partitioned' => env('SESSION_PARTITIONED_COOKIE', false),
];

1
database/.gitignore vendored Normal file
View File

@ -0,0 +1 @@
*.sqlite*

44
database/factories/UserFactory.php Normal file
View File

@ -0,0 +1,44 @@
<?php
namespace Database\Factories;
use Illuminate\Database\Eloquent\Factories\Factory;
use Illuminate\Support\Facades\Hash;
use Illuminate\Support\Str;
/**
* @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\User>
*/
class UserFactory extends Factory
{
/**
* The current password being used by the factory.
*/
protected static ?string $password;
/**
* Define the model's default state.
*
* @return array<string, mixed>
*/
public function definition(): array
{
return [
'name' => fake()->name(),
'email' => fake()->unique()->safeEmail(),
'email_verified_at' => now(),
'password' => static::$password ??= Hash::make('password'),
'remember_token' => Str::random(10),
];
}
/**
* Indicate that the model's email address should be unverified.
*/
public function unverified(): static
{
return $this->state(fn (array $attributes) => [
'email_verified_at' => null,
]);
}
}

31
database/migrations/2025_07_17_120805_create_sessions_table.php Normal file
View File

@ -0,0 +1,31 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
return new class extends Migration
{
/**
* Run the migrations.
*/
public function up(): void
{
Schema::create('sessions', function (Blueprint $table) {
$table->string('id')->primary();
$table->foreignId('user_id')->nullable()->index();
$table->string('ip_address', 45)->nullable();
$table->text('user_agent')->nullable();
$table->longText('payload');
$table->integer('last_activity')->index();
});
}
/**
* Reverse the migrations.
*/
public function down(): void
{
Schema::dropIfExists('sessions');
}
};

28
database/migrations/2025_07_20_115826_create_tasks_table.php Normal file
View File

@ -0,0 +1,28 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
return new class extends Migration
{
/**
* Run the migrations.
*/
public function up(): void
{
Schema::create('tasks', function (Blueprint $table) {
$table->string('id', 255)->primary();
$table->string('title');
$table->integer('created_at', false, true);
});
}
/**
* Reverse the migrations.
*/
public function down(): void
{
Schema::dropIfExists('tasks');
}
};

23
database/seeders/DatabaseSeeder.php Normal file
View File

@ -0,0 +1,23 @@
<?php
namespace Database\Seeders;
use App\Models\User;
// use Illuminate\Database\Console\Seeds\WithoutModelEvents;
use Illuminate\Database\Seeder;
class DatabaseSeeder extends Seeder
{
/**
* Seed the application's database.
*/
public function run(): void
{
// User::factory(10)->create();
User::factory()->create([
'name' => 'Test User',
'email' => 'test@example.com',
]);
}
}

68
modules/ModulesProvider.php Normal file
View File

@ -0,0 +1,68 @@
<?php
namespace Modules;
use Modules\Tasks\Factory as TasksFactory;
use Modules\Tasks\Interfaces\IModulesProvider as ITasksModulesProvider;
use Modules\OtherModule\Factory as OtherModuleFactory;
use Modules\OtherModule\Interfaces\IModulesProvider as IOtherModulesProvider;
/**
* Класс ModulesProvider реализует интерфейсы провайдеров модулей.
* Служит централизованным поставщиком фабрик модулей с ленивой инициализацией.
*/
class ModulesProvider implements ITasksModulesProvider, IOtherModulesProvider
{
/** @var TasksFactory|null Экземпляр фабрики задач (ленивая инициализация) */
private ?TasksFactory $tasksFactory = null;
/** @var OtherModuleFactory|null Экземпляр фабрики другого модуля (ленивая инициализация) */
private ?OtherModuleFactory $otherModuleFactory = null;
/**
* Получает экземпляр фабрики задач.
* Реализует ленивую инициализацию (создание при первом обращении).
*
* @return TasksFactory Экземпляр фабрики задач
*/
public function getTasksModule(): TasksFactory
{
// Если фабрика уже создана - возвращаем её
if ($this->tasksFactory) {
return $this->tasksFactory;
}
// Ленивая инициализация фабрики
$this->tasksFactory = new TasksFactory();
// Настройка фабрики
$this->tasksFactory->loadSettings([
TasksFactory::TASKS_TABLE => 'tasks', // Установка таблицы задач
]);
// Инъекция зависимостей (передача текущего провайдера модулей)
$this->tasksFactory->injectModules($this);
return $this->tasksFactory;
}
/**
* Получает экземпляр фабрики другого модуля.
* Также использует ленивую инициализацию.
*
* @return OtherModuleFactory Экземпляр фабрики другого модуля
*/
public function getOtherModule(): OtherModuleFactory
{
// Если фабрика уже создана - возвращаем её
if ($this->otherModuleFactory) {
return $this->otherModuleFactory;
}
// Ленивая инициализация фабрики
$this->otherModuleFactory = new OtherModuleFactory();
return $this->otherModuleFactory;
}
}

10
modules/OtherModule/Factory.php Normal file
View File

@ -0,0 +1,10 @@
<?php
namespace Modules\OtherModule;
use Modules\OtherModule\Interfaces\IModulesProvider;
class Factory
{
private IModulesProvider $modulesProvider;
}

10
modules/OtherModule/Interfaces/IModulesProvider.php Normal file
View File

@ -0,0 +1,10 @@
<?php
namespace Modules\OtherModule\Interfaces;
use Modules\OtherModule\Factory;
interface IModulesProvider
{
public function getOtherModule(): Factory;
}

7
modules/Readme.md Normal file
View File

@ -0,0 +1,7 @@
В папку ``./Src`` я положил трейты с функциями общими для всех модулей в проекте
``Tasks`` - Папка с модулем. Собственно здесь это чисто для примера, чтобы наглядно показать как я разделяю проект на модули, и как модули могут взаимодействовать между собой. [Подробней](./Tasks/Readme.md)
``OtherModule`` - Пустой модуль для того, чтобы продемонстрировать взаимодействие между модулями. Собственно как вызвать одни модули из другого, пример тут: ``app/modules/Tasks/Infrastructure/Storage/Factory.php``
``ModulesProvider`` - Здесь происходит создание и инициализация модулей (внедрение зависимостей, загрузка настроек).

32
modules/Src/ResponsesCode.php Executable file
View File

@ -0,0 +1,32 @@
<?php
namespace Modules\Src;
abstract class ResponsesCode
{
/**
* Код ответа в случае внутренней ошибки сервера
*/
const SERVER_ERROR_CODE = 500;
/**
* Код ответа в случае если ресурс не найден
*/
const NOT_FOUND_CODE = 404;
/**
* Ошибка валидации или Unprocessable Entity
*/
const VALIDATION_FAILED_CODE = 422;
/**
* Неавторизованный юзер
*/
const NOT_AUTHORIZE_CODE = 401;
/**
* Все ок
*/
const OK_CODE = 200;
}

32
modules/Src/TraitDomain.php Executable file
View File

@ -0,0 +1,32 @@
<?php
namespace Modules\Src;
trait TraitDomain
{
/**
* Сообщения об ошибках
* @var array
*/
protected array $errors = [];
/**
* @var int код ответа
*/
protected int $responseCode = ResponsesCode::OK_CODE;
/**
* Сообщения об ошибках
* @return array
*/
public function getErrors(): array
{
return $this->errors;
}
public function getResponseCode(): int
{
return $this->responseCode;
}
}

53
modules/Src/TraitSqlQuery.php Normal file
View File

@ -0,0 +1,53 @@
<?php
namespace Modules\Src;
trait TraitSqlQuery
{
/**
* Формирует секцию селект
*
* @param array $fields
* @param array $allowFields
* @param string $table
* @param string $prefix
* @return array
*/
protected function getSelectSection(array $fields, array $allowFields, string $table, string $prefix = ''): array
{
$result = [];
if (empty($fields) || $fields[0] == '*') {
$fields = $allowFields;
}
foreach ($fields as $field) {
$alias = '';
if ($prefix) {
$alias = ' AS ' . $prefix . $field;
}
if (in_array($field, $allowFields)) {
$result[] = $table . '.' . $field . $alias;
}
}
return $result;
}
/**
* Добавить обязательные параметры
*
* @param array $fields
* @param array $requiredFields
* @return array
*/
protected function addRequiredFields(array $fields, array $requiredFields): array
{
if (empty($fields) || $fields[0] == '*') {
return $fields;
}
$stringsFields = array_filter($fields, function ($item) {
return gettype($item) != 'array';
});
$diff = array_diff($stringsFields, $requiredFields);
return array_merge($requiredFields, $diff);
}
}

88
modules/Src/TraitStorage.php Executable file
View File

@ -0,0 +1,88 @@
<?php
namespace Modules\Src;
trait TraitStorage
{
protected function pluck(string $key, array $array): array
{
$result = [];
$keySegments = explode('.', $key);
foreach ($keySegments as $keySegment) {
$result = [];
foreach ($array as $item) {
if (!key_exists($keySegment, $item)) {
continue;
}
if (is_array($item[$keySegment])) {
$result = array_merge($result, $item[$keySegment]);
} else {
$result[] = $item[$keySegment];
}
}
$array = $result;
}
return array_unique($result);
}
protected function arrayValues(array $keys, array $array): array
{
$result = [];
foreach ($keys as $key) {
if (key_exists($key, $array)) {
$result[] = $array[$key];
}
}
return $result;
}
public function groupBy(string $key, array $array, ?string $idField = null): array
{
$result = [];
foreach ($array as $item) {
$i = $item[$key];
if ($idField) {
$id = $item[$idField];
$result[$i][$id] = $item;
} else {
$result[$i][] = $item;
}
}
return $result;
}
public function appendFromRelations(array $array, array $relations, string $arrayKey, string $relKey, array $fields): array
{
$result = array_map(function ($item) use ($arrayKey, $relations, $relKey, $fields) {
$arrayId = $item[$arrayKey];
foreach ($relations as $rel) {
if ($rel[$relKey] == $arrayId) {
foreach ($fields as $field) {
$item[$field] = $rel[$field];
}
}
}
return $item;
}, $array);
return $result;
}
public function _appendFromRelations(array $array, array $relations, string $arrayKey, string $relKey, array $fields): array
{
$result = array_map(function ($item) use ($arrayKey, $relations, $relKey, $fields) {
$arrayId = $item[$arrayKey];
foreach ($relations as $rel) {
if ($rel[$relKey] == $arrayId) {
foreach ($fields as $alias => $field) {
$item[$alias][] = $rel[$field];
}
}
}
return $item;
}, $array);
return $result;
}
}

50
modules/Src/TraitValidator.php Executable file
View File

@ -0,0 +1,50 @@
<?php
namespace Modules\Src;
use Illuminate\Support\Facades\Validator as FacadeValidator;
trait TraitValidator
{
/**
* Сообщения об ошибках валидации
* @var array
*/
protected array $errors = [];
/**
* Проверенные и очищенные данные
* @var array
*/
protected array $cleanData = [];
/**
* Возвращает ошибки валидации
* @return array
*/
public function getErrors()
{
return $this->errors;
}
/**
* Возвращает проверенные и очищенные данные
* @return array
*/
public function getCleanData(): array
{
return $this->cleanData;
}
protected function validate(array $data, array $rules, array $messages): bool
{
$validator = FacadeValidator::make($data, $rules, $messages);
if ($validator->fails()) {
$this->errors = $validator->errors()->toArray();
return false;
}
$this->cleanData = $validator->validated();
return true;
}
}

185
modules/Tasks/Application/Api.php Normal file
View File

@ -0,0 +1,185 @@
<?php
namespace Modules\Tasks\Application;
use Modules\Src\TraitDomain;
use Modules\Src\ResponsesCode;
use Illuminate\Support\Facades\Log;
use Modules\Tasks\Infrastructure\Storage\TasksStorage;
use Modules\Tasks\Dto\Factory as DtoFactory;
use Modules\Tasks\Infrastructure\DBPersistLayer\TasksLayer;
/**
* Класс Api - основной рабочий класс для операций с задачами.
* Обеспечивает взаимодействие между:
* - Валидацией входных данных
* - Преобразованием DTO
* - Хранением данных
*/
class Api
{
// Используем трейт для общих методов
use TraitDomain;
// Валидатор входных данных
private Validator $validator;
// Хранилище задач (доступ к данным)
private TasksStorage $tasksStorage;
// Фабрика для создания DTO объектов
private DtoFactory $dtoFactory;
// Слой персистентности (работа с БД)
private TasksLayer $tasksLayer;
// Внутренний кеш задач
private array $tasks = [];
/**
* Установка валидатора (внедрение зависимости)
*/
public function setValidator(Validator $validator): void
{
$this->validator = $validator;
}
/**
* Установка хранилища задач (внедрение зависимости)
*/
public function setTasksStorage(TasksStorage $storage): void
{
$this->tasksStorage = $storage;
}
/**
* Установка фабрики DTO (внедрение зависимости)
*/
public function setDtoFactory(DtoFactory $factory): void
{
$this->dtoFactory = $factory;
}
/**
* Установка слоя персистентности (внедрение зависимости)
*/
public function setTasksLayer(TasksLayer $layer): void
{
$this->tasksLayer = $layer;
}
/**
* Создание новой задачи
* @param array $data Входные данные
* @return bool Успешность операции
*/
public function insert(array $data): bool
{
// Валидация входных данных
if (!$this->validator->insert($data)) {
$this->responseCode = ResponsesCode::VALIDATION_FAILED_CODE;
$this->errors = $this->validator->getErrors();
return false;
}
try {
// Получение очищенных данных после валидации
$cleanData = $this->validator->getCleanData();
// Создание DTO для сохранения
$task = $this->dtoFactory->createTaskPersist();
$task->load($cleanData);
// Сохранение в БД
$this->tasksLayer->insert($task);
return true;
} catch (\Throwable $e) {
// Логирование ошибок
Log::error($e);
$this->errors['except'][] = $e->getMessage();
return false;
}
}
/**
* Получение задачи по ID
* @param array $data Входные данные (должен содержать 'id')
* @return bool Успешность операции
*/
public function getById(array $data): bool
{
// Валидация входных данных
if (!$this->validator->getById($data)) {
$this->responseCode = ResponsesCode::VALIDATION_FAILED_CODE;
$this->errors = $this->validator->getErrors();
return false;
}
try {
// Получение очищенных данных
$cleanData = $this->validator->getCleanData();
$id = $cleanData['id'];
// Получение данных из хранилища
$taskData = $this->tasksStorage->getById($id, ['*', 'options']);
// Создание DTO и добавление в кеш
$task = $this->dtoFactory->createTaskResource();
$task->load($taskData);
$this->tasks[$task->getId()] = $task;
return true;
} catch (\Throwable $e) {
Log::error($e);
$this->errors['except'][] = $e->getMessage();
return false;
}
}
/**
* Получение списка задач с пагинацией
* @param array $data Входные данные (должны содержать 'limit' и 'offset')
* @return bool Успешность операции
*/
public function getList(array $data): bool
{
// Валидация входных данных
if (!$this->validator->getList($data)) {
$this->responseCode = ResponsesCode::VALIDATION_FAILED_CODE;
$this->errors = $this->validator->getErrors();
return false;
}
try {
// Получение параметров пагинации
$cleanData = $this->validator->getCleanData();
$limit = $cleanData['limit'];
$offset = $cleanData['offset'];
// Получение списка из хранилища
$tasksData = $this->tasksStorage->getList($limit, $offset, ['*', 'options']);
// Преобразование в DTO и сохранение в кеш
foreach ($tasksData as $taskData) {
$task = $this->dtoFactory->createTaskResource();
$task->load($taskData);
$this->tasks[$task->getId()] = $task;
}
return true;
} catch (\Throwable $e) {
Log::error($e);
$this->errors['except'][] = $e->getMessage();
return false;
}
}
/**
* Получение кешированных задач
* @return array Массив задач
*/
public function getTasks(): array
{
return $this->tasks;
}
}

40
modules/Tasks/Application/Factory.php Normal file
View File

@ -0,0 +1,40 @@
<?php
namespace Modules\Tasks\Application;
use Modules\Tasks\Factory as ModuleFactory;
class Factory
{
private ModuleFactory $moduleFactory;
private ?Api $api = null;
public function setModuleFactory(ModuleFactory $moduleFactory): void
{
$this->moduleFactory = $moduleFactory;
}
private function createValidator(): Validator
{
return new Validator();
}
public function getApi(): Api
{
if ($this->api) {
return $this->api;
}
$this->api = new Api();
$validator = $this->createValidator();
$this->api->setValidator($validator);
$tasksStorage = $this->moduleFactory->getInfrastructureFactory()->getStorageFactory()->getTasksStorage();
$this->api->setTasksStorage($tasksStorage);
$dtoFactory = $this->moduleFactory->getDtoFactory();
$this->api->setDtoFactory($dtoFactory);
$tasksLayer = $this->moduleFactory->getInfrastructureFactory()->getDBPersistLayerFactory()->getTasksLayer();
$this->api->setTasksLayer($tasksLayer);
return $this->api;
}
}

88
modules/Tasks/Application/Validator.php Normal file
View File

@ -0,0 +1,88 @@
<?php
namespace Modules\Tasks\Application;
use Modules\Src\TraitValidator;
/**
* Класс Validator - валидатор входных данных для операций с задачами.
* Использует трейт TraitValidator для базовой функциональности валидации.
* Реализует проверку данных для различных операций API.
*/
class Validator
{
// Используем трейт с базовой логикой валидации
use TraitValidator;
/**
* Валидация данных для создания задачи
*
* @param array $data Входные данные
* @return bool Результат валидации (true - успешно)
*
* Правила валидации:
* - title: обязательное поле
*/
public function insert(array $data): bool
{
$rules = [
'title' => [
'required' // Поле title обязательно для заполнения
],
];
// Сообщения об ошибках (можно кастомизировать)
$messages = [];
// Вызов базового метода валидации из трейта
return $this->validate($data, $rules, $messages);
}
/**
* Валидация данных для получения задачи по ID
*
* @param array $data Входные данные
* @return bool Результат валидации
*
* Правила валидации:
* - id: обязательное поле
*/
public function getById(array $data): bool
{
$rules = [
'id' => [
'required' // Поле id обязательно для заполнения
],
];
$messages = [];
return $this->validate($data, $rules, $messages);
}
/**
* Валидация данных для получения списка задач
*
* @param array $data Входные данные
* @return bool Результат валидации
*
* Правила валидации:
* - limit: обязательное поле (ограничение выборки)
* - offset: обязательное поле (смещение в выборке)
*/
public function getList(array $data): bool
{
$rules = [
'limit' => [
'required' // Параметр limit обязателен для пагинации
],
'offset' => [
'required' // Параметр offset обязателен для пагинации
],
];
$messages = [];
return $this->validate($data, $rules, $messages);
}
}

26
modules/Tasks/Dto/Factory.php Normal file
View File

@ -0,0 +1,26 @@
<?php
namespace Modules\Tasks\Dto;
use Modules\Tasks\Factory as ModuleFactory;
class Factory
{
private ModuleFactory $moduleFactory;
public function setModuleFactory(ModuleFactory $moduleFactory): void
{
$this->moduleFactory = $moduleFactory;
}
public function createTaskResource(): TaskResource
{
return new TaskResource();
}
public function createTaskPersist(): TaskPersist
{
return new TaskPersist();
}
}

24
modules/Tasks/Dto/TaskPersist.php Normal file
View File

@ -0,0 +1,24 @@
<?php
namespace Modules\Tasks\Dto;
class TaskPersist
{
use TaskTrait;
public function loadOptions(array $data): void {}
public function getInsertAttrs(): array
{
$this->createdAt = time();
if (!$this->id) {
$this->id = uniqid('task_');
}
return [
'id' => $this->id,
'title' => $this->title,
'created_at' => $this->createdAt,
];
}
}

24
modules/Tasks/Dto/TaskResource.php Normal file
View File

@ -0,0 +1,24 @@
<?php
namespace Modules\Tasks\Dto;
class TaskResource
{
use TaskTrait;
public function loadOptions(array $data): void
{
$this->options = $data;
}
public function getApiView(): array
{
return [
'id' => $this->id,
'title' => $this->title,
'options' => $this->options,
'createdAt' => $this->createdAt,
];
}
}

32
modules/Tasks/Dto/TaskTrait.php Normal file
View File

@ -0,0 +1,32 @@
<?php
namespace Modules\Tasks\Dto;
trait TaskTrait
{
protected ?string $id = null;
protected ?string $title = null;
protected ?int $createdAt = null;
protected array $options = [];
public function getId(): ?string
{
return $this->id;
}
public function load(array $data): void
{
$this->id = $data['id'] ?? null;
$this->title = $data['title'] ?? null;
$this->createdAt = $data['created_at'] ?? null;
if (key_exists('options', $data)) {
$this->loadOptions($data['options']);
}
}
abstract public function loadOptions(array $data): void;
}

75
modules/Tasks/Factory.php Normal file
View File

@ -0,0 +1,75 @@
<?php
namespace Modules\Tasks;
use Modules\Tasks\Interfaces\IModulesProvider;
use Modules\Tasks\Application\Factory as AppFactory;
use Modules\Tasks\Infrastructure\Factory as InfrastructureFactory;
use Modules\Tasks\Dto\Factory as DtoFactory;
class Factory
{
const TASKS_TABLE = 'tasks_table';
private array $settings = [];
private IModulesProvider $modulesProvider;
private ?AppFactory $appFactory = null;
private ?InfrastructureFactory $infrastructureFactory = null;
private ?DtoFactory $dtoFactory = null;
public function loadSettings(array $settings): void
{
$this->settings = $settings;
}
public function getSetting(string $key)
{
return $this->settings[$key];
}
public function injectModules(IModulesProvider $provider): void
{
// Так сделано для предотвращения проблем с циклической зависимостью
$this->modulesProvider = $provider;
}
public function getModulesProvider(): IModulesProvider
{
return $this->modulesProvider;
}
public function getApplicationFactory(): AppFactory
{
if ($this->appFactory) {
return $this->appFactory;
}
$this->appFactory = new AppFactory();
$this->appFactory->setModuleFactory($this);
return $this->appFactory;
}
public function getInfrastructureFactory(): InfrastructureFactory
{
if ($this->infrastructureFactory) {
return $this->infrastructureFactory;
}
$this->infrastructureFactory = new InfrastructureFactory();
$this->infrastructureFactory->setModuleFactory($this);
return $this->infrastructureFactory;
}
public function getDtoFactory(): DtoFactory
{
if ($this->dtoFactory) {
return $this->dtoFactory;
}
$this->dtoFactory = new DtoFactory;
$this->dtoFactory->setModuleFactory($this);
return $this->dtoFactory;
}
}

30
modules/Tasks/Infrastructure/DBPersistLayer/Factory.php Normal file
View File

@ -0,0 +1,30 @@
<?php
namespace Modules\Tasks\Infrastructure\DBPersistLayer;
use Modules\Tasks\Infrastructure\Factory as InfrastructureFactory;
use Modules\Tasks\Factory as ModuleFactory;
class Factory
{
private InfrastructureFactory $infFactory;
private ?TasksLayer $tasksLayer = null;
public function setInfrastructureFactory(InfrastructureFactory $factory): void
{
$this->infFactory = $factory;
}
public function getTasksLayer(): TasksLayer
{
if ($this->tasksLayer) {
return $this->tasksLayer;
}
$this->tasksLayer = new TasksLayer;
$table = $this->infFactory->getModuleFactory()->getSetting(ModuleFactory::TASKS_TABLE);
$this->tasksLayer->setTable($table);
return $this->tasksLayer;
}
}

24
modules/Tasks/Infrastructure/DBPersistLayer/TasksLayer.php Normal file
View File

@ -0,0 +1,24 @@
<?php
namespace Modules\Tasks\Infrastructure\DBPersistLayer;
use Illuminate\Support\Facades\DB;
use Modules\Tasks\Dto\TaskPersist;
class TasksLayer
{
private string $table;
public function setTable(string $table): void
{
$this->table = $table;
}
public function insert(TaskPersist $dto): void
{
$qb = DB::table($this->table);
$attrs = $dto->getInsertAttrs();
$qb->insert($attrs);
}
}

25
modules/Tasks/Infrastructure/DBQueries/Factory.php Normal file
View File

@ -0,0 +1,25 @@
<?php
namespace Modules\Tasks\Infrastructure\DBQueries;
use Modules\Tasks\Infrastructure\Factory as InfrastructureFactory;
use Modules\Tasks\Factory as ModuleFactory;
class Factory
{
private InfrastructureFactory $infFactory;
public function setInfrastructureFactory(InfrastructureFactory $factory): void
{
$this->infFactory = $factory;
}
public function createTasksQuery(): TasksQuery
{
$query = new TasksQuery();
$table = $this->infFactory->getModuleFactory()->getSetting(ModuleFactory::TASKS_TABLE);
$query->setTable($table);
return $query;
}
}

59
modules/Tasks/Infrastructure/DBQueries/TasksQuery.php Normal file
View File

@ -0,0 +1,59 @@
<?php
namespace Modules\Tasks\Infrastructure\DBQueries;
use Modules\Src\TraitSqlQuery;
use Illuminate\Support\Facades\DB;
use Illuminate\Database\Query\Builder;
class TasksQuery
{
use TraitSqlQuery;
private string $table;
private Builder $queryBuilder;
public function setTable(string $table): void
{
$this->table = $table;
}
public function select(array $fields = []): self
{
$allowFields = ['id', 'title', 'created_at',];
$select = $this->getSelectSection($fields, $allowFields, $this->table);
$this->queryBuilder = DB::table($this->table);
$this->queryBuilder->select($select);
return $this;
}
public function whereId(string $id): self
{
$this->queryBuilder->where($this->table . '.id', '=', $id);
return $this;
}
public function limit(int $limit, int $offset): self
{
$this->queryBuilder->limit($limit)->offset($offset);
return $this;
}
public function all(): array
{
$result = [];
foreach ($this->queryBuilder->get()->all() as $row) {
$result[$row->id] = $row;
}
return json_decode(json_encode($result), true);
}
public function one(): array
{
$result = $this->queryBuilder->first() ?? [];
$result = json_decode(json_encode($result), true);
return $result;
}
}

72
modules/Tasks/Infrastructure/Factory.php Normal file
View File

@ -0,0 +1,72 @@
<?php
namespace Modules\Tasks\Infrastructure;
use Modules\Tasks\Factory as ModuleFactory;
use Modules\Tasks\Infrastructure\DBQueries\Factory as DBQueriesFactory;
use Modules\Tasks\Infrastructure\OtherQueries\Factory as OtherQueriesFactory;
use Modules\Tasks\Infrastructure\Storage\Factory as StorageFactory;
use Modules\Tasks\Infrastructure\DBPersistLayer\Factory as DBPersistLayerFactory;
class Factory
{
private ModuleFactory $moduleFactory;
private ?DBQueriesFactory $dbQueriesFactory = null;
private ?OtherQueriesFactory $otherQueriesFactory = null;
private ?StorageFactory $storageFactory = null;
private ?DBPersistLayerFactory $dbPersistLayerFactory = null;
public function setModuleFactory(ModuleFactory $moduleFactory): void
{
$this->moduleFactory = $moduleFactory;
}
public function getModuleFactory(): ModuleFactory
{
return $this->moduleFactory;
}
public function getDBQueriesFactory(): DBQueriesFactory
{
if ($this->dbQueriesFactory) {
return $this->dbQueriesFactory;
}
$this->dbQueriesFactory = new DBQueriesFactory();
$this->dbQueriesFactory->setInfrastructureFactory($this);
return $this->dbQueriesFactory;
}
public function getOtherQueriesFactory(): OtherQueriesFactory
{
if ($this->otherQueriesFactory) {
return $this->otherQueriesFactory;
}
$this->otherQueriesFactory = new OtherQueriesFactory();
return $this->otherQueriesFactory;
}
public function getStorageFactory(): StorageFactory
{
if ($this->storageFactory) {
return $this->storageFactory;
}
$this->storageFactory = new StorageFactory;
$this->storageFactory->setInfrastructureFactory($this);
return $this->storageFactory;
}
public function getDBPersistLayerFactory(): DBPersistLayerFactory
{
if ($this->dbPersistLayerFactory) {
return $this->dbPersistLayerFactory;
}
$this->dbPersistLayerFactory = new DBPersistLayerFactory;
$this->dbPersistLayerFactory->setInfrastructureFactory($this);
return $this->dbPersistLayerFactory;
}
}

23
modules/Tasks/Infrastructure/OtherQueries/Factory.php Normal file
View File

@ -0,0 +1,23 @@
<?php
namespace Modules\Tasks\Infrastructure\OtherQueries;
use Modules\Tasks\Infrastructure\Factory as InfrastructureFactory;
use Modules\Tasks\Factory as ModuleFactory;
class Factory
{
private InfrastructureFactory $infFactory;
public function setInfrastructureFactory(InfrastructureFactory $factory): void
{
$this->infFactory = $factory;
}
public function createTasksQuery(): OtherQuery
{
$query = new OtherQuery();
return $query;
}
}

23
modules/Tasks/Infrastructure/OtherQueries/OtherQuery.php Normal file
View File

@ -0,0 +1,23 @@
<?php
namespace Modules\Tasks\Infrastructure\OtherQueries;
class OtherQuery
{
private array $data = [
[
'key' => 'owner',
'value' => 'status',
],
];
public function getForTasks(array $tasksIds): array
{
$result = [];
foreach ($tasksIds as $taskId) {
$result[$taskId] = $this->data;
}
return $this->data;
}
}

7
modules/Tasks/Infrastructure/Readme.md Normal file
View File

@ -0,0 +1,7 @@
``DBPersistLayer`` - Здесь классы в которых описаны методы записи данных в хранилища.
``DBQueries`` - Здесь классы с методами для формирования запросов к SQL БД
``OtherQueries`` - Здесь классы с методами для запроса данных из других хранилищ. В данном случае заглушка для демонстрации идеи.
``Storage`` - Здесь мы собираем данные полученные из нескольких источников для дальнейшей обработки

34
modules/Tasks/Infrastructure/Storage/Factory.php Normal file
View File

@ -0,0 +1,34 @@
<?php
namespace Modules\Tasks\Infrastructure\Storage;
use Modules\Tasks\Infrastructure\Factory as InfrastructureFactory;
use Modules\Tasks\Factory as ModuleFactory;
class Factory
{
private ?TasksStorage $tasksStorage = null;
private InfrastructureFactory $infFactory;
public function setInfrastructureFactory(InfrastructureFactory $factory): void
{
$this->infFactory = $factory;
}
public function getTasksStorage(): TasksStorage
{
if ($this->tasksStorage) {
return $this->tasksStorage;
}
$this->tasksStorage = new TasksStorage;
$tasksQuery = $this->infFactory->getDBQueriesFactory()->createTasksQuery();
$this->tasksStorage->setTasksQuery($tasksQuery);
$otherQuery = $this->infFactory->getOtherQueriesFactory()->createTasksQuery();
$this->tasksStorage->setOtherQuery($otherQuery);
// Если нам потребуется что-то из соседнего модуля, то:
// $otherModule = $this->infFactory->getModuleFactory()->getModulesProvider()->getOtherModule();
return $this->tasksStorage;
}
}

90
modules/Tasks/Infrastructure/Storage/TasksStorage.php Normal file
View File

@ -0,0 +1,90 @@
<?php
namespace Modules\Tasks\Infrastructure\Storage;
use Modules\Src\TraitStorage;
use Modules\Tasks\Infrastructure\DBQueries\TasksQuery;
use Modules\Tasks\Infrastructure\OtherQueries\OtherQuery;
/**
* Класс TasksStorage - репозиторий для работы с задачами.
* Обеспечивает:
* - Получение списка задач с пагинацией
* - Получение конкретной задачи по ID
* - Загрузку дополнительных связанных данных
*/
class TasksStorage
{
// Используем трейт с общими методами работы с хранилищем
use TraitStorage;
// Запросы к основной таблице задач
private TasksQuery $tasksQuery;
// Запросы для получения дополнительных данных
private OtherQuery $otherQuery;
/**
* Установка сервиса запросов к задачам
*/
public function setTasksQuery(TasksQuery $query): void
{
$this->tasksQuery = $query;
}
/**
* Установка сервиса запросов к дополнительным данным
*/
public function setOtherQuery(OtherQuery $query): void
{
$this->otherQuery = $query;
}
/**
* Получение списка задач с пагинацией
*
* @param int $limit - количество записей
* @param int $offset - смещение
* @param array $dsl - запрашиваемые поля и прочие правила для сборки данных (включая дополнительные данные)
* @return array - массив задач
*/
public function getList(int $limit, int $offset, array $dsl = []): array
{
$data = $this->tasksQuery->select($dsl)->limit($limit, $offset)->all();
$this->receiveAdditionalData($data, $dsl);
return $data;
}
/**
* Получение задачи по ID
*
* @param string $id - идентификатор задачи
* @param array $dsl - запрашиваемые поля и прочие правила для сборки данных
* @return array - данные задачи
*/
public function getById(string $id, array $dsl): array
{
$data = $this->tasksQuery->select($dsl)->whereId($id)->all();
$this->receiveAdditionalData($data, $dsl);
return array_pop($data) ?? [];
}
/**
* Загрузка дополнительных данных для задач
*
* @param array &$data - ссылка на массив задач (для модификации)
* @param array $dsl - запрашиваемые поля и прочие правила для сборки данных (определяет какие данные подгружать)
*/
private function receiveAdditionalData(array &$data, array $dsl): void
{
if (in_array('options', $dsl)) {
$tasksIds = $this->pluck('id', $data);
$otherData = $this->otherQuery->getForTasks($tasksIds);
foreach ($data as &$row) {
// $myOtherData = $otherData[$row['id']] ?? []; // Правильная реализация была бы такой
$myOtherData = $otherData[0]; // Текущая упрощенная реализация
$row['options'] = $myOtherData;
}
}
}
}

12
modules/Tasks/Interfaces/IModulesProvider.php Normal file
View File

@ -0,0 +1,12 @@
<?php
namespace Modules\Tasks\Interfaces;
use Modules\Tasks\Factory;
use Modules\OtherModule\Factory as OtherModuleFactory;
interface IModulesProvider
{
public function getTasksModule(): Factory;
public function getOtherModule(): OtherModuleFactory;
}

9
modules/Tasks/Readme.md Normal file
View File

@ -0,0 +1,9 @@
Модуль на слои делим, грубо говоря
``Application`` - Здесь у нас классы для валидации входящих данных, классы с логикой обработки этих данных (мы тут какбы решаем куда их отправить дальше).
``Dto`` - Тут классы в которых реализуем обработку данных, разные расчеты, преобразования, перед тем, как отдать пользователю, или сохранить в БД или еще где. Грубо говоря описывается логика програмных сущностей, в данном случае тасков
``Infrastructure`` - Тут классы в которых реализованна работа с хранилищами данных, запросы к SQL базам, к elastic, может часть данных какой-либо сущности у нас кешируется, а часть нет. [Подробней](./Infrastructure/Readme.md)
``Interfaces`` - Собственно интерфейсы, те которые нужны, на каждый класс писать интерфейс конечно врядли смысл имеется.

17
package.json Normal file
View File

@ -0,0 +1,17 @@
{
"$schema": "https://json.schemastore.org/package.json",
"private": true,
"type": "module",
"scripts": {
"build": "vite build",
"dev": "vite"
},
"devDependencies": {
"@tailwindcss/vite": "^4.0.0",
"axios": "^1.8.2",
"concurrently": "^9.0.1",
"laravel-vite-plugin": "^1.2.0",
"tailwindcss": "^4.0.0",
"vite": "^6.2.4"
}
}

39
phpunit.xml Normal file
View File

@ -0,0 +1,39 @@
<?xml version="1.0" encoding="UTF-8"?>
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
bootstrap="vendor/autoload.php"
colors="true"
>
<testsuites>
<testsuite name="Unit">
<directory>tests/Unit</directory>
</testsuite>
<testsuite name="Feature">
<directory>tests/Feature</directory>
</testsuite>
</testsuites>
<source>
<include>
<directory>app</directory>
</include>
</source>
<php>
<env name="APP_ENV" value="testing"/>
<env name="APP_MAINTENANCE_DRIVER" value="file"/>
<env name="BCRYPT_ROUNDS" value="4"/>
<env name="CACHE_STORE" value="array"/>
<env name="DB_CONNECTION" value="mysql"/>
<env name="DB_HOST" value="db"/>
<env name="DB_PORT" value="3306"/>
<env name="DB_DATABASE" value="dbname"/>
<env name="DB_USERNAME" value="user"/>
<env name="DB_PASSWORD" value="password"/>
<env name="DB_DATABASE" value=":memory:"/>
<env name="MAIL_MAILER" value="array"/>
<env name="QUEUE_CONNECTION" value="sync"/>
<env name="SESSION_DRIVER" value="array"/>
<env name="PULSE_ENABLED" value="false"/>
<env name="TELESCOPE_ENABLED" value="false"/>
<env name="NIGHTWATCH_ENABLED" value="false"/>
</php>
</phpunit>

25
public/.htaccess Normal file
View File

@ -0,0 +1,25 @@
<IfModule mod_rewrite.c>
<IfModule mod_negotiation.c>
Options -MultiViews -Indexes
</IfModule>
RewriteEngine On
# Handle Authorization Header
RewriteCond %{HTTP:Authorization} .
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
# Handle X-XSRF-Token Header
RewriteCond %{HTTP:x-xsrf-token} .
RewriteRule .* - [E=HTTP_X_XSRF_TOKEN:%{HTTP:X-XSRF-Token}]
# Redirect Trailing Slashes If Not A Folder...
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} (.+)/$
RewriteRule ^ %1 [L,R=301]
# Send Requests To Front Controller...
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]
</IfModule>

0
public/favicon.ico Normal file
View File

20
public/index.php Normal file
View File

@ -0,0 +1,20 @@
<?php
use Illuminate\Foundation\Application;
use Illuminate\Http\Request;
define('LARAVEL_START', microtime(true));
// Determine if the application is in maintenance mode...
if (file_exists($maintenance = __DIR__.'/../storage/framework/maintenance.php')) {
require $maintenance;
}
// Register the Composer autoloader...
require __DIR__.'/../vendor/autoload.php';
// Bootstrap Laravel and handle the request...
/** @var Application $app */
$app = require_once __DIR__.'/../bootstrap/app.php';
$app->handleRequest(Request::capture());

3
public/info.php Normal file
View File

@ -0,0 +1,3 @@
<?php
phpinfo();

2
public/robots.txt Normal file
View File

@ -0,0 +1,2 @@
User-agent: *
Disallow:

11
resources/css/app.css Normal file
View File

@ -0,0 +1,11 @@
@import 'tailwindcss';
@source '../../vendor/laravel/framework/src/Illuminate/Pagination/resources/views/*.blade.php';
@source '../../storage/framework/views/*.php';
@source '../**/*.blade.php';
@source '../**/*.js';
@theme {
--font-sans: 'Instrument Sans', ui-sans-serif, system-ui, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji',
'Segoe UI Symbol', 'Noto Color Emoji';
}

1
resources/js/app.js Normal file
View File

@ -0,0 +1 @@
import './bootstrap';

4
resources/js/bootstrap.js vendored Normal file
View File

@ -0,0 +1,4 @@
import axios from 'axios';
window.axios = axios;
window.axios.defaults.headers.common['X-Requested-With'] = 'XMLHttpRequest';

277
resources/views/welcome.blade.php Normal file
View File

File diff suppressed because one or more lines are too long

8
routes/console.php Normal file
View File

@ -0,0 +1,8 @@
<?php
use Illuminate\Foundation\Inspiring;
use Illuminate\Support\Facades\Artisan;
Artisan::command('inspire', function () {
$this->comment(Inspiring::quote());
})->purpose('Display an inspiring quote');

31
routes/web.php Normal file
View File

@ -0,0 +1,31 @@
<?php
use Illuminate\Support\Facades\Route;
use Illuminate\Http\Request;
use Modules\ModulesProvider;
Route::get('/', function () {
return view('welcome');
});
Route::group(['prefix' => 'api/v1'], function () {
Route::group(['prefix' => 'tasks', 'as' => 'tasks.'], function () {
Route::get('/list', function (Request $request) {
$mp = new ModulesProvider;
$data = $request->all();
$api = $mp->getTasksModule()->getApplicationFactory()->getApi();
$success = $api->getList($data);
$tasks = array_map(function (\Modules\Tasks\Dto\TaskResource $task) {
return $task->getApiView();
}, $api->getTasks());
$resp = [
'success' => $success,
'errors' => $api->getErrors(),
'tasks' => $tasks,
];
return response()->json($resp, $api->getResponseCode());
})->name('list');
});
});

4
storage/app/.gitignore vendored Normal file
View File

@ -0,0 +1,4 @@
*
!private/
!public/
!.gitignore

2
storage/app/private/.gitignore vendored Normal file
View File

@ -0,0 +1,2 @@
*
!.gitignore

2
storage/app/public/.gitignore vendored Normal file
View File

@ -0,0 +1,2 @@
*
!.gitignore

9
storage/framework/.gitignore vendored Normal file
View File

@ -0,0 +1,9 @@
compiled.php
config.php
down
events.scanned.php
maintenance.php
routes.php
routes.scanned.php
schedule-*
services.json

3
storage/framework/cache/.gitignore vendored Normal file
View File

@ -0,0 +1,3 @@
*
!data/
!.gitignore

2
storage/framework/cache/data/.gitignore vendored Normal file
View File

@ -0,0 +1,2 @@
*
!.gitignore

2
storage/framework/sessions/.gitignore vendored Normal file
View File

@ -0,0 +1,2 @@
*
!.gitignore

2
storage/framework/testing/.gitignore vendored Normal file
View File

@ -0,0 +1,2 @@
*
!.gitignore

2
storage/framework/views/.gitignore vendored Executable file
View File

@ -0,0 +1,2 @@
*
!.gitignore

2
storage/logs/.gitignore vendored Executable file
View File

@ -0,0 +1,2 @@
*
!.gitignore

19
tests/Feature/ExampleTest.php Normal file
View File

@ -0,0 +1,19 @@
<?php
namespace Tests\Feature;
// use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;
class ExampleTest extends TestCase
{
/**
* A basic test example.
*/
public function test_the_application_returns_a_successful_response(): void
{
$response = $this->get('/');
$response->assertStatus(200);
}
}

10
tests/TestCase.php Normal file
View File

@ -0,0 +1,10 @@
<?php
namespace Tests;
use Illuminate\Foundation\Testing\TestCase as BaseTestCase;
abstract class TestCase extends BaseTestCase
{
//
}

16
tests/Unit/ExampleTest.php Normal file
View File

@ -0,0 +1,16 @@
<?php
namespace Tests\Unit;
use PHPUnit\Framework\TestCase;
class ExampleTest extends TestCase
{
/**
* A basic test example.
*/
public function test_that_true_is_true(): void
{
$this->assertTrue(true);
}
}

28
tests/Unit/TasksTest.php Normal file
View File

@ -0,0 +1,28 @@
<?php
namespace Tests\Unit;
use Tests\TestCase;
use Modules\ModulesProvider;
class TasksTest extends TestCase
{
/**
* A basic unit test example.
*/
public function test_example(): void
{
$this->assertTrue(true);
}
public function test_insert(): void
{
$mp = new ModulesProvider;
$api = $mp->getTasksModule()->getApplicationFactory()->getApi();
$data = [
'title' => 'test_task',
];
$success = $api->insert($data);
$this->assertTrue($success);
}
}

13
vite.config.js Normal file
View File

@ -0,0 +1,13 @@
import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';
import tailwindcss from '@tailwindcss/vite';
export default defineConfig({
plugins: [
laravel({
input: ['resources/css/app.css', 'resources/js/app.js'],
refresh: true,
}),
tailwindcss(),
],
});