在配置和除錯nginx.conf中的location時，有一個非常有用的模組可以安裝，
那就是echo-nginx-module，它可以在location中直接使用類似linux shell命令echo一樣的指令，幫助驗證location配置是否符合預期。我在配置location的過程中，就遇到過奇怪的問題，最後發現因為程式碼走錯了location。

• 下載nginx原始碼

  mkdir nginx_1_12_1
  git clone https://github.com/nginx/nginx/tree/branches/stable-1.12

• 使用預設選項配置，編譯，安裝nginx

  ./configure
  sudo
   
   make
  sudo make install

  一切正常的話，會在/usr/local/nginx目錄下安裝好nginx.
  使用下面命令啟動nginx.

  cd /usr/local/nginx/sbin
  ./nginx

  如果啟動正常的話，可以檢視到nginx啟動了兩個程序，master和worker程序。

  root@rex-VirtualBox:/usr/local/nginx/sbin# ps ax|grep "nginx"
  6347 ?        Ss     0:00 nginx: master process ./nginx
  6498 ?        S      0:00 nginx: worker process
  6803
   
   pts/2    S+     0:00 grep --color=auto nginx
  

• 開啟瀏覽器，輸入127.0.0.1，可以看到nginx的歡迎頁面。

  

• 下載echo-nginx-module模組，這裡我把它作為我nginx倉庫的一個子模組來管理。

  cd nginx_1_12_1
  git submodule add git@github.com:openresty/echo-nginx-module.git

• 重新配置nginx,把echo-nginx-module模組編譯進nginx可執行檔案

  sudo ./configure --add-module=echo-nginx-module
  sudo
   
   make
  sudo make install

• 修改/usr/local/nginx/conf/nginx.conf, 在server塊中增加下面語句

      location /hello {                                                                                                           
          echo -n "hello, ";
          echo "world!";
      }
      location /timed_hello {
          echo_reset_timer;
          echo_sleep 1.4;
          echo hello world;
          echo "'hello world' takes about $echo_timer_elapsed sec.";
          echo_reset_timer;
          echo hiya igor;
          echo "'hiya igor' takes about $echo_timer_elapsed sec.";
      }   
  

• 重新載入nginx的配置執行

  cd /usr/local/nginx/sbin
  nginx -s reload

• 測試echo-nginx-module

  rex@rex-VirtualBox:~/work/nginx_1_12_1$ curl  http://127.0.0.1/hello
  hello, world!
  rex@rex-VirtualBox:~/work/nginx_1_12_1$ curl  http://127.0.0.1/timed_hello
  hello world
  'hello world' takes about 1.402 sec.
  hiya igor
  'hiya igor' takes about 0.000 sec.

  從這個簡單的demo中，就有兩個echo-nginx-module的使用場景，

  • 使用echo指令，可以直觀地檢視到呼叫不同的URL及對應的location
  • 可以利用echo_reset_timer指令和變數echo_timer_elapsed，方便地進行計時，這樣就可以對某些命令對執行時間進行衡量。

  當然，我相信echo-nginx-module有更多的用途，具體執行的說明可以參考官方網站。