wiki.techinc.nl/includes/api/Hook/ApiQueryBaseBeforeQueryHook.php
daniel e6e0ad2472 Replace "@stable for implementation" with "@stable to implement"
For compliance with the new version of the table interface policy
(T255803).

This patch was created by an automated search & replace operation
on the includes/ directory.

Bug: T257789
Change-Id: I17e5e92e24c708ffc846945a136347670a3a20c7
2020-07-13 11:05:49 +02:00

35 lines
1.3 KiB
PHP

<?php
namespace MediaWiki\Api\Hook;
use ApiQueryBase;
/**
* @stable to implement
* @ingroup Hooks
*/
interface ApiQueryBaseBeforeQueryHook {
/**
* This hook is called for (some) API query modules before a
* database query is made. WARNING: It would be very easy to misuse this hook and
* break the module! Any joins added *must* join on a unique key of the target
* table unless you really know what you're doing. An API query module wanting to
* use this hook should see the ApiQueryBase::select() and
* ApiQueryBase::processRow() documentation.
*
* @since 1.35
*
* @param ApiQueryBase $module Module in question
* @param array &$tables Array of tables to be queried
* @param array &$fields Array of columns to select
* @param array &$conds Array of WHERE conditionals for query
* @param array &$query_options Array of options for the database request
* @param array &$join_conds Join conditions for the tables
* @param array &$hookData Array that will be passed to the ApiQueryBaseAfterQuery and
* ApiQueryBaseProcessRow hooks, intended for inter-hook communication.
* @return bool|void True or no return value to continue or false to abort
*/
public function onApiQueryBaseBeforeQuery( $module, &$tables, &$fields,
&$conds, &$query_options, &$join_conds, &$hookData
);
}