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

regex

فئات أخرى

3.1.1

تنزيل

جعل التعبير العادي رائعًا مرة أخرى

تتطلب وظائف preg_* المضمنة في Php بعض الأنماط الفردية مثل تمرير المتغيرات حسب المرجع ومعاملة القيم false أو null كأخطاء. يوفر spatie/regex واجهة أكثر نظافة لـ preg_match و preg_match_all و preg_replace و preg_replace_callback .

 use Spatie  Regex  Regex ;

// Using `match`
Regex:: match ( ' /a/ ' , ' abc ' ); // `MatchResult` object
Regex:: match ( ' /a/ ' , ' abc ' )-> hasMatch (); // true
Regex:: match ( ' /a/ ' , ' abc ' )-> result (); // 'a'

// Capturing groups with `match`
Regex:: match ( ' /a(b)/ ' , ' abc ' )-> result (); // 'ab'
Regex:: match ( ' /a(b)/ ' , ' abc ' )-> group ( 1 ); // 'b'

// Setting defaults
Regex:: match ( ' /a(b)/ ' , ' xyz ' )-> resultOr ( ' default ' ); // 'default'
Regex:: match ( ' /a(b)/ ' , ' xyz ' )-> groupOr ( 1 , ' default ' ); // 'default'

// Using `matchAll`
Regex:: matchAll ( ' /a/ ' , ' abcabc ' )-> hasMatch (); // true
Regex:: matchAll ( ' /a/ ' , ' abcabc ' )-> results (); // Array of `MatchResult` objects

// Using replace
Regex:: replace ( ' /a/ ' , ' b ' , ' abc ' )-> result (); // 'bbc' ;
Regex:: replace ( ' /a/ ' , function ( MatchResult $ result ) {
    return $ result -> result () . ' Hello! ' ;
}, ' abc ' )-> result (); // 'aHello!bc' ;

Spatie هي وكالة تصميم مواقع الإنترنت مقرها في أنتويرب، بلجيكا. ستجد نظرة عامة على جميع مشاريعنا مفتوحة المصدر على موقعنا.

ادعمنا

نحن نستثمر الكثير من الموارد في إنشاء أفضل الحزم مفتوحة المصدر في فئتها. يمكنك دعمنا عن طريق شراء أحد منتجاتنا المدفوعة.

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

تثبيت

يمكنك تثبيت الحزمة عبر الملحن:

composer require spatie/regex

الاستخدام

مطابقة النمط مرة واحدة

يطابق نمطًا على موضوع ما. إرجاع كائن MatchResult للمطابقة الأولى.

 / * *
 * @ param string $ pattern
 * @ param string $ subject
 *
 * @ return  Spatie  Regex  MatchResult
 * /
Regex:: match (string $ pattern , string $ subject ): MatchResult

`MatchResult::hasMatch(): bool`

يتحقق مما إذا كان النمط يطابق الموضوع.

Regex:: match ( ' /abc/ ' , ' abc ' )-> hasMatch (); // true
Regex:: match ( ' /def/ ' , ' abc ' )-> hasMatch (); // false

`MatchResult::result(): string`

إرجاع المباراة الكاملة التي تم إجراؤها. إرجاع null إذا لم يتم إجراء أي تطابق.

Regex:: match ( ' /abc/ ' , ' abc ' )-> result (); // 'abc'
Regex:: match ( ' /def/ ' , ' abc ' )-> result (); // null

`MatchResult::group(int $id): string`

قم بإرجاع محتويات المجموعة التي تم التقاطها (مع فهرس يستند إلى 1). يطرح استثناء RegexFailed إذا كانت المجموعة غير موجودة.

Regex:: match ( ' /a(b)c/ ' , ' abc ' )-> group ( 1 ); // 'b'
Regex:: match ( ' /a(b)c/ ' , ' abc ' )-> group ( 2 ); // `RegexFailed` exception

مطابقة كافة تكرارات النمط

يطابق نمطًا على موضوع ما. تقوم بإرجاع كائن MatchAllResult الذي يحتوي على جميع التطابقات.

 / * *
 * @ param string $ pattern
 * @ param string $ subject
 *
 * @ return  Spatie  Regex  MatchAllResult
 * /
public static function matchAll( string $ pattern , string $ subject ): MatchAllResult

`MatchAllResult::hasMatch(): bool`

يتحقق مما إذا كان النمط يطابق الموضوع.

Regex:: matchAll ( ' /abc/ ' , ' abc ' )-> hasMatch (); // true
Regex:: matchAll ( ' /abc/ ' , ' abcabc ' )-> hasMatch (); // true
Regex:: matchAll ( ' /def/ ' , ' abc ' )-> hasMatch (); // false

`MatchAllResult::results(): array`

إرجاع مصفوفة من كائنات MatchResult .

 $ results = Regex:: matchAll ( ' /ab([a-z])/ ' , ' abcabd ' )-> results ();

$ results [ 0 ]-> result (); // 'abc'
$ results [ 0 ]-> group ( 1 ); // 'c'
$ results [ 1 ]-> result (); // 'abd'
$ results [ 1 ]-> group ( 1 ); // 'd'

استبدال النمط في الموضوع

يستبدل النمط في الموضوع. إرجاع كائن ReplaceResult .

 / * *
 * @ param string | array $ pattern
 * @ param string | array | callable $ replacement
 * @ param string | array $ subject
 * @ param int $ limit
 *
 * @ return  Spatie  Regex  ReplaceResult
 * /
public static function replace( $ pattern , $ replacement , $ subject , $ limit = - 1 ): ReplaceResult

`ReplaceResult::result(): mixed`

Regex:: replace ( ' /a/ ' , ' b ' , ' abc ' )-> result (); // 'bbc'

Regex::replace يعمل أيضًا مع العناصر القابلة للاستدعاء. سوف يتلقى الكائن القابل للاستدعاء مثيل MatchResult كوسيطة له.

Regex:: replace ( ' /a/ ' , function ( MatchResult $ matchResult ) {
    return str_repeat ( $ matchResult -> result (), 2 );
}, ' abc ' )-> result (); // 'aabc'

يمكن أيضًا أن تكون الأنماط والبدائل والمواضيع عبارة عن صفائف. يتصرف Regex::replace تمامًا مثل preg_replace في تلك الحالات.

معالجة الأخطاء

إذا حدث أي خطأ في أسلوب Regex ، فسيتم طرح استثناء RegexFailed . ليست هناك حاجة للتحقق من preg_last_error() .

اختبار

$ composer test

سجل التغيير

الرجاء مراجعة سجل التغيير للحصول على مزيد من المعلومات حول ما تغير مؤخرًا.

المساهمة

يرجى الاطلاع على المساهمة للحصول على التفاصيل.

الثغرات الأمنية

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

البطاقات البريدية

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

عنواننا هو: سباتي، كرويكسترات 22، 2018 أنتويرب، بلجيكا.

ننشر جميع البطاقات البريدية المستلمة على موقع شركتنا.