Skip to content

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>:

1
2
3
4
5
6
C:\laragon
├── bin\        the software: apache, mysql, php, redis, composer…
├── data\       the DBMS data
├── etc\        configuration files
├── tmp\
└── www\        the root of the Apache web server: http://localhost

启动 [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 -v

该命令应显示 PHP 的版本,即 8.5.x。

2.1.2. 为学习配置 PHP

PHP 通过一个名为 [php.ini] 的文本文件进行配置,可通过 [Laragon] 菜单中的 [PHP > php.ini] 项访问。在学习期间,PHP 必须报告所有错误、警告和弃用提示。请检查该文件是否包含以下几行(或进行修改):

1
2
3
4
5
6
error_reporting = E_ALL
display_errors = On
display_startup_errors = On
log_errors = On
error_log = C:/laragon/tmp/php_errors.log
date.timezone = Europe/Paris
  • [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] 文件夹:

1
2
3
4
5
6
C:\laragon\www
└── php8-oct-2026
    ├── composer.json
    ├── phpunit.xml
    ├── scripts-console
    └── scripts-web

这样,其中的 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] 文件夹中:

{
    "name": "stahe/php8-oct-2026",
    "description": "Code of the course \"Introduction to the PHP 8 language by example\" (October 2026)",
    "type": "project",
    "license": "MIT",
    "require": {
        "php": ">=8.5",
        "symfony/http-foundation": "^8.0",
        "symfony/http-client": "^8.0",
        "symfony/mailer": "^8.0",
        "symfony/mime": "^8.0",
        "predis/predis": "^3.0",
        "zbateson/mail-mime-parser": "^3.0"
    },
    "require-dev": {
        "phpunit/phpunit": "^12.0"
    },
    "config": {
        "sort-packages": true
    }
}
  • 第 6 行:运行脚本所需的库。每个库由 [vendor/library] 形式的名称和一个版本约束标识:[^8.0] 表示“从 8.0 开始的任何 8.x 版本”。它们的作用将在使用它们的章节中介绍;
  • 第 7 行:项目要求 PHP 8.5 或更高版本;
  • 第 15 行:仅用于开发的库,这里是 [PHPUnit] 测试框架。

要安装这些库,请在 [php8-oct-2026] 文件夹中打开一个终端([Laragon] 终端或 [VS Code] 终端),然后输入:

> composer install

[Composer] 随后会创建一个名为 [vendor] 的文件夹,其中包含这些库及其依赖,还有一个名为 [vendor/autoload.php] 的文件。想使用这些库的脚本只需引入这个文件,它会在这些库的类第一次被使用时自动加载它们。本课程的脚本使用相对于自身所在文件夹的路径来做到这一点,例如:

require_once __DIR__ . '/../../vendor/autoload.php';

常量 [__DIR__] 指向使用它的脚本所在的文件夹:因此,这个路径既不取决于运行脚本时所在的文件夹,也不取决于 [php8-oct-2026] 文件夹的位置。

通过显示 [PHPUnit] 的版本来验证安装:

> php vendor/bin/phpunit --version
PHPUnit 12.5.37 by Sebastian Bergmann and contributors.

现在工作环境已经安装完毕,我们可以讲解 PHP 的基础知识了。