تُسهّل حزمة  php-humanizer المقدمة من Norbert Orzechowicz قراءة القيم مثل الأرقام، النصوص، والتواريخ.  تقدم الحزمة مميزات مفيدة  لأي مشروع PHP  مستقل أو تطبيق PHP،  بالإضافة إلى ما تقدمه  Laravel من مميزات  مثل القيم الترتيبية للأعداد،  وأساليب مساعدة النصوص،  وتعامل Carbon مع التواريخ.

تحويل القيم النصية، والأرقام، والتواريخ إلى صيغ قابلة للقراءة.

use Coduo\PHPHumanizer\NumberHumanizer;
use Coduo\PHPHumanizer\CollectionHumanizer;
use Coduo\PHPHumanizer\StringHumanizer;
 
// Humanize
StringHumanizer::humanize('field_name'); // "Field Name"
StringHumanizer::humanize('user_id'); // "User"
StringHumanizer::humanize('field_name', false); // "field name"
 
// Binary suffix
NumberHumanizer::binarySuffix(1024); // "1 kB"
NumberHumanizer::binarySuffix(1536); // "1.5 kB"
NumberHumanizer::binarySuffix(1048576 * 5); // "5 MB"
NumberHumanizer::binarySuffix(1073741824 * 2); // "2 GB"
 
// Metric suffix
NumberHumanizer::metricSuffix(101); // "101"
NumberHumanizer::metricSuffix(1000); // "1k"
NumberHumanizer::metricSuffix(1240); // "1.2k"
NumberHumanizer::metricSuffix(1240000); // "1.24M"
NumberHumanizer::metricSuffix(3500000); // "3.5M"
 
// Oxford
CollectionHumanizer::oxford(['Michal', 'Norbert', 'Lukasz', 'Pawel'], 2); // "Michal, Norbert, and 2 others"
CollectionHumanizer::oxford(['Michal', 'Norbert', 'Lukasz'], 2); // "Michal, Norbert, and 1 other"
CollectionHumanizer::oxford(['Michal', 'Norbert']); // "Michal and Norbert"

الخصائص الرئيسية

• تنسيق الأعداد
  • تحويل الأعداد إلى قيم ترتيبية (الأول، الثاني، الثالث)
  • تنسيق الأعداد مع لاحقات مترية (1K، 1M، 1B)
  • تحويل الأعداد إلى أرقام رومانية
• معالجة النصوص
  • تحويل السلاسل إلى/من camelCase، snake_case، إلخ.
  • قص النص مع حدود الكلمات الذكية
  • إضافة فواصل سطور مناسبة للفواصل النصية
• التاريخ/الوقت
  • تحويل الطوابع الزمنية إلى وقت نسبي (قبل ساعتين، في 3 أيام)
  • توفير فروقات تواريخ طبيعية (شهر واحد، سنتان)
  • يدعم لغات/لهجات متعددة
• تنسيق حجم الملف
  • تحويل البايت إلى أحجام قابلة للقراءة (1KB، 2MB، 3GB)
  • يدعم الوحدات الثنائية والعشرية
  • دقة قابلة للتكوين
• تنسيق قائمة أكسفورد
  • تحويل المصفوفات إلى قوائم لغة طبيعية
  • يدعم أنماط الانضمام المختلفة (أ، ب و ج مقابل أ، ب، وج)
  • يعالج لهجات وفواصل مختلفة
• عمليات المجموعة
  • يوفر تنسيق مجموعة لغة طبيعية
  • يدعم مُنسيقات وقواعد مخصصة
  • يعالج المجموعات الفارغة بشكل جيد

يحتوي ملف readme على المزيد من الأمثلة ويسرد جميع اللغات المدعومة. يمكنك معرفة المزيد حول هذه الحزمة، والحصول على تعليمات التثبيت الكاملة،على GitHub.