PHP Master | Menetapkan mesej ralat tersuai untuk zend_form_element

Dalam artikel ini saya akan menunjukkan penyelesaian kepada masalah biasa yang timbul apabila pemaju perlu membuat laman web atau aplikasi bukan bahasa Inggeris yang berdasarkan rangka kerja Zend. Bagaimana kita menandakan bidang zend_form yang manakah zend_form_element sebagai tidak sah, menunjukkan satu atau lebih mesej ralat tersuai? Masalahnya disebabkan terutamanya oleh kaedah kaunter-intuitif asli kelas Zend_Form_Element yang akan saya jelaskan dengan lebih terperinci. (Perhatikan masalah dan penyelesaian yang dibincangkan di sini adalah sah untuk Rangka Kerja Zend Versi 1.12 dan ke bawah.)

Kunci Takeaways

• Apabila membuat laman web atau aplikasi bukan bahasa Inggeris berdasarkan rangka kerja Zend, pemaju sering berjuang dengan menandakan bidang zend_form, yang merupakan zend_form_element, sebagai tidak sah dan memaparkan mesej ralat tersuai. Ini disebabkan terutamanya oleh kaedah kaunter-intuitif asli kelas Zend_Form_Element.
• Tingkah laku lalai Rangka Kerja Zend, yang dimiliki oleh syarikat Amerika Zend, adalah untuk memaparkan mesej ralat dalam bahasa Inggeris untuk setiap pengesahan yang dipecahkan oleh input pengguna. Pemaju boleh menterjemahkan setiap mesej ralat rangka kerja atau menerangkan dalam satu atau lebih mesej bahawa input tidak sah dan menunjukkan cadangan untuk memasukkan nilai yang diterima. Pilihan terakhir kurang rumit, terutamanya untuk projek kecil dan sederhana.
• Penyelesaian kepada masalah ini terletak pada penciptaan medan dalam bentuk (init () kaedah) dan penggunaan kaedah setRrormessages () bersempena dengan harta validator rangka kerja Zend yang dipanggil breakchainonfailure (). Harta ini membolehkan proses pengesahan berhenti pada keadaan gagal pertama. Pendekatan ini membolehkan borang hanya menunjukkan mesej tersuai apabila terdapat input tidak sah.

Membangunkan contoh

Katakan bahawa anda mempunyai borang dengan bidang yang berbeza dan mengambil kira salah satu daripada mereka, contohnya medan input teks yang digunakan untuk membiarkan pengguna memasukkan namanya. Validator yang boleh anda gunakan adalah berbeza, tetapi demi contoh kita akan mengehadkan panjang nama dan ia hanya akan membenarkan aksara dan ruang abjad. Bercakap bahasa Rangka Kerja Zend, kami akan menggunakan kelas Zend_Validate_stringlength dan kelas Zend_Validate_alpha. Seperti yang anda ketahui, Rangka Kerja Zend dimiliki oleh syarikat Amerika Zend dan oleh itu semua mesej yang ditunjukkannya dalam bahasa Inggeris. Tingkah laku lalai rangka kerja adalah untuk memaparkan satu atau lebih mesej ralat untuk setiap pengesahan yang dipecahkan oleh input pengguna. Oleh itu, bagi mereka yang membina laman web bukan bahasa Inggeris, terdapat dua pilihan untuk mempunyai mesej yang boleh dibaca oleh semua pengguna: menterjemahkan setiap mesej ralat rangka kerja, atau terangkan dalam satu atau lebih mesej yang input tidak sah dan menunjukkan cadangan untuk dimasukkan nilai yang diterima. Pilihan pertama adalah terlalu rumit, terutamanya untuk projek kecil dan sederhana, jadi saya akan menunjukkan cara menggunakan pilihan kedua. Untuk memastikan ia mudah, kami akan menetapkan satu mesej tersuai: "Input tidak sah. Nilai mesti hanya mempunyai aksara dan ruang abjad dan panjangnya mestilah antara 3 dan 50 aksara. "

kod

