That's really cool.
It would be interesting if we could use this as an excuse to move away from what i would consider antipatterns in our sql layer e.g., having no high level way of specifying WHERE comparisons (x > "foo". Currently we do addQuotes() instead of automatic or `field1` = `field2`). Similarly the whole thing with field names only getting automatically addIdentifierQuotes() if it looks like its not sql, always seemed sketch. This might provide us a path forward to address those while still maintaining backwards compat.
-- Brian
p.s. Now all i need to dream about is a fluent version of Html class.
On Thursday, May 21, 2020, Tim Starling tstarling@wikimedia.org wrote:
SelectQueryBuilder is a new fluent interface for constructing database queries, which has been merged to master for release in MediaWiki 1.35. Please consider using it in new code.
SELECT page_id FROM page WHERE page_namespace=$namespace AND page_title=$title
becomes
$id = $db->newSelectQueryBuilder() ->select( 'page_id' ) ->from( 'page' ) ->where( [ 'page_namespace' => $namespace, 'page_title' => $title, ] ) ->fetchField();
As explained on the design task T243051, SelectQueryBuilder was loosely based on the query builder in Doctrine, but I made an effort to respect existing MediaWiki conventions, to make migration easy.
SelectQueryBuilder is easy to use for simple cases, but has the most impact on readability when it is used for complex queries. That's why I chose to migrate the showIndirectLinks query in Special:WhatLinksHere as a pilot -- it was one of the gnarliest queries in core.
SelectQueryBuilder excels at building joins, including parenthesized (nested) joins and joins on subqueries.
SelectQueryBuilder can be used as a structured alternative to the "query info" pattern, in which the parameters to Database::select() are stored in an associative array. It can convert to and from such arrays. As a pilot of this functionality, I converted ApiQueryBase to use a SelectQueryBuilder to store accumulated query info.
Check it out!
-- Tim Starling
Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l