Skip to content

10. 分层应用程序

10.1. 简介

本章的脚本位于 [scripts-console/three-layers] 文件夹中:

1
2
3
4
5
6
7
8
9
php8-oct-2026/scripts-console/three-layers
├── Business.php
├── Dao1.php
├── Dao2.php
├── IBusiness.php
├── IDao.php
├── main1.php
├── main2.php
└── Person.php

现在我们来探讨如何把 PHP 应用程序组织成分层结构:

Image

在这个示意图中,左侧的层发起对右侧层的使用。各层的作用如下:

  • [1]:名为 [dao] (Data Access Objects,数据访问对象)的层负责与外部数据存储 [4](文件、数据库、Web 服务等)的交互。这一层有时被称为 [DAL] (Data Access Layer,数据访问层),这个术语更好地描述了它的作用。这一层可以从 [3] 读取数据或向 [2] 写入数据。它由 [business] 层 [6] 调用,并向其返回结果 [7];
  • [5]:名为 [business] 的层,汇集“业务”过程,并被提供它们所需的全部数据。这通常是项目中最稳定的层,因为它不依赖于数据的获取方式。数据来自两个来源:
    • [9]:由 PHP 脚本提供的数据;
    • [6, 7]:向 [dao] 层请求的数据;
  • [8]:主脚本充当编排者。在控制台应用程序中,它将:
    • 创建 [business] 和 [dao] 层;
    • 执行应用程序的算法。该算法起着编排者的作用:它不包含“业务逻辑”或数据访问代码。主脚本只是调用 [business] 层 [9]的过程。它完全不知道 [dao] 层和外部数据。它可以向 [business] 层提供 [9] 数据。在控制台应用程序中,这些数据可以来自配置文件或脚本的使用者。它从 [business] 层接收结果 [10]。它可能需要存储某些结果:为此,它再次使用 [business] 层的过程,而该层又会调用 [dao] 层来完成这项任务;
    • 在这些结果中,主脚本可能会收到异常。处理从所有层向上传播的异常是主脚本的职责。

这种分层架构旨在便于应用程序的演进。为此,每一层都实现一个接口。假设:

  • [dao] 层由类 [Dao], 实现,该类实现接口 [IDao];
  • [business] 层由类 [Business] 实现,该类实现接口 [IBusiness]。

于是 [business] 层的过程将使用接口 [IDao] 而不是类 [Dao]。这样就可以更新 [dao] 层而不影响 [business] 层。假设在版本 1 中,[Dao1] 层使用来自数据库的数据。更新之后,在版本 2 [Dao2] 中,这些数据改由 Web 服务提供。我们将确保两个类 [Dao1] 和 [Dao2], 实现同一个接口 [IDao], 并且抛出相同的异常。如果这一点得到验证,[Business] 层(它基于 [IDao] 接口工作)将保持不变。

同样的推理也适用于 [business] 层。

应用程序将实现如下的分层结构:

Image

10.2. 层与层之间交换的对象

通常,各层之间交换各种对象。这里,它们将交换如下 [Person] 类的对象:[Person.php]:

<?php

declare(strict_types=1);

// 一个人:不可变对象
final readonly class Person
{
    // 带 [id] 属性提升的构造函数
    public function __construct(public int $id)
    {
    }

    // toString
    public function __toString(): string
    {
        return "[Person($this->id)]";
    }
}

说明

  • 第 6 行:层与层之间交换的对象只包含数据。它们被做成不可变对象([readonly] 类):这可以防止某一层无意中修改从另一层收到的对象;
  • 第 9 行:这个人只有一个属性,即其标识符 [$id],由构造函数通过参数提升初始化。我们假定这个标识符指的是数据仓库中的唯一一个人;
  • 第 14–17 行:方法 [__toString], 用于显示这个人的标识符。

10.3. [dao] 层

由 [dao] 层实现的 [IDao] 接口如下:[IDao.php]:

<?php

declare(strict_types=1);

// [dao] 层
interface IDao
{
    // 从外部仓库获取一个人
    // 传入此人的标识符
    public function get(int $id): Person;

    // 将一个人保存到外部仓库
    public function save(Person $p): void;
}

