Ubilling Wiki

Користувальницькькі налаштування

Налаштування сайту

Відвідано: • nyanorm
nyanorm

Розбіжності

Тут показані розбіжності між вибраною ревізією та поточною версією сторінки.

Посилання на цей список змін

Порівняння попередніх версій Попередня ревізія
Наступна ревізія 		Попередня ревізія
nyanorm [2023/06/16 13:13]
nightfly 		nyanorm [2023/06/16 13:46] (поточний)
nightfly [Що ще?]
Рядок 64: Рядок 64:
 </code> </code>
  
-Так, усе після префікса **nya_** буде розгорнуто в ім'я таблички as is і для неї буде автоматично згенеровано модель.+Так, усе після префіксу **nya_** буде розгорнуто в ім'я таблички as is і для неї буде автоматично згенеровано модель.
  
-Получаем все записи+отримуємо всі записи
 <code php> <code php>
 $allPayments=$payments->getAll(); //отримуємо всі записи з моделі $allPayments=$payments->getAll(); //отримуємо всі записи з моделі
Рядок 81: Рядок 81:
  
 <code php> <code php>
-class payments extends NyanORM { } // создаем модель наследованием, так как это лучше дружит с автокомплитом некоторых IDE +class payments extends NyanORM { } // створюємо модель наслідуванням, оскільки це краще дружить з автокомплітом деяких IDE 
-$payments = new payments(); // создаем объект модели +$payments = new payments(); // створюємо об'єкт моделі 
-$payments->where('summ', '>', '0'); //тут и дальше вешаем наши условия+$payments->where('summ', '>', '0'); //тут і далі вішаємо наші умови
 $payments->where('date', 'LIKE', curyear() . '%'); $payments->where('date', 'LIKE', curyear() . '%');
-$payments->where('cashtypeid', '=', '1'); // да, это наличка +$payments->where('cashtypeid', '=', '1'); // так, це готівка 
-$rawPayments = $payments->getAll('id'); // автоматическая группировка по id+$rawPayments = $payments->getAll('id'); // автоматичне групування результату по id
 debarr($rawPayments); debarr($rawPayments);
 </code> </code>
  
-Давайте еще раз, на примере, но с чем то-другим. Пускай это будут свитчи. И пускай мы хотим просто получить все свитчи.+Давайте ще раз, на прикладі, але з чимось іншим. Нехай це будуть світчі. І нехай ми хочемо просто отримати всі світчі.
 <code php> <code php>
 $switches = new nya_switches(); $switches = new nya_switches();
Рядок 96: Рядок 96:
 </code> </code>
  
-Куда уже проще?+ну або якось так без чорної магії, в лоб: 
 +<code php> 
 +$switches = new NyanORM('switches'); 
 +$allSwitches = $switches->getAll(); 
 +</code> 
 + 
 +Куди вже простіше?
  
-===== О параметрах моделей =====+===== Про параметри моделей =====
  
-Как можно было заметить для установки параметров наших запросов к моделям мы можем использовать метод where() с тремя довольно очевидными параметрами. Также довольно очевидно, что несколько where() идущих последовательно будут сохранены в кумулятивных структурах и в дальнейшем интерпретированы как AND. А что если мы внезапно захотим кроме платежей с наличкой получать оные также с типом 4 (пускай это будут какие-то штуки из самообслуживания)? Очевидно, что мы хотим условие OR. А как его сделать? А очень просто.+Як можна було помітити, для встановлення параметрів наших запитів до моделей ми можемо використовувати метод where() з трьома досить очевидними параметрами. Також досить очевидно, що кілька where(), що йдуть послідовно, будуть збережені в кумулятивних структурах і надалі інтерпретовані як AND. А що якщо ми раптово захочемо крім платежів із готівкою отримувати їх також із типом 4 (нехай це будуть якісь штуки із самообслуговування)? Очевидно, що ми хочемо умову OR. А як її зробити? А дуже просто.
  
 <code php> <code php>
 $payments->where('cashtypeid', '=', '1'); $payments->where('cashtypeid', '=', '1');
