التعددية المستأجرة في Laravel

// Migration: إضافة tenant_id إلى الجداول Schema::create('posts', function (Blueprint $table) { $table->id(); $table->foreignId('tenant_id')->constrained()->onDelete('cascade'); $table->string('title'); $table->text('content'); $table->timestamps(); }); // Model مع نطاق المستأجر class Post extends Model { protected static function booted() { static::addGlobalScope('tenant', function (Builder $query) { if (auth()->check() && auth()->user()->tenant_id) { $query->where('tenant_id', auth()->user()->tenant_id); } }); static::creating(function ($model) { if (auth()->check() && auth()->user()->tenant_id) { $model->tenant_id = auth()->user()->tenant_id; } }); } }

// app/Models/Tenant.php class Tenant extends Model { protected $fillable = ['name', 'domain', 'database', 'is_active']; public function users() { return $this->hasMany(User::class); } } // Middleware تحديد المستأجر // app/Http/Middleware/IdentifyTenant.php class IdentifyTenant { public function handle(Request $request, Closure $next) { // الطريقة 1: بناءً على النطاق الفرعي $host = $request->getHost(); $subdomain = explode('.', $host)[0]; if ($subdomain !== 'www' && $subdomain !== config('app.domain')) { $tenant = Tenant::where('domain', $subdomain)->firstOrFail(); app()->instance('tenant', $tenant); } // الطريقة 2: بناءً على المسار if ($request->segment(1)) { $tenant = Tenant::where('slug', $request->segment(1))->first(); if ($tenant) { app()->instance('tenant', $tenant); } } // الطريقة 3: بناءً على الرأس (للـ APIs) if ($request->header('X-Tenant-ID')) { $tenant = Tenant::find($request->header('X-Tenant-ID')); if ($tenant) { app()->instance('tenant', $tenant); } } return $next($request); } }

// config/database.php - إضافة اتصال المستأجر 'tenant' => [ 'driver' => 'mysql', 'host' => env('DB_HOST', '127.0.0.1'), 'port' => env('DB_PORT', '3306'), 'database' => null, // سيتم تعيينه ديناميكياً 'username' => env('DB_USERNAME', 'forge'), 'password' => env('DB_PASSWORD', ''), ], // Middleware للتبديل بين قواعد البيانات class SwitchTenantDatabase { public function handle(Request $request, Closure $next) { $tenant = app('tenant'); if ($tenant) { // تكوين اتصال قاعدة بيانات المستأجر Config::set('database.connections.tenant.database', $tenant->database); // مسح وإعادة الاتصال DB::purge('tenant'); DB::reconnect('tenant'); // تعيين كاتصال افتراضي DB::setDefaultConnection('tenant'); } return $next($request); } } // الاستخدام في النماذج class TenantPost extends Model { protected $connection = 'tenant'; protected $table = 'posts'; }

// app/Models/Scopes/TenantScope.php namespace App\Models\Scopes; use Illuminate\Database\Eloquent\Builder; use Illuminate\Database\Eloquent\Model; use Illuminate\Database\Eloquent\Scope; class TenantScope implements Scope { public function apply(Builder $builder, Model $model) { if ($tenantId = $this->getTenantId()) { $builder->where($model->getTable() . '.tenant_id', $tenantId); } } protected function getTenantId() { if (app()->has('tenant')) { return app('tenant')->id; } if (auth()->check()) { return auth()->user()->tenant_id; } return null; } public function extend(Builder $builder) { $builder->macro('withoutTenant', function (Builder $builder) { return $builder->withoutGlobalScope($this); }); } } // Trait للاستخدام السهل trait BelongsToTenant { protected static function bootBelongsToTenant() { static::addGlobalScope(new TenantScope); static::creating(function ($model) { if (app()->has('tenant')) { $model->tenant_id = app('tenant')->id; } }); } } // الاستخدام في النماذج class Product extends Model { use BelongsToTenant; }

// نموذج أساسي مع علاقات المستأجر class TenantModel extends Model { use BelongsToTenant; // تجاوز hasMany لإضافة نطاق المستأجر public function hasMany($related, $foreignKey = null, $localKey = null) { $instance = $this->newRelatedInstance($related); $foreignKey = $foreignKey ?: $this->getForeignKey(); $localKey = $localKey ?: $this->getKeyName(); return $this->newHasMany( $instance->newQuery()->where('tenant_id', $this->tenant_id), $this, $instance->getTable() . '.' . $foreignKey, $localKey ); } // تجاوز belongsToMany لجداول الربط public function belongsToMany($related, $table = null, $foreignPivotKey = null, $relatedPivotKey = null, $parentKey = null, $relatedKey = null, $relation = null) { $instance = $this->newRelatedInstance($related); return parent::belongsToMany( $related, $table, $foreignPivotKey, $relatedPivotKey, $parentKey, $relatedKey, $relation )->wherePivot('tenant_id', $this->tenant_id); } } // مثال على الاستخدام class User extends TenantModel { public function posts() { return $this->hasMany(Post::class); } public function roles() { return $this->belongsToMany(Role::class) ->withPivot('tenant_id'); } }

// تثبيت الحزمة composer require spatie/laravel-multitenancy // نشر الإعدادات php artisan vendor:publish --provider="Spatie\Multitenancy\MultitenancyServiceProvider" // تكوين نموذج المستأجر // config/multitenancy.php return [ 'tenant_model' => App\Models\Tenant::class, 'tenant_finder' => Spatie\Multitenancy\TenantFinder\DomainTenantFinder::class, 'switch_tenant_tasks' => [ Spatie\Multitenancy\Tasks\SwitchTenantDatabase::class, // Spatie\Multitenancy\Tasks\SwitchRouteCacheTask::class, // Spatie\Multitenancy\Tasks\SwitchConfigTask::class, ], 'queues_are_tenant_aware_by_default' => true, ]; // تنفيذ نموذج المستأجر use Spatie\Multitenancy\Models\Tenant as SpatieTenant; class Tenant extends SpatieTenant { public function makeCurrent(): static { // منطق مخصص قبل التبديل return parent::makeCurrent(); } public function forget(): static { // منطق تنظيف مخصص return parent::forget(); } } // الاستخدام في وحدات التحكم class DashboardController extends Controller { public function index() { // المستأجر الحالي متاح تلقائياً $tenant = Tenancy::getTenant(); // أو تحقق مما إذا كنا في سياق المستأجر if (Tenancy::checkCurrent()) { // منطق خاص بالمستأجر } return view('dashboard', [ 'tenant' => $tenant, 'stats' => $this->getTenantStats(), ]); } }