Yii - Validazione
Non dovresti mai fidarti dei dati ricevuti dagli utenti. Per convalidare un modello con gli input dell'utente, è necessario chiamareyii\base\Model::validate()metodo. Restituisce un valore booleano se la convalida ha esito positivo. Se sono presenti errori, è possibile ottenerli dal fileyii\base\Model::$errors proprietà.
Usare le regole
Per rendere il file validate() funziona, dovresti sovrascrivere il file yii\base\Model::rules() metodo.
Step 1 - Il rules() restituisce un array nel formato seguente.
[
// required, specifies which attributes should be validated
['attr1', 'attr2', ...],
// required, specifies the type a rule.
'type_of_rule',
// optional, defines in which scenario(s) this rule should be applied
'on' => ['scenario1', 'scenario2', ...],
// optional, defines additional configurations
'property' => 'value', ...
]
Per ogni regola, è necessario definire almeno a quali attributi si applica la regola e il tipo di regola applicata.
Le regole di convalida fondamentali sono: boolean, captcha, compare, date, default, double, each, email, exist, file, filter, image, ip, in, integer, match, number, required, safe, string, trim, unique, url.
Step 2 - Crea un nuovo modello in models cartella.
<?php
namespace app\models;
use Yii;
use yii\base\Model;
class RegistrationForm extends Model {
public $username;
public $password; public $email;
public $country; public $city;
public $phone;
public function rules() {
return [
// the username, password, email, country, city, and phone attributes are
//required
[['username' ,'password', 'email', 'country', 'city', 'phone'], 'required'],
// the email attribute should be a valid email address
['email', 'email'],
];
}
}
?>
Abbiamo dichiarato il modello per il modulo di registrazione. Il modello ha cinque proprietà: nome utente, password, e-mail, paese, città e telefono. Sono tutti obbligatori e la proprietà email deve essere un indirizzo email valido.
Step 3 - Aggiungi il file actionRegistration metodo al SiteController dove creiamo un nuovo RegistrationForm modello e passarlo a una vista.
public function actionRegistration() {
$model = new RegistrationForm();
return $this->render('registration', ['model' => $model]);
}
Step 4- Aggiungi una vista per il nostro modulo di registrazione. All'interno della cartella views / site, crea un file chiamato registration.php con il seguente codice.
<?php
use yii\bootstrap\ActiveForm;
use yii\bootstrap\Html;
?>
<div class = "row">
<div class = "col-lg-5">
<?php $form = ActiveForm::begin(['id' => 'registration-form']); ?> <?= $form->field($model, 'username') ?> <?= $form->field($model, 'password')->passwordInput() ?> <?= $form->field($model, 'email')->input('email') ?> <?= $form->field($model, 'country') ?> <?= $form->field($model, 'city') ?> <?= $form->field($model, 'phone') ?>
<div class = "form-group">
<?= Html::submitButton('Submit', ['class' => 'btn btn-primary',
'name' => 'registration-button']) ?>
</div>
<?php ActiveForm::end(); ?>
</div>
</div>
Stiamo usando il ActiveForm widget per la visualizzazione del nostro modulo di registrazione.
Step 5 - Se vai dall'host locale http://localhost:8080/index.php?r=site/registration e fai clic sul pulsante di invio, vedrai le regole di convalida in azione.
Step 6 - Per personalizzare il messaggio di errore per il username proprietà, modificare il file rules() metodo del RegistrationForm nel seguente modo.
public function rules() {
return [
// the username, password, email, country, city, and phone attributes are required
[['password', 'email', 'country', 'city', 'phone'], 'required'],
['username', 'required', 'message' => 'Username is required'],
// the email attribute should be a valid email address
['email', 'email'],
];
}
Step 7 - Vai all'host locale http://localhost:8080/index.php?r=site/registratione fare clic sul pulsante di invio. Noterai che il messaggio di errore della proprietà del nome utente è cambiato.
Step 8 - Per personalizzare il processo di convalida, è possibile ignorare questi metodi.
yii \ base \ Model :: beforeValidate (): attiva un file
yii \ base \ Model :: EVENT_BEFORE_VALIDATE evento.
yii \ base \ Model :: afterValidate (): attiva un file
yii \ base \ Model :: EVENT_AFTER_VALIDATE evento.
Step 9 - Per tagliare gli spazi intorno alla proprietà del paese e trasformare l'input vuoto della proprietà della città in un valore nullo, puoi usare il trim e default validatori.
public function rules() {
return [
// the username, password, email, country, city, and phone attributes are required
[['password', 'email', 'country', 'city', 'phone'], 'required'],
['username', 'required', 'message' => 'Username is required'],
['country', 'trim'], ['city', 'default'],
// the email attribute should be a valid email address
['email', 'email'],
];
}
Step 10 - Se un input è vuoto, è possibile impostarne un valore predefinito.
public function rules() {
return [
['city', 'default', 'value' => 'Paris'],
];
}
Se la proprietà della città è vuota, verrà utilizzato il valore predefinito "Parigi".