← Cloudflare Pages / pages / functions

Маршрутизация

Functions используют файловую маршрутизацию. Ваш /functions структура директорий определяет маршруты, на которых будут выполняться ваши Functions. Вы можете создать /functions директория с таким количеством уровней, какое требуется для задач вашего проекта. Рассмотрим следующую директорию:

На основе приведённой выше структуры файлов будут сгенерированы следующие маршруты. Эти маршруты сопоставляют шаблон URL-адреса с /functions файл, который вызывается, когда посетитель переходит по URL:

Если для Function не находится совпадения, она будет использовать статический ресурс, если он есть. В противном случае Function будет использовать в качестве резервного варианта поведение маршрутизации по умолчанию для статических файлов Pages.

Динамические маршруты позволяют сопоставлять URL с параметризованными сегментами. Это полезно при создании динамических приложений: вы можете принимать динамические значения, которые сопоставляются с одним путем, изменив имя файла.

Чтобы создать динамический маршрут, заключите имя файла в квадратные скобки, например, /users/[user].js. Тем самым вы создаете заполнитель для одного сегмента пути:

Если заключить имя файла в двойные квадратные скобки, например, /users/[[user]].js : вы сопоставляете маршрут любой глубины после /users/:

Ознакомьтесь со следующим /functions/ структура директорий:

Следующие запросы будут соответствовать следующим файлам:

Сегмент(ы) URL-адреса, соответствующие заполнителю ([user]) будет доступен в запросе context объект. context.params объект можно использовать, чтобы найти значение, соответствующее заданному заполнителю имени файла.

Для файлов, соответствующих одному сегменту URL (используется одна пара скобок), значения возвращаются в виде строки:

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

Описанная выше логика вернёт daniel для запросов к /users/daniel.

Для файлов, соответствующих нескольким сегментам URL (используется двойная пара скобок), значения возвращаются в виде массива:

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

Описанная выше логика вернёт ["daniel", "xyz", "123"] для запросов к /users/daniel/xyz/123.

Для полностью статического проекта Pages предоставляет неограниченное количество бесплатных запросов. Однако как только вы добавляете Functions в проект Pages, все запросы по умолчанию начинают вызывать вашу Function. Чтобы сохранить неограниченное количество бесплатных статических запросов, исключите статические маршруты проекта, создав _routes.json файл. Этот файл будет создан автоматически, если functions директория обнаружена в вашем проекте при публикации проекта с помощью Pages CI или Wrangler.

Создайте _routes.json файл, чтобы управлять тем, когда вызывается Function. Его следует разместить в каталоге сборки проекта.

Этот файл будет включать три свойства:

• версия: Определяет версию схемы. На данный момент существует только одна версия схемы (версия 1), но в будущем могут появиться новые версии, и мы стремимся сохранять обратную совместимость.
• включить: Определяет маршруты, которые будут вызывать Functions. Поддерживает символы подстановки.
• исключить: Определяет маршруты, которые не будут вызывать Functions. Поддерживает символы подстановки. exclude всегда имеет приоритет над include.

Ниже приведён пример _routes.json.

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

Это _routes.json будет вызывать ваши Functions на всех маршрутах.

Ниже приведён ещё один пример _routes.json файл. Любой маршрут внутри /build директорию не вызовет Function и не приведет к списанию платы за вызов Functions.

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

Если вы используете тариф Workers Free, вы можете настроить поведение Pages при исчерпании дневного лимита бесплатного тарифа на запросы Pages Functions. Например, если в Pages Functions выполняются проверки аутентификации или другая критически важная логика, вы можете отключать свой проект Pages при исчерпании лимита.

1. На панели управления Cloudflare перейдите к разделу Workers & Pages страницу.

   Перейдите в Workers & Pages ↗

2. Выберите свой проект Pages.

3. Перейдите в Настройки > Runtime > Fail open / closed.

«Разрешать при сбое» означает, что статические ресурсы продолжат обслуживаться, даже если Pages Functions обычно должны были сработать первыми. «Блокировать при сбое» означает, что вместо статических ресурсов будет возвращена страница ошибки.

Суточный лимит запросов для Pages Functions можно полностью снять, перейдя на Workers Standard.

Для маршрутов вызова Functions действуют следующие ограничения:

• Должно быть указано хотя бы одно правило включения.
• Суммарно может быть не более 100 правил включения и исключения.
• Каждое правило может содержать не более 100 символов.