Вже доступно! Дослідження Telegram за 2025 — головні інсайти року 
| AmirHossein |
Відкрити в Telegram
635
Підписники
-324 години
-87 днів
-230 день
Архів дописів
🔴 سیستم جدیدی که در آپدیت های آینده به LaraGram اضافه میشه، سیستمی برای مدیریت خطا ها در استفاده از متد های Telegram هست.
◀️ 3 متد اضافه میشه که روی تمامی API Method های Teelgram به صورت Chain اجرا میشه.
◀️ متد اول tries هست که تعداد تلاش ها برای اجرای یک متد رو مشخص میکنه، به عنون مثال اگر هر 5 بار اجرای متد شکست خورد، متد دوم یعنی catch اجرا میشه و کالبک خودش رو که همراه با خطا هست اجرا میکه.
◀️ متد catch نیز درصورت برخورد با خطا میتونه چندین بار تلاش برای اجرا کالبک خودش بکنه، و درصورتی که تلاش های catch هم با شکست مواجه شد، متد سوم یعنی finally، کالبک خودش رو اجرا میکنه.
🔴 این 3 متد برای مدیریت خطا های سمت API بسیار مفید هستن.
⭐️ اگر مایل بودید با دادن استار به ریپوزیوری ها از پروژه ها حمایت کنید.
📱 LaraGram
📱 Laraquest
📱 Core
✅ @AmirhDeveloper
✅ @LaraXGram
.
فصل پنج - Migrations and Database
بخش اول - تعریف و اجرای Migrationها
برای ساخت یک جدول ساده با استفاده از مایگریشن در لاراول، میتوانید مراحل زیر را انجام دهید:
ابتدا یک فایل مایگریشن جدید با دستور زیر ایجاد میکنیم:
php artisan make:migration create_posts_table --create=postsreturn new class extends Migration
{
public function up()
{
Schema::create('posts', function (Blueprint $table) {
$table->id();
$table->string('title');
$table->text('content')->nullable();
$table->timestamps();
});
}
public function down()
{
Schema::dropIfExists('posts');
}
}php artisan migrateSchema::create('posts', function (Blueprint $table) {
//
});if (Schema::hasTable('posts')) {
//
}if (Schema::hasColumn('posts', 'title')) {
//
}if (Schema::hasIndex('posts', 'posts_title_index')) {
//
}Schema::connection('sqlite')->create('products', function (Blueprint $table) {
//
});Schema::rename('old_posts', 'new_posts');Schema::drop('posts');Schema::enableForeignKeyConstraints();Schema::withoutForeignKeyConstraints(function () {
Schema::dropIfExists('posts');
});فصل پنج - Migrations and Database
بخش اول - تعریف و اجرای Migrationها
در لاراول، Migrations یک سیستم برای مدیریت و ایجاد تغییرات در ساختار پایگاه داده است. این سیستم به توسعهدهندگان امکان میدهد تا جدولها، ستونها و روابط پایگاه داده را با استفاده از کد PHP تعریف، تغییر و مدیریت کنند. با استفاده از مایگریشن ها، تغییرات در پایگاه داده در کنار کد پروژه نگهداری میشود و میتوان آن را بهراحتی در محیطهای مختلف بهروزرسانی کرد.
اهداف و مزایای استفاده از مایگریشنها
1- مایگریشن ها به شما این امکان را میدهند که تغییرات پایگاه داده را با تغییرات کد هماهنگ کنید.
2- بهراحتی میتوانید تغییرات اعمال شده را به نسخه قبلی برگردانید.
3- وقتی توسعهدهندگان مختلف روی یک پروژه کار میکنند، میتوانند تغییرات پایگاه داده را بهصورت کنترلشده و منظم در بین خودشان به اشتراک بگذارند.
4- بهجای ویرایش دستی پایگاه داده، میتوانید از دستورات ساده برای افزودن یا تغییر جداول استفاده کنید.
ایجاد و اجرای مایگریشن
برای ایجاد مایگریشن جدید، میتوانید از دستور Artisan زیر استفاده کنید:
php artisan make:migration create_users_table --create=usersreturn new class extends Migration
{
public function up(): void
{
Schema::create('flights', function (Blueprint $table) {
$table->id();
$table->string('name');
$table->string('airline');
$table->timestamps();
});
}
public function down(): void
{
Schema::drop('flights');
}
};php artisan migratephp artisan migrate:rollbackphp artisan migrate:resetphp artisan make:migration add_phone_to_users_table --table=usersفصل 4 اینجا به پایان رسید.
این فصل طولانی ترین فصل بود، و سایر فصل ها سریع تر پیش میرن.
اگر چیزی در رابطه با الوکوئنت و مدل ها جا مونده بگید توضیح بدیم و فصل 5 رو شروع کنیم.
فصل چهار - مدلها و Eloquent ORM
بخش دهم - Route Model Binding
Route Model Binding به ما اجازه میدهد تا به صورت مستقیم و خودکار مدلهای لاراول را از URL به دست آوریم و در کنترلر استفاده کنیم. به عنوان مثال، اگر یک Post داریم و بخواهیم یک پست خاص را با استفاده از شناسه (ID) در URL بازیابی کنیم، معمولاً بدون استفاده از این ویژگی کدی شبیه به زیر مینویسیم:
Route::get('/posts/{id}', function($id) {
$post = Post::findOrFail($id);
return view('posts.show', compact('post'));
});Route::get('/posts/{post}', function(Post $post) {
return view('posts.show', compact('post'));
});Route::get('/posts/{post:slug}', function(Post $post) {
return view('posts.show', compact('post'));
});class Post extends Model
{
public function getRouteKeyName()
{
return 'slug';
}
}فصل چهار - مدلها و Eloquent ORM
بخش نهم - Transactions
تراکنشها یا Transactionها برای انجام چندین عملیات پایگاه داده به صورت یکجا استفاده میشوند. به عبارت دیگر، اگر همه عملیات موفق باشند، تغییرات به پایگاه داده اعمال میشود، اما اگر یکی از عملیاتها با خطا مواجه شود، تمامی تغییرات لغو میشوند (rollback).
این موضوع به ویژه برای اطمینان از یکپارچگی دادهها در سناریوهایی که شامل چندین عملیات هستند مفید است، مانند ثبت چند جدول همزمان، مدیریت تراکنشهای بانکی و غیره.
لاراول برای مدیریت تراکنشها متدهایی را فراهم میکند که در فساد DB قرار دارند.
متد ها عبارتند از:
1- متد beginTransaction برای شروع یک تراکنش.
2- متد commit برای تأیید و ثبت تراکنش.
3- متد rollBack برای لغو تغییرات در صورت بروز خطا.
4- متد afterCommit برای انجام عملیات پس از commit.
مثال:
try {
DB::beginTransaction();
DB::table('users')->insert([
'name' => 'John',
'email' => 'john@example.com',
'password' => bcrypt('1234')
]);
DB::table('profiles')->insert([
'user_id' => 1,
'bio' => 'Test Bio',
'age' => 25
]);
DB::commit();
} catch (\Exception $e) {
DB::rollBack();
echo "Error: " . $e->getMessage();
}DB::transaction(function () {
DB::table('users')->insert([
'name' => 'John',
'email' => 'john@example.com',
'password' => bcrypt('1234')
]);
DB::table('profiles')->insert([
'user_id' => 2,
'bio' => 'Test Bio',
'age' => 30
]);
})DB::transaction(function () {
//
}, 3)DB::afterCommit(function () {
echo "Success";
});فصل چهار - مدلها و Eloquent ORM
بخش هشتم - Observers
مشاهدهگرها یا Observer ها به عنوان کلاسهایی شناخته میشوند که برای نظارت بر رخدادهای مدلهای Eloquent طراحی شدهاند.
زمانی که میخواهید منطق خاصی را قبل یا بعد از رخ دادن یک عمل (مانند ایجاد، بهروزرسانی یا حذف یک رکورد) انجام دهید، میتوانید از Observerها استفاده کنید.
این امر منجر به جداسازی بهتر منطق بیزنسی از کنترلرها و مدلها و بهبود قابلیت نگهداری کد میشود.
لاراول اجازه میدهد تا به چندین رخداد پیشفرض مدل گوش دهید که با آنها در بخش قبل آشنا شدیم.
برای ایجاد یک Observer جدید میتوانید از دستور Artisan استفاده کنید:
php artisan make:observer UserObserver --model=User
class UserObserver
{
public function created(User $user)
{
Mail::to($user->email)->send(new \App\Mail\WelcomeMail($user));
}
}class AppServiceProvider extends ServiceProvider
{
public function boot()
{
User::observe(UserObserver::class);
}
}فصل چهار - مدلها و Eloquent ORM
بخش هفتم - Events
ایونت ها به شما اجازه میدهند تا قبل و بعد از رخ دادن عملیاتهای مختلفی روی مدلها (مانند ایجاد، بهروزرسانی، حذف و غیره) کدهای دلخواهی را اجرا کنید. این قابلیت به شما امکان میدهد تا فرآیندهایی مانند ثبت لاگها، ارسال اعلانها، اعتبارسنجیها و سایر عملیات وابسته به مدلها را بهصورت خودکار و در لحظه مدیریت کنید.
لاراول رویدادهای مختلفی را برای مدلها فراهم میکند که میتوانید آنها را در هر مرحله از چرخه حیات یک مدل استفاده کنید. این رویدادها به شما اجازه میدهند قبل یا بعد از عملیاتی مانند ایجاد، بهروزرسانی، حذف یا بازگردانی رکوردها، کدهای سفارشی خود را اجرا کنید.
لیست رویدادهای Eloquent
1- رویداد retrieved
بعد از اینکه یک مدل از دیتابیس بازیابی شد، اجرا میشود.
2- رویداد creating
قبل از ایجاد یک رکورد جدید در دیتابیس اجرا میشود.
3- رویداد created
بعد از ایجاد یک رکورد جدید اجرا میشود.
4- رویداد updating
قبل از بهروزرسانی یک رکورد اجرا میشود.
5- رویداد updated
بعد از بهروزرسانی یک رکورد اجرا میشود.
6- رویداد saving
قبل از ذخیرهشدن (چه ایجاد و چه بهروزرسانی) یک مدل اجرا میشود.
7- رویداد saved
بعد از ذخیرهشدن یک مدل اجرا میشود.
8- رویداد deleting
قبل از حذف یک رکورد اجرا میشود.
9- رویداد deleted
بعد از حذف یک رکورد اجرا میشود.
10- رویداد restoring
قبل از بازگردانی یک رکورد حذفشده اجرا میشود.
11- رویداد restored
بعد از بازگردانی یک رکورد حذفشده اجرا میشود.
12- رویداد trashed
بعد از soft delete شدن یک رکورد اجرا می شود.
13- رویداد forceDeleting
قبل از حذف کامل حتی با وجود soft delete اجرا می شود.
14- رویداد forceDeleted
بعد از حذف کامل حتی با وجود soft delete اجرا می شود.
15- رویداد replicating
قبل از replicate شدن یک رکورد اجرا می شود.
برای استفاده از رویدادها در Eloquent، شما میتوانید از متد boot() در مدل خود استفاده کنید و در آن رویدادهای دلخواه را تعریف کنید.
protected static function boot()
{
parent::boot();
static::creating(function ($user) {
Log::info('Creating new user: ' . $user->name);
});
static::created(function ($user) {
Log::info('New user Created: ' . $user->name);
});
}ساختار لاراول واقعا قشنگه
خیلی هم خوانا و ساده س
یه فیچر رو بسته به پیچیدگیش از چند دقیقه تا چند ساعت میشه بهش اضافه کرد
اونم با بهترین ترین ساختار
اگر حوصله کنم و دوره لاراول رو به فصل آخر برسونم درمورد کل ساختارش مفصل توضیح میدم
گزارشی از تغییرات پروژه و هدفم از توسعه LaraGram☕
سیستم کش تا حدودی به LaraGram اضافه شده.
در حال حاضر config ها و service provider ها و package ها کش میشن.
کش service provider های deferrable تا حدی وابسته به سیستم event هست که هنوز پیاده سازی نشده ولی فعلا کار میکنه بدون ایراد.
به زودی سیستم event و listener ها به container اضافه میشن و این مشکل هم کاملا برطرف میشه.
از طرفی console kernel و http kernel نیاز به بازنویسی کامل داره برای event ها.
اینها تنها بخشی از تغییرات مورد نیاز برای اضافه کردن یک سیستم کشینگ هست، تغییرات زیادی هم صورت گرفته مثلا service provider ها گسترده تر شدن، bootstrapper ها به application اضافه شدن.
وظیفه ساخت application از متد ساده __construct به سیستم application builder داده شده. ConfigRepository گسترده تر شده کنارش ProviderRepository اضافه شده، PackageManifest و AliasLoader و و و و ...
اینها همه بخش کوچکی از پیچیدگی های توسعه framework هستن.
یه نکته این وسط بگم که حواستون رو موقع commit و push کردن جمع کنید تا مثل من کد هارو push نکنید توی branch اشتباهی، الان حتی نمیتونم باگ فیکس بدم😒
وقتی توسعه LaraGram رو شروع کردم هدف خاصی پشتش نبود.
صرفا تازه با Laravel آشنا شده بودم و منم میخواستم یکی مثلشو بزنم.
شروع به ساخت ورژن 1 LaraGram کردم، تقریبا هر روز روش فعالیت داشتم و یک نسخه پایدار ازش رو توسعه دادم و موفق شدم اون رو توی صفحه نمونه های تلگرام هم منتشر کنم.
جلوتر که رفتم و فهمیدم حتی PHP هم بلد نیستم، از اونجا هدفم از توسعه LaraGram شد یادگیری.
90 درصد دانشی که الان از PHP، Laravel، Design patterns و... دارم رو با توسعه LaraGram بدست اوردم.
اگر بخوایم سطح علمی من رو از ابتدای شروع پروژه LaraGram نسبت به الان مقایسه کنیم میتونیم کد های ورژن 1 لاراگرام رو با ورژن 2 مقایسه کنیم.
ورژن 1، شاید اون اوایل برای خودم خفن بود ولی الان حتی نمیخوام نگاهش کنم☕
تمام LaraGram یک کپی از Laravel هست برای توسعه ربات، اما این کپی کردن که حتی 10 درصدش هم تا الان کپی نشده حدود 2 سال زمان برده.
من هیچی از PHP بلد نبودم ولی الان هسته فریم ورک بزرگی مثل لاراول رو حفظ هستم، به معنای واقعی حفظم. کافیه یک متد از اون وسطای vendor ببینم و بفهمم مال چیه و کجاس. همه ش رو مدیون توسعه LaraGram هستم.
حفظ بودن هسته Laravel شاید خودش ارزشی نداشته باشه ولی این حفظ بودن به معنی اینه که ده ها دیزاین پترن و شیوه های کد نویسی، سینتکس ها و ... رو یادگرفتم.
همیشه یادگیری با دیدن فیلم آموزشی و خوندن داکیومنت و کتاب نیست.
بخش بزرگی از یادگیری دست به کد شدنه، بدون ترس از دیدن کد های پیچیده شروع به خوندشون کردن.
اون اوایل هیچی از Laravel نمیفهمیدم، حتی برای پیدا کردن نقطه شروع Laravel چند روز داشتم فایل هاشو زیر و رو میکردم.
من کتابی از برنامه نویسی نخوندم، ویدئو هم در حد مقدماتی php و laravel دیدم که کلا 0.5 درصد چیزی که بلدم هم نیست، بقیه همش با توسعه پروژه مخصوصا LaraGram بوده.
یه بخشی هم از آموزش دادن بوده، بخشی از پست هایی که توی این کانال گزاشم رو خودم باهاش یاد گرفتم.
این به این معنی نیست کتاب نخونید و فیلم نبینید، هر کدوم سرجای خودشه.
تا زمانی که شروع به زدن پروژه نکنید، هر چند صد ساعت ویدئو دیدن و کتاب خوندن فایده ای نداره.
این تنها دلیل من از توسعه LaraGram هست😒
@AmirhDeveloper
.
بعد کلی وقت گفت و گو ها به LaraGram اضافه شدن!
🔴 با گفت و گو ها میتونید به سادگی یک گفت و گو بین کاربر و ربات ایجاد کنید.
⬇️ قابلیت ها:
◀️ ولیدیت کردن پاسخ هر سوال
◀️ نام گذاری برای هر سوال جهت پردازش راحت تر.
◀️ ارسال سوال به صورت media
◀️ ساخت گفت و گو با کیبورد
◀️ مشخص کردن کامند جهت skip سوال
◀️ مشخص کردن تعداد Attempt
◀️ مشخص کردن Timeout بدون پاسخ ماندن
◀️ مشحص کردن کامند لغو گفت و گو
◀️ مشخص کردن عملیات پس از گفت و گو
◀️ رویداد لغو گفت و گو
◀️ رویداد پایان گفت و گو
همه این قابلیت ها تنها با متد های پیش ساخته با یک خط کد.
میتونید گفت و گو هارو با یک کامند ایجاد کنید:
php laragram make:conversation GreetingConversation::start('Greeting');
بعد کلی وقت گفت و گو ها به LaraGram اضافه شدن!
🔴 با گفت و گو ها میتونید به سادگی یک گفت و گو بین کاربر و ربات ایجاد کنید.
⬇️ قابلیت ها:
◀️ ولیدیت کردن پاسخ هر سوال
◀️ نام گذاری برای هر سوال جهت پردازش راحت تر.
◀️ ارسال سوال به صورت media
◀️ ساخت گفت و گو با کیبورد
◀️ مشخص کردن کامند جهت skip سوال
◀️ مشخص کردن تعداد Attempt
◀️ مشخص کردن Timeout بدون پاسخ ماندن
◀️ مشحص کردن کامند لغو گفت و گو
◀️ مشخص کردن عملیات پس از گفت و گو
◀️ رویداد لغو گفت و گو
◀️ رویداد پایان گفت و گو
همه این قابلیت ها تنها با متد های پیش ساخته با یک خط کد.
میتونید گفت و گو هارو با یک کامند ایجاد کنید:
php laragram make:conversation GreetingConversation::start('Greeting');فصل چهار - مدلها و Eloquent ORM
بخش هفتم - Accessors و Mutators
به شما این امکان را میدهند که نحوه دسترسی به ویژگیهای مدل یا نحوه تغییر و ذخیرهسازی دادهها در مدل را سفارشیسازی کنید. شما میتوانید Accessors برای نمایش دادهها به شکلی متفاوت و Mutators برای ذخیرهسازی دادهها با فرمت موردنظر خود ایجاد کنید.
1- Accessors (دسترسیدهندهها)
برای تغییر دادههایی استفاده میشود که هنگام دسترسی به یک ویژگی مدل نمایش داده میشوند.
فرض کنید یک مدل کاربر (User) دارید و میخواهید نام کاربر همیشه با حرف اول بزرگ نمایش داده شود.
protected function name(): Attribute
{
return Attribute::make(
get: fn ($value) => ucfirst($value)
);
}protected function email(): Attribute
{
return Attribute::make(
set: fn ($value) => strtolower($value)
);
}protected function name(): Attribute
{
return Attribute::make(
get: fn ($value) => ucfirst($value),
set: fn ($value) => strtolower($value)
);
}$user = new User();
$user->name = 'jane doe';
echo $user->name; // Jane doepublic function getNameAttribute($value)
{
return ucfirst($value);
}
public function setEmailAttribute($value)
{
$this->attributes['email'] = strtolower($value);
}فصل چهار - مدلها و Eloquent ORM
بخش ششم - Casts
کست یک ویژگی در مدلهای لاراول است که به شما امکان میدهد نوع دادهای که از ستونهای دیتابیس بازیابی میشود یا به دیتابیس ذخیره میشود را خودکار مدیریت کنید. لاراول از Casts برای تبدیل دادهها به نوعهای مختلف استفاده میکند تا توسعهدهندگان بدون نیاز به نوشتن کد اضافی، نوع داده موردنظر خود را مدیریت کنند.
برای تعریف Castهای پیشفرض، متد casts() را در مدل خود پیادهسازی میکنید.
protected function casts(): array
{
return [
'is_active' => 'boolean',
'birthday' => 'date',
];
}'is_active' => 'boolean',
'age' => 'integer',
'price' => 'float',
'phone_number' => 'string',
'meta' => 'array',
'preferences' => 'json',
'settings' => 'object',
'tags' => 'collection',
'birthday' => 'date',
'created_at' => 'datetime',
'event_time' => 'timestamp',
'birthday' => 'immutable_date',
'created_at' => 'immutable_datetime',
'password' => 'encrypted',php artisan make:cast Uppercaseclass Uppercase implements CastsAttributes
{
public function get($model, string $key, $value, array $attributes)
{
return strtoupper($value);
}
public function set($model, string $key, $value, array $attributes)
{
return strtolower($value);
}
}protected function casts(): array
{
return [
'name' => Uppercase::class,
];
}protected $casts = [
'is_admin' => 'boolean',
];فصل چهار - مدلها و Eloquent ORM
بخش پنجم - پراپرتی های مدل
1- پراپرتی table
نام جدول دیتابیس مرتبط با مدل را مشخص میکند. بهصورت پیشفرض، لاراول نام مدل را با حروف کوچک و به صورت جمع تبدیل میکند.
protected $table = 'my_custom_table';protected $primaryKey = 'user_id';protected $keyType = 'string';public $incrementing = false;public $timestamps = false;protected $dateFormat = 'U';protected $connection = 'mysql2';protected $fillable = ['name', 'email', 'password'];protected $guarded = ['is_admin'];protected $hidden = ['password', 'remember_token'];protected $visible = ['name', 'email'];protected $dates = ['birthday'];protected $touches = ['post'];protected $perPage = 20;protected $morphClass = 'post';protected $relationResolvers = [
'profile' => 'resolveProfile',
];
public function resolveProfile()
{
return $this->hasOne(Profile::class);
}protected $foreignKeyType = 'string';فصل چهار - مدلها و Eloquent ORM
بخش چهارم - اسکوپ ها
اسکوپها (Scopes) در لاراول به شما اجازه میدهند که منطق جستجو یا کوئریهای پیچیدهای را به صورت توابع قابل استفاده مجدد تعریف کنید. این اسکوپها به شما کمک میکنند که کوئریهای مشابه را در سراسر برنامه به راحتی مدیریت کنید. اسکوپها به دو دسته اصلی تقسیم میشوند:
1- Local Scopes (اسکوپهای محلی)
2- Global Scopes (اسکوپهای سراسری)
اسکوپهای محلی به شما اجازه میدهند که منطق فیلتر کردن را در یک تابع درون مدل تعریف کنید و سپس آن را در هر کوئری که به مدل مربوط میشود، بهراحتی فراخوانی کنید.
اسکوپهای محلی به عنوان متدهایی در مدل تعریف میشوند و با کلمه scope شروع میشوند. برای استفاده از آنها نیازی به نوشتن scope در هنگام فراخوانی نیست.
فرض کنید یک جدول کاربران داریم که دارای یک ستون active است. میخواهیم کاربران فعال را با استفاده از یک اسکوپ بازیابی کنیم.
class User extends Model
{
public function scopeActive($query)
{
return $query->where('active', 1);
}
}
// Usage:
$activeUsers = User::active()->get();class User extends Model
{
public function scopeOlderThan($query, $age)
{
return $query->where('age', '>', $age);
}
}
// Usage:
$users = User::olderThan(25)->get();php artisan make:scope ActiveScopeclass ActiveScope implements Scope
{
public function apply(Builder $builder, Model $model)
{
$builder->where('active', 1);
}
}class User extends Model
{
protected static function booted()
{
static::addGlobalScope(new ActiveScope);
}
}// Without ActiveScope
$users = User::withoutGlobalScope(ActiveScope::class)->get();
// Without any global scope
$users = User::withoutGlobalScopes()->get();class AgeScope implements Scope
{
protected $age;
public function __construct($age)
{
$this->age = $age;
}
public function apply(Builder $builder, Model $model)
{
$builder->where('age', '>', $this->age);
}
}
// Usage:
class User extends Model
{
protected static function booted()
{
static::addGlobalScope(new AgeScope(30));
}
}فصل چهار - مدلها و Eloquent ORM
بخش سوم - روابط - قسمت هفتم
متد های روابط
1- متد with
برای Eager Loading روابط استفاده میشود. با استفاده از این متد، میتوانید قبل از اجرای کوئری و دریافت نتایج، تمام روابط مرتبط با مدل را نیز بهطور پیشفرض بارگذاری کنید.
$posts = Post::with('comments')->get();$posts = Post::without('comments')->get();$posts = Post::withOnly('comments')->get();$posts = Post::withWhereHas('comments', function ($query) {
$query->where('likes', '>', 10);
})->get();$users = User::morphWithCount([Post::class => ['comments']])->get();$post = Post::find(1);
$post->load('comments');$comment = Comment::find(1);
$comment->loadMorph('commentable', [Post::class => ['comments'], Video::class => ['likes']]);$comment = Comment::find(1);
$comment->loadMorphCount('commentable', [Post::class => ['comments'], Video::class => ['likes']]);$post = Post::find(1);
$post->loadSum('comments', 'likes');$posts = Post::has('comments')->get();$posts = Post::has('comments')->orHas('likes')->get();User::resolveRelationUsing('profile', function ($model) {
return $model->hasOne(Profile::class);
});فصل چهار - مدلها و Eloquent ORM
بخش سوم - روابط - قسمت ششم
رابطه Polymorphic Relationships
به شما اجازه میدهند که یک مدل به چندین مدل دیگر بهصورت پویا و با استفاده از یک ساختار واحد مرتبط شود. به عبارت دیگر، در این نوع رابطه، یک مدل میتواند به چندین مدل مختلف مرتبط باشد و نیازی به تعریف جداول جداگانه برای هر نوع مدل مرتبط نیست.
این نوع روابط به دو دسته اصلی تقسیم میشوند:
1- One-to-One/One-to-Many
2- Many-to-Many
نوع One-to-One/One-to-Many:
در این نوع رابطه، یک مدل میتواند به چندین مدل مختلف به صورت یک به یک یا یک به چند مرتبط شود. برای این کار از دو ستون morphable_id و morphable_type در جدول استفاده میشود که به ترتیب شناسه مدل و نوع مدل مرتبط را مشخص میکنند.
فرض کنید شما میخواهید یک سیستم نظردهی ایجاد کنید که کاربران بتوانند به پستها و ویدئوها نظر دهند. به جای ایجاد دو جدول جداگانه برای نظرهای پستها و نظرهای ویدئوها، میتوانید از یک جدول مشترک comments استفاده کنید و از رابطه Polymorphic بهره ببرید.
1- ساختار جداول:
جدول comments در کنار سایر فیلد ها، دو فیلد commentable_id و commentable_type را دارد.
نکته: شیوه نام گذاری، اسم مفرد جدول با پسوند های able_id و able_type می باشد، مانند commentable_id و commentable_type.
تعریف مدل ها:
ابتدا با متد های مربوطه آشنا می شویم:
1- متد morphTo
این متد برای ارتباط با یک مدل چندشکلی استفاده میشود.
پارامتر ها:
1- نام رابطه. اگر این پارامتر مشخص نشود، لاراول بهصورت خودکار نام رابطه را با توجه به فیلدهای *_id و *_type تشخیص میدهد.
2- نام ستون *_type که نوع مدل را نگه میدارد. به طور پیشفرض لاراول ستون *_type را با توجه به نام رابطه ایجاد میکند.
3- نام ستون *_id که شناسه مدل را نگه میدارد. به طور پیشفرض لاراول ستون *_id را با توجه به نام رابطه ایجاد میکند.
2- متد morphOne
این متد برای تعریف رابطه یک به یک چندشکلی استفاده میشود. در این رابطه، یک مدل میتواند به یک رکورد از مدلهای مختلف مرتبط باشد.
پارامتر ها:
1- نام کلاس مدلی که رابطه با آن برقرار است.
2- نام رابطه چندشکلی که برای فیلدهای *_id و *_type در مدل فرزند استفاده میشود.
3- متد morphMany
این متد مشابه morphOne اما برای تعریف رابطه یک به چند چندشکلی استفاده میشود. یعنی یک مدل میتواند با چندین رکورد از مدلهای مختلف مرتبط باشد.
4- متد morphToMany
این متد مشابه morphOne اما برای تعریف رابطه چند به چند چندشکلی استفاده میشود. یعنی یک مدل میتواند با چندین رکورد از مدلهای مختلف از طریق یک جدول واسط مرتبط باشد.
5- متد morphedByMany
این متد مشابه morphOne اما برای تعریف رابطه چند به چند چندشکلی از سمت مدل معکوس استفاده میشود. یعنی مدلی که در رابطهی چند به چند چندشکلی، سمت دیگر رابطه است.
———
مدل Comment:
در این مدل، از متد morphTo برای ارتباط با مدلهای دینامیک (پستها و ویدئوها) استفاده میشود.
public function commentable()
{
return $this->morphTo();
}public function comments()
{
return $this->morphMany(Comment::class, 'commentable');
}public function posts()
{
return $this->morphedByMany(Post::class, 'taggable');
}
public function videos()
{
return $this->morphedByMany(Video::class, 'taggable');
}public function tags()
{
return $this->morphToMany(Tag::class, 'taggable');
}فصل چهار - مدلها و Eloquent ORM
بخش سوم - روابط - قسمت پنجم
رابطه Has-Many-Through و Has-One-Through
رابطه Has-Many-Through زمانی استفاده میشود که یک مدل بتواند از طریق یک مدل واسط (Intermediate Model) به چندین رکورد در یک مدل دیگر دسترسی پیدا کند. به عبارت دیگر، این رابطه به شما اجازه میدهد که یک مدل با یک مدل دورتر (که مستقیماً به آن مرتبط نیست) ارتباط داشته باشد و بتوانید از طریق یک مدل واسط، رکوردهای آن را بازیابی کنید.
مثال:
فرض کنید شما سه جدول دارید:
1- جدول کشورها.
2- جدول کاربران که هر کاربر متعلق به یک کشور است.
3- جدول پستها که هر پست توسط یک کاربر نوشته شده است.
اگر بخواهید همه پستهایی که در یک کشور خاص نوشته شدهاند را پیدا کنید، این کار را از طریق رابطه Has-Many-Through انجام میدهید.
1- ساختار جداول:
جدول countries اطلاعات کشورها را نگهداری میکند. این جدول دارای یک فیلد id به عنوان primary key است.
جدول users اطلاعات کاربران را نگهداری میکند. این جدول دارای یک فیلد id به عنوان primary key و یک کلید خارجی (country_id) است که به جدول countries اشاره دارد.
جدول posts اطلاعات پستهای نوشته شده توسط کاربران را نگهداری میکند. این جدول دارای یک فیلد id به عنوان primary key و یک کلید خارجی (user_id) است که به جدول users اشاره دارد.
2- تعریف رابطه:
ابتدا با دو متد جدید برای ایجاد روابط آشنا می شویم:
1- متد hasOneThrough
زمانی استفاده میشود که یک رکورد از یک مدل از طریق یک مدل واسط، تنها به یک رکورد از مدل دیگری مرتبط باشد.
public function relatedModel()
{
return $this->hasOneThrough(FinalModel::class, IntermediateModel::class);
}public function posts()
{
return $this->hasManyThrough(Post::class, User::class, 'country_id', 'user_id');
}public function country()
{
return $this->belongsTo(Country::class);
}
public function posts()
{
return $this->hasMany(Post::class);
}public function user()
{
return $this->belongsTo(User::class);
}$country = Country::find(1); // USA
$posts = $country->posts;