تنزيل php helpers - تنزيل كود مصدر php helpers

عن

مكتبة clausnz/php-helpers عبارة عن مجموعة من 45 وظيفة مفيدة لمساعد php (PHP 5.6, 7.*) .
بعد التثبيت باستخدام composer ، يمكن الوصول إلى الوظائف العامة من كل مكان في التعليمات البرمجية الخاصة بك:

تثبيت

composer require clausnz/php-helpers

مثال

 <?php

dump ( ' any content ' );

إذا كانت هناك دالة بنفس الاسم موجودة بالفعل في قائمة الوظائف المحددة لمشروعك (المضمنة والمحددة من قبل المستخدم)، فلن يتم تسجيلها في بيئتك. ولذلك، لن تظهر أية تعارضات مع الوظائف الموجودة.

ومع ذلك، لا يزال من الممكن الوصول إلى كل وظيفة بطريقة ثابتة باستخدام بيان الاستخدام المناسب:

مثال

 <?php

use CNZ  Helpers  Util as util ;

util:: dump ( ' any content ' );

الاعتمادات

تستفيد هذه المكتبة من المكتبات الرائعة والمعروفة التالية:

https://github.com/serbanghita/Mobile-Detect
https://github.com/JayBizzle/Crawler-Detect
https://github.com/mustangostang/spyc

الاختبارات

يتم اختبار جميع الوظائف مقابل عدد من اختبارات الوحدات وإصدارات PHP.

ثَبَّتَ

قم بتثبيت أحدث مكتبة clausnz/php-helper باستخدام الملحن:

composer require clausnz/php-helpers

تأكد أيضًا من طلب ملف التحميل التلقائي للملحن الخاص بك:

 require __DIR__ . ' /vendor/autoload.php ' ;

بعد التثبيت، تتوفر وظائف PHP العالمية الجديدة في كل مكان في التعليمات البرمجية الخاصة بك. للوصول إلى الوظائف الثابتة (المتطابقة تقريبًا) في الفئات المساعدة، أضف بيان الاستخدام المناسب إلى ملفك:

مثال

 <?php

use CNZ  Helpers  Dev as dev ;

if ( dev:: isIphone () ) {
   // Do something here
}

وظائف PHP المتاحة

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

جهاز
- is_mobile
- is_smartphone
- is_tablet
- is_desktop
- is_robot
- is_ios
- is_android
- is_iphone
- is_samsung
صفيف
- array_get
- array_set
- array_first
- array_last
- to_array
- to_object
- is_assoc
خيط
- str_before
- str_after
- str_after_last
- str_between
- str_insert
- str_limit
- str_limit_words
- str_contains
- str_icontains
- str_starts_with
- str_istarts_with
- str_ends_with
- str_iends_with
المرافق
- الملكية الفكرية
- is_email
- أحمق
- د
- crypt_password
- is_password
يمل
- to_yml
- to_yml_file
- yml_parse
- yml_parse_file
- is_yml
- is_yml_file
- yml_get
- yml_get_file
- yml_set
- yml_set_file

وثائق واجهة برمجة التطبيقات

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

آر
- isAssoc
- toObject
- أحمق
- أولاً
- آخر
- يحصل
- تعيين
ديف
- com.isSmartphone
- com.isMobile
- mobileDetect
- com.isTablet
- com.isDesktop
- com.isRobot
- CrawlerDetect
- com.isAndroid
- com.isIphone
- com.isSamsung
- isIOS
شارع
- إدراج
- بين
- بعد
- قبل
- LimitWords
- حد
- يتضمن
- يحتوي علىIgnoreCase
- يبدأ مع
- يبدأ مع IgnoreCase
- ينتهي مع
- ينتهي مع IgnoreCase
- afterLast
فائدة
- isEmail
- الملكية الفكرية
- cryptPassword
- com.isPassword
- د
- أحمق
يمل
- isValidFile
- isValid
- تحليل
- يحصل
- getFile
- ملف تحليلي
- setFile
- dumpFile
- أحمق
- تعيين

آر

فئة مساعدة توفر سهولة الوصول إلى وظائف مصفوفة php المفيدة.

فئة آر

الاسم الكامل: CNZHelpersArr

isAssoc

يكتشف ما إذا كانت القيمة المحددة عبارة عن مصفوفة ترابطية.

Arr:: isAssoc ( array $ array ): boolean

is_assoc

الوظيفة العالمية ذات الصلة (الوصف انظر أعلاه).

 is_assoc ( array $ array ): boolean

مثال

 $ array = [
    ' foo ' => ' bar '
];

is_assoc ( $ array );

