WHMCS модулін орнату нұсқаулары

WHMCS (Web Host Manager Complete Solution) – хостинг компаниялары мен интернет-провайдерлерге арналған автоматтандыру жүйесі. Ол клиентті басқаруға, шот-фактураға, қолдауға және процесті автоматтандыруға арналған функционалдылықты ұсынады. Төменде біз осы модульді орнату нұсқауларын береміз.

1-ҚАДАМ. Модульді жүктеу

scp арқылы пәрмен жолы арқылы серверге модульді жүктеп салу:

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

Мысал, егер сіз файлы бар қалтада болсаңыз:

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

Содан кейін сервер құпия сөзін енгізу керек.

Файлды серверге жүктегеннен кейін серверге SSH арқылы қосылып, файлды ашыңыз

 ssh user@remote_server

Сізден сервер құпия сөзін енгізу сұралады.

Содан кейін жоба қалтасына және файлды жүктеп алған жерге өтуіңіз керек

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

Мұрағат жобаның түбірінде ашылуы керек

 unzip module-whmcs-billmanager.zip

Бұл мұрағатта whmcs жұмыс істейтін PHP нұсқасына сәйкес модульдің 3 нұсқасы бар, PHP нұсқасын білу үшін Utilities/System/PHP info бөліміне өтіңіз.

Содан кейін whmcs қолдайтын нұсқаның мұрағатын қайтадан ашуыңыз керек.

php 7.1, php 7.2, php 7.4 үшін енгізіңіз

 unzip version7.1|7.2|7.4.zip

PHP 8.1 нұсқасы үшін енгізіңіз

 unzip version8.1

PHP 8.2 нұсқасы үшін енгізіңіз

 unzip version8.2

Содан кейін файлдарға құқықтарды (міндетті) беру керек. Мұны жоба қалтасында орындауға болады, пәрменді енгізіңіз
chmod -R 755 модульдері/серверлері/PQH

Модуль жүктелді.

Немесе модульді серверге FileZilla арқылы жүктеп салу

Компьютерде module-whmcs-billmanager.zip файлын ашыңыз

Содан кейін 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

Содан кейін filezilla арқылы серверге қосылыңыз

Файлдарды PHP нұсқасына сәйкес мұрағаттан сайттың түбірлік қалтасына тасымалдаңыз (төмендегі скриншоттағыдай).

Содан кейін қалта мен файлдарға құқықтарды (міндетті) беру керек. Мұны модульдер/серверлер қалтасына өтіп, PQH қалтасын тінтуірдің оң жақ түймешігімен нұқу және қалқымалы терезеде файл атрибуттары элементін таңдау арқылы жасауға болады, өріске 755 сандық мәнін енгізіңіз және ішкі каталогтарға қайталану үшін құсбелгіні қойыңыз (төмендегі скриншоттағыдай)

Модуль жүктелді.

2-ҚАДАМ. IonCube тексеру

Ортақ хостингімізде IonCube қолдауы және оның нұсқасы пайдаланушы таңдаған PHP нұсқасына байланысты. Бұл кез келген хостинг жоспарының желісіне, сондай-ақ ISPManager тақтасы орнатылған виртуалды/арнайы серверлерге қатысты.

IonCube орнатудың алғышарттары

Егер сізде басқару тақтасы жоқ сервер болса, IonCube бағдарламасын қолмен орнату қажеттілігі туындауы мүмкін.

Орнату процесі операциялық жүйеге байланысты әр түрлі болуы мүмкін. Операциялық жүйеге қарамастан, бірінші қадам әрқашан SSH арқылы қосылу және түбірлік рұқсат алу болып табылады.

IonCube орнату үшін сізге белсенді және жұмыс істейтін веб-сервері бар құрылғы, Apache немесе Nginx және IonCube Loader қолдайтын тізімдегі PHP орнатылған нұсқасы қажет.

IonCube қадамдық орнату

Маңызды: IonCube Loader орнату кезінде пайдаланылатын пәрмендердің мағынасы бірнеше айнымалыларға байланысты өзгереді: сервердегі PHP нұсқасы, PHP каталогының орны және сервер архитектурасының нұсқасы. Мұнда және төменде біз осы айнымалылардың мәндерін бөлектейміз. Олардың орнына орнату кезінде серверге сәйкес мәндерді ауыстыру қажет болады.

1. Серверге SSH арқылы қосылыңыз.

2. Ағымдағы сервердің архитектурасын тексеріңіз:

 uname -m Exit x86_64

x86_64-тен көріп отырғанымыздай, біздің қазіргі серверіміз 64-биттік архитектурада жұмыс істейді. i686 сияқты мәндер керісінше – 32 биттік архитектураны көрсетеді.

Содан кейін tmp каталогына өтіп, қажетті мұрағатты жүктеңіз:

64 биттік жүйелер үшін:

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

32 биттік жүйелер үшін:

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

Мұрағатты жүктеп алғаннан кейін оны архивтен шығару керек:

Біздің мысалда біз 64 биттік архитектураны қолданатындықтан, біз дәл осы мұрағатты жүктеп алып, аштық.

 tar -zxvf ioncube_loaders_lin_x86-64.tar.gz

5. ioncube каталогына өтіп, файлдар тізімін қараңыз.

 cd ioncube/ ls -l

Қорытынды

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

Көріп отырғанымыздай, архивте PHP-тің әртүрлі нұсқалары үшін модульдің көптеген әртүрлі нұсқалары болды. Одан әрі орнату үшін осы файлдардың қайсысы бізге қажет екенін анықтауымыз керек.

