PHP संगीतकार: दर्द के बिना निर्भरता को ठीक करें

आप में से बहुत से लोग ऐसी स्थिति में आ गए होंगे जहां पुस्तकालय या ढांचे में आवश्यक कार्यक्षमता या बग नहीं है। मान लीजिए कि आप बहुत आलसी नहीं थे और एक पुल अनुरोध का गठन किया। लेकिन वे इसे तुरंत स्वीकार नहीं करेंगे, और सामान्य रूप से उत्पाद की अगली रिलीज एक साल में हो सकती है।

यदि आपको उत्पाद में सुधार लाने की तत्काल आवश्यकता है तो क्या करें? स्पष्ट समाधान एक पुस्तकालय या ढांचे के कांटे का उपयोग करना है। हालांकि, कांटे के साथ सब कुछ सरल नहीं है। कार्यक्षमता को ओवरराइड करने के लिए इनहेरिटेंस का उपयोग करना जिसे बदलना आवश्यक है, हमेशा संभव नहीं होता है और अक्सर बड़े बदलाव की आवश्यकता होती है। कम्पोज़र के लिए प्लगइन्स जो निर्भरता को पैच कर सकते हैं बचाव के लिए आते हैं।

इस लेख में मैं इस बारे में अधिक बात करूंगा कि कांटे असुविधाजनक क्यों हैं, और यह भी निर्भरता पैचिंग के लिए संगीतकार के लिए दो प्लगइन्स पर विचार करें: वे कैसे भिन्न होते हैं, उनका उपयोग कैसे करें और उनके फायदे क्या हैं। यदि आपको ऐसी ही समस्याओं का सामना करना पड़ा है या आप सोच रहे हैं, तो बिल्ली का स्वागत करें।

