Golden Code – Telegram
Golden Code
737 subscribers
53 photos
248 links
نکات laravel, php و...
Download Telegram
"گاهی ممکنه نیاز بشه عددی طولانی به کاربر نمایش بدیم ، درین شرایط خواندن عدد واسه کاربر کمی دشوار میشه.
برای نمایش دادن بهتر برخی اعداد به کاربر، میتونیم از هلپری بانام Number استفاده کنیم.✔️

مثال شماره ۱:
عدد ۱۰۰۰ رو دادیم به هلپر، خروجی: 1thousand

در مثال ۲ هم عدد رو رُند کرده برامون.

مثال شماره ۳(تصویر):
اینجا که عدد 12340000 رو داریم،برای نمایش بهتر به کاربر میتونیم ازین هلپر استفاده کنیم.
حالا خروجیش چی میشه؟ 1.23million
چرا؟ چون بر اساس دو رقم اعشار تعیین شده."

@GoldenCodeir
#Laravel
#لاراول
(به منبع و مثال دقت کنید👇🏾)
https://x.com/OussamaMater/status/1797365006935248910?s=19
👍51💯1
Forwarded from Pishro App
نوشتن کد مانند ایراد سخنرانی است. اگر از کلمات بزرگ زیادی استفاده کنید، مخاطبان خود را گیج می‌کنید. اگر هر کلمه را تعریف کنید، مخاطبان خود را به خواب می‌برید.

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

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


#clean_code

👾 @pishroapp
Please open Telegram to view this post
VIEW IN TELEGRAM
👍61🔥1
Forwarded from Md Daily
چند Best Practice در طراحی REST API

امروزه که همه چی به هم وصله، 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
👍92💯2
Forwarded from Pishro App
💡یکی از نکاتی که باعث میشه کد شما تمیزتر و بهتر باشه استفاده از نام درست و صحیح برای متغییرها، کلاس ها، توابع و... هست


نام متغیرها باید معنی دار و توصیف کننده داده هایی باشد که توی اون متغیر وجود داره.

اینکار باعث میشه خوانایی کد بالاتر و درک اون ساده تر بشه.

برای نمونه قطعه کد زیر رو ببینید:


// Bad Example
int x = 5;

// Good Example
int numberOfStudents = 5;




بصورت کلی همونطور که گفتم سعی کنید از اسم های خلاصه شده و نامفهوم در هیچ کجای کد استفاده نکنید🍷

#clean_code


👾 @pishroapp
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
👍5
Forwarded from یک برنامه نویس تنبل (Raymond Dev)
یه نکته مهم❗️

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

🔹خودتون محدود به فریم وورک نکنید.قراره شما فرانت اند دولوپر باشید. نه ری اکت دولوپر! نه انگولار دولوپر.
سعی کنید دامنه دانسته هاتون از ابزار ببرید تو لول مفاهیم که سرعت شیفت کردنتون بین ابزارها سریع تر بشه اگر واقعا میخواید تو این مارکت خراب موندگار باشید.

@TheRaymondDev
👍51
Forwarded from Pishro App
🔥 توی Eloquent لاراول، دوتا متد 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 #نکته


👾 @pishroapp
Please open Telegram to view this post
VIEW IN TELEGRAM
7👍1
لازم نیست برای چند زبانه کردن سایت دنبال تکنیک و ترفند باشید!

"ترجمه گوگل" بهترین گزینه برای چند زبانه کردن سایت هستش که برای شما دوستان Golden Code ای کدهاشو نوشتم.

- پشتیبانی همه زبان ها
- سرعت بالای ترجمه
- ظاهری زیبا
- استفاده آسان

تنها با چند کپی پیست ازش استفاده کنید و لذت ببرید ❤️

https://github.com/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

👾 @pishroapp
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
👍42🔥1
Forwarded from کداکسپلور | CodeExplore (CodeExplore)
روانشناسی رنگ ها 👀

میدونین که رنگ ها و تم ها چقدر توی طراحی نرم افزار و سایت ها مهمن ، این عکس کمکتون میکنه با توجه به نرم افزار رنگ های مناسبی انتخاب کنید😂

#color #theme
☕️ @CodeExplore
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
3👍2💯2
Forwarded from CleverDevs (Mammad)
-اصل Use Pronounceable Names در کلین کد

این اصل میگه که شما باید اسم هایی که برای متغیر هاتون انتخاب میکنید قابل تلفظ باشه اگه نتونید تلفظش کنید نمیتونید در بارش بحث کنید بدون این که صدای احمقانه در بیارید این مهمه چون برنامه نویسی یه فعالیت اجتماعیه

ما برنامه نویسا باید اسم هارو جوری انتخاب کنیم که وقتی در بارش توضیح میدیم راحت باشیم مثلا این دوتا کد رو ببینید اولی اسم های غیر قابل تلفظ داره و دومی اسم های درست درمون

کد زیر :

class DtaRcd102 {
private Date genymdhms;
private Date modymdhms;
private final String pszqint = "102";
};


میتونه با متغیر های بهتر زیر نوشته باشه :

class Customer {
private Date generationTimestamp;
private Date modificationTimestamp;
private final String recordId = "102";
};



حالا وقتی میخوایم به رفیقمون بگیم بیا یه نگاه به این کد بنداز دیگه راحت تلفظ میکنیم و صدای احمقانه در نمیاریم


