kjenney/php-webminer

A php client that uses WebDriver and Querypath

0.5 2015-02-25 19:47 UTC

Requires

• php: >=5.4.0
• facebook/webdriver: 0.5.1
• querypath/querypath: 3.0.3

Requires (Dev)

• phpdocumentor/phpdocumentor: 2.8.1
• phpunit/phpunit: 3.7.*

Apache-2.0

• php
• selenium
• webdriver
• kjenney

README

DESCRIPTION

The goal of this project is to create an extensible system for extracting data from web pages. Currently it is using Selenium WebDriver (via php-webdriver), QueryPath, and a configuration file which specifies which components to extract and how to output the results.

Job File

The "job" configuration file defines all of the aspects of the system (database, infrastructure) and the web site and the data you wish to extract.

It is in XML and has the following options:

1. Child element "site" must be defined
2. Child element "steps" are recommended as they drive actions

Database

Currently a single MySQL database is accepted. If elements are defind the XML will be imported into the database->table per the specifications in the Configuration File

Actions

1. Click
2. Type
3. Captcha

Elements

1. Input - CSS Selectors used by QueryPath to pull data from a web page
2. Output - Element name of Output XML

Samples are included in the /examples folder.

Outputs XML

The definitions in the configuration define how the output will be formatted (element names).

INSTALLING

GET THE CODE

Github

git clone [e-mail]:kjenney/php-webminer.git

Packagist

Add the dependency. https://packagist.org/packages/kjenney/php-webminer

{
  "require": {
    "kjenney/php-webminer": "dev-master"
  }
}

BUILD WITH DEPENDENCIES

Download the composer.phar

curl -sS https://getcomposer.org/installer | php

Install the library.

php composer.phar install

Install PHP5 Extensions

apt-get install php5-tidy
yum install php-tidy

apt-get install php5-mysqlnd

Install Tesseract (optional)

apt-get install tesseract-ocr

GETTING STARTED

• All you need as the server for this client is the selenium-server-standalone-#.jar file provided here: http://www.seleniumhq.org/download/

• Download and run that file, replacing # with the current server version.

  java -jar selenium-server-standalone-#.jar
  

Support

• Wiki - https://github.com/kjenney/php-webminer/wiki

Contributing

• There's still a lot of work that needs to be done, but I welcome any help and/or suggestions.

• Feel free to create issues and recommend features.