https://github.com/alibaba/nginx-http-user-agent

A nginx module to match browsers and crawlers
https://github.com/alibaba/nginx-http-user-agent

Last synced: 2 months ago
JSON representation

A nginx module to match browsers and crawlers

• Host: GitHub
• URL: https://github.com/alibaba/nginx-http-user-agent
• Owner: alibaba
• Created: 2012-04-06T07:09:27.000Z (almost 13 years ago)
• Default Branch: master
• Last Pushed: 2019-05-04T21:27:29.000Z (over 5 years ago)
• Last Synced: 2024-08-03T18:22:10.403Z (5 months ago)
• Language: C
• Homepage: http://tengine.taobao.org
• Size: 113 KB
• Stars: 162
• Watchers: 30
• Forks: 52
• Open Issues: 1
• Metadata Files:
  • Readme: README

Awesome Lists containing this project

• awesome-nginx - nginx-http-user-agent - A nginx module to match browsers and crawlers. (Third Party Modules / C Modules)

README

        
# HTTP user_agent module for Tengine

#syntax:

user_agent $variable_name {

    greedy        name;

    name [([+|-]version) | (version1~version2)]  value;

}

if ($variable == value) {

    echo hello;

}

## Introduction

greedy:

We specify the keyword in the user_agent string from right to left, and this is more efficient. As usual, we use the greedy algorithm. It will return immediately after the keyword being found.

E.g 1. "Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.1; WOW64; Trident/6.0)", this string is MSIE's user_agent string, we will return when we find the keyword "MSIE". But the truth is not alway like this:

E.g 2. "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_3) AppleWebKit/535.20 (KHTML, like Gecko) Chrome/19.0.1036.7 Safari/535.20", This is Chrome's user_agent. We will match Safari frist. If we define safari is greedy, it scans the string in a reverse order. If a keyword is greedy, it will not return when it matches the keyword at the first time. It will continue to scan the string.

default:

set the default value of this variable;

The directive format is like this in the block:

name   version    value;

name: the name of operating_system, browser, crawler and so on;

version: It can be omitted, and it support multiple formats;

value: It is the value filled to the variable;

for example:

user_agent $example {

    #set default value

    default                                             msie;

    #define safari is greedy

    greedy                                             safari;

    #match exact version

    msie                6.0                             1;

    #match interval

    msie                7.0~8.0                         2;

    #match greater than version 9.0

    msie                9.0+                            3;

    #match less than version 4.0 (include 4.0)

    msie                4.0-                            4;

    #match all

    Chrome                                              5;

}