stristr

FunctionParams and return types changed in PHP 8.0

Case-insensitive strstr.

PHP 5
PHP 7
PHP 8.0
Improved
PHP 8.1
PHP 8.2-8.3
PHP 8.4
PHP 8.5
PHP 8.6

stristr Function synopsis

stristr(
    string $haystack,
    string $needle,
    bool $before_needle = false
  ): string|false

Parameters

$haystack

Typestring

The string to search in

$needle

Typestring

The string to search for.

$before_needle

OptionalTypeboolDefault valuefalse

If true, stristr returns the part of the $haystack before the first occurrence of the $needle (excluding needle).

Return value

Typestring|false

Returns the matched substring. If $needle is not found, returns false.

Changes to the stristr Function

PHP 8.0

  • Return type added: string|false
  • Parameter type added for parameter #1 ($haystack): string
  • Parameter type added for parameter #2 ($needle): string
  • Parameter name of parameter #3 changed: $part to $before_needle
  • Parameter type added for parameter #3 ($before_needle): bool
  • Parameter default value added for position #3 ($before_needle): false
  stristr(
-     $haystack,
+     string $haystack,
-     $needle,
+     string $needle,
-     $part
+     bool $before_needle = false
-   )
+   ): string|false

stristr Function Availability

PHP VersionAvailability
PHP 8.6Upcoming Release Yes
PHP 8.5Supported (Latest) Yes
PHP 8.4Supported Yes
PHP 8.3Security-Fixes Only Yes
PHP 8.2Security-Fixes Only Yes
PHP 8.1Unsupported Yes
PHP 8.0Unsupported Yes
PHP 7.4Unsupported Yes
PHP 7.3Unsupported Yes
PHP 7.2Unsupported Yes
PHP 7.1Unsupported Yes
PHP 7.0Unsupported Yes
PHP 5.6Unsupported Yes
PHP 5.5Unsupported Yes
PHP 5.4Unsupported Yes
PHP 5.3Unsupported Yes