[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EN81DN14EHSEPAC2PMMNXP":3,"skill-same:01M7EN81DN14EHSEPAC2PMMNXP":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7EN81DN14EHSEPAC2PMMNXP","laravel-security",null,"Laravel security best practices — authentication, authorization, Eloquent safety, CSRF, XSS prevention, API security, and secure deployment configurations. Use when reviewing Laravel auth, Eloquent safety, CSRF, XSS, API security, or deployment configuration.","lza6\u002FArmor-piercing-system-prompts","lza6","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F128880206?v=4","01M7EB3K7WPX5T28EJ2NVHE6EG","Chinese-tingfeng","01M7EB3K97E1KQ16QWKJMFNGX8",11,"MIT","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F04-安全渗透\u002Flaravel-security\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: laravel-security\ndescription: Laravel security best practices — authentication, authorization, Eloquent safety, CSRF, XSS prevention, API security, and secure deployment configurations. Use when reviewing Laravel auth, Eloquent safety, CSRF, XSS, API security, or deployment configuration.\nmetadata:\n  origin: ECC\n---\n\n# Laravel Security Best Practices\n\nComprehensive security guidelines for Laravel applications to protect against common vulnerabilities.\n\n## When to Activate\n\n- Setting up Laravel authentication and authorization (Sanctum, Passport, Jetstream, Breeze)\n- Implementing user roles, permissions, and policies\n- Configuring production security settings and environment variables\n- Reviewing Laravel applications for security vulnerabilities\n- Deploying Laravel applications to production\n- Writing secure Eloquent queries and migrations\n\n## Production Configuration\n\n### Essential Production Settings\n\n```php\n\u002F\u002F config\u002Fapp.php\n'env' => env('APP_ENV', 'production'),\n'debug' => (bool) env('APP_DEBUG', false), \u002F\u002F CRITICAL: Never true in production\n'key' => env('APP_KEY'), \u002F\u002F Must be set: php artisan key:generate\n\n\u002F\u002F config\u002Fsession.php\n'secure' => env('SESSION_SECURE_COOKIE', true),\n'http_only' => true,\n'same_site' => 'lax',\n\n\u002F\u002F Verify APP_KEY is set at boot\n\u002F\u002F bootstrap\u002Fapp.php or a service provider\nif (empty(config('app.key'))) {\n    throw new RuntimeException('APP_KEY is not set. Run: php artisan key:generate');\n}\n```\n\n### Environment File Security\n\n```bash\n# NEVER commit .env to version control\n# .gitignore already includes .env by default\n\n# Use .env.example with placeholders instead\nDB_PASSWORD=\nAPP_KEY=\nSANCTUM_TOKEN_PREFIX=\n\n# Validate required variables at boot\n\u002F\u002F In AppServiceProvider::boot()\n$requiredKeys = ['app.key', 'database.connections.mysql.database', 'database.connections.mysql.username'];\nforeach ($requiredKeys as $key) {\n    if (empty(config($key))) {\n        throw new RuntimeException(\"Missing required config key: {$key}\");\n    }\n}\n```\n\n### HTTPS Enforcement\n\n```php\n\u002F\u002F AppServiceProvider::boot() or middleware\nif (app()->environment('production')) {\n    URL::forceScheme('https');\n    request()->server->set('HTTPS', 'on');\n}\n\n\u002F\u002F config\u002Fapp.php for trusted proxies (load balancers)\n\u002F\u002F Use specific IP ranges — * trusts all, allowing X-Forwarded-* spoofing\n\u002F\u002F AWS: '10.0.0.0\u002F8', '172.16.0.0\u002F12', '192.168.0.0\u002F16'\n'trusted_proxies' => ['10.0.0.0\u002F8', '172.16.0.0\u002F12'],\n\n\u002F\u002F Force HTTPS in production via middleware\n\u002F\u002F app\u002FHttp\u002FMiddleware\u002FForceHttps.php\npublic function handle($request, Closure $next)\n{\n    if (!$request->secure() && app()->environment('production')) {\n        return redirect()->secure($request->getRequestUri());\n    }\n    return $next($request);\n}\n```\n\n## Authentication\n\n### Sanctum (API Token Authentication)\n\n```php\n\u002F\u002F config\u002Fsanctum.php\n'stateful' => explode(',', env('SANCTUM_STATEFUL_DOMAINS', sprintf(\n    '%s%s',\n    'localhost,localhost:3000,127.0.0.1,127.0.0.1:8000,::1',\n    env('APP_URL') ? ',' . parse_url(env('APP_URL'), PHP_URL_HOST) : ''\n)));\n\n'expiration' => 60 * 24, \u002F\u002F Token expiration in minutes (null = never)\n'token_prefix' => env('SANCTUM_TOKEN_PREFIX', ''),\n\n\u002F\u002F Issuing tokens with abilities\n$token = $user->createToken('api-token', ['read', 'write'])->plainTextToken;\n\n\u002F\u002F Validate abilities on routes\nRoute::middleware('auth:sanctum')->group(function () {\n    Route::get('\u002Forders', function () {\n        \u002F\u002F User must have 'read' ability\n        abort_unless(Auth::user()->tokenCan('read'), 403);\n        \u002F\u002F ...\n    })->middleware('abilities:read');\n\n    Route::post('\u002Forders', function () {\n        \u002F\u002F User must have 'write' ability\n        abort_unless(Auth::user()->tokenCan('write'), 403);\n        \u002F\u002F ...\n    })->middleware('abilities:write');\n});\n```\n\n### Password Security\n\n```php\n\u002F\u002F config\u002Fhashing.php\n\u002F\u002F Default is bcrypt. Argon2id is stronger.\n'bcrypt' => [\n    'rounds' => env('BCRYPT_ROUNDS', 12), \u002F\u002F Increase for stronger hashing\n],\n\n'argon' => [\n    'memory' => 65536,\n    'threads' => 4,\n    'time' => 4,\n],\n\n\u002F\u002F Password validation in RegisterRequest\npublic function rules(): array\n{\n    return [\n        'password' => [\n            'required',\n            'confirmed',\n            Password::min(12)\n                ->letters()\n                ->mixedCase()\n                ->numbers()\n                ->symbols()\n                ->uncompromised(), \u002F\u002F Checks haveibeenpwned\n        ],\n    ];\n}\n\n\u002F\u002F Rate limit login attempts\n\u002F\u002F App\\Http\\Controllers\\Auth\\AuthenticatedSessionController\nprotected function authenticated(Request $request, $user)\n{\n    if ($user->wasRecentlyLockedOut()) {\n        \u002F\u002F Notify user of suspicious login\n        $user->notify(new SuspiciousLoginNotification($request->ip()));\n    }\n}\n```\n\n### Session Management\n\n```php\n\u002F\u002F config\u002Fsession.php\n'driver' => env('SESSION_DRIVER', 'database'), \u002F\u002F database\u002Fredis > file\n'lifetime' => env('SESSION_LIFETIME', 120),\n'expire_on_close' => env('SESSION_EXPIRE_ON_CLOSE', false),\n'encrypt' => env('SESSION_ENCRYPT', false),\n\n\u002F\u002F Regenerate session on login\n\u002F\u002F App\\Http\\Controllers\\Auth\\AuthenticatedSessionController\npublic function store(LoginRequest $request): RedirectResponse\n{\n    $request->authenticate();\n    $request->session()->regenerate(); \u002F\u002F CRITICAL: prevents session fixation\n    return redirect()->intended(RouteServiceProvider::HOME);\n}\n\n\u002F\u002F Invalidate session on logout\npublic function destroy(Request $request): RedirectResponse\n{\n    Auth::guard('web')->logout();\n    $request->session()->invalidate();\n    $request->session()->regenerateToken();\n    return redirect('\u002F');\n}\n```\n\n## Authorization\n\n### Gates\n\n```php\n\u002F\u002F App\\Providers\\AuthServiceProvider\nuse App\\Models\\Post;\nuse App\\Models\\User;\nuse Illuminate\\Support\\Facades\\Gate;\n\npublic function boot(): void\n{\n    Gate::define('update-post', function (User $user, Post $post): bool {\n        return $user->id === $post->user_id;\n    });\n\n    Gate::define('publish-post', function (User $user): bool {\n        return $user->role === 'editor' || $user->role === 'admin';\n    });\n\n    \u002F\u002F Using before() for super-admin override\n    Gate::before(function (User $user, string $ability): ?bool {\n        if ($user->role === 'super-admin') {\n            return true; \u002F\u002F Grants all abilities\n        }\n        return null; \u002F\u002F Fall through to normal checks\n    });\n}\n\n\u002F\u002F Usage in controllers\npublic function update(Request $request, Post $post): RedirectResponse\n{\n    Gate::authorize('update-post', $post);\n    \u002F\u002F Or: $this->authorize('update-post', $post);\n    \u002F\u002F Or: abort_unless(Auth::user()->can('update-post', $post), 403);\n    \u002F\u002F ...\n}\n```\n\n### Policies\n\n```php\n\u002F\u002F App\\Policies\\PostPolicy\nclass PostPolicy\n{\n    use HandlesAuthorization;\n\n    public function viewAny(?User $user): bool\n    {\n        return true; \u002F\u002F Public listing\n    }\n\n    public function view(?User $user, Post $post): bool\n    {\n        return $post->is_published || ($user && $user->id === $post->user_id);\n    }\n\n    public function create(User $user): bool\n    {\n        return $user->hasVerifiedEmail(); \u002F\u002F Must verify email first\n    }\n\n    public function update(User $user, Post $post): bool\n    {\n        return $user->id === $post->user_id;\n    }\n\n    public function delete(User $user, Post $post): bool\n    {\n        return $user->id === $post->user_id && $post->created_at->diffInDays(now()) \u003C= 30;\n    }\n\n    public function restore(User $user, Post $post): bool\n    {\n        return $user->role === 'admin';\n    }\n\n    public function forceDelete(User $user, Post $post): bool\n    {\n        return $user->role === 'super-admin';\n    }\n}\n\n\u002F\u002F Register in AuthServiceProvider\nprotected $policies = [\n    Post::class => PostPolicy::class,\n];\n\n\u002F\u002F Controller usage\npublic function show(Post $post): View\n{\n    $this->authorize('view', $post);\n    return view('posts.show', compact('post'));\n}\n\n\u002F\u002F Blade usage\n@can('update', $post)\n    \u003Ca href=\"{{ route('posts.edit', $post) }}\">Edit\u003C\u002Fa>\n@endcan\n\n@cannot('update', $post)\n    \u003Cspan>You cannot edit this post\u003C\u002Fspan>\n@endcannot\n```\n\n### Middleware Authorization\n\n```php\n\u002F\u002F Using middleware in routes\nRoute::put('\u002Fposts\u002F{post}', [PostController::class, 'update'])\n    ->middleware('can:update,post');\n\nRoute::get('\u002Fposts\u002Fcreate', [PostController::class, 'create'])\n    ->middleware('can:create,App\\Models\\Post');\n\n\u002F\u002F Custom authorization middleware\n\u002F\u002F app\u002FHttp\u002FMiddleware\u002FCheckRole.php\nclass CheckRole\n{\n    public function handle(Request $request, Closure $next, string $role): mixed\n    {\n        if (!$request->user() || $request->user()->role !== $role) {\n            abort(403, 'Unauthorized. This area requires role: ' . $role);\n        }\n        return $next($request);\n    }\n}\n\n\u002F\u002F Register in Kernel\nprotected $routeMiddleware = [\n    'role' => \\App\\Http\\Middleware\\CheckRole::class,\n];\n\n\u002F\u002F Route usage\nRoute::middleware(['auth', 'role:admin'])->group(function () {\n    Route::get('\u002Fadmin', [AdminController::class, 'index']);\n});\n```\n\n## Eloquent Security\n\n### Mass Assignment Protection\n\n```php\n\u002F\u002F BAD: $guarded = [] allows ALL columns to be mass-assigned\n\u002F\u002F NEVER use $guarded = [] in production\n\n\u002F\u002F GOOD: Whitelist fillable attributes\nfinal class User extends Authenticatable\n{\n    protected $fillable = [\n        'name',\n        'email',\n        'phone',\n        'avatar',\n    ];\n    \u002F\u002F NEVER add 'role', 'is_admin', 'is_verified' here\n}\n\n\u002F\u002F GOOD: Explicitly control which fields can be filled in requests\npublic function store(StoreUserRequest $request): RedirectResponse\n{\n    $user = User::create($request->safe()->only([\n        'name', 'email', 'phone', 'avatar'\n    ]));\n    \u002F\u002F $request->safe() uses validated data only\n    \u002F\u002F $request->only() is NOT safe on its own without validation rules\n}\n\n\u002F\u002F BAD: Creating a user with request data directly\nUser::create($request->all()); \u002F\u002F VULNERABLE to mass assignment!\n\n\u002F\u002F BETTER: Use DTOs for creation\n$user = User::create($request->validated()); \u002F\u002F Only validated fields\n```\n\n### SQL Injection Prevention\n\n```php\n\u002F\u002F GOOD: Eloquent automatically parameterizes queries\nUser::where('email', $userInput)->first();\nUser::whereRaw('email = ?', [$userInput])->first();\n\n\u002F\u002F GOOD: Query Builder also parameterizes\nDB::table('users')->where('email', $userInput)->first();\nDB::select('SELECT * FROM users WHERE email = ?', [$userInput]);\n\n\u002F\u002F BAD: Raw string interpolation\nDB::select(\"SELECT * FROM users WHERE email = '{$userInput}'\"); \u002F\u002F VULNERABLE!\nUser::whereRaw(\"email = '{$userInput}'\")->first(); \u002F\u002F VULNERABLE!\n\n\u002F\u002F BAD: whereRaw\u002ForderByRaw with unescaped input\nUser::orderByRaw($userInput); \u002F\u002F VULNERABLE!\nUser::groupByRaw($userInput); \u002F\u002F VULNERABLE!\n\n\u002F\u002F BAD: DB::statement with concatenation\nDB::statement(\"INSERT INTO users (email) VALUES ('{$userInput}')\"); \u002F\u002F VULNERABLE!\n```\n\n### Attribute Casting\n\n```php\nfinal class User extends Authenticatable\n{\n    protected $casts = [\n        'email_verified_at' => 'datetime',\n        'is_admin' => 'boolean', \u002F\u002F Cast to boolean prevents string injection\n        'settings' => 'array', \u002F\u002F Automatically json_encode\u002Fjson_decode\n        'metadata' => 'encrypted:array', \u002F\u002F Laravel 11+ encrypted casting\n        'password' => 'hashed', \u002F\u002F Laravel 10+ auto-hashes on set\n    ];\n}\n```\n\n### Model Security\n\n```php\nfinal class User extends Authenticatable\n{\n    \u002F\u002F Hide sensitive attributes from JSON\u002FAPI responses\n    protected $hidden = [\n        'password',\n        'remember_token',\n        'two_factor_secret',\n        'two_factor_recovery_codes',\n    ];\n\n    \u002F\u002F Append only safe computed attributes\n    protected $appends = ['full_name']; \u002F\u002F safe\n    \u002F\u002F NEVER append sensitive computed data\n}\n\nfinal class Post extends Model\n{\n    \u002F\u002F Global scope to filter soft deleted records\n    use SoftDeletes;\n\n    \u002F\u002F Prevent N+1 by restricting lazy loading (optional strict mode)\n    \u002F\u002F AppServiceProvider::boot()\n    \u002F\u002F Model::preventLazyLoading(!app()->isProduction());\n}\n```\n\n## CSRF Protection\n\n### Default Protection\n\n```php\n\u002F\u002F Laravel CSRF is enabled by default via VerifyCsrfToken middleware\n\u002F\u002F app\u002FHttp\u002FKernel.php (protected $middlewareGroups['web'])\n\n\u002F\u002F All POST\u002FPUT\u002FPATCH\u002FDELETE forms must include @csrf\n\u003Cform method=\"POST\" action=\"\u002Fposts\">\n    @csrf\n    \u003Cinput type=\"text\" name=\"title\">\n    \u003Cbutton type=\"submit\">Create\u003C\u002Fbutton>\n\u003C\u002Fform>\n```\n\n### Excluding Routes (Carefully)\n\n```php\n\u002F\u002F app\u002FHttp\u002FMiddleware\u002FVerifyCsrfToken.php\nclass VerifyCsrfToken extends Middleware\n{\n    \u002F\u002F Only exclude routes that have external CSRF protection (webhooks, etc.)\n    protected $except = [\n        'stripe\u002F*', \u002F\u002F Stripe webhooks use their own signature verification\n        \u002F\u002F Avoid blanket 'api\u002F*' — stateful Sanctum routes need CSRF.\n        \u002F\u002F Exclude only specific stateless webhook\u002Fendpoint routes.\n    ];\n}\n```\n\n### CSRF with JavaScript\n\n```html\n\u003Cmeta name=\"csrf-token\" content=\"{{ csrf_token() }}\">\n\n\u003Cscript>\n\u002F\u002F Axios example (Laravel ships with Axios)\naxios.defaults.headers.common['X-CSRF-TOKEN'] = document.querySelector(\n    'meta[name=\"csrf-token\"]'\n).getAttribute('content');\n\n\u002F\u002F Fetch example\nfetch('\u002Fposts', {\n    method: 'POST',\n    headers: {\n        'X-CSRF-TOKEN': document.querySelector('meta[name=\"csrf-token\"]').getAttribute('content'),\n        'Content-Type': 'application\u002Fjson',\n    },\n    body: JSON.stringify(data),\n});\n\u003C\u002Fscript>\n```\n\n## XSS Prevention\n\n### Blade Templating Security\n\n```blade\n{{-- SAFE: Auto-escaped by Blade --}}\n{{ $userInput }}\n\n{{-- DANGEROUS: Raw output — NEVER use with user input --}}\n{!! $userInput !!}\n\n{{-- SAFE: Only use {!! !!} with trusted content you control --}}\n{!! $trustedHtmlFromYourServer !!}\n\n{{-- GOOD: Use specific escaping directives --}}\n@js($data) {{-- JSON encode for JavaScript --}}\n@json($data) {{-- JSON encode in templates --}}\n\n{{-- BAD: Direct user input in raw HTML --}}\n\u003Cdiv>{!! $user->bio !!}\u003C\u002Fdiv> {{-- VULNERABLE if user provides bio --}}\n```\n\n### Safe HTML Handling\n\n```php\n\u002F\u002F When you must allow some HTML, use a whitelist approach\nuse HTMLPurifier; \u002F\u002F Requires: composer require ezyang\u002Fhtmlpurifier\n\npublic function sanitizeHtml(string $dirty): string\n{\n    $config = \\HTMLPurifier_Config::createDefault();\n    $config->set('HTML.Allowed', 'p,b,i,a[href],ul,ol,li,br');\n    $config->set('URI.AllowedSchemes', ['http', 'https', 'mailto']);\n    $purifier = new \\HTMLPurifier($config);\n    return $purifier->purify($dirty);\n}\n\n\u002F\u002F In blade:\n\u003Cdiv>{!! $sanitizedContent !!}\u003C\u002Fdiv> {{-- Safe after purification --}}\n```\n\n### JavaScript Context Escaping\n\n```blade\n{{-- SAFE: Blade @js escapes for JavaScript context --}}\n\u003Cscript>\n    const user = @js($user); \u002F\u002F JSON + escaped for JS context\n    const settings = @json($settings); \u002F\u002F Direct JSON encode\n\u003C\u002Fscript>\n\n{{-- DANGEROUS: Manual JSON in JS context --}}\n\u003Cscript>\n    const user = {{ json_encode($user) }}; \u002F\u002F NOT escaped for JS!\n\u003C\u002Fscript>\n```\n\n### HTTP Headers for XSS Protection\n\n```php\n\u002F\u002F App\\Http\\Middleware\\SecurityHeaders.php\nclass SecurityHeaders\n{\n    public function handle(Request $request, Closure $next): mixed\n    {\n        $response = $next($request);\n\n        $response->headers->set('X-Content-Type-Options', 'nosniff');\n        $response->headers->set('X-Frame-Options', 'DENY');\n        $response->headers->set('X-XSS-Protection', '1; mode=block');\n        $response->headers->set('Referrer-Policy', 'strict-origin-when-cross-origin');\n        $response->headers->set(\n            'Content-Security-Policy',\n            \"default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data: https:; font-src 'self'; connect-src 'self'; frame-ancestors 'none'\"\n        );\n\n        return $response;\n    }\n}\n\n\u002F\u002F Register in kernel\nprotected $middleware = [\n    \\App\\Http\\Middleware\\SecurityHeaders::class,\n];\n```\n\n## Input Validation\n\n### Form Request Validation\n\n```php\nfinal class StorePostRequest extends FormRequest\n{\n    public function authorize(): bool\n    {\n        return $this->user()?->can('create', Post::class) ?? false;\n    }\n\n    public function rules(): array\n    {\n        return [\n            'title' => ['required', 'string', 'max:255', 'sanitize_html'],\n            'content' => ['required', 'string', 'max:10000'],\n            'image' => [\n                'required',\n                'image',\n                'mimes:jpg,jpeg,png,gif,webp', \u002F\u002F Whitelist specific types\n                'max:2048', \u002F\u002F 2MB max\n            ],\n            'tags' => ['array'],\n            'tags.*' => ['integer', 'exists:tags,id'],\n        ];\n    }\n\n    public function messages(): array\n    {\n        return [\n            'title.max' => 'Post title must not exceed 255 characters.',\n            'image.max' => 'Image must be under 2MB.',\n        ];\n    }\n\n    \u002F\u002F Sanitize input after validation\n    public function validated($key = null, $default = null): mixed\n    {\n        $validated = parent::validated();\n        $validated['title'] = strip_tags($validated['title']);\n        return $key ? ($validated[$key] ?? $default) : $validated;\n    }\n}\n```\n\n### Custom Validation Rules\n\n```php\n\u002F\u002F app\u002FRules\u002FStrongPassword.php\nclass StrongPassword implements Rule\n{\n    public function passes($attribute, $value): bool\n    {\n        return preg_match('\u002F^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d)(?=.*[@$!%*?&#^()_\\-+=])[A-Za-z\\d@$!%*?&#^()_\\-+=]{12,}$\u002F', $value);\n    }\n\n    public function message(): string\n    {\n        return 'The :attribute must be at least 12 characters with uppercase, lowercase, number, and symbol.';\n    }\n}\n\n\u002F\u002F app\u002FRules\u002FNotBlacklistedDomain.php\nclass NotBlacklistedDomain implements Rule\n{\n    private array $blacklisted = ['mailinator.com', 'guerrillamail.com'];\n\n    public function passes($attribute, $value): bool\n    {\n        $domain = substr(strrchr($value, '@'), 1);\n        return !in_array(strtolower($domain), $this->blacklisted);\n    }\n\n    public function message(): string\n    {\n        return 'Email from disposable domains is not allowed.';\n    }\n}\n```\n\n## API Security\n\n### Rate Limiting\n\n```php\n\u002F\u002F App\u002FProviders\u002FRouteServiceProvider\nprotected function configureRateLimiting(): void\n{\n    RateLimiter::for('api', function (Request $request) {\n        return Limit::perMinute(60)->by($request->user()?->id ?: $request->ip());\n    });\n\n    RateLimiter::for('auth', function (Request $request) {\n        return Limit::perMinute(5)->by($request->ip())\n            ->response(function () {\n                return response()->json([\n                    'message' => 'Too many login attempts. Try again in 1 minute.',\n                ], 429);\n            });\n    });\n\n    RateLimiter::for('uploads', function (Request $request) {\n        return Limit::perHour(10)->by($request->user()?->id ?? $request->ip())\n            ->response(function () {\n                return response()->json([\n                    'message' => 'Upload limit reached. Try again later.',\n                ], 429);\n            });\n    });\n}\n\n\u002F\u002F Route usage\nRoute::middleware(['auth:sanctum', 'throttle:api'])->group(function () {\n    Route::apiResource('posts', PostController::class);\n});\n\nRoute::post('\u002Flogin', [AuthController::class, 'login'])\n    ->middleware('throttle:auth');\n```\n\n### API Authentication — Sanctum vs Passport\n\n```php\n\u002F\u002F Sanctum (recommended for most apps — simple, first-party, SPA)\n\u002F\u002F config\u002Fsanctum.php\n'expiration' => 60 * 24, \u002F\u002F Tokens expire after 24 hours\n'model' => User::class,\n\n\u002F\u002F Issuing scoped tokens\n$token = $user->createToken('client-name', [\n    'posts:read',\n    'posts:write',\n])->plainTextToken;\n\n\u002F\u002F Middleware scoping\nRoute::middleware('auth:sanctum')->group(function () {\n    Route::get('\u002Fposts', [PostController::class, 'index'])\n        ->middleware('abilities:posts:read');\n\n    Route::post('\u002Fposts', [PostController::class, 'store'])\n        ->middleware('abilities:posts:write');\n});\n\n\u002F\u002F Passport (OAuth2 — for third-party clients or complex auth flows)\n\u002F\u002F Install: composer require laravel\u002Fpassport\nPassport::tokensExpireIn(now()->addDays(15));\nPassport::refreshTokensExpireIn(now()->addDays(30));\nPassport::personalAccessTokensExpireIn(now()->addMonths(6));\n```\n\n### CORS Configuration\n\n```php\n\u002F\u002F config\u002Fcors.php\nreturn [\n    'paths' => ['api\u002F*', 'sanctum\u002Fcsrf-cookie'],\n    'allowed_methods' => ['*'],\n    'allowed_origins' => explode(',', env('CORS_ALLOWED_ORIGINS', '')), \u002F\u002F Whitelist specific origins\n    'allowed_origins_patterns' => [],\n    'allowed_headers' => ['*'],\n    'exposed_headers' => ['X-Total-Count', 'X-Pagination-Page'],\n    'max_age' => 0,\n    'supports_credentials' => true, \u002F\u002F Required for Sanctum SPA auth\n];\n\n\u002F\u002F NEVER: Allow all origins in production unless absolutely necessary\n\u002F\u002F 'allowed_origins' => ['*'], \u002F\u002F Only for truly public APIs\n```\n\n## File Upload Security\n\n### Validation\n\n```php\npublic function rules(): array\n{\n    return [\n        'document' => [\n            'required',\n            'file',\n            'mimes:pdf,doc,docx,xls,xlsx', \u002F\u002F Whitelist specific MIME types\n            'max:10240', \u002F\u002F 10MB\n            'extensions:pdf,doc,docx,xls,xlsx', \u002F\u002F Verify extension matches MIME\n        ],\n        'avatar' => [\n            'nullable',\n            'image', \u002F\u002F Ensures it's a valid image\n            'mimes:jpg,jpeg,png,webp',\n            'max:2048',\n            'dimensions:min_width=100,min_height=100,max_width=2000,max_height=2000',\n        ],\n    ];\n}\n```\n\n### Secure Storage\n\n```php\n\u002F\u002F Store files outside public directory\n$path = $request->file('document')->store('documents', 'local');\n\u002F\u002F Never use 'public' disk for sensitive documents\n\n\u002F\u002F Use signed URLs for temporary file access\nuse Illuminate\\Support\\Facades\\Storage;\n\npublic function download(Request $request, string $path)\n{\n    \u002F\u002F Generate temporary signed URL (expires in 15 minutes)\n    $url = Storage::temporaryUrl($path, now()->addMinutes(15));\n\n    \u002F\u002F Validate user has permission\n    $this->authorize('download', $path);\n\n    return redirect($url);\n}\n\n\u002F\u002F Storage configuration for cloud with encryption\n\u002F\u002F config\u002Ffilesystems.php\n's3' => [\n    'driver' => 's3',\n    'key' => env('AWS_ACCESS_KEY_ID'),\n    'secret' => env('AWS_SECRET_ACCESS_KEY'),\n    'region' => env('AWS_DEFAULT_REGION'),\n    'bucket' => env('AWS_BUCKET'),\n    'url' => env('AWS_URL'),\n    'endpoint' => env('AWS_ENDPOINT'),\n    'use_path_style_endpoint' => env('AWS_USE_PATH_STYLE_ENDPOINT', false),\n    'throw' => false,\n    'server_side_encryption' => 'AES256', \u002F\u002F Encrypt at rest\n],\n```\n\n## Dependencies and Secrets\n\n### Composer Security\n\n```bash\n# Always audit dependencies in CI\ncomposer audit\n\n# Pin major versions in composer.json\n\"laravel\u002Fframework\": \"^11.0\",\n\"spatie\u002Flaravel-permission\": \"^6.0\"\n\n# Check for abandoned packages\ncomposer why-not\n\n# Keep lock file in version control (it pins exact versions)\n# Run `composer update` deliberately, never in CI\u002FCD\n```\n\n### Secret Management\n\n```bash\n# .env file (NEVER commit)\n# .gitignore includes .env by default\n\nAPP_KEY=base64:abc123...\nDB_PASSWORD=secure_password\nSTRIPE_KEY=sk_live_...\nSANCTUM_TOKEN_PREFIX=myapp_\n\n# For production: Use a secret manager\n# Deploy with: env $(aws secretsmanager get-secret-value --secret-id prod\u002Fdb | jq ...) php artisan serve\n\n# Validate secrets at boot (AppServiceProvider::boot)\n$secrets = ['services.stripe.key', 'services.stripe.webhook_secret'];\nforeach ($secrets as $key) {\n    if (empty(config($key))) {\n        Log::critical(\"Missing secret: {$key}\");\n    }\n}\n```\n\n## Queue Security\n\n```php\n\u002F\u002F Define a named rate limiter (typically in AppServiceProvider::boot())\nRateLimiter::for('payments', fn () => Limit::perMinute(5));\n```\n\n```php\n\u002F\u002F Encrypt sensitive job data by implementing the interface\nfinal class ProcessPaymentJob implements ShouldQueue, ShouldBeEncrypted\n{\n    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;\n\n    public function __construct(\n        private readonly string $paymentIntentId, \u002F\u002F Public IDs are fine\n        private readonly string $cardFingerprint, \u002F\u002F Encrypted via ShouldBeEncrypted\n    ) {}\n\n    public function handle(): void\n    {\n        \u002F\u002F Process payment\n    }\n\n    \u002F\u002F Limit retries and delay between attempts\n    public function retryUntil(): Carbon\n    {\n        return now()->addMinutes(5);\n    }\n\n    \u002F\u002F Rate limit how many jobs of this type can run\n    public function middleware(): array\n    {\n        return [\n            new RateLimited('payments'),\n        ];\n    }\n}\n```\n\n## Logging Security Events\n\n```php\n\u002F\u002F config\u002Flogging.php\n'channels' => [\n    'security' => [\n        'driver' => 'single',\n        'path' => storage_path('logs\u002Fsecurity.log'),\n        'level' => 'warning',\n    ],\n],\n\n\u002F\u002F Audit log helper\nfinal class SecurityLogger\n{\n    public static function log(string $event, array $context = []): void\n    {\n        Log::channel('security')->warning($event, array_merge([\n            'user_id' => Auth::id(),\n            'ip' => request()->ip(),\n            'user_agent' => request()->userAgent(),\n            'url' => request()->fullUrl(),\n            'timestamp' => now()->toIso8601String(),\n        ], $context));\n    }\n}\n\n\u002F\u002F Usage\nSecurityLogger::log('failed_login_attempt', ['email' => $email]);\nSecurityLogger::log('password_change');\nSecurityLogger::log('role_change', ['target_user' => $targetId, 'new_role' => 'admin']);\nSecurityLogger::log('suspicious_activity', ['reason' => 'multiple_attempts_from_different_ips']);\n```\n\n## Quick Security Checklist\n\n| Check | Description |\n|-------|-------------|\n| `APP_DEBUG=false` | Never run with debug enabled in production |\n| `APP_KEY` set | Always run `php artisan key:generate` |\n| HTTPS enforced | Force HTTPS in production via middleware or proxy |\n| `$fillable` whitelisted | Never use `$guarded = []` |\n| CSRF active | `@csrf` on all state-changing forms |\n| Sanctum\u002FPassport configured | API authentication with token abilities\u002Fscopes |\n| Rate limiting applied | Throttle API and auth endpoints |\n| Input validation | FormRequest with specific rules, never `$request->all()` |\n| File upload restrictions | Validate MIME types, size, dimensions |\n| `composer audit` in CI | Check dependencies for known vulnerabilities |\n| `password_hash` \u002F `password_verify` | Use Laravel's built-in hashing (bcrypt\u002FArgon2) |\n| Session regeneration on login | Call `$request->session()->regenerate()` |\n| Security headers middleware | CSP, X-Frame-Options, X-Content-Type-Options |\n| Logged security events | Audit log for auth failures, role changes, suspicious activity |\n| `.env` not committed | Verify `.gitignore` includes `.env` |\n\n## Related Skills\n\n- `laravel-patterns` — Laravel architecture, routing, Eloquent, and API patterns\n- `backend-patterns` — General backend API and database patterns\n- `laravel-tdd` — Laravel testing with PHPUnit and Pest\n","# Laravel Security Best Practices\n\nComprehensive security guidelines for Laravel applications to protect against common vulnerabilities.\n\n## When to Activate\n\n- Setting up Laravel authentication and authorization (Sanctum, Passport, Jetstream, Breeze)\n- Implementing user roles, permissions, and policies\n- Configuring production security settings and environment variables\n- Reviewing Laravel applications for security vulnerabilities\n- Deploying Laravel applications to production\n- Writing secure Eloquent queries and migrations\n\n## Production Configuration\n\n### Essential Production Settings\n\n```php\n\u002F\u002F config\u002Fapp.php\n'env' => env('APP_ENV', 'production'),\n'debug' => (bool) env('APP_DEBUG', false), \u002F\u002F CRITICAL: Never true in production\n'key' => env('APP_KEY'), \u002F\u002F Must be set: php artisan key:generate\n\n\u002F\u002F config\u002Fsession.php\n'secure' => env('SESSION_SECURE_COOKIE', true),\n'http_only' => true,\n'same_site' => 'lax',\n\n\u002F\u002F Verify APP_KEY is set at boot\n\u002F\u002F bootstrap\u002Fapp.php or a service provider\nif (empty(config('app.key'))) {\n    throw new RuntimeException('APP_KEY is not set. Run: php artisan key:generate');\n}\n```\n\n### Environment File Security\n\n```bash\n# NEVER commit .env to version control\n# .gitignore already includes .env by default\n\n# Use .env.example with placeholders instead\nDB_PASSWORD=\nAPP_KEY=\nSANCTUM_TOKEN_PREFIX=\n\n# Validate required variables at boot\n\u002F\u002F In AppServiceProvider::boot()\n$requiredKeys = ['app.key', 'database.connections.mysql.database', 'database.connections.mysql.username'];\nforeach ($requiredKeys as $key) {\n    if (empty(config($key))) {\n        throw new RuntimeException(\"Missing required config key: {$key}\");\n    }\n}\n```\n\n### HTTPS Enforcement\n\n```php\n\u002F\u002F AppServiceProvider::boot() or middleware\nif (app()->environment('production')) {\n    URL::forceScheme('https');\n    request()->server->set('HTTPS', 'on');\n}\n\n\u002F\u002F config\u002Fapp.php for trusted proxies (load balancers)\n\u002F\u002F Use specific IP ranges — * trusts all, allowing X-Forwarded-* spoofing\n\u002F\u002F AWS: '10.0.0.0\u002F8', '172.16.0.0\u002F12', '192.168.0.0\u002F16'\n'trusted_proxies' => ['10.0.0.0\u002F8', '172.16.0.0\u002F12'],\n\n\u002F\u002F Force HTTPS in production via middleware\n\u002F\u002F app\u002FHttp\u002FMiddleware\u002FForceHttps.php\npublic function handle($request, Closure $next)\n{\n    if (!$request->secure() && app()->environment('production')) {\n        return redirect()->secure($request->getRequestUri());\n    }\n    return $next($request);\n}\n```\n\n## Authentication\n\n### Sanctum (API Token Authentication)\n\n```php\n\u002F\u002F config\u002Fsanctum.php\n'stateful' => explode(',', env('SANCTUM_STATEFUL_DOMAINS', sprintf(\n    '%s%s',\n    'localhost,localhost:3000,127.0.0.1,127.0.0.1:8000,::1',\n    env('APP_URL') ? ',' . parse_url(env('APP_URL'), PHP_URL_HOST) : ''\n)));\n\n'expiration' => 60 * 24, \u002F\u002F Token expiration in minutes (null = never)\n'token_prefix' => env('SANCTUM_TOKEN_PREFIX', ''),\n\n\u002F\u002F Issuing tokens with abilities\n$token = $user->createToken('api-token', ['read', 'write'])->plainTextToken;\n\n\u002F\u002F Validate abilities on routes\nRoute::middleware('auth:sanctum')->group(function () {\n    Route::get('\u002Forders', function () {\n        \u002F\u002F User must have 'read' ability\n        abort_unless(Auth::user()->tokenCan('read'), 403);\n        \u002F\u002F ...\n    })->middleware('abilities:read');\n\n    Route::post('\u002Forders', function () {\n        \u002F\u002F User must have 'write' ability\n        abort_unless(Auth::user()->tokenCan('write'), 403);\n        \u002F\u002F ...\n    })->middleware('abilities:write');\n});\n```\n\n### Password Security\n\n```php\n\u002F\u002F config\u002Fhashing.php\n\u002F\u002F Default is bcrypt. Argon2id is stronger.\n'bcrypt' => [\n    'rounds' => env('BCRYPT_ROUNDS', 12), \u002F\u002F Increase for stronger hashing\n],\n\n'argon' => [\n    'memory' => 65536,\n    'threads' => 4,\n    'time' => 4,\n],\n\n\u002F\u002F Password validation in RegisterRequest\npublic function rules(): array\n{\n    return [\n        'password' => [\n            'required',\n            'confirmed',\n            Password::min(12)\n                ->letters()\n                ->mixedCase()\n                ->numbers()\n                ->symbols()\n                ->uncompromised(), \u002F\u002F Checks haveibeenpwned\n        ],\n    ];\n}\n\n\u002F\u002F Rate limit login attempts\n\u002F\u002F App\\Http\\Controllers\\Auth\\AuthenticatedSessionController\nprotected function authenticated(Request $request, $user)\n{\n    if ($user->wasRecentlyLockedOut()) {\n        \u002F\u002F Notify user of suspicious login\n        $user->notify(new SuspiciousLoginNotification($request->ip()));\n    }\n}\n```\n\n### Session Management\n\n```php\n\u002F\u002F config\u002Fsession.php\n'driver' => env('SESSION_DRIVER', 'database'), \u002F\u002F database\u002Fredis > file\n'lifetime' => env('SESSION_LIFETIME', 120),\n'expire_on_close' => env('SESSION_EXPIRE_ON_CLOSE', false),\n'encrypt' => env('SESSION_ENCRYPT', false),\n\n\u002F\u002F Regenerate session on login\n\u002F\u002F App\\Http\\Controllers\\Auth\\AuthenticatedSessionController\npublic function store(LoginRequest $request): RedirectResponse\n{\n    $request->authenticate();\n    $request->session()->regenerate(); \u002F\u002F CRITICAL: prevents session fixation\n    return redirect()->intended(RouteServiceProvider::HOME);\n}\n\n\u002F\u002F Invalidate session on logout\npublic function destroy(Request $request): RedirectResponse\n{\n    Auth::guard('web')->logout();\n    $request->session()->invalidate();\n    $request->session()->regenerateToken();\n    return redirect('\u002F');\n}\n```\n\n## Authorization\n\n### Gates\n\n```php\n\u002F\u002F App\\Providers\\AuthServiceProvider\nuse App\\Models\\Post;\nuse App\\Models\\User;\nuse Illuminate\\Support\\Facades\\Gate;\n\npublic function boot(): void\n{\n    Gate::define('update-post', function (User $user, Post $post): bool {\n        return $user->id === $post->user_id;\n    });\n\n    Gate::define('publish-post', function (User $user): bool {\n        return $user->role === 'editor' || $user->role === 'admin';\n    });\n\n    \u002F\u002F Using before() for super-admin override\n    Gate::before(function (User $user, string $ability): ?bool {\n        if ($user->role === 'super-admin') {\n            return true; \u002F\u002F Grants all abilities\n        }\n        return null; \u002F\u002F Fall through to normal checks\n    });\n}\n\n\u002F\u002F Usage in controllers\npublic function update(Request $request, Post $post): RedirectResponse\n{\n    Gate::authorize('update-post', $post);\n    \u002F\u002F Or: $this->authorize('update-post', $post);\n    \u002F\u002F Or: abort_unless(Auth::user()->can('update-post', $post), 403);\n    \u002F\u002F ...\n}\n```\n\n### Policies\n\n```php\n\u002F\u002F App\\Policies\\PostPolicy\nclass PostPolicy\n{\n    use HandlesAuthorization;\n\n    public function viewAny(?User $user): bool\n    {\n        return true; \u002F\u002F Public listing\n    }\n\n    public function view(?User $user, Post $post): bool\n    {\n        return $post->is_published || ($user && $user->id === $post->user_id);\n    }\n\n    public function create(User $user): bool\n    {\n        return $user->hasVerifiedEmail(); \u002F\u002F Must verify email first\n    }\n\n    public function update(User $user, Post $post): bool\n    {\n        return $user->id === $post->user_id;\n    }\n\n    public function delete(User $user, Post $post): bool\n    {\n        return $user->id === $post->user_id && $post->created_at->diffInDays(now()) \u003C= 30;\n    }\n\n    public function restore(User $user, Post $post): bool\n    {\n        return $user->role === 'admin';\n    }\n\n    public function forceDelete(User $user, Post $post): bool\n    {\n        return $user->role === 'super-admin';\n    }\n}\n\n\u002F\u002F Register in AuthServiceProvider\nprotected $policies = [\n    Post::class => PostPolicy::class,\n];\n\n\u002F\u002F Controller usage\npublic function show(Post $post): View\n{\n    $this->authorize('view', $post);\n    return view('posts.show', compact('post'));\n}\n\n\u002F\u002F Blade usage\n@can('update', $post)\n    \u003Ca href=\"{{ route('posts.edit', $post) }}\">Edit\u003C\u002Fa>\n@endcan\n\n@cannot('update', $post)\n    \u003Cspan>You cannot edit this post\u003C\u002Fspan>\n@endcannot\n```\n\n### Middleware Authorization\n\n```php\n\u002F\u002F Using middleware in routes\nRoute::put('\u002Fposts\u002F{post}', [PostController::class, 'update'])\n    ->middleware('can:update,post');\n\nRoute::get('\u002Fposts\u002Fcreate', [PostController::class, 'create'])\n    ->middleware('can:create,App\\Models\\Post');\n\n\u002F\u002F Custom authorization middleware\n\u002F\u002F app\u002FHttp\u002FMiddleware\u002FCheckRole.php\nclass CheckRole\n{\n    public function handle(Request $request, Closure $next, string $role): mixed\n    {\n        if (!$request->user() || $request->user()->role !== $role) {\n            abort(403, 'Unauthorized. This area requires role: ' . $role);\n        }\n        return $next($request);\n    }\n}\n\n\u002F\u002F Register in Kernel\nprotected $routeMiddleware = [\n    'role' => \\App\\Http\\Middleware\\CheckRole::class,\n];\n\n\u002F\u002F Route usage\nRoute::middleware(['auth', 'role:admin'])->group(function () {\n    Route::get('\u002Fadmin', [AdminController::class, 'index']);\n});\n```\n\n## Eloquent Security\n\n### Mass Assignment Protection\n\n```php\n\u002F\u002F BAD: $guarded = [] allows ALL columns to be mass-assigned\n\u002F\u002F NEVER use $guarded = [] in production\n\n\u002F\u002F GOOD: Whitelist fillable attributes\nfinal class User extends Authenticatable\n{\n    protected $fillable = [\n        'name',\n        'email',\n        'phone',\n        'avatar',\n    ];\n    \u002F\u002F NEVER add 'role', 'is_admin', 'is_verified' here\n}\n\n\u002F\u002F GOOD: Explicitly control which fields can be filled in requests\npublic function store(StoreUserRequest $request): RedirectResponse\n{\n    $user = User::create($request->safe()->only([\n        'name', 'email', 'phone', 'avatar'\n    ]));\n    \u002F\u002F $request->safe() uses validated data only\n    \u002F\u002F $request->only() is NOT safe on its own without validation rules\n}\n\n\u002F\u002F BAD: Creating a user with request data directly\nUser::create($request->all()); \u002F\u002F VULNERABLE to mass assignment!\n\n\u002F\u002F BETTER: Use DTOs for creation\n$user = User::create($request->validated()); \u002F\u002F Only validated fields\n```\n\n### SQL Injection Prevention\n\n```php\n\u002F\u002F GOOD: Eloquent automatically parameterizes queries\nUser::where('email', $userInput)->first();\nUser::whereRaw('email = ?', [$userInput])->first();\n\n\u002F\u002F GOOD: Query Builder also parameterizes\nDB::table('users')->where('email', $userInput)->first();\nDB::select('SELECT * FROM users WHERE email = ?', [$userInput]);\n\n\u002F\u002F BAD: Raw string interpolation\nDB::select(\"SELECT * FROM users WHERE email = '{$userInput}'\"); \u002F\u002F VULNERABLE!\nUser::whereRaw(\"email = '{$userInput}'\")->first(); \u002F\u002F VULNERABLE!\n\n\u002F\u002F BAD: whereRaw\u002ForderByRaw with unescaped input\nUser::orderByRaw($userInput); \u002F\u002F VULNERABLE!\nUser::groupByRaw($userInput); \u002F\u002F VULNERABLE!\n\n\u002F\u002F BAD: DB::statement with concatenation\nDB::statement(\"INSERT INTO users (email) VALUES ('{$userInput}')\"); \u002F\u002F VULNERABLE!\n```\n\n### Attribute Casting\n\n```php\nfinal class User extends Authenticatable\n{\n    protected $casts = [\n        'email_verified_at' => 'datetime',\n        'is_admin' => 'boolean', \u002F\u002F Cast to boolean prevents string injection\n        'settings' => 'array', \u002F\u002F Automatically json_encode\u002Fjson_decode\n        'metadata' => 'encrypted:array', \u002F\u002F Laravel 11+ encrypted casting\n        'password' => 'hashed', \u002F\u002F Laravel 10+ auto-hashes on set\n    ];\n}\n```\n\n### Model Security\n\n```php\nfinal class User extends Authenticatable\n{\n    \u002F\u002F Hide sensitive attributes from JSON\u002FAPI responses\n    protected $hidden = [\n        'password',\n        'remember_token',\n        'two_factor_secret',\n        'two_factor_recovery_codes',\n    ];\n\n    \u002F\u002F Append only safe computed attributes\n    protected $appends = ['full_name']; \u002F\u002F safe\n    \u002F\u002F NEVER append sensitive computed data\n}\n\nfinal class Post extends Model\n{\n    \u002F\u002F Global scope to filter soft deleted records\n    use SoftDeletes;\n\n    \u002F\u002F Prevent N+1 by restricting lazy loading (optional strict mode)\n    \u002F\u002F AppServiceProvider::boot()\n    \u002F\u002F Model::preventLazyLoading(!app()->isProduction());\n}\n```\n\n## CSRF Protection\n\n### Default Protection\n\n```php\n\u002F\u002F Laravel CSRF is enabled by default via VerifyCsrfToken middleware\n\u002F\u002F app\u002FHttp\u002FKernel.php (protected $middlewareGroups['web'])\n\n\u002F\u002F All POST\u002FPUT\u002FPATCH\u002FDELETE forms must include @csrf\n\u003Cform method=\"POST\" action=\"\u002Fposts\">\n    @csrf\n    \u003Cinput type=\"text\" name=\"title\">\n    \u003Cbutton type=\"submit\">Create\u003C\u002Fbutton>\n\u003C\u002Fform>\n```\n\n### Excluding Routes (Carefully)\n\n```php\n\u002F\u002F app\u002FHttp\u002FMiddleware\u002FVerifyCsrfToken.php\nclass VerifyCsrfToken extends Middleware\n{\n    \u002F\u002F Only exclude routes that have external CSRF protection (webhooks, etc.)\n    protected $except = [\n        'stripe\u002F*', \u002F\u002F Stripe webhooks use their own signature verification\n        \u002F\u002F Avoid blanket 'api\u002F*' — stateful Sanctum routes need CSRF.\n        \u002F\u002F Exclude only specific stateless webhook\u002Fendpoint routes.\n    ];\n}\n```\n\n### CSRF with JavaScript\n\n```html\n\u003Cmeta name=\"csrf-token\" content=\"{{ csrf_token() }}\">\n\n\u003Cscript>\n\u002F\u002F Axios example (Laravel ships with Axios)\naxios.defaults.headers.common['X-CSRF-TOKEN'] = document.querySelector(\n    'meta[name=\"csrf-token\"]'\n).getAttribute('content');\n\n\u002F\u002F Fetch example\nfetch('\u002Fposts', {\n    method: 'POST',\n    headers: {\n        'X-CSRF-TOKEN': document.querySelector('meta[name=\"csrf-token\"]').getAttribute('content'),\n        'Content-Type': 'application\u002Fjson',\n    },\n    body: JSON.stringify(data),\n});\n\u003C\u002Fscript>\n```\n\n## XSS Prevention\n\n### Blade Templating Security\n\n```blade\n{{-- SAFE: Auto-escaped by Blade --}}\n{{ $userInput }}\n\n{{-- DANGEROUS: Raw output — NEVER use with user input --}}\n{!! $userInput !!}\n\n{{-- SAFE: Only use {!! !!} with trusted content you control --}}\n{!! $trustedHtmlFromYourServer !!}\n\n{{-- GOOD: Use specific escaping directives --}}\n@js($data) {{-- JSON encode for JavaScript --}}\n@json($data) {{-- JSON encode in templates --}}\n\n{{-- BAD: Direct user input in raw HTML --}}\n\u003Cdiv>{!! $user->bio !!}\u003C\u002Fdiv> {{-- VULNERABLE if user provides bio --}}\n```\n\n### Safe HTML Handling\n\n```php\n\u002F\u002F When you must allow some HTML, use a whitelist approach\nuse HTMLPurifier; \u002F\u002F Requires: composer require ezyang\u002Fhtmlpurifier\n\npublic function sanitizeHtml(string $dirty): string\n{\n    $config = \\HTMLPurifier_Config::createDefault();\n    $config->set('HTML.Allowed', 'p,b,i,a[href],ul,ol,li,br');\n    $config->set('URI.AllowedSchemes', ['http', 'https', 'mailto']);\n    $purifier = new \\HTMLPurifier($config);\n    return $purifier->purify($dirty);\n}\n\n\u002F\u002F In blade:\n\u003Cdiv>{!! $sanitizedContent !!}\u003C\u002Fdiv> {{-- Safe after purification --}}\n```\n\n### JavaScript Context Escaping\n\n```blade\n{{-- SAFE: Blade @js escapes for JavaScript context --}}\n\u003Cscript>\n    const user = @js($user); \u002F\u002F JSON + escaped for JS context\n    const settings = @json($settings); \u002F\u002F Direct JSON encode\n\u003C\u002Fscript>\n\n{{-- DANGEROUS: Manual JSON in JS context --}}\n\u003Cscript>\n    const user = {{ json_encode($user) }}; \u002F\u002F NOT escaped for JS!\n\u003C\u002Fscript>\n```\n\n### HTTP Headers for XSS Protection\n\n```php\n\u002F\u002F App\\Http\\Middleware\\SecurityHeaders.php\nclass SecurityHeaders\n{\n    public function handle(Request $request, Closure $next): mixed\n    {\n        $response = $next($request);\n\n        $response->headers->set('X-Content-Type-Options', 'nosniff');\n        $response->headers->set('X-Frame-Options', 'DENY');\n        $response->headers->set('X-XSS-Protection', '1; mode=block');\n        $response->headers->set('Referrer-Policy', 'strict-origin-when-cross-origin');\n        $response->headers->set(\n            'Content-Security-Policy',\n            \"default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data: https:; font-src 'self'; connect-src 'self'; frame-ancestors 'none'\"\n        );\n\n        return $response;\n    }\n}\n\n\u002F\u002F Register in kernel\nprotected $middleware = [\n    \\App\\Http\\Middleware\\SecurityHeaders::class,\n];\n```\n\n## Input Validation\n\n### Form Request Validation\n\n```php\nfinal class StorePostRequest extends FormRequest\n{\n    public function authorize(): bool\n    {\n        return $this->user()?->can('create', Post::class) ?? false;\n    }\n\n    public function rules(): array\n    {\n        return [\n            'title' => ['required', 'string', 'max:255', 'sanitize_html'],\n            'content' => ['required', 'string', 'max:10000'],\n            'image' => [\n                'required',\n                'image',\n                'mimes:jpg,jpeg,png,gif,webp', \u002F\u002F Whitelist specific types\n                'max:2048', \u002F\u002F 2MB max\n            ],\n            'tags' => ['array'],\n            'tags.*' => ['integer', 'exists:tags,id'],\n        ];\n    }\n\n    public function messages(): array\n    {\n        return [\n            'title.max' => 'Post title must not exceed 255 characters.',\n            'image.max' => 'Image must be under 2MB.',\n        ];\n    }\n\n    \u002F\u002F Sanitize input after validation\n    public function validated($key = null, $default = null): mixed\n    {\n        $validated = parent::validated();\n        $validated['title'] = strip_tags($validated['title']);\n        return $key ? ($validated[$key] ?? $default) : $validated;\n    }\n}\n```\n\n### Custom Validation Rules\n\n```php\n\u002F\u002F app\u002FRules\u002FStrongPassword.php\nclass StrongPassword implements Rule\n{\n    public function passes($attribute, $value): bool\n    {\n        return preg_match('\u002F^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d)(?=.*[@$!%*?&#^()_\\-+=])[A-Za-z\\d@$!%*?&#^()_\\-+=]{12,}$\u002F', $value);\n    }\n\n    public function message(): string\n    {\n        return 'The :attribute must be at least 12 characters with uppercase, lowercase, number, and symbol.';\n    }\n}\n\n\u002F\u002F app\u002FRules\u002FNotBlacklistedDomain.php\nclass NotBlacklistedDomain implements Rule\n{\n    private array $blacklisted = ['mailinator.com', 'guerrillamail.com'];\n\n    public function passes($attribute, $value): bool\n    {\n        $domain = substr(strrchr($value, '@'), 1);\n        return !in_array(strtolower($domain), $this->blacklisted);\n    }\n\n    public function message(): string\n    {\n        return 'Email from disposable domains is not allowed.';\n    }\n}\n```\n\n## API Security\n\n### Rate Limiting\n\n```php\n\u002F\u002F App\u002FProviders\u002FRouteServiceProvider\nprotected function configureRateLimiting(): void\n{\n    RateLimiter::for('api', function (Request $request) {\n        return Limit::perMinute(60)->by($request->user()?->id ?: $request->ip());\n    });\n\n    RateLimiter::for('auth', function (Request $request) {\n        return Limit::perMinute(5)->by($request->ip())\n            ->response(function () {\n                return response()->json([\n                    'message' => 'Too many login attempts. Try again in 1 minute.',\n                ], 429);\n            });\n    });\n\n    RateLimiter::for('uploads', function (Request $request) {\n        return Limit::perHour(10)->by($request->user()?->id ?? $request->ip())\n            ->response(function () {\n                return response()->json([\n                    'message' => 'Upload limit reached. Try again later.',\n                ], 429);\n            });\n    });\n}\n\n\u002F\u002F Route usage\nRoute::middleware(['auth:sanctum', 'throttle:api'])->group(function () {\n    Route::apiResource('posts', PostController::class);\n});\n\nRoute::post('\u002Flogin', [AuthController::class, 'login'])\n    ->middleware('throttle:auth');\n```\n\n### API Authentication — Sanctum vs Passport\n\n```php\n\u002F\u002F Sanctum (recommended for most apps — simple, first-party, SPA)\n\u002F\u002F config\u002Fsanctum.php\n'expiration' => 60 * 24, \u002F\u002F Tokens expire after 24 hours\n'model' => User::class,\n\n\u002F\u002F Issuing scoped tokens\n$token = $user->createToken('client-name', [\n    'posts:read',\n    'posts:write',\n])->plainTextToken;\n\n\u002F\u002F Middleware scoping\nRoute::middleware('auth:sanctum')->group(function () {\n    Route::get('\u002Fposts', [PostController::class, 'index'])\n        ->middleware('abilities:posts:read');\n\n    Route::post('\u002Fposts', [PostController::class, 'store'])\n        ->middleware('abilities:posts:write');\n});\n\n\u002F\u002F Passport (OAuth2 — for third-party clients or complex auth flows)\n\u002F\u002F Install: composer require laravel\u002Fpassport\nPassport::tokensExpireIn(now()->addDays(15));\nPassport::refreshTokensExpireIn(now()->addDays(30));\nPassport::personalAccessTokensExpireIn(now()->addMonths(6));\n```\n\n### CORS Configuration\n\n```php\n\u002F\u002F config\u002Fcors.php\nreturn [\n    'paths' => ['api\u002F*', 'sanctum\u002Fcsrf-cookie'],\n    'allowed_methods' => ['*'],\n    'allowed_origins' => explode(',', env('CORS_ALLOWED_ORIGINS', '')), \u002F\u002F Whitelist specific origins\n    'allowed_origins_patterns' => [],\n    'allowed_headers' => ['*'],\n    'exposed_headers' => ['X-Total-Count', 'X-Pagination-Page'],\n    'max_age' => 0,\n    'supports_credentials' => true, \u002F\u002F Required for Sanctum SPA auth\n];\n\n\u002F\u002F NEVER: Allow all origins in production unless absolutely necessary\n\u002F\u002F 'allowed_origins' => ['*'], \u002F\u002F Only for truly public APIs\n```\n\n## File Upload Security\n\n### Validation\n\n```php\npublic function rules(): array\n{\n    return [\n        'document' => [\n            'required',\n            'file',\n            'mimes:pdf,doc,docx,xls,xlsx', \u002F\u002F Whitelist specific MIME types\n            'max:10240', \u002F\u002F 10MB\n            'extensions:pdf,doc,docx,xls,xlsx', \u002F\u002F Verify extension matches MIME\n        ],\n        'avatar' => [\n            'nullable',\n            'image', \u002F\u002F Ensures it's a valid image\n            'mimes:jpg,jpeg,png,webp',\n            'max:2048',\n            'dimensions:min_width=100,min_height=100,max_width=2000,max_height=2000',\n        ],\n    ];\n}\n```\n\n### Secure Storage\n\n```php\n\u002F\u002F Store files outside public directory\n$path = $request->file('document')->store('documents', 'local');\n\u002F\u002F Never use 'public' disk for sensitive documents\n\n\u002F\u002F Use signed URLs for temporary file access\nuse Illuminate\\Support\\Facades\\Storage;\n\npublic function download(Request $request, string $path)\n{\n    \u002F\u002F Generate temporary signed URL (expires in 15 minutes)\n    $url = Storage::temporaryUrl($path, now()->addMinutes(15));\n\n    \u002F\u002F Validate user has permission\n    $this->authorize('download', $path);\n\n    return redirect($url);\n}\n\n\u002F\u002F Storage configuration for cloud with encryption\n\u002F\u002F config\u002Ffilesystems.php\n's3' => [\n    'driver' => 's3',\n    'key' => env('AWS_ACCESS_KEY_ID'),\n    'secret' => env('AWS_SECRET_ACCESS_KEY'),\n    'region' => env('AWS_DEFAULT_REGION'),\n    'bucket' => env('AWS_BUCKET'),\n    'url' => env('AWS_URL'),\n    'endpoint' => env('AWS_ENDPOINT'),\n    'use_path_style_endpoint' => env('AWS_USE_PATH_STYLE_ENDPOINT', false),\n    'throw' => false,\n    'server_side_encryption' => 'AES256', \u002F\u002F Encrypt at rest\n],\n```\n\n## Dependencies and Secrets\n\n### Composer Security\n\n```bash\n# Always audit dependencies in CI\ncomposer audit\n\n# Pin major versions in composer.json\n\"laravel\u002Fframework\": \"^11.0\",\n\"spatie\u002Flaravel-permission\": \"^6.0\"\n\n# Check for abandoned packages\ncomposer why-not\n\n# Keep lock file in version control (it pins exact versions)\n# Run `composer update` deliberately, never in CI\u002FCD\n```\n\n### Secret Management\n\n```bash\n# .env file (NEVER commit)\n# .gitignore includes .env by default\n\nAPP_KEY=base64:abc123...\nDB_PASSWORD=secure_password\nSTRIPE_KEY=sk_live_...\nSANCTUM_TOKEN_PREFIX=myapp_\n\n# For production: Use a secret manager\n# Deploy with: env $(aws secretsmanager get-secret-value --secret-id prod\u002Fdb | jq ...) php artisan serve\n\n# Validate secrets at boot (AppServiceProvider::boot)\n$secrets = ['services.stripe.key', 'services.stripe.webhook_secret'];\nforeach ($secrets as $key) {\n    if (empty(config($key))) {\n        Log::critical(\"Missing secret: {$key}\");\n    }\n}\n```\n\n## Queue Security\n\n```php\n\u002F\u002F Define a named rate limiter (typically in AppServiceProvider::boot())\nRateLimiter::for('payments', fn () => Limit::perMinute(5));\n```\n\n```php\n\u002F\u002F Encrypt sensitive job data by implementing the interface\nfinal class ProcessPaymentJob implements ShouldQueue, ShouldBeEncrypted\n{\n    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;\n\n    public function __construct(\n        private readonly string $paymentIntentId, \u002F\u002F Public IDs are fine\n        private readonly string $cardFingerprint, \u002F\u002F Encrypted via ShouldBeEncrypted\n    ) {}\n\n    public function handle(): void\n    {\n        \u002F\u002F Process payment\n    }\n\n    \u002F\u002F Limit retries and delay between attempts\n    public function retryUntil(): Carbon\n    {\n        return now()->addMinutes(5);\n    }\n\n    \u002F\u002F Rate limit how many jobs of this type can run\n    public function middleware(): array\n    {\n        return [\n            new RateLimited('payments'),\n        ];\n    }\n}\n```\n\n## Logging Security Events\n\n```php\n\u002F\u002F config\u002Flogging.php\n'channels' => [\n    'security' => [\n        'driver' => 'single',\n        'path' => storage_path('logs\u002Fsecurity.log'),\n        'level' => 'warning',\n    ],\n],\n\n\u002F\u002F Audit log helper\nfinal class SecurityLogger\n{\n    public static function log(string $event, array $context = []): void\n    {\n        Log::channel('security')->warning($event, array_merge([\n            'user_id' => Auth::id(),\n            'ip' => request()->ip(),\n            'user_agent' => request()->userAgent(),\n            'url' => request()->fullUrl(),\n            'timestamp' => now()->toIso8601String(),\n        ], $context));\n    }\n}\n\n\u002F\u002F Usage\nSecurityLogger::log('failed_login_attempt', ['email' => $email]);\nSecurityLogger::log('password_change');\nSecurityLogger::log('role_change', ['target_user' => $targetId, 'new_role' => 'admin']);\nSecurityLogger::log('suspicious_activity', ['reason' => 'multiple_attempts_from_different_ips']);\n```\n\n## Quick Security Checklist\n\n| Check | Description |\n|-------|-------------|\n| `APP_DEBUG=false` | Never run with debug enabled in production |\n| `APP_KEY` set | Always run `php artisan key:generate` |\n| HTTPS enforced | Force HTTPS in production via middleware or proxy |\n| `$fillable` whitelisted | Never use `$guarded = []` |\n| CSRF active | `@csrf` on all state-changing forms |\n| Sanctum\u002FPassport configured | API authentication with token abilities\u002Fscopes |\n| Rate limiting applied | Throttle API and auth endpoints |\n| Input validation | FormRequest with specific rules, never `$request->all()` |\n| File upload restrictions | Validate MIME types, size, dimensions |\n| `composer audit` in CI | Check dependencies for known vulnerabilities |\n| `password_hash` \u002F `password_verify` | Use Laravel's built-in hashing (bcrypt\u002FArgon2) |\n| Session regeneration on login | Call `$request->session()->regenerate()` |\n| Security headers middleware | CSP, X-Frame-Options, X-Content-Type-Options |\n| Logged security events | Audit log for auth failures, role changes, suspicious activity |\n| `.env` not committed | Verify `.gitignore` includes `.env` |\n\n## Related Skills\n\n- `laravel-patterns` — Laravel architecture, routing, Eloquent, and API patterns\n- `backend-patterns` — General backend API and database patterns\n- `laravel-tdd` — Laravel testing with PHPUnit and Pest\n",{"name":5,"metadata":24,"description":7},{"origin":25},"ECC","main","d69096e239f2a89aabc2cd078c47664a9d3b1e11","04-安全渗透\u002Flaravel-security",3,"https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts","https:\u002F\u002Fgithub.com\u002Flza6","个人vx：Tf00798\r\n个人✈：@TFGY999","2026-10-08 14:29:22",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add lza6\u002FArmor-piercing-system-prompts --skill laravel-security",{"tool":40,"command":41},"bunx","bunx skills add lza6\u002FArmor-piercing-system-prompts --skill laravel-security",{"tool":43,"command":44},"pnpm","pnpm dlx skills add lza6\u002FArmor-piercing-system-prompts --skill laravel-security","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F04-安全渗透\u002Flaravel-security\u002FSKILL.md",true,[],[49,57,62,69,76,83],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":56},"01M7FFG485KY83TD6HSC4YPCMC","obsidian-clipper-template-creator","Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobsidian-clipper-template-creator\u002FSKILL.md",[],[],"2026-11-16 10:05:34",{"skillNo":58,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":56},"01M7FFG0T6AZ0STEJPSB3CX84K","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobsidian-clipper-template-creator-antigravity-awesome-skills-main\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":56},"01M7FFFY0QEM14SKWPDYGMXM2P","python-api","Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP\u002FmAP semantics, and source-style import diagnostics.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobject-detection-metrics\u002Fsub-skills\u002Fpython-api\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":56},"01M7FFFVZQZ2GJ0C0TGP7JHD20","file-evaluation","Folder-based PASCAL VOC AP\u002FmAP evaluation from ground-truth and detection text files.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobject-detection-metrics\u002Fsub-skills\u002Ffile-evaluation\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":56},"01M7FFFSFNYSE77SJ6PE1CK2DA","object-detection-metrics","Guides legacy Object-Detection-Metrics PASCAL VOC AP\u002FmAP evaluation from detection text folders and direct Python API classes.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobject-detection-metrics\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":56},"01M7FFFP0GCK1RVXBCPQ8APBMT","nx-workspace-patterns","Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fnx-workspace-patterns\u002FSKILL.md",[],[]]