ساخت API برای لایک‌ها با PHP: یک راهنمای جامع

در دنیای وب مدرن، تعامل کاربران با محتوا بخش اساسی تجربه کاربری است. یکی از ساده‌ترین و رایج‌ترین راه‌های تعامل، سیستم لایک است. این مقاله به بررسی نحوه ساخت یک API (Application Programming Interface) برای مدیریت لایک‌ها با استفاده از PHP می‌پردازد. هدف، ارائه یک راهنمای عملی و قابل فهم برای توسعه‌دهندگانی است که قصد پیاده‌سازی این قابلیت را در پروژه‌های خود دارند.

مقدمه

API به عنوان یک واسط بین اجزای مختلف یک سیستم نرم‌افزاری عمل می‌کند. در این مورد، API ما به برنامه‌های کلاینت (مانند وب‌سایت‌ها، اپلیکیشن‌های موبایل و غیره) اجازه می‌دهد تا لایک‌ها را ثبت، حذف و شمارش کنند. استفاده از API به جای دسترسی مستقیم به پایگاه داده، امنیت و انعطاف‌پذیری بیشتری را فراهم می‌کند.

پیش‌نیازها

برای دنبال کردن این آموزش، به موارد زیر نیاز دارید:

• یک سرور وب با PHP نصب شده (مانند Apache یا Nginx)
• یک پایگاه داده (مانند MySQL یا PostgreSQL)
• دانش پایه PHP و SQL
• یک ابزار برای تست API (مانند Postman یا cURL)

طراحی پایگاه داده

برای ذخیره اطلاعات لایک‌ها، به یک جدول در پایگاه داده نیاز داریم. یک جدول ساده به شکل زیر می‌تواند مناسب باشد:

CREATE TABLE likes (
    id INT AUTO_INCREMENT PRIMARY KEY,
    user_id INT NOT NULL,
    content_id INT NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    UNIQUE KEY unique_like (user_id, content_id)
);

در این جدول:

• id: شناسه یکتای لایک
• user_id: شناسه کاربری که لایک کرده است
• content_id: شناسه محتوایی که لایک شده است
• created_at: زمان ایجاد لایک
• UNIQUE KEY unique_like (user_id, content_id): این کلید یکتا تضمین می‌کند که هر کاربر فقط یک بار می‌تواند یک محتوا را لایک کند.

ساخت API با PHP

اکنون می‌توانیم شروع به ساخت API خود کنیم. ما از یک رویکرد RESTful استفاده خواهیم کرد، که در آن هر عملیات با یک endpoint و متد HTTP خاص مرتبط است.

1. اتصال به پایگاه داده

ابتدا باید یک اتصال به پایگاه داده برقرار کنیم. این کار را می‌توان با استفاده از PDO (PHP Data Objects) انجام داد:

setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
    die("Connection failed: " . $e->getMessage());
}
?>

به جای مقادیر نمونه، اطلاعات اتصال پایگاه داده خود را وارد کنید.

2. Endpoint برای ایجاد لایک (POST /likes)

این endpoint به کلاینت اجازه می‌دهد تا یک لایک جدید ایجاد کند. پارامترهای مورد نیاز user_id و content_id هستند.

prepare("INSERT INTO likes (user_id, content_id) VALUES (?, ?)");
        $stmt->execute([$user_id, $content_id]);

        echo json_encode(['status' => 'success', 'message' => 'Like created successfully']);
    } catch (PDOException $e) {
        if ($e->getCode() == 1062) { // Duplicate entry
            echo json_encode(['status' => 'error', 'message' => 'You have already liked this content']);
        } else {
            echo json_encode(['status' => 'error', 'message' => 'Failed to create like: ' . $e->getMessage()]);
        }
    }
} else {
    echo json_encode(['status' => 'error', 'message' => 'Invalid request method']);
}
?>

3. Endpoint برای حذف لایک (DELETE /likes/{id})

این endpoint به کلاینت اجازه می‌دهد تا یک لایک را حذف کند. شناسه لایک (id) به عنوان پارامتر در URL ارسال می‌شود.

