CakePHP
  • Documentation
    • Book
    • API
    • Videos
    • Logos & Trademarks
  • Business Solutions
  • Swag
  • Road Trip
  • Team
  • Community
    • Community
    • Team
    • Issues (Github)
    • YouTube Channel
    • Get Involved
    • Bakery
    • Featured Resources
    • Newsletter
    • Certification
    • My CakePHP
    • CakeFest
    • Facebook
    • Twitter
    • Help & Support
    • Forum
    • Stack Overflow
    • IRC
    • Slack
    • Paid Support
CakePHP

C CakePHP 3.8 Red Velvet API

  • Overview
  • Tree
  • Deprecated
  • Version:
    • 3.8
      • 3.8
      • 3.7
      • 3.6
      • 3.5
      • 3.4
      • 3.3
      • 3.2
      • 3.1
      • 3.0
      • 2.10
      • 2.9
      • 2.8
      • 2.7
      • 2.6
      • 2.5
      • 2.4
      • 2.3
      • 2.2
      • 2.1
      • 2.0
      • 1.3
      • 1.2

Namespaces

  • Cake
    • Auth
      • Storage
    • Cache
      • Engine
    • Collection
      • Iterator
    • Command
    • Console
      • Exception
    • Controller
      • Component
      • Exception
    • Core
      • Configure
        • Engine
      • Exception
      • Retry
    • Database
      • Driver
      • Exception
      • Expression
      • Schema
      • Statement
      • Type
    • Datasource
      • Exception
    • Error
      • Middleware
    • Event
      • Decorator
    • Filesystem
    • Form
    • Http
      • Client
        • Adapter
        • Auth
      • Cookie
      • Exception
      • Middleware
      • Session
    • I18n
      • Formatter
      • Middleware
      • Parser
    • Log
      • Engine
    • Mailer
      • Exception
      • Transport
    • Network
      • Exception
    • ORM
      • Association
      • Behavior
        • Translate
      • Exception
      • Locator
      • Rule
    • Routing
      • Exception
      • Filter
      • Middleware
      • Route
    • Shell
      • Helper
      • Task
    • TestSuite
      • Fixture
      • Stub
    • Utility
      • Exception
    • Validation
    • View
      • Exception
      • Form
      • Helper
      • Widget
  • None

Classes

  • Mysql
  • Postgres
  • Sqlite
  • Sqlserver

Traits

  • PDODriverTrait

Class Mysql

Class Mysql

Cake\Database\Driver implements Cake\Database\DriverInterface
Extended by Cake\Database\Driver\Mysql uses Cake\Database\Dialect\MysqlDialectTrait
Namespace: Cake\Database\Driver
Location: Database/Driver/Mysql.php

Properties summary

  • $_baseConfig protected
    array
    Base configuration settings for MySQL driver
  • $_supportsNativeJson protected
    boolean
    Whether or not the server supports native JSON
  • $_version protected
    string
    The server version

Inherited Properties

  • _autoQuoting, _config, _connection _endQuote, _schemaDialect, _startQuote

Method Summary

  • connect() public
    Establishes a connection to the database server
  • enabled() public
    Returns whether php is able to use this driver for connecting to database
  • prepare() public
    Prepares a sql statement to be executed
  • schema() public
    Returns the schema name that's being used.
  • supportsDynamicConstraints() public

    Returns whether the driver supports adding or dropping constraints to already created tables.

  • supportsNativeJson() public
    Returns true if the server supports native JSON columns

Method Detail

connect() public ¶

connect( )

Establishes a connection to the database server

Returns
boolean
true on success

enabled() public ¶

enabled( )

Returns whether php is able to use this driver for connecting to database

Returns
boolean
true if it is valid to use this driver

prepare() public ¶

prepare( string|Cake\Database\Query $query )

Prepares a sql statement to be executed

Parameters
string|Cake\Database\Query $query
The query to prepare.
Returns
Cake\Database\StatementInterface
Overrides
Cake\Database\Driver::prepare()

schema() public ¶

schema( )

Returns the schema name that's being used.

Returns
string
Overrides
Cake\Database\Driver::schema()

supportsDynamicConstraints() public ¶

supportsDynamicConstraints( )

Returns whether the driver supports adding or dropping constraints to already created tables.

Returns
boolean
true if driver supports dynamic constraints.

supportsNativeJson() public ¶

supportsNativeJson( )

Returns true if the server supports native JSON columns

Returns
boolean

Methods inherited from Cake\Database\Driver

__construct() public ¶

__construct( array $config = [] )

Constructor

Parameters
array $config optional []
The configuration for the driver.
Throws
InvalidArgumentException

__debugInfo() public ¶

__debugInfo( )

Returns an array that can be used to describe the internal state of this object.

Returns
array

__destruct() public ¶

__destruct( )

Destructor

_connect() protected ¶

_connect( string $dsn , array $config )

Establishes a connection to the database server

Parameters
string $dsn
A Driver-specific PDO-DSN
array $config
configuration to be used for creating connection
Returns
boolean
true on success

autoQuoting() public deprecated ¶

autoQuoting( boolean|null $enable = null )

Returns whether or not this driver should automatically quote identifiers in queries

If called with a boolean argument, it will toggle the auto quoting setting to the passed value

Deprecated
3.4.0 use enableAutoQuoting()/isAutoQuotingEnabled() instead.
Parameters
boolean|null $enable optional null
Whether to enable auto quoting
Returns
boolean

beginTransaction() public ¶

beginTransaction( )

Starts a transaction.

Returns
boolean
True on success, false otherwise.
Implementation of
Cake\Database\DriverInterface::beginTransaction()

commitTransaction() public ¶

commitTransaction( )

Commits a transaction.

Returns
boolean
True on success, false otherwise.
Implementation of
Cake\Database\DriverInterface::commitTransaction()

compileQuery() public ¶

compileQuery( Cake\Database\Query $query , Cake\Database\ValueBinder $generator )

Transforms the passed query to this Driver's dialect and returns an instance of the transformed query and the full compiled SQL string.

Parameters
Cake\Database\Query $query
The query to compile.
Cake\Database\ValueBinder $generator
The value binder to use.
Returns
array

containing 2 entries. The first entity is the transformed query and the second one the compiled SQL.


Implementation of
Cake\Database\DriverInterface::compileQuery()

connection() public deprecated ¶

connection( mixed $connection = null )

Returns correct connection resource or object that is internally used If first argument is passed, it will set internal connection object or result to the value passed.

Deprecated
3.6.0 Use getConnection()/setConnection() instead.
Parameters
mixed $connection optional null
The PDO connection instance.
Returns
mixed
Connection object used internally.

disableAutoQuoting() public ¶

disableAutoQuoting( )

Disable auto quoting of identifiers in queries.

Returns

$this

disableForeignKeySQL() abstract public ¶

disableForeignKeySQL( )

Get the SQL for disabling foreign keys.

Returns
string
Implementation of
Cake\Database\DriverInterface::disableForeignKeySQL()

disconnect() public ¶

disconnect( )

Disconnects from database server.

Implementation of
Cake\Database\DriverInterface::disconnect()

enableAutoQuoting() public ¶

enableAutoQuoting( boolean $enable = true )

Sets whether or not this driver should automatically quote identifiers in queries.

Parameters
boolean $enable optional true
Whether to enable auto quoting
Returns

$this
Implementation of
Cake\Database\DriverInterface::enableAutoQuoting()

enableForeignKeySQL() abstract public ¶

enableForeignKeySQL( )

Get the SQL for enabling foreign keys.

Returns
string
Implementation of
Cake\Database\DriverInterface::enableForeignKeySQL()

getConnection() public ¶

getConnection( )

Get the internal PDO connection instance.

Returns
PDO
Implementation of
Cake\Database\DriverInterface::getConnection()

isAutoQuotingEnabled() public ¶

isAutoQuotingEnabled( )

Returns whether or not this driver should automatically quote identifiers in queries.

Returns
boolean
Implementation of
Cake\Database\DriverInterface::isAutoQuotingEnabled()

isConnected() public ¶

isConnected( )

Checks whether or not the driver is connected.

Returns
boolean
Implementation of
Cake\Database\DriverInterface::isConnected()

lastInsertId() public ¶

lastInsertId( string|null $table = null , string|null $column = null )

Returns last id generated for a table or sequence in database.

Parameters
string|null $table optional null
table name or sequence to get last insert value from.
string|null $column optional null
the name of the column representing the primary key.
Returns
string|integer
Implementation of
Cake\Database\DriverInterface::lastInsertId()

newCompiler() public ¶

newCompiler( )

Returns an instance of a QueryCompiler.

Returns
Cake\Database\QueryCompiler
Implementation of
Cake\Database\DriverInterface::newCompiler()

queryTranslator() abstract public ¶

queryTranslator( string $type )

