PHP में ओपन सोर्स योगदान: कैसे शुरू करें योगदान देना और पागल न हों

ओपन सोर्स डरावना क्यों नहीं है, बल्कि फायदेमंद है?

क्या आपने कभी किसी बड़े PHP प्रोजेक्ट के रिपॉजिटरी को देखा और सोचा: "वहाँ सिर्फ गुरु हैं, मैं तो वहाँ झाँकने से भी डरता हूँ"? परिचित सी भावना है। लेकिन सच्चाई यह है कि ओपन सोर्स योगदान 20 साल के अनुभव वाले सुपरहीरो के बारे में नहीं है। यह सामान्य डेवलपर्स के बारे में है जिन्होंने एक दिन तय किया: "क्यों नहीं?"

आइए समझते हैं कि आपको इसकी आवश्यकता क्यों है। पहला, PHP में योगदान देना कौशल बढ़ाने का सबसे अच्छा तरीका है। आप दूसरों का कोड पढ़ेंगे, आर्किटेक्चर समझेंगे, और ऐसा कोड लिखना सीखेंगे जिसे कोड-रिव्यू में अस्वीकार न किया जाए। दूसरा, यह पोर्टफोलियो है। नियोक्ता उन उम्मीदवारों को पसंद करते हैं जिनके GitHub पर स्टार हों। और तीसरा, यह जानकर अच्छा लगता है कि आपका कोड दुनिया भर के हज़ारों (शायद लाखों) डेवलपर्स द्वारा उपयोग किया जा रहा है।

लेकिन शुरुआती का मुख्य डर: "मैं बकवास लिखूंगा और लोग मुझ पर हंसेंगे"। स्पॉयलर: वे नहीं हंसेंगे। PHP ओपन सोर्स समुदाय में शुरुआती लोगों की मदद करने का रिवाज है। आपको सुधारा जाएगा, लेकिन विनम्रता से। मुख्य बात है शुरुआत करना।

कहाँ से शुरू करें? प्रोजेक्ट चुनना

सीधे Symfony या Laravel में न कूदें। कुछ सरल चुनें। आदर्श पहला प्रोजेक्ट वह लाइब्रेरी या पैकेज है जिसका आप स्वयं उपयोग करते हैं। अपना composer.json खोलें और डिपेंडेंसी देखें। निश्चित रूप से वहाँ कुछ छोटा होगा: Markdown पार्सर, तिथियों के साथ काम करने के लिए लाइब्रेरी, या एक सरल HTTP क्लाइंट।

चुनने के लिए कुछ मानदंड:

\n
• प्रोजेक्ट की सक्रियता: अंतिम कमिट 3 महीने से पुराना न हो। अन्यथा आप खालीपन में लिखने का जोखिम उठाते हैं।
\n
• "good first issue" लेबल वाली issue की उपलब्धता: यह शुरुआती लोगों के लिए सोने की खान है। कई PHP प्रोजेक्ट विशेष रूप से सरल कार्यों को चिह्नित करते हैं।
\n
• स्पष्ट README: यदि दस्तावेज़ीकरण में लिखा है कि टेस्ट कैसे चलाएं और वातावरण कैसे सेट करें - यह एक अच्छा संकेत है।
\n

उदाहरण के लिए, GitHub पर जाएं और good-first-issue टैग के साथ PHP ओपन सोर्स प्रोजेक्ट्स खोजें। वहाँ आपको सैकड़ों कार्य मिलेंगे जो अपने नायक की प्रतीक्षा कर रहे हैं।

पहला कदम: CONTRIBUTING.md पढ़ें

गंभीरता से, इस फ़ाइल को न छोड़ें। इसमें आमतौर पर सब कुछ लिखा होता है: कमिट नामकरण नियमों से लेकर टेस्ट चलाने के तरीके तक। यदि आप CONTRIBUTING.md को अनदेखा करते हैं, तो आपका काम सिर्फ इसलिए स्वीकार नहीं किया जा सकता क्योंकि आपने प्रारूप का पालन नहीं किया।

PHP प्रोजेक्ट्स में सामान्य आवश्यकताएँ:

\n
• कोड PSR-12 (कोड फ़ॉर्मेटिंग मानक) के अनुरूप होना चाहिए।
\n
• सभी परिवर्तन टेस्ट (PHPUnit, Pest) द्वारा कवर किए जाने चाहिए।
\n
• कमिट पर हस्ताक्षर होने चाहिए या कम से कम स्पष्ट विवरण होना चाहिए।
\n

पहला कार्य खोजना: issue से पहले कोड तक

मान लीजिए आपको एक कार्य मिल गया। उदाहरण के लिए, JSON के साथ काम करने के लिए PHP लाइब्रेरी प्रोजेक्ट में एक issue है: "JSON_THROW_ON_ERROR विकल्प के लिए समर्थन जोड़ें"। डरावना लगता है? वास्तव में यह सरल है: एक फ़्लैग जोड़ना है ताकि फ़ंक्शन null लौटाने के बजाय अपवाद फेंके।

यहाँ प्रोजेक्ट में हो सकने वाले कोड का उदाहरण है:

<?php\n\n/**\n * JSON स्ट्रिंग को पार्स करता है।\n *\n * @param string $json\n * @param bool $throwOnError\n * @return array|null\n */\nfunction parseJson(string $json, bool $throwOnError = false): ?array\n{\n    $data = json_decode($json, true);\n    \n    if (json_last_error() !== JSON_ERROR_NONE) {\n        if ($throwOnError) {\n            throw new \\RuntimeException('Invalid JSON: ' . json_last_error_msg());\n        }\n        return null;\n    }\n    \n    return $data;\n}\n

देखा? यह रॉकेट साइंस नहीं है। आप बस एक पैरामीटर जोड़ते हैं और उसकी जाँच करते हैं। शुरुआती के लिए कार्य - बिल्कुल सही।

कोड लिखना: अच्छे व्यवहार के नियम

जब आप PHP में योगदान देते हैं, याद रखें: आपका कोड दूसरे लोग पढ़ेंगे। ऐसा लिखें कि वह बिना टिप्पणियों के समझ में आए, लेकिन यदि तर्क जटिल है - टिप्पणियाँ अनिवार्य हैं।

यहाँ नहीं है