diff --git a/docs/guide-ar/README.md b/docs/guide-ar/README.md new file mode 100644 index 0000000000..dd6c63ecef --- /dev/null +++ b/docs/guide-ar/README.md @@ -0,0 +1,205 @@ + Yii 2.0 الدليل التقني الخاص ببيئة العمل +=============================== + +تم تحرير هذا الملف اعتمادا على [الشروط الخاصة بتوثيف ال Yii](http://www.yiiframework.com/doc/terms/). + +جميع الحقوق محفوظة + +2014 (c) Yii Software LLC. + + +المقدمة +------------ + +* [عن بيئة العمل Yii](intro-yii.md) +* [التحديث من الإصدار 1.1](../guide/intro-upgrade-from-v1.md) + + +البداية من هنا +--------------- + +* [ماذا يجب أن تعرف عن بيئة العمل](start-prerequisites.md) +* [تنصيب ال Yii](../guide/start-installation.md) +* [تشغيل وتطبيق بيئة العمل](../guide/start-workflow.md) +* [قل مرحبا - المشروع الأول](../guide/start-hello.md) +* [العمل مع ال forms](../guide/start-forms.md) +* [العمل مع قواعد البيانات](../guide/start-databases.md) +* [إنشاء الشيفرة البرمجية من خلال ال gii](../guide/start-gii.md) +* [ماذا الآن - الخطوة القادمة](../guide/start-looking-ahead.md) + + +الهيكلية الخاصة بالتطبيق (Application Structure) +--------------------- + +* [نظرة عامة عن الهيكلية الخاصة بالتطبيق](../guide/structure-overview.md) +* [Entry Scripts](../guide/structure-entry-scripts.md) +* [التطبيقات](../guide/structure-applications.md) +* [مكونات التطبيقات](../guide/structure-application-components.md) +* [Controllers](../guide/structure-controllers.md) +* [Models](../guide/structure-models.md) +* [Views](../guide/structure-views.md) +* [Modules](../guide/structure-modules.md) +* [Filters](../guide/structure-filters.md) +* [Widgets](../guide/structure-widgets.md) +* [Assets](../guide/structure-assets.md) +* [Extensions](../guide/structure-extensions.md) + + +التعامل مع ال requests +----------------- + +* [نظرة عامة عن التعامل مع ال requests](../guide/runtime-overview.md) +* [Bootstrapping](../guide/runtime-bootstrapping.md) +* [Routing and URL Creation](../guide/runtime-routing.md) +* [Requests](../guide/runtime-requests.md) +* [Responses](../guide/runtime-responses.md) +* [Sessions and Cookies](../guide/runtime-sessions-cookies.md) +* [Handling Errors - التحكم بالأخطاء](../guide/runtime-handling-errors.md) +* [Logging - تسجيل الحركات](../guide/runtime-logging.md) + + +المفاهيم الرئيسية (Key Concepts) +------------ + +* [Components](../guide/concept-components.md) +* [Properties](../guide/concept-properties.md) +* [Events](../guide/concept-events.md) +* [Behaviors](../guide/concept-behaviors.md) +* [Configurations](../guide/concept-configurations.md) +* [Aliases](../guide/concept-aliases.md) +* [Class Autoloading](../guide/concept-autoloading.md) +* [Service Locator](../guide/concept-service-locator.md) +* [Dependency Injection Container](../guide/concept-di-container.md) + + +التعامل مع قواعد البيانات +---------------------- + +* [Database Access Objects](../guide/db-dao.md): Connecting to a database, basic queries, transactions, and schema manipulation +* [Query Builder](../guide/db-query-builder.md): Querying the database using a simple abstraction layer +* [Active Record](../guide/db-active-record.md): The Active Record ORM, retrieving and manipulating records, and defining relations +* [Migrations](../guide/db-migrations.md): Apply version control to your databases in a team development environment +* [Sphinx](https://www.yiiframework.com/extension/yiisoft/yii2-sphinx/doc/guide) +* [Redis](https://www.yiiframework.com/extension/yiisoft/yii2-redis/doc/guide) +* [MongoDB](https://www.yiiframework.com/extension/yiisoft/yii2-mongodb/doc/guide) +* [ElasticSearch](https://www.yiiframework.com/extension/yiisoft/yii2-elasticsearch/doc/guide) + + +الحصول على البيانات من خلال المستخدمين +----------------------- + +* [Creating Forms](../guide/input-forms.md) +* [Validating Input](../guide/input-validation.md) +* [Uploading Files](../guide/input-file-upload.md) +* [Collecting Tabular Input](../guide/input-tabular-input.md) +* [Getting Data for Multiple Models](../guide/input-multiple-models.md) +* [Extending ActiveForm on the Client Side](../guide/input-form-javascript.md) + + +عرض البيانات +--------------- + +* [Data Formatting](../guide/output-formatting.md) +* [Pagination](../guide/output-pagination.md) +* [Sorting](../guide/output-sorting.md) +* [Data Providers](../guide/output-data-providers.md) +* [Data Widgets](../guide/output-data-widgets.md) +* [Working with Client Scripts](../guide/output-client-scripts.md) +* [Theming](../guide/output-theming.md) + + +الامان والحماية +-------- + +* [Security Overview](../guide/security-overview.md) +* [Authentication](../guide/security-authentication.md) +* [Authorization](../guide/security-authorization.md) +* [Working with Passwords](../guide/security-passwords.md) +* [Cryptography](../guide/security-cryptography.md) +* [Auth Clients](https://www.yiiframework.com/extension/yiisoft/yii2-authclient/doc/guide) +* [Best Practices](../guide/security-best-practices.md) + + +Caching التخزين المؤقت +------- + +* [Caching Overview](../guide/caching-overview.md) +* [Data Caching](../guide/caching-data.md) +* [Fragment Caching](../guide/caching-fragment.md) +* [Page Caching](../guide/caching-page.md) +* [HTTP Caching](../guide/caching-http.md) + + +RESTful Web Services +-------------------- + +* [Quick Start](../guide/rest-quick-start.md) +* [Resources](../guide/rest-resources.md) +* [Controllers](../guide/rest-controllers.md) +* [Routing](../guide/rest-routing.md) +* [Response Formatting](../guide/rest-response-formatting.md) +* [Authentication](../guide/rest-authentication.md) +* [Rate Limiting](../guide/rest-rate-limiting.md) +* [Versioning](../guide/rest-versioning.md) +* [Error Handling](../guide/rest-error-handling.md) + + +الأدوات المساعدة أثناء تطوير التطبيقات +----------------- + +* [Debug Toolbar and Debugger](https://www.yiiframework.com/extension/yiisoft/yii2-debug/doc/guide) +* [Generating Code using Gii](https://www.yiiframework.com/extension/yiisoft/yii2-gii/doc/guide) +* [Generating API Documentation](https://www.yiiframework.com/extension/yiisoft/yii2-apidoc) + + +فحص واختبار التطبيقات +------- + +* [Testing Overview](../guide/test-overview.md) +* [Testing environment setup](../guide/test-environment-setup.md) +* [Unit Tests](../guide/test-unit.md) +* [Functional Tests](../guide/test-functional.md) +* [Acceptance Tests](../guide/test-acceptance.md) +* [Fixtures](../guide/test-fixtures.md) + + +مواضيع وعناوين مميزة +-------------- + +* [Advanced Project Template](https://www.yiiframework.com/extension/yiisoft/yii2-app-advanced/doc/guide) +* [Building Application from Scratch](../guide/tutorial-start-from-scratch.md) +* [Console Commands](../guide/tutorial-console.md) +* [Core Validators](../guide/tutorial-core-validators.md) +* [Docker](../guide/tutorial-docker.md) +* [Internationalization](../guide/tutorial-i18n.md) +* [Mailing](../guide/tutorial-mailing.md) +* [Performance Tuning](../guide/tutorial-performance-tuning.md) +* [Shared Hosting Environment](../guide/tutorial-shared-hosting.md) +* [Template Engines](../guide/tutorial-template-engines.md) +* [Working with Third-Party Code](../guide/tutorial-yii-integration.md) +* [Using Yii as a micro framework](../guide/tutorial-yii-as-micro-framework.md) + + +Widgets +------- + +* [GridView](https://www.yiiframework.com/doc-2.0/yii-grid-gridview.html) +* [ListView](https://www.yiiframework.com/doc-2.0/yii-widgets-listview.html) +* [DetailView](https://www.yiiframework.com/doc-2.0/yii-widgets-detailview.html) +* [ActiveForm](https://www.yiiframework.com/doc-2.0/guide-input-forms.html#activerecord-based-forms-activeform) +* [Pjax](https://www.yiiframework.com/doc-2.0/yii-widgets-pjax.html) +* [Menu](https://www.yiiframework.com/doc-2.0/yii-widgets-menu.html) +* [LinkPager](https://www.yiiframework.com/doc-2.0/yii-widgets-linkpager.html) +* [LinkSorter](https://www.yiiframework.com/doc-2.0/yii-widgets-linksorter.html) +* [Bootstrap Widgets](https://www.yiiframework.com/extension/yiisoft/yii2-bootstrap/doc/guide) +* [jQuery UI Widgets](https://www.yiiframework.com/extension/yiisoft/yii2-jui/doc/guide) + + +Helpers +------- + +* [Helpers Overview](../guide/helper-overview.md) +* [ArrayHelper](../guide/helper-array.md) +* [Html](../guide/helper-html.md) +* [Url](../guide/helper-url.md) + diff --git a/docs/guide-ar/intro-yii.md b/docs/guide-ar/intro-yii.md new file mode 100644 index 0000000000..7177d094b8 --- /dev/null +++ b/docs/guide-ar/intro-yii.md @@ -0,0 +1,57 @@ +#
ما هي بيئة العمل Yii
+ +

Yii هو إطار PHP عالي الأداء يعتمد على المكونات لتطوير تطبيقات الويب الحديثة بسرعة. +إن الاسم "Yii" (يُنطق بـ "يي" أو "[جي:]" يعني "بسيطًا وتطوريًا" باللغة الصينية. ومن الممكن ايضا + اعتباره اختصارًا لـ Yes It Is!

+ + +#
ما هي أفضل التطبيقات أو البرمجيات التي يمكن برمجتها وتتناسب مع ال Yii
+ +

+Yii هو إطار عام لبرمجة الويب ، مما يعني أنه يمكن استخدامه لتطوير كافة أنواع +تطبيقات الويب باستخدام PHP. وذلك بسبب البنية القائمة على البنية التركيبة لبيئة العمل وترابطها مع المكونات والتخزين المؤقت، وهو مناسب بشكل خاص لتطوير portals, forums, content management systems (CMS), e-commerce projects, RESTful Web services. وما إلى ذلك. +

+ + +#
كيف يمكن مقارنة بيئة العمل الخاصة بال Yii مع الأطر أو بيئات العمل الأخرى؟
+ +

+ إذا كنت بالفعل على دراية بإطار العمل الأخرى ، فيمكنك معرفة كيف تتم مقارنة ال Yii: + +

+

+ +

+ال Yii إطار عمل صمم من قبل فريق برمجي متكامل، فهو ليس مجرد عمل فردي ، بل يتكون من فريق تطوير أساسي وقوي(http://www.yiiframework.com/team/) ، بالإضافة إلى منتدى كبير +من المهنيين الذين يساهمون باستمرار في تطوير هذا الإطار. فريق المطورين الخاص بال Yii +يراقب عن كثب أحدث اتجاهات تطوير الويب وأفضل الممارسات والمميزات التي +وجدت في الأطر والمشاريع الأخرى. وتدرج بانتظام بإضافة أفضل الممارسات والميزات الى ال Yii عبر واجهات بسيطة وأنيقة. +

+ + + +#
الإصدارات الخاصة بال Yii
+ +

+ يتوفر لدى Yii حاليًا إصداران رئيسيان: 1.1 و 2.0. الإصدار 1.1 هو الجيل القديم وهو الآن في وضع الصيانة. الإصدار 2.0 هو إعادة كتابة وهيكلة كاملة لل Yii، تم اعتماد أحدث التقنيات والبروتوكولات فيها مثل including Composer, PSR, namespaces, traits والكثير من الأمور الأخرى، وفي هذه الإرشادات، سيكون الكلام كله موجها الى الإصدار الثاني من بيئة العمل ال Yii. +

+ +#
المتطلبات الأساسية للعمل على إطار ال Yii
+ +

+

+

+ +

+ ملاحظة: يمكن التحقق من توافق المتطلبات الخاصة بك مع ال yii من خلال الدخول الى الصفحة requirement الموجودة بال yii +

diff --git a/docs/guide-ar/start-prerequisites.md b/docs/guide-ar/start-prerequisites.md new file mode 100644 index 0000000000..bbafc6e461 --- /dev/null +++ b/docs/guide-ar/start-prerequisites.md @@ -0,0 +1,25 @@ +#
ماذا يجب أن تعرف قبل البدء بال Yii
+ +

+ منحنى التعلم الخاص بال Yii ليس حادًا مثل أطر PHP الأخرى، ولكن لا يزال هناك بعض الأشياء التي يجب أن تتعلمها قبل البدء بـال Yii. +

+ +##
PHP
+ +

+ ال Yii هو إطار عمل PHP، لذا تأكد من قراءة وفهم المرجع الرسمي الخاص باللغة (http://php.net/manual/en/langref.php). عند البدء بتطوير المشاريع أو التطبيقات باستخدام ال Yii ، ستكتب التعليمات البرمجية بطريقة كائنية التوجه OOP، لذا تأكد من أنك على دراية بـمفاهيم ال OOP (https://secure.php.net/manual/en/language.oop5.basic.php) وكذلك ال namespaces (https://secure.php.net/manual/en/language.namespaces.php). +

+ +##
البرمجة كائنية التوجه object oriented programming
+ +

+ كمبرمج أو مطور يرغب بالعمل على ال Yii، يجب عليك أن تمتلك المعرفة الأساسية للبرمجة كائنية التوجه OOP. إذا لم تكن على دراية بها ، فيمكنك تعلم ذلك من خلال واحدة من هذه الدورات المنتشرة مثل (https://code.tutsplus.com/tutorials/object-oriented-php-for-beginners--net-12762).
+ملاحظة: كلما زاد تعقيد التطبيق أو المشروع الذي تعمل عليه، كلما احتجت الى مستوى أعلى وإحترافي أكثر من مفاهيم ال OOP لحل وإدارة التعقديات التي ستترب على مثل هذه المشاريع. +

+ +##
Command line and composer
+ +

تستخدم ال Yii بشكل كبير de-facto standard PHP package manager، ال Composer (https://getcomposer.org/)، لذلك تأكد من قرائتك وفهمك لهذا الموضوع قبل أن تبدء. بالإضافة الى ذلك إذا لم تكن على دراية باستخدام سطر الأوامر (command line) ، فقد حان الوقت لبدء المحاولة. بمجرد تعلم الأساسيات ، لن ترغب في العمل بدون إستخدام سطر الأوامر.
+ال composer: ويترجم حرفيا الى كلمة "الملحن"، وهي عبارة عن أداة لإدارة المشاريع البرمجية والتي تسمح لك بتحديث وتنزيل المكتبات البرمجية المطلوبة للمشروع الخاص بك. +

+ diff --git a/docs/guide-es/test-acceptance.md b/docs/guide-es/test-acceptance.md new file mode 100644 index 0000000000..8df65e44db --- /dev/null +++ b/docs/guide-es/test-acceptance.md @@ -0,0 +1,20 @@ +Tests de aceptación +=================== + +Un test de aceptación verifica escenarios desde la perspectiva de un usuario. +Se accede a la aplicación testeada por medio de PhpBrowser o de un navegador de verdad. +En ambos casos los navegadores se comunican vía HTTP así que la aplicación debe ser +servida por un servidor web. + +Los tests de aceptación se implementan con ayuda del _framework_ Codeception, que tiene +una buena documentación: + +- [Codeception para el _framework_ Yii](http://codeception.com/for/yii) +- [Tests funcionales de Codeception](http://codeception.com/docs/04-FunctionalTests) + +## Ejecución de tests en las plantillas básica y avanzada + +Si ha empezado con la plantilla avanzada, consulte la [guía de testeo](https://github.com/yiisoft/yii2-app-advanced/blob/master/docs/guide/start-testing.md) +para más detalles sobre la ejecución de tests. + +Si ha empezado con la plantilla básica, consulte la [sección sobre testeo de su README](https://github.com/yiisoft/yii2-app-basic/blob/master/README.md#testing). diff --git a/docs/guide-es/test-environment-setup.md b/docs/guide-es/test-environment-setup.md index 631f96a9ee..e016112b85 100644 --- a/docs/guide-es/test-environment-setup.md +++ b/docs/guide-es/test-environment-setup.md @@ -1,49 +1,23 @@ -Preparación del entorno de test -=============================== +Preparación del entorno de pruebas +================================== -> Note: Esta sección se encuentra en desarrollo. +Yii 2 ha mantenido oficialmente integración con el _framework_ de testeo [`Codeception`](https://github.com/Codeception/Codeception), +que le permite crear los siguientes tipos de tests: -Yii 2 ha mantenido integración oficial con el framework de testing [`Codeception`](https://github.com/Codeception/Codeception), -que te permite crear los siguientes tipos de tests: +- [Unitari](test-unit.md) - verifica que una unidad simple de código funciona como se espera; +- [Funcional](test-functional.md) - verifica escenarios desde la perspectiva de un usuario a través de la emulación de un navegador; +- [De aceptación](test-acceptance.md) - verifica escenarios desde la perspectiva de un usuario en un navegador. -- [Test de unidad](test-unit.md) - verifica que una unidad simple de código funciona como se espera; -- [Test funcional](test-functional.md) - verifica escenarios desde la perspectiva de un usuario a través de la emulación de un navegador; -- [Test de aceptación](test-acceptance.md) - verifica escenarios desde la perspectiva de un usuario en un navegador. +Yii provee grupos de pruebas listos para utilizar para los tres tipos de test, tanto en la plantilla de proyecto +[`yii2-basic`](https://github.com/yiisoft/yii2-app-basic) como en +[`yii2-advanced`](https://github.com/yiisoft/yii2-app-advanced). -Yii provee grupos de pruebas listos para utilizar en ambos -[`yii2-basic`](https://github.com/yiisoft/yii2-app-basic) y -[`yii2-advanced`](https://github.com/yiisoft/yii2-app-advanced) templates de proyectos. - -Para poder ejecutar estos tests es necesario instalar [Codeception](https://github.com/Codeception/Codeception). -Puedes instalarlo tanto localmente - únicamente para un proyecto en particular, o globalmente - para tu máquina de desarrollo. - -Para la instalación local utiliza los siguientes comandos: +Codeception viene preinstalado tanto en la plantilla de proyecto básica como en la avanzada. +En caso de que no use una de estas plantillas, puede instalar Codeception ejecutando +las siguientes órdenes de consola: ``` -composer require "codeception/codeception=2.1.*" -composer require "codeception/specify=*" -composer require "codeception/verify=*" +composer require codeception/codeception +composer require codeception/specify +composer require codeception/verify ``` - -Para la instalación global necesitarás la directiva `global`: - -``` -composer global require "codeception/codeception=2.1.*" -composer global require "codeception/specify=*" -composer global require "codeception/verify=*" -``` - -En caso de que nunca hayas utilizado Composer para paquetes globales, ejecuta `composer global status`. Esto debería mostrar la salida: - -``` -Changed current directory to -``` - -Entonces agrega `/vendor/bin` a tu variable de entorno `PATH`. Ahora podrás utilizar el `codecept` en la línea -de comandos a nivel global. - -> Note: la instalación global te permite usar Codeception para todos los proyectos en los que trabajes en tu máquina de desarrollo y - te permite ejecutar el comando `codecept` globalmente sin especificar su ruta. De todos modos, ese acercamiento podría ser inapropiado, - por ejemplo, si 2 proyectos diferentes requieren diferentes versiones de Codeception instaladas. - Por simplicidad, todos los comandos relacionados a tests en esta guía están escritos asumiendo que Codeception - ha sido instalado en forma global. diff --git a/docs/guide-es/test-functional.md b/docs/guide-es/test-functional.md index ee53ebc9d1..b48238cb2c 100644 --- a/docs/guide-es/test-functional.md +++ b/docs/guide-es/test-functional.md @@ -1,11 +1,25 @@ -Tests Funcionales +Tests funcionales ================= -> Note: Esta sección se encuentra en desarrollo. +Los tests funcionales verifican escenarios desde la perspectiva de un usuario. +Son similares a los [tests de aceptación](test-acceptance.md) pero en lugar de +comunicarse vía HTTP rellena el entorno como parámetros POST y GET y después ejecuta +una instancia de la aplicación directamente desde el código. -- [Tests Funcionales de Codeception](http://codeception.com/docs/04-FunctionalTests) +Los tests funcionales son generalmente más rápidos que los tests de aceptación y +proporcionan _stack traces_ detalladas en los fallos. +Como regla general, debería preferirlos salvo que tenga una configuración de servidor +web especial o una interfaz de usuario compleja en Javascript. -Ejecutar test funcionales de templates básicos y avanzados ----------------------------------------------------------- +Las pruebas funcionales se implementan con ayuda del _framework_ Codeception, que tiene +una buena documentación: -Por favor consulta las instrucciones provistas en `apps/advanced/tests/README.md` y `apps/basic/tests/README.md`. +- [Codeception para el _framework_ Yii](http://codeception.com/for/yii) +- [Tests funcionales de Codeception](http://codeception.com/docs/04-FunctionalTests) + +## Ejecución de tests en las plantillas básica y avanzada + +Si ha empezado con la plantilla avanzada, consulte la [guía de testeo](https://github.com/yiisoft/yii2-app-advanced/blob/master/docs/guide/start-testing.md) +para más detalles sobre la ejecución de tests. + +Si ha empezado con la plantilla básica, consulte la [sección sobre testeo de su README](https://github.com/yiisoft/yii2-app-basic/blob/master/README.md#testing). diff --git a/docs/guide-es/test-overview.md b/docs/guide-es/test-overview.md new file mode 100644 index 0000000000..35b7008191 --- /dev/null +++ b/docs/guide-es/test-overview.md @@ -0,0 +1,80 @@ +Tests +===== + +Las pruebas son una parte importante del desarrollo de software. Seamos conscientes +de ello o no, ralizamos pruebas contínuamente. +Por ejemplo, cuando escribimos una clase en PHP, podemos depurarla paso a paso o +simplemente usar declaraciones `echo` o `die` para verificar que la implementación +funciona conforme a nuestro plan inicial. En el caso de una aplicación web, introducimos +algunos datos de prueba en los formularios para asegurarnos de que la página interactúa +con nosotros como esperábamos. + +El proceso de testeo se puede automatizar para que cada vez que necesitemos verificar +algo, solamente necesitemos invocar el código que lo hace por nosotros. El código que +verifica que el restulado coincide con lo que habíamos planeado se llama *test* y el proceso +de su creación y posterior ejecución es conocido como *testeo automatizado*, que es el +principal tema de estos capítulos sobre testeo. + + +## Desarrollo con tests + +El Desarrollo Dirigido por Pruebas (_Test-Driven Development_ o TDD) y el Desarrollo +Dirigido por Corpotamientos (_Behavior-Driven Development_ o BDD) son enfoques para +desarrollar software, en los que se describe el comportamiento de un trozo de código +o de toda la funcionalidad como un conjunto de escenarios o pruebas antes de escribir +el código real y sólo entonces crear la implementación que permite pasar esos tests +verificando que se ha logrado el comportamiento pretendido. + +El proceso de desarrollo de una funcionalidad es el siguiente: + +- Crear un nuevo test que describe una funcionalidad a implementar. +- Ejecutar el nuevo test y asegurarse de que falla. Esto es lo esperado, dado que todavía no hay ninguna implementación. +- Escribir un código sencillo para superar el nuevo test. +- Ejecutar todos los tests y asegurarse de que se pasan todos. +- Mejorar el código y asegurarse de que los tests siguen superándose. + +Una vez hecho, se repite el proceso de neuvo para otra funcionalidad o mejora. +Si se va a cambiar la funcionalidad existente, también hay que cambiar los tests. + +> Tip: Si siente que está perdiendo tiempo haciendo un montón de iteraciones pequeñas +> y simples, intente cubrir más por cada escenario de test, de modo que haga más cosas antes +> de ejecutar los tests de nuevo. Si está depurando demasiado, intente hacer lo contrario. + +La razón para crear los tests antes de hacer ninguna implementación es que eso nos permite +centrarnos en lo que queremos alcanzar y sumergirnos totalmente en «cómo hacerlo» después. +Normalmente conduce a mejores abstracciones y a un más fácil mantenimiento de los tests +cuando toque hacer ajustes a las funcionalidades o componentes menos acoplados. + +Para resumir, las ventajas de este enfoque son las siguientes: + +- Le mantiene centrado en una sola cosa en cada momento, lo que resulta en una mejor planificación e implementación. +- Resulta en más funcionalidades cubiertas por tests, y en mayor detalle. Es decir, si se superan los tests, lo más problable es que no haya nada roto. + +A largo plazo normalmente tiene como efecto un buen ahorro de tiempo. + +## Qué y cómo probar + +Aunque el enfoque de primero los tests descrito arriba tiene sentido para el largo plazo +y proyectos relativamente complejos, sería excesivo para proyectos más simples. +Hay algunas indicaciones de cuándo es apropiado: + +- El proyecto ya es grande y complejo. +- Los requisitos del proyecto están empezando a hacerse complejos. El proyecto crece constantemente. +- El proyecto pretende a ser a largo plazo. +- El coste de fallar es demasiado alto. + +No hay nada malo en crear tests que cubran el comportamiento de una implementación existente. + +- Es un proyecto legado que se va a renovar gradualmente. +- Le han dado un proyecto sobre el que trabajar y no tiene tests. + +En algunos casos cualquier forma de testo automatizado sería exagerada: + +- El proyecto es sencillo y no se va a volver más complejo. +- Es un proyecto puntual en el que no se seguirá trabajando. + +De todas formas, si dispone de tiempo, es bueno automatizar las pruebas también en esos casos. + +## Más lecturas + +- Test Driven Development: By Example / Kent Beck. ISBN: 0321146530. diff --git a/docs/guide-es/test-unit.md b/docs/guide-es/test-unit.md index 5cb43fef74..c6b47adfc6 100644 --- a/docs/guide-es/test-unit.md +++ b/docs/guide-es/test-unit.md @@ -1,25 +1,25 @@ -Tests de Unidad -=============== +Pruebas unitarias +================= -> Note: Esta sección se encuentra en desarrollo. +Un test unitario se encarga de verificar que una unidad simple de código funcione como se espera. +Esto decir, dados diferentes parámetros de entrada, el test verifica que el método +de la clase devuelve el resultado esperado. +Normalmente los tests unitarios son desarrollados por la persona que escribe las clases testeadas. -Un test de unidad se encarga de verificar que una unidad simple de código funcione como se espera. En la programación orientada a objetos, -la unidad de código más básica es una clase. Por lo tanto, un test de unidad necesita verificar que cada método de la interfaz de la clase funciona apropiadamente. -Esto quiere decir que, dando diferentes parámetros de entrada, el test verifica que el método devuelve el resultado esperado. -Los tests de unidad son normalmente desarrollados por la persona que escribe las clases siendo testeadas. +Los tests unitarios en Yii están construidos en base a PHPUnit y, opcionalmente, Codeception, por lo que se recomienda consultar su respectiva documentación: -Los tests de unidad en Yii están construidos en base a PHPUnit y opcionalmente, Codeception, por lo que se recomineda consultar su respectiva documentación: +- [Codeception para el _framework_ Yii](http://codeception.com/for/yii) +- [Tests unitarios con Codeception](http://codeception.com/docs/05-UnitTests) +- [Documentación de PHPUnit, empezando por el capítulo 2](http://phpunit.de/manual/current/en/writing-tests-for-phpunit.html) -- [Documentación de PHPUnit comienza en el capítulo 2](http://phpunit.de/manual/current/en/writing-tests-for-phpunit.html). -- [Tests de Unidad con Codeception](http://codeception.com/docs/05-UnitTests). +## Ejecución de tests en las plantillas básica y avanzada -Ejecutar test de unidad de templates básicos y avanzados --------------------------------------------------------- +Si ha empezado con la plantilla avanzada, consulte la [guía de testeo](https://github.com/yiisoft/yii2-app-advanced/blob/master/docs/guide/start-testing.md) +para más detalles sobre la ejecución de tests. -Por favor consulta las instrucciones provistas en `apps/advanced/tests/README.md` y `apps/basic/tests/README.md`. +Si ha empezado con la plantilla básica, consulte la [sección sobre testeo de su README](https://github.com/yiisoft/yii2-app-basic/blob/master/README.md#testing). -Test de unidad del Framework ----------------------------- +##Tests unitarios del framework -Si quieres ejecutar tests de unidad para Yii en sí, consulta -"[Comenzando a desarrollar con Yii 2](https://github.com/yiisoft/yii2/blob/master/docs/internals/getting-started.md)". +Si desea ejecutar tests unitarios para el framework Yii en sí, consulte +«[Comenzando con el desarrollo de Yii 2](https://github.com/yiisoft/yii2/blob/master/docs/internals/getting-started.md)». diff --git a/docs/guide-ru/tutorial-core-validators.md b/docs/guide-ru/tutorial-core-validators.md index df180b3074..16bc11e008 100644 --- a/docs/guide-ru/tutorial-core-validators.md +++ b/docs/guide-ru/tutorial-core-validators.md @@ -66,7 +66,7 @@ public function rules() // проверяет, является ли значение атрибута "password" таким же, как "password_repeat" ['password', 'compare'], - // то же, что и выше, но атрбут для сравнения указан явно + // то же, что и выше, но атрибут для сравнения указан явно ['password', 'compare', 'compareAttribute' => 'password_repeat'], // проверяет, что возраст больше или равен 30 diff --git a/docs/guide-zh-CN/rest-authentication.md b/docs/guide-zh-CN/rest-authentication.md index db99c2ba49..23fd4e4d39 100644 --- a/docs/guide-zh-CN/rest-authentication.md +++ b/docs/guide-zh-CN/rest-authentication.md @@ -63,7 +63,7 @@ public function behaviors() } ``` -如果你系那个支持以上3个认证方式，可以使用`CompositeAuth`，如下所示： +如果你想支持以上3个认证方式，可以使用`CompositeAuth`，如下所示： ```php use yii\filters\auth\CompositeAuth; diff --git a/docs/guide/structure-widgets.md b/docs/guide/structure-widgets.md index 39427471f1..d4324d8661 100644 --- a/docs/guide/structure-widgets.md +++ b/docs/guide/structure-widgets.md @@ -86,6 +86,10 @@ details. ## Creating Widgets +Widget can be created in either of two different ways depending on the requirement. + +### 1: Utilizing `widget()` method + To create a widget, extend from [[yii\base\Widget]] and override the [[yii\base\Widget::init()]] and/or [[yii\base\Widget::run()]] methods. Usually, the `init()` method should contain the code that initializes the widget properties, while the `run()` method should contain the code that generates the rendering result of the widget. @@ -128,6 +132,21 @@ use app\components\HelloWidget; 'Good morning']) ?> ``` + +Sometimes, a widget may need to render a big chunk of content. While you can embed the content within the `run()` +method, a better approach is to put it in a [view](structure-views.md) and call [[yii\base\Widget::render()]] to +render it. For example, + +```php +public function run() +{ + return $this->render('hello'); +} +``` + +### 2: Utilizing `begin()` and `end()` methods + +This is similar to above one with minor difference. Below is a variant of `HelloWidget` which takes the content enclosed within the `begin()` and `end()` calls, HTML-encodes it and then displays it. @@ -168,22 +187,17 @@ use app\components\HelloWidget; ?> - content that may contain 's + sample content that may contain one or more HTML 
tags
+ + If this content grows too big, use sub views + + For e.g. + + render('viewfile'); // Note: here render() method is of class \yii\base\View as this part of code is within view file and not in Widget class file ?> ``` -Sometimes, a widget may need to render a big chunk of content. While you can embed the content within the `run()` -method, a better approach is to put it in a [view](structure-views.md) and call [[yii\base\Widget::render()]] to -render it. For example, - -```php -public function run() -{ - return $this->render('hello'); -} -``` - By default, views for a widget should be stored in files in the `WidgetPath/views` directory, where `WidgetPath` stands for the directory containing the widget class file. Therefore, the above example will render the view file `@app/components/views/hello.php`, assuming the widget class is located under `@app/components`. You may override @@ -205,3 +219,4 @@ which can be utilized to solve the problem. When a widget contains view code only, it is very similar to a [view](structure-views.md). In fact, in this case, their only difference is that a widget is a redistributable class, while a view is just a plain PHP script that you would prefer to keep within your application. + diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md index d5577302f2..cf4d641447 100644 --- a/framework/CHANGELOG.md +++ b/framework/CHANGELOG.md @@ -4,6 +4,9 @@ Yii Framework 2 Change Log 2.0.16 under development ------------------------ +- Bug #13932: Fix number validator attributes comparison (uaoleg, s1lver) +- Bug #14039, #16636: Fixed validation for disabled inputs (s1lver, omzy83) +- Bug #16425: Check for additional values for disabled confirm dialog (Alex-Code, s1lver) - Enh #14367: In `yii\db\mysql\QueryBuilder` added support fractional seconds for time types for MySQL >= 5.6.4 (konstantin-vl) - Bug #16766: `yii\filters\ContentNegotiator` was not setting `Vary` header to inform cache recipients (koteq, cebe, samdark) - Bug #11960: Fixed `checked` option ignore in `yii\helpers\BaseHtml::checkbox()` (misantron) diff --git a/framework/assets/yii.activeForm.js b/framework/assets/yii.activeForm.js index ec0be1e84e..fbcece46f4 100644 --- a/framework/assets/yii.activeForm.js +++ b/framework/assets/yii.activeForm.js @@ -325,7 +325,7 @@ // client-side validation $.each(data.attributes, function () { this.$form = $form; - if (!$(this.input).is(":disabled")) { + if (!findInput($form, this).is(":disabled")) { this.cancelled = false; // perform validation only if the form is being submitted or if an attribute is pending validation if (data.submitting || this.status === 2 || this.status === 3) { @@ -489,7 +489,6 @@ updateInput($(this), attribute, msg); } } - }; var watchAttribute = function ($form, attribute) { @@ -625,8 +624,9 @@ if (submitting) { var errorAttributes = []; + var $input = findInput($form, this); $.each(data.attributes, function () { - if (!$(this.input).is(":disabled") && !this.cancelled && updateInput($form, this, messages)) { + if (!$input.is(":disabled") && !this.cancelled && updateInput($form, this, messages)) { errorAttributes.push(this); } }); diff --git a/framework/assets/yii.js b/framework/assets/yii.js index fd38b02dce..766877d85d 100644 --- a/framework/assets/yii.js +++ b/framework/assets/yii.js @@ -483,7 +483,7 @@ window.yii = (function ($) { return true; } - if (message !== undefined) { + if (message !== undefined && message !== false && message !== '') { $.proxy(pub.confirm, this)(message, function () { pub.handleAction($this, event); }); diff --git a/framework/assets/yii.validation.js b/framework/assets/yii.validation.js index 16a74f03ca..81cf69c222 100644 --- a/framework/assets/yii.validation.js +++ b/framework/assets/yii.validation.js @@ -282,12 +282,12 @@ yii.validation = (function ($) { if (!$target.length) { $target = $form.find('[name="' + options.compareAttributeName + '"]'); } - compareValue = $target.val(); + compareValue = $target.val(); } if (options.type === 'number') { - value = parseFloat(value); - compareValue = parseFloat(compareValue); + value = value ? parseFloat(value) : 0; + compareValue = compareValue ? parseFloat(compareValue) : 0; } switch (options.operator) { case '==': diff --git a/framework/db/QueryTrait.php b/framework/db/QueryTrait.php index e9dc68e82d..4f2789dc99 100644 --- a/framework/db/QueryTrait.php +++ b/framework/db/QueryTrait.php @@ -85,7 +85,7 @@ trait QueryTrait * * See [[QueryInterface::where()]] for detailed documentation. * - * @param array $condition the conditions that should be put in the WHERE part. + * @param string|array $condition the conditions that should be put in the WHERE part. * @return $this the query object itself * @see andWhere() * @see orWhere() diff --git a/framework/helpers/BaseArrayHelper.php b/framework/helpers/BaseArrayHelper.php index 054bda5b66..e070db5599 100644 --- a/framework/helpers/BaseArrayHelper.php +++ b/framework/helpers/BaseArrayHelper.php @@ -509,7 +509,7 @@ class BaseArrayHelper * ``` * * @param array $array - * @param string|\Closure $name + * @param int|string|\Closure $name * @param bool $keepKeys whether to maintain the array keys. If false, the resulting array * will be re-indexed with integers. * @return array the list of column values diff --git a/tests/js/data/yii.activeForm.html b/tests/js/data/yii.activeForm.html index 912c549a18..928b25371e 100644 --- a/tests/js/data/yii.activeForm.html +++ b/tests/js/data/yii.activeForm.html @@ -1,3 +1,37 @@
+ +
+
+
+ + +
+
+
+ +
+
+ + +
+ + +
+
+
+
+ +
+
+ + +
+ + +
+
+
+
+
\ No newline at end of file diff --git a/tests/js/tests/yii.activeForm.test.js b/tests/js/tests/yii.activeForm.test.js index 65a564941a..23733a5366 100644 --- a/tests/js/tests/yii.activeForm.test.js +++ b/tests/js/tests/yii.activeForm.test.js @@ -78,6 +78,32 @@ describe('yii.activeForm', function () { assert.isTrue(afterValidateSpy.calledOnce); }); }); + + describe('with disabled fields', function () { + var inputTypes = { + test_radio: 'radioList', + test_checkbox: 'checkboxList', + test_text: 'text input' + }; + + for (var key in inputTypes) { + if (inputTypes.hasOwnProperty(key)) { + (function () { + var inputId = key; + it(inputTypes[key] + ' disabled field', function () { + $activeForm = $('#w1'); + $activeForm.yiiActiveForm({ + id: inputId, + input: '#' + inputId + }); + $activeForm.yiiActiveForm('validate'); + + assert.isFalse($activeForm.data('yiiActiveForm').validated); + }); + })(); + } + } + }); }); describe('resetForm method', function () { diff --git a/tests/js/tests/yii.test.js b/tests/js/tests/yii.test.js index 60d3059a50..f135edb18f 100644 --- a/tests/js/tests/yii.test.js +++ b/tests/js/tests/yii.test.js @@ -1359,6 +1359,33 @@ describe('yii', function () { }); }); + describe('disabled confirm dialog', function () { + it('confirm data param = false', function () { + var element = $('#data-methods-no-data'); + element.attr('data-confirm', false); + element.trigger($.Event('click')); + + assert.isFalse(yiiConfirmSpy.called); + assert.isTrue(yiiHandleActionStub.called); + }); + it('confirm data param = empty', function () { + var element = $('#data-methods-no-data'); + element.attr('data-confirm', ''); + element.trigger($.Event('click')); + + assert.isFalse(yiiConfirmSpy.called); + assert.isTrue(yiiHandleActionStub.called); + }); + it('confirm data param = undefined', function () { + var element = $('#data-methods-no-data'); + element.attr('data-confirm', undefined); + element.trigger($.Event('click')); + + assert.isFalse(yiiConfirmSpy.called); + assert.isTrue(yiiHandleActionStub.called); + }); + }); + describe('with clickableSelector with data-confirm', function () { it('should call confirm and handleAction methods', function () { var event = $.Event('click'); diff --git a/tests/js/tests/yii.validation.test.js b/tests/js/tests/yii.validation.test.js index ea8ffb3651..e5196d309b 100644 --- a/tests/js/tests/yii.validation.test.js +++ b/tests/js/tests/yii.validation.test.js @@ -1518,6 +1518,41 @@ describe('yii.validation', function () { {operator: '<', compareValue: '2', type: 'number'}, false ], + 'number type, ">=" operator, 2nd is lower': [ + 10, + {operator: '>=', compareValue: 2, type: 'number'}, + true + ], + 'number type, "<=" operator, 2nd is lower': [ + 10, + {operator: '<=', compareValue: 2, type: 'number'}, + false + ], + 'number type, ">" operator, 2nd is lower': [ + 10, + {operator: '>', compareValue: 2, type: 'number'}, + true + ], + 'number type, ">" operator, compare value undefined': [ + undefined, + {operator: '>', compareValue: 2, type: 'number'}, + false + ], + 'number type, "<" operator, compare value undefined': [ + undefined, + {operator: '<', compareValue: 2, type: 'number'}, + true + ], + 'number type, ">=" operator, compare value undefined': [ + undefined, + {operator: '>=', compareValue: 2, type: 'number'}, + false + ], + 'number type, "<=" operator, compare value undefined': [ + undefined, + {operator: '<=', compareValue: 2, type: 'number'}, + true + ], // default compare value 'default compare value, "===" operator, against undefined': [undefined, {operator: '==='}, true] }, function (value, options, expectValid) { diff --git a/tests/mssql/docker-compose.yml b/tests/mssql/docker-compose.yml index a68eb35982..69bc2f4d34 100644 --- a/tests/mssql/docker-compose.yml +++ b/tests/mssql/docker-compose.yml @@ -12,6 +12,8 @@ services: # Enable for debugging, Note: File-cache tests may be VERY slow or fail #volumes: # - ../../..:/project + volumes: + - ../../tests/data/config-docker.php:/project/tests/data/config.php depends_on: - mssql # Enable for debugging