1
0
mirror of synced 2024-12-15 23:56:02 +03:00
doctrine2/manual/docs/Configuration - Setting attributes - Identifier quoting.php

60 lines
1.5 KiB
PHP
Raw Normal View History

2007-04-14 01:49:11 +04:00
You can quote the db identifiers (table and field names) with quoteIdentifier(). The delimiting style depends on which database driver is being used. NOTE: just because you CAN use delimited identifiers, it doesn't mean you SHOULD use them. In general, they end up causing way more problems than they solve. Anyway, it may be necessary when you have a reserved word as a field name (in this case, we suggest you to change it, if you can).
Some of the internal Doctrine methods generate queries. Enabling the "quote_identifier" attribute of Doctrine you can tell Doctrine to quote the identifiers in these generated queries. For all user supplied queries this option is irrelevant.
Portability is broken by using the following characters inside delimited identifiers:
* backtick (`) -- due to MySQL
* double quote (") -- due to Oracle
* brackets ([ or ]) -- due to Access
Delimited identifiers are known to generally work correctly under the following drivers:
* Mssql
* Mysql
* Oracle
* Pgsql
* Sqlite
* Firebird
When using the quoteIdentifiers option, all of the field identifiers will be automatically quoted in the resulting SQL statements:
<code type="php">
\$conn->setAttribute('quote_identifiers', true);
?></code>
will result in a SQL statement that all the field names are quoted with the backtick '`' operator (in MySQL).
<div class='sql'>SELECT * FROM `sometable` WHERE `id` = '123'</div>
as opposed to:
<div class='sql'>SELECT * FROM sometable WHERE id='123'</div>