41 lines
2.1 KiB
ReStructuredText
41 lines
2.1 KiB
ReStructuredText
|
Multiple Connections
|
|||
|
|
====================
|
|||
|
|
|
|||
|
|
Paris now works with multiple database conections (and necessarily relies on an updated version of Idiorm that also supports multiple connections). Database connections are identified by a string name, and default to ``OrmWrapper::DEFAULT_CONNECTION`` (which is really ``ORM::DEFAULT_CONNECTION``).
|
|||
|
|
|
|||
|
|
See `Idiorm’s documentation`_ for information about configuring multiple connections.
|
|||
|
|
|
|||
|
|
The connection to use can be specified in two separate ways. To indicate a default connection key for a subclass of ``Model``, create a public static property in your model class called ``$_connection_name``.
|
|||
|
|
|
|||
|
|
.. code-block:: php
|
|||
|
|
|
|||
|
|
<?php
|
|||
|
|
// A named connection, where 'alternate' is an arbitray key name
|
|||
|
|
ORM::configure('sqlite:./example2.db', null, 'alternate');
|
|||
|
|
|
|||
|
|
class SomeClass extends Model
|
|||
|
|
{
|
|||
|
|
public static $_connection_name = 'alternate';
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
The connection to use can also be specified as an optional additional parameter to ``OrmWrapper::for_table()``, or to ``Model::factory()``. This will override the default setting (if any) found in the ``$_connection_name`` static property.
|
|||
|
|
|
|||
|
|
.. code-block:: php
|
|||
|
|
|
|||
|
|
<?php
|
|||
|
|
$person = Model::factory('Author', 'alternate')->find_one(1); // Uses connection named 'alternate'
|
|||
|
|
|
|||
|
|
The connection can be changed after a model is populated, should that be necessary:
|
|||
|
|
|
|||
|
|
.. code-block:: php
|
|||
|
|
|
|||
|
|
<?php
|
|||
|
|
$person = Model::factory('Author')->find_one(1); // Uses default connection
|
|||
|
|
$person->orm = Model::factory('Author', 'alternate'); // Switches to connection named 'alternate'
|
|||
|
|
$person->name = 'Foo';
|
|||
|
|
$person->save(); // *Should* now save through the updated connection
|
|||
|
|
|
|||
|
|
Queries across multiple connections are not supported. However, as the Paris methods ``has_one``, ``has_many`` and ``belongs_to`` don't require joins, these *should* work as expected, even when the objects on opposite sides of the relation belong to diffrent connections. The ``has_many_through`` relationship requires joins, and so will not reliably work across different connections.
|
|||
|
|
|
|||
|
|
.. _Idiorm’s documentation: http://github.com/j4mie/idiorm/
|