架設 Nginx + PHP FastCGI 於 Ubuntu Linux 10.04

Nginx 是比較輕巧的 HTTP Server, 此篇主要架設環境是於 Ubuntu Linux 10.04, Debian Linux.

Nginx 與 Apache 效能比較

• Nginx 跟 Apache 效能到底差多少, 此篇文章有清楚的圖文說明: [原]nginx折騰記（HTTP性能測試，與 Apache 對比）

Nginx 文件參考

• Nginx Configuration - Config
• Nginx VirtualHostExample - Virtualhost
• Nginx PHPFcgiExample - 設定 php cgi 支援(推薦)
• Nginx Modules
• Nginx FullExample - Full example
• Nginx RewriteMultiCondExample - Rewirte

Nginx + PHP CGI 安裝步驟

下述是 Nginx + PHP5 CGI 安裝步驟, 假設 Web server 的專案目錄是 /var/www/example.

1. apt-get update
2. apt-get install php5-cgi
3. apt-get install nginx
4. vim /etc/init.d/php-fcgi # 建立 PHP CGI 開機啟動 Script
   View Raw Code?

   1. #!/bin/bash
   2. BIND=127.0.0.1:9000
   3. USER=www-data
   4. PHP_FCGI_CHILDREN=15
   5. PHP_FCGI_MAX_REQUESTS=1000
   7. PHP_CGI=/usr/bin/php-cgi
   8. PHP_CGI_NAME=`basename $PHP_CGI`
   9. PHP_CGI_ARGS="- USER=$USER PATH=/usr/bin PHP_FCGI_CHILDREN=$PHP_FCGI_CHILDREN PHP_FCGI_MAX_REQUESTS=$PHP_FCGI_MAX_REQUESTS $PHP_CGI -b $BIND"
   10. RETVAL=0
   12. start() {
   13. echo -n "Starting PHP FastCGI: "
   14. start-stop-daemon --quiet --start --background --chuid "$USER" --exec /usr/bin/env -- $PHP_CGI_ARGS
   15. RETVAL=$?
   16. echo "$PHP_CGI_NAME."
   17. }
   19. stop() {
   20. echo -n "Stopping PHP FastCGI: "
   21. killall -q -w -u $USER $PHP_CGI
   22. RETVAL=$?
   23. echo "$PHP_CGI_NAME."
   24. }
   26. case "$1" in
   27. start)
   28. start
   29. ;;
   31. stop)
   32. stop
   33. ;;
   35. restart)
   36. stop
   37. start
   38. ;;
   40. *)
   41. echo "Usage: php-fastcgi {start|stop|restart}"
   42. exit 1
   43. ;;
   44. esac
   45. exit $RETVAL
5. chmod +x /etc/init.d/php-fcgi
6. update-rc.d php-fcgi defaults # 開機自動啟動 php-fcgi
7. mkdir /var/www/example # Web 根目錄
8. vim /var/www/example/index.php
   View Raw Code?

   1. <?php
   2. phpinfo();
   3. ?>
9. vim /etc/nginx/sites-available/www # 設定 Nginx VirtualHost,下述包含常用設定範例
   View Raw Code?

   1. server {
   2. listen   80;
   3. server_name  example.com;
   4. root /var/www/example;
   6. charset utf-8;
   7. error_page  404  /404.html;
   8. access_log  /var/log/nginx/example.access.log;
   9. error_log  /var/log/nginx/example.error.log;
   11. location / {
   12. # root   /var/www/example;
   13. index  index.html index.htm;
   14. }
   16. # 只有 127.0.0.1 可以存取, 其它擋掉
   17. location /doc {
   18. root   /usr/share;
   19. autoindex on;
   20. allow 127.0.0.1;
   21. deny all;
   22. }
   24. # 開啟檔案索引列表
   25. location /images {
   26. root   /usr/share;
   27. autoindex on;
   28. }
   30. # 設定靜態檔案 expires 時間
   31. location ~* ^.+.(jpg|jpeg|gif|css|png|js|ico|html)$ {
   32. access_log   off;
   33. expires         30d;
   34. }
   36. # rewrite 下述寫法, 執行 "/forum/" 時, 一樣可以跑到下面的 "location /forum/", 而不會被上面的 "/" 裡面的 "^/.*" 影響
   37. # 而 "/" 裡面的 "^/.*", 一樣可以把所有沒寫到 location 的檔案全部納進來.
   38. # rewrite /
   39. location / {
   40. if (!-e $request_filename) {
   41. rewrite ^/form3/topic/(.*)$ /index.php?q=$1 last;
   42. rewrite ^/form3/forum/(.*)$ /forums/a.php?q=$1 last;
   43. rewrite ^/form3 /index.php?q=xxx last;
   44. rewrite ^/.* /index.php?q=xxx last;
   45. break;
   46. }
   47. }
   49. # rewrite /forum/
   50. location /forum/ {
   51. if (!-e $request_filename) {
   52. rewrite ^/forum/topic/(.*)$ /index.php?q=$1&$query_string last;
   53. rewrite ^/forum/forum/(.*)$ /forums/a.php?q=$1&$query_string last;
   54. rewrite ^/forum/ /index.php?$query_string last;
   55. break;
   56. }
   57. }
   59. location ~ \.php$ {
   60. fastcgi_pass   127.0.0.1:9000;
   61. fastcgi_index  index.php;
   62. #fastcgi_param  SCRIPT_FILENAME  /var/www/example$fastcgi_script_name;
   63. fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
   64. #fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;
   65. include fastcgi_params;
   67. # 若上傳的目錄, 怕使用者傳 *.php 上來, 可以用此設定來避免危險 (網址是 /images/, 就不會經過 PHP 編譯執行)
   68. if ($uri !~ "^/images/") {
   69. fastcgi_pass 127.0.0.1:9000;
   70. }
   71. }
   72. }
