KoaJS একটি অত্যন্ত লঘু এবং কাস্টমাইজযোগ্য ওয়েব ফ্রেমওয়ার্ক যা Node.js-এ তৈরি। KoaJS-এ Form Data এবং File Upload হ্যান্ডল করা সম্ভব এবং এর জন্য koa-body বা koa-multer মতো মিডলওয়্যার ব্যবহার করা হয়। এই টিউটোরিয়ালে, আমরা দেখব কিভাবে KoaJS-এ Form Data এবং ফাইল আপলোড হ্যান্ডল করা যায়।
১. Form Data হ্যান্ডল করা
Form Data সাধারণত application/x-www-form-urlencoded বা multipart/form-data টাইপের ডেটা হয়। সাধারণত ওয়েব ফর্মের মাধ্যমে ডেটা পাঠানোর জন্য এই ধরনের ডেটা ব্যবহার করা হয়। KoaJS-এ koa-body বা koa-bodyparser মিডলওয়্যার ব্যবহার করা হয় Form Data পার্স করার জন্য।
১.১. koa-body ইনস্টল করা
Form Data প্রসেস করার জন্য প্রথমে আপনাকে koa-body ইনস্টল করতে হবে:
npm install koa-body
১.২. koa-body ব্যবহার করে Form Data হ্যান্ডল করা
এখন আপনি KoaJS অ্যাপে koa-body ব্যবহার করে Form Data হ্যান্ডল করতে পারবেন:
const Koa = require('koa');
const Router = require('koa-router');
const bodyParser = require('koa-body');
const app = new Koa();
const router = new Router();
// koa-body মিডলওয়্যার ব্যবহার করা
app.use(bodyParser());
// Form Data হ্যান্ডল করা
router.post('/submit', (ctx) => {
const formData = ctx.request.body; // Form Data অ্যাক্সেস করা
ctx.body = {
message: 'Form Data received successfully!',
data: formData
};
});
// রাউট মাউন্ট করা
app
.use(router.routes())
.use(router.allowedMethods());
// অ্যাপ চালু করা
app.listen(3000, () => {
console.log('Server is running on http://localhost:3000');
});
এখানে, koa-body মিডলওয়্যারটি POST রিকোয়েস্টের body থেকে Form Data পার্স করে এবং আপনি ctx.request.body এর মাধ্যমে সেগুলি অ্যাক্সেস করতে পারেন।
২. File Upload হ্যান্ডল করা
KoaJS-এ ফাইল আপলোড হ্যান্ডল করার জন্য সবচেয়ে জনপ্রিয় মিডলওয়্যার হলো koa-multer। এটি multipart/form-data ফরম্যাটে ফাইল আপলোডের জন্য ব্যবহৃত হয়।
২.১. koa-multer ইনস্টল করা
File Upload হ্যান্ডল করার জন্য প্রথমে koa-multer ইনস্টল করুন:
npm install koa-multer
২.২. koa-multer ব্যবহার করে File Upload হ্যান্ডল করা
এখন আমরা koa-multer ব্যবহার করে ফাইল আপলোডের প্রক্রিয়া দেখব:
const Koa = require('koa');
const Router = require('koa-router');
const multer = require('koa-multer');
const path = require('path');
const app = new Koa();
const router = new Router();
// File Upload এর জন্য multer কনফিগারেশন
const storage = multer.diskStorage({
destination: (req, file, cb) => {
cb(null, './uploads'); // ফাইল আপলোড করার ডিরেক্টরি
},
filename: (req, file, cb) => {
cb(null, Date.now() + path.extname(file.originalname)); // ফাইলের নাম সেট করা
}
});
const upload = multer({ storage: storage });
// File Upload রাউট
router.post('/upload', upload.single('file'), (ctx) => {
// File আপলোড হওয়ার পর ফাইল ইনফরমেশন অ্যাক্সেস করা
ctx.body = {
message: 'File uploaded successfully!',
file: ctx.file // আপলোড করা ফাইলের তথ্য
};
});
// রাউট মাউন্ট করা
app
.use(router.routes())
.use(router.allowedMethods());
// অ্যাপ চালু করা
app.listen(3000, () => {
console.log('Server is running on http://localhost:3000');
});
২.৩. File Upload উদাহরণ
এখানে /upload রাউটে একটি POST রিকোয়েস্ট পাঠানোর মাধ্যমে ফাইল আপলোড করা হয়। upload.single('file') মিডলওয়্যারটি ফাইলটি পার্স করে এবং ctx.file এর মাধ্যমে ফাইলটির তথ্য অ্যাক্সেস করা যায়।
উল্লেখযোগ্য পয়েন্টসমূহ:
destination: ফাইল কোথায় সেভ হবে তা নির্ধারণ করে।filename: ফাইলের নাম কিভাবে সেট হবে তা নির্ধারণ করে (এখানে আমরা তারিখ ও ফাইলের এক্সটেনশন ব্যবহার করেছি)।upload.single('file'): ফাইল আপলোড করার জন্যsingleমেথড ব্যবহার করা হয়, যেখানেfileফর্মের ইনপুট নাম।
২.৪. Multiple File Upload হ্যান্ডল করা
যদি একাধিক ফাইল আপলোড করতে চান, তাহলে upload.array() মেথড ব্যবহার করতে হবে:
router.post('/multiple-upload', upload.array('files', 10), (ctx) => {
// Multiple files আপলোড হওয়ার পর ফাইল ইনফরমেশন অ্যাক্সেস করা
ctx.body = {
message: 'Multiple files uploaded successfully!',
files: ctx.files // আপলোড করা ফাইলগুলোর তথ্য
};
});
এখানে, files ইনপুট নাম ব্যবহার করা হয়েছে এবং 10 ফাইল আপলোড করার সীমা নির্ধারণ করা হয়েছে।
৩. File Upload Error Handling
ফাইল আপলোডের সময় কিছু ত্রুটি ঘটতে পারে, যেমন বড় ফাইল সাইজ বা অচেনা ফাইল টাইপ। koa-multer ত্রুটি হ্যান্ডলিংয়ের জন্য onError ফাংশনও প্রদান করে।
router.post('/upload', upload.single('file'), (ctx) => {
ctx.body = {
message: 'File uploaded successfully!',
file: ctx.file
};
}, (err, ctx) => {
ctx.status = 400;
ctx.body = { message: 'File upload failed!', error: err.message };
});
এখানে, যদি কোনো ত্রুটি ঘটে তবে তা err এর মাধ্যমে ধরা পড়বে এবং 400 (Bad Request) স্ট্যাটাস কোডের সাথে রেসপন্স করা হবে।
সারাংশ
KoaJS-এ Form Data এবং File Upload হ্যান্ডল করা খুবই সহজ। আপনি koa-body মিডলওয়্যার ব্যবহার করে Form Data এবং koa-multer ব্যবহার করে ফাইল আপলোড হ্যান্ডল করতে পারেন। koa-multer এর মাধ্যমে আপনি ফাইল সেভ করার ডিরেক্টরি, নাম এবং একাধিক ফাইল আপলোড কনফিগার করতে পারেন। এর মাধ্যমে আপনি সহজেই আপনার KoaJS অ্যাপ্লিকেশনে Form Data এবং ফাইল আপলোড ফিচার যুক্ত করতে পারবেন।
KoaJS-এ ফর্ম ডেটা হ্যান্ডল করা খুবই সহজ, এবং এটি সাধারণত koa-bodyparser প্যাকেজ ব্যবহার করে করা হয়। koa-bodyparser একটি মিডলওয়্যার যা POST, PUT, এবং PATCH রিকোয়েস্টের বডি থেকে ডেটা প্যার্স করতে সাহায্য করে। এটি JSON, URL-encoded, এবং ফর্ম ডেটা সহ বিভিন্ন ধরনের বডি প্যার্স করতে পারে।
এই টিউটোরিয়ালে আমরা দেখব কিভাবে KoaJS ব্যবহার করে ফর্ম ডেটা হ্যান্ডল করা যায় এবং কিভাবে koa-bodyparser মিডলওয়্যারটি সেটআপ করা যায়।
১. koa-bodyparser ইনস্টলেশন
প্রথমে আপনাকে koa-bodyparser ইনস্টল করতে হবে। নিচে দেওয়া কমান্ডটি ব্যবহার করে এটি ইনস্টল করুন:
npm install koa-bodyparser
২. KoaJS অ্যাপে koa-bodyparser ব্যবহার করা
এখন, আপনি koa-bodyparser ইনস্টল করার পর এটি কিভাবে ব্যবহার করবেন তা দেখব। ফর্ম ডেটা, যেমন application/x-www-form-urlencoded বা multipart/form-data, koa-bodyparser এর মাধ্যমে প্যার্স করা যায়। সাধারণত application/x-www-form-urlencoded ডেটা ফর্ম সাবমিট করার জন্য ব্যবহৃত হয়।
উদাহরণ:
const Koa = require('koa');
const bodyParser = require('koa-bodyparser'); // koa-bodyparser ইমপোর্ট
const app = new Koa();
// koa-bodyparser মিডলওয়্যার যোগ করা
app.use(bodyParser());
app.use(async (ctx) => {
if (ctx.method === 'POST') {
// ফর্ম ডেটা অ্যাক্সেস করা
const { username, email } = ctx.request.body;
ctx.body = `Received username: ${username} and email: ${email}`;
} else {
ctx.body = `
<form method="POST">
<label for="username">Username:</label>
<input type="text" name="username" /><br />
<label for="email">Email:</label>
<input type="text" name="email" /><br />
<input type="submit" value="Submit" />
</form>
`;
}
});
app.listen(3000, () => {
console.log('Server running on http://localhost:3000');
});
এই কোডে, আমরা একটি ফর্ম তৈরি করেছি যা POST রিকোয়েস্ট পাঠায়। ফর্মে দুটি ইনপুট ফিল্ড রয়েছে: username এবং email। যখন ফর্মটি সাবমিট করা হয়, তখন koa-bodyparser সেই ডেটা ctx.request.body এ প্যার্স করে নিয়ে আসে।
কিভাবে কাজ করে:
koa-bodyparser()মিডলওয়্যারটি ডেটা প্যার্স করার কাজ করে। এটি ফর্ম ডেটা, JSON, বা URL-encoded ডেটা প্যার্স করে।- কনটেক্সট অবজেক্টে
ctx.request.bodyঅ্যাক্সেস করার মাধ্যমে আপনি ফর্মের ইনপুট ডেটা ব্যবহার করতে পারবেন। - ফর্ম ডেটা প্যার্স হওয়ার পরে, এটি অ্যাপ্লিকেশনের মধ্যে প্রয়োগ করা হয়।
৩. JSON এবং URL-encoded ডেটা হ্যান্ডলিং
koa-bodyparser JSON এবং URL-encoded উভয় ধরনের ডেটা প্যার্স করতে সহায়তা করে। যখন আপনি JSON বা URL-encoded ডেটা পাঠান, koa-bodyparser সেগুলোকে ctx.request.body এ প্যার্স করে রাখে।
JSON ডেটা:
app.use(async (ctx) => {
if (ctx.method === 'POST') {
const { username, password } = ctx.request.body;
ctx.body = `Received username: ${username} and password: ${password}`;
} else {
ctx.body = `
<form method="POST" action="/login">
<input type="text" name="username" />
<input type="password" name="password" />
<button type="submit">Login</button>
</form>
`;
}
});
URL-encoded ডেটা:
Content-Type: application/x-www-form-urlencoded ফর্মের মাধ্যমে ডেটা পাঠানো হয়, এবং koa-bodyparser এটি প্যার্স করে ctx.request.body এ রাখে।
৪. Multi-part ফর্ম ডেটা
koa-bodyparser multipart/form-data (ফাইল আপলোডের জন্য ব্যবহৃত) প্যার্স করতে সহায়তা করে না। এর জন্য আপনি koa-multipart প্যাকেজ ব্যবহার করতে পারেন। যদি আপনি ফাইল আপলোডের জন্য কাজ করতে চান, তাহলে koa-multipart ইনস্টল এবং কনফিগার করা উচিত।
npm install koa-multipart
তারপর koa-multipart ব্যবহার করে ফাইল আপলোড এবং ফর্ম ডেটা একসাথে হ্যান্ডল করা যায়।
সারাংশ
KoaJS-এ ফর্ম ডেটা হ্যান্ডল করার জন্য koa-bodyparser মিডলওয়্যার ব্যবহার করা সহজ। এটি URL-encoded, JSON, এবং ফর্ম ডেটা প্যার্স করতে সহায়তা করে। ফর্ম ডেটা প্যার্স করার জন্য ctx.request.body ব্যবহার করা হয়, যেখানে আপনি ফর্মের ইনপুট ডেটা অ্যাক্সেস করতে পারবেন। koa-bodyparser কে একটি শক্তিশালী টুল হিসেবে ব্যবহার করে আপনি সহজেই POST বা PUT রিকোয়েস্টের ডেটা হ্যান্ডল করতে পারবেন।
KoaJS একটি অত্যন্ত লঘু ও কাস্টমাইজযোগ্য ওয়েব ফ্রেমওয়ার্ক, এবং এতে ফাইল আপলোড পরিচালনা করার জন্য সাধারণত koa-multer প্যাকেজটি ব্যবহৃত হয়। koa-multer হলো KoaJS এর জন্য একটি মিডলওয়্যার যা ফাইল আপলোডের কাজ সহজ করে তোলে। এটি multer প্যাকেজের KoaJS-এর জন্য তৈরি করা সংস্করণ, যা মূলত ফাইল আপলোডের সময় ফাইলগুলি প্রসেস ও স্টোর করার জন্য ব্যবহৃত হয়।
এখানে আমরা দেখব কিভাবে koa-multer ব্যবহার করে ফাইল আপলোড করা যায়।
koa-multer ইনস্টল করা
প্রথমে আপনাকে koa-multer প্যাকেজটি ইনস্টল করতে হবে। এটি multer এর KoaJS-এর জন্য তৈরি করা সংস্করণ।
npm install koa-multer
koa-multer দিয়ে ফাইল আপলোড করার প্রাথমিক উদাহরণ
ধরা যাক, আপনি একটি API তৈরি করতে চান যেখানে ব্যবহারকারীরা তাদের ফাইল আপলোড করতে পারবেন। আমরা এখানে একটি ফাইল আপলোডের প্রাথমিক উদাহরণ দেখাবো।
১. koa-multer মিডলওয়্যার কনফিগার করা
প্রথমে koa-multer কে আপনার অ্যাপ্লিকেশনে ইমপোর্ট করুন এবং কনফিগার করুন।
const Koa = require('koa');
const Router = require('koa-router');
const multer = require('koa-multer');
const path = require('path');
// Koa অ্যাপ্লিকেশন এবং রাউটার তৈরি
const app = new Koa();
const router = new Router();
// Multer কনফিগারেশন
const storage = multer.diskStorage({
destination: (req, file, cb) => {
cb(null, './uploads'); // ফাইল কোথায় সেভ হবে
},
filename: (req, file, cb) => {
cb(null, Date.now() + path.extname(file.originalname)); // ফাইলের নাম কাস্টমাইজ করা
},
});
// Multer মিডলওয়্যার তৈরি করা
const upload = multer({ storage: storage });
// রাউট তৈরি
router.post('/upload', upload.single('file'), async (ctx) => {
// ফাইল আপলোড করা হলে রেসপন্স
if (ctx.file) {
ctx.body = {
message: 'File uploaded successfully!',
file: ctx.file,
};
} else {
ctx.status = 400;
ctx.body = 'No file uploaded!';
}
});
// রাউটার কনফিগার করা
app.use(router.routes()).use(router.allowedMethods());
// অ্যাপ্লিকেশন চালু করা
app.listen(3000, () => {
console.log('Server running on http://localhost:3000');
});
এখানে কী হচ্ছে:
multer.diskStorage(): এটি ফাইলের সঞ্চয়ের জায়গা এবং ফাইলের নাম কাস্টমাইজ করে।destination: এটি ফাইলটি কোথায় সংরক্ষণ করা হবে তা নির্ধারণ করে (এই উদাহরণে,./uploadsফোল্ডারে)।filename: এটি ফাইলের নাম কাস্টমাইজ করে, যাতে ফাইলটির নাম ফাইল আপলোডের সময় ডেটাইম স্ট্যাম্প সহ থাকে।
upload.single('file'): এটি একটি ফাইল আপলোডের জন্য ব্যবহৃত হয় এবংfileহল HTML ফর্মের ইনপুট ফিল্ডের নাম।ctx.file: এই প্রপার্টি দিয়ে আপনি আপলোড করা ফাইলের তথ্য অ্যাক্সেস করতে পারবেন।
HTML ফর্মের মাধ্যমে ফাইল আপলোড
এখন, আপনি একটি HTML ফর্ম তৈরি করতে পারেন যা ফাইল আপলোড করবে। উদাহরণস্বরূপ:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>File Upload</title>
</head>
<body>
<h1>Upload a File</h1>
<form action="http://localhost:3000/upload" method="POST" enctype="multipart/form-data">
<input type="file" name="file" required />
<button type="submit">Upload</button>
</form>
</body>
</html>
এই ফর্মের মাধ্যমে আপনি ফাইলটি /upload রাউটে POST রিকোয়েস্ট পাঠাতে পারবেন। ফাইল আপলোডের পর আপনি সফল মেসেজ সহ ফাইলের তথ্য পাবেন।
আপলোড ফোল্ডার তৈরি করা
যেহেতু ফাইলগুলি ./uploads ফোল্ডারে সেভ করা হচ্ছে, তাই নিশ্চিত করুন যে আপনার প্রকল্পে একটি uploads ফোল্ডার আছে। যদি না থাকে, তাহলে এটি তৈরি করুন:
mkdir uploads
ফাইল আপলোডের সফল রেসপন্স
যখন আপনি ফাইল সফলভাবে আপলোড করবেন, তখন KoaJS অ্যাপ্লিকেশন আপনাকে একটি JSON রেসপন্স দেবে, যেমন:
{
"message": "File uploaded successfully!",
"file": {
"fieldname": "file",
"originalname": "example.jpg",
"encoding": "7bit",
"mimetype": "image/jpeg",
"destination": "./uploads",
"filename": "1633038012345.jpg",
"path": "uploads/1633038012345.jpg",
"size": 1024
}
}
ফাইল আপলোডের ত্রুটি হ্যান্ডলিং
যদি ফাইলের সাইজ বেশি হয় বা অন্য কোনো সমস্যা ঘটে, তবে আপনি multer এর মাধ্যমে ত্রুটি হ্যান্ডলিংও কনফিগার করতে পারেন। উদাহরণস্বরূপ, ফাইল সাইজ সীমাবদ্ধ করা:
const upload = multer({
storage: storage,
limits: { fileSize: 5 * 1024 * 1024 }, // 5MB ফাইল সাইজ সীমা
});
router.post('/upload', upload.single('file'), async (ctx) => {
if (ctx.file) {
ctx.body = {
message: 'File uploaded successfully!',
file: ctx.file,
};
} else {
ctx.status = 400;
ctx.body = 'File size is too large!';
}
});
এটি 5MB এর বেশি সাইজের ফাইল আপলোড করা থেকে রোধ করবে।
সারাংশ
KoaJS-এ koa-multer ব্যবহার করে আপনি খুব সহজে ফাইল আপলোড পরিচালনা করতে পারেন। koa-multer কনফিগার করে আপনি ফাইল আপলোডের গন্তব্য, নাম, সাইজ সীমা ইত্যাদি কাস্টমাইজ করতে পারেন। এর মাধ্যমে আপনি ফাইল আপলোডের একটি শক্তিশালী এবং কাস্টমাইজযোগ্য সিস্টেম তৈরি করতে পারবেন।
KoaJS একটি লঘু এবং কাস্টমাইজযোগ্য ওয়েব ফ্রেমওয়ার্ক যা Node.js পরিবেশে ব্যবহৃত হয়। ওয়েব অ্যাপ্লিকেশন ডেভেলপমেন্টে ফাইল আপলোড একটি গুরুত্বপূর্ণ বিষয়, এবং KoaJS-এ ফাইল আপলোড কনফিগারেশন করা সম্ভব। তবে, ফাইল আপলোডের সময় নিরাপত্তা নিশ্চিত করা অত্যন্ত জরুরি, যাতে আপনার অ্যাপ্লিকেশনটি আক্রমণ থেকে সুরক্ষিত থাকে। এই গাইডে আমরা KoaJS-এ ফাইল আপলোড কনফিগারেশন এবং নিরাপত্তা নিশ্চিত করার বিভিন্ন পদক্ষেপ আলোচনা করব।
ফাইল আপলোড কনফিগারেশন
KoaJS-এ ফাইল আপলোড করতে koa-body বা koa-multer এর মতো মিডলওয়্যার ব্যবহার করা হয়। এই মিডলওয়্যারগুলি ফাইল আপলোডের জন্য প্রয়োজনীয় ফাংশনালিটি সরবরাহ করে।
১. koa-body ইনস্টল এবং ব্যবহার করা
koa-body একটি জনপ্রিয় মিডলওয়্যার যা ফর্ম ডেটা, JSON এবং ফাইল আপলোডকে সমর্থন করে।
ইনস্টলেশন:
npm install koa-body
উদাহরণ:
const Koa = require('koa');
const Router = require('koa-router');
const bodyParser = require('koa-body');
const path = require('path');
const fs = require('fs');
const app = new Koa();
const router = new Router();
// koa-body মিডলওয়্যার ফাইল আপলোডের জন্য কনফিগার করা
app.use(bodyParser({
multipart: true, // multipart ফর্ম ডেটা গ্রহণ করতে
formidable: {
uploadDir: path.join(__dirname, 'uploads'), // আপলোড ডিরেক্টরি
keepExtensions: true, // ফাইলের এক্সটেনশন ধরে রাখা
maxFileSize: 2 * 1024 * 1024, // 2MB এর বেশি সাইজ না নিতে
}
}));
// ফাইল আপলোড রাউট
router.post('/upload', (ctx) => {
const files = ctx.request.files; // আপলোড করা ফাইলগুলো
ctx.body = {
message: 'File uploaded successfully!',
files: files
};
});
// রাউট মাউন্ট করা
app
.use(router.routes())
.use(router.allowedMethods());
// সার্ভার চালু করা
app.listen(3000, () => {
console.log('Server is running on http://localhost:3000');
});
এখানে:
koa-bodyমিডলওয়্যারটি ফাইল আপলোড এবং ফর্ম ডেটা গ্রহণের জন্য কনফিগার করা হয়েছে।uploadDir-এ ফাইলগুলি সেভ করা হবে।maxFileSizeদ্বারা ফাইল সাইজ সীমাবদ্ধ করা হয়েছে।
২. koa-multer ব্যবহার করা
আরেকটি জনপ্রিয় মিডলওয়্যার হলো koa-multer, যা বিশেষভাবে ফাইল আপলোডের জন্য ব্যবহৃত হয়।
ইনস্টলেশন:
npm install koa-multer
উদাহরণ:
const Koa = require('koa');
const Router = require('koa-router');
const multer = require('koa-multer');
const path = require('path');
const app = new Koa();
const router = new Router();
// ফাইল আপলোডের জন্য কনফিগারেশন
const storage = multer.diskStorage({
destination: function (req, file, cb) {
cb(null, 'uploads/'); // আপলোড ডিরেক্টরি
},
filename: function (req, file, cb) {
cb(null, Date.now() + path.extname(file.originalname)); // ফাইল নাম কাস্টমাইজ করা
}
});
const upload = multer({ storage: storage });
// ফাইল আপলোড রাউট
router.post('/upload', upload.single('file'), (ctx) => {
ctx.body = {
message: 'File uploaded successfully!',
file: ctx.file
};
});
// রাউট মাউন্ট করা
app
.use(router.routes())
.use(router.allowedMethods());
// সার্ভার চালু করা
app.listen(3000, () => {
console.log('Server is running on http://localhost:3000');
});
এখানে:
multer.diskStorageব্যবহার করে ফাইলেরdestinationএবংfilenameকাস্টমাইজ করা হয়েছে।upload.single('file')ব্যবহার করে একটি ফাইল আপলোড করা হচ্ছে।
ফাইল আপলোডের নিরাপত্তা
ফাইল আপলোডের সময় কিছু নিরাপত্তা সতর্কতা অবলম্বন করা অত্যন্ত গুরুত্বপূর্ণ। কিছু সাধারণ নিরাপত্তা পদক্ষেপ নিচে আলোচনা করা হল।
১. ফাইল সাইজ সীমাবদ্ধ করা
বিশাল ফাইল আপলোড করা নিরাপত্তার জন্য ঝুঁকি হতে পারে। তাই ফাইল সাইজ সীমাবদ্ধ করা উচিত।
maxFileSize: 2 * 1024 * 1024 // 2MB সীমাবদ্ধ
এটি ফাইল সাইজ 2MB এর বেশি হতে দেবে না।
২. ফাইল টাইপ ভ্যালিডেশন
ফাইলের টাইপ চেক করা উচিত, যেন শুধুমাত্র নির্দিষ্ট ধরনের ফাইল (যেমন: .jpg, .png, .pdf) আপলোড করা যায়।
const allowedTypes = ['image/jpeg', 'image/png'];
app.use(bodyParser({
formidable: {
filter: function (file) {
if (allowedTypes.indexOf(file.type) === -1) {
throw new Error('Unsupported file type!');
}
return file;
}
}
}));
৩. ফাইল নাম ভ্যালিডেশন
ফাইল নামের মধ্যে স্পেস, স্পেশাল ক্যারেক্টার বা স্ক্রিপ্ট থাকতে পারে যা নিরাপত্তার জন্য ক্ষতিকারক হতে পারে। তাই ফাইল নাম sanitize করা উচিত।
const sanitize = require('sanitize-filename');
const filename = sanitize(file.originalname);
এখানে, sanitize-filename প্যাকেজটি ব্যবহার করে ফাইল নাম sanitize করা হয়েছে, যাতে অযাচিত ক্যারেক্টার এবং স্ক্রিপ্ট থাকে না।
৪. অথেন্টিকেশন এবং অথরাইজেশন
ফাইল আপলোডের আগে ব্যবহারকারীকে অথেন্টিকেট করা এবং যাচাই করা উচিত, যাতে অজ্ঞাত ব্যবহারকারীরা ফাইল আপলোড না করতে পারে।
app.use(async (ctx, next) => {
if (!ctx.state.user) { // যাচাই করা হচ্ছে ব্যবহারকারী লগিন অবস্থায় আছে কিনা
ctx.status = 401;
ctx.body = 'Unauthorized';
return;
}
await next();
});
এখানে, ctx.state.user যাচাই করে ব্যবহারকারীর অথেন্টিকেশন চেক করা হচ্ছে।
সারাংশ
KoaJS-এ ফাইল আপলোড কনফিগারেশন সহজ এবং কার্যকরী। koa-body বা koa-multer মিডলওয়্যার ব্যবহার করে আপনি সহজেই ফাইল আপলোডের জন্য কনফিগারেশন করতে পারেন। তবে, ফাইল আপলোডের সময় নিরাপত্তা নিশ্চিত করা অত্যন্ত গুরুত্বপূর্ণ। কিছু সাধারণ নিরাপত্তা পদক্ষেপ যেমন ফাইল সাইজ সীমাবদ্ধ করা, ফাইল টাইপ ভ্যালিডেশন, ফাইল নাম sanitize করা এবং অথেন্টিকেশন নিশ্চিত করা ফাইল আপলোডকে নিরাপদ করে তোলে। KoaJS-এ এইসব পদক্ষেপ অবলম্বন করলে আপনি একটি সুরক্ষিত এবং কার্যকরী ফাইল আপলোড সিস্টেম তৈরি করতে পারবেন।
KoaJS হল একটি আধুনিক এবং শক্তিশালী ওয়েব ফ্রেমওয়ার্ক যা Node.js পরিবেশে ব্যবহৃত হয়। KoaJS-এ ফর্ম ডেটা এবং ফাইল ম্যানেজমেন্ট সহজভাবে করা যায়, বিশেষ করে যখন আপনি POST রিকোয়েস্টে ফর্ম ডেটা বা ফাইল আপলোড করতে চান। এই টিউটোরিয়ালে, আমরা ফর্ম ডেটা এবং ফাইল ম্যানেজমেন্টের জন্য KoaJS-এ প্রয়োজনীয় টুলস এবং মিডলওয়্যার ব্যবহারের পদ্ধতি আলোচনা করব।
১. ফর্ম ডেটা প্রসেসিং
KoaJS-এ ফর্ম ডেটা প্রসেস করতে সাধারণত koa-bodyparser বা koa-multer মিডলওয়্যার ব্যবহৃত হয়। ফর্ম ডেটা যেমন application/x-www-form-urlencoded বা application/json ধরনের হতে পারে, এবং এগুলোকে KoaJS অ্যাপ্লিকেশনে পার্স করতে হয়।
১.১ koa-bodyparser ব্যবহার করা
koa-bodyparser একটি সহজ এবং সাধারণ মিডলওয়্যার, যা application/json এবং application/x-www-form-urlencoded ফর্ম ডেটা পার্স করতে সহায়তা করে।
koa-bodyparser ইনস্টল করা:
npm install koa-bodyparser
koa-bodyparser ব্যবহার করা:
const Koa = require('koa');
const Router = require('koa-router');
const bodyParser = require('koa-bodyparser');
const app = new Koa();
const router = new Router();
// koa-bodyparser মিডলওয়্যার ব্যবহার
app.use(bodyParser());
// ফর্ম ডেটা পোস্ট করা
router.post('/submit', (ctx) => {
const formData = ctx.request.body; // ফর্ম ডেটা অ্যাক্সেস করা
ctx.body = {
message: 'Form data received successfully!',
data: formData
};
});
app
.use(router.routes())
.use(router.allowedMethods());
app.listen(3000, () => {
console.log('Server running on http://localhost:3000');
});
এখানে, আমরা koa-bodyparser মিডলওয়্যার ব্যবহার করে ফর্ম ডেটা পার্স করছি এবং ctx.request.body এর মাধ্যমে ফর্ম ডেটা অ্যাক্সেস করছি।
২. ফাইল আপলোড (File Upload) এবং ম্যানেজমেন্ট
KoaJS-এ ফাইল আপলোড এবং ম্যানেজমেন্টের জন্য জনপ্রিয় মিডলওয়্যার koa-multer ব্যবহৃত হয়। এটি একটি multipart/form-data ফর্ম ডেটা হ্যান্ডল করার জন্য ডিজাইন করা হয়েছে, যা সাধারণত ফাইল আপলোডের ক্ষেত্রে ব্যবহৃত হয়।
২.১ koa-multer ইনস্টল করা
npm install koa-multer
২.২ koa-multer ব্যবহার করে ফাইল আপলোড করা
const Koa = require('koa');
const Router = require('koa-router');
const multer = require('koa-multer');
const path = require('path');
const app = new Koa();
const router = new Router();
// multer সেটআপ
const storage = multer.diskStorage({
destination: function (req, file, cb) {
cb(null, 'uploads/'); // ফাইল কোথায় সংরক্ষণ হবে
},
filename: function (req, file, cb) {
cb(null, Date.now() + path.extname(file.originalname)); // ফাইলের নাম সেট করা
}
});
const upload = multer({ storage: storage });
// ফাইল আপলোড রুট তৈরি করা
router.post('/upload', upload.single('file'), (ctx) => {
ctx.body = {
message: 'File uploaded successfully!',
file: ctx.file // আপলোড করা ফাইলের তথ্য
};
});
app
.use(router.routes())
.use(router.allowedMethods());
app.listen(3000, () => {
console.log('Server running on http://localhost:3000');
});
এখানে, koa-multer মিডলওয়্যার ব্যবহার করা হয়েছে, যা ফাইল আপলোড হ্যান্ডল করে এবং ফাইলটি uploads/ ডিরেক্টরিতে সংরক্ষণ করে। upload.single('file') ফাংশনটি একক ফাইল আপলোডের জন্য ব্যবহৃত হয়, যেখানে 'file' ফাইলের ফিল্ড নাম। ফাইলের নাম Date.now() দ্বারা তৈরি করা হয়, যাতে ফাইলের নামের মধ্যে কোনও কনফ্লিক্ট না হয়।
২.৩ ফাইল ডিরেক্টরি তৈরি এবং ফাইল সেভিং
ফাইল আপলোডের জন্য ডিরেক্টরি তৈরি করতে হবে যেখানে ফাইলগুলি সেভ হবে। যেমন, উপরের কোডে uploads/ নামক একটি ডিরেক্টরি ব্যবহার করা হয়েছে। যদি এই ডিরেক্টরি না থাকে, তবে আপনাকে এটি ম্যানুয়ালি তৈরি করতে হবে।
এছাড়া, আপনি যদি ফাইলের ধরন (মিমে টাইপ) বা ফাইলের আকার কাস্টমাইজ করতে চান, তাহলে multer এর কনফিগারেশন ব্যবহার করতে পারেন।
৩. ফাইল ডাউনলোড
KoaJS-এ আপলোড করা ফাইল ডাউনলোড করার জন্য koa-send মিডলওয়্যার ব্যবহার করা যায়, যা সার্ভারের ফাইল পাঠানোর জন্য ব্যবহৃত হয়।
৩.১ koa-send ইনস্টল করা
npm install koa-send
৩.২ ফাইল ডাউনলোড করার উদাহরণ
const Koa = require('koa');
const Router = require('koa-router');
const send = require('koa-send');
const app = new Koa();
const router = new Router();
// ফাইল ডাউনলোড রুট
router.get('/download/:filename', async (ctx) => {
const filename = ctx.params.filename;
const filePath = path.join(__dirname, 'uploads', filename); // ফাইলের পাথ
await send(ctx, filePath); // ফাইল পাঠানো
});
app
.use(router.routes())
.use(router.allowedMethods());
app.listen(3000, () => {
console.log('Server running on http://localhost:3000');
});
এখানে, koa-send ব্যবহার করা হয়েছে যাতে আমরা সার্ভারের uploads ডিরেক্টরি থেকে ফাইল ডাউনলোড করতে পারি। রুট GET /download/:filename ফাইলের নাম প্যারামিটার হিসেবে নেয় এবং সেই ফাইলটি ডাউনলোড করে পাঠায়।
সারাংশ
KoaJS-এ ফর্ম ডেটা এবং ফাইল ম্যানেজমেন্ট খুবই সহজ এবং কাস্টমাইজযোগ্য। koa-bodyparser মিডলওয়্যার ব্যবহার করে ফর্ম ডেটা, এবং koa-multer ব্যবহার করে ফাইল আপলোড করতে পারি। এছাড়া, koa-send ব্যবহার করে আমরা আপলোড করা ফাইল ডাউনলোডও করতে পারি। এই টুলগুলো ব্যবহারের মাধ্যমে KoaJS-এ ফর্ম ডেটা এবং ফাইল ম্যানেজমেন্ট কার্যক্রম দ্রুত এবং সহজে করা যায়।
Read more
