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 hochoptimiertes 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: Es wird geprüft, ob die Datenbank bereits konvertiert ist. Bei positivem Ergebnis wird der Vorgang beendet und das Skript gelöscht.
- Sicheres Backup: Es erstellt sowohl ein vollständiges SQL-Datenbank-Backup als auch ein Backup der
configuration.php(alsconfiguration.php.bak). - Automatisches Patching: Es passt die
configuration.phpan, indem es$mysql_charset = 'utf8mb4';setzt, um die korrekte Zeichenkodierung für die Applikation zu gewährleisten. - Finale Selbstlöschung: Nach erfolgreicher Ausführung oder positiver Prüfung 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 (Nur für registrierte Kunden): 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 alle 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 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 und die Daten repariert wurden, 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.
WGS AI Köməkçi