Ujian Unit dalam Laravel: Pendekatan Praktikal untuk Pembangun

Pengujian ialah bahagian penting dalam pembangunan perisian, tetapi ia selalunya terasa seperti tugas. Mujurlah, Laravel membuat ujian mudah dengan alatan terbina dalamnya, membantu pembangun memastikan aplikasi mereka berfungsi seperti yang diharapkan tanpa menghabiskan waktu menyahpepijat tanpa henti. Sama ada anda sedang membina projek kecil atau aplikasi berskala besar, ujian unit boleh menyelamatkan anda daripada kemungkinan sakit kepala dengan mengetahui isu lebih awal.

Dalam blog ini, kami akan meneroka ujian unit dalam Laravel—apa itu, sebab ia penting dan cara untuk memulakan ujian menulis. Pada akhirnya, anda akan memahami cara membuat dan melaksanakan ujian dalam Laravel dengan contoh dunia sebenar.

---

Jadual Kandungan

1. Apakah Ujian Unit?
2. Mengapa Ujian Unit Penting
3. Menyediakan Ujian Unit dalam Laravel
4. Menulis Ujian Unit Pertama Anda
5. Model Ujian, Pengawal dan Perkhidmatan
6. Menjalankan dan Mentafsir Ujian
7. Amalan Terbaik untuk Ujian Unit Laravel
8. Pemikiran Akhir

---

Apakah Ujian Unit?

Ujian unit ialah jenis ujian di mana anda menulis kod untuk menguji unit individu aplikasi anda, seperti fungsi, kaedah atau kelas. Ujian ini adalah kecil, pantas dan fokus pada memastikan sekeping kod tertentu berfungsi seperti yang diharapkan.

Dalam Laravel, ujian unit biasanya ditulis menggunakan PHPUnit, yang didatangkan prapasang dengan Laravel.

---

Mengapa Ujian Unit Penting

Ujian unit mungkin terasa seperti kerja tambahan pada mulanya, tetapi faedahnya jauh melebihi usaha awal. Inilah sebabnya masa anda berbaloi:

• Tangkap Pepijat Awal: Ujian membantu mengenal pasti pepijat sebelum aplikasi anda disiarkan secara langsung, menjimatkan anda daripada pembaikan yang mahal kemudiannya.
• Refactor with Confidence: Mengetahui ujian anda akan menghadapi sebarang isu menjadikan pemfaktoran semula lebih selamat dan cekap.
• Tingkatkan Kualiti Kod: Ujian penulisan memaksa anda memikirkan logik dan kes kelebihan kod anda, yang membawa kepada kod yang lebih bersih dan lebih mantap.
• Pastikan Ketekalan: Ujian memastikan kemas kini atau ciri baharu tidak merosakkan kefungsian sedia ada.

---

Menyediakan Ujian Unit dalam Laravel

Laravel diprakonfigurasikan untuk ujian unit, jadi anda tidak perlu memasang sebarang alatan tambahan. Begini caranya untuk bermula:

Langkah 1: Semak Pemasangan PHPUnit

Laravel termasuk PHPUnit di luar kotak. Anda boleh menyemak versi dengan menjalankan:

vendor/bin/phpunit --version

Langkah 2: Buat Kelas Ujian

Laravel menyediakan arahan Artisan yang berguna untuk menjana kelas ujian baharu:

php artisan make:test ExampleTest --unit

Ini mencipta fail ujian dalam direktori ujian/Unit:

vendor/bin/phpunit --version

Langkah 3: Konfigurasi Persekitaran Pengujian

Laravel menggunakan fail .env.testing untuk ujian. Salin fail .env anda dan namakan semula kepada .env.testing. Kemas kini konfigurasi pangkalan data untuk menggunakan pangkalan data ujian yang berasingan, memastikan ujian anda tidak menjejaskan pangkalan data pembangunan anda.

php artisan make:test ExampleTest --unit

---

Menulis Ujian Unit Pertama Anda

Mari kita tulis ujian mudah untuk menyemak sama ada kaedah dalam kelas mengembalikan nilai yang dijangkakan.

Contoh: Menguji Fungsi Pembantu Matematik

