akofaraji.ir
نصب و راه‌اندازی لاراول با Homestead
نوشته شده در تاریخ 20 آبان 1403
نظرات: 0 امتیاز: 10 زمان مطالعه: 28 دقیقه

۱) ملزومات سیستم

 

تمام امکاناتی که برای نصب لاراول مورد نیاز است در سیستم عامل ویندوز وجود دارد و با نصب Wamp‌ یا Xampp دسترسی به یک سرور داخلی امکان پذیر خواهد بود. اما تمام افراد و برنامه‌نویسان با ویندوز کار نمی‌کنند. بنابراین تمرکز این آموزش ارائه کدها و دستورها بر اساس ساختار سیستم عامل لینوکس و مکینتاش است. البته لازم به ذکر است که این دستورها و کدها در سیستم‌عامل ویندوز قابل اجرا هستند.

حداقل امکاناتی که برای نصب لاراول مورد نیاز است:

  • PHP نسخه 5.5.9 یا بالاتر
  • افزونه‌ی OpenSSL PHP
  • افزونه PDO PHP
  • افزونه Mbstring PHP
  • افزونه Tokenizer PHP

 

۱-۱) Composer

 

جهت توسعه نرم‌افزار خود حتما و حتما به یک Composer عمومی (گلوبال) نیاز دارید. و اما کامپوزر چیست؟

کامپوزر ابزاری ست برای مدیریت بسته های نصبی که به زبان PHP نوشته شده اند. کامپوزرها در PHP مانند npm در Node یا Ruby Gem در زبان Ruby است. در واقع با کامپوزرها می توان بسته هایی مثل لاراول، Laravel Collective, Laravel Helper و… را در فایل پروژه خود نصب و مدیریت کرد. گاها برای تعریف کامپوزر از عبارت Dependency Manager (مدیریت وابستگی ها) استفاده می شود که به معنای مدیریت تمام کتابخانه ها و وابستگی های موجود در پروژه است. لازم به ذکر است یک مدیریت بسته ی دیگر تحت عنوان PEAR (مخفف عبارت PHP Extension and Application Repository) وجود دارد ولی بنا به دلایلی توسعه دهندگان دیگر از آن استفاده نمی کنند و مهم ترین ایراد آن بروز نبودن بسیاری از بسته هاست.

 

۲-۱) Vagrant, VMWare و VirtualBox

 

اگر با ابزار Vagrant‌ آشنا نیستید باید خدمت شما عرض کنم که این ابزار به عنوان یکی از بهترین ماشین‌های مجازی‌ساز شناخته می‌شود و محیطی مجازی را به همراه نصب لاراول و تمام تنظیمات در اختیار شما قرار می‌دهد. وگرانت در دل نرم‌افزارهای شبیه‌سازی چون VMWare و VirtualBox بکار گرفته می‌شود. لازم به ذکر است که نرم‌افزارهای VMWare و VirtualBox‌ قابلیت نصب سیستم‌عامل‌هایی چون لینوکس، ویندوز و مکینتاش را  به صورت مجازی برای شما فراهم می‌کنند. به عبارت دیگر Vagrant‌ ابزاری در اختیار شما قرار می‌دهد تا ماشین مجازی خود را بدون نصب هیچگونه ابزاری در سیستم عامل خود راه‌اندازی کنید، از مزایای استفاده از این ابزار می‌توان به شبیه‌سازی محیط واقعی سرورها در بستر اینترنت، اشاره نمود. اصلا نگران نباشید زیرا Vagrant مانند یک ظرف یکبار مصرف است که هیچ آسیبی به سیستم‌عامل فعلی شما وارد نمی‌کند.

 

۳-۱) Laravel Homestead (حیاط لاراول)

 

ابزار Homestead به عنوان یکی از قوی‌ترین ابزارهای لاراول شناخته می‌شود که محیطی مجازی را در دل Vagrant در اختیار شما قرار می‌دهد. این محیط دقیقا مشابه سرورهای وی پی اس VPS (مخفف عبارت Virtual Private Server) است که بسیاری از سایت‌هایی که با لاراول نوشته شده‌اند بر روی این سرورها قرار دارند.

 

۲) نصب Homestead

 

اگر تازه‌کار هستید به شما تضمین می‌دهیم اگر با یکی از مجازی‌سازها یا شبیه‌سازهای فوق ( مثلا ترکیب VMWare و Vagrant و Homestead) لاراول را بیاموزید تجربه‌ی توسعه‌ و برنامه‌نویسی بسیار دلچسبی (بدون درنظر گرفتن اینکه چه امکاناتی روی سیستم‌عامل شما نصب است) بدست می‌آورید. فقط کافیست به امکاناتی که با نصب Homestead در اختیار شما قرار می‌دهد نگاهی بیاندازید:

  • Ubuntu 16.04
  • Git
  • PHP 7.1
  • Nginx
  • MySQL
  • MariaDB
  • Sqlite3
  • Postgres
  • Composer
  • Node به همراه Yarn, Bower, Grunt و Gulp
  • Redis
  • Memcached
  • Beanstalkd
  • Mailhog
  • ngrok

 

۱-۲) نصب پیش‌نیازهای Homestead

 

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

در مرحله‌ی بعدی پلاگین Vagrant را از این لینک دریافت کنید.

 
توجه: پس از نصب نرم‌افزار‌های فوق حتما کامپیوتر خود را Restart کنید.

پس از نصب Vagrant باید دستور زیر را در CMD ویندوز وارد کرده تا box پلاگین Vagrant فعال شود:

 

هنگامی که این دستور را وارد می‌:نید و دکمه‌ی Enter را فشار می‌دهید، متن پیام زیر که شامل لیستی از نرم‌افزارهای متناسب با Vagrant است، به نمایش گذاشته می‌شود:

 

از آنجا که ما از Virtualbox استفاده کرده‌ایم لذا گزینه‌ی ۳ را انتخاب کرده و دکمه‌ی Enter را فشار می‌دهیم. با انجام این عملیات، فرآیند دانلود و نصب این Box فراهم می‌شود. در واقع Box ها مشابه Template ها هستند. برای اینکه یک پروژه ایجاد کنید باید آن را در Box‌ مربوط به خود قرار دهید. این فرآیند بسته به سرعت اینترنت شما می‌تواند زمان‌گیر باشد. کمی صبور باشید 

 

پس از اتمام این عملیات  تمام فایل‌های مربوط به Homestead دانلود شدند (حجمی معادل حدود ۱ گیگ) که می‌توانید این فایل‌ها را در مسیر زیر مشاهده کنید:

 

۲-۲) نصب Homestead

و اما مرحله‌ی نهایی، نصب محیط واقعی Homestead است. درنظر داشته باشید که شما می‌توانید چندین Homestead مختلف نصب کنید. اما به شما پیشنهاد می‌شود که برای تمام پروژهای خود تنها یک Homestead نصب کنید. بنابراین اولین قدم برای نصب Homestead وارد کردن دستور زیر در CMD ویندوز می‌باشد:

 

درصورتی که دستور را به درستی وارد کرده باشید با پیام زیر مواجه خواهید شد:

 

و در نهایت فولدری در مسیر اولیه‌ای که مشخص کرده‌اید ظاهر خواهد شد:

 

 
توجه: مسیر فوق ممکن است در سیستم شما متفاوت باشد بنابراین همواره مسیر فولدر Homestead را برای ادامه‌ی فرآیند، پیدا کنید.

برای ادامه‌ی فرآیند ابتدا باید به وارد پوشه شوید که این کار را با دستور زیر انجام می‌دهیم:

 

در هر فولدر Homestead باید همواره اسکریپت شما یک سری مقادیر اولیه را تنظیم کند. بنابراین توسط دستور زیر اینکار را انجام می‌دهیم. بنابراین در دستور زیر به فایل init.sh‌ دسترسی پیدا خواهیم کرد:

 

راهنمایی لینوکس: عبارت bash در واقع Shell لینوکس (مشابه CMD در ویندوز) را فعال می‌کند. در واقع Bash‌ یک Command Line‌ لینوکسی است که دستورهای چاپ شده را ترجمه و اجرا می‌کند.

در نهایت با اجرای دستور فوق فایل تنظیمات اولیه Homestead تحت عنوان Homestead.yaml در دایرکتوری (فولدر) Homestead. /~ قرار می‌گیرد و پیام زیر را دریافت می‌کنید:

 

تنظیمات Homestead

 

فایل Homestead.yaml را با استفاده از یک ادیتور متن (مثلا ++Notepad) باز کنید و تنظیمات را انجام دهید.

در خطوط اول تا سوم ip و میزان memory و cpus ماشین مجازی را مشاهده می‌کنید که بهتر است مقدار cpus را به عدد ۲ ارتقاء دهید.

ابتدا باید ماشین مجازی خود را مشخص کنید. این ماشین‌های مجازی با نام‌های virtualbox, vmware_fusion, vmware_workstation, or parallels قابل دسترس هستند که در این پروژه ماشین مجازی ما virtualbox است. بنابراین برای provider داریم:

برای تنظیم کردن مسیر کلید‌های عمومی و خصوصی SSH خود باید مقدار authorize را ویرایش کنید:

 

راهنمایی: کلید‌های عمومی و خصوصی SSH‌ که به SSH Key معروف هستند برای خصوصی‌سازی پروژه در بستر کامپیوتر مورد استفاده قرار می‌گیرند یعنی اگر شما این کلید‌ها را تنظیم کنید، پروژه‌ها تنها و تنها در کامپیوتر شما (برای کامپیوترها از SSH Private Key استفاده می‌شود)  و یک سرور (برای سرورها از SSH Public Key استفاده می‌شود) مشخص قابل دسترسی هستند.

در صورتیکه بخواهید کلید SSH خود را مجددا بسازید کافی‌ست دستور زیر را در فولدر Homestead اجرا کنید (حتما این کار را انجام دهید):

 

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

 

حال باید مسیر فولدر هر وب سایت و یا وب اپلیکیشن را مشخص کنیم برای اینکار ابتدا فولدر موردنظر را در مسیری که می‌خواهیم ایجاد کرده و آن را به متغییر map: ارسال می‌کنیم، در این مثال ما فولدر Projects را داخل مسیر C:/User/YourComputerName ایجاد کرده‌ایم بنابراین دستورهای زیر را اجرا می‌کنیم:

 

و در نهایت برای تعیین کردن آدرس سایت در مرورگر خود (یعنی وب سایت شما با آدرس مثلا http://laravel.dev اجرا شود) عبارت زیر را در متغییر site ویرایش می‌کنیم:

 

حال نوبت به تعیین نام databases می‌رسد که مقدار آن را مشابه خط زیر قرار می‌دهیم:

 

بنابراین فایل Homestead.yaml به صورت زیر خواهد بود:

 

تا به اینجای کار تمام تنظیمات را به درستی انجام داده‌اید و کار شما به اتمام رسیده است. حال باید به مسیر زیر رفته و فایل hosts را با یک ادیتور متن (مثلا ++Notepad) باز کنید و ip‌ ای که در فایل Homestead.yaml بود را داخل این فایل قرار دهید تا لوکال هاست شما مجددا شناسایی شود.

 

بنابراین محتویات درون فایل hosts باید به صورت زیر باشد:

 

حال باید در CMD‌ ویندوز و در پوشه Homestead دستور زیر را تایپ کنید تا فرآیند نصب Homestead با تنظیمات مشخص شده آغاز شود:

 

توجه: در صورتیکه پس از اجرای دستور vagrant up با خطاهایی از قبلی found tab character و یا No directory found و … مواجه شدید باید در جریان باشید که قطعا یا مسیر دهی درست انجام نداده‌اید یا به جای space از دکمه‌ی tab برای فاصله دادن استفاده کرده اید. بنابراین برای کاهش خطا کد نهایی را عینا از همین صفحه کپی کرده و آن را ویرایش کنید.

اگر تمام مراحل فوق را به درستی انجام داده باشید با وارد کردن آدرس http://laravel.dev همواره با صفحه‌ی No input file specified مواجه خواهید شد. این بدین معنی‌ست که مجازی سازی شما به درستی صورت پذیرفته است و تنها باید در سرور مجازی خود نصب لاراول را انجام دهید.

پس از مشاهده پیغام فوق و تایید صحت نصب Vagrant و Homestead حال نوبت به نصب لاراول می‌رسد. برای نصب لاراول دو راه وجود دارد:

  1. نصب لاراول با VirtualBox
  2. نصب لاراول با vagrant ssh (پیشنهاد ما)

در هر صورت شما با خط فرمان Vagrant کار می‌کنید و باید به دستورات این خط فرمان آشنایی مقدماتی داشته باشید. در ادامه به توضیح برخی از فرمان‌های Vagrant می‌پردازیم:

  • vagrant up: اجرا کردن Homestead
  • vagrant suspent:‌ همانند Hibernating (خاموشی موقت) در ویندوز
  • vagrant halt:‌ همانند Shut Down کردن در ویندوز
  • vagrant destory: همانند Format کردن در ویندوز (فرمت کردن یک درایو یا فولدر)
  • vargant provision:‌ همانند Restart کردن در ویندوز

۱-۳) نصب لاراول با VirtualBox

