14. 应用练习——版本 6
我们刚刚实现了如下分层结构:

示例中使用的 DBMS 是 MySQL。在上一章中,我们指出,实现 [dao] 层的类中没有任何内容表明使用了特定的 DBMS。现在我们将通过使用另一种 DBMS,即 PostgreSQL,来验证这一点。分层架构变为如下形式:

版本 6 不包含任何新类:它使用版本 5 的类。它只包含数据文件和新的主脚本:
| version-06
├── Data
│ ├── database.json
│ ├── errors.json
│ ├── postgres-dbtaxes-2019.sql
│ ├── results.json
│ ├── taxadmindata.json
│ └── taxpayersdata.json
├── Main
│ ├── MainCalculateTaxWithTaxAdminDataInPostgresDatabase.php
│ └── MainTransferAdminDataFromJsonFile2PostgresDatabase.php
└── Tests
├── data
│ ├── database-incomplete.json
│ └── database-nonexistent-user.json
├── BusinessTest.php
└── DaoTest.php
|
14.1. 安装 PostgreSQL DBMS
PHP 7 课程从网站 https://www.postgresql.org/download/下载了适用于 Windows 的 PostgreSQL 安装程序,运行它,然后把 PostgreSQL 的 Windows 服务(它在系统启动时自动启动)改为手动启动的服务。使用 [Laragon] 则更简单。PostgreSQL 默认没有安装,但 [Laragon] 可以自行添加它:
- 在 [Laragon] 窗口中(或在任务栏中它的图标上)右键单击,打开其菜单;
- 选择 [Tools > Quick add]。列表中显示了 [Laragon] 可以下载并安装的软件,其中包括一个或多个版本的 PostgreSQL,例如 [postgresql-17];
- 单击所需的版本即开始下载和安装。PostgreSQL 安装在 [<laragon>/bin/postgresql] 文件夹中,其数据位于 [<laragon>/data/postgresql-NN] 文件夹中;
- 现在,[Start All] 按钮会将 PostgreSQL 与 Apache 和 MySQL 一起启动。[Laragon] 窗口显示它正在监听端口 5432,即其默认端口。
如果所需版本的 PostgreSQL 没有列出,可以把它添加到列表中:菜单 [Tools > Quick add > Configuration] 会打开 [<laragon>/usr/packages.conf] 文件,该文件将每个程序与其压缩包的地址关联起来。添加(或修改)一行,形式为 [postgresql-17=<address of the zip archive>],其中该压缩包是 EDB 公司提供的适用于 Windows 的 PostgreSQL“二进制文件”压缩包(页面 https://www.enterprisedb.com/download-postgresql-binaries 上的“zip archive”链接)。或者,不使用该菜单,你也可以自己把这个压缩包解压到 [<laragon>/bin/postgresql] 的某个子文件夹中:[Laragon] 会在下次启动时找到它,并且可以通过 [PostgreSQL > Version] 菜单选择要使用的版本。
PostgreSQL 只在本章和下一章中使用。它只有在 [Laragon] 运行时才能工作,你可以通过 [PostgreSQL] 菜单在 [Laragon] 中停止它。
与 MySQL 一样,PostgreSQL 也有一个管理员,即超级用户 [postgres]。在 [Laragon] 所做的安装中,它通常没有密码。如果为它设置了密码,各工具会提示输入。
[Laragon] 的终端提供对 PostgreSQL 命令行客户端 [psql] 的访问,它相当于客户端 [mysql]。[PostgreSQL] 菜单在 [Laragon] 中还提供图形工具 [pgAdmin] (在已安装时)。PostgreSQL 的文档位于 https://www.postgresql.org/docs/。
14.2. 为 PostgreSQL DBMS 启用 PDO 扩展
PostgreSQL 的 PDO 驱动程序是 PHP 的 [pdo_pgsql] 扩展。启用它的方式与启用 MySQL 驱动程序相同:
- 要么在 [Laragon] 菜单中:PHP / Extensions / pdo_pgsql;
- 要么确认 [php.ini] 文件中的下面一行没有被注释掉(行首没有分号)(通过 [Laragon] 的 PHP / php.ini 菜单):
保存更改后,重启 [Laragon] 服务([Reload] 按钮)。然后使用 MySQL 一节中的 [pdo-drivers.php] 脚本验证驱动程序是否存在,在 [scripts-console/mysql] 文件夹中运行:
| > php pdo-drivers.php
Available PDO drivers: mysql, pgsql, sqlite
extension [pdo_mysql]: loaded
extension [pdo_pgsql]: loaded
extension [pdo_sqlite]: loaded
|
[pgsql] 驱动程序是可用的驱动程序之一。
14.3. 创建数据库 [dbtaxes-2019]
使用 PostgreSQL,我们将创建:
- 一个名为 [admtaxes] 的用户,密码为 [pwdtaxes];
- 一个名为 [dbtaxes-2019], 的数据库,该用户将是其所有者;
- 在该数据库中,创建表 [tbbrackets] 和 [tbconstants]。
PHP 7 课程使用管理工具 [pgAdmin] 来完成这项任务,它是一个需要在 DBMS 之外另行安装的 Web 应用程序。与 MySQL 一样,我们改为编写一个 SQL 脚本:[Data/postgres-dbtaxes-2019.sql]:
| -- database [dbtaxes-2019] of the tax calculation application - PostgreSQL DBMS
-- to be executed by the administrator [postgres] of the DBMS:
-- psql -U postgres -f postgres-dbtaxes-2019.sql
-- the database, its tables and its owner are recreated if they already exist
-- the database and its owner [admtaxes] with password [pwdtaxes]
DROP DATABASE IF EXISTS "dbtaxes-2019";
DROP ROLE IF EXISTS admtaxes;
CREATE ROLE admtaxes LOGIN PASSWORD 'pwdtaxes';
CREATE DATABASE "dbtaxes-2019" OWNER admtaxes ENCODING 'UTF8' TEMPLATE template0;
-- connection to the new database (psql client command)
\connect dbtaxes-2019
-- the tables are created by [admtaxes]: he will be their owner
SET ROLE admtaxes;
-- the table of the tax brackets
CREATE TABLE tbbrackets (
id INTEGER GENERATED ALWAYS AS IDENTITY,
limits NUMERIC(10, 2) NOT NULL,
coeffr NUMERIC(6, 2) NOT NULL,
coeffn NUMERIC(10, 2) NOT NULL,
PRIMARY KEY (id)
);
-- the table of the tax calculation constants
CREATE TABLE tbconstants (
id INTEGER GENERATED ALWAYS AS IDENTITY,
half_share_qf_ceiling NUMERIC(10, 2) NOT NULL,
single_income_ceiling_for_reduction NUMERIC(10, 2) NOT NULL,
couple_income_ceiling_for_reduction NUMERIC(10, 2) NOT NULL,
half_share_reduction_value NUMERIC(10, 2) NOT NULL,
single_discount_ceiling NUMERIC(10, 2) NOT NULL,
couple_discount_ceiling NUMERIC(10, 2) NOT NULL,
single_tax_ceiling_for_discount NUMERIC(10, 2) NOT NULL,
couple_tax_ceiling_for_discount NUMERIC(10, 2) NOT NULL,
ten_percent_allowance_max NUMERIC(10, 2) NOT NULL,
ten_percent_allowance_min NUMERIC(10, 2) NOT NULL,
PRIMARY KEY (id)
);
|
说明
- 第 7–8 行:如果数据库和用户存在,就删除它们,以便脚本可以重新运行。在 PostgreSQL 中,包含连字符的名称用引号括起来,而不是像 MySQL 那样用反引号:这是两个 DBMS 脚本之间的第一个区别;
- 第 9 行:PostgreSQL 把它的用户称为“角色”。[LOGIN] 属性授权角色 [admtaxes] 连接到 DBMS;
- 第 10 行:创建数据库 [dbtaxes-2019]。它的所有者是 [admtaxes],因而拥有对该数据库的全部权限。字符编码为 UTF-8。该数据库基于模板数据库 [template0] 创建,它支持任何字符编码;
- 第 13 行:这一行不是 SQL 命令,而是 [psql] 客户端命令 (它以反斜杠开头)。它使客户端连接到刚创建的数据库 [dbtaxes-2019] 。在 PostgreSQL 中,没有与 MySQL 的 [USE] 命令等价的命令:一个连接只作用于一个数据库;
- 第 16 行:以下命令以 [admtaxes] 的身份执行,因此它将是所创建表的所有者;
- 第 19–25 行:表 [tbbrackets]。主键 [id] 的类型为 [INTEGER GENERATED ALWAYS AS IDENTITY]:插入时由 DBMS 生成其值,就像 MySQL 的 [AUTO_INCREMENT] 属性那样。这种语法符合 SQL 标准;[AUTO_INCREMENT] 则是 MySQL 特有的。[NUMERIC] 类型等价于 MySQL 的 [DECIMAL] 类型;
- 第 28–41 行:表 [tbconstants]。列名用小写书写,各单词之间用下划线分隔(half_share_qf_ceiling)。
为什么是这些列名?PostgreSQL 的一个显著特点是列名可能区分大小写,而其他 DBMS 通常并非如此。例如,在 MySQL 中,查询 [select limits, coeffR, coeffN from tbbrackets] 即使表 [tbbrackets] 中的实际列是 [LIMITS, COEFFR, COEFFN] 也能工作。而在 PostgreSQL 中则不行,因为 PostgreSQL 会把没有用引号括起来的名称转换为小写:它实际执行的是命令 [select limits, coeffr, coeffn from tbbrackets]。为避免这种情况,必须使用 [select "LIMITS", "COEFFR", "COEFFN" from tbbrackets]——也就是把列名用引号括起来。出于这些原因,我们给列起小写的名称,并且不能沿用 MySQL 数据库中的驼峰式名称(halfShareQfCeiling)。数据库对象的名称可能成为 DBMS 之间不兼容的来源,因为某些名称在一些 DBMS 中是保留字,而在另一些中则不是。
这个脚本必须由超级用户 [postgres] 运行。在 [Laragon] 终端中,于 [version-06/Data] 文件夹下键入以下命令([-U] 选项指定用户名,[-f] 选项指定要运行的文件):
| > psql -U postgres -f postgres-dbtaxes-2019.sql
psql:postgres-dbtaxes-2019.sql:7: NOTICE: database "dbtaxes-2019" does not exist, skipping
DROP DATABASE
psql:postgres-dbtaxes-2019.sql:8: NOTICE: role "admtaxes" does not exist, skipping
DROP ROLE
CREATE ROLE
CREATE DATABASE
You are now connected to database "dbtaxes-2019" as user "postgres".
SET
CREATE TABLE
CREATE TABLE
|
- 第 2 行和第 4 行:首次执行时 [DROP ... IF EXISTS] 命令给出的警告(NOTICE):数据库和角色并不存在;
- 其他行是所执行命令的日志。
我们以 [admtaxes] 的身份登录数据库来验证结果。[-h localhost] 选项要求通过网络连接到本机,PHP 也将如此。随后 [psql] 会提示输入 [admtaxes] 的密码,除非服务器信任本地连接(见下面关于测试的一节)。[-c] 选项传入要执行的命令;[psql] 命令 [\dt] 列出数据库中的表:
| > psql -U admtaxes -h localhost -d dbtaxes-2019 -c "\dt"
List of relations
Schema | Name | Type | Owner
--------+-------------+-------+----------
public | tbbrackets | table | admtaxes
public | tbconstants | table | admtaxes
(2 rows)
|
而命令 [\d tbbrackets] 显示表 [tbbrackets] 的结构:
| > psql -U admtaxes -h localhost -d dbtaxes-2019 -c "\d tbbrackets"
Table "public.tbbrackets"
Column | Type | Collation | Nullable | Default
--------+---------------+-----------+----------+------------------------------
id | integer | | not null | generated always as identity
limits | numeric(10,2) | | not null |
coeffr | numeric(6,2) | | not null |
coeffn | numeric(10,2) | | not null |
Indexes:
"tbbrackets_pkey" PRIMARY KEY, btree (id)
|
- 第 5 行:主键 [id],由 DBMS 生成(始终作为标识列生成);
- 第 9–10 行:主键索引。
PostgreSQL 也可以通过图形界面管理。[HeidiSQL] 工具随 [Laragon] 一起提供,可以连接到 PostgreSQL 服务器(网络类型“PostgreSQL (TCP/IP”),端口 5432)。PHP 7 课程中的 [pgAdmin] 工具也可以使用([https://www.pgadmin.org/])。
14.4. 填充 [dbtaxes-2019] 数据库
我们已经在版本 5 中用 MySQL DBMS 完成了这项工作。现在只需修改描述数据库的 [database.json] 文件。[version-06/Data/database.json] 文件如下:
| {
"dsn": "pgsql:host=localhost;dbname=dbtaxes-2019",
"id": "admtaxes",
"pwd": "pwdtaxes",
"tableBrackets": "public.tbbrackets",
"colId": "id",
"colLimits": "limits",
"colCoeffR": "coeffr",
"colCoeffN": "coeffn",
"tableConstants": "public.tbconstants",
"colHalfShareQfCeiling": "half_share_qf_ceiling",
"colSingleIncomeCeilingForReduction": "single_income_ceiling_for_reduction",
"colCoupleIncomeCeilingForReduction": "couple_income_ceiling_for_reduction",
"colHalfShareReductionValue": "half_share_reduction_value",
"colSingleDiscountCeiling": "single_discount_ceiling",
"colCoupleDiscountCeiling": "couple_discount_ceiling",
"colSingleTaxCeilingForDiscount": "single_tax_ceiling_for_discount",
"colCoupleTaxCeilingForDiscount": "couple_tax_ceiling_for_discount",
"colTenPercentAllowanceMax": "ten_percent_allowance_max",
"colTenPercentAllowanceMin": "ten_percent_allowance_min"
}
|
- 第 2 行:DSN 已经改变;前缀 [pgsql] 表示我们处理的是 PostgreSQL DBMS。没有指定端口:这是 PostgreSQL 的默认端口 5432;
- 第 5 行和第 10 行:表名前加上了它们所属模式的名称 [public]。一个 PostgreSQL 数据库可以包含多个模式,模式充当表的命名空间。这并非严格必要,因为当表名中没有指定模式时,[public] 就是所使用的默认模式;
- 第 11–20 行:常量表中的列名已经改变。
用于填充 [Main/MainTransferAdminDataFromJsonFile2PostgresDatabase.php] 脚本的 [dbtaxes-2019] 数据库如下:
| <?php
// 严格遵守所声明的函数参数和结果的类型
declare(strict_types=1);
// 命名空间
namespace Application;
// 引入传输所需的版本 5 的接口和类
require_once __DIR__ . "/../../version-05/Entities/TaxException.php";
require_once __DIR__ . "/../../version-05/Entities/TaxAdminData.php";
require_once __DIR__ . "/../../version-05/Entities/Database.php";
require_once __DIR__ . "/../../version-05/Utilities/Utilities.php";
require_once __DIR__ . "/../../version-05/Dao/InterfaceDao4TransferAdminData2Database.php";
require_once __DIR__ . "/../../version-05/Dao/DaoTransferAdminDataFromJsonFile2Database.php";
// 常量的定义
const DATABASE_CONFIG_FILENAME = __DIR__ . "/../Data/database.json";
const TAXADMINDATA_FILENAME = __DIR__ . "/../Data/taxadmindata.json";
try {
// 创建 [dao] 层
$dao = new DaoTransferAdminDataFromJsonFile2Database(DATABASE_CONFIG_FILENAME, TAXADMINDATA_FILENAME);
// 将数据传输到数据库
$dao->transferAdminData2Database();
print "The data of the tax administration have been transferred into the database\n";
} catch (TaxException $ex) {
// 我们显示错误
print "Error no. {$ex->getCode()}: {$ex->getMessage()}\n";
}
// 结束
print "Done\n";
|
说明
与版本 5 的脚本相比,只有第 10–15 行(加载运行应用程序所需的文件)发生了变化:这些文件现在位于与 [version-05] 文件夹相邻的 [version-06] 文件夹中。第 18–19 行的常量指向 [version-06/Data] 文件夹中的文件。
运行该脚本时,得到如下结果:
| > php MainTransferAdminDataFromJsonFile2PostgresDatabase.php
The data of the tax administration have been transferred into the database
Done
|
以及 [tbbrackets] 表中的如下内容:
| > psql -U admtaxes -h localhost -d dbtaxes-2019 -c "select * from tbbrackets"
id | limits | coeffr | coeffn
----+-----------+--------+----------
1 | 9964.00 | 0.00 | 0.00
2 | 27519.00 | 0.14 | 1394.96
3 | 73779.00 | 0.30 | 5798.00
4 | 156244.00 | 0.41 | 13913.69
5 | 0.00 | 0.45 | 20163.45
(5 rows)
|
我们对常量表 [tbconstants] 重复同样的过程。[psql] 的 [-x] 选项以纵向方式显示每一行:
| > psql -U admtaxes -h localhost -d dbtaxes-2019 -x -c "select * from tbconstants"
-[ RECORD 1 ]-----------------------+---------
id | 1
half_share_qf_ceiling | 1551.00
single_income_ceiling_for_reduction | 21037.00
couple_income_ceiling_for_reduction | 42074.00
half_share_reduction_value | 3797.00
single_discount_ceiling | 1196.00
couple_discount_ceiling | 1970.00
single_tax_ceiling_for_discount | 1595.00
couple_tax_ceiling_for_discount | 2627.00
ten_percent_allowance_max | 12502.00
ten_percent_allowance_min | 437.00
|
这一次,[PDO::connect] 方法创建了一个 [Pdo\Pgsql] 类的对象,使用的是 PostgreSQL 驱动程序,而 [DaoTransferAdminDataFromJsonFile2Database] 类却一行代码也没有修改。请注意,运行该脚本既不需要 Apache 服务器,也不需要 MySQL DBMS:只需要启动 PostgreSQL DBMS。
14.5. 税款计算

[dao] [3] 层和 [business] [2] 层已经编写完成。我们在版本 5 中已经为 MySQL DBMS 编写了主脚本。我们只需拿来 [MainCalculateTaxWithTaxAdminDataInMySQLDatabase.php] 脚本,并将其改写以适用于 PostgreSQL DBMS。它现在叫作 [MainCalculateTaxWithTaxAdminDataInPostgresDatabase.php]:
| <?php
// 严格遵守所声明的函数参数和结果的类型
declare(strict_types=1);
// 命名空间
namespace Application;
// 引入版本 5 的接口和类
require_once __DIR__ . "/../../version-05/Entities/TaxException.php";
require_once __DIR__ . "/../../version-05/Entities/TaxAdminData.php";
require_once __DIR__ . "/../../version-05/Entities/TaxPayerData.php";
require_once __DIR__ . "/../../version-05/Entities/Database.php";
require_once __DIR__ . "/../../version-05/Utilities/Utilities.php";
require_once __DIR__ . "/../../version-05/Dao/InterfaceDao.php";
require_once __DIR__ . "/../../version-05/Dao/TraitDao.php";
require_once __DIR__ . "/../../version-05/Dao/DaoTaxWithTaxAdminDataInDatabase.php";
require_once __DIR__ . "/../../version-05/Business/InterfaceBusiness.php";
require_once __DIR__ . "/../../version-05/Business/Business.php";
// 常量的定义
const DATABASE_CONFIG_FILENAME = __DIR__ . "/../Data/database.json";
const TAXPAYERSDATA_FILENAME = __DIR__ . "/../Data/taxpayersdata.json";
const RESULTS_FILENAME = __DIR__ . "/../Data/results.json";
const ERRORS_FILENAME = __DIR__ . "/../Data/errors.json";
try {
// 创建 [dao] 层
$dao = new DaoTaxWithTaxAdminDataInDatabase(DATABASE_CONFIG_FILENAME);
// 创建 [business] 层
$business = new Business($dao);
// 批处理模式下的税款计算
$business->executeBatchTaxes(TAXPAYERSDATA_FILENAME, RESULTS_FILENAME, ERRORS_FILENAME);
print "The results have been saved in the file [results.json]\n";
} catch (TaxException $ex) {
// 我们显示错误
print "Error no. {$ex->getCode()}: {$ex->getMessage()}\n";
}
// 结束
print "Done\n";
|
说明
同样,只有第 10–19 行(加载版本 5 的文件)发生了变化。所使用的 JSON 文件来自 [version-06/Data] 文件夹,特别是描述 PostgreSQL 数据库的 [database.json] 文件。
执行结果
| > php MainCalculateTaxWithTaxAdminDataInPostgresDatabase.php
The results have been saved in the file [results.json]
Done
|
文件 [errors.json] 和 [results.json] 是在 [version-06/Data] 文件夹中生成的,与版本 5 中使用 MySQL 数据库得到的文件完全相同。
14.6. [PHPUnit] 测试
与之前的版本一样,我们使用 [PHPUnit] 测试来验证这个版本。[version-06/Tests] 文件夹中的测试类 [DaoTest] 和 [BusinessTest] 与版本 5 中的相同。唯一的变化是测试环境:应用程序文件从 [version-05] 文件夹加载,数据来自 [version-06/Data] 文件夹。
14.6.1. 对 [dao] 层的测试
[Tests/DaoTest.php] 测试的开头部分如下:
| <?php
// 严格遵守所声明的函数参数和结果的类型
declare(strict_types=1);
// 测试的命名空间
namespace Application\Tests;
// 被测试的类
use Application\DaoTaxWithTaxAdminDataInDatabase;
use Application\DaoTransferAdminDataFromJsonFile2Database;
use Application\TaxException;
use Application\InterfaceDao;
use Application\TaxAdminData;
use Application\TaxPayerData;
// PHPUnit 的类
use PHPUnit\Framework\Attributes\DataProvider;
use PHPUnit\Framework\TestCase;
// 加载版本 5 的 [dao] 层的类
require_once __DIR__ . "/../../version-05/Entities/TaxException.php";
require_once __DIR__ . "/../../version-05/Entities/TaxAdminData.php";
require_once __DIR__ . "/../../version-05/Entities/TaxPayerData.php";
require_once __DIR__ . "/../../version-05/Entities/Database.php";
require_once __DIR__ . "/../../version-05/Utilities/Utilities.php";
require_once __DIR__ . "/../../version-05/Dao/InterfaceDao.php";
require_once __DIR__ . "/../../version-05/Dao/TraitDao.php";
require_once __DIR__ . "/../../version-05/Dao/DaoTaxWithTaxAdminDataInDatabase.php";
require_once __DIR__ . "/../../version-05/Dao/InterfaceDao4TransferAdminData2Database.php";
require_once __DIR__ . "/../../version-05/Dao/DaoTransferAdminDataFromJsonFile2Database.php";
final class DaoTest extends TestCase
{
// 版本 6 的数据文件夹
private const string DATA = __DIR__ . "/../Data";
// 被测试的 [dao] 层
private InterfaceDao $dao;
// 用于错误的临时文件
private string $errorsFilename;
|
说明
- 第 21–30 行:定义测试环境:加载版本 5 中 [dao] 层的类;
- 第 35 行:测试数据来自版本 6,具体来说是 PostgreSQL 数据库的 [database.json] 文件。
测试方法与版本 5 中的相同,只有一个例外。文件 [database-incomplete.json] (位于文件夹 [Tests/data] 中)是版本 5 的文件针对 PostgreSQL 数据库改写后的版本。不过,版本 5 的“密码不正确”测试用例已被“用户不存在”测试用例取代:
| // 不正确的数据库描述
public static function invalidDatabases(): array
{
// [文件名, 预期的错误代码]
return [
"non-existent file" => ["nonexistent.json", 15],
"missing key" => ["database-incomplete.json", 21],
// 对于 PostgreSQL,我们测试不存在的用户而不是错误的密码:
// 如果服务器信任本地连接([trust] 方式),它不会检查
// 密码,但始终会拒绝它不认识的用户
"non-existent user" => ["database-nonexistent-user.json", 30],
];
}
|
- 第 102 行:文件 [database-nonexistent-user.json] 描述的数据库带有名为 [unknown] 的用户,PostgreSQL 并不认识该用户。连接失败,[dao] 层触发代码为 30 的 [TaxException] 。
为什么做这个改变?对于每种连接类型,PostgreSQL 服务器都会选择其配置文件 [pg_hba.conf] 中指定的身份验证方法(该文件位于 PostgreSQL 数据文件夹中,[<laragon>/data/postgresql-NN] 使用 [Laragon] 时)。[scram-sha-256] 方法会验证密码。而 [trust] 方法则信任客户端:只要用户存在,它就接受连接而不验证密码。这正是 [Laragon] 所创建的 PostgreSQL 安装对来自本机的连接所使用的方法,这也解释了为什么超级用户 [postgres] 没有密码。在这种配置下,不正确的密码也会被接受:“密码不正确”测试会失败,因为预期的异常并没有被抛出。相反,不存在的用户无论采用哪种身份验证方法都会被拒绝访问:这个测试在所有安装上都能工作。[trust] 方法在开发机上很方便;显然不应在生产服务器上使用。
14.6.2. 测试 [business] 层
同样,[Tests/BusinessTest.php] 测试是版本 5 的测试,只是环境有所修改:
| // 加载版本 5 的 [dao] 层和 [business] 层的类
require_once __DIR__ . "/../../version-05/Entities/TaxException.php";
require_once __DIR__ . "/../../version-05/Entities/TaxAdminData.php";
require_once __DIR__ . "/../../version-05/Entities/TaxPayerData.php";
require_once __DIR__ . "/../../version-05/Entities/Database.php";
require_once __DIR__ . "/../../version-05/Utilities/Utilities.php";
require_once __DIR__ . "/../../version-05/Dao/InterfaceDao.php";
require_once __DIR__ . "/../../version-05/Dao/TraitDao.php";
require_once __DIR__ . "/../../version-05/Dao/DaoTaxWithTaxAdminDataInDatabase.php";
require_once __DIR__ . "/../../version-05/Business/InterfaceBusiness.php";
require_once __DIR__ . "/../../version-05/Business/Business.php";
final class BusinessTest extends TestCase
{
// 版本 6 的数据文件夹
private const string DATA = __DIR__ . "/../Data";
// 被测试的 [business] 层
private InterfaceBusiness $business;
// 在每个测试之前执行
#[\Override]
protected function setUp(): void
{
// 创建 [dao] 层
$dao = new DaoTaxWithTaxAdminDataInDatabase(self::DATA . "/database.json");
// 创建 [business] 层
$this->business = new Business($dao);
}
|
14.6.3. 运行测试
必须启动 PostgreSQL DBMS。测试结果如下:
| > php vendor/bin/phpunit scripts-console/tax/version-06/Tests --testdox
PHPUnit 12.5.37 by Sebastian Bergmann and contributors.
Runtime: PHP 8.5.11
Configuration: /home/claude/php8/php8-oct-2026/phpunit.xml
.................. 18 / 18 (100%)
Time: 00:00.558, Memory: 16.00 MB
Business (Application\Tests\Business)
✔ Calculate tax with data set "couple, 2 children, 55555"
✔ Calculate tax with data set "couple, 2 children, 50000"
✔ Calculate tax with data set "couple, 3 children, 50000"
✔ Calculate tax with data set "single, 2 children, 100000"
✔ Calculate tax with data set "single, 3 children, 100000"
✔ Calculate tax with data set "couple, 3 children, 100000"
✔ Calculate tax with data set "couple, 5 children, 100000"
✔ Calculate tax with data set "single, 0 children, 100000"
✔ Calculate tax with data set "couple, 2 children, 30000"
✔ Calculate tax with data set "single, 0 children, 200000"
✔ Calculate tax with data set "couple, 3 children, 200000"
Dao (Application\Tests\Dao)
✔ Tax admin data
✔ Transfer
✔ Invalid databases with data set "non-existent file"
✔ Invalid databases with data set "missing key"
✔ Invalid databases with data set "non-existent user"
✔ Tax payers data
✔ Non existent tax payers data
OK (18 tests, 49 assertions)
|
全部 18 个测试都通过了,使用的是 PostgreSQL 数据库而不是 MySQL 数据库。本章开头所下的赌注得到了回报:从 MySQL 过渡到 PostgreSQL 不需要对应用程序的类做任何修改,只需要在 [database.json] 文件中提供新的数据库描述。不过必须承认,我们不得不调整列名以及用于创建数据库的 SQL 脚本代码,而且我们的 SQL 命令一直非常简单([select]、[insert]、[delete])。