PHP/LaravelSkeletonAPI
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Skeleton is ready

Browse Source
This commit is contained in:
Viktor Smagin
2026-01-05 16:33:20 +04:00
commit eeaf43ab5d
89 changed files with 2704 additions and 0 deletions
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

38
.env.example Normal file
View File

@@ -0,0 +1,38 @@
APP_NAME=project-api
APP_ENV=local
APP_KEY=
APP_DEBUG=true
APP_URL=http://api.project.local
APP_LOCALE=en
APP_FALLBACK_LOCALE=en
APP_FAKER_LOCALE=en_US
APP_MAINTENANCE_DRIVER=file
# APP_MAINTENANCE_STORE=database
BCRYPT_ROUNDS=12
LOG_CHANNEL=stack
LOG_STACK=daily
LOG_DEPRECATIONS_CHANNEL=null
LOG_LEVEL=debug
DB_CONNECTION=pgsql
DB_HOST=localhost
DB_PORT=5432
DB_DATABASE=
DB_USERNAME=
DB_PASSWORD=
BROADCAST_CONNECTION=log
FILESYSTEM_DISK=local
QUEUE_CONNECTION=redis
CACHE_STORE=redis
# CACHE_PREFIX=
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_DB=0
REDIS_CACHE_DB=0

25
.gitignore vendored Normal file
View File

@@ -0,0 +1,25 @@
*.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
*.pid

58
Jenkinsfile vendored Normal file
View File

@@ -0,0 +1,58 @@
pipeline {
agent any
environment {
API_TOKEN = credentials('04f8a5d4-19fc-4ab3-979e-35bbb5b64611')
ENV_FILE = '/usr/local/share/environment/api.env'
COMPOSE_FILE = 'src/deploy/main/docker-compose.yaml'
PHP_CONTAINER = 'project-php'
}
stages {
stage('Clean') {
steps {
cleanWs()
}
}
stage('Clone') {
steps {
sh """
git clone https://gitea.diffteam.online/PHP/LaravelSkeletonAPI.git src
"""
}
}
stage('Environment') {
steps {
sh """
if [ -f "${ENV_FILE}" ]; then
cp "${ENV_FILE}" src/.env
echo ".env file copied successfully"
else
echo "ERROR: .env file not found at ${ENV_FILE}"
exit 1
fi
"""
}
}
stage('Build') {
steps {
sh """
docker compose --env-file src/.env -f "${COMPOSE_FILE}" build
"""
}
}
stage('Deploy') {
steps {
sh """
docker compose --env-file src/.env -f "${COMPOSE_FILE}" down --remove-orphans
docker compose --env-file src/.env -f "${COMPOSE_FILE}" up -d
docker exec "${PHP_CONTAINER}" php artisan migrate --force
docker exec "${PHP_CONTAINER}" php artisan optimize
"""
}
}
}
}

60
README.md Normal file
View File

@@ -0,0 +1,60 @@
# Laravel API skeleton
This is a feature-based API application skeleton.
## Requirements
* PHP 8.2+
## About
### Packages
The skeleton contains the following packages:
* `diffhead/php-dto` - DTO implementation
* `laravel/framework` - Laravel version 12
* `laravel/tinker` - Application interpreter
* `laravel/sanctum` - Authentication library
* `spatie/laravel-permission` - Authorization features
It also includes packages for application testing. See `composer.json` for details.
### Architecture
This is a feature-based skeleton. Every feature has a
service provider which should be included by adding it to
`bootstrap/providers.php`.
The skeleton has the `App\Kernel` namespace which contains
some basic utilities, enums, middlewares and other
fundamental components.
Also this application has the `App\Shared` namespace for
services, events, or other things that will be shared
between features and components.
`App\Models` namespace should contain global app models
which represent database structures.
#### Feature
A feature can contain route definitions, event listeners,
commands, services, and other required components needed to
implement a specific functionality.
I strongly recommend keeping each feature isolated from the
others. A good sign of proper isolation is that the application
continues to work stably even when a feature is disabled.
### Infrastructure
The skeleton contains a Jenkinsfile in the root of the project as
an example of how to build and deploy the application. It also
contains Docker files inside the `deploy` directory.
### Usage
The skeleton includes an `app\Feature\Example` feature as an example of how to
define features, some shared services and events, and base
migrations with the user model.

