Jak rozpocząć?

Rozpoczęcie pracy z yesFramework jest bardzo proste i szybkie. Na początek pobierz paczkę w najnowszej wersji stąd.

Zawartość należy przekopiować w taki sposób, by katalog public odpowiadał katalogowi, w którym domyślnie znajdują się pliki strony internetowej widoczne dla użytkownika. Następnie wywołaj adres swojej strony internetowej. Twoim oczom ukaże strona startowa. Gotowe! Właśnie zainstalowałeś i uruchomiłeś yesFramework!

Co teraz?

Na początek odnajdź plik .env w głównym katalogu projektu oraz config.php w folderze src/yesFramework/Core. Są to pliki konfiguracyjne, w których możesz wprowadzić podstawowe dane, takie jak środowisko działania (development/production), dane dostępowe do bazy danych i inne ustawienia. Poprawne wypełnienie tych danych jest niezbędne do działania frameworku. Zauważysz też, że framework wykorzystuje nowoczesną strukturę OOP oraz własny router. Zajrzyj do pliku public/index.php, by sprawdzić jak rejestrowane są ścieżki (routing), a następnie zerknij do WelcomeController.php w src/yesFramework/App/Controllers/. Plik ten odpowiada za stronę startową, którą widzisz po wywołaniu adresu w przeglądarce. Przeanalizuj go, by dowiedzieć się, w jaki sposób yesFramework obsługuje modele i kontrolery.

Dodajemy nowy kontroler

Kontrolery to klasy obsługujące ścieżki (routing). Aby dodać nowy kontroler, utwórz klasę PHP w src/yesFramework/App/Controllers/. Następnie zarejestruj ścieżkę korzystając z Routera w pliku public/index.php:

$router->get('/twoja-sciezka', [TwojKontroler::class, 'nazwaMetody']);

Wywołanie adresu www.example.com/twoja-sciezka spowoduje uruchomienie metody `nazwaMetody` z Twojego kontrolera. yesFramework obsługuje zarówno ścieżki statyczne, jak i dynamiczne parametry, np. /user/{id}.

Dodajemy widok

By załadować wybrany widok, należy w kontrolerze wpisać następującą linię:

Base::load_view('nazwaszablonu.php','nazwawidoku.php',$data_to_body);

Zmienna $data_to_body jest tablicą elementów, która zostanie wstrzyknięta do plików nazwaszablonu.php oraz nazwawidoku.php, które znajdują się w katalogu App/Views.

Przykład

$data_to_body = array(
	"header" => "example header",
	"data_from_class" => $data_from_class,
	"footer" => "example footer"
);

Base::load_view('template.php', 'content.php', $data_to_body);

W plikach template.php i content.php powstaną zmienne o nazwach $header, data_from_class oraz $footer, które będą zawierać wartości z tablicy.

Podsumowanie

Zachęcam do zapoznania się z całą dokumentacją wraz z przykładami tutaj. Mam nadzieję, że ten szybki start jest w miarę zrozumiały.