10. ln -s /etc/nginx/sites-available/www /etc/nginx/sites-enabled/www # 設定啟動 www
11. /etc/init.d/nginx configtest # 測試設定檔是否有錯誤
12. /etc/init.d/php-fcgi start # 啟動 PHP cgi
13. /etc/init.d/nginx restart # 啟動 Nginx
14. http://example.com/index.php # 就可以看到標準 phpinfo() 的畫面囉~ 到此即完成.

問題排除

1. 若出現 No input file specified. 的錯誤, 可做下述設定試試看
   

   $ vim /etc/php5/conf.d/nginx.ini # 寫入下述內容
   cgi.fix_pathinfo=1
   doc_root=

2. 若發現 $_SERVER['DOCUMENT_ROOT'] 跟正常應該出現的 DOCUMENT_ROOT 值不同, 則於設定檔加入: (於 "server {}" 層級, 上述範例已經有加入)
   

   root /var/www/example; # "/var/www/example" 請替換成實際路徑

3. 要使用像 Apache ServerAlias 的話, 要怎麼設定?
   

   server_name   example.com alias.example.com;

4. nginx.conf 的 worker_processes 要設多少?
   

   worker_processes 一般是與 CPU n核 的數量相同即可.

5. nginx.conf 的 event 設定?
   View Raw Code?

   1. events {
   2. use epoll; # Linux 效能最佳的 event 模式
   3. worker_connections  1024; # 每個 process 允許最大的同時連線數
   4. }
6. 用 php cgi 跑的模式, 於 $_GET, $_POST, $_REQUEST 取得的值, 需要做 urldecode().
   

   特別是參數列有遇到空白, 會變成 "+", 若這個值有需要去找某些資料, 就會出問題~

關於 Nginx 效能 的 相關網頁

• WordPress and bbPress nice URL rewrite for Nginx
• nginx rewrite 參數
• nginx rewrite 的一些參數
• nginx rewrite 參數和例子
• Nginx rewrite rules with wpmu, wp super cache, bbpress and sitemaps support

關於 Nginx + Awstats 分析 的 相關網頁

• nginx + Awstats 日誌分析（與網上流傳的不同）
• 使用 awstats 分析 Nginx 的訪問日誌

相關網頁

• Top 20 Nginx WebServer Best Security Practices - Nginx 安全該注意的設定(推薦)
• Nginx 建置小記
• nginx 中文網
• nginx 小設置
• Nginx 0.5.31 + PHP 5.2.4（FastCGI）搭建可承受3萬以上併發連接數，勝過Apache 10倍的Web服務器[原創]
• Nginx 0.5.33 + PHP 5.2.5（FastCGI）搭建勝過Apache 10倍的Web服務器（第2版）[原創]
• nginx + PHP + FastCGI：輕型網頁伺服器
• linux(CentOS 5.3) 下LNMP(linux+nginx+mysql+php)環境的搭建(原創)
• Nginx and PHP-FastCGI on Ubuntu 10.10 (Maverick)

作者: Tsung

對新奇的事物都很有興趣, 喜歡簡單的東西, 過簡單的生活. 檢視「Tsung」的全部文章