فصل پنج - Migrations and Database

بخش دوم - Factories

در این قسمت به متد های مربوط به فکتوری ها و قابل فراخوانی از مدل ها می پردازیم.

1- متد factory
برای ایجاد یک فکتوری جدید استفاده می‌شود. در نسخه‌های قدیمی لاراول این متد به طور خودکار در دسترس بود، اما در نسخه‌های جدید لاراول باید از Model::factory() استفاده کنید.

User::factory()->...

در اینجا از متد factory برای تولید یک فکتوری از مدل User استفاده شده است.

2- متد create
برای ذخیره مدل‌های تولیدشده در پایگاه داده استفاده می‌شود. این متد رکورد جدید را در دیتابیس ذخیره می‌کند.

User::factory()->create();

در این مثال، کاربر جدیدی بر اساس فیلد های تعریف شده در UserFactory ایجاد و ذخیره می‌شود.

3- متد trashed
برای فیلتر کردن مدل‌هایی که در حالت soft delete قرار دارند، استفاده می‌شود. این متد برای زمانی که می‌خواهید فقط مدل‌های حذف‌شده را ایجاد کنید مفید است.

User::factory()->trashed()->create();

در این مثال، کاربری که حذف شده است، ایجاد می‌شود.

4- متد make
مشابه create است اما رکورد را ذخیره نمی‌کند. این متد فقط شی مدل را برمی‌گرداند و هیچ تغییراتی در دیتابیس ایجاد نمی‌کند.

$user = User::factory()->make();

در اینجا، یک مدل جدید ساخته می‌شود اما در پایگاه داده ذخیره نمی‌شود.

5- متد count
برای مشخص کردن تعداد رکوردهایی است که باید ایجاد شوند.

User::factory()->count(10)->create();

در اینجا 10 کاربر ایجاد و در پایگاه داده ذخیره می‌شود.

6- متد suspended
معمولاً به عنوان یک حالت (state) در فکتوری‌ها استفاده می‌شود. این متد یک وضعیت خاص (مثل تعلیق یا وضعیت غیر فعال) را به مدل اختصاص می‌دهد.

User::factory()->suspended()->create();

در اینجا، یک کاربر که در وضعیت تعلیق قرار دارد، ایجاد می‌شود.

7- متد state
برای اعمال حالت‌های خاص (custom states) به مدل‌های تولید شده استفاده می‌شود. این متد به شما این امکان را می‌دهد که ویژگی‌های مدل را به صورت پویا تغییر دهید.

User::factory()->state([
 'email_verified_at' => null,
])->create();

در اینجا، یک کاربر تولید می‌شود که ایمیل او تایید نشده است.

8- متد has
برای ایجاد روابط (مثل روابط hasMany) استفاده می‌شود. این متد به شما این امکان را می‌دهد که تعداد مدل‌های وابسته (مانند پست‌ها، کامنت‌ها و غیره) را که باید به مدل اصلی تعلق داشته باشند مشخص کنید.

User::factory()->has(Post::factory()->count(5))->create();

ابتدا یک کاربر جدید ایجاد می‌شود، سپس 5 پست مرتبط با این کاربر به طور خودکار ایجاد می‌شود.
ای متد نیاز به پیاده سازی روابط مربوطه در مدل های مربوطه می باشد.

9- متد hasXXX
این متد همان متد has می باشد اما به صورت داینامیک.

User::factory()->hasPosts(3)->create();

در اینجا، کاربری ایجاد می‌شود و به طور خودکار 3 پست برای او ایجاد می‌شود.
بخش Posts در متد hasPosts درواقع نام رابطه posts در مدل User می باشد.

10- متد for
برای تعریف یک رابطه به صورت خاص (معمولاً belongsTo) استفاده می‌شود. این متد به شما این امکان را می‌دهد که مدل‌های وابسته را به مدل اصلی اختصاص دهید.

Post::factory()->for(User::factory())->create();

در اینجا، یک پست ایجاد می‌شود که به طور خودکار به یک کاربر جدید تعلق دارد.

11- متد forXXX
این متد همان متد for می باشد اما به صورت داینامیک.

Post::factory()->forUser($user)->create();

در اینجا، یک پست برای یک کاربر مشخص ایجاد می‌شود.
بخش User در متد forUser درواقع رابطه user در مدل Post می باشد.

12- متد hasAttached
برای ایجاد روابط وابسته بین مدل‌ها (مانند belongsToMany) استفاده می‌شود. این متد برای مدیریت روابط چند به چند (many-to-many) کاربرد دارد.

