Проект | Старт и перенос | Правила ведения проектов

Старт и перенос проекта

Создание нового проекта

1) Скачиваем архив с сайта Битрикс
2) Проводим стандартную установку Битрикс (Помним о “Установить в кодировке UTF-8”, Тип таблиц базы данных: Innodb)
3) Распаковываем в папку проекта <site_folder>/public
4) Создаем файл .gitignore в папке <site_folder>, пример файла тут
5) Создаем файл .gitignore в папке <site_folder>/public/bitrix, пример файла тут
6) Копируем примеры файлов конфигов, что бы не заморачиваться при переносе проекта между репозиториями разработчиков.
```
# файл примера настройки нового ядра
/bitrix/.settings.example.php

# файл примера настройки старого ядра
/bitrix/php_interface/dbconn.example.php
```
код файлов

при переносе проекта эти файлы копируются, уберается .example в имени файла и в них вносятся нужные настройки.
7) инициализируем основной репозиторий в папке <site_folder>
```
git init .
git add .
git rm -r --cached public/bitrix
```
8) инициализируем репозиторий ядра битрикс в папке <site_folder>/public/bitrix
```
git init .
git add .
git commit -m"init"
```

9) Создаем репозитории на bitbucket.org

Имя репозитория составляем по маске:

<projectType>-<projectName>[-<coreName>]

где
  <projectType> - тип проекта:
    im - интернет-магазин
    lp - лендинг пейдж
    st - прочие сайты, такие как каталоги товаров, сайты визитки и иные...

  <projectName> - имя проекта

  <coreName> - имя ядра системы, присваивается репозиториям, 
               которые выступают как подмодули основного репозитория
               пример: bitrix, modx, wp

10) Привязываем удаленные репозитории к локальным
```
git remote add origin <repo_path>
```
11) Проталкиваем изменения ядра в репозиторий
```
git push origin --all
```
12) Привязываем репозиторий ядра как подмодуль к основному
```
git submodule add <core_repo_path> public/bitrix/
```

Результат должен быть следующим: "Добавляю существующий репозиторий из «public/bitrix» в индекс"

  git submodule init

13) Проверяем
```
git submodule status
```

Результат должен быть следующим: "22996cd787dd1ec3b82724c9ff2f7dc21298ec43 public/bitrix (heads/master)"

  git status

папка bitrix теперь должна отображаться в логе как файл, все файлы должны находиться в состоянии “Изменения, которые будут включены в коммит:” и быть “зелеными”

14) Получаем шаблон локального модуля для инкапсуляции кода проекта
```
cd public/local
mkdir -p modules/local.common
cd modules/local.common

git clone https://ariets@bitbucket.org/ariets/bxmodule-local.common.git .
```
После получения файлов идем в админку битрикса и устанавливаем модуль в разделе сторонних модулей маркетплейс
15) Делаем коммит основного репозитория и проталкиваем его в bitbucket
```
git commit -m"init"
git push origin --all
```

16) Привязываем отслеживание веток

# основной репозиторий
git branch --set-upstream-to=origin/master master

# подмодуль ядра
cd public/bitrix
git branch --set-upstream-to=origin/master master

Получение существующего проекта

  cd <site_path>
  git clone <repo path> .
  git submodule init bitrix
  git submidule update
  cd bitrix
  git checkout master
  cd ..
  git status

папка bitrix теперь должна отображаться в логе как файл