---
title: "Class **Phalcon\\Mvc\\Model\\Manager**"
version: "3.4"
---

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

# Class **Phalcon\Mvc\Model\Manager**

*implements* [Phalcon\Mvc\Model\ManagerInterface](/3.4/api/phalcon_mvc_model_manager/), [Phalcon\Di\InjectionAwareInterface](/3.4/api/phalcon_di/), [Phalcon\Events\EventsAwareInterface](/3.4/api/phalcon_events/)

<a href="https://github.com/phalcon/cphalcon/tree/v3.4.0/phalcon/mvc/model/manager.zep" class="btn btn-default btn-sm">Source on GitHub</a>

This components controls the initialization of models, keeping record of relations
between the different models of the application.

A ModelsManager is injected to a model via a Dependency Injector/Services Container such as Phalcon\Di.

```php
<?php

use Phalcon\Di;
use Phalcon\Mvc\Model\Manager as ModelsManager;

$di = new Di();

$di->set(
"modelsManager",
function() {
    return new ModelsManager();
}
);

$robot = new Robots($di);

```

## Methods
public  **setDI** ([Phalcon\DiInterface](/3.4/api/phalcon_di/) $dependencyInjector)

Sets the DependencyInjector container

public  **getDI** ()

Returns the DependencyInjector container

public  **setEventsManager** ([Phalcon\Events\ManagerInterface](/3.4/api/phalcon_events/) $eventsManager)

Sets a global events manager

public  **getEventsManager** ()

Returns the internal event manager

public  **setCustomEventsManager** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, [Phalcon\Events\ManagerInterface](/3.4/api/phalcon_events/) $eventsManager)

Sets a custom events manager for a specific model

public  **getCustomEventsManager** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

Returns a custom events manager related to a model

public  **initialize** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

Initializes a model in the model manager

public  **isInitialized** (*mixed* $modelName)

Check whether a model is already initialized

public  **getLastInitialized** ()

Get last initialized model

public  **load** (*mixed* $modelName, [*mixed* $newInstance])

Loads a model throwing an exception if it doesn't exist

public  **setModelPrefix** (*mixed* $prefix)

Sets the prefix for all model sources.

```php
<?php

use Phalcon\Mvc\Model\Manager;

$di->set("modelsManager", function () {
$modelsManager = new Manager();
$modelsManager->setModelPrefix("wp_");

return $modelsManager;
});

$robots = new Robots();
echo $robots->getSource(); // wp_robots

```

public  **getModelPrefix** ()

Returns the prefix for all model sources.

```php
<?php

use Phalcon\Mvc\Model\Manager;

$di->set("modelsManager", function () {
$modelsManager = new Manager();
$modelsManager->setModelPrefix("wp_");

return $modelsManager;
});

$robots = new Robots();
echo $robots->getSource(); // wp_robots

```

public  **setModelSource** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $source)

Sets the mapped source for a model

final public  **isVisibleModelProperty** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $property)

Check whether a model property is declared as public.

```php
<?php

$isPublic = $manager->isVisibleModelProperty(
new Robots(),
"name"
);

```

public  **getModelSource** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

Returns the mapped source for a model

public  **setModelSchema** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $schema)

Sets the mapped schema for a model

public  **getModelSchema** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

Returns the mapped schema for a model

public  **setConnectionService** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $connectionService)

Sets both write and read connection service for a model

public  **setWriteConnectionService** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $connectionService)

Sets write connection service for a model

public  **setReadConnectionService** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $connectionService)

Sets read connection service for a model

public  **getReadConnection** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

Returns the connection to read data related to a model

public  **getWriteConnection** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

Returns the connection to write data related to a model

protected  **_getConnection** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $connectionServices)

Returns the connection to read or write data related to a model depending on the connection services.

public  **getReadConnectionService** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

Returns the connection service name used to read data related to a model

public  **getWriteConnectionService** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

Returns the connection service name used to write data related to a model

public  **_getConnectionService** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $connectionServices)

Returns the connection service name used to read or write data related to
a model depending on the connection services

public  **notifyEvent** (*mixed* $eventName, [Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

Receives events generated in the models and dispatches them to an events-manager if available
Notify the behaviors that are listening in the model

public  **missingMethod** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $eventName, *mixed* $data)

Dispatch an event to the listeners and behaviors
This method expects that the endpoint listeners/behaviors returns true
meaning that a least one was implemented

public  **addBehavior** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, [Phalcon\Mvc\Model\BehaviorInterface](/3.4/api/phalcon_mvc_model_behavior/) $behavior)

