Artikel von: Gernot Leitgab

TYPO3 Composer-Installation schlägt auf Plesk fehl

caticonslite_bm_alt

In der Datei „composer.json“ von TYPO3 is für „post-autoload-dump“ ein Script definiert:

"scripts":{
   "typo3-cms-scripts": [
      "typo3cms install:fixfolderstructure",
      "typo3cms install:generatepackagestates"
   ],
   "post-autoload-dump": [
      "@typo3-cms-scripts"
   ]
}

Dieses Script wird nach jeder Generierung der Autoload-Information ausgeführt, z.B. beim „composer install“ oder „composer dump-autoload“. Erfüllt der Standard-PHP-Interpreter auf dem Command Line Interface (CLI) nicht die Versionsvoraussetzungen von TYPO3, so schlägt die Ausführung von z.B. „/opt/plesk/php/7.2/bin/php composer.phar install“ mit folgender bzw. einer ähnlichen Fehlermeldung fehl:

PHP Warning:  Unsupported declare 'strict_types' in /var/www/vhosts/webentwickler.at/httpdocs/vendor/helhum/typo3-console/Scripts/typo3-console.php on line 2
PHP Parse error:  syntax error, unexpected '(' in /var/www/vhosts/webentwickler.at/httpdocs/vendor/helhum/typo3-console/Scripts/typo3-console.php on line 32
Script typo3cms install:fixfolderstructure handling the typo3-cms-scripts event returned with error code 255
Script @typo3-cms-scripts was called via post-autoload-dump

Der Fehler kann behoben werden, indem bei den Scripts der zu verwendende PHP-Interpreter und der Pfad zum Binary-Verzeichnis von Composer ergänzt werden:

"scripts":{
   "typo3-cms-scripts": [
      "/opt/plesk/php/7.2/bin/php /var/www/vhosts/webentwickler.at/httpdocs/vendor/bin/typo3cms install:fixfolderstructure",
      "/opt/plesk/php/7.2/bin/php /var/www/vhosts/webentwickler.at/httpdocs/vendor/bin/typo3cms install:generatepackagestates"
   ],
   "post-autoload-dump": [
      "@typo3-cms-scripts"
   ]
}

Anschließend können „composer install“ oder „composer dump-autoload“ ausgeführt werden.

Declaration of TYPO3 CMS Composer Installers not compatible

caticonslite_bm_alt

Wenn nach der Aktualisierung der PHP-Version beim Ausführen von „/usr/bin/php72 composer.phar“ install folgende Fehlermeldung erscheint:

PHP Fatal error: Declaration of TYPO3\CMS\Composer\Installer\Downloader\T3xDownloader::download(Composer\Package\PackageInterface $package, $path) must be compatible with Composer\Downloader\ArchiveDownloader::download(Composer\Package\PackageInterface $package, $path, $output = true) in /var/www/vendor/typo3/cms-composer-installers/src/Installer/Downloader/T3xDownloader.php on line 27
Fatal error: Declaration of TYPO3\CMS\Composer\Installer\Downloader\T3xDownloader::download(Composer\Package\PackageInterface $package, $path) must be compatible with Composer\Downloader\ArchiveDownloader::download(Composer\Package\PackageInterface $package, $path, $output = true) in /var/www/public_html/vendor/typo3/cms-composer-installers/src/Installer/Downloader/T3xDownloader.php on line 27

So müssen zuerst die TYPO3 CMS Composer Installers mit folgendem Befehl aktualisiert werden:

/usr/bin/php72 composer.phar require typo3/cms-composer-installers:~1.5.2 --no-plugins --update-no-dev

Anschließend kann wie gewohnt ein composer install durchgeführt werden:

/usr/bin/php72 composer.phar install --no-dev

Weiterleitung von HTTP auf HTTPS

caticonslite_bm_alt

Im Chromium Blog wurde angekündigt, dass mit Veröffentlichung von Chrome 68 im Juli 2018 alle via HTTP abgerufenen Seiten als „Nicht sicher“ in der Adressleiste gekennzeichnet werden. Dank Diensten wie Let’s Encrypt oder Cloudflare ist die Aktivierung eines SSL- bzw. TLS-Zertifikats heutzutage einfach und kostenlos möglich. Um die Weiterleitung von HTTP auf HTTPS für die Webseite zu aktivieren ist folgende Apache-Konfiguration (z.B in der .htaccess-Datei) erforderlich:

RewriteEngine On
RewriteCond %{HTTP_HOST} =blog.webentwickler.at
RewriteCond %{HTTPS} !=on
RewriteCond %{HTTP:X-Forwarded-Proto} !=https
RewriteRule .* https://%{SERVER_NAME}%{REQUEST_URI} [R=301,L]

