ÄÈÐÅÊÒÈÂÛ

• #break
• #config
• #echo
• #exec
• #flastmod
• #fsize
• #goto
• #include
• #label
• #printenv
• #set

Äèðåêòèâû ïî àëôàâèòó âìåñòå ñ àòðèáóòàìè. Îäíè è òå æå àòðèáóòû ìîãóò èñïîëüçîâàòüñÿ ñ ðàçíûìè äèðåêòèâàìè. Ïîèñê ïî àòðèáóòàì — íà ñòðàíèöå «Àòðèáóòû».

ÏÐÈÌÅ×ÀÍÈÅ

Çäåñü íå çàòðîíóòû äèðåêòèâû, îòíîñÿùèåñÿ ê ñïåöèôèêàöèè SSI+.

#break

Îñòàíàâëèâàåò âûâîä äîêóìåíòà.

Àòðèáóòîâ íåò

ÏÐÈÌÅÐ

<p>Ýòà ñòðîêà áóäåò íàïå÷àòàíà.</p> <!--#break --> <p>Ýòà ñòðîêà íå áóäåò íàïå÷àòàíà, ïîòîìó ÷òî äîêóìåíò îáðåçàí è ñâÿçü ñ êëèåíòîì ïðåðâàíà.</p>

ÏÐÈÌÅ×ÀÍÈÅ

Ðàáîòàåò íå íà âñåõ ñåðâåðàõ.

#config

Óïðàâëÿåò ñëåäóþùèìèìè îïöèÿìè SSI: óñòàíîâêà òåêñòà ñîîáùåíèÿ îá îøèáêå, íàñòðîéêà ôîðìàòà âûâîäà ðàçìåðà ôàéëà è äàòû/âðåìåíè. Ñàìà äèðåêòèâà íè÷åãî íå âûâîäèò, ëèøü äà¸ò óêàçàíèÿ, êîòîðûå èñïîëüçóþò äðóãèå äèðåêòèâû.

Àòðèáóòû: errmsg, sizefmt, timefmt, cmdecho, cmdprefix, cmdpostfix

errmsg — óñòàíàâëèâàåò ëþáîé òåêñò ñîîáùåíèÿ îá îøèáêå âìåñòî ñòàíäàðòíîãî [an error occurred while processing this directive].

ÏÐÈÌÅ×ÀÍÈÅ

Èíñòðóêöèÿ #config errmsg äîëæíà áûòü ïîìåùåíà íà îñíîâíîé ñòðàíèöå äîêóìåíòà. Íàõîäÿñü âî âëîæåííîé ñòðàíèöå, îíà íå ñðàáàòûâàåò. Òàê ÷òî çàäàòü å¸ îäèí ðàç íà âåñü ñàéò íå ïîëó÷èòñÿ.

ÏÐÈÌÅÐ (èç ×åõîâà)

<!--#config errmsg = "[Ïîäúåçæàÿ ê ñâîåé ñòàíöûè, ó ìåíÿ ñëåòåëà øëÿïà]" -->

Ðåçóëüòàò (çàäàíà çàâåäîìî íå ñóùåñòâóþùàÿ äèðåêòèâà)

[Ïîäúåçæàÿ ê ñâîåé ñòàíöûè, ó ìåíÿ ñëåòåëà øëÿïà]

 

sizefmt — îïðåäåëÿåò ôîðìàò âûâîäà ðàçìåðà ôàéëà:

<!--#config sizefmt = "bytes" --> — â áàéòàõ;

<!--#config sizefmt = "abbrev" --> — â êèëîáàéòàõ.

 

ÏÐÈÌÅ×ÀÍÈÅ

Ðóññêîìó ÷åëîâåêó ìîæåò ïîêàçàòüñÿ, ÷òî bytes òîæå çàäà¸ò ðàçìåð â êèëîáàéòàõ, òîëüêî ñ ìåíüøèì îêðóãëåíèåì. ß òîæå íà ýòî ïîïàëñÿ (ìèíóò 20 ãóãëèë ñïðàâî÷íèêè, ïîêà íå äîøëî äî èäèîòà). Âñïîìíèì, ÷òî «ó íèõ òàì» äåñÿòè÷íûì ðàçäåëèòåëåì ñëóæèò òî÷êà, à çàïÿòàÿ (êîòîðàÿ âûâîäèòñÿ ïðè èñïîëüçîâàíèè bytes) ïîðàçðÿäíî ðàçäåëÿåò òûñÿ÷è.

