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
= []
$_color
private
string
$_color
= '#3b82f6'
$_createdAt
private
DateTimeImmutable|null
$_createdAt
= null
$_description
private
string|null
$_description
= null
$_events
private
array<string|int, mixed>
$_events
= []
Attributes
- #[HasMany]
- \Neuron\Cms\Models\Event::class
- $foreignKey: 'category_id'
- $dependent: \Neuron\Orm\DependentStrategy::Nullify
$_id
private
int|null
$_id
= null
$_name
private
string
$_name
$_slug
private
string
$_slug
$_updatedAt
private
DateTimeImmutable|null
$_updatedAt
= null
Methods
__construct()
public
__construct() : mixed
__get()
Magic method to access relations.
public
__get(string $name) : mixed
Parameters
- $name : string
Tags
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
Return values
bool —True on success
commit()
Commit the current transaction.
public
static commit() : bool
Tags
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
Return values
staticdelete()
Delete the model without handling dependents (simple delete).
public
delete() : bool
Tags
Return values
booldestroy()
Delete the model from the database with dependent cascade.
public
destroy() : bool
Tags
Return values
booldestroyMany()
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
Return values
int —Number of records deleted
exists()
Check if the model exists in the database.
public
exists() : bool
Return values
boolfill()
Fill the model with an array of attributes.
public
fill(array<string|int, mixed> $attributes) : self
Parameters
- $attributes : array<string|int, mixed>
Return values
selffind()
Find a model by primary key.
public
static find(int $id) : static|null
Parameters
- $id : int
Return values
static|nullfromArray()
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
Return values
staticgetAttribute()
Get an attribute value from the model.
public
getAttribute(string $key) : mixed
Parameters
- $key : string
getColor()
Get color
public
getColor() : string
Return values
stringgetCreatedAt()
Get created timestamp
public
getCreatedAt() : DateTimeImmutable|null
Return values
DateTimeImmutable|nullgetDescription()
Get description
public
getDescription() : string|null
Return values
string|nullgetEvents()
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|nullgetName()
Get name
public
getName() : string
Return values
stringgetPrimaryKey()
Get the primary key column name.
public
static getPrimaryKey() : string
Return values
stringgetSlug()
Get slug
public
getSlug() : string
Return values
stringgetTableName()
Get the table name for this model from the Table attribute.
public
static getTableName() : string
Tags
Return values
stringgetUpdatedAt()
Get updated timestamp
public
getUpdatedAt() : DateTimeImmutable|null
Return values
DateTimeImmutable|nullinTransaction()
Check if currently inside a transaction.
public
static inTransaction() : bool
Tags
Return values
bool —True if inside a transaction
limit()
Set result limit.
public
static limit(int $limit) : QueryBuilder
Parameters
- $limit : int
Return values
QueryBuilderloadRelations()
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
offset()
Set result offset.
public
static offset(int $offset) : QueryBuilder
Parameters
- $offset : int
Return values
QueryBuilderorderBy()
Add an order by clause.
public
static orderBy(string $column[, string $direction = 'ASC' ]) : QueryBuilder
Parameters
- $column : string
- $direction : string = 'ASC'
Return values
QueryBuilderquery()
Create a new query builder for this model.
public
static query() : QueryBuilder
Return values
QueryBuilderrelation()
Get a relation instance (for calling sync/attach/detach methods).
public
relation(string $name) : BelongsToRelation|HasManyRelation|HasOneRelation|BelongsToManyRelation
Parameters
- $name : string
-
Relation name
Tags
Return values
BelongsToRelation|HasManyRelation|HasOneRelation|BelongsToManyRelationrollBack()
Roll back the current transaction.
public
static rollBack() : bool
Tags
Return values
bool —True on success
save()
Save the model to the database (insert or update).
public
save() : bool
Tags
Return values
boolsetAttribute()
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
selfsetCreatedAt()
Set created timestamp
public
setCreatedAt(DateTimeImmutable $createdAt) : self
Parameters
- $createdAt : DateTimeImmutable
Return values
selfsetDescription()
Set description
public
setDescription(string|null $description) : self
Parameters
- $description : string|null
Return values
selfsetEvents()
Set events
public
setEvents(array<string|int, Event> $events) : self
Parameters
- $events : array<string|int, Event>
Return values
selfsetId()
Set category ID
public
setId(int $id) : self
Parameters
- $id : int
Return values
selfsetLoadedRelation()
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
selfsetPdo()
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
selfsetUpdatedAt()
Set updated timestamp
public
setUpdatedAt(DateTimeImmutable|null $updatedAt) : self
Parameters
- $updatedAt : DateTimeImmutable|null
Return values
selftoArray()
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
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
Return values
boolwhere()
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
QueryBuilderwhereIn()
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
QueryBuilderwith()
Eager load relations.
public
static with(array<string|int, mixed>|string $relations) : QueryBuilder
Parameters
- $relations : array<string|int, mixed>|string
Return values
QueryBuildercreateRelation()
Create a relation instance.
protected
createRelation(string $propertyName, array<string|int, mixed> $metadata) : BelongsToRelation|HasManyRelation|HasOneRelation|BelongsToManyRelation
Parameters
- $propertyName : string
- $metadata : array<string|int, mixed>
Tags
Return values
BelongsToRelation|HasManyRelation|HasOneRelation|BelongsToManyRelationgetForeignKeyName()
Get the foreign key name for this model.
protected
getForeignKeyName() : string
Return values
stringgetPdo()
Get the PDO connection.
protected
static getPdo() : PDO
Tags
Return values
PDOgetPivotTableName()
Get the pivot table name for a many-to-many relationship.
protected
getPivotTableName(string $relatedModel) : string
Parameters
- $relatedModel : string
Return values
stringgetRelatedForeignKeyName()
Get the foreign key name for a related model.
protected
getRelatedForeignKeyName(string $relatedModel) : string
Parameters
- $relatedModel : string
Return values
stringgetRelationMetadata()
Get relation metadata for a property.
protected
getRelationMetadata(string $propertyName) : array<string|int, mixed>|null
Parameters
- $propertyName : string
Return values
array<string|int, mixed>|nullhandleDependentRelations()
Handle dependent relations before destroying the model.
protected
handleDependentRelations() : void
Tags
performInsert()
Perform an insert operation.
protected
performInsert() : bool
Tags
Return values
boolperformUpdate()
Perform an update operation.
protected
performUpdate() : bool
Tags
Return values
boolpropertyToColumn()
Convert property name to database column name.
protected
propertyToColumn(string $propertyName) : string
Parameters
- $propertyName : string