Jede RewriteCond muss für die nachfolgende RewriteRule zutreffen, damit diese angewandt wird. In diesem Fall muss der Hostname „blog.webentwickler.at“ lauten und die Environment-Variable „HTTPS“ darf nicht „on“ sein und „HTTP:X-Forwarded-Proto“ darf nicht „https“ sein, damit die Weiterleitung auf die HTTPS-Adresse erfolgt. Die Überprüfung von „HTTPS“ ist für direkt auf Apache aufgeschaltete Domains erforderlich, „HTTP:X-Forwarded-Proto“ kommt im Falle eines Reverse-Proxy (z.B. NGINX oder Varnish) oder Cloudflare zum Tragen.

Verwendung von vimdiff als git mergetool

Beim ersten Merge-Konflikt schlägt git zwar i.d.R. ein Mergetool vor, mit dem folgenden Befehl kann vimdiff aber bereits vorab konfiguriert werden:

git config global merge.tool vimdiff

Der Aufruf des Mergetools nach einem Merge-Konflikt (z.B.: „CONFLICT (content): Merge conflict in test.txt“) erfolgt mit:

git mergetool

Daraufhin öffnet sich vimdiff mit mehreren Fenstern (eigentlich: „Buffer“ in der Split-Ansicht), die folgende Bezeichnungen tragen:

  • „LOCAL“ (kurz: „LO“): Aktueller Branch/Zweig.
  • „BASE“ (kurz: „BA“): Gemeinsamer Vorgänger (Zustand vor LOCAL- bzw. REMOTE-Änderungen).
  • „REMOTE“ (kurz: „RE“): Branch/Zweig der mittels „git merge“ mit LOCAL hätte zusammengefügt werden sollen.
  • „MERGED“ (bzw. keine Bezeichnung, kurz: „ME“): Gewünschtes Merge-Ergebnis.

Zwischen den Fenstern kann mit „Strg + w“ bzw. „Ctrl + w“ navigiert werden, das ist grundsätzlich nicht erforderlich, da sämtliche Arbeiten in „MERGED“ ausgeführt werden können/sollen.
Die häufigsten erforderlichen Befehle sind (jeweils ohne Anführungszeichen auszuführen):

  • „]c“: Nächster Unterschied.
  • „[c“: Vorheriger Unterschied.
  • „zo“: Text einblenden.
  • „zc“: Text ausblenden.
  • „:diffupdate“: Dateien erneut auf Unterschiede überprüfen.
  • „:diffget RE“ (statt „RE“ kann z.B. auch „LO“ angegeben werden): Änderung von „REMOTE“ übernehmen.

Nachdem alle Unstimmigkeiten beseitigt worden sind, können wie gewohnt mit „:wqa“ alle Fenster gespeichert und geschlossen und mit „git commit“ fortgefahren werden.

TYPO3 mit Komprimierung auf Plesk-Host mit Reverse Proxy nginx

caticonslite_bm_alt

Wird in TYPO3 die Frontend-Komprimierung mit „$GLOBALS[‚TYPO3_CONF_VARS‘][‚FE‘][‚compressionLevel‚] = 9″ und in den TypoScript-Setup-Einstellungen „config.compressJs“ bzw. „config.compressCss“ aktiviert, werden statische „pre-rendered“ JavaScript- und CSS-Dateien im gzip-Format im Ordner „typo3temp/compressor“ abgelegt. Für die korrekte Auslieferung ist für Apache (z.B. in der Datei .htaccess) die folgende Konfiguration erforderlich:

<FilesMatch "\.js\.gzip$">
	AddType "text/javascript" .gzip
</FilesMatch>
<FilesMatch "\.css\.gzip$">
	AddType "text/css" .gzip
</FilesMatch>
AddEncoding gzip .gzip

Seit Plesk 12 wird nginx als Reverse Proxy eingesetzt und statische Dateien werden nicht mehr von Apache, sondern direkt von nginx ausgeliefert. Das führt dazu, dass nginx die Dateien zwar mit dem korrekten „Content-Type“, aber ohne erforderliches „Content-Encoding: gzip“ im HTTP-Header ausliefert und infolgedessen die Dateien vom Browser falsch (so als wären sie nicht komprimiert) interpretiert werden. Analog zur o.g. Konfiguration für Apache ist auch eine Konfiguration für nginx erforderlich: In Plesk kann unter „Einstellungen für Apache & nginx“ der Domain entweder die Option „Intelligente Bearbeitung statischer Dateien“ deaktiviert werden (nicht empfohlen), oder folgende Konfiguration unter „Zusätzliche nginx-Anweisungen“ hinterlegt werden:

location ~ "\.js\.gzip$" {
	add_header Content-Encoding gzip;
	gzip off;
	types { text/javascript gzip; }
}
location ~ "\.css\.gzip$" {
	add_header Content-Encoding gzip;
	gzip off;
	types { text/css gzip; }
}

Diese Konfiguration bringt nginx dazu die komprimierten JS- und CSS-Dateien analog zu Apache zu behandeln und das erforderliche „Content-Encoding: gzip“ im HTTP-Header zu setzen.

1 2 3 … 8  nach oben