{ "href": "/post/2018/05/22/atlas-query-simple-sensible-sql/", "relId": "2018/05/22/atlas-query-simple-sensible-sql", "title": "Atlas.Query: Simple. Sensible. SQL.", "author": "pmjones", "markup": "html", "tags": [ { "href": "/tag/atlas/", "relId": "atlas", "title": "Atlas", "author": null, "created": "2020-09-21 14:37:38 UTC", "updated": [ "2020-09-21 14:37:38 UTC", "2023-06-22 02:17:41 UTC" ], "markup": "markdown" }, { "href": "/tag/php/", "relId": "php", "title": "PHP", "author": null, "created": null, "updated": [], "markup": "markdown" }, { "href": "/tag/programming/", "relId": "programming", "title": "Programming", "author": null, "created": null, "updated": [], "markup": "markdown" } ], "created": "2018-05-22 12:00:04 UTC", "updated": [ "2018-05-22 12:00:04 UTC", "2020-10-29 21:54:55 UTC", "2020-10-29 21:55:59 UTC", "2020-10-29 21:56:15 UTC" ], "html": "

I am happy to announce that Atlas.Query is now stable and ready for production
\nuse! Installaton is as easy as composer require atlas/query ~1.0.

\n

With Atlas.Query and any PDO instance, you can build and execute your queries in a single fluent series of method calls:

\n\n
use Atlas\\Query\\Select;\n\n$rows = Select::new($pdo)\n    ->columns('*')\n    ->from('posts')\n    ->where('id IN ', $ids)\n    ->fetchAll();\n\nforeach ($rows as $row) {\n    // ...\n}\n
\n\n

If you prefer, you can exercise fine control over your PDO connection, use a query factory, or build your queries in smaller steps:

\n\n
use Atlas\\Pdo\\Connection;\nuse Atlas\\Query\\QueryFactory;\n\n$connection = Connection::new(\n    'mysql:host=localhost;dbname=testdb',\n    'username',\n    'password'\n);\n\n$queryFactory = new QueryFactory();\n\n$select = $queryFactory->newSelect($connection);\n$select->columns('*');\n$select->from('posts');\n$select->where('id = ', $id);\n\n$row = $select->fetchOne();\n
\n\n

Atlas.Query provides the full power of SQL at your fingertips \u2026

\n\n
$select\n    ->columns(...)\n    ->from(...)\n    ->join(...)\n    ->where(...)\n    ->groupBy(...)\n    ->having(...)\n    ->orderBy(...)\n    ->limit(...)\n    ->offset(...);\n
\n\n

\u2026 along with UNIONs, paging, sub-selects, inline value binding, and all sorts of fetch and yield styles.

\n

Atlas.Query comes with INSERT, UPDATE, and DELETE builders as well:

\n\n
use Atlas\\Query\\Insert;\n\n$insert = Insert::new($pdo);\n\n// insert a row ...\n$insert->into('posts')\n    ->columns([\n        'title' => $title,\n        'body' => $body,\n    ])\n    ->raw('created_at', 'NOW()')\n    ->perform();\n\n// ... and get back the autoincrement value:\n$post_id = $insert->getLastInsertId();\n
\n\n

Do you work on different project with different database backends? Atlas.Query lets you use the same interface for them all, while not restricting you to a common subset of functionality. MySQL, PostgreSQL, SQLite, and SQL Server are all supported explicitly.

\n

And if you discover you need more than just a query system, you\u2019ll have a clear refactoring path towards Atlas.Orm. If you are looking for a modern, stable, easy-to-use query system, try Atlas.Query in your project!

\n
\n

You can read the Reddit commentary on this post here.

\n" }