База данных

База данных

Подключение к ядру базы данных

Fat-Free предназначен для того, чтобы сделать работу по взаимодействию с базами данных SQL легкой. Если вы не из тех, кто углубляется в детали SQL, но больше склоняетесь к объектно-ориентированной обработке данных, вы можете перейти непосредственно к следующему разделу этого руководства. Однако, если вам нужно выполнить некоторые сложные задачи по обработке данных и оптимизации производительности базы данных, SQL-это правильный путь.
Установление связи с SQL-движком, таким как MySQL, SQLite, PostgreSQL, SQL Server, Sybase и Oracle, осуществляется с помощью знакомой $f3->set()команды. Подключение к базе данных SQLite было бы:
1
$f3->set('DB', new DB\SQL('sqlite:/absolute/path/to/your/database.sqlite'));
Copied!
Теперь вы можете работать с объектом базы данных из любого места вашего приложения $f3->get('DB')->exec('…');.
Еще один пример, на этот раз с MySQL:
1
$db=new DB\SQL(
2
'mysql:host=localhost;port=3306;dbname=mysqldb',
3
'admin',
4
'p455w0rD'
5
);
Copied!
Вы также можете посмотреть видео, которое проходит через использование MySQL в Fat-Free Framework.

Запрос к базе данных

ОК. Это было легко, не так ли? Примерно так же вы поступили бы и в обычном PHP. Вам просто нужно знать формат DSN базы данных, к которой вы подключаетесь. Смотрите раздел PDO руководства по PHP.
Давайте продолжим наш PHP код:
1
$f3->set('result',$db->exec('SELECT brandName FROM wherever'));
2
echo Template::instance()->render('abc.htm');
Copied!
Хм, что здесь происходит? Разве мы не должны создавать такие вещи, как PDO, операторы, курсоры и т. д.? Ответ прост: вы не должны этого делать. F3 упрощает все, взяв на себя всю тяжелую работу в бэкэнде.
На этот раз мы создаем такой HTML шаблон abc.htmкоторый имеет как минимум следующее:
1
<repeat group="{{ @result }}" value="{{ @item }}">
2
<span>{{ @item.brandName }}</span>
3
</repeat>
Copied!
В большинстве случаев набора команд SQL должно быть достаточно для генерации готового к работе в Интернете результата, чтобы вы могли напрямую использовать переменную resultмассива в своем шаблоне. Как бы то ни было, Fat-Free не помешает вам проникнуть в его внутренние части SQL-обработчика. На самом деле DB\SQLкласс F3 происходит непосредственно от PDOкласса PHP, поэтому у вас все еще есть доступ к базовым компонентам PDO и примитивам, участвующим в каждом процессе, если вам нужен какой-то низкоуровневый контроль.

Операции

Вот еще один пример. Вместо одного оператора, предоставленного в качестве аргумента $db->exec()команде, вы также можете передать массив SQL-операторов:
1
$db->exec(
2
array(
3
'DELETE FROM diet WHERE food="cola"',
4
'INSERT INTO diet (food) VALUES ("carrot")',
5
'SELECT * FROM diet'
6
)
7
);
Copied!
F3 достаточно умен, чтобы знать, что если вы передаете массив инструкций SQL, это указывает на пакетную транзакцию SQL. Вам не нужно беспокоиться об откатах и фиксациях SQL, потому что фреймворк автоматически вернется к исходному состоянию базы данных, если во время транзакции возникнет какая-либо ошибка. В случае успеха F3 фиксирует все изменения, внесенные в базу данных.
Вы также можете запускать и завершать транзакцию программно:
1
$db->begin();
2
$db->exec('DELETE FROM diet WHERE food="cola"');
3
$db->exec('INSERT INTO diet (food) VALUES ("carrot")');
4
$db->exec('SELECT * FROM diet');
5
$db->commit();
Copied!
Откат произойдет, если какой-либо из операторов столкнется с ошибкой.
Чтобы получить список всех выданных инструкций базы данных:
1
echo $db->log();
Copied!

параметризованный запрос

