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

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

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

Содержание

Содержимое этой страницы относится к среде IDE NetBeans 7.1

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

Программное обеспечение или материал Требуемая версия
Среда IDE NetBeans Пакет загрузки PHP
Система PHP, включая PEAR Версия 5.
Веб-сервер Рекомендуется использовать сервер HTTP Apache 2.2.
PHPUnit Версия 3.3.0 или выше.

Установка PHPUnit

Установите PHPUnit с помощью PEAR согласно указаниям в документации по PHPUnit. Следует установить версию PHPUnit 3.3.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 должен отобразиться в поле "Сценарий PHPUnit". Если сценарий не найден, выполните переход к нему вручную.

На странице "Параметры" отображается путь к сценарию PHPUnit

Создание и выполнение тестов 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;
        }
    }
    ?>
  2. Добавьте блок комментариев с аннотацией @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;
        }
    }
    ?>
  3. В окне "Проекты" правой кнопкой мыши щелкните узел Calculator.php и выберите команду "Сервис" > "Создать тесты PHPUnit". Обратите внимание на то, что тесты для всех файлов в проекте можно создавать в контекстном меню для узла "Исходные файлы".
    Контекстное меню для узла "Исходные файлы" проекта PHP, отображающее команду "Создать тесты PHPUnit"
  4. При первом создании тестов в диалоговом окне выводится вопрос о каталоге, в котором следует сохранить файлы тестов. В этом примере функция "Обзор" используется для создания папки tests.
    Диалоговое окно каталога файлов теста
  5. В среде IDE в файле с именем CalculatorTest.php создается базовый класс, который отображается в окне "Проекты" и открывается в редакторе.
    Окно "Проекты" с новым тестовым классом

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

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

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

    Окно "Вывод" с результатами теста

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

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

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

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

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

  1. В окне "Проекты" правой кнопкой мыши щелкните узел "Калькулятор" и выберите "Свойства". Откроется раздел "Свойства проекта".
  2. В разделе "Свойства проекта" выберите категорию PhpUnit. Выберите "Запрос групп тестирования перед выполнением тестов". Нажмите кнопку "ОК".
    Свойства проекта, категория PhpUnit, отображение активированных групп тестирования
  3. Откройте файл CalculatorTest.php в редакторе.
  4. Для методов testAdd, testAdd3 и testAdd5 добавьте аннотацию @group production.
    Код, демонстрирующий аннотацию группы тестирования
  5. Для методов testAdd2 и testAdd4 добавьте аннотации @group production и @group development. Код, демонстрирующий аннотации групп тестирования
  6. Правой кнопкой мыши щелкните узел Calculator.php и выберите "Тестировать". Откроется диалоговое окно выбора групп тестирования для выполнения. Выберите "разработка" и нажмите клавишу "ОК". Среда IDE выполняет только те тесты, которые имеют аннотацию @group development.
    Выберите диалоговое окно групп тестирования

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

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

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

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

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

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

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

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

Окно "Вывод" с полными результатами теста PHPUnit

Покрытие кода

Среда 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;
        }
    
    } 
    ?>
    
  2. Щелкните узел проекта правой кнопкой мыши. В контекстном меню выберите команду "Охват кода" > "Сбор и отображения охвата кода". По умолчанию панель "Отобразить панель редактора" также выбрана.
    Включение покрытия кода из контекстного меню узла проекта
  3. Панель покрытия кода теперь отображается в нижней части редактора. Поскольку тестирование покрытия кода еще не выполнялось, на панели редактора отображается значение покрытия, равное 0%. (Это значение также отображается при нажатии на кнопку "Очистить" для очистки результатов теста).
    Панель покрытия кода в редакторе перед выполнением тестов
  4. Выберите команду "Тестировать" для тестирования открытого файла или "Все тесты" для запуска всех тестов по проекту. Отобразится окно "Результаты теста". Кроме того, на панели "Покрытие кода" отобразится процент задействованных в тестах операторов исполняемого кода. Задействованный код в окне редактора выделяется зеленым цветом, а незадействованный код – красным цветом.

    Внимание!При повторном создании файлов теста ПОСЛЕ добавления функции add2 тесты PHPUnit выполняться не будут. Причиной этого является то, что PHPUnit создает две конфликтующие функции testAdd2. Не разграничивайте функции добавляемыми в конце номерами, если планируете использовать PHPUnit для нескольких подобных функций. См. документацию по PHPUnit.

    Панель редактора для покрытия кода после выполнения тестов
  5. На панели редактора щелкните элемент "Отчет...". Отобразится отчет "Покрытие кода", в котором будут показаны результаты всех тестов, выполненных для проекта. Кнопки в отчете позволяют очищать результаты, повторно выполнять тесты или отключать покрытие кода (нажмите кнопку "Готово").
    Отчет о покрытии кода
  6. Разработчик может добавить другой класс в проект, удалить и заново создать файлы теста, а также еще раз изучить отчет о покрытии кода. Будет показан новый класс. В следующем отчете класс Calculator снова содержит функцию, не включенную в тесты.
    Отчет о покрытии кода со вторым классом

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

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

  • файл начальной загрузки;
  • файл настройки в формате XML;
  • набор тестов.

Для выбора варианта настройки для отдельного проекта щелкните правой кнопкой мыши узел проекта или узел "Файлы тестов", а затем выберите пункт меню "Свойства". В результате откроется диалоговое окно "Свойства". Выберите в нем категорию "PHPUnit". Откроется диалоговое окно, в котором можно выбрать особый файл начальной загрузки, файл XML настройки или файл набора тестов. При отсутствии знаний о структуре этих файлов можно создать их скелеты средствами среды IDE NetBeans.

Выбор особых параметров PHPUnit в диалоговом окне свойств проекта

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

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

Если установлен особый набор тестов, он запускается при каждом выборе пункта меню "Выполнить > Тестирование проекта". Это особенно удобно, если требуется запустить только подмножество всех тестов, либо если требуется использовать недавно реализованные функции 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" и нажмите кнопку "Далее".
    Мастер "Создать файл" с выбранным файлом Selenium
  4. При первом создании теста Selenium будет открыто диалоговое окно, позволяющее установить каталог для файлов теста Selenium. Этот каталог должен отличаться от каталога файлов теста PHPUnit. В противном случае тесты Selenium будут запускаться при каждом запуске модульных тестов. Запуск функциональных тестов вида Selenium обычно занимает больше времени, чем запуск модульных тестов, поэтому их совместный запуск с модульными тестами скорее всего нежелателен.
  5. Примите параметры по умолчанию на странице "Имя и местоположение" и нажмите кнопку "Готово". Новый файл теста Selenium откроется в редакторе и появится в окне "Проекты".
    Окно "Проекты" с новым тестом Selenium
  6. Элемент "Выполнить тесты Selenium" добавлен в контекстное меню проекта. Щелкните этот элемент, и результаты теста Selenium отобразятся в окне "Результаты теста", как и для тестов PHPUnit.

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

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

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

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

Дополнительные материалы

Дополнительные сведения о тестировании PHP в среде IDE NetBeans приведены в следующих материалах:

Возврат к учебной карте по PHP

get support for the NetBeans

Support


By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2013, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo