Skip to content

Commit

Permalink
More dots added, some removed. Also a typo was removed.
Browse files Browse the repository at this point in the history
  • Loading branch information
bar committed Mar 6, 2014
1 parent 3f162b3 commit ff980a3
Show file tree
Hide file tree
Showing 3 changed files with 50 additions and 50 deletions.
66 changes: 33 additions & 33 deletions src/Database/Connection.php
Original file line number Diff line number Diff line change
Expand Up @@ -25,65 +25,65 @@
use Cake\Database\Query;

/**
* Represents a connection with a database server
* Represents a connection with a database server.
*/
class Connection {

use TypeConverterTrait;

/**
* Contains the configuration params for this connection
* Contains the configuration params for this connection.
*
* @var array
*/
protected $_config;

/**
* Driver object, responsible for creating the real connection
* and provide specific SQL dialect
* and provide specific SQL dialect.
*
* @var \Cake\Database\Driver
*/
protected $_driver;

/**
* Contains how many nested transactions have been started
* Contains how many nested transactions have been started.
*
* @var int
*/
protected $_transactionLevel = 0;

/**
* Whether a transaction is active in this connection
* Whether a transaction is active in this connection.
*
* @var int
*/
protected $_transactionStarted = false;

/**
* Whether this connection can and should use savepoints for nested
* transactions
* transactions.
*
* @var boolean
*/
protected $_useSavePoints = false;

/**
* Whether to log queries generated during this connection
* Whether to log queries generated during this connection.
*
* @var boolean
*/
protected $_logQueries = false;

/**
* Logger object instance
* Logger object instance.
*
* @var QueryLogger
*/
protected $_logger = null;

/**
* Constructor
* Constructor.
*
* @param array $config configuration for connecting to database
*/
Expand Down Expand Up @@ -133,7 +133,7 @@ public function configName() {
* Sets the driver instance. If an string is passed it will be treated
* as a class name and will be instantiated.
*
* If no params are passed it will return the current driver instance
* If no params are passed it will return the current driver instance.
*
* @param string|Driver $driver
* @param array|null $config Either config for a new driver or null.
Expand All @@ -158,7 +158,7 @@ public function driver($driver = null, $config = null) {
}

/**
* Connects to the configured database
* Connects to the configured database.
*
* @throws \Cake\Database\Exception\MissingConnectionException if credentials are invalid
* @return boolean true on success or false if already connected.
Expand All @@ -173,7 +173,7 @@ public function connect() {
}

/**
* Disconnects from database server
* Disconnects from database server.
*
* @return void
*/
Expand All @@ -182,7 +182,7 @@ public function disconnect() {
}

/**
* Returns whether connection to database server was already stablished
* Returns whether connection to database server was already established.
*
* @return boolean
*/
Expand All @@ -191,7 +191,7 @@ public function isConnected() {
}

/**
* Prepares a sql statement to be executed
* Prepares a SQL statement to be executed.
*
* @param string|\Cake\Database\Query $sql
* @return \Cake\Database\Statement
Expand All @@ -208,7 +208,7 @@ public function prepare($sql) {

/**
* Executes a query using $params for interpolating values and $types as a hint for each
* those params
* those params.
*
* @param string $query SQL to be executed and interpolated with $params
* @param array $params list or associative array of params to be interpolated in $query as values
Expand All @@ -227,7 +227,7 @@ public function execute($query, array $params = [], array $types = []) {
}

/**
* Executes a SQL statement and returns the Statement object as result
* Executes a SQL statement and returns the Statement object as result.
*
* @param string $sql
* @return \Cake\Database\Statement
Expand Down Expand Up @@ -257,7 +257,7 @@ public function schemaCollection() {
}

/**
* Executes an INSERT query on the specified table
* Executes an INSERT query on the specified table.
*
* @param string $table the table to update values in
* @param array $data values to be inserted
Expand All @@ -273,7 +273,7 @@ public function insert($table, array $data, array $types = []) {
}

/**
* Executes an UPDATE statement on the specified table
* Executes an UPDATE statement on the specified table.
*
* @param string $table the table to delete rows from
* @param array $data values to be updated
Expand All @@ -291,7 +291,7 @@ public function update($table, array $data, array $conditions = [], $types = [])
}

/**
* Executes a DELETE statement on the specified table
* Executes a DELETE statement on the specified table.
*
* @param string $table the table to delete rows from
* @param array $conditions conditions to be set for delete statement
Expand All @@ -305,7 +305,7 @@ public function delete($table, $conditions = [], $types = []) {
}

/**
* Starts a new transaction
* Starts a new transaction.
*
* @return void
*/
Expand All @@ -327,7 +327,7 @@ public function begin() {
}

/**
* Commits current transaction
* Commits current transaction.
*
* @return boolean true on success, false otherwise
*/
Expand All @@ -352,7 +352,7 @@ public function commit() {
}

/**
* Rollback current transaction
* Rollback current transaction.
*
* @return boolean
*/
Expand Down Expand Up @@ -384,7 +384,7 @@ public function rollback() {
* only if driver the allows it.
*
* If you are trying to enable this feature, make sure you check the return value of this
* function to verify it was enabled successfully
* function to verify it was enabled successfully.
*
* ## Example:
*
Expand All @@ -408,7 +408,7 @@ public function useSavePoints($enable = null) {
}

/**
* Creates a new save point for nested transactions
* Creates a new save point for nested transactions.
*
* @param string $name
* @return void
Expand All @@ -418,7 +418,7 @@ public function createSavePoint($name) {
}

/**
* Releases a save point by its name
* Releases a save point by its name.
*
* @param string $name
* @return void
Expand All @@ -428,7 +428,7 @@ public function releaseSavePoint($name) {
}

/**
* Rollback a save point by its name
* Rollback a save point by its name.
*
* @param string $name
* @return void
Expand All @@ -442,9 +442,9 @@ public function rollbackSavepoint($name) {
* while executing the passed callable, the transaction will be rolled back
* If the result of the callable function is ``false``, the transaction will
* also be rolled back. Otherwise the transaction is committed after executing
* the callback
* the callback.
*
* The callback will receive the connection instance as its first argument..
* The callback will receive the connection instance as its first argument.
*
* ### Example:
*
Expand Down Expand Up @@ -479,7 +479,7 @@ public function transactional(callable $callback) {
}

/**
* Quotes value to be used safely in database query
* Quotes value to be used safely in database query.
*
* @param mixed $value
* @param string $type Type to be used for determining kind of quoting to perform
Expand All @@ -491,7 +491,7 @@ public function quote($value, $type = null) {
}

/**
* Checks if the driver supports quoting
* Checks if the driver supports quoting.
*
* @return boolean
*/
Expand All @@ -501,7 +501,7 @@ public function supportsQuoting() {

/**
* Quotes a database identifier (a column name, table name, etc..) to
* be used safely in queries without the risk of using reserved words
* be used safely in queries without the risk of using reserved words.
*
* @param string $identifier
* @return string
Expand All @@ -522,7 +522,7 @@ public function logQueries($enable) {

/**
* Sets the logger object instance. When called with no arguments
* it returns the currently setup logger instance
* it returns the currently setup logger instance.
*
* @param object $instance logger object instance
* @return object logger instance
Expand All @@ -538,7 +538,7 @@ public function logger($instance = null) {
}

/**
* Logs a Query string using the configured logger object
* Logs a Query string using the configured logger object.
*
* @param string $sql string to be logged
* @return void
Expand Down
4 changes: 2 additions & 2 deletions src/Database/Query.php
Original file line number Diff line number Diff line change
Expand Up @@ -188,7 +188,7 @@ public function connection($connection = null) {
* to actually be executed. Immediately after, literal values are passed to the
* connection so they are bound to the query in a safe way. Finally, the resulting
* statement is decorated with custom objects to execute callbacks for each row
* is retrieved if necessary.
* retrieved if necessary.
*
* Resulting statement is traversable, so it can be used in any loop as you would
* with an array.
Expand Down Expand Up @@ -219,7 +219,7 @@ public function execute() {
* values when the query is executed, hence it is most suitable to use with
* prepared statements.
*
* @param ValueBinder $generator A placeholder a value binder object that will hold
* @param ValueBinder $generator A placeholder object that will hold
* associated values for expressions
* @return string
*/
Expand Down
Loading

0 comments on commit ff980a3

Please sign in to comment.