Buat kelas pembantu dalam app/Helpers/MathHelper.php:

tests/
├── Unit/
│   └── ExampleTest.php

Tulis ujian untuk fungsi ini dalam ujian/Unit/MathHelperTest.php:

DB_CONNECTION=sqlite
DB_DATABASE=:memory:

Jalankan ujian:

namespace App\Helpers;

class MathHelper
{
    public static function add($a, $b)
    {
        return $a + $b;
    }
}

Jika semuanya betul, PHPUnit akan mengeluarkan:

namespace Tests\Unit;

use PHPUnit\Framework\TestCase;
use App\Helpers\MathHelper;

class MathHelperTest extends TestCase
{
    public function testAddition()
    {
        $result = MathHelper::add(2, 3);
        $this->assertEquals(5, $result);
    }
}

---

Menguji Model, Pengawal dan Perkhidmatan

Model Pengujian

Model adalah penting kepada mana-mana aplikasi Laravel. Mari uji kaedah model mudah.

Tambah model Pengguna dengan kaedah tersuai dalam app/Models/User.php:

vendor/bin/phpunit

Tulis ujian dalam ujian/Unit/UserTest.php:

OK (1 test, 1 assertion)

Pengawal Pengujian

Untuk pengawal, anda biasanya akan menggunakan ujian ciri, tetapi anda masih boleh menguji kaedah individu.

Perkhidmatan Ujian

Buat perkhidmatan dalam app/Services/ExampleService.php:

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    use HasFactory;

    public function isAdmin()
    {
        return $this->role === 'admin';
    }
}

Tulis ujian untuknya:

namespace Tests\Unit;

use PHPUnit\Framework\TestCase;
use App\Models\User;

class UserTest extends TestCase
{
    public function testIsAdmin()
    {
        $user = new User();
        $user->role = 'admin';

        $this->assertTrue($user->isAdmin());
    }
}

---

Ujian Berlari dan Mentafsir

Untuk menjalankan semua ujian dalam projek anda:

namespace App\Services;

class ExampleService
{
    public function greet($name)
    {
        return "Hello, $name!";
    }
}

Untuk menjalankan fail ujian tertentu:

namespace Tests\Unit;

use PHPUnit\Framework\TestCase;
use App\Services\ExampleService;

class ExampleServiceTest extends TestCase
{
    public function testGreeting()
    {
        $service = new ExampleService();
        $this->assertEquals('Hello, John!', $service->greet('John'));
    }
}

Output akan menunjukkan:

• Ujian yang telah berlalu.
• Ujian yang gagal (dengan butiran tentang perkara yang salah).

---

Amalan Terbaik untuk Ujian Unit Laravel

1. Uji Unit Kecil: Fokus pada unit kod yang kecil dan terpencil, seperti kaedah atau fungsi tunggal.
2. Gunakan Penegasan Dengan Bijak: Laravel menyediakan banyak kaedah penegasan, seperti assertEquals, assertTrue dan assertCount. Gunakannya untuk mengesahkan hasil yang dijangkakan.
3. Ketergantungan Luar Mock: Gunakan keupayaan mengejek Laravel untuk mensimulasikan pertanyaan pangkalan data atau panggilan API, memastikan ujian bebas daripada faktor luaran.
4. Jalankan Ujian Secara Tetap: Sepadukan ujian ke dalam aliran kerja pembangunan anda untuk mengetahui isu lebih awal.

---

Fikiran Akhir

Ujian unit dalam Laravel tidak perlu menakutkan. Dengan alatan terbina dalam dan penyepaduan lancar dengan PHPUnit, Laravel memudahkan untuk menulis dan mengurus ujian. Dengan mengamalkan minda mengutamakan ujian, anda akan memastikan aplikasi anda teguh, boleh dipercayai dan sedia untuk pengeluaran.

Mulakan kecil—tulis ujian untuk satu fungsi atau kelas. Apabila anda berasa selesa, anda akan melihat cara ujian unit boleh mengubah proses pembangunan anda. Selamat mengekod!

Atas ialah kandungan terperinci Ujian Unit dalam Laravel: Pendekatan Praktikal untuk Pembangun. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!