Beiträge aus der Kategorie: TYPO3 CMS

Deployment mit TYPO3 Surf

Den ganzen Tag entwickelt man tolle neue Features, die dann auf einem Testsystem abgenommen werden müssen oder das Licht der Welt auf dem Livesystem erblicken dürfen. Früher hat man dafür den FTP-Client angeschmissen, dann wurde es en vogue alles per SSH zu transferieren und irgendwann wurde alles so komplex, dass man noch Tests vorher ausführen oder das Autoloading von Klassen und Schnittstellen automatisieren wollte. Dadurch wurde dieser Prozess so aufgebläht und kompliziert, dass man gezwungen wurde, diesen auch von Software durchführen zu lassen, um ja nichts zu vergessen oder Fehler zu übersehen.
Neben Travis CI und Codeship gibt es noch für PHP Deployer, die einem auf die ein oder andere Art den Deployment-Prozess abnehmen.

Da TYPO3 das Beste System der Welt ist (höhöhö) gibt es hierfür noch aus den Zeiten von TYPO3 Flow das Deployment-Tool TYPO3 Surf, das unter der Obhut von Helmut Hummel (und ganz vielen anderen Entwicklern) gepflegt wird. TYPO3 Surf setzt darauf auf, dass ein Projekt auf Basis von git und composer erstellt wird und man noch die TYPO3 Console verwendet. Recht viele Anforderungen auf den ersten Blick. Aber wer setzt denn noch TYPO3-Installationen ohne composer auf?

Wie man composer und TYPO3 Surf installiert, wird bestens auf deren Seiten beschrieben und dann kann man sich von mir das Repository ziehen, in der alles vorhanden ist, um sich erstmal lokal eine Entwicklungsumgebung mit allen benötigten Dateien für ein Deployment mit TYPO3 Surf aufzubauen.
Das ganze Script ist noch nicht ganz fertig, es basiert leider darauf, dass eine Datenbank auf dem Livesystem mit den benötigten TYPO3-Tabellen existiert. Und die entsprechenden Konfigurationsdateien müssen auch erstmal in das eigene Repository. Von daher muss man leider noch folgende Schritte ausführen, bis man deployen kann:

  1. "composer install" ausführen, um erstmal lokal die TYPO3-Installation anstoßen zu können.
  2. Dann führt man wie gewohnt die TYPO3-Installation aus, damit wir die Datenbank erhalten, die auf das Livesystem importiert wird.
  3. In der Datei web/typo3conf/LocalConfiguration.php werden die entsprechenden Parameter für das Live-System gemacht, für das Entwicklungssystem werden die Parameter in der Datei web/Configuration/Development.php gesetzt. Diese wird verwendet, wenn man den Application-Context von TYPO3 auf Development während der Entwicklung setzt.
  4. Die Datei .surf/typo3-surf-base-installation.php muss auch noch angepasst werden. Hier müssen Hostname, SSH-User, der Pfad zur PHP-Datei, der Deployment-Pfad und das git-Repository gesetzt werden. Letzteres ist das eigene Repository, in der zwar ein Klon meines Repositories sitzt. Aber mit allen jetzt gemachten Änderungen in den Konfigurationsdateien.
  5. Die Änderungen werden in den Master-Branch des Repositories gepushed.
  6. Im Terminal der Wahl wird im Hauptverzeichnis des Repositories der Befehl "surf deploy typo3-surf-base-installation" ausgeführt. Sollte die Datei im Verzeichnis .surf umbenannt worden sein, den Befehl entsprechend anpassen.
  7. Staunen.

Zum Schluss muss nur noch der vHost-Eintrag des Livesystems auf den Ordner "releases/current/web" unterhalb des Deployment-Pfades verweisen und schon hat man sein erstes "deploytes" TYPO3-System. Viel Spaß.

In der kommenden Zeit werde ich mich noch damit auseinandersetzen, wie man die Datenbank auf dem Livesystem per Deployment und TYPO3 Console "frisch" hält und was vor allem bei zukünftigen Deployments zu beachten ist.