User::factory()->hasAttached(Role::factory(), 3)->create();

در اینجا، یک کاربر جدید ایجاد می‌شود و به طور خودکار به 3 نقش متصل می‌شود.

13- متد recycle
برای استفاده از یک مدل موجود (که قبلاً ایجاد شده یا حذف نرم شده) در روابط مختلف میان مدل‌ها استفاده می‌شود. این متد به شما کمک می‌کند که یک مدل خاص را در فکتوری‌های مختلف برای ایجاد رکوردهای مرتبط استفاده کنید تا یک نسخه واحد از آن مدل برای همه روابط در فرآیند ساخت داده‌ها استفاده شود.

Ticket::factory()->recycle(Airline::factory()->create())->create();

در اینجا، ابتدا یک ایرلاین جدید ایجاد می‌شود، سپس متد recycle این ایرلاین را برای استفاده در بلیط‌ها و پروازهایی که ایجاد می‌شوند، انتخاب می‌کند. درواقع ایرلاین ایجاد شده در تمام بلیط‌ها و پروازهای موجود از قبل استفاده می‌شود.

#laravel #لاراول #فصل_۵
@AmirhDeveloper
.

فصل پنج - Migrations and Database

بخش سوم - Seeders

‏Seeder یکی از ابزارهای لاراول است که برای وارد کردن داده‌های اولیه یا نمونه به پایگاه داده استفاده می‌شود. این ابزار به توسعه‌دهندگان کمک می‌کند تا داده‌های لازم برای تست یا مقداردهی اولیه پایگاه داده را به صورت خودکار و سریع ایجاد کنند.

فرض کنید می‌خواهید جدول cities را با داده‌های اولیه شهرها پر کنید. این جدول ممکن است شامل نام شهرها و استان‌های آن‌ها باشد.

1- ایجاد Seeder
ابتدا Seeder جدیدی برای جدول شهرها ایجاد می‌کنیم، این کار به وسیله دستور زیر انجام می شود:

php artisan make:seeder CitySeeder

2- پر کردن Seeder
فایل database/seeders/CitySeeder.php را باز کرده و داده‌های اولیه را به صورت دستی وارد کنید:

namespace Database\Seeders;

use Illuminate\Database\Seeder;
use App\Models\City;

class CitySeeder extends Seeder
{
 public function run()
 {
  $cities = [
   ['name' => 'Tehran', 'province' => 'Tehran'],
   ['name' => 'Mashhad', 'province' => 'Khorasan Razavi'],
   ['name' => 'Isfahan', 'province' => 'Isfahan'],
   ['name' => 'Shiraz', 'province' => 'Fars'],
   ['name' => 'Tabriz', 'province' => 'East Azerbaijan'],
  ];

  foreach ($cities as $city) {
   City::create($city);
  }
  // Or using query builder:
  //City::insert($cities);
 }
}

3- اجرای Seeder
برای اجرای Seeder شهرها، از دستور زیر استفاده کنید:

php artisan db:seed --class=CitySeeder

یا برای اجرای تمامی سیدر ها:

php artisan db:seed

گاهی در محیط پروداکشن سیدر ها ممکن است برای محافط از آسیب داده ها اجرا نشوند، برای این کار می توان از فلگ —force استفاده کرد، اما مراقب داده های خود باشید:

php artisan db:seed --force

پس از اجرای Seeder، جدول cities با داده های مشخص شده پر خواهد شد.

این روش برای مقداردهی اولیه داده‌های ثابت مانند شهرها، دسته‌بندی‌ها، یا تنظیمات بسیار مفید است و در زمان تست یا توسعه پروژه استفاده می‌شود.

استفاده از فکتوری ها در سیدر:
همچنین می توانید یک فکتوری را در سیدر خود فراخوانی کنید و داده های تستی خود را از فکتوری ایجاد کنید:

# UserSeeder.php
public function run(): void
{
 User::factory()
   ->count(50)
   ->hasPosts(1)
   ->create();
}

فراخوانی سیدر های اضافی در یک سیدر:
همچنین می توانید از متد call استفاده کنید و سیدر های دیگری را در سیدر خود فراخوانی و اجرا کنید:

# FolanSeeder.php
public function run(): void
{
 $this->call([
  UserSeeder::class,
  PostSeeder::class,
  CommentSeeder::class,
 ]);
}

