PHP Selenium 自动化测试 - 起始设定

当你在开发一个大型的专案时，往往会因为需求复杂，或是年代久远，没有人记得当初某些功能是怎么完成的，而造成新人不敢修改，老人一改就把旧功能改坏掉，一个好的自动化测试工具在这种状态就非常的重要，除了程式必需撰写的 Unit test 之外 ，通常我们还要加上 E2E 测试，例如使用 Selenium。

Selenium 是一个用来模拟真人的自动化测试工具，它可以操作网页浏览器，自动连结网页，输入资料，然后自动点击 Form Post 按钮等等各种强大的功能，另外他们支援多个浏览器，能够帮前端工程师抓到 CSS/JS Error。

Selenium 是 Server 端的工具，另外我们还必需使用一个 Client 端来传送指令给 Selenium ，这个工具我们统称为 WebDriver。

如何使用 Selenium 与 WebDriver

接下来我会一步一步教你如何安装 Selenium ，并且写一段简单的 PHP 来进行测试。

安装 Java

Selenium 是用 Java 写成的，所以你一定要在你的作业系统中安装 Java，请先至下面这个 Java 官网下载 Java 并安装。

• https://www.java.com/zh_TW/download/help/windows_manual_download.xml

启动 Seleniun

首先我们得先下载 Selenium 这套软体，你可以从这个网址下载 http://docs.seleniumhq.org/download/ ，下载回来是一个 Java Jar 档，启动的指令如： java -jar selenium-server-standalone-2.39.0.jar。

另一个下载点 http://selenium-release.storage.googleapis.com/index.html

成功启动 Selenium 后，你可以使用 telnet localhost 4444 , 或是打开 Browser 连上这个网址 http://127.0.0.1:4444/wd/hub ，Selenium 预设会使用 4444 Port 来接收指令，如果你看到的画面如下，就代表 Selenium 已经启动成功!

Facebook WebDriver

WebDriver 就是一个用来控制 Selenium 动作的 Library ，称之为 Driver 因为他就像网卡一样，网卡是用来控制网路传输，而 WebDriver 是用来控制 Selenium，这里我使用的 WebDriver 是从 Facebook Git 上抓来下的，你可以在 https://github.com/facebook/php-webdriver 这里下载得到。

接著我们写一小段程式，呼叫 Selenium 打开 Firefox Browser 并且连上 Google 首页

<?php
require_once "./php-webdriver/lib/__init__.php";
$capabilities = array(
    WebDriverCapabilityType::BROWSER_NAME => 'firefox'
);
$seleniumUrl = 'http://localhost:4444/wd/hub';
$driver = RemoteWebDriver::create($seleniumUrl, $capabilities, 5000);
$driver->get("http://www.google.com.tw/");
sleep(5);
$driver->close();

程式有正确执行的话，你应该会看到你的电脑打开了 Firefox ，并连上Google 首面 ，我有故意在程式中加上 sleep 5 秒，这是怕 selenium 一执行完毕，就会自动关闭 Browser ，这样会来不及确认是否有连到 Google。

"capabilities" 这个参数是用来指定基本设定，例如上面的范例中我指定了 Browser = firefox 。

自动打动网页，并点击连结的范例

这是稍复杂一点的范例，功能是连上我开发好的页面，并且点击一个连结，然后等待 Browser 载入页面完成后，再继续执行接下来的指令。

$capabilities = array(WebDriverCapabilityType::BROWSER_NAME => 'firefox');
$seleniumUrl = 'http://localhost:4444/wd/hub';
$host = "http://www.puritys.me";
 
$driver = RemoteWebDriver::create($seleniumUrl, $capabilities, 5000);
 
$driver->get($host . "/docs-blog/article-49");
 
$url = $driver->getCurrentUrl();
error_log( "url = " . $url);
//change url and wait
$elm = $driver->findElement(
  WebDriverBy::cssSelector('.nav-box a:nth-of-type(1)')
);
 
$elm->click();
// wait for at most 10 seconds until the URL is 'http://example.com/'.
// check again 500ms after the previous attempt.
$driver->wait(10, 500)->until(function ($driver) {
    if ($driver->getCurrentURL() === 'http://www.puritys.me/news') {
        error_log("Document is complete");
        return true;
    } else {
        return false;
    }
});
 
error_log("test");
$driver->close();

设定视窗的尺寸，长宽

$driver = RemoteWebDriver::create($seleniumUrl, $capabilities, 5000);
$manage = $driver->manage();
 
$window = $manage->window();
$dimension = $window->getSize();
 
$height = $dimension->getHeight(); //取得视窗的高 
$width = $dimension->getWidth(); //取得视窗的宽
 
$newSize = new WebDriverDimension(100,200); // 设定视窗的宽高  = 100x200
$window->setSize($newSize);

如何将视窗最大化

平常我们在使用 Selenium 时，最好都将 Window 视窗调成最大化，避免 Selenium 因为 Element 不在画面上而选不到，最大化的方式很简单，使用 maximize 即可。

$manage = $driver->manage();
$window = $manage->window();
$window->maximize();

取得视窗位置与移动

$position = $window->getPosition();
echo  $position->getX();
echo  $position->getY();
 
//移动视窗
$position->move(200, 0);
$window->setPosition($position);

Selenium Protocol

• https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol

WebDriver 不管开发者是谁，功能如何强力，他的 Server 一定还是 Selenium ，所以你只要了解 Selenium 所支援的功能，就能猜出 WebDriver 大概要怎么使用了，也可以知道 Selenium 所支援的 API 有哪一些。

其它相关

driver 能够使用的 method ，可以在 php-webdriver/lib/remote/RemoteWebDriver.php 中找到，例如 findElement 这个 Method 。

• https://github.com/facebook/php-webdriver/blob/master/lib/remote/RemoteWebDriver.php

下面这个连结是 Selenium 如何操作 Browser 的 source code ，有一大部分的程式是用 JavaScript 写成的，可以看这边的程式，去了解 selenium 的实作方式。

• https://github.com/SeleniumHQ/selenium/

相关文件

• http://phpunit.de/manual/3.7/en/selenium.html
• http://phptest.club/