18
app/Feature/Example/Command/DoSomething.php Normal file
View File

@@ -0,0 +1,18 @@
<?php
declare(strict_types=1);
namespace App\Feature\Example\Command;
use Illuminate\Console\Command;
class DoSomething extends Command
{
protected $signature = 'example:do-something';
protected $description = 'Do something example';
public function handle(): int
{
return 0;
}
}

18
app/Feature/Example/Dto/SearchUsers.php Normal file
View File

@@ -0,0 +1,18 @@
<?php
declare(strict_types=1);
namespace App\Feature\Example\Dto;
use Diffhead\PHP\Dto\Dto;
use Diffhead\PHP\Dto\Property;
/**
* @property \Diffhead\PHP\Dto\Property<int> $page
* @property \Diffhead\PHP\Dto\Property<int> $perPage
*/
class SearchUsers extends Dto
{
protected Property $page;
protected Property $perPage;
}

23
app/Feature/Example/Http/Controller/User.php Normal file
View File

@@ -0,0 +1,23 @@
<?php
declare(strict_types=1);
namespace App\Feature\Example\Http\Controller;
use App\Feature\Example\Dto\SearchUsers;
use App\Feature\Example\Http\Request\Index;
use App\Feature\Example\Http\Resource\Users;
use App\Feature\Example\Service\UsersRepository;
class User
{
public function __construct(
private UsersRepository $users,
) {}
public function index(Index $request): Users
{
$dto = SearchUsers::fromArray($request->validated());
return Users::make($this->users->search($dto));
}
}

22
app/Feature/Example/Http/Request/Index.php Normal file
View File

@@ -0,0 +1,22 @@
<?php
declare(strict_types=1);
namespace App\Feature\Example\Http\Request;
use Illuminate\Foundation\Http\FormRequest;
/**
* @property int|null $page
* @property int|null $per_page
*/
class Index extends FormRequest
{
public function rules(): array
{
return [
'page' => ['sometimes', 'integer', 'min:1'],
'per_page' => ['sometimes', 'integer', 'min:1', 'max:200'],
];
}
}

24
app/Feature/Example/Http/Resource/User.php Normal file
View File

@@ -0,0 +1,24 @@
<?php
declare(strict_types=1);
namespace App\Feature\Example\Http\Resource;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;
/**
* @property \App\Models\User\User $resource
*/
class User extends JsonResource
{
public function toArray(Request $request): array
{
return [
'id' => $this->resource->getKey(),
'login' => $this->resource->login,
'created_at' => $this->resource->created_at,
'updated_at' => $this->resource->updated_at,
];
}
}

21
app/Feature/Example/Http/Resource/Users.php Normal file
View File

@@ -0,0 +1,21 @@
<?php
declare(strict_types=1);
namespace App\Feature\Example\Http\Resource;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\ResourceCollection;
/**
* @property \Illuminate\Pagination\LengthAwarePaginator<\App\Models\User\User> $collection
*/
class Users extends ResourceCollection
{
public function toArray(Request $request): array
{
return [
'data' => User::collection($this->collection)
];
}
}

25
app/Feature/Example/Listener/DoSomethingOnEvent.php Normal file
View File

@@ -0,0 +1,25 @@
<?php
declare(strict_types=1);
namespace App\Feature\Example\Listener;
use App\Shared\Event\User\Created;
use Illuminate\Contracts\Queue\ShouldQueue;
class DoSomethingOnEvent implements ShouldQueue
{
public function handle(Created $event): void
{
}
public function viaConnection(): string
{
return 'sync';
}
public function viaQueue(): string
{
return 'default';
}
}

60
app/Feature/Example/Provider.php Normal file
View File

