Skip to content

The CMS
Docs
- Guide
- Reference
- Cookbook
- Quicktips
- Screencasts
- Glossary
Resources
- Plugins
- Themes
- Newsletter
- Buzz
- License Hub
Community
Partners

Try
Buy

View all results ›

Formatting text
- KirbyText
- Markdown
Templates
- Field methods
- Helpers
Panel
- Blueprints
- Fields
- Sections
- Blocks
- Icons
- Styling
- Samples
Objects
- $kirby
- $site
- $page
- $pages
- $file
- $files
- $user
- $users
- $block
- $blocks
- $layout
- $layouts
- $language
- $languages
- $pagination
- $request
- $session
- All classes
- Aliases
Router
- Patterns
- Response types
System
- Config options
- Urls
- Roots
- Requirements
- Validators
Plugins
API
- Authentication
- Languages
- Pages
- Roles
- Site
- System
- Translations
- Users
Tools
- A
- Cookie
- Data
- Dir
- Escape
- F
- Header
- Html
- I18n
- Mime
- QrCode
- Query
- Str
- Tpl
- Url
- V
- Xml

new Collection()

Constructor
$collection->append()

Appends an element
$collection->chunk()

Creates chunks of the same size.
$collection->clone()

Returns a cloned instance of the collection
$collection->count()

Counts all elements
$collection->current()

Returns the current element
$collection->data()

Getter and setter for the data
$collection->empty()

Clone and remove all elements from the collection
$collection->extend()

Adds all elements to the collection
$collection->filter()

Filters elements by one of the predefined filter methods, by a custom filter function or an array of filters
$collection->filterBy()

Alias for Kirby\Toolkit\Collection::filter
$collection->find()

Find one or multiple elements by id
$collection->findBy()

Find a single element by an attribute and its value
$collection->findByKey()

Find a single element by key (id)
$collection->first()

Returns the first element
$collection->flip()

Returns the elements in reverse order
$collection->get()

Getter
$collection->getAttribute()

Extracts an attribute value from the given element in the collection. This is useful if elements in the collection might be objects, arrays or anything else and you need to get the value independently from that. We use it for filter.
$collection->getIterator()

Get an iterator for the items.
$collection->group()

Groups the elements by a given field or callback function
$collection->groupBy()

Alias for Kirby\Toolkit\Collection::group
$collection->has()

Checks by key if an element is included
$collection->indexOf()

Tries to find the index number for the given element
$collection->intersection()

Returns a Collection with the intersection of the given elements
$collection->intersects()

Checks if there is an intersection between the given collection and this collection
$collection->isEmpty()

Checks if the number of elements is zero
$collection->isEven()

Checks if the number of elements is even
$collection->isNotEmpty()

Checks if the number of elements is more than zero
$collection->isOdd()

Checks if the number of elements is odd
$collection->key()

Returns the current key
$collection->keyOf()

Tries to find the key for the given element
$collection->keys()

Returns an array of all keys
$collection->last()

Returns the last element
$collection->limit()

Returns a new object with a limited number of elements
$collection->map()

Map a function to each element
$collection->next()

Moves the cursor to the next element and returns it
$collection->not()

Returns a Collection without the given element(s)
$collection->nth()

Returns the nth element from the collection
$collection->offset()

Returns a new object starting from the given offset
$collection->paginate()

Add pagination
$collection->pagination()

Get the previously added pagination object
$collection->pluck()

Extracts all values for a single field into a new array
$collection->prepend()

Prepends an element to the data array
$collection->prev()

Moves the cursor to the previous element and returns it
$collection->query()

Runs a combination of filter, sort, not, offset, limit and paginate on the collection.
$collection->random()

Returns a new collection consisting of random elements, from the original collection, shuffled or ordered
$collection->remove()

Removes an element from the array by key
$collection->rewind()

Moves the cursor to the first element
$collection->set()

Adds a new element to the collection
$collection->shuffle()

Shuffle all elements
$collection->slice()

Returns a slice of the object
$collection->sort()

Sorts the elements by any number of fields
Collection::sortArgs()

Get sort arguments from a string
$collection->sortBy()

Alias for Kirby\Toolkit\Collection::sort
$collection->toArray()

Converts the object into an array
$collection->toJson()

Converts the object into a JSON string
$collection->toString()

Converts the object to a string
$collection->valid()

Checks if the current element is valid
$collection->values()

Returns a non-associative array with all values. If a mapping Closure is passed, all values are processed by the Closure.
$collection->when()

The when method only executes the given Closure when the first parameter is true. If the first parameter is false, the Closure will not be executed.
$collection->without()

Alias for $this->not()

$collection->first()

Returns the first element

kirby/src/Toolkit/Collection.php#L445

$collection->first(): mixed

Return type

mixed

Parent class

Kirby\Toolkit\Collection

Did you find an error? Help us improve our docs and edit this page on GitHub. Make sure to check out our styleguide →

Report an issue on this page

Kirby

The CMS that adapts to any project. Made for developers, designers, creators and clients.

The CMS
Docs
- Guide
- Reference
- Cookbook
- Quicktips
- Screencasts
- Glossary
- Archive
Resources
- Plugins
- Themes
- Newsletter
- Buzz
- License Hub
Community
Kirby
- Security
- Privacy
- License
- Presskit
- Contact
With support of