54:T51a, 'Create Post', 'slug' => 'create-post', 'description' => 'Can create posts' ]); $editPost = Permission::create([ 'name' => 'Edit Post', 'slug' => 'edit-post', 'description' => 'Can edit posts' ]); // Create roles $admin = Role::create([ 'name' => 'Administrator', 'slug' => 'admin', 'description' => 'Administrator with full access' ]); $editor = Role::create([ 'name' => 'Editor', 'slug' => 'editor', 'description' => 'Editor with limited access' ]); // Assign permissions to roles $admin->givePermissionTo($createPost, $editPost); $editor->givePermissionTo($createPost); // Assign role to user $user = User::find(1); if ($user) { $user->assignRole('admin'); } } }55:T515, 'All Post Permissions', 'slug' => 'posts.*', 'description' => 'Grants all post-related permissions' ]); $role = Role::where('slug', 'content-manager')->first(); $role->givePermissionTo('posts.*'); $user = User::find(1); $user->assignRole('content-manager'); // Now user has access to all post-related permissions $user->hasPermission('posts.create'); // true $user->hasPermission('posts.edit'); // true $user->hasPermission('posts.delete'); // true $user->hasPermission('posts.publish'); // true $user->hasPermission('posts.archive'); // true // Works with nested patterns $user->givePermissionTo('admin.*'); $user->hasPermission('admin.users.create'); // true $user->hasPermission('admin.settings.update'); // true // Mixed wildcard and specific permissions $user->givePermissionTo('comments.moderate'); $user->givePermissionTo('reports.*'); $user->hasPermission('comments.moderate'); // true $user->hasPermission('reports.view'); // true $user->hasPermission('reports.export'); // true 56:T4b1,get(); // Get users with any of multiple roles $staff = User::role(['admin', 'editor', 'moderator'])->get(); // Get users with specific permission $authors = User::permission('create-post')->get(); // Get users with any of multiple permissions $contentCreators = User::permission(['create-post', 'create-article'])->get(); // Get users WITHOUT specific role $regularUsers = User::withoutRole('banned')->get(); // Get users WITHOUT specific permission $limitedUsers = User::withoutPermission('delete-post')->get(); // Combine scopes with query builder $activeEditors = User::role('editor') ->permission('create-post') ->where('status', 'active') ->where('email_verified_at', '!=', null) ->orderBy('created_at', 'desc') ->get(); // Complex filtering $seniorStaff = User::role(['admin', 'senior-editor']) ->withoutRole('suspended') ->permission('manage-users') ->whereDate('created_at', '<', now()->subYear()) ->paginate(20); // Count users by role $adminCount = User::role('admin')->count(); $editorCount = User::role('editor')->count(); 57:T47d, 'Super Administrator', 'slug' => 'super-admin', 'description' => 'Has all permissions automatically' ]); $user = User::find(1); $user->assignRole('super-admin'); // Super admin check if ($user->isSuperAdmin()) { echo "Unlimited access granted"; } // Super admin has ALL permissions without explicit assignment $user->hasPermission('any-permission'); // true $user->hasPermission('delete-everything'); // true $user->hasPermission('system-configuration'); // true $user->can('perform-any-action'); // true // Super admin bypasses all permission checks if ($user->isSuperAdmin()) { // Skip detailed permission checking // Grant full access to all features return response()->json(['access' => 'unlimited']); } // Regular permission flow for non-super admins if ($user->hasPermission('specific-action')) { // Normal authorization logic } 58:T4be, 'Web Administrator', 'slug' => 'admin', 'guard_name' => 'web' ]); $apiAdmin = Role::create([ 'name' => 'API Administrator', 'slug' => 'admin', 'guard_name' => 'api' ]); $backofficeManager = Role::create([ 'name' => 'Backoffice Manager', 'slug' => 'manager', 'guard_name' => 'backoffice' ]); // Create permissions for specific guards $webCreatePost = Permission::create([ 'name' => 'Create Post (Web)', 'slug' => 'create-post', 'guard_name' => 'web' ]); $apiCreatePost = Permission::create([ 'name' => 'Create Post (API)', 'slug' => 'create-post', 'guard_name' => 'api' ]); // Query by guard $webRoles = Role::forGuard('web')->get(); $apiPermissions = Permission::forGuard('api')->get(); // Find by slug and guard $webAdminRole = Role::findBySlug('admin', 'web'); $apiAdminRole = Role::findBySlug('admin', 'api'); // Find or create with guard $moderator = Role::findOrCreate('moderator', 'Moderator', 'api'); 53:{"contextType":"code","snippets":[{"codeTitle":"Install Laravel Permissions Package (Composer)","codeDescription":"This snippet shows how to add the Laravel Permissions package to your project's composer.json file and update dependencies. It requires defining a path repository for local installation.","codeLanguage":"json","codeTokens":106,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/QUICKSTART.md#_snippet_0","pageTitle":"Laravel Permissions Quick Start Guide","codeList":[{"language":"json","code":"{\n \"repositories\": [\n {\n \"type\": \"path\",\n \"url\": \"./packages/saeedvir/laravel-permissions\"\n }\n ],\n \"require\": {\n \"saeedvir/laravel-permissions\": \"*\"\n }\n}"},{"language":"bash","code":"composer update"}],"relevance":0.032291666,"generationDate":"2025-11-11T01:38:23.807Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Cache Configuration Example (PHP)","codeDescription":"Configuration settings for caching permissions within the laravel-permissions package. It allows enabling/disabling cache, setting expiration time, prefix, and storage driver. Reads from environment variables for dynamic configuration.","codeLanguage":"php","codeTokens":115,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_11","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"php","code":"'cache' => [\n 'enabled' => env('PERMISSION_CACHE_ENABLED', true),\n 'expiration_time' => env('PERMISSION_CACHE_EXPIRATION', 3600),\n 'key_prefix' => 'saeedvir_permissions',\n 'store' => env('PERMISSION_CACHE_STORE', 'default'),\n],"}],"relevance":0.032002047,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Run Database Migrations","codeDescription":"This command executes the database migrations for the Laravel Permissions package, creating the necessary tables to store roles, permissions, and their relationships.","codeLanguage":"bash","codeTokens":40,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/QUICKSTART.md#_snippet_2","pageTitle":"Laravel Permissions Quick Start Guide","codeList":[{"language":"bash","code":"php artisan migrate"}],"relevance":0.03159204,"generationDate":"2025-11-11T01:38:23.807Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Installation and Setup - Laravel Permissions","codeDescription":"Install the Laravel permissions package via Composer, publish configuration files, set up database connections, and run migrations. Requires PHP 8.2+, Laravel 11/12, and Composer. Environment variables control database connection and caching settings.","codeLanguage":"bash","codeTokens":159,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/README.md#_snippet_0","pageTitle":"Laravel Permissions Package Documentation","codeList":[{"language":"bash","code":"# Install package\ncomposer require saeedvir/laravel-permissions\n\n# Publish config\nphp artisan vendor:publish --tag=permissions-config\n\n# Run migrations\nphp artisan migrate\n\n# Add trait to User model and start using!"},{"language":"bash","code":"# Publish configuration\nphp artisan vendor:publish --tag=permissions-config\n\n# Environment configuration\nPERMISSION_DB_connection=mysql\nPERMISSION_DB_NAME=laravel_permission\nPERMISSION_CACHE_ENABLED=true\nPERMISSION_CACHE_EXPIRATION=3600"}],"relevance":0.029857397,"generationDate":"2025-11-11T01:39:45.088Z","model":"minimax/minimax-m2"},{"codeTitle":"Run Database Seeder (Bash)","codeDescription":"Command to execute a specific database seeder class. This is used to run the RolesAndPermissionsSeeder after it has been created. No specific inputs or outputs, simply executes the seeder.","codeLanguage":"bash","codeTokens":63,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_8","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"bash","code":"php artisan db:seed --class=RolesAndPermissionsSeeder"}],"relevance":0.029236022,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Create roles and permissions in Laravel","codeDescription":"Example code for creating roles and permissions in the application. Demonstrates role creation with name and slug, permission creation, and assigning permissions to roles. Foundational for access control setup.","codeLanguage":"php","codeTokens":100,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/PACKAGE-SUMMARY.md#_snippet_5","pageTitle":"Unknown","codeList":[{"language":"php","code":"$$admin = Role::create(['name' => 'Admin', 'slug' => 'admin']);\n$permission = Permission::create(['name' => 'Create Post', 'slug' => 'create-post']);\n$admin->givePermissionTo('create-post');"}],"relevance":0.028991597,"generationDate":"2025-11-11T01:38:52.557Z","model":"Unknown"},{"codeTitle":"Publish Configuration and Update .env","codeDescription":"This command publishes the package's configuration file and demonstrates how to update your application's .env file with specific permission settings. These settings control database table names and cache behavior.","codeLanguage":"bash","codeTokens":77,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/QUICKSTART.md#_snippet_1","pageTitle":"Laravel Permissions Quick Start Guide","codeList":[{"language":"bash","code":"php artisan vendor:publish --tag=permissions-config"},{"language":"env","code":"PERMISSION_DB_NAME=laravel_permission\nPERMISSION_CACHE_ENABLED=true"}],"relevance":0.028177224,"generationDate":"2025-11-11T01:38:23.807Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Seed Initial Roles and Permissions (PHP)","codeDescription":"Creates a database seeder to populate initial roles and permissions. It defines permissions, roles, assigns permissions to roles, and assigns a role to a user. Requires the Saeedvir\\LaravelPermissions\\Models\\Role and \\Saeedvir\\LaravelPermissions\\Models\\Permission models, and an App\\Models\\User model.","codeLanguage":"php","codeTokens":370,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_7","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"php","code":"$54"}],"relevance":0.028158147,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Cache Permissions and Config (Bash)","codeDescription":"Commands to clear the application cache and then cache the configuration. This is a troubleshooting step for ensuring permissions are correctly cached and applied. Verifies cache enablement and driver functionality.","codeLanguage":"bash","codeTokens":62,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_16","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"bash","code":"php artisan cache:clear\npH p artisan config:cache"}],"relevance":0.02759802,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Install Laravel Permissions via Composer Bash Commands","codeDescription":"These Bash commands update or install the Laravel Permissions package dependencies using Composer. Dependencies include Composer and a valid composer.json. Inputs are the current project state, with outputs being updated vendor directory and lock files. Limitations: Requires internet connection for updates and assumes composer.json is correctly configured.","codeLanguage":"bash","codeTokens":87,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_0","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"bash","code":"composer update saeedvir/laravel-permissions"},{"language":"bash","code":"composer install"}],"relevance":0.027579736,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Migrate Database Tables (Bash)","codeDescription":"Commands to manage database migrations, specifically checking migration status and forcing migration execution. Used for troubleshooting issues with table creation. Ensure database connection is properly configured in .env.","codeLanguage":"bash","codeTokens":60,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_13","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"bash","code":"php artisan migrate:status\npH p artisan migrate --force"}],"relevance":0.026838433,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Create Roles, Permissions, and Assign Them (PHP)","codeDescription":"This PHP snippet demonstrates how to programmatically create new roles and permissions, assign permissions to roles, and then assign roles to specific users. It utilizes the `Role` and `Permission` models provided by the package.","codeLanguage":"php","codeTokens":179,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/QUICKSTART.md#_snippet_4","pageTitle":"Laravel Permissions Quick Start Guide","codeList":[{"language":"php","code":"use Saeedvir\\LaravelPermissions\\Models\\Role;\nuse Saeedvir\\LaravelPermissions\\Models\\Permission;\n\n// Create permissions\n$createPost = Permission::create([\n 'name' => 'Create Post',\n 'slug' => 'create-post'\n]);\n\n// Create role\n$admin = Role::create([\n 'name' => 'Administrator',\n 'slug' => 'admin'\n]);\n\n// Assign permission to role\n$admin->givePermissionTo('create-post');\n\n// Assign role to user\n$user = User::find(1);\n$user->assignRole('admin');"}],"relevance":0.02608401,"generationDate":"2025-11-11T01:38:23.807Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Dump Composer Autoload (Bash)","codeDescription":"Command to regenerate the Composer autoloader. This is a common troubleshooting step when encountering 'class not found' errors after installing or updating packages. Also clears config and cache.","codeLanguage":"bash","codeTokens":69,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_14","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"bash","code":"composer dump-autoload\npH p artisan config:clear\npH p artisan cache:clear"}],"relevance":0.0260771,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Check Roles and Permissions in Blade Views","codeDescription":"This example demonstrates how to conditionally display content in your Blade templates based on a user's role or assigned permissions. This is useful for creating role-specific UI elements.","codeLanguage":"blade","codeTokens":88,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/QUICKSTART.md#_snippet_6","pageTitle":"Laravel Permissions Quick Start Guide","codeList":[{"language":"blade","code":"@role('admin')\n Admin Panel\n@endrole\n\n@permission('create-post')\n Create Post\n@endpermission"}],"relevance":0.026008826,"generationDate":"2025-11-11T01:38:23.807Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Run Laravel Permissions Migrations via Artisan","codeDescription":"These Artisan commands execute or publish migrations for the permissions package. Dependencies include Laravel and the package. Inputs are migration files, outputs are updated database schema. Limitations: Option A runs directly, Option B allows customization but requires manual publishing.","codeLanguage":"bash","codeTokens":87,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_4","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"bash","code":"php artisan migrate"},{"language":"bash","code":"php artisan vendor:publish --tag=permissions-migrations\nphp artisan migrate"}],"relevance":0.025678061,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Test Permissions Route (PHP)","codeDescription":"Defines a test route in Laravel to verify user roles and permissions. It retrieves the authenticated user and displays their roles and all assigned permissions. Requires authentication middleware.","codeLanguage":"php","codeTokens":132,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_9","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"php","code":"use Illuminate\\Support\\Facades\\Route;\n\nRoute::get('/test-permissions', function () {\n $user = auth()->user();\n\n if (!$user) {\n return 'Please login first';\n }\n\n return [\n 'user' => $user->name,\n 'roles' => $user->roles->pluck('name'),\n 'permissions' => $user->getAllPermissions()->pluck('name'),\n ];\n})->middleware('auth');"}],"relevance":0.025381526,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Role and Permission Assignment in PHP","codeDescription":"Demonstrates creating a role, assigning permissions to it, creating a user, assigning the role to the user, and verifying the user's permissions.","codeLanguage":"PHP","codeTokens":115,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_13","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"php","code":"$$role = Role::create(['name' => 'Editor', 'slug' => 'editor']);\n$role->givePermissionTo('create-post', 'edit-post');\n$user = User::factory()->create();\n$user->assignRole('editor');\n$this->assertTrue($user->hasPermission('create-post'));\n$this->assertTrue($user->hasPermission('edit-post'));"}],"relevance":0.025188537,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Middleware Response Configuration (PHP)","codeDescription":"Defines how the package's middleware responds to unauthorized or unauthenticated access. Options include returning JSON, redirecting, or aborting with a status code. Configurable for both unauthorized and unauthenticated scenarios.","codeLanguage":"php","codeTokens":170,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_12","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"php","code":"'middleware' => [\n 'unauthorized_response' => [\n 'type' => 'json', // 'json', 'redirect', 'abort'\n 'redirect_to' => '/unauthorized',\n 'abort_code' => 403,\n 'json_message' => 'Unauthorized access.',\n ],\n 'unauthenticated_response' => [\n 'type' => 'redirect', // 'json', 'redirect', 'abort'\n 'redirect_to' => '/login',\n 'abort_code' => 401,\n 'json_message' => 'Unauthenticated.',\n ],\n],"}],"relevance":0.025158228,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Dynamic Permission Checks in PHP","codeDescription":"Illustrates how to perform dynamic permission checks for a logged-in user. It shows examples for checking if a user has any of a list of permissions (`hasAnyPermission`) and if they have all of a specified set of permissions (`hasAllPermissions`).","codeLanguage":"PHP","codeTokens":116,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_17","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"php","code":"if (auth()->user()->hasAnyPermission(['edit-own-post', 'edit-all-posts'])) {\n // Can edit posts\n}\n\nif (auth()->user()->hasAllPermissions(['create-post', 'publish-post'])) {\n // Can create and publish\n}"}],"relevance":0.02480974,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Query Scope Examples for Roles and Permissions","codeDescription":"Provides examples of using query scopes to filter users. It shows how to get users with the 'admin' role, how to delete users with the 'banned' role, and how to paginate users who have the 'write-post' permission.","codeLanguage":"php","codeTokens":97,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/CHANGES.md#_snippet_32","pageTitle":"CHANGELOG - Version 2.0.0","codeList":[{"language":"php","code":"$$admins = User::role('admin')->get();\n$banned = User::role('banned')->delete();\n$authors = User::permission('write-post')->paginate();"}],"relevance":0.02463401,"generationDate":"2025-11-11T01:38:39.421Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Clear Application Caches (Bash)","codeDescription":"Commands to clear various caches in a Laravel application. This is a common troubleshooting step to ensure changes are reflected. Includes clearing config, cache, view, and route caches.","codeLanguage":"bash","codeTokens":71,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_10","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"bash","code":"php artisan config:clear\nphp artisan cache:clear\nphp artisan view:clear\nphp artisan route:clear"}],"relevance":0.02435065,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Configure Environment Variables for Laravel Permissions","codeDescription":"These environment variables in .env configure database and caching for the permissions package. Dependencies include Laravel's environment handling. Inputs are the .env file, outputs are runtime configuration values. Limitations: Requires valid database settings and cache store availability.","codeLanguage":"env","codeTokens":95,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_1","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"env","code":"PERMISSION_DB_CONNECTION=mysql\nPERMISSION_DB_NAME=laravel_permission\nPERMISSION_CACHE_ENABLED=true\nPERMISSION_CACHE_EXPIRATION=3600\nPERMISSION_CACHE_STORE=default"}],"relevance":0.024202898,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Composer Configuration for Local Package Installation","codeDescription":"This JSON configuration is added to your main Laravel project's `composer.json` file to specify a local path for the 'saeedvir/laravel-permissions' package and require it. This is typically used during development to link to a local copy of the package before publishing it.","codeLanguage":"json","codeTokens":124,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_0","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"json","code":"{\n \"repositories\": [\n {\n \"type\": \"path\",\n \"url\": \"./packages/saeedvir/laravel-permissions\"\n }\n ],\n \"require\": {\n \"saeedvir/laravel-permissions\": \"*\"\n }\n}"}],"relevance":0.023839932,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Run Laravel permissions installation commands","codeDescription":"Essential terminal commands for package installation. Updates Composer dependencies, publishes configuration files, and runs database migrations. Must be executed after adding package to composer.json.","codeLanguage":"bash","codeTokens":60,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/PACKAGE-SUMMARY.md#_snippet_4","pageTitle":"Unknown","codeList":[{"language":"bash","code":"composer update\nphp artisan vendor:publish --tag=permissions-config\nphp artisan migrate"}],"relevance":0.023513328,"generationDate":"2025-11-11T01:38:52.557Z","model":"Unknown"},{"codeTitle":"Clear View Cache (Bash)","codeDescription":"Command to clear the Laravel view cache. Useful for troubleshooting issues where changes to Blade templates are not reflected. This is often necessary when directives are not working as expected.","codeLanguage":"bash","codeTokens":51,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_15","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"bash","code":"php artisan view:clear"}],"relevance":0.02314815,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Additional Environment Variables for Separate Permissions Database","codeDescription":"These additional .env variables configure a separate database connection for permissions. Dependencies include Laravel's env handling. Inputs are the .env file, outputs are connection parameters. Limitations: Requires the config/database.php update and valid host/port details.","codeLanguage":"env","codeTokens":109,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_3","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"env","code":"PERMISSION_DB_CONNECTION=permission_mysql\nPERMISSION_DB_HOST=127.0.0.1\nPERMISSION_DB_PORT=3306\nPERMISSION_DB_NAME=laravel_permission\nPERMISSION_DB_USERNAME=root\nPERMISSION_DB_PASSWORD="}],"relevance":0.023140717,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Update Composer Dependencies (Bash)","codeDescription":"Command to update Composer dependencies. This is typically run after modifying the composer.json file during uninstallation or after any package updates to synchronize the project's dependencies.","codeLanguage":"bash","codeTokens":46,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_18","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"bash","code":"composer update"}],"relevance":0.023039762,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Run package tests for Laravel permissions","codeDescription":"Command to execute the package's test suite. Verifies proper installation and functionality of all permission-related features. Should be run after installation and major updates to ensure system integrity.","codeLanguage":"bash","codeTokens":49,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/README.md#_snippet_21","pageTitle":"Laravel Permissions Package Documentation","codeList":[{"language":"bash","code":"composer test"}],"relevance":0.022967506,"generationDate":"2025-11-11T01:39:45.088Z","model":"minimax/minimax-m2"},{"codeTitle":"Protect Routes with Role and Permission Middleware (PHP)","codeDescription":"This snippet shows how to protect your application's routes using the package's middleware. You can restrict access based on user roles (e.g., 'admin') or specific permissions (e.g., 'create-post').","codeLanguage":"php","codeTokens":110,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/QUICKSTART.md#_snippet_5","pageTitle":"Laravel Permissions Quick Start Guide","codeList":[{"language":"php","code":"// Check role\nRoute::get('/admin', fn() => 'Admin Area')\n ->middleware('role:admin');\n\n// Check permission\nRoute::post('/posts', [PostController::class, 'store'])\n ->middleware('permission:create-post');"}],"relevance":0.022266205,"generationDate":"2025-11-11T01:38:23.807Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Before Feature Usage Examples","codeDescription":"Illustrates basic permission checks and manual cache clearing operations that were common before the recent feature additions. This serves as a baseline for understanding the improvements made in the project.","codeLanguage":"PHP","codeTokens":65,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/COMPLETION-SUMMARY.md#_snippet_10","pageTitle":"laravel-permissions Project Overview","codeList":[{"language":"php","code":"// Basic permission check\n$user->hasPermission('create-post');\n\n// Manual cache clearing \nCache::flush();"}],"relevance":0.022254474,"generationDate":"2025-11-11T01:38:43.037Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Install Laravel permissions package with Composer","codeDescription":"Package installation configuration for Composer. Defines local repository path and package requirement. Requires subsequent artisan commands to publish config and run migrations.","codeLanguage":"json","codeTokens":89,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/PACKAGE-SUMMARY.md#_snippet_3","pageTitle":"Unknown","codeList":[{"language":"json","code":"{\n \"repositories\": [\n { \"type\": \"path\", \"url\": \"./packages/saeedvir/laravel-permissions\" }\n ],\n \"require\": {\n \"saeedvir/laravel-permissions\": \"*\"\n }\n}"}],"relevance":0.02213255,"generationDate":"2025-11-11T01:38:52.557Z","model":"Unknown"},{"codeTitle":"Efficient User Querying with Roles","codeDescription":"This PHP example shows a more efficient way to query users by role using scopes (`User::role('admin')->get()`) compared to manual `whereHas` clauses.","codeLanguage":"php","codeTokens":86,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/QUICK-REFERENCE.md#_snippet_19","pageTitle":"Laravel Permissions Package Improvements Reference","codeList":[{"language":"php","code":"// Good\nUser::role('admin')->get();\n\n// Not as good\nUser::whereHas('roles', fn($q) => $q->where('slug', 'admin'))->get();"}],"relevance":0.022086468,"generationDate":"2025-11-11T01:38:44.157Z","model":"x-ai/grok-4-fast"},{"codeTitle":"Composer and Artisan Commands for Troubleshooting","codeDescription":"A collection of common Bash commands used for troubleshooting issues related to autoloading, configuration, and caching in a Laravel project. These commands help resolve 'Class not found' errors and ensure configurations are up-to-date.","codeLanguage":"Bash","codeTokens":75,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_18","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"bash","code":"composer dump-autoload\nphp artisan config:clear\nphp artisan cache:clear"}],"relevance":0.022031963,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Artisan Commands for Migrations Troubleshooting in Bash","codeDescription":"Provides Bash commands to check migration statuses and run specific migration files, particularly useful when migrations are not running as expected. It helps in managing the database schema.","codeLanguage":"Bash","codeTokens":73,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_19","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"bash","code":"php artisan migrate:status\nphp artisan migrate --path=vendor/saeedvir/laravel-permissions/database/migrations"}],"relevance":0.022007452,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Test Role and Permission Assignment in Tinker","codeDescription":"This example shows how to use Laravel's Tinker tool to test role assignment and checking. It assigns the 'admin' role to a user and then verifies if the user actually has that role using the `hasRole` method.","codeLanguage":"bash","codeTokens":97,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_7","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"bash","code":"php artisan tinker"},{"language":"php","code":"$$user = User::find(1);\n$user->assignRole('admin');\n$user->hasRole('admin'); // Should return true"}],"relevance":0.022005772,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Artisan Commands for Middleware and Cache Troubleshooting in Bash","codeDescription":"Lists Bash commands to troubleshoot middleware and caching issues in Laravel. This includes checking route lists, caching configurations, and clearing caches to ensure proper application behavior.","codeLanguage":"Bash","codeTokens":93,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_20","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"bash","code":"php artisan route:list\nphp artisan config:cache\n\n# Check cache driver\nphp artisan tinker\n>>> config('cache.default')\n\n# Clear all caches\nphp artisan cache:clear\nphp artisan config:clear"}],"relevance":0.021916876,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Configure Separate Database Connection for Permissions in PHP","codeDescription":"This PHP configuration adds a separate MySQL connection for permissions in config/database.php. It requires Laravel and the .env variables. Inputs are database settings, outputs are updated config array. Limitations: Requires additional .env variables and assumes MySQL driver availability.","codeLanguage":"php","codeTokens":280,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_2","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"php","code":"'connections' => [\n 'mysql' => [\n 'driver' => 'mysql',\n 'host' => env('DB_HOST', '127.0.0.1'),\n 'port' => env('DB_PORT', '3306'),\n 'database' => env('DB_DATABASE', 'laravel'),\n 'username' => env('DB_USERNAME', 'root'),\n 'password' => env('DB_PASSWORD', ''),\n // ... other settings\n ],\n\n // Add this if you want a separate connection for permissions\n 'permission_mysql' => [\n 'driver' => 'mysql',\n 'host' => env('PERMISSION_DB_HOST', '127.0.0.1'),\n 'port' => env('PERMISSION_DB_PORT', '3306'),\n 'database' => env('PERMISSION_DB_NAME', 'laravel_permission'),\n 'username' => env('PERMISSION_DB_USERNAME', 'root'),\n 'password' => env('PERMISSION_DB_PASSWORD', ''),\n // ... other settings\n ],\n],"}],"relevance":0.021858577,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Drop Permission Tables (SQL)","codeDescription":"SQL statements to drop all tables associated with the laravel-permissions package. This is part of the uninstallation process. It ensures that all related database schema elements are removed.","codeLanguage":"sql","codeTokens":82,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_17","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"sql","code":"DROP TABLE IF EXISTS model_has_permissions;\nDROP TABLE IF EXISTS model_has_roles;\nDROP TABLE IF EXISTS role_has_permissions;\nDROP TABLE IF EXISTS permissions;\nDROP TABLE IF EXISTS roles;"}],"relevance":0.021638656,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Admin Setup Seeder in PHP","codeDescription":"A PHP seeder class to set up an 'admin' role with predefined permissions and assign it to an existing admin user. It uses `firstOrCreate` to avoid duplicating roles and permissions.","codeLanguage":"PHP","codeTokens":189,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_15","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"php","code":"public function run()\n{\n $admin = Role::firstOrCreate(['slug' => 'admin'], [\n 'name' => 'Administrator',\n ]);\n\n $permissions = ['create-post', 'edit-post', 'delete-post', 'manage-users'];\n\n foreach ($permissions as $slug) {\n $permission = Permission::firstOrCreate(['slug' => $slug], [\n 'name' => ucwords(str_replace('-', ' ', $slug)),\n ]);\n $admin->givePermissionTo($slug);\n }\n\n $user = User::where('email', 'admin@example.com')->first();\n if ($user) {\n $user->assignRole('admin');\n }\n}"}],"relevance":0.021405678,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Add HasRolesAndPermissions Trait to User Model in PHP","codeDescription":"This PHP code updates the User model to include roles and permissions trait. It requires the Laravel Permissions package. Input is the existing User.php, output is an enhanced model with trait. Limitations: Assumes standard Laravel User structure and trait availability.","codeLanguage":"php","codeTokens":129,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/INSTALLATION.md#_snippet_5","pageTitle":"Installation Guide for Laravel Permissions Package","codeList":[{"language":"php","code":" \\Saeedvir\\LaravelPermissions\\Middleware\\CheckRole::class,\n 'permission' => \\Saeedvir\\LaravelPermissions\\Middleware\\CheckPermission::class,\n 'check.auth' => \\Saeedvir\\LaravelPermissions\\Middleware\\CheckAuth::class,\n];"}],"relevance":0.02070943,"generationDate":"2025-11-11T01:38:42.370Z","model":"x-ai/grok-code-fast-1"},{"codeTitle":"Artisan Commands for View Cache Troubleshooting in Bash","codeDescription":"A simple Bash command to clear compiled view files. This is often necessary when changes to Blade templates are not reflected.","codeLanguage":"Bash","codeTokens":52,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_21","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"bash","code":"php artisan view:clear\nphp artisan config:clear"}],"relevance":0.019940477,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Cache Verification for Permission Checks in PHP","codeDescription":"Shows how to verify that permission checks are utilizing the cache. It includes a first call that should hit the database and a second call that should use the cache, followed by an assertion that the cached data exists.","codeLanguage":"PHP","codeTokens":141,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_14","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"php","code":"// First call - hits database\n$user->hasPermission('create-post');\n\n// Second call - should use cache\n$user->hasPermission('create-post');\n\n// Verify cache is working\n$cache = app(\"Saeedvir\\LaravelPermissions\\Services\\PermissionCache::class);\n$key = $cache->getUserPermissionsKey($user->id);\n$cached = $cache->get($key);\n$this->assertNotNull($cached);"}],"relevance":0.019931607,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Check Roles and Permissions in Code (PHP)","codeDescription":"This PHP snippet illustrates how to check if a user has a specific role or permission directly within your application's logic. This allows for granular control over user actions and access.","codeLanguage":"php","codeTokens":85,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/QUICKSTART.md#_snippet_7","pageTitle":"Laravel Permissions Quick Start Guide","codeList":[{"language":"php","code":"if ($user->hasRole('admin')) {\n // User is admin\n}\n\nif ($user->hasPermission('create-post')) {\n // User can create posts\n}"}],"relevance":0.019746378,"generationDate":"2025-11-11T01:38:23.807Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Laravel Permissions Usage Examples (PHP)","codeDescription":"Demonstrates various ways to use the laravel-permissions package for managing user roles and permissions. Includes super admin checks, wildcard permissions, expirable permissions, Laravel Gate integration, multi-guard support, query scopes, and automatic cache clearing.","codeLanguage":"php","codeTokens":277,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/COMPLETION-SUMMARY.md#_snippet_11","pageTitle":"laravel-permissions Project Overview","codeList":[{"language":"php","code":"// 1. Super Admin - Has ALL permissions\n$user->isSuperAdmin();\n\n// 2. Wildcard Permissions\n$user->givePermissionTo('posts.*'); // All post permissions\n\n// 3. Expirable Permissions\n$user->givePermissionToUntil('trial', now()->addDays(7));\n\n// 4. Laravel Gate Integration\n$user->can('create-post'); // Native Laravel!\n$this->authorize('edit-post');\n\n// 5. Multiple Guards\nRole::forGuard('api')->get();\nPermission::create(['slug' => 'admin', 'guard_name' => 'admin']);\n\n// 6. Query Scopes\nUser::role('admin')->get();\nUser::permission('create-post')->withoutRole('banned')->get();\n\n// 7. Automatic Cache Clearing\n$role->givePermissionTo('edit'); // All users auto-updated!\n\n// 8. Database Transactions\n// Everything atomic - no partial updates!\n\n// 9. Optimized Queries\nRole::findOrCreate('editor', 'Editor'); // Single query!"}],"relevance":0.019172113,"generationDate":"2025-11-11T01:38:43.037Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Combine multiple middlewares in Laravel routes","codeDescription":"Example of combining authentication, role, and permission middlewares for comprehensive access control. All specified middlewares must pass for access to be granted. Useful for protecting sensitive administrative operations.","codeLanguage":"php","codeTokens":83,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/README.md#_snippet_17","pageTitle":"Laravel Permissions Package Documentation","codeList":[{"language":"php","code":"Route::middleware(['check.auth', 'role:admin', 'permission:delete-post'])\n ->delete('/posts/{post}', [PostController::class, 'destroy']);"}],"relevance":0.019081209,"generationDate":"2025-11-11T01:39:45.088Z","model":"minimax/minimax-m2"},{"codeTitle":"Guard-Specific Role Creation Example","codeDescription":"Illustrates creating roles specific to different guards, 'api' and 'web'. This allows for separate permission management systems for different parts of an application.","codeLanguage":"php","codeTokens":92,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/CHANGES.md#_snippet_31","pageTitle":"CHANGELOG - Version 2.0.0","codeList":[{"language":"php","code":"$$apiRole = Role::create(['slug' => 'api-admin', 'guard_name' => 'api']);\n$webRole = Role::create(['slug' => 'admin', 'guard_name' => 'web']);\n// Separate permission systems"}],"relevance":0.018706294,"generationDate":"2025-11-11T01:38:39.421Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"User Model Setup with HasRolesAndPermissions Trait (PHP)","codeDescription":"Demonstrates how to set up the User model by using the HasRolesAndPermissions trait. This enables all permission-related methods on the User model, allowing direct assignment and checking of roles and permissions. Ensure the trait is imported correctly.","codeLanguage":"php","codeTokens":188,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/context7.md#_snippet_0","pageTitle":"Laravel Permissions Package Documentation","codeList":[{"language":"php","code":"assignRole('admin');\n$user->givePermissionTo('create-post');\n\nif ($user->hasRole('admin')) {\n echo \"User is an administrator\";\n}\n\nif ($user->hasPermission('create-post')) {\n echo \"User can create posts\";\n}"}],"relevance":0.018462826,"generationDate":"2025-11-11T01:44:04.687Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Laravel Permissions - Wildcard Permissions","codeDescription":"Demonstrates how to use wildcard permissions to grant access to multiple related actions. This requires enabling wildcard permissions in the .env file. The example shows creating a wildcard permission and assigning it to a role, then verifying access for a user assigned to that role.","codeLanguage":"php","codeTokens":373,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/context7.md#_snippet_10","pageTitle":"Laravel Permissions Package Documentation","codeList":[{"language":"php","code":"$55"}],"relevance":0.018271485,"generationDate":"2025-11-11T01:44:04.687Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Wildcard Permission Assignment Example","codeDescription":"Demonstrates assigning a wildcard permission 'admin.*' to a role. This implies the role has permissions like 'admin.users', 'admin.settings', and 'admin.anything'.","codeLanguage":"php","codeTokens":71,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/CHANGES.md#_snippet_29","pageTitle":"CHANGELOG - Version 2.0.0","codeList":[{"language":"php","code":"$$role->givePermissionTo('admin.*');\n// User has: admin.users, admin.settings, admin.anything"}],"relevance":0.01823109,"generationDate":"2025-11-11T01:38:39.421Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Publish Vendor Configuration","codeDescription":"This command publishes the package's configuration file to your Laravel application. It uses the `vendor:publish` Artisan command with the `permissions-config` tag to copy the `config/permissions.php` file into your application's config directory.","codeLanguage":"bash","codeTokens":68,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_1","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"bash","code":"php artisan vendor:publish --tag=permissions-config"}],"relevance":0.0181445,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Laravel Native Gate Integration (After v2.0)","codeDescription":"This example shows how the package integrates with Laravel's native `can` method, allowing you to check permissions using the framework's built-in authorization system.","codeLanguage":"php","codeTokens":58,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/CHANGES.md#_snippet_23","pageTitle":"CHANGELOG - Version 2.0.0","codeList":[{"language":"php","code":"$$user->can('create-post'); // Works with Gate!"}],"relevance":0.01752372,"generationDate":"2025-11-11T01:38:39.421Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Resource Controller Middleware Protection in PHP","codeDescription":"Applies middleware to a PostController to protect different actions based on required permissions. It uses the `middleware` method within the controller's constructor.","codeLanguage":"PHP","codeTokens":126,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_16","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"php","code":"class PostController extends Controller\n{\n public function __construct()\n {\n $this->middleware('permission:view-post')->only(['index', 'show']);\n $this->middleware('permission:create-post')->only(['create', 'store']);\n $this->middleware('permission:edit-post')->only(['edit', 'update']);\n $this->middleware('permission:delete-post')->only(['destroy']);\n }\n}"}],"relevance":0.017507646,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Create Role and Assign Permission in Laravel","codeDescription":"This PHP code demonstrates how to create new roles and permissions using the package's Eloquent models and assign a permission to a role. It shows the creation of a 'Create Post' permission and an 'Administrator' role, then assigns the permission to the role.","codeLanguage":"php","codeTokens":186,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_5","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"php","code":"use Saeedvir\\LaravelPermissions\\Models\\Role;\nuse Saeedvir\\LaravelPermissions\\Models\\Permission;\n\n// Create a permission\n$permission = Permission::create([\n 'name' => 'Create Post',\n 'slug' => 'create-post',\n 'description' => 'Can create blog posts'\n]);\n\n// Create a role\n$admin = Role::create([\n 'name' => 'Administrator',\n 'slug' => 'admin',\n 'description' => 'Full system access'\n]);\n\n// Assign permission to role\n$admin->givePermissionTo('create-post');"}],"relevance":0.017476749,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Unit Test for Permission Assignment","codeDescription":"This PHP code is a unit test designed to confirm that permissions can be correctly assigned to a user and that the `hasPermission` method accurately reflects these assignments. It creates a user, grants the 'create-post' permission, and asserts the permission's existence.","codeLanguage":"php","codeTokens":92,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_12","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"php","code":"$$user = User::factory()->create();\n$user->givePermissionTo('create-post');\n$this->assertTrue($user->hasPermission('create-post'));"}],"relevance":0.016986812,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Laravel Permissions - Query Scopes for Filtering Users","codeDescription":"Shows how to use query scopes to filter users based on assigned roles and permissions. The example demonstrates retrieving users with specific roles, permissions, or excluding them.","codeLanguage":"php","codeTokens":337,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/context7.md#_snippet_12","pageTitle":"Laravel Permissions Package Documentation","codeList":[{"language":"php","code":"$56"}],"relevance":0.016964924,"generationDate":"2025-11-11T01:44:04.687Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Laravel Permissions - Super Admin Role","codeDescription":"Illustrates how to configure and utilize the super admin role. This requires enabling super admin in the .env file. The example shows creating a super admin role, assigning it to a user, and verifying that the user has access to all permissions.","codeLanguage":"php","codeTokens":326,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/context7.md#_snippet_11","pageTitle":"Laravel Permissions Package Documentation","codeList":[{"language":"php","code":"$57"}],"relevance":0.016372629,"generationDate":"2025-11-11T01:44:04.687Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Test User Permissions (Tinker)","codeDescription":"This example demonstrates how to test user permissions using the `php artisan tinker` command. It fetches the first user and checks if they have a specific permission, 'test'.","codeLanguage":"php","codeTokens":61,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/CHANGES.md#_snippet_11","pageTitle":"CHANGELOG - Version 2.0.0","codeList":[{"language":"php","code":"$$user = User::first()\n$user->hasPermission('test')"}],"relevance":0.016338801,"generationDate":"2025-11-11T01:38:39.421Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Assign roles and permissions to users in Laravel","codeDescription":"Code examples for assigning roles and permissions to user instances. Core functionality for user access management. Requires the HasRolesAndPermissions trait to be implemented on the User model.","codeLanguage":"php","codeTokens":63,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/PACKAGE-SUMMARY.md#_snippet_6","pageTitle":"Unknown","codeList":[{"language":"php","code":"$$user->assignRole('admin');\n$user->givePermissionTo('create-post');"}],"relevance":0.016244685,"generationDate":"2025-11-11T01:38:52.557Z","model":"Unknown"},{"codeTitle":"Controller Logic for Role and Permission Verification","codeDescription":"This PHP code demonstrates how to perform role and permission checks within a Laravel controller. It uses `auth()->user()->hasPermission()` and `auth()->user()->hasRole()` methods to authorize actions, providing granular control over user access to specific functionalities.","codeLanguage":"php","codeTokens":208,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_10","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"php","code":"class PostController extends Controller\n{\n public function store(Request $request)\n {\n // Check permission in controller\n if (!auth()->user()->hasPermission('create-post')) {\n abort(403, 'Unauthorized');\n }\n\n // Create post logic...\n return response()->json(['message' => 'Post created']);\n }\n\n public function destroy($id)\n {\n $user = auth()->user();\n\n // Multiple checks\n if (!$user->hasRole('admin') && !$user->hasPermission('delete-post')) {\n abort(403, 'Unauthorized');\n }\n\n // Delete post logic...\n return response()->json(['message' => 'Post deleted']);\n }\n}"}],"relevance":0.016148828,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Environment Variable Configuration for Permissions","codeDescription":"These environment variables are added to your `.env` file to configure the database connection, database name, and cache settings for the Laravel Permissions package. This allows you to customize how the package interacts with your database and caching system.","codeLanguage":"env","codeTokens":86,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_2","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"env","code":"PERMISSION_DB_CONNECTION=mysql\nPERMISSION_DB_NAME=laravel_permission\nPERMISSION_CACHE_ENABLED=true\nPERMISSION_CACHE_EXPIRATION=3600"}],"relevance":0.016066588,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"SQL Statement for Database Creation","codeDescription":"This SQL statement creates a new database named 'laravel_permission' with UTF8MB4 character set and utf8mb4_unicode_ci collation. This is recommended for proper handling of various characters and is often used in conjunction with the Laravel Permissions package.","codeLanguage":"sql","codeTokens":82,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_3","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"sql","code":"CREATE DATABASE laravel_permission CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"}],"relevance":0.015686516,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Use permissions in Laravel Blade templates","codeDescription":"Blade directive examples for conditional rendering based on user roles and permissions. Provides clean syntax for showing/hiding UI elements based on access rights. Requires package middleware to be properly configured.","codeLanguage":"blade","codeTokens":85,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/PACKAGE-SUMMARY.md#_snippet_9","pageTitle":"Unknown","codeList":[{"language":"blade","code":"@role('admin')\n Admin Panel\n@endrole\n\n@permission('create-post')\n \n@endpermission"}],"relevance":0.015675675,"generationDate":"2025-11-11T01:38:52.557Z","model":"Unknown"},{"codeTitle":"Query Scopes for Roles and Permissions (After v2.0)","codeDescription":"Demonstrates using the package's query scopes to filter users by role or permission. Examples include finding users with a specific role, users without a role, and users with a specific permission.","codeLanguage":"php","codeTokens":70,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/CHANGES.md#_snippet_24","pageTitle":"CHANGELOG - Version 2.0.0","codeList":[{"language":"php","code":"User::role('admin')->permission('create-post')->get();"}],"relevance":0.015491454,"generationDate":"2025-11-11T01:38:39.421Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Configure multiple authentication guards in Laravel Permissions","codeDescription":"This PHP code illustrates how to configure and use multiple authentication guards in the Laravel Permissions package. It demonstrates creating roles and permissions scoped to different guards (web, api, backoffice) and shows methods for querying and retrieving guard-specific data. The examples also reference the PERMISSION_GUARDS_ENABLED environment variable required to activate this feature.","codeLanguage":"php","codeTokens":412,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/context7.md#_snippet_18","pageTitle":"Laravel Permissions Package Documentation","codeList":[{"language":"php","code":"$58"}],"relevance":0.015445615,"generationDate":"2025-11-11T01:44:04.687Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Unit Test for Role Assignment","codeDescription":"This PHP code snippet is a unit test that verifies the functionality of assigning a role to a user and checking if the assignment was successful. It uses Laravel's factory to create a user, assigns the 'admin' role, and asserts that `hasRole('admin')` returns true.","codeLanguage":"php","codeTokens":94,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_11","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"php","code":"$$user = User::factory()->create();\n$user->assignRole('admin');\n$this->assertTrue($user->hasRole('admin'));"}],"relevance":0.015096274,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Creating Roles with Role::create() and Role::findOrCreate() (PHP)","codeDescription":"Shows how to create new roles in the database using the Role::create() method, specifying name, slug, description, and guard name. It also demonstrates the findOrCreate method to get an existing role or create a new one if it doesn't exist. Roles can be identified by their slug and guard name.","codeLanguage":"php","codeTokens":291,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/context7.md#_snippet_1","pageTitle":"Laravel Permissions Package Documentation","codeList":[{"language":"php","code":" 'Administrator',\n 'slug' => 'admin',\n 'description' => 'Administrator role with full access',\n 'guard_name' => 'web' // Optional, defaults to 'web'\n]);\n\n// Create multiple roles\n$editor = Role::create([\n 'name' => 'Editor',\n 'slug' => 'editor',\n 'description' => 'Content editor role'\n]);\n\n$moderator = Role::create([\n 'name' => 'Moderator',\n 'slug' => 'moderator',\n 'description' => 'Community moderator'\n]);\n\n// Find or create a role\n$manager = Role::findOrCreate('manager', 'Manager', 'web');\n\n// Find role by slug and guard\n$webAdmin = Role::findBySlug('admin', 'web');\n$apiAdmin = Role::findBySlug('admin', 'api');"}],"relevance":0.015092199,"generationDate":"2025-11-11T01:44:04.687Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Query Permissions Model in PHP","codeDescription":"Methods to find or create permissions by slug and guard, or query by guard. Integrates with role assignments. Inputs are slug, name, guard; outputs Permission models or collections. Limitation: Similar to roles, guard-specific queries require proper guard setup.","codeLanguage":"php","codeTokens":97,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/QUICK-REFERENCE.md#_snippet_7","pageTitle":"Laravel Permissions Package Improvements Reference","codeList":[{"language":"php","code":"Permission::findBySlug('create-post', 'web');\nPermission::findOrCreate('edit-post', 'Edit Post', 'api');\nPermission::forGuard('api')->get();"}],"relevance":0.014928699,"generationDate":"2025-11-11T01:38:44.157Z","model":"x-ai/grok-4-fast"},{"codeTitle":"Checking User Roles with HasRole Methods (PHP)","codeDescription":"Provides examples of how to check a user's roles. This includes checking for a specific role, any of multiple roles, or all of a set of roles. It also shows how to check if a user is a super admin and how to retrieve all roles assigned to a user.","codeLanguage":"php","codeTokens":249,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/context7.md#_snippet_4","pageTitle":"Laravel Permissions Package Documentation","codeList":[{"language":"php","code":"hasRole('admin')) {\n echo \"User is an administrator\";\n}\n\n// Check if user has any of multiple roles\nif ($user->hasAnyRole(['admin', 'editor', 'moderator'])) {\n echo \"User is a staff member\";\n}\n\n// Check if user has all specified roles\nif ($user->hasAllRoles(['admin', 'verified'])) {\n echo \"User is a verified administrator\";\n}\n\n// Check if user is super admin (has all permissions)\nif ($user->isSuperAdmin()) {\n echo \"User has unlimited access\";\n}\n\n// Get all user roles\n$roles = $user->roles;\nforeach ($roles as $role) {\n echo $role->name . \": \" . $role->description;\n}"}],"relevance":0.014784506,"generationDate":"2025-11-11T01:44:04.687Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Assign Role to User in Laravel","codeDescription":"This PHP code snippet illustrates how to assign a previously created role (e.g., 'admin') to a specific user instance in Laravel. It fetches a user by their ID and then uses the `assignRole` method provided by the package.","codeLanguage":"php","codeTokens":76,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_6","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"php","code":"$$user = User::find(1);\n$user->assignRole('admin');"}],"relevance":0.014674719,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Assign super admin role in Laravel","codeDescription":"Demonstrates how to assign the super admin role to a user, which grants all permissions automatically. The super admin has unlimited access to all system resources. Dependencies include the Laravel Permissions package with proper setup.","codeLanguage":"php","codeTokens":112,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/README.md#_snippet_12","pageTitle":"Laravel Permissions Package Documentation","codeList":[{"language":"php","code":"// Assign super admin role\n$user->assignRole('super-admin');\n\n// User now has ALL permissions\n$user->hasPermission('any-permission'); // Always true\n\n// Check if user is super admin\nif ($user->isSuperAdmin()) {\n // User has unlimited access\n}"}],"relevance":0.014498672,"generationDate":"2025-11-11T01:39:45.088Z","model":"minimax/minimax-m2"},{"codeTitle":"Protect Routes with Role and Permission Middleware","codeDescription":"This code configures routes in `routes/web.php` to be protected by middleware. The first route requires the 'admin' role, while the second requires the 'create-post' permission. Access to these routes will be controlled based on the logged-in user's assigned roles and permissions.","codeLanguage":"php","codeTokens":116,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_8","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"php","code":"Route::get('/admin', function () {\n return 'Welcome Admin!';\n})->middleware('role:admin');\n\nRoute::post('/posts', function () {\n return 'Post created!';\n})->middleware('permission:create-post');"}],"relevance":0.014085201,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Blade Directives for Role and Permission Checks","codeDescription":"This Blade template code utilizes package-specific directives like `@role`, `@permission`, and `@hasanypermission` to conditionally display content. This allows for dynamic rendering of UI elements based on the user's roles and permissions, enhancing security and user experience.","codeLanguage":"blade","codeTokens":200,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/GETTING-STARTED.md#_snippet_9","pageTitle":"Laravel Permissions Package Setup and Usage","codeList":[{"language":"blade","code":"@extends('layouts.app')\n\n@section('content')\n

