راه اندازی یک محیط توسعه با استفاده از بادبان لاراول (Docker)
Summarize this content to 400 words in Persian Lang
Laravel Sail یک رابط خط فرمان سبک وزن برای تعامل با محیط توسعه Docker لاراول است. این یک محیط توسعه کامل را فراهم می کند که شامل PHP، MySQL، Redis و موارد دیگر است، بدون نیاز به نصب دستی این خدمات بر روی دستگاه محلی شما. Laravel Sail برای کسانی که می خواهند به سرعت یک پروژه جدید لاراول را با یک محیط توسعه استاندارد شروع کنند، عالی است.
در این پست به شما نشان خواهم داد که چگونه محیط را با Laravel Sail بدون نیاز به نصب محیط به صورت محلی تنظیم کنید.
ما فقط به داکر نیاز داریم. 🐳
نصب محیط با بادبان لاراول
مرحله 1: پیش نیازها
قبل از شروع، مطمئن شوید که Docker را روی دستگاه خود نصب کرده اید. می توانید Docker را از وب سایت رسمی دانلود و نصب کنید: Docker.
مرحله 2: نصب Laravel Sail
نصب Laravel Sail ساده است و تنها با یک فرمان قابل انجام است. در زیر دستورالعمل نصب Laravel Sail در MacOS، Windows و Linux آمده است.ترمینال خود را باز کنید و دستور زیر را اجرا کنید:
curl -s “https://laravel.build/example-app” | bash
وارد حالت تمام صفحه شوید
از حالت تمام صفحه خارج شوید
این دستور یک برنامه جدید لاراول به نام example-app را در فهرستی با همین نام دانلود و پیکربندی می کند. به راحتی می توانید نام پروژه خود را جایگزین برنامه نمونه کنید.
انتخاب خدمات بادبانی شما
هنگام ایجاد یک برنامه جدید لاراول از طریق Sail، می توانید از متغیر with query string استفاده کنید تا انتخاب کنید کدام سرویس ها باید در فایل docker-compose.yml برنامه جدید شما پیکربندی شوند. برای خدمات موجود، به مستندات Laravel Sail مراجعه کنید.
curl -s “https://laravel.build/example-app?with=mysql,redis” | bash
وارد حالت تمام صفحه شوید
از حالت تمام صفحه خارج شوید
اگر مشخص نکنید که کدام سرویسها میخواهید پیکربندی شوند، یک پشته پیشفرض تنظیم میشود. در لاراول 11، این پشته پیش فرض شامل mysql، redis، meilisearch، mailpit و سلنیوم است.
مرحله 3: راه اندازی Laravel Sail
پس از اتمام نصب، به دایرکتوری پروژه خود بروید و محیط توسعه Laravel Sail را شروع کنید:
cd example-app
./vendor/bin/sail up
وارد حالت تمام صفحه شوید
از حالت تمام صفحه خارج شوید
این دستور کانتینرهای Docker تعریف شده توسط Laravel Sail، از جمله وب سرور، پایگاه داده و سایر خدمات را شروع می کند.
مرحله 4: اجرای مهاجرت
پس از شروع محیط با sail up، باید مهاجرت ها را برای راه اندازی پایگاه داده اجرا کنید:
./vendor/bin/sail artisan migrate
وارد حالت تمام صفحه شوید
از حالت تمام صفحه خارج شوید
این دستور تمام مهاجرت های معلق را اعمال می کند و پایگاه داده را برای استفاده با برنامه لاراول شما تنظیم می کند.
ایجاد نام مستعار برای فرمان بادبان
برای ساخت با استفاده از ./vendor/bin/sail دستور ساده تر، می توانید یک نام مستعار در ترمینال خود ایجاد کنید. این به شما امکان می دهد که بدوید sail دستورات بدون تایپ مسیر کامل.
ایجاد نام مستعار در MacOS و Linux
فایل پیکربندی پوسته خود را باز کنید (معمولا ~/.bashrc، ~/.zshrc، یا ~/.bash_profile) و خط زیر را اضافه کنید:
alias sail='[ -f sail ] && bash sail || bash vendor/bin/sail’
وارد حالت تمام صفحه شوید
از حالت تمام صفحه خارج شوید
سپس، فایل پیکربندی پوسته را دوباره بارگیری کنید:
source ~/.bashrc
# or
source ~/.zshrc
# or
source ~/.bash_profile
وارد حالت تمام صفحه شوید
از حالت تمام صفحه خارج شوید
ایجاد نام مستعار در ویندوز (PowerShell)
برای ایجاد نام مستعار در PowerShell، خط زیر را به نمایه PowerShell خود ($PROFILE) اضافه کنید:
New-Alias sail vendor/bin/sail
وارد حالت تمام صفحه شوید
از حالت تمام صفحه خارج شوید
سپس نمایه PowerShell را دوباره بارگیری کنید:
. $PROFILE
وارد حالت تمام صفحه شوید
از حالت تمام صفحه خارج شوید
با استفاده از نام مستعار
اکنون می توانید از دستور sail به طور مستقیم در ترمینال استفاده کنید. به عنوان مثال، برای شروع محیط توسعه، به سادگی اجرا کنید:
sail up
وارد حالت تمام صفحه شوید
از حالت تمام صفحه خارج شوید
برای اجرای مهاجرت از:
sail artisan migrate
وارد حالت تمام صفحه شوید
از حالت تمام صفحه خارج شوید
نکته: نصب ماژول ها و برنامه های افزودنی PHP
اگر نیاز به نصب ماژول ها یا افزونه های اضافی PHP مانند GMP دارید، می توانید به Dockerfile استفاده شده توسط Laravel Sail دسترسی داشته باشید و تغییرات لازم را انجام دهید.
حرکت به ./vendor/laravel/sail/runtimes/ فهرست راهنما.
نسخه PHP مورد استفاده خود را انتخاب کنید (به عنوان مثال، 8.3).
Dockerfile مربوطه را باز کنید و دستورالعمل ها را برای نصب افزونه مورد نظر اضافه کنید. مثلا برای نصب php8.3-gmp، شما می توانید اضافه کنید:
پس از اصلاح Dockerfile، کانتینرهای Docker را دوباره بسازید تا تغییرات را اعمال کنید:
sail build –no-cache
وارد حالت تمام صفحه شوید
از حالت تمام صفحه خارج شوید
نتیجه
Laravel Sail راه اندازی محیط توسعه را ساده می کند و محیطی استاندارد و با کاربری آسان را ارائه می دهد. با مراحل بالا، میتوانید Laravel Sail را روی MacOS، Windows و Linux نصب کنید، یک نام مستعار برای سهولت استفاده از دستورات Sail ایجاد کنید و در صورت نیاز ماژولهای اضافی را نصب کنید.
آن را امتحان کنید و ببینید که چگونه Laravel Sail می تواند گردش کار توسعه شما را سرعت بخشد!
امیدوارم کمک کند!! 🤓
Laravel Sail یک رابط خط فرمان سبک وزن برای تعامل با محیط توسعه Docker لاراول است. این یک محیط توسعه کامل را فراهم می کند که شامل PHP، MySQL، Redis و موارد دیگر است، بدون نیاز به نصب دستی این خدمات بر روی دستگاه محلی شما. Laravel Sail برای کسانی که می خواهند به سرعت یک پروژه جدید لاراول را با یک محیط توسعه استاندارد شروع کنند، عالی است.
در این پست به شما نشان خواهم داد که چگونه محیط را با Laravel Sail بدون نیاز به نصب محیط به صورت محلی تنظیم کنید.
ما فقط به داکر نیاز داریم. 🐳
نصب محیط با بادبان لاراول
مرحله 1: پیش نیازها
قبل از شروع، مطمئن شوید که Docker را روی دستگاه خود نصب کرده اید. می توانید Docker را از وب سایت رسمی دانلود و نصب کنید: Docker.
مرحله 2: نصب Laravel Sail
نصب Laravel Sail ساده است و تنها با یک فرمان قابل انجام است. در زیر دستورالعمل نصب Laravel Sail در MacOS، Windows و Linux آمده است.
ترمینال خود را باز کنید و دستور زیر را اجرا کنید:
curl -s "https://laravel.build/example-app" | bash
این دستور یک برنامه جدید لاراول به نام example-app را در فهرستی با همین نام دانلود و پیکربندی می کند. به راحتی می توانید نام پروژه خود را جایگزین برنامه نمونه کنید.
انتخاب خدمات بادبانی شما
هنگام ایجاد یک برنامه جدید لاراول از طریق Sail، می توانید از متغیر with query string استفاده کنید تا انتخاب کنید کدام سرویس ها باید در فایل docker-compose.yml برنامه جدید شما پیکربندی شوند. برای خدمات موجود، به مستندات Laravel Sail مراجعه کنید.
curl -s "https://laravel.build/example-app?with=mysql,redis" | bash
اگر مشخص نکنید که کدام سرویسها میخواهید پیکربندی شوند، یک پشته پیشفرض تنظیم میشود. در لاراول 11، این پشته پیش فرض شامل mysql، redis، meilisearch، mailpit و سلنیوم است.
مرحله 3: راه اندازی Laravel Sail
پس از اتمام نصب، به دایرکتوری پروژه خود بروید و محیط توسعه Laravel Sail را شروع کنید:
cd example-app
./vendor/bin/sail up
این دستور کانتینرهای Docker تعریف شده توسط Laravel Sail، از جمله وب سرور، پایگاه داده و سایر خدمات را شروع می کند.
مرحله 4: اجرای مهاجرت
پس از شروع محیط با sail up، باید مهاجرت ها را برای راه اندازی پایگاه داده اجرا کنید:
./vendor/bin/sail artisan migrate
این دستور تمام مهاجرت های معلق را اعمال می کند و پایگاه داده را برای استفاده با برنامه لاراول شما تنظیم می کند.
ایجاد نام مستعار برای فرمان بادبان
برای ساخت با استفاده از ./vendor/bin/sail
دستور ساده تر، می توانید یک نام مستعار در ترمینال خود ایجاد کنید. این به شما امکان می دهد که بدوید sail
دستورات بدون تایپ مسیر کامل.
ایجاد نام مستعار در MacOS و Linux
فایل پیکربندی پوسته خود را باز کنید (معمولا ~/.bashrc
، ~/.zshrc
، یا ~/.bash_profile
) و خط زیر را اضافه کنید:
alias sail='[ -f sail ] && bash sail || bash vendor/bin/sail'
سپس، فایل پیکربندی پوسته را دوباره بارگیری کنید:
source ~/.bashrc
# or
source ~/.zshrc
# or
source ~/.bash_profile
ایجاد نام مستعار در ویندوز (PowerShell)
برای ایجاد نام مستعار در PowerShell، خط زیر را به نمایه PowerShell خود ($PROFILE) اضافه کنید:
New-Alias sail vendor/bin/sail
سپس نمایه PowerShell را دوباره بارگیری کنید:
. $PROFILE
با استفاده از نام مستعار
اکنون می توانید از دستور sail به طور مستقیم در ترمینال استفاده کنید. به عنوان مثال، برای شروع محیط توسعه، به سادگی اجرا کنید:
sail up
برای اجرای مهاجرت از:
sail artisan migrate
نکته: نصب ماژول ها و برنامه های افزودنی PHP
اگر نیاز به نصب ماژول ها یا افزونه های اضافی PHP مانند GMP دارید، می توانید به Dockerfile استفاده شده توسط Laravel Sail دسترسی داشته باشید و تغییرات لازم را انجام دهید.
- حرکت به
./vendor/laravel/sail/runtimes/
فهرست راهنما. - نسخه PHP مورد استفاده خود را انتخاب کنید (به عنوان مثال، 8.3).
- Dockerfile مربوطه را باز کنید و دستورالعمل ها را برای نصب افزونه مورد نظر اضافه کنید. مثلا برای نصب
php8.3-gmp
، شما می توانید اضافه کنید:
پس از اصلاح Dockerfile، کانتینرهای Docker را دوباره بسازید تا تغییرات را اعمال کنید:
sail build --no-cache
نتیجه
Laravel Sail راه اندازی محیط توسعه را ساده می کند و محیطی استاندارد و با کاربری آسان را ارائه می دهد. با مراحل بالا، میتوانید Laravel Sail را روی MacOS، Windows و Linux نصب کنید، یک نام مستعار برای سهولت استفاده از دستورات Sail ایجاد کنید و در صورت نیاز ماژولهای اضافی را نصب کنید.
آن را امتحان کنید و ببینید که چگونه Laravel Sail می تواند گردش کار توسعه شما را سرعت بخشد!
امیدوارم کمک کند!! 🤓