2. 搭建开发环境
脚本是在以下环境中编写和测试的:
- 一个由 [Apache] / [MySQL] 数据库管理系统 / [PHP] 8.5 组成的 Web 服务器环境,名为 [Laragon];
- [Visual Studio Code] 编辑器及其扩展 [PHP Intelephense];
- 依赖管理器 [Composer],随 [Laragon] 提供,用于安装本课程所使用的 PHP 库。
其他工具(邮件服务器 [Mailpit]、[PostgreSQL] 数据库管理系统以及 [Redis] 服务器)只与某些章节相关:它们的安装在相应章节中介绍。
2.1. 安装 Laragon
[Laragon] 是一个适用于 [Windows] 的软件包,集成了多个软件组件:
- 一个 Web 服务器([Apache])。我们将用它编写 PHP 的 Web 脚本;
- [MySQL] 数据库管理系统(还可以加入 [PostgreSQL] ,参见关于第 6 版的章节);
- PHP 脚本语言,含多个版本,其中包括 8.5 版;
- 一个 [Redis] 服务器,用于为 Web 应用程序实现缓存;
- [Composer] 工具;
- 一个命令行终端,可在其中直接使用所有这些工具。
[Laragon] 可从 https://laragon.org/download/ 下载。它可以免费使用全部功能;偶尔会弹出提示,请你购买许可证以支持其开发,这是可选的。安装很简单:只需接受默认设置。[Laragon] 随后会安装在 [C:\laragon] 文件夹中,今后我们将把它称为 <laragon>:
启动 [Laragon] 会显示其主窗口:
- [Démarrer tout] (全部启动)按钮会启动 [Apache] Web 服务器以及 [MySQL] 数据库管理系统。随后窗口会针对它们各自指示其已处于活动状态,以及监听的端口:[Apache] 为 80,[MySQL] 为 3306;
- [Web] 按钮会显示 [http://localhost] 页面,它对应 [<laragon>/www] 文件夹;
- [Base de données] (数据库)按钮会启动一个数据库管理工具([HeidiSQL],随 [Laragon] 一起提供);
- [Terminal] 按钮会打开一个命令终端,可在其中直接使用 [php]、[composer]、[mysql]……;
- [Racine] (根目录)按钮会在 [Windows] 文件资源管理器中打开 [<laragon>/www] 文件夹。所有由 [Apache] 服务器(来自 [Laragon])管理的 Web 应用程序都应放在这里;
- 在窗口中(或任务栏中的 [Laragon] 图标上)单击鼠标右键,会打开 [Laragon] 菜单,通过它可以访问各个应用程序的配置设置。
2.1.1. 选择 PHP 8.5
[Laragon] 可以包含多个版本的 PHP。要使用的版本在其菜单的 [PHP > Version] 项下选择。选择 8.5 版(8.5 系列中最新的版本)。随后 [Apache] 服务器和 [php] 终端命令都将使用它。
要使 [php] 命令在 [VS Code] 终端中同样可用,PHP 文件夹必须位于 [Windows] 的 PATH 路径中。[Laragon] 可以完成这件事:[Tools > Path > Add Laragon to Path] 菜单。然后打开一个新的终端(已经打开的终端看不到这一更改)并输入:
该命令应显示 PHP 的版本,即 8.5.x。
2.1.2. 为学习配置 PHP
PHP 通过一个名为 [php.ini] 的文本文件进行配置,可通过 [Laragon] 菜单中的 [PHP > php.ini] 项访问。在学习期间,PHP 必须报告所有错误、警告和弃用提示。请检查该文件是否包含以下几行(或进行修改):
- [error_reporting = E_ALL]:PHP 报告一切信息,包括宣告特性已被弃用的 [Deprecated] 消息。生产环境的配置通常使用 [E_ALL & ~E_DEPRECATED],它会隐藏这些消息:这不是我们在这里想要的;
- [display_errors = On]:消息会显示在脚本的输出中(终端或网页);
- [log_errors = On]:消息也会写入错误日志;
- [error_log]:日志文件。如果没有这一行,控制台脚本会把日志写到终端本身,每条消息就会在那里出现两次(一次带有 [PHP] 前缀,一次没有);
- [date.timezone]:日期函数所使用的时区。
本课程还使用了 PHP 的若干扩展。它们可在 [Laragon] 菜单的 [PHP > Extensions] 项下启用,或者在 [php.ini] 文件中使用形如 [extension=name] 的行启用。所用的扩展有:[curl]、[mbstring]、[openssl]、[pdo_mysql]、[pdo_pgsql]、[fileinfo] 和 [zip] (最后一个由 [Composer] 用来解压它所下载的库)。修改 [php.ini] 文件后,必须重新启动 [Apache] ([Reload] 按钮,位于 [Laragon] 中);而控制台脚本则会在每次运行时重新读取 [php.ini] 文件。
你可以在终端中使用命令 [php --ini] (所使用的 [php.ini] 文件)和 [php -m] (已加载扩展的列表)来验证配置。下一章的第一个脚本 [phpinfo.php] 会显示全部配置。
2.2. 安装 VS Code
[Visual Studio Code] 是 Microsoft 推出的免费编辑器,可从 https://code.visualstudio.com/ 下载。在这里,它取代了 PHP 7 课程中使用的 [NetBeans] IDE。
安装好 [VS Code] 之后,添加对 PHP 语言的支持:在 [Extensions] 面板(Ctrl+Shift+X)中,搜索并安装 [PHP Intelephense] 扩展。它提供:
- 代码补全:输入时会提示 PHP 的函数、类及其方法和属性;
- 将鼠标悬停在函数或方法名称上时显示其文档;
- 输入时检测错误(未定义的变量、错误的类型、不存在的方法等),这些错误会在代码中以下划线标出,并列在 [Problems] 面板中;
- 代码导航:按住 Ctrl 并单击类名或函数名即可打开其定义,包括 [vendor] 文件夹内各个库中的定义。
[Intelephense] 必须知道所使用的 PHP 版本,才能识别其新特性:在 [VS Code] 设置(Ctrl+逗号)中,搜索“intelephense php version”并输入 8.5。
接下来,在 [VS Code] 中打开课程代码文件夹([File > Open Folder] 菜单)。通过 [Terminal > New Terminal] 菜单可以打开终端:它定位在已打开的文件夹,你在其中输入命令 [php]、[composer]、[curl]……要运行一个控制台脚本,先进入其所在文件夹(命令 [cd]),然后输入 [php script-name.php]。
2.3. 安装课程代码
课程的代码文件包含在名为 [php8-oct-2026] 的文件夹中,可在本文档开头下载。将它放入 [<laragon>/www] 文件夹:
这样,其中的 Web 脚本就可以通过 [http://localhost/php8-oct-2026/...] 形式的 URL 访问。例如,启动 [Apache] 后,URL [http://localhost/php8-oct-2026/composer.json] 应当显示文件 [composer.json]。
2.4. 使用 Composer 安装库
和大多数编程语言一样,PHP 也有依赖管理器 [Composer],它从 [packagist.org] 仓库下载项目所需的库。本课程使用的库在 [composer.json] 文件中声明,该文件位于 [php8-oct-2026] 文件夹中:
- 第 6 行:运行脚本所需的库。每个库由 [vendor/library] 形式的名称和一个版本约束标识:[^8.0] 表示“从 8.0 开始的任何 8.x 版本”。它们的作用将在使用它们的章节中介绍;
- 第 7 行:项目要求 PHP 8.5 或更高版本;
- 第 15 行:仅用于开发的库,这里是 [PHPUnit] 测试框架。
要安装这些库,请在 [php8-oct-2026] 文件夹中打开一个终端([Laragon] 终端或 [VS Code] 终端),然后输入:
[Composer] 随后会创建一个名为 [vendor] 的文件夹,其中包含这些库及其依赖,还有一个名为 [vendor/autoload.php] 的文件。想使用这些库的脚本只需引入这个文件,它会在这些库的类第一次被使用时自动加载它们。本课程的脚本使用相对于自身所在文件夹的路径来做到这一点,例如:
常量 [__DIR__] 指向使用它的脚本所在的文件夹:因此,这个路径既不取决于运行脚本时所在的文件夹,也不取决于 [php8-oct-2026] 文件夹的位置。
通过显示 [PHPUnit] 的版本来验证安装:
现在工作环境已经安装完毕,我们可以讲解 PHP 的基础知识了。