// bool(true)

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$array`	صفيف	أي نوع من المصفوفة.

قيمة الإرجاع:

صحيح إذا كانت المصفوفة ترابطية، وخطأ فيما عدا ذلك.

toObject

تحويل مصفوفة إلى كائن.

Arr:: toObject ( array $ array ): object| null

to_object

الوظيفة العالمية ذات الصلة (الوصف انظر أعلاه).

 to_object ( array $ array ): object| null

مثال

 $ array = [
    ' foo ' => [
         ' bar ' => ' baz '
    ]
];

$ obj = to_object ( $ array );
echo $ obj -> foo -> bar ;

// baz

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$array`	صفيف	المصفوفة المراد تحويلها.

قيمة الإرجاع:

تمثيل كائن std للصفيف المحول.

أحمق

تحويل سلسلة أو كائن إلى صفيف.

Arr:: dump ( string|object $ var ): array| null

to_array

الوظيفة العالمية ذات الصلة (الوصف انظر أعلاه).

 to_array ( string|object $ var ): array| null

المثال 1 (سلسلة)

 $ var = ' php ' ;
to_array ( $ var );

// (
//     [0] => p
//     [1] => h
//     [2] => p
// )

المثال 2 (الكائن)

 $ var = new stdClass ;
$ var -> foo = ' bar ' ;

to_array ( $ var );

// (
//     [foo] => bar
// )

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$var`	سلسلة\|كائن	سلسلة أو كائن.

قيمة الإرجاع:

تمثيل صفيف للسلسلة أو الكائن المحول. إرجاع فارغة على الخطأ.

أولاً

إرجاع العنصر الأول من المصفوفة.

Arr:: first ( array $ array ): mixed

array_first

الوظيفة العالمية ذات الصلة (الوصف انظر أعلاه).

 array_first ( array $ array ): mixed

مثال

 $ array = [
     ' foo ' => ' bar ' ,
     ' baz ' => ' qux '
];

array_first ( $ array )

// bar

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$array`	صفيف	المصفوفة المعنية.

قيمة الإرجاع:

قيمة العنصر الأول بدون مفتاح. نوع مختلط.

آخر

إرجاع العنصر الأخير في المصفوفة.

Arr:: last ( array $ array ): mixed

array_last

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 array_last ( array $ array ): mixed

مثال

 $ array = [
     ' foo ' => ' bar ' ,
     ' baz ' => ' qux '
];

array_last ( $ array )

// qux

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$array`	صفيف	المصفوفة المعنية.

قيمة الإرجاع:

قيمة العنصر الأخير، بدون مفتاح. نوع مختلط.

يحصل

الحصول على قيمة في مصفوفة عن طريق تدوين النقاط للمفاتيح.

Arr:: get ( string $ key , array $ array ): mixed

array_get

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 array_get ( string key, array $ array ): mixed

مثال

 $ array = [
     ' foo ' => ' bar ' ,
     ' baz ' => [
         ' qux => ' foobar'
     ]
];

array_get ( ' baz.qux ' , $ array );

// foobar

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$key`	خيط	المفتاح عن طريق تدوين النقطة.
`$array`	صفيف	المصفوفة المراد البحث فيها.

قيمة الإرجاع:

القيمة التي تم البحث عنها، فارغة خلاف ذلك.

تعيين

يضبط قيمة في مصفوفة باستخدام تدوين النقطة.

Arr:: set ( string $ key , mixed $ value , array & $ array ): boolean

array_set

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 array_set ( string key, mixed value, array $ array ): boolean

مثال 1

 $ array = [
     ' foo ' => ' bar ' ,
     ' baz ' => [
         ' qux => ' foobar'
     ]
];

array_set ( ' baz.qux ' , ' bazqux ' , $ array );

// (
//     [foo] => bar
//     [baz] => [
//         [qux] => bazqux
//     ]
// )

مثال 2

 $ array = [
     ' foo ' => ' bar ' ,
     ' baz ' => [
         ' qux => ' foobar'
     ]
];

array_set ( ' baz.foo ' , ' bar ' , $ array );

