API در PHP

<input type="text" name="birthday" <?php echo persian_kit_date_field_attributes(['max' => '2010-12-31']); ?>>

persian_kit_to_persian_digits(string $text): string;

persian_kit_to_english_digits(string $text): string;

persian_kit_to_arabic_digits(string $text): string;

persian_kit_normalize_persian(string $text): string;

persian_kit_slug(string $text): string;

persian_kit_is_persian(string $text, bool $complex = false): bool;

persian_kit_has_persian(string $text, bool $complex = false): bool;

persian_kit_is_arabic(string $text): bool;

persian_kit_has_arabic(string $text): bool;

persian_kit_half_space_fix(string $text): string;

persian_kit_keyboard_fix(string $text): string;

persian_kit_persian_sort(array $items, ?callable $key = null): array;

persian_kit_date(string $format, int|string $timestamp = '', ?\DateTimeZone $timezone = null): string;

persian_kit_gregorian_date(string $format, int|string $timestamp = '', ?\DateTimeZone $timezone = null): string;

persian_kit_jalali_to_gregorian(string $date, string $format = 'Y-m-d'): ?string;

persian_kit_date_field_attributes(array $options = []): string;

persian_kit_number_format(int|float|string $number, string $separator = ','): string;

persian_kit_number_to_words(int|float $number): string;

persian_kit_words_to_number(string $words): int|float|null;

persian_kit_ordinal_word(int $n): string;

persian_kit_ordinal_short(int $n, bool|string $digits = true): string;

persian_kit_time_ago(int|string|\DateTimeInterface $timestamp, ?int $now = null, bool $persianDigits = true): string;

persian_kit_currency_format( int|float|string $amount, string $unit = 'toman', bool $persianDigits = true, bool $withUnit = true, ): string;

persian_kit_currency_convert(int|float $amount, string $from, string $to): int|float;

persian_kit_validate_national_id(string $id): ValidationResult;

persian_kit_validate_phone(string $phone): ValidationResult;

persian_kit_validate_card_number(string $card): ValidationResult;

persian_kit_validate_iban(string $iban): ValidationResult;

persian_kit_validate_legal_id(string $id): ValidationResult;

persian_kit_validate_postal_code(string $code): ValidationResult;

persian_kit_validate_plate_number(string $plate): ValidationResult;

persian_kit_validate_bill_id(string $billId, ?string $paymentId = null): ValidationResult;

echo persian_kit_to_persian_digits('Order 123'), "\n";
echo persian_kit_normalize_persian('كتاب يكي ١٢'), "\n";
echo persian_kit_slug('نمونه نوشته ۱۴۰۵'), "\n";
echo persian_kit_half_space_fix('می خواهم کتاب ها را'), "\n";
echo persian_kit_date('Y/m/d', 1790899200, new DateTimeZone('UTC')), "\n";
echo persian_kit_jalali_to_gregorian('1405/07/10'), "\n";
echo persian_kit_validate_phone('+989121234567')->detail()->normalizedLocal, "\n";

Order ۱۲۳
کتاب یکی ۱۲
نمونه-نوشته-1405
می‌خواهم کتاب‌ها را
1405/07/10
2026-10-02
09121234567

echo persian_kit_to_english_digits('۱۲۳'), "\n";
echo persian_kit_to_arabic_digits('123'), "\n";
echo persian_kit_keyboard_fix('sghl'), "\n";
echo persian_kit_keyboard_fix('سلام'), "\n";
echo persian_kit_number_format('۱۲۳۴۵۶۷'), "\n";
echo persian_kit_number_format(1234567, '٬'), "\n";
echo persian_kit_number_to_words(123), "\n";
echo persian_kit_number_to_words(12.5), "\n";
echo persian_kit_words_to_number('بیست و یک'), "\n";
echo persian_kit_words_to_number('سه صد'), "\n";
echo json_encode(persian_kit_words_to_number('سلام')), "\n";
echo persian_kit_ordinal_word(3), "\n";
echo persian_kit_ordinal_word(30), "\n";
echo persian_kit_ordinal_short(3), "\n";
echo persian_kit_ordinal_short(3, false), "\n";
echo persian_kit_currency_format(1500000), "\n";
echo persian_kit_currency_format(1500000, 'rial', false, false), "\n";
echo persian_kit_currency_convert(100, 'toman', 'rial'), "\n";
echo persian_kit_currency_convert(1235, 'rial', 'toman'), "\n";
echo persian_kit_time_ago(1700000000, 1700003600), "\n";
echo persian_kit_jalali_to_gregorian('۱۴۰۳-۰۵-۱۲ ۱۸:۳۰', 'Y-m-d H:i'), "\n";
echo json_encode(persian_kit_jalali_to_gregorian('1403/12/31')), "\n";
echo persian_kit_gregorian_date('Y-m-d', 1790899200, new DateTimeZone('UTC')), "\n";

