Next.js ফর্ম ব্যাকএন্ড ইন্টিগ্রেশন (অ্যাপ রাউটার এবং সার্ভার অ্যাকশন)
শূন্য শংসাপত্রের এক্সপোজার সহ Lugatu এন্ডপয়েন্ট এবং সার্ভার অ্যাকশন ব্যবহার করে Next.js 14/15-এ যোগাযোগের ফর্মগুলি পরিচালনার জন্য সম্পূর্ণ TypeScript এবং প্রতিক্রিয়া বাস্তবায়ন নির্দেশিকা।
1. সার্ভার অ্যাকশন সহ Next.js অ্যাপ রাউটার আর্কিটেকচার
Next.js সার্ভার অ্যাকশনগুলি সার্ভারে একচেটিয়াভাবে চালায়, ক্লায়েন্ট বান্ডিলের গোপনীয়তা প্রকাশ না করেই ব্যক্তিগত লুগাতু API কীগুলির সাথে অনুসন্ধান জমা দেওয়ার জন্য তাদের আদর্শ করে তোলে৷
'use server';
export async function submitContact(prevState: any, formData: FormData) {
// Silent rejection of automated bot submissions via honeypot trap
const honeypot = (formData.get('_gotcha') as string) || '';
if (honeypot) {
return { success: true, error: null };
}
const name = formData.get('name') as string;
const email = formData.get('email') as string;
const message = formData.get('message') as string;
if (!name || !email || !message) {
return { success: false, error: 'All fields are required.' };
}
const payload = {
fields: { name, email, message },
};
try {
const res = await fetch(`https://www.lugatu.com/api/v1/forms/${process.env.LUGATU_FORM_ID}/submissions`, {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.LUGATU_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify(payload),
});
if (!res.ok) {
return { success: false, error: 'Failed to submit form.' };
}
return { success: true, error: null };
} catch (err) {
return { success: false, error: 'Network error occurred.' };
}
}
2. লোডিং স্টেট সহ ক্লায়েন্ট-সাইড ফর্ম কম্পোনেন্ট
অ্যাক্সেসযোগ্য লোডিং সূচক সহ আপনার সার্ভার অ্যাকশনকে একটি প্রতিক্রিয়া 19 / Next.js ক্লায়েন্ট উপাদানের সাথে সংযুক্ত করুন।
'use client';
import { useActionState } from 'react';
import { submitContact } from '@/app/actions/contact';
export function ContactForm() {
const [state, formAction, isPending] = useActionState(submitContact, { success: false, error: null });
return (
<form action={formAction} className="space-y-4 max-w-md">
<div>
<label className="block text-sm font-semibold mb-1">Name</label>
<input name="name" required className="w-full border rounded-xl p-2.5" />
</div>
<div>
<label className="block text-sm font-semibold mb-1">Email</label>
<input type="email" name="email" required className="w-full border rounded-xl p-2.5" />
</div>
<div>
<label className="block text-sm font-semibold mb-1">Message</label>
<textarea name="message" rows={4} required className="w-full border rounded-xl p-2.5" />
</div>
<input type="text" name="_gotcha" style={{ display: 'none' }} tabIndex={-1} autoComplete="off" />
<button type="submit" disabled={isPending} className="btn-primary-editorial w-full py-2.5">
{isPending ? 'Sending...' : 'Send Message'}
</button>
{state.success && <p className="text-emerald-700 text-sm">Thank you! Your message was received.</p>}
{state.error && <p className="text-red-700 text-sm">{state.error}</p>}
</form>
);
}
নিরাপত্তা এবং প্রমাণীকরণ অপরিবর্তনীয়
নিরাপত্তা নির্দেশনা: NEXT_PUBLIC_ এর সাথে LUGATU_API_KEY উপসর্গ করবেন না। শুধুমাত্র ব্যক্তিগত সার্ভার-সাইড ভেরিয়েবল নিরাপদে আপনার লাইভ API কী ধরে রাখতে পারে।
সমস্যা সমাধান এবং সাধারণ ইনজেশন ত্রুটি৷
আপনি একটি API কী দিয়ে ক্লায়েন্ট-সাইড ব্রাউজার কোড থেকে একটি fetch() কল করছেন৷ হয় একটি Next.js সার্ভার অ্যাকশনে স্যুইচ করুন অথবা এপিআই কী ছাড়াই সর্বজনীন ফর্ম এন্ডপয়েন্ট ব্যবহার করুন।
প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী
আমি কি এটিকে ভার্সেল বা ক্লাউডফ্লেয়ার পৃষ্ঠাগুলিতে স্থাপন করতে পারি?
হ্যাঁ। সার্ভার অ্যাকশনগুলি সার্ভারবিহীন প্ল্যাটফর্ম এবং Next.js দ্বারা সমর্থিত প্রান্ত রানটাইম জুড়ে নির্বিঘ্নে কাজ করে।
আপনার ফর্ম শেষ বিন্দু তৈরি করতে প্রস্তুত?
সেকেন্ডের মধ্যে বিনামূল্যে শুরু করুন। কোনো ক্রেডিট কার্ডের প্রয়োজন নেই।