Передача строковых аргументов в SQL-операторы чревата опасностью.
1
$db->exec(
2
'SELECT * FROM users '.
3
'WHERE username="'.$f3->get('POST.userID').'"'
4
);
Copied!
Если POSTпеременная userIDне проходит через какой-либо процесс очистки данных, злоумышленник может передать следующую строку и необратимо повредить вашу базу данных:
1
admin"; DELETE FROM users; SELECT "1
Copied!
К счастью, параметризованные запросы помогают снизить эти риски:
1
$db->exec(
2
'SELECT * FROM users WHERE userID=?',
3
$f3->get('POST.userID')
4
);
Copied!
Если F3 обнаруживает, что значение параметра запроса/токена является строкой, базовый уровень доступа к данным экранирует эту строку и добавляет кавычки по мере необходимости.
Наш пример в предыдущем разделе будет намного безопаснее от SQL-инъекции, если он будет написан таким образом:
1
$db->exec(
2
array(
3
'DELETE FROM diet WHERE food=:name',
4
'INSERT INTO diet (food) VALUES (?)',
5
'SELECT * FROM diet'
6
),
7
array(
8
array(':name'=>'cola'),
9
array(1=>'carrot'),
10
NULL
11
)
12
);
Copied!
Вы также можете посмотреть видео, посвященное SQL-инъекции и безопасности базы данных.

Грубость (но с большим количеством стиля)

F3 упакован с простыми в использовании объектно-реляционными сопоставителями (ORM), которые находятся между вашим приложением и вашими данными, что делает его намного проще и быстрее для вас писать программы, которые обрабатывают общие операции с данными, такие как создание, извлечение, обновление и удаление информации (CRUD) из баз данных SQL и NoSQL. Картографы данных выполняют большую часть работы, сопоставляя взаимодействия объектов PHP с соответствующими бэкенд-запросами.
Предположим, у вас есть существующая база данных MySQL, содержащая таблицу пользователей вашего приложения. (SQLite, PostgreSQL, SQL Server, Sybase подойдут точно так же.) Он был бы создан с помощью следующей команды SQL:
1
CREATE TABLE users (
2
userID VARCHAR(30),
3
password VARCHAR(30),
4
visits INT,
5
PRIMARY KEY(userID)
6
);
Copied!
Примечание: MongoDB-это движок базы данных NoSQL, который по своей сути не содержит схем. F3 имеет свою собственную быструю и легкую реализацию NoSQL под названием Jig, которая использует файлы, сериализованные на PHP или закодированные в JSON. Эти уровни абстракции не требуют жестких структур данных. Поля могут варьироваться от одной записи к другой. Они также могут быть определены или отброшены на лету.
Теперь вернемся к SQL. Во-первых, мы устанавливаем связь с нашей базой данных.
1
$db=new DB\SQL(
2
'mysql:host=localhost;port=3306;dbname=mysqldb',
3
'admin',
4
'wh4t3v3r'
5
);
Copied!
Чтобы извлечь запись из нашей таблицы:
1
$user=new DB\SQL\Mapper($db,'users');
2
$user->load(array('userID=?','tarzan'));
Copied!
В первой строке создается экземпляр объекта Data mapper, который взаимодействует с usersтаблицей в нашей базе данных. За сценой F3 извлекает структуру usersтаблицы и определяет, какие поля определяются как первичные ключи. На данный момент объект mapper еще не содержит никаких данных (он называется "сухое состояние"), а $uservar - это в основном не более чем структурированный объект, но он содержит методы, необходимые для выполнения основных операций CRUD, плюс некоторые дополнительные функции, как вы увидите позже. Теперь, чтобы извлечь запись из нашей usersтаблицы, например, с полемuserID, содержащим строковое значение tarzan, мы используем load() метод. Этот процесс называется "автогидратацией" объекта Data mapper.
Легко, не правда ли? F3 понимает, что таблица SQL уже имеет структурное определение, существующее в самом ядре СУБД. В отличие от других фреймворков, F3 не требует никаких дополнительных объявлений классов (если только вы не хотите расширить картографы данных, чтобы они соответствовали сложным объектам), никаких избыточных сопоставлений свойств PHP-массива/объекта в поле (дублирование усилий), никаких генераторов кода (которые требуют регенерации кода при изменении структуры базы данных), никаких глупых XML/YAML-файлов для настройки ваших моделей, никаких лишних команд просто для извлечения одной записи. С помощью F3 простое изменение размера a varchar поле в вашей таблице MySQL не требует ни одного изменения в коде вашего приложения. В соответствии с MVC и "разделением проблем" администратор базы данных имеет такой же контроль над данными и структурами, как дизайнер шаблонов над шаблонами HTML/XML.
Если вы предпочитаете работать с базами данных NoSQL, то сходство в синтаксисе запросов поверхностно. В случае картографа данных MongoDB эквивалентным кодом будет:
1
$db=new DB\Mongo('mongodb://localhost:27017','testdb');
2
$user=new DB\Mongo\Mapper($db,'users');
3
$user->load(array('userID'=>'tarzan'));
Copied!
В jig синтаксис аналогичен шаблонному движку F3:
1
$db=new DB\Jig('db/data/',DB\Jig::FORMAT_JSON);
2
$user=new DB\Jig\Mapper($db,'users');
3
$user->load(array('@userID=?','tarzan'));
Copied!

