Przewodnik Użytkownika Abyss Web Server X1 Dla Windows | ||
---|---|---|
Poprzedni | Rozdział 6. Pliki Dołączane Serwera [SSI] | Następny |
Powyższa dyrektywa używana jest do unieważnienia domyślnych ustawień SSI podczas przetwarzania pliku SSI.
#config errmsg używane jest do zmiany komunikatu wysyłanego do klienta w momencie, gdy wystąpi błąd SSI. Domyślnie, błędy SSI są zgłaszane ze szczegółowymi sposobami zachowania się, które ułatwiają debugowanie.
#config sizefmt kontroluje sposób, w jaki serwer wyświetla rozmiary plików SSI. size_format może mieć dwie wartości:
ABBREV: wyświetla rozmiary plików w kilobajtach (Kb) lub megabajtach (Mb).
BYTE: wyświetla rozmiary plików w bajtach. Jest to wartość domyślna.
#config timefmt określa format, w jakim zostaną wstawione daty w SSI. time_format musi zawierać symbole wieloznaczne, które są zastępowane przez opowiadające części daty. Dostępne symbole są wypisane poniżej wraz z opisem:
%a: Skrócona nazwa dnia tygodnia.
%A: Pełna nazwa dnia tygodnia.
%b: Skrócona nazwa miesiąca.
%B: Pełna nazwa miesiąca.
%c: Przedstawienie daty i czasu.
%d: Dzień miesiąca (01-31).
%H: Godzina w formacie 24-godzinnym (00-23).
%I: Godzina w formacie 12-godzinnym (01-12).
%j: Dzień roku jako liczba dziesiętna (001-366).
%m: Miesiąc jako liczba dziesiętna (01-12).
%M: Minuta jako liczba dziesiętna (00-59).
%p: Wskaźnik A.M. lub P.M. w formacie 12-godzinnym.
%S: Sekunda jako liczba dziesiętna (00-59).
%U: Tydzień jako liczba (00-51). Niedziela jest pierwszym dniem tygodnia.
%w: Dzień tygodnia jako liczba (0-6). Niedziela jest pierwszym dniem tygodnia.
%W: Tydzień roku jako liczba (00-51). Poniedziałek jest pierwszym dniem tygodnia.
%x: Przedstawienie daty.
%X: Przedstawienie czasu<-- dla obecnego obszaru C -->.
%y: Rok bez wieku (00-99).
%Y: Rok z wiekiem (0000-9999).
%z: Nazwa strefy czasowej; pusta jeśli nieznana.
%Z: Skrócenie nazwy strefy czasowej; pusta jeśli nieznana.
%%: Znak procentu.
#echo wstawia wartość zmiennej środowiskowej SSI. Zmienne środowiskowe SSI zawierają te dostępne dla skryptów CGI (zobacz "Zmienne środowiskowe CGI" w rozdziale "Skrypty CGI") i pięć specjalnych dla SSI:
DOCUMENT_NAME: Nazwa przetworzonego pliku SSI.
DOCUMENT_URI: Wirtualna ścieżka do aktualnie przetworzonego pliku.
DATE_LOCAL: Aktualna lokalna data.
DATE_GMT: Aktualna uniwersalna data (GMT).
LAST_MODIFIED: Data ostatniej modyfikacji przetworzonego pliku.
#exec cgi uruchamia skrypty CGI i wstawia jego wynik(i). Jeśli cgi_file zaczyna się znakiem /, uważana jest za wirtualną ścieżkę, a dyrektywy będą zachowywać się jakby to było <!-- #include virtual="cgi_file" -->. Jeśli cgi_file nie zaczyna się znakiem /, wtedy, nastomiast, uważana jest jako za względną nazwę pliku. #exec cgi będzie zachowywać się jak by to było <!-- #include file="cgi_file" -->.
Uwaga: #exec cgi jest obsługiwane tylko w celu zgodności, więc jego użycie jest niezalecane. Powinieneś używać dyrektywy #include zamiast #exec cgi.
#exec cmd wykonywuje polecenie powłoki i wstawia jego wyniki. Scieżka plików wykonywalnych powłoki umieszczona jest w systemowej zmiennej środowiskowej COMPSEC. Jeśli ta zmienna jest pusta lub nie istnieje, command.com jest używana jako domyślna powłoka.
Uwaga: #exec cmd musi być wykonywane z nadzwyczajną ostrożnością. Jeśli użytkownik może zmieniać lub modyfikować strony HTML w twojej witrynie (które występują w przypadku jeśli masz - przykładowo - forum lub księgę gości), musisz wyłączyć #exec cmd. Istotnie, mogą one zawierać znaczniki SSI z niebezpiecznymi dyrektywami #exec cmd, które mogą zostać zdalnie wywołane.
#flastmod file wstawia datę ostatniej modyfikacji pliku określonego w zmiennej file_name. file_name to względna ścieżka z katalogu zawierającego przetworzony plik SSI. Plik ten może być samym katalogu lub w jednym z jego podkatalogów.
#flastmod virtual wstawia datę ostatniej modyfikacji pliku, którego wirtualna ścieżka to virt_path.
#fsize file wstawia rozmiar pliku określonego w file_name. file_name to ścieżka wzgledna z katalogu zawierającego przetworzony plik SSI. Może być ten plik umieszczony tylko w tym samym katalogu lub w jednym z jego podkatalogów.
#fsize virtual wstawia rozmiar zawartości wynikającej z żądania virt_path od serwera. Jeśli virt_path jest plikiem statyczym, którego rozmiar zostanie wstawiony. Jeśli jest to skrypt CGI lub plik SSI, rozmiar będzie szacowany przez serwer i rozmiar pochodzący z wyników zostanie wstawiony.
#include file wydaje polecenie serwerowi sieciowemu aby wstawił plik, który musi zawierać prawidłową zawartość HTML. file_name jest ścieżką wzgledną od katalogu zawierającego przetworzony plik SSI. Załączony plik może być tylko w tym samym katalogu lub w jednym z jego podkatalogów.
#include virtual wstawia zawartość wynikającą z żądania virt_path od serwera. Jeśli virt_path jest plikiem statycznym, jego zawatość zostanie załączona "taka, jaka jest". Jeśli jest to skrypt CGI lub plik SSI, jest ona szacowana przez serwer, a następnie wstawiane są wyniki. virt_path musi zawierać lub generować prawidłową zawartość HTML.
Poprzedni | Spis treści | Następny |
Składnia SSI | Początek rozdziału | Słowniczek |