Skip to content

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 应用程序十分常见:

Image

  • 在 [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 编写具有如下结构的客户端/服务器应用程序:

Image

这里是一个完全用 PHP 编写的客户端/服务器应用程序。一个 [9] 控制台脚本将查询一个 [4] 数据服务器。你在这里学到的编写数据服务的知识可以在 Web 应用程序中复用:可以保留 PHP 的数据服务,而把 PHP 客户端替换为 JavaScript 客户端。

作为本文档的主线,我们将分 13 个版本构建一个所得税计算服务。第 12 版将具有如下架构:

Image

服务器的 [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/
├── composer.json        the libraries used by the course
├── phpunit.xml          the PHPUnit test configuration
├── vendor/              the libraries, installed by Composer (to be created, see next chapter)
├── scripts-console/     the scripts run in a terminal
│   ├── basics/          the basics of the language
│   ├── json/            JSON encoding / decoding
│   ├── classes/         classes
│   ├── interfaces/      interfaces
│   ├── exceptions/      exceptions and errors
│   ├── traits/          traits
│   ├── three-layers/    a layered application
│   ├── mysql/           using the MySQL DBMS
│   ├── inet/            network functions (TCP, HTTP, SMTP, POP3, IMAP)
│   ├── web-clients/     the web service clients
│   ├── xml/             processing XML documents
│   └── tax/             the tax calculation, versions 1 to 12 (the console versions and the clients)
└── scripts-web/         the scripts run by the Apache server
    ├── 01/ … 08/        the web services
    └── tax/             the tax calculation servers, versions 8 to 13

文件夹 [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 初学者的章节。不过,假定读者已经用某种语言编过程序,并且知道什么是变量、循环和函数。