Ubuntu 下 nginx-1.24.0 源码分析 - ngx_test_full_name

ngx_test_full_name

声明在 src\core\ngx_file.c 

static ngx_int_t ngx_test_full_name(ngx_str_t *name);

---

定义在 src\core\ngx_file.c 

static ngx_int_t
ngx_test_full_name(ngx_str_t *name)
{
#if (NGX_WIN32)
    u_char  c0, c1;

    c0 = name->data[0];

    if (name->len < 2) {
        if (c0 == '/') {
            return 2;
        }

        return NGX_DECLINED;
    }

    c1 = name->data[1];

    if (c1 == ':') {
        c0 |= 0x20;

        if ((c0 >= 'a' && c0 <= 'z')) {
            return NGX_OK;
        }

        return NGX_DECLINED;
    }

    if (c1 == '/') {
        return NGX_OK;
    }

    if (c0 == '/') {
        return 2;
    }

    return NGX_DECLINED;

#else

    if (name->data[0] == '/') {
        return NGX_OK;
    }

    return NGX_DECLINED;

#endif
}

ngx_test_full_name 是一个用于判断路径名是否为“完整路径”的函数 

函数签名

static ngx_int_t
ngx_test_full_name(ngx_str_t *name)

 

• ngx_int_t ：Nginx 自定义的整数类型，通常用于返回状态码。
• ngx_str_t ：Nginx 自定义的字符串结构体，包含两个字段：
  • data：指向字符串数据的指针。
  • len：字符串的长度。
• static ：表明该函数的作用域仅限于当前文件，不会被其他文件调用。
• name:传入的需要判断的路径

Windows 平台的特殊处理

#if (NGX_WIN32)

 条件编译 ：NGX_WIN32 是一个宏，表示当前代码运行在 Windows 平台上。

Windows 和类 Unix 系统（如 Linux）对路径的处理方式不同，因此需要分别处理

 变量声明

u_char  c0, c1;

• u_char ：无符号字符类型，等价于 unsigned char。
• c0 和 c1 ：分别用于存储路径字符串的第一个和第二个字符。

检查路径长度

c0 = name->data[0];
if (name->len < 2) {
    if (c0 == '/') {
        return 2;
    }
    return NGX_DECLINED;
}

 

• c0 = name->data[0] ：获取路径字符串的第一个字符。
• if (name->len < 2) ：如果路径长度小于 2，则进行以下判断：
  • 如果第一个字符是 /，返回 2，表示路径是一个根路径（例如 / 或 /abc），需要添加盘符 （如/ → C:/）
  • 否则，返回 NGX_DECLINED，表示路径不符合要求。

在路径长度不足的情况下，快速判断是否为根路径。

提取次字符并检测盘符路径 

c1 = name->data[1];
if (c1 == ':') {
    c0 |= 0x20;
    if ((c0 >= 'a' && c0 <= 'z')) {
        return NGX_OK;
    }
    return NGX_DECLINED;
}

c1 == ':': 检测Windows盘符格式（如C:）。

c0 |= 0x20: 通过位操作将大写字母转为小写（A(0x41) → a(0x61)）。

原理: 0x20 是ASCII表中大小写字母的差值，按位或操作实现不区分大小写。

范围检查: 确保盘符在a-z之间，兼容C:/和c:/写法。

拒绝非法盘符: 如0:或G:（超出a-z范围）。

检查 UNC 路径

if (c1 == '/') {
    return NGX_OK;
}

 

• if (c1 == '/') ：如果第二个字符是斜杠 /，则可能是 UNC 路径（例如 //server/share）。
• 返回 NGX_OK，表示路径有效。

---

UNC（Universal Naming Convention，通用命名约定）路径 是一种用于在计算机网络中标识共享资源（如文件夹、打印机等）的路径格式。它主要用于 Windows 操作系统，允许用户通过网络访问远程计算机上的资源，而无需映射网络驱动器

UNC 路径的基本格式如下：

\\<ServerName>\<SharedResource>

• \\ ：UNC 路径以两个反斜杠开头，表示这是一个网络路径。
• <ServerName> ：这是提供共享资源的服务器名称或 IP 地址。例如：
  • FileServer
  • 192.168.1.100
• <SharedResource> ：这是服务器上共享的具体资源名称，例如文件夹或打印机。例如：
  • SharedFolder
  • Printer1

完整的 UNC 路径示例：

• \\FileServer\SharedFolder
• \\192.168.1.100\Documents

检查根路径 

if (c0 == '/') {
    return 2;
}

首字符为'/' 

可能为根目录（如"/path"需转换为"C:/path"）

 

return NGX_DECLINED;

 

• 如果以上条件都不满足，则返回 NGX_DECLINED，表示路径无效。

非 Windows 平台的处理

#else
if (name->data[0] == '/') {
    return NGX_OK;
}
return NGX_DECLINED;
#endif

 

• 在非 Windows 平台上，路径的有效性判断较为简单：
  • 如果路径的第一个字符是 /，则返回 NGX_OK，表示路径有效。
  • 否则，返回 NGX_DECLINED。

类 Unix 系统（如 Linux）的路径规范较为统一，只需检查是否以 / 开头即可