
# Cloudflare Workers

`--platform cloudflare` は、`worker.mjs`、`main.js`、`prelude.js` を持つ `build/cloudflare/` と、アプリケーションのディレクトリの `wrangler.toml` (一度だけ) を書きます。`npx wrangler deploy` でデプロイします。[ビルド](building.md) を参照してください。

- ワーカーの `env` はリクエストとともに届くので、コンテキストは最初のリクエストで起動します。その文字列の値 (`[vars]`、シークレット) はアプリケーションの環境になります。オブジェクトであるバインディング (KV、D1) はプロパティではありません。下の「バインディング」を参照してください。
- クライアントのアドレスは `CF-Connecting-IP` です。これは Cloudflare のネットワークが自分で設定し、クライアントが送ってきたときは置き換えます。
- `wrangler.toml` は一度だけアプリケーションのディレクトリに、名前、`main` としてビルドされた `worker.mjs`、その日の互換性日付とともに書かれます。それ以降はあなたのものです (バインディング、ルート、cron トリガー)。

## バインディング

Bean `cloudflareBindings` (`CloudflareBindings`) は、ワーカーの KV 名前空間 (`KvNamespace`) と D1 データベース (`D1Database`) を、`wrangler.toml` でのバインディング名で返します。

```toml
[[kv_namespaces]]
binding = "SETTINGS"
id = "..."

[[d1_databases]]
binding = "DB"
database_name = "shop"
database_id = "..."
```

```dart
@Service()
class Settings {
  Settings(this.bindings);
  final CloudflareBindings bindings;

  Future<String?> theme() => bindings.kv('SETTINGS').get('theme');

  Future<List<Map<String, Object?>>> orders(String user) => bindings
      .d1('DB')
      .query('select id, total from orders where user = ?1', [user]);
}
```

バインディングはリクエストとともに届きます。コンストラクターではなく、リクエスト (またはスケジュールイベント) を処理している間に使ってください。その他の種類のバインディング (キュー、R2、Durable Objects) の API は、まだありません。

## D1 のレートリミッター

`spring.edge.cloudflare.rate-limit.database: DB` (D1 データベースのバインディング) を設定すると、レートリミッターのカウンターはそのデータベースに置かれます (`D1RateLimitStore`、ストア名 `d1`。アトミックな一つの文で、テーブルがなければ作られます)。ワーカーのすべてのインスタンスで共有されます。`spring.edge.cloudflare.rate-limit.table` でテーブル名を指定できます (デフォルトは `rate_limit`)。KV はカウンターを置く場所ではありません。書き込みがアトミックではないためです。

## cron トリガー

cron トリガー (`wrangler.toml` の `[triggers] crons`) は、アプリケーションの `EdgeScheduledHandler` の Bean を実行します。`event.schedule` はトリガーの式です。[スケジュールによる処理](differences.md) を参照してください。

## 関連項目

- [関数のデプロイ](deploying.md#cloudflare-workers): デプロイの手順。手作業と GitHub Actions
- [関数が異なる点](differences.md)
- [すべてのプロパティ](properties.md)