// (
//     [foo] => bar
//     [baz] => [
//         [qux] => bazqux
//         [foo] => bar
//     ]
// )

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$key`	خيط	المفتاح للضبط باستخدام تدوين النقطة.
`$value`	مختلط	القيمة التي سيتم تعيينها على المفتاح المحدد.
`$array`	صفيف	المصفوفة المعنية.

قيمة الإرجاع:

صحيح إذا تم تعيين القيمة الجديدة بنجاح، وإلا فسيكون خطأ.

ديف

فئة مساعدة توفر سهولة الوصول إلى وظائف php المفيدة بالاشتراك مع وكيل المستخدم.

فئة التطوير

الاسم الكامل: CNZHelpersDev

com.isSmartphone

يحدد ما إذا كان الجهاز الحالي هو هاتف ذكي.

Dev:: isSmartphone (  ): boolean

is_smartphone

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 is_smartphone (  ): boolean

مثال

 if ( is_smartphone () ) {
     // I am a smartphone
}

هذه الطريقة ثابتة .

قيمة الإرجاع:

صحيح إذا كان الزائر الحالي يستخدم الهاتف الذكي، وخطأ غير ذلك.

com.isMobile

يكتشف ما إذا كان الزائر الحالي يستخدم جهازًا محمولاً (الهاتف الذكي/الكمبيوتر اللوحي/المحمول).

Dev:: isMobile (  ): boolean

is_mobile

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 is_mobile (  ): boolean

مثال

 if ( is_mobile () ) {
     // I am a mobile device (smartphone/tablet or handheld)
}

هذه الطريقة ثابتة .

قيمة الإرجاع:

صحيح إذا كان الزائر الحالي يستخدم جهازًا محمولاً، وخطأ بخلاف ذلك.

mobileDetect

احصل على كائن MobileDetect فردي لاستدعاء كل طريقة يوفرها.

Dev::mobileDetect(  ):  Detection  MobileDetect

الوصول العام للاستخدام خارج هذا الفصل. Mobile_Detect دوكو: https://github.com/serbanghita/Mobile-Detect

هذه الطريقة ليس لها وظيفة عالمية ذات صلة!

مثال

Dev:: mobileDetect ()-> version ( ' Android ' );

// 8.1

هذه الطريقة ثابتة .

قيمة الإرجاع:

كائن MobileDetect فردي لاستدعاء كل طريقة يوفرها.

com.isTablet

تحديد ما إذا كان الزائر الحالي يستخدم جهازًا لوحيًا.

Dev:: isTablet (  ): boolean

is_tablet

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 is_tablet (  ): boolean

مثال

 if ( is_tablet () ) {
     // I am a tablet
}

هذه الطريقة ثابتة .

قيمة الإرجاع:

صحيح إذا كان الزائر الحالي يستخدم جهازًا لوحيًا، وخطأ بخلاف ذلك.

com.isDesktop

يحدد ما إذا كان الزائر الحالي يستخدم جهاز كمبيوتر مكتبي.

Dev:: isDesktop (  ): boolean

is_desktop

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 is_desktop (  ): boolean

مثال

 if ( is_desktop () ) {
     // I am a desktop computer (Mac, Linux, Windows)
}

هذه الطريقة ثابتة .

قيمة الإرجاع:

صحيح إذا كان الزائر الحالي يستخدم جهاز كمبيوتر مكتبي، وخطأ إذا كان خلاف ذلك.

com.isRobot

يحدد ما إذا كان الزائر الحالي هو محرك بحث/بوت/زاحف/عنكبوت.

Dev:: isRobot (  ): boolean

is_robot

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 is_robot (  ): boolean

مثال

 if ( is_robot () ) {
     // I am a robot (search engine, bot, crawler, spider)
}

هذه الطريقة ثابتة .

قيمة الإرجاع:

صحيح إذا كان الزائر الحالي محرك بحث/بوت/زاحف/عنكبوت، وخطأ إذا كان خلاف ذلك.

CrawlerDetect

احصل على كائن CrawlerDetect فردي لاستدعاء كل طريقة يوفرها.

Dev::crawlerDetect(  ):  Jaybizzle  CrawlerDetect  CrawlerDetect

الوصول العام للاستخدام خارج هذا الفصل. كشف الزاحف دوكو: https://github.com/JayBizzle/Crawler-Detect

هذه الطريقة ليس لها وظيفة عالمية ذات صلة!

مثال

Dev:: crawlerDetect ()-> getMatches ();

// Output the name of the bot that matched (if any)

هذه الطريقة ثابتة .

com.isAndroid

يحدد ما إذا كان الجهاز الحالي يعمل بنظام التشغيل Android.

Dev:: isAndroid (  ): boolean

is_android

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 is_android (  ): boolean

مثال

 if ( is_android () ) {
     // I am an Android based device
}

هذه الطريقة ثابتة .

قيمة الإرجاع:

صحيح إذا كان الزائر الحالي يستخدم جهازًا يعمل بنظام التشغيل Android، وخطأ إذا كان خلاف ذلك.

com.isIphone

تحديد ما إذا كان الجهاز الحالي هو iPhone.

Dev:: isIphone (  ): boolean

is_iphone

الوظيفة العالمية ذات الصلة (الوصف انظر أعلاه).

 is_iphone (  ): boolean

مثال

 if ( is_iphone () ) {
     // I am an iPhone
}

هذه الطريقة ثابتة .

قيمة الإرجاع:

صحيح إذا كان الزائر الحالي يستخدم جهاز iPhone، وخطأ غير ذلك.

com.isSamsung

يحدد ما إذا كان الجهاز الحالي من سامسونج.

Dev:: isSamsung (  ): boolean

is_samsung

الوظيفة العالمية ذات الصلة (الوصف انظر أعلاه).

 is_samsung (  ): boolean

مثال

 if ( is_samsung () ) {
     // I am a device from Samsung
}

هذه الطريقة ثابتة .

قيمة الإرجاع:

صحيح إذا كان الزائر الحالي يستخدم جهاز سامسونج، وخطأ غير ذلك.

com.isIOS

يحدد ما إذا كان الجهاز الحالي يعمل بنظام التشغيل iOS.

Dev:: isIOS (  ): boolean

is_ios

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 is_ios (  ): boolean

مثال

 if ( is_ios () ) {
     // I am an iOS based device
}

هذه الطريقة ثابتة .

قيمة الإرجاع:

صحيح إذا كان الزائر الحالي يستخدم جهاز iOS، وخطأ إذا كان خلاف ذلك.

شارع

فئة مساعدة توفر سهولة الوصول إلى وظائف سلسلة PHP المفيدة.

شارع الطبقة

الاسم الكامل: CNZHelpersStr

إدراج

إدراج سلسلة واحدة أو أكثر في سلسلة أخرى في موضع محدد.

Str:: insert ( array $ keyValue , string $ string ): string

str_insert

الوظيفة العالمية ذات الصلة (الوصف انظر أعلاه).

 str_insert ( array $ keyValue , string $ string ): string

مثال

 $ keyValue = [
     ' :color ' => ' brown ' ,
     ' :animal ' => ' dog '
]
$ string = ' The quick :color fox jumps over the lazy :animal. ' ;

str_insert ( $ keyValue , $ string );

// The quick brown fox jumps over the lazy dog.

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$keyValue`	صفيف	مصفوفة ترابطية مع أزواج القيمة الرئيسية =>.
`$string`	خيط	النص مع السلاسل المراد استبدالها.

