PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8
array_chunk - Split an array into chunks

array_chunk( array$array, int$length, [bool$preserve_keys = false] ): array

Chunks an array into arrays with length elements. The last chunk may contain less than length elements.



The array to work on


The size of each chunk


When set to true keys will be preserved. Default is false which will reindex the chunk numerically

Return Values

Returns a multidimensional numerically indexed array, starting with zero, with each dimension containing length elements.

Exceptions and Errors

If length is less than 1, a ValueError will be thrown.


Version Description
8.0.0 If length is less than 1, a ValueError will be thrown now; previously, an error of level E_WARNING has been raised instead, and the function returned null.

Related Functions

Example of array_chunk

Show all examples for array_chunk

PHP Version:

Function array_chunk:

Arrays Functions

Most used PHP functions