Одним из главных аспектов при разработке программного обеспечения вообще и web-приложений в частности я считаю способность программного обеспечения быть изменяемым — адаптируемым к изменениям окружающего мира. Это не значит, что разработчик должен заранее предусмотреть будущие изменения среды обитания своего кода, это значит, что код должен переносить множество циклов рефакторинга, оставаясь при этом работоспособным как можно дольше. А для этого нужно, чтобы последствия изменений, вносимых в код, были либо обозримы, либо предсказуемы. Под катом я суммировал свое понимание областей сокрытия кода, сформировавшееся в результате тесных, практически интимных, отношений с Magento 2 (платформой для построения интернет-магазинов). Изложенное ниже относится во-первых, к языку PHP, во-вторых — к web-приложениям, в-третьих — ко всему остальному.

• размещение кода модуля в репозитории Github'а;
• подключение модуля к Magento-приложению при помощи Composer'а;
• автоматизация процесса развертывания девелоперской/тестовой версии Magento;

Введение

• Magento
• Сторонние модули, используемые в проекте
• Разрабатываемые нами модули, используемые более, чем в одном нашем проекте
• Разрабатываемый нами модуль, содержащий функционал конкретно для данного проекта
• Тема для конкретного проекта

• инсталляция Magento и сторонние модули для проекта 01;
• инсталляция Magento и сторонние модули для проекта 02;
• ...
• наши модули;

• z_mage_composer_prj_01_full: скрипты развертывания всего проекта, тема, сторонние модули, не доступные через Magento Composer;
• z_mage_composer_mod_01: первый модуль, от которого зависит проект;
• z_mage_composer_mod_02: второй модуль, от которого зависит проект;

Введение

• основной проект: https://github.com/praxigento/z_git_submodules_main.git (Git)
• новый модуль: https://github.com/praxigento/z_mage_composer_mod_01.git (Git)
• legacy-модуль: https://github.com/praxigento/z_mage_composer_mod_02/trunk (Git as SVN)

$ lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description:    Ubuntu 14.04.1 LTS
Release:        14.04
Codename:       trusty
$ uname -a
Linux hamster 3.13.0-43-generic #72-Ubuntu SMP Mon Dec 8 1