Skip to Content

env

Object chứa secret và cấu hình của app, import từ manh/env. Chỉ dùng trong code server (.ts).

Cách dùng

app/payments/repository.ts
import { env } from "manh/env"; import { fail } from "manh/errors"; export async function createPayment(orderId: number, amount: number) { if (!env.PAY_API_KEY) fail(503, "Chưa cấu hình cổng thanh toán", "PAY_NOT_CONFIGURED"); const res = await fetch("https://pay.example.vn/v1/payments", { method: "POST", headers: { authorization: `Bearer ${env.PAY_API_KEY}`, "content-type": "application/json" }, body: JSON.stringify({ orderId, amount, returnUrl: `${env.MANH_APP_URL}/orders/${orderId}` }), }); return res.json(); }

Chữ ký

manh/env
export const env: Record<string, string | undefined>;

Tham số

Không có. env là một object; đọc env.TEN_BIEN.

Trả về

Mỗi khoá là một chuỗi, hoặc undefined khi chưa đặt. Có hai nhóm:

  • Secret của bạn: đặt bằng lệnh MCP env_set({ project, name, value }) hoặc trong trang Secret của project. Giá trị mới có hiệu lực ngay, không cần deploy lại. env_list chỉ trả tên, không trả giá trị.
  • Giá trị manh.run đặt cho mọi app: JWT_SECRET (khoá ký token đăng nhập, riêng mỗi app), MANH_APP_URL (địa chỉ app, là tên miền riêng khi đã bật), MANH_APP_NAME (tên project).

Ví dụ

Tên secret viết UPPER_SNAKE. Không dùng tên bắt đầu bằng FT_, MANH_, OPENAI_ và không dùng JWT_SECRET: các tên đó dành cho manh.run.

app/lib/token.ts
import { sign } from "hono/jwt"; import { env } from "manh/env"; export const issue = (userId: number) => sign({ sub: userId }, env.JWT_SECRET!, "HS256");
  • Email, AI và kho file không cần key: dùng manh/email, manh/openai, manh/blob. Đọc env.OPENAI_API_KEY hay các tên dành riêng khác thì check báo lỗi code.no-reserved-env, và lúc chạy giá trị là undefined.
  • Không dùng process.env hay Deno.env. manh/env là module duy nhất để đọc cấu hình.
  • Trang .tsx không import được manh/env: secret không bao giờ xuống trình duyệt.

Bước tiếp theo

Cập nhật