深入浅出BAE:理解配置文件app.conf

BAE环境中,每个应用对应一个配置文件app.conf,很多开发者在初次接触BAE的时候,对如何使用app.conf比较困惑,本文对app.conf做一个基本的介绍。

1. BAE环境中HTTP请求的处理流程

要理解app.conf的作用,首先要理解HTTP请求在BAE环境中是如何被处理的。

  • WEB请求首先到达前端 WEB proxy,WEB proxy负责将请求转发给后端的某一个WEB server。(注意,后端可能会有多个WEB server来处理应用的请求)
  • 请求到达后端 WEB server后,WEB server 根据 app.conf进行一些特定的处理,所以说app.conf主要是用来控制后端WEB server的处理逻辑的。app.conf的作用比较多,其中主要的功能是实现URL rewrite。
  • URL rewrite 完成后,原始的URL被改写, WEB server能根据改写后的URL识别出请求类型,
  • 对于静态请求,例如图片、模板、CSS文件、JS文件等,WEB server直接处理
  • 对于动态请求,例如PHP脚本、Python脚本等,WEB server进一步将其转发给后端的 Runtime去处理。
  • 后端Runtime根据请求,找到对应的处理脚本,例如index.php,执行脚本,并将处理结果返回给浏览器。

2. 用app.conf实现URL rewrite

  • 如何使用app.conf ,请先参看BAE配置文件
  • 关于 URL rewrite,可以参考URL rewrite
  • app.conf 采用的是 YAML格式,参考YAML
  • app.conf中,每条规则包括“规则类型”、“规则”和“执行”三个部分,“规则类型”中最重要的是“url”类型, 用来实现URL rewrite。 “规则”指定了URL匹配模式,“执行”指定了URL rewrite的结果; 若某个URL匹配了这个模式,则按照“执行” 对URL进行rewrite。
  • 规则是按顺序匹配的,一旦匹配上,就不往下继续匹配了。
  • “规则”和“执行”部分支持正则表达式,但使用的是LUA格式的正则表达式,详细的语法后面会介绍。

3. 你在设计app.conf 时要考虑的东西

  • 如何设计你的应用的URL的表现形式
  • 如何将URL请求路由到你的动态处理脚本
  • 区分动态请求和静态请求。对于静态请求,最好让后端WEB server直接处理,这样可以提高性能。

4. 你在设计动态脚本时要考虑的东西

  • URL被重写了,有些情况下,需要知道原始URL的信息,可以通过环境变量REQUEST_URI来获取

5. 示例

  • 示例一

深入浅出BAE:理解配置文件app.conf

如图所示,假设你开发了一个应用,希望把所有的静态文件,都放在应用的 /static 目录下,其它所有的URL,都统一转发给 index.php处理。

示例图中有两条规则,第一条规则,用来处理静态文件;第二条规则,用来处理动态脚本;
规则是按顺序匹配的,一旦匹配上,就不往下继续匹配了

(.*)是正则表达式里面的分组方式,例如URL为 http://xxx.duapp.com/static/f1.jpg ,那么 (.*) 匹配的是 f1.jpg, $1 表示第一个 (.*) 匹配的内容,这里只有一个,那就是 f1.jpg;

示例图中,有两个URL请求,

第一个是 http://xxx.duapp.com/aaa/bbb, 经WEB proxy转发后到达WEB server,WEB server根据app.conf 规则进行匹配,匹配到第二条规则,从而将其改写为  http://xxx.duapp.com/index.php, WEB server判断这是一个动态请求,继续向后转发给PHP runtime处理;PHP runtime找到应用目录下的index.php进行处理,并将结果返回给前端。

第二个是 http://xxx.duapp.com/static/xxx.jpg, 经WEB proxy转发后到达WEB server,WEB server根据app.conf 规则进行匹配,匹配到第一条规则,从而将其改写为  http://xxx.duapp.com/static/xxx.jpg(改写后的URL与原始的URL是一样的), WEB server判断这是一个静态请求,则自己到应用目录下的static子目录中,找到 xxx.jpg,将其内容返回给前端。

6. app.conf 所用的正则表达式语法简介

BAE rewrite 采用的是 Lua 正则的规则。唯一不同在于将 Lua 正则的转义符号 % 替换成大家所熟悉的 \
可使用BAE规则检查器来检查你的规则

  • x    (这里 x 是指其不是这些转义字符 ^$()\.[]*+-? 之一) — 其代表了这个字符本身.
  • . 代表任何字符
  • * 与普通正则一致,贪婪匹配,即{0,}
  • + 与普通正则一致,贪婪匹配,即{1,}
  • - 非贪婪匹配,即 *?
  • ?  与普通正则一致,贪婪匹配,即{0,1}
  • \n  n 为1到9之间的数字,用于表示捕获的分组,类似与 \1
  • ^ 当在正则表达式开头时,表示匹配字符串起始位置,否则视为普通字符^
  • $  当在正则表达式结尾时,表示匹配字符串结束位置,否则视为普通字符$
  • \a 代表任何字母. 即[a-zA-Z]
  • \c 代表任何的控制字符暂不支持
  • \d 代表任何的数字字符. 即[0-9] 或 \d
  • \l 代表所有的小写字母. 即[a-z]
  • \p 代表所有的标点符号字符暂不支持
  • \s 代表所有空格,tab 字符
  • \u 代表所有的大写字母. 即[A-Z]
  • \w 代表所有的字母数字. 即[a-zA-Z0-9] 或 \w
  • \x 代表16进制数字,类似于 \x,后面需要紧跟两位16进制数字
  • \z 代表字符值是 0 的字符. 注意:值为0 的字符是无法正常表达的在表达式中,如果你要使用他,请使用 \z暂不支持
  • \x (x是任何非字母和数字的字符)代表字符 x. 这是一种标准的方式来代表应用转义字符. 任何标点符号字符(即使不是转义字符) 在其前面添加一个 \ 可以用来表示其自己 例如 \\ 表示 \ , \$ 表示 $
  • [set] 代表一个字符集合. 如果要表达一个范围集合,在范围开始的字符和结尾的字符之间使用 – , 例如要表达 3,4,5,6 这个集合 可以用 [3456] ,也可以用 [3-6] .上面提到的 \x 也可以用到集合中. 例如, [\w_] 表达所有的字母和数字加一个下划线
  • [^set] 表达所有不出现在集合内的

你可能感兴趣的:(深入浅出BAE:理解配置文件app.conf)