單元測試常用技能(PHPUnit + Laravel)

1. 數據供給器

用來提供參數和結果,使用 @dataProvider 標註來指定使用哪個數據供給器方法。例如檢測app升級數據是否符合預期,addProviderAppUpdateData()提供測試的參數和結果。testAppUpdateData()檢測appUpdateData()返回的結果是否和給定的預期結果相等,即如果$appId='apple_3.3.2_117', $result=['status' => 0, 'isIOS' => false], 則$data中如果含有['status' => 0, 'isIOS' => false], 則斷言成功。建議在數據提供器,逐個用字符串鍵名對其命名,這樣在斷言失敗的時候將輸出失敗的名稱,更容易定位問題

  • 示例代碼:
<?php
    namespace Tests\Unit;

    use App\Services\ClientService;
    use Tests\TestCase;

    class ClientServiceTest extends TestCase
    {
        /**
         * @dataProvider addProviderAppUpdateData
         *
         * @param $appId
         * @param $result
         */
        public function testAppUpdateData($appId, $result)
        {
            $data = (new ClientService($appId))->appUpdateData();

            $this->assertTrue(count(array_intersect_assoc($data, $result)) == count($result));
        }

        public function addProviderAppUpdateData()
        {
            return [
                'null'                 => [null, ['status' => 0, 'isIOS' => false, 'latest_version' => 'V']],
                'error app id'         => ['sdas123123', ['status' => 0, 'isIOS' => false, 'latest_version' => 'V']],
                'android force update' => ['bx7_3.3.5_120', ['status' => 0, 'isIOS' => false]],
                'ios force update'     => ['apple_3.3.2_117', ['status' => 1, 'isIOS' => true]],
                'android soft update'  => ['sanxing_3.3.2_117', ['status' => 2, 'isIOS' => false]],
                'ios soft update'      => ['apple_3.3.3_118', ['status' => 2, 'isIOS' => true]],
                'android normal'       => ['fhqd_3.3.6_121', ['status' => 1, 'isIOS' => false]],
                'ios normal'           => ['apple_3.3.5_120', ['status' => 1, 'isIOS' => true]],
                'h5'                   => ['h5_3.3.3', ['status' => 1, 'isIOS' => false]]
            ];
        }
    }
  • 斷言成功結果:

企業微信截圖_cf737ee6-415a-4dbd-9bb4-87a3b1759b15.png

2. 斷言方法

常用有assertTrue(), assertFalse(), assertNull(), assertEquals(), assertThat()。

assertThat()自定義斷言。常用的約束有isNull()、isTrue()、isFalse()、isInstanceOf();常用的組合約束logicalOr()、logicalAnd()。例如檢測返回的結果是否是null或ApiApp類。

  • 示例代碼:
<?php
    namespace Tests\Unit;

    use App\Models\ApiApp;
    use App\Services\SystemConfigService;
    use Tests\TestCase;

    class SystemConfigServiceTest extends TestCase
    {
        /**
         * @dataProvider additionProviderGetLatestUpdateAppApi
         *
         * @param $appType
         */
        public function testGetLatestUpdateAppApi($appType)
        {
            $result = SystemConfigService::getLatestUpdateAppApi($appType);
            $this->assertThat($result, $this->logicalOr($this->isNull(), $this->isInstanceOf(ApiApp::class)));
        }

        public function additionProviderGetLatestUpdateAppApi()
        {
            return [
                'apple'   => [1],
                'android' => [2],
                'null'    => [9999]
            ];
        }
    }
  • 斷言成功結果:

syste.png

3. 對異常進行測試

使用expectExceptionCode()對錯誤碼進行檢測,不建議對錯誤信息文案進行檢測。例如檢測設備被鎖後是否拋出3026錯誤碼。

  • 示例代碼:
<?php
    namespace Tests\Unit;

    use App\Services\UserSecurityService;
    use Illuminate\Support\Facades\Cache;
    use Tests\TestCase;

    class UserSecurityServiceTest extends TestCase
    {
        public static $userId = 4;

        /**
         * 設備鎖檢測
         * @throws \App\Exceptions\UserException
         */
        public function testDeviceCheckLock()
        {
            $this->expectExceptionCode(3026);
            Cache::put('device-login-error-account-', '1,2,3,4,5', 300);
            UserSecurityService::$request = null;
            UserSecurityService::$udid    = null;
            UserSecurityService::deviceCheck(self::$userId);
        }
    }
  • 斷言成功結果:

