MIGRATE FROM THE TYPO3 DATABASE WRAPPER TO THE DOCTRINE DBAL SYNTAX

Size: px

Start display at page:

Download "MIGRATE FROM THE TYPO3 DATABASE WRAPPER TO THE DOCTRINE DBAL SYNTAX"

Phebe Owens
6 years ago
Views:

1 Jans Blog INTERNET, TYPO3 MIGRATE FROM THE TYPO3 DATABASE WRAPPER TO THE DOCTRINE DBAL SYNTAX 14. APRIL 2016 JAN HELKE HINTERLASSE EINEN KOMMENTAR With the TYPO3 8.1 release, the Doctrine Database Abstraction Layer (DBAL will be introduced into the TYPO3 core. Sooner or later the old TYPO3 database wrapper (together with the old dbal and adodb extensions will be removed. So if you re an extension developer creating extensions for TYPO3 8.1 or above, it could come in handy to migrate all of your database calls to the new syntax. If your extension just relies on Extbase Repository stuff, then you are fine. The migration of Extbase will be done by the core itself so your magic functions will also work in the future. But in case you still have this dusty exec_se- LECTgetRows somewhere in your extension, I ll try to give you some help to come to the light side. I gained all my knowledge during migrating system extensions to the new syntax shortly after the initial merge of Doctrine DBAL into the core. So it s kinda cutting edge and not necessarily best practice. Most of this is pure Doctrine DBAL syntax, so if in doubt don t hesitate to check the Doctrine DBAL documentation for more detailed information [1]. Prerequisites The following examples assumes you create a query builder object like this for every query you want to build: // The use statements of course belong into the file header. use TYPO3\CMS\Core\Database\ConnectionPool; use TYPO3\CMS\Core\Database\Query\QueryBuilder; use TYPO3\CMS\Core\Utility\GeneralUtility; 1 von , 14:18

2 QueryBuilder $querybuilder */ $querybuilder = GeneralUtility::makeInstance(ConnectionPool::class ->getquerybuilderfortable('sys_log'; The query builder substitutes the custom getdatabaseconnection( wrapper method you most likely integrated in the past into your class to have proper code completion. Or, if your extension is that outdated, it will be somehow similar to $GLOBALS[ TYPO3_DB ]. It might seem to be a little bit odd to specify the table name here, because you will also write it down again in the query. But with Doctrine DBAL every table can be located in a different database and even on different database systems (e.g. MySQL, Oracle. This way the query builder instantly knows, what kind of table you want to address and can apply the database specific encapsulating and quoting later on. Examples how to migrate I try to cover most cases that were used in developers daily work. exec_selectgetrows That s the most basic function to select a couple of rows out of the database and provide them as a handy array. $rows = $this ->getdatabaseconnection( ->exec_selectgetrows( 'uid', 'pages, 'pid=123' ; You might realize the missing enablefields magic here. That is by purpose, because I want to get all rows from the database. That causes a couple of more characters in the migrated version because the Doctrine DBAL wrapper would take care of such stuff on it own. So before you can do the select, you have to configure the query context. If you just want to select all active elements skip this block. 2 von , 14:18

3 $querybuilder // Get the default configured query context. ->getquerycontext( // Ignore the enablefield stuff like hidden, starttime or endtime ->setignoreenablefields(true // And as deleted is by definition no enablefield of TYPO3, it must addressed separately ->setincludedeleted(true; Now you can start to build your query. $rows = $querybuilder // Select one ore more fields ->select('uid' // from a table ->from('pages' // that fits into this condition. ->where( // This looks a bit strange, but ensures that the condition is coded in the most suitable way for the database. $querybuilder->expr(->eq('pid', (int$elparts[1] // Run the query ->execute( // and fetch all results as an associative array. ->fetchall(; exec_selectcountrows TYPO3 DB wrapper style: $count = $this ->getdatabaseconnection( ->exec_selectcountrows( 'error', 'sys_log', 'tstamp >= '. $timestamp. 3 von , 14:18

4 ' AND error IN(-1,1,2'; Doctrine DBAL style: $count = $querybuilder // Invoke the native count command of the database ->count('error' // Table ->from('sys_log' // Every where( will overwrite the last one. So ->where($querybuilder->expr(->gte('tstamp', $timestamp // additional where clauses must be added with andwhere or orwhere ->andwhere($querybuilder->expr(->in('error', [-1, 1, 2] // Run the command ->execute( // After executing you would get a result set with one result. So we have to fetch the first result to get the actual count instead of the amount of results. ->fetchcolumn(0; exec_selectgetsinglerow If you just need a single result row, you replace $record = $this ->getdatabaseconnection( ->exec_selectgetsinglerow( '*', 'sys_history', '1=1; with the following $record = $querybuilder ->select('*' ->from('sys_history' 4 von , 14:18

5 // Yes, no where command here. Doctrine DBAL can build queries without where. Finally. ->execute( // This will fetch exactly on specified row out of the result. If no row is specified, it will fetch the first row. ->fetchcolumn(; exec_selectgetrows across different tables Now things start to become a little bit more complex. I have to join two tables. $rows = $databaseconnection->exec_selectgetrows( 'sys_history.*, sys_log.userid, sys_log.log_data', 'sys_history, sys_log', 'sys_history.sys_log_uid = sys_log.uid'. ' AND sys_history.tablename = '. $databaseconnection->fullquotestr($table, 'sys_history'. ' AND sys_history.recuid = '. (int$uid, '', 'sys_log.uid DESC', $this->maxsteps; Because old habits die hard (and I don t want to change the resulting SQL statement to avoid behavior changes I refused to rebuild it using the JOIN syntax. $rows = $querybuilder // Every argument is entered separately so Doctrine DBAL can take care of the encapsulation. ->select('sys_history.*', 'sys_log.userid', 'sys_log.log_data' // The first table ->from('sys_history' // and the second table. Every table gets an own from( command ->from('sys_log' ->where( $querybuilder->expr(->eq( // This joins the two tables. 'sys_history.sys_log_uid', $querybuilder->quoteidentifier('sys_log.uid' 5 von , 14:18

6 ->andwhere($querybuilder->expr(->eq('sys_history.tablename', // That is more sophisticated than just using the also possible quote( command, because quote( would cast everything to a string while createnamedparameter( will stay an object and will be more easy handleable for Doctrine DBAL during execution. $querybuilder->createnamedparameter($table ->andwhere($querybuilder->expr(->eq('sys_history.recuid', (int$uid // Kinda self explaining ->orderby('sys_log.uid', 'DESC' // This replaces the LIMIT statement ->setmaxresults($this->maxsteps ->execute( ->fetchall(; Some of you might realize at this point, that the call for callquerybuilderfortable( at the top of this article gets just one table name while I am fiddling around with multiple tables. That seems a little bit odd, but will work, because that would only be interesting, if both tables are located on different databases. Join database operations will not work across different databases. Nesting conditions Sometimes you want to nest conditions in the where statement like $rows = $databaseconnection ->exec_selectgetrows( 'uid, userid, action, tstamp, log_data', 'sys_log', 'type = 1 '. ' AND (action=1 OR action=3'. ' AND tablename = '. $databaseconnection->fullquotestr($table, 'sys_log'. ' AND recuid = '. (int$uid, '', 'uid DESC', $this->maxsteps; 6 von , 14:18

7 You can do this by just using the OR operator, because it is simple enough to work with all database systems ->andwhere( $querybuilder->expr(->eq('action', 1. ' OR '. $querybuilder->expr(->eq('action', 3 But the nicer way would look like ->andwhere( $querybuilder->expr(->orx( $querybuilder->expr(->eq('action', 1, $querybuilder->expr(->eq('action', 3 You can add as much values to orx( as you like. And it might not surprise you, that there is also an andx( function available. Insert, update and delete This is now pretty straight forward. TYPO3 syntax $this->getdatabaseconnection( ->exec_updatequery( 'sys_history', 'uid='. $uid, array( 'snapshot' =>!$row['snapshot'] ; is replaced by $querybuilder 7 von , 14:18

8 ->update('sys_history' ->where($querybuilder->expr(->eq('uid',$uid ->values( array( 'snapshot' =>!$row['snapshot'] ->execute(; The insert and delete statements work the same way. Show SQL query For debugging purposes you almost always need the possibility to show the exact SQL query. That s quite easy with Doctrine DBAL. Just remove the fetch command and replace execute( with getsql(. echo $querybuilder ->select('*' ->from('sys_history' ->getsql(; Last words Even if the new syntax look strange on first glance, it is easy to use, because it works the same way in every case. And the benefit of beging able to support more database systems while removing DBAL and adodb makes me happy. So. If you are, after reading this till the end, eager to gain some experience while supporting the TYPO3 core work, don t hesitate to pick yourself a piece of the cake. We have a LOT database statements to be replaced in the core and happy about every helping hand. Check out the Epic on Forge [2] to see, what happens until now, open a ticket for very your own playground and start contributing. Weiterführende Links [1] Lates Doctrine DBAL Documentation [2] TYPO3 Forge Doctrine DBAL migration Epic 8 von , 14:18

9 DBAL DOCTRINE EXTENSION 9 von , 14:18

Pl Sql Copy Table From One Schema To Another

Pl Sql Copy Table From One Schema To Another I know how to do this using MS SQL Server. you want to copy a table from one schema to another, or from one database to another, and keep the same table name.