#!/usr/bin/python
#coding=utf-8
'''
程序员对于代码都有一种后天形成的敏感，代码是程序员的一种逻辑思维的体现，写程序这门活深深的影响了程序员对这个世界的思考方式，因此导致看代码反而比普通的文章来的更容易接受些（此结论纯属个人推测）
在此尝试以python程序的方式来写本文，好处是让自己更熟悉python，自己看起来更容易接受信息。坏处是没学过python的人可能有点儿不习惯，不过python基础语法还是非常简单的。
'''

def what_is_Nginx():
    '''
    1.什么是Nginx:
    Nginx（发音同 engine x）是一款轻量级的Web 服务器/反向代理服务器及电子邮件（IMAP/POP3）代理服务器，并在一个BSD-like 协议下发行。（百度百科定义）
    '''
    print(what_is_Nginx.__doc__)

def who_is_the_author():
    '''
    2.Nginx的作者:
     俄罗斯人Igor Sysoev 在2004年10月4日发布第一个公开版本0.1.0。
    '''
    print(who_is_the_author.__doc__)

def what_is_the_advantage():
    '''
    3.Nginx的有点:
    Nginx 可以在大多数 Unix like OS 上编译运行，并有 Windows 移植版。 Nginx 的1.4.0稳定版已经于2013年4月24日发布，一般情况下，对于新建站点，建议使用最新稳定版作为生产版本，已有站点的升级急迫性不高。Nginx 的源代码使用 2-clause BSD-like license。
    Nginx 是一个很强大的高性能Web和反向代理服务器，它具有很多非常优越的特性：
    在高连接并发的情况下，Nginx是Apache服务器不错的替代品：Nginx在美国是做虚拟主机生意的老板们经常选择的软件平台之一。能够支持高达 50,000 个并发连接数的响应，感谢Nginx为我们选择了 epoll and kqueue作为开发模型。
    Nginx作为负载均衡服务器：Nginx 既可以在内部直接支持 Rails 和 PHP 程序对外进行服务，也可以支持作为 HTTP代理服务器对外进行服务。Nginx采用C进行编写，不论是系统资源开销还是CPU使用效率都比 Perlbal 要好很多。
    Nginx代码完全用C语言从头写成，已经移植到许多体系结构和操作系统，包括：Linux、FreeBSD、Solaris、Mac OS X、AIX以及Microsoft Windows。Nginx有自己的函数库，并且除了zlib、PCRE和OpenSSL之外，标准模块只使用系统C库函数。而且，如果不需要或者考虑到潜在的授权冲突，可以不使用这些第三方库。
    作为邮件代理服务器：Nginx 同时也是一个非常优秀的邮件代理服务器（最早开发这个产品的目的之一也是作为邮件代理服务器），Last. fm 描述了成功并且美妙的使用经验。
Nginx 是一个安装非常的简单，配置文件非常简洁（还能够支持perl语法），Bugs非常少的服务器：Nginx 启动特别容易，并且几乎可以做到7*24不间断运行，即使运行数个月也不需要重新启动。你还能够不间断服务的情况下进行软件版本的升级。
    '''
    print(what_is_the_advantage.__doc__)

def how_to_use_Nginx():
    '''
    4.怎样使用Nginx:
    未完成
    '''
    print(how_to_use_Nginx.__doc__)


class NginxFunctions:
    def test(self):
        self.what_are_the_support_os()
        self.what_are_the_structure_and_expand()
        
    def what_are_the_support_os(self):
        '''
    Nginx支持的系统：
    FreeBSD 3.x,4.x,5.x,6.x i386; FreeBSD 5.x,6.x amd64;
    Linux 2.2,2.4,2.6 i386; Linux 2.6 amd64;
    Solaris 8 i386; Solaris 9 i386 and sun4u; Solaris 10 i386;
    MacOS X （10.4） PPC;
    Windows XP，Windows Server 2003和Windows 7中。
        '''
        print(self.what_are_the_support_os.__doc__)

    def what_are_the_structure_and_expand(self):
        '''
    结构与扩展：
    一个主进程和多个工作进程。工作进程是单线程的，且不需要特殊授权即可运行；
    kqueue (FreeBSD 4.1+),epoll (Linux 2.6+),rt signals (Linux 2.2.19+),/dev/poll (Solaris 7 11/99+),select，以及 poll 支持；
    kqueue支持的不同功能包括 EV_CLEAR,EV_DISABLE （临时禁止事件）， NOTE_LOWAT,EV_EOF，有效数据的数目，错误代码；
    sendfile (FreeBSD 3.1+),sendfile (Linux 2.2+),sendfile64 (Linux 2.4.21+），和 sendfilev (Solaris 8 7/01+) 支持；
    输入过滤 (FreeBSD 4.1+) 以及 TCP_DEFER_ACCEPT (Linux 2.4+) 支持；
    10,000 非活动的 HTTP keep-alive 连接仅需要 2.5M内存。
    最小化的数据拷贝操作；
    其他HTTP功能：
    基于IP 和名称的虚拟主机服务；
    Memcached 的 GET 接口；
    支持 keep-alive 和管道连接；
    灵活简单的配置；
    重新配置和在线升级而无须中断客户的工作进程；
    可定制的访问日志，日志写入缓存，以及快捷的日志回卷；
    4xx-5xx错误代码重定向；
    基于 PCRE 的 rewrite 重写模块；
    基于客户端IP 地址和 HTTP 基本认证的访问控制；
    PUT,DELETE，和 MKCOL 方法；
    支持 FLV （Flash 视频）；
    带宽限制；
        '''
        print(self.what_are_the_structure_and_expand.__doc__)

