پیکربندی Nginx برای Laravel — php-fpm، root و بهینه‌سازی

Apache با mod_php در XAMPP آسان است؛ در production اوبونتو معمولاً Nginx + php-fpm است — سبک‌تر و concurrent بهتر. Laravel فقط از public/ سرو شود؛ بقیه پوشه‌ها نباید web-accessible باشند.

ساختار کلی

Client → Nginx :80/443 → fastcgi → php-fpm → Laravel bootstrap

server block پایه

server {
    listen 80;
    server_name example.com;
    root /var/www/portfolio/public;

    index index.php;
    charset utf-8;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }

    error_page 404 /index.php;

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
        fastcgi_hide_header X-Powered-By;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}

چرا public root؟

.env و storage بیرون document root — امنیت.

try_files ضروری

بدون آن routeهای Laravel 404 می‌دهند — همه به index.php front controller.

client_max_body_size

client_max_body_size 20M;

آپلود فایل — هماهنگ با PHP upload_max_filesize.

gzip

gzip on;
gzip_types text/plain text/css application/json application/javascript;

php-fpm pool

pm = dynamic
pm.max_children = 20
pm.start_servers = 4

تنظیم بر اساس RAM — monitor با htop.

با Docker Compose

fastcgi_pass app:9000;

نام service به‌جای unix socket — Compose.

static asset

location ~* \.(js|css|png|jpg|webp)$ {
    expires 30d;
    access_log off;
}

یا CDN — بهینه‌سازی.

اشتباهات

• root روی پوشه پروژه نه public
• fastcgi_param اشتباه — open_basedir error
• فراموش کردن deny hidden files

جمع‌بندی

SSL: Let us Encrypt. Deploy کامل: Ubuntu. Cron: Scheduled tasks.

تنظیم Nginx سرور