Reference

Text

KirbyText
Markdown

Templates

Field methods
Helpers

Panel

Blueprints
Presets
Fields
Sections
Icons
Samples

Objects

$file
$files
$kirby
$language
$languages
$page
$pages
$pagination
$request
$session
$site
$user
$users

Router

Patterns
Response types

System

Options
Urls
Roots
Validators

Plugins

Extensions
Hooks
Core components
UI Kit

API

Authentication
Languages
Pages
Roles
Site
System
Translations
Users

Tools

A
Cookie
Data
Dir
Escape
F
Header
Html
Mime
Server
Str
Url
Xml

$users->add()
Adds a single user or an entire second collection to the current collection
$users->append()
Appends an element to the data array
$users->clone()
Returns a cloned instance of the collection
$users->count()
Counts all elements
$users->create()
$users->current()
Returns the current element
$users->data()
Getter and setter for the data
Users::factory()
Takes an array of user props and creates a nice and clean user collection from it
$users->filter()
Filters elements by a custom filter function or an array of filters
$users->filterBy()
Filters elements by one of the predefined filter methods.
$users->find()
Find one or multiple elements by id
$users->findBy()
Find a single element by an attribute and its value
$users->findByKey()
Finds a user in the collection by id or email address
$users->first()
Returns the first element
$users->flip()
Returns the elements in reverse order
$users->group()
Groups the elements by a given callback
$users->groupBy()
Groups the items by a given field
$users->has()
Checks if the given object or id is in the collection
$users->indexOf()
Correct position detection for objects.
$users->isEmpty()
Checks if the number of elements is zero
$users->isEven()
Checks if the number of elements is even
$users->isNotEmpty()
CChecks if the number of elements is more than zero
$users->isOdd()
Checks if the number of elements is odd
$users->key()
Returns the current key
$users->keyOf()
Tries to find the key for the given element
$users->keys()
Returns an array of all keys
$users->last()
Returns the last element
$users->limit()
Returns a new object with a limited number of elements
Users::load()
Loads a user from disk by passing the absolute path (root)
$users->map()
Map a function to each element
$users->next()
Moves the cursor to the next element and returns it
$users->not()
Returns a Collection without the given element(s)
$users->nth()
Returns the nth element from the collection
$users->offset()
Returns a new object starting from the given offset
$users->paginate()
Add pagination
$users->pagination()
Get the previously added pagination object
$users->parent()
Returns the parent model
$users->pluck()
Extracts all values for a single field into a new array
$users->prepend()
Prepends an element to the data array
$users->prev()
Moves the cursor to the previous element and returns it
$users->query()
Runs a combination of filterBy, sortBy, not offset, limit and paginate on the collection.
$users->remove()
Removes an object
$users->rewind()
Moves the cusor to the first element
$users->search()
Searches the collection
$users->set()
Adds a new element to the collection
$users->shuffle()
Shuffle all elements
$users->slice()
Returns a slice of the object
$users->sortBy()
Sorts the elements by any number of fields
$users->toArray()
Converts all objects in the collection to an array. This can also take a callback function to further modify the array result.
$users->toJson()
Converts the object into a JSON string
$users->toString()
Convertes the object to a string
$users->valid()
Checks if the current element is valid
$users->without()
Alias for $this->not()

$users->first()

Returns the first element

$users->first(): mixed

Return type

mixed

Source code

kirby/src/Toolkit/Collection.php#L396