نسخه:

نصب و راه اندازی

با لاراول آشنا شوید

لاراول یک چارچوب برنامه کاربردی وب با نحو رسا و زیبا است. یک چارچوب وب ساختار و نقطه شروعی را برای ایجاد برنامه شما فراهم می کند و به شما این امکان را می دهد که روی ایجاد چیزی شگفت انگیز تمرکز کنید در حالی که ما جزئیات را بررسی می کنیم.

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

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

چرا لاراول؟

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

یک چارچوب پیشرو

ما دوست داریم لاراول را یک چارچوب «پیشرو» بنامیم. منظور ما این است که لاراول با شما رشد می کند. اگر اولین قدم‌های خود را برای توسعه وب برمی‌دارید، کتابخانه وسیع مستندات، راهنماها و آموزش‌های ویدیویی لاراول به شما کمک می‌کند تا بدون خسته‌شدن، طناب‌ها را یاد بگیرید.

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

یک چارچوب مقیاس پذیر

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

آیا به مقیاس بندی شدید نیاز دارید؟ پلتفرم هایی مانند Laravel Vapor به شما این امکان را می دهند که برنامه Laravel خود را در مقیاس تقریباً نامحدود در آخرین فناوری بدون سرور AWS اجرا کنید.

چارچوب جامعه

لاراول بهترین بسته‌های موجود در اکوسیستم PHP را ترکیب می‌کند تا قوی‌ترین و سازگارترین چارچوب موجود برای توسعه‌دهندگان را ارائه دهد. علاوه بر این، هزاران توسعه‌دهنده با استعداد از سراسر جهان به این چارچوب کمک کرده‌اند . چه کسی می داند، شاید شما حتی یکی از همکاران لاراول شوید.

اولین پروژه لاراول شما

ما می خواهیم تا حد امکان شروع با لاراول آسان باشد. گزینه های مختلفی برای توسعه و اجرای پروژه لاراول در رایانه شخصی شما وجود دارد. در حالی که ممکن است بخواهید بعداً این گزینه ها را بررسی کنید، لاراول Sail را ارائه می دهد ، یک راه حل داخلی برای اجرای پروژه لاراول خود با استفاده از Docker .

Docker ابزاری برای اجرای برنامه‌ها و خدمات در "ظروف" کوچک و سبک وزن است که با نرم‌افزار یا پیکربندی نصب‌شده رایانه محلی شما تداخلی ندارند. این بدان معنی است که شما لازم نیست نگران پیکربندی یا راه اندازی ابزارهای توسعه پیچیده مانند وب سرورها و پایگاه های داده در رایانه شخصی خود باشید. برای شروع، فقط باید Docker Desktop را نصب کنید .

Laravel Sail یک رابط خط فرمان سبک وزن برای تعامل با پیکربندی پیش فرض Docker لاراول است. Sail یک نقطه شروع عالی برای ساخت یک برنامه لاراول با استفاده از PHP، MySQL و Redis بدون نیاز به تجربه قبلی Docker فراهم می کند.

قبلاً یک متخصص Docker هستید؟ نگران نباش! docker-compose.yml همه چیز در مورد Sail را می توان با استفاده از فایل همراه لاراول سفارشی کرد .

شروع به کار در macOS

اگر در حال توسعه بر روی مک هستید و Docker Desktop قبلاً نصب شده است، می توانید از یک دستور ترمینال ساده برای ایجاد یک پروژه جدید لاراول استفاده کنید. به عنوان مثال، برای ایجاد یک برنامه جدید لاراول در پوشه ای به نام "example-app"، می توانید دستور زیر را در ترمینال خود اجرا کنید: 

curl -s "https://laravel.build/example-app" | bash

البته، شما می توانید "example-app" را در این URL به هر چیزی که دوست دارید تغییر دهید. دایرکتوری برنامه لاراول در دایرکتوری که دستور را از آن اجرا می کنید ایجاد می شود.

پس از ایجاد پروژه، می توانید به دایرکتوری برنامه بروید و Laravel Sail را راه اندازی کنید. Laravel Sail یک رابط خط فرمان ساده برای تعامل با پیکربندی Docker پیش‌فرض لاراول ارائه می‌کند: 

cd example-app
 
./vendor/bin/sail up

