تحميل shlink - تنزيل كود المصدر shlink

يتقلص

شفرة المصدر الأخرى

v4.2.5

تنزيل

أداة تقصير عناوين URL ذاتية الاستضافة تعتمد على لغة PHP والتي يمكن استخدامها لخدمة عناوين URL المختصرة ضمن نطاقك الخاص.

جدول المحتويات

التوثيق الكامل
صورة عامل الميناء
استضافة ذاتية
- تحميل
- تكوين
باستخدام شلينك
المساهمة

التوثيق الكامل

يحتوي هذا المستند على الأساسيات لبدء استخدام Shlink. إذا كنت تريد معرفة كل ما يمكنك فعله به، قم بزيارة الوثائق الكاملة القابلة للبحث.

صورة عامل الميناء

يمكنك معرفة كيفية استخدام صورة عامل الإرساء الرسمية من خلال قراءة المستندات.

الفكرة هي أنه يمكنك فقط إنشاء حاوية باستخدام الصورة وتوفير التكوين المخصص عبر env vars.

استضافة ذاتية

أولاً، تأكد من أن المضيف الذي ستقوم بتشغيل shlink يلبي المتطلبات التالية:

PHP 8.2 أو 8.3
ملحقات PHP التالية: json، وcurl، وpdo، وintl، وgd، وgmp/bcmath.
- يوصى بامتداد apcu إذا كنت لا تخطط لاستخدام RoadRunner.
- مطلوب امتداد xml إذا كنت تريد إنشاء رموز QR بتنسيق svg.
- المقابس وامتدادات bcmath مطلوبة إذا كنت تريد التكامل مع مثيل RabbitMQ.
MySQL أو MariaDB أو PostgreSQL أو MicrosoftSQL أو SQLite.
- ستحتاج أيضًا إلى إصدار pdo المطابق لقاعدة البيانات التي تخطط لاستخدامها: pdo_mysql أو pdo_pgsql أو pdo_sqlsrv أو pdo_sqlite .

تحميل

من أجل تشغيل Shlink، سوف تحتاج إلى نسخة مبنية من المشروع. هناك طريقتان للحصول عليه.

باستخدام ملف dist
أسهل طريقة لتثبيت shlink هي استخدام إحدى الحزم القابلة للتوزيع المجمعة مسبقًا.
انتقل إلى أحدث إصدار وقم بتنزيل ملف shlink*_dist.zip الذي يناسب احتياجاتك. ستجد واحدًا لكل إصدار PHP مدعوم.
وأخيرًا، قم بفك ضغط الملف في الموقع الذي تختاره.
البناء من المصادر
إذا كنت تريد لأي سبب من الأسباب بناء المشروع بنفسك، فاتبع الخطوات التالية:
- انسخ المشروع باستخدام git ( git clone https://github.com/shlinkio/shlink.git )، أو قم بتنزيله بالنقر فوق الزر Clone أو التنزيل الأخضر.
- قم بتنزيل مدير حزم Composer PHP داخل مجلد المشروع.
- قم بتشغيل ./build.sh 3.0.0 ، مع استبدال الإصدار برقم الإصدار الذي ستقوم بإنشائه (يتم استخدام رقم الإصدار كجزء من اسم ملف التوزيع الذي تم إنشاؤه، ولضبط القيمة التي يتم إرجاعها عند تشغيل shlink -V من سطر الأوامر).
بعد ذلك، سيكون لديك ملف dist داخل دليل build ، والذي تحتاج إلى فك ضغطه في الموقع الذي تختاره.
ملحوظة
هذه هي العملية المستخدمة عند إصدار إصدارات Shlink الجديدة. بعد وضع علامة على الإصدار الجديد باستخدام git، يتم إنشاء إصدار GitHub تلقائيًا من خلال سير عمل GitHub، مع إرفاق ملف dist الذي تم إنشاؤه به.

تكوين

على الرغم من كيفية إنشاء المشروع، فأنت بحاجة الآن إلى تكوينه باتباع الخطوات التالية:

إذا كنت ستستخدم MySQL أو MariaDB أو PostgreSQL أو Microsoft SQL Server، فقم بإنشاء قاعدة بيانات فارغة بالاسم الذي تختاره.
منح أذونات الكتابة بشكل متكرر إلى دليل data . يستخدمه Shlink لتخزين بعض المعلومات مؤقتًا.
قم بإعداد التطبيق عن طريق تشغيل البرنامج النصي vendor/bin/shlink-installer install . إنها أداة سطر أوامر سترشدك خلال عملية التثبيت. ضع في اعتبارك أنه يجب تشغيل هذه الأداة مباشرة على الخادم الذي تخطط لاستضافة Shlink فيه. لا تقم بتشغيله قبل تحميله/نقله هناك.
قم بإنشاء مفتاح API الأول الخاص بك عن طريق تشغيل bin/cli api-key:generate . ستحتاج إلى المفتاح للتفاعل مع واجهة برمجة تطبيقات Shlink.

باستخدام شلينك

بمجرد تثبيت shlink، هناك طريقتان رئيسيتان للتفاعل معه:

سطر الأوامر : حاول تشغيل bin/cli لرؤية جميع الأوامر المتاحة.
يمكن تشغيلها جميعًا باستخدام علامة --help / -h لمعرفة كيفية استخدامها وجميع الخيارات المتاحة.
من المحتمل أن تكون فكرة جيدة ربط نقطة إدخال CLI ( bin/cli ) بمكان ما في المسار الخاص بك، بحيث يمكنك تشغيل shlink من أي دليل.
واجهة برمجة تطبيقات REST : يمكن العثور على المستندات الكاملة حول كيفية استخدام واجهة برمجة التطبيقات هنا، ويمكن العثور على صندوق الحماية الذي يوثق أيضًا كل نقطة نهاية في بوابة API Spec.
ومع ذلك، ربما لا ترغب في استهلاك واجهة برمجة التطبيقات الأولية بنفسك. ولهذا السبب يتم توفير عميل ويب رائع يمكن استخدامه مباشرة من https://app.shlink.io، أو استضافته بنفسك.

يسمح لك كل من API وCLI بالقيام بنفس العمليات في الغالب، باستثناء إدارة مفاتيح API، والتي يمكن إجراؤها من واجهة سطر الأوامر فقط.