Интеллектуальный SQL ORM

Фреймворк автоматически сопоставляет поле visitsв нашей таблице со свойством Data mapper во время создания экземпляра объекта, $user=new DB\SQL\Mapper($db,'users');т. е. Как только объект будет создан, $user->passwordон $user->userIDбудет сопоставлен с полями passwordи userIDв нашей таблице соответственно.
Вы не можете добавить или удалить сопоставленное поле или изменить структуру таблицы с помощью ORM. Вы должны сделать это в MySQL или любом другом движке базы данных, который вы используете. После внесения изменений в компонент database engine Fat-Free автоматически синхронизирует новую структуру таблицы с объектом Data mapper при запуске приложения.
F3 выводит структуру картографа данных непосредственно из схемы базы данных. Никаких догадок. Он понимает различия между движками баз данных MySQL, SQLite, MSSQL, Sybase и PostgreSQL.Обратите внимание: идентификаторы SQL не должны использовать зарезервированные слова и должны быть ограничены буквенно-цифровыми символами A-Z0-9и символом подчеркивания (_). Имена столбцов, содержащие пробелы (или специальные символы) и заключенные в кавычки в определении данных, несовместимы с ORM. Они не могут быть представлены должным образом как свойства объекта PHP.
Допустим, мы хотим увеличить количество посещений пользователя и обновить соответствующую запись в нашей usersтаблице, мы можем добавить следующий код:
1
$user->visits++;
2
$user->save();
Copied!
Если мы хотим вставить запись, мы следуем этому процессу:
1
$user=new DB\SQL\Mapper($db,'users');
2
// or $user=new DB\Mongo\Mapper($db,'users');
3
// or $user=new DB\Jig\Mapper($db,'users');
4
$user->userID='jane';
5
$user->password=md5('secret');
6
$user->visits=0;
7
$user->save();
Copied!
Мы все еще используем тот же save()метод. Но как F3 узнает, когда запись должна быть вставлена или обновлена? В тот момент, когда объект картографа данных автоматически гидратируется извлечением записи, фреймворк отслеживает первичные ключи записи (или _id, в случае MongoDB и Jig) - так что он знает, какая запись должна быть обновлена или удалена-даже при изменении значений первичных ключей. Программный гидратированный картограф данных, значения которого не были извлечены из базы данных, но заполнены приложением, не будет иметь памяти предыдущих значений в своих первичных ключах. То же самое относится к MongoDB и Jig, но с использованием объекта _idв качестве ссылки. Итак, когда мы создали экземпляр $user объект выше и заполнил его свойства значениями из нашей программы - вообще не извлекая запись из пользовательской таблицы, F3 знает, что он должен вставить эту запись.
Объект mapper не будет пустым после a save(). Если вы хотите добавить новую запись в свою базу данных, вы должны сначала очистить картограф с помощью этого resetметода:
1
$user->reset();
2
$user->userID='cheetah';
3
$user->password=md5('unknown');
4
$user->save();
Copied!
Вызов save()во второй раз без вызова reset()просто обновит запись, на которую в данный момент указывает картограф.

Предостережение для таблиц SQL

Хотя проблема наличия первичных ключей во всех таблицах базы данных является спорной, F3 не мешает вам создать объект сопоставления данных, который взаимодействует с таблицей, не содержащей первичных ключей. Единственный недостаток: вы не можете удалить или обновить сопоставленную запись, потому что F3 абсолютно не может определить, на какую запись вы ссылаетесь, плюс тот факт, что позиционные ссылки ненадежны. Идентификаторы строк не переносимы между различными движками SQL и не могут быть возвращены драйвером базы данных PHP.
Чтобы удалить сопоставленную запись из нашей таблицы, вызовите этот erase()метод на автогидратированном картографе данных. Например:
1
$user=new DB\SQL\Mapper($db,'users');
2
$user->load(array('userID=? AND password=?','cheetah','ch1mp'));
3
$user->erase();
Copied!
Синтаксис запроса джига был бы немного похож:
1
$user=new DB\Jig\Mapper($db,'users');
2
$user->load(array('@userID=? AND @password=?','cheetah','chimp'));
3
$user->erase();
Copied!
И эквивалент MongoDB был бы таким:
1
$user=new DB\Mongo\Mapper($db,'users');
2
$user->load(array('userID'=>'cheetah','password'=>'chimp'));
3
$user->erase();
Copied!