اولین باری که up فرمان Sail را اجرا می کنید، کانتینرهای برنامه Sail روی دستگاه شما ساخته می شود. این ممکن است چند دقیقه طول بکشد. نگران نباشید، تلاش های بعدی برای شروع Sail بسیار سریعتر خواهد بود.

پس از راه اندازی کانتینرهای Docker برنامه، می توانید به برنامه در مرورگر وب خود در آدرس زیر دسترسی داشته باشید: http://localhost .

برای ادامه کسب اطلاعات بیشتر در مورد Laravel Sail، مستندات کامل آن را مرور کنید .

شروع به کار در ویندوز

قبل از ایجاد یک برنامه Laravel جدید بر روی دستگاه ویندوز خود، مطمئن شوید که Docker Desktop را نصب کنید . در مرحله بعد، باید مطمئن شوید که Windows Subsystem for Linux 2 (WSL2) نصب و فعال است. WSL به شما امکان می دهد تا فایل های اجرایی باینری لینوکس را به صورت بومی در ویندوز 10 اجرا کنید. اطلاعات مربوط به نحوه نصب و فعال کردن WSL2 را می توان در مستندات محیط توسعه دهنده مایکروسافت یافت .

پس از نصب و فعال کردن WSL2، باید مطمئن شوید که Docker Desktop برای استفاده از باطن WSL2 پیکربندی شده است .

در مرحله بعد، شما آماده ایجاد اولین پروژه لاراول خود هستید. Windows Terminal را راه اندازی کنید و یک جلسه ترمینال جدید برای سیستم عامل لینوکس WSL2 خود شروع کنید. در مرحله بعد، می توانید از یک دستور ترمینال ساده برای ایجاد یک پروژه جدید لاراول استفاده کنید. به عنوان مثال، برای ایجاد یک برنامه جدید لاراول در پوشه ای به نام "example-app"، می توانید دستور زیر را در ترمینال خود اجرا کنید: 

curl -s https://laravel.build/example-app | bash

البته، شما می توانید "example-app" را در این URL به هر چیزی که دوست دارید تغییر دهید. دایرکتوری برنامه لاراول در دایرکتوری که دستور را از آن اجرا می کنید ایجاد می شود.

پس از ایجاد پروژه، می توانید به دایرکتوری برنامه بروید و Laravel Sail را راه اندازی کنید. Laravel Sail یک رابط خط فرمان ساده برای تعامل با پیکربندی Docker پیش‌فرض لاراول ارائه می‌کند: 

cd example-app
 
./vendor/bin/sail up

اولین باری که up فرمان Sail را اجرا می کنید، کانتینرهای برنامه Sail روی دستگاه شما ساخته می شود. این ممکن است چند دقیقه طول بکشد. نگران نباشید، تلاش های بعدی برای شروع Sail بسیار سریعتر خواهد بود.

پس از راه اندازی کانتینرهای Docker برنامه، می توانید به برنامه در مرورگر وب خود در آدرس زیر دسترسی داشته باشید: http://localhost .

برای ادامه کسب اطلاعات بیشتر در مورد Laravel Sail، مستندات کامل آن را مرور کنید .

در حال توسعه در WSL2

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

پس از نصب این ابزارها، می توانید هر پروژه لاراول را با اجرای code . دستور از دایرکتوری ریشه برنامه خود با استفاده از ترمینال ویندوز باز کنید.

شروع کار در لینوکس

اگر در حال توسعه روی لینوکس هستید و Docker Compose قبلاً نصب شده است، می توانید از یک دستور ترمینال ساده برای ایجاد یک پروژه جدید لاراول استفاده کنید. به عنوان مثال، برای ایجاد یک برنامه جدید لاراول در پوشه ای به نام "example-app"، می توانید دستور زیر را در ترمینال خود اجرا کنید: 

curl -s https://laravel.build/example-app | bash

البته، شما می توانید "example-app" را در این URL به هر چیزی که دوست دارید تغییر دهید. دایرکتوری برنامه لاراول در دایرکتوری که دستور را از آن اجرا می کنید ایجاد می شود.

پس از ایجاد پروژه، می توانید به دایرکتوری برنامه بروید و Laravel Sail را راه اندازی کنید. Laravel Sail یک رابط خط فرمان ساده برای تعامل با پیکربندی Docker پیش‌فرض لاراول ارائه می‌کند: 

cd example-app
 
