push_stream_message_ttl
`push_stream_message_ttl` 指令设置通道中消息在被删除之前的生存时长。
NGINX push stream module
·
http
语法push_stream_message_ttl time;
默认值none
上下文http
参数1
说明
push_stream_message_ttl 指令指定推送流通道中消息在被视为过期并删除之前的保留时长（以秒为单位）。此指令通过定义消息的生命周期影响推送通知系统，控制订阅者可获取信息的持久性。例如，如果消息的 TTL 设置为 300 秒，消息在发布后会在通道中保留 5 分钟；超过该时限后，消息将被移除，尝试检索这些消息的新订阅者将发现它们已不存在。
将 TTL 设置得过高会导致消息堆积，从而产生不必要的内存消耗；而 TTL 过低可能导致订阅者错过重要更新。因此，应根据应用的需求和预期的消息消费模式配置该指令。对该设置的修改可以立即生效，而无需完全重启服务器，从而在动态管理消息寿命时提供灵活性。
该指令在 NGINX 配置的 HTTP 上下文中定义，并带有 NGX_CONF_TAKE1 标志，表示它需要且仅需要一个参数（即 TTL 值）。所提供的值必须是 NGINX 识别的有效时间格式，例如整数后可跟可选的时间单位（s 表示秒，m 表示分钟，等等）。
配置示例
http {
push_stream_shared_memory_size 32M;
push_stream_message_ttl 300;
server {
location /pub {
push_stream_publisher admin;
push_stream_channels_path $arg_id;
}
location ~ /sub/(.*) {
push_stream_subscriber;
push_stream_channels_path $1;
}
}
}⚠
请确保以秒为单位指定 TTL 值；如果不这样做会导致配置错误。
⚠
请确保设置的 TTL 适合您应用程序的消息传递需求，以避免重要消息被过早删除。
⚠
如果在更改后解析配置时出现问题，可能需要重启服务器。