Biblioteka Phiend

Phiend może znajdować się w dowolnym miejscu twojego systemu. Jako, że Phiend jest biblioteką, jedna kopia może być używana przez kilka różnych stron. Nie musisz (a nawet nie powinieneś) kiedykolwiek modyfikować jakiegokolwiek pliku załączonego do Phiend'a.

Phiend składa się z następujących plików:

Zawiera główna klasę Phiend'a

Podstawowa klasa wszystkich zdarzeń

Zawiera klasę odpowiedzialną za wykonywanie uwierzytelnienia użytkownika.

Zawiera parser, odpowiedzialny za przetwarzanie napisanego przez ciebie pliku konfiguracyjnego.

Stałe używane przez analizator. Definicje aktualnych elementów, ich nazwy, dozwolona zawartość, odpowiednie zagnieżdżenia elementów i temu podobne.

Katalog zawierający przykładowe sterowniki silnika uwierzytelnienia

Katalog zawierający przykładowe sterowniki logowania

Katalog zawierający dla twojej wygody szablony zdarzeń i pliku konfiguracyjnego. Te pliki nie są używane przez Phiend'a. Możesz je skopiować, jeśli pomogą ci w tworzeniu aplikacji.

Ten plik istnieje jedynie po to, abyś mógł go skopiować do twojego katalogu głównego strony, a potem go zmieniać, jeśli okaże się to niezbędne.

To przykładowy plik konfiguracyjny w Phiend. Możesz go skopiować i używać jako podstawy w konstruowaniu pliku konfiguracyjnego twojej aplikacji.

Katalog główny witryny

Katalog główny witryny to miejsce na twoim serwerze sieciowym, skąd będzie dostępna twoja aplikacja. Jest bardzo zalecane (choć nie jest to absolutnie konieczne), żeby katalog ten zawierał jak najmniej kodu PHP. Ma to uchronić przed dostępem osób niepożądanych. Twój sieciowy katalog główny musi zawierać przynajmniej jeden plik PHP, ponieważ powinien być jakiś punkt wejścia do twojego kodu. Zadaniem tego pliku jest załadowanie twojej aplikacji, poprzez stworzenie instancji klasy ActionController.

Aby prawidłowo utworzyć aplikację, plik musi znać położenie ważnych katalogów. Nie mogą one być odczytane z pliku konfiguracyjnego, ponieważ, aby dokonać analizy składni. klasy Phiend muszą być już wprowadzone. Plik ten ma nazwę bootstrap.php. Nazwa ta bardzo dobrze opisuje jego cel. Możesz jednak zmieniać ją jak chcesz. Można przyjąć wspólną nazwę tego pliku - "index.php" tak, aby był plikiem domyślnym dla twojego katalogu głównego strony. Elementy bootstrap.php są dokładniej opisane pod "Plik samoładujący i uruchamiający się".

Katalog głowny kodu

Główny katalog kodu jest tam, gdzie są umieszczone pliki PHP. Ponieważ dobrze umieszczać jak najmniej kodu PHP w głównym katalogu witryny (miejsca na twoim serwerze, gdzie dostępna będzie twoja strona), potrzebny jest katalog przechowujący kod. Oprócz kodu PHP, twój główny katalog kodu będzie zawierał również plik konfiguracyjny i, zależnie od ustawień zawartych w "bootstrap.php", możliwe, że również inne pliki.

Katalog główny kodu musi zawierać następujące pliki i/lub katalogi:

Główny (i jedyny) plik konfiguracyjny w Phiend'zie. Musi on być umieszczony w podkatalogu twojego głównego katalogu kodu o nazwie "config", i musi być nazwany "phiend-config.xml". Składniki tego pliku są bardziej szczegółowo opisane w "Główny plik konfiguracyjny".

Katalog zawierać będzie pliki klas dla wszystkich twoich zdarzeń.

Wszystkie inne pliki i/lub katalogi są nieobowiązkowe. Na powyższym rysunku, główny katalog kodu zawiera katalogi "log/" oraz "config-output/". Są one skonfigurowane w pliku bootstrap.php a umieszczone mogą być w dowolnie przez ciebie wybranym miejscu.

Notatka