---
title: "Phalcon Contracts"
version: "5.17"
---
> Documentation Index
> Fetch the complete documentation index at: https://docs.phalcon.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Phalcon Contracts
:::info[NOTE]
All classes are prefixed with `Phalcon`
:::
## Contracts\Acl\Adapter\Adapter
Interface
Source on GitHub
Canonical contract for Phalcon\Acl adapters
- **`Phalcon\Contracts\Acl\Adapter\Adapter`**
- [`Phalcon\Acl\Adapter\AdapterInterface`](/5.17/api/phalcon_acl/#acladapteradapterinterface)
__Uses__ `Phalcon\Acl\ComponentInterface` · `Phalcon\Acl\RoleInterface`
### Method Summary
public
bool
addComponent(mixed $componentValue,mixed $accessList)
Adds a component to the ACL list
public
bool
addComponentAccess(string $componentName,mixed $accessList)
Adds access to components
public
bool
addInherit(string $roleName,mixed $roleToInherits)
Do a role inherit from another existing role
public
bool
addRole(mixed $role,mixed $accessInherits = null)
Adds a role to the ACL list. Second parameter lets to inherit access data
public
void
allow(string $roleName,string $componentName,mixed $access,mixed $func = null)
Allow access to a role on a component
public
void
deny(string $roleName,string $componentName,mixed $access,mixed $func = null)
Deny access to a role on a component
public
void
dropComponentAccess(string $componentName,mixed $accessList)
Removes access from a component
public
null|string
getActiveAccess()
Returns the access which the list is checking if some role can access it
public
null|string
getActiveComponent()
Returns the component which the list is checking if some role can access
public
null|string
getActiveRole()
Returns the role which the list is checking if it's allowed to certain
public
ComponentInterface[]
getComponents()
Return an array with every component registered in the list
public
int
getDefaultAction()
Returns the default ACL access level
public
array
getInheritedRoles( string $roleName = "" )
Returns the inherited roles for a passed role name. If no role name
public
int
getNoArgumentsDefaultAction()
Returns the default ACL access level for no arguments provided in
public
RoleInterface[]
getRoles()
Return an array with every role registered in the list
public
bool
isAllowed(mixed $roleName,mixed $componentName,string $access,array $parameters = null)
Check whether a role is allowed to access an action from a component
public
bool
isComponent( string $componentName )
Check whether component exist in the components list
public
bool
isRole( string $roleName )
Check whether role exist in the roles list
public
void
setDefaultAction( int $defaultAccess )
Sets the default access level (Phalcon\Acl\Enum::ALLOW or Phalcon\Acl\Enum::DENY)
public
void
setNoArgumentsDefaultAction( int $defaultAccess )
Sets the default access level (Phalcon\Acl\Enum::ALLOW or Phalcon\Acl\Enum::DENY)
### Methods
Public · 20
addComponent()
```php
public function addComponent(
mixed $componentValue,
mixed $accessList
): bool;
```
Adds a component to the ACL list
Access names can be a particular action, by example
search, update, delete, etc. or a list of them
addComponentAccess()
```php
public function addComponentAccess(
string $componentName,
mixed $accessList
): bool;
```
Adds access to components
addInherit()
```php
public function addInherit(
string $roleName,
mixed $roleToInherits
): bool;
```
Do a role inherit from another existing role
addRole()
```php
public function addRole(
mixed $role,
mixed $accessInherits = null
): bool;
```
Adds a role to the ACL list. Second parameter lets to inherit access data
from other existing role
allow()
```php
public function allow(
string $roleName,
string $componentName,
mixed $access,
mixed $func = null
): void;
```
Allow access to a role on a component
deny()
```php
public function deny(
string $roleName,
string $componentName,
mixed $access,
mixed $func = null
): void;
```
Deny access to a role on a component
dropComponentAccess()
```php
public function dropComponentAccess(
string $componentName,
mixed $accessList
): void;
```
Removes access from a component
getActiveAccess()
```php
public function getActiveAccess(): null|string;
```
Returns the access which the list is checking if some role can access it
getActiveComponent()
```php
public function getActiveComponent(): null|string;
```
Returns the component which the list is checking if some role can access
it
getActiveRole()
```php
public function getActiveRole(): null|string;
```
Returns the role which the list is checking if it's allowed to certain
component/access
getComponents()
```php
public function getComponents(): ComponentInterface[];
```
Return an array with every component registered in the list
getDefaultAction()
```php
public function getDefaultAction(): int;
```
Returns the default ACL access level
getInheritedRoles()
```php
public function getInheritedRoles( string $roleName = "" ): array;
```
Returns the inherited roles for a passed role name. If no role name
has been specified it will return the whole array. If the role has not
been found it returns an empty array
getNoArgumentsDefaultAction()
```php
public function getNoArgumentsDefaultAction(): int;
```
Returns the default ACL access level for no arguments provided in
isAllowed action if there exists func for accessKey
getRoles()
```php
public function getRoles(): RoleInterface[];
```
Return an array with every role registered in the list
isAllowed()
```php
public function isAllowed(
mixed $roleName,
mixed $componentName,
string $access,
array $parameters = null
): bool;
```
Check whether a role is allowed to access an action from a component
isComponent()
```php
public function isComponent( string $componentName ): bool;
```
Check whether component exist in the components list
isRole()
```php
public function isRole( string $roleName ): bool;
```
Check whether role exist in the roles list
setDefaultAction()
```php
public function setDefaultAction( int $defaultAccess ): void;
```
Sets the default access level (Phalcon\Acl\Enum::ALLOW or Phalcon\Acl\Enum::DENY)
setNoArgumentsDefaultAction()
```php
public function setNoArgumentsDefaultAction( int $defaultAccess ): void;
```
Sets the default access level (Phalcon\Acl\Enum::ALLOW or Phalcon\Acl\Enum::DENY)
for no arguments provided in isAllowed action if there exists func for
accessKey
## Contracts\Acl\Adapter\Persistable
Interface
Source on GitHub
Contract for ACL adapters that persist their policy to a backing store as a
whole-policy snapshot (coarse granularity).
NOTE: callable (closure) rules registered via allow()/deny() are NOT
persisted - closures are not serializable. Re-register them in code after
load(). The static rule set and role inheritance are persisted in full.
- **`Phalcon\Contracts\Acl\Adapter\Persistable`**
### Method Summary
### Methods
Public · 2
load()
```php
public function load(): bool;
```
Loads the policy snapshot from the backing store, replacing current
in-memory state. Returns false if no snapshot was found.
save()
```php
public function save(): bool;
```
Persists the current policy snapshot to the backing store.
## Contracts\Acl\Component
Interface
Source on GitHub
Canonical contract for an ACL component entity.
- **`Phalcon\Contracts\Acl\Component`**
- [`Phalcon\Acl\ComponentInterface`](/5.17/api/phalcon_acl/#aclcomponentinterface)
### Method Summary
### Methods
Public · 3
__toString()
```php
public function __toString(): string;
```
Magic method __toString
getDescription()
```php
public function getDescription(): string|null;
```
Returns component description
getName()
```php
public function getName(): string;
```
Returns the component name
## Contracts\Acl\ComponentAware
Interface
Source on GitHub
Canonical contract for ACL component-aware objects.
- **`Phalcon\Contracts\Acl\ComponentAware`**
- [`Phalcon\Acl\ComponentAwareInterface`](/5.17/api/phalcon_acl/#aclcomponentawareinterface)
### Method Summary
### Methods
Public · 1
getComponentName()
```php
public function getComponentName(): string;
```
Returns component name
## Contracts\Acl\Role
Interface
Source on GitHub
Canonical contract for an ACL role entity.
- **`Phalcon\Contracts\Acl\Role`**
- [`Phalcon\Acl\RoleInterface`](/5.17/api/phalcon_acl/#aclroleinterface)
### Method Summary
### Methods
Public · 3
__toString()
```php
public function __toString(): string;
```
Magic method __toString
getDescription()
```php
public function getDescription(): string|null;
```
Returns role description
getName()
```php
public function getName(): string;
```
Returns the role name
## Contracts\Acl\RoleAware
Interface
Source on GitHub
Canonical contract for ACL role-aware objects.
- **`Phalcon\Contracts\Acl\RoleAware`**
- [`Phalcon\Acl\RoleAwareInterface`](/5.17/api/phalcon_acl/#aclroleawareinterface)
### Method Summary
### Methods
Public · 1
getRoleName()
```php
public function getRoleName(): string;
```
Returns role name
## Contracts\Assets\Asset
Interface
Source on GitHub
Canonical contract for Phalcon\Assets\Asset.
Covers collection membership: an asset's key, type, HTML attributes, and
filter flag. The file-output pipeline (Phalcon\Assets\Manager::output())
requires the concrete Phalcon\Assets\Asset class.
- **`Phalcon\Contracts\Assets\Asset`**
- [`Phalcon\Assets\AssetInterface`](/5.17/api/phalcon_assets/#assetsassetinterface)
### Method Summary
### Methods
Public · 7
getAssetKey()
```php
public function getAssetKey(): string;
```
Gets the asset's key.
getAttributes()
```php
public function getAttributes(): array|null;
```
Gets extra HTML attributes.
getFilter()
```php
public function getFilter(): bool;
```
Gets if the asset must be filtered or not.
getType()
```php
public function getType(): string;
```
Gets the asset's type.
setAttributes()
```php
public function setAttributes( array $attributes ): Asset;
```
Sets extra HTML attributes.
setFilter()
```php
public function setFilter( bool $filter ): Asset;
```
Sets if the asset must be filtered or not.
setType()
```php
public function setType( string $type ): Asset;
```
Sets the asset's type.
## Contracts\Assets\Filter
Interface
Source on GitHub
Canonical contract for Phalcon\Assets filters (Cssmin, Jsmin, None, and
custom user filters).
- **`Phalcon\Contracts\Assets\Filter`**
- [`Phalcon\Assets\FilterInterface`](/5.17/api/phalcon_assets/#assetsfilterinterface)
### Method Summary
### Methods
Public · 1
filter()
```php
public function filter( string $content ): string;
```
Filters the content returning a string with the filtered content
## Contracts\Auth\Access\Access
Interface
Source on GitHub
Access gates are Specifications: policies that decide whether the current
identity may run the given action. The enforcement point passes the
identity (the guard) and the request context on every call; gates hold no
reference to the auth manager.
- **`Phalcon\Contracts\Auth\Access\Access`**
__Uses__ `Phalcon\Contracts\Auth\Guard\Guard`
### Method Summary
### Methods
Public · 6
getExceptActions()
```php
public function getExceptActions(): array;
```
getOnlyActions()
```php
public function getOnlyActions(): array;
```
isAllowed()
```php
public function isAllowed(
Guard $guard,
string $actionName,
array $context = []
): bool;
```
Whether the identity behind the guard may run the action.
redirectTo()
```php
public function redirectTo(): array|null;
```
setExceptActions()
```php
public function setExceptActions( array $exceptActions = [] ): void;
```
Exempts the listed action names from the gate; every other action is
checked. See setOnlyActions() for the gate-family divergence note.
setOnlyActions()
```php
public function setOnlyActions( array $onlyActions = [] ): void;
```
Restricts the gate to the listed action names.
Authoritative semantics: the gate applies only to the listed actions; an
action that is not listed passes without a check (and except() is the
inverse - the gate applies to every action except those listed).
NOTE: the implementations currently diverge. The Acl gate follows the
authoritative semantics above, while the binary gates (Auth, Guest)
treat `only` as a whitelist - an unlisted action is denied even when the
base condition holds. The two gate families will be aligned in the next
major version; until then, choose the gate family deliberately, because
for an unlisted action they return opposite answers to the same call.
## Contracts\Auth\Adapter\Adapter
Interface
Source on GitHub
Authentication adapter contract.
Adapters look users up by credentials or by identifier and verify the
password against the stored hash. The credential payload is intentionally
unsealed: any user-row field may be used as the lookup key, plus an
optional `password` entry that is ignored during the row match and
consumed only by validateCredentials().
- **`Phalcon\Contracts\Auth\Adapter\Adapter`**
- [`Phalcon\Contracts\Auth\Adapter\RememberAdapter`](#contractsauthadapterrememberadapter)
__Uses__ `Phalcon\Contracts\Auth\AuthUser` · `Phalcon\Contracts\Encryption\Security\Security`
### Method Summary
### Methods
Public · 4
fromOptions()
```php
public static function fromOptions(
Security $hasher,
array $options
): static;
```
Build an adapter from a flat options map. Used by ManagerFactory to
wire adapters from the application config; each implementation is
free to interpret the option keys it cares about.
retrieveByCredentials()
```php
public function retrieveByCredentials( array $credentials ): AuthUser|null;
```
Find a user matching the given credentials (e.g. ['email' => 'a@b']).
The 'password' key, if present, is ignored during the lookup.
Returns null if no user matches.
retrieveById()
```php
public function retrieveById( mixed $id ): AuthUser|null;
```
Find a user by their unique identifier.
validateCredentials()
```php
public function validateCredentials(
AuthUser $user,
array $credentials
): bool;
```
Validate the provided credentials against the given user.
Implementations typically verify the password hash held under the
'password' key.
## Contracts\Auth\Adapter\AdapterConfig
Interface
Source on GitHub
Authentication adapter configuration contract.
Per-adapter config shape is intentionally adapter-specific (e.g. Stream
exposes getFile(), Memory exposes getUsers()); the only field shared across
all adapters is the optional model class used during user hydration.
- **`Phalcon\Contracts\Auth\Adapter\AdapterConfig`**
### Method Summary
### Methods
Public · 1
getModel()
```php
public function getModel(): string|null;
```
Returns the user-model class name to hydrate, if configured.
## Contracts\Auth\Adapter\RememberAdapter
Interface
Source on GitHub
Capability extension implemented by adapters that support remember-me.
- [`Phalcon\Contracts\Auth\Adapter\Adapter`](#contractsauthadapteradapter)
- **`Phalcon\Contracts\Auth\Adapter\RememberAdapter`**
__Uses__ `Phalcon\Contracts\Auth\AuthUser` · `Phalcon\Contracts\Auth\RememberToken`
### Method Summary
### Methods
Public · 2
createRememberToken()
```php
public function createRememberToken( AuthUser $user ): RememberToken;
```
Create and persist a new remember token for the user.
retrieveByToken()
```php
public function retrieveByToken(
mixed $id,
string $token,
string $userAgent = null
): AuthUser|null;
```
Retrieve a user by the remember-me cookie payload.
## Contracts\Auth\AuthRemember
Interface
Source on GitHub
Implemented by authenticatable models that support remember-me tokens.
This is intentionally separate from AuthUser so that adapters which do
not support remember-me are not forced to implement it.
- **`Phalcon\Contracts\Auth\AuthRemember`**
### Method Summary
### Methods
Public · 2
createRememberToken()
```php
public function createRememberToken(
string $token,
string $userAgent = null
): RememberToken;
```
Persists a new remember token for the user.
getRememberToken()
```php
public function getRememberToken( string $token ): RememberToken|null;
```
Returns the remember token entry matching the given token value,
or null if not found.
## Contracts\Auth\AuthUser
Interface
Source on GitHub
Implemented by user models that can be authenticated.
- **`Phalcon\Contracts\Auth\AuthUser`**
### Method Summary
### Methods
Public · 2
getAuthIdentifier()
```php
public function getAuthIdentifier(): int|string;
```
Returns the unique identifier for the authenticatable user
(e.g. the primary key). Implementations MUST return a non-null
scalar; if a record cannot produce one, the implementation should
fail at construction time rather than returning null.
getAuthPassword()
```php
public function getAuthPassword(): string;
```
Returns the hashed password for the authenticatable user.
## Contracts\Auth\Guard\BasicAuth
Interface
Source on GitHub
- **`Phalcon\Contracts\Auth\Guard\BasicAuth`**
__Uses__ `Phalcon\Contracts\Auth\AuthUser`
### Method Summary
### Methods
Public · 2
basic()
```php
public function basic(
string $field = "email",
array $extraConditions = []
): bool;
```
Authenticate against HTTP Basic credentials. Returns true on success.
onceBasic()
```php
public function onceBasic(
string $field = "email",
array $extraConditions = []
): false|AuthUser;
```
Like basic() but does not persist; returns the resolved user on success
or false on failure.
## Contracts\Auth\Guard\Guard
Interface
Source on GitHub
- **`Phalcon\Contracts\Auth\Guard\Guard`**
__Uses__ `Phalcon\Contracts\Auth\Adapter\Adapter` · `Phalcon\Contracts\Auth\AuthUser` · `Phalcon\Contracts\Container\Service\Collection` · `Phalcon\Di\DiInterface`
### Method Summary
### Methods
Public · 9
check()
```php
public function check(): bool;
```
Whether the current request is authenticated.
fromOptions()
```php
public static function fromOptions(
Adapter $adapter,
mixed $container,
array $options
): static;
```
Build a guard from an adapter, the application container, and a flat
options map. Used by ManagerFactory to wire guards from the
application config; each implementation resolves the framework
services it needs from the container.
The container is Container-first: pass a Phalcon\Container\Container.
The legacy Phalcon\Di\Di is also supported with provisions - its
service definitions must be pre-registered (no autowiring).
getLastUserAttempted()
```php
public function getLastUserAttempted(): AuthUser|null;
```
Returns the last user the guard tried to authenticate during this
request, regardless of success.
guest()
```php
public function guest(): bool;
```
Whether the current request is unauthenticated.
hasUser()
```php
public function hasUser(): bool;
```
Whether the guard currently holds a resolved user.
id()
```php
public function id(): int|string|null;
```
Returns the authenticated user's identifier, or null when no
authenticated user is present.
setUser()
```php
public function setUser( AuthUser $user ): static;
```
Sets the current user explicitly. Returns $this for fluent chaining.
user()
```php
public function user(): AuthUser|null;
```
Returns the resolved user for the current request, or null.
validate()
```php
public function validate( array $credentials = [] ): bool;
```
Validates the given credentials without logging in.
## Contracts\Auth\Guard\GuardConfig
Interface
Source on GitHub
Authentication guard configuration contract.
Per-guard config shape is intentionally guard-specific (e.g. Token exposes
getInputKey()/getStorageKey(); Session has no required config today).
The contract carries no methods of its own - it only marks the type so
AbstractGuard can accept any guard config uniformly.
- **`Phalcon\Contracts\Auth\Guard\GuardConfig`**
## Contracts\Auth\Guard\GuardStateful
Interface
Source on GitHub
Implemented by guards backed by persistent state (sessions/cookies).
- **`Phalcon\Contracts\Auth\Guard\GuardStateful`**
__Uses__ `Phalcon\Contracts\Auth\Adapter\Adapter` · `Phalcon\Contracts\Auth\AuthUser`
### Method Summary
### Methods
Public · 5
attempt()
```php
public function attempt(
array $credentials = [],
bool $remember = false
): bool;
```
Attempts to authenticate the user with the given credentials and, on
success, persists the resulting state on the guard.
login()
```php
public function login(
AuthUser $user,
bool $remember = false
): void;
```
loginById()
```php
public function loginById(
mixed $id,
bool $remember = false
): false|AuthUser;
```
Logs in the user identified by $id. Returns the resolved user on
success or false when no user matches the id.
logout()
```php
public function logout(): void;
```
viaRemember()
```php
public function viaRemember(): bool;
```
## Contracts\Auth\Manager
Interface
Source on GitHub
- **`Phalcon\Contracts\Auth\Manager`**
__Uses__ `Phalcon\Auth\Exception` · `Phalcon\Contracts\Auth\Access\Access` · `Phalcon\Contracts\Auth\Adapter\Adapter` · `Phalcon\Contracts\Auth\Guard\Guard`
### Method Summary
### Methods
Public · 18
access()
```php
public function access( string $accessName ): self;
```
Activates the named access gate for the current request and returns the
manager for fluent only()/except() configuration.
Enforcement is opt-in and fail-open: when no access has been activated
(getAccess() returns null) every dispatch is allowed. An activated gate
stays active for subsequent dispatches in the same request (forwards,
nested handlers) until it is replaced. Under classic FPM this is scoped
to a single request; long-running runtimes must reset it per request.
addAccessList()
```php
public function addAccessList( array $accessList ): self;
```
addGuard()
```php
public function addGuard(
string $nameGuard,
Guard $guard,
bool $isDefault = false
): self;
```
attempt()
```php
public function attempt(
array $credentials = [],
bool $remember = false
): bool;
```
check()
```php
public function check(): bool;
```
Whether the default guard reports the current request as authenticated.
except()
```php
public function except( string $actions ): self;
```
Restricts the active access gate to skip the listed action names.
getAccess()
```php
public function getAccess(): Access|null;
```
Returns the active access gate, or null when none has been activated -
in which case listener enforcement is a no-op (see access()).
getAccessList()
```php
public function getAccessList(): array;
```
getDefaultGuard()
```php
public function getDefaultGuard(): Guard|null;
```
getGuards()
```php
public function getGuards(): array;
```
guard()
```php
public function guard( string $name = null ): Guard;
```
Returns the named guard, or the default guard when $name is null.
id()
```php
public function id(): int|string|null;
```
Returns the authenticated user's identifier from the default guard,
or null when no authenticated user is present.
logout()
```php
public function logout(): void;
```
Logs the current user out via the default guard.
only()
```php
public function only( string $actions ): self;
```
Restricts the active access gate to apply only to the listed action names.
setAccess()
```php
public function setAccess( Access $access ): self;
```
setDefaultGuard()
```php
public function setDefaultGuard( Guard $guard ): self;
```
user()
```php
public function user(): AuthUser|null;
```
Returns the resolved user from the default guard, or null.
validate()
```php
public function validate( array $credentials = [] ): bool;
```
Validates the given credentials against the default guard without
logging in.
## Contracts\Auth\RememberToken
Interface
Source on GitHub
A persisted remember-me token row.
- **`Phalcon\Contracts\Auth\RememberToken`**
### Method Summary
### Methods
Public · 3
delete()
```php
public function delete(): bool;
```
Deletes the token from storage.
getToken()
```php
public function getToken(): string;
```
Returns the token value stored for this remember entry.
getUserAgent()
```php
public function getUserAgent(): string|null;
```
Returns the user agent associated with this token, if any.
## Contracts\Cache\Cache
Interface
Source on GitHub
Canonical contract for Phalcon\Cache\Cache.
- **`Phalcon\Contracts\Cache\Cache`**
- [`Phalcon\Cache\CacheInterface`](/5.17/api/phalcon_cache/#cachecacheinterface)
__Uses__ `DateInterval` · `Phalcon\Cache\Exception\InvalidArgumentException`
### Method Summary
### Methods
Public · 8
clear()
```php
public function clear(): bool;
```
Wipes clean the entire cache's keys.
delete()
```php
public function delete( string $key ): bool;
```
Delete an item from the cache by its unique key.
deleteMultiple()
```php
public function deleteMultiple( mixed $keys ): bool;
```
Deletes multiple cache items in a single operation.
get()
```php
public function get(
string $key,
mixed $defaultValue = null
);
```
Fetches a value from the cache.
getMultiple()
```php
public function getMultiple(
mixed $keys,
mixed $defaultValue = null
);
```
Obtains multiple cache items by their unique keys.
has()
```php
public function has( string $key ): bool;
```
Determines whether an item is present in the cache.
set()
```php
public function set(
string $key,
mixed $value,
mixed $ttl = null
): bool;
```
Persists data in the cache, uniquely referenced by a key with an optional
expiration TTL time.
setMultiple()
```php
public function setMultiple(
mixed $values,
mixed $ttl = null
): bool;
```
Persists a set of key => value pairs in the cache, with an optional TTL.
## Contracts\Cli\Dispatcher
Interface
Source on GitHub
Canonical contract for Phalcon\Cli\Dispatcher.
- [`Phalcon\Contracts\Dispatcher\Dispatcher`](#contractsdispatcherdispatcher)
- **`Phalcon\Contracts\Cli\Dispatcher`**
- [`Phalcon\Cli\DispatcherInterface`](/5.17/api/phalcon_cli/#clidispatcherinterface)
__Uses__ `Phalcon\Cli\TaskInterface` · `Phalcon\Contracts\Dispatcher\Dispatcher`
### Method Summary
### Methods
Public · 9
getActiveTask()
```php
public function getActiveTask(): TaskInterface;
```
Returns the active task in the dispatcher
getLastTask()
```php
public function getLastTask(): TaskInterface;
```
Returns the latest dispatched controller
getOptions()
```php
public function getOptions(): array;
```
Get dispatched options
getTaskName()
```php
public function getTaskName(): string;
```
Gets last dispatched task name
getTaskSuffix()
```php
public function getTaskSuffix(): string;
```
Gets default task suffix
setDefaultTask()
```php
public function setDefaultTask( string $taskName ): void;
```
Sets the default task name
setOptions()
```php
public function setOptions( array $options ): void;
```
Set the options to be dispatched
setTaskName()
```php
public function setTaskName( string $taskName ): void;
```
Sets the task name to be dispatched
setTaskSuffix()
```php
public function setTaskSuffix( string $taskSuffix ): void;
```
Sets the default task suffix
## Contracts\Container\Ioc\IocContainer
Interface
Source on GitHub
[_IocContainer_][] affords obtaining services by name.
- Notes:
- **This interface does not afford service management.** The container
will need to obtain services somehow, e.g. from a [Service-Interop][]
implementation.
- **`Phalcon\Contracts\Container\Ioc\IocContainer`**
- [`Phalcon\Contracts\Container\Service\Collection`](#contractscontainerservicecollection)
### Method Summary
### Methods
Public · 2
getService()
```php
public function getService( string $serviceName ): object;
```
Returns an instance of the `$serviceName`.
- Directives:
- Implementations MUST throw [_IocThrowable_][] if the container
cannot return an instance of the `$serviceName`.
- Notes:
- **The logic for this method is expressly unspecified.** Retrieval
may be accomplished via a service management subsystem, or by some
other means.
- **The returned instance may be new or shared.** The retrieval
logic defines the service lifetime, not the container (per se) and
not the caller requesting the service.
hasService()
```php
public function hasService( string $serviceName ): bool;
```
Is the container able to return an instance of the `$serviceName`?
- Notes:
- **The logic for this method is expressly unspecified.** The ability
check may be accomplished by querying a service management subsystem,
or by some other means.
## Contracts\Container\Ioc\IocContainerFactory
Interface
Source on GitHub
[_IocContainerFactory_][] affords obtaining a new instance of
[_IocContainer_][].
- **`Phalcon\Contracts\Container\Ioc\IocContainerFactory`**
### Method Summary
### Methods
Public · 1
newContainer()
```php
public function newContainer(): IocContainer;
```
Returns a new instance of [_IocContainer_][].
- Notes:
- **Container instantiation logic is not specified.** Implementations
might use providers, configuration files, attribute or annotation
collection, or some other means to create and populate a container.
Implementations might also choose to return a compiled or otherwise
reconstituted container.
## Contracts\Container\Ioc\IocThrowable
Interface
Source on GitHub
[_IocThrowable_][] extends [_Throwable_][] to mark an [_Exception_][] as
IOC-related.
It adds no class members.
- `Throwable`
- **`Phalcon\Contracts\Container\Ioc\IocThrowable`**
- [`Phalcon\Container\Exceptions\ContainerThrowable`](/5.17/api/phalcon_container/#containerexceptionscontainerthrowable)
__Uses__ `Throwable`
## Contracts\Container\Ioc\IocTypeAliases
Interface
Source on GitHub
- **`Phalcon\Contracts\Container\Ioc\IocTypeAliases`**
## Contracts\Container\Resolver\ReflectionMethodResolver
Interface
Source on GitHub
- **`Phalcon\Contracts\Container\Resolver\ReflectionMethodResolver`**
__Uses__ `Phalcon\Contracts\Container\Ioc\IocContainer` · `ReflectionMethod`
### Method Summary
### Methods
Public · 1
resolveMethod()
```php
public function resolveMethod(
IocContainer $ioc,
ReflectionMethod $method,
object $instance
): void;
```
## Contracts\Container\Resolver\ReflectionParameterResolver
Interface
Source on GitHub
- **`Phalcon\Contracts\Container\Resolver\ReflectionParameterResolver`**
- [`Phalcon\Contracts\Container\Resolver\ResolverService`](#contractscontainerresolverresolverservice)
__Uses__ `Phalcon\Contracts\Container\Ioc\IocContainer` · `ReflectionParameter`
### Method Summary
### Methods
Public · 1
resolveParameter()
```php
public function resolveParameter(
IocContainer $ioc,
ReflectionParameter $parameter
): mixed;
```
## Contracts\Container\Resolver\Resolvable
Interface
Source on GitHub
- **`Phalcon\Contracts\Container\Resolver\Resolvable`**
__Uses__ `Phalcon\Contracts\Container\Ioc\IocContainer`
### Method Summary
### Methods
Public · 1
resolve()
```php
public function resolve( IocContainer $ioc ): mixed;
```
## Contracts\Container\Resolver\ResolverService
Interface
Source on GitHub
- [`Phalcon\Contracts\Container\Resolver\ReflectionParameterResolver`](#contractscontainerresolverreflectionparameterresolver)
- **`Phalcon\Contracts\Container\Resolver\ResolverService`**
__Uses__ `Phalcon\Contracts\Container\Ioc\IocContainer` · `ReflectionMethod` · `ReflectionParameter` · `ReflectionType`
### Method Summary
### Methods
Public · 6
isResolvableClass()
```php
public function isResolvableClass( string $className ): bool;
```
resolveCall()
```php
public function resolveCall(
IocContainer $ioc,
callable $callableObject,
array $arguments
): mixed;
```
resolveClass()
```php
public function resolveClass(
IocContainer $ioc,
string $className,
array $arguments
): object;
```
resolveMethod()
```php
public function resolveMethod(
IocContainer $ioc,
ReflectionMethod $method,
object $instance
): void;
```
resolveParameters()
```php
public function resolveParameters(
IocContainer $ioc,
array $parameters,
array $arguments
): array;
```
resolveType()
```php
public function resolveType(
IocContainer $ioc,
ReflectionType $type
): mixed;
```
## Contracts\Container\Resolver\ResolverThrowable
Interface
Source on GitHub
- `Throwable`
- **`Phalcon\Contracts\Container\Resolver\ResolverThrowable`**
__Uses__ `Throwable`
## Contracts\Container\Service\Collection
Interface
Source on GitHub
- [`Phalcon\Contracts\Container\Ioc\IocContainer`](#contractscontaineriocioccontainer)
- **`Phalcon\Contracts\Container\Service\Collection`**
__Uses__ `Closure` · `Phalcon\Container\Definition\ServiceDefinition` · `Phalcon\Container\Resolver\Resolver` · `Phalcon\Contracts\Container\Ioc\IocContainer`
### Method Summary
### Methods
Public · 30
bind()
```php
public function bind(
string $interfaceName,
string $concrete
): ServiceDefinition;
```
callableGet()
```php
public function callableGet( string $name ): Closure;
```
callableNew()
```php
public function callableNew( string $name ): Closure;
```
extend()
```php
public function extend(
string $name,
callable $callableObject
): void;
```
get()
```php
public function get( string $name ): mixed;
```
getAlias()
```php
public function getAlias( string $name ): string;
```
getByTag()
```php
public function getByTag( string $tag ): array;
```
getDefinition()
```php
public function getDefinition( string $name ): ServiceDefinition;
```
getInstance()
```php
public function getInstance( string $name ): object;
```
getParameter()
```php
public function getParameter( string $name ): mixed;
```
getResolver()
```php
public function getResolver(): Resolver;
```
has()
```php
public function has( string $name ): bool;
```
hasAlias()
```php
public function hasAlias( string $name ): bool;
```
hasDefinition()
```php
public function hasDefinition( string $name ): bool;
```
hasInstance()
```php
public function hasInstance( string $name ): bool;
```
hasParameter()
```php
public function hasParameter( string $name ): bool;
```
isAutowireEnabled()
```php
public function isAutowireEnabled(): bool;
```
new()
```php
public function new( string $name ): mixed;
```
newDefinition()
```php
public function newDefinition( string $name ): ServiceDefinition;
```
set()
```php
public function set(
string $name,
mixed $definition
): ServiceDefinition;
```
setAlias()
```php
public function setAlias(
string $name,
string $alias
): static;
```
setAutowire()
```php
public function setAutowire( bool $enabled ): static;
```
setDefinition()
```php
public function setDefinition(
string $name,
ServiceDefinition $definition
): static;
```
setInstance()
```php
public function setInstance(
string $name,
object $instance,
string $lifetime
): static;
```
setParameter()
```php
public function setParameter(
string $name,
mixed $value
): static;
```
unsetAlias()
```php
public function unsetAlias( string $name ): void;
```
unsetDefinition()
```php
public function unsetDefinition( string $name ): void;
```
unsetInstance()
```php
public function unsetInstance( string $name ): void;
```
unsetInstances()
```php
public function unsetInstances( string $lifetime ): void;
```
unsetParameter()
```php
public function unsetParameter( string $name ): void;
```
## Contracts\Container\Service\Definition
Interface
Source on GitHub
- **`Phalcon\Contracts\Container\Service\Definition`**
__Uses__ `Phalcon\Contracts\Container\Ioc\IocContainer`
### Method Summary
### Methods
Public · 17
addExtender()
```php
public function addExtender( callable $extender ): static;
```
buildService()
```php
public function buildService( IocContainer $ioc ): object;
```
getClass()
```php
public function getClass(): string;
```
getExtenders()
```php
public function getExtenders(): array;
```
getFactory()
```php
public function getFactory(): callable;
```
getLifetime()
```php
public function getLifetime(): string;
```
getServiceName()
```php
public function getServiceName(): string;
```
hasClass()
```php
public function hasClass(): bool;
```
hasExtenders()
```php
public function hasExtenders(): bool;
```
hasFactory()
```php
public function hasFactory(): bool;
```
setClass()
```php
public function setClass( string $className ): static;
```
setExtenders()
```php
public function setExtenders( array $extenders ): static;
```
setFactory()
```php
public function setFactory( callable $factory ): static;
```
setLifetime()
```php
public function setLifetime( string $lifetime ): static;
```
unsetClass()
```php
public function unsetClass(): static;
```
unsetExtenders()
```php
public function unsetExtenders(): static;
```
unsetFactory()
```php
public function unsetFactory(): static;
```
## Contracts\Container\Service\Provider
Interface
Source on GitHub
- **`Phalcon\Contracts\Container\Service\Provider`**
### Method Summary
### Methods
Public · 1
provide()
```php
public function provide( Collection $services ): void;
```
## Contracts\Container\Service\Throwable
Interface
Source on GitHub
- `PhpThrowable`
- **`Phalcon\Contracts\Container\Service\Throwable`**
__Uses__ `Throwable`
## Contracts\Db\Adapter\Adapter
Interface
Source on GitHub
Canonical contract for Phalcon\Db adapters.
@todo v7 - these will become required interface members. They are
omitted from the v5 line to avoid breaking third-party
implementors:
- addCheck() : bool
- createMaterializedView() : bool
- dropCheck() : bool
- dropMaterializedView() : bool
- onConflictUpdate() : string
- refreshMaterializedView() : bool
- returning() : string
- **`Phalcon\Contracts\Db\Adapter\Adapter`**
- [`Phalcon\Db\Adapter\AdapterInterface`](/5.17/api/phalcon_db/#dbadapteradapterinterface)
__Uses__ `Phalcon\Db\ColumnInterface` · `Phalcon\Db\DialectInterface` · `Phalcon\Db\IndexInterface` · `Phalcon\Db\RawValue` · `Phalcon\Db\ReferenceInterface` · `Phalcon\Db\ResultInterface`
### Method Summary
public
bool
addColumn(string $tableName,string $schemaName,ColumnInterface $column)
Adds a column to a table
public
bool
addForeignKey(string $tableName,string $schemaName,ReferenceInterface $reference)
Adds a foreign key to a table
public
bool
addIndex(string $tableName,string $schemaName,IndexInterface $index)
Adds an index to a table
public
bool
addPrimaryKey(string $tableName,string $schemaName,IndexInterface $index)
Adds a primary key to a table
public
int
affectedRows()
Returns the number of affected rows by the last INSERT/UPDATE/DELETE
public
bool
begin( bool $nesting = true )
Starts a transaction in the connection
public
void
close()
Closes active connection returning success. Phalcon automatically closes
public
bool
commit( bool $nesting = true )
Commits the active transaction in the connection
public
void
connect( array $descriptor = [] )
This method is automatically called in \Phalcon\Db\Adapter\Pdo
public
bool
createSavepoint( string $name )
Creates a new savepoint
public
bool
createTable(string $tableName,string $schemaName,array $definition)
Creates a table
public
bool
createView(string $viewName,array $definition,string $schemaName = null)
Creates a view
public
bool
delete(mixed $table,string $whereCondition = null,array $placeholders = [],array $dataTypes = [])
Deletes data from a table using custom RDBMS SQL syntax
public
ColumnInterface[]
describeColumns(string $table,string $schema = null)
Returns an array of Phalcon\Db\Column objects describing a table
public
IndexInterface[]
describeIndexes(string $table,string $schema = null)
Lists table indexes
public
ReferenceInterface[]
describeReferences(string $table,string $schema = null)
Lists table references
public
bool
dropColumn(string $tableName,string $schemaName,string $columnName)
Drops a column from a table
public
bool
dropForeignKey(string $tableName,string $schemaName,string $referenceName)
Drops a foreign key from a table
public
bool
dropIndex(string $tableName,string $schemaName,string $indexName)
Drop an index from a table
public
bool
dropPrimaryKey(string $tableName,string $schemaName)
Drops primary key from a table
public
bool
dropTable(string $tableName,string $schemaName = null,bool $ifExists = true)
Drops a table from a schema/database
public
bool
dropView(string $viewName,string $schemaName = null,bool $ifExists = true)
Drops a view
public
string
escapeIdentifier( mixed $identifier )
Escapes a column/table/schema name
public
string
escapeString( string $str )
Escapes a value to avoid SQL injections
public
bool
execute(string $sqlStatement,array $bindParams = [],array $bindTypes = [])
Sends SQL statements to the database server returning the success state.
public
array
fetchAll(string $sqlQuery,int $fetchMode = 2,array $bindParams = [],array $bindTypes = [])
Dumps the complete result of a query into an array
public
string|bool
fetchColumn(string $sqlQuery,array $placeholders = [],mixed $column = 0)
Returns the n'th field of first row in a SQL query result
public
array
fetchOne(string $sqlQuery,int $fetchMode = 2,array $bindParams = [],array $bindTypes = [])
Returns the first row in a SQL query result
public
string
forUpdate(string $sqlQuery,string $modifier = "")
Returns a SQL modified with a FOR UPDATE clause. The optional modifier
public
string
getColumnDefinition( ColumnInterface $column )
Returns the SQL column definition from a column
public
string
getColumnList( mixed $columnList )
Gets a list of columns
public
int
getConnectionId()
Gets the active connection unique identifier
public
RawValue
getDefaultIdValue()
Return the default identity value to insert in an identity column
public
RawValue|null
getDefaultValue()
Returns the default value to make the RBDM use the default value declared
public
array
getDescriptor()
Return descriptor used to connect to the active database
public
DialectInterface
getDialect()
Returns internal dialect instance
public
string
getDialectType()
Returns the name of the dialect used
public
mixed
getInternalHandler()
Return internal PDO handler
public
string
getNestedTransactionSavepointName()
Returns the savepoint name to use for nested transactions
public
string
getRealSQLStatement()
Active SQL statement in the object without replace bound parameters
public
array
getSQLBindTypes()
Active SQL statement in the object
public
string
getSQLStatement()
Active SQL statement in the object
public
array
getSQLVariables()
Active SQL statement in the object
public
string
getType()
Returns type of database system the adapter is used for
public
bool
insert(string $table,array $values,mixed $fields = null,mixed $dataTypes = null)
Inserts data into a table using custom RDBMS SQL syntax
public
bool
insertAsDict(string $table,mixed $data,mixed $dataTypes = null)
Inserts data into a table using custom RBDM SQL syntax
public
bool
isNestedTransactionsWithSavepoints()
Returns if nested transactions should use savepoints
public
bool
isUnderTransaction()
Checks whether connection is under database transaction
public
string|bool
lastInsertId( string $name = null )
Returns insert id for the auto_increment column inserted in the last SQL
public
string
limit(string $sqlQuery,mixed $number)
Appends a LIMIT clause to sqlQuery argument
public
array
listTables( string $schemaName = null )
List all tables on a database
public
array
listViews( string $schemaName = null )
List all views on a database
public
bool
modifyColumn(string $tableName,string $schemaName,ColumnInterface $column,ColumnInterface $currentColumn = null)
Modifies a table column based on a definition
public
ResultInterface|bool
query(string $sqlStatement,array $bindParams = [],array $bindTypes = [])
Sends SQL statements to the database server returning the success state.
public
bool
releaseSavepoint( string $name )
Releases given savepoint
public
bool
rollback( bool $nesting = true )
Rollbacks the active transaction in the connection
public
bool
rollbackSavepoint( string $name )
Rollbacks given savepoint
public
\Phalcon\Db\Adapter\AdapterInterface
setNestedTransactionsWithSavepoints( bool $nestedTransactionsWithSavepoints )
Set if nested transactions should use savepoints
public
string
sharedLock(string $sqlQuery,string $modifier = "")
Returns a SQL modified with a shared-lock clause. See the dialect's
public
bool
supportSequences()
Check whether the database system requires a sequence to produce
public
bool
supportsDefaultValue()
SQLite does not support the DEFAULT keyword
public
bool
tableExists(string $tableName,string $schemaName = null)
Generates SQL checking for the existence of a schema.table
public
array
tableOptions(string $tableName,string $schemaName = null)
Gets creation options from a table
public
bool
update(string $table,mixed $fields,mixed $values,mixed $whereCondition = null,mixed $dataTypes = null)
Updates data on a table using custom RDBMS SQL syntax
public
bool
updateAsDict(string $table,mixed $data,mixed $whereCondition = null,mixed $dataTypes = null)
Updates data on a table using custom RBDM SQL syntax
public
bool
useExplicitIdValue()
Check whether the database system requires an explicit value for identity
public
bool
viewExists(string $viewName,string $schemaName = null)
Generates SQL checking for the existence of a schema.view
### Methods
Public · 67
addColumn()
```php
public function addColumn(
string $tableName,
string $schemaName,
ColumnInterface $column
): bool;
```
Adds a column to a table
addForeignKey()
```php
public function addForeignKey(
string $tableName,
string $schemaName,
ReferenceInterface $reference
): bool;
```
Adds a foreign key to a table
addIndex()
```php
public function addIndex(
string $tableName,
string $schemaName,
IndexInterface $index
): bool;
```
Adds an index to a table
addPrimaryKey()
```php
public function addPrimaryKey(
string $tableName,
string $schemaName,
IndexInterface $index
): bool;
```
Adds a primary key to a table
affectedRows()
```php
public function affectedRows(): int;
```
Returns the number of affected rows by the last INSERT/UPDATE/DELETE
reported by the database system
begin()
```php
public function begin( bool $nesting = true ): bool;
```
Starts a transaction in the connection
close()
```php
public function close(): void;
```
Closes active connection returning success. Phalcon automatically closes
and destroys active connections within Phalcon\Db\Pool
commit()
```php
public function commit( bool $nesting = true ): bool;
```
Commits the active transaction in the connection
connect()
```php
public function connect( array $descriptor = [] ): void;
```
This method is automatically called in \Phalcon\Db\Adapter\Pdo
constructor. Call it when you need to restore a database connection
createSavepoint()
```php
public function createSavepoint( string $name ): bool;
```
Creates a new savepoint
createTable()
```php
public function createTable(
string $tableName,
string $schemaName,
array $definition
): bool;
```
Creates a table
createView()
```php
public function createView(
string $viewName,
array $definition,
string $schemaName = null
): bool;
```
Creates a view
delete()
```php
public function delete(
mixed $table,
string $whereCondition = null,
array $placeholders = [],
array $dataTypes = []
): bool;
```
Deletes data from a table using custom RDBMS SQL syntax
describeColumns()
```php
public function describeColumns(
string $table,
string $schema = null
): ColumnInterface[];
```
Returns an array of Phalcon\Db\Column objects describing a table
describeIndexes()
```php
public function describeIndexes(
string $table,
string $schema = null
): IndexInterface[];
```
Lists table indexes
describeReferences()
```php
public function describeReferences(
string $table,
string $schema = null
): ReferenceInterface[];
```
Lists table references
dropColumn()
```php
public function dropColumn(
string $tableName,
string $schemaName,
string $columnName
): bool;
```
Drops a column from a table
dropForeignKey()
```php
public function dropForeignKey(
string $tableName,
string $schemaName,
string $referenceName
): bool;
```
Drops a foreign key from a table
dropIndex()
```php
public function dropIndex(
string $tableName,
string $schemaName,
string $indexName
): bool;
```
Drop an index from a table
dropPrimaryKey()
```php
public function dropPrimaryKey(
string $tableName,
string $schemaName
): bool;
```
Drops primary key from a table
dropTable()
```php
public function dropTable(
string $tableName,
string $schemaName = null,
bool $ifExists = true
): bool;
```
Drops a table from a schema/database
dropView()
```php
public function dropView(
string $viewName,
string $schemaName = null,
bool $ifExists = true
): bool;
```
Drops a view
escapeIdentifier()
```php
public function escapeIdentifier( mixed $identifier ): string;
```
Escapes a column/table/schema name
escapeString()
```php
public function escapeString( string $str ): string;
```
Escapes a value to avoid SQL injections
execute()
```php
public function execute(
string $sqlStatement,
array $bindParams = [],
array $bindTypes = []
): bool;
```
Sends SQL statements to the database server returning the success state.
Use this method only when the SQL statement sent to the server does not
return any rows
fetchAll()
```php
public function fetchAll(
string $sqlQuery,
int $fetchMode = 2,
array $bindParams = [],
array $bindTypes = []
): array;
```
Dumps the complete result of a query into an array
fetchColumn()
```php
public function fetchColumn(
string $sqlQuery,
array $placeholders = [],
mixed $column = 0
): string|bool;
```
Returns the n'th field of first row in a SQL query result
```php
// Getting count of invoices
$invoicesCount = $connection->fetchColumn("SELECT COUNT(*) FROM co_invoices");
print_r($invoicesCount);
// Getting the title of the last created invoice
$invoice = $connection->fetchColumn(
"SELECT inv_id, inv_title FROM co_invoices ORDER BY inv_created_at DESC",
1
);
print_r($invoice);
```
fetchOne()
```php
public function fetchOne(
string $sqlQuery,
int $fetchMode = 2,
array $bindParams = [],
array $bindTypes = []
): array;
```
Returns the first row in a SQL query result
forUpdate()
```php
public function forUpdate(
string $sqlQuery,
string $modifier = ""
): string;
```
Returns a SQL modified with a FOR UPDATE clause. The optional `modifier`
appends a row-lock disposition keyword - pass `Dialect::LOCK_NOWAIT`
or `Dialect::LOCK_SKIP_LOCKED` (or leave as `Dialect::LOCK_NONE`).
getColumnDefinition()
```php
public function getColumnDefinition( ColumnInterface $column ): string;
```
Returns the SQL column definition from a column
getColumnList()
```php
public function getColumnList( mixed $columnList ): string;
```
Gets a list of columns
getConnectionId()
```php
public function getConnectionId(): int;
```
Gets the active connection unique identifier
getDefaultIdValue()
```php
public function getDefaultIdValue(): RawValue;
```
Return the default identity value to insert in an identity column
getDefaultValue()
```php
public function getDefaultValue(): RawValue|null;
```
Returns the default value to make the RBDM use the default value declared
in the table definition
```php
// Inserting a new invoice with a valid default value for the column 'inv_total'
$success = $connection->insert(
"co_invoices",
[
"Test Invoice",
$connection->getDefaultValue()
],
[
"inv_title",
"inv_total",
]
);
```
@todo Return NULL if this is not supported by the adapter
getDescriptor()
```php
public function getDescriptor(): array;
```
Return descriptor used to connect to the active database
getDialect()
```php
public function getDialect(): DialectInterface;
```
Returns internal dialect instance
getDialectType()
```php
public function getDialectType(): string;
```
Returns the name of the dialect used
getInternalHandler()
```php
public function getInternalHandler(): mixed;
```
Return internal PDO handler
getNestedTransactionSavepointName()
```php
public function getNestedTransactionSavepointName(): string;
```
Returns the savepoint name to use for nested transactions
getRealSQLStatement()
```php
public function getRealSQLStatement(): string;
```
Active SQL statement in the object without replace bound parameters
getSQLBindTypes()
```php
public function getSQLBindTypes(): array;
```
Active SQL statement in the object
getSQLStatement()
```php
public function getSQLStatement(): string;
```
Active SQL statement in the object
getSQLVariables()
```php
public function getSQLVariables(): array;
```
Active SQL statement in the object
getType()
```php
public function getType(): string;
```
Returns type of database system the adapter is used for
insert()
```php
public function insert(
string $table,
array $values,
mixed $fields = null,
mixed $dataTypes = null
): bool;
```
Inserts data into a table using custom RDBMS SQL syntax
insertAsDict()
```php
public function insertAsDict(
string $table,
mixed $data,
mixed $dataTypes = null
): bool;
```
Inserts data into a table using custom RBDM SQL syntax
```php
// Inserting a new invoice
$success = $connection->insertAsDict(
"co_invoices",
[
"inv_title" => "Test Invoice",
"inv_total" => 100,
]
);
// Next SQL sentence is sent to the database system
INSERT INTO `co_invoices` (`inv_title`, `inv_total`) VALUES ("Test Invoice", 100);
```
isNestedTransactionsWithSavepoints()
```php
public function isNestedTransactionsWithSavepoints(): bool;
```
Returns if nested transactions should use savepoints
isUnderTransaction()
```php
public function isUnderTransaction(): bool;
```
Checks whether connection is under database transaction
lastInsertId()
```php
public function lastInsertId( string $name = null ): string|bool;
```
Returns insert id for the auto_increment column inserted in the last SQL
statement
limit()
```php
public function limit(
string $sqlQuery,
mixed $number
): string;
```
Appends a LIMIT clause to sqlQuery argument
listTables()
```php
public function listTables( string $schemaName = null ): array;
```
List all tables on a database
listViews()
```php
public function listViews( string $schemaName = null ): array;
```
List all views on a database
modifyColumn()
```php
public function modifyColumn(
string $tableName,
string $schemaName,
ColumnInterface $column,
ColumnInterface $currentColumn = null
): bool;
```
Modifies a table column based on a definition
query()
```php
public function query(
string $sqlStatement,
array $bindParams = [],
array $bindTypes = []
): ResultInterface|bool;
```
Sends SQL statements to the database server returning the success state.
Use this method only when the SQL statement sent to the server returns
rows
releaseSavepoint()
```php
public function releaseSavepoint( string $name ): bool;
```
Releases given savepoint
rollback()
```php
public function rollback( bool $nesting = true ): bool;
```
Rollbacks the active transaction in the connection
rollbackSavepoint()
```php
public function rollbackSavepoint( string $name ): bool;
```
Rollbacks given savepoint
setNestedTransactionsWithSavepoints()
```php
public function setNestedTransactionsWithSavepoints( bool $nestedTransactionsWithSavepoints ): \Phalcon\Db\Adapter\AdapterInterface;
```
Set if nested transactions should use savepoints
sharedLock()
```php
public function sharedLock(
string $sqlQuery,
string $modifier = ""
): string;
```
Returns a SQL modified with a shared-lock clause. See the dialect's
`sharedLock()` for per-engine semantics. The optional `modifier` is
passed straight through (use `Dialect::LOCK_NOWAIT` /
`Dialect::LOCK_SKIP_LOCKED` for PostgreSQL).
supportSequences()
```php
public function supportSequences(): bool;
```
Check whether the database system requires a sequence to produce
auto-numeric values
supportsDefaultValue()
```php
public function supportsDefaultValue(): bool;
```
SQLite does not support the DEFAULT keyword
tableExists()
```php
public function tableExists(
string $tableName,
string $schemaName = null
): bool;
```
Generates SQL checking for the existence of a schema.table
tableOptions()
```php
public function tableOptions(
string $tableName,
string $schemaName = null
): array;
```
Gets creation options from a table
update()
```php
public function update(
string $table,
mixed $fields,
mixed $values,
mixed $whereCondition = null,
mixed $dataTypes = null
): bool;
```
Updates data on a table using custom RDBMS SQL syntax
updateAsDict()
```php
public function updateAsDict(
string $table,
mixed $data,
mixed $whereCondition = null,
mixed $dataTypes = null
): bool;
```
Updates data on a table using custom RBDM SQL syntax
Another, more convenient syntax
```php
// Updating existing invoice
$success = $connection->updateAsDict(
"co_invoices",
[
"inv_title" => "New Test Invoice",
],
"inv_id = 101"
);
// Next SQL sentence is sent to the database system
UPDATE `co_invoices` SET `inv_title` = "New Test Invoice" WHERE inv_id = 101
```
useExplicitIdValue()
```php
public function useExplicitIdValue(): bool;
```
Check whether the database system requires an explicit value for identity
columns
viewExists()
```php
public function viewExists(
string $viewName,
string $schemaName = null
): bool;
```
Generates SQL checking for the existence of a schema.view
## Contracts\Db\Check
Interface
Source on GitHub
Canonical contract for Phalcon\Db\Check.
- **`Phalcon\Contracts\Db\Check`**
- [`Phalcon\Db\CheckInterface`](/5.17/api/phalcon_db/#dbcheckinterface)
### Method Summary
### Methods
Public · 2
getExpression()
```php
public function getExpression(): string;
```
Gets the CHECK expression (the SQL boolean predicate).
getName()
```php
public function getName(): string;
```
Gets the constraint name. An empty string indicates an unnamed CHECK
constraint - the dialect will emit the clause without a `CONSTRAINT`
prefix in that case.
## Contracts\Db\Column
Interface
Source on GitHub
Canonical contract for Phalcon\Db\Column.
@todo v7 - these will become required interface members. They are
omitted from the v5 line to avoid breaking third-party
implementors:
- getGenerationExpression() : string | null
- isArray() : bool
- isGenerated() : bool
- isGenerationStored() : bool
- isInvisible() : bool
- **`Phalcon\Contracts\Db\Column`**
- [`Phalcon\Db\ColumnInterface`](/5.17/api/phalcon_db/#dbcolumninterface)
### Method Summary
### Methods
Public · 16
getAfterPosition()
```php
public function getAfterPosition(): string|null;
```
Check whether field absolute to position in table
getBindType()
```php
public function getBindType(): int;
```
Returns the type of bind handling
getDefault()
```php
public function getDefault(): mixed;
```
Returns default value of column
getName()
```php
public function getName(): string;
```
Returns column name
getScale()
```php
public function getScale(): int;
```
Returns column scale
getSize()
```php
public function getSize(): int|string;
```
Returns column size
getType()
```php
public function getType(): int|string;
```
Returns column type
getTypeReference()
```php
public function getTypeReference(): int;
```
Returns column type reference
getTypeValues()
```php
public function getTypeValues(): array|string|int;
```
Returns column type values
hasDefault()
```php
public function hasDefault(): bool;
```
Check whether column has default value
isAutoIncrement()
```php
public function isAutoIncrement(): bool;
```
Auto-Increment
isFirst()
```php
public function isFirst(): bool;
```
Check whether column have first position in table
isNotNull()
```php
public function isNotNull(): bool;
```
Not null
isNumeric()
```php
public function isNumeric(): bool;
```
Check whether column have an numeric type
isPrimary()
```php
public function isPrimary(): bool;
```
Column is part of the primary key?
isUnsigned()
```php
public function isUnsigned(): bool;
```
Returns true if number column is unsigned
## Contracts\Db\Dialect
Interface
Source on GitHub
Canonical contract for Phalcon\Db dialects.
@todo v7 - these will become required interface members. They are
omitted from the v5 line to avoid breaking third-party
implementors:
- addCheck() : string
- createMaterializedView() : string
- dropCheck() : string
- dropMaterializedView() : string
- onConflictUpdate() : string
- refreshMaterializedView() : string
- returning() : string
- **`Phalcon\Contracts\Db\Dialect`**
- [`Phalcon\Db\DialectInterface`](/5.17/api/phalcon_db/#dbdialectinterface)
__Uses__ `Phalcon\Db\ColumnInterface` · `Phalcon\Db\IndexInterface` · `Phalcon\Db\ReferenceInterface`
### Method Summary
public
string
addColumn(string $tableName,string $schemaName,ColumnInterface $column)
Generates SQL to add a column to a table
public
string
addForeignKey(string $tableName,string $schemaName,ReferenceInterface $reference)
Generates SQL to add an index to a table
public
string
addIndex(string $tableName,string $schemaName,IndexInterface $index)
Generates SQL to add an index to a table
public
string
addPrimaryKey(string $tableName,string $schemaName,IndexInterface $index)
Generates SQL to add the primary key to a table
public
string
createSavepoint( string $name )
Generate SQL to create a new savepoint
public
string
createTable(string $tableName,string $schemaName,array $definition)
Generates SQL to create a table
public
string
createView(string $viewName,array $definition,string $schemaName = null)
Generates SQL to create a view
public
string
describeColumns(string $table,string $schema = null)
Generates SQL to describe a table
public
string
describeIndexes(string $table,string $schema = null)
Generates SQL to query indexes on a table.
public
string
describeReferences(string $table,string $schema = null)
Generates SQL to query foreign keys on a table.
public
string
dropColumn(string $tableName,string $schemaName,string $columnName)
Generates SQL to delete a column from a table
public
string
dropForeignKey(string $tableName,string $schemaName,string $referenceName)
Generates SQL to delete a foreign key from a table
public
string
dropIndex(string $tableName,string $schemaName,string $indexName)
Generates SQL to delete an index from a table
public
string
dropPrimaryKey(string $tableName,string $schemaName)
Generates SQL to delete primary key from a table
public
string
dropTable(string $tableName,string $schemaName,bool $ifExists = true)
Generates SQL to drop a table
public
string
dropView(string $viewName,string $schemaName = null,bool $ifExists = true)
Generates SQL to drop a view
public
string
forUpdate(string $sqlQuery,string $modifier = "")
Returns a SQL modified with a FOR UPDATE clause. The optional modifier
public
string
getColumnDefinition( ColumnInterface $column )
Gets the column name in RDBMS
public
string
getColumnList( array $columnList )
Gets a list of columns
public
array
getCustomFunctions()
Returns registered functions
public
string
getSqlExpression(array $expression,string $escapeChar = null,array $bindCounts = [])
Transforms an intermediate representation for an expression into a
public
string
limit(string $sqlQuery,mixed $number)
Generates the SQL for LIMIT clause
public
string
listTables( string $schemaName = null )
List all tables in database
public
string
modifyColumn(string $tableName,string $schemaName,ColumnInterface $column,ColumnInterface $currentColumn = null)
Generates SQL to modify a column in a table
public
\Phalcon\Db\Dialect
registerCustomFunction(string $name,callable $customFunction)
Registers custom SQL functions
public
string
releaseSavepoint( string $name )
Generate SQL to release a savepoint
public
string
rollbackSavepoint( string $name )
Generate SQL to rollback a savepoint
public
string
select( array $definition )
Builds a SELECT statement
public
string
sharedLock(string $sqlQuery,string $modifier = "")
Returns a SQL modified with a shared-lock clause. MySQL emits
public
bool
supportsReleaseSavepoints()
Checks whether the platform supports releasing savepoints.
public
bool
supportsSavepoints()
Checks whether the platform supports savepoints
public
string
tableExists(string $tableName,string $schemaName = null)
Generates SQL checking for the existence of a schema.table
public
string
tableOptions(string $table,string $schema = null)
Generates the SQL to describe the table creation options
public
string
viewExists(string $viewName,string $schemaName = null)
Generates SQL checking for the existence of a schema.view
### Constants
string
LOCK_NONE = ""
No row-lock modifier - the default behavior for forUpdate().
string
LOCK_NOWAIT = "NOWAIT"
Append NOWAIT to the FOR UPDATE clause - the query fails immediately if a row it needs is locked instead of blocking. MySQL 8.0+ and PostgreSQL 9.5+ recognize this. SQLite has no row-level locking and silently ignores the modifier.
string
LOCK_SKIP_LOCKED = "SKIP LOCKED"
Append SKIP LOCKED to the FOR UPDATE clause - the query returns rows that are not currently locked and silently skips ones that are. MySQL 8.0+ and PostgreSQL 9.5+ recognize this. SQLite ignores it.
### Methods
Public · 34
addColumn()
```php
public function addColumn(
string $tableName,
string $schemaName,
ColumnInterface $column
): string;
```
Generates SQL to add a column to a table
addForeignKey()
```php
public function addForeignKey(
string $tableName,
string $schemaName,
ReferenceInterface $reference
): string;
```
Generates SQL to add an index to a table
addIndex()
```php
public function addIndex(
string $tableName,
string $schemaName,
IndexInterface $index
): string;
```
Generates SQL to add an index to a table
addPrimaryKey()
```php
public function addPrimaryKey(
string $tableName,
string $schemaName,
IndexInterface $index
): string;
```
Generates SQL to add the primary key to a table
createSavepoint()
```php
public function createSavepoint( string $name ): string;
```
Generate SQL to create a new savepoint
createTable()
```php
public function createTable(
string $tableName,
string $schemaName,
array $definition
): string;
```
Generates SQL to create a table
createView()
```php
public function createView(
string $viewName,
array $definition,
string $schemaName = null
): string;
```
Generates SQL to create a view
describeColumns()
```php
public function describeColumns(
string $table,
string $schema = null
): string;
```
Generates SQL to describe a table
describeIndexes()
```php
public function describeIndexes(
string $table,
string $schema = null
): string;
```
Generates SQL to query indexes on a table.
The base adapter consumes the result as `FETCH_NUM` rows by position:
column index 2 must be the index key name and column index 4 the indexed
column name.
describeReferences()
```php
public function describeReferences(
string $table,
string $schema = null
): string;
```
Generates SQL to query foreign keys on a table.
The base adapter consumes the result as `FETCH_NUM` rows by position:
index 1 the local column, index 2 the constraint name, index 3 the
referenced schema, index 4 the referenced table, and index 5 the
referenced column.
dropColumn()
```php
public function dropColumn(
string $tableName,
string $schemaName,
string $columnName
): string;
```
Generates SQL to delete a column from a table
dropForeignKey()
```php
public function dropForeignKey(
string $tableName,
string $schemaName,
string $referenceName
): string;
```
Generates SQL to delete a foreign key from a table
dropIndex()
```php
public function dropIndex(
string $tableName,
string $schemaName,
string $indexName
): string;
```
Generates SQL to delete an index from a table
dropPrimaryKey()
```php
public function dropPrimaryKey(
string $tableName,
string $schemaName
): string;
```
Generates SQL to delete primary key from a table
dropTable()
```php
public function dropTable(
string $tableName,
string $schemaName,
bool $ifExists = true
): string;
```
Generates SQL to drop a table
dropView()
```php
public function dropView(
string $viewName,
string $schemaName = null,
bool $ifExists = true
): string;
```
Generates SQL to drop a view
forUpdate()
```php
public function forUpdate(
string $sqlQuery,
string $modifier = ""
): string;
```
Returns a SQL modified with a FOR UPDATE clause. The optional `modifier`
appends a row-lock disposition keyword - pass `Dialect::LOCK_NOWAIT`
or `Dialect::LOCK_SKIP_LOCKED` (or leave as `Dialect::LOCK_NONE`).
getColumnDefinition()
```php
public function getColumnDefinition( ColumnInterface $column ): string;
```
Gets the column name in RDBMS
getColumnList()
```php
public function getColumnList( array $columnList ): string;
```
Gets a list of columns
getCustomFunctions()
```php
public function getCustomFunctions(): array;
```
Returns registered functions
getSqlExpression()
```php
public function getSqlExpression(
array $expression,
string $escapeChar = null,
array $bindCounts = []
): string;
```
Transforms an intermediate representation for an expression into a
database system valid expression
limit()
```php
public function limit(
string $sqlQuery,
mixed $number
): string;
```
Generates the SQL for LIMIT clause
listTables()
```php
public function listTables( string $schemaName = null ): string;
```
List all tables in database
modifyColumn()
```php
public function modifyColumn(
string $tableName,
string $schemaName,
ColumnInterface $column,
ColumnInterface $currentColumn = null
): string;
```
Generates SQL to modify a column in a table
registerCustomFunction()
```php
public function registerCustomFunction(
string $name,
callable $customFunction
): \Phalcon\Db\Dialect;
```
Registers custom SQL functions
releaseSavepoint()
```php
public function releaseSavepoint( string $name ): string;
```
Generate SQL to release a savepoint
rollbackSavepoint()
```php
public function rollbackSavepoint( string $name ): string;
```
Generate SQL to rollback a savepoint
select()
```php
public function select( array $definition ): string;
```
Builds a SELECT statement
sharedLock()
```php
public function sharedLock(
string $sqlQuery,
string $modifier = ""
): string;
```
Returns a SQL modified with a shared-lock clause. MySQL emits
`LOCK IN SHARE MODE`; PostgreSQL emits `FOR SHARE`; SQLite returns the
original query unchanged. The optional `modifier` appends a row-lock
disposition keyword (`Dialect::LOCK_NOWAIT` / `Dialect::LOCK_SKIP_LOCKED`)
for PostgreSQL - MySQL's legacy `LOCK IN SHARE MODE` does not support
modifiers, so non-empty values are silently ignored on MySQL.
supportsReleaseSavepoints()
```php
public function supportsReleaseSavepoints(): bool;
```
Checks whether the platform supports releasing savepoints.
supportsSavepoints()
```php
public function supportsSavepoints(): bool;
```
Checks whether the platform supports savepoints
tableExists()
```php
public function tableExists(
string $tableName,
string $schemaName = null
): string;
```
Generates SQL checking for the existence of a schema.table
tableOptions()
```php
public function tableOptions(
string $table,
string $schema = null
): string;
```
Generates the SQL to describe the table creation options
viewExists()
```php
public function viewExists(
string $viewName,
string $schemaName = null
): string;
```
Generates SQL checking for the existence of a schema.view
## Contracts\Db\Geometry\Geometry
Interface
Source on GitHub
Canonical contract for Phalcon\Db\Geometry value objects.
- **`Phalcon\Contracts\Db\Geometry\Geometry`**
- [`Phalcon\Db\Geometry\GeometryInterface`](/5.17/api/phalcon_db/#dbgeometrygeometryinterface)
### Method Summary
### Methods
Public · 3
getSrid()
```php
public function getSrid(): int;
```
Gets the Spatial Reference System Identifier (SRID).
getType()
```php
public function getType(): int;
```
Gets the geometry type.
toWkt()
```php
public function toWkt(): string;
```
Renders the geometry as a Well-Known Text (WKT) string.
## Contracts\Db\Index
Interface
Source on GitHub
Canonical contract for Phalcon\Db\Index.
@todo v7 - these will become required interface members. They are
omitted from the v5 line to avoid breaking third-party
implementors:
- getDirections() : array
- getWhere() : string
- isConcurrent() : bool
- isInvisible() : bool
- **`Phalcon\Contracts\Db\Index`**
- [`Phalcon\Db\IndexInterface`](/5.17/api/phalcon_db/#dbindexinterface)
### Method Summary
### Methods
Public · 3
getColumns()
```php
public function getColumns(): array;
```
Gets the columns that corresponds the index
getName()
```php
public function getName(): string;
```
Gets the index name
getType()
```php
public function getType(): string;
```
Gets the index type
## Contracts\Db\Reference
Interface
Source on GitHub
Canonical contract for Phalcon\Db\Reference.
- **`Phalcon\Contracts\Db\Reference`**
- [`Phalcon\Db\ReferenceInterface`](/5.17/api/phalcon_db/#dbreferenceinterface)
### Method Summary
### Methods
Public · 8
getColumns()
```php
public function getColumns(): array;
```
Gets local columns which reference is based
getName()
```php
public function getName(): string;
```
Gets the index name
getOnDelete()
```php
public function getOnDelete(): string|null;
```
Gets the referenced on delete
getOnUpdate()
```php
public function getOnUpdate(): string|null;
```
Gets the referenced on update
getReferencedColumns()
```php
public function getReferencedColumns(): array;
```
Gets referenced columns
getReferencedSchema()
```php
public function getReferencedSchema(): string|null;
```
Gets the schema where referenced table is
getReferencedTable()
```php
public function getReferencedTable(): string;
```
Gets the referenced table
getSchemaName()
```php
public function getSchemaName(): string|null;
```
Gets the schema where referenced table is
## Contracts\Db\Result
Interface
Source on GitHub
Canonical contract for Phalcon\Db result objects.
- **`Phalcon\Contracts\Db\Result`**
- [`Phalcon\Db\ResultInterface`](/5.17/api/phalcon_db/#dbresultinterface)
### Method Summary
### Methods
Public · 8
dataSeek()
```php
public function dataSeek( int $number );
```
Moves internal resultset cursor to another position letting us to fetch a
certain row
execute()
```php
public function execute(): bool;
```
Allows to execute the statement again. Some database systems don't
support scrollable cursors. So, as cursors are forward only, we need to
execute the cursor again to fetch rows from the beginning
fetch()
```php
public function fetch(): mixed;
```
Fetches an array/object of strings that corresponds to the fetched row,
or FALSE if there are no more rows. This method is affected by the active
fetch flag set using `Phalcon\Db\Result\Pdo::setFetchMode()`
fetchAll()
```php
public function fetchAll(): array;
```
Returns an array of arrays containing all the records in the result. This
method is affected by the active fetch flag set using
`Phalcon\Db\Result\Pdo::setFetchMode()`
fetchArray()
```php
public function fetchArray(): mixed;
```
Returns an array of strings that corresponds to the fetched row, or FALSE
if there are no more rows. This method is affected by the active fetch
flag set using `Phalcon\Db\Result\Pdo::setFetchMode()`
getInternalResult()
```php
public function getInternalResult(): \PDOStatement;
```
Gets the internal PDO result object
numRows()
```php
public function numRows(): int;
```
Gets number of rows returned by a resultset
setFetchMode()
```php
public function setFetchMode( int $fetchMode ): bool;
```
Changes the fetching mode affecting Phalcon\Db\Result\Pdo::fetch()
## Contracts\Dispatcher\Dispatcher
Interface
Source on GitHub
Canonical contract for Phalcon\Dispatcher\AbstractDispatcher.
Note: The deprecated `getParam()`/`getParams()`/`hasParam()`/`setParam()`/
`setParams()` spellings are still declared for backwards compatibility and
are scheduled to be removed in the next major version in favor of their
`*Parameter` counterparts.
- **`Phalcon\Contracts\Dispatcher\Dispatcher`**
- [`Phalcon\Contracts\Cli\Dispatcher`](#contractsclidispatcher)
- [`Phalcon\Contracts\Mvc\Dispatcher`](#contractsmvcdispatcher)
- [`Phalcon\Dispatcher\DispatcherInterface`](/5.17/api/phalcon_dispatcher/#dispatcherdispatcherinterface)
### Method Summary
### Methods
Public · 21
dispatch()
```php
public function dispatch(): mixed|bool;
```
Dispatches a handle action taking into account the routing parameters
forward()
```php
public function forward( array $forward ): void;
```
Forwards the execution flow to another controller/action
getActionName()
```php
public function getActionName(): string;
```
Gets last dispatched action name
getActionSuffix()
```php
public function getActionSuffix(): string;
```
Gets the default action suffix
getHandlerSuffix()
```php
public function getHandlerSuffix(): string;
```
Gets the default handler suffix
getParam()
```php
public function getParam(
mixed $param,
mixed $filters = null
): mixed;
```
Gets a param by its name or numeric index
Note: This signature omits the `defaultValue` argument the implementation
accepts; the two will be aligned in the next major version.
getParameter()
```php
public function getParameter(
mixed $param,
mixed $filters = null
): mixed;
```
Gets a param by its name or numeric index
getParameters()
```php
public function getParameters(): array;
```
Gets action params
getParams()
```php
public function getParams(): array;
```
Gets action params
getReturnedValue()
```php
public function getReturnedValue(): mixed;
```
Returns value returned by the latest dispatched action
hasParam()
```php
public function hasParam( mixed $param ): bool;
```
Check if a param exists
isFinished()
```php
public function isFinished(): bool;
```
Checks if the dispatch loop is finished or has more pendent
controllers/tasks to dispatch
setActionName()
```php
public function setActionName( string $actionName ): void;
```
Sets the action name to be dispatched
setActionSuffix()
```php
public function setActionSuffix( string $actionSuffix ): void;
```
Sets the default action suffix
setDefaultAction()
```php
public function setDefaultAction( string $actionName ): void;
```
Sets the default action name
setDefaultNamespace()
```php
public function setDefaultNamespace( string $defaultNamespace ): void;
```
Sets the default namespace
setHandlerSuffix()
```php
public function setHandlerSuffix( string $handlerSuffix ): void;
```
Sets the default suffix for the handler
setModuleName()
```php
public function setModuleName( string $moduleName = null ): void;
```
Sets the module name which the application belongs to
setNamespaceName()
```php
public function setNamespaceName( string $namespaceName ): void;
```
Sets the namespace which the controller belongs to
setParam()
```php
public function setParam(
mixed $param,
mixed $value
): void;
```
Set a param by its name or numeric index
setParams()
```php
public function setParams( array $params ): void;
```
Sets action params to be dispatched
## Contracts\Domain\Payload\Payload
Interface
Source on GitHub
Canonical combined read/write contract for a domain payload.
`Payload` extends both `Writeable` and `Readable`, exposing the full
capability set. The intended convention narrows that surface by which side of
the Action-Domain-Responder boundary holds the payload: the domain layer
builds the payload through `Writeable` (the setters), while the responder
consumes the finished payload through `Readable` (the getters). Type-hinting
against the narrower contract at each boundary keeps each side to the
capability it needs, even though the concrete payload implements both.
@see Readable
@see Writeable
- [`Phalcon\Contracts\Domain\Payload\Readable`](#contractsdomainpayloadreadable)
- **`Phalcon\Contracts\Domain\Payload\Payload`** - extends [`Phalcon\Contracts\Domain\Payload\Readable`](#contractsdomainpayloadreadable), [`Phalcon\Contracts\Domain\Payload\Writeable`](#contractsdomainpayloadwriteable)
## Contracts\Domain\Payload\Readable
Interface
Source on GitHub
Canonical read-only contract for a domain payload.
Responders consume a finished payload through this contract (the getters),
narrowing the surface to the read side of the Action-Domain-Responder
boundary.
- **`Phalcon\Contracts\Domain\Payload\Readable`**
- [`Phalcon\Contracts\Domain\Payload\Payload`](#contractsdomainpayloadpayload)
- [`Phalcon\Domain\Payload\ReadableInterface`](/5.17/api/phalcon_domain/#domainpayloadreadableinterface)
__Uses__ `Throwable`
### Method Summary
### Methods
Public · 6
getException()
```php
public function getException(): Throwable|null;
```
Gets the potential exception thrown in the domain layer
getExtras()
```php
public function getExtras(): mixed;
```
Gets arbitrary extra values produced by the domain layer.
getInput()
```php
public function getInput(): mixed;
```
Gets the input received by the domain layer.
getMessages()
```php
public function getMessages(): mixed;
```
Gets the messages produced by the domain layer.
getOutput()
```php
public function getOutput(): mixed;
```
Gets the output produced from the domain layer.
getStatus()
```php
public function getStatus(): mixed;
```
Gets the status of this payload.
Status values are drawn from the `Status` vocabulary.
@see \Phalcon\Domain\Payload\Status
## Contracts\Domain\Payload\Writeable
Interface
Source on GitHub
Canonical write-only contract for a domain payload.
The domain layer builds a payload through this contract (the setters),
narrowing the surface to the write side of the Action-Domain-Responder
boundary.
- **`Phalcon\Contracts\Domain\Payload\Writeable`**
- [`Phalcon\Domain\Payload\WriteableInterface`](/5.17/api/phalcon_domain/#domainpayloadwriteableinterface)
__Uses__ `Throwable`
### Method Summary
### Methods
Public · 6
setException()
```php
public function setException( Throwable $exception ): Payload;
```
Sets an exception produced by the domain layer.
setExtras()
```php
public function setExtras( mixed $extras ): Payload;
```
Sets arbitrary extra values produced by the domain layer.
setInput()
```php
public function setInput( mixed $input ): Payload;
```
Sets the input received by the domain layer.
setMessages()
```php
public function setMessages( mixed $messages ): Payload;
```
Sets the messages produced by the domain layer.
setOutput()
```php
public function setOutput( mixed $output ): Payload;
```
Sets the output produced from the domain layer.
setStatus()
```php
public function setStatus( mixed $status ): Payload;
```
Sets the status of this payload.
Status values are drawn from the `Status` vocabulary.
@see \Phalcon\Domain\Payload\Status
## Contracts\Encryption\Crypt\Crypt
Interface
Source on GitHub
Canonical contract for Phalcon\Encryption\Crypt.
The encrypted payload produced by `encrypt()` uses the wire format:
iv ‖ hmac ‖ ciphertext ‖ tag
where `hmac` is present only when signing is enabled (`useSigning(true)`,
the default) and `tag` is present only for AEAD ciphers (`gcm`/`ccm`).
The AEAD parameters (`authData`, `authTag`, `authTagLength`) are instance
state set through the relevant setters and shared across every
`encrypt()`/`decrypt()` call on the instance. A `Crypt` service shared
through the DI container is therefore not safe for interleaved AEAD
operations.
- **`Phalcon\Contracts\Encryption\Crypt\Crypt`**
- [`Phalcon\Encryption\Crypt\CryptInterface`](/5.17/api/phalcon_encryption/#encryptioncryptcryptinterface)
### Method Summary
### Methods
Public · 17
decrypt()
```php
public function decrypt(
string $input,
string $key = null
): string;
```
Decrypts a text
decryptBase64()
```php
public function decryptBase64(
string $input,
string $key = null
): string;
```
Decrypt a text that is coded as a base64 string
encrypt()
```php
public function encrypt(
string $input,
string $key = null
): string;
```
Encrypts a text
encryptBase64()
```php
public function encryptBase64(
string $input,
string $key = null
): string;
```
Encrypts a text returning the result as a base64 string
getAuthData()
```php
public function getAuthData(): string;
```
Returns authentication data
getAuthTag()
```php
public function getAuthTag(): string;
```
Returns the authentication tag
getAuthTagLength()
```php
public function getAuthTagLength(): int;
```
Returns the authentication tag length
getAvailableCiphers()
```php
public function getAvailableCiphers(): array;
```
Returns a list of available cyphers
getCipher()
```php
public function getCipher(): string;
```
Returns the current cipher
getKey()
```php
public function getKey(): string;
```
Returns the encryption key
setAuthData()
```php
public function setAuthData( string $data ): Crypt;
```
Sets authentication data
setAuthTag()
```php
public function setAuthTag( string $tag ): Crypt;
```
Sets the authentication tag
setAuthTagLength()
```php
public function setAuthTagLength( int $length ): Crypt;
```
Sets the authentication tag length
setCipher()
```php
public function setCipher( string $cipher ): Crypt;
```
Sets the cipher algorithm
setKey()
```php
public function setKey( string $key ): Crypt;
```
Sets the encryption key
setPadding()
```php
public function setPadding( int $scheme ): Crypt;
```
Changes the padding scheme used.
useSigning()
```php
public function useSigning( bool $useSigning ): Crypt;
```
Sets if the calculating message digest must be used.
## Contracts\Encryption\Crypt\Padding\Pad
Interface
Source on GitHub
Canonical contract for Phalcon\Encryption\Crypt\Padding strategies.
The pad/unpad protocol operates on binary (8-bit) data. Implementations
must measure and slice the input with byte-true functions (`strlen`,
`substr`, or the `mb_*` family with the explicit `"8bit"` encoding); using
encoding-sensitive functions such as `mb_strlen()` on the padded plaintext
yields the wrong padding size whenever the bytes form valid multibyte
sequences.
- **`Phalcon\Contracts\Encryption\Crypt\Padding\Pad`**
- [`Phalcon\Encryption\Crypt\Padding\PadInterface`](/5.17/api/phalcon_encryption/#encryptioncryptpaddingpadinterface)
### Method Summary
### Methods
Public · 2
pad()
```php
public function pad( int $paddingSize ): string;
```
unpad()
```php
public function unpad(
string $input,
int $blockSize
): int;
```
## Contracts\Encryption\Security\CryptoUtils
Interface
Source on GitHub
- **`Phalcon\Contracts\Encryption\Security\CryptoUtils`**
- [`Phalcon\Contracts\Encryption\Security\Security`](#contractsencryptionsecuritysecurity)
__Uses__ `Phalcon\Encryption\Security\Random`
### Method Summary
### Methods
Public · 5
computeHmac()
```php
public function computeHmac(
string $data,
string $key,
string $algorithm,
bool $raw = false
): string;
```
getRandom()
```php
public function getRandom(): Random;
```
getRandomBytes()
```php
public function getRandomBytes(): int;
```
getSaltBytes()
```php
public function getSaltBytes( int $numberBytes = 0 ): string;
```
setRandomBytes()
```php
public function setRandomBytes( int $randomBytes ): Security;
```
## Contracts\Encryption\Security\CsrfProtection
Interface
Source on GitHub
- **`Phalcon\Contracts\Encryption\Security\CsrfProtection`**
### Method Summary
### Methods
Public · 6
checkToken()
```php
public function checkToken(
string $tokenKey = null,
mixed $tokenValue = null,
bool $destroyIfValid = true
): bool;
```
destroyToken()
```php
public function destroyToken(): Security;
```
getRequestToken()
```php
public function getRequestToken(): string|null;
```
getSessionToken()
```php
public function getSessionToken(): string|null;
```
getToken()
```php
public function getToken(): string|null;
```
getTokenKey()
```php
public function getTokenKey(): string|null;
```
## Contracts\Encryption\Security\JWT\Signer\Signer
Interface
Source on GitHub
Canonical contract for JWT Signer classes
- **`Phalcon\Contracts\Encryption\Security\JWT\Signer\Signer`**
- [`Phalcon\Encryption\Security\JWT\Signer\SignerInterface`](/5.17/api/phalcon_encryption/#encryptionsecurityjwtsignersignerinterface)
### Method Summary
### Methods
Public · 4
```php
public function getAlgHeader(): string;
```
Return the value that is used for the "alg" header
getAlgorithm()
```php
public function getAlgorithm(): string;
```
Return the algorithm used
sign()
```php
public function sign(
string $payload,
string $passphrase
): string;
```
Sign a payload using the passphrase
verify()
```php
public function verify(
string $source,
string $payload,
string $passphrase
): bool;
```
Verify a passed source with a payload and passphrase
## Contracts\Encryption\Security\PasswordSecurity
Interface
Source on GitHub
- **`Phalcon\Contracts\Encryption\Security\PasswordSecurity`**
### Method Summary
### Methods
Public · 8
checkHash()
```php
public function checkHash(
string $password,
string $passwordHash,
int $maxPassLength = 0
): bool;
```
getDefaultHash()
```php
public function getDefaultHash(): int;
```
```php
public function getHashInformation( string $hash ): array;
```
getWorkFactor()
```php
public function getWorkFactor(): int;
```
hash()
```php
public function hash(
string $password,
array $options = []
): string;
```
isLegacyHash()
```php
public function isLegacyHash( string $passwordHash ): bool;
```
setDefaultHash()
```php
public function setDefaultHash( int $defaultHash ): Security;
```
setWorkFactor()
```php
public function setWorkFactor( int $workFactor ): Security;
```
## Contracts\Encryption\Security\Security
Interface
Source on GitHub
- [`Phalcon\Contracts\Encryption\Security\CryptoUtils`](#contractsencryptionsecuritycryptoutils)
- **`Phalcon\Contracts\Encryption\Security\Security`** - extends [`Phalcon\Contracts\Encryption\Security\CryptoUtils`](#contractsencryptionsecuritycryptoutils), [`Phalcon\Contracts\Encryption\Security\CsrfProtection`](#contractsencryptionsecuritycsrfprotection), [`Phalcon\Contracts\Encryption\Security\PasswordSecurity`](#contractsencryptionsecuritypasswordsecurity)
## Contracts\Encryption\Security\Uuid\NodeProvider
Interface
Source on GitHub
- **`Phalcon\Contracts\Encryption\Security\Uuid\NodeProvider`**
- [`Phalcon\Encryption\Security\Uuid\NodeProviderInterface`](/5.17/api/phalcon_encryption/#encryptionsecurityuuidnodeproviderinterface)
### Method Summary
### Methods
Public · 1
getNode()
```php
public function getNode(): string;
```
## Contracts\Encryption\Security\Uuid\TimeBasedUuid
Interface
Source on GitHub
- **`Phalcon\Contracts\Encryption\Security\Uuid\TimeBasedUuid`**
- [`Phalcon\Encryption\Security\Uuid\TimeBasedUuidInterface`](/5.17/api/phalcon_encryption/#encryptionsecurityuuidtimebaseduuidinterface)
### Method Summary
### Methods
Public · 2
getDateTime()
```php
public function getDateTime(): \DateTimeImmutable;
```
getNode()
```php
public function getNode(): string;
```
## Contracts\Encryption\Security\Uuid\Uuid
Interface
Source on GitHub
Canonical marker contract for UUID version adapters.
Also carries the standard RFC 4122 namespace UUIDs as constants.
- **`Phalcon\Contracts\Encryption\Security\Uuid\Uuid`**
- [`Phalcon\Encryption\Security\Uuid\UuidInterface`](/5.17/api/phalcon_encryption/#encryptionsecurityuuiduuidinterface)
### Constants
string
NAMESPACE_DNS = "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
string
NAMESPACE_OID = "6ba7b812-9dad-11d1-80b4-00c04fd430c8"
string
NAMESPACE_URL = "6ba7b811-9dad-11d1-80b4-00c04fd430c8"
string
NAMESPACE_X500 = "6ba7b814-9dad-11d1-80b4-00c04fd430c8"
## Contracts\Events\Event
Interface
Source on GitHub
Canonical contract for Phalcon\Events\Event.
- **`Phalcon\Contracts\Events\Event`**
- [`Phalcon\Events\EventInterface`](/5.17/api/phalcon_events/#eventseventinterface)
### Method Summary
### Methods
Public · 7
getData()
```php
public function getData(): mixed;
```
Gets event data
getType()
```php
public function getType(): mixed;
```
Gets event type
isCancelable()
```php
public function isCancelable(): bool;
```
Check whether the event is cancelable
isStopped()
```php
public function isStopped(): bool;
```
Check whether the event is currently stopped
setData()
```php
public function setData( mixed $data = null ): Event;
```
Sets event data
setType()
```php
public function setType( string $type ): Event;
```
Sets event type
stop()
```php
public function stop(): Event;
```
Stops the event preventing propagation
## Contracts\Events\EventsAware
Interface
Source on GitHub
Canonical contract for Phalcon\Events\EventsAwareInterface. Implemented by
components that accept an events manager and dispatch through it.
Cross-references the legacy ManagerInterface (not the canonical Manager
contract) to preserve LSP for the many AbstractEventsAware subclasses that
already type-hint ManagerInterface. ManagerInterface extends Manager, so
this remains type-compatible with any code that needs the canonical surface.
- **`Phalcon\Contracts\Events\EventsAware`**
- [`Phalcon\Events\EventsAwareInterface`](/5.17/api/phalcon_events/#eventseventsawareinterface)
__Uses__ `Phalcon\Events\ManagerInterface`
### Method Summary
### Methods
Public · 2
getEventsManager()
```php
public function getEventsManager(): ManagerInterface|null;
```
Returns the internal events manager
setEventsManager()
```php
public function setEventsManager( ManagerInterface $eventsManager ): void;
```
Sets the events manager
## Contracts\Events\Manager
Interface
Source on GitHub
Canonical contract for Phalcon\Events\Manager.
- **`Phalcon\Contracts\Events\Manager`**
- [`Phalcon\Events\ManagerInterface`](/5.17/api/phalcon_events/#eventsmanagerinterface)
### Method Summary
### Constants
int
DEFAULT_PRIORITY = 100
### Methods
Public · 16
addSubscriber()
```php
public function addSubscriber( Subscriber $subscriber ): void;
```
Registers an event subscriber. The subscriber's getSubscribedEvents()
map is parsed and each entry is attached through the regular listener
pipeline.
arePrioritiesEnabled()
```php
public function arePrioritiesEnabled(): bool;
```
Returns whether priority ordering is currently enabled.
attach()
```php
public function attach(
string $eventType,
mixed $handler,
int $priority = self::DEFAULT_PRIORITY
): void;
```
Attach a listener to the events manager.
clearSubscribers()
```php
public function clearSubscribers(): void;
```
Removes every registered subscriber and detaches each listener they
contributed. Listeners attached via attach() are untouched.
collectResponses()
```php
public function collectResponses( bool $collect ): void;
```
Toggle response collection on/off.
detach()
```php
public function detach(
string $eventType,
mixed $handler
): void;
```
Detach a listener from the events manager.
detachAll()
```php
public function detachAll( string $type = null ): void;
```
Removes all listeners - globally or for a single event type.
enablePriorities()
```php
public function enablePriorities( bool $enablePriorities ): void;
```
Toggle priority ordering on/off.
fire()
```php
public function fire(
string $eventType,
object $source,
mixed $data = null,
bool $cancelable = true
);
```
Fires an event, notifying the active listeners.
getListeners()
```php
public function getListeners( string $type ): array;
```
Returns all listeners attached to the given event type.
getResponses()
```php
public function getResponses(): array;
```
Returns the responses recorded during the last fire (when collecting).
getSubscribers()
```php
public function getSubscribers(): array;
```
Returns the list of registered subscriber instances.
hasListeners()
```php
public function hasListeners( string $type ): bool;
```
Check whether the given event type has any listeners.
isCollecting()
```php
public function isCollecting(): bool;
```
Check whether the manager is currently collecting responses.
isValidHandler()
```php
public function isValidHandler( mixed $handler ): bool;
```
Returns true when the given handler is an object or callable.
removeSubscriber()
```php
public function removeSubscriber( Subscriber $subscriber ): void;
```
Removes a previously registered subscriber. Detaches every listener the
subscriber declared via getSubscribedEvents(). Idempotent.
## Contracts\Events\Stoppable
Interface
Source on GitHub
Phalcon's local mirror of PSR-14 StoppableEventInterface. Identical shape;
not extended from the PSR interface because the Zephir extension cannot
reference Composer-loaded interfaces at build time. A separate bridge
package exposes a PSR-14 adapter.
- **`Phalcon\Contracts\Events\Stoppable`**
### Method Summary
### Methods
Public · 1
isPropagationStopped()
```php
public function isPropagationStopped(): bool;
```
Returns true when the event must stop propagating to subsequent
listeners.
## Contracts\Events\Subscriber
Interface
Source on GitHub
Contract for event subscriber classes. A subscriber declares the events it
wants to listen to via a static map; Events\Manager parses the map and
attaches each entry as a regular listener.
Accepted value shapes per event key:
'event:name' => 'methodName'
'event:name' => ['methodName', priority]
'event:name' => [
['methodName1'],
['methodName2', priority],
]
Keys can be either a Phalcon event string (e.g. "db:beforeQuery") or a
fully qualified event class name.
Wildcard subscriptions: Phalcon's manager fires both the prefix queue and
the full-name queue (e.g. "db" is fired before "db:beforeQuery"). To
subscribe to every event of a component, use the prefix as the key:
'db' => 'onAnyDbEvent' // fires for db:beforeQuery, db:afterQuery, ...
- **`Phalcon\Contracts\Events\Subscriber`**
### Method Summary
### Methods
Public · 1
getSubscribedEvents()
```php
public static function getSubscribedEvents(): array;
```
Returns a map of event name => listener config. Called once per
Manager::addSubscriber() / removeSubscriber() call.
## Contracts\Filter\Sanitizer
Interface
Source on GitHub
The contract for sanitizers registered in Phalcon\Filter\Filter.
A sanitizer is an invokable object: it must expose a public `__invoke()`
method that receives the value to sanitize as its first parameter and
returns the sanitized value. Additional parameters, when a sanitizer
needs them (e.g. `regex`, `replace`), must be declared after the value
parameter; Phalcon\Filter\Filter::sanitize() forwards them in order.
`__invoke()` is intentionally not declared here: implementations type
their value parameter differently (`string` for text-only sanitizers,
untyped for coercing ones), and PHP parameter variance does not allow an
implementation to narrow a parameter declared by an interface.
A sanitizer operates on a single value. Array handling (one level of
recursion by default) is the responsibility of
Phalcon\Filter\Filter::sanitize(), not of the sanitizer.
- **`Phalcon\Contracts\Filter\Sanitizer`**
## Contracts\Flash\Flash
Interface
Source on GitHub
Canonical contract for Phalcon\Flash messengers.
Note: `output()` and `clear()` are part of the concrete `Direct` / `Session`
API and are not declared on this contract; they are scheduled to be added in
the next major version.
- **`Phalcon\Contracts\Flash\Flash`**
- [`Phalcon\Flash\FlashInterface`](/5.17/api/phalcon_flash/#flashflashinterface)
### Method Summary
### Methods
Public · 5
error()
```php
public function error( string $message ): string|null;
```
Shows a HTML error message
message()
```php
public function message(
string $type,
string $message
): string|null;
```
Outputs a message
Note: the shipped implementations (`Direct`, `Session`) accept
`string|array` for `$message`; this contract declares `string` and is
scheduled to be widened to `mixed` in the next major version. Delivery
semantics differ per implementation: `Direct::message()` renders and
emits the message immediately, while `Session::message()` stores the raw
message for output on a later request.
notice()
```php
public function notice( string $message ): string|null;
```
Shows a HTML notice/information message
success()
```php
public function success( string $message ): string|null;
```
Shows a HTML success message
warning()
```php
public function warning( string $message ): string|null;
```
Shows a HTML warning message
## Contracts\Forms\Schema
Interface
Source on GitHub
Contract for objects that supply a normalized list of form element
definitions. Implementations may source the definitions from a PHP array,
a JSON document, a YAML file, or any other format.
Each returned definition must be an associative array containing at least:
- 'type' (string) - element type key (e.g. 'text', 'select', 'checkgroup')
- 'name' (string) - the HTML name attribute value
Optional keys per definition:
- 'label' (string) - visible label text
- 'default' (mixed) - pre-populated default value
- 'attributes' (array) - additional HTML attributes
- 'filters' (array|string) - filter names applied on bind()
- 'validators' (array) - ValidatorInterface instances
- 'options' (array) - choices for select / checkgroup / radiogroup
- **`Phalcon\Contracts\Forms\Schema`**
### Method Summary
### Methods
Public · 1
```php
public function load(): array;
```
Returns an ordered list of normalized element definitions.
## Contracts\Html\Helper\Input\SelectData
Interface
Source on GitHub
Interface for SELECT option data providers.
Return format: [value => label] for flat options;
[groupLabel => [value => label, ...]] for optgroups.
- **`Phalcon\Contracts\Html\Helper\Input\SelectData`**
### Method Summary
### Methods
Public · 2
```php
public function getAttributes(): array;
```
Returns the per-option attribute map.
Format: [optionValue => [attrName => stringValue, ...]].
Implementations must return resolved string values; no escaping,
ordering, or rendering is performed here.
```php
public function getOptions(): array;
```
## Contracts\Logger\Adapter\Adapter
Interface
Source on GitHub
Canonical contract for Phalcon\Logger adapters.
- **`Phalcon\Contracts\Logger\Adapter\Adapter`**
- [`Phalcon\Logger\Adapter\AdapterInterface`](/5.17/api/phalcon_logger/#loggeradapteradapterinterface)
__Uses__ `Phalcon\Logger\Formatter\FormatterInterface` · `Phalcon\Logger\Item`
### Method Summary
### Methods
Public · 9
add()
```php
public function add( Item $item ): Adapter;
```
Adds a message in the queue
begin()
```php
public function begin(): Adapter;
```
Starts a transaction
close()
```php
public function close(): bool;
```
Closes the logger
commit()
```php
public function commit(): Adapter;
```
Commits the internal transaction
```php
public function getFormatter(): FormatterInterface;
```
Returns the internal formatter
inTransaction()
```php
public function inTransaction(): bool;
```
Returns the whether the logger is currently in an active transaction or
not
process()
```php
public function process( Item $item ): void;
```
Processes the message in the adapter
rollback()
```php
public function rollback(): Adapter;
```
Rollbacks the internal transaction
```php
public function setFormatter( FormatterInterface $formatter ): Adapter;
```
Sets the message formatter
## Contracts\Logger\Formatter\Formatter
Interface
Source on GitHub
Canonical contract for Phalcon\Logger formatters.
- **`Phalcon\Contracts\Logger\Formatter\Formatter`**
- [`Phalcon\Logger\Formatter\FormatterInterface`](/5.17/api/phalcon_logger/#loggerformatterformatterinterface)
__Uses__ `Phalcon\Logger\Item`
### Method Summary
### Methods
Public · 1
```php
public function format( Item $item ): string;
```
Applies a format to an item
## Contracts\Logger\Logger
Interface
Source on GitHub
Canonical contract for Phalcon\Logger\Logger.
- **`Phalcon\Contracts\Logger\Logger`**
- [`Phalcon\Logger\LoggerInterface`](/5.17/api/phalcon_logger/#loggerloggerinterface)
__Uses__ `Phalcon\Contracts\Logger\Adapter\Adapter`
### Method Summary
public
void
alert(string $message,array $context = [])
Action must be taken immediately.
public
void
critical(string $message,array $context = [])
Critical conditions.
public
void
debug(string $message,array $context = [])
Detailed debug information.
public
void
emergency(string $message,array $context = [])
System is unusable.
public
void
error(string $message,array $context = [])
Runtime errors that do not require immediate action but should typically
public
Adapter
getAdapter( string $name )
Returns an adapter from the stack
public
array
getAdapters()
Returns the adapter stack array
public
int
getLogLevel()
Returns the log level
public
string
getName()
Returns the name of the logger
public
void
info(string $message,array $context = [])
Interesting events.
public
void
log(mixed $level,string $message,array $context = [])
Logs with an arbitrary level.
public
void
notice(string $message,array $context = [])
Normal but significant events.
public
void
trace(string $message,array $context = [])
Extra-verbose diagnostic output.
public
void
warning(string $message,array $context = [])
Exceptional occurrences that are not errors.
### Methods
Public · 14
alert()
```php
public function alert(
string $message,
array $context = []
): void;
```
Action must be taken immediately.
Example: Entire website down, database unavailable, etc. This should
trigger the SMS alerts and wake you up.
critical()
```php
public function critical(
string $message,
array $context = []
): void;
```
Critical conditions.
Example: Application component unavailable, unexpected exception.
debug()
```php
public function debug(
string $message,
array $context = []
): void;
```
Detailed debug information.
emergency()
```php
public function emergency(
string $message,
array $context = []
): void;
```
System is unusable.
error()
```php
public function error(
string $message,
array $context = []
): void;
```
Runtime errors that do not require immediate action but should typically
be logged and monitored.
getAdapter()
```php
public function getAdapter( string $name ): Adapter;
```
Returns an adapter from the stack
getAdapters()
```php
public function getAdapters(): array;
```
Returns the adapter stack array
getLogLevel()
```php
public function getLogLevel(): int;
```
Returns the log level
getName()
```php
public function getName(): string;
```
Returns the name of the logger
info()
```php
public function info(
string $message,
array $context = []
): void;
```
Interesting events.
Example: User logs in, SQL logs.
log()
```php
public function log(
mixed $level,
string $message,
array $context = []
): void;
```
Logs with an arbitrary level.
An unknown level (a typo or an unmapped value) is not rejected; it maps
to the CUSTOM level and is logged, rather than raising an exception.
notice()
```php
public function notice(
string $message,
array $context = []
): void;
```
Normal but significant events.
trace()
```php
public function trace(
string $message,
array $context = []
): void;
```
Extra-verbose diagnostic output.
warning()
```php
public function warning(
string $message,
array $context = []
): void;
```
Exceptional occurrences that are not errors.
Example: Use of deprecated APIs, poor use of an API, undesirable things
that are not necessarily wrong.
## Contracts\Messages\Messages
Interface
Source on GitHub
Canonical contract for Phalcon\Messages\Messages.
The collection stores Phalcon\Messages\MessageInterface objects and is
iterated by integer position. An entry added under a string key through the
ArrayAccess interface stays reachable by that offset but is not visited
during iteration (`foreach`), which walks the integer sequence only.
- `ArrayAccess`
- **`Phalcon\Contracts\Messages\Messages`** - extends `ArrayAccess`, `Countable`, `Iterator`
__Uses__ `ArrayAccess` · `Countable` · `Iterator` · `Phalcon\Messages\MessageInterface`
### Method Summary
### Methods
Public · 3
appendMessage()
```php
public function appendMessage( MessageInterface $message ): void;
```
Appends a message to the collection
appendMessages()
```php
public function appendMessages( mixed $messages );
```
Appends an array of messages to the collection
filter()
```php
public function filter( string $fieldName ): array;
```
Filters the message collection by field name
## Contracts\Mvc\Dispatcher
Interface
Source on GitHub
Canonical contract for Phalcon\Mvc\Dispatcher.
- [`Phalcon\Contracts\Dispatcher\Dispatcher`](#contractsdispatcherdispatcher)
- **`Phalcon\Contracts\Mvc\Dispatcher`**
- [`Phalcon\Mvc\DispatcherInterface`](/5.17/api/phalcon_mvc/#mvcdispatcherinterface)
__Uses__ `Phalcon\Contracts\Dispatcher\Dispatcher` · `Phalcon\Mvc\ControllerInterface`
### Method Summary
### Methods
Public · 6
getActiveController()
```php
public function getActiveController(): ControllerInterface|null;
```
Returns the active controller in the dispatcher
getControllerName()
```php
public function getControllerName(): string;
```
Gets last dispatched controller name
getLastController()
```php
public function getLastController(): ControllerInterface|null;
```
Returns the latest dispatched controller
setControllerName()
```php
public function setControllerName( string $controllerName ): DispatcherContract;
```
Sets the controller name to be dispatched
setControllerSuffix()
```php
public function setControllerSuffix( string $controllerSuffix ): DispatcherContract;
```
Sets the default controller suffix
setDefaultController()
```php
public function setDefaultController( string $controllerName ): DispatcherContract;
```
Sets the default controller name
## Contracts\Mvc\Model\Relation\CacheKeyProvider
Interface
Source on GitHub
Interface for models that provide a custom unique key for the reusable
records cache in the Model Manager. Implement this interface when the
default object-identity based key (unique_key) does not produce stable
cache hits across multiple object instances that represent the same
database record.
- **`Phalcon\Contracts\Mvc\Model\Relation\CacheKeyProvider`**
### Method Summary
### Methods
Public · 1
getUniqueKey()
```php
public function getUniqueKey(): string;
```
Returns a string that uniquely identifies this model instance for
use as the key in the reusable records cache.
## Contracts\Paginator\Adapter
Interface
Source on GitHub
Interface for Phalcon\Paginator adapters
- **`Phalcon\Contracts\Paginator\Adapter`**
- [`Phalcon\Paginator\Adapter\AdapterInterface`](/5.17/api/phalcon_paginator/#paginatoradapteradapterinterface)
### Method Summary
### Methods
Public · 4
getLimit()
```php
public function getLimit(): int;
```
Get current rows limit
paginate()
```php
public function paginate(): Repository;
```
Returns a slice of the resultset to show in the pagination
setCurrentPage()
```php
public function setCurrentPage( int $page ): Adapter;
```
Set the current page number
setLimit()
```php
public function setLimit( int $limit ): Adapter;
```
Set current rows limit
## Contracts\Paginator\Repository
Interface
Source on GitHub
Interface for the repository of current state
Phalcon\Paginator\AdapterInterface::paginate()
Two adapter dialects fill this repository:
- Offset adapters (Model, NativeArray, QueryBuilder) populate every
property as a sequential page number / item count.
- Cursor adapters (QueryBuilderCursor) reuse the same properties with a
different meaning: `getCurrent()`/`getNext()` carry keyset cursor values
rather than page numbers, and `getTotalItems()`, `getLast()` and
`getPrevious()` are not computed (they return 0).
- **`Phalcon\Contracts\Paginator\Repository`**
- [`Phalcon\Paginator\RepositoryInterface`](/5.17/api/phalcon_paginator/#paginatorrepositoryinterface)
### Method Summary
### Constants
string
PROPERTY_CURRENT_PAGE = "current"
string
PROPERTY_FIRST_PAGE = "first"
string
PROPERTY_ITEMS = "items"
string
PROPERTY_LAST_PAGE = "last"
string
PROPERTY_LIMIT = "limit"
string
PROPERTY_NEXT_PAGE = "next"
string
PROPERTY_PREVIOUS_PAGE = "previous"
string
PROPERTY_TOTAL_ITEMS = "total_items"
### Methods
Public · 11
getAliases()
```php
public function getAliases(): array;
```
Gets the aliases for properties repository
getCurrent()
```php
public function getCurrent(): int;
```
Gets number of the current page
Cursor adapters store the cursor value used for the current page here
(0 on the first page), not a sequential page number.
getFirst()
```php
public function getFirst(): int;
```
Gets number of the first page
getItems()
```php
public function getItems(): mixed;
```
Gets the items on the current page
getLast()
```php
public function getLast(): int;
```
Gets number of the last page
Cursor adapters do not compute this and return 0.
getLimit()
```php
public function getLimit(): int;
```
Gets current rows limit
getNext()
```php
public function getNext(): int;
```
Gets number of the next page
Cursor adapters store the next cursor value here rather than a page
number; 0 means there is no next page.
getPrevious()
```php
public function getPrevious(): int;
```
Gets number of the previous page
Cursor adapters do not compute this and return 0.
getTotalItems()
```php
public function getTotalItems(): int;
```
Gets the total number of items
Cursor adapters do not compute this and return 0.
setAliases()
```php
public function setAliases( array $aliases ): Repository;
```
Sets the aliases for properties repository
setProperties()
```php
public function setProperties( array $properties ): Repository;
```
Sets values for properties of the repository
## Contracts\Queue\ConnectionFactory
Interface
Source on GitHub
Builds a Context: the entry point of every adapter.
- **`Phalcon\Contracts\Queue\ConnectionFactory`**
### Method Summary
### Methods
Public · 1
createContext()
```php
public function createContext(): Context;
```
Creates a context (a session/connection to the transport).
## Contracts\Queue\Consumer
Interface
Source on GitHub
Receives messages from a single queue.
- **`Phalcon\Contracts\Queue\Consumer`**
### Method Summary
### Methods
Public · 5
acknowledge()
```php
public function acknowledge( Message $message ): void;
```
Acknowledges the message; the transport may then discard it.
getQueue()
```php
public function getQueue(): Queue;
```
Returns the queue this consumer reads from.
receive()
```php
public function receive( int $timeout = 0 ): Message|null;
```
Receives a message, blocking up to timeout milliseconds (0 = block
until one is available). Returns null when none arrives in time.
receiveNoWait()
```php
public function receiveNoWait(): Message|null;
```
Receives a message without blocking, or null when none is ready.
reject()
```php
public function reject(
Message $message,
bool $requeue = false
): void;
```
Rejects the message. When requeue is true the transport redelivers it.
## Contracts\Queue\Context
Interface
Source on GitHub
A session with the transport. Factory for messages, destinations,
producers and consumers.
- **`Phalcon\Contracts\Queue\Context`**
### Method Summary
### Methods
Public · 9
close()
```php
public function close(): void;
```
Closes the context and releases its resources.
createConsumer()
```php
public function createConsumer( Destination $destination ): Consumer;
```
Creates a consumer for the given destination.
createMessage()
```php
public function createMessage(
string $body = "",
array $properties = [],
array $headers = []
): Message;
```
Creates a message with an optional body, properties and headers.
createProducer()
```php
public function createProducer(): Producer;
```
Creates a producer.
createQueue()
```php
public function createQueue( string $queueName ): Queue;
```
Creates a queue destination by name.
createSubscriptionConsumer()
```php
public function createSubscriptionConsumer(): SubscriptionConsumer;
```
Creates a subscription consumer for consuming from several queues.
createTemporaryQueue()
```php
public function createTemporaryQueue(): Queue;
```
Creates a temporary queue tied to the lifetime of the context.
createTopic()
```php
public function createTopic( string $topicName ): Topic;
```
Creates a topic destination by name.
purgeQueue()
```php
public function purgeQueue( Queue $queue ): void;
```
Removes all messages from the given queue.
## Contracts\Queue\Destination
Interface
Source on GitHub
Marker interface for a message destination: a Queue or a Topic.
- **`Phalcon\Contracts\Queue\Destination`**
- [`Phalcon\Contracts\Queue\Queue`](#contractsqueuequeue)
- [`Phalcon\Contracts\Queue\Topic`](#contractsqueuetopic)
## Contracts\Queue\Inspectable
Interface
Source on GitHub
Optional capability contract for a transport that can report statistics for
a queue (for example ready, delayed and buried job counts). Callers detect
support with `instanceof`.
The array returned by getStats() is ADAPTER-NATIVE: its keys and their
semantics are defined by the implementing adapter and are NOT guaranteed to
be uniform across adapters. It is an inspection surface, not a portable or
normalized schema. Each implementation documents the exact keys it returns.
- **`Phalcon\Contracts\Queue\Inspectable`**
### Method Summary
### Methods
Public · 1
getStats()
```php
public function getStats( Queue $queue ): array;
```
Returns statistics for the given queue.
## Contracts\Queue\Message
Interface
Source on GitHub
A message exchanged through the transport. Carries a body, application
properties, transport headers and the standard messaging metadata.
- **`Phalcon\Contracts\Queue\Message`**
### Method Summary
### Methods
Public · 20
getBody()
```php
public function getBody(): string;
```
Returns the message body.
getCorrelationId()
```php
public function getCorrelationId(): string|null;
```
Returns the correlation id used to correlate request/reply messages.
```php
public function getHeader(
string $name,
mixed $defaultValue = null
): mixed;
```
Returns a single header value, or the default when it is not set.
```php
public function getHeaders(): array;
```
Returns all transport headers.
getMessageId()
```php
public function getMessageId(): string|null;
```
Returns the message id.
getProperties()
```php
public function getProperties(): array;
```
Returns all application properties.
getProperty()
```php
public function getProperty(
string $name,
mixed $defaultValue = null
): mixed;
```
Returns a single property value, or the default when it is not set.
getReplyTo()
```php
public function getReplyTo(): string|null;
```
Returns the reply-to destination name.
getTimestamp()
```php
public function getTimestamp(): int|null;
```
Returns the timestamp (in milliseconds) or null when it is not set.
isRedelivered()
```php
public function isRedelivered(): bool;
```
Whether the message has been redelivered.
setBody()
```php
public function setBody( string $body ): void;
```
Sets the message body.
setCorrelationId()
```php
public function setCorrelationId( string $correlationId ): void;
```
Sets the correlation id.
```php
public function setHeader(
string $name,
mixed $value
): void;
```
Sets a single transport header.
```php
public function setHeaders( array $headers ): void;
```
Replaces all transport headers.
setMessageId()
```php
public function setMessageId( string $messageId ): void;
```
Sets the message id.
setProperties()
```php
public function setProperties( array $properties ): void;
```
Replaces all application properties.
setProperty()
```php
public function setProperty(
string $name,
mixed $value
): void;
```
Sets a single application property.
setRedelivered()
```php
public function setRedelivered( bool $redelivered ): void;
```
Marks the message as redelivered.
setReplyTo()
```php
public function setReplyTo( string $replyTo ): void;
```
Sets the reply-to destination name.
setTimestamp()
```php
public function setTimestamp( int $timestamp ): void;
```
Sets the timestamp (in milliseconds).
## Contracts\Queue\Processor
Interface
Source on GitHub
Processes a single message. The return value tells the consumer what to
do next: acknowledge, reject, or requeue.
The literal constant values are kept compatible with the wider interop
ecosystem.
- **`Phalcon\Contracts\Queue\Processor`**
### Method Summary
### Constants
string
ACK = "enqueue.ack"
string
REJECT = "enqueue.reject"
string
REQUEUE = "enqueue.requeue"
### Methods
Public · 1
process()
```php
public function process(
Message $message,
Context $context
): string|object;
```
Processes the message and returns one of the ACK / REJECT / REQUEUE
constants, or an object whose string form is one of those values.
## Contracts\Queue\Producer
Interface
Source on GitHub
Sends messages to a destination.
- **`Phalcon\Contracts\Queue\Producer`**
### Method Summary
### Methods
Public · 7
getDeliveryDelay()
```php
public function getDeliveryDelay(): int|null;
```
Returns the delivery delay (in milliseconds) or null when not set.
getPriority()
```php
public function getPriority(): int|null;
```
Returns the message priority or null when not set.
getTimeToLive()
```php
public function getTimeToLive(): int|null;
```
Returns the time to live (in milliseconds) or null when not set.
send()
```php
public function send(
Destination $destination,
Message $message
): void;
```
Sends a message to the given destination.
setDeliveryDelay()
```php
public function setDeliveryDelay( mixed $deliveryDelay = null ): Producer;
```
Sets the delivery delay (in milliseconds). Null clears it.
setPriority()
```php
public function setPriority( mixed $priority = null ): Producer;
```
Sets the message priority. Null clears it.
setTimeToLive()
```php
public function setTimeToLive( mixed $timeToLive = null ): Producer;
```
Sets the time to live (in milliseconds). Null clears it.
## Contracts\Queue\Queue
Interface
Source on GitHub
A queue destination (point-to-point).
- [`Phalcon\Contracts\Queue\Destination`](#contractsqueuedestination)
- **`Phalcon\Contracts\Queue\Queue`**
### Method Summary
### Methods
Public · 1
getQueueName()
```php
public function getQueueName(): string;
```
Returns the queue name.
## Contracts\Queue\SubscriptionConsumer
Interface
Source on GitHub
Consumes from several queues at once, dispatching each message to the
callback registered for its consumer.
- **`Phalcon\Contracts\Queue\SubscriptionConsumer`**
### Method Summary
### Methods
Public · 4
consume()
```php
public function consume( int $timeout = 0 ): void;
```
Starts consuming, blocking up to timeout milliseconds (0 = block
until a message is available).
subscribe()
```php
public function subscribe(
Consumer $consumer,
callable $callback
): void;
```
Subscribes a consumer; the callback receives each delivered message.
unsubscribe()
```php
public function unsubscribe( Consumer $consumer ): void;
```
Removes a previously subscribed consumer.
unsubscribeAll()
```php
public function unsubscribeAll(): void;
```
Removes every subscribed consumer.
## Contracts\Queue\Topic
Interface
Source on GitHub
A topic destination (publish/subscribe).
- [`Phalcon\Contracts\Queue\Destination`](#contractsqueuedestination)
- **`Phalcon\Contracts\Queue\Topic`**
### Method Summary
### Methods
Public · 1
getTopicName()
```php
public function getTopicName(): string;
```
Returns the topic name.
## Contracts\Queue\VisibilityAware
Interface
Source on GitHub
Marker contract for a consumer that supports a visibility timeout
(for example Beanstalk TTR or an SQS visibility timeout). Callers detect
support with `instanceof`. It carries no behavior and commits to no class
shape.
- **`Phalcon\Contracts\Queue\VisibilityAware`**
## Contracts\Support\Collection
Interface
Source on GitHub
Canonical contract for Phalcon\Support\Collection.
@extends ArrayAccess<int|string, mixed>
@extends IteratorAggregate<int|string, mixed>
- `ArrayAccess`
- **`Phalcon\Contracts\Support\Collection`** - extends `ArrayAccess`, `IteratorAggregate`
- [`Phalcon\Support\Collection\CollectionInterface`](/5.17/api/phalcon_support/#supportcollectioncollectioninterface)
__Uses__ `ArrayAccess` · `IteratorAggregate`
### Method Summary
public
mixed
__get( string $element )
public
bool
__isset( string $element )
public
void
__set(string $element,mixed $value)
public
void
__unset( string $element )
public
void
clear()
Clears the internal collection.
public
array
column( string $propertyOrMethod )
Returns the values from a single property/method extracted from every
public
static
each( callable $callback )
Invokes the callback for every item in the collection.
public
static
filter( callable $callback )
Returns a new collection of items for which the callback returns true.
public
mixed
first()
Returns the first value in the collection or null when empty.
public
mixed
get(string $element,mixed $defaultValue = null,string $cast = null)
Returns an element from the collection.
public
array
getKeys( bool $insensitive = true )
Returns the keys (insensitive or not) of the collection.
public
string|null
getType()
Returns the configured runtime type guard, or null when not set.
public
array
getValues()
Returns the values of the internal array.
public
bool
has( string $element )
Checks whether an element exists in the collection.
public
void
init( array $data = [] )
Initializes the internal array.
public
bool
isEmpty()
Returns true when the collection has no entries.
public
array
keys( bool $insensitive = true )
Returns the keys (insensitive or not) of the collection.
public
mixed
last()
Returns the last value in the collection or null when empty.
public
static
map( callable $callback )
Returns a new collection with the callback applied to every value.
public
mixed
reduce(callable $callback,mixed $initial = null)
Reduces the collection to a single value using the callback.
public
void
remove( string $element )
Removes the element from the collection.
public
void
replace( array $data )
Replaces the collection data with a new array, clearing first.
public
void
set(string $element,mixed $value)
Stores an element in the collection.
public
static
sort(callable $callback = null,int $order = 4)
Returns a new collection sorted by value, preserving keys.
public
array
toArray()
Returns the collection as an array.
public
string
toJson( int $options = 4194383 )
Returns the collection serialized as a JSON string.
public
array
values()
Returns the values of the internal array.
public
static
where(string $propertyOrMethod,mixed $value)
Returns a new collection containing only the items whose
### Methods
Public · 28
__get()
```php
public function __get( string $element ): mixed;
```
__isset()
```php
public function __isset( string $element ): bool;
```
__set()
```php
public function __set(
string $element,
mixed $value
): void;
```
__unset()
```php
public function __unset( string $element ): void;
```
clear()
```php
public function clear(): void;
```
Clears the internal collection.
column()
```php
public function column( string $propertyOrMethod ): array;
```
Returns the values from a single property/method extracted from every
item in the collection, keyed by the original collection key.
each()
```php
public function each( callable $callback ): static;
```
Invokes the callback for every item in the collection.
filter()
```php
public function filter( callable $callback ): static;
```
Returns a new collection of items for which the callback returns true.
first()
```php
public function first(): mixed;
```
Returns the first value in the collection or null when empty.
get()
```php
public function get(
string $element,
mixed $defaultValue = null,
string $cast = null
): mixed;
```
Returns an element from the collection.
getKeys()
```php
public function getKeys( bool $insensitive = true ): array;
```
Returns the keys (insensitive or not) of the collection.
getType()
```php
public function getType(): string|null;
```
Returns the configured runtime type guard, or null when not set.
getValues()
```php
public function getValues(): array;
```
Returns the values of the internal array.
has()
```php
public function has( string $element ): bool;
```
Checks whether an element exists in the collection.
init()
```php
public function init( array $data = [] ): void;
```
Initializes the internal array.
isEmpty()
```php
public function isEmpty(): bool;
```
Returns true when the collection has no entries.
keys()
```php
public function keys( bool $insensitive = true ): array;
```
Returns the keys (insensitive or not) of the collection.
last()
```php
public function last(): mixed;
```
Returns the last value in the collection or null when empty.
map()
```php
public function map( callable $callback ): static;
```
Returns a new collection with the callback applied to every value.
reduce()
```php
public function reduce(
callable $callback,
mixed $initial = null
): mixed;
```
Reduces the collection to a single value using the callback.
remove()
```php
public function remove( string $element ): void;
```
Removes the element from the collection.
replace()
```php
public function replace( array $data ): void;
```
Replaces the collection data with a new array, clearing first.
set()
```php
public function set(
string $element,
mixed $value
): void;
```
Stores an element in the collection.
sort()
```php
public function sort(
callable $callback = null,
int $order = 4
): static;
```
Returns a new collection sorted by value, preserving keys.
toArray()
```php
public function toArray(): array;
```
Returns the collection as an array.
toJson()
```php
public function toJson( int $options = 4194383 ): string;
```
Returns the collection serialized as a JSON string.
values()
```php
public function values(): array;
```
Returns the values of the internal array.
where()
```php
public function where(
string $propertyOrMethod,
mixed $value
): static;
```
Returns a new collection containing only the items whose
`propertyOrMethod` strictly equals `$value`.
## Contracts\Support\Debug\Renderer
Interface
Source on GitHub
Canonical contract for Phalcon\Support\Debug renderers. Turns an
ExceptionReport into output.
- [`Phalcon\Contracts\Support\Debug\TemplateAware`](#contractssupportdebugtemplateaware)
- **`Phalcon\Contracts\Support\Debug\Renderer`**
__Uses__ `Phalcon\Support\Debug\Report\ExceptionReport`
### Method Summary
### Methods
Public · 4
getCssSources()
```php
public function getCssSources( string $uri ): string;
```
Returns the CSS sources block for the given base URI.
getJsSources()
```php
public function getJsSources( string $uri ): string;
```
Returns the JavaScript sources block for the given base URI.
getVersion()
```php
public function getVersion(): string;
```
Returns the framework version block.
render()
```php
public function render( ExceptionReport $report ): string;
```
Renders the report.
## Contracts\Support\Debug\TemplateAware
Interface
Source on GitHub
Canonical contract for components that render through named, overridable
template strings.
- **`Phalcon\Contracts\Support\Debug\TemplateAware`**
- [`Phalcon\Contracts\Support\Debug\Renderer`](#contractssupportdebugrenderer)
### Method Summary
### Methods
Public · 2
getTemplate()
```php
public function getTemplate( string $name ): string;
```
Returns the template for the given name (override if set, default
otherwise).
setTemplate()
```php
public function setTemplate(
string $name,
string $template
): static;
```
Overrides the template for the given name.
Source: https://docs.phalcon.io/5.17/api/phalcon_contracts/index.mdx