Merge branch 'master' into end

githubjeka · githubjeka · commit 28530ddd221f · 2015-05-04T16:02:02.000+03:00
diff --git a/scripts/index.php b/scripts/index.php
@@ -25,7 +25,7 @@
         'file' => 'step-000.4.md',
     ],
     'step-1' => [
-        'title' => 'Тестирование',
+        'title' => 'Знакомство с тестированием',
         'file' => 'step-001.0.md',
     ],
     'step-1.1' => [
diff --git a/scripts/steps/step-001.0.md b/scripts/steps/step-001.0.md
@@ -1,11 +1,202 @@
-### Административное приложение Backend
+### Знакомство с тестированием
 
-В этом разделе добавим функциональности в backend приложение. Создадим место, где администратор сможет просматривать
-результаты опроса. Рассмотрим возможности ограничения доступа к тому или иному функционалу.
+Неотъемлемой частью разработки масштабного приложения служит тестирование тех или иных частей этого приложения.
+Есть даже методика разработки приложений, которая тесно связана с тестированием - разработка через тестирование. Возможно, 
+вы знакомы с ней как <a href="https://en.wikipedia.org/wiki/Test-driven_development" target="_blank">TDD</a>.
 
-Чтобы начать, выполните команду из директории yii2-tutorial:
+Разработчики и сообщество Yii приложило много усилий, чтобы можно было максимально просто покрыть тестами необходимый код.
 
+Раньше, например когда создавали форму опрос, приходилось открывать браузер, заполнять форму выдуманными данными, проверять
+результат. Добавляли успешный вывод сообщения, в виде результата - опять открывали форму, заполняли данными, проверяли 
+результат. Добавили, поведение к форме - опять проверяли, открывая форму и вводя данные. Сохраняли результат в базе данных - 
+приходилось смотреть сохранились ли данные корректно. Всё это наверное вам знакомо. Возможно, вам приходится такое проделывать,
+когда разрабатывается тот или иной функционал. А когда приложение становится масштабным, уже боязно вносить изменения
+в код. Так как далее приходится тратить много времени, чтобы пройтись по некоторым страницам сайта и проверить
+вручную всё ли работает как требуется. И часто, спустя несколько дней, кто-нибудь сообщает, что то что, когда-то работало,
+перестало работать. И опять тратиться время на выяснение причины неисправности, а так как изменения вносились несколько
+дней назад, то поиск истиной причины становится мукой. Или причина неисправности определяется неверно и в результате 
+добавляется "костыль", который исправляет проблему. 
+
+Может вы к этому привыкли и вас всё устраивает. Но что, если про это всё забыть и использовать всего лишь одну команду:
+
+```
+codecept run
+```
+
+Всё! Больше ничего. Запустив команду, после очередного изменения кода и не увидев ни одной ошибки в результатах, вы можете 
+со спокойной душой сообщить всем, что всё работает, как того требует техническое задание.
+
+В этой главе посмотрим, что скрывается под командой `codecept run`. Чтобы начать, выполните команду из 
+директории yii2-tutorial:
+
+```
+git checkout -f step-1.0
+```
+
+
+<p class="alert alert-info">Под Windows вместо стандартной командной строки cmd лучше использовать другой интерпретатор.
+Тот который использует подсветку кода, например <a href="http://gooseberrycreative.com/cmder/" target="_blank">Cmder</a>
+</p>
+
+#### Codeception
+
+Yii для тестирование кода предоставляет систему <a href="http://codeception.com/" target="_blank">Codeception</a>.
+Codeception основан на php фреймворке для тестирования <a href="https://phpunit.de/" target="_blank">PHPUnit</a>.
+Вся настройка Codeception сводится к следующим шагам:
+
+- создайте директорию `codecept`, где посчитаете нужным (не внутри учебника)
+- создайте в этой директории `composer.json`:
+```
+{
+    "require": {
+        "codeception/codeception": "*",
+        "codeception/verify": "*",
+        "codeception/specify": "*"
+    }
+}
+```
+- запустите команду `composer install` из этой директории
+- после установки всех зависимостей, настройте переменную 
+<a href="https://ru.wikipedia.org/wiki/PATH_%28%D0%BF%D0%B5%D1%80%D0%B5%D0%BC%D0%B5%D0%BD%D0%BD%D0%B0%D1%8F%29" target="_blank">
+PATH</a> на директории `codecept\vendor\bin\`, чтобы команда codecept была доступна из любого места.
+
+Теперь можно выполнить команду `codecept -V`, чтобы увидеть версию Codeception и убедиться, что он успешно установлен.
+
+#### Виды тестов
+
+Codeception поддерживает следующие виды тестов:
+
+- Модульные тесты (Unit), которые проверяют код, который выполняется в изоляции.
+- Функциональные тесты (Functional), которые проверяют код, через эмуляцию браузера.
+- Приёмочные тесты (Acceptance), которые проверяют код, через браузер.
+
+Все тесты располагаются в `\yii2-tutorial\yii2-app-advanced\tests\codeception`. Как и структура Advanced шаблона Yii, 
+тесты также разделены для гибкости на backend и frontend. Только настройки вынесены в отдельную директорию `config`.
+
+Кстати для некоторых тестов необходимо соединение с базой данных. Придётся извлекать, записывать данные, а иногда и удалять.
+Понятное дело, что основную базу лучше в этом случае не использовать. Нужна тестовая. Используя миграции, не составит труда
+создать копию основной базы данных.
+
+Поэтому в `yii2-app-advanced/tests/codeception/config/config.php` указана:
+
+```php
+'db' => [
+    'dsn' => 'sqlite:' . dirname(__FILE__) .'/../../sqlite-test.db',
+],
 ```
-git checkout -f step-0.3
+
+К этой базе данных применены все миграции, которые использовались и для основной. Чтобы это выполнить, понадобилось
+вызвать `php yii migrate` из `yii2-app-advanced/tests/codeception/bin`.
+
+Теперь вернёмся к структуре директорий. Открыв `yii2-app-advanced/tests/codeception/backend`, можно обнаружить
+
+```
+[_output]
+[acceptance]
+[functional]
+[unit]
+```
+
+`acceptance, functional, unit` директории, которые хранят тесты в зависимости от их видов. `_output` - это директория, в 
+которую будет попадать результат эмуляции браузера (html код страницы) для функциональных тестов, в случае ошибки.
+
+В Codeception есть понятие "Исполнители тестов". Из названия понятно, для чего они. Для того, чтобы их создать 
+необходимо произвести их инициализацию. В директории `tests/codeception/frontend` 
+необходимо выполнить `codecept build`. Создадутся файлы:
+
 ```
+yii2-app-advanced/tests/codeception/frontend/acceptance/AcceptanceTester.php
+yii2-app-advanced/tests/codeception/frontend/functional/FunctionalTester.php
+yii2-app-advanced/tests/codeception/frontend/unit/UnitTester.php
+```
+
+которые и будут являться исполнителями. В последствии, тоже самое нужно проделать и для backend части.
+
+#### Запуск тестов
+
+Можно попробовать для frontend запустить тесты. В `yii2-tutorial\yii2-app-advanced\tests\codeception\frontend\`
+запустим на выполнение все функциональные тесты:
+
+```php
+codecept run functional
+
+Time: 3 seconds, Memory: 29.25Mb
+OK (6 tests, 49 assertions)
+```
+
+Выполнив эту команду, вы наверное ничего и не почувствовали. Но обратите внимание на время выполнения - **3 секунды**.
+За эти три секунды `FunctionalTester` успел посетить страницу <a href="/yii2-app-advanced/frontend/web/index.php?r=site/about" target="_blank">
+о нас</a>, <a href="/yii2-app-advanced/frontend/web/index.php?r=site/contract" target="_blank">обратная связь</a>,
+<a href="/yii2-app-advanced/frontend/web/index.php?r=site/index" target="_blank">домашнюю страницу</a> и проверить
+что они работают без ошибок. В эти 3 секунды исполнитель побывал на 
+<a href="/yii2-app-advanced/frontend/web/index.php?r=site/signup" target="_blank">странице регистрации</a>,
+<a href="/yii2-app-advanced/frontend/web/index.php?r=site/login" target="_blank">аутентификации</a>, 
+и на <a href="/yii2-app-advanced/frontend/web/index.php?r=site/login" target="_blank">странице опроса</a>, проверил эти 
+формы, на корректность ввода данных. Исполнитель проверил работоспособность поведения accessOnce, которое было создано ранее.
+В сумме за три секунды исполнитель выполнил 6 тестов, в которых присутствовало 49 проверок. 
+
+Представьте сколько бы времени у вас ушло, если бы это выполняли самостоятельно через браузер. И запустив 
+
+```php
+codecept run functional
+```
+
+после очередного рефакторинга кода, можно с уверенностью сказать, корректно ли работает сайт. А не бродить по сайту в поисках
+"А не поломал ли я чего-нибудь?". В этом и есть одна из приятных особенностей тестирования.
+
+Также можно попробовать запустить модульные тесты:
+
+```php
+codecept run unit
+
+Time: 8.29 seconds, Memory: 17.00Mb
+OK (9 tests, 25 assertions)
+```
+
+А вот для приёмочных, вы обнаружите ошибки.
+
+```php
+codecept run acceptance
+
+FAILURES!
+Tests: 5, Assertions: 0, Errors: 5.
+```
+
+Всё дело в том, что для работы приёмочных тестов нужен браузер. Окружение для Codeception в Yii настроено таким образом,
+что используется <a href="http://codeception.com/docs/modules/PhpBrowser" target="_blank">PhpBrowser</a>. 
+
+```
+// Файл yii2-app-advanced/tests/codeception/frontend/acceptance.suite.yml
+modules:
+    enabled:
+        - PhpBrowser
+        - tests\codeception\common\_support\FixtureHelper
+    config:
+        PhpBrowser:
+            url: http://localhost:8080
+```
+
+Т.е. настраивать ничего не нужно, остаётся изменить только путь к нашему сайту с http://localhost:8080 на 
+http://localhost:8888/yii2-app-advanced/. Сделайте это.
+ 
+Вместо PhpBrowser может быть выбран любой другой браузер (Chrome, FF, IE или другой) под управлением специального 
+веб-драйвера, например <a href="http://www.seleniumhq.org/" target="_blank">Selenium</a>. Смена PhpBrowser браузера 
+позволит тестировать поведения в браузере, связанные с javascripts.
+
+А сейчас, когда PhpBrowser настроен, можно пробовать запускать и приёмочные тесты.
+
+Запуск отдельных тестов, сокращает время ожидания выполнения. Codeception поддерживает: запуск всех тестов, 
+запуск тестов по видам и запуск отдельных тестов. Например, для `yii2-app-advanced/tests/codeception/frontend` можно 
+выполнить:
+
+```
+codecept run
+codecept run functional
+codecept run functional functional\InterviewCept.php 
+```
+
+#### Дополнительная информация для самостоятельного ознакомления:
 
+- <a href="https://ru.wikipedia.org/wiki/%D0%AD%D0%BA%D1%81%D1%82%D1%80%D0%B5%D0%BC%D0%B0%D0%BB%D1%8C%D0%BD%D0%BE%D0%B5_%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5" target="_blank">Экстремальное программирование</a>.
+- <a href="http://codeception.com/docs/01-Introduction" target="_blank">Руководство по Codeception</a>.
+- <a href="https://phpunit.de/manual/current/en/index.html" target="_blank">Руководство по PHPUnit</a>.