Binds a behavior to a model

public  **keepSnapshots** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $keepSnapshots)

Sets if a model must keep snapshots

public  **isKeepingSnapshots** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

Checks if a model is keeping snapshots for the queried records

public  **useDynamicUpdate** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $dynamicUpdate)

Sets if a model must use dynamic update instead of the all-field update

public  **isUsingDynamicUpdate** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

Checks if a model is using dynamic update instead of all-field update

public [Phalcon\Mvc\Model\Relation](/3.4/api/phalcon_mvc_model_relation/) **addHasOne** ([Phalcon\Mvc\Model](/3.4/api/phalcon_mvc_model/) $model, *mixed* $fields, *string* $referencedModel, *mixed* $referencedFields, [*array* $options])

Setup a 1-1 relation between two models

public [Phalcon\Mvc\Model\Relation](/3.4/api/phalcon_mvc_model_relation/) **addBelongsTo** ([Phalcon\Mvc\Model](/3.4/api/phalcon_mvc_model/) $model, *mixed* $fields, *string* $referencedModel, *mixed* $referencedFields, [*array* $options])

Setup a relation reverse many to one between two models

public  **addHasMany** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $fields, *string* $referencedModel, *mixed* $referencedFields, [*array* $options])

Setup a relation 1-n between two models

public [Phalcon\Mvc\Model\Relation](/3.4/api/phalcon_mvc_model_relation/) **addHasManyToMany** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *string* $fields, *string* $intermediateModel, *string* $intermediateFields, *string* $intermediateReferencedFields, *string* $referencedModel, *string* $referencedFields, [*array* $options])

Setups a relation n-m between two models

public  **existsBelongsTo** (*mixed* $modelName, *mixed* $modelRelation)

Checks whether a model has a belongsTo relation with another model

public  **existsHasMany** (*mixed* $modelName, *mixed* $modelRelation)

Checks whether a model has a hasMany relation with another model

public  **existsHasOne** (*mixed* $modelName, *mixed* $modelRelation)

Checks whether a model has a hasOne relation with another model

public  **existsHasManyToMany** (*mixed* $modelName, *mixed* $modelRelation)

Checks whether a model has a hasManyToMany relation with another model

public  **getRelationByAlias** (*mixed* $modelName, *mixed* $alias)

Returns a relation by its alias

final protected  **_mergeFindParameters** (*mixed* $findParamsOne, *mixed* $findParamsTwo)

Merge two arrays of find parameters

public [Phalcon\Mvc\Model\Resultset\Simple](/3.4/api/phalcon_mvc_model_resultset/) | [Phalcon\Mvc\Model\Resultset\Simple](/3.4/api/phalcon_mvc_model_resultset/) | *int* | *false* **getRelationRecords** ([Phalcon\Mvc\Model\RelationInterface](/3.4/api/phalcon_mvc_model_relation/) $relation, *mixed* $method, [Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $record, [*mixed* $parameters])

Helper method to query records based on a relation definition

public  **getReusableRecords** (*mixed* $modelName, *mixed* $key)

Returns a reusable object from the internal list

public  **setReusableRecords** (*mixed* $modelName, *mixed* $key, *mixed* $records)

Stores a reusable record in the internal list

public  **clearReusableObjects** ()

Clears the internal reusable list

public  **getBelongsToRecords** (*mixed* $method, *mixed* $modelName, *mixed* $modelRelation, [Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $record, [*mixed* $parameters])

Gets belongsTo related records from a model

public  **getHasManyRecords** (*mixed* $method, *mixed* $modelName, *mixed* $modelRelation, [Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $record, [*mixed* $parameters])

Gets hasMany related records from a model

public  **getHasOneRecords** (*mixed* $method, *mixed* $modelName, *mixed* $modelRelation, [Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $record, [*mixed* $parameters])

Gets belongsTo related records from a model

public  **getBelongsTo** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

Gets all the belongsTo relations defined in a model

```php
<?php

$relations = $modelsManager->getBelongsTo(
new Robots()
);

```

public  **getHasMany** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

Gets hasMany relations defined on a model

public  **getHasOne** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

Gets hasOne relations defined on a model

public  **getHasManyToMany** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

Gets hasManyToMany relations defined on a model

public  **getHasOneAndHasMany** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

Gets hasOne relations defined on a model

public  **getRelations** (*mixed* $modelName)

Query all the relationships defined on a model

public  **getRelationsBetween** (*mixed* $first, *mixed* $second)

Query the first relationship defined between two models

public  **createQuery** (*mixed* $phql)

Creates a Phalcon\Mvc\Model\Query without execute it

public  **executeQuery** (*mixed* $phql, [*mixed* $placeholders], [*mixed* $types])

Creates a Phalcon\Mvc\Model\Query and execute it

public  **createBuilder** ([*mixed* $params])

Creates a Phalcon\Mvc\Model\Query\Builder

public  **getLastQuery** ()

Returns the last query created or executed in the models manager

public  **registerNamespaceAlias** (*mixed* $alias, *mixed* $namespaceName)

Registers shorter aliases for namespaces in PHQL statements

public  **getNamespaceAlias** (*mixed* $alias)

Returns a real namespace from its alias

public  **getNamespaceAliases** ()

Returns all the registered namespace aliases

public  **__destruct** ()

Destroys the current PHQL cache

<hr />

# Interface **Phalcon\Mvc\Model\ManagerInterface**

<a href="https://github.com/phalcon/cphalcon/tree/v3.4.0/phalcon/mvc/model/managerinterface.zep" class="btn btn-default btn-sm">Source on GitHub</a>

## Methods
abstract public  **initialize** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

...

abstract public  **setModelSource** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $source)

...

abstract public  **getModelSource** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

...

abstract public  **setModelSchema** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $schema)

...

abstract public  **getModelSchema** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

...

abstract public  **setConnectionService** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $connectionService)

...

abstract public  **setReadConnectionService** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $connectionService)

