نسخه:

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

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

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

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

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

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

چرا لاراول؟

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

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

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

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

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

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

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

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

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

ایجاد یک پروژه لاراول

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

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

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

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

composer global require laravel/installer
 
laravel new example-app

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

cd example-app
 
php artisan serve

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

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

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

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

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

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

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

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

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

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

اکنون که برنامه لاراول خود را ایجاد کرده اید، احتمالاً می خواهید برخی از داده ها را در یک پایگاه داده ذخیره کنید. به طور پیش فرض، فایل پیکربندی برنامه شما .env مشخص می کند که لاراول با پایگاه داده SQLite تعامل خواهد داشت.

در حین ایجاد پروژه، لاراول یک database/database.sqlite فایل برای شما ایجاد کرد و مهاجرت های لازم را برای ایجاد جداول پایگاه داده برنامه اجرا کرد.

اگر ترجیح می دهید از درایور پایگاه داده دیگری مانند MySQL یا PostgreSQL استفاده کنید، می توانید .env فایل پیکربندی خود را برای استفاده از پایگاه داده مناسب به روز کنید. برای مثال، اگر می‌خواهید از MySQL استفاده کنید، متغیرهای .env فایل پیکربندی خود را به‌روزرسانی کنید: DB_* 

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

اگر انتخاب می کنید از پایگاه داده ای غیر از SQLite استفاده کنید، باید پایگاه داده را ایجاد کنید و انتقال پایگاه داده برنامه خود را اجرا کنید : 

php artisan migrate

اگر در حال توسعه بر روی macOS هستید و باید MySQL، PostgreSQL یا Redis را به صورت محلی نصب کنید، از DBngin استفاده کنید .

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

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

نصب داکر با استفاده از بادبان

ما می خواهیم بدون در نظر گرفتن سیستم عامل ترجیحی شما، شروع به کار با لاراول تا حد امکان آسان باشد. بنابراین، گزینه های مختلفی برای توسعه و اجرای یک پروژه لاراول در ماشین محلی شما وجود دارد. در حالی که ممکن است بخواهید بعداً این گزینه ها را بررسی کنید، لاراول 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 برنامه شروع به کار کردند، باید مهاجرت های پایگاه داده برنامه خود را اجرا کنید : 

./vendor/bin/sail artisan migrate

در نهایت، می توانید به برنامه در مرورگر وب خود در آدرس زیر دسترسی داشته باشید: 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 برنامه شروع به کار کردند، باید مهاجرت های پایگاه داده برنامه خود را اجرا کنید : 

./vendor/bin/sail artisan migrate

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

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

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

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

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

بادبانی در لینوکس

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

ابتدا، اگر از Docker Desktop برای لینوکس استفاده می کنید، باید دستور زیر را اجرا کنید. اگر از Docker Desktop برای لینوکس استفاده نمی کنید، می توانید این مرحله را نادیده بگیرید: 

docker context use default

سپس، برای ایجاد یک برنامه جدید لاراول در دایرکتوری به نام "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 برنامه شروع به کار کردند، باید مهاجرت های پایگاه داده برنامه خود را اجرا کنید : 

./vendor/bin/sail artisan migrate

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

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

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

هنگام ایجاد یک برنامه جدید لاراول از طریق Sail، می توانید از with متغیر query string استفاده کنید تا انتخاب کنید کدام سرویس ها باید در فایل برنامه جدید شما پیکربندی شوند docker-compose.yml . خدمات موجود عبارتند از mysql , pgsql , mariadb , redis , memcached , meilisearch , typesense , 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

پشتیبانی IDE

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

علاوه بر این، پلاگین Laravel Idea PhpStorm که توسط جامعه نگهداری می‌شود، انواع تقویت‌کننده‌های مفید IDE، از جمله تولید کد، تکمیل نحو Eloquent، تکمیل قوانین اعتبارسنجی و موارد دیگر را ارائه می‌دهد.

مراحل بعدی

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

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

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

فریم ورک Full Stack را لاراول کنید

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

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

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

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

لاراول API Backend

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

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

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