Instrukcja instalacji modułu WHMCS

WHMCS (Web Host Manager Complete Solution) to system automatyzacji dla firm hostingowych i dostawców usług internetowych. Oferuje funkcje zarządzania klientami, rozliczeń, wsparcia i automatyzacji procesów. Poniżej znajdują się instrukcje dotyczące instalacji tego modułu.

KROK 1: Ładowanie modułu

Prześlij moduł na serwer za pomocą wiersza poleceń za pomocą scp:

scp /path/to/local/module-whmcs-billmanager.zip
username@remote_server:/path/to/remote/directory

Przykład, jeśli jesteś już w folderze z plikiem:

scp module-whmcs-billmanager.ziproot@77.92.122.212:/var/www/www-root/data/www/data-hub.online/

Następnie zostaniesz poproszony o podanie hasła do serwera.

Po przesłaniu pliku na serwer, połącz się z serwerem przez SSH i rozpakuj plik

ssh user@remote_server

Konieczne będzie wprowadzenie hasła serwera.

Następnie przejdź do folderu projektu, do którego przesłałeś plik.

cd /var/www/path/to/destination/ 

Archiwum powinno zostać rozpakowane do katalogu głównego projektu

unzip module-whmcs-billmanager.zip

W tym archiwum znajdują się 3 wersje modułu odpowiadające wersji php, na której działa whmcs, aby sprawdzić swoją wersję php przejdź do Utilities/System/PHP info.

Następnie należy ponownie rozpakować archiwum dla wersji obsługiwanej przez whmcs.

Dla php 7.1, php 7.2, php 7.4 wpisz

unzip version7.1|7.2|7.4.zip

Dla php 8.1 wpisz

unzip version8.1

Dla php 8.2 wpisz

unzip version8.2

Następnie musisz (koniecznie) nadać uprawnienia do plików. Możesz to zrobić z folderu projektu, wpisując polecenie
chmod -R 755 modules/servers/PQH

Moduł zostanie załadowany.

Lub Prześlij moduł na serwer przez FileZilla

Na komputerze rozpakuj plik module-whmcs-billmanager.zip

Następnie należy ponownie rozpakować archiwum wersji obsługiwanej przez whmcs:

Для версии php 7.1, php 7.2, php 7.4 архив version7.1|7.2|7.4.zip
Для версии php 8.1 архив version8.1
Для версии php 8.2 архив version8.2

Następnie połącz się z serwerem za pomocą filezilla.

Przenieś pliki do folderu głównego witryny z archiwum odpowiadającego twojej wersji php (jak na zrzucie ekranu poniżej).

Następnie konieczne (obowiązkowe) jest nadanie praw do folderu i plików, aby to zrobić, przejdź do folderu modules/servers i kliknij prawym przyciskiem myszy folder PQH i wybierz atrybuty pliku w wyskakującym okienku, wpisz w polu wartość liczbową 755 i zaznacz pole wyboru dotyczące rekursji do podkatalogów (jak na zrzucie ekranu poniżej).

Moduł został załadowany.

KROK 2. Sprawdź IonCube

Na naszym hostingu współdzielonym obsługa IonCube i jego wersja zależy od wersji PHP wybranej dla użytkownika. Dotyczy to każdej linii planów hostingowych, a także serwerów wirtualnych/dedykowanych z zainstalowanym panelem ISPManager.

Wymagania wstępne dla instalacji IonCube

Jeśli posiadasz serwer bez panelu sterowania, możesz stanąć przed koniecznością ręcznej instalacji IonCube.

Proces instalacji może się różnić w zależności od systemu operacyjnego. Niezależnie od systemu operacyjnego, pierwszym krokiem jest zawsze połączenie się przez SSH i uzyskanie dostępu roota.

Do instalacji IonCube potrzebny jest komputer z aktywnym i działającym serwerem WWW, Apache lub Nginx, a także zainstalowana wersja PHP z listy obsługiwanych przez IonCube Loader.

Instalacja IonCube krok po kroku

Ważne: wartość poleceń używanych do instalacji IonCube Loader różni się w zależności od kilku zmiennych: wersji PHP na serwerze, lokalizacji katalogu PHP i wersji architektury serwera. Tutaj i w przyszłości podkreślimy wartości tych zmiennych. W ich miejsce będziesz musiał podstawić odpowiednie wartości dla swojego serwera podczas instalacji.

