Ми розглядаємо можливість створити власний commonпакет для відображення сутності та служб для використання в декількох окремих додатках. Набір повинен бути легким для модифікації, запуску, включення та тестування. Я знаю про найкращі практики структурування пакетів , але не знаю, яку gitстратегію використовувати, коли мова йде про розробку.

Чи слід нам створювати commonпакет як цілий проект і зафіксувати ціле сховище на нашому git-сервері, чи краще запустити керування вихідними кодами лише для кореня commonпакета і натискати лише його вміст? Я бачу такий підхід у наборах, доступних на github, але я не знаю легкого та зручного способу розробити набори таким чином.

Створіть новий порожній проект symfony

php composer.phar create-project symfony/framework-standard-edition demo/ 2.4.1
cd demo

Створіть новий пакет

(наприклад src/Company/DemoBundle)

php app/console generate:bundle
cd src/Company/DemoBundle/

Запустіть свій репозиторій github у src/Company/DemoBundle

git init
touch README.md
git add .
git commit -m "initial commit"
git remote add origin https://github.com/YourAccount/DemoBundle.git
git push -u origin master

Додайте файл composer.json

src/Company/DemoBundle/composer.json:

{
    "name" : "company/demobundle",
    "description" : "A demo bundle",
    "type" : "symfony-bundle",
    "authors" : [{
        "name" : "demo",
        "email" : "demo@company.com"
    }],
    "keywords" : [
        "demo bundle"
    ],
    "license" : [
        "MIT"
    ],
    "require" : {
    },
    "autoload" : {
        "psr-0" : {
            "Company\\DemoBundle" : ""
        }
    },
    "target-dir" : "Company/DemoBundle",
    "repositories" : [{
    }],
    "extra" : {
    "branch-alias" : {
            "dev-master" : "some_version-dev"
        }
    }
}

Тепер у вас є базова структура вашого пакета

Використовуйте його в іншому проекті

composer.json:

    [...]
    "require" : {
        [...]
        "company/demobundle" : "dev-master"
    },
    "repositories" : [{
        "type" : "vcs",
        "url" : "https://github.com/Company/DemoBundle.git"
    }],
    [...]

Зробіть:

curl -sS https://getcomposer.org/installer | php
php composer.phar update company/demobundle

app / AppKernel:

new Company\DemoBundle\CompanyDemoBundle(),

Попрацюйте над цим

• Ви можете клонувати свій DemoBundle в src/Companyпапці, а потім встановити його вручну
• Ви можете використовувати символічне посилання

Висновок

Ви можете розробити та протестувати свій пакет у своєму першому проекті та використовувати його з github та композитором у другому проекті.

Важливим моментом є те, що ви можете зробити свій репо від / постачальника. Справді, композитор створює другий пульт, що називається "композитор", для кожного пакета (або пакета), який посилається на репо пакета, щоб ви могли працювати над ним у робочому контексті. Тож хороша практика - зареєструвати свій пакет у вашому composer.json для всіх ваших проектів і взяти на себе зобов’язання /vendor/MyCompany/MyBundleз будь-якого проекту.

Як доказ - просто запустите git remote -vбудь-який комплект вашого постачальника.

Поганою практикою було б розглядати свій пакет як окремий проект і мати з ним посилання. Основна причина, через яку це погана практика, полягає в тому, що ви не зможете оголосити про залежності за допомогою вашого пакета. Більше того, у вас будуть певні труднощі з розгортанням ваших проектів.

У Symfony4 generate:bundleкоманда більше недоступна. Натомість ви можете дотримуватися цього підручника .

Спочатку створіть проект за допомогою:

composer create-project symfony/website-skeleton my-project

Потім створіть my-project/lib/AcmeFooBundle/srcкаталог. Тут буде жити ваша пачка. Простір імен для цього каталогу буде Acme\AcmeFooBundle, отже, якщо ви створите клас служби в lib/AcmeFooBundle/src/Service/Foo.php, його простір імен буде Acme\AcmeFooBundle\Service.

Тепер нам потрібно сказати автозавантажувачу композитора шукати нові класи в цьому новому каталозі, тому нам потрібно відредагувати composer.json autoloadрозділ:

"autoload": {
    "psr-4": {
        "Acme\\AcmeFooBundle\\": "lib/AcmeFooBundle/src/",
    }
}, 

і біжи composer dump-autoload.

Тепер вам потрібно лише додати клас набору до config/bundles.php:

return [
    ...
    Acme\AcmeFooBundle\AcmeFooBundle::class => ['all' => true],
];

та введення залежностей для завантаження конфігурації з вашого пакета.

Якщо ви хочете перевірити свої послуги перед додаванням інжекції залежностей, ви можете просто підключити їх автоматично за адресою config/services.yml:

services:
    ...
    Acme\AcmeFooBundle\Services\Foo: ~

Це все. Дотримуйтесь найкращих практик і продовжуйте кодування.

PS: Я опублікував допис із кількома порадами щодо розробки багаторазових комплектів Symfony .