Dashboard

\n\n @role('admin')\n \n Manage Users (Admin Only)\n \n @endrole\n\n @permission('create-post')\n \n Create New Post\n \n @endpermission\n\n @hasanypermission(['edit-post', 'delete-post'])\n \n Manage Posts\n \n @endhasanypermission\n@endsection"}],"relevance":0.013739884,"generationDate":"2025-11-11T01:38:29.590Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Add HasRolesAndPermissions Trait to User Model (PHP)","codeDescription":"Integrate the `HasRolesAndPermissions` trait into your `User` model to enable role and permission management capabilities. This requires importing the trait and using it within the model class.","codeLanguage":"php","codeTokens":83,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/QUICKSTART.md#_snippet_3","pageTitle":"Laravel Permissions Quick Start Guide","codeList":[{"language":"php","code":"use Saeedvir\\LaravelPermissions\\Traits\\HasRolesAndPermissions;\n\nclass User extends Authenticatable\n{\n use HasRolesAndPermissions;\n}"}],"relevance":0.012820513,"generationDate":"2025-11-11T01:38:23.807Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Create Permissions with Saeedvir Laravel Permissions (PHP)","codeDescription":"Demonstrates how to create individual permissions and guard‑specific permissions using the Permission model. Requires the Saeedvir\\LaravelPermissions\\Models\\Permission class. Returns Permission instances that can be used throughout the application. Ensure the appropriate guard configuration is set for each permission.","codeLanguage":"php","codeTokens":284,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/context7.md#_snippet_5","pageTitle":"Laravel Permissions Package Documentation","codeList":[{"language":"php","code":" 'Create Post',\n 'slug' => 'create-post',\n 'description' => 'Can create new blog posts',\n 'guard_name' => 'web'\n]);\n\n$editPost = Permission::create([\n 'name' => 'Edit Post',\n 'slug' => 'edit-post',\n 'description' => 'Can edit existing posts'\n]);\n\n$deletePost = Permission::create([\n 'name' => 'Delete Post',\n 'slug' => 'delete-post',\n 'description' => 'Can delete posts'\n]);\n\n// Create permissions for different guards\n$apiCreateUser = Permission::create([\n 'name' => 'API Create User',\n 'slug' => 'create-user',\n 'guard_name' => 'api'\n]);\n\n// Find or create permission\n$publishPost = Permission::findOrCreate('publish-post', 'Publish Post', 'web');"}],"relevance":0.011627907,"generationDate":"2025-11-11T01:44:04.687Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Expirable Permission Assignment Example","codeDescription":"Shows how to grant a 'premium' permission to a user that will automatically expire after one month.","codeLanguage":"php","codeTokens":55,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/CHANGES.md#_snippet_30","pageTitle":"CHANGELOG - Version 2.0.0","codeList":[{"language":"php","code":"$$user->givePermissionToUntil('premium', now()->addMonth());\n// Auto-expires in 30 days"}],"relevance":0.010204081,"generationDate":"2025-11-11T01:38:39.421Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Environment Variables for Laravel Permissions Configuration","codeDescription":"Configuration settings for the 'laravel-permissions' package, specified in environment variables. This includes database connection details and various cache-related options such as enabling caching, specifying cache store (e.g., redis), expiration times, and whether to use tags. Proper configuration is essential for optimal performance and functionality.","codeLanguage":"bash","codeTokens":143,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/context7.md#_snippet_20","pageTitle":"Laravel Permissions Package Documentation","codeList":[{"language":"bash","code":"# Database Configuration\nPERMISSION_DB_CONNECTION=mysql\nPERMISSION_DB_NAME=laravel_permission\n\n# Cache Settings (Recommended: all enabled)\nPERMISSION_CACHE_ENABLED=true\nPERMISSION_CACHE_ROLES=true\nPERMISSION_CACHE_PERMISSIONS=true\nPERMISSION_CACHE_EXPIRATION=3600\nPERMISSION_CACHE_STORE=redis\nPERMISSION_CACHE_USE_TAGS=true\n"}],"relevance":0.01,"generationDate":"2025-11-11T01:44:04.687Z","model":"gemini-2.5-flash-lite"},{"codeTitle":"Check user permissions in Laravel","codeDescription":"Methods for checking user roles and permissions. Conditional logic examples for access control in application code. Returns boolean values for authorization decisions.","codeLanguage":"php","codeTokens":59,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/PACKAGE-SUMMARY.md#_snippet_7","pageTitle":"Unknown","codeList":[{"language":"php","code":"if ($user->hasRole('admin')) { }\nif ($user->hasPermission('create-post')) { }"}],"relevance":0.01,"generationDate":"2025-11-11T01:38:52.557Z","model":"Unknown"},{"codeTitle":"Super Admin Role Assignment and Check","codeDescription":"Example of assigning the 'super-admin' role to a user and then checking if they have permission to 'do-anything', which should return true due to super admin privileges.","codeLanguage":"php","codeTokens":66,"codeId":"https://github.com/saeedvir/laravel-permissions/blob/main/CHANGES.md#_snippet_28","pageTitle":"CHANGELOG - Version 2.0.0","codeList":[{"language":"php","code":"$$user->assignRole('super-admin');\n$user->can('do-anything'); // true"}],"relevance":0.00990099,"generationDate":"2025-11-11T01:38:39.421Z","model":"gemini-2.5-flash-lite"}]}