Bei einem Update der JobRouter-Webanwendung kann es notwendig sein, ebenfalls die eingesetzte PHP-Version zu aktualisieren. Welche PHP-Version Sie benötigen und welche zusätzlichen Abhängigkeiten dafür erforderlich sind, können Sie im Abschnitt zu den Systemvoraussetzungen nachlesen.
Eine passende, vorkonfigurierte PHP-Version inklusive der zusätzlichen Bibliotheken (z. B. SourceGuardian- und SQLSRV-Erweiterung) finden Sie im Downloadbereich unseres Kunden- und Partnerportals.
Handelt es sich um eine neue Major-Version von PHP, empfehlen wir eine neue Installation gemäß Installationshandbuch (Kapitel "Installation von PHP").
Vorgehensweise zur Aktualisierung Ihrer PHP-Installation:
1.Beenden Sie die Ausführung der Internetinformationsdienste (IIS).
2.Führen Sie eine Sicherung der bestehenden PHP-Installation durch.
3.Entpacken Sie zur Installation die ZIP-Datei der aktuellen PHP-Version in ein temporäres Verzeichnis.
4.Kopieren Sie die zuvor entpackten Dateien aus dem temporären Verzeichnis in das bisherige PHP-Verzeichnis.
5.Starten Sie wieder die Ausführung der Internetinformationsdienste (IIS).
Bitte beachten Sie: Die von JobRouter empfohlenen PHP-Einstellungen finden Sie in der Datei php.ini-jobrouter. Bei einer Aktualisierung der PHP-Version wird empfohlen, die verwendeten Einstellungen mit dieser Datei abzugleichen und ggf. anzupassen. Die beiden Dateien php.ini-production und php.ini-development werden von PHP standardmäßig mit ausgeliefert und haben normalerweise keine Relevanz für eine JobRouter-Installation.
Falls Sie nach der Durchführung des PHP-Updates beim Zugriff auf die JobRouter-Webanwendung folgende Fehlermeldung erhalten, ist die SourceGuardian-Erweiterung in der PHP-Laufzeitumgebung nicht aktiviert:
PHP script ...\jobrouter\index.php is protected by SourceGuardian and requires SourceGuardian loader 'ixed.8.4.win' to be installed
In diesem Fall müssen Sie die SourceGuardian-Erweiterung in der php.ini durch Hinzufügen folgender Zeile vor der opcache-Erweiterung aktivieren:
extension=...
zend_extension="C:\Program Files\PHP 8.4\ext\ixed.8.4.win"
zend_extension="C:\Program Files\PHP 8.4\ext\php_opcache.dll"
...
Bitte beachten Sie: Wenn Sie nicht die im Installationspaket enthaltene PHP-Laufzeitumgebung nutzen möchten, müssen Sie die PHP-Erweiterung SourceGuardian Loader manuell in Ihre PHP-Laufzeitumgebung integrieren. Weitere Informationen finden Sie auf der Website des Anbieters. Zusätzlich werden die PHP-Erweiterungen OPCache, AMQP und MessagePack benötigt.
Diese müssen ebenfalls durch Hinzufügen folgender Zeilen unterhalb der bereits aktivierten Erweiterungen in der php.ini aktiviert werden:
extension=...
extension=amqp
extension=msgpack
zend_extension="C:\Program Files\PHP 8.4\ext\ixed.8.4.win"
zend_extension="C:\Program Files\PHP 8.4\ext\php_opcache.dll"
...
Auf Linux-basierte Systeme kann je nach PHP-Distribution die zip-Erweiterung fehlen. Diese muss nach installiert werden.