Saya akan menunjukkan kod yang akan kami gunakan semasa artikel. Pertama, ini adalah bentuk yang mengandungi medan input untuk nama dan pengesahan yang diperlukan untuk memeriksa data.

<span><span><?php
</span></span><span><span>class Application_Form_User extends Zend_Form
</span></span><span><span>{
</span></span><span>    <span>public function init() {
</span></span><span>        <span>// create the field
</span></span><span>        <span>$element = new Zend_Form_Element_Text("name");
</span></span><span>        <span>$element->setLabel("Name");
</span></span><span>
</span><span>        <span>// set the validators
</span></span><span>        <span>$element->setValidators(array(
</span></span><span>            <span>new Zend_Validate_Alpha(true),
</span></span><span>            <span>new Zend_Validate_StringLength(
</span></span><span>                <span>array("min" => 3, "max" => 50))
</span></span><span>        <span>));
</span></span><span>        <span>$element->setRequired();
</span></span><span>
</span><span>        <span>// add the element to the form
</span></span><span>        <span>$this->addElement($element);
</span></span><span>
</span><span>        <span>// add a submit button
</span></span><span>        <span>$element = new Zend_Form_Element_Submit("submit");
</span></span><span>        <span>$element->setLabel("Submit");
</span></span><span>        <span>$this->addElement($element);
</span></span><span>    <span>}
</span></span><span><span>}</span></span>

Dalam pengawal kami akan periksa sama ada medan itu sah dan bertindak dengan sewajarnya. Biasanya anda tidak akan menggunakan indexController dan mungkin anda mempunyai pengesahan ini dalam pengawal tertentu. Bagaimanapun, untuk memudahkan contoh, saya akan menggunakannya.

<span><span><?php
</span></span><span><span>class IndexController extends Zend_Controller_Action
</span></span><span><span>{
</span></span><span>    <span>public function init() {
</span></span><span>    <span>}
</span></span><span>
</span><span>    <span>public function indexAction() {
</span></span><span>        <span>$form = new Application_Form_User();
</span></span><span>
</span><span>        <span>if ($this->getRequest()->isPost() &&
</span></span><span>            <span>$form->isValid($this->getRequest()->getPost())) {
</span></span><span>            <span>$this->view->message = "Valid input";
</span></span><span>        <span>}
</span></span><span>        <span>else {
</span></span><span>            <span>$this->view->form = $form;
</span></span><span>        <span>}
</span></span><span>    <span>}
</span></span><span><span>}</span></span>

Pandangan yang digunakan agak mudah; Ia hanya menunjukkan mesej dan borang.

<span><span><?php
</span></span><span><span>if (isset($this->message)) {
</span></span><span>    <span>echo $this->message;
</span></span><span><span>}
</span></span><span><span>if (isset($this->form)) {
</span></span><span>    <span>echo $this->form;
</span></span><span><span>}</span></span>

Kod sumber di atas, tanpa sebarang peraturan CSS, akan menjadikannya:

Selain itu, jika anda memasukkan nilai tidak sah "88" dalam medan nama anda akan melihat mesej:

Menganalisis kaedah rangka kerja

Soalan yang baik untuk ditanya ialah jika sudah ada kaedah yang tersedia untuk menghadapi situasi seperti ini. Jawapannya ialah hampir . Maksud saya ada kaedah, tetapi mereka tidak selalu berfungsi seperti yang anda harapkan (sekurang -kurangnya seperti yang saya harapkan). Kaedah untuk menguruskan mesej ralat adalah:

• setErrors (array $ mesej)
• setRrormessages (array $ mesej)

Kaedah setErrors () hanya mempunyai satu parameter yang merupakan array dan menggunakan unsur -unsurnya sebagai mesej untuk ditunjukkan dalam kes input tidak sah. Contoh penggunaannya ialah:

