push_stream_channel_deleted_message_text

push_stream_channel_deleted_message_text 指令定义了频道被删除时发送的消息。

语法push_stream_channel_deleted_message_text text;
默认值none
上下文http
参数1

说明

在 NGINX Push Stream 模块中,push_stream_channel_deleted_message_text 指令用于指定当某个频道被删除时要发送给所有订阅者的自定义消息。该消息可用于通知用户该频道已被删除,从而在使用实时流的应用中提升透明度与通信。该指令需要一个参数,即要发送的消息文本。

配置该指令时,消息字符串应使用引号括起。这样可以确保消息在 NGINX 配置上下文中被正确解析和注册。此外,删除消息的具体措辞可根据应用需求进行定制,使开发者在频道不可用时能够向订阅者提供具备上下文信息的灵活提示。如果未指定此指令,则不会向订阅者广播删除消息,在不需要此类通知的应用中这可能反而带来更好的用户体验。

该指令应在 NGINX 配置文件的 http 上下文中定义,通常与诸如 push_stream_shared_memory_sizepush_stream_max_messages_stored_per_channel 等相关指令一起使用,以全面定义应用中 push stream 频道的行为。正确使用此指令有助于在动态管理频道时保持流畅的用户体验。

配置示例

http {
    push_stream_shared_memory_size 32M;
    push_stream_channel_deleted_message_text "Channel has been deleted";
}

确保消息用引号括起以避免配置错误。

如果省略该指令,将不会发送删除消息,这会使订阅者感到困惑。

← 返回所有指令