Narzędzie wiersza poleceń ServBay: przewodnik instalacji, konfiguracji i użytkowania

ServBay to nie tylko intuicyjny graficzny interfejs użytkownika (GUI) do zarządzania lokalnym środowiskiem developerskim – oferuje również rozbudowane wsparcie dla narzędzia wiersza poleceń. Dzięki zainstalowaniu CLI ServBay w Twoim terminalu (bash lub zsh) możesz wygodnie korzystać z szerokiej gamy zintegrowanych narzędzi i pakietów bezpośrednio z poziomu konsoli, znacznie zwiększając efektywność i elastyczność pracy.

Wymagania wstępne

Przed rozpoczęciem korzystania z narzędzia wiersza poleceń ServBay upewnij się, że ServBay jest poprawnie zainstalowany i uruchomiony.

Instalacja narzędzia wiersza poleceń ServBay

Oto szczegółowe kroki instalacji narzędzia CLI ServBay do Twojego środowiska terminala:

1. Uruchom aplikację ServBay.

2. W lewym pasku nawigacyjnym aplikacji kliknij opcję Ustawienia.

   

3. Na stronie ustawień znajdź sekcję Narzędzie wiersza poleceń.

4. Wybierz odpowiedni przycisk w zależności od używanego środowiska terminalowego (domyślnie macOS korzysta z bash, ale możesz też używać zsh):

   • Jeśli używasz zsh, kliknij Zainstaluj narzędzie CLI dla zsh.
   • Jeśli używasz bash, kliknij Zainstaluj narzędzie CLI dla bash.

   

5. Podczas instalacji system może poprosić Cię o podanie hasła administratora w celu modyfikacji plików środowiska (np. .zshrc lub .bash_profile). Wprowadź hasło i wyraź zgodę na instalację.

6. Po zakończeniu instalacji koniecznie zamknij i otwórz ponownie okno terminala. Narzędzie CLI ServBay będzie dostępne w nowej sesji terminalowej.

Konfiguracja domyślnych wersji pakietów

ServBay pozwala na ustawienie globalnych, domyślnych wersji najważniejszych pakietów, takich jak PHP, Node.js, MySQL czy MariaDB. Dzięki temu, gdy w terminalu wpisujesz polecenia typu php, node czy mysql, automatycznie wykorzystywana jest wersja domyślna ustawiona w GUI ServBay lub przez CLI.

Szczegółowe kroki konfiguracji globalnych wersji znajdziesz w dokumencie Ustawianie domyślnych wersji.

Przypisywanie wersji CLI do konkretnego projektu

Aby sprostać indywidualnym wymaganiom projektów, ServBay umożliwia przypisanie wersji PHP i Node.js na poziomie projektu przez utworzenie pliku .servbay.config w katalogu głównym projektu. Te ustawienia nadpisują konfiguracje globalne, gwarantując, że wybrany projekt zawsze korzysta ze wskazanej wersji narzędzi, eliminując problem konfliktów wersji.

Dzięki plikowi .servbay.config możesz nie tylko określić konkretne wersje PHP i Node.js, ale także ustalać inne parametry projektu – np. konkretną wersję Node.js do uruchamiania, adres repozytorium pakietów czy katalog cache.

Opis szczegółowych opcji i instrukcje znajdziesz w dokumencie Korzystanie z pliku .servbay.config.

Bezpośrednie uruchamianie wybranych wersji pakietów

Poza ustawianiem domyślnych i projektowych wersji, ServBay automatycznie dodaje wszystkie zainstalowane wersje głównych narzędzi (np. PHP, Node.js) do systemowego PATH, nadając wykonywalnym plikom sufiks z numerem wersji (np. php-7.4, php-8.1, php-8.3). Dzięki temu w dowolnym terminalu możesz użyć konkretnej wersji, bez konieczności zmiany globalnych lub projektowych ustawień.

Przykłady popularnych poleceń w CLI

Po zainstalowaniu narzędzia CLI ServBay możesz korzystać z szerokiego wachlarza poleceń zintegrowanych z ServBay bezpośrednio w terminalu. Oto kilka najczęściej używanych przykładów:

• Sprawdzenie aktualnej domyślnej wersji PHP:

  php -v

• Sprawdzenie aktualnej domyślnej wersji Node.js:

  node -v

• Uruchomienie skryptu przy użyciu wybranej wersji PHP:

  php-8.3 your_script.php

  php-8.3 możesz zamienić na dowolną inną zainstalowaną wersję, np. php-7.4 lub php-8.1.

• Użycie wybranej wersji narzędzia phpize:

  phpize-8.3

  Narzędzie phpize służy do przygotowania środowiska do kompilacji rozszerzeń PHP.

• Połączenie z bazą danych PostgreSQL:

  psql -h localhost -U your_user -d your_database

  Zamień your_user i your_database na odpowiednią nazwę użytkownika i bazy danych.

• Połączenie z bazą danych MySQL:

  mysql -h localhost -u your_user -p your_database

  Zamień your_user i your_database na odpowiednią nazwę użytkownika i bazy danych. Po uruchomieniu komenda poprosi o hasło.

• Wykonanie zapytania SQL:

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

  Parametr -c pozwala na bezpośrednie wykonanie zapytania SQL z wiersza poleceń.

• Sprawdzenie stanu serwera Redis:

  redis-cli info stats

Dzięki powyższym poleceniom możesz wygodnie zarządzać narzędziami i usługami ServBay w środowisku wiersza poleceń – usprawniając swoją codzienną pracę nad projektami oraz proces debugowania.

Wskazówki i ważne informacje

• Po zakończeniu instalacji narzędzia CLI pamiętaj, aby ponownie otworzyć okno terminala, by nowe zmienne środowiskowe zaczęły działać.
• Jeśli zmienisz ścieżkę instalacji pakietów ServBay, konieczna może być ponowna instalacja narzędzia CLI.

Podsumowanie

Narzędzie wiersza poleceń ServBay to kluczowy element jego bogatej funkcjonalności. Daje deweloperom bezpośredni, wydajny dostęp do zarządzania i korzystania z narzędzi oraz pakietów lokalnego środowiska developerskiego. Dzięki prostemu procesowi instalacji możesz łatwo korzystać z PHP, Node.js, baz danych i innych usług ServBay w terminalu, a konfigurując wersje globalne lub projektowe – idealnie dostosujesz środowisko do potrzeb swoich projektów. Biegłość w korzystaniu z narzędzia CLI ServBay znacznie usprawni pracę i przebieg całego procesu lokalnego developmentu.