137 lines
3.3 KiB
PHP
137 lines
3.3 KiB
PHP
<?php
|
|
/**
|
|
* @brief PaginatedAPI Response
|
|
* @author <a href='https://www.invisioncommunity.com'>Invision Power Services, Inc.</a>
|
|
* @copyright (c) Invision Power Services, Inc.
|
|
* @license https://www.invisioncommunity.com/legal/standards/
|
|
* @package Invision Community
|
|
* @since 3 Dec 2015
|
|
*/
|
|
|
|
namespace IPS\Api;
|
|
|
|
/* To prevent PHP errors (extending class does not exist) revealing path */
|
|
if ( !\defined( '\IPS\SUITE_UNIQUE_KEY' ) )
|
|
{
|
|
header( ( isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0' ) . ' 403 Forbidden' );
|
|
exit;
|
|
}
|
|
|
|
/**
|
|
* API Response
|
|
*/
|
|
class _PaginatedResponse extends Response
|
|
{
|
|
/**
|
|
* @brief HTTP Response Code
|
|
*/
|
|
public $httpCode;
|
|
|
|
/**
|
|
* @brief Iterator (usually a select query)
|
|
*/
|
|
protected $iterator;
|
|
|
|
/**
|
|
* @brief Current page
|
|
*/
|
|
protected $page = 1;
|
|
|
|
/**
|
|
* @brief Results per page
|
|
*/
|
|
protected $resultsPerPage = 25;
|
|
|
|
/**
|
|
* @brief ActiveRecord class
|
|
*/
|
|
protected $activeRecordClass;
|
|
|
|
/**
|
|
* @brief Total Count
|
|
*/
|
|
protected $count;
|
|
|
|
/**
|
|
* @brief The member making the API request or NULL for API Key / client_credentials
|
|
*/
|
|
protected $authorizedMember;
|
|
|
|
/**
|
|
* Constructor
|
|
*
|
|
* @param int $httpCode HTTP Response code
|
|
* @param \Iterator $iterator Select query or \IPS\Patterns\ActiveRecordIterator instance
|
|
* @param int $page Current page
|
|
* @param string $activeRecordClass ActiveRecord class
|
|
* @param int|NULL $count Total Count
|
|
* @param \IPS\Member|NULL $authorizedMember The member making the API request or NULL for API Key / client_credentials
|
|
* @param int $perPage Number of results per page
|
|
* @return void
|
|
*/
|
|
public function __construct( $httpCode, $iterator, $page, $activeRecordClass, $count, \IPS\Member $authorizedMember = NULL, $perPage=NULL )
|
|
{
|
|
$this->httpCode = $httpCode;
|
|
$page = (int) $page;
|
|
$this->page = $page > 0 ? $page : 1;
|
|
$this->iterator = $iterator;
|
|
$this->activeRecordClass = $activeRecordClass;
|
|
$this->count = (int) $count;
|
|
$this->resultsPerPage = $perPage ? (int) $perPage : 25;
|
|
$this->authorizedMember = $authorizedMember;
|
|
|
|
if( $this->iterator instanceof \IPS\Db\Select )
|
|
{
|
|
/* Limit the query before calling count(), as this runs the query so it cannot be modified after */
|
|
$this->iterator->query .= \IPS\Db::i()->compileLimitClause( array( ( $this->page - 1 ) * $this->resultsPerPage, $this->resultsPerPage ) );
|
|
|
|
if ( $count === NULL )
|
|
{
|
|
$this->count = $iterator->count();
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Data to output
|
|
*
|
|
* @return array
|
|
*/
|
|
public function getOutput()
|
|
{
|
|
$results = array();
|
|
|
|
if ( $this->activeRecordClass )
|
|
{
|
|
if( $this->iterator instanceof \IPS\Patterns\ActiveRecordIterator )
|
|
{
|
|
foreach ( $this->iterator as $result )
|
|
{
|
|
$results[] = $result->apiOutput( $this->authorizedMember );
|
|
}
|
|
}
|
|
else
|
|
{
|
|
foreach ( new \IPS\Patterns\ActiveRecordIterator( $this->iterator, $this->activeRecordClass ) as $result )
|
|
{
|
|
$results[] = $result->apiOutput( $this->authorizedMember );
|
|
}
|
|
}
|
|
}
|
|
else
|
|
{
|
|
foreach ( $this->iterator as $result )
|
|
{
|
|
$results[] = $result;
|
|
}
|
|
}
|
|
|
|
return array(
|
|
'page' => $this->page,
|
|
'perPage' => $this->resultsPerPage,
|
|
'totalResults' => $this->count,
|
|
'totalPages' => ceil( $this->count / $this->resultsPerPage ),
|
|
'results' => $results
|
|
);
|
|
}
|
|
} |