PHP-CS-Fixer

1. पीएचपी-सीएस-फिक्‍सर: शुरुआती के लिए एक संपूर्ण गाइड

पीएचपी-सीएस-फिक्‍सर एक उपकरण है जो आपके पीएचपी कोड को एक समान कोडिंग स्‍टाइल के अनुसार स्वचालित रूप से ठीक करता है। यह आपके कोड की पठनीयता और रखरखाव को बेहतर बनाने में मदद करता है, और टीम के सदस्यों के बीच सहयोग को आसान बनाता है। यह लेख आपको पीएचपी-सीएस-फिक्‍सर के मूल सिद्धांतों, इसकी स्थापना, उपयोग और कॉन्‍फ़िगरेशन के बारे में बताएगा।

पीएचपी-सीएस-फिक्‍सर क्‍या है?

पीएचपी-सीएस-फिक्‍सर एक स्‍वचालित कोड सुधार उपकरण है जो पीएचपी कोड को एक पूर्वनिर्धारित कोडिंग स्‍टाइल के अनुसार ठीक करता है। यह कई अलग-अलग कोडिंग स्‍टाइल नियमों का समर्थन करता है, जिनमें PSR-2, PSR-12, और Symfony स्‍टील्‍स शामिल हैं।

यह उपकरण विशेष रूप से उपयोगी है जब आप एक टीम में काम कर रहे हों, क्‍योंकि यह सुनिश्चित करता है कि सभी डेवलपर एक ही कोडिंग स्‍टाइल का पालन कर रहे हैं। यह आपके कोड की गुणवत्ता को भी बढ़ाता है, जिससे इसे समझना और बनाए रखना आसान हो जाता है।

पीएचपी-सीएस-फिक्‍सर का उपयोग करने के लाभ

पीएचपी-सीएस-फिक्‍सर का उपयोग करने के कई लाभ हैं:

कोड की पठनीयता में सुधार: एक समान कोडिंग स्‍टाइल का उपयोग करने से आपके कोड को पढ़ना और समझना आसान हो जाता है।
बढ़े हुए रखरखाव: जब आपका कोड सुसंगत रूप से स्‍टाइल किया जाता है, तो इसे बनाए रखना और डिबग करना आसान होता है।
बेहतर टीम सहयोग: जब सभी डेवलपर एक ही कोडिंग स्‍टाइल का पालन करते हैं, तो टीमवर्क अधिक कुशल हो जाता है।
स्वचालित सुधार: पीएचपी-सीएस-फिक्‍सर स्वचालित रूप से आपके कोड में कोडिंग स्‍टाइल के मुद्दों को ठीक कर सकता है, जिससे आपका समय और प्रयास बचता है।
मानक अनुपालन: पीएचपी-सीएस-फिक्‍सर आपको कोडिंग मानक का पालन करने में मदद कर सकता है, जैसे कि PSR-2 और PSR-12।

पीएचपी-सीएस-फिक्‍सर की स्थापना

पीएचपी-सीएस-फिक्‍सर को स्थापित करने के कई तरीके हैं:

Composer के माध्यम से: यह सबसे अनुशंसित तरीका है। अपने प्रोजेक्ट रूट में टर्मिनल खोलें और निम्न कमांड चलाएं:

   ```bash
   composer require friendsofphp/php-cs-fixer
   ```

Phar फ़ाइल का उपयोग करके: आप पीएचपी-सीएस-फिक्‍सर की एक Phar फ़ाइल डाउनलोड कर सकते हैं और इसे सीधे चला सकते हैं। आप इसे यहां से डाउनलोड कर सकते हैं: [1](https://github.com/FriendsOfPHP/PHP-CS-Fixer/releases)

   डाउनलोड करने के बाद, फ़ाइल को निष्पादन योग्य बनाएं:

   ```bash
   chmod +x php-cs-fixer.phar
   ```

पीएचपी-सीएस-फिक्‍सर का उपयोग

एक बार जब आप पीएचपी-सीएस-फिक्‍सर स्थापित कर लेते हैं, तो आप इसका उपयोग अपने कोड को ठीक करने के लिए कर सकते हैं।

एक विशिष्ट फ़ाइल को ठीक करना:

   ```bash
   php-cs-fixer fix filename.php
   ```

एक निर्देशिका में सभी फ़ाइलों को ठीक करना:

   ```bash
   php-cs-fixer fix ./directory
   ```

एक निर्देशिका में सभी फ़ाइलों को ठीक करना और डिफ़रेंस दिखाना:

   ```bash
   php-cs-fixer fix --diff ./directory
   ```

एक निर्देशिका में सभी फ़ाइलों को ठीक करना और उन्हें बदलना:

   ```bash
   php-cs-fixer fix --dry-run ./directory
   ```

पीएचपी-सीएस-फिक्‍सर का कॉन्‍फ़िगरेशन

पीएचपी-सीएस-फिक्‍सर को कॉन्‍फ़िगर करने के लिए, आपको एक `.php-cs-fixer.php` फ़ाइल बनानी होगी। इस फ़ाइल में, आप उन नियमों को निर्दिष्ट कर सकते हैं जिनका उपयोग पीएचपी-सीएस-फिक्‍सर को आपके कोड को ठीक करने के लिए करना चाहिए।

यहां एक उदाहरण `.php-cs-fixer.php` फ़ाइल है:

```php <?php

use PhpCsFixer\Config; use PhpCsFixer\Fixer\ControlStructure\BracesPositionFixer; use PhpCsFixer\Fixer\Whitespace\ArrayIndentationFixer;

return (new Config)

   ->setRules([
       '@PSR2' => true,
       'braces_position' => ['position' => 'same_line'],
       'array_indentation' => 'tab',
   ])
   ->setRisky(true)
   ->setUsingCache(true);

```

इस उदाहरण में, हम PSR-2 कोडिंग स्‍टाइल का उपयोग करने के लिए पीएचपी-सीएस-फिक्‍सर को कॉन्‍फ़िगर कर रहे हैं। हम `braces_position` और `array_indentation` नियमों को भी कॉन्‍फ़िगर कर रहे हैं।

पीएचपी-सीएस-फिक्‍सर के नियम

पीएचपी-सीएस-फिक्‍सर कई अलग-अलग नियम प्रदान करता है जिनका उपयोग आप अपने कोड को ठीक करने के लिए कर सकते हैं। यहां कुछ सबसे सामान्य नियम दिए गए हैं:

`@PSR2`: PSR-2 कोडिंग स्‍टाइल के सभी नियमों को लागू करता है।
`@PSR12`: PSR-12 कोडिंग स्‍टाइल के सभी नियमों को लागू करता है।
`array_indentation`: सरणियों के इंडेंटेशन को नियंत्रित करता है।
`braces_position`: ब्रेसेस की स्थिति को नियंत्रित करता है।
`declare_strict_types`: `declare(strict_types=1)` का उपयोग करने के लिए मजबूर करता है।
`no_trailing_whitespace`: लाइनों के अंत में ट्रेलिंग वाइटस्पेस को हटाता है।
`single_quote`: डबल कोट्स के बजाय सिंगल कोट्स का उपयोग करने के लिए मजबूर करता है।
`trailing_comma_in_multiline_array`: बहु-पंक्ति सरणियों में ट्रेलिंग अल्पविराम जोड़ता है।

आप पीएचपी-सीएस-फिक्‍सर की आधिकारिक वेबसाइट पर सभी उपलब्ध नियमों की सूची पा सकते हैं: [2](https://cs.laracasts.com/php-cs-fixer/rules/)

पीएचपी-सीएस-फिक्‍सर के साथ एकीकरण

पीएचपी-सीएस-फिक्‍सर को कई अलग-अलग विकास उपकरणों के साथ एकीकृत किया जा सकता है, जिनमें शामिल हैं:

IDE: कई IDE, जैसे PhpStorm, पीएचपी-सीएस-फिक्‍सर के साथ एकीकृत करने के लिए प्लगइन प्रदान करते हैं।
कमांड लाइन: आप पीएचपी-सीएस-फिक्‍सर को कमांड लाइन से सीधे चला सकते हैं।
Git हुक: आप पीएचपी-सीएस-फिक्‍सर को Git हुक के रूप में कॉन्‍फ़िगर कर सकते हैं ताकि यह सुनिश्चित हो सके कि सभी कमिट किए गए कोड कोडिंग स्‍टाइल के अनुसार ठीक किया गया है।
CI/CD पाइपलाइन: आप पीएचपी-सीएस-फिक्‍सर को अपनी CI/CD पाइपलाइन में एकीकृत कर सकते हैं ताकि यह सुनिश्चित हो सके कि आपका कोड हमेशा एक समान कोडिंग स्‍टाइल का पालन करता है।

उन्नत कॉन्‍फ़िगरेशन

पीएचपी-सीएस-फिक्‍सर आपको अपने कॉन्‍फ़िगरेशन को और अधिक अनुकूलित करने के लिए कई उन्नत विकल्प प्रदान करता है।

विशिष्ट फ़ाइलों या निर्देशिकाओं को छोड़कर: आप अपनी `.php-cs-fixer.php` फ़ाइल में `exclude` विकल्प का उपयोग करके विशिष्ट फ़ाइलों या निर्देशिकाओं को ठीक करने से बाहर कर सकते हैं।

   ```php
   return (new Config)
       ->setRules([
           '@PSR2' => true,
       ])
       ->setExcluded([
           'vendor',
           'node_modules',
       ]);
   ```

नियमों को अनुकूलित करना: आप अपनी `.php-cs-fixer.php` फ़ाइल में नियमों के लिए विशिष्ट पैरामीटर सेट करके नियमों को अनुकूलित कर सकते हैं।

   ```php
   return (new Config)
       ->setRules([
           'array_indentation' => ['indentation' => 'space'],
       ]);
   ```

फिक्‍सरों के साथ प्रयोग: आप अपनी `.php-cs-fixer.php` फ़ाइल में `fixers` विकल्प का उपयोग करके विशिष्ट फिक्‍सरों को सक्षम या अक्षम कर सकते हैं।

   ```php
   return (new Config)
       ->setFixers([
           '-strict_comparison',
           'declare_strict_types',
       ]);
   ```

डिबगिंग और समस्या निवारण

कभी-कभी, पीएचपी-सीएस-फिक्‍सर आपके कोड को ठीक करते समय त्रुटियाँ या अप्रत्याशित व्यवहार उत्पन्न कर सकता है। यहां कुछ सामान्य डिबगिंग और समस्या निवारण युक्तियाँ दी गई हैं:

त्रुटि संदेशों को ध्यान से पढ़ें: त्रुटि संदेश आपको समस्या के बारे में बहुमूल्य जानकारी प्रदान कर सकते हैं।
`--dry-run` विकल्प का उपयोग करें: यह विकल्प आपको पीएचपी-सीएस-फिक्‍सर को आपके कोड में परिवर्तन करने से पहले यह देखने की अनुमति देता है कि यह क्या करेगा।
`--diff` विकल्प का उपयोग करें: यह विकल्प आपको यह देखने की अनुमति देता है कि पीएचपी-सीएस-फिक्‍सर ने आपके कोड में क्या परिवर्तन किए हैं।
अपने कॉन्‍फ़िगरेशन को मान्य करें: सुनिश्चित करें कि आपकी `.php-cs-fixer.php` फ़ाइल सही ढंग से कॉन्‍फ़िगर की गई है।
पीएचपी-सीएस-फिक्‍सर के नवीनतम संस्करण का उपयोग करें: नवीनतम संस्करण में बग फिक्स और प्रदर्शन सुधार शामिल हो सकते हैं।
समुदाय से मदद लें: यदि आप अभी भी समस्याओं का सामना कर रहे हैं, तो पीएचपी-सीएस-फिक्‍सर समुदाय से मदद लें।

निष्कर्ष

पीएचपी-सीएस-फिक्‍सर एक शक्तिशाली उपकरण है जो आपके पीएचपी कोड को एक समान कोडिंग स्‍टाइल के अनुसार स्वचालित रूप से ठीक करने में आपकी मदद कर सकता है। यह आपके कोड की पठनीयता और रखरखाव को बेहतर बनाने में मदद करता है, और टीम के सदस्यों के बीच सहयोग को आसान बनाता है। इस लेख में, हमने आपको पीएचपी-सीएस-फिक्‍सर के मूल सिद्धांतों, इसकी स्थापना, उपयोग और कॉन्‍फ़िगरेशन के बारे में बताया है।

यह उपकरण सॉफ्टवेयर विकास प्रक्रिया का एक महत्वपूर्ण हिस्सा बन सकता है, खासकर जब एजाइल विकास जैसी कार्यप्रणाली का पालन किया जा रहा हो। यह सुनिश्चित करता है कि कोडबेस लगातार साफ और संगत रहे।

यह लेख आपको पीएचपी-सीएस-फिक्‍सर का उपयोग शुरू करने के लिए आवश्यक सभी जानकारी प्रदान करता है।

PSR-0 PSR-1 PSR-3 PSR-4 Symfony कोडिंग स्‍टाइल PHP कोडिंग मानक Composer Git CI/CD PhpStorm कोड गुणवत्ता कोड समीक्षा स्वचालित परीक्षण सॉफ्टवेयर वास्तुकला डिजाइन पैटर्न तकनीकी ऋण सॉफ्टवेयर रखरखाव टीम सहयोग संस्करण नियंत्रण कोड रिफैक्टरिंग

अभी ट्रेडिंग शुरू करें

IQ Option पर रजिस्टर करें (न्यूनतम जमा $10) Pocket Option में खाता खोलें (न्यूनतम जमा $5)

हमारे समुदाय में शामिल हों

हमारे Telegram चैनल @strategybin से जुड़ें और प्राप्त करें: ✓ दैनिक ट्रेडिंग सिग्नल ✓ विशेष रणनीति विश्लेषण ✓ बाजार की प्रवृत्ति पर अलर्ट ✓ शुरुआती के लिए शिक्षण सामग्री