Neuron-PHP

EventCategory extends Model
in package

EventCategory entity representing a calendar event category.

Attributes
#[Table]
'event_categories'

Table of Contents

Properties

$_loadedRelations  : array<string|int, mixed>
Loaded relations cache
$_pdo  : PDO|null
Database connection
$_relationCache  : array<string|int, mixed>
Relation metadata cache
$_color  : string
$_createdAt  : DateTimeImmutable|null
$_description  : string|null
$_events  : array<string|int, mixed>
$_id  : int|null
$_name  : string
$_slug  : string
$_updatedAt  : DateTimeImmutable|null

Methods

__construct()  : mixed
__get()  : mixed
Magic method to access relations.
all()  : array<string|int, mixed>
Get all models.
beginTransaction()  : bool
Begin a database transaction.
commit()  : bool
Commit the current transaction.
create()  : static
Create a new model and save it to the database.
delete()  : bool
Delete the model without handling dependents (simple delete).
destroy()  : bool
Delete the model from the database with dependent cascade.
destroyMany()  : int
Delete one or more models by ID.
exists()  : bool
Check if the model exists in the database.
fill()  : self
Fill the model with an array of attributes.
find()  : static|null
Find a model by primary key.
fromArray()  : static
Create EventCategory from array data
getAttribute()  : mixed
Get an attribute value from the model.
getColor()  : string
Get color
getCreatedAt()  : DateTimeImmutable|null
Get created timestamp
getDescription()  : string|null
Get description
getEvents()  : array<string|int, Event>
Get events in this category
getId()  : int|null
Get category ID
getName()  : string
Get name
getPrimaryKey()  : string
Get the primary key column name.
getSlug()  : string
Get slug
getTableName()  : string
Get the table name for this model from the Table attribute.
getUpdatedAt()  : DateTimeImmutable|null
Get updated timestamp
inTransaction()  : bool
Check if currently inside a transaction.
limit()  : QueryBuilder
Set result limit.
loadRelations()  : void
Eager load relations.
offset()  : QueryBuilder
Set result offset.
orderBy()  : QueryBuilder
Add an order by clause.
query()  : QueryBuilder
Create a new query builder for this model.
relation()  : BelongsToRelation|HasManyRelation|HasOneRelation|BelongsToManyRelation
Get a relation instance (for calling sync/attach/detach methods).
rollBack()  : bool
Roll back the current transaction.
save()  : bool
Save the model to the database (insert or update).
setAttribute()  : void
Set an attribute value on the model.
setColor()  : self
Set color (hex code)
setCreatedAt()  : self
Set created timestamp
setDescription()  : self
Set description
setEvents()  : self
Set events
setId()  : self
Set category ID
setLoadedRelation()  : void
Set a loaded relation (used by eager loading).
setName()  : self
Set name
setPdo()  : void
Set the PDO connection for all models.
setSlug()  : self
Set slug
setUpdatedAt()  : self
Set updated timestamp
toArray()  : array<string|int, mixed>
Convert category to array
transaction()  : mixed
Execute a closure within a database transaction.
update()  : bool
Update the model's attributes and save to database.
where()  : QueryBuilder
Start a query with a where clause.
whereIn()  : QueryBuilder
Start a query with a where in clause.
with()  : QueryBuilder
Eager load relations.
createRelation()  : BelongsToRelation|HasManyRelation|HasOneRelation|BelongsToManyRelation
Create a relation instance.
getForeignKeyName()  : string
Get the foreign key name for this model.
getPdo()  : PDO
Get the PDO connection.
getPivotTableName()  : string
Get the pivot table name for a many-to-many relationship.
getRelatedForeignKeyName()  : string
Get the foreign key name for a related model.
getRelationMetadata()  : array<string|int, mixed>|null
Get relation metadata for a property.
handleDependentRelations()  : void
Handle dependent relations before destroying the model.
performInsert()  : bool
Perform an insert operation.
performUpdate()  : bool
Perform an update operation.
propertyToColumn()  : string
Convert property name to database column name.

Properties

$_loadedRelations

Loaded relations cache

protected array<string|int, mixed> $_loadedRelations = []

$_pdo

Database connection