Update: Jan Kiesewetter von t3easy hat auf dem letzten TYPO3Camp in Stuttgart einen Talk zu TYPO3 Surf gehalten. Die Slides kann man sich bei ihm anschauen.

Backendmodule von TYPO3 6.2 nach TYPO3 7.6 migrieren

Momentan migriere ich ein paar TYPO3-Installation von Version 6.2 auf die LTS-Version 7.6 als Zwischenschritt um dann auf die neue LTS-Version 8.7 gehen zu können. Dabei sind mir ein paar kleine Backend-Module vor die Füße gefallen, deren Sinn meistens darin besteht, Daten aufzubereiten und anzuzeigen oder eine Import-Schnittstelle für CSV-/XML-Dateien bereitstellen.
Eigentlich würde ich eher dazu tendieren, diesen Update-Schritt dafür zu nutzen, den bestehenden Code zu refakturieren um von piBase/AbstractController-Extensions zu Extbase-basierten Erweiterungen zu kommen. Das ist den meisten Kunden aber schlichtweg zu teuer, von daher bleibt einem manchmal nur übrig, den minimalen Weg zu gehen.

Ich habe diverse Backend-Module mit folgenden Klassen-/Namespace-Ersetzungen wieder zum Laufen bekommen. Diese Erweiterungen sind aber wirklich nur klein und auch nicht mehrsprachig gehalten. In dieser Beziehung konnte ich leider keine Erfahrungen sammeln.

$LANG => $GLOBALS["LANG"]

$BE_USER => $GLOBALS['BE_USER']

t3lib_SCbase => \TYPO3\CMS\Backend\Module\BaseScriptClass

t3lib_BEfunc => \TYPO3\CMS\Backend\Utility\BackendUtility

t3lib_div => \TYPO3\CMS\Core\Utility\GeneralUtility

$page = t3lib_div::makeInstance('t3lib_pageSelect'); => $page = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\CMS\Frontend\Page\PageRepository');

$template = t3lib_div::makeInstance('t3lib_TStemplate'); => $template = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\CMS\Core\TypoScript\TemplateService');

$this->doc = t3lib_div::makeInstance('mediumDoc'); => $this->doc = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Backend\\Template\\DocumentTemplate');

$this->doc = t3lib_div::makeInstance('template'); => $this->doc = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Backend\\Template\\DocumentTemplate');

Über den Weg Gelaufenes in KW12

Diese Woche lag im Zeichen des Frühlingsanfangs und irgendwie gab es wenig Artikel, die ich mir überhaupt zum Lesen markiert habe. Lag vielleicht aber auch daran, dass ich wenig dazu kam, meine RSS-Feeds zu scannen.

  • Wunschliste für die Integration von composer in TYPO3 Alexander Schnitzler hat auf Github einige Zeilen geschrieben, wie er sich selber die Integration von composer für TYPO3 vorstellt. Die Kommentare sind lesenswert, weil sie noch mehr Punkte aufgreifen.
  • Karabiner-Elements Tool, mit dem ich die Media-Tasten von macOS auf meine Pok3r-Tastatur legen konnte. Endlich.
  • Interview mit Donald Trump mit dem Time-Magazin Auf der einen Seite total faszinierend, wie so jemand Präsident eines riesengroßen und vor allem bunten Staat werden kann. Auf der anderen Seite beängstigend.
  • OpenEmu - Emulator für diverse Systeme Auf der Suche nach einem SNES-Emulator für den Raspberry Pi drauf gestoßen, ausprobiert und für gut befunden. Alte Spiele auf macOS mit dem PlayStation-Controller spielen. Wunderbar.
  • RetroPie - Emulator für den Raspberry Pi Ich habe es noch nicht ausprobiert, aber das scheint genau das zu sein, was ich für den Mini-Rechner benötige. Wenn das wirklich mit einem PlayStation-Controller zu koppeln ist, wird mein Sohnemann das hoffentlich wie ich hervorragend finden.
  • Der letzte Brand Faszinierendes Interview eines Workaholic und in Perfektion versessenen Mannes, der nicht zum ersten Mal alles hinschmeisst, weil es nur noch betriebswirtschaftliche Maximierung für seine Tätigkeit gibt. Nicht nur, dass ich Monkey 47 immer noch allen anderen Gins bevorzuge, weil er für mich die schönste, fruchtig-würzige Geschmacksnote hat, ich würde gerne mal so einen Williams aus seiner Brennerei probieren. Leider unbezahlbar.

