آموزش گام به گام نصب لاراول روی ویندوز (با XAMPP و Laragon)

مقدمه‌ای ساده و کاربردی برای شروع کار با لاراول، نقطه‌ای مناسب برای ورود به دنیای توسعه وب است. این مقاله یک راهنمای کامل برای نصب لاراول روی ویندوز ارائه می‌دهد تا بتوانید محیطی پایدار و آماده برای کدنویسی ایجاد کنید. در این مسیر دو روش محبوب معرفی می‌شود: XAMPP که برای درک بهتر سازوکارها مناسب است و Laragon که سرعت و راحتی بیشتری دارد. سپس مراحل راه اندازی لاراول به‌صورت گام‌به‌گام توضیح داده می‌شود تا شروع پروژه‌ها ساده و بدون مشکل باشد. در نهایت، این مقاله به‌عنوان اولین قدم در آموزش لاراول شما محسوب می‌شود و مسیر ساده و روشنی برای شروع توسعه پروژه‌های حرفه‌ای فراهم می‌کند.

پیش‌نیازهای ضروری قبل از شروع نصب لاراول

قبل از اینکه فرآیند نصب و کار با لاراول را آغاز کنید، لازم است محیط سیستم خود را به‌طور کامل آماده کنید. رعایت این پیش نیازهای نصب لاراول باعث می‌شود در طول کار با خطاها و مشکلات غیرمنتظره روبه‌رو نشوید. در ادامه هر مورد به‌طور ساده و کامل توضیح داده شده است:

• دسترسی ادمین (Administrator) به ویندوز
  برای نصب بسیاری از ابزارها و اجرای دستورات سیستمی، نیاز به دسترسی کامل یا همان ادمین دارید. اگر این دسترسی فعال نباشد، بعضی از مراحل نصب متوقف می‌شود یا خطا ایجاد می‌کند. بنابراین بهتر است مطمئن شوید که با یک حساب کاربری ادمین وارد ویندوز شده‌اید.
  
  

• غیرفعال کردن Hyper-V (در صورت وجود)
  Hyper-V ابزاری در ویندوز است که برای مجازی‌سازی استفاده می‌شود. اما وجود آن ممکن است باعث ناسازگاری با برخی نرم‌افزارهای مورد نیاز لاراول شود. اگر فعال باشد، بهتر است آن را خاموش کنید تا محیط توسعه بدون مشکل اجرا گردد.
  
  

• آشنایی اولیه با خط فرمان (Command Prompt یا Terminal)
  بیشتر مراحل نصب و راه اندازی لاراول از طریق خط فرمان انجام می‌شود. نیازی نیست متخصص باشید، اما دانستن دستورات پایه مثل تغییر مسیر پوشه‌ها یا اجرای دستور PHP، کار را خیلی راحت‌تر می‌کند.
  
  

• دانلود یک ویرایشگر کد مناسب مانند VS Code
  برای نوشتن کد، داشتن یک ویرایشگر حرفه‌ای ضروری است. VS Code انتخابی محبوب است چون سبک، سریع و پر از افزونه‌های کاربردی است. این ابزار به شما کمک می‌کند راحت‌تر کدنویسی کنید، خطاها را پیدا کنید و پروژه‌ها را بهتر مدیریت نمایید.
  
  

با رعایت این موارد، مطمئن خواهید شد که سیستم مورد نیاز لاراول به بهترین شکل آماده است و می‌توانید بدون دردسر وارد دنیای توسعه با این فریم‌ورک قدرتمند شوید.

قدم اول: نصب Composer، مدیر پکیج PHP

Composer یک ابزار بسیار مهم برای برنامه‌نویسی با PHP است. این برنامه به شما کمک می‌کند کتابخانه‌ها و بسته‌های مورد نیاز پروژه‌ها را مدیریت کنید و آن‌ها را به‌صورت خودکار به‌روز نگه دارید. برای فریم‌ورک لاراول، استفاده از Composer ضروری است؛ زیرا بدون آن نمی‌توانید بسته‌ها و وابستگی‌های لاراول را نصب یا بروزرسانی کنید. بنابراین، نصب composer در ویندوز اولین قدم برای شروع کار با لاراول است.

برای شروع، ابتدا به وب‌سایت رسمی Composer مراجعه کنید و فایل نصب به نام Composer-Setup.exe را دانلود کنید. این فایل نصب کار را بسیار ساده می‌کند و همه مراحل را به‌صورت گرافیکی راهنمایی می‌کند.

بعد از اتمام نصب، باید مطمئن شوید همه چیز درست کار می‌کند. برای این کار CMD (برای اجرا از استارت ویندوز cmd را سرچ کنید) را باز کرده و دستور زیر را تایپ کنید:

composer

اگر نصب موفقیت‌آمیز باشد، لیستی از دستورات و نسخه Composer نمایش داده می‌شود. این مرحله، اولین گام عملی در مسیر کار با لاراول و بخش مهمی از آموزش composer است.

با انجام این مراحل، محیط شما آماده مدیریت بسته‌ها و شروع توسعه پروژه‌های لاراول خواهد بود.

قدم دوم: انتخاب و نصب سرور محلی (Local Server)

برای اجرای پروژه‌های لاراول، نیاز به یک سرور محلی لاراول داریم که بتواند PHP و MySQL را به‌درستی مدیریت کند. این سرور محیطی شبیه‌سازی‌شده از وب‌سرور واقعی فراهم می‌کند و امکان تست و توسعه پروژه‌ها را بدون نیاز به اینترنت می‌دهد. دو گزینه پرطرفدار برای این کار وجود دارد: XAMPP و Laragon. XAMPP بیشتر برای افرادی مناسب است که می‌خواهند تنظیمات سرور را به‌صورت دستی کنترل کنند و با جزئیات آشنا شوند. در مقابل، Laragon محیطی خودکار و سریع ارائه می‌دهد که نصب و راه‌اندازی آن تنها چند دقیقه طول می‌کشد و کار توسعه‌دهندگان را ساده می‌کند.

انتخاب هر یک از این ابزارها بستگی به نیاز و سطح آشنایی شما دارد، اما هر دو گزینه یک لوکال سرور لاراول پایدار و آماده برای شروع پروژه‌ها فراهم می‌کنند و پایه‌ای محکم برای توسعه حرفه‌ای ایجاد می‌کنند.

روش الف) نصب و راه‌اندازی با XAMPP

یکی از روش‌های محبوب برای راه‌اندازی محیط توسعه لاراول، استفاده از XAMPP است. برای شروع، ابتدا باید آخرین نسخه XAMPP را از وب‌سایت رسمی دانلود کرده و مراحل نصب آن را دنبال کنید. نصب ساده است، اما توجه به جزئیات می‌تواند از مشکلات بعدی جلوگیری کند.

پس از نصب، لازم است تنظیمات xampp برای لاراول انجام شود تا محیط کاملاً سازگار با نیازهای فریم‌ورک باشد. اولین قدم، فعال کردن اکستنشن‌های ضروری PHP در فایل php.ini است. اکستنشن‌هایی مانند fileinfo و openssl برای عملکرد صحیح لاراول الزامی هستند. پس از فعال کردن این موارد، سرور Apache و MySQL را از کنترل پنل XAMPP اجرا کنید تا محیط نصب لاراول با xampp آماده کار شود.

1. باز کردن فایل php.ini
   
   

• وارد پوشه نصب XAMPP شوید، معمولاً مسیر پیش‌فرض C:\xampp\php\php.ini است.
  
  

• فایل php.ini را با یک ویرایشگر متن مانند Notepad یا VS Code باز کنید.
  
  

2. فعال کردن اکستنشن‌های ضروری PHP
   
   

• در این فایل به دنبال خطوطی بگردید که با ;extension= شروع می‌شوند.
  
  

• به ترتیب خطوط زیر را پیدا کرده و نقطه‌ویرگول ; ابتدای هر خط را حذف کنید تا فعال شوند:
  
  

• extension=fileinfo
  
  

• extension=openssl
  
  

• همچنین در صورت نیاز می‌توانید اکستنشن‌های pdo, mbstring, tokenizer, xml, ctype را فعال کنید که اکثر پروژه‌های لاراول به آن‌ها نیاز دارند.
  
  

3. ذخیره تغییرات
   
   

• پس از فعال کردن اکستنشن‌ها، فایل را ذخیره کنید و ببندید.
  
  

4. اجرای Apache و MySQL
   
   

• کنترل پنل XAMPP را باز کنید.
  
  

• روی دکمه Start کنار Apache کلیک کنید تا وب‌سرور فعال شود.
  
  

• سپس روی دکمه Start کنار MySQL کلیک کنید تا پایگاه داده آماده کار شود.
  
  

• اگر همه چیز درست باشد، وضعیت هر دو سرویس سبز می‌شود و هیچ خطایی نمایش داده نمی‌شود.
  
  

با انجام این مراحل، محیط شما آماده نصب لاراول با xampp خواهد بود و می‌توانید پروژه‌های لاراول را بدون مشکل اجرا کنید.

روش ب) نصب و راه‌اندازی با Laragon (روش پیشنهادی)

