📄 محتوای کامل
لاراول یک چارچوب محبوب 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 و پیکربندی آن برای استفاده از پایگاه داده 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. iniکپیAPP_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 ارائه دهید. برای اطلاعات بیشتر و گزینه های پیکربندی، به مستندات رسمی لاراول مراجعه کنید .