Über den Weg Gelaufenes in KW8

Die letzte Woche war geprägt von Arbeit, selbst gemachtem Freizeitstress und irgendwie viel zu wenig Zeit zum Internet durchforsten oder Podcast hören. Von daher fällt die Liste recht unspektakulär und kurz aus.

  • GitKraken Ausprobiert und für gut befunden, auch wenn ich eigentlich keinen Standalone-Git-Client brauche, da mir der eingebaute Client in PhpStorm reicht. Ich werde dem Kraken aber die nächste Woche mal an seiner Stelle verwenden, vielleicht hat er ja das ein oder andere Feature, was mir mehr zusagt.
  • Anleitung zur Integration des CKEditors in TYPO3 Ich habe leider noch überhaupt keine Zeit gehabt, mir den neuen WYSIWYG-Editor von TYPO3 anzuschauen, obwohl ich den alten RTEHtmlArea mit aller Inbrunst hasse. Auch mal für nächste Woche vornehmen.
  • Cloudbleed Das schlug ja ein wie eine Bombe letzte Woche, auch wenn der nächste Punkt in der Liste viel schlimmer ist. Trotzdem hatte Cloudflare monatelang einen Fehler in seinem SSL-Proxy, der nicht nur den angeforderten SSL-Traffic zum Client auslieferte, sondern auch Teile des SSL-Verkehrs anderer User. Wenn da jemand sich die Mühe gemacht hat über diesen Zeitraum brav mitzusniffen, dürfte jemand jetzt über eine Menge Rohdaten mit Passwörtern und Kreditkarten-Informationen verfügen.
  • Zwei gleiche Hashes darf es nicht geben Ich habe es jetzt nicht überprüft, aber in der dunklen Erinnerung haben früher ziemlich viele Systeme ihre Hash-Verfahren auf SHA1 basieren lassen. Seit Jahren ist dies aber auf dem absteigenden Ast und wird durch andere Verfahren wie RSA ersetzt. Zum Glück.
  • Ist Zelda 1 das bessere Zelda? Ein Video, in dem erörtert wird, dass das erste Zelda das bessere Zelda ist. Weil es in erster Linie den Spieler nicht an die Hand nimmt, wie es fast jedes aktuelle Spiel macht. Ich sollte mir vielleicht doch einen NES Mini besorgen, um zu testen, ob das stimmt. Oder mal schauen, ob es das noch für den 3DS gibt. The Legend of Zelda habe ich zu meiner Schande noch nie gespielt.

Über den Weg Gelaufenes in KW7

An dieser Stelle fange ich mal an, meine Pocket-Liste zu entschlacken, in dem ich erwähnenswerte Sites in solchen Artikeln wochenweise zusammenfasse. Vielleicht gibt es ja den ein oder anderen, der auch gefallen an manchen Artikeln findet. Mich selber soll es dazu bringen, Dinge, die ich mir für später merken möchte, auch wirklich abzuarbeiten. Und sei es nur, sie einfach ungelesen zu löschen.
Den Anfang machen folgende Artikel:

Der wirklich beste Weg, TYPO3-Projekte zu verwalten

Anfang des Sommers hatte ich in einem Artikel meinen ungefähren Aufbau erklärt, wie ich komplexe TYPO3-Projekte, also komplette Installationen von einer oder mehreren Websites verwalte, an denen mehrere Entwickler gleichzeitig arbeiten. Gleichzeitig habe ich im Sommer diesen Aufbau auf den auf seine Funktionsweise überprüft und geschaut, was man verbessern kann. Und so langsam habe ich mein Setting verfeinert, dass ich zufriedener als vorher bin.

