add str_contains function

Author: IonBazan

README.md

@@ -45,6 +45,7 @@ Polyfills are provided for:
   introduced in PHP 7.4;
 - the `fdiv` function introduced in PHP 8.0;
 - the `preg_last_error_msg` 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

@@ -49,6 +49,11 @@ public static function preg_last_error_msg()
         }
     }
 
+    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,12 +1,13 @@
 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)
+- [`fdiv`](https://php.net/fdiv) function
+- [`preg_last_error_msg`](https://php.net/preg_last_error_msg) function
+- [`str_contains`](https://php.net/str_contains) function
 - `ValueError` class
 - `FILTER_VALIDATE_BOOL` constant
-- [`preg_last_error_msg`](https://php.net/preg_last_error_msg)
 
 More information can be found in the
 [main Polyfill README](https://github.com/symfony/polyfill/blob/master/README.md).

src/Php80/bootstrap.php

@@ -20,6 +20,10 @@ function fdiv($dividend, $divisor) { return p\Php80::fdiv($dividend, $divisor);
         function preg_last_error_msg() { return p\Php80::preg_last_error_msg(); }
     }
 
+    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

@@ -59,15 +59,15 @@ public function testFilterValidateBool()
     }
 
     /**
-     * @covers \Symfony\Polyfill\Php80\Php80::pregLastErrorMsg
+     * @covers \Symfony\Polyfill\Php80\Php80::preg_last_error_msg
      */
     public function testPregNoError()
     {
         $this->assertSame('No error', preg_last_error_msg());
     }
 
     /**
-     * @covers \Symfony\Polyfill\Php80\Php80::pregLastErrorMsg
+     * @covers \Symfony\Polyfill\Php80\Php80::preg_last_error_msg
      */
     public function testPregMalformedUtfError()
     {
@@ -76,7 +76,7 @@ public function testPregMalformedUtfError()
     }
 
     /**
-     * @covers \Symfony\Polyfill\Php80\Php80::pregLastErrorMsg
+     * @covers \Symfony\Polyfill\Php80\Php80::preg_last_error_msg
      */
     public function testPregMalformedUtf8Offset()
     {
@@ -87,6 +87,24 @@ public function testPregMalformedUtf8Offset()
         );
     }
 
+    /**
+     * @covers \Symfony\Polyfill\Php80\Php80::str_contains
+     */
+    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(