1. 引言
本文档的 PDF 版本在这里。
本文档的代码在这里。
本文档由 Anthropic 的 Claude 制作。它是针对 PHP 8 语言对 Serge Tahé 于 2019 年 7 月撰写的课程《通过示例入门 PHP 7 语言》的改写。它保留了原有的大纲、示例和主线,只更换了语言:
- 2019 年的课程使用 PHP 7.3。此后,PHP 经历了六个主要版本:8.0(2020)、8.1(2021)、8.2(2022)、8.3(2023)、8.4(2024)和 8.5(2025)。本文档使用 PHP 8.5;
- 在这两个版本之间,PHP 发生了显著变化:引入了许多特性(类型、枚举、只读类、[match]、命名参数……),也有许多特性被弃用:它们仍然可以工作,但每次使用时 PHP 都会显示一条警告消息,提醒用户这些特性将在未来的版本中被移除。本文档中的代码不使用任何已弃用的特性:所有脚本都是在配置为显示所有错误、警告和弃用提示的 PHP 8.5 下运行的,其结果中没有出现任何[Deprecated] 消息;
- 工具也发生了变化:[VS Code] 编辑器取代了 [NetBeans] IDE;[PHPUnit] 测试框架取代了 [Codeception];[curl] 命令取代了 [Postman] 工具;[Symfony Mailer] 库取代了已被弃用的 [SwiftMailer];[Mailpit] 邮件服务器取代了同样已被弃用的 [hMailServer]。
本文档提供了一系列涉及不同领域(语言结构、类、文件访问、数据库和 Internet)的 PHP 控制台脚本。Web 编程通过 Web 服务来讲解。在本文档中,Web 服务指任何生成数据(纯文本、JSON、XML)而不是 HTML 页面的 Web 应用程序。它们是数据服务器,而不是网页服务器(网页是 HTML、CSS 和 JavaScript 的组合)。内容涵盖经典的 Web 概念(HTTP 协议、JSON 或 XML 响应、会话管理和身份验证),这些概念同样用于传统的 Web 编程。文档的最后一部分还会构建一个 HTML Web 应用程序。
1.1. PHP 在客户端/服务器应用程序中的角色
如今,以客户端/服务器模式构建 Web 应用程序十分常见:

- 在 [1] 中,Web 浏览器为用户显示网页。这些页面包含 JavaScript,它实现了 [2] 数据 Web 服务的客户端,以及 [3] 网页片段服务器的客户端。[Vue.js]、[React]、或 [Angular] 等 JavaScript 框架正是为此而设计的;
- 在 [2] 中,Web 服务器是一个数据服务器。它可以用任何语言编写,例如 PHP。除了可能的第一次之外,它不会生成传统意义上的网页(HTML、CSS、JavaScript)。不过,这第一个页面可以从传统的 Web 服务器获得([3])。初始页面的 JavaScript 随后会通过从数据服务器 [4] 获取要显示的数据,生成应用程序的各个网页 [2]。它还可以从网页服务器获取用于格式化这些数据的网页片段([5])([3]);
- 在 [4] 中,用户发起一个操作;
- 在 [6, 7] 中,用户收到以网页片段格式化的数据。
在本文档中,我们将用 PHP 编写具有如下结构的客户端/服务器应用程序:

这里是一个完全用 PHP 编写的客户端/服务器应用程序。一个 [9] 控制台脚本将查询一个 [4] 数据服务器。你在这里学到的编写数据服务的知识可以在 Web 应用程序中复用:可以保留 PHP 的数据服务,而把 PHP 客户端替换为 JavaScript 客户端。
作为本文档的主线,我们将分 13 个版本构建一个所得税计算服务。第 12 版将具有如下架构:

