captcha_height
设置验证码图片的高度(以像素为单位)。
NGINX Captcha Module
·
httpserverlocation
语法captcha_height pixels;
默认值30
上下文http, server, location
参数1
说明
'captcha_height' 指令设置由 NGINX Captcha Module 生成的验证码图片的高度。该指令允许用户配置验证码图片的垂直尺寸,以适应不同的设计需求或用户界面元素。高度值以像素为单位,应根据实现该验证码系统的应用的整体美观和功能需求进行设置。默认情况下,如果未指定,高度设置为 30 像素,这通常足以清晰显示验证码文本。
在配置该指令时,可以将其放置在 'http'、'server' 或 'location' 上下文中,允许根据所需的应用范围灵活调整。该指令接受一个整数参数,表示验证码图片的像素高度。对于具有多样主题或用户流程的 Web 应用,能够调整高度可以提高可读性并确保与现有布局更好地集成。例如,如果为验证码文本选择了较大的字体,则可能需要通过该指令增加高度以保持良好的视觉比例。
需要注意的是,将高度设置得过低可能导致文本重叠或验证码难以阅读。因此,建议测试不同的高度值以找到在美观与可访问性之间取得平衡的最佳尺寸。此设置的调整还可以与其他参数(例如 'captcha_width' 和 'captcha_size')配合使用,以完全重新定义验证码的大小。
配置示例
location =/captcha {
captcha;
captcha_height 40;
}
location =/login {
# Other configurations
}⚠
将 captcha_height 设置为过小的值可能会使 CAPTCHA 难以识别。
⚠
确保高度值与其他尺寸(如宽度)保持一致,以维持良好的纵横比。