💏 🤰🏻 ⚙️ सिम्फनी 5 बंडलों के साथ कोड का पुन: उपयोग कैसे करें? भाग 7. रिलीज चक्र, स्थापना और अद्यतन 🧛🏽 📀 👂

आइए परियोजनाओं के बीच कॉपी-पेस्ट को कैसे रोकें और कोड को फिर से उपयोग करने योग्य प्लग-इन बंडल सिम्फनी में स्थानांतरित करें। 5. बंडल के साथ मेरे अनुभव को सारांशित करने वाले लेखों की एक श्रृंखला, एक न्यूनतम बंडल बनाने से लेकर परीक्षण और बंडल रिलीज चक्र तक एक डेमो एप्लिकेशन को फिर से बनाने तक अभ्यास करेगी।

श्रृंखला के पिछले लेखों में, हमने पुन: प्रयोज्य कोड को एक पूर्ण बंडल में लिया, इसे कॉन्फ़िगर और परीक्षण किया। अंतिम लेख में, हम बंडल जीवन चक्र के बारे में बात करेंगे: स्थापना से रिलीज चक्र तक।

इस लेख में:

README.md
स्थापना: संगीतकार, फ्लेक्स व्यंजनों, कंसोल कमांड के माध्यम से
रिलीज चक्र, नए संस्करणों की रिलीज
शब्दार्थ संस्करण
CHANGELOG.md में परिवर्तन करना

श्रृंखला सामग्री

1.
2.
3. : , , JS
4.
5.
6. ,
7. ,

यदि आप लगातार ट्यूटोरियल पूरा नहीं करते हैं, तो रिपॉजिटरी से एप्लिकेशन डाउनलोड करें और 6-परीक्षण शाखा में स्विच करें ।

किसी फ़ाइल में प्रोजेक्ट को स्थापित करने और शुरू करने के लिए निर्देश README.md। आपको इस लेख के लिए कोड का अंतिम संस्करण 7-सपोर्ट शाखा में मिलेगा ।

अस्वीकरण

«», , . , .

, composer:

composer require bravik/calendar-bundle

vendors
composer- Symfony Flex, config/bundles.php.

. , - CalendarBundle:

- . , config/packages/ - . ?
, Doctrine. , , . ?
— , . , , . . : composer Symfony , , npm , package.json . .

, ?

README.md

. , : README.md .

, , . .

, . , .

Best Practices for Reusable Bundles

Symfony Flex

Symfony , . , - , ENV-, .gitignore- .

composer Symfony Flex. - , . , , - . .

, . , , , .gitignore, ENV-, .

Symfony Flex? open-source Flex , .

, . : Symfony Contribution- Symfony. Contrib , , .

, . :

Symfony Flex Private Repositories — Fabien Potencier, 2017
Symfony 4 Using Private Recipes with Flex — Sebastian Sellmeier, 2018
Symfony Flex Private Recipes: , — , 2017

, :

1.5-2
Flex Server , 249 EUR .
Flex Server packagist, .
Flex Server MIT BSD
, . 1.5 .

Symfony Flex Symfony open-source Symfony-, .

CLI- Symfony

, README.md

: .

mybundle/src/Command/InstallCommand.php:

<?php

namespace bravik\CalendarBundle\Command;

use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;
use Symfony\Component\Filesystem\Filesystem;

class InstallCommand extends Command
{
    protected static $defaultName = 'bravik:calendar:install';

    /** @var Filesystem */
    private $filesystem;

    private $projectDir;

    public function __construct(Filesystem $filesystem, string $projectDir)
    {
        parent::__construct();

        $this->filesystem = $filesystem;
        $this->projectDir = $projectDir;
    }

    protected function execute(InputInterface $input, OutputInterface $output): int
    {
        $output->writeln('Installing bravik/CalendarBundle...');

        $this->initConfig($output);

        //    
        // ...

        return 0;
    }

    private function initConfig(OutputInterface $output): void
    {
        // Create default config if not exists
        $bundleConfigFilename = $this->projectDir
            . DIRECTORY_SEPARATOR . 'config'
            . DIRECTORY_SEPARATOR . 'packages'
            . DIRECTORY_SEPARATOR . 'calendar.yaml'
        ;
        if ($this->filesystem->exists($bundleConfigFilename)) {
            $output->writeln('Config file already exists');

            return;
        }

        //      
        $config = <<<YAML
calendar:
  enable_soft_delete: true
YAML;
        $this->filesystem->appendToFile($bundleConfigFilename, $config);

        $output->writeln('Config created: "config/packages/calendar.yaml"');

    }
}

, , , .

. , . .

, Symfony, shell-script.

, . , .

, CHANGELOG.md. , :

, , . , , .

<major>.<minor>.<patch>

— .

, , .
, , .
-, , .

Composer , , - .

CalendarBundle.

?

composer.json:

{
    "name": "bravik/calendar-bundle",
    "version": "0.1.0",
    ...
}

, Composer git-. , . :

git tag v0.1.0

composer.json — composer .

?

composer.json - :

"require": {
    "bravik/calendar-bundle": "^0.1.0",
    ...
},

^ composer , :

> 1.0.0 2.0.0.
1.0.0 « », -.

> 0.1.0 < 0.2.0.

?

bundles/CalendarBundle/composer.json :

{
    "version": "0.1.1",
}

composer outdated

. — , — . , .

{
    "version": "0.2.1",
}

Composer . , . composer , require composer.json -.

?

composer update

, Composer

CHANGELOG.md

, , . . . CHANGELOG.md

, . , . , — , .

( « » 0.X.X) . , . CHANGELOG.md — , . !

CHANGElOG.md, .

# CHANGELOG
      

[BC] -   breaking changes

[BugFix] -   

## Unreleased
     
 * CAL-5 [BC]  
 * CAL-5    

## [0.2.0] (2020-04-06)
 * CAL-5 [BC]     
    -       `calendar_bundle.exporter`
 * CAL-6 [BC]     
    -   ,  ,        X  Y.        SQL  "XXX"
 * CAL-7   

## [0.1.1] (2020-03-30)
* CAL-4 [BugFix]      

## [0.1.0] (2020-02-15)
* CAL-1   
* CAL-2   
* CAL-3   
* [BugFix] Editor should initialize blocks only when they change

CHANGELOG.md symfony/framework-bundle. Symfony : . UPGRADE.md Symfony 4 Symfony 5.

Doctrine .

. , . — .

- : - .

SQL , , ?

, , .

, . — .

7-support.