قيمة الإرجاع:

السلسلة المستبدلة.

بين

قم بإرجاع المحتوى في سلسلة بين العنصر الأيسر والأيمن.

Str:: between ( string $ left , string $ right , string $ string ): array

str_between

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 str_between ( string $ left , string $ right , string $ string ): array

مثال

 $ string = ' <tag>foo</tag>foobar<tag>bar</tag> '

str_between ( ' <tag> ' , ' </tag> ' $ string );

// (
//     [0] => foo
//     [1] => bar
// )

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$left`	خيط	العنصر الأيسر من السلسلة للبحث.
`$right`	خيط	العنصر الصحيح من السلسلة المراد البحث عنها.
`$string`	خيط	السلسلة المراد البحث فيها.

قيمة الإرجاع:

مصفوفة نتائج تحتوي على جميع مطابقات البحث.

بعد

إرجاع جزء السلسلة بعد قيمة معينة.

Str:: after ( string $ search , string $ string ): string

str_after

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 str_after ( string $ search , string $ string ): string

مثال

 $ string = ' The quick brown fox jumps over the lazy dog ' ;

str_after ( ' fox ' $ string );

// jumps over the lazy dog

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$search`	خيط	السلسلة المراد البحث عنها.
`$string`	خيط	السلسلة المراد البحث فيها.

قيمة الإرجاع:

السلسلة التي تم العثور عليها بعد سلسلة البحث. ستتم إزالة المسافات البيضاء في البداية.

قبل

احصل على جزء من السلسلة قبل قيمة معينة.

Str:: before ( string $ search , string $ string ): string

str_before

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 str_before ( string $ search , string $ string ): string

مثال

 $ string = ' The quick brown fox jumps over the lazy dog ' ;

str_before ( ' fox ' $ string );

// The quick brown

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$search`	خيط	السلسلة المراد البحث عنها.
`$string`	خيط	السلسلة المراد البحث فيها.

قيمة الإرجاع:

السلسلة التي تم العثور عليها قبل سلسلة البحث. ستتم إزالة المسافات البيضاء في النهاية.

LimitWords

الحد من عدد الكلمات في السلسلة. ضع قيمة $end في نهاية السلسلة.

Str:: limitWords ( string $ string , integer $ limit = 10 , string $ end = ' ... ' ): string

str_limit_words

الوظيفة العالمية ذات الصلة (الوصف انظر أعلاه).

 str_limit_words ( string $ string , int $ limit = 10 , string $ end = ' ... ' ): string

مثال

 $ string = ' The quick brown fox jumps over the lazy dog ' ;

str_limit_words ( $ string , 3 );

// The quick brown...

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$string`	خيط	السلسلة للحد من الكلمات.
`$limit`	عدد صحيح	عدد الكلمات للحد. الافتراضي إلى 10.
`$end`	خيط	السلسلة لإنهاء سلسلة القطع. الإعدادات الافتراضية إلى "..."

قيمة الإرجاع:

السلسلة المحدودة مع $end في النهاية.

حد

