Composer in Vtiger CRM installieren – Eine Schritt-für-Schritt-Anleitung

Composer in Vtiger CRM installieren – Eine Schritt-für-Schritt-Anleitung

Composer ist der populärste Paketmanager für PHP und wird bei der Entwicklung in Vtiger CRM oft sehr vermisst. In diesem Artikel zeige ich Ihnen, wie Sie Composer in Ihre Vtiger CRM-Installation integrieren können – egal, ob Sie bereits Vtiger 7.x verwenden oder Ihre bestehende Installation erweitern möchten.

1. Installation von Composer
   Zunächst müssen Sie Composer global auf Ihrem System installieren. Der genaue Vorgang hängt von Ihrem Betriebssystem ab – Details finden Sie auf der offiziellen Webseite unter https://getcomposer.org/. Befolgen Sie die dortigen Anweisungen, um Composer erfolgreich zu installieren.
2. Composer im Vtiger-Verzeichnis initialisieren
   Nachdem Composer installiert ist, wechseln Sie in das Hauptverzeichnis Ihrer Vtiger CRM-Installation und führen dort folgenden Befehl aus:   composer install

Dies lädt alle notwendigen Abhängigkeiten und richtet den Composer ein.

3. Einbindung des Composer Autoloaders in Vtiger
   Um den Paketmanager in Vtiger nutzen zu können, müssen Sie den Autoloader von Composer in Ihre Anwendung einbinden. Öffnen Sie dazu die Datei index.php im Hauptverzeichnis Ihrer CRM-Installation. Suchen Sie die Zeile, in der Vtiger‘s Module eingebunden werden, zum Beispiel:   include_once 'vtlib/Vtiger/Module.php';

Fügen Sie unmittelbar vor dieser Zeile den folgenden Code ein:

  include_once 'vendor/autoload.php';

Falls Vtiger nun eine Fehlermeldung anzeigt, prüfen Sie, ob der Autoloader korrekt eingebunden wurde.

4. Installation weiterer Pakete und Integration in Vtiger
   Um Composer voll auszunutzen, können Sie zusätzliche Pakete installieren und in Vtiger integrieren. Zwei Beispiele:

a) HTMLPurifier installieren
Führen Sie im Terminal folgenden Befehl aus:

  composer require ezyang/htmlpurifier

Anschließend müssen Sie die Einbindung anpassen. Öffnen Sie die Datei include/utils/VtlibUtils.php und suchen Sie nach der Zeile:

  include_once ('libraries/htmlpurifier/library/HTMLPurifier.auto.php');

Ersetzen Sie diese durch:

  include_once ('vendor/ezyang/htmlpurifier/library/HTMLPurifier.auto.php');

b) PHPSpreadsheet installieren
Installieren Sie das Paket mit:

  composer require phpoffice/phpspreadsheet

Passen Sie dann in der Datei modules/Reports/ReportRun.php die Einbindung an. Suchen Sie dort die Zeile:

  require_once("libraries/PHPExcel/PHPExcel.php");

Und ändern Sie sie in:

  require_once("vendor/autoload.php");

Nach dieser Änderung können Sie theoretisch den Ordner libraries/PHPExcel löschen.

5. Update von Smarty mit Composer
   Um auch die Smarty-Bibliothek via Composer zu verwalten, führen Sie im Terminal folgenden Befehl aus:   composer require smarty/smarty

Anschließend müssen Sie den Pfad in der Datei includes/runtime/Viewer.php anpassen. Suchen Sie hier die Zeile:

  vimport ('~/libraries/Smarty/libs/SmartyBC.class.php');

Ersetzen Sie sie durch:

  vimport ('~/vendor/smarty/smarty/libs/SmartyBC.class.php');

Auch hier können Sie nach erfolgreicher Integration optional den alten Ordner libraries/Smarty/libs entfernen.

6. Testen der Composer-Integration und weitere Entwickler-Tools
   Um zu überprüfen, ob Composer korrekt in Vtiger CRM arbeitet, können Sie eine nützliche Debugging-Utility installieren. Verwenden Sie den folgenden Befehl, um das Paket kint (für Debug-Ausgaben) als Entwickler-Abhängigkeit zu installieren:   composer require kint-php/kint --dev

Als Test können Sie beispielsweise in der Datei modules/Potentials/models/ListView.php vor der Zeile

  return $massActionLinks;

den Befehl

  d($massActionLinks);

einfügen. Öffnen Sie anschließend die Seite mit der Liste der Deals. Wenn alles funktioniert, werden oberhalb der Tabelle Debug-Informationen angezeigt.

Fazit

Mit diesen Schritten haben Sie Composer erfolgreich in Ihre Vtiger CRM-Installation integriert. Durch den Einsatz von Composer können Sie nun weitere Pakete einfach installieren und automatisch in das System einbinden. Dies ermöglicht Ihnen eine flexiblere Entwicklung, einfachere Verwaltung von Abhängigkeiten und erleichtert den Einsatz moderner PHP-Bibliotheken in Vtiger CRM. Viel Erfolg beim Einbinden und Erweitern Ihrer Vtiger-Lösung!