Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion composer.json
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
"keywords": ["Laravel", "ipinfolaravel"],
"require": {
"illuminate/support": "^7.0|^8.0|^9.0|^10.0|^11.0|^12.0",
"ipinfo/ipinfo": "^3.2.0"
"ipinfo/ipinfo": "^3.3.0"
},
"require-dev": {
"phpunit/phpunit": "^12.0",
Expand Down
5 changes: 5 additions & 0 deletions config/ipinfocorelaravel.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
<?php

return [
//
];
132 changes: 132 additions & 0 deletions src/core/ipinfocorelaravel.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,132 @@
<?php

namespace ipinfo\ipinfolaravel\core;

use Closure;
use ipinfo\ipinfo\IPinfoCore as IPinfoCoreClient;
use ipinfo\ipinfolaravel\DefaultCache;
use ipinfo\ipinfolaravel\iphandler\DefaultIPSelector;

class ipinfocorelaravel
{
/**
* IPinfo API access token.
* @var string
*/
public $access_token = null;

/**
* IPinfo client object settings.
* @var array
*/
public $settings = [];

/**
* Return true to skip IPinfo lookup, otherwise return false.
* @var function
*/
public $filter = null;

/**
* Provides ip.
* @var ipinfo\ipinfolaravel\iphandler\IPHandlerInterface
*/
public $ip_selector = null;

const CACHE_MAXSIZE = 4096;
const CACHE_TTL = 60 * 24;

/**
* Handle an incoming request.
* @param \Illuminate\Http\Request $request
* @param \Closure $next
* @return mixed
*/
public function handle($request, Closure $next)
{
$this->configure();

if ($this->filter && call_user_func($this->filter, $request)) {
$details = null;
} else {
try {
$details = $this->ipinfo->getDetails(
$this->ip_selector->getIP($request),
);
} catch (\Exception $e) {
$details = null;

// users can't catch this exception with their own wrapper
// middleware unfortunately, so we catch it for them. but for
// backwards-compatibility, we throw the exception again unless
// they've told us not to.
if ($this->no_except != true) {
throw $e;
}
}
}

$request->attributes->set("ipinfo", $details);

return $next($request);
}

/**
* Determine settings based on user-defined configs or use defaults.
*/
public function configure()
{
$this->access_token = config("services.ipinfo.access_token", null);
$this->filter = config("services.ipinfo.filter", [
$this,
"defaultFilter",
]);
$this->no_except = config("services.ipinfo.no_except", false);
$this->ip_selector = config(
"services.ipinfo.ip_selector",
new DefaultIPSelector(),
);

if (
$custom_countries = config("services.ipinfo.countries_file", null)
) {
$this->settings["countries_file"] = $custom_countries;
}

if ($custom_cache = config("services.ipinfo.cache", null)) {
$this->settings["cache"] = $custom_cache;
} else {
$maxsize = config(
"services.ipinfo.cache_maxsize",
self::CACHE_MAXSIZE,
);
$ttl = config("services.ipinfo.cache_ttl", self::CACHE_TTL);
$this->settings["cache"] = new DefaultCache($maxsize, $ttl);
}

$this->ipinfo = new IPinfoCoreClient(
$this->access_token,
$this->settings,
);
}

/**
* Should IP lookup be skipped.
* @param Request $request Request object.
* @return bool Whether or not to filter out.
*/
public function defaultFilter($request)
{
$user_agent = $request->header("user-agent");
if ($user_agent) {
$lower_user_agent = strtolower($user_agent);

$is_spider = strpos($lower_user_agent, "spider") !== false;
$is_bot = strpos($lower_user_agent, "bot") !== false;

return $is_spider || $is_bot;
}

return false;
}
}
64 changes: 64 additions & 0 deletions src/core/ipinfocorelaravelServiceProvider.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
<?php

namespace ipinfo\ipinfolaravel\core;

use Illuminate\Support\ServiceProvider;

class ipinfocorelaravelServiceProvider extends ServiceProvider
{
/**
* Perform post-registration booting of services.
* @return void
*/
public function boot()
{
// Publishing is only necessary when using the CLI.
if ($this->app->runningInConsole()) {
$this->bootForConsole();
}
}

/**
* Register any package services.
* @return void
*/
public function register()
{
$this->mergeConfigFrom(
__DIR__ . "/../../config/ipinfocorelaravel.php",
"ipinfocorelaravel",
);

// Register the service the package provides.
$this->app->singleton(
"ipinfocorelaravel",
fn($app) => new ipinfocorelaravel(),
);
}

/**
* Get the services provided by the provider.
* @return array
*/
public function provides()
{
return ["ipinfocorelaravel"];
}

/**
* Console-specific booting.
* @return void
*/
protected function bootForConsole()
{
// Publishing the configuration file.
$this->publishes(
[
__DIR__ . "/../../config/ipinfocorelaravel.php" => config_path(
"ipinfocorelaravel.php",
),
],
"ipinfocorelaravel.config",
);
}
}
145 changes: 145 additions & 0 deletions tests/IpinfocorelaravelTest.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,145 @@
<?php
namespace ipinfo\ipinfolaravel\Tests;

use Orchestra\Testbench\TestCase;
use Illuminate\Http\Request;
use Illuminate\Http\Response;
use ipinfo\ipinfo\IPinfoCore as IPinfoCoreClient;
use ipinfo\ipinfolaravel\iphandler\IPHandlerInterface;
use ipinfo\ipinfolaravel\core\ipinfocorelaravel;

class IpinfocorelaravelTest extends TestCase
{
protected function getPackageProviders($app)
{
return [
\ipinfo\ipinfolaravel\core\ipinfocorelaravelServiceProvider::class,
];
}

/** Create a middleware with injected mocks, stubbing configure() */
protected function makeMiddleware(
$client,
$selector,
$filter = null,
$noExcept = false,
) {
$mw = $this->getMockBuilder(ipinfocorelaravel::class)
->onlyMethods(["configure"])
->getMock();
$mw->method("configure")->willReturn(null);
$mw->ipinfo = $client;
$mw->ip_selector = $selector;
$mw->filter = $filter;
$mw->no_except = $noExcept;
return $mw;
}

public function test_handle_merges_details_on_success()
{
$details = (object) ["country" => "US", "ip" => "8.8.8.8"];
$client = $this->createMock(IPinfoCoreClient::class);
$client
->expects($this->once())
->method("getDetails")
->with("8.8.8.8")
->willReturn($details);

$selector = $this->createMock(IPHandlerInterface::class);
$selector->method("getIP")->willReturn("8.8.8.8");

$mw = $this->makeMiddleware($client, $selector);

$request = Request::create("/foo", "GET");
$next = function ($req) use (&$out) {
$out = $req->get("ipinfo");
return new Response("OK", 200);
};

$resp = $mw->handle($request, $next);

$this->assertSame($details, $out);
$this->assertEquals(200, $resp->getStatusCode());
$this->assertEquals("OK", $resp->getContent());
}

public function test_handle_skips_lookup_when_filter_true()
{
$client = $this->createMock(IPinfoCoreClient::class);
$client->expects($this->never())->method("getDetails");

$selector = $this->createMock(IPHandlerInterface::class);
$selector->expects($this->never())->method("getIP");

$filter = fn($req) => true;
$mw = $this->makeMiddleware($client, $selector, $filter);

$request = Request::create("/", "GET");
$request->headers->set("user-agent", "GoogleBot");

$next = function ($req) use (&$out) {
$out = $req->get("ipinfo");
return new Response();
};

$mw->handle($request, $next);
$this->assertNull($out);
}

public function test_handle_throws_if_client_throws_and_no_except_false()
{
$this->expectException(\Exception::class);

$client = $this->createMock(IPinfoCoreClient::class);
$client
->method("getDetails")
->willThrowException(new \Exception("boom"));

$selector = $this->createMock(IPHandlerInterface::class);
$selector->method("getIP")->willReturn("1.1.1.1");

$mw = $this->makeMiddleware($client, $selector, null, false);
$mw->handle(Request::create("/", "GET"), fn($r) => new Response());
}

public function test_handle_swallows_if_client_throws_and_no_except_true()
{
$client = $this->createMock(IPinfoCoreClient::class);
$client
->method("getDetails")
->willThrowException(new \Exception("boom"));

$selector = $this->createMock(IPHandlerInterface::class);
$selector->method("getIP")->willReturn("1.1.1.1");

$mw = $this->makeMiddleware($client, $selector, null, true);

$next = function ($req) use (&$out) {
$out = $req->get("ipinfo");
return new Response();
};

$mw->handle(Request::create("/", "GET"), $next);
$this->assertNull($out);
}

public function test_defaultFilter_detects_bots_and_spiders()
{
$mw = new ipinfocorelaravel();

$r1 = Request::create("/", "GET");
$r1->headers->set("user-agent", "MySpider");
$this->assertTrue($mw->defaultFilter($r1));

$r2 = Request::create("/", "GET");
$r2->headers->set("user-agent", "someBOT/2.0");
$this->assertTrue($mw->defaultFilter($r2));

$r3 = Request::create("/", "GET");
$r3->headers->set("user-agent", "normal");
$this->assertFalse($mw->defaultFilter($r3));

$r4 = Request::create("/", "GET");
$this->assertFalse($mw->defaultFilter($r4));
}
}