Solar is a simple object library and application repository for PHP 5. You can view the rather extensive change log here.
\nThis release is a major break to backwards compatibility, mostly because we now use PDO for the SQL database API abstraction (as opposed to the homegrown solution I was using in preparation for PDO). The distribution includes a number of migration documents to help users of prior versions move to the new system.
\nI want to specifically mention one aspect of the Solar SQL system, the Solar_Sql_Select object. This is probably not new in the PHP world, but it's the first time I've done anything like this, so I want to talk about it.
\nOne of the problems with database portability is that you can't depend on a LIMIT to work the same way across database backends; indeed, it may not even exist as such. Different DB abstraction packages use different methods to support LIMIT emulation, either by rewriting the SELECT statement, or by supporting only the portions of a LIMIT clause available to the particular backend.
\nWhat Solar_Sql_Select does is let you programmatically build a SELECT statement, and it keeps the clause portions separated internally. It then combines those portions in a manner specific to the database backend driver, putting the appropriate LIMIT clauses in the right place. Here's a quick example; let's build this SELECT statement.
\nSELECT id, date, type, name\nFROM example\nWHERE\n date >= '2005-01-01' AND\n date <= '2005-01-31' AND\n type IN('a','b','c')\nORDER BY id\nLIMIT 10,50(The LIMIT in this case is to grab 10 rows starting at row 50.)
\nThe equivalent Solar_Sql_Select code is:
\n\n\n<?php\n$select = Solar::object(\"Solar_Sql_Select\");\n\n// the basic columns\n$table = 'example';\n$cols = array('id', 'date', 'type', 'name');\n\n$select->from($table, $cols);\n\n// WHERE clauses for the date\n$select->where('date >= ?', '2005-01-01');\n\n$select->where('date <= ?', '2005-01-31');\n\n// WHERE clause for the type\n$types = array('a', 'b', 'c');\n\n$select->where('type IN(?)', $types);\n\n// ORDER and LIMIT\n$select->order('id');\n$select->limit(10, 50);\n\n\n$statement = $select->fetch('statement');\n?>\nSome notes:
\nIn the above Solar-based PHP code, when MySQL is the driver, the $statement contents will look something like the initial example. However, when using the Microsoft SQL driver (which does not support LIMIT, only TOP), the resulting SELECT looks something like this:
\nSELECT *\nFROM (\n SELECT TOP 10 *\n FROM (\n SELECT TOP 60 id, date, type, name\n FROM example\n WHERE\n date >= '2005-01-01' AND\n date <= '2005-01-31' AND\n type IN('a','b','c')\n ) AS solar_limit_rev\n ORDER BY id DESC\n ) AS solar_limit\nORDER BY id ASCWhich looks like a mess, but these guys seem to think it works. The point is that by keeping the SELECT clauses separate until you build the statement, you can manipulate the individual pieces with great precision for better portability.
\nAnother thing about Solar_Sql_Select is that paging is built in. If you wanted to grab page 5, where pages are 10 rows each, you can do this:
\n\n<?php\n// instead of $select->limit(10,50) ...\n$select->paging(10); // 10 rows per page\n\n$select->limitPage(5); // limit to page 5\n?>\nAlso, row-and-page counting is built in.
\n\n<?php\n\n// instead of $select->fetch() ...\n$total = $select->countPages();\n\n/*\n$total = array(\n 'count' => number_of_rows,\n 'pages' => number_of_pages\n);\n*/\n?>\nYou can see more extensive Solar_Sql_Select docs here (although they are not \"real\" docs, just migration examples).
\n" }