1. Połącz się z serwerem przez SSH.

2. Sprawdź architekturę bieżącego serwera:

uname -m
Exit
x86_64

Jak widzimy na podstawie x86_64, nasz obecny serwer działa na architekturze 64-bitowej. Wartości w postaci i686 wskazywałyby na coś przeciwnego - architekturę 32-bitową.

Następnie przechodzimy do katalogu tmp i pobieramy niezbędne archiwum:

Dla systemów 64-bitowych:

cd /tmp
wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz

Dla systemów 32-bitowych:

cd /tmp
wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86.tar.gz

Po pobraniu archiwum należy je rozpakować:

Ponieważ w przykładzie mamy architekturę 64-bitową, pobraliśmy i rozpakowaliśmy właśnie takie archiwum.

tar -zxvf ioncube_loaders_lin_x86-64.tar.gz

5. Przejdź do katalogu ioncube i przejrzyj listę plików.

cd ioncube/
ls -l

Wnioski

total 39260
-rw-rw-r-- 1 507 507  472192 Sep  9  2023 ioncube_loader_lin_4.1.so
-rw-rw-r-- 1 507 507  471968 Sep  9  2023 ioncube_loader_lin_4.2.so
-rw-rw-r-- 1 507 507  472768 Sep  9  2023 ioncube_loader_lin_4.3.so
-rw-rw-r-- 1 507 507  490752 Sep  9  2023 ioncube_loader_lin_4.3_ts.so
-rw-rw-r-- 1 507 507  475840 Sep  9  2023 ioncube_loader_lin_4.4.so
-rw-rw-r-- 1 507 507  494880 Sep  9  2023 ioncube_loader_lin_4.4_ts.so
-rw-rw-r-- 1 507 507  483360 Sep  9  2023 ioncube_loader_lin_5.0.so
-rw-rw-r-- 1 507 507  497632 Sep  9  2023 ioncube_loader_lin_5.0_ts.so
-rw-rw-r-- 1 507 507 1116768 Sep  9  2023 ioncube_loader_lin_5.1.so
-rw-rw-r-- 1 507 507 1155744 Sep  9  2023 ioncube_loader_lin_5.1_ts.so
-rw-rw-r-- 1 507 507 1139936 Sep  9  2023 ioncube_loader_lin_5.2.so
-rw-rw-r-- 1 507 507 1176704 Sep  9  2023 ioncube_loader_lin_5.2_ts.so
-rw-rw-r-- 1 507 507 1222328 Sep  9  2023 ioncube_loader_lin_5.3.so
-rw-rw-r-- 1 507 507 1275512 Sep  9  2023 ioncube_loader_lin_5.3_ts.so
-rw-rw-r-- 1 507 507 1512960 Sep  9  2023 ioncube_loader_lin_5.4.so
-rw-rw-r-- 1 507 507 1599584 Sep  9  2023 ioncube_loader_lin_5.4_ts.so
-rw-rw-r-- 1 507 507 1520056 Sep  9  2023 ioncube_loader_lin_5.5.so
-rw-rw-r-- 1 507 507 1602040 Sep  9  2023 ioncube_loader_lin_5.5_ts.so
-rw-rw-r-- 1 507 507 1485192 Sep  9  2023 ioncube_loader_lin_5.6.so
-rw-rw-r-- 1 507 507 1549640 Sep  9  2023 ioncube_loader_lin_5.6_ts.so
-rw-rw-r-- 1 507 507 1254608 Sep  9  2023 ioncube_loader_lin_7.0.so
-rw-rw-r-- 1 507 507 1316080 Sep  9  2023 ioncube_loader_lin_7.0_ts.so
-rw-rw-r-- 1 507 507 1355080 Sep  9  2023 ioncube_loader_lin_7.1.so
-rw-rw-r-- 1 507 507 1438760 Sep  9  2023 ioncube_loader_lin_7.1_ts.so
-rw-rw-r-- 1 507 507 1407568 Sep  9  2023 ioncube_loader_lin_7.2.so
-rw-rw-r-- 1 507 507 1489008 Sep  9  2023 ioncube_loader_lin_7.2_ts.so
-rw-rw-r-- 1 507 507 1316800 Sep  9  2023 ioncube_loader_lin_7.3.so
-rw-rw-r-- 1 507 507 1386880 Sep  9  2023 ioncube_loader_lin_7.3_ts.so
-rw-rw-r-- 1 507 507 1363392 Sep  9  2023 ioncube_loader_lin_7.4.so
-rw-rw-r-- 1 507 507 1430848 Sep  9  2023 ioncube_loader_lin_7.4_ts.so
-rw-rw-r-- 1 507 507 1401736 Sep  9  2023 ioncube_loader_lin_8.1.so
-rw-rw-r-- 1 507 507 1506216 Sep  9  2023 ioncube_loader_lin_8.1_ts.so
-rw-rw-r-- 1 507 507 1439016 Sep  9  2023 ioncube_loader_lin_8.2.so
-rw-rw-r-- 1 507 507 1546568 Sep  9  2023 ioncube_loader_lin_8.2_ts.so
-rw-r--r-- 1 507 507   10768 Aug  5  2022 LICENSE.txt
-rw-r--r-- 1 507 507  181104 Aug 15  2022 loader-wizard.php
-rw-r--r-- 1 507 507    4070 Sep  9  2023 README.txt
-rw-r--r-- 1 507 507   39548 Sep  9  2023 USER-GUIDE.pdf
-rw-r--r-- 1 507 507   11269 Sep  9  2023 USER-GUIDE.txt

