Selenium × PHP でテスト自動化！【環境構築編】
はじめに
みなさんこんにちは、プロダクト開発本部の亀梨です。
普段はXmediaOneというメディアプランニング・広告運用管理・トラッキング・マーケティング分析を行う
統合プラットフォームの開発を担当しています。
テスト自動化の背景
わたくしが担当するXmediaOneでは品質担保のために①コードベース（ScalaTest）の単体テスト②人力での端末操作の単体テスト・シナリオテストを行っていますが、高い品質を維持しようとすると②の工数・負荷が高くなり日々の業務を圧迫しています。
そこで、Seleniumを使ってテスト自動化することで工数削減→さらなる品質強化のためにテストカバレッジ向上をしていこうということになりました。
今回はSelenium導入にあたっての環境構築の手順を紹介したいと思います。
PCはMacでPHPプリインストール済みであることを前提としています。
環境構築の手順
それではさっそく始めていきましょー。
0. テストを実行するディレクトリを作成する
適当なディレクトリを作ります。
|
1 2 |
$ mkdir selenium $ cd selenium |
1. selenium-serverのインストール
Homebrew経由でインストール
|
1 2 3 4 5 6 7 8 9 10 |
$ brew install selenium-server-standalone ==> Downloading https://selenium-release.storage.googleapis.com/3.11/selenium-server-standalone-3.11.0.jar ######################################################################## 100.0% ==> Caveats To have launchd start selenium-server-standalone now and restart at login: brew services start selenium-server-standalone Or, if you don't want/need a background service you can just run: selenium-server -port 4444 ==> Summary 🍺 /usr/local/Cellar/selenium-server-standalone/3.11.0: 5 files, 22.3MB, built in 4 seconds |
2. 各ブラウザ用ドライバのインストール
SeleniumServer標準ではSafariに対応済み それ以外(ChromeとかFirefox)にはドライバが必要
Selenium Google Chrome Driver
ChromeDriver – WebDriver for Chrome
downloads zip file
Selenium Firefox Driver
ここから最新版をダウンロードする。
本記事執筆時点だとv0.20.1の「 geckodriver-v0.20.1-macos.tar.gz」をダウンロード。
ダウンロードしたらファイルを解凍する。
|
1 |
$ tar zxvf geckodriver-v0.20.1-macos.tar.gz |
各ドライバをダウンロードしたらファイルを移動
ダウンロードしたドライバをカレントディレクトリに移動する
|
1 2 3 4 5 6 7 8 |
$ mv /Users/username/Downloads/chromedriver ./ $ mv /Users/username/Downloads/geckodriver ./ $ ls -la total 31920 drwxr-xr-x 7 username staff 238 5 24 17:42 . drwxr-xr-x+ 55 username staff 1870 5 24 17:42 .. -rwxr-xr-x@ 1 username staff 11917200 4 20 16:39 chromedriver -rwxr-xr-x@ 1 username staff 4404680 4 8 21:44 geckodriver |
3. PHPでWebブラウザを操作するために必要なライブラリ「facebook-webdriver」のダウンロード
Composerのダウンロード
ComposerはPHPのパッケージ管理ツールです。
|
1 2 3 4 5 6 |
$ curl -sS https://getcomposer.org/installer | php All settings correct for using Composer Downloading... Composer (version 1.6.5) successfully installed to: /Users/kamenashikou/selenium/composer.phar Use it: php composer.phar |
facebook-webdriverのインストール
Facebookさんが作ってくれたツールです。少し時間がかかります。
|
1 2 3 4 5 6 7 8 9 10 11 |
$ php composer.phar require facebook/webdriver Using version ^1.6 for facebook/webdriver ./composer.json has been created Loading composer repositories with package information Updating dependencies (including require-dev) Package operations: 2 installs, 0 updates, 0 removals - Installing symfony/process (v4.1.1): Downloading (100%) - Installing facebook/webdriver (1.6.0): Downloading (100%) facebook/webdriver suggests installing ext-SimpleXML (For Firefox profile creation) Writing lock file Generating autoload files |
4. ここでディレクトリ構成を確認
以下のようになっていれば成功です。
|
1 2 3 4 5 6 7 8 9 10 |
$ ls -la total 38368 drwxr-xr-x 8 username staff 272 7 5 09:49 . drwxr-xr-x+ 95 username staff 3230 7 5 09:35 .. -rwxr-xr-x@ 1 username staff 12093844 6 7 13:25 chromedriver -rw-r--r-- 1 username staff 64 7 5 09:49 composer.json -rw-r--r-- 1 username staff 4447 7 5 09:49 composer.lock -rwxr-xr-x 1 username staff 1849094 7 5 09:48 composer.phar -rwxr-xr-x@ 1 username staff 5685072 6 16 05:56 geckodriver drwxr-xr-x 6 username staff 204 7 5 09:49 vendor |
5. Selenium Server の起動
バックグラウンドで起動
以下コマンドを実行します。
|
1 2 3 4 5 6 7 |
$ selenium-server -port 4444 & [1] 33415 C02SY1XFGTFJ:selenium username$ 18:04:14.512 INFO [GridLauncherV3.launch] - Selenium build info: version: '3.11.0', revision: 'e59cfb3' 18:04:14.513 INFO [GridLauncherV3$1.launch] - Launching a standalone Selenium Server on port 4444 2018-05-24 18:04:14.624:INFO::main: Logging initialized @441ms to org.seleniumhq.jetty9.util.log.StdErrLog 18:04:14.882 INFO [SeleniumServer.boot] - Welcome to Selenium for Workgroups.... 18:04:14.882 INFO [SeleniumServer.boot] - Selenium Server is up and running on port 4444 |
ctrl + c でコマンドプロンプトに戻ったら、jobsコマンドを実行するとバックグラウンドでselenium serverが起動しているのが確認できます。
|
1 2 |
$ jobs [1]+ Running selenium-server -port 4444 & |
はい、これで環境構築は完了です。
それでは早速テストコードを実行してみましょう
実際に動作するかを以下のテストコードで試してみましょう。
|
1 |
$ vim test.php |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
<?php require_once './vendor/autoload.php'; use Facebook\WebDriver\Remote\RemoteWebDriver; use Facebook\WebDriver\Remote\DesiredCapabilities; use Facebook\WebDriver\WebDriverExpectedCondition; use Facebook\WebDriver\WebDriverBy; // テスト実行 sample(); /** * selenium facebook-webdriver 実行のサンプル */ function sample() { // selenium $host = 'http://localhost:4444/wd/hub'; // chrome ドライバーの起動 $driver = RemoteWebDriver::create($host,DesiredCapabilities::chrome()); // 指定URLへ遷移 (Google) $driver->get('https://www.google.co.jp/'); // スクリーンショットを撮って保存する $file = __DIR__ . '/' . __METHOD__ . ".png"; $driver->takeScreenshot($file); // ブラウザを閉じる $driver->close(); } |
では実行してみましょう。
はい、無事に実行できてスクリーンショット画像も保存されていますね。テスト実行は終了です。
最後に、Seleniumサーバーを必ず終了させましょう。
|
1 2 3 4 5 |
$ jobs [1]+ Running selenium-server -port 4444 & (wd: ~/selenium) $ kill %1 $ jobs [1]+ Exit 143 selenium-server -port 4444 (wd: ~/selenium) |
以上、環境構築でした
これで準備は整いましたので、これからテストケースをじゃんじゃん書いていきたいと思います。
テストコードの知見が貯まってきたらまた投稿したいと思います。それではまたー。
関連記事
-
-
Burpの使い方！
こんにちは、第二ソリューション開発部の谷口です。 受託開発の部署で開発を担当してます。 APIを扱う機会が多く、今回は通信内容を確認するためのローカルプロキシツール「Burp」について書かせて頂きます。 Burpとは Webアプリケーション開発時の検証において、Webサーバとブラウザ間の通信内容を確 …
-
-
AWSにRailsアプリをデプロイする(準備編)
今回は、せっかくRailsで開発したアプリをAWS上に公開してみたいので その構築方法をまとめていきたいと思います。 (前回の記事：初心者がRailsで開発 – deviseでユーザー認証設定 ) AWSの設定はすでに社内で使用できるようになっていたので割愛します。 ★やりたいこと Gitlabでコ …
-
-
自社サービスのDocker化(前編)
こんにちは。 インフラ開発部の上田です。 普段は自社開発システムのインフラ担当として、日々頑張って仕事をしています。 今回は、近年話題になっているDockerについて、取り上げてみようと思います！ なぜDockerなのか・・・？ そもそもDockerとは何か・・・？ 当社では様々なサー …
-
-
【未経験からのRuby on Rails – 第１回】楽しく書けるプログラミング言語 “Ruby” とは
こんにちは、はじめまして。新卒１年目のmatsuari（女子）です。 この度、Rubyの勉強を始めることになりまして、 まずはたくさんあるプログラミング言語の中で、なぜ自分がRubyを学ぶのか？ しっかりと把握した上で学習に取り組んでいきたいと考え、『Rubyとは何か？』調べました。 超基礎的なこと …
-
-
D3.jsとその活用事例について
D3.jsとは？ D3とは「Data Driven Document」の略で、データに基づいてドキュメントを操作するための JavaScript ライブラリです。 ご存知の方も多いと思いますが、ちょっとだけD3.jsの基本的な使い方、そして弊社プラットフォームでの利用についてご紹介したいと思います。 …
-
-
【HTML5】4ツール出力ファイルサイズ比較
こんにちは、近江です。 前回もHTML5のSwiffyについて書かせて頂きましたが、まだまだHTML5について調査しています。 今回はSwiffyを含めた4つのHTML5系ツールで、同じ素材で同じアニメーションを作成した時のファイルサイズを比較したいと思います。 何故ファイルサイズの比較をするかと言 …
-
-
最強のSQLクライアント（GUIツール）「TeamSQL」を使ってみた！
はじめに みなさんこんにちは、プロダクト開発本部の亀梨です。 普段はXmediaOneというメディアプランニング・広告運用管理・トラッキング・マーケティング分析を行う 統合プラットフォームの開発を担当しています。 エンジニアの皆さん、SQLクライアント（GUIツール）って何使ってます？ わたくしはこ …
-
-
【クラウド初心者向け】Google Cloud Platform（GCP）でWebサイトを公開してみよう！
はじめに みなさんこんにちは、プロダクト開発本部の亀梨です。 普段はXmediaOneというメディアプランニング・広告運用管理・トラッキング・マーケティング分析を行う 統合プラットフォームの開発を担当しています。 背景 わたくしは最近プライベートで開発したWebサービスをインターネット上に公開しまし …
-
-
Qiita Team API と Google Spread Sheet でチーム日報を生成する
チーム日報を活用する MarketOne 開発チームでは複数拠点に分かれての開発を行っています。リモート開発が中心となると口頭でのコミュニケーションに限界があるため、テキストベースのコミュニケーションの比重が高い状態にあります。 チケットシステムやソースコード管理ツール上の議論はもちろんおこなってい …
-
-
Scala番外編「Boxに保存したファイルをBox APIを使ってダウンロードしよう！」
はじめに みなさんこんにちは、プロダクト開発本部の亀梨です。 普段はXmediaOneというメディアプランニング・広告運用管理・トラッキング・マーケティング分析を行う 統合プラットフォームの開発を担当しています。 Box APIを使う背景・目的 DACはメディアレップです メディアレップとは、インタ …