FuelPHP দিয়ে RESTful API তৈরি করা

FuelPHP একটি শক্তিশালী PHP ফ্রেমওয়ার্ক যা RESTful API তৈরি করতে সক্ষম। RESTful API (Representational State Transfer) হল একটি ওয়েব সার্ভিস আর্কিটেকচার যা HTTP প্রটোকল ব্যবহার করে ডেটা অ্যাক্সেস এবং ম্যানিপুলেট করতে সাহায্য করে। FuelPHP এর মাধ্যমে আপনি খুব সহজে RESTful API তৈরি করতে পারেন এবং API এর জন্য CRUD (Create, Read, Update, Delete) অপারেশনগুলি পরিচালনা করতে পারবেন।

এখানে FuelPHP দিয়ে RESTful API তৈরি করার প্রক্রিয়া আলোচনা করা হয়েছে।

FuelPHP দিয়ে RESTful API তৈরি করা

1. Controller তৈরি করা

FuelPHP তে RESTful API তৈরি করতে প্রথমে একটি কন্ট্রোলার তৈরি করতে হবে, যেখানে API রুট এবং এর অ্যাকশন নির্ধারণ করা হবে। FuelPHP তে RESTful API তৈরির জন্য কন্ট্রোলার ক্লাসে before() এবং after() মেথডের মাধ্যমে হ্যান্ডলার নির্ধারণ করা হয়।

Controller তৈরি:

<?php

use Fuel\Core\Controller_Rest;
use Fuel\Core\Response;

class Controller_Api_Post extends Controller_Rest
{
    // API কনফিগারেশন এবং প্রয়োজনীয় প্রি-প্রসেসিং
    public function before()
    {
        parent::before();
        // আপনার API কনফিগারেশন এবং অন্যান্য কোড এখানে।
    }

    // GET রিকোয়েস্টের জন্য ডেটা রিটার্ন করা
    public function get_index()
    {
        // Dummy ডেটা রিটার্ন করা
        $posts = array(
            array('id' => 1, 'title' => 'Post 1', 'content' => 'Content of post 1'),
            array('id' => 2, 'title' => 'Post 2', 'content' => 'Content of post 2')
        );

        // JSON রেসপন্স প্রদান করা
        return $this->response($posts);
    }

    // POST রিকোয়েস্টের জন্য ডেটা তৈরি করা
    public function post_create()
    {
        $data = json_decode($this->body, true);  // Body থেকে ডেটা গ্রহণ
        if (isset($data['title']) && isset($data['content'])) {
            $new_post = array(
                'id' => rand(3, 100),
                'title' => $data['title'],
                'content' => $data['content']
            );
            return $this->response($new_post, 201);  // 201 Created
        } else {
            return $this->response(array('error' => 'Invalid data'), 400);  // 400 Bad Request
        }
    }

    // PUT রিকোয়েস্টের জন্য ডেটা আপডেট করা
    public function put_update($id = null)
    {
        $data = json_decode($this->body, true);  // Body থেকে ডেটা গ্রহণ
        if ($id && isset($data['title']) && isset($data['content'])) {
            $updated_post = array(
                'id' => $id,
                'title' => $data['title'],
                'content' => $data['content']
            );
            return $this->response($updated_post);  // Success response
        } else {
            return $this->response(array('error' => 'Invalid data or ID'), 400);  // 400 Bad Request
        }
    }

    // DELETE রিকোয়েস্টের জন্য ডেটা ডিলিট করা
    public function delete_delete($id = null)
    {
        if ($id) {
            return $this->response(array('message' => 'Post ' . $id . ' deleted'), 200);  // Success response
        } else {
            return $this->response(array('error' => 'Invalid ID'), 400);  // 400 Bad Request
        }
    }
}

এখানে:

• Controller_Rest: FuelPHP তে Controller_Rest ক্লাস ব্যবহার করা হয়, যা RESTful API এর জন্য উপযুক্ত। এটি JSON, XML, বা অন্য কোনো ফরম্যাটে রেসপন্স প্রদান করতে সক্ষম।
• get_index(): GET রিকোয়েস্টের জন্য ডেটা রিটার্ন করা হচ্ছে।
• post_create(): POST রিকোয়েস্টের মাধ্যমে নতুন ডেটা তৈরি করা হচ্ছে।
• put_update(): PUT রিকোয়েস্টের মাধ্যমে ডেটা আপডেট করা হচ্ছে।
• delete_delete(): DELETE রিকোয়েস্টের মাধ্যমে ডেটা মুছে ফেলা হচ্ছে।

