captcha_width

设置验证码图片的宽度(以像素为单位)。

语法captcha_width pixels;
默认值130
上下文http, server, location
参数1

说明

captcha_width 指令是 NGINX 验证码模块的一部分,用于在表单提交时生成验证码图片。此指令专门用于配置呈现给用户的验证码图片的宽度。宽度设置直接影响生成图片的尺寸,确保其能在网页或应用的布局中合适显示。提供合适的宽度有助于在美观设计与功能需求之间保持平衡。

captcha_width 指定的值应为表示像素数的正整数。必须确保该宽度与验证码定义的其他尺寸(例如高度)一致,以保持适当的视觉比例。调整宽度会影响验证码的整体可用性;例如,过小的宽度可能导致文字难以阅读,而过大的宽度则可能在 UI 中占用过多空间。

此指令可在不同上下文中使用,例如 httpserverlocation,以便根据配置的具体需求或作用域提供灵活性。默认情况下,该指令的宽度为 130 像素,可根据特定布局需求或设计规范进行修改。

配置示例

location =/captcha {
    captcha;
    captcha_width 200;
}

确保该值为正整数以避免配置错误。

将宽度设置得过大可能会对页面的整体布局产生不利影响。

应将宽度与高度结合考虑,以保持正确的纵横比。

← 返回所有指令