بی صدا کردن رویداد های مدل:
درصورت اجرای سیدر و ایجاد رکورد ها، رویداد های مدل ها نیز فراخوانی می شوند، شما می توانید با استفاده از تریت WithoutModelEvents، می توانید مانع فراخوانی این سیدر ها شوید:

class DatabaseSeeder extends Seeder
{
 use WithoutModelEvents;

 public function run(): void
 {
  $this->call([
   UserSeeder::class,
  ]);
 }
}

#laravel #لاراول #فصل_۵
@AmirhDeveloper
.

فصل پنج - Migrations and Database

بخش چهارم - اتصالات دیتابیس

در لاراول، مدیریت چندین اتصال به دیتابیس و استفاده از دیتابیس‌های مختلف به صورت ساده‌ای امکان‌پذیر است.

- چندین اتصال به دیتابیس

برای مدیریت چندین اتصال به دیتابیس فایل تنظیمات config/database.php را باز کنید. در آرایه‌ی connections، می‌توانید چندین کانکشن مختلف تعریف کنید.
مثال:

'connections' => [
  'mysql' => [
    // ...
  ],
  'mysql_second' => [
    // ...
  ],
]

در اینجا دو کانکشن مختلف با نام های mysql و mysql_second را پیکربندی می کنیم.

——————

- استفاده از چندین کانکشن در کد

پس از تعریف کانکشن‌ها در فایل تنظیمات، می‌توانید به صورت زیر از آن‌ها استفاده کنید:

// connect to 'mysql'
$data = DB::connection('mysql')->select('SELECT * FROM users');

// connect to 'mysql_second'
$data = DB::connection('mysql_second')->select('SELECT * FROM products');

// In migrations
public function up()
{
  Schema::connection('mysql_second')->create('products', function (Blueprint $table) {
     // ...
  });
}

همچنین در یک مدل خاص می‌توانید کانکشن را مشخص کنید:

class Product extends Model
{
  protected $connection = 'mysql_second';
}

——————

- استفاده از MongoDB

برای استفاده از MongoDB در لاراول، می‌توانید از پکیج رسمی mongodb/laravel-mongodb استفاده کنید. این پکیج توسط MongoDB نگهداری می‌شود و ادغام کاملی با Eloquent و سایر ویژگی‌های لاراول فراهم می‌کند. در ادامه، مراحل نصب و پیکربندی این پکیج را توضیح می‌دهم:

با استفاده از Composer، پکیج را به پروژه خود اضافه کنید:

composer require mongodb/laravel-mongodb

پس از نصب پکیج، باید تنظیمات مربوط به اتصال به دیتابیس MongoDB را در فایل config/database.php اضافه کنید. در بخش connections، کانکشن mongodb را به صورت زیر تعریف کنید:

'connections' => [
    // others...

    'mongodb' => [
        'driver' => 'mongodb',
        'dsn' => env('MONGODB_URI', 'mongodb://localhost:27017'),
        'database' => env('MONGODB_DATABASE', 'laravel_app'),
    ],
],

پس از آن با کانکشن mongodb به دیتابیس mongodb خود متصل شوید.

——————

- استفاده از Redis در لاراول

لاراول به صورت داخلی از Redis پشتیبانی می‌کند.
تنظیمات Redis را می توانید در فایل config/database.php بررسی کنید.
در این دوره استفاده از ردیس به طور کامل بررسی نمی شود، اما تمامی متد های ردیس از فساد Redis در دسترس هستند:

use Illuminate\Support\Facades\Redis;

Redis::set('key', 'value');

$value = Redis::get('key');

#laravel #لاراول #فصل_۵
@AmirhDeveloper
.

ایشالا تا سال دیگه ریلیز میشه (سال میلادی منظورمه🥰)

⭐️ LaraGram
.

کامندهای Symfony که، توی Laravel هم استفاده شده و جدیدا توی LaraGram هم باز نویسی کردم، به قدری باهوش هستن که کافیه یک حرف از کامند رو بنویسی تا متوجه بشه.

اگر کامند هایی مثل m:c, ma:c, make:c, m:class یا هرچیز شبیه ش رو بزنید باز هم make:class رو متوجه میشه.

@Amirhdeveloper

❓ خروجی حلقه کدام است؟

1️⃣ Error
2️⃣ 10 9 8 7 6 5 4 3 2 1
3️⃣ Warning
4️⃣ 9 8 7 6 5 4 3 2 1 0

✅ پاسخ خود را همراه با توضیح ارائه دهید.

