WHERE Синтаксис

Версія: v2.3.0

Синтаксис WHERE

Деякі методи Medoo приймають аргумент $where для фільтрації записів, подібно до клаузи SQL WHERE. Хоча такі умови можуть бути складними й ризикованими, якщо писати їх вручну, Medoo пропонує структурований і наочний спосіб безпечно будувати умови WHERE.

Основні умови

Базові умови прості у використанні. Ви також можете додати оператори до імені стовпця, щоб створити розширені порівняння, особливо для числових значень.

$database->select("account", "user_name", [
	"email" => "foo@bar.com"
]);
// WHERE email = 'foo@bar.com'

$database->select("account", "user_name", [
	"user_id" => 200
]);
// WHERE user_id = 200

$database->select("account", "user_name", [
	"user_id[>]" => 200
]);
// WHERE user_id > 200

$database->select("account", "user_name", [
	"user_id[>=]" => 200
]);
// WHERE user_id >= 200

$database->select("account", "user_name", [
	"user_id[!]" => 200
]);
// WHERE user_id != 200

$database->select("account", "user_name", [
	"age[<>]" => [200, 500]
]);
// WHERE age BETWEEN 200 AND 500

$database->select("account", "user_name", [
	"age[><]" => [200, 500]
]);
// WHERE age NOT BETWEEN 200 AND 500

Оператори [<>] і [><] також можна використовувати зі значеннями дати й часу.

$database->select("account", "user_name", [
	"birthday[<>]" => [date("Y-m-d", mktime(0, 0, 0, 1, 1, 2015)), date("Y-m-d")]
]);

$database->select("account", "user_name", [
	"birthday[><]" => [date("Y-m-d", mktime(0, 0, 0, 1, 1, 2015)), date("Y-m-d")]
]);

WHERE ("birthday" BETWEEN '2015-01-01' AND '2017-01-01')
WHERE ("birthday" NOT BETWEEN '2015-01-01' AND '2017-01-01')

Ви можете передати не лише один рядок або числове значення, а й масив. У такому випадку Medoo створює умову IN.

$database->select("account", "user_name", [
	"OR" => [
		"user_id" => [2, 123, 234, 54],
		"email" => ["foo@bar.com", "cat@dog.com", "admin@medoo.in"]
	]
]);

WHERE
user_id IN (2,123,234,54) OR
email IN ('foo@bar.com','cat@dog.com','admin@medoo.in')

Заперечні умови

Використовуйте оператор [!] для створення негативних порівнянь, таких як !=, NOT IN і IS NOT NULL.

$database->select("account", "user_name", [
	"AND" => [
		"user_name[!]" => "foo",
		"user_id[!]" => 1024,
		"email[!]" => ["foo@bar.com", "cat@dog.com", "admin@medoo.in"],
		"city[!]" => null,
		"promoted[!]" => true
	]
]);

WHERE
"user_name" != 'foo' AND
"user_id" != 1024 AND
"email" NOT IN ('foo@bar.com','cat@dog.com','admin@medoo.in') AND
"city" IS NOT NULL AND
"promoted" != 1

Ви також можете використовувати результат select() або get() як значення умови.

$database->select("account", "user_name", [
	"user_id" => $database->select("post", "user_id", ["comments[>]" => 40])
]);

WHERE user_id IN (2, 51, 321, 3431)

Логічні умови

Логічні умови описують зв’язки між кількома виразами. Використовуйте AND і OR, щоб будувати складніші запити.

Основне використання

$database->select("account", "user_name", [
	"AND" => [
		"user_id[>]" => 200,
		"age[<>]" => [18, 25],
		"gender" => "female"
	]
]);

// Типово Medoo поєднує умови через AND. Наведений нижче запит є еквівалентним.
$database->select("account", "user_name", [
	"user_id[>]" => 200,
	"age[<>]" => [18, 25],
	"gender" => "female"
]);

WHERE user_id > 200 AND age BETWEEN 18 AND 25 AND gender = 'female'

$database->select("account", "user_name", [
	"OR" => [
		"user_id[>]" => 200,
		"age[<>]" => [18, 25],
		"gender" => "female"
	]
]);

WHERE user_id > 200 OR age BETWEEN 18 AND 25 OR gender = 'female'

Вкладені умови

$database->has("account", [
	"AND" => [
		"OR" => [
			"user_name" => "foo",
			"email" => "foo@bar.com"
		],
		"password" => "12345"
	]
]);

WHERE (user_name = 'foo' OR email = 'foo@bar.com') AND password = '12345'

Оскільки Medoo використовує масиви для опису логічних умов, повторювані ключі в одному масиві перезаписуватимуть один одного.

// Це не спрацює так, як очікується.
$database->select("account", '*', [
	"AND" => [
		"OR" => [
			"user_name" => "foo",
			"email" => "foo@bar.com"
		],
		"OR" => [
			"user_name" => "bar",
			"email" => "bar@foo.com"
		]
	]
]);
// [X] SELECT * FROM "account" WHERE ("user_name" = 'bar' OR "email" = 'bar@foo.com')

Щоб уникнути конфлікту ключів, додайте коментар після імені логічного ключа. Коментар починається з # і може містити будь-який текст.

$database->select("account", '*', [
	"AND #Коментарі можна використовувати з будь-якою логічною умовою AND або OR" => [
		"OR #перша умова" => [
			"user_name" => "foo",
			"email" => "foo@bar.com"
		],
		"OR #друга умова" => [
			"user_name" => "bar",
			"email" => "bar@foo.com"
		]
	]
]);

