Skip to content

Commit

Permalink
added docs about DB table and column quoting
Browse files Browse the repository at this point in the history
  • Loading branch information
samdark committed Jul 3, 2013
1 parent 33285c5 commit 96184c2
Showing 1 changed file with 24 additions and 1 deletion.
25 changes: 24 additions & 1 deletion docs/guide/database-basics.md
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,7 @@ $command = $connection->createCommand('UPDATE tbl_post SET status=1 WHERE id=1')
$command->execute();
```

Alternatively the following syntax is possible:
Alternatively the following syntax that takes care of proper table and column names quoting is possible:

```php
// INSERT
Expand All @@ -130,6 +130,29 @@ $connection->createCommand()->update('tbl_user', array(
$connection->createCommand()->delete('tbl_user', 'status = 0')->execute();
```

Quoting table and column names
------------------------------

If you are building query string dynamically make sure you're properly quoting table and column names using
[[\yii\db\Connection::quoteTableName()]] and [[\yii\db\Connection::quoteColumnName()]]:

```php
$column = $connection->quoteColumnName($column);
$table = $connection->quoteTableName($table);
$sql = "SELECT COUNT($column) FROM $table";
$rowCount = $connection->createCommand($sql)->queryScalar();
```

Alternatively you can use special syntax when writing SQL:

```php
$sql = "SELECT COUNT({{$column}}) FROM [[$table]]";
$rowCount = $connection->createCommand($sql)->queryScalar();
```

In the code above `{{X}}` will be converted to properly quoted column name while `[[Y]]` will be converted to properly
quoted table name.


Prepared statements
-------------------
Expand Down

0 comments on commit 96184c2

Please sign in to comment.