123
١٢٣
سلام
sghl
1,234,567
1٬234٬567
یکصد و بیست و سه
دوازده ممیز پنج
21
300
null
سوم
سی‌ام
۳ام
3ام
۱،۵۰۰،۰۰۰ تومان
1،500،000
1000
123.5
۱ ساعت پیش
2024-08-02 18:30
null
2026-10-02

⁅امض توابع نتیجه اعتبارسنجی قالببندی قالب بندی و api فیلد تاریخ این توابع در src functions php تعریف شد و با بارگذاری افزونه در دسترس حتی اگر بخش نامک خامو بود اگر افزونه ممکن است غیرفعال شد با function exists بررسی کرد بیشتر توابع از abzar و daynum همراه زیر namespace persiankit dependencies استفاد کرد تنظ بخش لزوما روی فراخوانی صریح تابع اثر نداشت اعتبارسنج برای ورودی نامعتبر validationresult برمیگردانند رمید گرداند و خطا ورودی را exception نکرد کلاس کامل persiankit dependencies eram abzar validation validationresult است isvalid اعتبار ساختار و قاعده بررسی را داد این استعلام هویت نیست isstrictlyvalid علاوه بر اعتبار نبود هشدار را خواست errors و warnings پیام فارسی errorcodes و warningcodes مورد enum برای کد هستند detail شیء با ویژگی فقطخواندنی فقط خواندنی یا null است نه آرایه ارایه jsonserialize خروجی آرایه ارایه با کلید snake case داد شهر بانک یا کد منطقه ناشناخته توانست هشدار داد و مقدار lookup را null کرد بدون اینکه ورودی از نظر ساختار نامعتبر شد همه اعتبارسنج اعداد فارسی و عربی و فاصله اطراف ورودی را پذیرفت و نشانه رایج کپیکردن کپی کرد مثل zwnj bidi mark و dash یونیکد را پاک کرد تابع بررسی و ویژگی detail persian kit validate national id کد ملی ورودی 8 یا 9 رقمی با صفر به 10 رقم رسید تکرار یک رقم و checksum غلط رد شد value citycode city province persian kit validate legal id شناسه ملی 11 رقمی و checksum value persian kit validate phone همراه یا ثابت ایران type normalizedlocal normalizede164 operator areacode city province نوع از phonenumbertype mobile یا landline است persian kit validate card number کارت 16 رقمی و luhn بدون الگوی تکراری value bin bank persian kit validate iban شبای ایران و mod 97 24 رقم بدون پیشوند ir گرفت value bankcode bank persian kit validate postal code الگوی کد پستی 10 رقمی postalcode zonecode persian kit validate plate number قالب nn letter nnn nn مثل 12ب345 67 twodigit letter threedigit citycode type province provinces persian kit validate bill id شناسه قبض و در صورت داد آرگومان ارگو دوم شناسه پرداخت و ارتباط checksum آن آنها ان billid paymentid type قالببندی قالب بندی عدد عدد به حرف زمان نسبی و ترتیب برای ورودی نامناسب formatexception از نوع runtimeexception داد واحد پول ناشناخته invalidargumentexception داد قالببندی قالب بندی مبلغ نامعتبر هم توانست خطا قالببندی قالب بندی داد تبدیل حرف به عدد برای متن نامفهو یا سرریز null داد persian kit date با token tokenه php مثل y m d تاریخ شمسی داد خروجی اولیه اعداد انگلیسی داشت ولی از filter به نام persian kit date display گذشت و ممکن است اعداد تغییر کرد تاریخ میلادی کنار آن ان اضافه نشد persian kit gregorian date میلادی داد و از تبدیل عمومی عبور نکرد timestamp یا رشت قابل فهم برای strtotime پذیرفت شد رشت بدون timezone از پیشفرض پیش فرض php پیروی کرد که معمولا در وردپرس utc است 0 و یعنی اکنون رشت نامعتبر پس از شکست strtotime به timestamp صفر cast شد بهتر است timestamp معتبر و timezone مشخص داد persian kit jalali to gregorian تاریخ شمسی یا میلادی را به قالب درخواستی برد اعداد فارسی عربی و انگلیسی جداکننده یا و ساعت بعد از تاریخ پذیرفت شد ساعت در timezone سایت است سال 1200 تا 1600 شمسی و از 1700 میلادی است تاریخ نامعتبر null داد مثلا 1403 05 12 برابر 2024 08 02 است و 1403 12 31 معتبر نیست persian kit date field attributes attribute attributeه escapeشد ورودی را داد و فایل انتخابگر را بارگذاری کرد format پیشفرض پیش فرض y m d همچن ymd و y m d h i s برای ساعت type پیشفرض پیش فرض date همچن range multiple month و year حالت غیرتکی قالب خروجی خود picker را داشت مثلا بازه 2026 10 02 2026 10 05 min و max تاریخ شمسی یا میلادی disable past و disable future boolean locale تگ bcp 47 پیشفرض پیش فرض زبان صفحه گزینه ناشناخته ناد گرفت شد بدون javascript ورودی به شکل قبلی ماند انتخاب تاریخ مقدار میلادی را به ورودی داد و event eventه input و change را اجرا کرد ویژگی required disabled readonly placeholder aria label min و max منتقل شد data persian kit date hint off راهنمای تایپ را فقط برای screen reader نگه داشت input type text name birthday php echo persian kit date field attributes max 2010 12 31 این قطعه در قالب وردپرس اجرا شد استایل با متغیر متغیره css به نام idp روی intl datepicker persian kit date picker تنظی شد در javascript window persiankitdatefield متد upgrade input upgradeall root refresh input و picker input داشت بعد از تغییر خامو مقدار با val از refresh استفاد کرد event نفرستاد فیلد تازه خودکار آماد اماد شد window persiankitcalendar jalalitoiso year month day و isotojalali 2026 10 02 تاریخ نامعتبر را null کرد توابع to persian digits to english digits و to arabic digits با پیشوند persian kit سه نوع عدد را تبدیل کرد normalize persian ی و ک عربی و اعداد عربی را فارسی کرد تنظی teh marbuta بخش نگارش را نخواند و پردازشگر html نیست slug حرف را اصلاح اعداد را انگلیسی و فاصله زیرخط و نیمفاصله نیم فاصله را خط تیره کرد و نشانه نامناسب url را حذف کرد half space fix بر اساس الگوی پیشوند و پسوند کار کرد و بیخطا بی خطا نیست keyboard fix چیدمان اشتباه را بین فارسی و لاتین تبدیل کرد sghl به سلا و برعکس رفت shift هم پشتیبانی شد persian sort آرایه ارایه جدید داد و برای ترتیب درست به intl نیاز داشت بدون آن ان به sort بایتی برگشت رمید گشت توانست callback استخراج نام داد number format جداکننده هزار را اضافه و علامت و اعشار را حفظ کرد رشت عددی فارسی هم پذیرفت شد number to words منفی و اعشار را نوشت words to number برعکس آن ان است ordinal word و ordinal short عدد مثبت خواست خروجی کوتاه پیشفرض پیش فرض فارسی است و رشت قدیمی persian و english را هم پذیرفت time ago گذشت و آینده اینده را نسبت به now یا اکنون توصیف کرد currency format پیشفرض پیش فرض توم با اعداد فارسی و نام واحد داد currency convert توم و ریال را با ضریب 10 تبدیل کرد و نتیجه صحیح را int داد واحد toman و rial هستند و بزرگی حرف مهم نیست is persian همه متن و has persian وجود یک حرف فارسی را بررسی کرد حالت complex حرف مشترک عربی و نشانه بیشتر را هم پذیرفت is arabic و has arabic به حرف مخصوص عربی حساس تشخیص عمومی زبان از هر کاراک یونیکد نبود امضا عینا از کد آمد امد نام و مقدار مقداره پیشفرض پیش فرض را ترجمه نکرد persian kit to persian digits string text string persian kit to english digits string text string persian kit to arabic digits string text string persian kit normalize persian string text string persian kit slug string text string persian kit is persian string text bool complex false bool persian kit has persian string text bool complex false bool persian kit is arabic string text bool persian kit has arabic string text bool persian kit half space fix string text string persian kit keyboard fix string text string persian kit persian sort array items callable key null array persian kit date string format int string timestamp datetimezone timezone null string persian kit gregorian date string format int string timestamp datetimezone timezone null string persian kit jalali to gregorian string date string format y m d string persian kit date field attributes array options string persian kit number format int float string number string separator string persian kit number to words int float number string persian kit words to number string words int float null persian kit ordinal word int n string persian kit ordinal short int n bool string digits true string persian kit time ago int string datetimeinterface timestamp int now null bool persiandigits true string persian kit currency format int float string amount string unit toman bool persiandigits true bool withunit true string persian kit currency convert int float amount string from string to int float persian kit validate national id string id validationresult persian kit validate phone string phone validationresult persian kit validate card number string card validationresult persian kit validate iban string iban validationresult persian kit validate legal id string id validationresult persian kit validate postal code string code validationresult persian kit validate plate number string plate validationresult persian kit validate bill id string billid string paymentid null validationresult اجراکننده مستند توابع همراه را با utc و filter بدون تغییر بارگذاری کرد دیتابیس وردپرس بارگذاری نشد سایت واقعی توانست خروجی تاریخ را filter کرد echo persian kit to persian digits order 123 n echo persian kit normalize persian کتاب یکی 12 n echo persian kit slug نمونه نوشت 1405 n echo persian kit half space fix خواست کتاب را n echo persian kit date y m d 1790899200 new datetimezone utc n echo persian kit jalali to gregorian 1405 07 10 n echo persian kit validate phone 989121234567 detail normalizedlocal n order 123 کتاب یکی 12 نمونه نوشت 1405 خواست کتاب را 1405 07 10 2026 10 02 09121234567 مرتبط hook نمونه کاربردی و رفتار تاریخ این مثال از همان محیط جدا و زمان ثابت استفاد کرد echo persian kit to english digits 123 n echo persian kit to arabic digits 123 n echo persian kit keyboard fix sghl n echo persian kit keyboard fix سلا n echo persian kit number format 1234567 n echo persian kit number format 1234567 n echo persian kit number to words 123 n echo persian kit number to words 12 5 n echo persian kit words to number بیست و یک n echo persian kit words to number سه صد n echo json encode persian kit words to number سلا n echo persian kit ordinal word 3 n echo persian kit ordinal word 30 n echo persian kit ordinal short 3 n echo persian kit ordinal short 3 false n echo persian kit currency format 1500000 n echo persian kit currency format 1500000 rial false false n echo persian kit currency convert 100 toman rial n echo persian kit currency convert 1235 rial toman n echo persian kit time ago 1700000000 1700003600 n echo persian kit jalali to gregorian 1403 05 12 18 30 y m d h i n echo json encode persian kit jalali to gregorian 1403 12 31 n echo persian kit gregorian date y m d 1790899200 new datetimezone utc n 123 123 سلا sghl 1 234 567 1 234 567 یکصد و بیست و سه دوازد ممیز پنج 21 300 null سوم سی سیا 3ام 3ام 1 500 000 توم 1 500 000 1000 123 5 1 ساعت پیش 2024 08 02 18 30 null 2026 10 02⁆

⁅api در php⁆

⁅نتیجه اعتبارسنجی و خطاتاریخ و ورودی تاریخمتن و عددامض توابعمثال قابل تکرارمثال قالببندی قالب بندی⁆