🚀 WHMCS-Migrations-Guide: Volle Emoji-Unterstützung durch UTF8MB4

WHMCS-Datenbank-Upgrade: Volle Emoji-Unterstützung durch UTF8MB4

Um die volle Unterstützung für Emojis (z.B. 🌍, 🎉, 🚀) und erweiterte mehrsprachige Zeichen in Ihrer WHMCS-Installation zu gewährleisten, ist ein Upgrade des MySQL/MariaDB-Zeichensatzes auf den 4-Byte-Standard utf8mb4_unicode_ci notwendig.

Diese Anleitung verwendet ein optimiertes Bash-Skript, das die Datenbankzugangsdaten automatisch aus Ihrer configuration.php liest und die Konvertierung als Root auf dem Server durchführt.

⚠️ Achtung: Die Durchführung dieses Upgrades erfolgt auf eigene Gefahr. Ein vollständiges Backup Ihrer Datenbank ist zwingend erforderlich!

💾 Schritt 1: Das Migrations-Skript vorbereiten und hochladen

Das Skript whmcs_db_migrate.sh wurde mit erweiterten Sicherheits- und Automatisierungsfunktionen aktualisiert:

• Intelligente Prüfung: Das Skript prüft, ob die Datenbank bereits auf utf8mb4_unicode_ci umgestellt ist. Ist dies der Fall, gibt es eine Erfolgsmeldung aus und beendet den Vorgang.
• Sicheres Backup: Es erstellt ein vollständiges SQL-Backup der Datenbank und gibt den genauen Speicherpfad aus.
• Automatisches Patching: Es passt die configuration.php an, indem es ältere Charset-Variablen auskommentiert und die neue Variable $db_charset = 'utf8mb4'; hinzufügt.
• Selbstlöschung (💣): Nach erfolgreicher Migration oder erfolgreicher Prüfung auf Konvertierung löscht sich das Skript selbst vom Server, um die Offenlegung der Datenbankzugangsdaten zu verhindern.

Laden Sie das Skript herunter und legen Sie es im Hauptverzeichnis Ihrer WHMCS-Installation ab (dort, wo sich die configuration.php befindet).

Download-Link zum Skript (Bitte anpassen): whmcs_db_migrate.sh herunterladen

🖥️ Schritt 2: Skript per SSH ausführen

Nach dem Hochladen melden Sie sich per SSH auf dem Server an. Gehen Sie in das Verzeichnis, in dem die WHMCS-Dateien liegen (Beispiel: /var/www/vhosts/example.com/httpdocs), und führen Sie die Befehle aus:

1. Zum Verzeichnis wechseln (Beispielpfad):

cd /var/www/vhosts/example.com/httpdocs

2. Ausführungsrechte vergeben:

chmod +x whmcs_db_migrate.sh

3. Skript ausführen (als Root oder mit sudo):

./whmcs_db_migrate.sh

Das Skript führt nun die notwendigen Schritte durch. Nach Beendigung wird die Meldung zur **Selbstlöschung** angezeigt und die Skriptdatei vom Server entfernt.

⚙️ Schritt 3: WHMCS-Konfiguration abschließen

Nach erfolgreicher Skriptausführung (die das automatische Patching der configuration.php beinhaltet) müssen Sie einen letzten manuellen Schritt in der WHMCS-Admin-Oberfläche durchführen:

1. WHMCS-Admin-Einstellung deaktivieren

Da Ihre Datenbank nun utf8mb4 unterstützt, muss WHMCS die erweiterten Zeichen nicht mehr herausfiltern:

• Gehen Sie zu Einstellungen > Allgemein (General Settings) > Support.
• Suchen Sie die Option: Erweiterte UTF-8-Zeichen entfernen (Remove Extended UTF-8 Characters).
• Deaktivieren Sie diese Option (AUS).

Nehmen Sie WHMCS anschließend aus dem Wartungsmodus.

🎨 Liste der Emojis (Unterstützt durch utf8mb4)

Ihre WHMCS-Installation unterstützt nun offiziell 4-Byte-Zeichen, einschließlich des vollen Emoji-Spektrums in allen Textfeldern:

**GESICHTER & EMOTIONEN**
😀 😃 😄 😁 😆 😅 😂 🤣 🥲 ☺️ 😊 😇 🙂 🙃 😉 😌 😗 😙 😚 😙 😋 😛 😝 😜 🤪 🤨 🧐 🤓 😎 🥸 🤩 🥳 😏 😒 😞 😔 😟 😕 🙁 😖 😫 😩 🥺 😢 😭 😤 😠 😡 🤬 🤯 😳 🥵 🥶 😱 😨 😰 😥 😓 🤗 😶‍🌫️ 🫡 🤫 🫠 🤭 🫢 🫣 🤥 😶 😐 😑 😒 🙄 😬 🤥 😌 😔 😴 🤤 😷 🤒 🤕 🤢 🤮 🤧 😇 🤠 🥳 🥺 😢 😭 😨 😱 🤯 🤔 🤩

