آموزش ساخت سیستم مدیریت گزارش‌ها با PHP

سیستم‌های مدیریت گزارش (Report Management Systems – RMS) ابزارهای حیاتی برای جمع‌آوری، سازماندهی، تجزیه و تحلیل و ارائه داده‌ها هستند. این سیستم‌ها به سازمان‌ها کمک می‌کنند تا تصمیمات آگاهانه‌تری بگیرند، عملکرد را ردیابی کنند و مشکلات را شناسایی کنند. در این مقاله، به بررسی گام به گام ساخت یک سیستم مدیریت گزارش ساده با استفاده از PHP خواهیم پرداخت. این آموزش برای توسعه‌دهندگان مبتدی تا متوسط ​​PHP مناسب است و بر جنبه‌های عملی و کاربردی تمرکز دارد.

بخش اول: طراحی پایگاه داده

اولین قدم در ساخت هر سیستم، طراحی پایگاه داده است. برای سیستم مدیریت گزارش ما، به جداول زیر نیاز داریم:

• users: اطلاعات کاربران سیستم (id, username, password, role)
• reports: اطلاعات گزارش‌ها (id, user_id, title, content, date_created, status)
• report_categories: دسته‌بندی گزارش‌ها (id, name)
• report_category_relations: ارتباط بین گزارش‌ها و دسته‌بندی‌ها (report_id, category_id)

جداول را می‌توان با استفاده از دستورات SQL زیر ایجاد کرد:

CREATE TABLE users (
  id INT PRIMARY KEY AUTO_INCREMENT,
  username VARCHAR(255) NOT NULL UNIQUE,
  password VARCHAR(255) NOT NULL,
  role VARCHAR(50) DEFAULT 'user'
);

CREATE TABLE reports (
  id INT PRIMARY KEY AUTO_INCREMENT,
  user_id INT NOT NULL,
  title VARCHAR(255) NOT NULL,
  content TEXT,
  date_created TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  status VARCHAR(50) DEFAULT 'draft',
  FOREIGN KEY (user_id) REFERENCES users(id)
);

CREATE TABLE report_categories (
  id INT PRIMARY KEY AUTO_INCREMENT,
  name VARCHAR(255) NOT NULL UNIQUE
);

CREATE TABLE report_category_relations (
  report_id INT NOT NULL,
  category_id INT NOT NULL,
  PRIMARY KEY (report_id, category_id),
  FOREIGN KEY (report_id) REFERENCES reports(id),
  FOREIGN KEY (category_id) REFERENCES report_categories(id)
);

بخش دوم: ایجاد ساختار فایل‌ها و پوشه‌ها

برای سازماندهی بهتر کد، ساختار فایل‌ها و پوشه‌های زیر را پیشنهاد می‌کنیم:

• config: فایل‌های پیکربندی (database.php)
• controllers: کنترلرهای PHP (ReportController.php, UserController.php)
• models: مدل‌های PHP (Report.php, User.php, ReportCategory.php)
• views: فایل‌های HTML برای نمایش (reports/list.php, reports/create.php, users/login.php)
• public: فایل‌های قابل دسترسی از طریق وب (index.php, css, js)

بخش سوم: پیاده‌سازی مدل‌ها (Models)

مدل‌ها مسئول تعامل با پایگاه داده هستند. برای مثال، مدل Report.php می‌تواند شامل توابعی برای دریافت، ایجاد، به‌روزرسانی و حذف گزارش‌ها باشد.

db = $db;
  }

  public function getAllReports() {
    $query = $this->db->query("SELECT * FROM reports");
    return $query->fetchAll(PDO::FETCH_ASSOC);
  }

  public function getReportById($id) {
    $query = $this->db->prepare("SELECT * FROM reports WHERE id = ?");
    $query->execute([$id]);
    return $query->fetch(PDO::FETCH_ASSOC);
  }

  public function createReport($user_id, $title, $content, $status) {
    $query = $this->db->prepare("INSERT INTO reports (user_id, title, content, status) VALUES (?, ?, ?, ?)");
    $query->execute([$user_id, $title, $content, $status]);
    return $this->db->lastInsertId();
  }

  // توابع دیگر برای به‌روزرسانی و حذف گزارش‌ها
}
?>

بخش چهارم: پیاده‌سازی کنترلرها (Controllers)

کنترلرها درخواست‌های کاربر را دریافت می‌کنند، مدل‌ها را فراخوانی می‌کنند و داده‌ها را به نماها (Views) ارسال می‌کنند. برای مثال، کنترلر ReportController.php می‌تواند شامل توابعی برای نمایش لیست گزارش‌ها، ایجاد گزارش جدید و ویرایش گزارش موجود باشد.

reportModel = new Report($db);
  }

  public function listReports() {
    $reports = $this->reportModel->getAllReports();
    include 'views/reports/list.php';
  }

  public function createReport() {
    if ($_SERVER['REQUEST_METHOD'] == 'POST') {
      $user_id = $_SESSION['user_id'];
      $title = $_POST['title'];
      $content = $_POST['content'];
      $status = $_POST['status'];

      $report_id = $this->reportModel->createReport($user_id, $title, $content, $status);
      header('Location: index.php?action=list');
      exit();
    } else {
      include 'views/reports/create.php';
    }
  }

  // توابع دیگر برای ویرایش و حذف گزارش‌ها
}
?>

بخش پنجم: پیاده‌سازی نماها (Views)

نماها فایل‌های HTML هستند که داده‌ها را به کاربر نمایش می‌دهند. برای مثال، نمای reports/list.php می‌تواند شامل یک جدول برای نمایش لیست گزارش‌ها باشد.

<!DOCTYPE html>
<html>
<head>
  <title>لیست گزارش‌ها</title>
</head>
<body>
  <table>
    <thead>
      <tr>
        <th>عنوان</th>
        <th>تاریخ ایجاد</th>
        <th>وضعیت</th>
      </tr>
    </thead>
    <tbody>
      <?php foreach ($reports as $report) { ?>
        <tr>
          <td><?php echo $report['title']; ?></td>
          <td><?php echo $report['date_created']; ?></td>
          <td><?php echo $report['status']; ?></td>
        </tr>
      <?php } ?>
    </tbody>
  </table>
</body>
</html>

بخش ششم: مدیریت کاربران و احراز هویت

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

بخش هفتم: اتصال به پایگاه داده

فایل config/database.php باید شامل اطلاعات اتصال به پایگاه داده باشد:

<?php
$host = 'localhost';
$dbname = 'report_db';
$username = 'root';
$password = '';

try {
  $db = new PDO("mysql:host=$host;dbname=$dbname", $username, $password);
  $db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch(PDOException $e) {
  echo "Connection failed: " . $e->getMessage();
}
?>

بخش هشتم: مسیریابی (Routing)

فایل public/index.php باید درخواست‌های کاربر را دریافت کند و کنترلرهای مناسب را فراخوانی کند. یک روش ساده برای مسیریابی، استفاده از پارامتر action در URL است.

<?php
require_once 'config/database.php';
require_once 'controllers/ReportController.php';
require_once 'controllers/UserController.php';

session_start();

$action = isset($_GET['action']) ? $_GET['action'] : 'list';

$reportController = new ReportController($db);
$userController = new UserController($db);

switch ($action) {
  case 'list':
    $reportController->listReports();
    break;
  case 'create':
    $reportController->createReport();
    break;
  // موارد دیگر
  default:
    echo "صفحه مورد نظر یافت نشد.";
}
?>

نتیجه‌گیری

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