Installation von vBulletin mit UTF-8

Beim Versuch die deutsche Version von vBulletin zu installieren stellte ich fest, dass die Default-Konfiguration kein UTF-8 verwendet. Nach der Installation sah ich unvollständige Strings im Forum und in den Posts. Die Ursache war, dass Strings mit deutschen Umlauten abgeschnitten wurden. Nach unzähligen Stunden fand ich endlich einen Weg, um vBulletin korrekt mit UTF-8 zu installieren. Dies hier ist keine vollständige Installationsanleitung, dazu bitte die Originaldokumentation lesen. Ich führe nur die Schritte auf, die für UTF-8 notwendig sind, was das ganze hoffentlich auch etwas übersichtlicher belässt.

Der erste Schritt ist zu prüfen ob MySQL denn vollständig mit UTF-8 läuft.

mysql> show variables like '%char%';
+--------------------------+----------------------------+
| Variable_name | Value |
+--------------------------+----------------------------+
| character_set_client | utf8 |
| character_set_connection | utf8 |
| character_set_database | utf8 |
| character_set_filesystem | binary |
| character_set_results | utf8 |
| character_set_server | utf8 |
| character_set_system | utf8 |
| character_sets_dir | /usr/share/mysql/charsets/ |
+--------------------------+----------------------------+
8 rows in set (0.00 sec)

Dann prüft man die Forums-Datenbank selbst auf UTF-8.

mysql> show create database ForumDB;
+--------------------+-----------------------------------------------------------------------------+
| Database | Create Database |
+--------------------+-----------------------------------------------------------------------------+
| ForumDB | CREATE DATABASE `ForumDB` /*!40100 DEFAULT CHARACTER SET utf8 */ |
+--------------------+-----------------------------------------------------------------------------+
1 row in set (0.00 sec)

Sobald man die vBulletin-Software entpackt hat muss die Hauptkonfigurationsdatei upload/includes/config.php angepasst werden.
Die folgende Zeile muss aktiviert sein:

$config['Mysqli']['charset'] = 'utf8';

Als nächstes konvertieren wir den Zeichensatz von zwei Sprachdateien von Latin1 nach UTF-8. Das Kommando recode ist ein Linux-Shellkommando und sollte standardmäßig vorhanden sein.

recode latin1..utf8 upload/install/vbulletin-language-de-du.xml
recode latin1..utf8 upload/install/vbulletin-language.xml

Nach diesem Schritt kann man das Installationsskript von vBulletin laufen lassen. Noch sieht man abhackte Strings wegen den deutschen Umlauten, die jedoch während der nächsten Schritte verschwinden werden.

Danach müssen die deutschen Sprachdateien (vbulletin-language-de-du.xml, vbulletin-language.xml) importiert werden. Dazu geht man in den Administrationsbereich von vBulletin und importiert die Datei vbulletin-language-de-du.xml vom Server mit Hilfe der Spracheinstellungen und wählt die Sprache in der Dropdown-Liste aus.

Dann ändert man den HTML-Zeichensatz in den Spracheinstellungen von ISO-8859-1 nach UTF-8. Zuletzt aktualisiert man die angezeigte Seite im Browser und schon sind alle Strings so wie sie sein sollen, mit allen Sonderzeichen und Umlauten.