149 lines
7.6 KiB
Markdown
149 lines
7.6 KiB
Markdown
|
# Работа с Git
|
|||
|
|
|
|||
|
|
Kohana применяет [git](http://git-scm.com/) для контроля версий и [github](http://github.com/kohana) для совместной разработки. Данная статья покажет Вам как использовать git и github для создания простейшего приложения.
|
|||
|
|
|
|||
|
|
## Установка и настройка Git на Вашей машине
|
|||
|
|
|
|||
|
|
### Установка Git
|
|||
|
|
|
|||
|
|
- для OSX: [Git-OSX](http://code.google.com/p/git-osx-installer/)
|
|||
|
|
- для Windows: [Msygit](http://code.google.com/p/msysgit/)
|
|||
|
|
- Или загрузите git с [официального сайта](http://git-scm.com/) и установите его самостоятельно (подробности установки смотрите на сайт Git)
|
|||
|
|
|
|||
|
|
### Основные глобальные настройки
|
|||
|
|
|
|||
|
|
git config --global user.name "Your Name"
|
|||
|
|
git config --global user.email "youremail@website.com"
|
|||
|
|
|
|||
|
|
### Дополнительные, но предпочтимые настройки
|
|||
|
|
|
|||
|
|
Для лучшей визуализации команд и репозиторий в командной строке, используйте следующее:
|
|||
|
|
|
|||
|
|
git config --global color.diff auto
|
|||
|
|
git config --global color.status auto
|
|||
|
|
git config --global color.branch auto
|
|||
|
|
|
|||
|
|
### Настройка автозавершения
|
|||
|
|
|
|||
|
|
[!!] Следующие строки применимы только для OSX машин
|
|||
|
|
|
|||
|
|
Эти строки сделают всю грязную работу за вас и после этого Вы сможете спокойно работать с git-окружением, используя автозавершение команд:
|
|||
|
|
|
|||
|
|
cd /tmp
|
|||
|
|
git clone git://git.kernel.org/pub/scm/git/git.git
|
|||
|
|
cd git
|
|||
|
|
git checkout v`git --version | awk '{print $3}'`
|
|||
|
|
cp contrib/completion/git-completion.bash ~/.git-completion.bash
|
|||
|
|
cd ~
|
|||
|
|
rm -rf /tmp/git
|
|||
|
|
echo -e "source ~/.git-completion.bash" >> .profile
|
|||
|
|
|
|||
|
|
### Всегда используйте LF в окончаниях строк
|
|||
|
|
|
|||
|
|
Это соглашение, которое было принято Kohana сообществом. Выставьте эту настройку во имя Вашего Господа, особенно если хотите участвовать в kohana коммьюнити!
|
|||
|
|
|
|||
|
|
git config --global core.autocrlf input
|
|||
|
|
git config --global core.savecrlf true
|
|||
|
|
|
|||
|
|
[!!] Более подробную информацию об окончаниях строк читайте на [GitHub'е](http://help.github.com/dealing-with-lineendings/)
|
|||
|
|
|
|||
|
|
### Информация для размышления
|
|||
|
|
|
|||
|
|
- [Git скринкасты](http://www.gitcasts.com/)
|
|||
|
|
- [Git справочник](http://gitref.org/)
|
|||
|
|
- [Pro Git book](http://progit.org/book/)
|
|||
|
|
|
|||
|
|
## Основная структура
|
|||
|
|
|
|||
|
|
[!!] Предполагается, что Ваш web-сервер уже настроен, и Вы будете использовать адрес <http://localhost/gitorial/> для нового приложения.
|
|||
|
|
|
|||
|
|
Откройте консоль, перейдите в пустую директорию `gitorial` и выполните команду `git init`. Она создаст заготовку под новый git-репозиторий.
|
|||
|
|
|
|||
|
|
Далее, мы создадим подпроект ([submodule](http://www.kernel.org/pub/software/scm/git/docs/git-submodule.html)) для директории `system`. Откройте <http://github.com/kohana/core> и скопируйте значение Clone URL:
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
Используйте скопированный URL для создания подпроекта `system`:
|
|||
|
|
|
|||
|
|
git submodule add git://github.com/kohana/core.git system
|
|||
|
|
|
|||
|
|
[!!] Будет создана связь с текущей разрабатываемой версией следующего стабильного релиза. Эта версия должна практически всегда быть безопасна для использования, иметь тот же API, что в текущем стабильном релизе с исправленными ошибками.
|
|||
|
|
|
|||
|
|
Теперь добавьте остальные необходимые подпроекты. Например, если нужен модуль [Database](http://github.com/kohana/database):
|
|||
|
|
|
|||
|
|
git submodule add git://github.com/kohana/database.git modules/database
|
|||
|
|
|
|||
|
|
После добавления модули должны быть проиниализированы:
|
|||
|
|
|
|||
|
|
git submodule init
|
|||
|
|
|
|||
|
|
Теперь мы должны зафиксировать текущее состояние:
|
|||
|
|
|
|||
|
|
git commit -m 'Added initial submodules'
|
|||
|
|
|
|||
|
|
Следующий шаг - создание структуры папок для приложения. Вот необходимый минимум:
|
|||
|
|
|
|||
|
|
mkdir -p application/classes/{controller,model}
|
|||
|
|
mkdir -p application/{config,views}
|
|||
|
|
mkdir -m 0777 -p application/{cache,logs}
|
|||
|
|
|
|||
|
|
Если запустить команду `find application`, Вы должны увидеть такой список:
|
|||
|
|
|
|||
|
|
application
|
|||
|
|
application/cache
|
|||
|
|
application/config
|
|||
|
|
application/classes
|
|||
|
|
application/classes/controller
|
|||
|
|
application/classes/model
|
|||
|
|
application/logs
|
|||
|
|
application/views
|
|||
|
|
|
|||
|
|
Мы не хотим, чтобы git обрабатывал логи или файлы кэша, поэтому добавим файл `.gitignore` в соответствуюшие директории logs и cache. Теперь все нескрытые (non-hidden) файлы будут проигнорированы git'ом:
|
|||
|
|
|
|||
|
|
echo '[^.]*' > application/{logs,cache}/.gitignore
|
|||
|
|
|
|||
|
|
[!!] Git пропускает пустые папки, так что добавляя файл `.gitignore`, мы дополнительно заставляем git учитывать данную директорию, но не файлы внутри нее.
|
|||
|
|
|
|||
|
|
Теперь загружаем файлы `index.php` и `bootstrap.php`:
|
|||
|
|
|
|||
|
|
wget http://github.com/kohana/kohana/raw/master/index.php
|
|||
|
|
wget http://github.com/kohana/kohana/raw/master/application/bootstrap.php -O application/bootstrap.php
|
|||
|
|
|
|||
|
|
Фиксируем эти изменения:
|
|||
|
|
|
|||
|
|
git add application
|
|||
|
|
git commit -m 'Added initial directory structure'
|
|||
|
|
|
|||
|
|
Это все необходимые изменения. Теперь у Вас имеется приложение, использующее Git для контроля версий.
|
|||
|
|
|
|||
|
|
## Обновление подмодулей
|
|||
|
|
|
|||
|
|
Скорее всего, на определенном этапе Вы захотите обновить свои подпроекты. Чтобы обновить все модули до последних версий `HEAD`, введите:
|
|||
|
|
|
|||
|
|
git submodule foreach 'git checkout master && git pull origin master'
|
|||
|
|
|
|||
|
|
Для синхронизации подпроекта `system` выполните:
|
|||
|
|
|
|||
|
|
cd system
|
|||
|
|
git checkout master
|
|||
|
|
git pull
|
|||
|
|
cd ..
|
|||
|
|
git add system
|
|||
|
|
git commit -m 'Updated system directory'
|
|||
|
|
|
|||
|
|
Обновление отдельного модуля до определенной ревизии:
|
|||
|
|
|
|||
|
|
cd modules/database
|
|||
|
|
git fetch
|
|||
|
|
git checkout fbfdea919028b951c23c3d99d2bc1f5bbeda0c0b
|
|||
|
|
cd ../..
|
|||
|
|
git add database
|
|||
|
|
git commit -m 'Updated database module'
|
|||
|
|
|
|||
|
|
Заметьте, что можно так же загрузить коммит по официальной метке релиза. Например:
|
|||
|
|
|
|||
|
|
git checkout 3.0.7
|
|||
|
|
|
|||
|
|
Для того, чтобы увидеть все метки, просто запустите `git tag` без дополнительных аргументов.
|
|||
|
|
|
|||
|
|
Вот и всё!
|