13840516a9
html->wiki conversion previously missed
82 lines
2.3 KiB
PHP
82 lines
2.3 KiB
PHP
|
|
Doctrine supports sequences for generating record identifiers. Sequences are a way of offering unique IDs for data rows. If you do most of your work with e.g. MySQL, think of sequences as another way of doing AUTO_INCREMENT.
|
|
|
|
|
|
|
|
Doctrine knows how to do sequence generation in the background so you don't have to worry about calling database specific queries - Doctrine does it for you, all you need to do
|
|
is define a column as a sequence column and optionally provide the name of the sequence table and the id column name of the sequence table.
|
|
|
|
|
|
|
|
Consider the following record definition:
|
|
|
|
|
|
|
|
<code type="php">
|
|
class Book extends Doctrine_Record {
|
|
public function setTableDefinition()
|
|
{
|
|
\$this->hasColumn('id', 'integer', null, array('primary', 'sequence'));
|
|
\$this->hasColumn('name', 'string');
|
|
}
|
|
}
|
|
?></code>
|
|
|
|
|
|
|
|
By default Doctrine uses the following format for sequence tables [tablename]_seq. If you wish to change this you can use the following
|
|
piece of code to change the formatting:
|
|
|
|
|
|
|
|
<code type="php">
|
|
\$manager = Doctrine_Manager::getInstance();
|
|
\$manager->setAttribute(Doctrine::ATTR_SEQNAME_FORMAT,
|
|
'%s_my_seq');
|
|
?></code>
|
|
|
|
|
|
|
|
Doctrine uses column named id as the sequence generator column of the sequence table. If you wish to change this globally (for all connections and all tables)
|
|
you can use the following code:
|
|
|
|
|
|
|
|
<code type="php">
|
|
\$manager = Doctrine_Manager::getInstance();
|
|
\$manager->setAttribute(Doctrine::ATTR_SEQCOL_NAME,
|
|
'my_seq_column');
|
|
?></code>
|
|
|
|
|
|
|
|
In the following example we do not wish to change global configuration we just want to make the id column to use sequence table called
|
|
book_sequence. It can be done as follows:
|
|
|
|
|
|
<code type="php">
|
|
class Book extends Doctrine_Record {
|
|
public function setTableDefinition()
|
|
{
|
|
\$this->hasColumn('id', 'integer', null, array('primary', 'sequence' => 'book_sequence'));
|
|
\$this->hasColumn('name', 'string');
|
|
}
|
|
}
|
|
?></code>
|
|
|
|
|
|
|
|
Here we take the preceding example a little further: we want to have a custom sequence column. Here it goes:
|
|
|
|
|
|
<code type="php">
|
|
class Book extends Doctrine_Record {
|
|
public function setTableDefinition()
|
|
{
|
|
\$this->hasColumn('id', 'integer', null, array('primary', 'sequence' => array('book_sequence', 'sequence')));
|
|
\$this->hasColumn('name', 'string');
|
|
}
|
|
}
|
|
?></code>
|
|
|