-$payments->orWhere('cashtypeid','=','4'); //Ага, все настолько очевидно.+$payments->orWhere('cashtypeid','=','4'); //Ага, все настільки очевидно
 </code>  </code> 
  
-Также если нам очень захочется пописать кусочки запросов руками вспомнив старое, либо если хочется сделать что нибудь такое "эдакое" чего из коробки не понятно как сделать при помощи конструктора NyanORM вы можете использовать whereRaw('expression')/orWhereRaw('expression') например так:+Також якщо нам дуже захочеться пописати шматочки запитів руками, згадавши старе, або якщо хочеться зробити щось таке "таке", чого з коробки не зрозуміло, як зробити, за допомогою конструктора запитів NyanORM, тоді ви можете використовувати whereRaw('expression')/orWhereRaw('expression'), наприклад так:
  
 <code php> <code php>
Рядок 116: Рядок 122:
 </code>  </code> 
  
-Что даст нам вполне себе идентичный результат. Но не красиво же, правда?+Що дасть нам цілком собі ідентичний результат. Але не красиво ж, правда? 
 +===== Про очищення параметрів =====
  
-===== О очистке параметров =====+Слід, до речі, зауважити, що після виконання методів типу getAll(), delete() і їм подібних. Усі раніше встановлені вами параметри моделей, як-от where, limit, order, data будуть скинуті. Це зроблено з метою безпеки. Наприклад ось вибираєте ви ці платежі, розглядаєте їх, а потім, уже забувши, що ви це робили кількома екранами коду вище, ви вирішили з якоїсь причини зробити delete(). І все. Вам результат не сподобався. Саме тому за замовчуванням відбувається автоматичне очищення цих параметрів. Метод delete(), наприклад, також своєю чергою нічого не робить без зазначених явно where і кидається на вас винятками.
  
-Следует кстати заметить, что после выполнения методов типа getAll(), delete() и им подобных. Все ранее установленные вами параметры моделей, такие как where, limit, order, data будут сброшены. Это сделано в целях безопасности. Например вот выбираете вы эти платежи, рассматриваете их, а потом, уже забыв, что вы это делали несколькими экранами кода выше, вы решили по какой-то причине сделать delete(). И все. Вам результат не понравился. Именно поэтому по-умолчанию происходит автоматическая очистка этих параметров. Метод delete(), например, также свою очередь ничего не делает без указанных явно where и бросается в вас исключениями. 
 \\ \\
-Если по какой-то причине, вы не хотите, чтобы происходила автоматическая очистка параметров моделей, вы можете установить параметр $flushParams этих очищающих методов в значение false.+Якщо з якоїсь причини, ви не хочете, щоб відбувалося автоматичне очищення параметрів моделей, ви можете встановити параметр $flushParams цих очищувальних методів у значення false.
 \\ \\
-Также в любой момент, вы можете самостоятельно очистить состояние любых параметров конкретной модели использовав соответствующий сеттер со всеми пустыми параметрами. +Також у будь-який момент ви можете самостійно очистити стан будь-яких параметрів конкретної моделі, використавши відповідний сеттер з усіма порожніми параметрами. 
  
 <code php> <code php>
Рядок 134: Рядок 140:
 </code> </code>
  
-Заметили, как ненавязчиво мы вам показали какие еще параметры (кумулятивные структуры) у моделей бывают? Да? ;)+Помітили, як ненав'язливо ми вам показали, які ще параметри (кумулятивні структури) у моделей бувають? Так? ;)
  
-===== Удаление данных ===== +===== Видалення даних ===== 
-Вы не поверите. Все настолько же линейно и просто. Давайте будем удалять запись из таблички abstractdevices с id 666?+ 
 +Ви не повірите. Усе настільки ж лінійно і просто. Давайте будемо видаляти запис із таблички abstractdevices з id 666?
  
 <code php> <code php>