#CleanCode
@CleverDevs
@CleverDevsGp
4👍3🔥2
Forwarded from Pishro App
توی #لاراول 11.11 دو متد جدید به کالکشن ها اضافه شده که شما میتونید با استفاده از این دو متد before و after مقادیر قبل و بعد یک مقدار رو دریافت کنید.
این دو متد بر روی نمونه های  Collection و LazyCollection  جواب میدن  و اگر هم قبل یا بعد از اون کلید انتخاب شده، مقداری وجود نداشته باشه، null برمیگیرده.

#laravel


👾 @pishroapp
Please open Telegram to view this post
VIEW IN TELEGRAM
👍81🔥1
از نسخه ۹ به بعد لاراول، میتونیم برای انجام عملیات ریدایرکت کاربر به مسیر مدنظر، بجای ()redirect()->route از هلپر ()to_route استفاده کنیم .

استفاده ازین هلپر باعث کوتاه تر شدن و تمیز تر شدن کدمون خواهد شد. ✔️
#لاراول
#Laravel
@GoldenCodeir
(به منبع و مثالش دقت کنید👇🏾)
https://x.com/PovilasKorop/status/1805175287686078690?s=19
3👍2🔥1
Forwarded from یک برنامه نویس تنبل (Raymond Dev)
🔶 تفاوت متد boot و register توی Provider ها چیست؟

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

اما به محض اینکه متد register همه‌ی پرووایدرها پردازش شد، متد boot همه پرووایدرها توسط فریم‌ورک شروع به پردازش شدن می‌کنه. این رو می‌تونین با یک echo ساده بررسی‌ کنین. پس توی متد boot ما مطمئن هستیم که همه‌ی پرووایدرها رجیستر شدن. پس کارهایی غیر از bind کردن مثل استفاده از یک پرووایدر دیگه، اضافه کردن فایل‌های Route، ثبت کردن Event/Listerner ها و ... رو توی متد boot می‌نویسیم.

</ Farshad Rajabzade >

#لاراول

@TheRaymondDev
5👍2
Forwarded from کداکسپلور | CodeExplore (Koorosh)
تگ <time> در HTML 🖐

☄️این تگ برای اینه که وقتی داریم توی سایتمون یه تاریخ یا زمان رو نشون میدیم، مرورگر و موتورهای جستجو دقیقاً بفهمن که داریم راجع به چی صحبت می‌کنیم. مثلا، اگه یه مقاله نوشتیم و می‌خوایم تاریخ انتشارش رو نشون بدیم، یا می‌خوایم بگیم یه رویداد کی برگزار میشه، از این تگ استفاده می‌کنیم.

مثال: فرض کنیم میخوایم تاریخ یه رویدادی رو بنویسیم...
<p>آغاز رویداد: <time datetime="2024-06-27T10:00:00">27 ژوئن 2024، ساعت 10:00</time></p>


◀️اینجا داریم به مرورگر می‌گیم که این "27 ژوئن 2024، ساعت 10:00" یه تاریخ و زمان خاصه. این خیلی کمک می‌کنه که مرورگر بفهمه این یه زمان مهمه و موتورهای جستجو هم راحت‌تر می‌تونن این اطلاعات رو پیدا کنن.


کجاها می‌تونیم ازش استفاده کنیم؟

1⃣وقتی توی سایت بلاگ می‌نویسیم و می‌خوایم تاریخ انتشار مقاله‌هامون رو نشون بدیم.

🔢 اگه سایتی داریم که رویدادها رو معرفی می‌کنه و می‌خوایم زمان شروع و پایان رویدادها رو بنویسیم.

🔢یا حتی وقتی یه تایم‌لاین داریم و می‌خوایم بگیم هر اتفاقی کی افتاده.

#html #time
☕️ @CodeExplore
Please open Telegram to view this post
VIEW IN TELEGRAM
3👍3🔥1
"در لاراول جهت مرتب سازی مدل بر اساس تاریخ، اغلب از متود ()orderBy استفاده میشه.

اما فریمورک لاراول با ارائه دو متود ()latest و ()oldest این فرایند رو برای ما خوانا تر و کوتاه تر کرده.👌🏾

(به مثال سه توجه کنین،تفاوته فرایند مرتب سازی با این دو متود نسبت به orderBy کاملن شفافه).

نکته: مرتب سازی بطور پیشفرض ستون create_at هست که قابل تغییره"
#Laravel
@GoldenCodeir
(به منبع و مثالش دقت کنید👇🏾)
https://x.com/OussamaMater/status/1804611139516453170?s=35
🔥32👍2
Forwarded from CleverDevs (Mammad)
-اصل Avoid Encoding در کلین کد


این اصل میگه که ما به حد کافی رمزگذاری برای اسامی داریم که دیگه نخوایم رمزگذاری های بیشتری اضافه کنیم تا مسئولیتمون رو سخت تر کنیم
رمز گذاری کردن اطلاعات تایپ و اسکوپ ها توی اسامی به راحتی کار مارو سخت میکنه

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

اسم هایی که رمزگذاری شدن به ندرت قابل تلفظ هستن و این خودش اصل قبلی رو نقض میکنه


#CleanCode
@CleverDevs
@CleverDevsGp
👍6
اره php مرده، دوبار
https://w3techs.com/technologies/overview/programming_language


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

@DevTwitter
👍95😁2🤨1