پرش به مطلب اصلی

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

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

پیش‌نیازها​

قبل از شروع نصب، مطمئن شوید موارد زیر روی سیستم شما نصب و تنظیم شده است:

PHP

برای اجرای پروژه‌های Doravel به نسخه 8.4 یا بالاتر PHP نیاز است.
می‌توانید نسخه PHP نصب‌شده را با دستور زیر بررسی کنید:

php -v
Composer

ابزار مدیریت وابستگی‌های PHP که برای نصب پکیج‌ها و کتابخانه‌های موردنیاز پروژه استفاده می‌شود.
بررسی نسخه Composer:

composer --version

دانلود و نصب Composer

SourceGuardian

افزونه‌ای برای PHP جهت اجرای فایل‌های رمزنگاری شده با SourceGuardian.

این افزونه باید متناسب با نسخه PHP و سیستم‌عامل شما نصب شود.

برای فعال‌سازی، فایل sourceguardian_loader را دانلود کرده و در مسیر افزونه‌های PHP قرار دهید، سپس در php.ini آن را فعال کنید:

extension=ixed.X.X.lin

(به جای X.X نسخه مربوط به PHP خود را وارد کنید)

توصیه: قبل از ادامه، با اجرای php -m اطمینان حاصل کنید که افزونه‌ SourceGuardian فعال است.

دانلود لودر SourceGuardian

ایجاد پروژه جدید Laravel​

ابتدا یک پروژه لاراول جدید ایجاد کنید:

composer create-project laravel/laravel PROJECT_NAME

افزودن مخازن داخلی به Composer​

برای دسترسی به پکیج‌های زیرساخت، لازم است مخازن داخلی درنیکا به فایل composer.json پروژه اضافه شوند.

نمونه‌ای از پیکربندی:

"repositories": {
    "packagist.org": false,
    "dornica-mirror": {
        "type": "composer",
        "url": "https://nexus.dornica-co.local/repository/composer-packagist",
        "options": {
            "ssl": {
                "verify_peer": false
            }
        }
    },
    "dornica-internal": {
        "type": "composer",
        "url": "https://composer.dornica-co.local",
        "options": {
            "ssl": {
                "verify_peer": false
            }
        }
    }
},
نکته

کلید repositories باید به درستی در فایل composer.json جایگذاری شود.

نصب پکیج‌های زیرساخت​

جهعت نصب پکیج‌ زیرساخت، از دستور زیر استفاده کنید:

پروژه‌های Panel و API​

composer require dornica/doravel

انتشار فایل‌های Config​

جهت انتشار فایل‌های کانفیگ مربوط به پکیج‌ها، دستور زیر را اجرا کنید:

php artisan vendor:publish --tag=dornica-configs --force
نکته

فایل‌های پیکربندی زیرساخت درنیکا با پیشوند -dornica شروع می‌شوند. لطفاً بر اساس نیاز پروژه خود، این فایل‌ها را تنظیم کنید.

تنظیم نوع پروژه​

در فایل dornica-app باید کلید application_type را با یکی از مقدار های زیر تنظیم کنید:

  • panel برای پروژه‌های پنل
  • api برای پروژه‌های API

انتشار Assets​

اگر پروژه شما panel باشد، برای انتشار Assets دستور‌های زیر را اجرا کنید:

php artisan vendor:publish --tag=dornica-assets --force
php artisan livewire:publish --assets

این کار باعث انتقال فایل‌های استاتیک موردنیاز Doravel و Livewire به مسیر public پروژه می‌شود.

انتشار فایل‌های Lang​

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

برای این کار میتوانید از یکی از تگ‌های زیر استفاده کنید:

php artisan vendor:publish --tag=dornica-translations --force
php artisan vendor:publish --tag=dornica-lang --force
نکته

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

سفارشی‌سازی دیزاین​

در پروژه‌های پیاده‌سازی شده با Doravel شما این امکان را دارید که رنگ‌های پروژه را مطابق با متغیرهای تعریف شده در فیگمای دیزاین پروژه سفارشی‌سازی کنید.

برای مشاهده جزئیات بیشتر و اطلاع از نحوه سفارشی‌سازی اینجا کلیک کنید

انتشار فایل‌های Migration​

برای انتشار فایل‌های Migration، دستور زیر را اجرا کنید:

php artisan dornica:publish-migrations

با اجرای این دستور، migration ها به مسیر database/migrations پروژه شما منتقل می‌شوند.

نکته

هر کدام از Feature ها ممکن است فایل‌های Migration مخصوص به خود را داشته باشند و با توجه به تنظیم کلید های موجود در فایل های Config (پیکربندی) ممکن است جدول یا ستون در این فایل‌ها اضافه یا حذف شود.

برای آشنایی کامل با Migration Registry میتوانید به صفحه مستندات مراجعه کنید: مستندات Migration Registry

تزرین جداول در پایگاه داده​

با اجرای دستور زیر، جداول مورد نیاز در پایگاه داده ایجاد می‌شوند:

php artisan migrate

آماده برای توسعه​

پروژه اکنون آماده توسعه بوده و می‌توانید از امکانات زیرساخت درنیکا یا Doravel بهره ببرید.