Робота з формами ================ В даному розділі буде описано як створити нову сторінку з формою для отримання даних від користувачів. На сторінці буде розміщена форма з полями, де можна буде вказати ім’я та адресу електронної пошти. Після отримання цих двох фрагментів інформації від користувача, сторінка відобразить введені значення знову для підтвердження. Для досягнення даної цілі, крім створення [дії](structure-controllers.md) і двох [представлень](structure-views.md), ви також створите [модель](structure-models.md). В даному керівництві ви дізнаєтесь як: * створити [модель](structure-models.md) для даних, введених користувачем через форму; * оголосити правила перевірки введених даних; * створити HTML-форму в [представленні](structure-views.md). Створення моделі ---------------- Дані, отримувані від користувача, будуть представлятись моделлю класу `EntryForm` як показано нижче, який зберігатиметься у файлі `models/EntryForm.php`. Детальніше про присвоєння імен файлам класів читайте в розділі [Автозавантаження класів](concept-autoloading.md). ```php Інформація: Клас [[yii\base\Model]] використовується як батьківський клас для класів моделей, які *не* асоційовані з таблицями бази даних. Клас [[yii\db\ActiveRecord]] зазвичай є батьківським для класів моделей, що відповідають таблицям бази даних. Клас `EntryForm` містить дві публічні властивості `name` та `email`, які використовуються для зберігання даних, вказаних користувачем. Він також містить метод `rules()`, який повертає набір правил перевірки даних. Правила перевірки, оголошені у вищезазначеному коді означають наступне: * поля `name` і `email` обов’язкові для заповнення; * поле `email` повинно містити правильну адресу електронної пошти. Якщо об’єкт `EntryForm` заповнений даними користувача, то для їх перевірки ви можете викликати метод цього об’єкту [[yii\base\Model::validate()|validate()]]. У випадку невдалої перевірки властивість [[yii\base\Model::hasErrors|hasErrors]] дорівнюватиме `true`. За допомогою [[yii\base\Model::getErrors|errors]] можна дізнатись, які саме помилки перевірки виникли. ```php name = 'Qiang'; $model->email = 'bad'; if ($model->validate()) { // Все добре! } else { // Невдача! // Використовуйте $model->getErrors() } ``` Створення дії ------------- Далі необхідно створити дію `entry` в контролері `site`, яка буде використовувати нову модель. Процес створення та використання дій описано у розділі [Говоримо "Привіт"](start-hello.md). ```php load(Yii::$app->request->post()) && $model->validate()) { // дані в $model успішно перевірені // тут робимо щось корисне з $model ... return $this->render('entry-confirm', ['model' => $model]); } else { // або сторінка відображається вперше, або ж є помилка в даних return $this->render('entry', ['model' => $model]); } } } ``` Дія спочатку створює об’єкт `EntryForm`. Потім вона намагається заповнити модель даними із масиву `$_POST`, доступ до якого забезпечується в Yii за допомогою [[yii\web\Request::post()]]. Якщо модель успішно заповнена, тобто користувач відправив дані з HTML-форми, то для перевірки даних буде викликаний метод [[yii\base\Model::validate()|validate()]]. > Інформація: `Yii::$app` являє собою глобально доступний екземпляр-одинак [додатка](structure-applications.md) (singleton). Одночасно це є [Service Locator](concept-service-locator.md), який надає компоненти, типу `request`, `response`, `db` і так далі для доступу до специфічної функціональності. У вищезазначеному коді для доступу до даних з `$_POST` був використаний компонент екземпляру додатка `request`. Якщо все гаразд, дія зобразить представлення `entry-confirm`, яке покаже користувачу вказані ним дані. Якщо дані не передані або містять помилки, буде зображено представлення `entry` з HTML-формою та повідомленнями про присутні помилки перевірки даних. > Примітка: У цьому дуже простому прикладі ми просто відобразили сторінку підтвердження відправлення даних. На практиці, ви повинні розглянути використання [[yii\web\Controller::refresh()|refresh()]] або [[yii\web\Controller::redirect()|redirect()]] для уникнення [проблеми повторного відправлення даних форми](http://en.wikipedia.org/wiki/Post/Redirect/Get). Створення представлення ----------------------- На завершення, створюємо два файли представлення з іменами `entry-confirm` і `entry`, котрі зображаються дією `entry` з минулого підрозділу. Представлення `entry-confirm` просто зображає ім’я та адресу електронної пошти. Воно мусить бути збережене у файлі `views/site/entry-confirm.php`. ```php
Ви вказали наступну інформацію: