|
1 | 1 | Geocoder
|
2 | 2 | ========
|
3 | 3 |
|
4 |
| -**Geocoder** is a library which helps you build geo-aware applications. It provides an abstraction layer for geocoding manipulations. |
5 |
| -The library is split in two parts: `HttpAdapter` and `Provider` and is really extensible. |
6 |
| - |
7 | 4 | [](http://travis-ci.org/geocoder-php/Geocoder)
|
| 5 | +[](https://packagist.org/packages/willdurand/Geocoder) |
| 6 | +[](https://packagist.org/packages/willdurand/Geocoder) |
8 | 7 |
|
| 8 | +**Geocoder** is a library which helps you build geo-aware applications. It |
| 9 | +provides an abstraction layer for geocoding manipulations. |
9 | 10 |
|
10 |
| -### HttpAdapters ### |
11 |
| - |
12 |
| -_HttpAdapters_ are responsible to get data from remote APIs. |
13 |
| - |
14 |
| -Currently, there are the following adapters: |
| 11 | +### HTTP Adapters ### |
15 | 12 |
|
16 |
| -* `BuzzHttpAdapter` to use [Buzz](https://github.com/kriswallsmith/Buzz), a lightweight PHP 5.3 library for issuing HTTP requests; |
17 |
| -* `CurlHttpAdapter` to use [cURL](http://php.net/manual/book.curl.php); |
18 |
| -* `GuzzleHttpAdapter` to use [Guzzle](https://github.com/guzzle/guzzle), PHP 5.3+ HTTP client and framework for building RESTful web service clients; |
19 |
| -* `SocketHttpAdapter` to use a [socket](http://www.php.net/manual/function.fsockopen.php); |
20 |
| -* `ZendHttpAdapter` to use [Zend Http Client](http://framework.zend.com/manual/2.0/en/modules/zend.http.client.html); |
21 |
| -* `GeoIP2Adapter` to use [GeoIP2 Database Reader](https://github.com/maxmind/GeoIP2-php#database-reader) or the [Webservice Client](https://github.com/maxmind/GeoIP2-php#web-service-client) by MaxMind. |
| 13 | +In order to talk to geocoding APIs, you need HTTP adapters. While it was part of |
| 14 | +the library in Geocoder 1.x and 2.x, Geocoder 3.x and upper now relies on the |
| 15 | +[PSR-7 |
| 16 | +Standard](https://github.com/php-fig/fig-standards/blob/master/proposed/http-message.md) |
| 17 | +which defines how HTTP message should be implemented. Choose any library that |
| 18 | +follows this PSR and implement the specified interfaces to use with Geocoder. |
22 | 19 |
|
| 20 | +As making choices is rather hard, Geocoder requires the |
| 21 | +[egeloen/http-adapter](https://github.com/egeloen/ivory-http-adapter) library. |
23 | 22 |
|
24 | 23 | ### Providers ###
|
25 | 24 |
|
|
0 commit comments