device.png

4. 測試私有屬性和私有方法使用反射機制

  • 如果只測試私有方法可使用ReflectionMethod()反射方法,使用setAccessible(true)設置方法可訪問,並使用invokeArgs()或invoke()調用方法(invokeArgs將參數作爲數組傳遞)。例如檢測IP是否在白名單中。
  • 示例代碼:

被檢測代碼:

namespace App\Facades\Services;

    /**
     * Class WebDefender
     */
    class WebDefenderService extends BaseService
    {
          //ip白名單
        private $ipWhiteList = [
            '10.*',  
            '172.18.*',  
            '127.0.0.1' 
        ];

        /**
         * ip是否在白名單中
         *
         * @param string $ip
         *
         * @return bool
         */
        private function checkIPWhiteList($ip)
        {
            if (!$this->ipWhiteList || !is_array($this->ipWhiteList)) {
                return false;
            }
            foreach ($this->ipWhiteList as $item) {
                if (preg_match("/{$item}/", $ip)) {
                    return true;
                }
            }

            return false;
        }
     }

檢測方法:

<?php

    namespace Tests\Unit;

    use App\Facades\Services\WebDefenderService;
    use Tests\TestCase;

    class WebDefenderTest extends TestCase
    {
        /**
         * 測試IP白名單
         * @dataProvider additionProviderIp
         *
         * @param $ip
         * @param $result
         *
         * @throws \ReflectionException
         */
        public function testIPWhite($ip, $result)
        {
            $checkIPWhiteList = new \ReflectionMethod(WebDefenderService::class, 'checkIPWhiteList');
            $checkIPWhiteList->setAccessible(true);
            $this->assertEquals($result, $checkIPWhiteList->invokeArgs(new WebDefenderService(), [$ip]));
        }

        public function additionProviderIp()
        {
            return [
                '10 ip'  => ['10.1.1.7', true],
                '172 ip' => ['172.18.2.5', true],
                '127 ip' => ['127.0.0.1', true],
                '192 ip' => ['192.168.0.1', false]
            ];
        }
     }
  • 測試私有屬性可使用ReflectionClass(), 獲取屬性用getProperty(), 設置屬性的值用setValue(), 獲取方法用getMethod(), 設置屬性和方法可被訪問使用setAccessible(true)。例如檢測白名單路徑。
  • 示例代碼:

被檢測代碼:

<?php
    namespace App\Facades\Services;

    use App\Exceptions\ExceptionCode;
    use App\Exceptions\UserException;
    use Illuminate\Support\Facades\Cache;

    /**
     * CC攻擊防禦器
     * Class WebDefender
     */
    class WebDefenderService extends BaseService
    {
        //路徑白名單(正則)
        private $pathWhiteList = [
            //'^auth\/(.*)',
        ];

        private static $request = null;

         /**
         * 請求路徑是否在白名單中
         *
         * @return bool
         */
        private function checkPathWhiteList()
        {
            $path = ltrim(self::$request->getPathInfo(), '/');
            if (!$path || !$this->pathWhiteList || !is_array($this->pathWhiteList)) {
                return false;
            }
            foreach ($this->pathWhiteList as $item) {
                if (preg_match("/$item/", $path)) {
                    return true;
                }
            }

            return false;
        }
    }

檢測方法:

