Skip to content
Adrian Goral edited this page Nov 29, 2024 · 3 revisions

Uruchamianie lokalne

Instrukcja krok po kroku, jak skonfigurować i uruchomić lokalnie stronę internetową KN Algo w HTML, CSS, JavaScript i PHP.


Wymagania wstępne

Przed rozpoczęciem upewnij się, że masz zainstalowane:


Kroki instalacji

1. Instalacja PHP

  1. Pobierz PHP z oficjalnej strony.
  2. Dodaj ścieżkę do pliku wykonywalnego PHP (php.exe) do zmiennej środowiskowej PATH:
    • Na Windows: W panelu sterowania przejdź do System -> Zaawansowane ustawienia systemu -> Zmienne środowiskowe.
    • Dodaj folder PHP do zmiennej PATH (np. C:\php).

2. Instalacja Composera

  1. Pobierz instalator Composera z tej strony.
  2. Uruchom instalator i upewnij się, że poprawnie wykrywa PHP zainstalowane w systemie.

Uruchamianie projektu

Konfiguracja lokalna Gita

Jeśli konfigurujesz Git po raz pierwszy na swoim komputerze, ustaw swoją nazwę użytkownika i email (takie same jak na Githubie):

git config --global user.name "Twoje Imię"
git config --global user.email "[email protected]"

Sklonowanie repozytorium

Otwórz terminal i wpisz:

git clone https://github.com/KN-Algo/strona-internetowa.git
cd strona-internetowa

Instalacja zależności Composera

W głównym katalogu projektu uruchom polecenie:

composer install

To polecenie pobierze wszystkie niezbędne zależności PHP wymagane przez projekt.

Opcjonalnie: plik .env

Być może będziesz potrzebować do poprawnego wytestowania wszystkich funkcji (wysyłanie maili) pliku .env. Gdy taka sytuacja wystąpi, zgłoś się do mnie, wtedy Ci go wyślę 😃

Uruchomienie serwera PHP

W głównym katalogu projektu wpisz:

php -S 0.0.0.0:8000

Serwer lokalny PHP zostanie uruchomiony na porcie 8000.

Dostęp do strony

Przejdź na stronę 127.0.0.1:8000 by potwierdzić poprawność konfiguracji i działania strony.


Typowe problemy i ich rozwiązania

Composer nie wykrywa PHP

  • Sprawdź, czy ścieżka do PHP została poprawnie dodana do zmiennej PATH.
  • Upewnij się, że uruchamiasz Composer z terminala, który ma dostęp do zmiennych środowiskowych (np. Command Prompt, PowerShell, Git Bash).

Port 8000 jest zajęty

W tym przypadku, wystarczy podmienić go na inny podczas wykonywania komendy uruchomienia serwera:

php -S 127.0.0.1:8080

Problemy nie ustępują i nie możesz zacząć pracy?

Skontaktuj się ze mną na Discordzie: eddy6666