Σκοπός:
Σκοπός της μελέτης είναι να παρουσιάσει τα βήματα σχετικά με την αναβάθμιση της PHP από έκδοση 5.6 σε 7.4 σε local web app.

Προϋποθέσεις:

Η εφαρμογή θα πρέπει να είναι πλήρως αναβαθμισμένη.

Σημαντική σημείωση: Σε εγκαταστάσεις με custom υλοποιήσεις(πχ ΣΜΕ αυτοματισμοί κ.ο.κ.), οι αλλαγές που απαιτούνται είναι αρκετές. Ως εκ τούτου, δεν μπορούν να τυποποιηθούν με χρήση συγκεκριμένων οδηγιών. Σε αυτές τις περιπτώσεις και πριν ξεκινήσει η διαδικασία της αναβάθμισης, θα πρέπει να γίνει επικοινωνία με την Παραγωγή ώστε να ελεγχθεί η εγκατάσταση και να κοστολογηθούν οι απαραίτητες εργασίες.

Βήμα 1
Αρχικά θα πρέπει να κατεβάσετε τα παρακάτω αρχεία

1. PHP (θα χρειαστείτε τη thread safe έκδοση για PHP 7.4)
   https://windows.php.net/download/

2. iocubeLoader vc 15 threadsafe
   https://www.ioncube.com/loaders.php

3. Τα κρυπτογραφημένο core της εφαρμογής
   https://www.tesae.gr/pegasus/download01/download00.php?file=26463465

4. module pegapi(Web App REST Service:PE.00.087) σε περίπτωση που η εφαρμογή σας διαθέτει το συγκεκριμένο module
   https://www.tesae.gr/pegasus/download01/download00.php?file=264635a6

Βήμα 2
Θα πρέπει να αλλάξετε τη βιβλιοθήκη κρυπτογράφησης σε openssl.
Από τη διαδρομή [Toolbox->Εργαλεία Παραμετροποίησης->Παραμετροποίηση Firewall->Βασικές Παράμετροι Firewall] θα πρέπει να αλλάξετε το πεδίο “Βιβλιοθήκη Κρυπτογράφησης” σε [openssl].

Βήμα 3
Θα δημιουργήσετε ένα νέο φάκελο για την php στη διαδρομή  C:\pegasus_webapp\servers πχ \php_74 και θα αποσυμπιέσετε τα αρχεία της php, που κατεβάσατε στο Βήμα 1.1 σε αυτόν.
Επιπλέον μετονομάσετε το αρχείο php.ini-development μέσα από το νέο φάκελο της php σε php.ini.

Σημείωση: Προτείνουμε να δημιουργήσετε ένα φάκελο με όνομα διαφορετικό από \php, σε περίπτωση που χρειαστεί να κάνετε επαναφορά στην προηγούμενη php version.

Βήμα 4
Αποσυμπιέζετε το αρχεία για το ioncubeLoader που κατεβάσατε στο Βήμα 1.2 και μεταφέρετε τα αρχεία που βρίσκονται στον φάκελο ioncube μέσα στο φάκελο της php που δημιουργήσατε στο Βήμα 3.

Βήμα 5
Ανοίγετε το αρχείο php.ini (που μετονομάσατε στο Βήμα 3) και συμπληρώνετε στο πάνω μέρος του αρχείου (μετά το tag [PHP]) την εντολή:

zend_extension = διαδρομή για το φάκελο της php/ioncube_loader_win_7.4.dll

σημειώνοντας σωστά τη διαδρομή για το φάκελο που δημιουργήσατε στο βήμα 3 πχ:

zend_extension = C:\pegasus_webapp\servers\php_74\ioncube_loader_win_7.4.dll

Στη συνέχεια θα εντοπίσετε την εντολή:

; On windows:
;extension_dir = "ext"

και στην οποία:

• θα κανετε comment out τη 2η γραμμή, αφαιρώντας το ;

• θα συμπληρώσετε τη διαδρομή για τον φάκελο ext μέσα από τα αρχεία της php ανάμεσα στα quotes πχ:

; On windows:

extension_dir = "C:\pegasus_webapp\servers\php_74\ext"

Επιπλέον θα εντοπίσετε τον παρακάτω κώδικα

;extension=bz2
;extension=curl
;extension=ffi
;extension=ftp
;extension=fileinfo
;extension=gd2
;extension=gettext
;extension=gmp
;extension=intl
;extension=imap
;extension=ldap
;extension=mbstring
;extension=exif      ; Must be after mbstring as it depends on it
;extension=mysqli
;extension=oci8_12c  ; Use with Oracle Database 12c Instant Client
;extension=odbc
;extension=php_openssl.dll
;extension=pdo_firebird
;extension=pdo_mysql
;extension=pdo_oci
;extension=pdo_odbc
;extension=pdo_pgsql
;extension=pdo_sqlite
;extension=pgsql
;extension=shmop

