نحوه نصب لاراول با Nginx در اوبونتو
لاراول یک چارچوب محبوب PHP برای ساخت برنامه های وب مدرن است که از سینتکس پویا و ویژگی های قوی مانند مسیریابی، احراز هویت و مدیریت پایگاه داده پشتیبانی می کند. لاراول با نسخه های مختلف PHP کار می کند و از ادغام با سایر برنامه های backend مانند سرورهای پایگاه داده پشتیبانی می کند. استقرار لاراول با Nginx به شما امکان می دهد برنامه های با کارایی بالا و مقیاس پذیر را در محیط های تولید ارائه دهید و به شما امکان ساخت برنامه های وب مدرن را می دهد.
این مقاله نحوه استقرار لاراول با Nginx در اوبونتو ۲۴.۰۴ را توضیح می دهد. شما لاراول را نصب خواهید کرد و یک پروژه جدید برای استقرار با Nginx با استفاده از یک دامنه سفارشی مانند app.example.com. ایجاد خواهید کرد.
پیش نیازها #
قبل از شروع، شما نیاز دارید:
- یک سرور مجازی با سیستم عامل ubuntu و دسترسی root
- نصب وب سرور ngnix
- MySQL را برای استفاده به عنوان پایگاه داده backend نصب کنید.
- یک رکورد دامنه A ایجاد کنید که به آدرس IP سرور نمونه اشاره می کند، مانند
app.example.com.
ایجاد پایگاه داده MySQL برای لاراول #
لاراول از یک پایگاه داده رابطه ای برای ذخیره داده های برنامه استفاده می کند. مراحل زیر را برای راه اندازی یک پایگاه داده MySQL جدید، اضافه کردن داده های نمونه برنامه برای آزمایش و ایجاد یک کاربر پایگاه داده اختصاصی برای لاراول دنبال کنید.
- به عنوان کاربر پایگاه داده وارد کنسول MySQL شوید
root.کنسول$ sudo mysql- دستور زیر را برای به روزرسانی فهرست بسته APT اجرا کنید، در صورت عدم نصب MySQL، آن را نصب کنید و وارد کنسول پایگاه داده شوید.کنسول
$ sudo apt update && sudo apt install mysql-server -y && sudo mysql
- دستور زیر را برای به روزرسانی فهرست بسته APT اجرا کنید، در صورت عدم نصب MySQL، آن را نصب کنید و وارد کنسول پایگاه داده شوید.
- یک پایگاه داده جدید
negarnovin_demoبرای استفاده با لاراول ایجاد کنید.اس کیو الmysql> CREATE DATABASE negarnovin_demo;
negarnovin_userیک کاربر MySQL جدید با یک رمز عبور قوی ایجاد کنید .secure_passwordرمز عبور دلخواه خود را جایگزین کنید.اس کیو الmysql> CREATE USER 'negarnovin_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'secure_password';
negarnovin_userبه کاربر دسترسی کامل به پایگاه داده را اعطا کنیدnegarnovin_demo.اس کیو الmysql> GRANT ALL ON negarnovin_demo.* TO 'negarnovin_user'@'localhost';
- برای اعمال تغییرات کاربر پایگاه داده، جدول امتیازات MySQL را پاک کنید.sql
mysql> FLUSH PRIVILEGES;
- از کنسول MySQL خارج شوید.اس کیو ال
mysql> EXIT;
- به عنوان کاربر MySQL وارد شوید
negarnovin_userو در صورت درخواست، رمز عبور کاربر را وارد کنید.کنسول$ mysql -u negarnovin_user -p - تمام پایگاه های داده را فهرست کنید و تأیید کنید که
negarnovin_demoپایگاه داده در دسترس است.اس کیو الmysql> SHOW DATABASES;
خروجی :
+--------------------+ | Database | +--------------------+ | information_schema | | performance_schema | | negarnovin_demo | +--------------------+ 3 rows in set (0.00 sec) - از پایگاه داده استفاده کنید
negarnovin_demo.اس کیو الmysql> USE negarnovin_demo;
server_statsبرای ردیابی معیارهای سرور، یک ستون با ستون های فعال ایجاد کنید .اس کیو الmysql> CREATE TABLE server_stats ( id INT AUTO_INCREMENT, server_name VARCHAR(255), region VARCHAR(255), cpu_usage DECIMAL(5,2), memory_usage DECIMAL(5,2), status ENUM('active', 'maintenance', 'offline'), last_updated TIMESTAMP DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY(id) );
- داده های آزمایشی را در
server_statsجدول وارد کنید.اس کیو الmysql> INSERT INTO server_stats ( server_name, region, cpu_usage, memory_usage, status ) VALUES ('negarnovin-APP-01', 'New York', 24.50, 45.30, 'active'), ('negarnovin-DB-01', 'London', 12.75, 78.20, 'active'), ('negarnovin-WEB-01', 'Tokyo', 65.80, 89.50, 'active');
- از کنسول MySQL خارج شوید.اس کیو ال
mysql> EXIT;
نصب کامپوزر و افزونه های PHP #
لاراول برای اجرا روی سرور به Composer و افزونه های خاص PHP نیاز دارد. برای نصب PHP، Composer و تمام افزونه های PHP مورد نیاز برای لاراول، مراحل زیر را دنبال کنید.
- فهرست بسته APT را به روزرسانی کنید.کنسول
$ sudo apt update - کامپوزر و افزونه های PHP مورد نیاز برای لاراول را نصب کنید.کنسول
$ sudo apt install composer php php-curl php-fpm php-bcmath php-json php-mysql php-mbstring php-xml php-tokenizer php-zip -yدستور بالا Composer، PHP و افزونه های لازم برای Laravel را نصب می کند. بسته های نصب شده عبارتند از:
composer: یک مدیر وابستگی برای PHP.php-fpm: مدیر فرآیند PHP FastCGI که PHP را قادر می سازد به عنوان یک سرویس اجرا شود و اتصالات را از سرورهای وب مانند Nginx بپذیرد.php-mysql: PHP را به پایگاه داده MySQL متصل می کند.php-mbstringپشتیبانی از رشته های چندبایتی مورد نیاز لاراول را فعال می کند.php-curlPHP را قادر می سازد تا درخواست های HTTP را به URL های خارجی ارسال کند.php-bcmathتوابع ریاضی با دقت دلخواه را در برنامه های PHP فعال می کند.php-json: داده های JSON لازم برای APIها، جاوا اسکریپت و داده های ساختاریافته را رمزگذاری و رمزگشایی می کند.php-xml: امکان ارسال و تولید اسناد XML را در برنامه ها فراهم می کند.php-tokenizerشامل ابزارهایی برای توکن سازی کد PHP است.php-zipلاراول را قادر می سازد تا آرشیوهای فشرده را بخواند و بنویسد.zip.
- نسخه Composer نصب شده را تأیید کنید.کنسول
$ composer --versionخروجی:
Composer version 2.7.1 2024-02-09 15:26:28 ................. - نسخه PHP نصب شده را تأیید کنید.کنسول
$ php --versionخروجی :
PHP 8.3.6 (cli) (built: Mar 19 2025 10:08:38) (NTS) Copyright (c) The PHP Group ... - بسته به نسخه نصب شده مانند PHP-FPM، آن را مجدداً راه اندازی کنید
php8.3-fpm.کنسول$ sudo systemctl restart php8.3-fpm
آموزش نصب لاراول Laravel در سی پنل cPanel
ایجاد یک برنامه لاراول #
برای ایجاد یک برنامه Laravel و پیکربندی آن برای استفاده از پایگاه داده MySQL که قبلاً ایجاد کرده اید، مراحل زیر را دنبال کنید.
- به دایرکتوری خانگی کاربر خود بروید.کنسول
$ cd ~
- یک پروژه جدید لاراول مانند
negarnovin-demo. ایجاد کنید.کنسول$ composer create-project --prefer-dist laravel/laravel negarnovin-demoدستور بالا لاراول را به همراه تمام وابستگی هایش دانلود می کند و یک
negarnovin-demoدایرکتوری پروژه ایجاد می کند. - به
negarnovin-demoدایرکتوری پروژه بروید.کنسول$ cd negarnovin-demo
- یک کلید برنامه منحصر به فرد مورد نیاز برای رمزگذاری ایمن ایجاد کنید.کنسول
$ php artisan key:generateخروجی:
INFO Application key set successfully. .envفایل را با استفاده از یک ویرایشگر متن مانند ویرایشگری کهnanoاطلاعات اتصال پایگاه داده لاراول و درایور جلسه را تنظیم می کند، باز کنید .کنسول$ nano .env- بخش اول را به روزرسانی کنید تا نام پروژه شما مانند [نام پروژه] را شامل شود
negarnovin-demo، محیط را از [نام پروژه] تغییر دهیدlocalوdevelopmentآدرس اینترنتی برنامه را ازhttp://localhost[نام دامنه] به آدرس اینترنتی دامنه خود تغییر دهید. آن را با دامنه واقعی خود جایگزین کنیدapp.example.com.iniAPP_NAME=negarnovin-demo APP_ENV=development APP_KEY=base64:APPLICATION_UNIQUE_KEY APP_DEBUG=true APP_URL=http://app.example.com
- بخش اتصال پایگاه داده را به روزرسانی کنید تا اطلاعات پایگاه داده شما را شامل شود.
sqliteمقدار پیش فرض اتصال را به تغییر دهیدmysql، فیلدهای میزبان، پورت، پایگاه داده و کاربر را از حالت کامنت خارج کنید و اطلاعات پیش فرض را با جزئیات واقعی پایگاه داده MySQL خود که برای استفاده با لاراول استفاده می شود، جایگزین کنید.اینیDB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=negarnovin_demo DB_USERNAME=negarnovin_user DB_PASSWORD=secure_password SESSION_DRIVER=file
فایل را ذخیره کنید و ببندید.
- بخش اول را به روزرسانی کنید تا نام پروژه شما مانند [نام پروژه] را شامل شود
- دایرکتوری پروژه خود را
negarnovin-demoبه یک مسیر ریشه وب استاندارد مانند/var/www. (مانند .net) منتقل کنید.کنسول$ sudo mv ~/negarnovin-demo /var/www/negarnovin-demo www-dataامتیازات مالکیت کاربر و گروه Nginx را به/var/www/negarnovin-demoدایرکتوری پروژه Laravel اعطا کنید .کنسول$ sudo chown -R www-data:www-data /var/www/negarnovin-demo/var/www/negarnovin-demoحالت مجوزها را به تغییر دهید تا به کاربر امتیازات کامل برای دسترسی به دایرکتوری755اعطا شود .www-dataکنسول$ sudo chmod -R 755 /var/www/negarnovin-demo/storage
/var/www/negarnovin-demo/bootstrap/cacheحالت مجوزها را به تغییر دهید تا به کاربر امتیازات کامل برای ایجاد فایل های کش755اعطا شود .www-dataکنسول$ sudo chmod -R 755 /var/www/negarnovin-demo/bootstrap/cache
- به
/var/www/negarnovin-demoدایرکتوری پروژه بروید.کنسول$ cd /var/www/negarnovin-demo
- برای آزمایش اتصال، داده های لاراول را به پایگاه داده خود منتقل کنید.کنسول
$ php artisan migrateخروجی شما در صورت موفقیت باید مشابه تصویر زیر باشد.
................. INFO Running migrations. 0001_01_01_000000_create_users_table .......... 15ms DONE 0001_01_01_000001_create_cache_table ........... 5ms DONE .................
پیکربندی لاراول با Nginx #
Nginx از پیکربندی های بلوک سرور برای ارائه فایل های Laravel از دایرکتوری پروژه شما استفاده می کند. برای پیکربندی Laravel با Nginx با استفاده از پیکربندی میزبان مجازی جدید با بلوک سرور مورد نیاز و جزئیات اتصال PHP، مراحل زیر را دنبال کنید.
- وضعیت سرویس Nginx را مشاهده کنید و تأیید کنید که در حال اجرا است.کنسول
$ sudo systemctl status nginxخروجی:
● nginx.service - A high performance web server and a reverse proxy server Loaded: loaded (/usr/lib/systemd/system/nginx.service; enabled; preset: enabled) Active: active (running) since Mon 2025-04-21 13:08:27 UTC; 18s ago Docs: man:nginx(8) Process: 19294 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS) Process: 19296 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS) ...- دستور زیر را اجرا کنید تا Nginx نصب نشود، اگر فعال است آپاچی را متوقف کنید و سرویس Nginx را شروع کنید.کنسول
$ sudo apt install nginx -y && sudo systemctl stop apache2 && sudo systemctl start nginx
- دستور زیر را اجرا کنید تا Nginx نصب نشود، اگر فعال است آپاچی را متوقف کنید و سرویس Nginx را شروع کنید.
- یک فایل پیکربندی Nginx جدید
negarnovin-demo.confدر/etc/nginx/sites-availableدایرکتوری ایجاد کنید.کنسول$ sudo nano /etc/nginx/sites-available/negarnovin-demo.conf - پیکربندی های زیر را به
negarnovin-demo.confفایل اضافه کنید.app.example.comدامنه واقعی خود را جایگزین کنید.اینیserver { listen 80; server_name app.example.com; root /var/www/negarnovin-demo/public; add_header X-Frame-Options "SAMEORIGIN"; add_header X-XSS-Protection "1; mode=block"; add_header X-Content-Type-Options "nosniff"; 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; } location ~ \.php$ { fastcgi_pass unix:/var/run/php/php8.3-fpm.sock; fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; include fastcgi_params; } location ~ /\.(?!well-known).* { deny all; } }
فایل را ذخیره کنید و ببندید.
پیکربندی فوق، Nginx را قادر می سازد تا فایل های برنامه Laravel را با استفاده از دامنه
80شما، روی پورت HTTP ارائه دهد. این بلوک، تمام درخواست های PHP را به سوکت PHP-FPM ارسال می کند و Nginx را قادر می سازد تا به تمام فایل های برنامه Laravel ارائه دهد.app.example.comlocation ~ \.php - برای فعال کردن پیکربندی،
negarnovin-demo.confفایل را به دایرکتوری پیوند دهید ./etc/nginx/sites-enabledکنسول$ sudo ln -s /etc/nginx/sites-available/negarnovin-demo.conf /etc/nginx/sites-enabled/ - پیکربندی Nginx را برای خطاها آزمایش کنید.کنسول
$ sudo nginx -tخروجی:
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful - برای اعمال تغییرات پیکربندی، Nginx را مجدداً راه اندازی کنید.کنسول
$ sudo systemctl restart nginx - پورت HTTP را
80از طریق فایروال مجاز کنید.کنسول$ sudo ufw allow 80/tcp
- برای اعمال تغییرات فایروال، UFW را مجدداً بارگذاری کنید.کنسول
$ sudo ufw reload app.example.comبا استفاده از یک مرورگر وب مانند کروم به دامنه خود دسترسی پیدا کنید و نمایش پیش فرض صفحات لاراول را بررسی کنید.http://app.example.com
آموزش نصب لاراول
ایمن سازی لاراول با گواهی های SSL رمزگذاری شده ی معتبر Let’s Encrypt
Nginx تمام فایل های برنامه Laravel را با استفاده از HTTP که به طور پیش فرض ناامن است، ارائه می دهد. تولید گواهینامه های SSL، اتصالات HTTPS را فعال کرده و اتصال به سرور وب شما را رمزگذاری می کند. مراحل زیر را برای تولید گواهینامه های SSL قابل اعتماد Let’s Encrypt و ایمن سازی Laravel دنبال کنید.
- کلاینت Certbot Let’s Encrypt و افزونه آن را برای Nginx نصب کنید.کنسول
$ sudo apt install certbot python3-certbot-nginx -y - با استفاده از افزونه Nginx و دامنه میزبان مجازی خود، یک گواهی SSL جدید ایجاد کنید.
app.example.comدامنه واقعی و[email protected]آدرس ایمیل فعال خود را جایگزین کنید.کنسول$ sudo certbot --nginx --redirect -d app.example.com -m [email protected] --agree-tos
وقتی درخواست گواهی SSL با موفقیت انجام شود، خروجی شما باید مشابه تصویر زیر باشد.
Requesting a certificate for app.example.com Successfully received certificate. Certificate is saved at: /etc/letsencrypt/live/app.example.com/fullchain.pem Key is saved at: /etc/letsencrypt/live/app.example.com/privkey.pem This certificate expires on 2025-07-06. These files will be updated when the certificate renews. Certbot has set up a scheduled task to automatically renew this certificate in the background. Deploying certificate Successfully deployed certificate for app.example.com to /etc/nginx/sites-enabled/negarnovin-demo.conf Congratulations! You have successfully enabled HTTPS on https://app.example.com ... - تأیید کنید که Certbot قبل از انقضا، گواهی SSL را به طور خودکار تمدید می کند.کنسول
$ sudo certbot renew --dry-run - برای اعمال تغییرات پیکربندی SSL، Nginx را مجدداً راه اندازی کنید.کنسول
$ sudo systemctl restart nginx - پورت HTTPS را
443از طریق فایروال مجاز کنید.کنسول$ sudo ufw allow 443/tcp
- برای اعمال تغییرات فایروال، UFW را مجدداً بارگذاری کنید.کنسول
$ sudo ufw reload
ساخت یک اپلیکیشن آزمایشی لاراول #
لاراول شامل یک برنامه آزمایشی با Let's get startedصفحه ای است که می توانید آن را با کد سفارشی خود جایگزین کنید. مراحل زیر را برای جایگزینی فایل های پیش فرض پروژه دنبال کنید و یک برنامه آزمایشی لاراول با یک داشبورد کاربردی برای نمایش معیارهای سرور از پایگاه داده MySQL خود بسازید.
- فایل مسیر لاراول را باز کرده و تغییر دهید.
- از فایل پیش فرض
web.phpدر دایرکتوری پروژه لاراول خود نسخه پشتیبان تهیه کنید.کنسول$ sudo mv /var/www/negarnovin-demo/routes/web.php /var/www/negarnovin-demo/routes/web.php.ORIG web.phpدوباره فایل را ایجاد کنید .کنسول$ sudo nano /var/www/negarnovin-demo/routes/web.php- پیکربندی مسیر پیش فرض زیر را به
web.phpفایل اضافه کنید تا داده های معیارهای سرور را در پایگاه داده MySQL خود جستجو کنید.php<?php use Illuminate\Support\Facades\DB; use Illuminate\Support\Facades\Route; Route::get('/', function () { $servers = DB::table('server_stats') ->orderBy('status') ->orderBy('cpu_usage', 'desc') ->get(); return view('dashboard', ['servers' => $servers]); });
فایل را ذخیره کنید و ببندید.
کد برنامه فوق از سازنده پرس و جو لاراول برای واکشی تمام رکوردها از
server_statsجدول موجود در پایگاه داده MySQL استفاده می کند. سپس، سرورها را بر اساس وضعیت و میزان استفاده از CPU مرتب می کند و نتایج را به یک نمای داشبورد ارسال می کند. - یک قالب Blade جدید
dashboard.blade.phpبرای استفاده با نمای داشبورد ایجاد کنید.کنسول$ sudo nano /var/www/negarnovin-demo/resources/views/dashboard.blade.php - کد برنامه HTML زیر را
dashboard.blade.phpبرای نمایش معیارهای سرور به فایل اضافه کنید.html<!DOCTYPE html> <html> <head> <title>Server Dashboard | negarnovin Demo</title> <style> body { font-family: 'Segoe UI', sans-serif; margin: 2rem; } .server-card { padding: 1rem; margin-bottom: 1rem; border-radius: 8px; box-shadow: 0 2px 4px rgba(0,0,0,0.1); } .active { border-left: 4px solid #10B981; background: #F0FDF4; } .maintenance { border-left: 4px solid #F59E0B; background: #FFFBEB; } .offline { border-left: 4px solid #EF4444; background: #FEF2F2; } .metric { font-weight: 600; color: #1F2937; } </style> </head> <body> <h1>Server Status Dashboard</h1> <p>Real-time metrics from your infrastructure</p> @foreach($servers as $server) <div class="server-card {{ $server->status }}"> <h3>{{ $server->server_name }} <small>({{ $server->region }})</small></h3> <p class="metric">Status: {{ ucfirst($server->status) }}</p> @if($server->status != 'offline') <p class="metric">CPU: {{ $server->cpu_usage }}%</p> <p class="metric">Memory: {{ $server->memory_usage }}%</p> @endif <p>Last updated: {{ $server->last_updated }}</p> </div> @endforeach </body> </html>
فایل را ذخیره کنید و ببندید.
کد برنامه فوق، معیارهای سرور دریافت شده از
web.phpفایل را در یک صفحه وب واحد نمایش می دهد. - برای اعمال تغییرات، Nginx را مجدداً راه اندازی کنید.کنسول
$ sudo systemctl restart nginx - با استفاده از HTTPS در یک پنجره مرورگر وب جدید به دامنه خود دسترسی پیدا کنید و تأیید کنید که برنامه Laravel با داده های پایگاه داده MySQL به درستی نمایش داده می شود.
https://app.example.com
نتیجه گیری #
شما لاراول را به همراه Nginx روی اوبونتو ۲۴.۰۴ مستقر کرده اید و یک برنامه نمونه ایجاد کرده اید که از پایگاه داده MySQL برای نمایش داده های زنده پرس وجو می کند. می توانید پروژه لاراول خود را با مدل ها، نماها و کنترل کننده های جدید تغییر دهید تا برنامه های خود را با Nginx ارائه دهید. برای اطلاعات بیشتر و گزینه های پیکربندی، به مستندات رسمی لاراول مراجعه کنید .


