Дискуссия: Расширения и документация yii
Re: Дискуссия: Расширения и документация yii
Не знаю куда писать, поэтому пишу здесь.
на странице http://www.yiiframework.com/doc/api/CDbCriteria
в списке Public Properties не хватает свойства on
нашел описание здесь http://yiiframework.ru/doc/guide/ru/database.arr:
может кому пригодится, если не поправят API
на странице http://www.yiiframework.com/doc/api/CDbCriteria
в списке Public Properties не хватает свойства on
нашел описание здесь http://yiiframework.ru/doc/guide/ru/database.arr:
Код: Выделить всё
on: соответствует оператору ON. Условие, указываемое в этом параметре, будет добавлено к условию объединения с использованием оператора AND. Для используемых столбцов должны быть разрешены конфликты имён. Данный параметр неприменим для отношений типа MANY_MANY. Параметр доступен, начиная с версии 1.0.2;
- samdark
- Администратор
- Сообщения: 9489
- Зарегистрирован: 2009.04.02, 13:46
- Откуда: Воронеж
- Контактная информация:
Re: Дискуссия: Расширения и документация yii
Вообще его в CDbCriteria и нет. Это свойство относится к CActiveRecordRelation.
Нравится Yii? Давайте сделаем его лучше!.
Re: Дискуссия: Расширения и документация yii
RuZk писал(а):В документации очень не хватает примеров задания различных отношений AR, например как связать 2 таблицы посредством третей (я пока так и не понял, возможно ли это вообще сделать (viewtopic.php?f=3&t=1089 дополнительный вопрос в 3 посте))
1) таблица посредник с 2-мя отношениями (левое и правое)Есть больше одного способа сделать это.
2) отношение у отношения
Код: Выделить всё
//...
$criteria->with = array(
'category',
'translation',
'translation_en',
'anyRelation'=>array('with' => array('parent'))
);
//...
$criteria->with = array(
'category',
'translation',
'translation_en',
'anyRelation.parent'
);
//...
Re: Дискуссия: Расширения и документация yii
В документации очень часто забвают о мелочах. Например вот -- http://www.yiiframework.com/forum/index ... n-buttons/ , потратил наверное полчаса на гугление данного вопроса. Может в документации лучше приводить полные примеры, со всеми опциями и тд?
Re: Дискуссия: Расширения и документация yii
да. я тоже над каждой мелочью сижу подолгу. не так и легко "войти" в фреймворк. отсутствие примеров очень напрягает.Dr0ID писал(а):В документации очень часто забвают о мелочах. Например вот -- http://www.yiiframework.com/forum/index ... n-buttons/ , потратил наверное полчаса на гугление данного вопроса. Может в документации лучше приводить полные примеры, со всеми опциями и тд?
но я так понимаю, это из-за нехватки человеческих ресурсов.
сейчас пытаюсь после штудирования как-то конспектировать и делать заметки к api
Якоря в документации
SamDark, возможно, имеет смысл добавить на страницы русскоязычной документации якоря. Будет удобнее и ссылку дающему и адресату. (в сравнении с http://... "Раздел такой-то".) Если в результате обсуждений или технических сложностей данный вариант уже был отклонён - приношу извинения
ps. со своей стороны готов оказать помощь в подборе|вставке якорей
pps. для автогенерации (если возможно) можно пользовать транслит или "а-ля википедия" #.D0.A7.D0...
ps. со своей стороны готов оказать помощь в подборе|вставке якорей
pps. для автогенерации (если возможно) можно пользовать транслит или "а-ля википедия" #.D0.A7.D0...
...
Re: Якоря в документации
поддерживаю, c якорями намного удобнее было бesche писал(а):SamDark, возможно, имеет смысл добавить на страницы русскоязычной документации якоря. Будет удобнее и ссылку дающему и адресату. (в сравнении с http://... "Раздел такой-то".) Если в результате обсуждений или технических сложностей данный вариант уже был отклонён - приношу извинения
ps. со своей стороны готов оказать помощь в подборе|вставке якорей
pps. для автогенерации (если возможно) можно пользовать транслит или "а-ля википедия" #.D0.A7.D0...
- TranceSmile
- Сообщения: 562
- Зарегистрирован: 2011.06.27, 19:04
- Откуда: Украина
- Контактная информация:
Re: Дискуссия: Расширения и документация yii
Если честно то половина документации очень заумно написана (или просто упущены какие-то мелочи). Я только позавчера капитально взялся его изучать (я бы может и отказался от него, но я уже давно знаю SamDark-a я думаю за гнилой проект он бы не брался).
- samdark
- Администратор
- Сообщения: 9489
- Зарегистрирован: 2009.04.02, 13:46
- Откуда: Воронеж
- Контактная информация:
Re: Дискуссия: Расширения и документация yii
esche, rak, якоря прикручу.
TranceSmile, стоит собрать список таких непонятных мест или мест с излишне заумными формулировками и отметить, что именно непонятно. Возможно, поможет улучшить документацию.
TranceSmile, стоит собрать список таких непонятных мест или мест с излишне заумными формулировками и отметить, что именно непонятно. Возможно, поможет улучшить документацию.
Нравится Yii? Давайте сделаем его лучше!.
- greatdane
- Сообщения: 408
- Зарегистрирован: 2010.10.20, 14:05
- Откуда: Электросталь
- Контактная информация:
Re: Дискуссия: Расширения и документация yii
Да просто примеров надо больше в документации. Особенно в английском API. Тогда сразу документация перестанет казаться сухой и заумной...
- samdark
- Администратор
- Сообщения: 9489
- Зарегистрирован: 2009.04.02, 13:46
- Откуда: Воронеж
- Контактная информация:
Re: Дискуссия: Расширения и документация yii
Конкретику надо. А лучше сами примеры. С радостью добавлю.
Нравится Yii? Давайте сделаем его лучше!.
- greatdane
- Сообщения: 408
- Зарегистрирован: 2010.10.20, 14:05
- Откуда: Электросталь
- Контактная информация:
Re: Дискуссия: Расширения и документация yii
К тому времени, как до меня доходит, как что-то сделать — мне уже пофиг, есть пример в документации или нет... ну просто ко всему нужны примеры для новичка. К валидаторам, к виджетам, к CHtml...
Re: Дискуссия: Расширения и документация yii
+1 xDgreatdane писал(а):К тому времени, как до меня доходит, как что-то сделать — мне уже пофиг, есть пример в документации или нет...
... к COutputCachegreatdane писал(а):ну просто ко всему нужны примеры для новичка. К валидаторам, к виджетам, к CHtml...
По поводу расширений я считаю, что можно "зарегистрировать" в Yii подкоманду опытных разработчиков, которым интересна разработка расширений и которая будет производить ревизию пользовательских расширений и принимать решения о добавлении их к "официальной коллекции" либо давать рекомендации автору по исправлению/улучшению, а также писать и развивать свои расширения "на наиболее популярные темы".
Т.е. сторонние авторы расширений могли бы и дальше сваливать их в общую кучу или, если это - что-то стоящее, регистрировать свое расширение для ревизии и возможного утверждения.
- samdark
- Администратор
- Сообщения: 9489
- Зарегистрирован: 2009.04.02, 13:46
- Откуда: Воронеж
- Контактная информация:
Re: Дискуссия: Расширения и документация yii
Примерно такая команда у нас в yiiext https://github.com/yiiext. Единственное — нет официального статуса…
Нравится Yii? Давайте сделаем его лучше!.
Re: Дискуссия: Расширения и документация yii
Добрый день.
Разбираюсь с yii с понедельника, чайнику от документации мало пользы: куски кода и непонятно, как их использовать.
Количество вопросов после чтения этой документации только увеличивается.
Если бы был пример, как вставить приведенный код в метод xxx класса yyy итп и где он может применяться (в модели, в контроллере итп), было бы здорово.
Вероятно, в документацию следует добавить FAQ , а потом доработать ее с учетом вопросов, возникающих у начинающих.
Разбираюсь с yii с понедельника, чайнику от документации мало пользы: куски кода и непонятно, как их использовать.
Количество вопросов после чтения этой документации только увеличивается.
Если бы был пример, как вставить приведенный код в метод xxx класса yyy итп и где он может применяться (в модели, в контроллере итп), было бы здорово.
Вероятно, в документацию следует добавить FAQ , а потом доработать ее с учетом вопросов, возникающих у начинающих.
- samdark
- Администратор
- Сообщения: 9489
- Зарегистрирован: 2009.04.02, 13:46
- Откуда: Воронеж
- Контактная информация:
Re: Дискуссия: Расширения и документация yii
http://yiiframework.ru/doc/guide/ru/bas ... -practices разве не отвечает на вопрос, где и что использовать?
Нравится Yii? Давайте сделаем его лучше!.
Re: Дискуссия: Расширения и документация yii
Что бы начать работать с Yii достаточно пробежаться по документации, пройти тоториал, не скопипастить, а именно повторить. Не достающие куски всегда можно посмотреть в исходниках, которые идут вместе с дистрибутивом фреймворка.
Мне кажется что документация к фреймворку не должна превращаться в документацию по PHP или алгоритмам.
Вот пришлось спустя 4 года окунутся в CodeIgniter, вот там вот документация страдает.
Огромное спасибо команде Yii за поддержание документации и API в актуальном состоянии.
Мне кажется что документация к фреймворку не должна превращаться в документацию по PHP или алгоритмам.
Вот пришлось спустя 4 года окунутся в CodeIgniter, вот там вот документация страдает.
Огромное спасибо команде Yii за поддержание документации и API в актуальном состоянии.
- tiron_alexey
- Сообщения: 13
- Зарегистрирован: 2010.07.13, 16:17
- Откуда: Одесса
- Контактная информация:
Re: Дискуссия: Расширения и документация yii
+1aser писал(а):Огромное спасибо команде Yii за поддержание документации и API в актуальном состоянии.
Документация в нормальном состоянии (по крайней мере сейчас мне достаточно, может дальше чет не будет хватать ). Иногда правда все таки не хватает примеров, для того, чтобы быстрее разобраться, но соглашусь с aser - "документация к фреймворку не должна превращаться в документацию по PHP или алгоритмам".
-
- Сообщения: 11
- Зарегистрирован: 2010.05.17, 16:30
- Откуда: Нижневартовск
- Контактная информация:
Re: Дискуссия: Расширения и документация yii
Sam Dark писал(а): стоит собрать список таких непонятных мест или мест с излишне заумными формулировками и отметить, что именно непонятно. Возможно, поможет улучшить документацию.
Прочитал документацию. Выполнил демо пример. Заглядывал в API. Смотрел и разбирался в коде Юпи и ПламЦМФ.
После 2 суток общения с Yii сложились вопросы:
Active Records
1. Модели без AR. Да, в документации есть пример, но он какой-то жиденький.
2. Чего мы лишаемся, при НЕиспользовании AR?
3. Валидация, пагинация, zii-виджеты с dataProvider, кэширование для моделей без AR.
4. Как можно оптимизировать AR, кроме кэширования схемы.
Модели
5. Включить в официальную документацию расширенный пример с DAO (да он есть в рецептах, может что то добавить в основную документацию)
по мне, так более понятно описано в Laravel http://laravel.ru/docs/models#сущности, http://laravel.com/docs/models#best-practices
Различия между DAO и Entities - Services - Repositories: http://stackoverflow.com/questions/8550 ... y-patterns
6. Простые модели, а ля модели CodeIgniter. То есть когда есть построитель запросов, с помощью которого выполняются выборки и возврат результатов. 1 модель - 1 файл.
7. Было бы не плохо добавить в документацию или в рецепты более глобальный пример использования Yii без AR. Можно на примере базового демо-блога.
Общее
8. В документации используется просто Widget. В примере по демоблогу используется Yii::import('zii.widgets.CPortlet'). Вначале я думал что я читал невнимательно официальную документацию. Проверил поиском "CPortlet" - ничего не найдено. Зачем нужно делать Yii::import?
ps. Данные вопросы дублирую в ветке вопросов. Интересные ответы - верну сюда.