protected static PDO|null $_pdo = null

$_relationCache

Relation metadata cache

protected static array<string|int, mixed> $_relationCache = []

$_createdAt

private DateTimeImmutable|null $_createdAt = null

$_events

private array<string|int, mixed> $_events = []
Attributes
#[HasMany]
\Neuron\Cms\Models\Event::class
$foreignKey: 'category_id'
$dependent: \Neuron\Orm\DependentStrategy::Nullify

$_updatedAt

private DateTimeImmutable|null $_updatedAt = null

Methods

__get()

Magic method to access relations.

public __get(string $name) : mixed
Parameters
$name : string
Tags
throws
RelationException

all()

Get all models.

public static all() : array<string|int, mixed>
Return values
array<string|int, mixed>

beginTransaction()

Begin a database transaction.

public static beginTransaction() : bool
Tags
throws
ModelException

If PDO is not set or transaction fails

Return values
bool

True on success

commit()

Commit the current transaction.

public static commit() : bool
Tags
throws
ModelException

If PDO is not set or commit fails

Return values
bool

True on success

create()

Create a new model and save it to the database.

public static create(array<string|int, mixed> $attributes) : static
Parameters
$attributes : array<string|int, mixed>
Tags
throws
ModelException
Return values
static

delete()

Delete the model without handling dependents (simple delete).

public delete() : bool
Tags
throws
ModelException
Return values
bool

destroyMany()

Delete one or more models by ID.

public static destroyMany(int|array<string|int, mixed> $ids) : int
Parameters
$ids : int|array<string|int, mixed>
Tags
throws
ModelException
Return values
int

Number of records deleted

exists()

Check if the model exists in the database.

public exists() : bool
Return values
bool

fill()

Fill the model with an array of attributes.

public fill(array<string|int, mixed> $attributes) : self
Parameters
$attributes : array<string|int, mixed>
Return values
self

find()

Find a model by primary key.

public static find(int $id) : static|null
Parameters
$id : int
Return values
static|null

fromArray()

Create EventCategory from array data

public static fromArray(array<string|int, mixed> $data) : static
Parameters
$data : array<string|int, mixed>

Associative array of category data

Tags
throws
Exception
Return values
static

getAttribute()

Get an attribute value from the model.

public getAttribute(string $key) : mixed
Parameters
$key : string

getColor()

Get color

public getColor() : string
Return values
string

getCreatedAt()

Get created timestamp

public getCreatedAt() : DateTimeImmutable|null
Return values
DateTimeImmutable|null

getDescription()

Get description

public getDescription() : string|null
Return values
string|null

getEvents()

Get events in this category

public getEvents() : array<string|int, Event>
Return values
array<string|int, Event>

getId()

Get category ID

public getId() : int|null
Return values
int|null

getName()

Get name

public getName() : string
Return values
string

getPrimaryKey()

Get the primary key column name.

public static getPrimaryKey() : string
Return values
string

getSlug()

Get slug

public getSlug() : string
Return values
string

getTableName()

Get the table name for this model from the Table attribute.

public static getTableName() : string
Tags
throws
ModelException
Return values
string

getUpdatedAt()

Get updated timestamp

public getUpdatedAt() : DateTimeImmutable|null
Return values
DateTimeImmutable|null

inTransaction()

Check if currently inside a transaction.

public static inTransaction() : bool
Tags
throws
ModelException

If PDO is not set

Return values
bool

True if inside a transaction

loadRelations()

Eager load relations.

public static loadRelations(array<string|int, mixed> $relations, array<string|int, mixed> $models) : void
Parameters
$relations : array<string|int, mixed>

Relation names to load

$models : array<string|int, mixed>

Array of models to load relations for

orderBy()

Add an order by clause.

public static orderBy(string $column[, string $direction = 'ASC' ]) : QueryBuilder
Parameters
$column : string
$direction : string = 'ASC'
Return values
QueryBuilder

rollBack()

Roll back the current transaction.

public static rollBack() : bool
Tags
throws
ModelException

If PDO is not set or rollback fails

Return values
bool

True on success

save()

Save the model to the database (insert or update).

public save() : bool
Tags
throws
ModelException
Return values
bool

