limitrr-php

composer require eddiejibson/limitrr-php "^1.0"

require "/vendor/autoload.php"; //Require composer's autoload

$options = [
    //Redis keystore information
    "redis" => [
        "host" => "666.chae.sh",
        "port" => 6379,
        "password" => "supersecret",
    ],
    "routes" => [
        "default" => [
            "requestsPerExpiry" => 5,
        ],
    ],

];

//Initialize the Limitrr class and pass the options defined above into it
//Note that the options are not required.
$limitrr = new \eddiejibson\limitrr\Limitrr($options);

//Various examples like this can be found further into the documentation,
//for each function.
$result = $limitrr->get(["discriminator" => $ip]);
echo $result["requests"] + " Requests";
echo $result["completed"] + " Completed";
//Note that this library is no means just for SlimPHP, it just happens to
//provide a middleware function for those who may need it.

//Usage within SlimPHP
$app = new Slim\App();

//Use the Limitrr SlimPHP middleware function, if you wish:
$app->add(new \eddiejibson\limitrr\RateLimitMiddleware($limitrr)); //Make sure to pass in the main Limitrr
//instance we defined above into the middleware function. This is mandatory.

//You can also add the get IP middleware function, it will append the user's real IP
//(behind Cloudflare or not) to the request.
$app->add(new \eddiejibson\limitrr\getIpMiddleware());

//Example usage within a route
$app->get("/hello/{name}", function ($request, $response, $args) {
    $name = $args["name"];
    $ip = $request->getAttribute('realip'); //Get the IP that was defined within Limitrr's get IP middleware function
    return $response->getBody()->write("Hello, ${name}. Your IP is ${ip}.");
});

//You do not have to app the middleware function to every single route, globally.
//You can do it indivually, too - along with passing options into such. Like so:
$app->get("/createUser/{name}", function ($request, $response, $args) {
    //Non intensive actions like simple verification will have a different limit to intensive ones.
    //and will only be measured in terms of each request via the middleware.
    //No further action is required.
    if (strlen($args["name"]) < 5) {
        //Dummy function creating user
        $res = $someRandomClass->registerUser();
        if ($res) {
            //Intensive actions like actually registering a user should have a
            //different limit to normal requests, hence the completedActionsPerExpiry option.
            //and should only be added to once this task has been completed fully
            //In this example, we will be limiting the amount of completed actions a certain IP can make.
            //Anything can be passed in here, however. For example, a email address or user ID.
            //$request->getAttribute('realip') was determined by calling the middleware earlier - getIpMiddleware()
            $limitrr->complete(["discriminator"] => $ip);
        }
    }
})->add(new \eddiejibson\limitrr\RateLimitMiddleware($limitrr, ["route"=>"createUser"]));
//You can also pass the route name within the limitrr middleware function

$app->run();

$limitrr->get([
    "discriminator" => $discriminator, //Erforderlich
    "route" => $route, //Nicht erforderlich, Standard wird angenommen
    "type" => $type //Nicht erforderlich
]);

$limitrr->get([
    "discriminator" => $discriminator,
    "type" => $type,
    "route" => $route
]); //Außer discriminator sind alle Parameter optional.
//Wenn type nicht an die Funktion übergeben wird, gibt sie
//sowohl die Anzahl der Anfragen als auch der abgeschlossenen Aktionen zurück

//Wobei discriminator das ist, was begrenzt wird
//z. B. x abgeschlossene Aktionen/Anfragen pro Diskriminator
$limitrr->get(["discriminator" => $discriminator]);

//Dies ist in der Regel die IP des Benutzers.
$limitrr->get(["discriminator" => $ip]);
//Dies gibt sowohl die Anzahl der Anfragen als auch der abgeschlossenen Aktionen zurück, die unter dem
//angegebenen Diskriminator in einem Objekt gespeichert sind. Sie können so damit umgehen:
$result = $limitrr->get(["discriminator" => $ip]);
echo $result["requests"] + " Requests";
echo $result["completed"] + " Completed";