./vendor/bin/sail up

اولین باری که up فرمان Sail را اجرا می کنید، کانتینرهای برنامه Sail روی دستگاه شما ساخته می شود. این ممکن است چند دقیقه طول بکشد. نگران نباشید، تلاش های بعدی برای شروع Sail بسیار سریعتر خواهد بود.

پس از راه اندازی کانتینرهای Docker برنامه، می توانید به برنامه در مرورگر وب خود در آدرس زیر دسترسی داشته باشید: http://localhost .

برای ادامه کسب اطلاعات بیشتر در مورد Laravel Sail، مستندات کامل آن را مرور کنید .

انتخاب خدمات بادبانی شما

هنگام ایجاد یک برنامه جدید لاراول از طریق Sail، می توانید از with متغیر query string استفاده کنید تا انتخاب کنید کدام سرویس ها باید در فایل برنامه جدید شما پیکربندی شوند docker-compose.yml . خدمات موجود عبارتند از mysql , pgsql , mariadb , redis , memcached , meilisearch , minio , selenium و mailhog : 

curl -s "https://laravel.build/example-app?with=mysql,redis" | bash

اگر مشخص نکنید که کدام سرویس‌ها می‌خواهید پیکربندی شوند، یک پشته پیش‌فرض از mysql , redis , meilisearch , mailhog و selenium پیکربندی می‌شود.

نصب از طریق Composer

اگر رایانه شما قبلاً PHP و Composer را نصب کرده است، می توانید با استفاده مستقیم از Composer یک پروژه Laravel جدید ایجاد کنید. پس از ایجاد برنامه، می توانید سرور توسعه محلی لاراول را با استفاده از serve دستور Artisan CLI راه اندازی کنید: 

composer create-project laravel/laravel:^8.0 example-app
 
cd example-app
 
php artisan serve

نصب کننده لاراول

یا، می توانید Laravel Installer را به عنوان یک وابستگی جهانی Composer نصب کنید: 

composer global require laravel/installer
 
laravel new example-app
 
cd example-app
 
php artisan serve

مطمئن شوید که دایرکتوری Composer's vendor bin در سراسر سیستم را در خود قرار دهید $PATH تا laravel فایل اجرایی توسط سیستم شما قرار گیرد. این دایرکتوری بر اساس سیستم عامل شما در مکان های مختلف وجود دارد. با این حال، برخی از مکان های رایج عبارتند از:

  • سیستم عامل مک: $HOME/.composer/vendor/bin
  • پنجره ها: %USERPROFILE%\AppData\Roaming\Composer\vendor\bin
  • توزیع های گنو / لینوکس: $HOME/.config/composer/vendor/bin یا $HOME/.composer/vendor/bin

برای راحتی کار، نصب کننده لاراول همچنین می تواند یک مخزن Git برای پروژه جدید شما ایجاد کند. برای نشان دادن اینکه می خواهید یک مخزن Git ایجاد شود، --git هنگام ایجاد یک پروژه جدید، پرچم را ارسال کنید: 

laravel new example-app --git

این دستور یک مخزن جدید Git را برای پروژه شما مقداردهی اولیه می کند و به طور خودکار اسکلت پایه لاراول را commit می کند. پرچم git فرض می کند که Git را به درستی نصب و پیکربندی کرده اید. همچنین می توانید از --branch پرچم برای تنظیم نام شعبه اولیه استفاده کنید: 

laravel new example-app --git --branch="main"

به جای استفاده از --git پرچم، می توانید از --github پرچم برای ایجاد یک مخزن Git و همچنین ایجاد یک مخزن خصوصی مربوطه در GitHub استفاده کنید: 

laravel new example-app --github

پس از آن مخزن ایجاد شده در دسترس خواهد بود https://github.com/<your-account>/example-app . پرچم فرض می کند که GitHub CLI را github به درستی نصب کرده اید و با GitHub احراز هویت شده اید. علاوه بر این، شما باید به درستی نصب و پیکربندی شده باشید. در صورت نیاز، می‌توانید پرچم‌های دیگری را که توسط GitHub CLI پشتیبانی می‌شوند، ارسال کنید: git 

laravel new example-app --github="--public"

می توانید از --organization پرچم برای ایجاد مخزن تحت یک سازمان خاص GitHub استفاده کنید: 

laravel new example-app --github="--public" --organization="laravel"