Состояние Данных Картографа

Чтобы узнать, был ли наш картограф данных загружен с допустимой записью данных или нет, используйте этот dryметод:
1
if ($user->dry())
2
echo 'Нет критериев соответствия записей';
Copied!

За гранью грубости

Мы разобрались с обработчиками грязи. Есть некоторые дополнительные методы, которые вы можете найти полезными:
1
$f3->set('user',new DB\SQL\Mapper($db,'users'));
2
$f3->get('user')->copyFrom('POST');
3
$f3->get('user')->save();
Copied!
Обратите внимание, что мы также можем использовать обезжиренные переменные в качестве контейнеров для объектов mapper. copyFrom()Метод увлажняет объект mapper элементами из переменной фреймворка массива, ключи массива которого должны иметь имена, идентичные свойствам объекта mapper, которые, в свою очередь, соответствуют именам полей записи. Таким образом, при отправке веб-формы (при условии, что атрибут HTML name установлен в userIDзначение) содержимое этого поля ввода передается$_POST['userID'], дублируется F3 в его POST.userIDпеременной и сохраняется в сопоставленном поле $user->userID в базе данных. Процесс становится очень простым, если все они имеют одинаковые имена элементов. Согласованность в ключах массива, т. е. именах шаблонных маркеров, именах переменных фреймворка и именах полей является ключевой :)Опасность: по умолчанию copyfromиспользуется весь предоставленный массив. Это может привести к утечке данных безопасности, если пользователь разместит больше полей, чем вы ожидаете. Используйте 2-й параметр для настройки функции обратного вызова фильтра, чтобы избавиться от нежелательных полей для копирования.
С другой стороны, если мы хотим получить запись и скопировать значения полей в переменную фреймворка для последующего использования, например для рендеринга шаблона:
1
$f3->set('user',new DB\SQL\Mapper($db,'users'));
2
$f3->get('user')->load(array('userID=?','jane'));
3
$f3->get('user')->copyTo('POST');
Copied!
Затем мы можем назначить {{ @POST.userID }} для атрибута value того же поля ввода. Подводя итог, можно сказать, что поле ввода HTML будет выглядеть следующим образом:
1
<input type="text" name="userID" value="{{ @POST.userID }}">
Copied!
Методыsave(),update(), copyFrom()Data mapper и параметризованные варианты load()and erase()безопасны от SQL-инъекции.
По умолчанию load()метод сопоставления данных извлекает только первую запись, соответствующую заданным критериям. Если у вас есть несколько записей, удовлетворяющих тому же условию, что и первая загруженная запись, вы можете использовать этот skip()метод для навигации:
1
$user=new DB\SQL\Mapper($db,'users');
2
$user->load('visits>3');
3
// Переписано как параметризованный запрос
4
$user->load(array('visits>?',3));
5
6
// Для пользователей MongoDB:
7
// $user=new DB\Mongo\Mapper($db,'users');
8
// $user->load(array('visits'=>array('$gt'=>3)));
9
10
// Если вы предпочитаете Jig:
11
// $user=new DB\Jig\Mapper($db,'users');
12
// $user->load('@visits>?',3);
13
14
// Отобразите идентификатор пользователя первой записи, соответствующей критериям
15
echo $user->userID;
16
// Перейдите к следующей записи, соответствующей тем же критериям
17
$user->skip(); // Так же, как $user->skip(1);
18
// Вернемся к первой записи
19
$user->skip(-1);
20
// Переместите три записи вперед
21
$user->skip(3);
Copied!
Вы можете использовать $user->next()в качестве замены$user->skip(), и $user->prev()если вы думаете, что это дает больше смысла$user->skip(-1).
Используйте этот dry()метод, чтобы проверить, не вышли ли вы за пределы результирующего набора. dry() вернет TRUE, если вы попробуете skip(-1)на первой записи. Он также вернет TRUE, если вы skip(1)на последней записи, которая соответствует критериям извлечения.
load()Метод принимает второй аргумент: массив опций, содержащий пары ключ-значение, такие как:
1
$user->load(
2
array('visits>?',3),
3
array(
4
'order'=>'userID DESC',
5
'offset'=>5,
6
'limit'=>3
7
)
8
);
Copied!
Если вы используете MySQL, запрос преобразуется в:
1
SELECT * FROM users
2
WHERE visits>3
3
ORDER BY userID DESC
4
LIMIT 3 OFFSET 5;
Copied!
Это один из способов представления данных в виде небольших фрагментов. Вот еще один способ разбиения результатов на страницы:
1
$page=$user->paginate(2,5,array('visits>?',3));
Copied!
В приведенном выше сценарии F3 будет извлекать записи, соответствующие этим критериям 'visits>3'. Затем он ограничит результаты 5 записями (на страницу), начиная со смещения страницы 2 (на основе 0). Фреймворк вернет массив состоящий из следующих элементов:
1
[subset] массив объектов картографа, соответствующих критериям
2
[total] сумма всех записей для всех страниц
3
[limit] то же значение, что и параметр размера (здесь 5)
4
[count] количество доступных подмножеств/страниц
5
[pos] фактическая позиция подмножества
Copied!
Фактическая возвращаемая позиция подмножества будет равна нулю, если первый аргумент paginate()является отрицательным числом или превышает число найденных подмножеств.

Виртуальные Поля

Бывают случаи, когда вам нужно получить вычисленное значение поля или значение перекрестной ссылки из другой таблицы. Введите виртуальные поля. SQL mini-ORM позволяет работать с данными, полученными из существующих полей.
Предположим, что у нас есть следующая таблица, определенная как:
1
CREATE TABLE products (
2
productID VARCHAR(30),
3
description VARCHAR(255),
4
supplierID VARCHAR(30),
5
unitprice DECIMAL(10,2),
6
quantity INT,
7
PRIMARY KEY(productID)
8
);
Copied!
totalpriceПоля не существует, поэтому мы можем сказать фреймворку, чтобы он запросил у компонента database engine арифметическое произведение этих двух полей:
1
$item=new DB\SQL\Mapper($db,'products');
2
$item->totalprice='unitprice*quantity';
3
$item->load(array('productID=:pid',':pid'=>'apple'));
4
echo $item->totalprice;
Copied!
Приведенный выше фрагмент кода определяет вызываемое виртуальное полеtotalprice, которое вычисляется путем умножения unitpriceна число quantity. SQL mapper сохраняет это правило / формулу, поэтому, когда приходит время извлекать запись из базы данных, мы можем использовать виртуальное поле как обычное отображенное поле.
Вы можете иметь более сложные виртуальные поля:
1
$item->mostNumber='MAX(quantity)';
2
$item->load();
3
echo $item->mostNumber;
Copied!
На этот раз фреймворк извлекает продукт с наибольшим количеством (обратите load()внимание, что метод не определяет никаких критериев, поэтому все записи в таблице будут обработаны). Конечно, виртуальное поле mostNumberвсе равно даст вам правильную цифру, если вы хотите ограничить выражение определенной группой записей, соответствующих заданным критериям.
Вы также можете получить значение из другой таблицы:
1
$item->supplierName=
2
'SELECT name FROM suppliers '.
3
'WHERE products.supplierID=suppliers.supplierID';
4
$item->load();
5
echo $item->supplierName;
Copied!
Каждый раз, когда вы загружаете запись из таблицы products, ORM перекрестно ссылается на supplerIDin the productstable с supplierIDin the supplierstable.
Чтобы уничтожить виртуальное поле, используйте unset($item->totalPrice);. isset($item->totalPrice)Выражение возвращает TRUE, если totalPriceвиртуальное поле было определено, или FALSE, если нет.
Помните, что виртуальное поле должно быть определено до получения данных. ORM не выполняет ни собственно вычисление, ни вывод результатов из другой таблицы. Именно компонент database engine выполняет всю тяжелую работу.

Ищите и вы найдете

Если у вас нет необходимости в навигации по записям, вы можете получить всю партию записей одним выстрелом:
1
$frequentUsers=$user->find(array('visits>?',3),array('order'=>'userID'));
Copied!
Синтаксис запросов jig mapper имеет небольшое сходство:
1
$frequentUsers=$user->find(array('@visits>?',3),array('order'=>'userID'));
Copied!
Эквивалентный код с использованием картографа MongoDB:
1
$frequentUsers=$user->find(array('visits'=>array('$gt'=>3)), array('order'=>array('userID'=>1)));
Copied!
find()Метод ищет в usersтаблице записи, соответствующие критериям, сортирует результат по userIDним и возвращает результат в виде массива объектов mapper. find('visits>3') отличается от load('visits>3')него . Последнее относится к текущему $userобъекту. find() не оказывает на него никакого влияния skip().Важно: Объявление пустого условия, NULL или строки нулевой длины в качестве первого аргумента find()or load()приведет к извлечению всех записей. Убедитесь, что вы знаете, что делаете - вы можете превысить "memory_limit" PHP на больших таблицах или коллекциях
Этот find()метод имеет следующий синтаксис:
1
find(
2
$criteria,
3
array(
4
'group'=>'foo',
5
'order'=>'foo,bar',
6
'limit'=>5,
7
'offset'=>0
8
)
9
);
Copied!
функция find() возвращает массив объектов. Каждый объект является сопоставителем записи, соответствующей заданным критериям.:
1
$place=new DB\SQL\Mapper($db,'places');
2
$list=$place->find('state="New York"');
3
foreach ($list as $obj)
4
echo $obj->city.', '.$obj->country;
Copied!
Если вам нужно преобразовать объект mapper в ассоциативный массив, используйте этот cast()метод:
1
$array=$place->cast();
2
echo $array['city'].', '.$array['country'];
Copied!
Чтобы получить количество записей в таблице, соответствующих определенному условию, используйте этот count()метод.
1
if (!$user->count(array('visits>?',10)))
2
echo 'Нам нужна лучшая рекламная кампания!';
Copied!
Существует также select()метод, который аналогиченfind(), но обеспечивает более мелкозернистый контроль над возвращаемыми полями. Он имеет SQL-подобный синтаксис:
1
select(
2
'foo, bar, baz',
3
'foo > ?',
4
array(
5
'group'=>'foo, bar',
6
'order'=>'baz ASC',
7
'limit'=>5,
8
'offset'=>3
9
)
10
);
Copied!
Как find()и метод, select()он не изменяет содержимое объекта mapper. Он служит только в качестве удобного метода для запроса сопоставленной таблицы. Возвращаемое значение обоих методов представляет собой массив объектов mapper. Использование dry()для определения того, была ли запись найдена одним из этих методов, неуместно. Если ни одна запись не соответствует критерию find()илиselect(), возвращаемое значение является пустым массивом.Имейте в виду: load() гидратирует текущий объект mapper, findoneвозвращает новый гидратированный объект mapper и findвозвращает массив гидратированных объектов mapper.Опасность: массив $options for не использует параметризованные значения полей и не очищается от входных данных пользователя. Если вы просто помещаете значения GET или POST в группу, ордер, лимит или смещение, не проверяя их заранее, вы открываете проблему безопасности, и могут произойти плохие вещи.

Профилирование

Если вы когда-нибудь захотите выяснить, какие операторы SQL, выпущенные непосредственно вашим приложением (или косвенно через объекты mapper), вызывают узкие места производительности, вы можете сделать это с помощью простого:
1
echo $db->log();
Copied!
F3 отслеживает все команды, выданные базовому драйверу базы данных SQL, а также время, необходимое для завершения каждой инструкции - именно та информация, которая необходима для настройки производительности приложения.

Иногда этого просто недостаточно

В большинстве случаев вы можете жить с комфортом, предоставляемым методами картографирования данных, которые мы обсуждали до сих пор. Если вам нужен фреймворк для выполнения какой-то тяжелой работы, вы можете расширить SQL mapper, объявив свои собственные классы с помощью пользовательских методов, но вы не можете избежать того, чтобы ваши руки были жирными на некоторых хардкорных SQL:
1
class Vendor extends DB\SQL\Mapper {
2
// Создать экземпляр картографа
3
function __construct(DB\SQL $db) {
4
// Именно здесь происходит синхронизация картографа и структуры БД
5
parent::__construct($db,'vendors');
6
}
7
8
// Специализированный запрос
9
function listByCity() {
10
return $this->select('vendorID,name,city',null,array('order'=>'city DESC'));
11
/*
12
Мы могли бы сделать то же самое с обычным ванильным SQL:
13
return $this->db->exec(
14
'SELECT vendorID,name,city FROM vendors '.
15
'ORDER BY city DESC;'
16
);
17
*/
18
}
19
}
20
21
$vendor=new Vendor;
22
$vendor->listByCity();
Copied!
Расширение карт данных таким образом-это простой способ построить модели, связанные с БД вашего приложения.

плюсы и минусы

Если вы хорошо разбираетесь в SQL, вы, вероятно, скажете: все в ORM можно обрабатывать с помощью SQL-запросов старой школы. Действительно. Мы можем обойтись без дополнительных прослушивателей событий, используя триггеры базы данных и хранимые процедуры. Мы можем выполнять реляционные запросы с Объединенными таблицами. ОРМ - это просто ненужные накладные расходы. Но суть в том, что картографы данных дают вам дополнительную функциональность использования объектов для представления сущностей базы данных. Как разработчик, вы можете писать код быстрее и продуктивнее. Полученная программа будет чище, если не короче. Но вам придется взвесить преимущества против компромисса в скорости - особенно при работе с большими и сложными хранилищами данных. Помните, что все ОРМЫ - какими бы тонкими они ни были - всегда будут просто еще одним абстрактным слоем. Они все еще должны передать работу базовым SQL-движкам.
По замыслу, ORMs F3 не предоставляют методов для непосредственного соединения объектов друг с другом, то есть SQL - соединений, потому что это открывает банку червей. Это делает ваше приложение более сложным, чем оно должно быть, и есть тенденция объектов через нетерпеливые или ленивые методы выборки быть заблокированными и даже несинхронизированными из-за наследования объектов и полиморфизма (несоответствия импеданса) с объектами базы данных, с которыми они сопоставлены. Есть косвенные способы сделать это в SQL mapper, используя виртуальные поля - но вам придется делать это программно и на свой страх и риск.
Если вы испытываете искушение применить" чистые " концепции ООП в своем приложении для представления всех ваших данных (потому что "все является объектом"), имейте в виду, что данные почти всегда живут дольше, чем приложение. Ваша программа может устареть задолго до того, как данные потеряют свою ценность. Не добавляйте еще один уровень сложности в свою программу, используя переплетенные объекты и классы, которые слишком сильно отклоняются от схемы и физической структуры данных.
Прежде чем объединять несколько объектов в приложении для управления базовыми таблицами в базе данных, подумайте вот о чем: создание представлений для представления связей и триггеров для определения поведения объектов в ядре СУБД более эффективно. Движки реляционных баз данных предназначены для обработки представлений, Объединенных таблиц и триггеров. Это не тупые хранилища данных. Таблицы, объединенные в представление, будут отображаться как одна таблица, и Fat-Free может автоматически отображать представление так же, как и обычную таблицу. Репликация соединений как реляционных объектов в PHP происходит медленнее по сравнению с машинным кодом ядра СУБД, реляционной алгеброй и логикой оптимизации. Кроме того, многократное объединение таблиц в нашем приложении является верным признаком того, что дизайн базы данных нуждается в аудите, а представления считаются неотъемлемой частью поиска данных. Если таблица часто ссылается на данные из другой таблицы, подумайте о нормализации структуры или создании представления. Затем создайте объект mapper для автоматического отображения этого представления. Это быстрее и требует меньше усилий.
Рассмотрим это представление SQL, созданное внутри вашего ядра СУБД:
1
CREATE VIEW combined AS
2
SELECT
3
projects.project_id AS project,
4
users.name AS name
5
FROM projects
6
LEFT OUTER JOIN users ON
7
projects.project_id=users.project_id AND
8
projects.user_id=users.user_id;
Copied!
Код вашего приложения становится простым, потому что ему не нужно поддерживать два объекта mapper (один для таблицы проектов, а другой для пользователей) только для извлечения данных из двух соединенных таблиц:
1
$combined=new DB\SQL\Mapper($db,'combined');
2
$combined->load(array('project=?',123));
3
echo $combined->name;
Copied!
Совет: используйте инструменты так, как они предназначены. Fat-Free уже имеет простой в использовании помощник SQL. Используйте его, если вам нужен больший молоток :) попробуйте найти баланс между удобством и производительностью. SQL всегда будет вашим резервным вариантом, если вы работаете со сложными и устаревшими структурами данных.