服务器的 [web] 层将采用 MVC 架构(模型–视图–控制器),能够以 JSON、XML 或 HTML 响应。整个课程的目标就是构建这个版本,而第 13 版则为其提供安全保护。
1.2. PHP 7 与 PHP 8 之间的变化
PHP 8 的新特性会在各章中按需逐步引入,并始终与 PHP 7 课程中的做法进行比较。以下是主要的新特性及其所在章节:
新特性 | 版本 | 章节 |
严格类型([declare(strict_types=1)])、参数类型与返回类型([mixed])、联合类型([int|float])、可空类型([?string]) | 7.0 至 8.0 | PHP 基础 |
表达式 [match]、空安全运算符 [?->]、命名参数 | 8.0 | PHP 基础 |
[str_contains]、[str_starts_with]、[str_ends_with]、[array_is_list]、[json_validate]、[array_find]、[array_any]、[array_all]、[array_first]、[array_last] | 8.0 至 8.5 | PHP 基础 |
[fn] 箭头函数、[f(...)] 一等可调用对象、[|>] 管道运算符 | 7.4 至 8.5 | PHP 基础 |
类型化属性、构造函数参数提升 | 7.4, 8.0 | 类 |
只读属性与只读类 [readonly] | 8.1, 8.2 | 类 |
枚举 [enum] | 8.1 | 类 |
属性钩子与非对称可见性 [public private(set)] | 8.4 | 类 |
[clone] 同时修改属性,[#[\Override]] | 8.5, 8.3 | 类 |
交集类型 [A&B] 以及默认值中的 [new] | 8.1 | 接口 |
已变为异常的错误([TypeError]、[ValueError]、[DivisionByZeroError]……)、[throw] 表达式、[catch] 不带变量 | 8.0 | 异常与错误 |
trait 中的常量 | 8.2 | trait |
[PDO::connect()] 以及子类 [Pdo\Mysql]、[Pdo\Pgsql] | 8.4 | MySQL |
属性(注解)[#[\SensitiveParameter]] | 8.2 | 应用练习,第 5 版及之后 |
新的 API [Dom\XMLDocument] | 8.4 | XML 文档处理 |
反过来,以下是 PHP 7 课程所使用、而现在已被弃用或移除的主要特性,以及本文档中的替代方案:
PHP 7 课程中的特性 | 状态 | 替代方案 |
动态属性(通过简单赋值 [$object->x = 1]创建) | 8.2 中弃用 | 已声明的属性,或类 [stdClass] |
插值 ["${var}"] | 8.2 中弃用 | ["$var"] 或 ["{$var}"] |
[utf8_encode]、[utf8_decode] | 8.2 中弃用 | [mb_convert_encoding] |
隐式可空参数 [Type $x = null] | 8.4 中弃用 | [?Type $x = null] |
类型转换 [(integer)]、[(boolean)]、[(double)] | 8.5 中弃用 | [(int)]、[(bool)]、[(float)] |
常量 [PDO::MYSQL_ATTR_*] | 8.5 中弃用 | [Pdo\Mysql::ATTR_*] |
函数 [imap_*] | 8.4 中从 PHP 核心中移除 | 使用套接字编写的 POP3 / IMAP 客户端 |
[SwiftMailer] 库 | 已停止维护 | [Symfony Mailer] |
[php-mime-mail-parser] 库 | 需要一个未提供的扩展 | [zbateson/mail-mime-parser] |
[Codeception] | 已被取代 | [PHPUnit] 12 |
Apache 2.2 语法 [deny from all] | 已过时 | [Require all denied] (Apache 2.4) |
1.3. 所用工具
示例是使用以下工具编写和测试的(其安装将在下一章介绍):
- [PHP] 8.5,配置为报告所有错误、警告和弃用提示;
- [Laragon] 8 软件包,它集成了 [Windows] 版的 PHP 8.5、[Apache] 2.4 Web 服务器、[MySQL] 8.4 数据库管理系统、[Redis] 服务器以及 [Composer] 依赖管理器;只需点几下鼠标,还可以加入 [PostgreSQL] 数据库管理系统;
- [Visual Studio Code] 编辑器(VS Code)及其扩展 [PHP Intelephense];
- 使用 [Composer] 安装的 PHP 库:[symfony/http-foundation]、[symfony/http-client]、[symfony/mailer]、[symfony/mime] 8、[predis/predis] 3、[zbateson/mail-mime-parser] 3,以及用于测试的 [phpunit/phpunit] 12;
- 测试邮件服务器 [Mailpit] ,以及针对 IMAP 协议的 IMAP 服务器([Gmail] 账户或本地服务器);
- 命令行工具 [curl],随 [Windows] 提供,用于显示原始的 HTTP 交换;
- 浏览器([Chrome]、[Firefox]、[Edge]……)。
本文档中的脚本都带有注释,并且复现了它们的控制台输出,有时还提供补充说明。阅读本文档需要主动思考:要理解一个脚本,必须阅读它的代码、注释和执行结果。网页截图是使用程序控制的浏览器拍摄的:它们是课程应用程序的真实页面。
1.4. 示例
本文档中的代码存放在一个名为 [php8-oct-2026] 的文件夹中:
文件夹 [php8-oct-2026] 必须放在 [www] 文件夹内,该文件夹位于 [Laragon] 的目录下(例如 [C:\laragon\www\php8-oct-2026]):这是 [Apache] Web 服务器的根目录。这样,Web 脚本就可以通过如下形式的 URL 访问:[http://localhost/php8-oct-2026/scripts-web/...]。
1.5. 文档内容
章节 | 内容 |
安装 | Laragon、PHP 8.5、VS Code、Composer |
PHP 基础 | 变量、类型、严格类型、数组、字符串、函数、文本文件、JSON |
实践练习,第 1 版和第 2 版 | 使用函数计算税额 |
类与接口 | 类、继承、类型化属性、[readonly]、枚举、属性钩子、接口 |
异常与错误 | PHP 8 的 [Throwable] 层次结构,自定义异常 |
应用练习,第 3 版 | 使用类计算税额 |
trait 与分层应用程序 | 代码复用,[dao] / [business] / [console] 架构 |
实践练习,第 4 版 | 分层的税额计算,[PHPUnit] 测试 |
使用 MySQL 数据库管理系统 | PDO、预处理 SQL 语句、事务 |
实践练习,第 5 版至第 7 版 | 数据库中的税务数据:先是 MySQL,然后是 PostgreSQL,再然后是二者任选其一 |
网络函数 | TCP、HTTP、SMTP、POP3、IMAP |
Web 服务 | 静态页面与动态页面、JSON、设置、会话、身份验证、HTTPS |
实践练习,第 8 版至第 10 版 | 税额计算服务器及其客户端、日志记录、发送电子邮件、[Redis] 缓存 |
XML 文档处理 | SimpleXML、PHP 8.4 的 DOM API |
应用练习,第 11 版 | 税额计算服务器以 XML 响应 |
实践练习,第 12 版 | 一个以 JSON、XML 或 HTML 响应的 MVC 服务器;一个 Web 应用程序;JSON 服务的客户端 |
实践练习,第 13 版 | 保护对应用程序文件的访问 |
这些都是面向 PHP 初学者的章节。不过,假定读者已经用某种语言编过程序,并且知道什么是变量、循环和函数。