تحميل laravel.io - تحميل كود المصدر laravel.io

laravel.io

فئات أخرى

1.0.0

تنزيل

لارافيل.io

هذا هو مستودع بوابة مجتمع Laravel.io. الكود مفتوح المصدر بالكامل ومرخص بموجب ترخيص MIT. نحن نرحب بمساهماتك ولكننا نشجعك على قراءة دليل المساهمة قبل إنشاء مشكلة أو إرسال طلب سحب. اقرأ دليل التثبيت أدناه لبدء إعداد التطبيق على جهازك.

الرعاة

نود أن نشكر هذه الشركات الرائعة لرعايتنا. إذا كنت مهتمًا بأن تصبح راعيًا، فيرجى زيارة صفحة رعاة Laravel.io GitHub.

إيفينتي
صياغة
مبعوث
فهم
تينكرويل
BairesDev
ن-التاسع

متطلبات

الأدوات التالية مطلوبة لبدء التثبيت.

بي إتش بي 8.3
الملحن
الآلية الوقائية الوطنية
خادم

تثبيت

لاحظ أنه لديك الحرية في ضبط موقع ~/Sites/laravel.io على أي دليل تريده على جهازك. عند القيام بذلك، تأكد من تشغيل أمر valet link داخل الدليل المطلوب.

استنسخ هذا المستودع باستخدام git clone [email protected]:laravelio/laravel.io.git ~/Sites/laravel.io
قم بتشغيل composer install لتثبيت تبعيات PHP
قم بإعداد قاعدة بيانات محلية تسمى laravel
قم بتشغيل composer setup لإعداد التطبيق
قم بإعداد برنامج تشغيل بريد إلكتروني فعال مثل Mailtrap
قم بتشغيل valet link لربط الموقع بعنوان ويب تجريبي
قم بإنشاء قاعدة بيانات testing في MySQL حتى تتمكن من تشغيل مجموعة الاختبار
قم بتكوين الميزات (الاختيارية) من الأسفل

يمكنك الآن زيارة التطبيق في متصفحك من خلال زيارة http://laravel.io.test. إذا قمت بزرع قاعدة البيانات، يمكنك تسجيل الدخول إلى حساب اختباري باستخدام password testing .

مصادقة جيثب (اختياري)

لكي تعمل مصادقة GitHub محليًا، ستحتاج إلى تسجيل تطبيق OAuth جديد على GitHub. استخدم http://laravel.io.test لعنوان URL للصفحة الرئيسية و http://laravel.io.test/auth/github لعنوان URL لرد الاتصال. عندما تقوم بإنشاء التطبيق، قم بملء المعرف والسر في ملف .env الخاص بك في متغيرات env أدناه. يجب أن تكون الآن قادرًا على المصادقة باستخدام GitHub.

GITHUB_ID=
GITHUB_SECRET=
GITHUB_URL=http://laravel.io.test/auth/github

بحث ألجوليا (اختياري)

لتشغيل بحث Algolia محليًا، ستحتاج إلى التسجيل للحصول على حساب جديد وإنشاء فهرس يسمى threads . تتمتع Algolia بطبقة مجانية تلبي جميع المتطلبات اللازمة لبيئة التطوير. الآن قم بتحديث المتغيرات أدناه في ملف .env الخاص بك. يمكن العثور على معرف التطبيق والمفاتيح السرية في قسم API Keys في واجهة مستخدم Algoila.

SCOUT_DRIVER=algolia
SCOUT_QUEUE=true

ALGOLIA_APP_ID=
ALGOLIA_SECRET="Use the Write API Key"

VITE_ALGOLIA_APP_ID="${ALGOLIA_APP_ID}"
VITE_ALGOLIA_SECRET="Use the Search API Key"

VITE_ALGOLIA_THREADS_INDEX=threads
VITE_ALGOLIA_ARTICLES_INDEX=articles
VITE_ALGOLIA_USERS_INDEX=users

من أجل فهرسة المواضيع الموجودة لديك، قم بتشغيل الأمر التالي:

 php artisan scout: استيراد التطبيقالنماذجالخيط

ستتم إضافة سلاسل الرسائل الجديدة تلقائيًا إلى الفهرس وستتم مزامنة سلاسل الرسائل التي يتم تحديثها تلقائيًا. إذا كنت بحاجة إلى مسح الفهرس الخاص بك والبدء من جديد، فيمكنك تشغيل الأمر التالي:

 php artisan scout: تدفق التطبيقالنماذجالخيط

مشاركة وسائل التواصل الاجتماعي (اختياري)

لتمكين مشاركة المقالات المنشورة تلقائيًا على X، ستحتاج إلى إنشاء تطبيق. بمجرد إنشاء التطبيق، قم بتحديث المتغيرات أدناه في ملف .env الخاص بك. يمكن العثور على مفتاح العميل والسر ورمز الوصول والسر في قسم Keys and tokens في واجهة مستخدم مطوري X.

TWITTER_CONSUMER_KEY=
TWITTER_CONSUMER_SECRET=
TWITTER_ACCESS_TOKEN=
TWITTER_ACCESS_SECRET=

لفعل الشيء نفسه بالنسبة إلى Bluesky، ما عليك سوى إعداد مفاتيح التطبيق باستخدام معلومات تسجيل الدخول وكلمة المرور الخاصة بك:

BLUESKY_USERNAME=
BLUESKY_PASSWORD=

تتم مشاركة المقالات المعتمدة بالترتيب الذي تم تقديمها للموافقة عليه. تتم مشاركة المقالات مرتين يوميًا الساعة 14:00 و18:00 بالتوقيت العالمي. بمجرد مشاركة المقالة، لن تتم مشاركتها مرة أخرى.

إشعارات برقية (اختياري)

يمكن لـ Laravel.io إخطار المشرفين بالمقالات المقدمة حديثًا عبر Telegram. لكي ينجح هذا الأمر، ستحتاج إلى إعداد روبوت Telegram والحصول على رمز مميز. ثم قم بتكوين القناة التي تريد إرسال رسائل المقالات الجديدة إليها.

TELEGRAM_BOT_TOKEN=
TELEGRAM_CHANNEL=

تحليلات الفهم (اختياري)

لتمكين عدد مرات المشاهدة على المقالات، ستحتاج إلى تسجيل حساب Fathom Analytics وتثبيته على الموقع. ستحتاج بعد ذلك إلى إنشاء رمز واجهة برمجة التطبيقات (API) والعثور على معرف موقعك قبل تحديث متغيرات البيئة أدناه في ملف .env الخاص بك.

FATHOM_SITE_ID=
FATHOM_TOKEN=

أونسبلاش (اختياري)

للتأكد من مزامنة صور رؤوس المقالات والمستخدمين في قاعدة البيانات، سنحتاج إلى إعداد مفتاح وصول من Unsplash. يرجى ملاحظة أن تطبيق Unsplash الخاص بك يتطلب الوصول إلى الإنتاج.

UNSPLASH_ACCESS_KEY=

بعد ذلك يمكنك إضافة معرف صورة Unsplash إلى أي صف مقال في عمود hero_image_id وتشغيل أمر المزامنة لجلب عنوان URL للصورة وبيانات المؤلف:

 php artisan lio:sync-article-images

الأوامر

يأمر	وصف
`vendor/bin/pest -p`	قم بإجراء الاختبارات بالتنفيذ المتوازي
`php artisan migrate:fresh --seed`	إعادة تعيين قاعدة البيانات
`npm run dev`	إنشاء ومراقبة التغييرات في ملفات CSS وJS