timefmt — îïðåäåëÿåò ôîðìàò âûâîäà äàòû è âðåìåíè. Äëÿ ýòîãî ñóùåñòâóåò ðÿä øàáëîíîâ (êðàñíûì ïîìå÷åíû øàáëîíû, çàâèñèìûå îò íàñòðîåê ñåðâåðà èëè ÎÑ, â [êâàäðàòíûõ ñêîáêàõ] — íåîïèñàííûå øàáëîíû, íàéäåííûå ìíîþ ýìïèðè÷åñêè).

ÏÐÈÌÅ×ÀÍÈÅ

Áîëüøèíñòâî ñåðâåðîâ ðàáîòàþò ïîä UNIX. Íî âñòðå÷àþòñÿ è ïîä Windows. Ìîé ñàéò íàõîäèòñÿ íà íîðìàëüíîì UNIX’îâîì ñåðâåðå, à äëÿ ïðåäâàðèòåëüíûõ ïðîãîíîâ è òåñòîâ ÿ ïîëüçóþñü âèðòóàëüíûì ñåðâåðîì, óñòàíîâëåííûì íà ìî¸ì êîìïüþòåðå ïîä Windows.

Ôîðìàò	Îïèñàíèå	Ðåçóëüòàò	Ïðèìå÷àíèÿ
%a	Êðàòêîå íàçâàíèå äíÿ íåäåëè	Ср
%A	Ïîëíîå íàçâàíèå äíÿ íåäåëè	Среда
%b	Àááðåâèàòóðà íàçâàíèÿ ìåñÿöà	июн	 òð¸õáóêâåííîì ìàå ïîëíîå è êðàòêîå íàçâàåèÿ ñîâïàäàþò.
%B	Ïîëíîå íàçâàíèå ìåñÿöà	Июнь
%c	ôîðìàò äàòû è âðåìåíè ïî óìîë÷àíèþ ("%x %X")	Ср 16 июн 2021 22:34:27	Íà ñåðâåðå äàííîãî ñàéòà âûâîäèòñÿ êàê "%a %b %d %X %Y"
[%C]	[?]	20	Íàø¸ë ìåòîäîì òûêà, çíà÷åíèÿ ïîêà íå ïîíÿë.
%d	Äåíü ìåñÿöà	16	îò 01 äî 31 (ñ ïðåäâàðÿþùèì íóë¸ì)
%D	Äàòà â ôîðìàòå "%m/%d/%y"	06/16/21
%e	Äåíü ìåñÿöà	16	îò 1 äî 31 (áåç ïðåäâàðÿþùåãî íóëÿ)
[%E]	[Âûâîä ñèìâîëà E]	%E	Ïîä Windows — ïóñòî.
[%f]	[Âûâîä ñèìâîëà f]	%f	Ïîä Windows — ïóñòî.
[%F]	[Äàòà â ôîðìàòå %Y-%m-%d]	2021-06-16	Ïîä Windows — ïóñòî.
[%g]	[Ãîä â ôîðìàòå ÃÃ]	21	Ïîä Windows — ïóñòî.
[%G]	[Ãîä â ôîðìàòå ÃÃÃÃ]	2021	Ïîä Windows — ïóñòî.
[%h]	[Àááðåâèàòóðà íàçâàíèÿ ìåñÿöà]	июн	Ïîä Unix — òî æå, ÷òî è %b; ïîä Windows — ïóñòî.
%H	×àñû â 24-÷àñîâîì ôîðìàòå	22	Ñ íåêîòîðûõ ïîð íà ìî¸ì ñåðâåðå âðåìÿ ïî óìîë÷àíèþ ïî÷åìó-òî óñòàíîâèëè â GMT (ïî Ãðèíâè÷ó). Òàê ÷òî íîðìàëüíîå ðîññèéñêîå âðåìÿ ÷åðåç ìîè SSI óñòàíîâèòü, óâû, íåâîçìîæíî.
[%i]	[Âûâîä ñèìâîëà i]	%i	Ïîä Windows — ïóñòî.
%I	×àñû â 12-÷àñîâîì ôîðìàòå	10
%j	Äåíü ãîäà	167	Ïîä Unix íóìåðàöèÿ ñ 1, ïîä Windows — ñ 0.
[%J]	[Âûâîä ñèìâîëà J]	%J	Ïîä Windows — ïóñòî.
[%k]	[×àñû â 24-÷àñîâîì ôîðìàòå (òî æå, ÷òî è %H)]	22	Ïîä Windows — ïóñòî.
[%K]	[Âûâîä ñèìâîëà K]	%K	Ïîä Windows — ïóñòî.
[%l]	[[×àñû â 12-÷àñîâîì ôîðìàòå (òî æå, ÷òî è %I)]	10	Ïîä Windows — ïóñòî.
[%L]	[Âûâîä ñèìâîëà L]	%L	Ïîä Windows — ïóñòî.
%m	Íîìåð ìåñÿöà	06
%M	Ìèíóòû	34
%n	Âñòàâêà ñèìâîëà íîâîé ñòðîêè
[%N]	[Âûâîä ñèìâîëà N]	%N	Ïîä Windows — ïóñòî.
[%o]	[Âûâîä ñèìâîëà o]	%o	Ïîä Windows — ïóñòî.
[%O]	[Âûâîä ñèìâîëà O]	%O	Ïîä Windows — ïóñòî.
%p	AM/PM (äî ïîëóäíÿ/ïîñëå)
[%P]	[Âûâîä ñèìâîëà P]		Ïîä Windows — ïóñòî.
[%q]	[Âûâîä ñèìâîëà q]	%q	Ïîä Windows — ïóñòî.
[%Q]	[Âûâîä ñèìâîëà Q]	%Q	Ïîä Windows — ïóñòî.
%r	Âðåìÿ â ôîðìàòå "%I:%M:%S %p"	10:34:27
%R	Âðåìÿ â ôîðìàòå "%H:%M"	22:34
%s	Âðåìÿ â ñåêóíäàõ ñ 01.01.1970	1623872067	Ïîä Windows — ïóñòî.
%S	Ñåêóíäû	27
%t	Âñòàâêà ñèìâîëà òàáóëÿöèè
%T	Âðåìÿ â ôîðìàòå "%H:%M:%S"	22:34:27
[%u]	[Íîìåð äíÿ íåäåëè]	3	Ñ ïîíåäåëüíèêà ïî âîñêðåñåíüå, 1–7 (íîìåðà ñ ïîíåäåëüíèêà ïî ñóááîòó ñîâïàäàþò ñ %w) Ïîä Windows — ïóñòî.
%U	Íåäåëÿ ãîäà (ïåðâûé äåíü íåäåëè — âîñêðåñåíüå)	24
[%v]	[Äàòà â ôîðìàòå "%e-%b-%Y"]	%v	Ïîä Windows — ïóñòî.
[%V]	[?]	24	Íàø¸ë ìåòîäîì òûêà, çíà÷åíèÿ ïîêà íå ïîíÿë.
%w	Íîìåð äíÿ íåäåëè	3	Ñ âîñêðåñåíüÿ ïî ñóááîòó, 0–6 (íîìåðà ñ ïîíåäåëüíèêà ïî ñóááîòó ñîâïàäàþò ñ %u)
%W	Íåäåëÿ ãîäà (ïåðâûé äåíü íåäåëè — ïîíåäåëüíèê)	24
%x	ôîðìàò äàòû ïî óìîë÷àíèþ	16.06.2021
%X	ôîðìàò âðåìåíè ïî óìîë÷àíèþ	22:34:27
%y	Ãîä â ôîðìàòå ÃÃ	21
%Y	Ãîä â ôîðìàòå ÃÃÃÃ	2021
[%z]	[Âðåìåííàÿ çîíà (ïîïðàâêà ê GMT)]	+0300	Íàø¸ë ìåòîäîì òûêà. Èçâèíèòå çà íóëè, íî «øëÿïà ñëåòåëà» íå ó ìåíÿ, à ó ñåðâåðà
%Z	Âðåìåííàÿ çîíà (íàçâàíèå)	MSK	Ïîä Windows ýòîò è ïðåäûäóùèé øàáëîí ïîêàçûâàþò îäèíàêîâîå çíà÷åíèå â ôîðìàòå "Ìîñêîâñêîå âðåìÿ (çèìà)"
%%	Ââîä ñèìâîëà %	%

Ìîæíî êîìáèíèðîâàòü øàáëîíû äðóã ñ äðóãîì è ñ ëþáûìè ïðî÷èìè ñèìâîëàìè.

ÏÐÈÌÅÐ

<!--#config timefmt = "%d.%m.%Y, %H:%M" --> <p>Ïîñëåäíåå îáíîâëåíèå ñòðàíèöû: <!--#flastmod file = "ssi2_1.html" --></p>

Ôîðìàò âûâîäà:

Ïîñëåäíåå îáíîâëåíèå ñòðàíèöû: 17.11.2017, 06:20

cmdecho — îïðåäåëÿåò âûõîäíûå ïàðàìåòðû êîìàíäû, âûïîëíåííîé äèðåêòèâîé #exec cmd.

ÎÏÈÑÛÂÀÞ ×ÈÑÒÎ ÒÅÎÐÅÒÈ×ÅÑÊÈ. ÍÀ ÏÐÀÊÒÈÊÅ ÏÎÊÀ ×ÒÎ [...ÑËÅÒÅËÀ ØËßÏÀ]

Ôîðìàò:

<!--#config cmdecho = "onoroff" -->

onoroff — ON èëè OFF. Åñëè êîìàíäà äèðåêòèâû #exec cmd âîçâðàùàåò äàííûå, êîòîðûå ìîæíî âûâåñòè ÷åðåç #echo, îíè âûâîäÿòñÿ ïðè çíà÷åíèè ON è èãíîðèðóþòñÿ ïðè çíà÷åíèè OFF.

Ïî óìîë÷àíèþ — OFF.

Ôîðìàò âûâîäèìûõ äàííûõ çàâèñèò îò íàëè÷èÿ èëè îòñóòñòâèÿ äèðåêòèâ #config cmdprefix è #config cmdpostfix.

Ïðè îòñóòñòâèè ýòèõ äèðåêòèâ äàííûå âûâîäÿòñÿ áåç ôîðìàòèðîâàíèÿ è èíòåðïðåòàöèè ñïåöèàëüíûõ ñèìâîëîâ. Ïðè èõ íàëè÷èè âûâîä áóäåò îòôîðìàòèðîâàí è èíòåðïðåòèðîâàí â ñîîòâåòñòâèè ñ èõ çíà÷åíèÿìè.

cmdprefix — èñïîëüçóåòñÿ äëÿ óñòàíîâêè òåêñòà, íà÷èíàþùåãî êàæäóþ ñòðîêó, âûâîäèìóþ êàæäîé ñëåäóþùåé èíñòðóêöèåé #exec cmd.

ÎÏÈÑÛÂÀÞ ×ÈÑÒÎ ÒÅÎÐÅÒÈ×ÅÑÊÈ. ÍÀ ÏÐÀÊÒÈÊÅ ÏÎÊÀ ×ÒÎ [...ÑËÅÒÅËÀ ØËßÏÀ]

Ôîðìàò:

<!--#config cmdprefix = "ñòðîêà" -->

ñòðîêà — ëþáîé ñèìâîë è/èëè òýã HTML.

cmdpostfix — èñïîëüçóåòñÿ äëÿ óñòàíîâêè òåêñòà, çàâåðøàþùåãî êàæäóþ ñòðîêó, âûâîäèìóþ êàæäîé ñëåäóþùåé èíñòðóêöèåé #exec cmd.

ÎÏÈÑÛÂÀÞ ×ÈÑÒÎ ÒÅÎÐÅÒÈ×ÅÑÊÈ. ÍÀ ÏÐÀÊÒÈÊÅ ÏÎÊÀ ×ÒÎ [...ÑËÅÒÅËÀ ØËßÏÀ]

Ôîðìàò:

<!--#config cmdpostfix = "ñòðîêà" -->

ñòðîêà — ëþáîé ñèìâîë è/èëè òýã HTML.

#echo

Âûâîäèò çíà÷åíÿ ïåðåìåííûõ èëè äàòû, îòôîðìàòèðîâàííîé â èíñòðóêöèè #config timefmt.

Àòðèáóòû: encoding, var

encoding — íåîáÿçàòåëüíûé àòðèáóò, îïðåäåëÿåò èíòåðïðåòàöèþ òåêñòà áðàóçåðîì. Èìååò 3 çíà÷åíèÿ: entity (ïî óìîë÷àíèþ), url è none.

• entity — ïî óìîë÷àíèþ.  ýòîì ñëó÷àå ïðîèñõîäèò çàìåíà ñèìâîëîâ ÿçûêà HTML íà ñïåöñèìâîëû äëÿ âûâîäà èõ íà ñòðàíèöó;
• url — ïðîèçîäèòñÿ òàê íàçûâàåìîå escape-ïðåîáðàçîâàíèå, ò.å. âñå ñèìâîëû ïðèîáðåòóò âèä %nn (nn — êîä ñèìâîëà â 16-ðè÷íîé êîäèðîâêå), ÷òî ïîçâîëèò èõ ïðèìåíÿòü â ñòðîêå URL;
• none — íå áóäåò íèêàêèõ ïðåîáðàçîâàíèé, ò.å. òýãè HTML, êîòîðûå ðàíüøå çàìåíÿëèñü íà ñïåöñèìâîëû, òåïåðü çàìåíÿòüñÿ íå áóäóò, è â ïåðåìåííûå SSI ìîæíî âñòàâëÿòü êîä HTML. À âîò ñïåöñèìâîëû áóäóò çàìåíÿòüñÿ íà òýãè.

ÏÐÈÌÅ×ÀÍÈÅ

Àòðèáóò encoding âñåãäà ñòàâèòñÿ ïåðåä àòðèáóòîì var.

ÏÐÈÌÅÐ

<!--#set var = "string1" value = "Òåñòèðóåì <b>òýãè</b> <i>HTML</i>" -->
<p>Ïî óìîë÷àíèþ:<br><!--#echo var = "string1" --></p>
<p>Çíà÷åíèå none:<br><!--#echo encoding = "none" var = "string1" --></p>
<p>Çíà÷åíèå url:<br><!--#echo encoding = "url" var = "string1" --></p>

Ðåçóëüòàò

Ïî óìîë÷àíèþ:
Òåñòèðóåì <b>òýãè</b> <i>HTML</i>

Çíà÷åíèå none:
Òåñòèðóåì òýãè HTML

var — îïðåäåëÿåò èìÿ ïåðåìåííîé, çíà÷åíèå êîòîðîé íàäî âûâåñòè.

ÏÐÈÌÅÐÛ

Âûâîä òåêóùåãî âðåìåíè â ôîðìàòå «÷÷:ìì:ññ»

<!--#config timefmt = "%T" --> <p>Òåêóùåå âðåìÿ: <!--#echo var = "DATE_LOCAL" --></p>

Ðåçóëüòàò

Òåêóùåå âðåìÿ: 22:34:27

Âûâîä çíà÷åíèÿ ïåðåìåííîé îêðóæåíèÿ HTTP_USER_AGENT

<p><!--#echo var = "HTTP_USER_AGENT" --></p>

Ðåçóëüòàò

CCBot/2.0 (https://commoncrawl.org/faq/)

#exec

Çàïóñêàåò âíåøíèå ïðîãðàììû è ñêðèïòû CGI.

Àòðèáóòû: cmd, cgi

cmd — çàäà¸ò ïàðàìåòðû äëÿ âûïîëíåíèÿ ïðîãðàìì, âûïîëíÿåìûõ UNIX shell.

ÎÏÈÑÛÂÀÞ ×ÈÑÒÎ ÒÅÎÐÅÒÈ×ÅÑÊÈ. ÍÀ ÏÐÀÊÒÈÊÅ ÏÎÊÀ ×ÒÎ [...ÑËÅÒÅËÀ ØËßÏÀ]

Ôîðìàò:

<!--#exec cmd = "èìÿ_ïðîãðàììû ñïèñîê_àðãóìåíòîâ" -->

èìÿ_ïðîãðàììû — ïîëíîå èìÿ èñïîëíÿåìîé ïðîãðàììû èëè êîìàíäû;

ñïèñîê_àðãóìåíòîâ — ñïèñîê àðãóìåíòîâ, ïîñûëàåìûõ èñïîëíÿåìîé ïðîãðàììå.

ÏÐÈÌÅ×ÀÍÈÅ

Íà ñåðâåðå äîëæíû áûòü çàäàíû ïóòè ê èñïîëíÿåìîé ïðîãðàììå â ïåðåìåííîé îêðóæåíèÿ PATH.

Ïðè îòñóòâèè ïóòè ïðîãðàììó ìîæíî çàïóñòèòü, èñïîëüçóÿ shell èëè ñêðèïò CGI.

Ñòàíäàðòíûé âûâîä ïðîãðàììû íàïðàâëÿåòñÿ â äîêóìåíò HTML. Âûâîä ìîæåò áûòü ìîäèôèöèðîâàí äèðåêòèâîé #config cmdecho.

ÏÐÈÌÅ×ÀÍÈÅ

Ïîä Win32 è ïîä UNIX ñ èñïîëüçîâàíèåì suExec â äèðåêòèâå #exec cmd íåëüçÿ ïåðåäàâàòü àðãóìåíòû êîìàíäû èëè èíûì îáðàçîì âêëþ÷àòü ïðîáåëû â çíà÷åíèè cmd. Ñëåäóþùèé ïðèìåð áóäåò ðàáîòàòü òîëüêî ïîä UNIX êîíôèãóðàöèè non-suExec, íî íå ñðàáîòàåò íè ïîä Win32, íè ïðè âûïîëíåíèè suExec:

<!--#exec cmd="perl /cgi-bin/counter/counter.pl page4" -->

Âìåñòî ýòîãî ñëåäóåò ïðèìåíèòü äðóãóþ äèðåêòèâó:

<!--#include virtual="/cgi-bin/counter/counter.pl?page4" -->

 ëþáîì ñëó÷àå: åñëè ìîæíî îáîéòèñü äèðåêòèâîé #include, òî ëó÷øå ïðèìåíÿòü å¸ âìåñòî #exec.

cgi — âûçûâàåò ñêðèïò CGI. Âûçûâàåìûé ñêðèïò äîëæåí íàõîäèòñÿ â äèðåêòîðèè cgi-bin èëè èìåòü ðàñøèðåíèå .cgi. Ôîðìàò:

<!--#exec cgi = "èìÿ_ñêðèïòà" -->

èìÿ_ñêðèïòà — ïîëíîå èìÿ ñêðèïòà CGI.

Âûâîä ñêðèïòà ïîäñòàâëÿåòñÿ â äîêóìåíò.

#flastmod

Îòîáðàæàåò äàòó ïîñëåäíãî îáíîâëåíèÿ óêàçàííîãî ôàéëà (ôîðìàò äàòû ìîæíî óñòàíîâèòü äèðåêòèâîé config).

Àòðèáóòû: file, virtual

file — óêàçûâàåò ïóòü ê ôàéëó îòíîñèòåëüíî òåêóùåãî äîêóìåíòà. Ìîæíî èñïîëüçîâàòü êàê òåêñòîâûå ôàéëû, òàê è HTML-äîêóìåíòà, à òàêæå âêëþ÷àòü äðóãèå SSI-ôàéëû (îáû÷íî ñ ðàñøèðåíèåì shtml) — íî òîëüêî òå, êîòîðûå íàõîäÿòñÿ â òîé æå ïàïêå, ÷òî è äàííàÿ ñòðàíèöà.

virtual — çàäàåò âèðòóàëüíûé ïóòü ê äîêóìåíòó íà ñåðâåðå. Íà÷èíàåòñÿ ñî ñëýøà.

/file.html — íàõîäèòñÿ â êîðíåâîé ïàïêå.

/subdir/file.html — íàõîäèòñÿ â ïàïêå subdir, âëîæåííîé â êîðíåâóþ.

ÏÐÈÌÅÐ

<!--#config timefmt = "%d.%m.%Y, %H:%M" --> <p>Ïîñëåäíåå îáíîâëåíèå ñòðàíèöû: <!--#flastmod file = "ssi2_1.html" --></p>

Ðåçóëüòàò

Ïîñëåäíåå îáíîâëåíèå ñòðàíèöû: 17.11.2017, 06:20

#fsize

Îòîáðàæàåò ðàçìåð îïðåäåë¸ííîãî ôàéëà (ôîðìàò âûâîäà ðàçìåðà ôàéëà ìîæíî îïðåäåëèòü äèðåêòèâîé #config).

Àòðèáóòû: file, virtual

file — óêàçûâàåò ïóòü ê ôàéëó îòíîñèòåëüíî òåêóùåãî äîêóìåíòà.

virtual — çàäàåò âèðòóàëüíûé ïóòü ê äîêóìåíòó íà ñåðâåðå.

(Ïîäðîáíåå îá ýòèõ àòðèáóòàõ ñì. #flastmod).

ÏÐÈÌÅÐÛ

Îïðåäåëÿåì ðàçìåð äàííîãî ôàéëà â áàéòàõ (÷åðåç àòðèáóò file).

ÏÐÈÌÅ×ÀÍÈÅ

Íå ïóòàéòå «èìïîðòíûå» òî÷êè è çàïÿòûå.

<!--#config sizefmt = "bytes" --> <p><!--#fsize file = "ssi2_1.html" --></p>

Ðåçóëüòàò

45,076

Îïðåäåëÿåì ðàçìåð ãëàâíîé ñòðàíèöû «Ìàñòåðñêîé Ñàìîäåëêèíà» â áàéòàõ (÷åðåç àòðèáóò file).

<!--#config sizefmt = "bytes" --> <p><!--#fsize fil e ="index.html" --></p>

Ðåçóëüòàò

5,134

Îïðåäåëÿåì ðàçìåð ãëàâíîé ñòðàíèöû ñàéòà â êèëîáàéòàõ (÷åðåç àòðèáóò virtual).

<!--#config sizefmt = "abbrev" --> <p><!--#fsize virtual = "/index.html" --></p>

Ðåçóëüòàò

8.4K

Îïðåäåëÿåì ðàçìåð ãëàâíîé ñòðàíèöû «Ìàñòåðñêîé Ñàìîäåëêèíà» â êèëîáàéòàõ (÷åðåç àòðèáóò virtual).

<!--#config sizefmt = "abbrev" --> <p><!--#fsize virtual = "/samodel/index.html" --></p>

Ðåçóëüòàò

5.0K

#goto

Îïåðàòîð ïåðåõîäà íà ìåòêó.

Àòðèáóòîâ íåò, âìåñòî àòðèáóòà èñïîëüçóåòñÿ çíà÷åíèå

ìåòêà — èìÿ ìåòêè, îïðåäåëÿåìîå äèðåêòèâîé #label.

ÏÐÈÌÅÐ

<!--#goto = "testlabel" --> <p>Ýòà ñòðîêà íå âûâîäèòñÿ.</p> <!--#label = "testlabel" --> <p>Ýòà ñòðîêà âûâîäèòñÿ.</p>

ÏÐÈÌÅ×ÀÍÈÅ

Ðàáîòàåò íå íà âñåõ ñåðâåðàõ.

#include

Äèðåêòèâà include — îäíà èç íàèáîëåå èñïîëüçóåìûõ. Ó íåêîòîðûõ ýòîé äèðåêòèâîé îãðàíè÷èâàåòñÿ âñ¸ ïðåäñòàâëåíèå îá SSI.

Âñòàâëÿåò ñîäåðæèìîå äðóãîãî ôàéëà â òåêóùèé äîêóìåíò. Ê ôàéëó îáÿçàòåëüíî äîëæåí áûòü îòêðûò äîñòóï, èíà÷å îí íå áóäåò ïîêàçàí.

Ìîæíî âêëþ÷àòü ôàéëû ñ ðàñøèðåíèåì .txt, .htm, .html, .shtml. Äëÿ îñíîâíîãî ôàéëà — «ïðè¸ìíèêà» âêëþ÷åíèé — ïðåäóñìîòðåíî ñïåöèàëüíîå ðàñøèðåíèå .shtml, íî ýòî íå îáÿçàòåëüíî è çàâèñèò îò íàñòðîåê ñåðâåðà, êîòîðûìè ìîæíî óïðàâëÿòü â ôàéëå .htaccess (ñì. «Íàñòðîéêà ñåðâåðà»).

Àòðèáóòû: file, virtual

file — óêàçûâàåò ïóòü ê ôàéëó îòíîñèòåëüíî òåêóùåãî äîêóìåíòà.

virtual — çàäàåò âèðòóàëüíûé ïóòü ê äîêóìåíòó íà ñåðâåðå.

(Ïîäðîáíåå îá ýòèõ àòðèáóòàõ ñì. #fsize).

ÏÐÈÌÅÐ

<!--#include file = "top1.html" -->

Ðåçóëüòàò ìîæíî óâèäåòü â «øàïêå» ýòîé ñòðàíèöû è äðóãèõ, åé ïîäîáíûõ.

#label

Óñòàíàâëèâàåò ìåòêó â äîêóìåíòå, êîòîðàÿ èñïîëüçóåòñÿ äèðåêòèâîé #goto.

Àòðèáóòîâ íåò, âìåñòî àòðèáóòà èñïîëüçóåòñÿ çíà÷åíèå

ÏÐÈÌÅÐ

<!--#goto = "testlabel" --> <p>Ýòà ñòðîêà íå âûâîäèòñÿ.</p> <!--#label = "testlabel" --> <p>Ýòà ñòðîêà âûâîäèòñÿ.</p>

ÏÐÈÌÅ×ÀÍÈÅ

Ðàáîòàåò íå íà âñåõ ñåðâåðàõ.

#printenv

Âûâîäèò èìåíà è çíà÷åíèÿ âñåõ ïåðåìåííûõ îêðóæåíèÿ, îïðåäåë¸ííûõ íà äàííîì ñåðâåðå.

Àòðèáóòîâ íåò

ÏÐÈÌÅÐ

Âûâîäèì ñïèñîê âñåõ ïåðåìåííûõ îêðóæåíèÿ

ÏÐÈÌÅ×ÀÍÈÅ

×òîáû áûëî «÷èòàáåëüíåå», ëó÷øå ýòî ñäåëàòü â òýãå <pre>, à ÷òîáû ïðè ýòîì íå ïîðóøèòü äèçàéí, íàçíà÷èòü åìó â CSS ïðèåìëåìóþ øèðèíó è çàäàòü ïðîêðóòêó. Ïîñêîëüêó ñïèñîê î÷åíü äëèííûé, èìååò ñìûñë îãðàíè÷èòü è âûñîòó êîíòåéíåðà (ñ ñîîòâåòñòâóþùåé ïðîêðóòêîé).

<pre style="width: 610px; height: 300px; overflow: scroll;"> <!--#printenv --> </pre>

Ðåçóëüòàò

HTTP_HOST=froland.ru
HTTP_X_FORWARDED_FOR=44.192.253.106, 44.192.253.106
HTTP_X_FORWARDED_PROTO=http
HTTP_X_REQUEST_SCHEME=http
HTTP_CONNECTION=close
HTTP_USER_AGENT=CCBot/2.0 (https://commoncrawl.org/faq/)
HTTP_ACCEPT=text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
HTTP_ACCEPT_LANGUAGE=en-US,en;q=0.5
HTTP_IF_MODIFIED_SINCE=Mon, 10 May 2021 04:13:37 GMT
HTTP_ACCEPT_ENCODING=br,gzip
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/snap/bin
SERVER_SIGNATURE=<address>Apache/2.4.41 (Ubuntu) PHP/5.3.29 mod_fcgid/2.3.9 mod_perl/2.0.9 Perl/v5.22.1 Server at froland.ru Port 80</address>

SERVER_SOFTWARE=Apache/2.4.41 (Ubuntu) PHP/5.3.29 mod_fcgid/2.3.9 mod_perl/2.0.9 Perl/v5.22.1
SERVER_NAME=froland.ru
SERVER_ADDR=10.3.117.188
SERVER_PORT=80
REMOTE_ADDR=44.192.253.106
DOCUMENT_ROOT=/home/frolan01/froland.ru/docs
REQUEST_SCHEME=http
CONTEXT_PREFIX=
CONTEXT_DOCUMENT_ROOT=/home/frolan01/froland.ru/docs
SERVER_ADMIN=postmaster@froland.ru
SCRIPT_FILENAME=/home/frolan01/froland.ru/docs/samodel/ssi2_1.html
REMOTE_PORT=37880
GATEWAY_INTERFACE=CGI/1.1
SERVER_PROTOCOL=HTTP/1.0
REQUEST_METHOD=GET
QUERY_STRING=
REQUEST_URI=/samodel/ssi2_1.html
SCRIPT_NAME=/samodel/ssi2_1.html
DATE_LOCAL=16.06.2021, 22:34
DATE_GMT=16.06.2021, 19:34
LAST_MODIFIED=17.11.2017, 06:20
DOCUMENT_URI=/samodel/ssi2_1.html
DOCUMENT_ARGS=
USER_NAME=frolan01
DOCUMENT_NAME=ssi2_1.html
TIME_FMT=%
string1=Òåñòèðóåì <b>òýãè</b> <i>HTML</i>

Êðîìå âûâîäà ýòîãî îãðîìíîãî ñïèñêà, äèðåêòèâà #printenv íè÷åãî äåëàòü íå óìååò.

×òîáû âûâåñòè çíà÷åíèÿ îòäåëüíûõ ïåðåìåííûõ îêðóæåíèÿ, íóæíî èñïîëüçîâàòü #echo var.

Âûâåäåì ðàçíûå âàðèàíòû àäðåñà ýòîé ñòðàíèöû

<p><!--#echo var = "SCRIPT_FILENAME" --></p> <p><!--#echo var = "SCRIPT_URI" --></p> <p><!--#echo var = "SCRIPT_URL" --></p>

Ðåçóëüòàò

/home/frolan01/froland.ru/docs/samodel/ssi2_1.html

(none)

(none)

Åñëè çàäàííàÿ ïåðåìåííàÿ íå îïðåäåëåíà íà äàííîì ñåðâåðå, âûâîäèòñÿ (none).

#set

Óñòàíàâëèâàåò çíà÷åíèå ïåðåìåííîé

Àòðèáóòû: var, value (èñïîëüçóþòñÿ âìåñòå)

var — îïðåäåëÿåò èìÿ ïåðåìåííîé;

value — îïðåäåëÿåò çíà÷åíèå ïåðåìåííîé.

ÏÐÈÌÅÐ

<!--#set var = "test1" value = "Òåñòèðóåì äèðåêòèâó #set" --> <p><!--#echo var = "test1" --></p>

Ðåçóëüòàò

Òåñòèðóåì äèðåêòèâó #set

froland2@yandex.ru