Istruzioni per l'installazione del modulo WHMCS

WHMCS (Web Host Manager Complete Solution) è un sistema di automazione per società di hosting e ISP. Offre funzionalità per la gestione dei clienti, la fatturazione, l'assistenza e l'automazione dei processi. Ecco le istruzioni su come installare questo modulo.

FASE 1: Caricamento del modulo

Caricare il modulo sul server tramite riga di comando utilizzando scp:

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

Esempio se si è già nella cartella con il file:

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

Verrà quindi richiesto di inserire la password del server.

Dopo aver caricato il file sul server, collegarsi al server tramite SSH e decomprimere il file.

ssh user@remote_server

È necessario inserire la password del server.

Andate quindi nella cartella del vostro progetto e dove avete caricato il file.

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

L'archivio deve essere scompattato nella radice del progetto.

unzip module-whmcs-billmanager.zip

In questo archivio ci sono 3 versioni del modulo che corrispondono alla versione di php su cui lavora whmcs; per conoscere la vostra versione di php andate in Utilità/Sistema/Info php.

Quindi è necessario decomprimere nuovamente l'archivio per la versione supportata da whmcs.

Per php 7.1, php 7.2, php 7.4 inserire

unzip version7.1|7.2|7.4.zip

Per php 8.1 inserire

unzip version8.1

Per php 8.2 inserire

unzip version8.2

Poi bisogna (necessariamente) concedere i permessi ai file. Lo si può fare dalla cartella del progetto inserendo il comando
chmod -R 755 modules/servers/PQH

Il modulo viene caricato.

Oppure caricare il modulo sul server tramite FileZilla

Sul proprio computer decomprimere il file module-whmcs-billmanager.zip

Quindi è necessario decomprimere nuovamente l'archivio della versione supportata da 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

Connettersi quindi al proprio server utilizzando filezilla.

Trasferire i file nella cartella principale del sito dall'archivio corrispondente alla propria versione di php (come nello screenshot sottostante).

Poi è necessario (obbligatorio) dare i diritti alla cartella e ai file per farlo andare nella cartella modules/servers e fare clic con il tasto destro del mouse sulla cartella PQH e selezionare attributi file nella finestra a comparsa, scrivere nel campo il valore numerico 755 e spuntare la casella di controllo su ricorri nelle sottodirectory (come nello screenshot qui sotto).

Il modulo è stato caricato.

FASE 2. Controllare IonCube

Sul nostro hosting condiviso, il supporto di IonCube e la sua versione dipendono dalla versione PHP selezionata per l'utente. Questo vale per qualsiasi linea di piani di hosting, nonché per i server virtuali/dedicati con pannello ISPManager installato.

Requisiti preliminari per l'installazione di IonCube

Se si dispone di un server senza pannello di controllo, è possibile che si renda necessaria l'installazione manuale di IonCube.

Il processo di installazione può variare a seconda del sistema operativo. Indipendentemente dal sistema operativo, il primo passo è sempre quello di connettersi tramite SSH e ottenere l'accesso root.

Per installare IonCube è necessario un computer con un server web attivo e funzionante, Apache o Nginx, e una versione di PHP installata tra quelle supportate da IonCube Loader.

Installazione passo-passo di IonCube

Importante: il valore dei comandi utilizzati per installare IonCube Loader varia a seconda di alcune variabili: la versione di PHP presente sul server, la posizione della directory PHP e la versione dell'architettura del server. Qui e in futuro, evidenzieremo i valori di queste variabili. Al loro posto, durante l'installazione, dovrete sostituire i valori appropriati per il vostro server.

1 .Connettersi al server tramite SSH.

2. Controllare l'architettura del server corrente:

uname -m
Exit
x86_64

Come si può vedere da x86_64, il nostro server attuale è in esecuzione su un'architettura a 64 bit. I valori della forma i686 indicherebbero il contrario: un'architettura a 32 bit.

Successivamente, andare nella directory tmp e scaricare l'archivio necessario:

Per i sistemi a 64 bit:

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

Per i sistemi a 32 bit:

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

Dopo aver scaricato l'archivio è necessario decomprimerlo:

Poiché nell'esempio abbiamo un'architettura a 64 bit, abbiamo scaricato e decompresso proprio questo archivio.

tar -zxvf ioncube_loaders_lin_x86-64.tar.gz

5. Andare nella directory ioncube e consultare l'elenco dei file.

cd ioncube/
ls -l

Conclusione

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

Come si può vedere, l'archivio contiene molte versioni diverse del modulo per diverse versioni di PHP. Dobbiamo scoprire quali di questi file ci servono per proseguire l'installazione.

