Frameworks menyediakan alatan untuk pembangunan aplikasi yang pantas, tetapi selalunya meningkatkan hutang teknikal dengan lebih pantas anda mencipta fungsi. Hutang teknikal berlaku apabila kebolehselenggaraan bukan fokus bertujuan untuk pemaju. Perubahan dan penyahpepijatan pada masa hadapan adalah mahal kerana kekurangan ujian dan struktur unit.
Berikut ialah cara untuk mula menstrukturkan kod anda untuk kebolehujian dan kebolehselenggaraan - dan menjimatkan masa anda.
Mari kita mulakan dengan beberapa kod yang direka tetapi tipikal. Ini boleh menjadi kelas model dalam mana-mana rangka kerja tertentu.
class User {
public function getCurrentUser()
{
$user_id = $_SESSION['user_id'];
$user = App::db->select('id, username')
->where('id', $user_id)
->limit(1)
->get();
if ( $user->num_results() > 0 )
{
return $user->row();
}
return false;
}
}
Kod ini berfungsi tetapi memerlukan penambahbaikan:
$_SESSION pembolehubah global. Rangka kerja ujian unit seperti PHPUnit bergantung pada baris arahan, di mana $_SESSION dan banyak pembolehubah global lain tidak tersedia. $_SESSION 全局变量。单元测试框架（例如 PHPUnit）依赖于命令行，其中 $_SESSION 和许多其他全局变量不可用。App::db 实例中的数据库代码。另外，如果我们不想要当前用户的信息怎么办？这里尝试为上述功能创建单元测试。
class UserModelTest extends PHPUnit_Framework_TestCase {
public function testGetUser()
{
$user = new User();
$currentUser = $user->getCurrentUser();
$this->assertEquals(1, $currentUser->id);
}
}
让我们检查一下。首先，测试将失败。 User 对象中使用的 $_SESSION 变量在单元测试中不存在，因为它在命令行中运行 PHP。
其次，没有数据库连接设置。这意味着，为了完成这项工作，我们需要引导我们的应用程序以获得 App 对象及其 db 对象。我们还需要一个可用的数据库连接来进行测试。
为了使这个单元测试工作，我们需要：
那么，让我们开始讨论如何改进这一点。
在这个简单的上下文中，检索当前用户的函数是不必要的。这是一个人为的示例，但本着 DRY 原则的精神，我选择进行的第一个优化是概括此方法。
class User {
public function getUser($user_id)
{
$user = App::db->select('user')
->where('id', $user_id)
->limit(1)
->get();
if ( $user->num_results() > 0 )
{
return $user->row();
}
return false;
}
}
这提供了一种我们可以在整个应用程序中使用的方法。我们可以在调用时传入当前用户，而不是将该功能传递给模型。当代码不依赖其他功能（例如会话全局变量）时，代码更加模块化和可维护。
但是，这仍然无法按预期进行测试和维护。我们仍然依赖数据库连接。
让我们通过添加一些依赖注入来帮助改善这种情况。当我们将数据库连接传递到类中时，我们的模型可能如下所示。
class User {
protected $_db;
public function __construct($db_connection)
{
$this->_db = $db_connection;
}
public function getUser($user_id)
{
$user = $this->_db->select('user')
->where('id', $user_id)
->limit(1)
->get();
if ( $user->num_results() > 0 )
{
return $user->row();
}
return false;
}
}
现在，我们的 User 模型的依赖项已经提供了。我们的类不再假定某个数据库连接，也不再依赖于任何全局对象。
至此，我们的类就基本可以测试了。我们可以传入我们选择的数据源（大部分）和用户 ID，并测试该调用的结果。我们还可以切换单独的数据库连接（假设两者都实现相同的检索数据的方法）。酷。
让我们看看单元测试可能是什么样子。
<?php
use Mockery as m;
use Fideloper\User;
class SecondUserTest extends PHPUnit_Framework_TestCase {
public function testGetCurrentUserMock()
{
$db_connection = $this->_mockDb();
$user = new User( $db_connection );
$result = $user->getUser( 1 );
$expected = new StdClass();
$expected->id = 1;
$expected->username = 'fideloper';
$this->assertEquals( $result->id, $expected->id, 'User ID set correctly' );
$this->assertEquals( $result->username, $expected->username, 'Username set correctly' );
}
protected function _mockDb()
{
// "Mock" (stub) database row result object
$returnResult = new StdClass();
$returnResult->id = 1;
$returnResult->username = 'fideloper';
// Mock database result object
$result = m::mock('DbResult');
$result->shouldReceive('num_results')->once()->andReturn( 1 );
$result->shouldReceive('row')->once()->andReturn( $returnResult );
// Mock database connection object
$db = m::mock('DbConnection');
$db->shouldReceive('select')->once()->andReturn( $db );
$db->shouldReceive('where')->once()->andReturn( $db );
$db->shouldReceive('limit')->once()->andReturn( $db );
$db->shouldReceive('get')->once()->andReturn( $result );
return $db;
}
}
我在此单元测试中添加了一些新内容：Mockery。 Mockery 允许您“模拟”（伪造）PHP 对象。在本例中，我们正在模拟数据库连接。通过我们的模拟，我们可以跳过测试数据库连接并简单地测试我们的模型。
想要了解有关 Mockery 的更多信息吗？
在本例中，我们正在模拟 SQL 连接。我们告诉模拟对象期望调用 select、where、limit 和 get 方法。我返回 Mock 本身，以反映 SQL 连接对象如何返回自身 ($this)，从而使其方法调用“可链接”。请注意，对于 get 方法，我返回数据库调用结果 - 填充了用户数据的 stdClass
🎜Kebolehselenggaraan kod ini tidak sesuai. Sebagai contoh, jika kita menukar sumber data, kita perlu menukar kod pangkalan data dalam setiap contoh
App::db yang digunakan dalam aplikasi. Juga, bagaimana jika kita tidak mahu maklumat pengguna semasa? 🎜
🎜
interface UserRepositoryInterface {
public function getUser($user_id);
}
class MysqlUserRepository implements UserRepositoryInterface {
protected $_db;
public function __construct($db_conn)
{
$this->_db = $db_conn;
}
public function getUser($user_id)
{
$user = $this->_db->select('user')
->where('id', $user_id)
->limit(1)
->get();
if ( $user->num_results() > 0 )
{
return $user->row();
}
return false;
}
}
class User {
protected $userStore;
public function __construct(UserRepositoryInterface $user)
{
$this->userStore = $user;
}
public function getUser($user_id)
{
return $this->userStore->getUser($user_id);
}
}
$_SESSION yang digunakan dalam objek User tidak wujud dalam ujian unit kerana ia menjalankan PHP daripada baris arahan. 🎜
🎜Kedua, tiada persediaan sambungan pangkalan data. Ini bermakna untuk membuat ini berfungsi, kita perlu bootstrap aplikasi kita untuk mendapatkan objek App dan objek dbnya. Kami juga memerlukan sambungan pangkalan data yang berfungsi untuk menguji. 🎜
🎜Untuk membuat ujian unit ini berfungsi, kami memerlukan: 🎜
🎜
🎜Sediakan konfigurasi untuk CLI (PHPUnit) yang berjalan dalam aplikasi kami🎜
🎜Bergantung pada sambungan pangkalan data. Melakukan ini bermakna bergantung pada sumber data yang berasingan daripada ujian unit kami. Bagaimana jika pangkalan data ujian kami tidak mempunyai data yang kami harapkan? Bagaimana jika sambungan pangkalan data kami perlahan? 🎜
🎜 Aplikasi yang bergantung pada bootstrap boleh memperlahankan ujian unit dengan ketara dengan menambahkan overhed pada ujian mereka. Sebaik-baiknya, kebanyakan kod kami boleh diuji secara bebas daripada rangka kerja yang digunakan. 🎜
🎜
🎜Jadi, mari kita mula membincangkan cara untuk menambah baik perkara ini. 🎜
🎜
🎜Pastikan kod anda kering🎜
🎜Dalam konteks mudah ini, fungsi untuk mendapatkan semula pengguna semasa adalah tidak diperlukan. Ini adalah contoh yang dibuat-buat, tetapi berdasarkan semangat prinsip KERING, pengoptimuman pertama yang saya pilih untuk lakukan adalah untuk menyamaratakan pendekatan ini. 🎜
<?php
use Mockery as m;
use Fideloper\User;
class ThirdUserTest extends PHPUnit_Framework_TestCase {
public function testGetCurrentUserMock()
{
$userRepo = $this->_mockUserRepo();
$user = new User( $userRepo );
$result = $user->getUser( 1 );
$expected = new StdClass();
$expected->id = 1;
$expected->username = 'fideloper';
$this->assertEquals( $result->id, $expected->id, 'User ID set correctly' );
$this->assertEquals( $result->username, $expected->username, 'Username set correctly' );
}
protected function _mockUserRepo()
{
// Mock expected result
$result = new StdClass();
$result->id = 1;
$result->username = 'fideloper';
// Mock any user repository
$userRepo = m::mock('Fideloper\Third\Repository\UserRepositoryInterface');
$userRepo->shouldReceive('getUser')->once()->andReturn( $result );
return $userRepo;
}
}
// In some controller
$user = new User( new MysqlUser( App:db->getConnection("mysql") ) );
$user->id = App::session("user->id");
$currentUser = $user->getUser($user_id);
User kami disediakan. Kelas kami tidak lagi menggunakan sambungan pangkalan data tertentu, dan juga tidak bergantung pada sebarang objek global. 🎜
🎜Pada ketika ini, kelas kami pada dasarnya bersedia untuk ujian. Kami boleh memasukkan sumber data pilihan kami (kebanyakannya) dan ID pengguna, dan menguji keputusan panggilan itu. Kami juga boleh menukar sambungan pangkalan data yang berasingan (dengan mengandaikan kedua-duanya melaksanakan kaedah yang sama untuk mendapatkan data). sejuk. 🎜
🎜Mari lihat rupa ujian unit. 🎜
// Somewhere in a configuration file
$container = new Pimple();
$container["user"] = function() {
return new User( new MysqlUser( App:db->getConnection('mysql') ) );
}
// Now, in all of our controllers, we can simply write:
$currentUser = $container['user']->getUser( App::session('user_id') );
🎜Ingin mengetahui lebih lanjut tentang Mockery? 🎜🎜Dalam contoh ini, kami mensimulasikan sambungan SQL. Kami memberitahu objek olok-olok untuk mengharapkan panggilan ke kaedah
select, where, limit dan get. Saya mengembalikan Mock itu sendiri untuk menggambarkan bagaimana objek sambungan SQL mengembalikan dirinya sendiri ($this), menjadikan kaedahnya memanggil "boleh rantai". Ambil perhatian bahawa untuk kaedah get, saya mengembalikan hasil panggilan pangkalan data - objek stdClass yang diisi dengan data pengguna. 🎜
🎜Ini menyelesaikan beberapa masalah: 🎜
我们还可以做得更好。这就是它变得有趣的地方。
为了进一步改进这一点，我们可以定义并实现一个接口。考虑以下代码。
interface UserRepositoryInterface {
public function getUser($user_id);
}
class MysqlUserRepository implements UserRepositoryInterface {
protected $_db;
public function __construct($db_conn)
{
$this->_db = $db_conn;
}
public function getUser($user_id)
{
$user = $this->_db->select('user')
->where('id', $user_id)
->limit(1)
->get();
if ( $user->num_results() > 0 )
{
return $user->row();
}
return false;
}
}
class User {
protected $userStore;
public function __construct(UserRepositoryInterface $user)
{
$this->userStore = $user;
}
public function getUser($user_id)
{
return $this->userStore->getUser($user_id);
}
}
这里发生了一些事情。
addUser() 方法。User 模型中强制使用实现 UserInterface 的类。这样可以保证数据源始终有一个可用的 getUser() 方法，无论使用哪个数据源来实现 UserInterface。请注意，我们的
User对象类型提示UserInterface在其构造函数中。这意味着实现UserInterface的类必须传递到User对象中。这是我们所依赖的保证 - 我们需要getUser方法始终可用。
这样做的结果是什么？
User类，我们可以轻松地模拟数据源。 （测试数据源的实现将是单独的单元测试的工作）。User 对象。如果您决定放弃 SQL，则只需创建一个不同的实现（例如 MongoDbUser）并将其传递到您的 User 模型中。我们还简化了单元测试！
<?php
use Mockery as m;
use Fideloper\User;
class ThirdUserTest extends PHPUnit_Framework_TestCase {
public function testGetCurrentUserMock()
{
$userRepo = $this->_mockUserRepo();
$user = new User( $userRepo );
$result = $user->getUser( 1 );
$expected = new StdClass();
$expected->id = 1;
$expected->username = 'fideloper';
$this->assertEquals( $result->id, $expected->id, 'User ID set correctly' );
$this->assertEquals( $result->username, $expected->username, 'Username set correctly' );
}
protected function _mockUserRepo()
{
// Mock expected result
$result = new StdClass();
$result->id = 1;
$result->username = 'fideloper';
// Mock any user repository
$userRepo = m::mock('Fideloper\Third\Repository\UserRepositoryInterface');
$userRepo->shouldReceive('getUser')->once()->andReturn( $result );
return $userRepo;
}
}
我们已经完全取消了模拟数据库连接的工作。相反，我们只是模拟数据源，并告诉它当调用 getUser 时要做什么。
但是，我们仍然可以做得更好！
考虑我们当前代码的用法：
// In some controller
$user = new User( new MysqlUser( App:db->getConnection("mysql") ) );
$user->id = App::session("user->id");
$currentUser = $user->getUser($user_id);
我们的最后一步是引入容器。容器。在上面的代码中，我们需要创建并使用一堆对象来获取当前用户。此代码可能散布在您的应用程序中。如果您需要从 MySQL 切换到 MongoDB，您仍然需要编辑上述代码出现的每个位置。那几乎不是干的。容器可以解决这个问题。
容器只是“包含”一个对象或功能。它类似于应用程序中的注册表。我们可以使用容器自动实例化一个新的 User 对象以及所有需要的依赖项。下面，我使用 Pimple，一个流行的容器类。
// Somewhere in a configuration file
$container = new Pimple();
$container["user"] = function() {
return new User( new MysqlUser( App:db->getConnection('mysql') ) );
}
// Now, in all of our controllers, we can simply write:
$currentUser = $container['user']->getUser( App::session('user_id') );
我已将 User 模型的创建移至应用程序配置中的一个位置。结果是：
User 对象和选择的数据存储在我们应用程序的一个位置定义。User 模型从使用 MySQL 切换到 ONE 位置中的任何其他数据源。这更易于维护。在本教程的过程中，我们完成了以下任务：
我相信您已经注意到，我们以可维护性和可测试性的名义添加了更多代码。可以对这种实现提出强有力的论据：我们正在增加复杂性。事实上，这需要项目的主要作者和合作者对代码有更深入的了解。
但是，技术债务总体减少远远超过了解释和理解的成本。
您可以使用 Composer 轻松地将 Mockery 和 PHPUnit 包含到您的应用程序中。将这些添加到 composer.json 文件中的“require-dev”部分：
"require-dev": {
"mockery/mockery": "0.8.*",
"phpunit/phpunit": "3.7.*"
}
然后，您可以按照“dev”要求安装基于 Composer 的依赖项：
$ php composer.phar install --dev
在 Nettuts+ 上了解有关 Mockery、Composer 和 PHPUnit 的更多信息。
对于 PHP，请考虑使用 Laravel 4，因为它特别利用了容器和此处介绍的其他概念。
感谢您的阅读！
Atas ialah kandungan terperinci Cipta kod PHP yang boleh diuji dan diselenggara. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!
![[Web front-end] Permulaan pantas Node.js](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
