Tworzenie i uruchamianie projektu FacturaScripts w ServBay

FacturaScripts to potężne i elastyczne, otwartoźródłowe rozwiązanie ERP (planowanie zasobów przedsiębiorstwa) oraz CRM (zarządzanie relacjami z klientami), idealne dla małych i średnich firm oraz freelancerów. Dzięki wygodnemu, lokalnemu środowisku developerskiemu ServBay możesz łatwo tworzyć, testować i uruchamiać projekty FacturaScripts na macOS bez skomplikowanej konfiguracji.

Ten przewodnik przeprowadzi Cię krok po kroku przez cały proces lokalnej instalacji i konfiguracji FacturaScripts w ServBay.

Przegląd FacturaScripts

FacturaScripts to otwartoźródłowe oprogramowanie ERP i CRM oparte na architekturze PHP oraz Bootstrap. Jego zadaniem jest wsparcie firm w zarządzaniu kluczowymi procesami biznesowymi, takimi jak:

• Wystawianie i zarządzanie fakturami
• Księgowość
• Kontrola stanów magazynowych
• Zarządzanie klientami i dostawcami
• Zarządzanie projektami
• Oraz wiele innych funkcjonalności dostępnych przez moduły i wtyczki…

Jako aktywny projekt open source, FacturaScripts posiada silne wsparcie społeczności i umożliwia rozbudowę oraz dostosowanie platformy poprzez pluginy, aby sprostać różnorodnym potrzebom biznesowym.

Najważniejsze cechy i korzyści FacturaScripts

• Open source — darmowe: Bez konieczności płacenia wysokich opłat licencyjnych, możesz swobodnie korzystać, modyfikować i dystrybuować oprogramowanie.
• Kompleksowa funkcjonalność: Obejmuje większość niezbędnych funkcji codziennej działalności MŚP, zapewniając kompleksowe rozwiązanie.
• Łatwe w obsłudze: Intuicyjny, przyjazny interfejs, niska bariera wejścia dla nowych użytkowników.
• Wysoka skalowalność: Rozbudowany rynek wtyczek i otwarte API umożliwiają łatwe dodawanie nowych funkcjonalności i integracji.
• Dostępność wieloplatformowa: Technologia webowa pozwala na dostęp z każdego urządzenia z nowoczesną przeglądarką.
• Aktywna społeczność: W przypadku problemów możesz liczyć na pomoc ze strony globalnej społeczności deweloperów.
• Wielojęzyczność: Wsparcie dla wielu języków interfejsu ułatwia użytkowanie w różnych regionach świata.

Dlaczego warto uruchomić FacturaScripts w ServBay

ServBay to lokalne środowisko developerskie zaprojektowane z myślą o deweloperach, idealne do uruchamiania aplikacji PHP, takich jak FacturaScripts. Integruje wszystkie niezbędne komponenty: serwer WWW Apache/Nginx, wiele wersji PHP, bazy danych MySQL/MariaDB/PostgreSQL oraz narzędzia typu Redis — wszystko wygodnie zarządzane przez czytelny interfejs graficzny.

Najważniejsze korzyści i kroki korzystania z FacturaScripts w ServBay:

• Zintegrowane środowisko: ServBay jest wyposażony we wszystkie niezbędne składniki (serwer WWW, PHP, baza danych), eliminując konieczność ręcznej instalacji każdego elementu osobno.
• Zarządzanie wersjami: Łatwa zmiana wersji PHP pod kątem wymagań konkretnej wersji FacturaScripts lub testów kompatybilności.
• Zarządzanie bazą danych: Wbudowane narzędzia, takie jak phpMyAdmin lub Adminer, umożliwiają szybkie tworzenie baz i kont użytkowników dla FacturaScripts.
• Uproszczona konfiguracja witryn: Za pomocą interfejsu ServBay szybko utworzysz lokalną stronę WWW, skonfigurujesz domenę, katalog główny, serwer WWW i wersję PHP.
• Automatyzacja pliku hosts: SerwBay automatycznie zarządza lokalnym plikiem hosts, dzięki czemu można korzystać z niestandardowej domeny (np. facturascripts.servbay.demo) do lokalnego testowania.
• Obsługa SSL: SerwBay umożliwia konfigurację SSL/HTTPS dla lokalnych stron za pomocą własnego CA lub publicznego ACME, co pozwala na symulowanie środowiska produkcyjnego.

Podsumowanie głównych kroków pracy z FacturaScripts w ServBay:

1. Pobierz źródła FacturaScripts.
2. Utwórz folder projektu w katalogu głównym stron ServBay.
3. Utwórz bazę danych MySQL dla FacturaScripts i użytkownika.
4. Skonfiguruj serwer WWW (Apache lub Nginx) w ServBay, wskazując katalog projektu.
5. Sprawdź/aktywuj wymagane rozszerzenia PHP.
6. Odwiedź lokalną domenę w przeglądarce i przejdź przez instalator FacturaScripts online.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że spełniasz następujące warunki:

• Udało Ci się pobrać, zainstalować i uruchomić ServBay na macOS. Najnowszą wersję znajdziesz na oficjalnej stronie ServBay.
• W panelu ServBay uruchomione są wymagane pakiety (serwer WWW Apache lub Nginx, kompatybilna wersja PHP oraz MySQL lub MariaDB).
• Znane są Ci podstawowe zagadnienia z zakresu web developmentu oraz baz danych.

Tworzenie projektu FacturaScripts (na podstawie paczki Zip)

To najpopularniejsza i najprostsza metoda lokalnej instalacji FacturaScripts.

1. Pobierz FacturaScripts:

   • Przejdź na stronę pobierania FacturaScripts: https://facturascripts.com/descargar.
   • Pobierz najnowszą stabilną wersję w postaci archiwum .zip na swój komputer z macOS.

2. Utwórz katalog projektu:

   • Otwórz Finder i przejdź do katalogu głównego stron lokalnych dla ServBay (domyślnie: /Applications/ServBay/www/).
   • W tym folderze utwórz nowy katalog na projekt FacturaScripts, np. facturascripts_project.
   • Przykładowa ścieżka projektu: /Applications/ServBay/www/facturascripts_project

3. Rozpakuj pliki:

   • Odnajdź pobrane archiwum .zip FacturaScripts i rozpakuj je.
   • Wszystkie pliki i katalogi po rozpakowaniu (np. index.php, Core, Dinamic, Plugins, itd.) skopiuj lub przenieś do utworzonego wcześniej folderu /Applications/ServBay/www/facturascripts_project.

Konfiguracja początkowa (m.in. baza danych MySQL)

FacturaScripts wymaga bazy danych do przechowywania wszystkich danych biznesowych, użytkowników i konfiguracji. W tym celu posłużymy się MySQL lub MariaDB zarządzanym przez ServBay. Oba są całkowicie wspierane przez ServBay.

1. Upewnij się, że pakiet bazy danych działa:

   • Uruchom aplikację ServBay.
   • W menu po lewej wybierz "Pakiety" — "MySQL" lub "MariaDB" (w zależności od preferowanego typu bazy danych).
   • Upewnij się, że wybrany pakiet jest uruchomiony. Jeśli nie, kliknij przełącznik obok, żeby go aktywować.

2. Stwórz bazę danych i użytkownika:

   • Skorzystaj z wbudowanego narzędzia, np. phpMyAdmin, dostarczanego razem z MySQL/MariaDB lub skorzystaj z terminala (ServBay udostępnia wygodne wejście do konsoli). Początkującym zalecane jest phpMyAdmin.
   • Przez phpMyAdmin (zalecane):
     • W interfejsie ServBay znajdź część "Bazy Danych", kliknij ikonę phpMyAdmin obok aktualnej bazy (MySQL/MariaDB) — ServBay otworzy stronę logowania w przeglądarce.
     • Zaloguj się jako root używając hasła ustawionego podczas inicjalizacji ServBay. Jeśli je zapomniałeś, ServBay umożliwia zresetowanie hasła w szczegółach pakietu bazy danych.
     • Po zalogowaniu kliknij "Bazy danych" na górze.
     • W polu "Utwórz bazę danych" wprowadź nazwę bazy (dla jasności np. facturascripts_servbay_db).
     • Wybierz odpowiedni zestaw znaków — zalecane utf8mb4_general_ci albo utf8mb4_unicode_ci ze względu na wsparcie dla szerokiego zakresu znaków i emoji.
     • Kliknij "Utwórz".
     • Tworzenie nowego użytkownika (opcjonalne, ale zalecane): Ze względów bezpieczeństwa lepiej nie łączyć się z bazą jako root, lecz utworzyć osobne konto.
       • Wróć do strony głównej phpMyAdmin, kliknij "Konta użytkowników".
       • Kliknij "Dodaj konto użytkownika".
       • Wpisz nazwę użytkownika (np. facturascripts_servbay_user).
       • Jako host wybierz localhost lub 127.0.0.1 (dostęp lokalny).
       • Wygeneruj lub wpisz silne hasło i koniecznie je zapisz.
       • Na dole strony możesz wybrać opcję utworzenia bazy o tej samej nazwie oraz przydzielenia wszystkich uprawnień, bądź ręcznie dodać uprawnienia do wybranej bazy (facturascripts_servbay_db), zaznaczając wszystkie niezbędne uprawnienia (ALL PRIVILEGES).
       • Kliknij "Wykonaj" na dole strony, aby zapisać użytkownika.

