Initial import

Author: moufmouf

Column.php

@@ -0,0 +1,70 @@
+<?php
+namespace database\querywriter;
+
+/**
+ * The Column class represents one or many columns to be retrieved in a SQL Select statement
+ * 
+ * @author David Negrier
+ * @Component
+ */
+class Column implements SelectExpressionInterface {
+	
+	/**
+	 * Optional table name
+	 * 
+	 * @Property
+	 * @var string
+	 */
+	public $tableName;
+
+	/**
+	 * The name of the column.
+	 * Use "*" to retrieve all columns.
+	 * 
+	 * @Property
+	 * @Compulsory
+	 * @var string
+	 */
+	public $columnName;
+	
+	/**
+	 * Optional alias name
+	 * 
+	 * @Property
+	 * @var string
+	 */
+	public $alias;
+	
+	/**
+	 * Constructor
+	 * 
+	 * @param string $tableName
+	 * @param string $columnName
+	 * @param string $alias
+	 */
+	public function __construct($tableName = null, $columnName = null, $alias = null) {
+		$this->tableName = $tableName;
+		$this->columnName = $columnName;
+		$this->alias = $alias;
+	}
+	
+	/**
+	 * (non-PHPdoc)
+	 * @see database\querywriter.SqlRenderInterface::toSql()
+	 */
+	public function toSql(\DB_ConnectionInterface $dbConnection) {
+		$sql = "";
+		if ($this->tableName) {
+			$sql .= $dbConnection->escapeDBItem($this->tableName).".";
+		}
+		if ($this->columnName != "*") {
+			$sql .= $dbConnection->escapeDBItem($this->columnName);
+		} else {
+			$sql .= "*";
+		}
+		if ($this->alias) {
+			$sql .= " AS ".$dbConnection->escapeDBItem($this->alias);
+		}
+		return $sql;
+	}
+}

Join.php

@@ -0,0 +1,61 @@
+<?php
+namespace database\querywriter;
+
+/**
+ * Represents a LEFT JOIN, JOIN, RIGHT JOIN or OUTER JOIN in a SELECT query.
+ * 
+ * @author David Negrier
+ * @Component
+ */
+class Join implements TableReferenceInterface {
+	/**
+	 * The left table in the join
+	 * 
+	 * @Property
+	 * @Compulsory
+	 * @var TableReferenceInterface
+	 */
+	public $left;
+	
+	/**
+	 * The right table in the join
+	 * 
+	 * @Property
+	 * @Compulsory
+	 * @var TableReferenceInterface
+	 */
+	public $right;
+	
+	/**
+	 * The ON condition.
+	 * 
+	 * @Property
+	 * @Compulsory
+	 * @var filters\FilterInterface
+	 */
+	public $on;
+	
+	/**
+	 * The kind of Join to apply
+	 * 
+	 * @Property
+	 * @Compulsory
+	 * @OneOf ("LEFT JOIN", "JOIN", "RIGHT JOIN", "OUTER JOIN")
+	 * @var string
+	 */
+	public $joinType = "LEFT JOIN";
+	
+	/**
+	 * (non-PHPdoc)
+	 * @see database\querywriter.SqlRenderInterface::toSql()
+	 */
+	public function toSql(\DB_ConnectionInterface $dbConnection) {
+		$sql = "(".$this->left->toSql($dbConnection);
+		$sql .= " ".$this->joinType." ";
+		$sql .= $this->right->toSql($dbConnection);
+		$sql .= " ON ";
+		$sql .= $this->on->toSql($dbConnection);
+		$sql .= ")";
+		return $sql;
+	}
+}

Select.php