پیکربندی اولیه

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

لاراول تقریباً به هیچ پیکربندی اضافی خارج از جعبه نیاز ندارد. شما برای شروع توسعه آزاد هستید! با این حال، ممکن است بخواهید config/app.php پرونده و مستندات آن را بررسی کنید. این شامل چندین گزینه است مانند timezone و locale اینکه ممکن است بخواهید با توجه به برنامه خود تغییر دهید.

پیکربندی مبتنی بر محیط

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

فایل شما .env نباید به کنترل منبع برنامه شما متعهد شود، زیرا هر توسعه دهنده / سروری که از برنامه شما استفاده می کند ممکن است به پیکربندی محیط متفاوتی نیاز داشته باشد. علاوه بر این، در صورتی که یک مزاحم به مخزن کنترل منبع شما دسترسی پیدا کند، این یک خطر امنیتی خواهد بود، زیرا هر گونه اعتبار حساس در معرض دید قرار می گیرد.

برای اطلاعات بیشتر در مورد پیکربندی مبتنی بر فایل و محیط، اسناد پیکربندی .env کامل را بررسی کنید .

پیکربندی دایرکتوری

لاراول باید همیشه خارج از ریشه «دایرکتوری وب» پیکربندی شده برای وب سرور شما ارائه شود. شما نباید سعی کنید یک برنامه لاراول را از زیر شاخه ای از "دایرکتوری وب" ارائه دهید. تلاش برای انجام این کار می تواند فایل های حساسی را که در برنامه شما وجود دارد در معرض دید قرار دهد.

مراحل بعدی

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

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

Laravel The Full Stack Framework

لاراول ممکن است به عنوان یک چارچوب کامل پشته عمل کند. منظور ما از چارچوب "پشته کامل" این است که از لاراول برای مسیریابی درخواست ها به برنامه خود و رندر کردن ظاهر خود از طریق قالب های Blade یا با استفاده از فناوری ترکیبی برنامه تک صفحه ای مانند Inertia.js استفاده می کنید . این رایج ترین راه برای استفاده از چارچوب لاراول است.

اگر قصد دارید از لاراول اینگونه استفاده کنید، ممکن است بخواهید مستندات ما در مورد مسیریابی ، نماها یا ORM Eloquent را بررسی کنید . علاوه بر این، ممکن است علاقه مند به یادگیری در مورد بسته های انجمن مانند Livewire و Inertia.js باشید . این بسته ها به شما این امکان را می دهند که از لاراول به عنوان یک چارچوب تمام پشته استفاده کنید و در عین حال از بسیاری از مزایای رابط کاربری ارائه شده توسط برنامه های جاوا اسکریپت تک صفحه ای بهره مند شوید.

اگر از لاراول به عنوان یک فریمورک کامل پشته استفاده می کنید، ما همچنین قویاً شما را تشویق می کنیم که یاد بگیرید چگونه CSS و جاوا اسکریپت برنامه خود را با استفاده از Laravel Mix کامپایل کنید .

اگر می‌خواهید برای ساخت برنامه خود شروع کنید، یکی از کیت‌های شروع برنامه رسمی ما را بررسی کنید .

Laravel The API Backend

لاراول همچنین ممکن است به عنوان پشتیبان API برای یک برنامه تک صفحه ای جاوا اسکریپت یا برنامه تلفن همراه عمل کند. به عنوان مثال، ممکن است از لاراول به عنوان پشتیبان API برای برنامه Next.js خود استفاده کنید . در این زمینه، می‌توانید از لاراول برای احراز هویت و ذخیره‌سازی/بازیابی داده‌ها برای برنامه‌تان استفاده کنید و در عین حال از خدمات قدرتمند لاراول مانند صف‌ها، ایمیل‌ها، اعلان‌ها و موارد دیگر بهره ببرید.

اگر قصد دارید از لاراول اینگونه استفاده کنید، ممکن است بخواهید مستندات ما در مورد مسیریابی ، Laravel Sanctum و Eloquent ORM را بررسی کنید .

آیا نیاز به یک راه اندازی داربست بک اند لاراول و فرانت اند Next.js دارید؟ Laravel Breeze یک پشته API و همچنین یک پیاده سازی frontend.js ارائه می دهد تا بتوانید در عرض چند دقیقه شروع به کار کنید.