Cara Melaksanakan Ujian Unit dalam PHP: Alat dan Amalan Terbaik

Ujian unit ialah bahagian penting dalam kitaran hayat pembangunan perisian yang memastikan komponen atau fungsi individu sesuatu aplikasi berkelakuan seperti yang diharapkan. Dalam PHP, ujian unit membantu mengesahkan ketepatan kod, membolehkan pembangun menangkap pepijat lebih awal dan meningkatkan kebolehpercayaan dan kebolehselenggaraan kod.

Melaksanakan ujian unit dalam PHP melibatkan ujian penulisan untuk kepingan kecil fungsi (unit) terpencil, biasanya menggunakan rangka kerja dan alatan ujian khusus. Di bawah ialah penjelasan mendalam tentang cara melaksanakan ujian unit dalam PHP, alatan dan rangka kerja yang biasa digunakan serta amalan terbaik untuk diikuti.

1. Apakah Ujian Unit dalam PHP?

Ujian unit melibatkan ujian unit kod individu (disebut sebagai fungsi atau kaedah) secara berasingan untuk memastikan ia berfungsi seperti yang diharapkan. Matlamat utama ujian unit adalah untuk mengesahkan ketepatan setiap unit, membantu menangkap pepijat lebih awal dan membenarkan pembangun memfaktorkan semula atau mengubah suai kod dengan yakin.

Ujian unit menyemak kelakuan fungsi atau kaedah untuk input tertentu dan membandingkan output sebenar dengan output yang dijangkakan. Ujian unit biasanya diautomatikkan dan boleh dijalankan secara berterusan untuk mengekalkan kualiti kod yang tinggi.

2. Faedah Utama Pengujian Unit

• Pengesanan Pepijat Awal: Ujian unit membantu menangkap ralat dan pepijat lebih awal, menjadikannya lebih mudah untuk membetulkannya sebelum ia memberi kesan kepada bahagian aplikasi yang lebih besar.
• Keyakinan Pemfaktoran Semula: Dengan adanya ujian unit, pembangun boleh membuat perubahan atau kod refactor dengan yakin, dengan mengetahui bahawa ujian itu akan menangkap sebarang regresi.
• Kualiti Kod yang Dipertingkat: Ujian unit penulisan memaksa pembangun menulis kod modular, boleh diselenggara dan tersusun dengan baik, mempromosikan amalan reka bentuk yang lebih baik.
• Dokumentasi: Ujian unit bertindak sebagai dokumentasi hidup tentang kelakuan yang diharapkan bagi fungsi dan kaedah.

3. Alat dan Rangka Kerja untuk Pengujian Unit dalam PHP

Beberapa alatan dan rangka kerja dalam PHP boleh membantu anda menulis dan melaksanakan ujian unit. Yang paling popular ialah PHPUnit, Mockery, dan PHPSpec. Di bawah ialah gambaran keseluruhan alatan ini:

a. PHPUnit

PHPUnit ialah rangka kerja ujian yang paling banyak digunakan untuk PHP. Ia ialah alat sumber terbuka yang menyediakan cara mudah untuk menulis dan menjalankan ujian unit. PHPUnit diilhamkan oleh keluarga rangka kerja xUnit (seperti JUnit untuk Java dan NUnit untuk .NET).

• Pemasangan: PHPUnit boleh dipasang melalui Composer, pengurus pergantungan PHP.

composer require --dev phpunit/phpunit

• Contoh Asas:

// Example: A simple Calculator class
class Calculator {
    public function add($a, $b) {
        return $a + $b;
    }
}

// PHPUnit test for Calculator class
use PHPUnit\Framework\TestCase;

class CalculatorTest extends TestCase {
    public function testAdd() {
        $calculator = new Calculator();
        $result = $calculator->add(2, 3);
        $this->assertEquals(5, $result);
    }
}

• Menjalankan PHPUnit:

Untuk menjalankan ujian menggunakan PHPUnit, gunakan arahan berikut:

./vendor/bin/phpunit tests/CalculatorTest.php

Ciri PHPUnit:

• Penegasan: Menyediakan pelbagai kaedah penegasan seperti assertEquals, assertTrue, assertFalse dan assertContains untuk mengesahkan keputusan ujian.
• Suite Ujian: Kumpulkan berbilang ujian bersama-sama dan jalankannya sebagai suite.
• Mengejek: Buat objek olok-olok untuk mensimulasikan kebergantungan semasa ujian.
• Liputan Kod: PHPUnit boleh menjana laporan liputan kod untuk mengukur jumlah kod anda dilindungi oleh ujian.

b. Ejekan

Ejekan ialah rangka kerja mengejek yang digunakan bersama PHPUnit untuk mengejek objek dan mensimulasikan gelagat kebergantungan. Ia membolehkan kawalan yang lebih terperinci apabila menguji komponen dengan kebergantungan luaran, seperti sambungan pangkalan data, API atau perkhidmatan.

• Pemasangan: Ejekan boleh dipasang melalui Komposer.