Returns a callable function that will be used to transform a passed Query object. This function, in turn, will return an instance of a Query object that has been transformed to accommodate any specificities of the SQL dialect in use.

Parameters
string $type

The type of query to be transformed (select, insert, update, delete).

Returns
callable
Implementation of
Cake\Database\DriverInterface::queryTranslator()

quote() public ¶

quote( mixed $value , string $type )

Returns a value in a safe representation to be used in a query string

Parameters
mixed $value
The value to quote.
string $type
Type to be used for determining kind of quoting to perform.
Returns
string
Implementation of
Cake\Database\DriverInterface::quote()

quoteIdentifier() abstract public ¶

quoteIdentifier( string $identifier )

Quotes a database identifier (a column name, table name, etc..) to be used safely in queries without the risk of using reserved words.

Parameters
string $identifier
The identifier expression to quote.
Returns
string
Implementation of
Cake\Database\DriverInterface::quoteIdentifier()

releaseSavePointSQL() abstract public ¶

releaseSavePointSQL( string $name )

Get the SQL for releasing a save point.

Parameters
string $name
The table name.
Returns
string
Implementation of
Cake\Database\DriverInterface::releaseSavePointSQL()

rollbackSavePointSQL() abstract public ¶

rollbackSavePointSQL( string $name )

Get the SQL for rollingback a save point.

Parameters
string $name
The table name.
Returns
string
Implementation of
Cake\Database\DriverInterface::rollbackSavePointSQL()

rollbackTransaction() public ¶

rollbackTransaction( )

Rollbacks a transaction.

Returns
boolean
True on success, false otherwise.
Implementation of
Cake\Database\DriverInterface::rollbackTransaction()

savePointSQL() abstract public ¶

savePointSQL( string $name )

Get the SQL for creating a save point.

Parameters
string $name
The table name.
Returns
string
Implementation of
Cake\Database\DriverInterface::savePointSQL()

schemaDialect() abstract public ¶

schemaDialect( )

Get the schema dialect.

Returns
Cake\Database\Schema\BaseSchema
Implementation of
Cake\Database\DriverInterface::schemaDialect()

schemaValue() public ¶

schemaValue( mixed $value )

Escapes values for use in schema definitions.

Parameters
mixed $value
The value to escape.
Returns
string
String for use in schema definitions.
Implementation of
Cake\Database\DriverInterface::schemaValue()

setConnection() public ¶

setConnection( PDO $connection )

Set the internal PDO connection instance.

Parameters
PDO $connection
PDO instance.
Returns

$this
Implementation of
Cake\Database\DriverInterface::setConnection()

supportsQuoting() public ¶

supportsQuoting( )

Checks if the driver supports quoting, as PDO_ODBC does not support it.

Returns
boolean
Implementation of
Cake\Database\DriverInterface::supportsQuoting()

supportsSavePoints() public ¶

supportsSavePoints( )

Returns whether this driver supports save points for nested transactions.

Returns
boolean
True if save points are supported, false otherwise.
Implementation of
Cake\Database\DriverInterface::supportsSavePoints()

Methods used from Cake\Database\Dialect\MysqlDialectTrait

disableForeignKeySQL() public ¶

disableForeignKeySQL( )

enableForeignKeySQL() public ¶

enableForeignKeySQL( )

schemaDialect() public ¶

schemaDialect( )

Get the schema dialect.

Used by Cake\Database\Schema package to reflect schema and generate schema.

Returns
Cake\Database\Schema\MysqlSchema

Properties detail

$_baseConfig ¶

protected array

Base configuration settings for MySQL driver

[
    'persistent' => true,
    'host' => 'localhost',
    'username' => 'root',
    'password' => '',
    'database' => 'cake',
    'port' => '3306',
    'flags' => [],
    'encoding' => 'utf8mb4',
    'timezone' => null,
    'init' => [],
]

$_supportsNativeJson ¶

protected boolean

Whether or not the server supports native JSON

$_version ¶

protected string

The server version

Follow @CakePHP
#IRC
OpenHub
Rackspace
  • Business Solutions
  • Showcase
  • Documentation
  • Book
  • API
  • Videos
  • Logos & Trademarks
  • Community
  • Team
  • Issues (Github)
  • YouTube Channel
  • Get Involved
  • Bakery
  • Featured Resources
  • Newsletter
  • Certification
  • My CakePHP
  • CakeFest
  • Facebook
  • Twitter
  • Help & Support
  • Forum
  • Stack Overflow
  • IRC
  • Slack
  • Paid Support

Generated using CakePHP API Docs