setAttribute()

Set an attribute value on the model.

public setAttribute(string $key, mixed $value) : void
Parameters
$key : string
$value : mixed

setColor()

Set color (hex code)

public setColor(string $color) : self
Parameters
$color : string
Return values
self

setCreatedAt()

Set created timestamp

public setCreatedAt(DateTimeImmutable $createdAt) : self
Parameters
$createdAt : DateTimeImmutable
Return values
self

setDescription()

Set description

public setDescription(string|null $description) : self
Parameters
$description : string|null
Return values
self

setEvents()

Set events

public setEvents(array<string|int, Event$events) : self
Parameters
$events : array<string|int, Event>
Return values
self

setId()

Set category ID

public setId(int $id) : self
Parameters
$id : int
Return values
self

setLoadedRelation()

Set a loaded relation (used by eager loading).

public setLoadedRelation(string $name, mixed $value) : void
Parameters
$name : string
$value : mixed

setName()

Set name

public setName(string $name) : self
Parameters
$name : string
Return values
self

setPdo()

Set the PDO connection for all models.

public static setPdo(PDO $pdo) : void
Parameters
$pdo : PDO

setSlug()

Set slug

public setSlug(string $slug) : self
Parameters
$slug : string
Return values
self

setUpdatedAt()

Set updated timestamp

public setUpdatedAt(DateTimeImmutable|null $updatedAt) : self
Parameters
$updatedAt : DateTimeImmutable|null
Return values
self

toArray()

Convert category to array

public toArray() : array<string|int, mixed>
Return values
array<string|int, mixed>

transaction()

Execute a closure within a database transaction.

public static transaction(callable $callback) : mixed

If the closure executes successfully, the transaction is committed. If an exception is thrown, the transaction is rolled back and the exception is re-thrown.

Parameters
$callback : callable

Function to execute within transaction

Tags
throws
Throwable

If callback throws an exception

throws
ModelException

If PDO is not set

Return values
mixed

The return value of the callback

update()

Update the model's attributes and save to database.

public update(array<string|int, mixed> $attributes) : bool
Parameters
$attributes : array<string|int, mixed>
Tags
throws
ModelException
Return values
bool

where()

Start a query with a where clause.

public static where(string $column, mixed $operator[, mixed|null $value = null ]) : QueryBuilder
Parameters
$column : string
$operator : mixed
$value : mixed|null = null
Return values
QueryBuilder

whereIn()

Start a query with a where in clause.

public static whereIn(string $column, array<string|int, mixed> $values) : QueryBuilder
Parameters
$column : string
$values : array<string|int, mixed>
Return values
QueryBuilder

with()

Eager load relations.

public static with(array<string|int, mixed>|string $relations) : QueryBuilder
Parameters
$relations : array<string|int, mixed>|string
Return values
QueryBuilder

getForeignKeyName()

Get the foreign key name for this model.

protected getForeignKeyName() : string
Return values
string

getPdo()

Get the PDO connection.

protected static getPdo() : PDO
Tags
throws
ModelException
Return values
PDO

getPivotTableName()

Get the pivot table name for a many-to-many relationship.

protected getPivotTableName(string $relatedModel) : string
Parameters
$relatedModel : string
Return values
string

getRelatedForeignKeyName()

Get the foreign key name for a related model.

protected getRelatedForeignKeyName(string $relatedModel) : string
Parameters
$relatedModel : string
Return values
string

getRelationMetadata()

Get relation metadata for a property.

protected getRelationMetadata(string $propertyName) : array<string|int, mixed>|null
Parameters
$propertyName : string
Return values
array<string|int, mixed>|null

handleDependentRelations()

Handle dependent relations before destroying the model.

protected handleDependentRelations() : void
Tags
throws
RelationException

performInsert()

Perform an insert operation.

protected performInsert() : bool
Tags
throws
ModelException
Return values
bool

performUpdate()

Perform an update operation.

protected performUpdate() : bool
Tags
throws
ModelException
Return values
bool

propertyToColumn()

Convert property name to database column name.

protected propertyToColumn(string $propertyName) : string
Parameters
$propertyName : string
Return values
string

        
On this page

Search results