استفاده از Laragon یکی از سریع‌ترین و راحت‌ترین روش‌ها برای راه‌اندازی محیط لاراول است. با نصب لاراول با laragon، همه ابزارهای مورد نیاز مثل PHP، MySQL، Composer و Git به‌صورت خودکار نصب می‌شوند و دیگر نیازی به تنظیمات پیچیده دستی نیست.

مراحل نصب Laragon به‌صورت ساده و مرحله‌به‌مرحله عبارتند از:

1. دانلود Laragon
   
   

• به وب‌سایت رسمی Laragon مراجعه کرده و نسخه مناسب ویندوز را دانلود کنید.
  
  

2. اجرای فایل نصب
   
   

• فایل دانلود شده (.exe) را اجرا کنید و مسیر نصب را انتخاب کنید.
  
  

• مراحل نصب بسیار ساده هستند و نیاز به تغییر تنظیمات پیچیده ندارند.
  
  

3. انتخاب نسخه PHP و MySQL
   
   

• در طول نصب، می‌توانید نسخه PHP و MySQL دلخواه خود را انتخاب کنید، اما معمولاً نسخه پیش‌فرض کافی است.
  
  

4. تکمیل نصب و باز کردن محیط Laragon
   
   

• پس از اتمام نصب، Laragon اجرا می‌شود و محیط کاربری ساده‌ای در اختیار شما قرار می‌دهد.
  
  

5. اجرای سرورها
   
   

• کافی است روی دکمه Start کلیک کنید تا هم Apache و هم MySQL اجرا شوند.
  
  

• اکنون لوکال سرور لاراول آماده کار است و می‌توانید پروژه‌های جدید خود را شروع کنید.
  
  

این روش به‌خصوص برای تازه‌کارها بسیار مناسب است و محیطی سریع، خودکار و بدون دردسر برای آموزش laragon و توسعه پروژه‌های لاراول فراهم می‌کند.

قدم سوم: نصب فریمورک لاراول

بعد از آماده کردن محیط با XAMPP یا Laragon، نوبت به ساخت پروژه جدید لاراول  می‌رسد. برای شروع، باید ترمینال یا CMD را باز کنید:

• در ویندوز، روی منوی استارت کلیک کنید و CMD را جستجو کنید و باز کنید.
  
  

• اگر از Laragon استفاده می‌کنید، از دکمه Terminal در کنترل پنل Laragon می‌توانید ترمینال را باز کنید که دسترسی مستقیم به پوشه پروژه‌ها را می‌دهد.
  
  

حالا باید وارد پوشه‌ای شوید که می‌خواهید پروژه جدید در آن ایجاد شود. برای این کار از دستور cd استفاده می‌کنیم:

cd c:\xampp\htdocs

یا

cd c:\laragon\www

اکنون دستور نصب لاراول را وارد کنید:

composer create-project laravel/laravel my-first-app

• composer create-project به Composer می‌گوید یک پروژه جدید ایجاد کند.
  
  

• laravel/laravel همان بسته رسمی لاراول است.
  
  

• my-first-app نام پروژه شما است که می‌توانید تغییر دهید.
  
  

در طول نصب ممکن است چند سوال از شما پرسیده شود. کافی است Enter بزنید تا ادامه یابد.

پس از نصب، معمولاً باید دستورات اضافی برای مدیریت پکیج‌های جاوااسکریپت نیز اجرا شود:

npm install

در این مرحله هم ممکن است از شما پرسیده شود که آیا می‌خواهید ادامه دهید یا نه؛ کافی است yes تایپ کنید یا Enter بزنید تا نصب کامل شود.

اکنون آماده توسعه، افزودن مسیرها، کنترلرها و شروع به نوشتن کدهای کاربردی هستید. این گام، پایه‌ای محکم برای هر پروژه لاراولی است و تمام ابزارهای لازم برای ساخت پروژه جدید لاراول را در اختیار شما قرار می‌دهد.

قدم چهارم: اجرای اولین پروژه لاراول

پس از نصب و راه‌اندازی موفقیت‌آمیز لاراول، حالا نوبت به لحظه هیجان‌انگیز است: اجرای پروژه لاراول و مشاهده نتیجه زحماتتان در مرورگر!

ابتدا ترمینال یا CMD را باز کنید و با دستور cd وارد پوشه پروژه خود شوید:

cd my-first-app

این دستور شما را به پوشه‌ای می‌برد که پروژه لاراول در آن ایجاد شده است. اکنون آماده اجرای سرور توسعه داخلی لاراول هستید. برای این کار دستور زیر را وارد کنید:

php artisan serve

• این دستور، یک سرور کوچک داخلی راه‌اندازی می‌کند که فقط برای محیط توسعه مناسب است و نیازی به تنظیمات پیچیده ندارد.
  
  

• پس از اجرای دستور، ترمینال پیامی نمایش می‌دهد که شامل آدرس پروژه است، معمولاً به شکل:
  
  

http://127.0.0.1:8000

با وارد کردن این آدرس در مرورگر، صفحه خوشامدگویی لاراول نمایش داده می‌شود. این همان صفحه معروف با لوگوی لاراول و پیامی ساده است که نشان می‌دهد همه چیز به درستی نصب و اجرا شده است.

این مرحله، اولین تجربه واقعی شما از کار با لاراول است و نقطه شروعی برای توسعه پروژه‌های واقعی محسوب می‌شود. اکنون می‌توانید مسیرهای جدید بسازید، کنترلرها و ویوها را اضافه کنید و توسعه پروژه را آغاز نمایید.

مشکلات رایج و راه‌حل‌ها

در مسیر نصب لاراول ممکن است با چند مشکل رایج روبه‌رو شوید. در ادامه، پرسش و پاسخ‌هایی ساده برای رفع این مشکلات ارائه شده است:

سؤال: هنگام اجرای دستور نصب لاراول، پیام composer is not recognized as an internal or external command نمایش داده می‌شود.
پاسخ: این خطای نصب لاراول نشان‌دهنده نصب ناقص یا عدم شناسایی Composer در متغیرهای محیطی ویندوز است. برای رفع مشکل، مطمئن شوید که Composer به‌درستی نصب شده و مسیر آن (معمولاً C:\ProgramData\ComposerSetup\bin) به PATH ویندوز اضافه شده است. سپس CMD را بسته و دوباره باز کنید.

سؤال: هنگام اجرای پروژه، پیام خطا مربوط به فعال نبودن یک اکستنشن PHP نمایش داده می‌شود.
پاسخ: بسیاری از مشکلات نصب لاراول به اکستنشن‌های فعال نشده PHP مربوط می‌شود. برای رفع آن، فایل php.ini را باز کرده و اکستنشن مورد نیاز مانند fileinfo یا openssl را فعال کنید (نقطه‌ویرگول ; ابتدای خط را حذف کنید). بعد از ذخیره تغییرات، سرور Apache را ری‌استارت کنید تا تغییرات اعمال شود.

سؤال: هنگام اجرای دستور php artisan serve، خطا می‌دهد که پورت ۸۰۰۰ مشغول است.
پاسخ: این مشکل زمانی رخ می‌دهد که سرویس دیگری از پورت ۸۰۰۰ استفاده می‌کند. برای رفع آن، می‌توانید دستور زیر را اجرا کنید تا یک پورت دیگر برای سرور لاراول استفاده شود:

php artisan serve --port=8001

با رعایت این راهکارها، بسیاری از خطای نصب لاراول و مشکلات نصب لاراول برطرف می‌شوند و محیط توسعه شما بدون مشکل آماده استفاده خواهد بود.

جمع‌بندی و قدم بعدی

تبریک می‌گوییم! با طی کردن مراحل قبلی، شما توانستید محیط توسعه لاراول را با موفقیت نصب و راه‌اندازی کنید. در این مسیر، ابتدا Composer نصب شد و مسیرهای لازم برای مدیریت پکیج‌ها آماده گردید. سپس با انتخاب یک لوکال سرور لاراول مانند XAMPP یا Laragon، محیط اجرای PHP و MySQL مهیا شد و سرور توسعه داخلی آماده بهره‌برداری شد. در ادامه، با اجرای دستور نصب لاراول، پروژه اولیه خود را ایجاد کردید و با دستور php artisan serve آن را اجرا کردید تا صفحه خوشامدگویی لاراول در مرورگر قابل مشاهده باشد.

با اتمام این مراحل، شما پایه‌ای محکم برای شروع توسعه پروژه‌های واقعی در اختیار دارید و می‌توانید به راحتی تغییرات و کدنویسی را آغاز کنید. این تجربه اولین قدم عملی در مسیر یادگیری لاراول است و زمینه را برای درک بهتر مفاهیم پیشرفته‌تر فراهم می‌کند.

در مقاله بعدی، به سراغ مفاهیم پایه‌ای مانند روتینگ، کنترلرها و ساخت ویوها خواهیم رفت تا بتوانید مسیر پروژه‌های خود را به صورت حرفه‌ای ادامه دهید. مطالعه و تمرین این مفاهیم، شما را آماده توسعه اپلیکیشن‌های پیچیده‌تر و مدیریت پروژه‌های واقعی خواهد کرد.

این مقاله لاراول به شما کمک کرد تا از نصب اولیه تا اجرای اولین پروژه، تمامی مراحل را به صورت گام‌به‌گام دنبال کنید و آماده باشید برای گام‌های بعدی در مسیر توسعه با این فریمورک قدرتمند.