class NginxSkills:
    def test(self):
        self.does_nginx_support_chroot()
        self.what_shall_we_do_when_something_not_work()
        self.practice_Nginx_reverse_proxy()

    def does_nginx_support_chroot(self):
        '''
    Nginx是否支持chroot：
    在什么情况下使用Nginx比使用squid要好? 反之亦然。
    大体上来说nginx主要用于反向加速代理而不是像squid那样做为常规代理服务器。Nginx的最大优势在于高负载情况下内存和CPU的低消耗。我不认为squid能给你带来比nginx更好的性能。
    有没有人能给出一个完整的.conf配置文件来详细的解读一下怎么配置和测试 IMAP模块， 而不只是关于 IMAP 的只言片语啊?
    依照 [NginxImapProxyExample] 开始你的配置. 关于不同配置参数的具体信息，请查看 [NginxMailCoreModule] 页。
    示例1: 用运行于apache上的php脚本做后端验证
    示例2: 使用运行于同一个服务器的 nginx-embedded-perl模块作为 imap/pop代理和认证后端
        '''
        print(self.does_nginx_support_chroot.__doc__)

    def what_shall_we_do_when_something_not_work(self):
        '''
    当有些东西不工作时怎么办：
    （URL重写，代理，路径，...)
    例如：如URL重写（rewrite）不工作了或者是unix的路径（/$PATH）的问题云云...
    请仔细阅读 [NginxDebugging] 并且 逐行 查看错误日志。
    如果你没找到错误 打起精神 试着到IRC或邮件列表里说明一下你碰到的问题。
    有没有其它类似的Web服务器
    Cherokee
    Lighttpd (Lighty)
    thttpd
    关于各自的优缺点请使用自己喜欢的搜索引擎查找
        '''
        print(self.what_shall_we_do_when_something_not_work.__doc__)
    def practice_Nginx_reverse_proxy(self):
        '''
        NGinx反向代理实践：
	[1]. nginx + substitutions 安装
	　　nginx 自带一个Substitution模块，但该模块只能写一行，所以我们改用 substitutions
	　　下面是安装一些预备软件
	yum -y --noplugins install wget zip
	yum -y --noplugins install unzip
	yum -y --noplugins install gcc
	yum -y --noplugins install make
	yum -y --noplugins install pcre-devel
	yum -y --noplugins install openssl-devel
	编译软件
	tar zxf nginx-1.0.8.tar.gz
	cd nginx-1.0.8.tar.gz
	./configure ./configure --add-module=path/substitutions4nginx-read-only //注意这里的path是相对应的真实路径
	make
	make install
	配置 nginx.conf
	此时，nginx应该安装在于 /usr/local/nginx 下面
	server_name servername;
	location / {
	subs_filter ca-pub-********** ca-pub-**********; //把google ad 的用户号 ca-pub-9805743306566114 改成你自己的，比如 ca-pub-**********
	subs_filter ********** **********; //把google ad 的广告号 **********改成你自己的，比如 **********，你懂的！：D
	proxy_pass 这里是填写需要代理的网址; //反向代理站。
	index index.html index.htm;
	}
	记住subs_filter 命令的格式即可随意发挥想象力替换你想替换的广告、超链接，等等。[1]
        '''
        print(self.practice_Nginx_reverse_proxy.__doc__)


def test():
    what_is_Nginx()
    who_is_the_author()
    what_is_the_advantage()
    how_to_use_Nginx()
    nginx_skills = NginxSkills()
    nginx_skills.test()
    
    NginxFunctions().test()

if __name__ == '__main__':
    print __doc__
    test()