تحديد عدد الأحرف في السلسلة. ضع قيمة $end في نهاية السلسلة.

Str:: limit ( string $ string , integer $ limit = 100 , string $ end = ' ... ' ): string

str_limit

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 str_limit ( string $ string , int $ limit = 100 , string $ end = ' ... ' ): string

مثال

 $ string = ' The quick brown fox jumps over the lazy dog ' ;

str_limit ( $ string , 15 );

// The quick brown...

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$string`	خيط	السلسلة للحد من الأحرف.
`$limit`	عدد صحيح	عدد الأحرف المسموح به. الافتراضي إلى 100.
`$end`	خيط	السلسلة لإنهاء سلسلة القطع. الإعدادات الافتراضية إلى "..."

قيمة الإرجاع:

السلسلة المحدودة مع $end في النهاية.

يتضمن

اختبارات إذا كانت السلسلة تحتوي على عنصر معين

Str:: contains ( string|array $ needle , string $ haystack ): boolean

str_contains

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 str_contains ( string|array $ needle , string $ haystack ): boolean

مثال

 $ string = ' The quick brown fox jumps over the lazy dog ' ;
$ array = [
     ' cat ' ,
     ' fox '
];

str_contains ( $ array , $ string );

// bool(true)

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$needle`	سلسلة\|صفيف	سلسلة أو مجموعة من السلاسل.
`$haystack`	خيط	السلسلة المراد البحث فيها.

قيمة الإرجاع:

صحيح إذا تم العثور على $needle، وخطأ بخلاف ذلك.

يحتوي علىIgnoreCase

يختبر ما إذا كانت السلسلة تحتوي على عنصر معين. تجاهل حساسية الحالة.

Str:: containsIgnoreCase ( string|array $ needle , string $ haystack ): boolean

str_icontains

الوظيفة العالمية ذات الصلة (الوصف انظر أعلاه).

 str_icontains ( string|array $ needle , string $ haystack ): boolean

مثال

 $ string = ' The quick brown fox jumps over the lazy dog ' ;
$ array = [
     ' Cat ' ,
     ' Fox '
];

str_icontains ( $ array , $ string );

// bool(true)

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$needle`	سلسلة\|صفيف	سلسلة أو مجموعة من السلاسل.
`$haystack`	خيط	السلسلة المراد البحث فيها.

قيمة الإرجاع:

صحيح إذا تم العثور على $needle، وخطأ بخلاف ذلك.

يبدأ مع

تحديد ما إذا كانت سلسلة معينة تبدأ بسلسلة فرعية معينة.

Str:: startsWith ( string|array $ needle , string $ haystack ): boolean

str_starts_with

الوظيفة العالمية ذات الصلة (الوصف انظر أعلاه).

 str_starts_with ( string|array $ needle , string $ haystack ): boolean

مثال

 $ string = ' The quick brown fox jumps over the lazy dog ' ;
$ array = [
     ' Cat ' ,
     ' The '
];

str_starts_with ( $ array , $ string );

// bool(true)

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$needle`	سلسلة\|صفيف	السلسلة أو مجموعة السلاسل المطلوب البحث عنها.
`$haystack`	خيط	السلسلة المراد البحث فيها.

قيمة الإرجاع:

صحيح إذا تم العثور على $needle، وخطأ بخلاف ذلك.

يبدأ مع IgnoreCase

تحديد ما إذا كانت سلسلة معينة تبدأ بسلسلة فرعية معينة. تجاهل حساسية الحالة.

Str:: startsWithIgnoreCase ( string|array $ needle , string $ haystack ): boolean

str_istarts_with

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 str_istarts_with ( string|array $ needle , string $ haystack ): boolean

مثال

 $ string = ' The quick brown fox jumps over the lazy dog ' ;
$ array = [
     ' cat ' ,
     ' the '
];

str_istarts_with ( $ array , $ string );

// bool(true)

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$needle`	سلسلة\|صفيف	السلسلة أو مجموعة السلاسل المطلوب البحث عنها.
`$haystack`	خيط	السلسلة المراد البحث فيها.

قيمة الإرجاع:

صحيح إذا تم العثور على $needle، وخطأ بخلاف ذلك.

ينتهي مع

تحديد ما إذا كانت سلسلة معينة تنتهي بسلسلة فرعية معينة.

Str:: endsWith ( string|array $ needle , string $ haystack ): boolean

str_ends_with

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 str_ends_with ( string|array $ needle , string $ haystack ): boolean

مثال

 $ string = ' The quick brown fox jumps over the lazy dog ' ;
$ array = [
     ' cat ' ,
     ' dog '
];

str_ends_with ( $ array , $ string );

// bool(true)

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$needle`	سلسلة\|صفيف	السلسلة أو مجموعة السلاسل المطلوب البحث عنها.
`$haystack`	خيط	السلسلة المراد البحث فيها.

