منصوبے کے بارے میں

یہ پیکج RFC 9116 میں بیان کردہ سکیورٹی ڈاٹ ٹیکسٹ فارمیٹ کے ساتھ کام کرنے کے لیے ایک مکمل PHP حل فراہم کرتا ہے۔ یہ ڈویلپرز کو پروگرامی طریقے سے سکیورٹی ڈاٹ ٹیکسٹ فائلیں بنانے، موجودہ فائلوں کا تجزیہ کرنے، اور ہوسٹ پر ان کے مواد اور مقام کی جامع تصدیق کرنے کی اجازت دیتا ہے۔ اہم صلاحیتیں درج ذیل ہیں: - **تولید**: ایک SecurityTxt آبجیکٹ بنائیں، رابطے، تعریفیں، ترجیحی زبانیں، میعاد ختم ہونے کی تاریخیں اور دیگر فیلڈز شامل کریں، پھر صحیح فارمیٹ والی ٹیکسٹ فائل آؤٹ پٹ کریں۔ - **تجزیہ**: اسٹرنگ، حاصل کردہ نتیجے، یا ریموت URL سے سکیورٹی ڈاٹ ٹیکسٹ لوڈ کریں، تمام فیلڈز نکالیں اور خراب لائنوں کا پتہ لگائیں۔ - **تصدیق**: تصدیق کریں کہ سکیورٹی ڈاٹ ٹیکسٹ فائل spec کی پابندی کرتی ہے، لازمی فیلڈز، درست URLs، HTTPS کے استعمال، دستخط کا احاطہ، ری ڈائریکٹس اور دیگر چیزوں کی جانچ کریں۔ تصدیق مقامی مواد پر یا ہوسٹ سے حاصل کر کے کی جا سکتی ہے، جس میں تفصیلی غلطی اور انتباہ رپورٹس شامل ہوتی ہیں۔ - **دستخط کی سپورٹ**: پروگرامی طریقے سے OpenPGP کلیئر ٹیکسٹ دستخط بنائیں (gnupg ایکسٹینشن درکار ہے) یا پہلے سے دستخط شدہ اسٹیٹک فائلیں استعمال کریں۔ لائبریری دستخطوں کی تصدیق کرتی ہے لیکن کلیدی اعتماد کی تصدیق نہیں کرتی، یہ کام محققین کے لیے چھوڑ دیا جاتا ہے۔ - **CLI ٹول**: ایک کمانڈ لائن اسکرپٹ (`checksecuritytxt.php`) کسی بھی ہوسٹ کی تیز رفتار تصدیق کی اجازت دیتا ہے، جو CI پائپ لائنز یا GitHub Actions میں مفید ہے۔ - **JSON سیرلائزیشن**: تصدیق یا حاصل کرنے کے نتائج کو کیشنگ، سرورلیس پروسیسنگ، یا بین پروسیس کمیونیکیشن کے لیے JSON میں انکوڈ کیا جا سکتا ہے، ورژن کنٹرول شدہ فارمیٹ ہینڈلنگ کے ساتھ۔ - **حاصل کرنے کے کنٹرول**: سخت پابندیوں کے ساتھ محفوظ حاصل کرنا (صرف HTTPS، IP تصدیق، ری ڈائریکٹ لمٹس، سائز لمٹس، کسٹم DNS پرووائیڈرز، اور صارف ایجنٹ کی تخصیص)۔ - **کیشنگ**: Symfony اور Nette کیشز کے ساتھ مثال کے طور پر انٹیگریشنز سکیورٹی ڈاٹ ٹیکسٹ فائلوں پر دستخط کرنے اور ہر درخواست پر دوبارہ کمپیوٹ کیے بغیر انہیں سرور کرنے کی اجازت دیتے ہیں۔ لائبریری سرور سائیڈ انٹیگریشن اور کمانڈ لائن دونوں کے استعمال کے لیے ڈیزائن کی گئی ہے، جس میں وسیع تر کنفیگریشن آپشنز (سٹرکٹ موڈ، انتباہ تھریشولڈز، IPv6 ہینڈلنگ وغیرہ) فراہم کیے گئے ہیں، جبکہ صاف ستھرا، آبجیکٹ اورینٹڈ API برقرار رکھا گیا ہے۔ یہ PHP 8.5 اور اس سے اوپر کے ورژنز کی حمایت کرتا ہے، ریموت حاصل کرنے اور دستخط کی تصدیق کو فعال کرنے کے لیے curl اور gnupg کے اختیاری ایکسٹینشنز کے ساتھ۔