explode

FunctionParams and return types changed in PHP 8.0

Split a string by a string.

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

explode Function synopsis

explode(
    string $separator,
    string $string,
    int $limit = PHP_INT_MAX
  ): array

Parameters

$separator

Typestring

The boundary string.

$string

Typestring

The input string.

$limit

OptionalTypeintDefault valuePHP_INT_MAX

If $limit is set and positive, the returned array will contain a maximum of $limit elements with the last element containing the rest of $string.

Return value

Typearray

Returns an array of strings created by splitting the $string parameter on boundaries formed by the $separator.

If $separator is an empty string (""), explode throws a ValueError. If $separator contains a value that is not contained in $string and a negative $limit is used, then an empty array will be returned, otherwise an array containing $string will be returned. If $separator values appear at the start or end of $string, said values will be added as an empty array value either in the first or last position of the returned array respectively.

Changes to the explode Function

PHP 8.0

  • Return type added: array
  • Parameter type added for parameter #1 ($separator): string
  • Parameter name of parameter #2 changed: $str to $string
  • Parameter type added for parameter #2 ($string): string
  • Parameter type added for parameter #3 ($limit): int
  • Parameter default value added for position #3 ($limit): PHP_INT_MAX
  explode(
-     $separator,
+     string $separator,
-     $str,
+     string $string,
-     $limit
+     int $limit = PHP_INT_MAX
-   )
+   ): array

explode 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