PHP MVC Framework 搭配 Nginx + PHP-FPM 設定檔

相信大家都知道

Nginx 搭配 PHP-FPM 用起來效能還不錯，這次來筆記如何設定 Nginx 去除 PHP MVC Framework 討厭的 index.php 字串，不管是 Laravel 或 CodeIgniter 教學文件都是在 Apache 設定 .htaccess 來達成 Cleaner URL，Apache 最大好處支援 .htaccess，但是 Nginx 也有強大的效能，此篇紀錄如何設定 Nginx 達成 mod_rewrite 效果。

首先來看看 apache .htaccess 是如何設定:


     RewriteEngine on

     RewriteCond %{REQUEST_FILENAME} !-f
     RewriteCond %{REQUEST_FILENAME} !-d

     RewriteRule ^(.*)$ index.php/$1 [L]

上面的意思就是代表如果該 URL 是不存在的檔案或者是目錄就全部導向 index.php，如果在

Ubuntu 底下可能會產生 Loop，請把 .htaccess 改成底下

Options +FollowSymLinks
RewriteEngine on

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

RewriteRule . index.php [L]

接著 Nginx 是如何設定呢？打開虛擬主機設定檔

/etc/nginx/sites-available/xxxx，將底下設定寫入

server {
    listen       80;
    server_name  laravel.wuboy.twbbs.org;
    root         /usr/home/git/laravel/public;

    access_log /var/log/nginx/laravel_access.log;
    error_log /var/log/nginx/laravel_error.log;

    location / {
        index  index.php index.html index.htm;
    }

    if ($request_uri ~* index/?$)
    {
        rewrite ^/(.*)/index/?$ /$1 permanent;
    }

    # removes trailing slashes (prevents SEO duplicate content issues)
    if (!-d $request_filename)
    {
        rewrite ^/(.+)/$ /$1 permanent;
    }

    # removes access to "system" folder, also allows a "System.php" controller
    if ($request_uri ~* ^/system)
    {
        rewrite ^/(.*)$ /index.php?/$1 last;
        break;
    }

    # unless the request is for a valid file (image, js, css, etc.), send to bootstrap
    if (!-e $request_filename)
    {
        rewrite ^/(.*)$ /index.php?/$1 last;
        break;
    }

    # catch all
    error_page 404 /index.php;

    # use fastcgi for all php files
    location ~ \.php$
    {
        fastcgi_pass unix:/tmp/php-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include /usr/local/etc/nginx/fastcgi_params;
        fastcgi_param HTTPS off;
    }

    # deny access to apache .htaccess files
    location ~ /\.ht
    {
        deny all;
    }
}

基本上按照上面的設定，你就可以成功移除 index.php 字眼，底下來解釋此設定檔

if ($request_uri ~* index/?$)
{
    rewrite ^/(.*)/index/?$ /$1 permanent;
}

此設定會將 /controller/index 轉成 /controller，因為每一個 Controller 預設的 method 就是 index，所以我想也不用特別顯示在 URL 上面。permanent 所代表就是 301 轉向。

if (!-d $request_filename)
{
    rewrite ^/(.+)/$ /$1 permanent;
}

此設定會將 URL 最後的 Slash 給拿掉，防止 SEO 取得重複資訊。

if ($request_uri ~* ^/system)
{
    rewrite ^/(.*)$ /index.php?/$1 last;
    break;
}

此設定是禁止存取 system 目錄，此目錄是 CodeIgniter 核心目錄，那 Laravel 沒有此問題，因為你的虛擬主機一定會指向 public 目錄，所以也無法存取上層 Laravel 核心目錄

if (!-e $request_filename)
{
    rewrite ^/(.*)$ /index.php?/$1 last;
    break;
}

此設定來到 URL 最後判斷，如果 URL 連結並非是實體檔案，則全部導向 /index.php?/$1，也就完成了 Cleaner URL 動作，最下面設定了 PHP-FPM Socket Server，這邊就不多說了，設定檔給大家參考，如果有任何問題請留言。

See also