PHP-Extension "Sodium" aktivieren

Falls du bei der Nutzung des ResellerAPI WHMCS Web-Connectors Fehlermeldungen erhältst, dass die sodium-Extension fehlt, ist diese Komponente auf deinem Server vermutlich noch nicht aktiv. Keine Sorge, das lässt sich schnell beheben!

Warum nutzt der Web-Connector Sodium?

Sicherheit steht bei uns an erster Stelle. Unser Web-Connector nutzt die Sodium-Bibliothek, um eine hochsichere, verschlüsselte Kommunikation zwischen deinem WHMCS-System und unserem Backend aufzubauen. Ohne diese Erweiterung können wir den Schutz deiner Daten nicht garantieren, weshalb der Connector die Arbeit verweigert.

Lösung für Linux-Server (Root-Zugriff)

Wenn du einen eigenen VPS oder Dedicated Server verwaltest, kannst du die Extension je nach Distribution und PHP-Version einfach über das Terminal nachinstallieren.

1. Installation unter Ubuntu / Debian

Nutze die folgenden Befehle (ersetze 8.2 ggf. durch deine aktive PHP-Version):

# Paketliste aktualisieren
sudo apt update

# Sodium installieren
sudo apt install php8.2-sodium

2. Installation unter RHEL / CentOS / AlmaLinux

Hier nutzt du meist den Paketmanager dnf:

sudo dnf install php-sodium

3. Neustart des Webservers

Damit PHP die neue Extension erkennt, musst du den Webserver oder den PHP-FPM-Dienst neu starten:

sudo systemctl restart apache2       # Falls du Apache nutzt
sudo systemctl restart nginx         # Falls du Nginx nutzt
sudo systemctl restart php8.2-fpm    # Falls PHP-FPM im Einsatz ist

Lösung in Plesk (Webspace)

In Plesk musst du keine Befehle tippen. Hier kannst du die Extension bequem über das Interface aktivieren:

Logge dich in dein Plesk Panel ein.
Gehe zu Tools & Einstellungen.
Klicke unter "Allgemeine Einstellungen" auf PHP-Einstellungen.
Wähle die PHP-Version aus, die für dein WHMCS aktiv ist (z. B. 8.2).
Suche in der Liste der Erweiterungen nach sodium.
Setze den Haken bei sodium.
Klicke unten auf OK, um die Änderung zu speichern.

[!TIP] Falls sodium in der Liste fehlt, ist das Paket auf dem Hauptserver nicht installiert. In diesem Fall müsstest du (falls du nicht selbst Admin bist) kurz deinen Hoster kontaktieren.

So prüfst du, ob es geklappt hat

Du kannst ganz einfach testen, ob die Extension nun aktiv ist. Gib dazu diesen Befehl in der Konsole ein:

php -m | grep sodium

Erscheint als Antwort einfach nur sodium, ist alles bereit!

Hast du noch Fragen?

Solltest du weiterhin Probleme mit dem Web-Connector haben, melde dich einfach bei unserem Support. Wir schauen uns das dann gemeinsam mit dir an!