"همونطور که میدونید در FormRequest میتونیم قوانین مدنظرمون رو در متود rules تعریف کنیم...
اما اگه بخواهید پیام خطای پیش فرض اعتبارسنجی رو برای یک فیلد خاص و یک قانون اعتبار سنجیه خاص تغییر بدین، کافیه متود ()messages رو به FormRequest اضافه کنید.
📌 بریم یه مثال بزنیم :
به تصویر توجه کنین، میخوایم پیام خطای مربوط به اعتبار سنجیه فیلد name برای قانون required رو تغییر بدیم، به راحتی میتونیم با استفاده از متود messages این کارو انجام بدیم.
خروجی :
اگر name خالی بمونه خطایی که تعریف کردیم نمایش داده میشه."
@GoldenCodeir
#Laravel
#لاراول
(به منبع و مثالش دقت کنید👇🏾)
https://x.com/PovilasKorop/status/1793941262698971531?s=35
اما اگه بخواهید پیام خطای پیش فرض اعتبارسنجی رو برای یک فیلد خاص و یک قانون اعتبار سنجیه خاص تغییر بدین، کافیه متود ()messages رو به FormRequest اضافه کنید.
📌 بریم یه مثال بزنیم :
به تصویر توجه کنین، میخوایم پیام خطای مربوط به اعتبار سنجیه فیلد name برای قانون required رو تغییر بدیم، به راحتی میتونیم با استفاده از متود messages این کارو انجام بدیم.
خروجی :
اگر name خالی بمونه خطایی که تعریف کردیم نمایش داده میشه."
@GoldenCodeir
#Laravel
#لاراول
(به منبع و مثالش دقت کنید👇🏾)
https://x.com/PovilasKorop/status/1793941262698971531?s=35
❤6👍2❤🔥1
ممکنه بعضی مواقع بخواید بررسی کنین که آیا همه عناصر در مجموعه ، تابع یک شرط هستن یا خیر.
لاراول با متود ()every همینکارو انجام میده.✔️
در دو مثال زیر ، یک شرط به طرق مختلف بررسی شده (آیا همه ی آیتم ها بزرگتر از ۲ هستند؟)
مثال ۱: پاسخ false
مثال ۲: یک آرایه خالی ایجاد شده و با متود every اقدام به بررسی شرط کردیم.
(پاسخ true میشه)
چرا؟
(چون عنصری وجود نداره که بخواد شرط رو نقض کنه)
📌 برخی مزایای متود every:
خواناتر شدن کد
تعامل خوب با اکثر متودای کالکشن
بهبود performance (وقتی شرط false بشه عملیات متوقف میشه)"
@GoldenCodeir
#Laravel
#لاراول
(به منبع و مثال توجه کنید👇🏾)
https://twitter.com/OussamaMater/status/1795907677702193378?t=RNSJQRVQfui92BI_BfOZ2g&s=19
لاراول با متود ()every همینکارو انجام میده.✔️
در دو مثال زیر ، یک شرط به طرق مختلف بررسی شده (آیا همه ی آیتم ها بزرگتر از ۲ هستند؟)
مثال ۱: پاسخ false
مثال ۲: یک آرایه خالی ایجاد شده و با متود every اقدام به بررسی شرط کردیم.
(پاسخ true میشه)
چرا؟
(چون عنصری وجود نداره که بخواد شرط رو نقض کنه)
📌 برخی مزایای متود every:
خواناتر شدن کد
تعامل خوب با اکثر متودای کالکشن
بهبود performance (وقتی شرط false بشه عملیات متوقف میشه)"
@GoldenCodeir
#Laravel
#لاراول
(به منبع و مثال توجه کنید👇🏾)
https://twitter.com/OussamaMater/status/1795907677702193378?t=RNSJQRVQfui92BI_BfOZ2g&s=19
X (formerly Twitter)
OussamaMater (@OussamaMater) on X
Laravel Tip💡: The "every" Collection Method
Sometimes you may want to check if every element in the collection passes a condition. Luckily, Laravel ships with the "every" method to do exactly that 🚀
#laravel
Sometimes you may want to check if every element in the collection passes a condition. Luckily, Laravel ships with the "every" method to do exactly that 🚀
#laravel
❤2❤🔥1👍1🔥1
Forwarded from کداکسپلور | CodeExplore (Bardia)
فرق گیت هاب و گیت لب چیه ، از کدومش استفاده کنم !! 🧐
🔹 در کنار شباهتهای این دو سرویس که دو نوع از پر کاربردترین سرویس های مدیریت مخزن گیت است، به طور حتم تفاوتهای بسیاری نیز مشاهده میشود . ما در این جا فقط به تفاوت های این دو می پردازیم .
🔻 تفاوت ها :
در قدم اول اینکه میدونین بیس و کار هر دو تا پلتفرم یکی هستش و هر دو ساخته شدند تا یک کاری رو انجام بدن اما !
گیت لب امکان اجازه به کاربران در جهت استفاده از مخزن خصوصی به صورت رایگان را میدهد. در حالی که گیت هاب برای مخزنهای شخصی خود به پرداختهای ماهانه و یا سالانه نیازمند است. به این دلیل که github به کمپانی مایکروسافت واگذار شده است.
یکی از بزرگترین مشکل گیت لب این است که برای کاربران ساکن ایران به دلیل تحریم ها یک مقدار مشکلاتی را به وجود می آوردن ، اما گیت هاپ کاملا آزاد است و کیتواندی ثبت نام و از مزایا آن استفاده کنید
در مورد سابقه این دو سرویس ، گیت لب یک مقدار از گیت هاب کارکشته تر است اما گیت هاب در این چند وقت واقعا رشد عجیبی نسبت به گیت لب کرده و اکثر توسعه دهندگان از سرویس گیت هاب استفاده می کنند .
#پست_پیشنهادی
☕️ @CodeExplore
🔹 در کنار شباهتهای این دو سرویس که دو نوع از پر کاربردترین سرویس های مدیریت مخزن گیت است، به طور حتم تفاوتهای بسیاری نیز مشاهده میشود . ما در این جا فقط به تفاوت های این دو می پردازیم .
🔻 تفاوت ها :
در قدم اول اینکه میدونین بیس و کار هر دو تا پلتفرم یکی هستش و هر دو ساخته شدند تا یک کاری رو انجام بدن اما !
گیت لب امکان اجازه به کاربران در جهت استفاده از مخزن خصوصی به صورت رایگان را میدهد. در حالی که گیت هاب برای مخزنهای شخصی خود به پرداختهای ماهانه و یا سالانه نیازمند است. به این دلیل که github به کمپانی مایکروسافت واگذار شده است.
یکی از بزرگترین مشکل گیت لب این است که برای کاربران ساکن ایران به دلیل تحریم ها یک مقدار مشکلاتی را به وجود می آوردن ، اما گیت هاپ کاملا آزاد است و کیتواندی ثبت نام و از مزایا آن استفاده کنید
در مورد سابقه این دو سرویس ، گیت لب یک مقدار از گیت هاب کارکشته تر است اما گیت هاب در این چند وقت واقعا رشد عجیبی نسبت به گیت لب کرده و اکثر توسعه دهندگان از سرویس گیت هاب استفاده می کنند .
#پست_پیشنهادی
☕️ @CodeExplore
👍6
Forwarded from Pishro App
بصورت کلی Property webhook به برنامهنویسان این امکان رو میده تا رفتار پیشفرض دسترسی به properties و تغییر آنها را با استفاده از توابع "get" و "set" تغییر دهند. این قابلیت از زبانهایی مانند Kotlin، C# و Swift الهام گرفته شده است.
Property Hooks دو نوع "hook" برای دسترسی و تغییر مقدار properties فراهم میکند:
get:
این hook برای تعیین منطق دلخواه هنگام خواندن مقدار property استفاده میشود. به عنوان مثال، میتوانید property را قبل از برگرداندن مقدار آن تغییر دهید.
set:
این hook برای تعیین منطق دلخواه هنگام تنظیم مقدار property استفاده میشود. به عنوان مثال، میتوانید مقادیر را اعتبارسنجی یا تغییر دهید قبل از اینکه به property اختصاص داده شوند.
class User {
public string $fullName {
get => $this->first . " " . $this->last;
set {
[$this->first, $this->last] = explode(' ', $value, 2);
}
}
public function __construct(public string $first, public string $last) {}
}
$user = new User('John', 'Doe');
echo $user->fullName; // John Doe
$user->fullName = 'Jane Smith';
echo $user->first; // Janeکاهش کدهای تکراری: نیازی به تعریف متدهای getter و setter برای هر property نیست.
انعطافپذیری بیشتر: امکان تعریف منطق دلخواه برای دسترسی و تغییر properties.
کد خواناتر: خوانایی و نگهداری کدها بهتر میشود.
ویژگی Property Hooks قابلیتهای متعددی برای بهبود و سادهسازی دسترسی به properties فراهم میکنند و از این جهت یک ابزار قدرتمند برای توسعهدهندگان PHP خواهند بود.
#php
Please open Telegram to view this post
VIEW IN TELEGRAM
👍5❤1🤮1
لاراول هلپری با نام ()optional در اختیارمون گذاشته که وقتی ازش استفاده کنیم میتونیم بر نتایج خطاهای مربوط به مقدار null ، مدیریت بهتری داشته باشیم تا برنامه به دلیل null بودن یک مقدار ، با خطا مواجه نشه...
تصویر رو مشاهده کنید
اگر مقدار برای user برابر null بشه دیگه خطایی رخ نمیده.(بدلیل استفاده از optional)
اما اگه دیتایی داشته باشه ، اون callback براش اجرا خواهد شد.✔️
#Laravel
#لاراول
#اموزشی_لاراول
#کد_نویسی
#برنامه_نویسی
@GoldenCodeir
(به منبع و مثال دقت کنید👇🏾)
https://x.com/laravelbackpack/status/1796866799663042779
تصویر رو مشاهده کنید
اگر مقدار برای user برابر null بشه دیگه خطایی رخ نمیده.(بدلیل استفاده از optional)
اما اگه دیتایی داشته باشه ، اون callback براش اجرا خواهد شد.✔️
#Laravel
#لاراول
#اموزشی_لاراول
#کد_نویسی
#برنامه_نویسی
@GoldenCodeir
(به منبع و مثال دقت کنید👇🏾)
https://x.com/laravelbackpack/status/1796866799663042779
X (formerly Twitter)
Backpack for Laravel (@laravelbackpack) on X
#Laravel Tip
Use Laravel's optional() helper with a callback to handle null values gracefully. 🕶️ That way, you can perform operations on potentially null values without throwing errors.
Use Laravel's optional() helper with a callback to handle null values gracefully. 🕶️ That way, you can perform operations on potentially null values without throwing errors.
⚡2👍2❤1🔥1
Forwarded from CleverDevs (Mahdi)
👈 5 نکته برای بهبود UI, UX سایتتون(پارت1) :
یه روانشناس آلمانی به اسم Hedwig von Restorff تو سال 1933 طی یه آزمایش چند تا آیتم شبیه به هم و یک آیتم متفاوت رو کنار هم گذاشت و طبق بررسی مشخص شد که اون آیتم متفاوت کنار آیتمهای یکسان، توجه خیلی بیشتری رو جلب میکنه.
حالا تو سایت چه استفادهای داره؟
میتونیم توی اسلایدری که محصولمون رو گذاشتیم، اسلایدی که زودتر باید فروش بره رو به یه نحوی نسبت به بقیه اسلاید ها مجزا کنیم(مثل تصویر).
#UX #UI src
@CleverDevs - @CleverDevsGp
1. Isolation
یه روانشناس آلمانی به اسم Hedwig von Restorff تو سال 1933 طی یه آزمایش چند تا آیتم شبیه به هم و یک آیتم متفاوت رو کنار هم گذاشت و طبق بررسی مشخص شد که اون آیتم متفاوت کنار آیتمهای یکسان، توجه خیلی بیشتری رو جلب میکنه.
حالا تو سایت چه استفادهای داره؟
میتونیم توی اسلایدری که محصولمون رو گذاشتیم، اسلایدی که زودتر باید فروش بره رو به یه نحوی نسبت به بقیه اسلاید ها مجزا کنیم(مثل تصویر).
#UX #UI src
@CleverDevs - @CleverDevsGp
👍2❤1💯1
"اگر نیاز داشته باشیم در کوئری نویسی از sql خام برای دریافت دیتای حاصل از کوئری استفاده کنیم درین شرایط میتونیم از متودی تحت عنوان ()rawValue استفاده کنیم.
در مثال سوم خواسته شده که دو ستون first_name و last_name که مربوط به یوزر مدنظر هستند رو در کنار هم تحویل بده."
@GoldenCodeir
#Laravel
#لاراول
#برنامه_نویسی
این مقاله فارسی هم خوب بود :
https://vrgl.ir/Xppdh
(📌 به منبع و مثالش دقت کنید👇🏾)
https://x.com/laravelbackpack/status/1797953958335725973
در مثال سوم خواسته شده که دو ستون first_name و last_name که مربوط به یوزر مدنظر هستند رو در کنار هم تحویل بده."
@GoldenCodeir
#Laravel
#لاراول
#برنامه_نویسی
این مقاله فارسی هم خوب بود :
https://vrgl.ir/Xppdh
(📌 به منبع و مثالش دقت کنید👇🏾)
https://x.com/laravelbackpack/status/1797953958335725973
👍3❤2🔥2💯1
Forwarded from CleverDevs (Mammad)
-اصل Explain Yourself in Code در کلین کد
این اصل میگه که وقتی میشه کد رو جوری نوشت که خودش کارشو توضیح بده چه نیازی به کامنت اضافس ؟
یعنی چی ؟ مثال پایین رو ببینید
این کد بهتره یا اینکه جای کامنت این شرط رو توی تابع با اسم درست بزاریم ؟ مثل این
کلا دوثانیه وقتتون رو میگیره تا جای کامنت این کارو بکنید. بیشتر مواقع اینکه یه تابع بسازی که بتونه کد رو هم توضیح بده بهتر از کامنت نوشتنه
#CleanCode
@CleverDevs - @CleverDevsGp
این اصل میگه که وقتی میشه کد رو جوری نوشت که خودش کارشو توضیح بده چه نیازی به کامنت اضافس ؟
یعنی چی ؟ مثال پایین رو ببینید
// Check to see if the employee is eligible for full benefits
if ((employee.flags & HOURLY_FLAG) &&
(employee.age > 65))
این کد بهتره یا اینکه جای کامنت این شرط رو توی تابع با اسم درست بزاریم ؟ مثل این
if (employee.isEligibleForFullBenefits())
کلا دوثانیه وقتتون رو میگیره تا جای کامنت این کارو بکنید. بیشتر مواقع اینکه یه تابع بسازی که بتونه کد رو هم توضیح بده بهتر از کامنت نوشتنه
#CleanCode
@CleverDevs - @CleverDevsGp
👍8🔥3❤2👎1
"گاهی ممکنه نیاز بشه عددی طولانی به کاربر نمایش بدیم ، درین شرایط خواندن عدد واسه کاربر کمی دشوار میشه.
برای نمایش دادن بهتر برخی اعداد به کاربر، میتونیم از هلپری بانام Number استفاده کنیم.✔️
مثال شماره ۱:
عدد ۱۰۰۰ رو دادیم به هلپر، خروجی: 1thousand
در مثال ۲ هم عدد رو رُند کرده برامون.
مثال شماره ۳(تصویر):
اینجا که عدد 12340000 رو داریم،برای نمایش بهتر به کاربر میتونیم ازین هلپر استفاده کنیم.
حالا خروجیش چی میشه؟ 1.23million
چرا؟ چون بر اساس دو رقم اعشار تعیین شده."
@GoldenCodeir
#Laravel
#لاراول
(به منبع و مثال دقت کنید👇🏾)
https://x.com/OussamaMater/status/1797365006935248910?s=19
برای نمایش دادن بهتر برخی اعداد به کاربر، میتونیم از هلپری بانام Number استفاده کنیم.✔️
مثال شماره ۱:
عدد ۱۰۰۰ رو دادیم به هلپر، خروجی: 1thousand
در مثال ۲ هم عدد رو رُند کرده برامون.
مثال شماره ۳(تصویر):
اینجا که عدد 12340000 رو داریم،برای نمایش بهتر به کاربر میتونیم ازین هلپر استفاده کنیم.
حالا خروجیش چی میشه؟ 1.23million
چرا؟ چون بر اساس دو رقم اعشار تعیین شده."
@GoldenCodeir
#Laravel
#لاراول
(به منبع و مثال دقت کنید👇🏾)
https://x.com/OussamaMater/status/1797365006935248910?s=19
X (formerly Twitter)
OussamaMater (@OussamaMater) on X
Laravel Tip💡: Human-readable Numbers
Sometimes you may want to format numbers for your users in a human-readable format. The "Number" helper allows you to do just that 🚀
#laravel
Sometimes you may want to format numbers for your users in a human-readable format. The "Number" helper allows you to do just that 🚀
#laravel
👍5❤1💯1
Forwarded from Pishro App
نوشتن کد مانند ایراد سخنرانی است. اگر از کلمات بزرگ زیادی استفاده کنید، مخاطبان خود را گیج میکنید. اگر هر کلمه را تعریف کنید، مخاطبان خود را به خواب میبرید.
به همین ترتیب، وقتی کد مینویسید، نباید فقط روی عملکرد آن تمرکز کنید. شما باید هدف داشته باشید که کدتان قابل خواندن، قابل فهم و قابل نگهداری برای خوانندگان آینده باشد.
به نقل از مهندس نرمافزار، مارتین فاولر، "هر کسی میتواند کدی بنویسد که یک کامپیوتر آن را بفهمد. برنامهنویسان خوب کدی مینویسند که انسانها آن را بفهمند."
به عنوان توسعهدهندگان نرمافزار، درک چگونگی نوشتن کد تمیز که کاربردی، آسان برای خواندن و مطابقت با بهترین شیوهها باشد، به شما کمک میکند تا به طور مستمر نرمافزار بهتری ایجاد کنید.
#clean_code
👾 @pishroapp
به همین ترتیب، وقتی کد مینویسید، نباید فقط روی عملکرد آن تمرکز کنید. شما باید هدف داشته باشید که کدتان قابل خواندن، قابل فهم و قابل نگهداری برای خوانندگان آینده باشد.
به نقل از مهندس نرمافزار، مارتین فاولر، "هر کسی میتواند کدی بنویسد که یک کامپیوتر آن را بفهمد. برنامهنویسان خوب کدی مینویسند که انسانها آن را بفهمند."
به عنوان توسعهدهندگان نرمافزار، درک چگونگی نوشتن کد تمیز که کاربردی، آسان برای خواندن و مطابقت با بهترین شیوهها باشد، به شما کمک میکند تا به طور مستمر نرمافزار بهتری ایجاد کنید.
#clean_code
Please open Telegram to view this post
VIEW IN TELEGRAM
👍6❤1🔥1
Forwarded from Md Daily
چند Best Practice در طراحی REST API
امروزه که همه چی به هم وصله، REST APIs با طراحی خوب، پایه و اساس برنامههای کاربردی کارآمد و قابل ارتقا هستن.
نوشتن دیزاین های REST API تمیز به چند دلیل خیلی مهمه:
استفاده راحتتر: یه API با طراحی خوب، کاربرپسند و سادست، و برای توسعهدهندهها با هر سطحی قابل استفادهست. اینجوری دیگه نیازی به صرف زمان زیاد برای یادگیری نیست.
نگهداری راحتتر: کد تمیز، نگهداری رو راحتتر میکنه. با این کار پیدا کردن و رفع اشکال، اضافه کردن قابلیتهای جدید و ارتقای API سادهتر و هزینههای توسعه هم کم میشه.
کاهش زمان توسعه: با مشخصات API دقیق و مستندات شفاف، میشه خیلی سریعتر برنامهنویسی کرد چون دیگه نیازی به حدس و گمان و تستهای مفصل نیست. اینجوری هم در زمان و هم در منابع صرفهجویی میشه.
مقیاسپذیری بیشتر: یه طراحی تمیز، با ارائه یه معماری ماژولار که به راحتی قابل گسترشه، امکان مقیاسپذیری راحت رو فراهم میکنه. اینجوری API میتونه با نیازهای برنامه شما رشد کنه و مشکلی پیش نیاد.
استفاده مجدد بیشتر: یه API با طراحی خوب رو میشه تو چند برنامه دیگه هم استفاده کرد، اینجوری دیگه نیازی به تکرار کار نیست و همه چی منظمتر میشه. اینجوری توسعه برنامهها سادهتر میشه و در زمان و تلاش هم صرفهجویی میشه.
مستندات بهتر: طراحیهای تمیز، مستندسازی رو هم سادهتر میکنن و نحوه کارکرد API و نحوه استفاده درست ازش رو به طور کامل برای برنامهنویسها توضیح میدن. اینجوری همه چی شفاف میشه و استفاده از API هم راحتتر میشه.
رولز ها یا قوانین URI
ساختار یه URI به شکل زیره:
مثال:
تو دنیای URI دو نوع منبع (resource) داریم:
منابع مجموعه (Collection resources): این نوع منبع، مجموعهای از منابع دیگه رو در خودش داره. میشه اون رو به یه جدول تو دیتابیس تشبیه کرد. مثلا میشه یه منبع مجموعه به اسم users داشته باشیم که لیستی از تمام کاربرها رو در خودش داره.
منابع تکی (Singleton resources): این نوع منبع، فقط شامل یه منبع واحده. میشه اون رو به یه رکورد تو دیتابیس تشبیه کرد. مثلا میشه یه منبع تکی به اسم users/123 داشته باشیم که اطلاعات مربوط به یه کاربر خاص با شناسه ۱۲۳ رو نشون بده
نکات مهم طراحی Rest Api
۱. منابع Collection باید جمع (plural) باشن :
۲. منابع Singleton باید مفرد (singular) باشن و با شناسه یکتاشون (unique id) جایگزین بشن:
فرض کن میخوای اطلاعات یه بازیکن خاص رو نمایش بدی، بجای استفاده از players/Ronaldo بهتره از شناسه عددی یا کد اون بازیکن استفاده کنی، مثلا players/12345.
۴. برای بهتر خونده شدن، از خط تیره (-) به جای زیرخط (_) استفاده کنید:
۵. تو مسیرهای URI از حروف کوچک استفاده کنید:
۶. تو URI ها از پسوند فایل استفاده نکنید:
۷. از اسم فانکشن های CRUD تو URI استفاده نکنید:
برای عملیات ایجاد، خواندن، بروزرسانی و حذف منابع، از اسم هایی مثل create, read, update, delete تو URI استفاده نکن. بجاش از Http Method های استاندارد استفاده کن.
۸. بخش کوئری (query) تو URI فقط برای منابع Collection قابل استفاده است:
۹. از بخش کوئری برای اسکرول (paging) کردن نتایج منابع مجموعه استفاده کنید:
نسخه بندی API برای موارد زیر اهمیت داره:
حفظ سازگاری قبلی (Maintaining backward compatibility)
تضمین یک API سازگار و با طراحی خوب: استفاده از نامگذاریهای یکسان تو همه نسخهها به یه تجربه کاربری خوب کمک میکنه. تغییر endpoint این تجربه رو بهم میریزه و نسخه بندی به جلوگیری از این موضوع کمک میکنه.
چند استراتزی برای نسخه بندی API:
URI Versioning (پیشنهادی):
Header Versioning:
🆔 @MdDaily
امروزه که همه چی به هم وصله، REST APIs با طراحی خوب، پایه و اساس برنامههای کاربردی کارآمد و قابل ارتقا هستن.
نوشتن دیزاین های REST API تمیز به چند دلیل خیلی مهمه:
استفاده راحتتر: یه API با طراحی خوب، کاربرپسند و سادست، و برای توسعهدهندهها با هر سطحی قابل استفادهست. اینجوری دیگه نیازی به صرف زمان زیاد برای یادگیری نیست.
نگهداری راحتتر: کد تمیز، نگهداری رو راحتتر میکنه. با این کار پیدا کردن و رفع اشکال، اضافه کردن قابلیتهای جدید و ارتقای API سادهتر و هزینههای توسعه هم کم میشه.
کاهش زمان توسعه: با مشخصات API دقیق و مستندات شفاف، میشه خیلی سریعتر برنامهنویسی کرد چون دیگه نیازی به حدس و گمان و تستهای مفصل نیست. اینجوری هم در زمان و هم در منابع صرفهجویی میشه.
مقیاسپذیری بیشتر: یه طراحی تمیز، با ارائه یه معماری ماژولار که به راحتی قابل گسترشه، امکان مقیاسپذیری راحت رو فراهم میکنه. اینجوری API میتونه با نیازهای برنامه شما رشد کنه و مشکلی پیش نیاد.
استفاده مجدد بیشتر: یه API با طراحی خوب رو میشه تو چند برنامه دیگه هم استفاده کرد، اینجوری دیگه نیازی به تکرار کار نیست و همه چی منظمتر میشه. اینجوری توسعه برنامهها سادهتر میشه و در زمان و تلاش هم صرفهجویی میشه.
مستندات بهتر: طراحیهای تمیز، مستندسازی رو هم سادهتر میکنن و نحوه کارکرد API و نحوه استفاده درست ازش رو به طور کامل برای برنامهنویسها توضیح میدن. اینجوری همه چی شفاف میشه و استفاده از API هم راحتتر میشه.
رولز ها یا قوانین URI
ساختار یه URI به شکل زیره:
scheme :// authority / path [?query][#fragment]
مثال:
https://soccer.api.org/teams/dortmund/players?name=Rona#2
تو دنیای URI دو نوع منبع (resource) داریم:
منابع مجموعه (Collection resources): این نوع منبع، مجموعهای از منابع دیگه رو در خودش داره. میشه اون رو به یه جدول تو دیتابیس تشبیه کرد. مثلا میشه یه منبع مجموعه به اسم users داشته باشیم که لیستی از تمام کاربرها رو در خودش داره.
منابع تکی (Singleton resources): این نوع منبع، فقط شامل یه منبع واحده. میشه اون رو به یه رکورد تو دیتابیس تشبیه کرد. مثلا میشه یه منبع تکی به اسم users/123 داشته باشیم که اطلاعات مربوط به یه کاربر خاص با شناسه ۱۲۳ رو نشون بده
نکات مهم طراحی Rest Api
۱. منابع Collection باید جمع (plural) باشن :
✅ soccer.api.org/teams/dortmond
❌ soccer.api.org/team/dortmond
۲. منابع Singleton باید مفرد (singular) باشن و با شناسه یکتاشون (unique id) جایگزین بشن:
فرض کن میخوای اطلاعات یه بازیکن خاص رو نمایش بدی، بجای استفاده از players/Ronaldo بهتره از شناسه عددی یا کد اون بازیکن استفاده کنی، مثلا players/12345.
✅ soccer.api.org/teams/dortmond/players/58c1aaae-205a-11ef-aeea-a64c74618950۳. اسلش ته آدرس رو حذف کنید:
✅ soccer.api.org/teams/dortmond/players
❌ soccer.api.org/teams/dortmond/players/
۴. برای بهتر خونده شدن، از خط تیره (-) به جای زیرخط (_) استفاده کنید:
✅ api.blog.com/blogs/this-is-my-blog
❌ api.blog.com/blogs/this_is_my_blog
۵. تو مسیرهای URI از حروف کوچک استفاده کنید:
✅ api.example.com/my-api/my-resource
❌ api.example.com/My-Api/My-Resource
۶. تو URI ها از پسوند فایل استفاده نکنید:
✅ api.example.com/api/resource
❌ api.example.com/api/resource.json
۷. از اسم فانکشن های CRUD تو URI استفاده نکنید:
برای عملیات ایجاد، خواندن، بروزرسانی و حذف منابع، از اسم هایی مثل create, read, update, delete تو URI استفاده نکن. بجاش از Http Method های استاندارد استفاده کن.
✅ DELETE api.example.com/api/resource
❌ GET api.example.com/api.resource/delete
✅ GET /users
❌ GET /getUsers
۸. بخش کوئری (query) تو URI فقط برای منابع Collection قابل استفاده است:
✅ GET /users?role=admin
❌ GET /users/admin
۹. از بخش کوئری برای اسکرول (paging) کردن نتایج منابع مجموعه استفاده کنید:
✅ GET /users?pageSize=25&pageStartIndex=50نسخه بندی API (Versioning)
نسخه بندی API برای موارد زیر اهمیت داره:
حفظ سازگاری قبلی (Maintaining backward compatibility)
تضمین یک API سازگار و با طراحی خوب: استفاده از نامگذاریهای یکسان تو همه نسخهها به یه تجربه کاربری خوب کمک میکنه. تغییر endpoint این تجربه رو بهم میریزه و نسخه بندی به جلوگیری از این موضوع کمک میکنه.
چند استراتزی برای نسخه بندی API:
URI Versioning (پیشنهادی):
✅ GET /api/v1/users
✅ GET /api/v2/users
Header Versioning:
✅ GET /api/users
Headers: { "X-API-Version": "1" }
✅ GET /api/users
Headers: { "X-API-Version": "2" }🆔 @MdDaily
❤6🔥2👍1💅1
در لاراول یه هلپر مفید داریم با نام literal که بهمون این امکان رو میده با استفاده از آرگومان های نامگذاری شده، یک آبجکت php بسازیم.
مزایاش ؟؟
افزایش خوانایی کد .
ساده تر شدن نحوه مدیریتشون .( مخصوصا در شرایطی که تعداد آرگومان ها زیاده مدیریت برامون ساده تر میشه با استفاده از هلپر literal ).
به مثالش در تصویر دقت کنین تا بهتر براتون جابیفته.
#Laravel
#لاراول
#برنامه_نویسی_وب
#برنامه_نویسی
@GoldenCodeir
(به منبع و مثالش دقت کنید👇🏾)
https://x.com/OussamaMater/status/1800258725078274249?s=19
مزایاش ؟؟
افزایش خوانایی کد .
ساده تر شدن نحوه مدیریتشون .( مخصوصا در شرایطی که تعداد آرگومان ها زیاده مدیریت برامون ساده تر میشه با استفاده از هلپر literal ).
به مثالش در تصویر دقت کنین تا بهتر براتون جابیفته.
#Laravel
#لاراول
#برنامه_نویسی_وب
#برنامه_نویسی
@GoldenCodeir
(به منبع و مثالش دقت کنید👇🏾)
https://x.com/OussamaMater/status/1800258725078274249?s=19
X (formerly Twitter)
OussamaMater (@OussamaMater) on X
Laravel Tip💡: The "literal" Helper
Did you know that Laravel ships with a cool helper "literal" that allows you to create a PHP object using named arguments? 🚀
#laravel
Did you know that Laravel ships with a cool helper "literal" that allows you to create a PHP object using named arguments? 🚀
#laravel
👍9❤2💯2
Forwarded from Pishro App
نام متغیرها باید معنی دار و توصیف کننده داده هایی باشد که توی اون متغیر وجود داره.
اینکار باعث میشه خوانایی کد بالاتر و درک اون ساده تر بشه.
برای نمونه قطعه کد زیر رو ببینید:
// Bad Example
int x = 5;
// Good Example
int numberOfStudents = 5;
بصورت کلی همونطور که گفتم سعی کنید از اسم های خلاصه شده و نامفهوم در هیچ کجای کد استفاده نکنید
#clean_code
Please open Telegram to view this post
VIEW IN TELEGRAM
❤3👍1🔥1
در لاراول وقتی با کالکشن ها کار میکنیم اگر بخوایم اولین آیتمی که با شرط مورد نظرمون مطابقت داره رو بگیریم، میتونیم از متود ()sole استفاده کنیم.👌🏾
اگر هم بیشتر از یه آیتم با شرط مطابقت داشته باشه exception برمیگرده.
همچنین اگر هیچ آیتمی مطابق با شرط نباشه باز هم exception برمیگرده.
طرز کارش سادست،کافیه به تصویر دقت کنین ✔️
#Laravel
@GoldenCodeir
(به منبع و مثالش دقت کنید👇🏾)
https://x.com/OussamaMater/status/1800982923039912370?t=Xc2MWc7xLWTSTsRWfQWfDQ&s=35
اگر هم بیشتر از یه آیتم با شرط مطابقت داشته باشه exception برمیگرده.
همچنین اگر هیچ آیتمی مطابق با شرط نباشه باز هم exception برمیگرده.
طرز کارش سادست،کافیه به تصویر دقت کنین ✔️
#Laravel
@GoldenCodeir
(به منبع و مثالش دقت کنید👇🏾)
https://x.com/OussamaMater/status/1800982923039912370?t=Xc2MWc7xLWTSTsRWfQWfDQ&s=35
X (formerly Twitter)
OussamaMater (@OussamaMater) on X
Laravel Tip💡: The "sole" Method
When working with collections, whether regular or Eloquent, if you want to get the first item that matches the condition and ensure it is the only one, use the "sole" method 🚀
#laravel
When working with collections, whether regular or Eloquent, if you want to get the first item that matches the condition and ensure it is the only one, use the "sole" method 🚀
#laravel
👍5
Forwarded from یک برنامه نویس تنبل (Raymond Dev)
یه نکته مهم❗️
بازار کار کاملا سبکش عوض شده.حداقل در مورد فرانت اند این موضوع به وضوح دیده میشه.تو این شرایط،شرکت ها دنبال بهترین گزینه هستن.همین عامل باعث میشه خیلی از افراد ماه ها بیکار بمونن.حالا باید چه کرد؟
🔹خودتون محدود به فریم وورک نکنید.قراره شما فرانت اند دولوپر باشید. نه ری اکت دولوپر! نه انگولار دولوپر.
سعی کنید دامنه دانسته هاتون از ابزار ببرید تو لول مفاهیم که سرعت شیفت کردنتون بین ابزارها سریع تر بشه اگر واقعا میخواید تو این مارکت خراب موندگار باشید.
@TheRaymondDev
بازار کار کاملا سبکش عوض شده.حداقل در مورد فرانت اند این موضوع به وضوح دیده میشه.تو این شرایط،شرکت ها دنبال بهترین گزینه هستن.همین عامل باعث میشه خیلی از افراد ماه ها بیکار بمونن.حالا باید چه کرد؟
🔹خودتون محدود به فریم وورک نکنید.قراره شما فرانت اند دولوپر باشید. نه ری اکت دولوپر! نه انگولار دولوپر.
سعی کنید دامنه دانسته هاتون از ابزار ببرید تو لول مفاهیم که سرعت شیفت کردنتون بین ابزارها سریع تر بشه اگر واقعا میخواید تو این مارکت خراب موندگار باشید.
@TheRaymondDev
👍5❤1
Forwarded from Pishro App
is و isNot هست که می تونین از این دو متد برای مقایسه اشیاء مدل با همدیگه استفاده کنید.این دو متد بررسی میکنن که آیا دو شیء از یک مدل یکسان هستند یا خیر.
به عبارت دیگه، این متدها بررسی میکنند که آیا دو شیء مدل اشاره به همان رکورد در دیتابیس دارند یا خیر.
isاین متد بررسی میکنه که آیا دو مدل یکسان هستند یا نه.
$user1 = User::find(1);
$user2 = User::find(1);
if ($user1->is($user2)) {
echo "Both are the same user.";
}
تومثال بالا؛ چون هر دو شیء
$user1 و $user2 به همان رکورد در دیتابیس اشاره میکنن، شرط برقرار است و پیام "Both are the same user." چاپ میشه.isNotاین متد بررسی میکنه که آیا دو مدل متفاوت هستند یا نه.
$user1 = User::find(1);
$user2 = User::find(2);
if ($user1->isNot($user2)) {
echo "They are different users.";
}
توی مثال بالا هم، چون شیء
$user1 و $user2 به رکوردهای مختلفی در دیتابیس اشاره میکنن، شرط برقرار است و پیام "They are different users." چاپ میشه#laravel #نکته
Please open Telegram to view this post
VIEW IN TELEGRAM
❤7👍1
لازم نیست برای چند زبانه کردن سایت دنبال تکنیک و ترفند باشید!
"ترجمه گوگل" بهترین گزینه برای چند زبانه کردن سایت هستش که برای شما دوستان Golden Code ای کدهاشو نوشتم.
- پشتیبانی همه زبان ها
- سرعت بالای ترجمه
- ظاهری زیبا
- استفاده آسان
تنها با چند کپی پیست ازش استفاده کنید و لذت ببرید ❤️
https://github.com/mordadam/google-translate-html-js
"ترجمه گوگل" بهترین گزینه برای چند زبانه کردن سایت هستش که برای شما دوستان Golden Code ای کدهاشو نوشتم.
- پشتیبانی همه زبان ها
- سرعت بالای ترجمه
- ظاهری زیبا
- استفاده آسان
تنها با چند کپی پیست ازش استفاده کنید و لذت ببرید ❤️
https://github.com/mordadam/google-translate-html-js
GitHub
GitHub - mordadam/google-translate-html-js: Google translate (html, js) for all countries with flags, responsive, customization…
Google translate (html, js) for all countries with flags, responsive, customization, high translation speed - mordadam/google-translate-html-js
❤5👏3👍2
Forwarded from Pishro App
یکی از اصولی که میتونه به تمیز بودن کدِ شما کمک کنه نامگذاری توابع هست
شما باید نام توابع رو جوری انتخاب کنید که بیانگر کاری (فعل) که داره انجام میده باشه
به چند نمونه زیر دقت کنید:
#دریافت داده
def data(): #bad
def fetchData(): #good
#نمایش لیست
def listItems(): # bad
def displayItems(): # good
#clean_code
Please open Telegram to view this post
VIEW IN TELEGRAM
❤4👍1💯1
هنگام ساخت کاربر جدید در بیشتر مواقع برای رمز عبور از فسادِ Hash استفاده میکنیم اما روش دیگه ای هم لاراول در اختیارمون گذاشته .
میتونیم با کمک cast تعیین کنیم که attribute 'پسورد' بصورت هش شده ذخیره بشه. برای این کار کافیه از عبارت 'hashed' کمک بگیریم و نوع این attribute رو تعیین کنیم.
#laravel
#لاراول
@GoldenCodeir
(به منبع و مثالش دقت کنید👇🏾)
https://x.com/OussamaMater/status/1801356734063399150?s=35
میتونیم با کمک cast تعیین کنیم که attribute 'پسورد' بصورت هش شده ذخیره بشه. برای این کار کافیه از عبارت 'hashed' کمک بگیریم و نوع این attribute رو تعیین کنیم.
#laravel
#لاراول
@GoldenCodeir
(به منبع و مثالش دقت کنید👇🏾)
https://x.com/OussamaMater/status/1801356734063399150?s=35
X (formerly Twitter)
OussamaMater (@OussamaMater) on X
Laravel Tip💡: Hash Passwords Automatically
When creating users, we often use the Hash facade, but did you know that Laravel comes with a "hashed" cast that will automatically hash your user's password? 🚀
#laravel
When creating users, we often use the Hash facade, but did you know that Laravel comes with a "hashed" cast that will automatically hash your user's password? 🚀
#laravel
👍4❤2🔥1
Forwarded from کداکسپلور | CodeExplore (CodeExplore)
روانشناسی رنگ ها 👀
میدونین که رنگ ها و تم ها چقدر توی طراحی نرم افزار و سایت ها مهمن ، این عکس کمکتون میکنه با توجه به نرم افزار رنگ های مناسبی انتخاب کنید😂
#color #theme
☕️ @CodeExplore
میدونین که رنگ ها و تم ها چقدر توی طراحی نرم افزار و سایت ها مهمن ، این عکس کمکتون میکنه با توجه به نرم افزار رنگ های مناسبی انتخاب کنید
#color #theme
Please open Telegram to view this post
VIEW IN TELEGRAM
❤3👍3
گاهی وقتا ممکنه کاربر بخواد از همه سیستم هایی که باهاشون وارد شده خارج شه ،بجز دستگاه فعلیش.
متود ()logoutOtherDevices بهمون اجازه میده تا همه session های کاربر روی دستگاه های دیگه رو غیرفعال کنیم و فقط session فعلی باقی بمونه.
طرز کارش هم اینجوریه که پسورد فعلیش رو باید به عنوان پارامتر پاس بدیم به این متود تا اعتبار سنجی انجام بشه.🪴
#laravel
#لاراول
@GoldenCodeir
(به منبع و مثالش توجه کنید👇🏾)
https://x.com/OussamaMater/status/1803533220362985736?s=19
متود ()logoutOtherDevices بهمون اجازه میده تا همه session های کاربر روی دستگاه های دیگه رو غیرفعال کنیم و فقط session فعلی باقی بمونه.
طرز کارش هم اینجوریه که پسورد فعلیش رو باید به عنوان پارامتر پاس بدیم به این متود تا اعتبار سنجی انجام بشه.🪴
#laravel
#لاراول
@GoldenCodeir
(به منبع و مثالش توجه کنید👇🏾)
https://x.com/OussamaMater/status/1803533220362985736?s=19
X (formerly Twitter)
OussamaMater (@OussamaMater) on X
Laravel Tip 💡: Log Out Other Devices
When users log out, you might want to ask them if they want to log out from other devices while keeping the current one. Luckily, Laravel ships with the "logoutOtherDevices" method that does exactly that. 🚀
#laravel
When users log out, you might want to ask them if they want to log out from other devices while keeping the current one. Luckily, Laravel ships with the "logoutOtherDevices" method that does exactly that. 🚀
#laravel
❤3👍2💯2