47 parent::__construct( $query, $moduleName,
'eu' );
49 $this->urlUtils = $urlUtils;
61 $this->
run( $resultPageSet );
68 private function run( $resultPageSet =
null ) {
73 $protocol = LinkFilter::getProtocolPrefix(
$params[
'protocol'] );
75 $this->
addTables( [
'externallinks',
'page' ] );
76 $this->
addJoinConds( [
'page' => [
'JOIN',
'page_id=el_from' ] ] );
77 $fields = [
'el_to_domain_index',
'el_to_path' ];
80 if ( $this->
getConfig()->
get( MainConfigNames::MiserMode ) ) {
81 $miser_ns =
$params[
'namespace'] ?: [];
85 if ( $query !==
null && $query !==
'' ) {
87 $query = Parser::normalizeLinkUrl( $query );
88 $conds = LinkFilter::getQueryConditions( $query, [
89 'protocol' => $protocol,
90 'oneWildcard' =>
true,
98 if ( $protocol !==
null ) {
100 $db->expr(
'el_to_domain_index', IExpression::LIKE,
new LikeValue(
"$protocol", $db->anyString() ) )
104 $orderBy = [
'el_id' ];
106 $this->
addOption(
'ORDER BY', $orderBy );
109 $prop = array_fill_keys(
$params[
'prop'],
true );
110 $fld_ids = isset( $prop[
'ids'] );
111 $fld_title = isset( $prop[
'title'] );
112 $fld_url = isset( $prop[
'url'] );
114 if ( $resultPageSet ===
null ) {
120 foreach ( $fields as $field ) {
124 $this->
addFields( $resultPageSet->getPageTableFields() );
133 if (
$params[
'continue'] !==
null ) {
135 array_fill( 0, count( $orderBy ),
'string' ) );
136 $conds = array_combine( $orderBy, array_map(
'rawurldecode', $cont ) );
137 $this->
addWhere( $db->buildComparison(
'>=', $conds ) );
140 $res = $this->
select( __METHOD__ );
144 if ( $resultPageSet ===
null ) {
149 foreach ( $res as $row ) {
150 if ( ++$count > $limit ) {
153 $this->setContinue( $orderBy, $row );
157 if ( count( $miser_ns ) && !in_array( $row->page_namespace, $miser_ns ) ) {
161 if ( $resultPageSet ===
null ) {
166 $vals[
'pageid'] = (int)$row->page_id;
169 $title = Title::makeTitle( $row->page_namespace, $row->page_title );
173 $to = LinkFilter::reverseIndexes( $row->el_to_domain_index ) . $row->el_to_path;
180 $fit = $result->addValue( [
'query', $this->
getModuleName() ],
null, $vals );
182 $this->setContinue( $orderBy, $row );
186 $resultPageSet->processDbRow( $row );
190 if ( $resultPageSet ===
null ) {
191 $result->addIndexedTagName( [
'query', $this->
getModuleName() ],
196 private function setContinue( $orderBy, $row ) {
198 foreach ( $orderBy as $field ) {
199 $fields[] = strtr( $row->$field, [
'%' =>
'%25',
'|' =>
'%7C' ] );
207 ParamValidator::PARAM_ISMULTI =>
true,
208 ParamValidator::PARAM_DEFAULT =>
'ids|title|url',
209 ParamValidator::PARAM_TYPE => [
220 ParamValidator::PARAM_TYPE => LinkFilter::prepareProtocols(),
221 ParamValidator::PARAM_DEFAULT =>
'',
225 ParamValidator::PARAM_ISMULTI =>
true,
226 ParamValidator::PARAM_TYPE =>
'namespace'
229 ParamValidator::PARAM_DEFAULT => 10,
230 ParamValidator::PARAM_TYPE =>
'limit',
231 IntegerDef::PARAM_MIN => 1,
236 ParamValidator::PARAM_TYPE =>
'boolean',
237 ParamValidator::PARAM_DEFAULT =>
false,
238 ParamValidator::PARAM_DEPRECATED =>
true,
242 if ( $this->
getConfig()->
get( MainConfigNames::MiserMode ) ) {
244 'api-help-param-limited-in-miser-mode',
253 'action=query&list=exturlusage&euquery=www.mediawiki.org'
254 =>
'apihelp-query+exturlusage-example-simple',
259 return 'https://www.mediawiki.org/wiki/Special:MyLanguage/API:Exturlusage';
array $params
The job parameters.
dieWithError( $msg, $code=null, $data=null, $httpCode=0)
Abort execution with an error.
getModulePrefix()
Get parameter prefix (usually two letters or an empty string).
const PARAM_HELP_MSG_APPEND
((string|array|Message)[]) Specify additional i18n messages to append to the normal message for this ...
parseContinueParamOrDie(string $continue, array $types)
Parse the 'continue' parameter in the usual format and validate the types of each part,...
const PARAM_HELP_MSG_PER_VALUE
((string|array|Message)[]) When PARAM_TYPE is an array, or 'string' with PARAM_ISMULTI,...
const LIMIT_BIG1
Fast query, standard limit.
getResult()
Get the result object.
extractRequestParams( $options=[])
Using getAllowedParams(), this function makes an array of the values provided by the user,...
const PARAM_HELP_MSG
(string|array|Message) Specify an alternative i18n documentation message for this parameter.
const LIMIT_BIG2
Fast query, apihighlimits limit.
getModuleName()
Get the name of the module being executed by this instance.
static addTitleInfo(&$arr, $title, $prefix='')
Add information (title and namespace) about a Title object to a result array.
addFields( $value)
Add a set of fields to select to the internal array.
addOption( $name, $value=null)
Add an option such as LIMIT or USE INDEX.
addTables( $tables, $alias=null)
Add a set of tables to the internal array.
getDB()
Get the Query database connection (read-only)
executeGenderCacheFromResultWrapper(IResultWrapper $res, $fname=__METHOD__, $fieldPrefix='page')
Preprocess the result set to fill the GenderCache with the necessary information before using self::a...
select( $method, $extraQuery=[], array &$hookData=null)
Execute a SELECT query based on the values in the internal arrays.
addFieldsIf( $value, $condition)
Same as addFields(), but add the fields only if a condition is met.
addJoinConds( $join_conds)
Add a set of JOIN conditions to the internal array.
addWhereFld( $field, $value)
Equivalent to addWhere( [ $field => $value ] )
addWhere( $value)
Add a set of WHERE clauses to the internal array.
executeGenerator( $resultPageSet)
Execute this module as a generator.
__construct(ApiQuery $query, $moduleName, UrlUtils $urlUtils)
getExamplesMessages()
Returns usage examples for this module.
execute()
Evaluates the parameters, performs the requested query, and sets up the result.
getHelpUrls()
Return links to more detailed help pages about the module.
getCacheMode( $params)
Get the cache mode for the data generated by this module.
getAllowedParams()
Returns an array of allowed parameters (parameter name) => (default value) or (parameter name) => (ar...
setContinueEnumParameter( $paramName, $paramValue)
Overridden to set the generator param if in generator mode.
This is the main query class.
const META_TYPE
Key for the 'type' metadata item.
A class containing constants representing the names of configuration variables.