7 января, 2010

Как и обещал, продолжаю цикл статей о создании сайта на базе фреймворка Yii. Сегодня мы поговорим об архитектуре базы данных и разберем установку фреймворка.

Начнем с базы данных.

Как вы, наверное, помните наш сайт будет использовать данные из игровой партнерки GameBoss.ru. Эти данные можно получить несколькими способами, но в нашем случае удобнее всего XML фид.

Естественно, просто скопировать данные из фида не получится (позже мы напишем специальный метод для этой цели), а сейчас нам нужно разработать структуру базы.

Получить XML фид можно по адресу

http://gameboss.ru/x2.php?partner=38370&limit=1000&genre=127&short=1&full=1&image=1

где partner=ваш_партнерский_id (его вы получаете при регистрации в партнерке)

Взгляните на скриншот фида.

Как видите, большинство названий говорят сами за себя. Но нас сейчас интересуют повторяющиеся теги, т.к. их нужно будет хранить в отдельных таблицах (отношение один-к-многим).

Такой тег только один – SCREENSHOT. Но есть еще тег TYPE, в нём в закодированной форме записан список жанров, к которым относится игра. Т.е. получается, что к одной игре может относиться несколько жанров, и, в тоже время, к одному жанру может относиться несколько игр. В результате получаем отношение многие-к-многим.

Взгляните на структуру базы, которая у меня получилась.

Данные игр хранятся в таблице – ygs_games, список жанров – в таблице ygs_types. Связь между ними (многие-к-многим) устанавливается с помощью таблицы ygs_games_types.

Таблица ygs_screenshots служит для хранения данных о скриншотах.

Таблица ygs_users используется для хранения данных о пользователях. У нас в ней будет только одна запись – акаунт администратора.

И последняя таблица ygs_clients. Она просто зарезервирована. Есть идея насчет её использования, но окончательно я ещё не решил , поэтому можете её спокойно проигнорировать.

Хочу обратить ваше внимание на два момента.

1) Я старался, чтобы названия полей в таблицах совпадали с названиями тегов в фиде (к ним просто добавляется приставка), так меньше путаницы возникает.

2) Префиксы таблиц (ygs – это сокращение от yii game site). Но тут я немного поспешил. Дело в том, что поддержка префиксов в Yii появится в версии 1.1, а последняя стабильная – 1.0.11. Конечно, есть способ решения этой проблемы, но его мы трогать не будем, учитывая, что до выхода 1.1 осталось немного времени.

Надеюсь со структурой базы всё более-менее понятно. В одной из следующих статей я выложу исходники этого приложения и там же будет дамп базы.

Переходим к установке фреймворка

Сразу хочу предупредить, я опишу вариант, который показался мне наиболее удобным для тестирования фреймворка. Вы можете выбрать другую структуру папок.

Качаем архив и распаковываем его в какую-нибудь папку, например,

E:\yii_1_0_11

Должна получиться такая структура папок

E:\yii_1_0_11\demos E:\yii_1_0_11\framework E:\yii_1_0_11\requirements ......

При этом в папке E:\yii_1_0_11\framework находится файл yiic.bat, который запускает скрипт генерации кода. Чтобы им было удобнее пользоваться, нужно добавить этот путь к системной переменной PATH. Под Windows это можно сделать в свойствах «Моего компьютера», вкладка «Дополнительно», кнопка «Переменные среды».

PATH = ……;E:\yii_1_0_11\framework

Примечание. Для линукса используется файл yiic, который находится в этой же папке, т.е. сделать нужно тоже самое – указать путь к этому файлу в переменной PATH.

После этого открываем консоль и выполняем команду yiic. Вы должны увидеть строку
Yii command runner (based on Yii v1.0.11)
и после неё краткую инструкцию по использованию этой утилиты.

Теперь можно создать каркас приложения.

Чтобы было немного удобнее работать, я советую создать виртуальный домен. Например, так.

<VirtualHost 127.0.0.1>
ServerName www.yiigame.l
DocumentRoot "E:/www/YiiGameSite/public_html"
ServerAlias yiigame.l *.yiigame.l
</VirtualHost>

Как видите, наше приложение будет находиться в папке E:\www\YiiGameSite\public_html.

Создаем эту папку и переходим в неё в консоли.

cd E:\www\YiiGameSite\public_html

Выполняем команду

yiic webapp .

Обратите внимание, после webapp должны идти пробел и точка, это указывает, что вы хотите выполнить установку в текущую папку. Если вы находитесь в папке E:\www\YiiGameSite, то можно выполнить команду так yiic webapp public_html, т.е. во втором параметре вы указываете путь к приложению относительно текущей папки.

Утилита запросит подтверждение, нажимаете «Y» и enter. После этого в папке появятся файлы приложения.

Всё, теперь можно открыть браузер (надеюсь web сервер у вас запущен ) и по адресу www.yiigame.l вы увидите работающий сайт. Правда он не имеет никакого отношения к нашей задаче, но этой проблемой мы займемся в следующий раз.

До встречи!

Все разделы цикла.

Постовой

Правильный кадровый учет документов на предедприятии – это то, что мы умеем делать лучше всего

Понравилась статья? Подписывайтесь на продолжение !

Или на мой твиттер

Добавьте эту страницу в

Опубликовано в PHP, Web разработка, Yii View Comments

GTAlex