Рядок 145: Рядок 152:
 </code> </code>
  
-===== Кумулятивная структура data() =====+===== Кумулятивна структура data() =====
  
-Кумулятивная структура **data** предназначена для хранения данных которые будут в дальнейшем использованы при вызове методов **create()** или **save()**. Собственно имеет она только два параметра, а именно **field** и **value**. Довольно не трудно догадаться как ее использовать:+Кумулятивна структура **data** призначена для зберігання даних, які будуть надалі використані під час виклику методів **create()** або **save()**. Власне має вона лише два параметри, а саме **field** та **value**. Досить не важко здогадатися як її використовувати:
  
 <code php> <code php>
 $object->data('somefield', 'new value'); $object->data('somefield', 'new value');
-$object->data('anotherfield', 'тоже какие-то данные');+$object->data('anotherfield', 'це теж типу якісь дані');
 </code> </code>
  
-===== Создание и изменение записей =====+===== Створення та зміна записів =====
  
-Помните кумулятивную структуру **data()**?  Она нам потребуется для создания записей в модели либо изменения существующих. Давайте создадим новую запись приблизительно для такой таблички:+Пам'ятаєте кумулятивну структуру **data()**?  Вона нам знадобиться для створення записів у моделі або зміни наявних. Давайте створимо новий запис приблизно для такої таблички:
  
 <code sql> <code sql>
Рядок 167: Рядок 174:
 </code> </code>
  
-Все очень прямолинейно.+Усе дуже прямолінійно.
  
 <code php> <code php>
 $object = new nya_someobjects(); $object = new nya_someobjects();
-$object->data('name', 'а это типа имя'); +$object->data('name', 'а це типу ім`я'); 
-$object->data('text', 'это типа текст записи');+$object->data('text', 'а це якби текст запису');
 $object->create(); $object->create();
 </code> </code>
  
-Заметьте, мы не указывали ручками NULL для автоинкрементного поля id, как так? А так, что у метода **create()** по умолчанию установлен параметр $autoAiId=true делающий это неявно. Если в вашей табличке нету автоинкрементного поля `id` или другого подобного primary key, вы должны установить этот параметр в false. Собственно имя поля главного ключа таблички вы всегда можете переназначить при помощи наследования. Он содержится в протектед проперти **defaultPk**.  +Зауважте, ми не вказували ручками NULL для автоінкрементного поля id, як так? А так, що у методу **create()** за замовчуванням встановлений параметр $autoAiId=true, який робить це неявно. Якщо у вашій табличці немає автоінкрементного поля `id` або іншого подібного primary key, ви маєте встановити цей параметр у false. Власне ім'я поля головного ключа таблички ви завжди можете перепризначити за допомогою наслідування. Він міститься в протектед проперті **defaultPk**.  
 \\ \\
 \\ \\
-Окей, запись создать мы создали, а как получить ее id? Для этого есть удобный метод **getLastId()** получающий последний **defaultPk** из таблички. +Окей, запис створити ми створили, а як отримати його id? Для цього є зручний метод **getLastId()**, який отримує останній **defaultPk** з таблички. 
-Вот как это работает:+Ось як це працює: 
 <code php> <code php>
-deb($object->getLastId()); // ой... возвращает 15+deb($object->getLastId()); // ой... повертає 15
 </code> </code>
  
-Окей, допустим мы внезапно захотели теперь изменить все или какое-то из полей в этой табличке. как быть? Все точно так-же как и с **create()** только при помощи **save()** но теперь нам еще понадобиться **where()**. Допустим мы будем редактировать последнюю запись в этой табличке:+Окей, припустимо, ми раптово захотіли тепер змінити всі або якесь конкретне із полів у цій табличці. як бути? Усе точно так само, як і з **create()** тільки за допомогою **save()**, але тепер нам ще знадобитися **where()**. Припустимо ми будемо редагувати останній запис у цій табличці: 
 <code php> <code php>
 $idToModify=$object->getLastId(); $idToModify=$object->getLastId();