<span><span><?php
</span></span><span><span>class Application_Form_User extends Zend_Form
</span></span><span><span>{
</span></span><span>    <span>public function init() {
</span></span><span>        <span>// create the field
</span></span><span>        <span>$element = new Zend_Form_Element_Text("name");
</span></span><span>        <span>$element->setLabel("Name");
</span></span><span>
</span><span>        <span>// set the validators
</span></span><span>        <span>$element->setValidators(array(
</span></span><span>            <span>new Zend_Validate_Alpha(true),
</span></span><span>            <span>new Zend_Validate_StringLength(
</span></span><span>                <span>array("min" => 3, "max" => 50))
</span></span><span>        <span>));
</span></span><span>        <span>$element->setRequired();
</span></span><span>
</span><span>        <span>// add the element to the form
</span></span><span>        <span>$this->addElement($element);
</span></span><span>
</span><span>        <span>// add a submit button
</span></span><span>        <span>$element = new Zend_Form_Element_Submit("submit");
</span></span><span>        <span>$element->setLabel("Submit");
</span></span><span>        <span>$this->addElement($element);
</span></span><span>    <span>}
</span></span><span><span>}</span></span>

Kaedah ini, serta memaparkan rentetan yang diberikan, juga menandakan medan sebagai tidak sah. Ia boleh digunakan pada dua kali dalam logik aplikasi, tetapi dalam kedua -dua ia mempunyai tingkah laku yang tidak berguna untuk matlamat kami. Yang pertama adalah semasa penciptaan elemen bentuk (init () kaedah). Dalam kes ini mesej ditunjukkan apabila borang telah dimuatkan dan sebelum pengguna telah memasukkan sebarang data. Agak tidak menyenangkan. Dalam kes ini, bahagian kod yang berkaitan berubah seperti ini:

<span><span><?php
</span></span><span><span>class IndexController extends Zend_Controller_Action
</span></span><span><span>{
</span></span><span>    <span>public function init() {
</span></span><span>    <span>}
</span></span><span>
</span><span>    <span>public function indexAction() {
</span></span><span>        <span>$form = new Application_Form_User();
</span></span><span>
</span><span>        <span>if ($this->getRequest()->isPost() &&
</span></span><span>            <span>$form->isValid($this->getRequest()->getPost())) {
</span></span><span>            <span>$this->view->message = "Valid input";
</span></span><span>        <span>}
</span></span><span>        <span>else {
</span></span><span>            <span>$this->view->form = $form;
</span></span><span>        <span>}
</span></span><span>    <span>}
</span></span><span><span>}</span></span>

Kali kedua berlaku selepas maklumat telah dihantar semasa pengesahan data biasa dalam pengawal. Apa yang berlaku ialah mesej tersuai dilampirkan kepada yang lalai apabila ralat berlaku. Dalam kes ini, indexAction () perubahan indexController dengan cara ini:

<span><span><?php
</span></span><span><span>if (isset($this->message)) {
</span></span><span>    <span>echo $this->message;
</span></span><span><span>}
</span></span><span><span>if (isset($this->form)) {
</span></span><span>    <span>echo $this->form;
</span></span><span><span>}</span></span>

Sama seperti setArrors (), kaedah setArrormessages () mengambil sebagai parameter pelbagai rentetan yang akan ditunjukkan kepada pengguna dalam hal input tidak sah. Contoh penggunaannya ialah:

<span><span><?php
</span></span><span><span>// set the custom message in the case of an error
</span></span><span><span>$element->setErrors(array("The input is invalid. The value must have only alphabetic characters and spaces and its length must be between 3 and 50 characters."));</span></span>

Barisan kod ini masih tidak menyelesaikan masalah Beucase, sama ada akan menunjukkan mesej ralat yang sama untuk setiap keadaan yang tidak berpatutan atau ia tidak akan memberi kesan. Jika garis yang ditunjukkan digunakan dalam kaedah INIT (), dengan cara yang sama ditunjukkan untuk setArrors (), dalam kes ralat, mesej tersuai akan ditunjukkan seberapa banyak kali sebagai bilangan syarat yang dilanggar oleh input pengguna. Jika garis dimasukkan semasa pengesahan data biasa dalam pengawal, dengan cara yang sama dijelaskan sebelum ini, tidak akan ada kesan. Ini bermakna mesej tersuai tidak akan dipaparkan dan rangka kerja akan menunjukkan hanya mesej lalai.

Membongkar penyelesaian