3. Zanotuj dane dostępowe do bazy: Podczas instalacji FacturaScripts potrzebne będą:

   • Nazwa bazy danych (np. facturascripts_servbay_db)
   • Nazwa użytkownika bazy (np. facturascripts_servbay_user)
   • Hasło użytkownika (ustawione wcześniej)
   • Host bazy (zazwyczaj localhost lub 127.0.0.1)
   • Port bazy (domyślne MySQL/MariaDB to 3306, sprawdź go w panelu ServBay)

Konfiguracja serwera WWW (Apache lub Nginx)

Musisz teraz poinformować ServBay, jak serwować pliki projektu FacturaScripts przez wybrany serwer WWW. ServBay obsługuje zarówno Apache, jak i Nginx.

1. Upewnij się, że serwer WWW działa:

   • W panelu "Pakiety" ServBay sprawdź, czy Twój serwer (Apache lub Nginx) jest uruchomiony.

2. Dodaj witrynę:

   • W menu po lewej ServBay wybierz "Strony" (Site).
   • Kliknij "+" nad listą stron po prawej, aby dodać nową konfigurację.
   • W otwartym oknie uzupełnij:
     • Nazwa: Opisowa nazwa, np. FacturaScripts Demo Site
     • Domena: Domena, pod którą chcesz testować lokalnie, np. facturascripts.servbay.demo — zgodnie z zaleceniami ServBay, do lokalnych domen stosujemy końcówkę .servbay.demo.
     • Typ strony: Wybierz PHP.
     • Katalog główny: Kliknij "Przeglądaj" lub "Wybierz" i wskaż zaprojektowany wcześniej folder (/Applications/ServBay/www/facturascripts_project). Uwaga: Niektóre frameworki wymagają wskazania podfolderu (np. public), ale dla FacturaScripts wystarczy katalog główny — sprawdź dokumentację FacturaScripts.
     • Wersja PHP: Wybierz wersję kompatybilną z Twoją wersją FacturaScripts (zazwyczaj PHP 8.1, 8.2 lub nowsza). Sprawdź oficjalne wymagania na stronie FacturaScripts. ServBay udostępnia kilka wersji PHP do wyboru.
     • Pozostałe ustawienia: Domyślne są wystarczające, ale ServBay umożliwia również konfigurację SSL/HTTPS (własny CA lub certyfikat ACME), ustawienia CORS i inne opcje zaawansowane.

3. Zapisz konfigurację i zaktualizuj Hosts:

   • Kliknij "Dodaj" lub "Zapisz".
   • ServBay automatycznie skonfiguruje virtual hosta (Apache) lub server block (Nginx), a następnie poprosi o uprawnienia administratora, aby zaktualizować plik hosts i przypisać domenę facturascripts.servbay.demo do lokalnego adresu IP (127.0.0.1). Dzięki temu możesz komfortowo pracować na nazwie domenowej bez samodzielnej edycji pliku hosts.

4. Sprawdź i aktywuj wymagane rozszerzenia PHP:

   • FacturaScripts może wymagać określonych rozszerzeń PHP: zwykle potrzeba pdo_mysql, gd (grafika), intl (internacjonalizacja), zip, xml, curl oraz innych. Wiele z nich jest domyślnie włączonych w ServBay, ale jeśli instalator FacturaScripts zgłosi brak któregoś z nich, doinstaluj je ręcznie.
   • Jak to zrobić w ServBay:
     • W menu po lewej wybierz "Języki" → "PHP".
     • Wybierz używaną przez stronę wersję PHP (np. PHP 8.2).
     • Przejdź na zakładkę "Rozszerzenia".
     • Odszukaj wymagane rozszerzenie (np. opcache), zaznacz je.
     • Kliknij "Zastosuj" lub "Zapisz". Niektóre zmiany wymagają restartu odpowiedniego procesu PHP (dostępny przy wersji PHP w panelu "Języki" ServBay).

Przykładowy panel konfiguracji strony w ServBay

