← Cloudflare Pages / pages / functions

Směrování

Functions využívají směrování založené na souborech. Váš /functions struktura adresáře určuje trasy, na kterých budou vaše Functions běžet. Můžete vytvořit /functions adresář s tolika úrovněmi, kolik váš projekt potřebuje. Prohlédněte si následující adresář:

Na základě výše uvedené struktury souborů se vygenerují následující trasy. Tyto trasy mapují vzor URL adresy na /functions soubor, který se spustí, když návštěvník přejde na URL:

Pokud se nenajde odpovídající Function, dojde k návratu na statické aktivum, pokud existuje. V opačném případě se Function vrátí na výchozí chování směrování pro statická aktiva Pages.

Dynamické trasy umožňují porovnávat URL adresy se segmenty obsahujícími parametry. To se hodí při tvorbě dynamických aplikací. Změnou názvu souboru můžete přijímat dynamické hodnoty, které se mapují na jedinou cestu.

Chcete-li vytvořit dynamickou trasu, umístěte kolem názvu souboru jednu dvojici závorek, například /users/[user].js. Tímto vytváříte zástupný symbol pro jeden segment cesty:

Pokud název souboru obalíte dvěma páry hranatých závorek, například /users/[[user]].js : shoda platí pro libovolnou hloubku trasy za /users/:

Projděte si následující /functions/ struktura adresáře:

Následující požadavky budou odpovídat těmto souborům:

Segment(y) URL adresy, které odpovídají zástupnému symbolu ([user]) bude k dispozici v požadavku context objekt. context.params objekt lze použít k nalezení odpovídající hodnoty pro daný zástupný symbol názvu souboru.

Pro soubory, které odpovídají jedinému segmentu URL (použijte jednu dvojici závorek), se hodnoty vracejí jako řetězec:

export function onRequest(context) {
	return new Response(context.params.user);
}

Výše uvedená logika vrátí daniel pro požadavky na /users/daniel.

Pro soubory, které odpovídají více segmentům URL (použijte dvojitou dvojici závorek), se hodnoty vracejí jako pole:

export function onRequest(context) {
	return new Response(JSON.stringify(context.params.catchall));
}

Výše uvedená logika vrátí ["daniel", "xyz", "123"] pro požadavky na /users/daniel/xyz/123.

U čistě statického projektu nabízí Pages neomezený počet požadavků zdarma. Jakmile ale do projektu Pages přidáte Functions, všechny požadavky ve výchozím nastavení spustí vaši Function. Aby vám statické požadavky zůstaly zdarma a bez omezení, vyřaďte statické trasy svého projektu vytvořením _routes.json soubor. Tento soubor se automaticky vygeneruje, pokud functions adresář je ve vašem projektu detekován při jeho publikování pomocí Pages CI nebo Wrangler.

Vytvořte _routes.json soubor pro řízení toho, kdy se vaše Function spustí. Měl by být umístěn v sestavovacím adresáři vašeho projektu.

Tento soubor bude obsahovat tři různé vlastnosti:

• verze: Definuje verzi schématu. V současnosti existuje pouze jedna verze schématu (verze 1), do budoucna však plánujeme přidávat další a usilujeme o zpětnou kompatibilitu.
• zahrnout: Definuje trasy, které budou vyvolávat Functions. Podporuje zástupné znaky.
• vyloučit: Definuje trasy, které nebudou vyvolávat Functions. Podporuje zástupné znaky. exclude mají vždy přednost před include.

Níže je příklad _routes.json.

{
	"version": 1,
	"include": ["/*"],
	"exclude": []
}

Tento _routes.json zavolá vaše Functions na všech trasách.

Níže je další příklad _routes.json soubor. Jakákoli cesta uvnitř /build adresář nevyvolá Function a nebude účtován poplatek za vyvolání Functions.

{
	"version": 1,
	"include": ["/*"],
	"exclude": ["/build/*"]
}

Pokud používáte tarif Workers Free, můžete nastavit, jak se Pages zachová po vyčerpání denního limitu bezplatného tarifu pro požadavky Pages Functions. Pokud například ve svých Pages Functions provádíte ověřování uživatelů nebo jinou kritickou funkcionalitu, možná budete chtít po vyčerpání limitu svůj projekt Pages vypnout.

1. V dashboardu Cloudflare přejděte na Workers & Pages stránce.

   Přejděte na Workers & Pages ↗

2. Vyberte svůj projekt Pages.

3. Přejděte na Nastavení > Runtime > Fail open / closed.

"Fail open" znamená, že se statické soubory budou obsluhovat i nadále, i když by za normálních okolností nejprve proběhly Pages Functions. "Fail closed" znamená, že se místo statických souborů vrátí chybová stránka.

Denní limit požadavků pro Pages Functions lze zcela odstranit přechodem na Workers Standard.

Trasy vyvolání Functions mají následující limity:

• Musíte mít alespoň jedno pravidlo include.
• Celkem můžete mít nejvýše 100 pravidel include/exclude.
• Každé pravidlo může mít maximálně 100 znaků.