composer require --dev mockery/mockery

• Contoh:

use Mockery;
use PHPUnit\Framework\TestCase;

class UserServiceTest extends TestCase {
    public function testGetUserName() {
        // Create a mock UserRepository
        $userRepository = Mockery::mock(UserRepository::class);
        $userRepository->shouldReceive('find')->with(1)->andReturn(new User('John Doe'));

        $userService = new UserService($userRepository);
        $userName = $userService->getUserName(1);

        $this->assertEquals('John Doe', $userName);
    }

    public function tearDown(): void {
        Mockery::close();  // Clean up mock objects
    }
}

c. PHPSpec

PHPSpec ialah rangka kerja pembangunan dipacu tingkah laku (BDD) untuk PHP. Walaupun PHPUnit memfokuskan pada menulis ujian untuk unit kod, PHPSpec memfokuskan pada menentukan gelagat kelas dan objek. Ia membolehkan ujian menulis dalam bahasa yang lebih semula jadi dan sering digunakan untuk memacu pembangunan dari luar ke dalam.

• Pemasangan:

composer require --dev phpspec/phpspec

• Contoh Asas:

// Spec for Calculator class
class CalculatorSpec extends \PhpSpec\ObjectBehavior {
    function it_adds_two_numbers() {
        $this->add(2, 3)->shouldReturn(5);
    }
}

4. Amalan Terbaik untuk Ujian Unit dalam PHP

Berikut ialah beberapa amalan terbaik untuk diikuti semasa menulis ujian unit dalam PHP:

a. Uji Satu Perkara Pada Satu Masa

Setiap ujian hendaklah hanya mengesahkan satu gelagat atau fungsi tertentu. Ini menjadikan ujian lebih mudah difahami, diselenggara dan nyahpepijat.

b. Pastikan Ujian Diasingkan

Ujian unit hendaklah bebas antara satu sama lain. Setiap ujian harus dijalankan secara berasingan daripada yang lain untuk memastikan ia boleh dipercayai dan boleh dihasilkan semula.

c. Gunakan Ejek untuk Kebergantungan

Jika kod anda bergantung pada perkhidmatan luaran, pangkalan data atau API, gunakan ejekan untuk mensimulasikan tingkah laku mereka. Ini menghalang ujian anda daripada bergantung pada sistem luaran sebenar, memastikan ia berjalan lebih pantas dan lebih dipercayai.

d. Tulis Ujian Sebelum Kod (Pembangunan Dipacu Ujian)

Mengikuti TDD (Pembangunan Dipacu Ujian) membantu memastikan kod anda ditulis dengan mengambil kira kebolehujian. Tulis ujian anda dahulu, kemudian tulis kod yang membolehkannya lulus.

e. Gunakan Nama Ujian Deskriptif

Gunakan nama ujian deskriptif yang menerangkan tingkah laku yang diuji. Ini membantu orang lain (dan diri masa depan anda) memahami tujuan setiap ujian.

composer require --dev phpunit/phpunit

f. Jalankan Ujian Secara Berkala

Sepadukan ujian anda ke dalam saluran paip penyepaduan berterusan (CI) anda supaya ia dijalankan secara automatik pada setiap komit. Ini memastikan perubahan baharu tidak merosakkan kefungsian sedia ada.

5. Contoh Ujian Unit Penuh dengan PHPUnit

Mari kita lihat contoh lengkap unit menguji kelas dengan PHPUnit.

Kelas untuk Ujian (Kalkulator.php):

// Example: A simple Calculator class
class Calculator {
    public function add($a, $b) {
        return $a + $b;
    }
}

// PHPUnit test for Calculator class
use PHPUnit\Framework\TestCase;

class CalculatorTest extends TestCase {
    public function testAdd() {
        $calculator = new Calculator();
        $result = $calculator->add(2, 3);
        $this->assertEquals(5, $result);
    }
}

Kelas Ujian Unit (CalculatorTest.php):

./vendor/bin/phpunit tests/CalculatorTest.php

Menjalankan ujian:

composer require --dev mockery/mockery

6. Kesimpulan

Ujian unit ialah bahagian penting dalam memastikan kualiti perisian, terutamanya dalam aplikasi PHP. Dengan menggunakan rangka kerja ujian seperti PHPUnit, Mockery dan PHPSpec, anda boleh menulis ujian automatik yang membantu mengesahkan ketepatan kod anda. Ujian unit memberikan beberapa faedah, seperti pengesanan pepijat awal, keyakinan kod semasa pemfaktoran semula dan kualiti perisian keseluruhan yang lebih baik.

Dengan mengikuti amalan terbaik seperti menulis ujian terpencil, deskriptif dan menggunakan ejekan untuk mensimulasikan kebergantungan, anda boleh menulis ujian unit yang berkesan dan boleh diselenggara yang menyumbang kepada kejayaan projek jangka panjang.

Atas ialah kandungan terperinci Menguasai Ujian Unit dalam PHP: Alat, Rangka Kerja dan Amalan Terbaik. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!