Odwiedź stronę i przejdź instalator FacturaScripts

Twój lokalny serwer ServBay jest gotowy do uruchomienia FacturaScripts — pora uruchomić instalator witryny.

1. Uruchom przeglądarkę: Skorzystaj z ulubionego programu (Chrome, Firefox, Safari).

2. Wpisz adres: W pasku adresu podaj domenę skonfigurowaną w ServBay, np. http://facturascripts.servbay.demo. Jeśli aktywowałeś SSL (przez CA ServBay lub ACME), możesz także użyć https://facturascripts.servbay.demo. Zatwierdź Enterem.

3. Instalator FacturaScripts:

   • Jeśli konfiguracja strony www, plik hosts oraz serwer WWW/PHP działają poprawnie, zobaczysz ekran powitania lub kreatora instalacji FacturaScripts.
   • Wybierz język: Na początek wskaż język interfejsu.
   • Sprawdzenie środowiska: Instalator automatycznie sprawdzi wersję PHP, aktywność wymaganych rozszerzeń i prawa zapisu do katalogów. Jeśli wszystko jest OK, zobaczysz potwierdzenie w postaci zielonych statusów. W razie komunikatu błędu lub ostrzeżenia odnieś się do wskazówek FacturaScripts lub ustawień ServBay (wersja PHP, prawa katalogów — katalog projektu /Applications/ServBay/www/facturascripts_project powinien być zapisywalny dla serwera WWW).
   • Konfiguracja bazy danych: Podaj wcześniej przygotowane dane:
     • Typ bazy: MySQL.
     • Host/Baza: localhost lub 127.0.0.1.
     • Port: 3306 (lub inny port MySQL z ServBay).
     • Nazwa bazy: facturascripts_servbay_db.
     • Użytkownik: facturascripts_servbay_user.
     • Hasło: Ustawione uprzednio.
     • Prefiks tabel: Domyślnie fs_ — możesz zmienić według potrzeb.
   • Konto administratora: Ustaw login, hasło i e-mail dla panelu admina FacturaScripts. Zadbaj o mocne hasło i zapisz te dane — będą potrzebne do logowania.
   • Instaluj: Po weryfikacji wszystkich informacji kliknij "Zainstaluj". FacturaScripts połączy się z bazą, utworzy wymagane tabele i zapisze konfigurację.

4. Zakończenie instalacji:

   • Po instalacji instalator może zalecić usunięcie katalogu install z katalogu głównego projektu — wykonaj to dla bezpieczeństwa.
   • Od tej pory możesz logować się pod adresem http://facturascripts.servbay.demo (lub odpowiednik HTTPS), używając konta administratora!

Najczęściej zadawane pytania (FAQ)

• P: Brakuje rozszerzenia PHP — co robić?
  • O: Otwórz panel ServBay, przejdź na "Języki" → "PHP", wybierz odpowiednią wersję, zakładka "Rozszerzenia". Znajdź brakujący moduł (np. opcache), zaznacz, "Zastosuj", zrestartuj proces PHP.
• P: Widzę "Forbidden" lub pustą stronę pod facturascripts.servbay.demo?
  • O: Sprawdź, czy serwer WWW i PHP są włączone w ServBay. Upewnij się, że katalog główny wskazuje na właściwy folder projektu. Jeśli strona jest pusta, sprawdź logi błędów serwera WWW/PHP. Jeśli widzisz "Forbidden", mogą być potrzebne poprawki praw do katalogów — użytkownik serwera WWW musi mieć prawo do odczytu plików i zapisu np. do katalogu Dinamic.
• P: Nie działa połączenie z bazą danych?
  • O: Sprawdź, czy MySQL/MariaDB działa w ServBay i słucha na właściwym porcie (3306). Zweryfikuj w instalatorze FacturaScripts wpisane: host, port, nazwę bazy, użytkownika i hasło.

Podsumowanie

Dzięki potężnemu środowisku ServBay instalacja i uruchomienie FacturaScripts na macOS jest szybka i prosta. ServBay dostarcza wszystkie potrzebne zależności (serwer WWW, PHP, baza danych) i znacząco upraszcza konfigurację poprzez przejrzysty interfejs graficzny. Postępując według tego poradnika możesz błyskawicznie przygotować lokalne środowisko testowe lub developerskie dla FacturaScripts, skupiając się na kluczowych funkcjonalnościach i zarządzaniu biznesem. Elastyczność i wygoda ServBay znacząco zwiększy efektywność Twojej pracy lokalnej!