**HANDGESTEN**
👋 🤚 🖐 ✋ 🖖 👌 🤌 🤏 ✌️ 🤞 🤟 🤘 🤙 👈 👉 👆 👇 ☝️ 🫵 🖕 ⬇️ ⬆️ ↗️ ↘️ ↙️ ↖️ ✊ 👊 🤛 🤜 👏 🙌 👐 🤲 🤝 🙏 ✍️ 💅 🤳 💪 🦾 🦿 🦵 🦶 👂 🦻 👃 🧠 🫀 🫁 🦴 🦷 👅 👄

**TIERE & NATUR**
🐶 🐱 🐭 🐹 🐰 🦊 🐻 🐼 🐻‍❄️ 🐨 🐯 🦁 🐮 🐷 🐽 🐸 🐒 🦍 🦧 🐔 🐧 🐦 🕊️ 🦅 🦆 🦢 🦉 🦩 🦚 🦜 🐸 🐊 🐢 🦎 🐍 🐉 🐳 🐬 🐠 🐡 🦈 🐙 🐚 🐌 🦋 🐛 🐜 🐝 🐞 🦗 🕷️ 🕸️ 🦂 🦟 🦠 💐 🌸 🌷 🌹 🌺 🌻 🌼 🌽 🌾 🌲 🌳 🌴 🌱 🌿 ☘️ 🍀 🎍 🎋 🍃 🍂🍁

**SPEISEN & GETRÄNKE**
🍇 🍈 🍉 🍊 🍋 🍌 🍍 🥭 🍎 🍏 🍐 🍑 🍒 🍓 🥝 🍅 🥥 🥑 🍆 🥔 🥕 🧅 🌶️ 🥒 🍄 🥜 🌰 🍞 🥐 🥖 🥞 🧇 🧀 🥩 🥓 🍔 🍟 🍕 🌭 🥪 🌮 🌯 🥙 🥚 🍳 🥘 🍲 🥣 🥗 🍿 🧈 🧂 🥫 🍣 🍤 🍙 🍚 🍜 🍝 🍠 🍡 🍦 🍧 🍨 🍩 🍪 🎂 🍰 🍫 🍬 🍭 🍮 🍯 ☕️ 🍵 🍶 🍼 🍺 🍻 🥂 🍷 🥃 🍸 🍹 🍾

**REISEN & ORTE**
🌍 🌎 🌏 🗺️ 🗾 🧭 🏔️ 🌋 ⛰️ 🏕️ 🏖️ 🏝️ 🏞️ 🏟️ 🏛️ 🏗️ 🏭 🏡 🏘️ 🏢 🏰 🏯 💒 🗼 🗽 🌉 🎠 🎡 🎢 🚂 🚃 🚄 🚅 🚈 🚞 🚝 🚋 🚌 🚍 🚎 🚐 🚑 🚒 🚓 🚔 🚕 🚖 🚗 🚙 🚚 🚛 🚜 🏍️ 🚲 🛵 🛴 🛹 ✈️ 🚁 🚀 🚢 ⛵️ 🚤 🛶 🛎️ 🧳

**OBJEKTE & SYMBOLE**
⌚️ 📱 💻 🖥️ ⌨️ 🖲️ 🖱️ 🖨️ 💿 📀 💾 💽 💾 ☎️ 📞 📟 📠 🔋 🔌 💡 🔦 🕯️ 🗑️ 🛍️ 🛒 🎁 🎀 🎈 🎊 🎉 🏆 🥇 🥈 🥉 🏅 🎖️ 🎗️ 🎫 🎟️ 🎼 🎸 🎹 🎺 🎻 🥁 🎲 ♟️ 🎮 🕹️ 🧩 🔮 🪄 🪅 💰 💵 💳 ✉️ 📩 📪 📫 📬 📮 📦 📝 📋 📄 📂 📁 📰 📜 🔖 🏷️ 🔑 🔒 🔓 ❤️ 🧡 💛 💚 💙 💜 🖤 🤍 💯 ❓ ❕ ❗️ ➕ ➖ ➗ ✖️

Haftungsausschluss

Haftungsausschluss: Die Durchführung dieser Datenbank-Migration erfolgt vollständig auf eigene Gefahr und Verantwortung. Obwohl die Schritte sorgfältig erstellt wurden und den üblichen Best Practices entsprechen, kann keine Haftung für eventuelle Datenverluste, Beschädigungen oder Fehlfunktionen Ihrer WHMCS-Installation übernommen werden. Stellen Sie immer sicher, dass Sie vor Beginn der Arbeiten ein **vollständiges Backup** Ihrer Datenbank und aller Dateien erstellt und überprüft haben.