Neuron-PHP

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
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 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
throws
Exception
Return values
static

getAttribute()

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|null

getAuthorId()

Get author ID

public getAuthorId() : int
Return values
int

getContent()

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
string

getCreatedAt()

Get created timestamp

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

getId()

Get page ID

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

getMetaDescription()

Get meta description (for SEO)

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

getMetaKeywords()

Get meta keywords (for SEO)

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

getMetaTitle()

Get meta title (for SEO)

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

getPrimaryKey()

Get the primary key column name.

public static getPrimaryKey() : string
Return values
string

getPublishedAt()

Get published date

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

getSlug()

Get slug

public getSlug() : string
Return values
string

getStatus()

Get status

public getStatus() : 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

getTemplate()

Get template

public getTemplate() : string
Return values
string

getTitle()

Get title

public getTitle() : string
Return values
string

getUpdatedAt()

Get updated timestamp

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

getViewCount()

Get view count

public getViewCount() : int
Return values
int

incrementViewCount()

Increment view count

public incrementViewCount() : self
Return values
self

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

isDraft()

Check if page is draft

public isDraft() : bool
Return values
bool

isPublished()

Check if page is published

public isPublished() : bool
Return values
bool

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

setAuthor()

Set author

public setAuthor(User|null $author) : self
Parameters
$author : User|null
Return values
self

setAuthorId()

Set author ID

public setAuthorId(int $authorId) : self
Parameters
$authorId : int
Return values
self

setContent()

Set content from Editor.js JSON string

public setContent(string $jsonContent) : self
Parameters
$jsonContent : string
Return values
self

setContentArray()

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
throws
JsonException

If JSON encoding fails

Return values
self

setCreatedAt()

Set created timestamp

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

setId()

Set page 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

setMetaDescription()

Set meta description

public setMetaDescription(string|null $metaDescription) : self
Parameters
$metaDescription : string|null
Return values
self

setMetaKeywords()

Set meta keywords

public setMetaKeywords(string|null $metaKeywords) : self
Parameters
$metaKeywords : string|null
Return values
self

setMetaTitle()

Set meta title

public setMetaTitle(string|null $metaTitle) : self
Parameters
$metaTitle : string|null
Return values
self

setPdo()

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
self

setSlug()

Set slug

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

setStatus()

Set status

public setStatus(string $status) : self
Parameters
$status : string
Return values
self

setTemplate()

Set template

public setTemplate(string $template) : self
Parameters
$template : string
Return values
self

setTitle()

Set title

public setTitle(string $title) : self
Parameters
$title : string
Return values
self

setUpdatedAt()

Set updated timestamp

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

setViewCount()

Set view count

public setViewCount(int $viewCount) : self
Parameters
$viewCount : int
Return values
self

toArray()

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
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