PHP: การออกแบบคลาสให้เป็น Single Responsibility

<?php
// =========================================================
// ❌ BAD PRACTICE: คลาสที่ละเมิด SRP (OrderManager)
// มีหน้าที่หลายอย่างเกินไป ทั้ง Business Logic, DB Access, และ Notification
// =========================================================

class OrderManagerBad {
    private $dbConnection; // สมมติว่ามีการเชื่อมต่อฐานข้อมูลอยู่แล้ว

    public function __construct($connection) {
        $this->dbConnection = $connection;
    }

    /**
     * จัดการคำสั่งซื้อทั้งหมด (รวมถึงการบันทึกและการแจ้งเตือน)
     */
    public function processOrder(array $orderData, float $taxRate): bool {
        // 1. Business Logic: คำนวณราคารวม
        $totalPrice = array_sum($orderData['items']) * (1 + $taxRate);

        if ($totalPrice <= 0) {
            return false; // ล้มเหลวในการคำนวณ
        }

        // 2. Data Persistence: บันทึกข้อมูลลงฐานข้อมูล
        $sql = "INSERT INTO orders (user_id, total_price, status) VALUES (?, ?, 'COMPLETED')";
        $stmt = $this->dbConnection->prepare($sql);
        $successDb = $stmt->execute([$orderData['user_id'], $totalPrice]);

        if (!$successDb) {
            return false; // ล้มเหลวในการบันทึกข้อมูล
        }

        // 3. Notification: ส่งอีเมลยืนยันคำสั่งซื้อ
        $subject = "Order Confirmation";
        $body = "Dear User, Your order of $" . number_format($totalPrice, 2) . " has been confirmed.";
        $emailSent = $this->sendEmailNotification("[email protected]", $subject, $body);

        if (!$emailSent) {
            // ถ้าส่งอีเมลล้มเหลว อาจจะต้องมีการ Rollback ข้อมูลใน DB ด้วย!
            echo "Warning: Order saved but email failed to send.";
        }

        return true;
    }

    /**
     * ฟังก์ชันจำลองการเชื่อมต่อฐานข้อมูล (เพื่อความสมบูรณ์ของตัวอย่าง)
     */
    private function sendEmailNotification(string $to, string $subject, string $body): bool {
        // โค้ดจริงจะใช้ PHPMailer หรือบริการอื่น ๆ
        echo "--- [LOG] Attempting to send email to {$to} ---\n";
        return true; // สมมติว่าสำเร็จเสมอ
    }
}

/* --------------------------------------------------------- */
/* 🚀 GOOD PRACTICE: การ Refactor ตามหลัก SRP (Dependency Injection) */
/* --------------------------------------------------------- */

// 1. Interface/Contract สำหรับการกำหนดหน้าที่ (Decoupling)
interface PaymentGateway {
    public function processPayment(float $amount, string $token): bool;
}

// 2. Class ที่รับผิดชอบเฉพาะเรื่องการคำนวณธุรกิจ
class OrderCalculator {
    /**
     * คำนวณราคารวมของสินค้าทั้งหมด
     */
    public function calculateTotal(array $items, float $taxRate): float {
        $subtotal = array_sum($items);
        return $subtotal * (1 + $taxRate);
    }
}

// 3. Class ที่รับผิดชอบเฉพาะเรื่องการบันทึกข้อมูล (Persistence)
class OrderRepository {
    private $dbConnection;

    public function __construct($connection) {
        $this->dbConnection = $connection;
    }

    /**
     * บันทึกคำสั่งซื้อลงฐานข้อมูลเท่านั้น
     */
    public function save(int $userId, float $totalPrice): bool {
        // ใช้ Prepared Statements เสมอเพื่อป้องกัน SQL Injection
        $sql = "INSERT INTO orders (user_id, total_price, status) VALUES (?, ?, 'COMPLETED')";
        $stmt = $this->dbConnection->prepare($sql);
        return $stmt->execute([$userId, $totalPrice]);
    }
}

// 4. Class ที่รับผิดชอบเฉพาะเรื่องการแจ้งเตือน (Notification/External Service)
class EmailService {
    /**
     * ส่งอีเมลยืนยันคำสั่งซื้อเท่านั้น
     */
    public function sendConfirmation(string $email, float $total): bool {
        echo "--- [LOG] Successfully sent confirmation email to {$email} for $" . number_format($total, 2) . " ---\n";
        // ในความเป็นจริงควรมีการจัดการ Exception ที่นี่
        return true;
    }
}

// 5. Orchestrator: คลาสที่รวบรวมการทำงาน (ใช้ Dependency Injection)
class OrderService {
    private $calculator;
    private $repository;
    private $emailService;

    public function __construct(OrderCalculator $calc, OrderRepository $repo, EmailService $emailSvc) {
        // รับ Dependencies ผ่าน Constructor ทำให้ทดสอบง่ายมาก (Testability)
        $this->calculator = $calc;
        $this->repository = $repo;
        $this->emailService = $emailSvc;
    }

    /**
     * กระบวนการหลัก: ใช้คลาสย่อยที่รับผิดชอบเฉพาะด้านเท่านั้น
     */
    public function processOrder(int $userId, array $items, float $taxRate, string $userEmail): bool {
        // 1. Calculate (Responsibility: Calculation)
        $totalPrice = $this->calculator->calculateTotal($items, $taxRate);

        if ($totalPrice <= 0) {
            return false;
        }

        try {
            // 2. Save (Responsibility: Persistence/Database)
            if (!$this->repository->save($userId, $totalPrice)) {
                throw new Exception("Failed to save order to database.");
            }

            // 3. Notify (Responsibility: External Communication)
            $this->emailService->sendConfirmation($userEmail, $totalPrice);

            return true;

        } catch (Exception $e) {
            // การจัดการข้อผิดพลาดรวมศูนย์ที่นี่เท่านั้น
            error_log("Order processing failed: " . $e->getMessage());
            return false;
        }
    }
}

// =========================================================
// 🧪 การใช้งานจริง (Simulation)
// =========================================================

// จำลองการเชื่อมต่อ DB และ Dependency Injection
$dbConnectionMock = new class {
    public function prepare($sql) { return new stdClass(); } // Mock statement
};

// สร้าง Instance ของคลาสที่แยกหน้าที่แล้ว
$calculator = new OrderCalculator();
$repository = new OrderRepository($dbConnectionMock);
$emailService = new EmailService();

// ส่งมอบ Dependencies ให้กับ Service หลัก (OrderService)
$orderService = new OrderService($calculator, $repository, $emailService);

// ข้อมูลจำลอง
$user_id = 101;
$items = [100.0, 50.0]; // สินค้าสองชิ้น
$tax_rate = 0.07; // VAT 7%
$user_email = "[email protected]";

echo "========================================\n";
echo "🚀 Running Order Processing (SRP Compliant)\n";
echo "========================================\n";

if ($orderService->processOrder($user_id, $items, $tax_rate, $user_email)) {
    echo "\n✅ SUCCESS: Order processed successfully and all services notified.\n";
} else {
    echo "\n❌ FAILURE: Failed to process order due to system error.\n";
}

?>