5.0 KiB
使用 Git 开发
Kohana 使用 git 作为版本控制并托管在 github 网站上面。本教程将会讲解如何让你使用 Git 并从 github 上部署一个简单的应用。
安装配置 Git
安装 Git
设置全局配置
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
附加偏好设置
为了让 git 命令和版本库在命令行达到更好的视觉效果，你可以额外设置:
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。如果你愿意捐赠代码至社区请遵循此约定。
git config --global core.autocrlf input
git config --global core.savecrlf true
[!!] 关于换行符的更多信息请参见 github
参考资料
部署系统结构
[!!] 开始本教程前务必保证开发环境以及设置完毕，接下来我们要做一个可以通过 http://localhost/gitorial/ 访问的新应用。
打开你的控制台(译者:Windows 平台为命令提示符，*nux 平台为终端)，创建并切换到 gitorial 空目录下面(译者:此目录即为新应用的目录)，执行 git init。这是为当前目录创建一个新的 git 空版本库。
下一步，我们为 system 目录要创建一个 submodule(子模块)。访问 http://github.com/kohana/core 页面并复制克隆(Clone) URL:
现在使用复制后的 URL 去创建 system 子模块:
git submodule add git://github.com/kohana/core.git system
[!!] 上面的链接是 Kohana 为下一个稳定版本准备的当前的开发版本。开发版本几乎是可以拿来做开发的，他拥有当前稳定版本同样的 API 和一些补丁修复。
现在，我们准备添加自己开发所需的子模块。比如你可能需要使用 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 去追踪日志(log)或者缓存(Cache)文件，我们需要为每个目录添加一个 .gitignore 文件。它会忽略所有的非隐藏文件:
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 作为版本控制开发 Kohana 应用了。
更新子模块
有时候你可能也需要更新你的子模块。更新所有子模块至最新的 HEAD 版本:
git submodule foreach 'git checkout master && git pull origin master'
更新单个子模块，比如 system:
cd system
git checkout master
git pull origin master
cd ..
git add system
git commit -m 'Updated system to latest version'
如果你要更新单个子模块到指定的版本库:
cd modules/database
git pull origin master
git checkout fbfdea919028b951c23c3d99d2bc1f5bbeda0c0b
cd ../..
git add database
git commit -m 'Updated database module'
完成！