git

TYPO3 Flow über HTTP- statt GIT-Protokoll mittels Composer laden

caticonslite_bm_alt

Aufgrund von erhöhter Verwendung des Git-Protokolls am Git-Server von TYPO3 wird die Anzahl der maximal erlaubten Verbindungen überschritten und daher Verbindungen vom Server verworfen. Bei der Installation von TYPO3 Flow mittels Composer (z.B. „composer create-project –dev –keep-vcs typo3/flow-base-distribution Quickstart“) äußert sich das mit der folgenden Fehlermeldung:

[RuntimeException]                                                                                                                                                                                                  
Failed to execute git clone --no-checkout 'git://git.typo3.org/Flow/Distributions/Base.git' 'Quickstart/' && cd 'Quickstart/' && git remote add composer 'git://git.typo3.org/Flow/Distributions/Base.git' && git fetch composer  
fatal: read error: Die Verbindung wurde vom Kommunikationspartner zurückgesetzt

Dieses Problem lässt sich umgehen, indem man in Git alternative URLs zur Verwendung konfiguriert. Für typo3/flow-base-distribution ist das:

git config --global url."http://git.typo3.org/Flow/Distributions/Base.git".insteadOf "git://git.typo3.org/Flow/Distributions/Base.git"
git config --global url."http://git.typo3.org/Packages/TYPO3.Flow.git".insteadOf "git://git.typo3.org/Packages/TYPO3.Flow.git"
git config --global url."http://git.typo3.org/Packages/TYPO3.Fluid.git".insteadOf "git://git.typo3.org/Packages/TYPO3.Fluid.git"
git config --global url."http://git.typo3.org/Packages/TYPO3.Eel.git".insteadOf "git://git.typo3.org/Packages/TYPO3.Eel.git"
git config --global url."http://git.typo3.org/Packages/TYPO3.Welcome.git".insteadOf "git://git.typo3.org/Packages/TYPO3.Welcome.git"
git config --global url."http://git.typo3.org/Packages/TYPO3.Party.git".insteadOf "git://git.typo3.org/Packages/TYPO3.Party.git"
git config --global url."http://git.typo3.org/Packages/TYPO3.Kickstart.git".insteadOf "git://git.typo3.org/Packages/TYPO3.Kickstart.git"
git config --global url."http://git.typo3.org/Flow/BuildEssentials.git".insteadOf "git://git.typo3.org/Flow/BuildEssentials.git"

Git-Problem „‚git status –porcelain‘ failed in submodule“ beheben

$ git status
error: cannot fork() for status: Cannot allocate memory
fatal: Could not run 'git status --porcelain' in submodule typo3_src
fatal: 'git status --porcelain' failed in submodule typo3_src

Die oben genannten Fehlermeldungen sind auf ein kaputtes .git-Verzeichnis/Repository im genannten Submodule zurückzuführen. Das Problem lässt sich wie folgt beheben:

rm -Rf typo3_src/
git checkout typo3_src
git submodule update

Installation von TYPO3 6.2 mit Git

caticonslite_bm_alt

Die Verwendung von Git als Versionverwaltung für TYPO3 (Version Control System – VCS) ist unbedingt zu empfehlen, schließlich ergeben sich u.a. folgende Vorteile daraus:

  • Der eigene Code ist versioniert, d.h. sollte es zu Problemen kommen, kann die funktionierende Version einfach wiederhergestellt werden.
  • Der TYPO3 Core wird als Git-Submodule eingebunden, somit ist das Einspielen von Core-Patches (z.B. nach Sicherheitslücken) binnen Sekunden erledigt.

Die Installation von TYPO3 mit Git hat sich im Vergleich zu den Vorgängerversionen seit Version TYPO3 6.2 sehr vereinfacht:

1. Initialisieren eines leeren Git-Repositories im Webverzeichnis (z.B. „public_html/“):

git init

2. TYPO3-Core („typo3_src“) als Git-Submodule einbinden und in das Verzeichnis wechseln:

git submodule add git://git.typo3.org/Packages/TYPO3.CMS.git typo3_src
cd typo3_src/

3. Anzeigen der verfügbaren Tags (TYPO3 Core-Versionen):

git tag

4. Checkout des TYPO3 Core in der gewünschten Version (in diesem Fall 6.2.4):

git checkout tags/TYPO3_6-2-4

5. Wechsel zurück in das Webverzeichnis und anlegen der erforderlichen Symlinks:

cd ..
ln -s typo3_src/index.php
ln -s typo3_src/typo3