Спасибо, Владимир - а в CodeIgniter подобная фишка имеется ? (имею ввиду лог)
вообще интересует возможность самому писать в лог
(в обоих фреймворках)
в CodeIgniter не нашел - самому пришлось писать класс
Владимир

И в CI, и в Yii есть встроенные библиотеки для ведения логов.
В CI используется функция log_message.
В Yii CLogger::log.
В обоих случаях нужно указать текст сообщения и его "уровень" (например, info, warning, error и т.п.). Уровни используются для последующей фильтрации сообщений. Например, вы можете выводить только ошибки (error) и пропустить предупреждения (warning).
GTAlex

как отключить "журнал приложения" справа ?

в index.php закомментировал
defined('YII_DEBUG') or define('YII_DEBUG',true);
- не помогло

установка
define('YII_DEBUG',false);
тоже
Владимир
В конфиге
```
'log'=>array(
	'class'=>'CLogRouter',
	'routes'=>array(
		array(
			//выводим лог внизу страницы
			'class'=>'CWebLogRoute',
			'levels'=>'trace, info',
		),
	),
),
```
если уберете весь блок - вообще лога не будет, можно заменить CWebLogRoute на CFileLogRoute, тогда вывод лога будет в файл.
GTAlex

почитал README с фреймворка - всё прояснилось :)
запускать нужно из каталога фреймворка, а указывать путь на папку приложения
напр.
yiic webapp ..\testdrive
так отработало
т.е. в моем случае:
руками копирнул framework в корень будущего приложения
cd .\framework
yiic webapp ..\
несработало
пришлось хитрить - создал папку testdrive
yiic webapp ..\testdrive - всё окей
далее скопировал содержимое testdrive на место, подправил index.php (убрал две точки ..)
далее уже поверх накатил содержимое твоего архивного файлика
GTAlex

нифига не получилось
во первых у меня ругалось на отсутствие файла php.exe
пришлось найти его в денвере и прописать путь в path
во вторых при выполнении "yiic webapp ." запрашивает
Create a Web application under 'Z:\home\yii\yii\framework'? [Yes/No] - т.е. пытается что то создавать и делать в самом дистрибутиве приложения, а не в папке откуда я запускаю и куда по идее инсталятор должен что-то скопировать из дистриба!

напрягает последняя строчка в результате работы скрипта
"Error in my_thread_global_end(): 1 threads didn'n exit"

пути у меня такие:
Z:\home\yii\www\ - сюда надо ставить (развернул yii_game_site.zip именно сюда)
Z:\home\yii\yii\ - тут развернутый дистрибутив (yii-1.1.1.r1907.zip) (соответсвенно в path я добавлял Z:\home\yii\yii\framework\)

в общем можно подробнее, что и куда нужно скопировать из дистрибутива для установки вручную ?
либо укажите где я не прав ?
Денис

Спасибо за статьи )))

Возникла проблема. Пробовал запустить твои исходнике на Денвере и WAMPe. Все сделал по инструкции. При запуске index.php выдается длинный лог yii, где ключевая ошибка:

Рабочий (runtime) путь приложения "D:\wamp\www\yii\protected\runtime" задан неверно. Удостоверьтесь, что директория доступна для записи пользователю, под которым запущен веб-сервер.

Уже второй час мурыжу эту бяку, все никак...
Владимир

Проверьте, пожалуйста, существует ли эта папка (runtime) и если нет, создайте её. В неё yii хранит временные файлы (кеш, например).
Тоже самое касается папки assets, которая должна находится в корне сайта (там же, где и index.php).
Арсений

Если не секрет, зачем устраивать танцы с переменной PATH? ИМХО, это не совсем нужно, потому что yiic из дистрибутива фреймворка используется ровно один раз на каждое приложение; а этот путь постоянно в переменной PATH имеет потенциальную опасность конфликта, если, например, у нас появятся дистрибутивы с двумя разными версиями фреймворка.
Владимир

Согласен, конфликт может быть, но yiic вас об этом предупредит. Он действительно должен в идеале использоваться только один раз на приложение, но при изучении фреймворка часто возникает желание попробовать ту или иную фичу, а для этого можно быстренько сделать отдельное приложение. Поэтому и выходит, что время от времени пользоваться приходится, а писать каждый раз полный путь лень ;)
Но это дело вкуса, можно не трогать PATH.
Sam

На самом деле лучше сразу показывать на 1.1. Релиз очень скоро.

Приложение можно и без консоли создать. Достаточно скопировать framework/cli/views/webapp/protected/.

Теги будут руками или при помощи CTaggableBehaviour?

Почему u_password типа VARCHAR(50), а не CHAR(40) или CHAR(32)?
Владимир

С консолью удобнее :)
Владимир

Из 1.1 пока нужна только поддержка префиксов таблиц. Думаю, после выхода будет несложно перейти.

Теги руками, просто не успеваю попробовать все расширения. И мне хотелось поработать именно с библиотекой Yii, а с этим расширением получится, что не будет примера по работе со связями многие-к-многим. Хотя, возможно, я не прав. Выглядит это расширение очень удобным.

VARCHAR(50) - спасибо, забыл изменить. Подойдет CHAR(32) (храниться будет md5 хеш).
xoma

to Cool - http://wb.mysql.com/...

Хороший туториал, жду продолжения!
Владимир

Хоma вы правы, это MySQL Workbench
COOL

что за программа для отображения структуры таблиц базы данных?
web-junior

Я тоже хотел об этом спросить. Неплохо отображает структуру и связи. Очень похоже на Enterprise Architect