指定 PHP 依赖项

您可以使用 Composer 管理 PHP 依赖项。

安装 Composer

如果您尚未安装 Composer,则可以按照以下步骤操作:

  1. 下载 Composer 至任何目标位置。

  2. 下载完成后,将 composer.phar 文件移动到系统路径中的目录,例如:

    mv composer.phar /usr/local/bin/composer
    

创建 composer.json 文件

composer.json 文件列出函数的依赖项。您可以手动创建,也可以运行以下命令:

composer init

运行此命令时,它会以交互方式要求您填写字段,同时提供一些智能默认值。

声明依赖项

如需声明依赖项,请将包含依赖项的 composer.json 文件添加到您的函数代码目录中。在本例中,我们需要 Cloud Functions 框架并添加 start 脚本:

{
    "require": {
        "php": ">= 8.1",
        "google/cloud-functions-framework": "^1.1"
    },
    "scripts": {
        "start": [
           "Composer\\Config::disableProcessTimeout",
           "FUNCTION_TARGET=helloHttp php -S localhost:${PORT:-8080} vendor/google/cloud-functions-framework/router.php"
        ]
    }
}

请注意,当 Composer 能够使用缓存结果时,composer.json 文件中定义的脚本不会运行。

将 Cloud Functions 框架添加为依赖项

Cloud Functions PHP 运行时要求 Cloud Functions 框架成为显式依赖项。如需将 Cloud Functions 框架添加为依赖项,请在包含函数代码的目录中运行以下命令(此目录还必须包含 composer.json 文件):

composer require google/cloud-functions-framework

系统随即会将 Cloud Functions 框架添加到您的 composer.json,并在 vendor/ 目录中安装软件包。

autoload.php 文件

vendor/ 目录中包含的其中一个文件是 autoload.php

将下面这行代码添加到 PHP 脚本的顶部即可要求使用 autoload.php 文件,该文件会自动require函数的其他依赖项:

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

默认情况下,生成的 .gcloudignore 文件中会忽略 vendor/ 目录,以减少部署中发送的文件数。

更新依赖项

如需更新函数的依赖项和 composer.lock 文件,请使用 update 命令

composer update

系统随即将解析项目的所有依赖项,并将其确切的版本写入 composer.lock