; The MIBS data available in the PHP distribution must be installed.
; See http://www.php.net/manual/en/snmp.installation.php
;extension=snmp

;extension=soap
;extension=sockets
;extension=sodium
;extension=sqlite3
;extension=tidy
;extension=xmlrpc
;extension=xsl

 και θα τον αντικαταστήσετε με 

;extension=bz2
extension=curl
;extension=ffi
extension=ftp
;extension=fileinfo
extension=gd2
;extension=gettext
;extension=gmp
;extension=intl
;extension=imap
;extension=ldap
extension=mbstring
;extension=exif      ; Must be after mbstring as it depends on it
;extension=mysqli
;extension=oci8_12c  ; Use with Oracle Database 12c Instant Client
;extension=odbc
extension=php_openssl.dll
;extension=pdo_firebird
extension=pdo_mysql
;extension=pdo_oci
;extension=pdo_odbc
;extension=pdo_pgsql
extension=pdo_sqlite
;extension=pgsql
;extension=shmop

; The MIBS data available in the PHP distribution must be installed.
; See http://www.php.net/manual/en/snmp.installation.php
;extension=snmp

;extension=soap
;extension=sockets
;extension=sodium
extension=sqlite3
;extension=tidy
;extension=xmlrpc
;extension=xsl

Βήμα 6

Σταματάτε το apache service. Στη συνέχεια και στη διαδρομή C:\pegasus_webapp\servers\Apache24\conf θα εντοπίσετε το αρχείο httpd.conf και θα δημιουργήσετε ένα αντίγραφο (ώστε να κρατήσετε backup τις ρυθμίσεις για την έκδοση της php 5.6). Θα αλλάξετε το όνομα του πρωτογενούς αρχείου (π.χ httpd__.conf) και θα μετονομάσετε το αντίγραφο σε httpd.conf.
Στη συνέχεια θα ανοίξετε το httpd.conf και θα εντοπίσετε την εντολή:

Define PHPROOT ""

στα quotes, θα συμπληρώσετε τη νέα διαδρομή για την php όπως το ορίσατε στο Βήμα 3 πχ:

Define PHPROOT "C:/pegasus_webapp/servers/php_74"

Επιπλέον στο κάτω μέρος του αρχείου θα εντoπίσετε την εντολή

LoadModule php5_module "${PHPROOT}/php5apache2_4.dll"

και την οποία θα μετασχηματίσετε σε

LoadModule php7_module ${PHPROOT}/php7apache2_4.dll

Τέλος, θα πρέπει να συμπληρώσετε στο κάτω μέρος του αρχείου τις εντολές

(για 32bit)

LoadFile  "${PHPROOT}/libcrypto-1_1.dll"
LoadFile  "${PHPROOT}/libssl-1_1.dll"
LoadFile  "${PHPROOT}/libssh2.dll"
LoadFile "${PHPROOT}/libsqlite3.dll"

(για 64bit)

LoadFile  "${PHPROOT}/libcrypto-1_1-x64.dll"
LoadFile  "${PHPROOT}/libssl-1_1-x64.dll"
LoadFile  "${PHPROOT}/libssh2.dll"
LoadFile "${PHPROOT}/libsqlite3.dll"

Βήμα 7
Αποσυμπιέζετε το αρχείο για το κρυπτογραφημένο core της εφαρμογής, που κατεβάσατε στο Βήμα 1.3, στη διαδρομή

C:\pegasus_webapp\webapp\όνομα_της_εφαρμογής\pegasus_cloud_app πχ
C:\pegasus_webapp\webapp\peg_freelancer\pegasus_cloud_app

Σημείωση: θα πρέπει να κάνετε replace στα αρχεία που θα βρεθούν. Σε περίπτωση που η εφαρμογή διαθέτει το module [REST], κάνετε το ίδιο και με τα αρχεία από το βήμα 1.4

Βήμα 8
Θα εντοπίσετε το αρχείο  peg_config.php από τη διαδρομή 
C:\pegasus_webapp\webapp\όνομα_της_εφαρμογής\pegasus_cloud_app πχ
C:\pegasus_webapp\webapp\peg_freelancer\pegasus_cloud_app

και θα συμπληρώσετε την εντολή:

define('DB_API' , 'PDO'); 

ακριβώς πριν από τις γραμμές:

//End SME
?>

Βήμα 9
Ενεργοποιείτε ξανά το service του apache εκτελώντας το αρχείο ApacheMonitor.exe στη διαδρομή

C:\pegasus_webapp\servers\Apache24\bin

Στο εικονίδιο που θα εμφανιστεί κάτω δεξιά,κάντε κλικ και στην επιλογή [apache 2.4] επιλέξτε [start].

Βήμα 10

Επιβεβαιώνετε ότι η php7.4 εγκαταστάθηκε σωστά ελέγχοντας τη σχετική ένδειξη στην εφαρμογή και στην επιλογή [toolbox->Στοιχεία Εγκατάστασης].