Source of file SQLInterface.php

Size: 2,492 Bytes - Last Modified: 2020-04-17T14:56:27-04:00

src/Drivers/SQLInterface.php

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136
<?php declare(strict_types=1);
/**
 * Query
 *
 * SQL Query Builder / Database Abstraction Layer
 *
 * PHP version 7.4
 *
 * @package     Query
 * @author      Timothy J. Warren <tim@timshomepage.net>
 * @copyright   2012 - 2020 Timothy J. Warren
 * @license     http://www.opensource.org/licenses/mit-license.html  MIT License
 * @link        https://git.timshomepage.net/aviat/Query
 * @version     3.0.0
 */
namespace Query\Drivers;

/**
 * Interface for database-specific syntax subclasses
 */
interface SQLInterface {

	/**
	 * Get database specific sql for limit clause
	 *
	 * @param string $sql
	 * @param int $limit
	 * @param int|null $offset
	 * @return string
	 */
	public function limit(string $sql, int $limit, ?int $offset=NULL): string;

	/**
	 * Modify the query to get the query plan
	 *
	 * @param string $sql
	 * @return string
	 */
	public function explain(string $sql): string;

	/**
	 * Get the sql for random ordering
	 *
	 * @return string
	 */
	public function random(): string;

	/**
	 * Returns sql to list other databases
	 *
	 * @return string
	 */
	public function dbList(): string;

	/**
	 * Returns sql to list tables
	 *
	 * @return string
	 */
	public function tableList(): string;

	/**
	 * Returns sql to list system tables
	 *
	 * @return string|array
	 */
	public function systemTableList();

	/**
	 * Returns sql to list views
	 *
	 * @return string
	 */
	public function viewList(): string;

	/**
	 * Returns sql to list triggers
	 *
	 * @return string
	 */
	public function triggerList(): ?string;

	/**
	 * Return sql to list functions
	 *
	 * @return string
	 */
	public function functionList(): ?string;

	/**
	 * Return sql to list stored procedures
	 *
	 * @return string
	 */
	public function procedureList(): ?string;

	/**
	 * Return sql to list sequences
	 *
	 * @return string
	 */
	public function sequenceList(): ?string;

	/**
	 * Return sql to list database field types
	 *
	 * @return string|array
	 */
	public function typeList();

	/**
	 * Get information about the columns in the
	 * specified table
	 *
	 * @param string $table
	 * @return string
	 */
	public function columnList(string $table): string;

	/**
	 * Get the list of foreign keys for the current
	 * table
	 *
	 * @param string $table
	 * @return string
	 */
	public function fkList(string $table): string;

	/**
	 * Get the list of indexes for the current table
	 *
	 * @param string $table
	 * @return string
	 */
	public function indexList(string $table): string;
}