Jak widać, archiwum zawiera wiele różnych wersji modułu dla różnych wersji PHP. Musimy dowiedzieć się, które z tych plików są nam potrzebne do dalszej instalacji.

6. Znając swoją wersję PHP (z pierwszego kroku), następnym krokiem jest określenie lokalizacji katalogu, w którym należy zainstalować IonCube Loader.

php -i | grep extension_dir

Wyjście

extension_dir => /usr/lib/php/20210902 => /usr/lib/php/20210902

Lokalizacja /usr/lib/php/20210902 będzie potrzebna w dalszym procesie instalacji. W systemie Centos taki folder może wyglądać jak /usr/lib64/php/modules.

7. Skopiuj pliki IonCube do odpowiedniego katalogu.

sudo cp /tmp/ioncube/ioncube_loader_lin_8.1.so /usr/lib/php/20210902

8. Teraz należy dokonać zmian w plikach konfiguracyjnych php.ini. Mogą one mieć różne lokalizacje w różnych konfiguracjach serwera:

sudo nano /etc/php/8.1/cli/php.ini          #для PHP CLI 
sudo nano /etc/php/8.1/fpm/php.ini          #для PHP-FPM & Nginx
sudo nano /etc/php/8.1/apache2/php.ini      #для Apache2

Na samym początku pliku php.ini należy wstawić linijkę następującej treści:

zend_extension = /usr/lib/php/20210902/ioncube_loader_lin_8.1.so

9. Wykonaj restart serwera WWW:

Apache Ubuntu/Debian
sudo systemctl restart apache2
Apache Centos/Rocky/Alma
sudo systemctl restart httpd
Nginx/PHP-FPM
sudo systemctl restart nginx
sudo systemctl restart php-fpm

10. Sprawdź poprawność instalacji za pomocą polecenia:

php -v

Jeśli instalacja przebiegnie pomyślnie, wiersz z informacją o aktualnej wersji IonCube zostanie wyświetlony w następujący sposób:

Wyjście

PHP 8.1.2-1ubuntu2.17 (cli) (built: May  1 2024 10:10:07) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.1.2, Copyright (c) Zend Technologies
    with the ionCube PHP Loader v13.0.2, Copyright (c) 2002-2023, by ionCube Ltd.
    with Zend OPcache v8.1.2-1ubuntu2.17, Copyright (c), by Zend Technologies

KROK 3. Dodaj serwer

Przejdź do panelu administracyjnego.

System Settings/Servers

Kliknij Dodaj nowy serwer.

Wypełnij formularz jak na poniższym zrzucie ekranu.

W polu Moduł wpisz: PQH

W polu Nazwa hosta lub Adres IP wpisz: client.the.hosting

Następnie wprowadź dane swojego konta (login, hasło) z client.the.hosting.

