Kurs KohanaPHP - Podstawowa konfiguracja

Zanim stworzymy naszą pierwszą aplikację warto odpowiednio skonfigurować naszego frameworka. Jeśli o to chodzi, to Kohana może pochwalić się ogromnym wachlarzem ustawień. Skonfigurować można niemalże wszystko: od głównego adresu strony, aż po sterowniki z jakich będzie korzystała aplikacja. KohanaPHP przetrzymuje całą konfigurację w katalogu /config odpowiednio w katalogach /system i /application. Domyślnie wszystko znajdziemy w tym pierwszym, jednak aby uniknąć problemów przy aktualizacji lepiej przenieść odpowiedni plik do katalogu /application i tam go wyedytować.

Podstawowa konfiguracja

Głównym plikiem w którym przechowywana jest konfiguracja frameworka jest plik config.php. Znajdziemy w nim ogólne ustawienia związane ze stroną. Najważniejsze z nich to:

$config['site_domain'] = 'http://nasza-strona.pl';

Adres pod którym znajduje się nasza aplikacja. Na jego podstawie generowane są między innymi wszystkie hiperłącza na stronie. Możemy pozostawić tą wartość pustą – wtedy adres zostanie wykryty automatycznie.

$config['index_page'] = 'index.php';

Nazwa głównego pliku frameworka. Domyślnym plikiem jest index.php. Jeśli korzystamy z  „ładnych linków” pozostawiamy to pole puste.

$config['url_suffix'] = '';

Rozszerzenie jakie będzie doklajane do adresów. Domyślnie puste, ale jeśli zmienimy np. na .html wszystkie adresy będą posiadały taką końcówkę.

$config['global_xss_filtering'] = TRUE;

W tej części możemy skonfigurować bezpieczeństwo aplikacji. Jeśli ustawimy powyższą wartość na TRUE, to wszystkie dane zewnętrzne (GET, POST, itp.) będą zabezpieczone przed atakami typu XSS.

$config['log_threshold'] = 1;
$config['log_directory'] = APPPATH.'logs';

Czyli poziom ostrzeżeń i błędów, jaki ma być zapisywany w plikach. Domyślna wartość to 1. Zamiast tego możemy podać jedną z poniższych:

• 0 – wyłączone logowanie – żadne informacje nie będą zapisywane,
• 1 – błędy i wyjątki,
• 2 – ostrzeżenia,
• 3 – uwagi,
• 4 – tryb debugowania – najwyższy poziom debugowania, zapisywane będą wszystkie informacje związane z działaniem aplikacji. Zalecam używanie tylko w konkretnych przypadkach, gdyż plik z logami po kilku minutach może skutecznie zapchać nam serwer.

Ogólnie zasada jest taka, że im wyższa wartość, tym więcej informacji jest zapisywanych. Nie zapomnijmy ustawić ścieżki w kluczu log_directory oraz odpowiednich praw w katalogu z logami.

$config['display_errors'] = TRUE;

W tym miejscu możemy zmienić wyświetlanie błędów. Jeżeli nasza aplikacja jest już skończona i przetestowana, możemy ustawić tą wartość na FALSE – uniemożliwi to poznanie struktury serwera w przypadku wystąpienia błędu.