<?php
    namespace Tests\Unit;

    use App\Facades\Services\WebDefenderService;
    use Illuminate\Http\Request;
    use Tests\TestCase;

    class WebDefenderTest extends TestCase
    {
         /**
         * 檢測白名單路徑
         * @dataProvider additionProviderPathWhiteList
         *
         * @param $pathProperty
         * @param $request
         * @param $result
         *
         * @throws \ReflectionException
         */
        public function testCheckPathWhiteList($pathProperty, $request, $result)
        {
            $reflectedClass = new \ReflectionClass('App\Facades\Services\WebDefenderService');

            $webDefenderService     = new WebDefenderService();
            $reflectedPathWhiteList = $reflectedClass->getProperty('pathWhiteList');
            $reflectedPathWhiteList->setAccessible(true);
            $reflectedPathWhiteList->setValue($webDefenderService, $pathProperty);

            $reflectedRequest = $reflectedClass->getProperty('request');
            $reflectedRequest->setAccessible(true);
            $reflectedRequest->setValue($request);

            $reflectedMethod = $reflectedClass->getMethod('checkPathWhiteList');
            $reflectedMethod->setAccessible(true);
            $this->assertEquals($result, $reflectedMethod->invoke($webDefenderService));
        }

        public function additionProviderPathWhiteList()
        {
            $allPath            = ['.*'];
            $checkPath          = ['^auth\/(.*)'];
            $authSendSmsRequest = new Request([], [], [], [], [], ['HTTP_HOST' => 'api.dev.com', 'REQUEST_URI' => '/auth/sendSms']);
            $indexRequest       = new Request([], [], [], [], [], ['HTTP_HOST' => 'api.dev.com', 'REQUEST_URI' => '/']);
            $noMatchRequest     = new Request([], [], [], [], [], ['HTTP_HOST' => 'api.dev.com', 'REQUEST_URI' => '/product/sendSms']);

            return [
                'index'               => [[], $authSendSmsRequest, false],
                'no request'          => [$allPath, $indexRequest, false],
                'all request'         => [$allPath, $authSendSmsRequest, true],
                'check auth sms'      => [$checkPath, $authSendSmsRequest, true],
                'check path no match' => [$checkPath, $noMatchRequest, false]
            ];
        }
    }

5. 代碼覆蓋率

使用--coverage-html導出的報告含有類與特質覆蓋率、行覆蓋率、函數與方法覆蓋率。可查看當前單元測試覆蓋的範圍。例如輸出WebDefenderTest的代碼覆蓋率到桌面(phpunit tests/unit/WebDefenderTest --coverage-html ~/Desktop/test)

code_coverage.png

6. 指定代碼覆蓋率報告要包含哪些文件

在配置文件(phpunit.xml)裏設置whitelist中的processUncoveredFilesFromWhitelist=true, 設置目錄用<directory>標籤,設置文件用<file>標籤。例如指定app/Services目錄下的所有文件和app/Facades/Services/WebDefenderService.php在報告中。

  • 示例代碼:
 <?xml version="1.0" encoding="UTF-8"?>
    <phpunit backupGlobals="false"
             backupStaticAttributes="false"
             bootstrap="tests/bootstrap.php"
             colors="true"
             convertErrorsToExceptions="true"
             convertNoticesToExceptions="true"
             convertWarningsToExceptions="true"
             processIsolation="false"
             stopOnFailure="false">
        <testsuites>
            <testsuite name="Unit">
                <directory suffix="Test.php">./tests/Unit</directory>
            </testsuite>

            <testsuite name="Feature">
                <directory suffix="Test.php">./tests/Feature</directory>
            </testsuite>
        </testsuites>
        <filter>
            <whitelist processUncoveredFilesFromWhitelist="true">
                <directory suffix=".php">./app/Services</directory>
                <file>./app/Facades/Services/WebDefenderService.php</file>
            </whitelist>
        </filter>
        <php>
            <server name="APP_ENV" value="local"/>
            <server name="BCRYPT_ROUNDS" value="4"/>
            <server name="CACHE_DRIVER" value="credis"/>
            <server name="MAIL_DRIVER" value="array"/>
            <server name="QUEUE_CONNECTION" value="sync"/>
            <server name="SESSION_DRIVER" value="array"/>
            <server name="APP_CONFIG_CACHE" value="bootstrap/cache/config.phpunit.php"/>
            <server name="APP_SERVICES_CACHE" value="bootstrap/cache/services.phpunit.php"/>
            <server name="APP_PACKAGES_CACHE" value="bootstrap/cache/packages.phpunit.php"/>
            <server name="APP_ROUTES_CACHE" value="bootstrap/cache/routes.phpunit.php"/>
            <server name="APP_EVENTS_CACHE" value="bootstrap/cache/events.phpunit.php"/>
        </php>
    </phpunit>

7. 參考文檔

[PHPUnit官方文檔 https://phpunit.readthedocs.io/zh_CN/latest/index.html](https://phpunit.readthedocs.io/zh_CN/latest/index.html)
[反射類 https://www.php.net/manual/en/class.reflectionclass.php](https://www.php.net/manual/en/class.reflectionclass.php)
[反射方法 https://www.php.net/manual/en/class.reflectionmethod.php](https://www.php.net/manual/en/class.reflectionmethod.php)
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章