စံသတ်မှတ်ထားသော PHP function ကိုရေးဆွဲရန်မည်သို့ရေးရမည်နည်း။

နိဒါန်း

PHP လုပ်ဆောင်ချက်များအတွက်ရှင်းရှင်းလင်းလင်းနှင့်ပြည့်စုံသောစာရွက်စာတမ်းများကိုရေးသားခြင်းသည် Modular, ထိန်းသိမ်းနိုင်သောနှင့်အဖွဲ့အခြေပြုကုဒ်အတွက်မရှိမဖြစ်လိုအပ်သည်။ စံသတ်မှတ်ချက်ဆိုင်ရာစာရွက်စာတမ်းများအရမှတ်တမ်းများအရစာရွက်စာတမ်းများသည်စာရွက်စာတမ်းများကိုတသမတ်တည်းနှင့်နားလည်ရန်လွယ်ကူစေသည်။

သတ်မှတ်ချက်များအမည်

function name အမည်များသည်စာလုံးအသေးများနှင့်စတင်ပြီး underscores နှင့်သီးခြားစကားလုံးများဖြင့်စတင်သင့်သည် (ဥပမာ - My_Function) ။ တစ်ချိန်တည်းမှာပင် PSR-2 Naming Convanting Convantation, Class နှင့် Method Name အမည်များသည် Camel Nomenclature ကိုအသုံးပြုသင့်သည် (ဥပမာ - MyFUNCE) ။

@param tags များ

function parameter ၏အမျိုးအစားနှင့်ဖော်ပြချက်ကိုဖော်ပြရန် @param tag ကိုသုံးပါ။

ဥပမာ -

/ **
 * @param string ကို $ username * @param string $ password စကားဝှက် * /
function login (string $ name, string $ password) {}

@return tag

function ၏ return value အမျိုးအစားနှင့်ဖော်ပြချက်ကိုဖော်ပြရန် @return tag ကိုသုံးပါ။

ဥပမာ -

/ **
 * @return bool login အောင်မြင်သည် * /
login function login (string $ name, string $ စကားဝှက်): Bool {}

@throws tags

@throws tag ကိုသုံးပါ။

ဥပမာ -

/ **
 * @throws $ အမည်သို့မဟုတ် $ $ စကားဝှက်သည်ဗလာဖြစ်သည်ဆိုလျှင်လွဲနယ်တုမရှိဖြာလွဲခြင်း *
login function login (string $ name, string $ စကားဝှက်): Bool {}

မှတ်ချက်ပြပါပိတ်ပင်တားဆီးမှုဥပမာ

PSR-5 ANTENTATE Block Standard နှင့်ကိုက်ညီသော function onnotation ၏ဥပမာ -

/ **
 * ဝင်ရောက်ရန်အသုံးပြုသူ * @param string ကို $ username * @param string $ @param string ကို $ @haram Bool * @return Bool * @return Bool * @rramulal @ $ အမည်သို့မဟုတ် $ စကားဝှက်သည်ဗလာဖြစ်သည်။
login function login (string $ name, string $ စကားဝှက်): Bool {}

လက်တွေ့ကိစ္စများ

parameter function မရှိပါ

ဥပမာ - လက်ရှိအခြေအနေကိုရယူပါ။

/ **
 * လက်ရှိအချိန်ကိုရယူပါ * @return string လက်ရှိအချိန် string ကို * /
function ကို get_current_time () trans {
    ပြန်လာသည့်နေ့ ('YMD H: i: S: S');
}

Multi- parameter သည် function ကို

ဥပမာ - နံပါတ်နှစ်ခု၏ပေါင်းလဒ်ကိုတွက်ချက်ပါ။

/ **
 * @param INT $ @param int $ @param in int $ @return int နှင့် @return int နှင့် *
function sum (int $ a, int $ ခ): int {
    $ a + $ b ကိုပြန်သွားပါ။
}

မှတ်သားရန်အရာ

• အမြဲတမ်းစံသတ်မှတ်ထားသောမှတ်စုစည်းဝေးကြီးများကိုလိုက်နာပါ။
• တိကျသောဖော်ပြချက်များကိုရေးပါ။
• ဖြစ်နိုင်ချေရှိသော parameters များ, ပြန်လည်ထူထောင်ရေးတန်ဖိုးများနှင့်ခြွင်းချက်များကိုသေချာစေရန်သေချာပါစေ။
• ကုဒ်နံပါတ်ပြောင်းလဲမှုကိုထင်ဟပ်စေရန်အခါသမယစာရွက်စာတမ်းများကိုအခါအားလျော်စွာ update လုပ်ပါ။