-$object->data('text', 'воу, это же новое значение для text!');+$object->data('text', 'ого, це ж нове значення для text!');
 $object->where('id', '=', $idToModify); $object->where('id', '=', $idToModify);
 $object->save(); $object->save();
Рядок 194: Рядок 203:
  
  
-===== Включение режима отладки ===== +===== Увімкнення режиму відлагодження ===== 
-Мы знаем. Вы привыкли использовать для отладки ваших модулей всякие print_r/debarr. Все, отвыкаем. Теперь можно легко и непринужденно включить режим отладки или глубокой отладки и получить нормальный лог и вывод всего происходящего с моделью.+ 
 +Ми знаємо. Ви звикли використовувати для налагодження ваших модулів усілякі print_r/debarr. Усе, відвикаємо. Тепер можна легко і невимушено увімкнути режим налагодження або глибокого налагодження і отримати нормальний лог і виведення всього, що відбувається з моделлю.
  
 <code php> <code php>
Рядок 201: Рядок 211:
 </code> </code>
  
-Все, теперь все запросы к БД будут выводиться прямо в ваш умолчательный вью, а также записываться вместе с временем в лог, который вы сможете смотреть реалтайм методом+Усе, тепер усі запити до БД виводитимуться прямо у ваш стандартний в'ю, а також записуватимуться разом із часом у дебаг-лог, який ви зможете дивитися реалтайм методом
  
 <code bash> <code bash>
Рядок 207: Рядок 217:
 </code> </code>
  
-Также вам может захотеться врубить режим глубокой отладки. Тогда в этот же лог, будет дампиться также состояние всей модели целиком на каждый чих. Делается это так:+Також вам може захотітися врубити режим глибокого відлагодження. Тоді в цей же лог, буде дампитися також стан всієї моделі цілком на кожен пчих. Робиться це так:
 <code php> <code php>
 $model->setDebug(true,true); $model->setDebug(true,true);
 </code> </code>
  
-===== О исключениях ===== +===== Про виключення =====
-Если вы совсем обнаглеете от вседозволенности NyanORM вам в лицо могут быть выброшены следующие исключения: +
-  * **MEOW_WHERE_STRUCT_EMPTY** - кумулятивная структура where пуста. А она нужна. Очень. +
-  * **MEOW_DATA_STRUCT_EMPTY** - кумулятивная структура data пуста. И она тоже кому-то очень нужна. +
-  * **MEOW_JOIN_WRONG_TYPE** - неверный тип JOIN. Допустимы только INNER, LEFT, RIGHT. +
-  * **MEOW_NO_FIELD_NAME** - не установлено обязательное имя поля.+
  
-===== Принципиальная схема ===== +Якщо ви зовсім знахабнієте від вседозволеності NyanORM вам в обличчя можуть бути викинуті такі винятки: 
-Это где-то вот настолько высокоуровневая штука.+ 
 +  * **MEOW_WHERE_STRUCT_EMPTY** - кумулятивна структура where порожня. А вона потрібна. Дуже. 
 +  * **MEOW_DATA_STRUCT_EMPTY** - кумулятивна структура data порожня. І вона теж комусь дуже потрібна. 
 +  * **MEOW_JOIN_WRONG_TYPE** - неправильний тип JOIN. Допустимі тільки INNER, LEFT, RIGHT. 
 +  * **MEOW_NO_FIELD_NAME** - не встановлено обов'язкове ім'я поля. 
 + 
 +===== Принципова схема ===== 
 + 
 +Це десь ось настільки високорівнева штука.
  
 {{:nyanorm_scheme0.png?|}} {{:nyanorm_scheme0.png?|}}
  
