خانه لاراول
معرفی
لاراول تلاش می کند تا کل تجربه توسعه PHP را لذت بخش کند، از جمله محیط توسعه محلی شما. Vagrant یک راه ساده و زیبا برای مدیریت و ارائه ماشین های مجازی ارائه می دهد.
Laravel Homestead یک "جعبه" رسمی و از پیش بسته بندی شده Vagrant است که بدون نیاز به نصب PHP، HHVM، وب سرور و هر نرم افزار سرور دیگری بر روی دستگاه محلی خود، یک محیط توسعه فوق العاده را برای شما فراهم می کند. دیگر نگران خراب کردن سیستم عامل خود نباشید! جعبه های ولگرد کاملا یکبار مصرف هستند. اگر مشکلی پیش آمد، می توانید ظرف چند دقیقه جعبه را از بین ببرید و دوباره ایجاد کنید!
Homestead بر روی هر سیستم ویندوز، مک یا لینوکس اجرا می‌شود و شامل وب سرور Nginx، PHP 5.6، MySQL، Postgres، Redis، Memcached و همه چیزهایی است که برای توسعه برنامه‌های لاراول شگفت‌انگیز به آن نیاز دارید.
توجه: اگر از ویندوز استفاده می کنید، ممکن است لازم باشد مجازی سازی سخت افزار (VT-x) را فعال کنید. معمولاً می توان آن را از طریق بایوس فعال کرد.
Homestead در حال حاضر با استفاده از Vagrant 1.6 ساخته و آزمایش شده است.
نرم افزار گنجانده شده است
- اوبونتو 14.04
- PHP 5.6
- HHVM
- Nginx
- MySQL
- Postgres
- گره (با Bower، Grunt و Gulp)
- ردیس
- Memcached
- Beanstalkd
- فرستاده لاراول
- افزونه Fabric + HipChat
نصب و راه اندازی
نصب VirtualBox & Vagrant
قبل از راه اندازی محیط Homestead خود، باید VirtualBox و Vagrant را نصب کنید . هر دوی این بسته‌های نرم‌افزاری، نصب‌کننده‌های بصری با کاربری آسان را برای همه سیستم‌عامل‌های محبوب ارائه می‌کنند.
اضافه کردن جعبه ولگرد
هنگامی که VirtualBox و Vagrant نصب شدند، باید
laravel/homestead
باکس را با استفاده از دستور زیر در ترمینال خود به نصب Vagrant خود اضافه
کنید.
بسته به سرعت اتصال اینترنت شما، دانلود جعبه چند دقیقه طول می کشد:
vagrant box add laravel/homesteadاگر این کار انجام نشد، ممکن است نسخه قدیمی‌تری از Vagrant داشته باشید که به نشانی اینترنتی جعبه نیاز دارد. موارد زیر باید کار کند:
vagrant box add laravel/homestead https://atlas.hashicorp.com/laravel/boxes/homesteadنصب Homestead
با composer + ابزار پی اچ پی
هنگامی که کادر به نصب Vagrant شما اضافه شد، آماده نصب ابزار Homestead CLI
با استفاده از دستور Composer هستید
global
:
composer global require "laravel/homestead=~2.0"
مطمئن شوید که
~/.composer/vendor/bin
دایرکتوری را در PATH خود قرار داده اید تا زمانی که
دستور را در ترمینال خود
homestead
اجرا می کنید، فایل اجرایی پیدا شود .
homestead
هنگامی که ابزار Homestead CLI را نصب کردید،
init
دستور ایجاد
Homestead.yaml
فایل پیکربندی را اجرا کنید:
homestead init
فایل
Homestead.yaml
در دایرکتوری قرار خواهد گرفت
~/.homestead
.
اگر از سیستم مک یا لینوکس استفاده می کنید، می توانید
Homestead.yaml
فایل را با اجرای
homestead edit
دستور در ترمینال خود ویرایش کنید:
homestead editدستی از طریق Git (بدون PHP محلی)
از طرف دیگر، اگر نمی‌خواهید PHP را روی دستگاه محلی خود نصب کنید،
می‌توانید Homestead را به صورت دستی و با شبیه‌سازی مخزن نصب کنید.
شبیه سازی مخزن را در
Homestead
دایرکتوری مرکزی در نظر بگیرید که در آن همه پروژه های لاراول خود را
نگهداری می کنید، زیرا جعبه Homestead به عنوان میزبان همه پروژه های لاراول (و PHP) شما عمل می کند:
git clone https://github.com/laravel/homestead.git Homestead
هنگامی که ابزار Homestead CLI را نصب کردید،
bash init.sh
دستور ایجاد
Homestead.yaml
فایل پیکربندی را اجرا کنید:
bash init.sh
فایل
Homestead.yaml
در دایرکتوری قرار خواهد گرفت
~/.homestead
.
کلید SSH خود را تنظیم کنید
در مرحله بعد باید
Homestead.yaml
فایل را ویرایش کنید.
در این فایل می‌توانید مسیر کلید SSH عمومی خود و همچنین پوشه‌هایی را که
می‌خواهید بین ماشین اصلی و ماشین مجازی Homestead به اشتراک گذاشته شوند، پیکربندی کنید.
کلید SSH ندارید؟ در مک و لینوکس، به طور کلی می توانید یک جفت کلید SSH با استفاده از دستور زیر ایجاد کنید:
ssh-keygen -t rsa -C "you@homestead"
در ویندوز، می‌توانید
Git را
نصب کنید و از
Git Bash
پوسته همراه با Git برای صدور دستور بالا استفاده کنید.
از طرف دیگر، می توانید از
PuTTY
و
PuTTYgen
استفاده کنید .
پس از ایجاد یک کلید SSH، مسیر کلید را در
authorize
ویژگی فایل خود مشخص کنید
Homestead.yaml
.
پوشه های مشترک خود را پیکربندی کنید
ویژگی
folders
فایل
Homestead.yaml
تمام پوشه هایی را که می خواهید با محیط Homestead خود به اشتراک بگذارید را
فهرست می کند.
همانطور که فایل‌های درون این پوشه‌ها تغییر می‌کنند، بین ماشین محلی شما و
محیط Homestead همگام می‌شوند.
می توانید هر تعداد پوشه مشترک را که لازم است پیکربندی کنید!
سایت های Nginx خود را پیکربندی کنید
با Nginx آشنایی ندارید؟
مشکلی نیست.
این
sites
ویژگی به شما امکان می دهد به راحتی یک "دامنه" را به یک پوشه در محیط
Homestead خود نگاشت کنید.
نمونه پیکربندی سایت در
Homestead.yaml
فایل موجود است.
مجدداً، می توانید هر تعداد سایت که لازم باشد به محیط Homestead خود اضافه
کنید.
Homestead می تواند به عنوان یک محیط راحت و مجازی برای هر پروژه لاراول که
روی آن کار می کنید خدمت کند!
شما می توانید هر سایت Homestead را از
HHVM
با تنظیم
hhvm
گزینه زیر استفاده کنید
true
:
sites: - map: homestead.app to: /home/vagrant/Code/Laravel/public hhvm: trueنام مستعار بش
برای افزودن نام مستعار Bash به کادر Homestead خود، کافی است
aliases
فایل را در ریشه دایرکتوری اضافه کنید
~/.homestead
.
جعبه ولگرد را راه اندازی کنید
پس از ویرایش
Homestead.yaml
مورد نظر خود،
homestead up
دستور را در ترمینال خود اجرا کنید.
اگر Homestead را به صورت دستی نصب کرده اید و از ابزار PHP استفاده نمی
کنید ،
از دایرکتوری که حاوی مخزن Homestead Git کلون شده شما است
homestead
اجرا کنید .
vagrant up
Vagrant ماشین مجازی را بوت می کند و پوشه های مشترک و سایت های Nginx شما
را به صورت خودکار پیکربندی می کند!
برای از بین بردن ماشین، می توانید از
homestead destroy
دستور استفاده کنید.
برای لیست کاملی از دستورات Homestead موجود، اجرا کنید
homestead list
.
فراموش نکنید که "دامنه" سایت های Nginx خود را به
hosts
فایل موجود در دستگاه خود اضافه کنید!
این
hosts
فایل درخواست های شما را برای دامنه های محلی به محیط Homestead شما هدایت
می کند.
در مک و لینوکس، این فایل در آدرس قرار دارد
/etc/hosts
.
در ویندوز، در
C:\Windows\System32\drivers\etc\hosts
.
خطوطی که به این فایل اضافه می کنید به شکل زیر خواهد بود:
192.168.10.10 homestead.app
مطمئن شوید که آدرس IP فهرست شده همان آدرسی است که در
Homestead.yaml
فایل خود تنظیم کرده اید.
هنگامی که دامنه را به فایل خود اضافه کردید
hosts
، می توانید از طریق مرورگر وب خود به سایت دسترسی پیدا کنید!
http://homestead.appبرای یادگیری نحوه اتصال به پایگاه داده خود، ادامه مطلب را بخوانید!
استفاده روزانه
اتصال از طریق SSH
برای اتصال به محیط Homestead از طریق SSH،
homestead ssh
دستور را در ترمینال خود صادر کنید.
اتصال به پایگاه های داده شما
یک
homestead
پایگاه داده برای MySQL و Postgres خارج از جعبه پیکربندی شده است.
برای راحتی بیشتر،
local
پیکربندی پایگاه داده لاراول برای استفاده از این پایگاه داده به طور پیش
فرض تنظیم شده است.
برای اتصال به پایگاه داده MySQL یا Postgres از دستگاه اصلی خود از طریق
Navicat یا Sequel Pro، باید به
127.0.0.1
33060 (MySQL) یا 54320 (Postgres) وصل شوید و پورت کنید.
نام کاربری و رمز عبور هر دو پایگاه داده
homestead
/ است
secret
.
توجه: شما باید فقط هنگام اتصال به پایگاه داده از دستگاه اصلی خود از این پورت های غیر استاندارد استفاده کنید. شما از پورت های پیش فرض 3306 و 5432 در فایل پیکربندی پایگاه داده لاراول خود استفاده خواهید کرد زیرا لاراول در ماشین مجازی اجرا می شود.
افزودن سایت های اضافی
هنگامی که محیط Homestead شما تهیه و اجرا شد، ممکن است بخواهید سایت های
Nginx دیگری را برای برنامه های Laravel خود اضافه کنید.
شما می توانید هر تعداد نصب لاراول را که بخواهید در یک محیط Homestead اجرا
کنید.
دو راه برای انجام این کار وجود دارد: ابتدا، می‌توانید به سادگی سایت‌ها را
به
Homestead.yaml
فایل خود اضافه کنید و سپس اجرا کنید
vagrant provision
.
یا می توانید از
serve
اسکریپتی که در محیط Homestead شما موجود است استفاده کنید.
برای استفاده از
serve
اسکریپت، SSH را در محیط Homestead خود قرار دهید و دستور زیر را اجرا کنید:
serve domain.app /home/vagrant/Code/path/to/public/directoryتوجه: پس از اجرای
serveدستور فراموش نکنید که سایت جدید را بهhostsفایل موجود در دستگاه اصلی خود اضافه کنید!
پورت ها
پورت های زیر به محیط Homestead شما ارسال می شوند:
- SSH: 2222 -> Forward to 22
- HTTP: 8000 -> Forward to 80
- MySQL: 33060 -> Forward to 3306
- Postgres: 54320 -> Forwards to 5432