@@ -0,0 +1,60 @@
<?php
declare(strict_types=1);
namespace App\Feature\Example;
use App\Feature\Example\Command\DoSomething;
use App\Feature\Example\Http\Controller\User;
use App\Feature\Example\Listener\DoSomethingOnEvent;
use App\Kernel\Feature\HasCommandsList;
use App\Kernel\Feature\HasEventListeners;
use App\Shared\Event\User\Created as UserCreated;
use Illuminate\Routing\Route;
use Illuminate\Support\ServiceProvider;
class Provider extends ServiceProvider
{
use HasCommandsList, HasEventListeners;
/**
* @var array<string,class-string>
*/
public array $bindings = [
/** Bindings section */
];
/**
* @var array<int,class-string>
*/
private array $commandsList = [
DoSomething::class,
];
private array $eventListeners = [
UserCreated::class => [
DoSomethingOnEvent::class,
],
];
public function register(): void
{
/** Register something here */
}
public function boot(): void
{
$this->registerCommands();
$this->registerListeners();
$this->registerRoutes();
}
private function registerRoutes(): void
{
Route::middleware('auth:sanctum')
->controller(User::class)
->group(function (): void {
Route::get('/users', 'index')->name('users.index');
});
}
}

26
app/Feature/Example/Service/UsersRepository.php Normal file
View File

@@ -0,0 +1,26 @@
<?php
declare(strict_types=1);
namespace App\Feature\Example\Service;
use App\Feature\Example\Dto\SearchUsers;
use App\Models\User\User;
use App\Shared\Service\User\SearchById;
use Illuminate\Pagination\LengthAwarePaginator;
class UsersRepository extends SearchById
{
/**
* @param \App\Feature\Example\Dto\SearchUsers $dto
*
* @return \Illuminate\Pagination\LengthAwarePaginator<\App\Models\User\User>
*/
public function search(SearchUsers $dto): LengthAwarePaginator
{
return User::query()->paginate(
page: $dto->page->exists() ? $dto->page->value() : 1,
perPage: $dto->perPage->exists() ? $dto->perPage->value() : 20,
);
}
}

11
app/Kernel/DateTime/Format.php Normal file
View File

@@ -0,0 +1,11 @@
<?php
declare(strict_types=1);
namespace App\Kernel\DateTime;
enum Format: string
{
case CutISO8601DateTime = 'Y-m-d H:i:s';
case CutISO8601Date = 'Y-m-d';
}

17
app/Kernel/DateTime/Util.php Normal file
View File

@@ -0,0 +1,17 @@
<?php
declare(strict_types=1);
namespace App\Kernel\DateTime;
use DateTimeInterface;
class Util
{
public static function toString(
DateTimeInterface $datetime,
Format $format
): string{
return $datetime->format($format->value);
}
}

12
app/Kernel/Db/Ilike.php Normal file
View File

@@ -0,0 +1,12 @@
<?php
declare(strict_types=1);
namespace App\Kernel\Db;
enum Ilike: string
{
case StartsWith = '%s%%%%';
case EndsWith = '%%%s';
case Contains = '%%%%%s%%%%';
}

16
app/Kernel/Db/Query.php Normal file
View File

@@ -0,0 +1,16 @@
<?php
declare(strict_types=1);
namespace App\Kernel\Db;
class Query
{
public static function ilike(
int|float|string $value,
string $modifier = '%s',
Ilike $mode = Ilike::Contains
): string {
return sprintf(sprintf($mode->value, $modifier), $value);
}
}

9
app/Kernel/Event/Event.php Normal file
View File

@@ -0,0 +1,9 @@
<?php
declare(strict_types=1);
namespace App\Kernel\Event;
enum Event: string
{
}

15
app/Kernel/Feature/HasCommandsList.php Normal file
View File

@@ -0,0 +1,15 @@
<?php
declare(strict_types=1);
namespace App\Kernel\Feature;
trait HasCommandsList
{
public function registerCommands(): void
{
if (isset($this->commandsList) && method_exists($this, 'commands')) {
$this->commands($this->commandsList);
}
}
}

25
app/Kernel/Feature/HasEventListeners.php Normal file
View File

@@ -0,0 +1,25 @@
<?php
declare(strict_types=1);
namespace App\Kernel\Feature;
use Illuminate\Support\Facades\Event;
trait HasEventListeners
{
public function registerListeners(): void
{
if (isset($this->eventListeners)) {
/**
* @var string $event
* @var array<int,string> $listeners
*/
foreach ($this->eventListeners as $event => $listeners) {
foreach ($listeners as $listener) {
Event::listen($event, $listener);
}
}
}
}
}

10
app/Kernel/Http/ContentType.php Normal file
View File

@@ -0,0 +1,10 @@
<?php
declare(strict_types=1);
namespace App\Kernel\Http;
enum ContentType: string
{
case ApplicationJson = 'application/json';
}

10
app/Kernel/Http/Header.php Normal file
View File

@@ -0,0 +1,10 @@
<?php
declare(strict_types=1);
namespace App\Kernel\Http;
enum Header: string
{
case Accept = 'Accept';
}

39
app/Kernel/Http/Middleware/CheckAcceptHeader.php Normal file
View File

@@ -0,0 +1,39 @@
<?php
declare(strict_types=1);
namespace App\Kernel\Http\Middleware;
use App\Kernel\Http\ContentType;
use App\Kernel\Http\Header;
use App\Kernel\Object\Enum;
use Closure;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\HttpKernel\Exception\NotAcceptableHttpException;
class CheckAcceptHeader
{
public function handle(Request $request, Closure $next): Response
{
$headerFound = false;
if ($this->acceptApplicationJson($request)) {
$headerFound = true;
}
if ($request->isMethod('OPTIONS') || $headerFound) {
return $next($request);
}
throw new NotAcceptableHttpException('Valid accept header not found');
}
private function acceptApplicationJson(Request $request): bool
{
$passedHeader = $request->headers->get(Header::Accept->value);
$expectedHeader = Enum::value(ContentType::ApplicationJson);
return $passedHeader === $expectedHeader;
}
}

15
app/Kernel/Http/Validation.php Normal file
View File

@@ -0,0 +1,15 @@
<?php
declare(strict_types=1);
namespace App\Kernel\Http;
use App\Kernel\String\Regex;
class Validation
{
public static function uuid7(): string
{
return sprintf('regex:/%s/', Regex::Uuid7->value);
}
}

27
app/Kernel/Object/Enum.php Normal file
View File

@@ -0,0 +1,27 @@
<?php
declare(strict_types=1);
namespace App\Kernel\Object;
use BackedEnum;
class Enum
{
/**
* Extract values from an array of BackedEnum instances.
*
* @param array<int,BackedEnum> $enums
*
* @return array<int,int|string|float>
*/
public static function values(array $enums): array
{
return array_map(fn (BackedEnum $enum) => static::value($enum), $enums);
}
public static function value(BackedEnum $enum): int|string|float
{
return $enum->value;
}
}

17
app/Kernel/Object/HasHiddenAttributes.php Normal file
View File

@@ -0,0 +1,17 @@
<?php
declare(strict_types=1);
namespace App\Kernel\Object;
trait HasHiddenAttributes
{
public function isHidden(string $key): bool
{
if (property_exists($this, 'hidden') && is_array($this->hidden)) {
return in_array($key, $this->hidden, true);
}
return false;
}
}

10
app/Kernel/Object/HasPermissions.php Normal file
View File

@@ -0,0 +1,10 @@
<?php
declare(strict_types=1);
namespace App\Kernel\Object;
interface HasPermissions
{
public function permissions(): array;
}

10
app/Kernel/Object/HasRoles.php Normal file
View File

@@ -0,0 +1,10 @@
<?php
declare(strict_types=1);
namespace App\Kernel\Object;
interface HasRoles
{
public function roles(): array;
}

7
app/Kernel/Object/HasRolesWithPermissions.php Normal file
View File

@@ -0,0 +1,7 @@
<?php
declare(strict_types=1);
namespace App\Kernel\Object;
interface HasRolesWithPermissions extends HasRoles, HasPermissions {}

10
app/Kernel/Object/HasUuidAsIdentifier.php Normal file
View File

@@ -0,0 +1,10 @@
<?php
declare(strict_types=1);
namespace App\Kernel\Object;
interface HasUuidAsIdentifier
{
public function id(): string;
}

9
app/Kernel/Queue/Queue.php Normal file
View File

@@ -0,0 +1,9 @@
<?php
declare(strict_types=1);
namespace App\Kernel\Queue;
enum Queue: string
{
}

11
app/Kernel/Role/Role.php Normal file
View File

@@ -0,0 +1,11 @@
<?php
declare(strict_types=1);
namespace App\Kernel\Role;
enum Role: string
{
case Admin = 'admin';
case User = 'user';
}

13
app/Kernel/String/Hash.php Normal file
View File

@@ -0,0 +1,13 @@
<?php
declare(strict_types=1);
namespace App\Kernel\String;
class Hash
{
public static function xxh128(string $value): string
{
return hash('xxh128', $value);
}
}

11
app/Kernel/String/Regex.php Normal file
View File

@@ -0,0 +1,11 @@
<?php
declare(strict_types=1);
namespace App\Kernel\String;
enum Regex: string
{
case Uuid7 = '^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$';
case Numeric = '^[0-9]+$';
}

10
app/Kernel/String/String.php Normal file
View File

@@ -0,0 +1,10 @@
<?php
declare(strict_types=1);
namespace App\Kernel\String;
enum String: string
{
case Empty = '';
}

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

@@ -0,0 +1,57 @@
<?php
namespace App\Models\User;
use Illuminate\Database\Eloquent\Concerns\HasUuids;
use Illuminate\Database\Eloquent\SoftDeletes;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Laravel\Sanctum\HasApiTokens;
use Spatie\Permission\Traits\HasRoles;
/**
* @property string $id
* @property string $login
* @property string $password
* @property bool $is_active
* @property \Carbon\Carbon $created_at
* @property \Carbon\Carbon $updated_at
* @property \Carbon\Carbon|null $deleted_at
* @property \Illuminate\Database\Eloquent\Collection<int,\Spatie\Permission\Models\Role> $roles
* @property \Illuminate\Database\Eloquent\Collection<int,\Spatie\Permission\Models\Permission> $permissions
*
* @method ?string getKey()
*
* @method static \App\Models\User\User findOrFail(string $id)
*/
class User extends Authenticatable
{
use HasApiTokens, HasUuids, HasRoles, SoftDeletes;
/**
* @var array<int,string>
*/
protected $fillable = [
'login',
'password',
'is_active',
];
/**
* @var array<int,string>
*/
protected $hidden = [
'password',
'laravel_through_key',
];
/**
* @return array<string,string>
*/
protected function casts(): array
{
return [
'is_active' => 'boolean',
'password' => 'hashed',
];
}
}

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

@@ -0,0 +1,24 @@
<?php
namespace App\Providers;
use Illuminate\Support\ServiceProvider;
class SharedService extends ServiceProvider
{
/**
* @var array<string,string>
*/
public array $bindings = [
/** User repository */
\App\Shared\Service\User\SearchByIdContract::class =>
\App\Shared\Service\User\SearchById::class,
];
/**
* @var array<int,string>
*/
public array $singletons = [
/** Singletons */
];
}

27
app/Shared/Event/User/Created.php Normal file
View File

@@ -0,0 +1,27 @@
<?php
declare(strict_types=1);
namespace App\Shared\Event\User;
class Created
{
private string $userId;
private string $createdAt;
public function __construct(string $userId, string $createdAt)
{
$this->userId = $userId;
$this->createdAt = $createdAt;
}
public function getUserId(): string
{
return $this->userId;
}
public function getCreatedAt(): string
{
return $this->createdAt;
}
}

27
app/Shared/Event/User/Deleted.php Normal file
View File

@@ -0,0 +1,27 @@
<?php
declare(strict_types=1);
namespace App\Shared\Event\User;
class Deleted
{
private string $userId;
private string $deletedAt;
public function __construct(string $userId, string $deletedAt)
{
$this->userId = $userId;
$this->deletedAt = $deletedAt;
}
public function getUserId(): string
{
return $this->userId;
}
public function getDeletedAt(): string
{
return $this->deletedAt;
}
}

27
app/Shared/Event/User/Updated.php Normal file
View File

@@ -0,0 +1,27 @@
<?php
declare(strict_types=1);
namespace App\Shared\Event\User;
class Updated
{
private string $userId;
private string $updatedAt;
public function __construct(string $userId, string $updatedAt)
{
$this->userId = $userId;
$this->updatedAt = $updatedAt;
}
public function getUserId(): string
{
return $this->userId;
}
public function getUpdatedAt(): string
{
return $this->updatedAt;
}
}

22
app/Shared/Service/User/SearchById.php Normal file
View File

@@ -0,0 +1,22 @@
<?php
declare(strict_types=1);
namespace App\Shared\Service\User;
use App\Models\User\User;
class SearchById implements SearchByIdContract
{
/**
* @param string $id
*
* @return \App\Models\User\User
*
* @throws \Illuminate\Database\Eloquent\ModelNotFoundException
*/
public function getById(string $id): User
{
return User::findOrFail($id);
}
}

12
app/Shared/Service/User/SearchByIdContract.php Normal file
View File

@@ -0,0 +1,12 @@
<?php
declare(strict_types=1);
namespace App\Shared\Service\User;
use App\Models\User\User;
interface SearchByIdContract
{
public function getById(string $id): User;
}

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);

28
bootstrap/app.php Normal file
View File

@@ -0,0 +1,28 @@
<?php
use App\Kernel\Http\Middleware\CheckAcceptHeader;
use Illuminate\Foundation\Application;
use Illuminate\Foundation\Configuration\Exceptions;
use Illuminate\Foundation\Configuration\Middleware;
use Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull;
use Illuminate\Foundation\Http\Middleware\TrimStrings;
return Application::configure(basePath: dirname(__DIR__))
->withRouting()
->withMiddleware(function (Middleware $middleware): void {
$middleware->use([
TrimStrings::class,
ConvertEmptyStringsToNull::class,
CheckAcceptHeader::class,
]);
$middleware->alias([
/**
* 'middleware.name' => Middleware:class,
*/
]);
})
->withExceptions(function (Exceptions $exceptions): void {
})
->create();

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

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

19
bootstrap/providers.php Normal file
View File

@@ -0,0 +1,19 @@
<?php
return [
/**
* Application providers
*/
App\Providers\SharedService::class,
/**
* Package providers
*/
// Diffhead\PHP\LaravelDataEnrichment\ServiceProvider::class,
// Diffhead\PHP\LaravelRabbitMQ\ServiceProvider::class,
/**
* Feature providers
*/
App\Feature\Example\Provider::class,
];

73
composer.json Normal file
View File

@@ -0,0 +1,73 @@
{
"$schema": "https://getcomposer.org/schema.json",
"name": "diffhead/laravel-skeleton-api",
"type": "project",
"description": "Laravel 12 skeleton for API application, feature-based.",
"keywords": ["laravel", "api", "skeleton", "feature"],
"license": "MIT",
"require": {
"php": "^8.2",
"diffhead/php-dto": "^1.0.0",
"laravel/framework": "^12.0",
"laravel/sanctum": "^4.1",
"laravel/tinker": "^2.10.1",
"spatie/laravel-permission": "^6.20"
},
"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.3"
},
"autoload": {
"psr-4": {
"App\\": "app/",
"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-install-cmd": [
"@php artisan vendor:publish --tag=config --ansi"
],
"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"
]
},
"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
}

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(',', 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'),
],
];

110
config/auth.php Normal file
View File

@@ -0,0 +1,110 @@
<?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\User::class),
],
],
/*
|--------------------------------------------------------------------------
| 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(env('APP_NAME', 'laravel'), '_').'_cache_'),
];

108
config/database.php Normal file
View File

@@ -0,0 +1,108 @@
<?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', 'pgsql'),
/*
|--------------------------------------------------------------------------
| 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' => [
'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',
],
],
/*
|--------------------------------------------------------------------------
| 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(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', '2'),
],
'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', '2'),
],
],
];

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' => false,
'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', 'daily'),
/*
|--------------------------------------------------------------------------
| 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(',', 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(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'),
],
];

113
config/queue.php Normal file
View File

@@ -0,0 +1,113 @@
<?php
use App\Kernel\Queue\Queue;
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',
],
];

17
config/services.php Normal file
View File

@@ -0,0 +1,17 @@
<?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.
|
*/
];

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::slug(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*

31
database/migrations/0001_01_01_000000_create_users_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('users', function (Blueprint $table) {
$table->uuid('id')->primary();
$table->string('login')->unique();
$table->string('password');
$table->boolean('is_active')->default(true);
$table->timestamps();
$table->softDeletes();
});
}
/**
* Reverse the migrations.
*/
public function down(): void
{
Schema::dropIfExists('users');
}
};

32
database/migrations/0001_01_02_000000_create_jobs_table.php Normal file
View File

@@ -0,0 +1,32 @@
<?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('jobs', function (Blueprint $table) {
$table->bigIncrements('id');
$table->string('queue')->index();
$table->longText('payload');
$table->unsignedTinyInteger('attempts');
$table->unsignedInteger('reserved_at')->nullable();
$table->unsignedInteger('available_at');
$table->unsignedInteger('created_at');
});
}
/**
* Reverse the migrations.
*/
public function down(): void
{
Schema::dropIfExists('jobs');
}
};

32
database/migrations/0001_01_03_000000_create_failed_jobs_table.php Normal file
View File

@@ -0,0 +1,32 @@
<?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('failed_jobs', function (Blueprint $table) {
$table->id();
$table->string('uuid')->unique();
$table->text('connection');
$table->text('queue');
$table->longText('payload');
$table->longText('exception');
$table->timestamp('failed_at')->useCurrent();
});
}
/**
* Reverse the migrations.
*/
public function down(): void
{
Schema::dropIfExists('failed_jobs');
}
};

35
database/migrations/0001_01_04_000000_create_job_batches_table.php Normal file
View File

@@ -0,0 +1,35 @@
<?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('job_batches', function (Blueprint $table) {
$table->string('id')->primary();
$table->string('name');
$table->integer('total_jobs');
$table->integer('pending_jobs');
$table->integer('failed_jobs');
$table->longText('failed_job_ids');
$table->mediumText('options')->nullable();
$table->integer('cancelled_at')->nullable();
$table->integer('created_at');
$table->integer('finished_at')->nullable();
});
}
/**
* Reverse the migrations.
*/
public function down(): void
{
Schema::dropIfExists('job_batches');
}
};

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

@@ -0,0 +1,19 @@
<?php
namespace Database\Seeders;
// use Illuminate\Database\Console\Seeds\WithoutModelEvents;
use Illuminate\Database\Seeder;
class DatabaseSeeder extends Seeder
{
/**
* Seed the application's database.
*/
public function run(): void
{
$this->call([
]);
}
}

68
deploy/main/docker-compose.yaml Normal file
View File

@@ -0,0 +1,68 @@
name: project
services:
php:
build:
context: ../../
dockerfile: deploy/main/php.Dockerfile
container_name: project-php
depends_on:
- pgsql
volumes:
- project-cache-volume:/var/www/html/bootstrap/cache
- project-vendor-volume:/var/www/html/vendor
- project-storage-volume:/var/www/html/storage
- project-log-volume:/var/www/html/storage/logs
networks:
project-network:
aliases:
- project-php
restart: unless-stopped
supervisor:
build:
context: ../../
dockerfile: deploy/main/supervisor.Dockerfile
container_name: project-supervisor
depends_on:
- pgsql
- php
environment:
- REDIS_HOST=${REDIS_HOST}
- REDIS_PORT=${REDIS_PORT}
- DB_HOST=${DB_HOST}
- DB_PORT=${DB_PORT}
volumes:
- project-cache-volume:/var/www/html/bootstrap/cache
- project-vendor-volume:/var/www/html/vendor
- project-storage-volume:/var/www/html/storage
- project-log-volume:/var/www/html/storage/logs
networks:
- project-network
restart: unless-stopped
pgsql:
image: postgres:17
container_name: project-pgsql
environment:
- POSTGRES_DB=${DB_DATABASE}
- POSTGRES_USER=${DB_USERNAME}
- POSTGRES_PASSWORD=${DB_PASSWORD}
volumes:
- project-pgsql-volume:/var/lib/postgresql/data
networks:
- project-network
ports:
- "127.0.0.1:5432:5432"
restart: unless-stopped
volumes:
project-cache-volume:
project-vendor-volume:
project-storage-volume:
project-log-volume:
project-pgsql-volume:
networks:
project-network:
external: true

11
deploy/main/etc/supervisor/conf.d/default-worker.conf Normal file
View File

@@ -0,0 +1,11 @@
[program:default-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/html/artisan queue:work --queue=default --sleep=3 --tries=3
autostart=true
autorestart=true
user=www-data
numprocs=4
redirect_stderr=true
stdout_logfile=/dev/stdout
stdout_logfile_maxbytes=0
stopwaitsecs=3600

27
deploy/main/php.Dockerfile Normal file
View File

@@ -0,0 +1,27 @@
FROM php:8.3-fpm
ENV MAKEFLAGS="-j$(nproc)"
RUN apt-get update
RUN apt-get install -y git zip unzip curl \
libicu-dev libzip-dev libcurl4-openssl-dev libxml2-dev libpq-dev libonig-dev
RUN docker-php-ext-install intl zip bcmath xml pdo pdo_pgsql dom mbstring curl
# Install xdebug and redis extensions if needed
#
# RUN pecl install xdebug redis-6.2.0
# RUN docker-php-ext-enable redis
COPY --from=composer /usr/bin/composer /usr/bin/composer
# xDebug configuration
#
# COPY ./usr/local/etc/php/conf.d/* /usr/local/etc/php/conf.d/
WORKDIR /var/www/html
COPY composer.* .
RUN composer install --no-dev
COPY . .

39
deploy/main/supervisor.Dockerfile Normal file
View File

@@ -0,0 +1,39 @@
FROM php:8.3-cli
RUN apt-get update
RUN apt-get install -y git zip unzip curl netcat-openbsd supervisor\
libicu-dev libzip-dev libcurl4-openssl-dev libxml2-dev libpq-dev libonig-dev
RUN docker-php-ext-install intl zip bcmath xml pdo pdo_pgsql dom mbstring curl
# Install xdebug and redis extensions if needed
#
#RUN pecl install xdebug redis-6.2.0
#RUN docker-php-ext-enable redis
COPY --from=composer /usr/bin/composer /usr/bin/composer
# xDebug configuration
#
# COPY ./usr/local/etc/php/conf.d/* /usr/local/etc/php/conf.d/
COPY deploy/main/usr/local/bin/supervisor.entrypoint.sh /usr/local/bin/supervisor.entrypoint.sh
# Set permissions to match host user (optional)
#
# RUN usermod -u 1000 www-data
# RUN groupmod -g 1000 www-data
RUN chmod +x /usr/local/bin/supervisor.entrypoint.sh
RUN chown -R www-data:www-data /var/www/html
WORKDIR /var/www/html
COPY composer.* .
RUN composer install --no-dev
COPY . .
ENTRYPOINT ["/usr/local/bin/supervisor.entrypoint.sh"]
CMD ["-c", "/etc/supervisor/supervisord.conf", "-n"]

21
deploy/main/usr/local/bin/supervisor.entrypoint.sh Normal file
View File

@@ -0,0 +1,21 @@
#!/bin/sh
echo "Waiting for redis startup..."
while ! nc -z "${REDIS_HOST}" "${REDIS_PORT}"; do
sleep 1
done
echo "Redis has started!"
echo "Waiting for database startup..."
while ! nc -z "${DB_HOST}" "${DB_PORT}"; do
sleep 1
done
echo "Database has started!"
echo "Running supervisor daemon..."
exec /usr/bin/supervisord $@

4
deploy/main/usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini Normal file
View File

@@ -0,0 +1,4 @@
xdebug.mode=debug
xdebug.start_with_request=trigger
xdebug.client_host=host.docker.internal
xdebug.client_port=9003

33
phpunit.xml Normal file
View File

@@ -0,0 +1,33 @@
<?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="sqlite"/>
<env name="DB_DATABASE" value=":memory:"/>
<env name="MAIL_MAILER" value="array"/>
<env name="PULSE_ENABLED" value="false"/>
<env name="QUEUE_CONNECTION" value="sync"/>
<env name="SESSION_DRIVER" value="array"/>
<env name="TELESCOPE_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>

BIN
public/favicon.ico Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 417 B

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());

2
public/robots.txt Normal file
View File

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

14
resources/views/blank.blade.php Normal file
View File

@@ -0,0 +1,14 @@
<!doctype html>
<html>
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Blank</title>
</head>
<body>
<div>
<h1>Blank</h1>
</div>
</body>
</html>

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 Normal file
View File

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

2
storage/logs/.gitignore vendored Normal 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);
}
}