❗ بدون اجرای کد یا استفاده از هوش مصنوعی، کمی فکر کنید.

🔖 #PHP, #پی_اچ_پی, #چالش

👤 AmirHossein

💎 Channel: @DevelopixPHP

🔰 در این سوال نکات زیادی حائز اهمیت است که معمولا در نظر گرفته نمی‌شود.

🔍 در ادامه، ساختار حلقه را به‌طور مفصل بررسی می‌کنیم:

for ($i = 10; $i--; $i > 0) {
    echo "$i ";
}

خروجی این حلقه به‌صورت زیر خواهد بود:
9 8 7 6 5 4 3 2 1 0

⁉️ اما چرا؟
بیایید ساختار حلقه را از ابتدا بررسی کنیم.

🔰 ساختار کلی حلقه for
حلقه for از سه بخش تشکیل شده است:

1- شروع: مقداردهی اولیه متغیر حلقه.
این بخش تنها یک بار در ابتدای حلقه اجرا می‌شود.

2- شرط ادامه: تعیین می‌کند که آیا حلقه ادامه یابد یا متوقف شود.
این بخش در هر تکرار، قبل از اجرای بدنه اجرا شده و شرط اجرای بدنه را بررسی می‌کند.

3- تغییر مقدار: مقدار متغیر حلقه را تغییر می‌دهد.
این بخش پس از اجرای بدنه حلقه اجرا می‌شود.

🔰 بررسی اجرای حلقه ذکر شده

1- مقداردهی اولیه:
- ابتدا متغیر $i مقدار 10 می‌گیرد و اجرای این بخش پایان می‌یابد.

2- بررسی شرط ($i--)
در این قسمت نکات مهمی وجود دارد:

- هر عدد به جز 0 مقدار true دارد، بنابراین تا زمانی که $i به 0 نرسد، حلقه ادامه خواهد داشت.

- در عبارت $i-- از عملیات post-decrement استفاده شده است، یعنی ابتدا مقدار فعلی $i برای بررسی شرط استفاده می‌شود، سپس مقدار $i کاهش می‌یابد.
- - به همین دلیل عدد 0 نیز چاپ خواهد شد.
- - مقدار $i بعد از کاهش وارد بدنه حلقه می‌شود، بنابراین چاپ اعداد از 9 شروع می‌شود.

اگر حلقه به این صورت نوشته می‌شد:

for ($i = 10; --$i; $i > 0) {
    echo "$i ";
}

در این حالت، ابتدا مقدار $i کاهش می‌یابد و سپس شرط بررسی می‌شود زیرا از عملیات pre-decrement، بنابراین 0 چاپ نمی‌شود و خروجی به این شکل خواهد بود:
9 8 7 6 5 4 3 2 1

3- بررسی قسمت سوم (تغییر مقدار update)
- بخش سوم این حلقه روی مقدار $i تغییری ایجاد نمی‌کند، بنابراین عملاً بی‌اثر است و می‌توان حلقه را ساده‌تر نوشت:

for ($i = 10; $i--;) {
    echo "$i ";
}

🔰 مرور روند اجرای حلقه ذکر شده

- مقدار دهی اولیه i با 10
- بررسی 10 == true، کاهش 10 به 9، چاپ 9
- بررسی 9 == true، کاهش 9 به 8، چاپ 8
‏.
‏.
‏.
- بررسی 2 == true، کاهش 2 به 1، چاپ 1
- بررسی 1 == true، کاهش 1 به 0، چاپ 0
- بررسی 0 == true، پایان حلقه

❗️ درک درست post-decrement ($i--) و pre-decrement (--$i) در حلقه‌ها اهمیت زیادی دارد و تفاوت‌های ظریفی در خروجی ایجاد می‌کند.

🔖 #PHP, #پی_اچ_پی, #چالش

👤 AmirHossein

💎 Channel: @DevelopixPHP

7 ماهی از انتشار ورژن 2 گذشته و ورژن 3 درحال توسعه هست.

توی ورژن 3 تغییرات زیادی مخصوصا در پرفورمنس اعمال شده؛
سیستم های کش اکثر بخش های فریم‌ورک رو در بر گرفتن.

همچنین Eloquent ORM به صورت کاملا اختصاصی بازنویسی شده.
دلیل این بازنویسی این هست که، این ORM برای اجرا نیاز به کانتینر، ایونت‌ها، کیوها، و کلی چیز دیگه از لاراول داره.
ما همه این سیستم هارو توی LaraGram داریم، ولی الوکوئنت دقیقا برای لاراول رو نیاز داره، به همین دلیل در کنار کانتینر LaraGram باید کانتینر Laravel هم لود بشه که منطقی نیست.
اما‌ این بازنویسی تمامی وابستگی های خارجی رو حذف کرده و سرعت دوبرابر بهتر شده.

