Тестирование с помощью PHPUnit и Selenium

This tutorial needs a review. You can edit it in GitHub following these contribution guidelines.

IDE NetBeans для PHP поддерживает автоматические тесты PHPUnit. За счет PHPUnit, IDE NetBeans обеспечивает покрытие кода для PHP, схожее с покрытием кода, обеспечиваемым IDE для Python. Вывод теста отображается в том же окне вывода, имеющем множество функций, которое используется средствами запуска тестов JUnit и Python среды IDE.

IDE NetBeans также поддерживает переносимую платформу тестирования Selenium в сочетании с PHPUnit. Подключаемый модуль Selenium доступен из центра обновления. При установке этот подключаемый модуль добавляет сервер Selenium к зарегистрированным серверам среды IDE, а также добавляет параметры тестирования Selenium к меню PHP.

Для работы с этим учебным курсом требуется следующее программное обеспечение и ресурсы.

Программное обеспечение или материал Требуемая версия

IDE NetBeans

Пакет загрузки PHP

Система PHP, включая PEAR

Версия 5.

Веб-сервер

Рекомендуется использовать HTTP-сервер Apache 2.2.

PHPUnit

Версия 3.4.0 и более поздние.

Генератор схемы PHPUnit

Версия PHPUnit.

Установка PHPUnit

Используйте PEAR для установки PHPUnit, как описано в документации по PHPUnit и генератор схемы PHPUnit, как описано в документации по генератору схемы. Следует установить версию PHPUnit 3.4.0 или выше. Специальная настройка не требуется. После установки PHPUnit среда NetBeans сможет распознать это средство тестирования. Обратите внимание на то, что вместе с механизмом PHP должен быть установлен PEAR. Также следует учитывать, что согласно документации по PHPUnit это средство тестирования обычно устанавливается в локальный каталог PEAR. В документации указывается путь /usr/lib/php/PHPUnit , однако в XAMPP для Windows используется путь XAMPP_HOME\php\PEAR\PHPUnit .

Чтобы проверить, распознает ли среда IDE NetBeans установочный комплект PHPUnit, откройте "Сервис" > "Параметры" (в ОС Mac откройте "Параметры NetBeans") и просмотрите окно "PHP". Откройте вкладку "Модульное тестирование". Должны отобразиться пути к сценариям PHPUnit и генератору схемы. Если сценарий отсутствует, щелкните 'Поиск' рядом с пустым полем. IDE выполнит поиск сценария в локальной системе. В качестве альтернативы можно нажать кнопку "Обзор" и выполнить поиск сценария.

unittesting options

Создание и выполнение тестов PHPUnit

В IDE NetBeans поддерживается создания и запуск тестов PHPUnit во всех классах PHP в файле. Для обеспечения работы генератора тестов дайте файлу PHP имя, идентичное имени первого класса файла.

Создание и выполнение тестов PHPUnit для класса:

  1. Создайте проект PHP с именем "Calculator". В этом проекте создайте файл с именем calculator.php . Введите или вставьте в этот файл класс Calculator из раздела "Skeleton Generator" документации PHPUnit.

<?php
class Calculator
{
    public function add($a, $b)
    {
        return $a + $b;
    }
}
?>
  1. Добавьте блок комментариев с аннотацией @assert, а также пример входных и выходных данных. Обратите внимание – в этот пример включено одно неверное подтверждение.

