天高云淡 发表于 2017-1-6 07:17:07

[转]关于Apache的内容协商

  该功能使得服务器可以根据agent指定的http头来选择合适的资源。

涉及的http头包括: Accept-*

涉及的Apache中的知识: 类型表


1。 需要模块 : modules/mod_negotiation.so

2。 需要在目录的Options中添加: MultiViews;  如: Options FollowSymLinks MultiViews Indexes

3。 参考文档: http://apache.jz123.cn/content-negotiation.html

4。 该功能可能会影响到rewrite,参考: http://www.linuxpk.com/4941.html


apache根据你给的资源名称a,查找所有的a.*资源,加入有两种资源: a.txt 和a.php, 在类型表中查出:

.txt 对应文档类型为: text/plain 

.php 对应文档类型为: application/x-httpd-php


如果请求时使用的 accept为:
text/plain ,则返回a.txt

如果请求时使用的 accept为:
application/x-httpd-php
,则返回a.php

如果请求时使用的accept为: text/none ,找不到这种类型,则协商失败,apache返回406,并返回所有可用的类型列表,如:




Not Acceptable
  An appropriate representation of the requested resource /a could not be found  on this server.
  Available variants:


    
[*]
a.php
, type application/x-httpd-php
    
[*]
a.txt
, type text/plain
  Apache可以协商的内容基本有四类:


[*]文档类型: content-type, 通过accept来说明
[*]语言: language, 通过accept-language来说明
[*]字符集: charset, 通过accept-charset来说明
[*]编码: encoding, 通过accept-encoding来说明; (注意是传输过程的编码,不是字符的编码)
  相关源码参考:

modules/mappers/mod_negotiation.c




[*]
typedef

struct
{

[*]
    apr_pool_t *pool;
[*]
    request_rec *r;
[*]
    neg_dir_config *conf;
[*]
    char
*dir_name;

[*]
    int
accept_q;              
/* 1 if an Accept item has a q= param */

[*]
    float
default_lang_quality;
/* fiddle lang q for variants with no lang */

[*]
[*]
    /* the array pointers below are NULL if the corresponding accept

[*]
     * headers are not present
[*]
     */
[*]
    apr_array_header_t *accepts;            /* accept_recs */

[*]
    apr_array_header_t *accept_encodings;   /* accept_recs */

[*]
    apr_array_header_t *accept_charsets;    /* accept_recs */

[*]
    apr_array_header_t *accept_langs;       /* accept_recs */

[*]
[*]
    apr_array_header_t *avail_vars;         /* available variants */

[*]
[*]
    int
count_multiviews_variants;    
/* number of variants found on disk */

[*]
[*]
    int
is_transparent;      
/* 1 if this resource is trans. negotiable */

[*]
[*]
    int
dont_fiddle_headers;  
/* 1 if we may not fiddle with accept hdrs */

[*]
    int
ua_supports_trans;    
/* 1 if ua supports trans negotiation */

[*]
    int
send_alternates;      
/* 1 if we want to send an Alternates header */

[*]
    int
may_choose;          
/* 1 if we may choose a variant for the client */

[*]
    int
use_rvsa;            
/* 1 if we must use RVSA/1.0 negotiation algo */

[*]
} negotiation_state;



typedef struct {     apr_pool_t *pool;     request_rec *r;     neg_dir_config *conf;     char *dir_name;     int accept_q;               /* 1 if an Accept item has a q= param */     float default_lang_quality; /* fiddle lang q for variants with no lang */      /* the array pointers below are NULL if the corresponding accept      * headers are not present      */     apr_array_header_t *accepts;            /* accept_recs */     apr_array_header_t *accept_encodings;   /* accept_recs */     apr_array_header_t *accept_charsets;    /* accept_recs */     apr_array_header_t *accept_langs;       /* accept_recs */      apr_array_header_t *avail_vars;         /* available variants */      int count_multiviews_variants;    /* number of variants found on disk */      int is_transparent;       /* 1 if this resource is trans. negotiable */      int dont_fiddle_headers;  /* 1 if we may not fiddle with accept hdrs */     int ua_supports_trans;    /* 1 if ua supports trans negotiation */     int send_alternates;      /* 1 if we want to send an Alternates header */     int may_choose;           /* 1 if we may choose a variant for the client */     int use_rvsa;             /* 1 if we must use RVSA/1.0 negotiation algo */ } negotiation_state;



  对于协商的表达方式都是一样的,如:

Accept: */*

Accept-Language: zh-cn,zh;q=0.5

Accept-Encoding: gzip,deflate

Accept-Charset: GB2312,utf-8;q=0.7,*;q=0.7

  其中“,”和“;”的分隔或许不太好明白其含义,其实,其格式是这样的:

name;q=N;charset=TEXT

如果要表达多组,则用“,”分隔;如:

name;q=N;charset=TEXT,name;q=N;charset=TEXT


其中,q、charset都是可以省略的,如:

Accept: */*

只有一组说明,而且是省略了q和charset



相关源码参考:

modules/mappers/mod_negotiation.c




[*]
typedef

struct
accept_rec {

[*]
    char
*name;                
/* MUST be lowercase */

[*]
    float
quality;

[*]
    float
level;

[*]
    char
*charset;              
/* for content-type only */

[*]
} accept_rec;



typedef struct accept_rec {     char *name;                 /* MUST be lowercase */     float quality;     float level;     char *charset;              /* for content-type only */ } accept_rec;



  

关于文档类型的协商依赖的是: docs/conf/mime.types

如:

文档类型                     资源扩展名

text/html                   html htm

text/css                    css

text/plain                  txt text conf def list log in  


关于语言和字符集的协商依赖的是: docs/conf/charset.conv

如:

# Lang-abbv Charset     Language

#---------------------------------

en          ISO-8859-1  English

UTF-8       utf8        UTF-8  

Unicode     ucs         Unicode

th          Cp874       Thai    

ja          SJIS        Japanese

ko          Cp949       Korean  

zh          Cp950       Chinese-Traditional

zh-cn       GB2312      Chinese-Simplified

zh-tw       Cp950       Chinese

。。。


其中,第一列是语言的缩写,协商时一般用缩写; 第二列是字符集



---------------------------

内容可能是根据多个条件来协商的,那么对于一个协商的资源可能涉及到多个扩展名的,如:

content.en.html.gz

该资源如果写成了:

content.html.en.gz

也是可以找到的,只是在做超链接的时候,如果写成了: content.gz.html.en 就找不到了

参考: http://httpd.apache.org/docs/2.2/content-negotiation.html#naming

关于内容协商与cache


对于http1.0来讲,经过协商的内容是不建议cache的;在http1.1中添加了vary的http头,用来告知客户端内容是根据哪些条件来协商的,这样客户端可以尽可能的利用cache,如果协商条件不变的话就可以使用cache的。


====================

参考资料:


http://httpd.apache.org/docs/2.2/content-negotiation.html

http://httpd.apache.org/docs/2.2/mod/mod_negotiation.html

  原文地址:http://phpor.net/blog/post/786/
页: [1]
查看完整版本: [转]关于Apache的内容协商