php單元測試進(jìn)階（7）- 核心技術(shù) - 樁件(stub) - 構(gòu)造函數(shù)注入樁件
本系列文章主要代碼與文字來源于《單元測試的藝術(shù)》展哭，原作者：Roy Osherove跺涤。譯者：金迎褪迟。
本系列文章根據(jù)php的語法與使用習(xí)慣做了改編凡壤。所有代碼在本機(jī)測試通過。如轉(zhuǎn)載請注明出處。
源代碼
（1）t2\application\index\controller下根據(jù)測試需要（實(shí)際是解耦易稠，讓程序更加結(jié)構(gòu)清晰）提取的接口
IExtensionManager.php
<?php
namespace app\index\controller;
/**
* 文件名是否有效接口
* 源代碼中的文件管理器類會實(shí)現(xiàn)，一個樁件也會實(shí)現(xiàn)
* 接口的存在包蓝，讓所有代碼的含義更加清晰驶社，穩(wěn)定。
*/
interface IExtensionManager
{
/**
* 判斷文件名是否有效
* @param string $filename
* @return boolean
*/
public function isValid($filename);
}
（2）t2\application\index\controller下文件管理器類养晋，實(shí)現(xiàn)了上面的接口衬吆，但是實(shí)際被排除在單元測試之外，不測它绳泉。應(yīng)該使用集成測試來測試此類逊抡。
FileExtensionManager.php
<?php
namespace app\index\controller;
/**
* 文件管理器類
*
*/
class FileExtensionManager implements IExtensionManager
{
/**
* 根據(jù)某個配置文件的內(nèi)容判斷文件名是否有效
* @param string $filename
*/
public function isValid($filename)
{
// 會使用file_get_contents函數(shù)讀取某個文件的內(nèi)容
// 這里為了簡略不寫，因?yàn)椴皇侵攸c(diǎn)零酪。
return true;
}
}
（3）t2\application\index\controller下被測類冒嫡，日志分析器。使用了構(gòu)造方法注入的方式來寫代碼四苇，便于測試
LogAnalyzer.php
<?php
namespace app\index\controller;
/**
* 日志分析器類孝凌，也是被測類
*
* 注意，這是用構(gòu)造方法注入的例子月腋。
*/
class LogAnalyzer
{
/**
* @var IExtensionManager
*/
private $manager;
public function __construct(IExtensionManager $mgr)
{
$this->manager = $mgr;
}
/**
* 判斷文件名是否有效蟀架，調(diào)用另一個類來實(shí)現(xiàn)
* @param string $filename
*/
public function isValidLogFileName($filename)
{
return $this->manager->isValid($filename);
}
}
測試代碼
（4）t2\tests\index\controller\下，樁件類榆骚，用于替換文件管理器片拍，便于測試
FakeExtensionManager.php
<?php
namespace tests\index\controller;
/**
* 一個樁件類，用于測試日志分析器妓肢，因?yàn)槿罩痉治鰰x取文件捌省，妨礙單元測試。
*/
class FakeExtensionManager implements \app\index\controller\IExtensionManager
{
public $willBeValid = false;
/**
* 根據(jù)某個配置文件的內(nèi)容判斷文件名是否有效
* @param string $filename
*/
public function isValid($filename)
{
return $this->willBeValid;
}
}
（5）t2\tests\index\controller\下碉钠，最后是測試類纲缓，用構(gòu)造方法注入樁件
LogAnalyzerTest.php
<?php
namespace tests\index\controller;
/**
* 測試用的類
*/
class LogAnalyzerTest extends \think\testing\TestCase
{
/**
* @test
* 使用構(gòu)造器注入樁件的方法 進(jìn)行測試
* 注意，盡量使得測試的方法名稱有意義喊废，這非常重要祝高，便于維護(hù)測試代碼。有規(guī)律
*/
public function isValidFileName_NameSupportedExtension_ReturnTrue()
{
//準(zhǔn)備好一個返回true的樁件
$myFakeManager = new FakeExtensionManager();
$myFakeManager->willBeValid = true;
//開始創(chuàng)建被測類的對象污筷，準(zhǔn)備測試
$analyzer = new \app\index\controller\LogAnalyzer($myFakeManager);
$result = $analyzer->isValidLogFileName("short.ext");
$this->assertTrue($result);
}
}
打開cmd窗口褂策，測試通過。
額外說明，本文里斤寂，源代碼的組織方式位于同一命名空間內(nèi)，實(shí)際至少不應(yīng)放在控制器命名空間下揪惦，本文為了簡便放一起遍搞。還有，測試代碼倒無所謂器腋，放一起挺好
上一篇：php單元測試進(jìn)階（6）- 核心技術(shù) - 樁件(stub)
下一篇：php單元測試進(jìn)階（8）- 核心技術(shù) - 樁件(stub) - 屬性注入樁件