6. Kopieren der .htaccess-Datei für URL-Rewriting, etc.:

cp typo3_src/_.htaccess .htaccess

7. Ausschließlich „Programmcode“ soll im Git-Repository versioniert werden, daher werden „Benutzerdaten“ (z.B. hochgeladene Bilder, Dokumente) und weitere für die Versionierung nicht relevante Dateien/Ordner ausgenommen:

echo "# User
/fileadmin/
/uploads/
# Deprecation-Log
/typo3conf/deprecation*
# Enable Install Tool
/typo3conf/ENABLE_INSTALL_TOOL
# SQL
/typo3conf/*.sql
/typo3conf/*.sql.gz
# Temp
/typo3conf/temp_*
/typo3temp/
# IDE & OS
/.DS_Store
/.idea/
/nbproject/
*.swp
" > .gitignore

8. Initial commit im CommitMessage-Format für TYPO3:

git add .
git commit -a -m "[TASK] initial commit"

Die Verzeichnisse „fileadmin“, „uploads“,… und deren Unterverzeichnisse werden während der Installation automatisch angelegt, mit der nun im Browser begonnen werden kann.

Installation von TYPO3 6.1 mit Git

caticonslite_bm_alt

TYPO3 verwendet bereits seit längerer Zeit (seit 1. März 2011 um genau zu sein) Git als Versionverwaltung (Version Control System – VCS). Aus diesem Grund bietet es sich an, auch für eigene TYPO3-Projekte Git einzusetzen, da sich daraus einige Vorteile ergeben, z.B. die Einbindung und somit einfache Aktualisierung des TYPO3-Core als Submodule.

1. Laden des „Dummy“-Archivs (in diesem Fall Version 6.1.1):

wget http://prdownloads.sourceforge.net/typo3/dummy-6.1.1.tar.gz?download

2. Entpacken und verschieben des „Dummy“-Archivs (in diesem Fall in den Ordner „public_html“):

tar xzf dummy-6.1.1.tar.gz?download
mv dummy-6.1.1 public_html

Das „Dummy“-Archiv wird nicht mehr benötigt und kann daher gelöscht werden.

3. Erstellen des Git-Repository (zuerst ins Verzeichnis wechseln):

cd public_html/
git init

4. Entfernen nicht benötigter Dateien/Symlinks (u.a. aus Sicherheitsgründen):

rm *.txt
rm typo3_src

5. TYPO3-Core („typo3_src“) als Git-Submodule einbinden:

git submodule add git://git.typo3.org/Packages/TYPO3.CMS.git typo3_src

6. Checkout von Core und dessen Submodules (Extbase, etc.) in der gewünschten Version (in diesem Fall 6.1.1):

cd typo3_src
git checkout tags/TYPO3_6-1-1
git submodule update --init --recursive
cd ..

Vorhandene Versionen können mit „git tag“ angezeigt werden.

7. Nur „Programmcode“ sollte ins Git-Repository, daher werden „Benutzerdaten“ (z.B. hochgeladene Bilder, Dokumente) und weitere für die Versionverwaltung nicht interessante Dateien/Ordner ausgenommen:

echo "# User
/fileadmin/
/uploads/
# Deprecation-Log
/typo3conf/deprecation*
# Enable Install Tool
/typo3conf/ENABLE_INSTALL_TOOL
# SQL
/typo3conf/*.sql
# Cache
/typo3conf/temp_CACHED*
/typo3conf/temp_fieldInfo.php
# Temp
/typo3temp/
" > .gitignore

8. Initial commit im CommitMessage-Format für TYPO3:

git add .
git commit -a -m "[TASK] initial commit"

Nun kann wie gewohnt mit Git gearbeitet werden.

TypoScript in externe Dateien auslagern

caticonslite_bm_alt

TypoScript lässt sich in externe Dateien auslagern, welche man dann in den jeweiligen Konfigurationen (Constants, Setup, PageTS und UserTS) inkludieren kann:

<INCLUDE_TYPOSCRIPT: source="FILE:fileadmin/templates/TypoScript/setup.ts">
<INCLUDE_TYPOSCRIPT: source="FILE:EXT:webentwickler/Configuration/TypoScript/setup.ts">

Dies Vorgehensweise ist besonders dann sinnvoll, wenn man eine Grundkonfiguration/Framework für seine häufig benutzten Extensions angelegt hat, eine Versionsverwaltung (z.B. Git, Subversion oder Mercurial) einsetzt, oder mit mehreren Servern (z.B.: Development, Testing, Staging, Production) arbeitet.

 nach oben