-Так что да, в модулях где скорость работы с данными может быть узким местом, возможно придется использовать более традиционный подход с использованием api.mysql. 
  
-===== Что еще? ===== +Тож так, у модулях, де швидкість роботи з даними може бути вузьким місцем, можливо, доведеться використовувати більш традиційний підхід із використанням api.mysql. 
-Короче вот пока что вам практические примеры использования этого в виде хеллоуворлда. Но так как я хеллоуворлды писать не умею, вот вам тудушка. Как говорят умные люди - не умеешь писать хеллоуворлды - пиши тудушки.+===== Що ще? ===== 
 + 
 +Коротше ось поки що вам практичні приклади використання цього у вигляді хеллоуворлда. Але оскільки я хеллоуворлди писати не вмію, ось вам тудушка. Як кажуть розумні люди - не вмієш писати хеллоуворлди - пиши тудушки. 
 + 
 + 
 +Працювати наш TODO-list буде на наступній табличці в БД:
  
-Работать наш TODO-list будет на следующей табличке в БД: 
 <code sql> <code sql>
 CREATE TABLE IF NOT EXISTS `todo` ( CREATE TABLE IF NOT EXISTS `todo` (
Рядок 238: Рядок 254:
 </code> </code>
  
-А вот и весь код нашего модуля:+А ось і весь код нашого модуля:
 <code php> <code php>
  
-$todo = new nya_todo(); // Создаем модель данных при помощи магии.  +$todo = new nya_todo(); //Створюємо модель даних за допомогою магії.  
-                       //Собственно todo после префикса nya_ это и есть наша табличка.+                       //Власне todo після префікса nya_ це і є наша табличка.
  
-$moduleBaseUrl = '?module=testing'; //базовый URL нашего модуля +$moduleBaseUrl = '?module=testing'; //базовий URL нашого модулю 
-$messages = new UbillingMessageHelper(); //хотим штатные красивые уведомления+$messages = new UbillingMessageHelper(); //хочемо штатні красиві повідомлення
 $result = ''; $result = '';
  
-//Рендерим формочку создания используя инлайновую сборку при помощи Astral.+//Рендеримо формочку створення, використовуючи інлайнову збірку за допомогою [[apiastral|Astral]].
 $inputs = wf_TextInput('newtasktext', __('Task'), '', false, 40); $inputs = wf_TextInput('newtasktext', __('Task'), '', false, 40);
 $inputs .= wf_Submit(__('Create')); $inputs .= wf_Submit(__('Create'));
Рядок 254: Рядок 270:
 show_window(__('Create new task'), $creationForm); show_window(__('Create new task'), $creationForm);
  
-//Ловим непустой newtasktext как сигнал для создания новой записи+//Ловимо непорожній newtasktext як сигнал для створення нового запису
 if (ubRouting::checkPost(array('newtasktext'))) { if (ubRouting::checkPost(array('newtasktext'))) {
-    //заполняем новыми данными структуру data предварительно отфильтровав их средствами ubRouting+    //заповнюємо новими даними структуру data, попередньо відфільтрувавши їх засобами ubRouting
     $todo->data('text', ubRouting::post('newtasktext', 'mres'));     $todo->data('text', ubRouting::post('newtasktext', 'mres'));
-    $todo->create(); //говорим модели что "создайся запись" на основании структуры выше. +    $todo->create(); //кажемо моделі що "створи запис" на підставі структури вище. 
-    ubRouting::nav($moduleBaseUrl); //возвращаемся в морду модуля+    ubRouting::nav($moduleBaseUrl); //повертаємось у морду модуля
 } }
  
-//Ловим запрос на удаление тудушки, на сей раз GET-ом.+//Ловимо запит на видалення тудушки, цього разу GET-ом.
 if (ubRouting::checkGet('deletetodo')) { if (ubRouting::checkGet('deletetodo')) {
-    //выставляем параметр where в удаляемую id, предварительно убедившись, что это будет циферка+    //виставляємо параметр where у id, котра видаляється, попередньо переконавшись, що це буде циферка
     $todo->where('id', '=', ubRouting::get('deletetodo', 'int'));     $todo->where('id', '=', ubRouting::get('deletetodo', 'int'));
-    $todo->delete(); // говорим модели "удались"+    $todo->delete(); //кажемо моделі "вдалися"
     ubRouting::nav($moduleBaseUrl);     ubRouting::nav($moduleBaseUrl);
 } }
  
-//Ловим запрос на изменение существующей записи. Для сигнализации о начале ждем не пустой текст и айдишку.+//Ловимо запит на зміну наявного запису. Для сигналізації про початок чекаємо не порожній текст і айдишку.
 if (ubRouting::checkPost(array('edittodoid', 'edittodotext'))) { if (ubRouting::checkPost(array('edittodoid', 'edittodotext'))) {
-    //Дальше ведь все очевидно, правда? Выставляем где, выставляем чего поменять, фильтруем, говорим "сохранись".+    //Далі ж усе очевидно, правда? Виставляємо де, виставляємо, що поміняти, фільтруємо, говоримо "збережися".
     $todo->where('id', '=', ubRouting::post('edittodoid', 'int'));     $todo->where('id', '=', ubRouting::post('edittodoid', 'int'));
     $todo->data('text', ubRouting::post('edittodotext', 'mres'));     $todo->data('text', ubRouting::post('edittodotext', 'mres'));
Рядок 279: Рядок 295:
 } }
  
-//Показываем существующие задачи которые нам нужно сделать. +//Показуємо наявні завдання, які нам потрібно зробити. 
-$todo->orderBy('id', 'DESC'); //хотим сортировку от свежим к древним +$todo->orderBy('id', 'DESC'); //хочемо сортування від свіжих до древніх 
-$allTodos = $todo->getAll(); //достаем вообще все что видим из модели.+$allTodos = $todo->getAll(); //дістаємо взагалі все, що бачимо з моделі.
  
 if (!empty($allTodos)) { if (!empty($allTodos)) {
Рядок 290: Рядок 306:
         $cells = wf_TableCell($each['text']);         $cells = wf_TableCell($each['text']);
         $actControls = wf_JSAlert($moduleBaseUrl . '&deletetodo=' . $each['id'], web_delete_icon(), $messages->getDeleteAlert());         $actControls = wf_JSAlert($moduleBaseUrl . '&deletetodo=' . $each['id'], web_delete_icon(), $messages->getDeleteAlert());
-        //Прямо тут, собираем формочку редактирования каждой задачи и пихаем ее в контролы.+        //Прямо тут, збираємо формочку редагування кожного завдання і пихаємо її в контроли.
         $editInputs = wf_HiddenInput('edittodoid', $each['id']);         $editInputs = wf_HiddenInput('edittodoid', $each['id']);
         $editInputs .= wf_TextInput('edittodotext', __('Text'), $each['text'], false, 40);         $editInputs .= wf_TextInput('edittodotext', __('Text'), $each['text'], false, 40);
Рядок 296: Рядок 312:
         $editForm = wf_Form('', 'POST', $editInputs, 'glamour');         $editForm = wf_Form('', 'POST', $editInputs, 'glamour');
         $actControls .= wf_modalAuto(web_edit_icon(), __('Edit'), $editForm);         $actControls .= wf_modalAuto(web_edit_icon(), __('Edit'), $editForm);
-        //Фу так делать.+        //Фу так робити.
         $cells .= wf_TableCell($actControls);         $cells .= wf_TableCell($actControls);
         $rows .= wf_TableRow($cells, 'row5');         $rows .= wf_TableRow($cells, 'row5');
nyanorm.1686910405.txt.gz · Востаннє змінено: 2023/06/16 13:13 повз nightfly

Налаштування сторінки

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki