Laravel framework knowledge base. Provides architecture, DDD integration, Eloquent persistence, service container, security, queues, events, infrastructure components, testing, and antipatterns for Laravel PHP projects.
From accnpx claudepluginhub dykyi-roman/awesome-claude-code --plugin accThis skill uses the workspace's default tool permissions.
references/antipatterns.mdreferences/architecture.mdreferences/ddd-integration.mdreferences/dependency-injection.mdreferences/event-system.mdreferences/infrastructure-components.mdreferences/persistence.mdreferences/queues-advanced.mdreferences/routing-http.mdreferences/security.mdreferences/testing.mdQuick reference for Laravel framework patterns, DDD integration strategies, and PHP 8.4 best practices for building scalable Laravel applications.
Service Providers are the central place to configure and bootstrap the application. All bindings, event listeners, middleware, and routes are registered through providers.
Facades provide a static-like interface to classes in the service container. Prefer dependency injection over Facades in Domain and Application layers; Facades are acceptable in Presentation and Infrastructure layers.
Default Laravel: DDD-Aligned Laravel:
app/ app/
├── Http/Controllers/ src/
├── Models/ ├── Domain/
├── Providers/ │ ├── Order/
├── Services/ │ │ ├── Entity/
├── Events/ │ │ ├── ValueObject/
├── Listeners/ │ │ ├── Repository/
├── Jobs/ │ │ └── Event/
├── Mail/ │ └── Customer/
└── Exceptions/ ├── Application/
│ ├── Order/UseCase/
│ └── Customer/UseCase/
└── Infrastructure/
├── Persistence/
├── Http/
└── Provider/
failed() method, and concurrency protectionEventDispatcherInterface (not Laravel Event facade)use Illuminate\... in Domain layer| Violation | Where to Look | Severity |
|---|---|---|
| Eloquent in Domain layer | use Illuminate\Database in Domain/ | Critical |
| Business logic in Controller | if/switch on domain state in Controllers | Critical |
| Fat Eloquent Model | Model with 500+ lines, business methods | Critical |
| Facade in Domain | use Illuminate\Support\Facades in Domain/ | Critical |
| Missing FormRequest | Raw $request->input() with inline validation | Warning |
| N+1 query | Relationship access in loops without eager loading | Warning |
| Missing API Resource | Array building in Controller for responses | Warning |
| Direct DB in Controller | DB::table() or Model::where() in Controller | Warning |
| Business logic in Policy | DB queries or complex logic in Policy class | Warning |
| Missing job retry strategy | ShouldQueue without $tries or backoff() | Warning |
| Event facade in Domain | Event::dispatch() or event() in Domain layer | Critical |
| Cache/HTTP in Domain | Cache:: or Http:: in Domain layer | Critical |
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Order;
use App\Application\Order\UseCase\CreateOrderUseCase;
use App\Http\Requests\Order\CreateOrderRequest;
use App\Http\Resources\Order\OrderResource;
use Illuminate\Http\JsonResponse;
use Symfony\Component\HttpFoundation\Response;
final readonly class CreateOrderController
{
public function __construct(
private CreateOrderUseCase $createOrder,
) {}
public function __invoke(CreateOrderRequest $request): JsonResponse
{
$orderId = $this->createOrder->execute($request->toCommand());
return OrderResource::make($orderId)
->response()
->setStatusCode(Response::HTTP_CREATED);
}
}
<?php
declare(strict_types=1);
namespace App\Http\Requests\Order;
use App\Application\Order\Command\CreateOrderCommand;
use App\Domain\Order\ValueObject\CustomerId;
use Illuminate\Foundation\Http\FormRequest;
final class CreateOrderRequest extends FormRequest
{
/** @return array<string, mixed> */
public function rules(): array
{
return [
'customer_id' => ['required', 'uuid'],
'lines' => ['required', 'array', 'min:1'],
'lines.*.product_id' => ['required', 'uuid'],
'lines.*.quantity' => ['required', 'integer', 'min:1'],
];
}
public function toCommand(): CreateOrderCommand
{
return new CreateOrderCommand(
customerId: new CustomerId($this->validated('customer_id')),
lines: $this->validated('lines'),
);
}
}
<?php
declare(strict_types=1);
namespace App\Application\Order\UseCase;
use App\Domain\Order\Entity\Order;
use App\Domain\Order\Repository\OrderRepositoryInterface;
use App\Domain\Order\ValueObject\OrderId;
final readonly class CreateOrderUseCase
{
public function __construct(
private OrderRepositoryInterface $orders,
) {}
public function execute(CreateOrderCommand $command): OrderId
{
$order = Order::create(
id: OrderId::generate(),
customerId: $command->customerId,
lines: $command->lines,
);
$this->orders->save($order);
return $order->id();
}
}
For detailed information, load these reference files:
references/architecture.md -- Service Providers, Facades, directory structure, module patternsreferences/ddd-integration.md -- Extracting Domain from app/, Eloquent separation, Domain Eventsreferences/routing-http.md -- Controllers, middleware, FormRequest, API Resources, policiesreferences/persistence.md -- Eloquent ORM, migrations, transactions, read/write splittingreferences/dependency-injection.md -- Service Container, contextual binding, interface bindingreferences/testing.md -- Feature/Unit tests, Pest, factories, mocking, database testingreferences/security.md -- Gates, Policies with Specifications, password hashing, Sanctum, User model separationreferences/queues-advanced.md -- Job middleware, batching, chaining, retry/DLQ, Horizon, unique jobs, CQRSreferences/event-system.md -- Event discovery, queued listeners, subscribers, domain event bridge, testingreferences/infrastructure-components.md -- Cache, HTTP Client, Rate Limiting, Task Scheduling, Locks with DDD portsreferences/antipatterns.md -- God Model, fat controller, Facade abuse, N+1 detectionProvides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.