.persyaratan (
bantalan: 0 30 piksel 0 50 piksel;
warna: #999;
tinggi maksimal: 0;
transisi: 0,28 detik;
meluap: tersembunyi;
warna: merah;
gaya font: miring;

Laravel hadir dengan sederhana, sistem yang nyaman validasi (memeriksa data input untuk kepatuhan terhadap aturan) dan menerima pesan kesalahan - dengan kelas Validasi.

Contoh validasi paling sederhana

$validator = Validator::make(array("nama" => "Dale"), array("nama" => "wajib|min:5"));

Parameter pertama yang diteruskan ke metode make adalah data yang akan diuji. Parameter kedua adalah aturan yang harus diterapkan pada mereka.

Menggunakan Array untuk Menentukan Aturan

Beberapa aturan dapat dipisahkan dengan garis lurus (|) atau menjadi elemen terpisah susunan.

$validator = Validator::make(array("nama" => "Dale"), array("nama" => array("wajib", "min:5")));

Memvalidasi beberapa bidang

$validator = Validator::make(array("name" => "Dale", "password" => "badpassword", "email" => " [dilindungi email]"), array("nama" => "wajib", "kata sandi" => "wajib|min:8", "email" => "wajib|email|unik"));

Setelah instance Validator dibuat, metode gagal (atau lolos) dapat digunakan untuk melakukan validasi.

If ($validator->fails()) ( // Data yang dikirimkan gagal verifikasi)

Jika Validator menemukan kesalahan, Anda bisa mendapatkan pesannya seperti ini:

$pesan = $validator->pesan();

Anda juga bisa mendapatkan serangkaian aturan, data yang gagal verifikasi, tanpa pesan itu sendiri:

$gagal = $validator->gagal();

Memeriksa file

Kelas Validator berisi beberapa aturan awal untuk memvalidasi file, seperti size, mime dan lain-lain. Untuk melakukan pemeriksaan pada file, cukup transfer file beserta data lainnya.

Kaitkan setelah validasi

Setelah validasi selesai, Laravel dapat menjalankan fungsi penutupannya, di mana Anda dapat, misalnya, memeriksa sesuatu yang istimewa atau menambahkan semacam pesan kesalahan. Metode after() digunakan untuk ini:

$validator = Validator::membuat(...); $validator->after(function($validator) ( if ($this->somethingElseIsInvalid()) ( $validator->errors()->add("field", "Ada yang salah dengan field ini!"); ) )); jika ($validator->gagal()) ( // )

Anda dapat menambahkan beberapa setelahnya jika diperlukan.

Validasi di pengontrol

Menulis kode lengkap validasi setiap kali Anda perlu memvalidasi data tidak nyaman. Oleh karena itu, Laravel memberikan beberapa solusi untuk menyederhanakan prosedur ini.

Pengontrol dasar App\Http\Controllers\Controller menyertakan sifat ValidatesRequests, yang sudah berisi metode untuk validasi:

/** * Simpan postingan blog.

* * @param Permintaan $request * @return Response */ penyimpanan fungsi publik(Permintaan $request) ( $this->validate($request, [ "title" => "wajib|unik|maks:255", "body" => "wajib", ]); // ) Jika validasi berhasil, kode akan terus dieksekusi. Jika tidak, Illuminate\Contracts\Validation\ValidationException akan dilempar. Jika Anda tidak menangkap pengecualian ini, kerangka kerja akan menangkapnya, mengisi variabel Flash dengan pesan kesalahan validasi dan mengarahkan pengguna ke halaman sebelumnya

dengan bentuk - dirimu sendiri!

Dalam kasus permintaan AJAX, pengalihan tidak terjadi; kerangka kerja mengembalikan respons dengan kode HTTP 422 dan JSON dengan kesalahan validasi.

Kode di atas mirip dengan ini:

/** * Simpan postingan blog.

* * @param Permintaan $request * @return Response */ penyimpanan fungsi publik(Permintaan $request) ( $v = Validator::make($request->all(), [ "title" => "wajib|diperlukan|unik|maks :255", "body" => "wajib", ]); if ($v->fails()) ( return redirect()->back()->withErrors($v->errors()); ) // )

/** * (@inheritdoc) */ fungsi yang dilindungi formatValidationErrors(\Illuminate\Validation\Validator $validator) ( return $validator->errors()->all(); )

Validasi Kueri

Untuk menerapkan skenario validasi yang lebih kompleks, Anda mungkin merasa nyaman menggunakan apa yang disebut Permintaan Formulir. Ini adalah kelas permintaan HTTP khusus yang berisi logika validasi. Mereka memproses permintaan sebelum mencapai pengontrol.

Untuk membuat kelas permintaan, gunakan perintah make:request artisan:

Pembuat php: permintaan StoreBlogPostRequest

Kelas akan dibuat di folder app/Http/Requests. Tambahkan aturan validasi yang diperlukan ke metode aturannya:

/** * Dapatkan aturan validasi yang berlaku pada permintaan.

* * @return array */ aturan fungsi publik() ( return [ "title" => "wajib|unik|maks:255", "body" => "wajib", ]; )

Agar kerangka kerja dapat mencegat permintaan sebelum pengontrol, tambahkan kelas ini ke argumen metode pengontrol yang diperlukan:

Dengan penggunaan validasi kueri yang tepat, Anda dapat yakin bahwa pengontrol Anda selalu hanya berisi data masukan yang divalidasi!

Jika validasi gagal, kerangka kerja mengisi variabel flash dengan kesalahan validasi dan mengembalikan pengalihan ke halaman sebelumnya. Dalam kasus permintaan AJAX, respons dengan kode 422 dan JSON dengan kesalahan validasi dikembalikan.

Kontrol Akses

Kelas Permintaan Formulir juga berisi metode otorisasi. Dalam metode ini, Anda dapat memeriksa apakah pengguna diizinkan melakukan tindakan ini, memperbarui sumber daya tertentu. Misalnya, jika pengguna mencoba mengedit komentar pada postingan, apakah mereka penulisnya?

/** * Tentukan apakah pengguna berwenang untuk membuat permintaan ini. * * @return bool */ fungsi publik authorize() ( $commentId = $this->route("comment"); return Comment::where("id", $commentId) ->where("user_id", Auth: :id())->ada(); Perhatikan pemanggilan metode rute() di atas. Metode ini memberi Anda akses ke parameter di URL (dalam

dalam hal ini

ini (komentar)), didefinisikan dalam rute:

Rute::post("komentar/(komentar)");

Jika metode otorisasi mengembalikan false, kerangka kerja menghasilkan respons dengan kode HTTP 403 dan segera mengirimkannya. Metode pengontrol tidak dijalankan.

Jika Anda ingin menyesuaikan pesan kesalahan validasi yang disimpan dalam variabel flash sesi selama pengalihan, ganti metode formatValidationErrors di kelas permintaan dasar (App\Http\Requests\Request):

/** * (@inheritdoc) */ fungsi yang dilindungi formatValidationErrors(\Illuminate\Validation\Validator $validator) ( return $validator->errors()->all(); )

Bekerja dengan Pesan Kesalahan

Setelah memanggil metode messages dari objek Validator, Anda akan menerima objek MessageBag yang memiliki satu set metode yang berguna untuk mengakses pesan kesalahan.

Menerima pesan pertama untuk suatu bidang

echo $pesan->pertama("email");

Mengambil semua pesan untuk satu bidang

foreach ($pesan->dapatkan("email") sebagai $pesan) ( // )

Mengambil semua pesan untuk semua bidang

foreach ($pesan->semua() sebagai $pesan) ( // )

Memeriksa pesan untuk suatu bidang

if ($pesan->memiliki("email")) ( // )

Menerima kesalahan dalam format tertentu

echo $pesan->pertama("email", "");

Catatan: Secara default, pesan diformat dengan cara yang sesuai untuk Twitter Bootstrap.

Terima semua pesan dalam format tertentu

foreach ($pesan->semua("

:pesan

") sebagai $pesan) ( // )

Bug dan pola

Setelah Anda menyelesaikan validasi, Anda memerlukan cara sederhana untuk meneruskan kesalahan ke template. Laravel membuat ini mudah dilakukan. Misalnya, kami memiliki rute berikut:

Rute::dapatkan("daftar", fungsi() ( return View::make("user.register"); )); Route::post("register", function() ( $rules = array(...); $validator = Validator::make(Input::all(), $rules); if ($validator->fails( )) ( return redirect("daftar")->withErrors($validator); ) ));

Perhatikan bahwa ketika pemeriksaan gagal, kita meneruskan objek Validator ke objek Redirect menggunakan metode withErrors. Metode ini akan menyimpan pesan kesalahan dalam variabel flash sesi satu kali, sehingga membuatnya tersedia untuk permintaan berikutnya.

Namun, perhatikan bahwa kami tidak meneruskan View::make("user.register"); variabel $errors ke templat. Laravel sendiri memeriksa data sesi untuk mengetahui keberadaan variabel dan secara otomatis meneruskannya ke template jika tersedia. Oleh karena itu, penting untuk diingat bahwa variabel $errors akan tersedia untuk semua template Anda setiap saat, berdasarkan permintaan apa pun. . Hal ini memungkinkan Anda berasumsi bahwa variabel $errors selalu ditentukan dan dapat digunakan dengan aman. Variabel $errors adalah turunan dari kelas MessageBag.

Jadi, setelah pengalihan, Anda dapat menggunakan variabel $errors yang diatur secara otomatis di template:

pertama("email"); ?>

Bernama Tas Pesan

Jika Anda memiliki beberapa formulir di halaman, maka Anda dapat memilih nama objek MessageBag di mana teks kesalahan akan dikembalikan sehingga Anda dapat menampilkannya dengan benar untuk formulir yang diinginkan.

Return redirect("daftar")->withErrors($validator, "login");

Dapatkan teks kesalahan dari MessageBag dengan nama login:

login->pertama("email"); ?>

Aturan Validasi

Di bawah ini adalah daftar semua aturan yang tersedia dan fungsinya:

diterima

Bidang tersebut harus bernilai Ya, pada atau 1 . Hal ini berguna untuk memeriksa penerimaan peraturan dan izin.

url_aktif

Bidang tersebut harus berupa URL yang valid, dapat diakses melalui fungsi checkdnsrr.

setelah: tanggal

Kolom harus diberi tanggal paling lambat tanggal

alfa

Bidang hanya boleh berisi karakter alfabet.

alpha_dash

Bidang hanya boleh berisi karakter alfabet, angka, garis bawah (_), dan tanda hubung (-).

angka_alfa

Bidang hanya boleh berisi karakter alfabet dan angka.

susunan

Bidangnya harus berupa array.

sebelum: tanggal

Bidang tersebut harus berisi tanggal yang lebih awal dari tanggal. String dikonversi menjadi tanggal menggunakan fungsi strtotime.

di antara: menit,maks

Bidang harus memiliki ukuran mulai dari menit ke maks. String, angka, dan file diperlakukan serupa dengan aturan ukuran.

boolean

Bidangnya harus Boolean. Nilai yang diperbolehkan adalah true , false , 1 , 0 , "1" dan "0" .

dikonfirmasi

Nilai bidang harus sesuai dengan nilai bidang dengan nama tersebut, ditambah foo_confirmation . Misalnya, jika kolom kata sandi dicentang, maka kolom konfirmasi_kata sandi yang cocok dengan nilainya harus diteruskan ke input.

tanggal

Lapangannya harus tanggal yang benar sesuai dengan fungsi strtotime.

format_tanggal: format

Bidang harus sesuai dengan format tanggal format sesuai dengan fungsi date_parse_from_format.

berbeda: bidang

Nilai field yang diperiksa harus berbeda dengan nilai field bidang.

e-mail

Bidang tersebut harus berupa alamat email yang valid.

ada: meja,kolom

Bidang tersebut harus ada di meja yang diberikan basis data.

Mudah digunakan:

"negara bagian" => "ada:negara bagian"

Menentukan nama field dalam tabel:

"state" => "ada:states,singkatan"

Anda juga dapat menentukan kondisi lainnya untuk ditambahkan ke kueri "WHERE":

"email" => "ada:staf,email,account_id,1"

gambar

File yang diupload harus berupa gambar format jpeg, png, bmp, gif atau svg.

di dalam: foo,batang,...

Nilai bidang harus berupa salah satu dari berikut ini ( foo, batang dll.).

bilangan bulat

Bidang harus memiliki nilai bilangan bulat yang valid.

aku p

Bidang tersebut harus berupa alamat IP yang valid.

maks: nilai

Nilai bidang harus kurang dari atau sama dengan nilai

pantomim: foo,batang,...

Jenis MIME dari file yang diunggah harus salah satu yang terdaftar.

Mudah digunakan:

"foto" => "pantomim:jpeg,bmp,png"

menit: nilai

Nilai bidang harus lebih dari nilai. String, angka, dan file diperlakukan serupa dengan aturan tersebut.

tidak masuk: foo,batang,...

Nilai bidang Bukan harus salah satu dari berikut ini ( foo, batang dll.).

numerik

Bidang harus memiliki nilai numerik atau pecahan yang valid.

ekspresi reguler: pola

Bidang harus cocok dengan ekspresi reguler yang diberikan.

Perhatian: Saat menggunakan aturan ini, Anda mungkin perlu mencantumkan aturan lain sebagai elemen array, terutama jika ekspresi berisi karakter pipa (|).

diperlukan

Bidang yang diuji harus ada dan memiliki nilai yang tidak kosong.

diperlukan_jika: bidang,nilai,...

Bidang yang diuji harus ada dan mempunyai nilai yang tidak kosong jika bidang lainnya bidang hadir dan memiliki arti apa pun nilai.

diperlukan_dengan: foo,batang,...

Setidaknya salah satu bidang yang tercantum ada dan memiliki nilai yang tidak kosong ( foo, batang dll.).

diperlukan_dengan_semua: foo,batang,...

Bidang yang diuji harus ada dan mempunyai nilai yang tidak kosong, tetapi hanya jika semua bidang yang terdaftar ada dan mempunyai nilai yang tidak kosong ( foo, batang dll.).

diperlukan_tanpa: foo,batang,...

Bidang yang diuji harus ada dan mempunyai nilai yang tidak kosong, tetapi hanya jika Bukan setidaknya salah satu bidang yang tercantum ada atau memiliki nilai kosong ( foo, batang dll.).

wajib_tanpa_semua: foo,batang,...

Bidang yang diuji harus ada dan mempunyai nilai yang tidak kosong, tetapi hanya jika Bukan hadir atau punya nilai kosong semua bidang yang terdaftar ( foo, batang dll.).

sama: bidang

Bidang tersebut harus memiliki nilai yang sama dengan bidang tersebut bidang.

ukuran: nilai

Bidangnya harus cocok nilai ukuran. Untuk string itu menunjukkan panjangnya, untuk angka- nomor, untuk file- ukuran dalam kilobyte.

zona waktu

Bidang tersebut harus berisi pengidentifikasi zona waktu, salah satu yang tercantum dalam fungsi php timezone_identifiers_list

unik: meja,kolom,kecuali,kolom id

Nilai bidang harus unik dalam tabel database yang diberikan. Jika kolom tidak ditentukan, nama field akan digunakan.

Mudah digunakan

"email" => "unik:pengguna"

Menentukan nama field dalam tabel

"email" => "unik:pengguna,alamat_email"

Abaikan ID tertentu

"email" => "unik:pengguna,alamat_email,10"

Menambahkan Ketentuan Tambahan

Anda juga dapat menentukan kondisi lainnya untuk ditambahkan ke kueri "WHERE":

"email" => "unik:pengguna,alamat_email,NULL,id,id_akun,1"

Pada aturan di atas, hanya baris dengan account_id sama dengan 1 yang akan dimasukkan dalam cek.

url

Bidang tersebut harus berupa URL yang valid.

Catatan: Fungsi PHP filter_var digunakan

Aturan bersyarat

Terkadang Anda perlu memvalidasi bidang tertentu hanya ketika itu ada dalam data input. Untuk melakukan ini, tambahkan aturan kadang-kadang:

$v = Validator::make($data, array("email" => "terkadang|diperlukan|email",));

Pada contoh di atas, kolom email hanya akan memicu validasi ketika $data["email"] ada.

Aturan bersyarat yang kompleks

Terkadang Anda hanya ingin sebuah bidang memiliki nilai jika bidang lain memiliki nilai, katakanlah, lebih besar dari 100. Atau Anda mungkin hanya memerlukan dua bidang untuk memiliki nilai ketika bidang ketiga juga ditentukan. Hal ini mudah dicapai dengan aturan bersyarat. Pertama buat objek Validator dengan seperangkat aturan statis yang tidak pernah berubah:

$v = Validator::make($data, array("email" => "wajib|email", "permainan" => "wajib|numerik",));

Sekarang katakanlah aplikasi Anda ditulis untuk kolektor game. Jika seorang kolektor yang memiliki lebih dari 100 game mendaftar, kami ingin bertanya kepada mereka mengapa mereka membutuhkan game sebanyak itu. Misalnya, mereka mungkin memiliki toko atau mungkin hanya ingin mengoleksinya. Jadi, untuk menambahkan aturan kondisional seperti itu, kami menggunakan metode Validator.

$v->kadang-kadang("alasan", "diperlukan|maks:500", function($input) ( return $input->games >= 100; ));

Parameter pertama dari metode ini adalah nama field yang kita periksa. Parameter kedua adalah aturan yang ingin kita tambahkan jika fungsi penutupan yang diteruskan (parameter ketiga) mengembalikan true . Metode ini memungkinkan Anda dengan mudah membuat aturan validasi masukan yang kompleks. Anda bahkan dapat menambahkan aturan bersyarat yang sama ke beberapa bidang secara bersamaan:

$v->kadang-kadang(array("alasan", "biaya"), "wajib", function($input) ( return $input->games >= 100; ));

Catatan: Parameter $input yang diteruskan ke penutupan adalah objek Illuminate\Support\Fluent dan dapat digunakan untuk membaca input dan file yang sedang diperiksa.

Pesan kesalahan sendiri

Anda dapat meneruskan pesan kesalahan Anda sendiri, bukan pesan default. Ada beberapa cara untuk melakukan ini.

Mengirimkan pesan Anda ke Validator

$messages = array("wajib" => "Kolom:atribut harus diisi.",); $validator = Validator::make($input, $rules, $messages);

Catatan: string:attribute akan diganti dengan nama field yang diperiksa. Anda juga dapat menggunakan string variabel lain.

Menggunakan Variabel String Lainnya

$messages = array("same" => "Nilai:attribute dan:other harus cocok.", "size" => "Field:attribute harus sama persis:size.", "between" => " Nilai:attribute harus dari:min hingga:max.", "in" => "Kolom:attribute harus memiliki salah satu nilai berikut: :values",);

Menentukan pesan Anda sendiri untuk bidang tertentu

Terkadang Anda mungkin perlu menentukan pesan Anda untuk bidang terpisah.

$messages = array("email.required" => "Kami perlu mengetahui alamat email Anda!",);

Menentukan pesan Anda sendiri di file pelokalan

Dimungkinkan juga untuk menentukan pesan validasi dalam file pelokalan alih-alih meneruskannya ke Validator secara langsung. Untuk melakukan ini, tambahkan pesan ke array khusus file pelokalan app/lang/xx/validation.php.

"custom" => array("email" => array("wajib" => "Kami perlu mengetahui alamat email Anda!",),),

Aturan verifikasi sendiri

Mendaftarkan aturan validasi Anda sendiri

Laravel secara asli berisi banyak aturan yang berguna, namun Anda mungkin perlu membuatnya sendiri. Salah satu cara untuk mendaftarkan aturan kustom adalah melalui metode Validator::extend.

Validator::extend("foo", function($attribute, $value, $parameters) ( return $value == "foo"; }); !}

Catatan: Nama aturan harus dalam format_with_underscores.

Fungsi penutupan yang diteruskan menerima tiga parameter: nama bidang yang sedang diperiksa $attribute , nilai bidang $value dan array parameter $parameters yang diteruskan ke aturan.

Alih-alih fungsi, Anda bisa meneruskan referensi ke metode kelas ke metode perluasan:

Validator::extend("foo", "FooValidator@validate");

Perhatikan bahwa Anda juga perlu menentukan pesan kesalahan untuk aturan baru. Anda dapat melakukan ini dengan meneruskannya sebagai array string ke Validator, atau dengan menulisnya ke dalam file pelokalan.

Memperluas kelas Validator

Daripada menggunakan fungsi penutupan untuk memperluas kumpulan aturan yang tersedia, Anda dapat memperluas kelas Validator itu sendiri. Untuk melakukannya, buat kelas yang mewarisi Illuminate\Validation\Validator . Anda dapat menambahkan metode validasi baru dengan mengawali namanya dengan validasi .

Mendaftarkan kelas Validator baru

Maka Anda perlu mendaftarkan ekstensi validasi ini. Hal ini dapat dilakukan, misalnya, di penyedia layanan Anda atau di file awal Anda.

Validator::resolver(function($translator, $data, $rules, $messages) ( return new CustomValidator($translator, $data, $rules, $messages); ));

Terkadang, saat membuat kelas validasi Anda sendiri, Anda mungkin perlu mendefinisikan variabel string Anda sendiri (seperti ":foo") untuk menggantikan pesan kesalahan. Hal ini dilakukan dengan membuat kelas seperti dijelaskan di atas dan menambahkan fungsi dengan nama seperti replaceXXX .

Fungsi yang dilindungi replaceFoo($message, $attribute, $rule, $parameters) ( return str_replace(":foo", $parameters, $message); )

Jika Anda ingin menambahkan pesan Anda tanpa menggunakan Validator::extend , Anda dapat menggunakan metode Validator::replacer:

Validator::replacer("aturan", function($pesan, $atribut, $aturan, $parameter) ( // ));