I kliknij Kontynuuj.

Następnie na następnej stronie należy wprowadzić nazwę serwera (wybraną przez siebie) i kliknąć Zapisz zmiany.

KROK 4. Administrator modułu

Musimy utworzyć nowego administratora.

Można to zrobić, przechodząc do ustawień / zarządzania administratorami

Następnie klikamy na Dodaj nowego administratora

Rola: pełny administrator

Nazwa użytkownika (obowiązkowa!): apisystem

Reszta danych zależy od Ciebie

Przykład (zrzut ekranu poniżej)

KROK 5. Dodatkowe pola

Pola takie jak wybór systemu operacyjnego przy zakupie można skonfigurować, przechodząc do Ustawienia/Ustawienia systemowe/Opcje konfigurowalne.

Kliknij przycisk Utwórz nową grupę, a następnie ustaw nazwę grupy według własnego uznania.

Kliknij przycisk Zapisz zmiany, a następnie kliknij przycisk Dodaj nową konfigurowalną opcję.

Następnie w wyskakującym oknie wpisz w polu Option Name: "VM Template".

Następnie dodaj wartość w polu Add Options.

Oto lista wszystkich obsługiwanych wartości:

VM6_ISPsystem_Alma-Linux-8
VM6_ISPsystem_Alma-Linux-9
VM6_ISPsystem_Astra-Linux-CE
VM6_ISPsystem_CentOS-8-Stream
VM6_ISPsystem_CentOS-9-Stream
VM6_ISPsystem_Debian-10
VM6_ISPsystem_Debian-11
VM6_ISPsystem_Debian-12
VM6_ISPsystem_FreeBSD-12
VM6_ISPsystem_FreeBSD-13
VM6_ISPsystem_Oracle-Linux-8
VM6_ISPsystem_Rocky-Linux-8
VM6_ISPsystem_Ubuntu-18.04
VM6_ISPsystem_Ubuntu-20.04
VM6_ISPsystem_Ubuntu-22.04
VM6_ISPsystem_VzLinux-8

Kliknij przycisk Zapisz zmiany zarówno w tej zakładce, jak i w zakładce Konfigurowalne grupy opcji.

KROK 6. Dodawanie produktów

Przejdź do Ustawienia/Ustawienia systemowe/Produkty, Usługi

Utwórz nową grupę, klikając przycisk Utwórz nową grupę.

Następnie wypełnij pola według własnego uznania

Zapisz i ponownie przejdź do Ustawienia/Ustawienia systemowe/Produkty,Usługi.

1. Kliknij Utwórz nowy produkt
2. Następnie (koniecznie) wybierz
3. Typ produktu: Serwer/VPS
4. Moduł: PQH

Wypełnij pozostałe pola według własnego uznania

Po zapisaniu możesz dostosować ten produkt

W zakładce Szczegóły (zrzut ekranu poniżej) możesz dostosować produkt według własnego uznania (nazwa produktu, slogan produktu, krótki opis produktu, opis produktu).

Pole wyboru w polu Wymagaj wartości domeny powinno być odznaczone.

Nie zapomnij zapisać ustawień produktu

W zakładce Cennik (zrzut ekranu poniżej) można skonfigurować płatność za produkt. Nie zapomnij zapisać ustawień produktu

W zakładce Ustawienia modułu (zrzut ekranu poniżej)

Wybierz (obowiązkowo) nazwę modułu: PQH

Następnie wybierz centrum danych i taryfę, które będą pasować do tego produktu.

Nie zapomnij zapisać ustawień produktu

W zakładce Custom Fields (zrzut ekranu poniżej), MUSISZ wstawić wartość "VMid" w polu Field Name.

Dostosuj pozostałe zakładki według własnego uznania.

Ponadto, aby uprościć proces dodawania produktów, możemy je zduplikować (zrzut ekranu poniżej).

KROK 7. Testowanie

Utwórz użytkownika, doładuj jego konto i spróbuj zamówić usługę z konta testowego. Podczas składania zamówienia przez użytkownika moduł przekaże wszystkie parametry do BILLmanagera, automatycznie zamówi serwer, a gdy serwer zostanie aktywowany po stronie BILLmanagera, usługa zostanie również aktywowana po stronie WHMCS.