समस्या को सबसे आसानी से एक उदाहरण के साथ माना जाता है। मान लीजिए कि हम PHP कोड कवरेज लाइब्रेरी में कुछ बदलना चाहते हैं, जिसका उपयोग परीक्षण द्वारा कोड कवरेज के स्तर को मापने के लिए PHPUnit परीक्षण ढांचे में किया जाता है। मान लीजिए कि हम इस तरह के संस्करण myFix.patch ( myFix.patch फ़ाइल) में कुछ ठीक करना चाहते हैं:

 diff --git a/src/CodeCoverage.php b/src/CodeCoverage.php index 2c92ae2..514171e 100644 --- a/src/CodeCoverage.php +++ b/src/CodeCoverage.php @@ -190,6 +190,7 @@ public function filter(): Filter */ public function getData(bool $raw = false): array { + // for example some changes here if (!$raw && $this->addUncoveredFilesFromWhitelist) { $this->addUncoveredFilesFromWhitelist(); } 

चलो हमारे उदाहरण पुस्तकालय बनाते हैं। इसे php-संगीतकार-पैच-उदाहरण होने दें । यहां विवरण बहुत महत्वपूर्ण नहीं हैं, लेकिन यदि आप यह देखने का निर्णय लेते हैं कि लाइब्रेरी क्या है, तो मैं कंसोल आउटपुट को स्पॉइलर के नीचे लाता हूं।

 $ git clone git@github.com:mougrim/php-composer-patches-example.git   «php-composer-patches-example»… remote: Enumerating objects: 3, done. remote: Counting objects: 100% (3/3), done. remote: Compressing objects: 100% (2/2), done. remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0  : 100% (3/3), . $ cd php-composer-patches-example/ $ $ composer.phar init --name=mougrim/php-composer-patches-example --description="It's an example for article with using forks and patches for changing dependencies" --author='Mougrim <rinat@mougrim.ru>' --type=library --require='phpunit/phpunit:^8.4.2' --license=MIT --homepage='https://github.com/mougrim/php-composer-patches-example' Welcome to the Composer config generator This command will guide you through creating your composer.json config. Package name (<vendor>/<name>) [mougrim/php-composer-patches-example]: Description [It's an example for article with using forks and patches for changing dependencies]: Author [Mougrim <rinat@mougrim.ru>, n to skip]: Minimum Stability []: Package Type (eg library, project, metapackage, composer-plugin) [library]: License [MIT]: Define your dependencies. Would you like to define your dev dependencies (require-dev) interactively [yes]? no { "name": "mougrim/php-composer-patches-example", "description": "It's an example for article with using forks and patches for changing dependencies", "type": "library", "homepage": "https://github.com/mougrim/php-composer-patches-example", "require": { "phpunit/phpunit": "^8.4.2" }, "license": "MIT", "authors": [ { "name": "Mougrim", "email": "rinat@mougrim.ru" } ] } Do you confirm generation [yes]? yes Would you like to install dependencies now [yes]? yes Loading composer repositories with package information Updating dependencies (including require-dev) Package operations: 29 installs, 0 updates, 0 removals - Installing sebastian/version (2.0.1): Loading from cache - Installing sebastian/type (1.1.3): Loading from cache - Installing sebastian/resource-operations (2.0.1): Loading from cache - Installing sebastian/recursion-context (3.0.0): Loading from cache - Installing sebastian/object-reflector (1.1.1): Loading from cache - Installing sebastian/object-enumerator (3.0.3): Loading from cache - Installing sebastian/global-state (3.0.0): Loading from cache - Installing sebastian/exporter (3.1.2): Loading from cache - Installing sebastian/environment (4.2.2): Loading from cache - Installing sebastian/diff (3.0.2): Loading from cache - Installing sebastian/comparator (3.0.2): Loading from cache - Installing phpunit/php-timer (2.1.2): Loading from cache - Installing phpunit/php-text-template (1.2.1): Loading from cache - Installing phpunit/php-file-iterator (2.0.2): Loading from cache - Installing theseer/tokenizer (1.1.3): Loading from cache - Installing sebastian/code-unit-reverse-lookup (1.0.1): Loading from cache - Installing phpunit/php-token-stream (3.1.1): Loading from cache - Installing phpunit/php-code-coverage (7.0.8): Loading from cache - Installing doctrine/instantiator (1.2.0): Loading from cache - Installing symfony/polyfill-ctype (v1.12.0): Loading from cache - Installing webmozart/assert (1.5.0): Loading from cache - Installing phpdocumentor/reflection-common (2.0.0): Loading from cache - Installing phpdocumentor/type-resolver (1.0.1): Loading from cache - Installing phpdocumentor/reflection-docblock (4.3.2): Loading from cache - Installing phpspec/prophecy (1.9.0): Loading from cache - Installing phar-io/version (2.0.1): Loading from cache - Installing phar-io/manifest (1.0.3): Loading from cache - Installing myclabs/deep-copy (1.9.3): Loading from cache - Installing phpunit/phpunit (8.4.2): Loading from cache sebastian/global-state suggests installing ext-uopz (*) phpunit/phpunit suggests installing phpunit/php-invoker (^2.0.0) phpunit/phpunit suggests installing ext-soap (*) Writing lock file Generating autoload files $ $ echo 'vendor/' > .gitignore $ echo 'composer.lock' >> .gitignore $ git add .gitignore composer.json $ $ git commit --gpg-sign --message='Init composer' [master ce800ae] Init composer 2 files changed, 18 insertions(+) create mode 100644 .gitignore create mode 100644 composer.json $ git push origin master  : 4, . Delta compression using up to 4 threads.  : 100% (3/3), .  : 100% (4/4), 1.21 KiB | 1.21 MiB/s, . Total 4 (delta 0), reused 0 (delta 0) To github.com:mougrim/php-composer-patches-example.git f31c342..ce800ae master -> master 

नशे के कांटे में क्या खराबी है

आइए देखें कि कांटा निर्भरता कैसे होती है। आइए PHP कोड कवरेज की कोशिश करें।

1. हम GitHub पर PHP कोड कवरेज पेज पर जाते हैं ।
2. फोर्क बटन को पुश करें (ध्यान दें: आपके पास आपका कांटा होगा, अपने यूजर नेम के साथ मौग्रीम बदलें)।
3. कांटा क्लोन:
   

    cd ../ git clone git@github.com:mougrim/php-code-coverage.git cd php-code-coverage 

4. उस संस्करण पर जाएं जिसे हम पैच करना चाहते हैं:
   

    git checkout 7.0.8 

5. फिक्स के लिए एक शाखा बनाएँ:
   

    git checkout -b 7.0.8-myFix 

6. हम आवश्यक परिवर्तन करते हैं, प्रतिबद्ध करते हैं, धक्का देते हैं:
   

    git apply ../myFix.patch git add src/CodeCoverage.php git commit --gpg-sign --message='My fix' git push -u origin 7.0.8-myFix 

7. हमारी लाइब्रेरी के लिए phpunit/php-code-coverage में भंडार के रूप में कांटा जोड़ें (यह आवश्यक है ताकि जब phpunit/php-code-coverage पैकेज कनेक्ट हो, तो मूल पैकेज कनेक्ट न हो, लेकिन कांटा):
   

    cd ../php-composer-patches-example git checkout -b useFork composer.phar config repositories.phpunit/php-code-coverage vcs https://github.com/mougrim/php-code-coverage.git 

8. ब्रंच के लिए निर्भरता के लिए संस्करण बदलें:
   

    composer.phar require phpunit/php-code-coverage 'dev-7.0.8-myFix' 

लेकिन वास्तव में यह अभी भी अधिक जटिल है: संगीतकार कहते हैं कि स्थापना असंभव है, क्योंकि phpunit/phpunit को phpunit/php-code-coverage ^7.0.7 phpunit/php-code-coverage संस्करण ^7.0.7 आवश्यकता होती है, और हमारी परियोजना के लिए dev-7.0.8-myFix आवश्यकता होती है

 $ composer.phar require phpunit/php-code-coverage 'dev-7.0.8-myFix' ./composer.json has been updated Loading composer repositories with package information Updating dependencies (including require-dev) Your requirements could not be resolved to an installable set of packages. Problem 1 - phpunit/phpunit 8.4.2 requires phpunit/php-code-coverage ^7.0.7 -> satisfiable by phpunit/php-code-coverage[7.0.x-dev]. - phpunit/phpunit 8.4.2 requires phpunit/php-code-coverage ^7.0.7 -> satisfiable by phpunit/php-code-coverage[7.0.x-dev]. - phpunit/phpunit 8.4.2 requires phpunit/php-code-coverage ^7.0.7 -> satisfiable by phpunit/php-code-coverage[7.0.x-dev]. - Can only install one of: phpunit/php-code-coverage[7.0.x-dev, dev-7.0.8-myFix]. - Installation request for phpunit/php-code-coverage dev-7.0.8-myFix -> satisfiable by phpunit/php-code-coverage[dev-7.0.8-myFix]. - Installation request for phpunit/phpunit ^8.4.2 -> satisfiable by phpunit/phpunit[8.4.2]. Installation failed, reverting ./composer.json to its original content. 

इसके बारे में क्या करना है? चार विकल्प हैं:

1. phpunit/php-code-coverage कांटा के अलावा, PHPUnit को कांटा और निर्भरता phpunit/php-code-coverage लिए संस्करण dev-7.0.8-myFix phpunit/php-code-coverage । यह रास्ता समर्थन के मामले में जटिल है और अधिक जटिल अधिक पुस्तकालयों phpunit/php-code-coverage पर निर्भर करता है।
2. phpunit/php-code-coverage कनेक्ट करते समय अन्य का उपयोग करें। लेकिन उपनामों को निर्भरता से नहीं खींचा जाता है, जिसका अर्थ है कि उन्हें हमेशा मैन्युअल रूप से लिखने की आवश्यकता होगी।
3. अपने फोर्क में phpunit/php-code-coverage करें ताकि 7.0.8 टैग किसी अन्य कमिट को 7.0.8 । यह कम से कम स्पष्ट नहीं है, लेकिन अधिकतम - गिट में यह उन टैग के साथ काम करने के लिए असुविधाजनक है जो विभिन्न दूरस्थ रिपॉजिटरी में एक ही नाम के साथ अलग-अलग कमिट का संदर्भ देते हैं।
4. आपके कांटे phpunit/php-code-coverage अल्फा रिलीज़ टैग का उपयोग करें, उदाहरण के लिए 7.0.8-a+myFix (स्रोत लाइब्रेरी के अल्फा रिलीज़ के साथ टकराव हो सकता है)।

सभी विकल्पों में उनकी कमियां हैं। मैंने 7.0.8.1 जैसे टैग का उपयोग करने का भी प्रयास किया, लेकिन संगीतकार ऐसे टैग को स्वीकार नहीं करता है।

दूसरा और चौथा विकल्प बुराइयों से कम लगता है। कार्यों की संख्या से वे लगभग समान हैं, इस लेख में हम केवल एक पर विचार करेंगे - चौथा। एक अल्फा रिलीज टैग बनाएं:

 cd ../php-code-coverage git tag 7.0.8-a+myFix git push origin 7.0.8-a+myFix cd ../php-composer-patches-example composer.phar require phpunit/php-code-coverage '7.0.8-a+myFix' git add composer.json git commit --gpg-sign --message='Use fork' git push -u origin useFork 

मान लें कि हम अपने पुस्तकालय का उपयोग करना चाहते हैं mougrim/php-composer-patches-example एक प्रोजेक्ट में जो phpunit/phpunit पर निर्भर करता है। यहां, कोई भी phpunit/php-code-coverage बिना नहीं कर सकता है, आपको फिर से phpunit/php-code-coverage लिए रिपॉजिटरी https://github.com/mougrim/php-code-coverage.git निर्दिष्ट करना होगा, साथ ही स्पष्ट रूप से phpunit/php-code-coverage पर निर्भरता का संकेत देना होगा संस्करण 7.0.8-a+myFix (अन्यथा स्थापना सफल नहीं होगी):

 cd ../ mkdir php-project cd php-project/ composer.phar require phpunit/phpunit '^8.4.2' composer.phar config repositories.mougrim/php-composer-patches-example vcs https://github.com/mougrim/php-composer-patches-example.git composer.phar config repositories.phpunit/php-code-coverage vcs https://github.com/mougrim/php-code-coverage.git composer.phar require phpunit/php-code-coverage 7.0.8-a+myFix composer.phar require mougrim/php-composer-patches-example dev-useFork 

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

कांटे के उपयोग को संक्षेप में प्रस्तुत करना।

इस दृष्टिकोण के लाभ:

• संगीतकार के लिए प्लगइन्स स्थापित करने की आवश्यकता नहीं है।

इस दृष्टिकोण के विपक्ष:

• यदि आप roave/security-advisories उपयोग करते हैं, तो आपको जानकारी नहीं roave/security-advisories कि आपके द्वारा roave/security-advisories और संशोधित किए गए निर्भरता के संस्करण में भेद्यता है;
• जब निर्भरता का एक नया संस्करण सामने आता है, तो कांटे की कहानी को नए सिरे से दोहराना होगा;
• यदि आप एक निर्भरता निर्भरता को ठीक करना चाहते हैं, जैसा कि माना गया उदाहरण है, तो dev-* इसके लिए काम नहीं करेगा और आपको विरोधाभासी निर्भरता के लिए संस्करणों या कांटा के साथ शमन करना होगा;
• यदि ऐसी परियोजनाएँ हैं जो आपके पुस्तकालय पर निर्भर करती हैं, तो आपको परियोजना में पुस्तकालय को सबसे स्पष्ट और सुविधाजनक तरीके से स्थापित नहीं करना पड़ेगा;
• यदि ऐसी परियोजनाएं हैं जो आपके पुस्तकालय पर निर्भर करती हैं, तो उनके लिए phpunit/php-code-coverage संस्करण सख्ती से तय किया जाएगा, जो हमेशा स्वीकार्य नहीं होता है;
• इसके अलावा, अगर ऊपर के बिंदुओं के प्रोजेक्ट पहले से ही किसी अन्य कारण से PHP कोड कवरेज को छोड़ देते हैं, तो सब कुछ और भी जटिल हो जाता है।

मुझे लगता है कि आप पहले से ही महसूस कर चुके हैं कि नशे की लत को रोकना इतना अच्छा विचार नहीं है।

Cweagans / कंपोज़र-पैच का उपयोग करना

एक बार फिर कांटे का उपयोग करने से दर्द और पीड़ा का अनुभव करते हुए, मैं PHP डाइजेस्ट नंबर 101 में cweagans/composer-patches भर आया (वैसे, pronskiy का एक उपयोगी ब्लॉग है, मैं सदस्यता लेने की सलाह देता हूं)। यह omposer के लिए एक प्लगइन है, जो आपको निर्भरता के लिए पैच लागू करने की अनुमति देता है। विवरण पढ़ने के बाद, मैंने सोचा कि यह वही है जो आपको चाहिए।

कैसे उपयोग करने के लिए cweagans / संगीतकार-पैच:

1. क्लोन PHP कोड कवरेज:
   

    cd ../ rm -rf php-code-coverage git clone git@github.com:sebastianbergmann/php-code-coverage.git cd php-code-coverage 

2. उस संस्करण पर जाएं जिसे हम पैच करना चाहते हैं:
   

    git checkout 7.0.8 

3. हम आवश्यक बदलाव करते हैं।
4. एक पैच बनाएँ:
   

    mkdir -p ../php-composer-patches-example/patches/phpunit/php-code-coverage git diff HEAD > ../php-composer-patches-example/patches/phpunit/php-code-coverage/myFix.patch 

5. हमारी परियोजना में हम cweagans/composer-patches कनेक्ट cweagans/composer-patches :
   

    cd ../php-composer-patches-example git checkout master composer.phar update git checkout -b cweagansComposerPatches composer.phar require cweagans/composer-patches '^1.6.7' 

6. cweagans/composer-patches को कॉन्फ़िगर करने के लिए cweagans/composer-patches में निम्न जोड़ें (आप एक पैकेज के लिए कई पैच निर्दिष्ट कर सकते हैं):
   

    { "config": { "preferred-install": "source" }, "extra": { "patches": { "phpunit/php-code-coverage": { "My fix description": "patches/phpunit/php-code-coverage/myFix.patch" } }, "enable-patching": true } } 

7. अद्यतन निर्भरताएँ:
   

    composer.phar update 

8. अगर कुछ गलत हुआ है, तो इसे पिछले कमांड के आउटपुट में देखा जा सकता है, लेकिन सिर्फ मामले में, आप देख सकते हैं कि हमारे बदलाव किए गए हैं:
   

    $ grep example vendor/phpunit/php-code-coverage/src/CodeCoverage.php // for example some changes here 

9. परिणाम को कमिट करें और धकेलें:
   

    git add composer.json patches/phpunit/php-code-coverage/myFix.patch git commit --gpg-sign --message='Use cweagans/composer-patches' git push -u origin cweagansComposerPatches 

हम यह सुनिश्चित करते हैं कि परियोजना में हमारे पुस्तकालय को स्थापित करते समय, पैच भी लागू होगा।

एक परियोजना बनाएँ:

 cd ../ rm -rf php-project mkdir php-project cd php-project composer.phar require phpunit/phpunit '^8.4.2' 

कंपोज़र.जॉन के लिए निम्न पंक्तियाँ जोड़ें:

 { "extra": { "enable-patching": true } } 

mougrim/php-composer-patches-example स्थापित करें:

 composer.phar config repositories.mougrim/php-composer-patches-example vcs https://github.com/mougrim/php-composer-patches-example.git composer.phar require mougrim/php-composer-patches-example dev-cweagansComposerPatches 

ऐसा लगता है कि पैकेज को जोड़ने पर पैच लगाने का प्रयास होना चाहिए था, लेकिन नहीं।
हम पैकेज अपडेट करते हैं ताकि पैच लागू हो, लेकिन ऐसा नहीं होता है:

 $ composer.phar update Removing package phpunit/php-code-coverage so that it can be re-installed and re-patched. - Removing phpunit/php-code-coverage (7.0.8) Loading composer repositories with package information Updating dependencies (including require-dev) Package operations: 1 install, 0 updates, 0 removals No patches supplied. Gathering patches for dependencies. This might take a minute. - Installing phpunit/php-code-coverage (7.0.8): Loading from cache - Applying patches for phpunit/php-code-coverage patches/phpunit/php-code-coverage/myFix.patch (My fix description) Could not apply patch! Skipping. The error was: The "patches/phpunit/php-code-coverage/myFix.patch" file could not be downloaded: failed to open stream: No such file or directory Writing lock file Generating autoload files 

बग ट्रैकर में रम होने के बाद, मैंने पाया कि फ़ाइल आधारित पैच निर्भरता बग में हल नहीं किए गए हैं । यह पता चला है कि आपको पैच से पहले URL को निर्दिष्ट करना होगा (जिसका अर्थ है कि इसे कहीं से डाउनलोड करना), या प्रत्येक प्रोजेक्ट में मैन्युअल रूप से पैच पर पथ निर्दिष्ट करें जहां आप एक निर्भरता स्थापित करते हैं जिसमें पैच की आवश्यकता होती है।

cweagans/composer-patches के उपयोग को संक्षेप में प्रस्तुत करना।

इस दृष्टिकोण के लाभ:

• प्लगइन का एक समुदाय है;
• roave/security-advisories काम करना बंद नहीं करेगी;
• जब निर्भरता का एक नया संस्करण जारी किया जाता है, यदि पैच को सफलतापूर्वक लागू किया जाता है, तो यह सुनिश्चित करने के लिए पर्याप्त होगा कि सब कुछ नए संस्करण के साथ काम करता है (मामूली रिलीज के लिए, उच्च संभावना के साथ यह अपने आप सभी काम करेगा, प्रमुख रिलीज के लिए यह भी संभावना है कि कुछ भी नहीं करना होगा);
• यदि ऐसी परियोजनाएँ हैं जो आपके पुस्तकालय पर निर्भर करती हैं, तो उनके लिए phpunit/php-code-coverage का संस्करण सख्ती से तय नहीं किया जाएगा;
• इसके अलावा, ऊपर दिए गए पैराग्राफ के मामले में, ऐसी परियोजना PHP कोड कवरेज में अपने पैच लागू करने में सक्षम होगी।

विपक्ष:

• यह संगीतकार के लिए एक प्लगइन है, जिसका अर्थ है कि संगीतकार को अद्यतन करते समय यह टूट सकता है;
• enable-patching=true निर्दिष्ट होना चाहिए ताकि पैच निर्भरता से लागू हो;
• मुख्य परियोजना अनुचर के पास इससे निपटने के लिए अधिक समय नहीं है, इसलिए, एक नियम के रूप में, वह पुल अनुरोधों को स्वीकार करता है, लेकिन विशेष रूप से परियोजना को विकसित नहीं करता है (उदाहरण के लिए, उसके पास कार्य में दूसरे संस्करण के लिए विचार थे, लेकिन तीन साल बाद थोड़ा बदल गया है);
• एक फ़ाइल आधारित पैच निर्भरता बग में हल नहीं किया गया है , जो असुविधाजनक है और तीन साल से बैकलॉग में लटका हुआ है;
• आप निर्भरता के विभिन्न संस्करणों के लिए विभिन्न पैच का उपयोग नहीं कर सकते।

अंतिम बिंदु मेरे लिए एक बाधा बन गया है। पहले मैंने एक सुविधा का अनुरोध किया । अनुचर ने लिखा कि वह इस सुविधा को मुख्य कोड में नहीं जोड़ना चाहता था, लेकिन दूसरे संस्करण में प्लग-इन (कंपोज़र के लिए प्लग-इन के लिए एक प्लग-इन) लिखना संभव होगा। दूसरे संस्करण के लिए दृष्टिकोण अस्पष्ट था, इसलिए मैंने विकल्पों की तलाश करने का फैसला किया। छोटी सूची में मुझे एक प्लगइन नहीं मिला जो समर्थित होगा।

मैं प्लगइन कोड में नहीं आना चाहता था, इसलिए मैंने कांटे का फैसला किया - निश्चित रूप से, किसी ने पहले ही समस्या का सामना कर लिया था और इसे हल कर दिया था।

Vaimo संगीतकार पैच का उपयोग करना

अधिकांश कांटों में मूल से कोई अंतर नहीं था (वे कांटा भी क्यों करते हैं?)। कांटों का हिस्सा पुल अनुरोधों के लिए बनाया गया था, जो पहले से ही मुख्य पुस्तकालय में विलय कर दिया गया था। हालांकि, एक दिलचस्प उम्मीदवार था जो मेरी समस्या को हल कर रहा था - वाइमो कम्पोजर पैच । उस समय यह अभी भी कांटे के रूप में तैयार किया गया था, लेकिन इसके अनुरक्षक, ऐसा लगता है, पुल अनुरोधों को नहीं करने जा रहा था। उदाहरण के लिए, अन्य बातों के अलावा, उन्होंने पहले ही पैकेज का नाम बदलकर vaimo/composer-patches । लेकिन एक समस्या थी: मुद्दों को अक्षम कर दिया गया था, अर्थात्, लेखक से कोई प्रतिक्रिया नहीं थी। साथ ही, पैकगिस्ट पर प्लगइन होस्ट नहीं किया गया था।

इस तरह के एक अच्छे कांटे को अन्य बेकार कांटों के ढेर में नहीं खोना चाहिए। इसलिए, मैंने लेखक से मुद्दों को सक्षम करने और पैकेजैगिस्ट में पैकेज जोड़ने के अनुरोध के साथ संपर्क किया। लगभग एक महीने के बाद, लेखक ने जवाब दिया और यह सब किया। :)

vaimo/composer-patches उपयोग करना पिछले प्लगइन का उपयोग करने से अलग नहीं है, लेकिन आप विभिन्न संस्करणों के लिए अलग-अलग पैच निर्दिष्ट कर सकते हैं।

1. हम अपनी लाइब्रेरी को वापस cweagans/composer-patches ( vendor फ़ोल्डर को हटाना आवश्यक है, क्योंकि प्लगइन्स cweagans/composer-patches और vaimo/composer-patches एक दूसरे के साथ बहुत संगत नहीं vaimo/composer-patches ):
   

    cd ../php-composer-patches-example git checkout master rm -rf vendor/ composer.phar update 

2. हम पिछले अनुभाग से 1-4 अंक लेते हैं।
3. हमारी परियोजना में हम vaimo/composer-patches कनेक्ट vaimo/composer-patches :
   

    cd ../php-composer-patches-example git checkout -b vaimoComposerPatches composer.phar require vaimo/composer-patches '^4.20.2' 

4. vaimo/composer-patches को कॉन्फ़िगर करने के लिए vaimo/composer-patches (प्रलेखन यहाँ देखा जा सकता है ):
   

    { "extra": { "patches": { "phpunit/php-code-coverage": { "My fix description": { "< 7.0.0": "patches/phpunit/php-code-coverage/myFix-leagcy.patch", ">= 7.0.0": "patches/phpunit/php-code-coverage/myFix.patch" } } } } } 

5. अद्यतन निर्भरताएँ:
   

    composer.phar update 

6. यदि कुछ गलत हुआ है, तो यह पिछले कमांड के आउटपुट में देखा जा सकता है, लेकिन सिर्फ मामले में, आप यह सुनिश्चित कर सकते हैं कि हमारे परिवर्तन शामिल हैं:
   

    $ grep example vendor/phpunit/php-code-coverage/src/CodeCoverage.php // for example some changes here 

7. परिणाम को कमिट करें और धकेलें:
   

    git add composer.json patches/phpunit/php-code-coverage/myFix.patch git commit --gpg-sign --message='Use vaimo/composer-patches' git push -u origin vaimoComposerPatches 

हम यह सुनिश्चित करते हैं कि परियोजना में हमारे पुस्तकालय को स्थापित करते समय, पैच भी लागू होगा।

एक परियोजना बनाएँ और mougrim/php-composer-patches-example :

 cd ../ rm -rf php-project mkdir php-project cd php-project composer.phar require phpunit/phpunit '^8.4.2' composer.phar config repositories.mougrim/php-composer-patches-example vcs https://github.com/mougrim/php-composer-patches-example.git composer.phar require mougrim/php-composer-patches-example dev-vaimoComposerPatches 

बस मामले में, आप यह सुनिश्चित कर सकते हैं कि हमारे परिवर्तन लागू कर दिए गए हैं:

 $ grep example vendor/phpunit/php-code-coverage/src/CodeCoverage.php // for example some changes here 

vaimo/composer-patches के उपयोग को संक्षेप में प्रस्तुत करना।

इस प्लगइन के फायदे लगभग पिछले वाले जैसे ही हैं, लेकिन इसमें निम्नलिखित भी शामिल हैं:

• अनुचर सक्रिय रूप से प्लगइन विकसित कर रहा है और पहले से ही चौथा प्रमुख संस्करण जारी कर चुका है;
• लागू होने के लिए निर्भरता से पैच के लिए अतिरिक्त कुछ भी निर्धारित करने की आवश्यकता नहीं है;
• आप निर्भरता के विभिन्न संस्करणों के लिए विभिन्न पैच का उपयोग कर सकते हैं;
• प्लगइन में बहुत सारी सेटिंग्स हैं, इसलिए यदि लेख में वर्णित कार्यक्षमता आपके लिए पर्याप्त नहीं है, तो दस्तावेज़ीकरण देखें - शायद आपको जिस सुविधा की आवश्यकता है वह पहले से ही लागू है।

विपक्ष:

• पिछले एक की तरह, यह संगीतकार के लिए एक प्लगइन है, जिसका अर्थ है कि संगीतकार को अपडेट करते समय यह टूट सकता है;
• पिछले प्लगइन के विपरीत, इस समुदाय में कम है।

निष्कर्ष

सामान्य परिणामों को संक्षेप में प्रस्तुत करने के लिए:

• किसी भी मामूली सुधार के लिए पैकेज कांटे का उपयोग करना असुविधाजनक है;
• cweagans/composer-patches एक अच्छा प्लगइन है, लेकिन खराब तरीके से विकसित होता है, इसलिए मैं इसकी सिफारिश नहीं करता हूं;
• Vaimo संगीतकार पैच एक उत्कृष्ट प्लगइन है जो निर्भरता को ठीक करने की समस्या को हल करता है, और सेटिंग्स का एक गुच्छा भी है;
• Vaimo संगीतकार पैच में एक छोटा सा समुदाय है, लेकिन मुझे उम्मीद है कि यह लेख इसे बढ़ाएगा;
• यदि निर्भरता में बहुत सारे बदलावों की आवश्यकता होती है, तो एक कठिन कांटा का सहारा लेना आसान हो सकता है (मूल निर्भरता के कांटे को स्वतंत्र रखें)।

मैंने एक अप्रत्यक्ष निष्कर्ष भी दिया: यदि किसी प्रकार की निर्भरता आवश्यक कार्यक्षमता प्रदान नहीं करती है, तो ऐसे कांटे हो सकते हैं जिन्होंने इस कार्यक्षमता को लागू किया और इससे भी अधिक।

दो मामलों में, हम दो मामलों में Vaimo संगीतकार पैच का उपयोग करते हैं:

• PHPMnit और PHP कोड कवरेज पैचिंग के लिए SoftMocks में;
• WebMozart Assert के लिए आंतरिक रिपॉजिटरी में सॉफ्ट फिक्स के साथ संगतता के लिए फिक्स फिक्स (जबकि सॉफ्टमैक्स array_map(array('static', 'valueToString') कंस्ट्रक्शन array_map(array('static', 'valueToString') समर्थन नहीं करता है)।

रिनट अखमदेव, सीनियर PHP डेवलपर

UPD1 : एलियास के लिंक के लिए धन्यवाद बोशरिक । लेख में उपनामों के बारे में एक बिंदु जोड़ा गया।