Meinen Aufbau, dass ich Extensions per Symlink unterhalb von typo3conf/ext einklinke, die außerhalb des eigentlichen Document-Roots liegen. Das hat sich schon immer als fehlerhaft erwiesen, da TYPO3 nicht wirklich den Symlinks folgt, was darin ausartet, dass Controller nicht geladen werden. Da die meisten selber entwickelten Extensions sowieso kunden- bzw. projektbezogen sind und selten in mehreren Projekten gleichzeitig verwendet werden, werden diese Erweiterungen jetzt direkt per git unterhalb von typo3conf/ext geklont, das Verzeichnis aber aus dem Gesamtprojekt per gitignore ausgeklammert. Die eigentliche TYPO3-Installation wird weiterhin von composer verwaltet, mit dem die üblichen "normalen" Extensions aus dem TER gezogen werden.

Auf einem Testsystem, das grundlegend in gleicher Weise aufgebaut ist wie das Livesystem werden per composer dann nicht nur die TER-Extensions, sondern auch die selber entwickelten Extensions eingebunden. Das geht wunderbar von der Hand und ermöglicht auch die Kontrolle über den Quellcode auf dem Testsystem, da kein Entwickler mehr direkt Code auf dem Testsystem ändern kann bzw. es beim nächsten Update auffällt. Und es dann auf die Finger gibt.

Im nächsten Schritt werden sich jetzt noch Automatic deployment auf Datei- und vor allem Datenbankebene vorgeknöpft, um noch einen Rattenschwanz abzuschlagen, um dem man sich immer kümmern muss. Zeit, die einem zum Entwickeln fehlt und Vorgänge, die immer fehlerbehaftet sein können.

Der beste Weg, um TYPO3-Projekte zu verwalten

Eine anständige Versionsverwaltung von Quellcode ist meiner Meinung nach einer der Grundpfeiler, um funktionalen und vor allem fehlerfreien Code zu schreiben. Vor allem im Team mit mehreren Entwicklern und Projektmanagern.
Aber wie baut man auf Dateiebene ein komplettes TYPO3-Projekt auf? Wie verwaltet man Extensions aus dem TER? Wie bindet man Eigenentwicklungen ein? In den letzten Jahren habe ich für meine Projekte einen entsprechenden Aufbau und Ablauf entwickelt, den ich gerade auf den Prüfstand stelle, um ihn zu verbessern. Verbessern kann man ja immer.

Das gesamte Projekt basiert auf composer und bindet nicht nur die TYPO3-Sourcen, sondern auch alle per TYPO3 Extension Repository Composer Repository erreichbaren Extensions ein. Der Code, der dadurch eingebunden wird, wird per gitignore aus dem Projekt-git ausgeschlossen, Erweiterungen, die nicht per composer installiert werden können, landen aber dann doch in der Versionsverwaltung. Damit alle Entwickler mit dem gleichen Versionsstand arbeiten.

Nur was ist mit den Erweiterungen, die man selber entwickelt und die nicht im TER landen? Man könnte sie natürlich auch per composer und einer eigenen Repository-Verlinkung integrieren. Jede Erweiterung wird in einem separaten git versioniert und in der composer.json lassen sich eigene Repositories verlinken und per require einklinken. Nur heißt das auch, dass man Entwicklungen in den Extensions nicht in diesem Projekt vornehmen kann. Von daher finde ich das zwar den eigentlich konsequenten Weg, der aber so nicht praktikabel umgesetzt werden kann. Man müsste nach Änderungen die Änderungen per composer einladen, um die "Auswirkungen" im Projekt zu sehen und zu testen. Mühsam und zeitaufwendig.

Ich bin dazu übergegangen, die Erweiterungen per Symlink unterhalb von web/typo3conf/ext einzubinden. Der Code liegt außerhalb des Projekt-Verzeichnisbaums in seiner eigenen git-Struktur. Entwickelt wird dann in einer separaten IDE-Instanz. So sind Änderungen in der Erweiterung sofort im eigentlichen TYPO3-Projekt sichtbar, die Repositories aber voneinander getrennt.

Nur bin ich mir nicht mehr so sicher, dass es der beste Weg ist, ein komplettes Projekt zu verwalten. Und ihr so?