Sekarang maksudnya adalah untuk memahami ketika dan bagaimana Untuk memasukkan mesej tersuai supaya pengguna boleh mempunyai perbandingan dan cadangan mengenai nilai yang diterima. Pasti, ketika terletak pada penciptaan medan di dalam bentuk (init () kaedah) dan bagaimana disebabkan oleh kesatuan kaedah setArrormessages () dan penggunaan harta validator rangka kerja Zend yang dipanggil breakchainonfailure () . Yang terakhir membolehkan kita menghentikan proses pengesahan pada keadaan gagal pertama. Jika kami menubuhkan lima pengesahan tetapi yang pertama gagal, empat yang lain tidak akan digunakan. Untuk menggunakan harta ini menggunakan bilangan baris kod terkecil, saya akan menukar sedikit kod yang saya telah digambarkan pada mulanya. Saya akan menambah kepada kaedah INIT () baris kod yang menggunakan kaedah setArrormessages (), dan saya akan memanfaatkan salah satu konfigurasi input yang mungkin diterima oleh setValidators () yang menjangkakan pelbagai tatasusunan. Arahan yang terkandung dalam yang utama boleh mempunyai maksimum tiga parameter, iaitu:

1. rentetan (wajib) untuk menentukan pengesahan kepada pengguna.
2. boolean (pilihan, secara lalai nilainya adalah palsu) untuk menentukan sama ada kerangka harus memecahkan pengesahan pada kegagalan pertama atau tidak. Oleh itu, parameter ini menetapkan nilai breakchainonfailure harta yang akan membantu kita mencapai matlamat kita.
3. pelbagai pilihan (pilihan, secara lalai array kosong) berbeza untuk setiap validator yang dipilih

Menggunakan parameter kedua yang diluluskan sebagai benar bagi setiap pengesahan yang anda mahu gunakan adalah penting. Mengikut apa yang telah kita lihat sehingga sekarang, kod yang dihasilkan adalah:

<span><span><?php
</span></span><span><span>class Application_Form_User extends Zend_Form
</span></span><span><span>{
</span></span><span>    <span>public function init() {
</span></span><span>        <span>// create the field
</span></span><span>        <span>$element = new Zend_Form_Element_Text("name");
</span></span><span>        <span>$element->setLabel("Name");
</span></span><span>
</span><span>        <span>// set the validators
</span></span><span>        <span>$element->setValidators(array(
</span></span><span>            <span>new Zend_Validate_Alpha(true),
</span></span><span>            <span>new Zend_Validate_StringLength(
</span></span><span>                <span>array("min" => 3, "max" => 50))
</span></span><span>        <span>));
</span></span><span>        <span>$element->setRequired();
</span></span><span>
</span><span>        <span>// add the element to the form
</span></span><span>        <span>$this->addElement($element);
</span></span><span>
</span><span>        <span>// add a submit button
</span></span><span>        <span>$element = new Zend_Form_Element_Submit("submit");
</span></span><span>        <span>$element->setLabel("Submit");
</span></span><span>        <span>$this->addElement($element);
</span></span><span>    <span>}
</span></span><span><span>}</span></span>

Kesimpulan

Menggunakan kod di atas, borang itu akan menunjukkan hanya mesej tersuai apabila terdapat input yang tidak sah ... Tepat apa yang kita mahu! Sekiranya anda perlu menggunakan lebih banyak mesej, contohnya cadangan dalam beberapa peringkat, tambahkan lebih banyak rentetan pada array yang digunakan untuk kaedah setRrormessages (). imej melalui Fotolia

Soalan Lazim (Soalan Lazim) Pada Menetapkan Mesej Ralat Khusus Untuk Elemen Borang Zend

Bagaimana saya boleh menyesuaikan mesej ralat untuk elemen bentuk tertentu di zend?

Menyesuaikan mesej ralat untuk elemen bentuk tertentu di zend agak mudah. Anda boleh menggunakan kaedah setMessage () untuk menetapkan mesej ralat tersuai untuk pengesahan tertentu. Sebagai contoh, jika anda mempunyai elemen borang bernama 'e -mel' dan anda ingin menetapkan mesej ralat tersuai untuknya, anda boleh melakukannya seperti berikut:

$ e -mel = new Zend_Form_Element_text ('Email');
$ e -mel-> setLabel ('Alamat E -mel')
-> AddValidator ('Notempty', True)
-> addValidator ('e-melAddress'); e-mel-> getValidator ('notempty')-> setMessage ('Sila masukkan alamat e-mel anda'); Tetapkan mesej ralat tersuai untuk validator 'notempty' elemen borang 'e -mel'.

Bagaimana saya boleh menetapkan beberapa mesej ralat tersuai untuk elemen borang dalam Zend?

Jika anda ingin menetapkan beberapa mesej ralat tersuai untuk elemen borang di Zend, anda boleh menggunakan kaedah setMessages (). Kaedah ini menerima pelbagai mesej ralat. Berikut adalah contoh:

$ e -mel = new Zend_Form_Element_text ('e -mel');

$ e -mel-> setLabel ('Alamat E -mel') > -> addValIdator ('e-melAddress'); $ e-mel-> getValidator ('notempty')-> setMessages (array (
zend_validate_notempty :: is_empty => 'Sila masukkan alamat e-mel anda',
zend_valate_emailaddress: : Tidak sah => 'Sila masukkan alamat e -mel yang sah'
)); Dalam ini Contohnya, kaedah setMessages () digunakan untuk menetapkan beberapa mesej ralat tersuai untuk validator 'notempty' elemen borang 'e -mel'.

Bagaimana saya boleh memaparkan mesej ralat tersuai apabila borang gagal pengesahan di Zend? Kaedah ini menambah mesej ralat yang akan dipaparkan apabila borang gagal pengesahan. Berikut adalah contoh:

$ form = new Zend_form ();
$ form-> addElement ('text', 'e-mel', array (
'validators' => array (
array ('validator' => 'notempty', 'options' => array ('mesej' => 'e -mel diperlukan'),
array ('validator' => 'E-melAddress', 'options' => array ('mesej' => 'alamat e-mel tidak sah'))
)
));
$ form-> adderror ('Terdapat kesilapan dalam penyerahan anda. Sila betulkannya dan cuba lagi.'); kaedah adderror () digunakan untuk menambah mesej ralat tersuai yang akan dipaparkan apabila borang gagal pengesahan.

Bagaimana saya boleh menukar mesej ralat lalai di zend? Mesej ralat di Zend dengan menggunakan kaedah setMessage (). Kaedah ini membolehkan anda menetapkan mesej ralat tersuai untuk pengesahan tertentu. Berikut adalah contoh:

$ e -mel = new Zend_Form_Element_text ('e -mel');
$ e -mel-> setLabel ('Alamat E -mel') >-> addValidator ('e-melAddress'); $ e-mel-> getValidator ('notempty')-> setMessage ('Sila masukkan Alamat e-mel anda '); e-mel-> getValidator (' e-melAddress ')-> setMessage (' Sila masukkan alamat e-mel yang sah ');

Dalam contoh ini, kaedah setMessage () digunakan untuk menukar Mesej ralat lalai untuk pengesahan 'notempty' dan 'emailaddress' dari elemen borang 'e -mel'.

Bagaimana saya boleh menetapkan mesej ralat tersuai untuk elemen borang yang diperlukan dalam ZEND?

Jika elemen borang diperlukan di ZEND, anda boleh menetapkan mesej ralat tersuai untuk menggunakan kaedah setRequired () dan adderRormessage (). Berikut adalah contoh:

$ e -mel = baru zend_form_element_text ('e -mel');
$ e -mel-> setLabel ('alamat e -mel')
-> setRequired (true)
-> adderRormessage ('E -mel diperlukan'); Dalam contoh ini, kaedah setRequired () digunakan untuk membuat elemen borang 'e -mel' diperlukan, dan Kaedah adderRormessage () digunakan untuk menetapkan mesej ralat tersuai untuknya.

Atas ialah kandungan terperinci PHP Master | Menetapkan mesej ralat tersuai untuk zend_form_element. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!