@bref.sh/constructs

中文文档
2.0.6发布于 2026/10/21MITTypeScriptCommonJS构建来源已验证近 30 天下载 7793

这个 布莱夫 CDK构建允许您使用 AWS CDK 在 AWS Lambda 上部署无服务器的 PHP 应用程序 .

中文使用文档
文档目录4 节
  1. 安装
  2. 使用量
  3. 构造
  4. 职能

在 AWS Lambda 为 PHP 构建 AWS CDK

这个 布莱夫 CDK构建允许您使用 AWS CDK 在 AWS Lambda 上部署无服务器的 PHP 应用程序 .

默认情况下, Bref 使用无服务器框架部署。使用 AWS CDK 是一个选择,但请注意这是一个高级话题。 如果你迷路了,跟着我 Bref 文档 换句话说.

安装

安装 软件包 与国家预防机制:

npm install @bref.sh/constructs

使用量

部署 HTTP 应用程序的简单示例 :

import { Construct } from 'constructs';
import { App, Stack } from 'aws-cdk-lib';
import { PhpFpmFunction } from '@bref.sh/constructs';

class MyStack extends Stack {
    constructor(scope: Construct, id: string, props?: StackProps) {
        super(scope, id, props);

        new PhpFpmFunction(this, 'Hello', {
            handler: 'public/index.php',
        });
    }
}

const app = new App();
new MyStack(app, 'test', {
    env: {
        region: 'eu-west-1',
    },
});

构造

职能

PhpFpmFunction

此构造将 PHP 函数与 HTTP 运行时间。 。 。 .

new PhpFpmFunction(this, 'MyFunction', {
    handler: 'public/index.php',
});

它继承自 AWS CDK Function 构造 默认设置这些选项:

  • handler数字 : index.php 默认
  • runtime数字 : provided.al2023
  • code:代码自动从当前目录中拉链.
  • layers: Bref 层自动添加.
  • memorySize数字 : 1024
  • timeout数字 : 28 (单位:秒)

该代码从当前目录中自动被拉链. 您可以通过设置 code 属性 :

import { packagePhpCode } from '@bref.sh/constructs';

new PhpFpmFunction(this, 'MyFunction', {
    code: packagePhpCode('custom-path', {
        exclude: ['docs'],
    }),
});

下列途径始终被排除在外: .git, (中文(简体) ), .idea, (中文(简体) ), cdk.out, (中文(简体) ), node_modules, (中文(简体) ), .bref, (中文(简体) ), .serverless, (中文(简体) ), tests。 。 。 .

该建筑还增加了以下选项:

  • phpVersion (默认 : 8.4:要使用的PHP版本.

PhpFunction

此构造将 PHP 函数与 “事件驱动的函数”运行时间。 。 。 .

new PhpFunction(this, 'MyFunction', {
    handler: 'my-handler.php',
});

它继承自 AWS CDK Function 构造 默认设置这些选项:

  • runtime数字 : provided.al2023
  • code:代码自动从当前目录中拉链.
  • layers: Bref 层自动添加.
  • memorySize数字 : 1024
  • timeout数字 : 6 (单位:秒)

该代码从当前目录中自动被拉链. 您可以通过设置 code 属性 :

import { packagePhpCode } from '@bref.sh/constructs';

new PhpFunction(this, 'MyFunction', {
    // ...
    code: packagePhpCode('custom-path', {
        exclude: ['docs'],
    }),
});

下列途径始终被排除在外: .git, (中文(简体) ), .idea, (中文(简体) ), cdk.out, (中文(简体) ), node_modules, (中文(简体) ), .bref, (中文(简体) ), .serverless, (中文(简体) ), tests。 。 。 .

该建筑还增加了以下选项:

  • phpVersion (默认 : 8.4:要使用的PHP版本.

ConsoleFunction

此构造将 PHP 函数与 "控制台"运行时间。 。 。 .

new ConsoleFunction(this, 'Artisan', {
    handler: 'artisan',
});

它继承自 AWS CDK Function 构造 默认设置这些选项:

  • runtime数字 : provided.al2023
  • code:代码自动从当前目录中拉链.
  • layers: Bref 层自动添加.
  • memorySize数字 : 1024
  • timeout数字 : 6 (单位:秒)

该代码从当前目录中自动被拉链. 您可以通过设置 code 属性 :

import { packagePhpCode } from '@bref.sh/constructs';

new ConsoleFunction(this, 'Artisan', {
    // ...
    code: packagePhpCode('custom-path', {
        exclude: ['docs'],
    }),
});

下列途径始终被排除在外: .git, (中文(简体) ), .idea, (中文(简体) ), cdk.out, (中文(简体) ), node_modules, (中文(简体) ), .bref, (中文(简体) ), .serverless, (中文(简体) ), tests。 。 。 .

该建筑还增加了以下选项:

  • phpVersion (默认 : 8.4:要使用的PHP版本.

版本与发布记录

@bref.sh/constructs 共发布 12 个版本,首次发布于 2022/12/15;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.0.6latest2026/10/2118 天前
2.0.52026/02/278 个月前
1.1.02024/11/252 年前
1.0.22023/11/152 年前
1.0.12023/06/303 年前
1.0.02023/03/153 年前

关于 @bref.sh/constructs 的常见问题

@bref.sh/constructs 是什么?

这个 布莱夫 CDK构建允许您使用 AWS CDK 在 AWS Lambda 上部署无服务器的 PHP 应用程序 .

如何安装 @bref.sh/constructs?

在项目目录运行 npm install @bref.sh/constructs,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:constructs(^10.0.0)、aws-cdk-lib(^2.100.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@bref.sh/constructs 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@bref.sh/constructs 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@bref.sh/constructs 可以商用吗?

@bref.sh/constructs 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@bref.sh/constructs 的下载量有多少?

根据 npm 官方下载统计,@bref.sh/constructs 在 2026/10/09 – 2026/11/07 这 30 天内被下载 7,793 次,日均约 260 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@bref.sh/constructs 还在维护吗?

最新版本 2.0.6 发布于 2026/10/21(18 天前);至今共发布 12 个版本,其中过去 12 个月发布了 2 个;首次发布于 2022/12/15。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。