Page
extends Model
in package
Page entity representing a CMS page with Editor.js content.
Attributes
- #[Table]
- 'pages'
Table of Contents
Constants
- STATUS_DRAFT = 'draft'
- Page status constants
- STATUS_PUBLISHED = 'published'
- TEMPLATE_DEFAULT = 'default'
- Template constants
- TEMPLATE_FULL_WIDTH = 'full-width'
- TEMPLATE_LANDING = 'landing'
- TEMPLATE_SIDEBAR = 'sidebar'
Properties
- $_loadedRelations : array<string|int, mixed>
- Loaded relations cache
- $_pdo : PDO|null
- Database connection
- $_relationCache : array<string|int, mixed>
- Relation metadata cache
- $_author : User|null
- $_authorId : int
- $_contentRaw : string
- $_createdAt : DateTimeImmutable|null
- $_id : int|null
- $_metaDescription : string|null
- $_metaKeywords : string|null
- $_metaTitle : string|null
- $_publishedAt : DateTimeImmutable|null
- $_slug : string
- $_status : string
- $_template : string
- $_title : string
- $_updatedAt : DateTimeImmutable|null
- $_viewCount : int
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 Page from array data
- getAttribute() : mixed
- Get an attribute value from the model.
- getAuthor() : User|null
- Get author
- getAuthorId() : int
- Get author ID
- getContent() : array<string|int, mixed>
- Get content as array (decoded Editor.js JSON)
- getContentRaw() : string
- Get raw content JSON string
- getCreatedAt() : DateTimeImmutable|null
- Get created timestamp
- getId() : int|null
- Get page ID
- getMetaDescription() : string|null
- Get meta description (for SEO)
- getMetaKeywords() : string|null
- Get meta keywords (for SEO)
- getMetaTitle() : string|null
- Get meta title (for SEO)
- getPrimaryKey() : string
- Get the primary key column name.
- getPublishedAt() : DateTimeImmutable|null
- Get published date
- getSlug() : string
- Get slug
- getStatus() : string
- Get status
- getTableName() : string
- Get the table name for this model from the Table attribute.
- getTemplate() : string
- Get template
- getTitle() : string
- Get title
- getUpdatedAt() : DateTimeImmutable|null
- Get updated timestamp
- getViewCount() : int
- Get view count
- incrementViewCount() : self
- Increment view count
- inTransaction() : bool
- Check if currently inside a transaction.
- isDraft() : bool
- Check if page is draft
- isPublished() : bool
- Check if page is published
- 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.
- setAuthor() : self
- Set author
- setAuthorId() : self
- Set author ID
- setContent() : self
- Set content from Editor.js JSON string
- setContentArray() : self
- Set content from array (will be JSON encoded)
- setCreatedAt() : self
- Set created timestamp
- setId() : self
- Set page ID
- setLoadedRelation() : void
- Set a loaded relation (used by eager loading).
- setMetaDescription() : self
- Set meta description
- setMetaKeywords() : self
- Set meta keywords
- setMetaTitle() : self
- Set meta title
- setPdo() : void
- Set the PDO connection for all models.
- setPublishedAt() : self
- Set published date
- setSlug() : self
- Set slug
- setStatus() : self
- Set status
- setTemplate() : self
- Set template
- setTitle() : self
- Set title
- setUpdatedAt() : self
- Set updated timestamp
- setViewCount() : self
- Set view count
- toArray() : array<string|int, mixed>
- Convert page 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.
Constants
STATUS_DRAFT
Page status constants
Use ContentStatus enum instead
public
mixed
STATUS_DRAFT
= 'draft'
STATUS_PUBLISHED
public
mixed
STATUS_PUBLISHED
= 'published'
TEMPLATE_DEFAULT
Template constants
Use PageTemplate enum instead
public
mixed
TEMPLATE_DEFAULT
= 'default'
TEMPLATE_FULL_WIDTH
public
mixed
TEMPLATE_FULL_WIDTH
= 'full-width'
TEMPLATE_LANDING
public
mixed
TEMPLATE_LANDING
= 'landing'
TEMPLATE_SIDEBAR
public
mixed
TEMPLATE_SIDEBAR
= 'sidebar'
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
= []
$_author
private
User|null
$_author
= null
Attributes
- #[BelongsTo]
- \Neuron\Cms\Models\User::class
- $foreignKey: 'author_id'
$_authorId
private
int
$_authorId
$_contentRaw
private
string
$_contentRaw
= '{"blocks":[]}'
$_createdAt
private
DateTimeImmutable|null
$_createdAt
= null
$_id
private
int|null
$_id
= null
$_metaDescription
private
string|null
$_metaDescription
= null
$_metaKeywords
private
string|null
$_metaKeywords
= null
$_metaTitle
private
string|null
$_metaTitle
= null
$_publishedAt
private
DateTimeImmutable|null
$_publishedAt
= null
$_slug
private
string
$_slug
$_status
private
string
$_status
= 'draft'
$_template
private
string
$_template
= 'default'
$_title
private
string
$_title
$_updatedAt
private
DateTimeImmutable|null
$_updatedAt
= null
$_viewCount
private
int
$_viewCount
= 0
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 Page from array data
public
static fromArray(array<string|int, mixed> $data) : static
Parameters
- $data : array<string|int, mixed>
-
Associative array of page data
Tags
Return values
staticgetAttribute()
Get an attribute value from the model.
public
getAttribute(string $key) : mixed
Parameters
- $key : string
getAuthor()
Get author
public
getAuthor() : User|null
Return values
User|nullgetAuthorId()
Get author ID
public
getAuthorId() : int
Return values
intgetContent()
Get content as array (decoded Editor.js JSON)
public
getContent() : array<string|int, mixed>
Return values
array<string|int, mixed>getContentRaw()
Get raw content JSON string
public
getContentRaw() : string
Return values
stringgetCreatedAt()
Get created timestamp
public
getCreatedAt() : DateTimeImmutable|null
Return values
DateTimeImmutable|nullgetId()
Get page ID
public
getId() : int|null
Return values
int|nullgetMetaDescription()
Get meta description (for SEO)
public
getMetaDescription() : string|null
Return values
string|nullgetMetaKeywords()
Get meta keywords (for SEO)
public
getMetaKeywords() : string|null
Return values
string|nullgetMetaTitle()
Get meta title (for SEO)
public
getMetaTitle() : string|null
Return values
string|nullgetPrimaryKey()
Get the primary key column name.
public
static getPrimaryKey() : string
Return values
stringgetPublishedAt()
Get published date
public
getPublishedAt() : DateTimeImmutable|null
Return values
DateTimeImmutable|nullgetSlug()
Get slug
public
getSlug() : string
Return values
stringgetStatus()
Get status
public
getStatus() : string
Return values
stringgetTableName()
Get the table name for this model from the Table attribute.
public
static getTableName() : string
Tags
Return values
stringgetTemplate()
Get template
public
getTemplate() : string
Return values
stringgetTitle()
Get title
public
getTitle() : string
Return values
stringgetUpdatedAt()
Get updated timestamp
public
getUpdatedAt() : DateTimeImmutable|null
Return values
DateTimeImmutable|nullgetViewCount()
Get view count
public
getViewCount() : int
Return values
intincrementViewCount()
Increment view count
public
incrementViewCount() : self
Return values
selfinTransaction()
Check if currently inside a transaction.
public
static inTransaction() : bool
Tags
Return values
bool —True if inside a transaction
isDraft()
Check if page is draft
public
isDraft() : bool
Return values
boolisPublished()
Check if page is published
public
isPublished() : bool
Return values
boollimit()
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
setAuthor()
Set author
public
setAuthor(User|null $author) : self
Parameters
- $author : User|null
Return values
selfsetAuthorId()
Set author ID
public
setAuthorId(int $authorId) : self
Parameters
- $authorId : int
Return values
selfsetContent()
Set content from Editor.js JSON string
public
setContent(string $jsonContent) : self
Parameters
- $jsonContent : string
Return values
selfsetContentArray()
Set content from array (will be JSON encoded)
public
setContentArray(array<string|int, mixed> $content) : self
Parameters
- $content : array<string|int, mixed>
-
Content array to encode
Tags
Return values
selfsetCreatedAt()
Set created timestamp
public
setCreatedAt(DateTimeImmutable $createdAt) : self
Parameters
- $createdAt : DateTimeImmutable
Return values
selfsetId()
Set page 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
setMetaDescription()
Set meta description
public
setMetaDescription(string|null $metaDescription) : self
Parameters
- $metaDescription : string|null
Return values
selfsetMetaKeywords()
Set meta keywords
public
setMetaKeywords(string|null $metaKeywords) : self
Parameters
- $metaKeywords : string|null
Return values
selfsetMetaTitle()
Set meta title
public
setMetaTitle(string|null $metaTitle) : self
Parameters
- $metaTitle : string|null
Return values
selfsetPdo()
Set the PDO connection for all models.
public
static setPdo(PDO $pdo) : void
Parameters
- $pdo : PDO
setPublishedAt()
Set published date
public
setPublishedAt(DateTimeImmutable|null $publishedAt) : self
Parameters
- $publishedAt : DateTimeImmutable|null
Return values
selfsetSlug()
Set slug
public
setSlug(string $slug) : self
Parameters
- $slug : string
Return values
selfsetStatus()
Set status
public
setStatus(string $status) : self
Parameters
- $status : string
Return values
selfsetTemplate()
Set template
public
setTemplate(string $template) : self
Parameters
- $template : string
Return values
selfsetTitle()
Set title
public
setTitle(string $title) : self
Parameters
- $title : string
Return values
selfsetUpdatedAt()
Set updated timestamp
public
setUpdatedAt(DateTimeImmutable|null $updatedAt) : self
Parameters
- $updatedAt : DateTimeImmutable|null
Return values
selfsetViewCount()
Set view count
public
setViewCount(int $viewCount) : self
Parameters
- $viewCount : int
Return values
selftoArray()
Convert page 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