| AmirHossein |
رفتن به کانال در Telegram
610
مشترکین
اطلاعاتی وجود ندارد24 ساعت
+27 روز
+230 روز
آرشیو پست ها
Repost from | Erfan's Notes |
⭕️ دوره آموزش برنامه‌نویسی مینی اپ تلگرام
💠 در این دوره به آموزش برنامه‌نویسی مینی اپ تلگرام می‌پردازیم، از مباحث پایه و عمومی شروع می‌کنیم و مفاهیم رو یاد می‌گیریم.
فصل پنج - Migrations and Database
بخش دوم - Factories
لاراول هنگام کار با فکتوری‌ها، مجموعه‌ای از متدها و پراپرتی‌ها را ارائه می‌دهد که به شما کمک می‌کنند داده‌های نمونه پیشرفته‌تری بسازید.
این متد ها درون کلاس فکتوری پیاده سازی می شوند.
1- متد definition
این متد اصلی ترین متد برای تعریف داده‌های پیشفرض فکتوری استفاده می‌شود. داده‌های تولید شده توسط Faker در این متد تعریف می‌شوند.
این متد یک آرایه برمی گرداند که شامل نام فیلد ها به عنوان key و مقدار فیلد ها به عنوان value می باشد.
class UserFactory extends Factory
{
protected $model = \App\Models\User::class;
public function definition()
{
return [
'name' => $this->faker->name(),
'email' => $this->faker->unique()->safeEmail(),
'password' => bcrypt('password'),
];
}
}public function unverified()
{
return $this->state(function (array $attributes) {
return [
'email_verified_at' => null,
];
});
}
// Usage:
User::factory()->unverified()->create();public function suspended()
{
return $this->state(function (array $attributes) {
return [
'is_suspended' => true,
];
});
}
// Usage:
User::factory()->suspended()->create();public function configure()
{
return $this->afterCreating(function (User $user) {
$user->profile()->create([
'bio' => 'This is a sample bio.',
]);
});
}
// Usage:
User::factory()->create();class User extends Authenticatable
{
use HasFactory;
protected static function newFactory()
{
return UserFactory::new();
}
}فصل پنج - Migrations and Database
بخش دوم - Factories
فکتوری‌ها در لاراول ابزاری برای ایجاد سریع و راحت داده‌های نمونه (mock) برای تست و توسعه هستند. با استفاده از فکتوری‌ها، میتوانید به راحتی رکوردهایی را در پایگاه داده تولید کنید، بدون اینکه نیاز باشد به صورت دستی داده‌ها را وارد کنید.
در تست‌های خودکار، میتوانید با استفاده از فکتوری‌ها داده‌های نمونه ایجاد کنید تا رفتار اپلیکیشن خود را آزمایش کنید.
ساخت یک فکتوری:
برای ساخت فکتوری، می توانید از دستور زیر استفاده کنید:
php artisan make:factory UserFactoryclass UserFactory extends Factory
{
protected $model = \App\Models\User::class;
public function definition()
{
return [
'name' => $this->faker->name(),
'email' => $this->faker->unique()->safeEmail(),
'email_verified_at' => now(),
'password' => bcrypt('password'),
'remember_token' => Str::random(10),
];
}
}User::factory()->create();User::factory()->count(10)->create();$user = User::factory()->make();class PostFactory extends Factory
{
protected $model = \App\Models\Post::class;
public function definition()
{
return [
'title' => $this->faker->sentence(),
'content' => $this->faker->paragraph(),
'user_id' => \App\Models\User::factory(),
];
}
}Post::factory()->count(100)->create();فصل پنج - Migrations and Database
بخش اول - تعریف و اجرای Migrationها
در قسمت آخر این بخش به تمامی کامندهای مربوط به مایگریشن ها اشاره می شود.
1- کامند make:migration
این دستور برای ایجاد یک فایل Migration جدید استفاده می‌شود.
php artisan make:migration create_flights_tablephp artisan make:migration create_flights_table
--create=flights
php artisan make:migration create_flights_table
--table=flightsphp artisan schema:dumpphp artisan schema:dump --prunephp artisan schema:dump --database=testingphp artisan migratephp artisan migrate --isolatedphp artisan migrate:statusphp artisan migrate:rollback --step=5php artisan migrate:rollback --batch=3php artisan migrate:rollback --pretendphp artisan migrate:resetphp artisan migrate:refreshphp artisan migrate:refresh --seedphp artisan migrate:refresh --step=5php artisan migrate:freshphp artisan migrate:fresh --seedphp artisan migrate:fresh --database=adminRepost from Mahi in Tech
+1
همونطور که می‌دونید، شما برای توسعه‌ی یک Mini App تلگرامی نیاز دارید که وب‌اپلیکیشن‌تون به‌صورت HTTPS در دسترس باشه که خب توسعه‌ی لوکال رو سخت میکنه و به ابزارهایی مثل ngrok برای تونل کردن لوکال‌هاستتون نیاز پیدا می‌کنید، همچنین دیدن حالت‌های مختلف (تم و سیستم‌عامل‌های مختلف مثلا) به‌سادگی همیشه نیست و احتمالا باید چند موبایل دم‌دستتون باشه تا بتونید خروجی کار رو به‌خوبی ببینید :))
این محیط، یعنی 📱 TMA Studio، رو یکی از دوستان به‌تازگی منتشر کرده اکثر این مشکلات رو حل کرده و با شبیه‌سازی محیط مینی‌اپ‌های تلگرام، توسعه‌ی اون‌ها رو ساده‌تر کرده و به‌صورت کراس‌پلتفرم دردسترس هست که خب می‌تونید ازش استفاده کنید و یا درتوسعه‌ش مشارکت داشته باشید.
برای حمایت از این پروژه می‌تونید توی گیت‌هاب بهش ⭐️ بدید.
📱 Repo Link
🌐 tma-studio.pages.dev
فصل پنج - Migrations and Database
بخش اول - تعریف و اجرای Migrationها
1- متد unique
این متد یک ایندکس یکتا برای یک یا چند ستون تعریف میکند. ایندکس یکتا باعث می‌شود که مقدارهای تکراری برای این ستون‌ها در جدول ذخیره نشود.
$table->string('email')->unique();$table->string('username')->index();$table->integer('order_id')->primary();$table->fullText('content');$table->point('coordinates')->spatialIndex(); $table->dropPrimary();$table->dropUnique('users_email_unique');$table->dropIndex('users_username_index');$table->dropFullText('articles_content_fulltext');$table->dropSpatialIndex('locations_coordinates_spatialindex');$table->unsignedBigInteger('user_id');
$table->foreign('user_id');$table->unsignedBigInteger('user_id');
$table->foreign('user_id')->references('id');$table->unsignedBigInteger('user_id');
$table->foreign('user_id')->references('id')->on('users');$table->foreignId('user_id');$table->foreignId('user_id')->constrained('users');$table->dropForeign('posts_user_id_foreign');$table->foreignId('user_id')->constrained('users')->onDelete('cascade')->onUpdate('cascade');$table->foreignId('user_id')->constrained('users')->cascadeOnDelete();
فصل پنج - Migrations and Database
بخش اول - تعریف و اجرای Migrationها
1- متد after
مشخص میکند که ستون باید بعد از ستون دیگری قرار گیرد.
این متد فقط برای برخی پایگاه‌های داده (مانند MySQL) پشتیبانی می‌شود.
$table->string('middle_name')->after('first_name');$table->integer('id')->autoIncrement();$table->string('name')->charset('utf8mb4');$table->string('name')->collation('utf8mb4_unicode_ci');$table->integer('age')->comment('Age of the user in years');$table->string('status')->default('active');$table->string('first_name')->first();$table->integer('id')->autoIncrement()->from(1000);$table->string('secret_code')->invisible();$table->string('middle_name')->nullable();$table->integer('price');
$table->integer('tax');
$table->integer('total')->storedAs('price + tax');$table->integer('votes')->unsigned();$table->timestamp('created_at')->useCurrent();$table->timestamp('updated_at')->useCurrentOnUpdate();$table->integer('price');
$table->integer('tax');
$table->integer('total')->virtualAs('price + tax');$table->integer('price');
$table->integer('tax');
$table->integer('total')->generatedAs('price + tax');$table->integer('total')->generatedAs('price + tax')->always();$table->integer('id')->autoIncrement()->change();$table->dropMorphs('commentable');$table->dropRememberToken();$table->dropSoftDeletes();$table->dropTimestamps();فصل پنج - Migrations and Database
بخش اول - تعریف و اجرای Migrationها
1- متد macAddress
ایجاد ستونی برای ذخیره آدرس MAC.
$table->macAddress('device_mac');$table->mediumIncrements('id');$table->mediumText('summary');$table->morphs('commentable');$table->nullableMorphs('taggable');$table->nullableTimestamps(precision: 0);$table->nullableUlidMorphs('taggable');$table->rememberToken();$table->set('flavors', ['strawberry', 'vanilla']);$table->smallIncrements('id');$table->softDeletesTz('deleted_at', precision: 0);$table->string('name', length: 100);$table->text('description');$table->timeTz('sunrise', precision: 0);$table->timestampTz('added_at', precision: 0);$table->timestampsTz(precision: 0);$table->tinyIncrements('id');$table->tinyText('notes');$table->unsignedBigInteger('votes');$table->ulidMorphs('taggable');$table->ulid('id');$table->vector('embedding', dimensions: 100);$table->year('birth_year');فصل پنج - Migrations and Database
بخش اول - تعریف و اجرای Migrationها
کلاس Blueprint در لاراول به عنوان ابزاری در مایگریشن‌ها استفاده می‌شود که امکان تعریف، تغییر و حذف ستون‌ها و ویژگی‌های جداول پایگاه داده را فراهم میکند. این کلاس همراه با متدهای Schema به کار می‌رود و مجموعه‌ای از متدها را برای مدیریت ستون‌ها و ایندکس‌ها ارائه می‌دهد.
مثال:
Schema::create('users', function (Blueprint $table) {
$table->id();
$table->string('name');
$table->string('email')->unique();
});$table->bigIncrements('id');$table->bigInteger('views');$table->binary('file_data', length: 16, fixed: true);$table->boolean('is_active');$table->char('code', length: 10);$table->dateTimeTz('start_time', precision: 0);$table->dateTime('created_at', precision: 0);$table->date('birth_date');$table->decimal('price', total: 10, places: 2);$table->double('rating');$table->enum('status', ['pending', 'approved', 'rejected']);$table->float('amount', precision: 53);$table->foreignId('user_id');$table->foreignIdFor(User::class);$table->foreignUlid('user_id');$table->foreignUuid('user_id');$table->geography('coordinates', subtype: 'point', srid: 4326);$table->geometry('positions', subtype: 'point', srid: 0);$table->id();$table->increments('id');$table->integer('votes');$table->ipAddress('visitor');$table->json('options');$table->jsonb('options');$table->longText('description');
🔴 سیستم جدیدی که در آپدیت های آینده به 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);
}
}