6. PHP нұсқасын (бірінші қадамнан бастап) біле отырып, келесі қадам IonCube Loader орнату қажет болатын каталогтың орнын анықтау болып табылады.

 php -i | grep extension_dir

Қорытынды

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

Әрі қарай орнату процесінде бізге /usr/lib/php/20210902 орны қажет болады. Centos филиалының ОЖ-да мұндай қалта /usr/lib64/php/modules сияқты көрінуі мүмкін.

7. IonCube файлдарын қажетті каталогқа көшіріңіз.

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

8. Енді php.ini конфигурация файлдарына өзгертулер енгізу керек. Олардың орналасуы әртүрлі сервер конфигурацияларында әртүрлі болуы мүмкін:

 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

php.ini ең басына келесідей жолды енгізіңіз:

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

9. Веб-серверді қайта іске қосыңыз:

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. Орнатудың дұрыстығын пәрмен арқылы тексеріңіз:

 php -v

Орнату сәтті болса, ағымдағы IonCube нұсқасы туралы ақпараты бар жол келесідей көрсетіледі:

Қорытынды

 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

3-ҚАДАМ. Сервер қосыңыз

Әкімші панеліне өтіңіз.

 System Settings/Servers

Жаңа сервер қосу түймесін басыңыз

Төмендегі скриншоттағыдай пішінді толтырыңыз

Модуль өрісінде біз мынаны табамыз: PQH

Хост атауы немесе IP мекенжайы өрісіне келесіні енгізіңіз: client.the.hosting

Содан кейін client.the.hosting сайтынан тіркелгі мәліметтерін (логин, құпия сөз) енгізіңіз

Және жалғастыру түймесін басыңыз.

Әрі қарай, келесі бетте сервер атын (таңдауыңыз) енгізіп, «Өзгерістерді сақтау» түймесін басыңыз

4-ҚАДАМ. Модуль әкімшісі

Сізге жаңа әкімші жасау керек.

Мұны параметрлерге/басқару әкімшілеріне өту арқылы жасауға болады

Содан кейін «Жаңа әкімші қосу» түймесін басыңыз

Рөлі: Толық әкімші

Пайдаланушы аты (міндетті!): apisystem

Қалған деректер сіздің таңдауыңызға байланысты.

Мысал (төмендегі скриншот)

5-ҚАДАМ. Қосымша өрістер

Сатып алу кезінде операциялық жүйені таңдау сияқты өрістерді параметрлерге/жүйе параметрлеріне/Конфигурацияланатын опцияларға өту арқылы конфигурациялауға болады.

Жаңа топ құру түймесін басыңыз, содан кейін өз қалауыңыз бойынша топ атауын көрсетіңіз

және Өзгерістерді сақтау түймешігін басыңыз, содан кейін Жаңа конфигурацияланатын опцияны қосу пайда болатын түймені басыңыз

Содан кейін қалқымалы терезеде опция атауы өрісіне енгізіңіз: «VM үлгісі»

Содан кейін «Параметрлерді қосу» өрісіне мәнді қосыңыз.

Мұнда барлық қолдау көрсетілетін мәндердің тізімі берілген:

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

Осы қойындыда және Конфигурацияланатын опция топтары қойындысының екеуінде де Өзгерістерді сақтау түймесін басыңыз.

6-ҚАДАМ. Өнімдерді қосу

Параметрлер/Жүйе параметрлері/Өнімдер, Қызметтер бөліміне өтіңіз

Жаңа топ құру түймесін басу арқылы жаңа топ жасаңыз.

Әрі қарай өрістерді қалауыңызша толтырыңыз.

Сақтап, Параметрлер/Жүйе параметрлері/ Өнімдер, Қызметтер бөліміне оралыңыз

1. Жаңа өнімді жасау түймесін басыңыз
2. Содан кейін (міндетті) таңдаңыз
3. Өнім түрі: Сервер/VPS
4. Модуль: PQH

Қалғанын өз қалауыңыз бойынша толтырыңыз.

Сақтағаннан кейін бұл өнімді теңшеуге болады.

Мәліметтер қойындысында (төмендегі скриншот) өнімді өз қалауыңыз бойынша теңшеуге болады (өнім атауы, өнім тақырыбы, өнім қысқаша сипаттамасы, өнім сипаттамасы).

Доменді талап ету мәніндегі құсбелгіні алып тастау керек.

Өнім параметрлерін сақтауды ұмытпаңыз.

Баға қойындысында (төмендегі скриншот) өнім үшін төлемді орнатуға болады. Өнім параметрлерін сақтауды ұмытпаңыз

Модуль параметрлері қойындысында (төмендегі скриншот)

Модуль атауын таңдаңыз (міндетті): PQH

Содан кейін осы өнімге сәйкес келетін деректер орталығы мен тарифті таңдаңыз.

Өнім параметрлерін сақтауды ұмытпаңыз.

Теңшелетін өрістер қойындысында (төмендегі скриншот), Өріс атауы өрісіне «VMid» мәнін енгізуді МІНДЕТТІ БОЛЫҢЫЗ.

Қалған қойындыларды қалауыңызша реттеңіз.

Әрі қарай, өнімдерді қосу процесін жеңілдету үшін олардың көшірмесін жасауға болады (төмендегі скриншот)

7-ҚАДАМ. Тестілеу

Пайдаланушыны жасаңыз, оның есептік жазбасын толтырыңыз және сынақ тіркелгісінен қызметке тапсырыс беріп көріңіз. Пайдаланушы тапсырыс бергенде, модуль барлық параметрлерді BILLmanager қызметіне тасымалдайды, автоматты серверге тапсырыс береді және сервер BILLmanager жағында іске қосылғанда, қызмет WHMCS жағында да іске қосылады.