نسخه:

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

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

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

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

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

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

چرا لاراول؟

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

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

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

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

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

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

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

یک چارچوب جامعه

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

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

قبل از ایجاد اولین پروژه لاراول خود، باید مطمئن شوید که دستگاه محلی شما PHP و Composer را نصب کرده است. اگر در حال توسعه بر روی macOS هستید، PHP و Composer را می توان از طریق Homebrew نصب کرد . علاوه بر این، توصیه می کنیم Node و NPM را نصب کنید .

پس از نصب PHP و Composer، می توانید یک پروژه Laravel جدید از طریق create-project دستور Composer ایجاد کنید: 

composer create-project laravel/laravel:^9.0 example-app

یا، می توانید با نصب سراسری نصب کننده لاراول از طریق Composer، پروژه های جدید لاراول ایجاد کنید: 

composer global require laravel/installer
 
laravel new example-app

پس از ایجاد پروژه، سرور توسعه محلی لاراول را با استفاده از serve دستور Artisan CLI لاراول راه اندازی کنید: 

cd example-app
 
php artisan serve

هنگامی که سرور توسعه Artisan را راه اندازی کردید، برنامه شما در مرورگر وب شما در دسترس خواهد بود http://localhost:8000 . در مرحله بعد، شما آماده هستید تا قدم های بعدی خود را در اکوسیستم لاراول بردارید . البته، ممکن است بخواهید یک پایگاه داده را نیز پیکربندی کنید .

اگر می‌خواهید در هنگام توسعه برنامه لاراول خود شروع کنید، از یکی از کیت‌های شروع ما استفاده کنید . کیت های شروع لاراول دارای داربست احراز هویت Backend و Frontend برای برنامه جدید Laravel شما هستند.

لاراول و داکر

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

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

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

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

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

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

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

البته، می‌توانید "example-app" را در این URL به هر چیزی که دوست دارید تغییر دهید - فقط مطمئن شوید که نام برنامه فقط شامل نویسه‌های الفا عددی، خط تیره و زیرخط باشد. دایرکتوری برنامه لاراول در دایرکتوری که دستور را از آن اجرا می کنید ایجاد می شود.

نصب بادبان ممکن است چند دقیقه طول بکشد در حالی که کانتینرهای برنامه Sail بر روی دستگاه محلی شما ساخته شده است.

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

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

پس از راه اندازی کانتینرهای 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 به هر چیزی که دوست دارید تغییر دهید - فقط مطمئن شوید که نام برنامه فقط شامل نویسه‌های الفا عددی، خط تیره و زیرخط باشد. دایرکتوری برنامه لاراول در دایرکتوری که دستور را از آن اجرا می کنید ایجاد می شود.

نصب بادبان ممکن است چند دقیقه طول بکشد در حالی که کانتینرهای برنامه Sail بر روی دستگاه محلی شما ساخته شده است.

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

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

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

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

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

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

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

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

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

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

البته، می‌توانید "example-app" را در این URL به هر چیزی که دوست دارید تغییر دهید - فقط مطمئن شوید که نام برنامه فقط شامل نویسه‌های الفا عددی، خط تیره و زیرخط باشد. دایرکتوری برنامه لاراول در دایرکتوری که دستور را از آن اجرا می کنید ایجاد می شود.

نصب بادبان ممکن است چند دقیقه طول بکشد در حالی که کانتینرهای برنامه Sail بر روی دستگاه محلی شما ساخته شده است.

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

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

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

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

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

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

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

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

می توانید با افزودن پارامتر به URL به Sail دستور دهید که یک Devcontainer پیش فرض را نصب کند: devcontainer 

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

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

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

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

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

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

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

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

پایگاه های داده و مهاجرت

اکنون که برنامه لاراول خود را ایجاد کرده اید، احتمالاً می خواهید برخی از داده ها را در یک پایگاه داده ذخیره کنید. به‌طور پیش‌فرض، فایل پیکربندی برنامه شما .env مشخص می‌کند که لاراول با پایگاه داده MySQL در تعامل است و به پایگاه داده در 127.0.0.1 . اگر در حال توسعه بر روی macOS هستید و نیاز به نصب MySQL، Postgres یا Redis به صورت محلی دارید، ممکن است استفاده از DBngin برای شما راحت باشد .

اگر نمی خواهید MySQL یا Postgres را روی دستگاه محلی خود نصب کنید، همیشه می توانید از پایگاه داده SQLite استفاده کنید . SQLite یک موتور پایگاه داده کوچک، سریع و مستقل است. برای شروع، فایل پیکربندی خود را برای استفاده از درایور پایگاه داده .env لاراول به روز کنید. sqlite می توانید سایر گزینه های پیکربندی پایگاه داده را حذف کنید: 

DB_CONNECTION=sqlite 
DB_CONNECTION=mysql 
DB_HOST=127.0.0.1 
DB_PORT=3306 
DB_DATABASE=laravel 
DB_USERNAME=root 
DB_PASSWORD=

هنگامی که پایگاه داده SQLite خود را پیکربندی کردید، می توانید مهاجرت های پایگاه داده برنامه خود را اجرا کنید ، که جداول پایگاه داده برنامه شما را ایجاد می کند: 

php artisan migrate

اگر پایگاه داده SQLite برای برنامه شما وجود نداشته باشد، لاراول از شما می پرسد که آیا می خواهید پایگاه داده ایجاد شود. به طور معمول، فایل پایگاه داده SQLite در آدرس ایجاد می شود database/database.sqlite .

مراحل بعدی

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

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

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

Laravel The Full Stack Framework

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

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

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

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

Laravel The API Backend

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

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

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