@@ -0,0 +1,124 @@
+<?php
+namespace database\querywriter;
+
+/**
+ * The Select class represents a SQL Select statement
+ * 
+ * @author David Negrier
+ * @Component
+ */
+class Select {
+	
+	/**
+	 * The connection to the database.
+	 * 
+	 * @Property
+	 * @Compulsory
+	 * @var \DB_ConnectionInterface
+	 */
+	public $connection;
+	
+	/**
+	 * If true, the DISTINCT keyword will be used with this select statement.
+	 * 
+	 * @Property
+	 * @var bool
+	 */
+	public $distinct;
+	
+	/**
+	 * This list of columns (or select expressions) that should be returned by the query.
+	 * 
+	 * @Property
+	 * @Compulsory
+	 * @var array<SelectExpressionInterface>
+	 */
+	public $columns = array();
+	
+	/**
+	 * One or many tables or joins to add to the select statement.
+	 * Advice: if you want to perform joins, create a JOIN first and put tables in the join.
+	 * 
+	 * @Property
+	 * @Compulsory
+	 * @var TableReferenceInterface
+	 */
+	public $from;
+	
+	/**
+	 * The where condition.
+	 * 
+	 * @Property
+	 * @var filters\FilterInterface
+	 */
+	public $where;
+	
+	/**
+	 * The list of fields to group on.
+	 * 
+	 * @Property
+	 * @var array<OrderByGroupByElementInterface>
+	 */
+	public $groupBy = array();
+	
+	/**
+	 * The having condition.
+	 * 
+	 * @Property
+	 * @var filters\FilterInterface
+	 */
+	public $having;
+	
+	/**
+	 * The list of fields to order on.
+	 * 
+	 * @Property
+	 * @var array<OrderByGroupByElementInterface>
+	 */
+	public $orderBy = array();
+	
+	/**
+	 * The limit number of fields to return.
+	 * 
+	 * @Property
+	 * @var int
+	 */
+	public $limit;
+	
+	/**
+	 * Start returning firlds from field number $offset.
+	 * 
+	 * @Property
+	 * @var int
+	 */
+	public $offset;
+	
+	/**
+	 * Returns the SELECT statement in a string.
+	 * 
+	 * @return string
+	 */
+	public function toSql() {
+		$sql = "SELECT ";
+		if ($this->distinct) {
+			$sql .= "DISTINCT ";
+		}
+		// Apply the toSql function on the columns 
+		$connection = $this->connection;
+				
+		$columnsSql = array_map(function(SelectExpressionInterface $elem) use ($connection)  {
+			return $elem->toSql($connection);
+		}, $this->columns);
+		$sql .= implode(", ", $columnsSql);
+		
+		$sql .= " FROM ";
+		
+		$sql .= $this->from->toSql($connection);
+		
+		if ($this->where) {
+			$sql .= " WHERE ".$this->where->toSql($connection);
+		}
+		
+		return $sql;
+	}
+}

SelectExpressionInterface.php

@@ -0,0 +1,11 @@
+<?php
+namespace database\querywriter;
+
+/**
+ * Classes implementing this interface can be added in the columns list of a SQL statement.
+ * 
+ * @author David
+ */
+interface SelectExpressionInterface extends SqlRenderInterface {
+	
+}

SqlRenderInterface.php

@@ -0,0 +1,18 @@
+<?php
+namespace database\querywriter;
+
+/**
+ * Objects implementing SqlRenderInterface can be rendered with the toSql method.
+ * 
+ * @author David Negrier
+ */
+interface SqlRenderInterface {
+	
+	/**
+	 * Renders the object as a SQL string
+	 * 
+	 * @param \DB_ConnectionInterface $dbConnection
+	 * @return string
+	 */
+	public function toSql(\DB_ConnectionInterface $dbConnection);
+}

TableReference.php

@@ -0,0 +1,42 @@
+<?php
+namespace database\querywriter;
+
+/**
+ * Represents a SQL table in a SELECT query.
+ * 
+ * @author David Negrier
+ * @Component
+ */
+class TableReference implements TableReferenceInterface {
+	
+	/**
+	 * The table name.
+	 * 
+	 * @Property
+	 * @Compulsory
+	 * @Important
+	 * @var string
+	 */
+	public $tableName;
+	
+	/**
+	 * The alias.
+	 * 
+	 * @Property
+	 * @Important
+	 * @var string
+	 */
+	public $alias;
+	
+	/**
+	 * Renders the object as a SQL string
+	 * @return string
+	 */
+	public function toSql(\DB_ConnectionInterface $dbConnection) {
+		$sql = $dbConnection->escapeDBItem($this->tableName);
+		if ($this->alias) {
+			$sql .= " AS ".$dbConnection->escapeDBItem($this->alias);
+		}
+		return $sql;
+	}
+}

TableReferenceInterface.php

@@ -0,0 +1,12 @@
+<?php
+namespace database\querywriter;
+
+/**
+ * Represents a SQL table or JOIN clause to put in a WHERE SQL statement.
+ * 
+ * @author David Negrier
+ * @Component
+ */
+interface TableReferenceInterface extends SqlRenderInterface {
+	
+}

composer.json

@@ -0,0 +1,23 @@
+{
+    "name": "mouf/database.querywritter",
+    "description": "TODO",
+    "keywords": ["security", "user", "user management"],
+    "homepage": "https://github.com/thecodingmachine/database.querywritter",
+    "type": "library",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "David Négrier",
+            "email": "[email protected]",
+            "homepage": "http://mouf-php.com"
+        }
+    ],
+    "require": {
+    	"php": ">=5.3.0"
+    },
+    "autoload": {
+        "psr-0": {
+            "Mouf": "src/"
+        }
+    }
+}