后端Web框架【免费下载链接】symfonyThe Symfony PHP framework项目地址https://gitcode.com/GitHub_Trending/sy/symfony点击查看免费下载Sendberry 是 Symfony Notifier 组件为 Sendberry 短信服务平台提供的一体化接入桥Bridge本指南将带你完整掌握其 DSN 配置参数、SmsMessage发送流程、底层 HTTP 请求结构、消息校验规则以及 6.18.2 各版本的能力演进。读完本文你既能写出可直接运行的.env配置也能读懂SendberryTransport源码级实现并了解如何用测试用例验证桥接行为。一、桥接组件定位与安装前提Sendberry 桥接位于 src/Symfony/Component/Notifier/Bridge/Sendberry属于 Symfony Notifier 生态中众多短信SMS桥接之一。从 composer.json 可以看到它的依赖约束php: 8.4.1要求较新的 PHP 运行时symfony/http-client: ^7.4|^8.0发送短信依赖 HttpClient 发起 HTTP 请求symfony/notifier: ^8.2桥接建立在 Notifier 组件的 Transport 抽象之上类型为symfony-notifier-bridge自动加载命名空间为Symfony\Component\Notifier\Bridge\Sendberry。因此要在应用中使用它至少需要安装 Notifier 与 HttpClient 两个组件例如composer require symfony/notifier symfony/http-client然后通过symfony/notifier的桥接发现机制加载sendberryscheme。实际发送短信时Notifier 的Transport接口负责消息分发而桥接只需要实现supports()与doSend()两个关键方法见 SendberryTransport.php。二、DSN 配置完整参数与来源Sendberry 桥接的官方 DSN 示例来自 README.md如下SENDBERRY_DSNsendberry://USERNAME:PASSWORDdefault?auth_keyAUTH_KEYfromFROM各组成部分含义如下表DSN 片段说明USERNAME你在 Sendberry 平台自定义的访问用户名access namePASSWORD与用户名对应的访问密码access passwordAUTH_KEY平台生成的认证密钥authentication keyFROM发件人名称可以是电话号码或发件人名称sender name其中USERNAME、PASSWORD分别由 SendberryTransportFactory.php 通过基类AbstractTransportFactory的getUser()与getPassword()解析若缺失会抛出IncompleteDsnException见 AbstractTransportFactory.php。auth_key与from则通过$dsn-getRequiredOption(auth_key)/$dsn-getRequiredOption(from)读取属于必填查询参数。测试用例 SendberryTransportFactoryTest.php 明确验证了缺少任一参数都会报错// missing option: auth_key sendberry://username:passworddefault?fromfrom // missing option: from sendberry://username:passworddefault?auth_keyauth_key另外host部分若为字面量default会被置空default $dsn-getHost() ? null : $dsn-getHost()随后交由setHost()处理最终回落到SendberryTransport::HOST api.sendberry.comport同样可显式覆盖。三、8.2 新增ssl选项与明文 HTTP 通道CHANGELOG 记录 8.2 版本引入了一个重要能力新增sslDSN 选项用于通过明文 HTTP 发送请求Add thesslDSN option to send requests over plain HTTP。在工厂侧SendberryTransportFactory.php构造 Transport 后链式调用了-setSsl($this-getSsl($dsn))。基类getSsl()的实现AbstractTransportFactory.php为protected function getSsl(Dsn $dsn): ?bool { return null $dsn-getOption(ssl) ? null : $dsn-getBooleanOption(ssl); }即未提供ssl时返回null提供时按布尔值解析。在 Transport 侧AbstractTransport::getHttpScheme()AbstractTransport.php决定最终协议protected function getHttpScheme(): string { return ($this-ssl ?? static::SSL) ? https : http; }因此只要在 DSN 中追加ssl0或sslfalse即可让桥接改用明文http://访问api.sendberry.com/SMS/SEND端点。这一特性通常用于对接仅提供明文 HTTP 的网关或本地联调环境生产环境仍默认走 HTTPS基类默认SSL常量为真。四、消息发送流程与底层 HTTP 调用SendberryTransport只支持SmsMessage。supports()返回$message instanceof SmsMessageSendberryTransport.php若在doSend()中收到非SmsMessage会抛出UnsupportedMessageTypeException。测试 SendberryTransportTest.php 也验证了ChatMessage与DummyMessage均不被支持。4.1 发件人取值优先级doSend()的第一步是确定发件人$from $message-getFrom() ?: $this-from;这与 CHANGELOG 中 6.2 版本的能力一一对应当SmsMessage定义了from时优先使用消息自身的发件人否则回退到 DSN 配置的fromUseSmsMessage-fromwhen defined。这使得同一条 DSN 可以服务多个不同发件人场景。4.2 发件人格式校验随后代码用两段正则校验$fromSendberryTransport.php若匹配^[][1-9][0-9]{9,14}$视为合法的国际格式电话号码开头、首位非 0、总长 1015 位否则要求非空且仅包含a-zA-Z0-9与空格即合法的字母数字 Sender ID空字符串或含其他字符都会抛出IncompleteDsnException分别提示This phone number is invalid.与The Sender ID is invalid.。4.3 请求端点与 JSON 载荷实际请求构造如下SendberryTransport.php$endpoint \sprintf(%s://%s/SMS/SEND, $this-getHttpScheme(), $this-getEndpoint()); $response $this-client-request(POST, $endpoint, [ json [ from $from, to [$message-getPhone()], content $message-getSubject(), key $this-authKey, name $this-username, password $this-password, ], ]);要点目标为POST {scheme}://{host}[/:{port}]/SMS/SENDgetEndpoint()会拼接自定义 host/port缺省时使用api.sendberry.comAbstractTransport.php载荷为 JSONfrom、to数组、content、key、name、password六个字段其中to来自SmsMessage::getPhone()content来自getSubject()若 HttpClient 本身抛TransportExceptionInterface网络不可达会被包装为TransportExceptionCould not reach the remote Sendberry server.。4.4 响应校验与消息 ID请求返回后按如下规则处理SendberryTransport.php状态码非 200 时抛出TransportExceptionUnable to send the SMS.解析 JSON 响应若status存在且不等于ok则把message数组逐行拼接进异常信息再抛出成功时构造SentMessage并读取ID字段作为消息 ID 写入$sentMessage-setMessageId($responseArr[ID])便于后续追踪与对账。SentMessage的(string)$this形式来自__toString()SendberryTransport.php会以sendberry://{endpoint}?from{from}的格式记录发送元信息。五、消息分发事件与异常路径SendberryTransport继承自AbstractTransport其公开的send()方法AbstractTransport.php负责统一的消息分发流程未配置事件分发器时直接调用doSend()配置了EventDispatcherInterface时依次派发MessageEvent发送前、SentMessageEvent成功或FailedMessageEvent失败后重抛异常。因此即使桥接本身只实现doSend()应用仍可无缝接入 Symfony 的事件系统对发送前、发送成功、发送失败三个阶段做日志、指标或重试处理。六、版本演进时间线CHANGELOG 完整记录了该桥接的三个版本节点版本变更内容6.1新增 Sendberry 桥接Add the bridge首次引入SendberryTransport与SendberryTransportFactory6.2优先使用SmsMessage-from作为发件人UseSmsMessage-fromwhen defined8.2新增sslDSN 选项支持通过明文 HTTP 发送请求需要说明仓库当前 composer.json 要求symfony/notifier: ^8.2、symfony/http-client: ^7.4|^8.0即当前形态面向 8.x 分支6.x 时代的 API 结构SmsMessage::getFrom()、auth_key/from必填项等在 8.2 中仍然延续并叠加了ssl选项的新能力。七、测试验证与自定义 host 场景仓库内的两组测试可帮助理解桥接行为边界SendberryTransportTest.php验证sendberry://api.sendberry.com?fromfrom的字符串表示、仅支持SmsMessage、拒绝ChatMessage与DummyMessageSendberryTransportFactoryTest.php验证 scheme 解析sendberry://user:passwordhost.test?auth_keyauth_keyfrom%2B0611223344可创建传输、其他 scheme 报UnsupportedSchemeException、必填项缺失报错、以及缺少 user 的IncompleteDsnException场景。其中supportsProvider()里出现sendberry://api_keydefault?from%2B0611223344这类无 user/password 仍通过的用例说明工厂在supports()阶段只做 scheme 匹配真正的凭据完整性检查推迟到create()/发送时完成。若需对接 Sendberry 的测试沙箱或自定义网关可在 DSN 中显式指定 host 与 port例如SENDBERRY_DSNsendberry://user:passsandbox.example.com:8080?auth_keyKEYfrom8613800138000ssl0其中8613800138000这类带的值在 DSN 中需做 URL 编码%2B如测试用例所示。八、快速上手示例在 Symfony 应用中使用 Sendberry 发送短信的最小路径安装依赖composer require symfony/notifier symfony/http-client在.env中配置 DSNSENDBERRY_DSNsendberry://USERNAME:PASSWORDdefault?auth_keyAUTH_KEYfromFROM通过Notifier服务发送SmsMessageuse Symfony\Component\Notifier\Notifier; use Symfony\Component\Notifier\NotifierInterface; use Symfony\Component\Notifier\Recipient\Recipient; /** var NotifierInterface $notifier */ $notifier-send( new SmsMessage(8613800138000, Hello from Symfony!, 8613900139000), new Recipient(8613800138000), );若第三个参数from留空桥接会自动使用 DSN 中的FROM指定后则以消息级from为准对应 6.2 行为。调试时可用MockHttpClient替换真实客户端如测试所示在不触网的情况下断言请求载荷与错误分支。综上Sendberry 桥接虽然代码量小却完整覆盖了 DSN 解析、消息类型约束、发件人校验、HTTP 调用与错误归一化等 Notifier 桥接的标准范式是理解 Symfony Notifier 传输层实现的上佳样例。赞分享后端Web框架【免费下载链接】symfonyThe Symfony PHP framework项目地址https://gitcode.com/GitHub_Trending/sy/symfony点击查看免费下载相关推荐Symfony Octopush Notifier 桥接器DSN 配置、消息发送与版本演进全解析Symfony Octopush Notifier 桥接器DSN 配置、消息发送与版本演进全解析 导读 本篇文章围绕 Symfony 官方 Notifier后端Web框架Symfony Notifier 的 KazInfoTeh 短信桥接器DSN 配置、发送流程与 CHANGELOG 演进解读Symfony Notifier 的 KazInfoTeh 短信桥接器DSN 配置、发送流程与 CHANGELOG 演进解读 KazInfoTeh 是哈萨克斯后端Web框架Symfony Notifier 的 iSendPro 短信桥接器DSN 配置、ssl 选项与版本演进全解析Symfony Notifier 的 iSendPro 短信桥接器DSN 配置、ssl 选项与版本演进全解析 iSendPro 是法国电信服务商提供的短信S后端Web框架创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考