//Das obige Beispiel würde die Anzahl der Anfragen und erledigten Aufgaben von der Standardroute
//abrufen. Wenn Sie Werte von einer anderen Route abrufen möchten, können Sie
//diese ebenfalls angeben. Dies kann so erfolgen:
$result = $limitrr->get(["discriminator" => $ip, "route" => "exampleRouteName"]);
echo $result["requests"] . " Requests made through the route exampleRouteName";
echo $result["completed"] . " Completed Tasks made through the route exampleRouteName";

//Sie können auch nur einen einzigen Wert abrufen – statt sowohl Anfragen als auch Erledigte.
$result = $limitrr->get(["discriminator" => $ip, "route" => "exampleRouteName", "type" => "completed"]);
echo $result["completed"] . " Completed tasks made through the route exampleRouteName";

$limitrr->get([
    "discriminator" => $discriminator, //Erforderlich
    "route" => $route, //Nicht erforderlich, Standard wird angenommen
]);

$limitrr->reset([
    "discriminator" => $discriminator, //Erforderlich
    "route" => $route, //Nicht erforderlich, Standard wird angenommen,
    "type" => $type //Nicht erforderlich
]);

//Wobei discriminator das ist, was begrenzt wird
//z. B. x abgeschlossene Aktionen/Anfragen pro Diskriminator
//Dies entfernt sowohl die Anzahl der Anfragen als auch die Anzahl der abgeschlossenen Aktionen
$limitrr->reset(["discriminator" => $discriminator]);

//Dies ist in der Regel die IP des Benutzers.
$limitrr->reset(["discriminator" => $ip]);

//Wenn Sie Zähler von einer bestimmten Route zurücksetzen möchten, kann dies ebenfalls erfolgen.
//Da der Typ nicht angegeben ist, werden sowohl die Anfragen- als auch die abgeschlossenen Zähler entfernt.
$result = $limitrr->reset([
    "discriminator" => $ip,
    "route" => "exampleRouteName"
]);
if ($result) {
    echo "Requests removed from the route exampleRouteName";
} else {
    //Do something else
}

//Wenn Sie nur entweder die Anzahl der Anfragen oder die der abgeschlossenen Aktionen entfernen möchten,
//aber nicht die andere, kann dies ebenfalls erfolgen.
//Der übergebene Wert kann entweder "requests" oder "completed" sein.
//In diesem Beispiel entfernen wir die Anzahl der Anfragen für eine bestimmte IP.
$result = $limitrr->reset([
    "discriminator" => $ip,
    "type" => "requests"
]);
if ($result) {
    echo "Request count for the specified IP were removed"
} else {
    //do something else
}

    //Übergeben Sie einen String mit einer Redis-URI.
    "redis" => "redis://127.0.0.1:6379/0"
    //Alternativ ein Array mit den Verbindungsinformationen verwenden.
    "redis" => [
        "port" => 6379, //Redis-Port. Erforderlich: false. Standardwert: 6379
        "host" => "127.0.0.1", //Redis-Hostname. Erforderlich: false. Standardwert: "127.0.0.1".
        "password" => "mysecretpassword1234", //Redis-Passwort. Erforderlich: false. Standardwert: null.
        "database" => 0 //Redis-Datenbank. Erforderlich: false. Standardwert: 0.
    ]

"options" => [
    "keyName" => "myApp", //Der Schlüsselname, unter dem alle Anfragen gespeichert werden. Erforderlich: false. Standardwert: "limitrr"
    "errorStatusCode" => 429 //Sollen wichtige Fehler wie Verbindungsfehler zum Redis-Keyspeicher abgefangen und angezeigt werden?
]

"routes" => [
    //Standard-Routenregeln überschreiben – nicht alle Schlüssel müssen gesetzt sein,
    //nur die, die Sie überschreiben möchten
    "default" => [
        "expiry": 1000
    ],
    "exampleRoute" => [
        "requestsPerExpiry" => 100,
        "completedActionsPerExpiry" => 5,
        "expiry" => 900,
        "completedExpiry" => 900,
        "errorMsgs" => [
            "requests" => "As you have made too many requests, you are being rate limited.",
            "completed" => "As you performed too many successful actions, you have been rate limited."
        ]
    ],
    //Wenn nicht alle Schlüssel gesetzt sind, werden sie auf die
    //Standardwerte zurückgesetzt
    "exampleRoute2" => [
        "requestsPerExpiry" => 500
    ]
]