<?php
class Calculator
{
    /**
     * @assert (0, 0) == 0
     * @assert (0, 1) == 1
     * @assert (1, 0) == 1
     * @assert (1, 1) == 2
     * @assert (1, 2) == 4
     */
    public function add($a, $b)
    {
        return $a + $b;
    }
}
?>
Можно использовать завершение кода аннотаций для добавления аннотаций @assert. Для перемещения между параметрами используйте клавишу табуляции, или нажмите Enter после ввода значения параметра.
]image::images/assert-cc-complete.png[
  1. В окне "Проекты" правой кнопкой мыши щелкните узел Calculator.php и выберите команду "Сервис" > "Создать тесты PHPUnit". Обратите внимание на то, что тесты для всех файлов в проекте можно создавать в контекстном меню для узла "Исходные файлы".

create tests
  1. При первом создании тестов в диалоговом окне выводится вопрос о каталоге, в котором следует сохранить файлы тестов. В этом примере функция "Обзор" используется для создания папки tests .

test directory
Пользователи могут написать для проекта несколько тестов вручную. Если создано несколько тестов, вы можете отсортировать их в подпапки каталога файлов тестов, такие как "Важные" или "Быстрые". Тесты можно запустить во вложенной папке, щелкнув правой кнопкой мыши эту папку и выбрав 'Выполнить тесты'.
test in folder
  1. В среде IDE в файле с именем CalculatorTest.php создается базовый класс, который отображается в окне "Проекты" и открывается в редакторе.

test class in project

Обратите внимание на то, что тест создается для каждой аннотации @assert .

    /**
     * Generated from @assert (1, 1) == 2.
     */
    public function testAdd4()
    {
        $this->assertEquals(
          2,
          $this->object->add(1, 1)
        );
    }
  1. Можно выполнить тестирование отдельного файла или целого проекта. Для тестирования проекта щелкните правой кнопкой мыши родительский узел проекта и выберите команду "Тестировать" или нажмите сочетание клавиш ALT+F6. Для тестирования файла Calculator.php щелкните правой кнопкой узел файла и выберите 'Тестировать' или нажмите Ctrl-F6/⌘-F6. В этом примере существует только один класс в одном файле, так что результаты являются идентичными. Среда IDE выполняет тесты и отображает результаты в окне "Результаты теста".

test results narrow

Более подробная текстовая версия результатов отображается в окне "Вывод".

test result output

Использование групп тестирования

Можно выбрать, какие группы тестирования будут выполняться при запуске набора тестов. Например, некоторые тесты могут выполняться только в производственной среде, а другие — как в производственной среде, так и в среде разработки. Тесты первого вида вы поместите в группу production , а второго — в группы production и development . При запуске набора тестов в среде разработки вы выбираете для выполнения только группу тестирования development .

Необходимо активировать группы тестирования для проекта PHP до использования этих групп на каком-либо из файлов данного проекта.

Чтобы отметить тест в качестве части группы тестирования, добавьте к методу теста аннотацию @group [group name] .

Создание и выполнение групп тестирования.

  1. В окне "Проекты" правой кнопкой мыши щелкните узел "Калькулятор" и выберите "Свойства". Откроется раздел "Свойства проекта".

  2. В разделе "Свойства проекта" выберите категорию PhpUnit. Выберите "Запрос групп тестирования перед выполнением тестов". Нажмите кнопку "ОК".

test group properties
  1. Откройте файл CalculatorTest.php в редакторе.

  2. Для методов testAdd , testAdd3 и testAdd5 добавьте аннотацию @group production .

production group annotation
  1. Для методов testAdd2 и testAdd4 добавьте аннотации @group production и @group development . production development group code

  2. Правой кнопкой мыши щелкните узел Calculator.php и выберите "Тестировать". Откроется диалоговое окно выбора групп тестирования для выполнения. Выберите "разработка" и нажмите клавишу "ОК". Среда IDE выполняет только те тесты, которые имеют аннотацию @group development .

select test group

Дополнительные сведения о группах тестов PhpUnit в IDE NetBeans см. IDE NetBeans для публикации в блоге Использование групп тестов единиц PHP.

Результаты теста и вывод среды IDE

Результаты тестов PHPUnit отображаются в двух окнах среды IDE – "Результаты теста" и "Вывод". Окно "Результаты теста" имеет графическую панель и краткую текстовую панель. Окно "Вывод" предоставляет более подробную текстовую версию выходных данных. В этом разделе окна "Результаты теста" и "Вывод" рассматриваются более подробно.

В окне "Результаты теста" отображаются сведения о тестах со сбоями из следующих местоположений:

  • Сообщения на панели пользовательского интерфейса, связанные с записью дерева для теста со сбоем

  • Текст правой панели со ссылками на строки кода теста со сбоем

  • Текст всплывающей подсказки, отображающийся при наведении курсора на тест со сбоем в панели пользовательского интерфейса

test results tooltip

На левой стороне окна "Результаты теста" расположены следующие кнопки:

  • Повторное выполнение теста rerun button;

  • Показать неуспешные тесты show failed

  • Показать успешные тесты show passed

  • Показать завершенные тесты, содержащие ошибки show error

  • Переход между отображением следующего результата теста next test button или предыдущего результата теста previous test button.

В окне "Вывод" отображаются все выходные данные сценария PHPUnit. Использование этой функции целесообразно, если причину ошибки невозможно установить с помощью информации в окне "Результаты теста". Как и окно "Результаты теста", окно "Вывод" содержит ссылки на строку класса теста с ошибкой. Также включает в себя кнопки на левой стороне для повторного выполнения теста и для открытия окна параметров PHP.options link button

test result output

Охват кода

IDE NetBeans для PHP обеспечивает покрытие кода вместе с поддержкой PHPUnit. (Среда IDE также предлагает покрытие кода для Python). Функция покрытия кода проверяет, все ли используемые методы покрываются тестами PHPUnit. В этом разделе мы увидим, как работает покрытие кода для существующего класса Calculator.

Использование функции покрытия кода:

  1. Откройте Calculator.php и добавьте дубликат функции add с именем add2 . При этом класс Calculator должен выглядеть примерно таким образом:

<?php
class Calculator {
    /**
     * @assert (0, 0) == 0
     * @assert (0, 1) == 1
     * @assert (1, 0) == 1
     * @assert (1, 1) == 2
     * @assert (1, 2) == 4
     */
    public function add($a, $b) {
        return $a + $b;
    }

    public function add2($a, $b) {
        return $a + $b;
    }

}
?>
  1. Щелкните узел проекта правой кнопкой мыши. В контекстном меню выберите команду "Охват кода" > "Сбор и отображения охвата кода". По умолчанию панель "Отобразить панель редактора" также выбрана.

turn on code coverage
  1. Панель покрытия кода теперь отображается в нижней части редактора. Поскольку тестирование покрытия кода еще не выполнялось, на панели редактора отображается значение покрытия, равное 0%. (Это значение также отображается при нажатии на кнопку "Очистить" для очистки результатов теста).

editor bar before
  1. Выберите команду "Тестировать" для тестирования открытого файла или "Все тесты" для запуска всех тестов по проекту. Отобразится окно "Результаты теста". Кроме того, на панели "Покрытие кода" отобразится процент задействованных в тестах операторов исполняемого кода. Задействованный код в окне редактора выделяется зеленым цветом, а незадействованный код – красным цветом.

При повторном создании файлов теста ПОСЛЕ добавления функции add2 тесты PHPUnit выполняться не будут. Причиной этого является то, что PHPUnit создает две конфликтующие функции testAdd2. Не разграничивайте функции добавляемыми в конце номерами, если планируете использовать PHPUnit для нескольких подобных функций. См. документацию по PHPUnit.
editor bar after
  1. На панели редактора щелкните элемент "Отчет…​". Отобразится отчет "Покрытие кода", в котором будут показаны результаты всех тестов, выполненных для проекта. Кнопки в отчете позволяют очищать результаты, повторно выполнять тесты или отключать покрытие кода (нажмите кнопку "Готово").

code coverage report
  1. Разработчик может добавить другой класс в проект, удалить и заново создать файлы теста, а также еще раз изучить отчет о покрытии кода. Будет показан новый класс. В следующем отчете класс Calculator снова содержит функцию, не включенную в тесты.

code coverage report2

Использование вариантов настройки для отдельных проектов

В среде IDE для проекта можно выбрать следующие особые варианты настройки:

  • файл начальной загрузки;

  • файл настройки в формате XML;

  • набор тестов.

  • Пользовательский сценарий PHPUnit

Настройка конфигурации, связанной с проектом.

  1. Щелкните правой кнопкой мыши узел проекта или узел проекта "Файлы тестов", а затем выберите пункт меню "Свойства". В результате откроется диалоговое окно "Свойства".

project ctxmenu
  1. Выберите в нем категорию "PHPUnit". Откроется диалоговое окно, в котором можно выбрать особый файл начальной загрузки, конфигурацию XML, сценарий PHPUnit или файл набора тестов.

proj properties
  1. Пользователи, не знакомые со структурой начальной нагрузки или файлами конфигурации XML можно использовать IDE NetBeans для создания основы. Инструкции по использованию диалогового доступны при выборе 'Справка'.

proj properties selected

Вариант начальной загрузки требуется для проектов, в которых используется собственный загрузчик классов, например, посредством реализации магической функции __autoload() . Вариант начальной загрузки используется также при необходимости включения файла, содержащего, например, глобальные константы, которые используются несколькими классами в проекте, в будущем.

Файл XML настройки позволяет определить параметры, используемые в вызове из командной строки. В руководстве по PHPUnit имеется полное введение. С помощью файла XML настройки также можно определить параметры php.ini и глобальные переменные для тестов. Параметр начальной загрузки может быть указан и в файле XML настройки.

Если установлен особый набор тестов, он запускается при каждом выборе пункта меню "Выполнить > Тестирование проекта". Это особенно удобно, если требуется запустить только подмножество всех тестов, либо если требуется использовать недавно реализованные функции PHPUnit, которые необходимо добавлять вручную, например источники данных. Следует отметить, что существует возможность создавать любое количество наборов тестов и запускать их по отдельности; для этого нужно щелкнуть файл в проводнике проектов и выбрать пункт меню "Выполнить". Во избежание недоразумений при использовании особого набора тестов выдается предупреждение. Это предупреждение выводится в окне "Результаты теста" и в окне вывода.

_Пользовательский сценарий PHPUnit _ можно использовать для проекта, вместо сценария по умолчанию, выбранного в 'Сервис' > 'Параметры'. Пользовательский сценарий PHPUnit может включать в себя любые переключатели командной строки, описанные в руководстве по PHPUnit.

 

Запуск тестов на платформе Selenium

Selenium – это переносимая платформа тестирования программного обеспечения для веб-приложений. Тесты могут быть созданы в виде таблиц HTML или написаны с помощью различных популярных языков программирования. Тесты запускаются напрямую в большинстве современных браузеров. Selenium может развертываться в системах Windows, Linux и Macintosh. Дополнительные сведения приведены на веб-сайте Selenium.

В IDE NetBeans имеется подключаемый модуль, включающий сервер Selenium. Этот подключаемый модуль позволяет выполнять тесты Selenium в PHP, веб-приложениях или проектах Maven. Чтобы запустить тесты Selenium в PHP, следует установить пакет Testing Selenium в системе PHP.

Запуск тестов Selenium в PHP:

  1. Откройте командную строку и запустите команду pear install Testing_Selenium-beta . PHP_HOME/php/PEAR должен быть добавлен к пути. Если команда выполнена успешно, то командная строка отобразит текст install ok: channel://pear.php.net/Testing_Selenium-0.4.3 .

  2. В среде IDE откройте меню "Сервис" > "Подключаемые модули" и установите модуль Selenium для PHP.

  3. В окне "Проекты" правой кнопкой мыши щелкните узел проекта для проекта Calculator. Выберите команду "Создать" > "Прочие". Откроется мастер создания файла. Выберите параметр "Selenium" и нажмите кнопку "Далее".

new selenium
  1. При первом создании теста Selenium будет открыто диалоговое окно, позволяющее установить каталог для файлов теста Selenium. Этот каталог должен отличаться от каталога файлов теста PHPUnit. В противном случае тесты Selenium будут запускаться при каждом запуске модульных тестов. Запуск функциональных тестов вида Selenium обычно занимает больше времени, чем запуск модульных тестов, поэтому их совместный запуск с модульными тестами скорее всего нежелателен.

  2. Примите параметры по умолчанию на странице "Имя и местоположение" и нажмите кнопку "Готово". Новый файл теста Selenium откроется в редакторе и появится в окне "Проекты".

selenium test in project
  1. Элемент "Выполнить тесты Selenium" добавлен в контекстное меню проекта. Щелкните этот элемент, и результаты теста Selenium отобразятся в окне "Результаты теста", как и для тестов PHPUnit.

Дополнительные упражнения

Ниже приведены дополнительные мысли для исследования:

  • Добавьте второй класс к Calculator.php, такой как класс Calculator2 , выполняющий умножение $a на $b. Удаление и восстановление тестов.

  • При работе с учебным курсом по созданию приложения CRUD, состоящего из нескольких частей, создайте тест Selenium для итогового проекта. link:/about/contact_form.html?to=3&subject=Feedback:PHPUnit and Selenium on NB 6.7[Отправить отзыв по этому учебному курсу]

Для отправки комментариев и предложений, получения поддержки и новостей о последних разработках, связанных с PHP IDE NetBeans присоединяйтесь к списку рассылки users@php.netbeans.org. Зеркало этого списка находится на форумах IDE NetBeans.

Дополнительные сведения