add str_contains function

Author: IonBazan

README.md

@@ -44,6 +44,7 @@ Polyfills are provided for:
 - the `get_mangled_object_vars`, `mb_str_split` and `password_algos` functions
   introduced in PHP 7.4;
 - the `fdiv` function introduced in PHP 8.0;
+- the `str_contains` function introduced in PHP 8.0;
 - the `ValueError` class introduced in PHP 8.0;
 - the `FILTER_VALIDATE_BOOL` constant introduced in PHP 8.0;
 

src/Php80/Php80.php

@@ -26,6 +26,11 @@ public static function fdiv($dividend, $divisor)
         return (float) @($dividend / $divisor);
     }
 
+    public static function str_contains($haystack, $needle)
+    {
+        return '' === $needle || false !== \strpos($haystack, $needle);
+    }
+
     private static function floatArg($value, $caller, $pos)
     {
         if (\is_float($value)) {

src/Php80/README.md

@@ -1,9 +1,10 @@
 Symfony Polyfill / Php80
 ========================
 
-This component provides functions added to PHP 8.0 core:
+This component provides features added to PHP 8.0 core:
 
-- [`fdiv`](https://php.net/fdiv) (only for PHP 7.0+)
+- [`fdiv`](https://php.net/fdiv) function (only for PHP 7.0+)
+- [`str_contains`](https://php.net/str_contains) function
 - `ValueError` class
 - `FILTER_VALIDATE_BOOL` constant
 

src/Php80/bootstrap.php

@@ -16,6 +16,10 @@
         function fdiv($dividend, $divisor) { return p\Php80::fdiv($dividend, $divisor); }
     }
 
+    if (!function_exists('str_contains')) {
+        function str_contains($haystack, $needle) { return p\Php80::str_contains($haystack, $needle); }
+    }
+
     if (!defined('FILTER_VALIDATE_BOOL') && defined('FILTER_VALIDATE_BOOLEAN')) {
         define('FILTER_VALIDATE_BOOL', FILTER_VALIDATE_BOOLEAN);
     }

tests/Php80/Php80Test.php

@@ -15,11 +15,12 @@
 
 /**
  * @author Ion Bazan <[email protected]>
+ *
+ * @requires PHP 7.0
  */
 class Php80Test extends TestCase
 {
     /**
-     * @requires PHP 7.0
      * @covers \Symfony\Polyfill\Php80\Php80::fdiv
      * @dataProvider fdivProvider
      */
@@ -32,7 +33,6 @@ public function testFdiv($expected, $divident, $divisor)
     }
 
     /**
-     * @requires PHP 7.0
      * @covers \Symfony\Polyfill\Php80\Php80::fdiv
      * @dataProvider nanFdivProvider
      */
@@ -42,7 +42,6 @@ public function testFdivNan($divident, $divisor)
     }
 
     /**
-     * @requires PHP 7.0
      * @covers \Symfony\Polyfill\Php80\Php80::fdiv
      * @dataProvider invalidFloatProvider
      */
@@ -52,15 +51,27 @@ public function testFdivTypeError($divident, $divisor)
         fdiv($divident, $divisor);
     }
 
-    /**
-     * @requires PHP 7.0
-     */
     public function testFilterValidateBool()
     {
         $this->assertTrue(\defined('FILTER_VALIDATE_BOOL'));
         $this->assertSame(FILTER_VALIDATE_BOOLEAN, FILTER_VALIDATE_BOOL);
     }
 
+    public function testStrContains()
+    {
+        $this->assertTrue(str_contains('abc', ''));
+        $this->assertTrue(str_contains('abc', 'a'));
+        $this->assertTrue(str_contains('abc', 'bc'));
+        $this->assertTrue(str_contains('abc', 'abc'));
+        $this->assertTrue(str_contains('abc', 'abc'));
+        $this->assertTrue(str_contains('한국어', '국'));
+        $this->assertTrue(str_contains('한국어', ''));
+        $this->assertTrue(str_contains('', ''));
+        $this->assertFalse(str_contains('abc', 'd'));
+        $this->assertFalse(str_contains('abc', 'abcd'));
+        $this->assertFalse(str_contains('DÉJÀ', 'à'));
+    }
+
     public function fdivProvider()
     {
         return array(