mirror of
https://gitlab.archlinux.org/archlinux/aurweb.git
synced 2025-02-03 10:43:03 +01:00
0488e8597c
The majority of "real world" info requests [1] come in hefty batches. We
would be better served to handle these in one request rather than
multiple by allowing AUR clients to send multiple arguments.
This enables things like this to work:
http://aur.test/rpc.php?type=multiinfo&arg[]=cups-xerox&arg[]=cups-mc2430dl&arg[]=10673
Note to RPC users: unfortunately due to the asinine design of PHP, you
unfortunately have to use the 'arg[]' syntax if you want more than one
query argument, or you will only get the package satisfying the last arg
you pass.
[1] Rough data from April 11, 2011, with a total hit count of 1,109,163:
12 /login.php
13 /rpc.php?type=sarch
15 /rpc.php?type=msearch
16 /pingserver.php
16 /rpc.php
22 /logout.php
163 /passreset.php
335 /account.php
530 /pkgsubmit.php
916 /rss2.php
3838 /index.php
6752 /rss.php
9699 /
42478 /rpc.php?type=search
184737 /packages.php
681725 /rpc.php?type=info
That means a whopping 61.5% of our requests were for info over the RPC
interface; package pages are a distant second at only 16.7%.
Lukas: Introduce "multiinfo" query instead of extending "info" (for the
sake of backward compatibility).
Signed-off-by: Dan McGee <dan@archlinux.org>
Signed-off-by: Lukas Fleischer <archlinux@cryptocrack.de>
36 lines
1.4 KiB
PHP
36 lines
1.4 KiB
PHP
<?php
|
|
|
|
set_include_path(get_include_path() . PATH_SEPARATOR . '../lib');
|
|
|
|
include_once("aurjson.class.php");
|
|
|
|
if ( $_SERVER['REQUEST_METHOD'] == 'GET' ) {
|
|
if ( isset($_GET['type']) ) {
|
|
$rpc_o = new AurJSON();
|
|
echo $rpc_o->handle($_GET);
|
|
}
|
|
else {
|
|
// dump a simple usage output for people to use.
|
|
// this could be moved to an api doc in the future, or generated from
|
|
// the AurJSON class directly with phpdoc. For now though, just putting it here.
|
|
echo '<html><body>';
|
|
echo 'The methods currently allowed are: <br />';
|
|
echo '<ul>';
|
|
echo '<li>search</li>';
|
|
echo '<li>info</li>';
|
|
echo '<li>multiinfo</li>';
|
|
echo '<li>msearch</li>';
|
|
echo '</ul><br />';
|
|
echo 'Each method requires the following HTTP GET syntax:<br />';
|
|
echo ' type=<i>methodname</i>&arg=<i>data</i> <br /><br />';
|
|
echo 'Where <i>methodname</i> is the name of an allowed method, and <i>data</i> is the argument to the call.<br />';
|
|
echo '<br />';
|
|
echo 'If you need jsonp type callback specification, you can provide an additional variable <i>callback</i>.<br />';
|
|
echo 'Example URL: <br /> http://aur-url/rpc.php?type=search&arg=foobar&callback=jsonp1192244621103';
|
|
echo '</body></html>';
|
|
}
|
|
}
|
|
else {
|
|
echo 'POST NOT SUPPORTED';
|
|
}
|
|
?>
|