ServBay CLI-Tool: Installation, Konfiguration und Anwendung

ServBay bietet Ihnen nicht nur eine intuitive grafische Benutzeroberfläche (GUI) zur Verwaltung Ihrer lokalen Entwicklungsumgebung, sondern auch ein leistungsstarkes Befehlszeilentool. Durch die Installation des ServBay-CLI-Tools in Ihrem Terminal (wie bash oder zsh) können Sie viele integrierte Entwicklungswerkzeuge und Softwarepakete direkt über die Kommandozeile ausführen, was Ihre Effizienz und Flexibilität beim Arbeiten deutlich erhöht.

Voraussetzungen

Bevor Sie das ServBay-Befehlszeilentool nutzen können, stellen Sie bitte sicher, dass ServBay erfolgreich installiert und ausgeführt wird.

ServBay CLI-Tool installieren

So installieren Sie das ServBay-CLI-Tool in Ihrem Terminal:

1. Öffnen Sie die ServBay-Anwendung.

2. Klicken Sie in der linken Navigationsleiste von ServBay auf den Menüpunkt Einstellungen.

   

3. Suchen Sie im Einstellungsfenster den Bereich Befehlszeilentool.

4. Klicken Sie entsprechend Ihrer verwendeten Terminalumgebung (z. B. ist das macOS-Standardterminal bash, oder Sie nutzen zsh) auf die passende Schaltfläche:

   • Verwenden Sie zsh, klicken Sie auf CLI-Tool für zsh installieren.
   • Verwenden Sie bash, klicken Sie auf CLI-Tool für bash installieren.

   

5. Während des Installationsprozesses werden Sie in der Regel aufgefordert, Ihr Administratorkennwort einzugeben, um Systemumgebungsdateien (wie .zshrc oder .bash_profile) zu ändern. Erteilen Sie die benötigten Berechtigungen.

6. Nach Abschluss der Installation schließen Sie Ihr Terminalfenster und öffnen Sie es erneut. Das ServBay-CLI-Tool wird dann in der neuen Terminal-Sitzung verfügbar sein.

Standardpaket-Versionen konfigurieren

Mit ServBay können Sie globale Standardversionen für häufig genutzte Pakete wie PHP, Node.js, MySQL oder MariaDB festlegen. Das bedeutet: Wenn Sie im Terminal-Bereich direkt php, node, mysql usw. ausführen, wird die in der ServBay-GUI gesetzte oder via Kommandozeile festgelegte Standardversion verwendet.

Ausführliche Infos zum Festlegen einer globalen Standardversion finden Sie im Dokument Standardversion festlegen.

Projektspezifische Versionen für die CLI definieren

Um unterschiedlichen Abhängigkeiten in verschiedenen Projekten gerecht zu werden, bietet ServBay die Möglichkeit, über eine .servbay.config-Datei im Projektstamm gezielt die verwendeten PHP- und Node.js-Versionen pro Projekt zu bestimmen. Mit diesem Ansatz wird die globale Einstellung überschrieben, sodass jedes Projekt garantiert mit der angegebenen Version arbeitet – Versionskonflikte werden so vermieden.

Mit der .servbay.config-Datei können Sie nicht nur PHP- und Node.js-Versionen vorgeben, sondern auch projektspezifische Parameter wie Laufzeit für Node.js, Registry-URL für Pakete und Cache-Verzeichnis individuell festlegen.

Details zu Einrichtung und Nutzung finden Sie im Dokument Arbeiten mit der .servbay.config-Datei.

Direktes Ausführen bestimmter Paket-Versionen

Neben der Festlegung von Standard- und projektspezifischen Versionen fügt ServBay ausführbare Dateien aller installierten Hauptpakete (wie PHP, Node.js) in sämtlichen Versionen direkt Ihrem System-PATH hinzu – jeweils mit der Versionsnummer als Suffix (z. B. php-7.4, php-8.1, php-8.3). So können Sie explizit eine bestimmte Version im Terminal starten, ohne die globale oder projektweite Konfiguration ändern zu müssen.

Häufig genutzte Befehle

Nach Installation des ServBay-Befehlszeilentools stehen Ihnen sämtliche integriert bereitgestellten Tools und Kommandos direkt zur Verfügung. Hier einige gängige Beispiele:

• Aktuelle Standard-PHP-Version anzeigen:

  php -v

• Aktuelle Standard-Node.js-Version anzeigen:

  node -v

• Ein Skript mit einer bestimmten PHP-Version ausführen:

  php-8.3 your_script.php

  Sie können php-8.3 durch jede andere in ServBay installierte PHP-Version, etwa php-7.4 oder php-8.1, ersetzen.

• Das phpize-Tool einer bestimmten Version nutzen:

  phpize-8.3

  Das Tool phpize dient zur Vorbereitung der Kompilation von PHP-Erweiterungsmodulen.

• Mit einer PostgreSQL-Datenbank verbinden:

  psql -h localhost -U your_user -d your_database

  Ersetzen Sie your_user und your_database mit Ihrem tatsächlichen Datenbank-Benutzernamen bzw. -namen.

• Mit einer MySQL-Datenbank verbinden:

  mysql -h localhost -u your_user -p your_database

  Ersetzen Sie your_user und your_database mit Ihren tatsächlichen Datenbankzugangsdaten. Nach dem Befehl werden Sie aufgefordert, Ihr Passwort einzugeben.

• SQL-Query direkt ausführen:

  psql -h localhost -U your_user -d your_database -c "SELECT * FROM your_table;"

  Mit dem Parameter -c können Sie einen SQL-Befehl direkt via Kommandozeile ausführen.

• Statusinformationen des Redis-Dienstes anzeigen:

  redis-cli info stats

Mit diesen Beispielbefehlen können Sie ServBay-Pakete und -Dienste bequem im Terminal nutzen, um Entwicklungs- und Debugging-Workflows effizienter zu gestalten.

Hinweise

• Nach der Installation des CLI-Tools müssen Sie Ihr Terminalfenster neu öffnen, damit neue Umgebungsvariablen wirksam werden.
• Ändern Sie den Installationsort von ServBay-Paketen, installieren Sie das CLI-Tool bitte erneut.

Fazit

Das ServBay-Befehlszeilentool ist ein zentraler Baustein der mächtigen Feature-Palette von ServBay: Es ermöglicht Entwickler:innen einen schnellen und direkten Zugriff auf alle Tools und Dienste der lokalen Entwicklungsumgebung. Mit wenigen Schritten installieren Sie das Tool und greifen fortan bequem im Terminal auf PHP, Node.js, Datenbanken und mehr zu – ob mit Standard- oder projektspezifischer Konfiguration. Wenn Sie die Bedienung des ServBay-CLI sicher beherrschen, beschleunigen und vereinfachen Sie Ihren lokalen Entwicklungsprozess ungemein.