ADOdb

Database Abstraction Layer for PHP

User Tools

Site Tools

Trace:
v5:database:mysql

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
database:mysql [2015/11/28 00:16] – mnewnhamv5:database:mysql [2026/01/30 03:48] (current) – [Connecting With SSL] mnewnham
Line 2: Line 2:
 ~~NOTOC~~ ~~NOTOC~~
 ===== mysqli driver ===== ===== mysqli driver =====
 +
 <WRAP right box round 300px> <WRAP right box round 300px>
 +
 == Specification == == Specification ==
 ^Driver Name|mysqli| ^Driver Name|mysqli|
-^Data Provider|mysql((ADOdb version 5, in ADOdb version 6 this driver will become a data provider))|+^Data Provider|[[v5:userguide:learn_extensions:new_driver#Understanding The Data Provider|mysql]]|
 ^Status|Active((This driver is actively supported by ADOdb project members))| ^Status|Active((This driver is actively supported by ADOdb project members))|
 ^Windows|Yes| ^Windows|Yes|
Line 11: Line 13:
 ^ADOdb V5|Yes| ^ADOdb V5|Yes|
 ^ADOdb V6|Yes| ^ADOdb V6|Yes|
 +
 == Alternatives == == Alternatives ==
-[[database:pdo#pdo_mysql|PDO driver for MySQL]]+[[v5:database:pdo#pdo_mysql|PDO driver for MySQL]] 
 + 
 +== See Also == 
 +[[v5:reference:connection:setconnectionparameter#mysql|setConnectionParameter()]]
 </WRAP> </WRAP>
  
-** This is the preferred driver to connections to MySQL databases. ** +** This is the preferred driver for connections to the following databases:** 
-This preferred driver uses the PHP mysqli interface and supports all MySQL table types, with full support for transactions and rollback when the MySQL table type supports it.   +  * [[http://mysql.com|MySQL]] 
----------------------------------------------- +  * [[http://mariadb.com|MariaDB]] 
-===== mysql driver ===== +  * [[http://percona.com|Percona]] 
-<WRAP right box round 300px> + 
-== Specification == +This driver uses the PHP **mysqli** interface and supports all table types, with full support for transactions and rollback when the table type supports it.  
-^Driver Name|mysql| + 
-^Data Provider|mysql)| +It replaces [[v5:database:mysql_legacy|]] (**mysql**, **mysqlt** and **mysqlpo**). 
-^Status|Obsolete((This driver will be removed in ADOdb version 6))| + 
-^Windows|Yes| +<WRAP important> 
-^Unix|Yes| +Starting with ADOdb 5.22, the mysqli driver requires the [[https://www.php.net/manual/en/book.mysqlnd.php|MySQL Native Driver (Mysqlnd)]]
-^ADOdb V5|Yes| +
-^ADOdb V6|No|+
 </WRAP> </WRAP>
-This driver uses the PHP original mysql driver and only provides support to non-transactional tables such as MyIsam. It cannot be used with the PHP 'Improved' MySQL driver. The PHP driver is deprecated as of PHP Version 5.5 and will be removed in PHP version 7. This driver is deprecated as of ADOdb version 5.20 and will be removed in ADOdb version 6.0 + 
--------------------------------------------- + 
-===== mysqlt driver ===== +------------------------------------------- 
-<WRAP right box round 300px> +
-== Specification == +
-^Driver Name|mysqlt| +
-^Data Provider|mysql)| +
-^Status|Obsolete((This driver will be removed in ADOdb version 6))| +
-^Windows|Yes| +
-^Unix|Yes| +
-^ADOdb V5|Yes| +
-^ADOdb V6|No| +
-</WRAP> +
-This driver uses the PHP original mysql driver and provided support to transactional tables such as InnoDB. It cannot be used with the PHP 'improved' MySQL driver. The PHP driver is deprecated as of PHP Version 5.5 and will be removed in PHP version 7. This driver is deprecated as of ADOdb version 5.20 and will be removed in ADOdb version 6.0 +
--------------------------------- +
-===== mysqlpo driver ===== +
-<WRAP right box round 300px> +
-== Specification == +
-^Driver Name|mysqlpo| +
-^Data Provider|mysql)| +
-^Status|Obsolete((This driver will be removed in ADOdb version 6))| +
-^Windows|Yes| +
-^Unix|Yes| +
-^ADOdb V5|Yes| +
-^ADOdb V6|No| +
-</WRAP> +
-This driver duplicates the functionality of the mysqlt driver and is not maintained. It will be removed in ADOdb version 6.0 +
-------------------------------------------+
 ===== Driver Specific Issues ===== ===== Driver Specific Issues =====
 ==== renameColumnSql ==== ==== renameColumnSql ====
-The method [[dictionary:renameColumnSql|renameColumnSql]] normally takes 3 parameters, ''$tableName'',+The method [[v5:dictionary:renamecolumnsql|renameColumnSql]] normally takes 3 parameters, ''$tableName'',
 ''$oldColumnName'' and ''$newColumnName''. When used with the mysql provider, a full definition of the column must be provided, as if creating the column new ''$oldColumnName'' and ''$newColumnName''. When used with the mysql provider, a full definition of the column must be provided, as if creating the column new
 ==== Usage ==== ==== Usage ====
Line 72: Line 52:
  
 $sql = $dict->renameColumnSql($table,'col9','col6', $flds); $sql = $dict->renameColumnSql($table,'col9','col6', $flds);
-</code>  +</code> 
-{{tag>[MySQL windows unix supported]}}+==== Connecting With SSL ==== 
 +From ADOdb version 5.23.10, you make an SSL connection to MySQL in the following way: 
 + 
 +<code php> 
 +/* 
 +* Enable ADOdb 
 +*/ 
 +$db = newAdoConnection('mysqli'); 
 +/* 
 +* Set the SSL parameters 
 +*/ 
 +$db->setConnectionParameter('ssl',[ 
 +    'key' => "key.pem", 
 +    'cert' => "cert.pem", 
 +    'ca' => "cacert.pem", 
 +    'capath' => null,  
 +    'cipher' => null 
 +    ] 
 +); 
 + 
 +/* 
 +* Open the connection 
 +*/ 
 +$db->connect($host, $user, $password, $database); 
 +</code> 
 + 
 +==== Connecting To A Microsoft Azure MySQL Instance ==== 
 +<code php> 
 +/* 
 +* Enable ADOdb 
 +*/ 
 +$db = newAdoConnection('mysqli'); 
 + 
 +$database = 'employees'; 
 +$host     = 'my-corporation.mysql.database.azure.com'; 
 +$user     = 'corpuser'; 
 +$password = 'Qzrt6r55geRt!'; 
 + 
 +$db->setConnectionParameter( 
 +    'ssl',  
 +    [ 
 +     'ca'=>'/opt/certs/DigiCertGlobalRootG2-combined.crt.pem' 
 +    ] 
 +); 
 + 
 +$db->setConnectionParameter( 
 +    'clientflags', MYSQLI_CLIENT_SSL_VERIFY_SERVER_CERT 
 +); 
 +  
 +/* 
 +* Open the connection 
 +*/ 
 +$db->connect($host, $user, $password, $database); 
 +</code> 
 + 
 +==== Forcing emulated prepared statements ==== 
 + 
 +ADOdb 5.22 introduced support for "true" bound variables in prepared statements((using  
 +[[https://www.php.net/manual/en/mysqli-stmt.execute.php|mysqli_stmt_execute()]],  
 +see [[https://github.com/ADOdb/ADOdb/pull/655|issue #655]])).  
 +Before that, parameterized queries were emulated, which was a potential security risk. 
 + 
 +When using database engines pretending to be MySQL but not implementing prepared statements such as 
 +[[https://clickhouse.com/|ClickHouse]] and  
 +[[https://manticoresearch.com/|Manticore Search]],  
 +it is possible((starting with ADOdb 5.22.8)) to force usage of emulated queries (i.e. reverting to behavior of ADOdb 5.21 and older) by setting the ''doNotUseBoundVariables'' property. 
 + 
 +<code php> 
 +$db = newAdoConnection('mysqli'); 
 +$db->doNotUseBoundVariables = true; 
 +$db->connect($host, $user, $password, $database); 
 +$db->execute($sql, $param); 
 +</code> 
 + 
 +{{tag>MySQL windows unix supported tier1}} 
 +{{htmlmetatags>metatag-keywords=(php, programming, database, mysql, percona, mariadb)}} 
v5/database/mysql.1448666177.txt.gz · Last modified: (external edit)