← Cloudflare Pages / pages / functions
Начало работы
Это руководство расскажет, как создать и развернуть Pages Function.
Предварительные требования
Необходимо иметь проект Pages, настроенный на локальной машине или развёрнутый через панель управления Cloudflare. Чтобы создать проект Pages, обратитесь к Начало работы.
Создайте функцию
Чтобы начать создавать Pages Function, создайте /functions директория. Убедитесь, что /functions директория находится в корне проекта Pages (а не в статическом корне, таком как /dist).
Написание файлов Functions в /functions директория автоматически создаст Worker с пользовательской функциональностью на заранее заданных маршрутах.
Скопируйте и вставьте следующий код в helloworld.js файл, который вы создаёте в /functions папка:
export function onRequest(context) {
return new Response("Hello, world!");
}В приведённом выше примере кода onRequest обработчик принимает запрос context объект. Обработчик должен вернуть Response или Promise для Response.
Эта функция будет выполняться на /helloworld маршрут и возвращает "Hello, world!". Эта Function доступна на данном маршруте потому, что файл называется helloworld.js. Аналогично, если бы этот файл назывался howdyworld.js, эта функция будет выполняться на /howdyworld.
См. Маршрутизация чтобы узнать больше о настройке маршрутов.
Возможности среды выполнения
Возможности среды выполнения Workers можно настраивать для Pages Functions, включая совместимость с частью API Node.js и возможность задать дата совместимости или флаг совместимости.
Настройте эти параметры, передав аргумент в Wrangler или задать их в дашборде. Чтобы задать флаги совместимости Pages в дашборде Cloudflare:
- Войдите в Панель управления Cloudflare ↗ и выберите свой аккаунт.
- Выберите Workers & Pages и выберите свой проект Pages.
- Выберите Настройки > Функции > Флаги совместимости.
- Настройте флаги совместимости Production и Preview по необходимости.
Кроме того, используйте другие продукты Cloudflare, например D1 (serverless-БД) и R2 изнутри вашего проекта Pages, настроив привязки.
Разверните вашу функцию
После того как вы настроите Function, разверните проект Pages. Чтобы развернуть проект:
- Подключение вашего Провайдер Git.
- Использование Wrangler из командной строки.
Дополнительные материалы
- Настройте свой Маршрутизация Function
- Просмотрите Справочник по API
- Узнайте, как отладить Function