از طرفی دو کرنل HTTP و Console اضافه شدن؛
کامند ها و درخواست ها به طور دقیق بررسی میشن، Gateها و Middlewareها روی اون ها اعمال میشن و خطاها به طور دقیق مدیریت میشن.

سیستم چندزبانی اصافه شده.
قابلیت مدیریت اتصال و توسعه چند ربات همزمان اضافه میشه.

سیستمی تحت عنوان کامپوننت قراره اضافه بشه، که راستش خودم نمیدونم چی هست فقط میدونم قراره قابلیت باز استفاده از ماژول ها یا هرچیزی رو با فراخوانی یک تابع بده.
مثلا شما نیاز نیست سیستم عضویت اجباری توسعه بدید، کافیه کامپوننت اون رو لود کنید.

سیستم کیو و جاب اضافه میشه که می‌تونید به سادگی عملیات های زمان بندی شده رو توسعه بدید.

قابلیت های جزئی هم طی توسعه اضافه میشن.

و در نهایت احتمال اضافه شدن پروتکل MTProto در ورژن 3 هست؛
توسعه ش یکم سخت و زمانبر هست، برای همین قول نمیدم توی ورژن 3 بیاد، شاید توی ورژن 4 اضافه بشه، ولی میشه یک روز.

و احتمالا چیزای دیگه که در آینده به ذهنم برسه.

اگر ایده یا پیشنهادی دارید خوشحال میشم درمیون بذارید، یا توی توسعه کمک کنید.

و اگر هم به پروژه استار بدید که خیلی بیشتر خوشحال میشم❤️

- LaraGram
- Laraquest
- Core

@AmirhDeveloper
.

از فردا فصل 6 رو شروع می‌کنیم.

یادم رفت

فصل شش - Requests and Response

بخش اول - پردازش درخواست و پاسخ

در فریمورک لاراول، مفاهیم Request (درخواست) و Response (پاسخ) جزو مهم‌ترین اجزای پردازش درخواست‌های وب محسوب می‌شوند. این دو مفهوم در الگوی MVC بخش ارتباط بین کاربر (Client) و سرور (Backend) را مدیریت می‌کنند.

1- درخواست (Request)
‏Request در لاراول به تمام داده‌هایی گفته می‌شود که از طرف کاربر (مثلاً مرورگر، Postman یا یک کلاینت دیگر) به سرور ارسال می‌شود. این داده‌ها می‌توانند شامل موارد زیر باشند:

- داده‌های فرم (POST)
- پارامترهای URL (GET)
- هدرهای HTTP
- کوکی‌ها
- فایل‌های آپلود شده
- اطلاعات احراز هویت

لاراول برای مدیریت درخواست‌ها از کلاس Illuminate\Http\Request استفاده می‌کند که قابلیت‌های زیادی برای دسترسی و فیلتر کردن داده‌های ورودی دارد.

در کنترلرها، برای دریافت اطلاعات ورودی، می‌توان از کلاس Request استفاده کرد:

class UserController extends Controller
{
 public function store(Request $request)
 {
  $name = $request->input('name');

  $email = $request->input('email', 'default@example.com');

  $data = $request->all();

  $token = $request->header('Authorization');
 }
}

2- پاسخ (Response)
‏Response یا پاسخ، همان داده‌ای است که لاراول پس از پردازش درخواست به کلاینت ارسال می‌کند. این پاسخ می‌تواند شامل:

‏- HTML‏ یا View
‏- JSON‏ یا API Response
- ریدارکت (Redirect)
- دانلود فایل
- ارسال پیام‌های خطا یا موفقیت باشد.

در کنترلرها، برای ارسال پاسخ، می‌توان از فساد یا هلپر Response استفاده کرد:

class UserController extends Controller
{
 public function store(Request $request)
 {
  return response('Hello, Laravel!');

  return response()->json([
    'message' => 'Success',
    'status' => 200
  ]);

  return response()->view('welcome', ['name' => 'John']);
 }
}

در ادامه این بخش به بررسی Request و Response و تمامی متد های در دسترس از آنها خواهیم پرداخت.

#laravel #لاراول #فصل_۶
@AmirhDeveloper
.