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_listchỉ 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. Đọcenv.OPENAI_API_KEYhay các tên dành riêng khác thìcheckbáo lỗicode.no-reserved-env, và lúc chạy giá trị làundefined. - Không dùng
process.envhayDeno.env.manh/envlà module duy nhất để đọc cấu hình. - Trang
.tsxkhông import đượcmanh/env: secret không bao giờ xuống trình duyệt.
Bước tiếp theo
- API handler: nơi đọc
envtrong code server. - Email, AI, kho file: các dịch vụ có sẵn dùng cùng nhau trong một app.
Cập nhật