قيمة الإرجاع:

صحيح إذا تم العثور على $needle، وخطأ بخلاف ذلك.

ينتهي مع IgnoreCase

تحديد ما إذا كانت سلسلة معينة تنتهي بسلسلة فرعية معينة.

Str:: endsWithIgnoreCase ( string|array $ needle , string $ haystack ): boolean

str_iends_with

الوظيفة العالمية ذات الصلة (الوصف انظر أعلاه).

 str_iends_with ( string|array $ needle , string $ haystack ): boolean

مثال

 $ string = ' The quick brown fox jumps over the lazy dog ' ;
$ array = [
     ' Cat ' ,
     ' Dog '
];

str_iends_with ( $ array , $ string );

// bool(true)

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$needle`	سلسلة\|صفيف	السلسلة أو مجموعة السلاسل المطلوب البحث عنها.
`$haystack`	خيط	السلسلة المراد البحث فيها.

قيمة الإرجاع:

صحيح إذا تم العثور على $needle، وخطأ بخلاف ذلك.

afterLast

إرجاع جزء السلسلة بعد آخر تواجد لقيمة بحث معينة.

Str:: afterLast ( string $ search , string $ string ): string

str_after_last

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 str_after_last ( string $ search , string $ string ): string

مثال

 $ path = " /var/www/html/public/img/image.jpg " ;

str_after_last ( ' / ' $ path );

// image.jpg

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$search`	خيط	السلسلة المراد البحث عنها.
`$string`	خيط	السلسلة المراد البحث فيها.

قيمة الإرجاع:

السلسلة التي تم العثور عليها بعد آخر تواجد لسلسلة البحث. ستتم إزالة المسافات البيضاء في البداية.

فائدة

فئة مساعدة توفر سهولة الوصول إلى وظائف php الشائعة والمفيدة.

فئة Util

الاسم الكامل: CNZHelpersUtil

isEmail

التحقق من صحة عنوان البريد الإلكتروني المحدد.

Util:: isEmail ( string $ email ): boolean

is_email

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 is_email ( string $ email ): boolean

مثال

 $ email = ' [email protected] ' ;

is_email ( $ email );

// bool(true)

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$email`	خيط	عنوان البريد الإلكتروني للاختبار.

قيمة الإرجاع:

صحيح إذا كانت السلسلة المعطاة عنوان بريد إلكتروني صالحًا، وإلا فسيكون خطأ.

الملكية الفكرية

احصل على عنوان IP الحالي للمستخدم.

Util:: ip (  ): string| null

user_ip

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 ip (  ): null|string

مثال

 echo ip ();

// 127.0.0.1

هذه الطريقة ثابتة .

قيمة الإرجاع:

عنوان IP المكتشف، يكون فارغًا إذا لم يتم اكتشاف IP.

cryptPassword

ينشئ تجزئة آمنة من كلمة مرور معينة. يستخدم خوارزمية CRYPT_BLOWFISH.

Util:: cryptPassword ( string $ password ): string

ملاحظة: يوصى باستخدام 255 حرفًا لعمود قاعدة البيانات!

crypt_password

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 crypt_password ( string $ password ): string

مثال

 $ password = ' foobar ' ;

crypt_password ( $ password );

// $2y$10$6qKwbwTgwQNcmcaw04eSf.QpP3.4T0..bEnY62dd1ozM8L61nb8AC

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$password`	خيط	كلمة المرور للتشفير.

قيمة الإرجاع:

كلمة المرور المشفرة.

com.isPassword

التحقق من تطابق كلمة المرور مع كلمة المرور المشفرة (خوارزمية CRYPT_BLOWFISH).

Util:: isPassword ( string $ password , string $ cryptedPassword ): boolean

is_password

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 is_password ( string $ password , string $ cryptedPassword ): boolean

مثال

 $ password = ' foobar ' ;
$ cryptedPassword = ' $2y$10$6qKwbwTgwQNcmcaw04eSf.QpP3.4T0..bEnY62dd1ozM8L61nb8AC ' ;

is_password ( $ password , $ cryptedPassword );

// bool(true)

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$password`	خيط	كلمة المرور للاختبار.
`$cryptedPassword`	خيط	كلمة المرور المشفرة (على سبيل المثال المخزنة في قاعدة البيانات).

د

يفرغ محتوى المتغير المحدد ويخرج من البرنامج النصي.

Util:: dd ( mixed $ var )

د

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 dd ( mixed $ var )

مثال

 $ array = [
     ' foo ' => ' bar ' ,
     ' baz ' => ' qux '
];

dd ( $ array );

// (
//     [foo] => bar
//     [baz] => qux
// )

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$var`	مختلط	فار للتفريغ.

أحمق

