13. 附录
13.1. 安装 PHP
示例和案例研究需要 [PHP] 8.4 或更高版本,并带有以下扩展:[intl] (数字格式化,示例 16)、[pdo_mysql] (访问 [MySQL],示例 28 和案例研究)、[mbstring]、以及 [openssl]。它们已在 8.4 版本上测试过。
在 [Windows] 下,最简单的选择是 [Laragon] (laragon.org),它会安装 [PHP]、[Composer]、一个 [MySQL] 服务器,以及 [HeidiSQL] 管理工具。如果所提供的 [PHP] 版本低于 8.4,请从 windows.php.net/download 下载较新的版本(*Thread Safe* 版本,[.zip] 压缩包),并将其解压到 [bin\php] 文件夹(位于 [Laragon] 中);通过菜单 PHP / [Laragon] 版本可以选择它。菜单 PHP / 扩展只需单击一下即可启用某个扩展([intl]、[pdo_mysql])。[Laragon] 的终端(“终端”按钮)支持命令 [php]、[composer]、以及 [mysql]。
没有 [Laragon] 时,把 [PHP] 的压缩包解压到某个文件夹([C:\php]),把该文件夹添加到环境变量 [Path] 中,然后通过复制 [php.ini] 来创建配置文件,复制的来源是 [php.ini-development],并去掉所需扩展那几行前面用来注释它们的分号:
在 [macOS] 下,包管理器 [Homebrew] 会安装 [PHP] 及其标准扩展:[brew install php]。对于 [Linux] ([Ubuntu]),发行版提供的版本往往较旧;[ppa:ondrej/php] 仓库提供最新版本:
在新的控制台中验证安装:
第一条命令应显示等于或高于 8.4 的版本号(例如 [PHP 8.4.12]);第二条命令列出已加载的扩展,其中应包括 [intl] 和 [pdo_mysql]。命令 [php --ini] 指明正在使用哪个文件,[php.ini]。
13.2. Composer
[Composer] 是 [PHP] 的库管理器(getcomposer.org)。它由 [Laragon] 提供;对于 [Windows],在没有 [Laragon] 的情况下,使用它的安装程序([Composer-Setup.exe]);对于 [macOS],使用 [brew install composer];对于 [Linux],请按照 getcomposer.org/download 页面上的说明操作。验证安装:
项目文件夹(包含 [composer.json] 的那个文件夹)中的常用命令:
[Composer] 从 [Packagist] (packagist.org)仓库下载库:安装期间需要连接互联网。如果你处于公司代理之后,请使用环境变量 [HTTP_PROXY] 和 [HTTPS_PROXY] 指定代理。[vendor] 文件夹不会在机器之间复制(它可能包含绝对路径,而且体积很大);它通过 [composer install] 重新创建。这就是它没有包含在课程材料中的原因。[examples] 文件夹有自己的 [vendor] 文件夹,由全部 28 个示例共用;案例研究有它自己的。
13.3. 安装 Visual Studio Code
[Visual Studio Code] 可从 code.visualstudio.com 下载。添加两个扩展(“查看”菜单 / 扩展):
- PHP Intelephense:代码补全、代码导航(包括 [Laravel] 的代码,位于 [vendor] 文件夹中)以及错误报告;
- Laravel (官方扩展):为 [Blade] 视图提供语法高亮,并对路由名称、视图名称、配置键和翻译键提供自动补全。
PHP Debug 扩展允许你使用 [Xdebug] 调试器单步执行代码(它是 [PHP] 的一个扩展,必须单独安装:xdebug.org)。
打开 [examples] 文件夹或案例研究文件夹(“文件”菜单 / 打开文件夹)。内置终端(“终端”菜单 / 新建终端)可以让你在不离开编辑器的情况下启动应用程序。
13.4. 使用 Laragon 安装 MySQL
[Laragon] 提供开箱即用的 [MySQL] 服务器,适用于 [Windows],并附带 [HeidiSQL] 管理工具。安装之后:
- “Start All”按钮会在端口 3306 上启动 [MySQL] 服务器;
- 用户 [root] 没有密码:这些是示例 28 和案例研究中 [.env] 文件里的值([DB_USERNAME=root]、[DB_PASSWORD=]);
- “数据库”按钮会打开 [HeidiSQL],其中“文件”菜单 / “运行文件”菜单项(SQL)会运行脚本 [dbpersons.sql] (示例 28)和 [dbrdvmedecins2.sql] (案例研究)。
在 [Linux] 或 [macOS] 中,使用系统的包管理器安装 [MySQL] 或 [MariaDB] ,并使用命令行客户端 [mysql] 运行脚本。[pdo_mysql] 驱动对两者都无需任何配置即可工作。在 [Linux] 下,[root] 账户(属于 [MariaDB] )通常被配置为只能通过系统账户 [root] 登录([sudo mysql]):此时需要为应用程序创建一个用户,并在它们的 [.env] 文件中指定这个用户:
13.5. 安装 curl
[curl] 已内置于 [Windows] 10 和 11、[macOS]、以及大多数 [Linux] 发行版中。在 [PowerShell] 中,必须输入 [curl.exe],而不是 [curl]:在较旧版本的 [PowerShell] 中,[curl] 是另一个命令的别名([Invoke-WebRequest]),其选项不同。在 [Windows] 的命令提示符([cmd])中,JSON 字符串的引号要写成 [\"] (示例 11),而包含 [&] 的 URL 必须用双引号括起来。