该接口由下面的 [Dao1] 类实现:[Dao1.php]:

<?php

declare(strict_types=1);

final class Dao1 implements IDao
{
    // 将一个人保存到外部仓库
    #[\Override]
    public function save(Person $p): void
    {
        print "[Dao1]: Saving the person $p in the [local] database\n";
    }

    // 从外部仓库获取一个人
    #[\Override]
    public function get(int $id): Person
    {
        print "[Dao1]: Retrieving the person with identity ($id) from the [local] database\n";
        return new Person($id);
    }
}

说明

  • 第 5 行:类 [Dao1] 实现接口 [IDao]。它被声明为 [final]:不打算被继承;
  • 该类不与数据仓库交互。它只是显示一些消息来跟踪代码的执行(第 11 行、第 18 行);
  • 第 8 行:属性 [#[\Override]] 表明该方法实现了接口的方法。如果方法名不正确,PHP 会发出提示;
  • 第 19 行:我们确实返回了一个标识符为传给该方法的参数的人。

我们还用下面的 [IDao] 类 [Dao2] 来实现该接口,[Dao2.php]:

<?php

declare(strict_types=1);

final class Dao2 implements IDao
{
    // 将一个人保存到外部仓库
    #[\Override]
    public function save(Person $p): void
    {
        print "[Dao2]: Saving the person $p in the [remote] database\n";
    }

    // 从外部仓库获取一个人
    #[\Override]
    public function get(int $id): Person
    {
        print "[Dao2]: Retrieving the person with identity ($id) from the [remote] database\n";
        return new Person($id);
    }
}

[Dao2] 类与 [Dao1] 类类似,只是我们修改了所显示的消息。

10.4. [business] 层

[business] 层提供如下 [IBusiness] 接口:[IBusiness.php]:

<?php

declare(strict_types=1);

// [business] 层
interface IBusiness extends IDao
{
    // 我们处理一个人
    public function doSomething(Person $p): void;
}

说明

  • 第 6 行:[IBusiness] 接口扩展了 [IDao] 接口。这完全不是必需的。我们在这里这样做,是因为示例很简单:[business] 层向主脚本提供 [get] 和 [save] 方法,它们来自 [dao] 层,而该层本身对主脚本是隐藏的;
  • 第 9 行:方法 [doSomething] 是 [business] 层特有的。

PHP 7 课程使用的是接口 [IMétier] 和类 [Métier],带有重音符号。PHP 允许标识符中出现带重音的字母,但名为 [Métier.php] 的文件会在某些工具(ZIP 压缩包、文件系统、类的自动加载)中引起问题。我们现在坚持使用不带重音的类名和文件名:这里是 [IBusiness] 和 [Business]。

[IBusiness] 接口由下面的类实现:[Business] [Business.php]:

<?php

declare(strict_types=1);

final class Business implements IBusiness
{
    // [dao] 层由构造函数注入
    public function __construct(private readonly IDao $dao)
    {
    }

    // 我们处理一个人
    #[\Override]
    public function doSomething(Person $p): void
    {
        // 处理
        print "[Business]: Business processing of the person $p\n";
    }

    // 保存此人
    #[\Override]
    public function save(Person $p): void
    {
        print "[Business]: Saving the person $p\n";
        // 我们请求 [dao] 层执行保存
        $this->dao->save($p);
    }

    // 获取一个人
    #[\Override]
    public function get(int $id): Person
    {
        print "[Business]: Retrieving the person with identifier $id\n";
        // 我们向 [dao] 层请求此人
        return $this->dao->get($id);
    }
}

说明

  • 第 8 行:[business] 层必须持有对 [dao] 层的引用,才能使用后者的方法。这个引用通过构造函数传给它,并保存在私有只读属性 [$dao] 中(参数提升)。请注意,参数的类型是 [IDao] 接口。因此,[business] 层能够与任何实现了 [IDao] 接口的类协同工作。如果我们从 [Dao1] 层切换到 [Dao2] 层,并且两者都实现了 [IDao] 接口,那么 [business] 层就无需重写;
  • 这种技术称为基于构造函数的 依赖注入:类 [Business] 并不创建它所依赖的 [dao] 层,而是由外部提供给它。PHP 7 课程使用的是 setter [setDao]。构造函数注入现在是标准做法:[Business] 对象没有其 [dao] 层就无法存在,并且这个层事后也无法更改([readonly] 属性)。Symfony 或 Laravel 等框架也采用这种做法;
  • 第 14–18 行:[IBusiness::doSomething] 的实现;
  • 第 22–27 行:[IBusiness::save] 的实现。该方法必须把一个人保存到数据仓库中。[business] 层无法做到这一点,它调用 [dao] 层来执行这次保存(第 26 行);
  • 第 31–36 行:[IBusiness::get] 的实现。该方法必须从数据仓库中取出标识符作为参数传给它的那个人。[business] 层无法做到这一点,它调用 [dao] 层来完成这项任务(第 35 行)。

结论:每当 [business] 层需要访问存储在数据仓库中的数据时,它都必须经过 [dao] 层,而该层正是专为访问这些数据而创建的。

10.5. 主脚本

我们将为该应用程序编写两个编排脚本。第一个 [main1.php], 使用 [Dao1] 层,而第二个 [main2.php], 使用 [Dao2] 层。我们想表明,这对 [Business] 层的代码没有任何影响。

[main1.php] 脚本如下:

<?php

// 严格遵守所声明的函数参数和结果的类型
declare(strict_types=1);

// 引入这些类和接口
require_once __DIR__ . "/Person.php";
require_once __DIR__ . "/IDao.php";
require_once __DIR__ . "/IBusiness.php";
require_once __DIR__ . "/Dao1.php";
require_once __DIR__ . "/Business.php";

// 创建各层:[dao] 层被注入到 [business] 层中
$business = new Business(new Dao1());
// 使用 [business] 层
$person = $business->get(4);
$business->doSomething($person);
$business->save($person);

说明

  • [main1.php] 脚本充当应用程序的编排者。它加载类文件和接口文件(第 7–11 行),创建应用程序的分层结构(第 14 行),然后与 [business] 层通信(第 16–18 行);
  • 第 14 行:正是在这里,也只有在这里,才选定 [dao] 层的实现;
  • 根据分层结构图,[main1.php] 脚本只能与 [business] 层通信。它不得与 [dao] 层通信,尽管这在理论上是可能的。

执行结果如下:

1
2
3
4
5
6
> php main1.php
[Business]: Retrieving the person with identifier 4
[Dao1]: Retrieving the person with identity (4) from the [local] database
[Business]: Business processing of the person [Person(4)]
[Business]: Saving the person [Person(4)]
[Dao1]: Saving the person [Person(4)] in the [local] database

说明

  • 代码的第 16 行导致写出了结果的第 2 行和第 3 行;
  • 代码的第 17 行导致写出了结果的第 4 行;
  • 代码的第 18 行导致写出了结果的第 5 行和第 6 行。

脚本 [main2.php] 如下:

<?php

// 严格遵守所声明的函数参数和结果的类型
declare(strict_types=1);

// 引入这些类和接口
require_once __DIR__ . "/Person.php";
require_once __DIR__ . "/IDao.php";
require_once __DIR__ . "/IBusiness.php";
require_once __DIR__ . "/Dao2.php";
require_once __DIR__ . "/Business.php";

// 创建各层:[dao] 层被注入到 [business] 层中
$business = new Business(new Dao2());
// 使用 [business] 层
$person = $business->get(4);
$business->doSomething($person);
$business->save($person);

说明

  • 第 10 行和第 14 行:层结构现在使用 [Dao2] 层。这些是与 [main1.php] 仅有的区别。

执行结果如下:

1
2
3
4
5
6
> php main2.php
[Business]: Retrieving the person with identifier 4
[Dao2]: Retrieving the person with identity (4) from the [remote] database
[Business]: Business processing of the person [Person(4)]
[Business]: Saving the person [Person(4)]
[Dao2]: Saving the person [Person(4)] in the [remote] database

[Dao1] 层模拟对本地数据库的访问,而 [Dao2] 层模拟对远程数据库的访问。只要这两个层都符合 [IDao] 接口,我们就能看到 [Business] 层的代码无需更改。

我们将把刚学到的内容应用于作为我们指导性示例的税款计算练习。