مقالب محتوى المتغير المحدد. لا يتوقف البرنامج النصي بعد المكالمة.

Util:: dump ( mixed $ var )

أحمق

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 dump ( mixed $ var )

مثال

 $ array = [
     ' foo ' => ' bar ' ,
     ' baz ' => ' qux '
];

dump ( $ array );

// (
//     [foo] => bar
//     [baz] => qux
// )

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$var`	مختلط	فار للتفريغ.

يمل

فئة مساعدة توفر سهولة الوصول إلى وظائف php yml المفيدة.

فئة يمل

الاسم الكامل: CNZHelpersYml

isValidFile

التحقق من صحة ما إذا كان الملف المعطى يحتوي على صيغة yaml.

Yml:: isValidFile ( string $ file ): boolean

is_yml_file

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 is_yml_file ( string $ file ): boolean

مثال

 $ file = /path/to/file.yml

is_yml_file ( $ file );

// bool(true)

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$file`	خيط	الملف الذي سيتم اختباره لبناء جملة yaml.

قيمة الإرجاع:

صحيح إذا كان الملف يحتوي على صيغة yaml، وإلا فهو خطأ.

isValid

يختبر ما إذا كان بناء جملة سلسلة معينة هو yaml.

Yml:: isValid ( string $ string ): boolean

is_yml

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 is_yml ( string $ string ): boolean

مثال

 $ string = "
     foo: bar
     baz: qux
     foobar:
         foo: bar
" ;

is_yml ( $ string );

// bool(true)

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$string`	خيط	السلسلة المراد اختبارها لبناء جملة yaml.

قيمة الإرجاع:

صحيح إذا كانت السلسلة هي yaml، وإلا فهي خاطئة.

تحليل

يحول سلسلة yaml معينة إلى مصفوفة.

Yml:: parse ( string $ yml ): array| null

yml_parse

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 yml_parse ( string $ yml ): array| null

مثال

 $ yml = "
     foo: bar
     baz: qux
     foobar:
         foo: bar
" ;

yml_parse ( $ yml );

// (
//       [foo] => bar
//       [baz] => qux
//       [foobar] => (
//           [foo] => bar
//       )
// )

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$yml`	خيط	سلسلة yaml للتحليل.

قيمة الإرجاع:

المصفوفة المحولة، خالية عند الخطأ.

يحصل

الحصول على قيمة في سلسلة yaml باستخدام تدوين النقطة.

Yml:: get ( string $ key , string $ yml ): mixed

yml_get

الوظيفة العالمية ذات الصلة (الوصف انظر أعلاه).

 yml_get ( string $ key , string $ yml ): mixed

مثال

 $ yml = "
     foo: bar
     baz: qux
     foobar:
         foo: bar
" ;

yml_get ( ' foobar.foo ' , $ yml );

// bar

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$key`	خيط	مفتاح البحث باستخدام التدوين النقطي (على سبيل المثال "foo.bar.baz").
`$yml`	خيط	سلسلة yml المراد البحث فيها.

قيمة الإرجاع:

القيمة التي تم العثور عليها، فارغة خلاف ذلك.

getFile

يحصل على قيمة في ملف yaml باستخدام تدوين النقطة.

Yml:: getFile ( string $ key , string $ ymlfile ): mixed

yml_get_file

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 yml_get_file ( string $ key , string $ ymlfile ): mixed

مثال

 $ ymlfile = ' /path/to/file.yml ' ;

yml_get_file ( ' foobar.foo ' , $ ymlfile );

// bar

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$key`	خيط	مفتاح البحث باستخدام التدوين النقطي (على سبيل المثال 'foo.bar.baz').
`$ymlfile`	خيط	ملف yml للبحث فيه.

قيمة الإرجاع:

القيمة التي تم العثور عليها، فارغة خلاف ذلك.

ملف تحليلي

يقوم بتحميل محتوى ملف yamlfile في مصفوفة.

Yml:: parseFile ( string $ ymlfile ): array

yml_parse_file

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 yml_parse_file ( string $ ymlfile ): array| null

مثال

 $ ymlfile = ' /path/to/file.yml ' ;

yml_parse_file ( $ ymlfile );

// (
//       [foo] => bar
//       [baz] => qux
//       [foobar] => (
//           [foo] => bar
//       )
// )

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$ymlfile`	خيط	مسار الملف الذي سيتم القراءة منه.

قيمة الإرجاع:

المصفوفة التي تم تحليلها.

setFile

يضبط قيمة في ملف yamlfile باستخدام تدوين النقطة. ملحوظة: ستتم إزالة جميع التعليقات الموجودة في الملف!

Yml:: setFile ( string $ key , mixed $ value , string $ ymlfile ): boolean

yml_set_file

الوظيفة العالمية ذات الصلة (الوصف انظر أعلاه).

 yml_set_file ( string $ key , mixed $ value , string $ ymlfile ): boolean

مثال

 $ ymlfile = ' /path/to/file.yml ' ;

yml_set_file ( ' foobar.foo ' , ' baz ' , $ ymlfile );

//   foo: bar
//   baz: qux
//   foobar:
//       foo: baz

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$key`	خيط	السلسلة المراد البحث بها مع تدوين النقطة
`$value`	مختلط	القيمة التي سيتم تعيينها على المفتاح المحدد.
`$ymlfile`	خيط	ملف yml لتعيين القيمة فيه.

