Làm thế nào để viết Unit Test trong PHPUnit cho mã nguồn cũ (Legacy Code) bị phụ thuộc chặt vào các Static Method hoặc Singleton mà không làm thay đổi trực tiếp logic của mã nguồn Production?

Question

Accepted Answer

Phụ thuộc vào Static Methods hoặc Singleton (Tight Coupling) là một rào cản lớn khi viết Unit Test vì chúng ta không thể dễ dàng thay thế chúng bằng Dependency Injection (DI) hoặc mock chuẩn của PHPUnit.
Dưới đây là các kỹ thuật xử lý thực chiến cho vấn đề này:
1. Phương pháp 1: Refactor theo mẫu Wrapper / Adapter (Khuyên dùng)
Thay vì gọi trực tiếp class Static trong mã nguồn, tạo một Adapter wrap class đó và truyền qua Constructor.
Mã nguồn cũ (Khó test):
class OrderProcessor
{
    public function process(array $orderData): void
    {
        // Gọi static method trực tiếp gây tight coupling
        PaymentGateway::charge($orderData['amount']);
    }
}
Refactor an toàn (Dễ test):
interface PaymentGatewayInterface
{
    public function charge(float $amount): bool;
}

class PaymentGatewayAdapter implements PaymentGatewayInterface
{
    public function charge(float $amount): bool
    {
        return PaymentGateway::charge($amount);
    }
}

class OrderProcessor
{
    private PaymentGatewayInterface $gateway;

public function __construct(?PaymentGatewayInterface $gateway = null)
    {
        // Tận dụng Backward Compatibility
        $this->gateway = $gateway ?? new PaymentGatewayAdapter();
    }

public function process(array $orderData): bool
    {
        return $this->gateway->charge($orderData['amount']);
    }
}
Cách này vừa không làm gãy mã nguồn cũ đang chạy trên Production, vừa giúp viết Unit Test cực kỳ dễ dàng bằng cách mock PaymentGatewayInterface.

2. Phương pháp 2: Sử dụng Kỹ thuật Partial Mock / Subclass and Override
Nếu tuyệt đối không được sửa Signature của Constructor hay tạo Class mới, ta có thể dùng kỹ thuật tách phương thức gọi static thành một protected method và xài Partial Mock của PHPUnit.
Mã nguồn Production (Sửa tối thiểu):
class OrderProcessor
{
    public function process(array $orderData): bool
    {
        // Gọi thông qua protected method nội bộ
        return $this->executePayment($orderData['amount']);
    }

protected function executePayment(float $amount): bool
    {
        return PaymentGateway::charge($amount);
    }
}
Mã nguồn Unit Test với PHPUnit:
use PHPUnit\Framework\TestCase;

class OrderProcessorTest extends TestCase
{
    public function testProcessSuccess(): void
    {
        // Tạo Partial Mock chỉ mock duy nhất phương thức executePayment
        $processor = $this->getMockBuilder(OrderProcessor::class)
            ->onlyMethods(['executePayment'])
            ->getMock();

// Giả lập kết quả cho phương thức protected
        $processor->expects($this->once())
            ->method('executePayment')
            ->with(100.0)
            ->willReturn(true);

$result = $processor->process(['amount' => 100.0]);
        $this->assertTrue($result);
    }
}

3. Phương pháp 3: Sử dụng thư viện Mockery với Overload / Alias
Nếu làm việc với framework PHP có hỗ trợ Mockery (như Laravel), ta có thể dùng alias: để mock Static Class mà không thay đổi bất kỳ dòng code production nào.
public function testProcessWithMockery(): void
{
    // Alias mock static class PaymentGateway
    $paymentMock = Mockery::mock('alias:App\Legacy\PaymentGateway');
    $paymentMock->shouldReceive('charge')
        ->once()
        ->with(100.0)
        ->andReturn(true);

$processor = new OrderProcessor();
    $result = $processor->process(['amount' => 100.0]);

$this->assertTrue($result);
}
Lưu ý khi dùng Alias Mocking: Quá trình này thay đổi định nghĩa class trong ClassLoader của PHP, do đó test case này phải chạy trong một Isolation Process (dùng annotation @runInSeparateProcess của PHPUnit).

Làm thế nào để viết Unit Test trong PHPUnit cho mã nguồn cũ (Legacy Code) bị phụ thuộc chặt vào các Static Method hoặc Singleton mà không làm thay đổi trực tiếp logic của mã nguồn Production?

Mở Khóa Full Câu Trả Lời & Code Chuẩn Senior

Làm Chủ Phỏng Vấn & Nâng Cao Trình Độ Chuyên Nghiệp

Tải Tuyển Tập 100+ Câu Hỏi Phỏng Vấn Chuyên Sâu (PDF)

Cần Mentor Phỏng Vấn Thử 1-1 & Tối Ưu CV?

Kiểm Tra CV Chuẩn ATS Miễn Phí

Câu hỏi PHPUnit liên quan cùng chủ đề

Làm thế nào để viết Unit Test trong PHPUnit cho mã nguồn cũ (Legacy Code) bị phụ thuộc chặt vào các Static Method hoặc Singleton mà không làm thay đổi trực tiếp logic của mã nguồn Production?

Đăng nhập để xem câu trả lời

Mở Khóa Full Câu Trả Lời & Code Chuẩn Senior

Làm Chủ Phỏng Vấn & Nâng Cao Trình Độ Chuyên Nghiệp

Tải Tuyển Tập 100+ Câu Hỏi Phỏng Vấn Chuyên Sâu (PDF)

Cần Mentor Phỏng Vấn Thử 1-1 & Tối Ưu CV?

Kiểm Tra CV Chuẩn ATS Miễn Phí

Câu hỏi PHPUnit liên quan cùng chủ đề