Tiện ích mở rộng phpunit

Kiểm tra tự động đảm bảo rằng tiện ích mở rộng của bạn hoạt động như bạn mong đợi, giúp tránh đưa ra các lỗi hoặc hồi quy mới và tiết kiệm thời gian kiểm tra thủ công. Flarum hiện cung cấp công cụ cho các bài kiểm tra tích hợp và đơn vị phụ trợ tự động và chúng tôi dự định phát hành hỗ trợ cho kiểm tra đơn vị giao diện người dùng và kiểm tra E2E trong tương lai

Kiểm tra phụ trợ

Thư viện

    
        
            ./integration
        
    

0 được sử dụng bởi lõi và một số tiện ích mở rộng đi kèm cho các bài kiểm tra tích hợp và đơn vị tự động. Thực chất nó là một tập hợp các utils cho phép test Flarum core và các extension với PHPUnit

Cài đặt

Đầu tiên, bạn sẽ cần yêu cầu gói trình soạn thảo

    
        
            ./integration
        
    

0 làm phụ thuộc nhà phát triển cho tiện ích mở rộng của mình

    
        
            ./integration
        
    

2

Sau đó, bạn sẽ cần thiết lập cấu trúc tệp để kiểm tra và thêm cấu hình PHPUnit

tests
├── fixtures [put any files needed by your tests here [blade templates, images, etc]]
├── integration
│   ├── setup.php [code below]
│   └── PUT INTEGRATION TESTS HERE [organizing into folder is generally a good idea]
├── unit
│   ├── PUT UNIT TESTS HERE
├── phpunit.integration.xml [code below]
└── phpunit.unit.xml [code below]

phpunit. hội nhập. xml

Đây chỉ là một tệp cấu hình phpunit ví dụ để kiểm tra tích hợp. Bạn có thể điều chỉnh điều này nếu cần, nhưng giữ nguyên

    
        
            ./integration
        
    

3,

    
        
            ./integration
        
    

4 và

    
        
            ./integration
        
    

5

    
        
            ./integration
        
    

phpunit. bài học. xml

Đây chỉ là một tệp cấu hình phpunit ví dụ cho các bài kiểm tra đơn vị. Bạn có thể tinh chỉnh điều này khi cần thiết

________số 8_______

cài đặt. php

Tập lệnh này sẽ được chạy để thiết lập cấu trúc tệp/cơ sở dữ liệu thử nghiệm

    
        
            ./integration
        
    

6 của mình để chúng tôi có thể chạy bộ thử nghiệm của mình qua

    
        
            ./integration
        
    

7. Thêm một số biến thể sau đây vào

    
        
            ./integration
        
    

6 của bạn

"scripts": {
    "test": [
        "@test:unit",
        "@test:integration"
    ],
    "test:unit": "phpunit -c tests/phpunit.unit.xml",
    "test:integration": "phpunit -c tests/phpunit.integration.xml",
    "test:setup": "@php tests/integration/setup.php"
},
"scripts-descriptions": {
    "test": "Runs all tests.",
    "test:unit": "Runs all unit tests.",
    "test:integration": "Runs all integration tests.",
    "test:setup": "Sets up a database for use with integration tests. Execute this only once."
}

Quy trình kiểm tra Github

Trong các kho lưu trữ công khai, GitHub Actions cho phép bạn chạy tất cả các thử nghiệm của mình trên mọi cam kết và yêu cầu kéo miễn phí. Bạn có thể sao chép quy trình kiểm tra GitHub Actions của lõi Flarum vào thư mục

    
        
            ./integration
        
    

9 của tiện ích mở rộng của bạn để kích hoạt tính năng này

Bây giờ chúng tôi đã có mọi thứ tại chỗ, chúng tôi cần thiết lập trang web thử nghiệm của mình để thử nghiệm tích hợp. Đối với điều này, chúng tôi sẽ cần một phiên bản MySQL hoặc MariaDb và một nơi để lưu trữ các tệp thử nghiệm

Thông tin cơ sở dữ liệu thử nghiệm được định cấu hình thông qua

    
        
            ./unit
        
    
    
        
    

0 [mặc định là

    
        
            ./unit
        
    
    
        
    

1],

    
        
            ./unit
        
    
    
        
    

2 [mặc định là

    
        
            ./unit
        
    
    
        
    

3],

    
        
            ./unit
        
    
    
        
    

4 [mặc định là

    
        
            ./unit
        
    
    
        
    

5],

    
        
            ./unit
        
    
    
        
    

6 [mặc định là

    
        
            ./unit
        
    
    
        
    

7],

    
        
            ./unit
        
    
    
        
    

8 [mặc định là

    
        
            ./unit
        
    
    
        
    

7] và