VAlarm

VAlarm component.

This component contains some additional functionality specific for VALARMs.

Full name: \Sabre\VObject\Component\VAlarm
Parent class: \Sabre\VObject\Component

Methods

getEffectiveTriggerTime

Returns a DateTime object when this alarm is going to trigger.

public getEffectiveTriggerTime(): \DateTimeImmutable

This ignores repeated alarm, only the first trigger is returned.

isInTimeRange

Returns true or false depending on if the event falls in the specified time-range. This is used for filtering purposes.

public isInTimeRange(\Sabre\VObject\Component\DateTime $start, \Sabre\VObject\Component\DateTime $end): bool

The rules used to determine if an event falls within the specified time-range is based on the CalDAV specification.

Parameters:

Parameter	Type	Description
`$start`	\Sabre\VObject\Component\DateTime
`$end`	\Sabre\VObject\Component\DateTime

getValidationRules

A simple list of validation rules.

public getValidationRules(): mixed

This is simply a list of properties, and how many times they either must or must not appear.

Possible values per property: * 0 - Must not appear. * 1 - Must appear exactly once. * + - Must appear at least once. * * - Can appear any number of times. * ? - May appear, but not more than once.

Inherited methods

serialize

Turns the object back into a serialized blob.

public serialize(): string

jsonSerialize

This method returns an array, with the representation as it should be encoded in JSON. This is used to create jCard or jCal documents.

public jsonSerialize(): array

xmlSerialize

This method serializes the data into XML. This is used to create xCard or xCal documents.

public xmlSerialize(\Sabre\Xml\Writer $writer): void

Parameters:

Parameter	Type	Description
`$writer`	\Sabre\Xml\Writer	XML writer

destroy

Call this method on a document if you're done using it.

public destroy(): mixed

It's intended to remove all circular references, so PHP can easily clean it up.

getIterator

Returns the iterator for this object.

public getIterator(): \Sabre\VObject\ElementList

setIterator

Sets the overridden iterator.

public setIterator(\Sabre\VObject\ElementList $iterator): mixed

Note that this is not actually part of the iterator interface

Parameters:

Parameter	Type	Description
`$iterator`	\Sabre\VObject\ElementList

validate

Validates the node for correctness.

public validate(int $options): array

The following options are supported: Node::REPAIR - May attempt to automatically repair the problem. Node::PROFILE_CARDDAV - Validate the vCard for CardDAV purposes. Node::PROFILE_CALDAV - Validate the iCalendar for CalDAV purposes.

This method returns an array with detected problems. Every element has the following properties:

level - problem level.
message - A human-readable string describing the issue.
node - A reference to the problematic node.

The level means: 1 - The issue was repaired (only happens if REPAIR was turned on). 2 - A warning. 3 - An error.

Parameters:

Parameter	Type	Description
`$options`	int

count

Returns the number of elements.

public count(): int

offsetExists

Checks if an item exists through ArrayAccess.

public offsetExists(int $offset): bool

This method just forwards the request to the inner iterator

Parameters:

Parameter	Type	Description
`$offset`	int

offsetGet

Gets an item through ArrayAccess.

public offsetGet(int $offset): mixed

This method just forwards the request to the inner iterator

Parameters:

Parameter	Type	Description
`$offset`	int

offsetSet

Sets an item through ArrayAccess.

public offsetSet(int $offset, mixed $value): mixed

This method just forwards the request to the inner iterator

Parameters:

Parameter	Type	Description
`$offset`	int
`$value`	mixed

offsetUnset

Sets an item through ArrayAccess.

public offsetUnset(int $offset): mixed

This method just forwards the request to the inner iterator

Parameters:

Parameter	Type	Description
`$offset`	int

__construct

Creates a new component.

public __construct(\Sabre\VObject\Document $root, string|null $name, array $children = [], bool $defaults = true): mixed

You can specify the children either in key=>value syntax, in which case properties will automatically be created, or you can just pass a list of Component and Property object.

By default, a set of sensible values will be added to the component. For an iCalendar object, this may be something like CALSCALE:GREGORIAN. To ensure that this does not happen, set $defaults to false.

Parameters:

Parameter	Type	Description
`$root`	\Sabre\VObject\Document
`$name`	string\|null	such as VCALENDAR, VEVENT
`$children`	array
`$defaults`	bool

add

Adds a new property or component, and returns the new item.

public add(): \Sabre\VObject\Node

This method has 3 possible signatures:

add(Component $comp) // Adds a new component add(Property $prop) // Adds a new property add($name, $value, array $parameters = []) // Adds a new property add($name, array $children = []) // Adds a new component by name.

remove

This method removes a component or property from this component.

public remove(string|\Sabre\VObject\Property|\Sabre\VObject\Component $item): mixed

You can either specify the item by name (like DTSTART), in which case all properties/components with that name will be removed, or you can pass an instance of a property or component, in which case only that exact item will be removed.

Parameters:

Parameter	Type	Description
`$item`	string\|\Sabre\VObject\Property\|\Sabre\VObject\Component

children

Returns a flat list of all the properties and components in this component.

public children(): array

getComponents

This method only returns a list of sub-components. Properties are ignored.

public getComponents(): array

select

Returns an array with elements that match the specified name.

public select(string $name): array

This function is also aware of MIME-Directory groups (as they appear in vcards). This means that if a property is grouped as "HOME.EMAIL", it will also be returned when searching for just "EMAIL". If you want to search for a property in a specific group, you can select on the entire string ("HOME.EMAIL"). If you want to search on a specific property that has not been assigned a group, specify ".EMAIL".

Parameters:

Parameter	Type	Description
`$name`	string

getDefaults

This method should return a list of default property values.

protected getDefaults(): array

__get

Using 'get' you will either get a property or component.

public __get(string $name): \Sabre\VObject\Property|null

If there were no child-elements found with the specified name, null is returned.

To use this, this may look something like this:

$event = $calendar->VEVENT;

Parameters:

Parameter	Type	Description
`$name`	string

__isset

This method checks if a sub-element with the specified name exists.

public __isset(string $name): bool

Parameters:

Parameter	Type	Description
`$name`	string

__set

Using the setter method you can add properties or subcomponents.

public __set(string $name, mixed $value): mixed

You can either pass a Component, Property object, or a string to automatically create a Property.

If the item already exists, it will be removed. If you want to add a new item with the same name, always use the add() method.

Parameters:

Parameter	Type	Description
`$name`	string
`$value`	mixed

__unset

Removes all properties and components within this component with the specified name.

public __unset(string $name): mixed

Parameters:

Parameter	Type	Description
`$name`	string

__clone

This method is automatically called when the object is cloned.

public __clone(): mixed

Specifically, this will ensure all child elements are also cloned.

getValidationRules

A simple list of validation rules.

public getValidationRules(): mixed

This is simply a list of properties, and how many times they either must or must not appear.

Possible values per property: * 0 - Must not appear. * 1 - Must appear exactly once. * + - Must appear at least once. * * - Can appear any number of times. * ? - May appear, but not more than once.

It is also possible to specify defaults and severity levels for violating the rule.

See the VEVENT implementation for getValidationRules for a more complex example.

Automatically generated on 2025-03-18