بسیار عالی حال برای اتصال به Shell باید نرم افزار VirtualBox را باز کرده و از منوی سمت چپ homestead7 را انتخاب و با راست کلیک کردن روی آن گزینه Run را بفشارید. بدین ترتیب صفحه ای مشکی برای شما نمایان خواهد شد که از شما اطلاعات یوزر نیم و پسورد را درخواست می‌کند تا به سرور مجازی لینوکسی خود دسترسی پیدا کنید. اطلاعات ورودی به صورت زیر خواهد بود:

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

 

نصب لاراول در VirtualBox

 

تمام مراحل بالا را طی کردیم تا به این نقطه از اجرای برنامه برسیم. برای نصب دو راه وجود دارد که هر دو از خط فرمان انجام می‌شوند. راه اول استفاده از خود نرم افزار کامپوزر (Composer) و راه دوم استفاده از ویژگی create-project در کامپوزر است.

حال در صفحه‌ی Shell لینوکس که در اختیار شما هست می‌توانید با دستور زیر ابزارهایی جهت راه‌اندازی لاراول با استفاده از Composer نصب کنید:

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

پس از طی کردن فرآیند نصب با عبارت Application Ready, Build something amazing روبه خواهید شد.

 

۲-۳) نصب لاراول با Vagrant SSH

 

در این شیوه‌ی نصب شما پس از اتمام فرآیند vagrant up باید دستور vagrant ssh را وارد کرده و به اصلاح وارد محیط Shell لینوکس مجازی خود شوید.

توجه: در صورتیکه هنگام اجرای دستور vagrant ssh با خطای زیر مواجه شدید به این لینک مراجعه کنید:

ssh` executable not found in any directories in the %PATH% variable. Is an SSH client installed? Try installing Cygwin, MinGW or Git, all of witch contain an SSH client. Or use your favorite SSH client with the following authentication information shown below:

Host: 127.0.0.1
Port: 2222
Username: vagrant
Private key: C:/path/to/project/.vagrant/machines/default/virtualbox/private_key

سپس مسیر فایل Projects را که قبلا ساخته بودیم با استفاده از دستور cd مشخص می‌کنیم. بنابراین داریم:

حال در این پوشه عبارت زیر را تایپ می‌کنیم:

 

طی این فرآیند نرم افزار لاراول برای شما به صورت کامل دانلود می‌شود و پس از وارد کردن آدرس laravel.dev صفحه‌ی خوش آمد گویی Laravel 5 را مشاهده خواهید کرد.

۳-۳) نصب پایگاه داده

حال جهت نصب پایگاه داده به مسیر زیر برید

سپس مقادیر موجود در فایل env. را به صورت زیر ویرایش کنید:

 

حال برای تست کردن دیتابیس نرم افزار MySQL WorkBench یا Navicat Premium را دانلود کنید. سپس نرم‌افزار را باز کرده و یک Connection جدید ایجاد کرده و در نهایت فیلدهای زیر را در آنها وارد کنید:

 

سپس روی Test Connection کلیک کنید. در صورتیکه جواب OK بود یعنی ارتباط شما برقرار است.

 

منبع: سایت روکسو


اگر احساس می کنید این مطلب برای شما مفید بود ، از 1 تا 10 به این مطلب امتیاز دهید

دیدگاه کاربران در مورد این مطلب

ثبت نظر
به نظر خوب میاد!
لطفا نام را وارد کنید
@
لطفا یک ایمیل منحصر به فرد و معتبر انتخاب کنید.
لطفا متن با کلمات و معانی مفهوم دار وارد نمایید