5.5 KiB
Werken met Git
Kohana gebruikt git als versie controle systeem en github voor community-bijdragen. Deze tutorial zal je tonen hoe je beide platformen kunt gebruiken om een applicatie op te zetten.
Het installeren en instellen van Git op uw computer
Installeren van Git
- OSX: Git-OSX
- Windows: Msygit
- Of download het van de git-site en installeer het manueel (zie de git website)
Basis globale instellingen
git config --global user.name "Uw Naam"
git config --global user.email "uwemail@website.com"
Extra, maar aan te raden instellingen
Om een beter visueel overzicht te hebben van de git commando's en repositories in je console stel je best volgende in:
git config --global color.diff auto
git config --global color.status auto
git config --global color.branch auto
Automatische aanvulling installeren
[!!] Deze lijnen code zijn enkel van toepassing voor OSX
Deze lijnen code doen al het vuile werk voor je zodat automatische aanvulling kan werken voor uw git-omgeving
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
Gebruik altijd LF als regeleinden
Dit is de conventie die we maken met Kohana. Stel deze instellingen voor uw eigen goed en vooral als je wilt bijdragen aan de Kohana community.
git config --global core.autocrlf input
git config --global core.savecrlf true
[!!] Meer informatie over regeleinden kan je vinden op github
Meer informatie op je op weg te zetten
Initiële structuur
[!!] Deze tutorial zal ervan uitgaan dat uw webserver al is ingesteld, en dat je een nieuwe applicatie zal maken op http://localhost/gitorial/.
Met behulp van je console, ga naar de lege map gitorial en voer git init uit. Dit zal een ruwe structuur voor een nieuwe git repository aanmaken.
Vervolgend zullen we een submodule maken voor de system folder. Ga naar http://github.com/kohana/core en kopieer de "Clone URL":
Gebruik nu de URL om de submodule aan te maken voor system:
git submodule add git://github.com/kohana/core.git system
[!!] Dit creëert een link naar de huidige ontwikkelingsversie voor de volgende stabiele uitgave. De ontwikkelingsversie is meestal veilig om te gebruiken, het heeft dezelfde API als de huidige stabiele download maar met bugfixes al toegepast.
Voeg nu elke submodule toe dat je wil. Bijvoorbeeld als je de [Database] module nodig hebt:
git submodule add git://github.com/kohana/database.git modules/database
Nadat de submodules zijn toegevoegd, moet je ze nog initialiseren:
git submodule init
Nu dat de submodules zijn toegevoegd en geinitialiseerd, kan je ze commit'en:
git commit -m 'Added initial submodules'
Vervolgens creëren we de applicatie folder structuur. Hier is een absoluut minimum vereist:
mkdir -p application/classes/{controller,model}
mkdir -p application/{config,views}
mkdir -m 0777 -p application/{cache,logs}
Als je nu find application uitvoert, moet je dit zien:
application
application/cache
application/config
application/classes
application/classes/controller
application/classes/model
application/logs
application/views
We willen niet dat git de log of cache bestanden volgt dus voegen we een .gitignore bestand toe aan deze folders. Dit zal alle niet-verborgen bestanden negeren:
echo '[^.]*' > application/{logs,cache}/.gitignore
[!!] Git negeert lege folders, dus het toevoegen van een .gitignore bestand zorgt er voor dat git de folder volgt maar niet de bestanden er in.
Nu hebben we nog de index.php en bootstrap.php bestanden nodig:
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
Commit deze veranderingen ook:
git add application
git commit -m 'Added initial directory structure'
Dit is alles wat je nodig hebt. Je hebt nu een applicatie dat Git gebruikt als versiesysteem.
Updaten van Submodules
Op een gegeven moment zal je waarschijnlijk ook je submodules willen upgraden. Om al je submodules te updaten naar de laatste "HEAD" versie:
git submodule foreach 'git checkout master && git pull origin master'
Om een enkele submodule te update, bijvoorbeel system:
cd system
git checkout master
git pull origin master
cd ..
git add system
git commit -m 'Updated system to latest version'
Als je een enkele submodule wilt updaten naar een specifieke commit:
cd modules/database
git pull origin master
git checkout fbfdea919028b951c23c3d99d2bc1f5bbeda0c0b
cd ../..
git add database
git commit -m 'Updated database module'
Merk op dat je ook een commit kunt uitchecken via een tag, zoals een officieel versie, bijvoorbeeld:
git checkout 3.0.6
Voer gewoon git tag uit zonder parameters om een lijst van alle tags te krijgen.
U weet nu "alles" over git!