WHERE (
	("user_name" = 'foo' OR "email" = 'foo@bar.com')
	AND
	("user_name" = 'bar' OR "email" = 'bar@foo.com')
)

Порівняння стовпців

$database->select("post", [
	"[>]account" => "user_id",
], [
	"post.content"
], [
	// Порівнюйте стовпці за допомогою операторів у повністю кваліфікованих назвах стовпців, таких як [=], [>], [<] і [!=].
	"post.restrict[<]account.age"
]);

WHERE "post"."restrict" < "account"."age"

Умови LIKE

Використовуйте оператор [~] для створення умов LIKE. Його можна використовувати як в основних, так і в логічних умовах.

// За замовчуванням ключове слово обгортається символами % з обох боків для часткового збігу.
$database->select("person", "id", [
	"city[~]" => "lon"
]);

WHERE "city" LIKE '%lon%'

Зіставлення груп

$database->select("person", "id", [
	"city[~]" => ["lon", "foo", "bar"]
]);

WHERE "city" LIKE '%lon%' OR "city" LIKE '%foo%' OR "city" LIKE '%bar%'

Негативні умови LIKE

$database->select("person", "id", [
	"city[!~]" => "lon"
]);

WHERE "city" NOT LIKE '%lon%'

Складені умови LIKE

$database->select("person", "id", [
	"content[~]" => ["AND" => ["lon", "on"]]
]);

WHERE ("content" LIKE '%lon%' AND "content" LIKE '%on%')

$database->select("person", "id", [
	"content[~]" => ["OR" => ["lon", "on"]]
]);

WHERE ("content" LIKE '%lon%' OR "content" LIKE '%on%')

Символи підстановки SQL

Ви можете використовувати шаблони символів узагальнення SQL для розширеного пошуку відповідностей.

$database->select("person", "id", [
	"city[~]" => "%stan" // Kazakhstan, Uzbekistan, Turkmenistan
]);

$database->select("person", "id", [
	"city[~]" => "Londo_" // London, Londox, Londos, ...
]);

$database->select("person", "id", [
	"name[~]" => "[BCR]at" // Bat, Cat, Rat
]);

$database->select("person", "id", [
	"name[~]" => "[!BCR]at" // Eat, Fat, Hat, ...
]);

Умови сортування

Використовуйте ORDER для сортування набору результатів.

// Сортування за одним стовпцем.
$database->select("account", "user_id", [
	"ORDER" => "user_id"
]);

// Сортування за кількома стовпцями.
$database->select("account", "user_id", [
	"ORDER" => [
		// Сортування стовпця у власному порядку.
		"user_id" => [43, 12, 57, 98, 144, 1],

		// Сортування стовпця з напрямком за замовчуванням.
		"register_date",

		// Сортування за спаданням.
		"profile_id" => "DESC",

		// Сортування за зростанням.
		"date" => "ASC"
	]
]);

Повнотекстовий пошук

Повнотекстовий пошук підтримує MySQL для розширених пошукових запитів.

Режими пошуку

natural	У РЕЖИМІ ПРИРОДНОЇ МОВИ
natural+query	У РЕЖИМІ ПРИРОДНОЇ МОВИ З РОЗШИРЕННЯМ ЗАПИТУ
boolean	У ЛОГІЧНОМУ РЕЖИМІ
query	З РОЗШИРЕННЯМ ЗАПИТУ

// Умова MATCH.
$database->select("post_table", "post_id", [
	"MATCH" => [
		"columns" => ["content", "title"],
		"keyword" => "foo",

		// Необов'язково: режим пошуку.
		"mode" => "natural"
	]
]);

WHERE MATCH (content, title) AGAINST ('foo' IN NATURAL LANGUAGE MODE)

Регулярні вирази

Використовуйте оператор [REGEXP], щоб зіставити значення з регулярним виразом.

$data = $database->select('account', [
	'user_id',
	'user_name'
], [
	'user_name[REGEXP]' => '[a-z0-9]*'
]);

WHERE "user_name" REGEXP '[a-z0-9]*'

Функції SQL

Для складніших випадків ви можете використовувати функції SQL через raw-об’єкт. Докладніше див. на сторінці raw.

$data = $database->select('account', [
	'user_id',
	'user_name'
], [
	'datetime' => Medoo::raw('NOW()')
]);

WHERE "datetime" = NOW()

LIMIT і OFFSET

Використовуйте LIMIT, щоб обмежити кількість повернутих рядків. Ви також можете вказати зсув.

// Повертає перші 100 рядків.
$database->select("account", "user_id", [
	"LIMIT" => 100
]);

// Пропускає перші 20 рядків, а потім повертає наступні 100.
$database->select("account", "user_id", [
	"LIMIT" => [20, 100]
]);

// Для Oracle і MSSQL також потрібен ORDER BY.
$database->select("account", "user_id", [
	"LIMIT" => [20, 100],
	"ORDER" => "location"
]);

GROUP BY і HAVING

Використовуйте GROUP для групування рядків і HAVING для фільтрації згрупованих результатів.

// Групування за одним стовпцем.
$database->select("account", "user_id", [
	"GROUP" => "type"
]);

// Групування за кількома стовпцями.
$database->select("account", "user_id", [
	"GROUP" => [
		"type",
		"age",
		"gender"
	]
]);

// Групує рядки та фільтрує згрупований результат.
$database->select("account", "user_id", [
	"GROUP" => "type",
	"HAVING" => [
		"user_id[>]" => 500
	]
]);