Mit der TYPO3 Version 8 wurde mit Doctrine eine Datenbankabstraktionsschicht in das System integriert. Alle bisherigen Datenbankaufrufe im Core wurden entsprechend konventiert. Nun sind die Extension-Entwickler dran, die Technologie zu nutzen. Dabei sollte man sich nicht abschrecken lassen. Die neuen Funktionen sind bei unseren Symfony-Entwicklern bereits bekannt und leicht zu erlernen.<\/p>\n
Unser erster Blog-Beitrag zur Weihnachtszeit ist ein kleines Geschenk f\u00fcr TYPO3-Entwickler. Kurz vor der Ver\u00f6ffentlichung von TYPO3 9.0 geben wir Ihnen einen Einblick in Doctrine mit allerhand Beispielen.<\/p>\n
Das Doctrine\u00a0Projekt<\/a> beinhaltet verschiedene PHP-Bibliotheken, deren prim\u00e4rer Fokus auf Datenbanken und Objekt-Mapping liegt. Zu den Kernprojekten geh\u00f6ren der Object Relational Mapper (ORM) und der Database Abstraction Layer (DBAL, deutsch: Datenbankabstraktionsschicht).<\/p>\n Einfach gesagt dient Doctrine dazu eine Ebene zwischen PHP und Datenbank zu schaffen. Der Einsatz dieser Ebene erm\u00f6glicht es mit ein und denselben PHP-Aufrufen unterschiedliche Datenbankmanagementsysteme (DBMS) anzusprechen. Zu diesen Systemen geh\u00f6ren derzeit u.a. MySQL, Oracle, PostgreSQL und Microsoft SQL Server. Dadurch ist die PHP-Anwendung und deren Entwickler weitestgehend unabh\u00e4ngig von dem System der Datenbank.<\/p>\n Weitere Vorteile von Doctrine sind laut der eigenen Webseite:<\/p>\n Doch wie wurde Doctrine in TYPO3 integriert? Das beleuchten wir im n\u00e4chsten Abschnitt.<\/p>\n Eine Datenbankabstraktionsschicht ist in TYPO3 kein neues Anliegen. Bisher gab es die Erweiterungen dbal<\/em> und\u00a0adodb<\/em>, welche Teil des TYPO3-Kerns waren. Allerdings mussten sie erst bei bedarf aktiviert werden. Standardm\u00e4\u00dfig wurde TYPO3 mit MySQL betrieben. Durch die Erweiterungen war es m\u00f6glich weitere DBMS zu nutzen. Nun soll daf\u00fcr Doctrine zum Einsatz kommen. Deswegen wurden die dbal<\/em> und adodb<\/em> aus dem Kern entfernt. Wer sie dennoch ben\u00f6tigt, kann sie im TYPO3 Extension Repository (TER)<\/a> herunterladen und installieren.<\/p>\n Nun aber zur\u00fcck aus der Vergangenheit hinein in die Zukunft. Ein wesentliches Feature der TYPO3 Version 8.7 LTS ist die Nutzung von Doctrine. Dazu wurden bis Version 8.4 alle Datenbankzugriffe im Kern umgeschrieben. Am einfachsten lassen sich die dazugeh\u00f6rigen \u00c4nderungen anhand von Praxisbeispielen zeigen.<\/p>\n Bisher wurden Datenbankzugriffe \u00fcber die Variable $GLOBALS[‚TYPO3_DB‘] abgelbildet. Diese ist eine Instanz der PHP-Klasse\u00a0DatabaseConnection. Diese Klasse existiert weiterhin in TYPO3 Version 8, wird allerdings in TYPO3 Version 9 entfernt. Somit wird ein Umstieg auf Doctrine f\u00fcr Entwickler unausweichlich.<\/p>\n Doch kein Grund zur Panik. Wer in einem Extbase-Repository bereits eine Abfrage implementiert hat, wird sich an die neue Syntax schnell gew\u00f6hnen.<\/p>\n Die wichtigsten Klassen im Umgang mit Doctrine in TYPO3 hei\u00dfen ConnectionPool und\u00a0QueryBuilder. Die erste wird dazu genutzt, um eine Verbindung zu einer Tabelle aufzubauen oder einen QueryBuilder zu instanzieren. Dieser wiederrum dient dazu komplexe Abfragen aufzubauen.<\/p>\n Eine Verbindung kann f\u00fcr kleine Abfragen genutzt werden, der QueryBuilder f\u00fcr komplexe. In der Praxis sieht das dann wie folgt aus.<\/p>\n Hier sehen Sie bereits ein relativ komplexes Beispiel einer Select-Abfrage. Allerdings l\u00e4sst es sich einfach lesen. Bei einigen Ausdr\u00fccken, wie\u00a0 Mit Alle m\u00f6glichen Ausdr\u00fccke f\u00fcr die Verkn\u00fcpfung von Tabellen lauten: Jede Eingabe<\/strong>, egal woher sie kommt ist mit createNamedParameter abzusichern! Dar\u00fcberhinaus ist darauf zu achten, dass bei Wie diese Funktion bereits durch ihren Namen verr\u00e4t, dient sie dazu m\u00f6gliche Platzhalter, welche bei einer Like-Abfrage genutzt werden k\u00f6nnen, entsprechend abzufangen.<\/p>\n Analog dazu kann die Methode getParameters() genutzt werden. Mit ihr erf\u00e4hrt der Entwickler, mit welchen Werten die Platzhalter in den Statements belegt werden.<\/p>\n Weitere ausf\u00fchrliche Beispiele finden Sie in der TYPO3-Dokumentation<\/a>. Wir hoffen, dass wir Ihnen einen soliden Einblick in Doctrine geben konnten. Unsere eigenen Extensions wie die cs_seo<\/a> oder cs_youtube_data<\/a> werden wir zeitnah an die TYPO3 Version 9 anpassen. Sollten Sie Anregungen oder Fragen zum Thema haben, hinterlassen Sie gerne einen Kommentar oder nehmen Sie Kontakt<\/a> mit uns auf.<\/p>\n","protected":false},"excerpt":{"rendered":" Die Zukunft der Datenbankaufraufe in TYPO3<\/p>\n","protected":false},"author":7,"featured_media":2652,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[135],"tags":[23,142,45,98,9],"class_list":["post-2489","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-cms","tag-cms","tag-datenbank","tag-entwicklung","tag-php","tag-typo3"],"acf":[],"yoast_head":"\n\n
Doctrine und TYPO3<\/h2>\n
Praxisbeispiele und CodeSnippets<\/h2>\n
use TYPO3\\CMS\\Core\\Database\\ConnectionPool;\r\nuse TYPO3\\CMS\\Core\\Database\\Query\\QueryBuilder;\r\nuse TYPO3\\CMS\\Core\\Utility\\GeneralUtility;\r\n\r\n\/\/\u00a0Query Builder f\u00fcr eine Tabelle instanzieren\r\n$queryBuilder\u00a0=\u00a0GeneralUtility::makeInstance(ConnectionPool::class)\r\n ->getQueryBuilderForTable('tt_content');\r\n\r\n\/\/\u00a0oder eine Verbindung aufbauen\r\n$connection\u00a0=\u00a0GeneralUtility::makeInstance(ConnectionPool::class)\r\n ->getConnectionForTable('tt_content');<\/pre>\nSelect – Abfrage von Datens\u00e4tzen<\/h3>\n
\/** @var QueryBuilder $queryBuilder *\/\r\n$queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)\r\n ->getQueryBuilderForTable($table);\r\n\r\n$limit = 4;\r\n$offset = 0;\r\n\r\n$data = $queryBuilder\r\n ->select('*')\r\n ->from($table)\r\n ->where($queryBuilder->expr()->eq('deleted', 0))\r\n ->orWhere(\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0$queryBuilder->expr()->like(\r\n 'teaser', \r\n '%' . $queryBuilder->escapeLikeWildcards($search) . '%'\r\n ),\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0$queryBuilder->expr()->like(\r\n 'bodytext', \r\n '%' . $queryBuilder->escapeLikeWildcards($search) . '%'\r\n )\r\n\u00a0\u00a0\u00a0)\r\n ->andWhere(\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0$queryBuilder->expr()->eq(\r\n 'pid',\u00a0\r\n $queryBuilder->createNamedParameter($pid, \\PDO::PARAM_INT)\r\n )\r\n\u00a0\u00a0\u00a0)\r\n ->orderBy('date', 'DESC')->addOrderBy('title')\r\n ->groupBy('author')\r\n ->setFirstResult($offset)\r\n ->setMaxResults($limit)\r\n ->execute()\r\n ->fetchAll();<\/pre>\n->where()<\/code> und ->orderBy()<\/code> ist darauf zu achten, dass sie nur einmal pro Abfrage verwendet werden sollten. Noch wichtiger ist, alle Ausdr\u00fccke abzusichern. Weiter unten im Text erfahren Sie mehr dazu.<\/p>\n->execute()<\/code> erhalten Sie ein Statement-Objekt zur\u00fcck. Mit einer ->fetch()<\/code> Schleife lassen sich die einzelnen Zeilen abfragen oder Sie nutzen direkt ->fetchAll()<\/code> um ein Array mit allen Eintr\u00e4gen zu erhalten.<\/p>\nJoin – Tabellen miteinander verkn\u00fcpfen<\/h3>\n
\/** @var QueryBuilder $queryBuilder *\/\r\n$queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)\r\n ->getQueryBuilderForTable($table);\r\n\r\n$table = 'tt_content';\r\n$joinTable = 'sys_category_record_mm';\r\n\r\n$statement = $queryBuilder\r\n\u00a0\u00a0\u00a0->select('*')\r\n\u00a0\u00a0\u00a0->from($table)\r\n\u00a0\u00a0\u00a0->leftJoin(\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0$table,\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0$joinTable,\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'categoryMM',\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0$queryBuilder->expr()->eq(\r\n 'categoryMM.uid_foreign',\u00a0\r\n $queryBuilder->quoteIdentifier('tt_content.uid')\r\n )\r\n\u00a0\u00a0\u00a0)\r\n\u00a0\u00a0\u00a0->where(\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0$queryBuilder->expr()->eq('categoryMM.tablenames', \r\n $queryBuilder->createNamedParameter($table)),\r\n $queryBuilder->expr()->eq('categoryMM.fieldname', \r\n $queryBuilder->createNamedParameter('categories')),\r\n $queryBuilder->expr()->eq(\r\n 'categoryMM.uid', \r\n $queryBuilder->createNamedParameter(42, \\PDO::PARAM_INT)\r\n )\r\n\u00a0\u00a0\u00a0)\r\n\u00a0\u00a0\u00a0->execute();<\/pre>\n->join()<\/code>, ->innerJoin()<\/code>, ->rightJoin()<\/code> und ->leftJoin()<\/code>.<\/p>\nCount – Anzahl von Datens\u00e4tzen erfragen<\/h3>\n
\/** @var QueryBuilder $queryBuilder *\/\r\n$queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)\r\n ->getQueryBuilderForTable($table);\r\n$count = $queryBuilder\r\n ->count('uid')\r\n ->from($table)\r\n ->execute()\r\n ->fetchColumn(0);<\/pre>\nInsert – Neue Datens\u00e4tze einf\u00fcgen<\/h3>\n
\/** @var QueryBuilder $queryBuilder *\/\r\n$queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)\r\n ->getQueryBuilderForTable($table);\r\n\r\n$arrayNewData = ['title' => 'Neuer Datensatz', 'tx_csseo_no_index' => 1];\r\n\r\n$queryBuilder\r\n ->insert($table)\r\n ->values($arrayNewData)\r\n ->execute();<\/pre>\n
Bulk Insert \/ Insert multiple rows<\/h3>\n
\/** @var Connection $databaseConnection *\/\r\n$databaseConnection = GeneralUtility::makeInstance(ConnectionPool::class)\r\n ->getConnectionForTable($table);\r\n\r\n$arrayWithNewData = [['title' => 'TYPO3'], ['title' => 'clickstorm GmbH']];\r\n$arrayWithColNames = ['title'];\r\n\r\n\r\n$databaseConnection->bulkInsert(\r\n $table,\r\n $arrayWithNewData,\r\n $arrayWithColNames\r\n);<\/pre>\n
Update – Aktualisieren von Datens\u00e4tzen<\/h3>\n
\/**\u00a0@var\u00a0Connection\u00a0$databaseConnection\u00a0*\/\r\n$databaseConnection\u00a0=\u00a0GeneralUtility::makeInstance(ConnectionPool::class)\r\n ->getConnectionForTable($table);\u00a0\r\n\r\n$arrayUpdateData = ['deleted' => 1];\r\n$arrayWhere = ['uid'\u00a0=>\u00a0'IN\u00a0('\u00a0.\u00a0implode(',',\u00a0$currentIds)\u00a0.\u00a0')'];\r\n\r\n$databaseConnection->update(\r\n $table,\r\n $arrayUpdateData,\r\n $arrayWhere\r\n);<\/pre>\nDelete – L\u00f6schen von Datens\u00e4tzen<\/h3>\n
\/** @var Connection $databaseConnection *\/\r\n$databaseConnection = GeneralUtility::makeInstance(ConnectionPool::class)\r\n ->getConnectionForTable($table);\r\n\r\n$arrayWhere = ['hidden'\u00a0=>\u00a01];\r\n\r\n$databaseConnection->delete($table, $arrayWhere);<\/pre>\n
Doctrines wichtige Helferfunktionen<\/h2>\n
Absichern von Nutzer-Eingaben mit createNamedParameter()<\/h3>\n
->where(\r\n\u00a0\u00a0\u00a0$queryBuilder->expr()->eq('bodytext',\u00a0$queryBuilder->createNamedParameter($search))\r\n)<\/pre>\n->expr()<\/code> immer<\/strong> das zweite Argument mit ->createNamedParameter()<\/code> oder ->quoteIdentifier()<\/code>\u00a0 versehen wird. Doctrine selbst \u00fcbernimmt nur die Vermeidung von SQL-Injections<\/a> bei ->setFirstResult()<\/code>\u00a0und ->setMaxResults()<\/code>.<\/p>\nescapeLikeWildcards()<\/h3>\n
->where(\r\n $queryBuilder->expr()->like(\r\n 'bodytext',\r\n $queryBuilder->createNamedParameter('%'\u00a0.\u00a0$queryBuilder->escapeLikeWildcards($search)\u00a0.\u00a0'%')\r\n)\r\n<\/pre>\nDebug mit getSQL()<\/h3>\n
\/** @var QueryBuilder $queryBuilder *\/\r\n$queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)\r\n ->getQueryBuilderForTable($table);\r\n\r\n$queryBuilder->select('*')->from($table);\r\n\r\n\\TYPO3\\CMS\\Extbase\\Utility\\DebuggerUtility::var_dump($queryBuilder->getSQL());\r\n\r\n$statement\u00a0=\u00a0$queryBuilder->execute();<\/pre>\nAusblick<\/h2>\n