prepare("DELETE FROM likes WHERE id = ?");
        $stmt->execute([$id]);

        echo json_encode(['status' => 'success', 'message' => 'Like deleted successfully']);
    } catch (PDOException $e) {
        echo json_encode(['status' => 'error', 'message' => 'Failed to delete like: ' . $e->getMessage()]);
    }
} else {
    echo json_encode(['status' => 'error', 'message' => 'Invalid request method']);
}
?>

4. Endpoint برای شمارش لایک‌ها (GET /likes/count/{content_id})

این endpoint به کلاینت اجازه می‌دهد تا تعداد لایک‌های یک محتوا را دریافت کند. شناسه محتوا (content_id) به عنوان پارامتر در URL ارسال می‌شود.

prepare("SELECT COUNT(*) FROM likes WHERE content_id = ?");
        $stmt->execute([$content_id]);
        $count = $stmt->fetchColumn();

        echo json_encode(['status' => 'success', 'count' => $count]);
    } catch (PDOException $e) {
        echo json_encode(['status' => 'error', 'message' => 'Failed to count likes: ' . $e->getMessage()]);
    }
} else {
    echo json_encode(['status' => 'error', 'message' => 'Invalid request method']);
}
?>

5. Endpoint برای بررسی لایک یک کاربر به یک محتوا (GET /likes/check/{user_id}/{content_id})

این endpoint بررسی می‌کند که آیا یک کاربر خاص، یک محتوای خاص را لایک کرده است یا خیر.

prepare("SELECT COUNT(*) FROM likes WHERE user_id = ? AND content_id = ?");
        $stmt->execute([$user_id, $content_id]);
        $count = $stmt->fetchColumn();

        echo json_encode(['status' => 'success', 'liked' => ($count > 0)]);
    } catch (PDOException $e) {
        echo json_encode(['status' => 'error', 'message' => 'Failed to check like: ' . $e->getMessage()]);
    }
} else {
    echo json_encode(['status' => 'error', 'message' => 'Invalid request method']);
}
?>

تست API

برای تست API خود، می‌توانید از ابزارهایی مانند Postman یا cURL استفاده کنید. به عنوان مثال، برای ایجاد یک لایک، یک درخواست POST به endpoint /likes ارسال کنید و پارامترهای user_id و content_id را در بدنه درخواست قرار دهید.

نکات امنیتی

هنگام ساخت API، رعایت نکات امنیتی بسیار مهم است. برخی از نکات کلیدی عبارتند از:

• اعتبارسنجی ورودی: همیشه ورودی‌های کاربر را اعتبارسنجی کنید تا از حملات تزریق SQL و سایر آسیب‌پذیری‌ها جلوگیری کنید.
• احراز هویت: از یک سیستم احراز هویت قوی برای اطمینان از اینکه فقط کاربران مجاز می‌توانند به API دسترسی داشته باشند استفاده کنید.
• محدودیت نرخ: برای جلوگیری از سوء استفاده، تعداد درخواست‌هایی که یک کاربر می‌تواند در یک بازه زمانی مشخص ارسال کند را محدود کنید.
• استفاده از HTTPS: برای رمزگذاری ارتباط بین کلاینت و سرور، از HTTPS استفاده کنید.

بهینه‌سازی

برای بهبود عملکرد API، می‌توانید از تکنیک‌های زیر استفاده کنید:

• Caching: نتایج درخواست‌های مکرر را در حافظه پنهان ذخیره کنید تا از بارگذاری مجدد پایگاه داده جلوگیری کنید.
• Indexing: از ایندکس‌ها در پایگاه داده برای تسریع جستجوها استفاده کنید.
• Pagination: برای لیست‌های بزرگ، از pagination برای تقسیم نتایج به صفحات کوچکتر استفاده کنید.

نتیجه‌گیری

در این مقاله، نحوه ساخت یک API برای مدیریت لایک‌ها با استفاده از PHP را بررسی کردیم. با استفاده از این راهنما، می‌توانید یک سیستم لایک کارآمد و امن را در پروژه‌های خود پیاده‌سازی کنید. به یاد داشته باشید که رعایت نکات امنیتی و بهینه‌سازی عملکرد، برای ارائه یک تجربه کاربری عالی ضروری است.