...

abstract public  **getReadConnectionService** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

...

abstract public  **setWriteConnectionService** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $connectionService)

...

abstract public  **getWriteConnectionService** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

...

abstract public  **getReadConnection** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

...

abstract public  **getWriteConnection** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

...

abstract public  **isInitialized** (*mixed* $modelName)

...

abstract public  **getLastInitialized** ()

...

abstract public  **load** (*mixed* $modelName, [*mixed* $newInstance])

...

abstract public  **addHasOne** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $fields, *mixed* $referencedModel, *mixed* $referencedFields, [*mixed* $options])

...

abstract public  **addBelongsTo** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $fields, *mixed* $referencedModel, *mixed* $referencedFields, [*mixed* $options])

...

abstract public  **addHasMany** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $fields, *mixed* $referencedModel, *mixed* $referencedFields, [*mixed* $options])

...

abstract public  **existsBelongsTo** (*mixed* $modelName, *mixed* $modelRelation)

...

abstract public  **existsHasMany** (*mixed* $modelName, *mixed* $modelRelation)

...

abstract public  **existsHasOne** (*mixed* $modelName, *mixed* $modelRelation)

...

abstract public  **getBelongsToRecords** (*mixed* $method, *mixed* $modelName, *mixed* $modelRelation, [Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $record, [*mixed* $parameters])

...

abstract public  **getHasManyRecords** (*mixed* $method, *mixed* $modelName, *mixed* $modelRelation, [Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $record, [*mixed* $parameters])

...

abstract public  **getHasOneRecords** (*mixed* $method, *mixed* $modelName, *mixed* $modelRelation, [Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $record, [*mixed* $parameters])

...

abstract public  **getBelongsTo** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

...

abstract public  **getHasMany** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

...

abstract public  **getHasOne** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

...

abstract public  **getHasOneAndHasMany** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

...

abstract public  **getRelations** (*mixed* $modelName)

...

abstract public  **getRelationsBetween** (*mixed* $first, *mixed* $second)

...

abstract public  **createQuery** (*mixed* $phql)

...

abstract public  **executeQuery** (*mixed* $phql, [*mixed* $placeholders])

...

abstract public  **createBuilder** ([*mixed* $params])

...

abstract public  **addBehavior** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, [Phalcon\Mvc\Model\BehaviorInterface](/3.4/api/phalcon_mvc_model_behavior/) $behavior)

...

abstract public  **notifyEvent** (*mixed* $eventName, [Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model)

...

abstract public  **missingMethod** ([Phalcon\Mvc\ModelInterface](/3.4/api/phalcon_mvc_model/) $model, *mixed* $eventName, *mixed* $data)

...

abstract public  **getLastQuery** ()

...

abstract public  **getRelationByAlias** (*mixed* $modelName, *mixed* $alias)

...

Source: https://docs.phalcon.io/3.4/api/phalcon_mvc_model_manager/index.mdx