2. Routes Configuration

FuelPHP তে routes.php ফাইলের মাধ্যমে API এর জন্য রাউট কনফিগার করা হয়। রাউট কনফিগারেশনে প্রতিটি HTTP মেথড (GET, POST, PUT, DELETE) এর জন্য আলাদা অ্যাকশন নির্ধারণ করা হয়।

routes.php ফাইল:

Route::set('api', 'api(/<controller>(/<action>))')
    ->defaults(array(
        'controller' => 'api_post', // Default controller
        'action'     => 'index',    // Default action
    ));

এখানে:

• api(/<controller>(/<action>)): এই রাউটটি /api পাথের সাথে সম্পর্কিত থাকবে। /api/post বা /api/post/create এর মতো URL পাথের মাধ্যমে API এর বিভিন্ন অ্যাকশন হ্যান্ডেল করা যাবে।

3. Testing the API

এখন আপনি API টেস্ট করতে পারেন Postman বা cURL এর মাধ্যমে।

GET Request Example:

URL: http://yourdomain.com/api/post

• রেসপন্স:

[
    {"id": 1, "title": "Post 1", "content": "Content of post 1"},
    {"id": 2, "title": "Post 2", "content": "Content of post 2"}
]

POST Request Example:

URL: http://yourdomain.com/api/post/create

Body:

{
    "title": "New Post",
    "content": "This is a new post content"
}

• রেসপন্স:

{
    "id": 45,
    "title": "New Post",
    "content": "This is a new post content"
}

PUT Request Example:

URL: http://yourdomain.com/api/post/update/2

Body:

{
    "title": "Updated Post",
    "content": "Updated content"
}

• রেসপন্স:

{
    "id": 2,
    "title": "Updated Post",
    "content": "Updated content"
}

DELETE Request Example:

URL: http://yourdomain.com/api/post/delete/2

• রেসপন্স:

{
    "message": "Post 2 deleted"
}

4. CORS Support (Cross-Origin Resource Sharing)

যদি আপনি আপনার API অন্য ডোমেইন থেকে কল করতে চান, তবে CORS সাপোর্ট করতে হবে। FuelPHP তে CORS এর জন্য কাস্টম হেডার যুক্ত করতে পারেন।

CORS হেডার সেট করা:

class Controller_Api_Post extends Controller_Rest
{
    public function before()
    {
        parent::before();

        // Enable CORS
        \Response::header('Access-Control-Allow-Origin', '*');
        \Response::header('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE');
        \Response::header('Access-Control-Allow-Headers', 'Content-Type, X-Requested-With');
    }
}

এটি CORS সেটআপ করবে যাতে আপনার API অন্য ডোমেইন থেকেও অ্যাক্সেস করা যায়।

5. Error Handling in REST API

FuelPHP তে API এর জন্য ত্রুটি হ্যান্ডলিং সহজেই করা যায়। আপনি HTTP স্ট্যাটাস কোড এবং একটি কাস্টম ত্রুটি বার্তা ফিরিয়ে দিতে পারেন।

Error Handling Example:

public function get_index()
{
    $posts = Model_Post::find('all');

    if (empty($posts)) {
        return $this->response(array('error' => 'No posts found'), 404);
    }

    return $this->response($posts);
}

এখানে:

• যদি কোন পোস্ট না থাকে তবে 404 ত্রুটি কোড সহ একটি কাস্টম ত্রুটি বার্তা ফেরত দেয়া হবে।

সারাংশ:

• FuelPHP তে RESTful API তৈরি করা খুবই সহজ এবং শক্তিশালী। আপনি Controller_Rest ব্যবহার করে API কন্ট্রোলার তৈরি করতে পারেন।
• GET, POST, PUT, এবং DELETE মেথড দিয়ে CRUD অপারেশন বাস্তবায়ন করা যায়।
• CORS এবং Error Handling ফিচার সহ API এর নিরাপত্তা এবং কার্যকারিতা নিশ্চিত করা যায়।
• আপনি FuelPHP এর RESTful API গুলিকে Postman বা cURL ব্যবহার করে টেস্ট করতে পারেন।

এভাবে, আপনি FuelPHP ব্যবহার করে একটি শক্তিশালী এবং সহজে পরিচালনাযোগ্য RESTful API তৈরি করতে পারবেন।