यह लेख लिखने और PHP कोड लिखने के लिए एक दृष्टिकोण पर चर्चा करता है। मौजूदा कंपनी के दृष्टिकोण और व्यक्तिगत अनुभव का विश्लेषण करके निम्नलिखित बिंदुओं का गठन किया गया था।

फ़ाइलों और फ़ोल्डरों के नामकरण के नियम

फ़ोल्डर्स और फ़ाइलों के लिए सभी नाम सार्थक और बोलने वाले होने चाहिए (अतिरिक्त स्पष्टीकरण की आवश्यकता नहीं)।

फ़ोल्डर

सभी फ़ोल्डरों को -माइनस साइन का उपयोग करके शब्द पृथक्करण के साथ लोअरकेस नाम दिया गया है ।

यदि फ़ोल्डर में ऐसी कक्षाएं हैं जो नेमस्पेस (नेमस्पेस) से संबंधित हैं, तो फ़ोल्डर का नाम नेमस्पेस नामस्थान (नेमस्पेस) के अनुसार रखा गया है।

नामकरण फ़ोल्डर के लिए अनुमत वर्ण: लैटिन अक्षर और एक -ऋण चिह्न।

फ़ाइलें

परियोजना से संबंधित सभी फाइलों को प्रतीक -(माइनस) का उपयोग करके शब्द जुदाई के साथ निचले मामले में नामित किया गया है ।

यदि फ़ाइल एक वर्ग फ़ाइल है, तो इसे वर्ग नाम के अनुसार नाम दिया गया है।

नामस्थानों, वर्गों, विधियों और चर के लिए नामकरण परंपराएं

सभी नाम सार्थक और बोलने वाले होने चाहिए (अतिरिक्त स्पष्टीकरण की आवश्यकता नहीं)।

नेमस्पेस

. , .

PascalCase. PascalCase .

Trait. Interface. Abstract.

camelCase. camelCase , .

:

2. , ,
   (isPostRequest, getRequestType, parseSchemaElement, renderPageWithSetupsAndTeardowns)
5. boolean is, has can

camelCase. camelCase , .

UPPER_CASE_SNAKE_CASE. UPPER_CASE_SNAKE_CASE , .

:

1. 
   

2. , ,

   
   

3. 
   

4. . Map ($typesMap, $statesMap), .. .

   
   

5. , (unpaidProject)

   
   

6. , , (userIsAdmin, messageIsSend, figureCanBePainted, projectName)

   
   

7. , ,

   
   

   :

   
   

   $object->expire_at
   $object->setExpireAt($date);
   $object->getExpireAt();

   
   

   :

   
   

   $object->expiration_date;
   $object->setExpirationDate($date);
   $object->getExpirationDate();

   
   

8. boolean is, has can

   
   

9. 
   

   :

   
   

   if ($project->isInvalid()) {
       // ...
   }
   if ($project->isNotValid()) {
       // ...
   }
   if ($accessManager->isAccessDenied()) {
       // ...
   }

   
   

   :

   
   

   if (!$project->isValid()) {
       // ...
   }
   if (!$accessManager->isAccessAllowed()) {
       // ...
   }
   if ($accessManager->canAccess()) {
       // ...
   }

   
   

10. ( 8 ), : , ), (userHasRoleAdmin, statusIsActive)

    
    

(namespace), ( ). (use).
{...}. .

.

:

1. .
3. / — .

.

, .

.

.

class InterfaceType {

    private $property = 'myProp';

    public function getProperty():string {
        return $this->property;
    }    
}

(return) , .

, () .

:

 if (IS_REGISTRATOR() && (($params.status === 'W' || $params.status === 'D' || $params.status === 'A') && $params.remark && (($params.subres_level == 0 && ($user_info->selected_title->tid == $params.boss || $user_info->selected_title->tid == $doc_signer_tid || !$params.usertid) || $params.subres_level > 0 && $user_info->selected_title->tid == $params.usertid))) { ... }

:

$docIsInWorkAcceptOrDraft = ...;
$bossHasSignerPriviledge = ...;
$userCanSign = ...;

if ($docIsInWorkAcceptOrDraft && $bossHasSignerPriviledge && $userCanSign) {
  // ...
}

( ""). , , .

, PHPDoc. - .

//, /*...*/.

, , .

, , declare(strict_types=1);

/ null. 0 .

function sendEmail(string $title, string $message = null, string $date = null): void {
    // ...
}

//    
$object->sendEmail('Title', null, '2017-01-01');

//    
$object->sendEmail('Title', '', '2017-01-01');

, ( — ).

. array_key_exists, isset. . .

. , :

3. . \n, \r, \t ..

, (: type). PHPDoc. , c check validate, .

private. , protected. , public.

null, Null object, , (: ).

json — return true, return ['success' => ['message' => '.....']] ['error' => ['message' => '.....']]. message , .

.

. . , .

boolean . boolean (===), .

:

if ($user) {
    // ...
}
if ($request->postData('amount') == 100) {
    // ...
}
if (!$request->postData('amount')) {
    // ...
}

:

if ($user === null) { // $user   object
    // ...
}
if ((int)$request->postData('amount') === 100) {
    // ...
}
if ($booking->comment === '') {
    // ...
} 

एक ही समय में सशर्त अभिव्यक्ति में AND और OR ऑपरेटर का उपयोग करते समय, कोष्ठकों को प्राथमिकता देना आवश्यक है।