6. Conoscendo la versione di PHP (dal primo passo), il passo successivo consiste nel determinare la posizione della directory in cui installare IonCube Loader.

php -i | grep extension_dir

Uscita

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

La posizione /usr/lib/php/20210902 sarà necessaria nel processo di installazione. Nel sistema operativo Centos tale cartella può apparire come /usr/lib64/php/modules.

7. Copiare i file di IonCube nella cartella necessaria.

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

8. Ora è necessario modificare i file di configurazione php.ini. Questi possono avere posizioni diverse nelle diverse configurazioni del server:

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

Inserire una riga del tipo seguente all'inizio di php.ini:

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

9. Eseguire il riavvio del server Web:

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. Verificare la correttezza dell'installazione con il comando:

php -v

Se l'installazione è andata a buon fine, la riga con le informazioni sulla versione corrente di IonCube verrà visualizzata come segue:

Uscita

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

FASE 3. Aggiungere il server

Accedere al pannello di amministrazione.

System Settings/Servers

Fare clic su Aggiungi nuovo server.

Compilare il modulo come nella schermata seguente.

Nel campo Modulo trovare: PQH

Nel campo Hostname o Indirizzo IP inserire: client.the.hosting

Quindi inserire i dati del proprio account (login, password) da client.the.hosting.

E fare clic su Continua.

Nella pagina successiva è necessario inserire il nome del server (a scelta) e fare clic su Salva modifiche.

FASE 4. Amministratore del modulo

È necessario creare un nuovo amministratore.

Questo può essere fatto andando in Impostazioni/Gestione amministratori.

Quindi fare clic su Aggiungi nuovo amministratore

Ruolo: Amministratore completo

Nome utente (obbligatorio!): apisystem

Il resto dei dati dipende da voi

Esempio (screenshot qui sotto)

FASE 5. Campi aggiuntivi

Campi come la scelta del sistema operativo al momento dell'acquisto possono essere configurati andando in Impostazioni/Impostazioni di sistema/Opzioni configurabili

Fare clic sul pulsante Crea un nuovo gruppo, quindi impostare il nome del gruppo come desiderato.

e fare clic su Salva modifiche, quindi fare clic sul pulsante Aggiungi nuova opzione configurabile.

Nella finestra a comparsa, inserire nel campo Nome opzione: "Modello VM".

Quindi aggiungere il valore nel campo Aggiungi opzioni.

Ecco un elenco di tutti i valori supportati:

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

Fare clic su Salva modifiche sia in questa scheda che nella scheda Gruppi di opzioni configurabili.

FASE 6. Aggiunta di prodotti

Accedere a Impostazioni/Impostazioni di sistema/Prodotti, Servizi

Creare un nuovo gruppo facendo clic su Crea un nuovo gruppo.

Compilare i campi come si ritiene opportuno

Salvare e andare nuovamente in Impostazioni/Impostazioni di sistema/Prodotti, Servizi.

1. Fare clic su Crea un nuovo prodotto
2. Quindi (assicurarsi di) selezionare
3. Tipo di prodotto: Server/VPS
4. Modulo: PQH

Compilare il resto come si ritiene opportuno

Dopo aver salvato, è possibile personalizzare il prodotto

Nella scheda Dettagli (schermata sottostante) è possibile personalizzare il prodotto come si desidera (Nome prodotto, Tagline prodotto, Descrizione breve prodotto, Descrizione prodotto).

La casella di controllo in Richiedi il valore del dominio deve essere deselezionata.

Non dimenticate di salvare le impostazioni del prodotto

Nella scheda Prezzi (schermata sottostante), è possibile configurare il pagamento del prodotto. Non dimenticare di salvare le impostazioni del prodotto

Nella scheda Impostazioni modulo (schermata seguente)

Selezionare (obbligatoriamente) il nome del modulo: PQH

Quindi selezionare il centro dati e la tariffa che corrispondono a questo prodotto.

Non dimenticate di salvare le impostazioni del prodotto

Nella scheda Campi personalizzati (schermata sottostante), inserire il valore "VMid" nel campo Nome campo.

Personalizzare le altre schede come si ritiene opportuno.

Inoltre, per semplificare il processo di aggiunta dei prodotti, possiamo duplicarli (schermata seguente).

FASE 7. Prova

Creare un utente, ricaricare il suo account e provare a ordinare un servizio dall'account di prova. Al momento dell'ordine da parte dell'utente, il modulo passerà tutti i parametri a BILLmanager, ordinerà automaticamente il server e quando il server sarà attivato sul lato BILLmanager, il servizio sarà attivato anche sul lato WHMCS.