قيمة الإرجاع:

صحيح إذا تم تعيين القيمة بنجاح في ملف yamlfile، وإلا فإن ذلك خطأ.

dumpFile

يحول مصفوفة معينة إلى صيغة yaml ويضع محتواها في ملف معين. ملاحظة: إذا كان الملف موجودا، سيتم الكتابة فوقه!

Yml:: dumpFile ( array|object $ var , string $ filename , integer $ indent = 2 , integer $ wordwrap , boolean $ openingDashes = false ): boolean

to_yml_file

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 to_yml_file ( array|object $ var , string $ filename , int $ indent = 2 , int $ wordwrap = 0 , bool $ openingDashes = false ): boolean

مثال

 $ array = [
     ' foo ' => ' bar ' ,
     ' baz ' => ' qux '
];

to_yml_file ( $ array , ' /path/to/file.yml ' );

//   foo: bar
//   baz: qux

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$var`	صفيف\|كائن	المصفوفة أو الكائن المطلوب تحويله.
`$filename`	خيط	المسار إلى الملف لكتابة سلسلة yaml فيه. ملحوظة: إذا كان الملف موجودًا بالفعل، فسيتم استبداله!
`$indent`	عدد صحيح	المسافة البادئة للyaml المحولة. الافتراضي إلى 2.
`$wordwrap`	عدد صحيح	بعد الرقم المحدد سيتم لف السلسلة. الافتراضي هو 0 (بدون التفاف الكلمات).
`$openingDashes`	منطقية	صحيح إذا كانت سلسلة yaml يجب أن تبدأ بشرطات مفتوحة. الافتراضيات كاذبة.

قيمة الإرجاع:

صحيح على النجاح، كاذب فيما عدا ذلك.

أحمق

يحول مصفوفة أو كائن معين إلى سلسلة yaml.

Yml:: dump ( array|object $ var , integer $ indent = 2 , integer $ wordwrap , boolean $ openingDashes = false ): string| null

to_yml

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 to_yml ( array|object $ array , string $ filename , int $ indent = 2 , int $ wordwrap = 0 , bool $ openingDashes = false ): string| null

مثال

 $ array = [
     ' foo ' => ' bar ' ,
     ' baz ' => ' qux ' ,
     ' foobar ' => [
         ' foo ' => ' bar '
     ]
];

to_yml ( $ array );

//   foo: bar
//   baz: qux
//   foobar:
//     foo: bar

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$var`	صفيف\|كائن	المصفوفة أو الكائن المطلوب تحويله.
`$indent`	عدد صحيح	المسافة البادئة للyaml المحولة. الافتراضي إلى 2.
`$wordwrap`	عدد صحيح	بعد الرقم المحدد سيتم لف السلسلة. الافتراضي هو 0 (بدون التفاف الكلمات).
`$openingDashes`	منطقية	صحيح إذا كانت سلسلة yaml يجب أن تبدأ بشرطات مفتوحة. الافتراضيات كاذبة.

قيمة الإرجاع:

سلسلة yaml المحولة. في حالة حدوث أخطاء، يتم إرجاع القيمة null.

تعيين

يضبط قيمة في سلسلة yaml باستخدام تدوين النقطة.

Yml:: set ( string $ key , mixed $ value , string & $ yml ): boolean

yml_set

الوظيفة العامة ذات الصلة (الوصف انظر أعلاه).

 yml_set ( string $ key , mixed $ value , string & $ yml ): boolean

مثال

 $ yml = "
     foo: bar
     baz: qux
     foobar:
         foo: bar
" ;

yml_set ( ' foobar.foo ' , ' baz ' , $ yml );

//   foo: bar
//   baz: qux
//   foobar:
//       foo: baz

هذه الطريقة ثابتة . حدود:

المعلمة	يكتب	وصف
`$key`	خيط	السلسلة المراد البحث بها مع تدوين النقطة
`$value`	مختلط	القيمة التي سيتم تعيينها على المفتاح المحدد.
`$yml`	خيط	سلسلة yml المراد البحث فيها. ملاحظة: ستتم إزالة جميع التعليقات الموجودة في السلسلة!

قيمة الإرجاع:

صحيح إذا تم تعيين القيمة بنجاح، وخطأ بخلاف ذلك.

يوسع