Public Member Functions |
Protected Member Functions |
Private Member Functions |
List of all members
ApiQueryPagesWithProp Class Reference
A query module to enumerate pages that use a particular prop. More...
Inheritance diagram for ApiQueryPagesWithProp:
Collaboration diagram for ApiQueryPagesWithProp:
Public Member Functions | |
| __construct (ApiQuery $query, $moduleName) | |
| execute () | |
| executeGenerator ($resultPageSet) | |
| getAllowedParams () | |
| getCacheMode ($params) | |
| getHelpUrls () | |
 Public Member Functions inherited from ApiQueryGeneratorBase | |
| encodeParamName ($paramName) | |
| Overrides ApiBase to prepend 'g' to every generator parameter. More... | |
| executeGenerator ($resultPageSet) | |
| Execute this module as a generator. More... | |
| isInGeneratorMode () | |
| Indicate whether the module is in generator mode. More... | |
| setGeneratorMode (ApiPageSet $generatorPageSet) | |
| Switch this module to generator mode. More... | |
| Public Member Functions inherited from ApiQueryBase | |
| __construct (ApiQuery $queryModule, $moduleName, $paramPrefix= '') | |
| getCacheMode ($params) | |
| Get the cache mode for the data generated by this module. More... | |
| requestExtraData ($pageSet) | |
| Override this method to request extra fields from the pageSet using $pageSet->requestField('fieldName') More... | |
| getQuery () | |
| Get the main Query module. More... | |
| getParent () | |
| selectNamedDB ($name, $db, $groups) | |
| Selects the query database connection with the given name. More... | |
| prepareUrlQuerySearchString ($query=null, $protocol=null) | |
| showHiddenUsersAddBlockInfo ($showBlockInfo) | |
| Filters hidden users (where the user doesn't have the right to view them) Also adds relevant block information. More... | |
| titlePartToKey ($titlePart, $namespace=NS_MAIN) | |
| Convert an input title or title prefix into a dbkey. More... | |
| prefixedTitlePartToKey ($titlePart, $defaultNamespace=NS_MAIN) | |
| Convert an input title or title prefix into a namespace constant and dbkey. More... | |
| validateSha1Hash ($hash) | |
| validateSha1Base36Hash ($hash) | |
| userCanSeeRevDel () | |
| Check whether the current user has permission to view revision-deleted fields. More... | |
| Public Member Functions inherited from ApiBase | |
| __construct (ApiMain $mainModule, $moduleName, $modulePrefix= '') | |
| execute () | |
| Evaluates the parameters, performs the requested query, and sets up the result. More... | |
| getModuleManager () | |
| Get the module manager, or null if this module has no sub-modules. More... | |
| getCustomPrinter () | |
| If the module may only be used with a certain format module, it should override this method to return an instance of that formatter. More... | |
| getHelpUrls () | |
| Return links to more detailed help pages about the module. More... | |
| shouldCheckMaxlag () | |
| Indicates if this module needs maxlag to be checked. More... | |
| isReadMode () | |
| Indicates whether this module requires read rights. More... | |
| isWriteMode () | |
| Indicates whether this module requires write mode. More... | |
| mustBePosted () | |
| Indicates whether this module must be called with a POST request. More... | |
| isDeprecated () | |
| Indicates whether this module is deprecated. More... | |
| isInternal () | |
| Indicates whether this module is "internal" Internal API modules are not (yet) intended for 3rd party use and may be unstable. More... | |
| needsToken () | |
| Returns the token type this module requires in order to execute. More... | |
| getConditionalRequestData ($condition) | |
| Returns data for HTTP conditional request mechanisms. More... | |
| getModuleName () | |
| Get the name of the module being executed by this instance. More... | |
| getModulePrefix () | |
| Get parameter prefix (usually two letters or an empty string). More... | |
| getMain () | |
| Get the main module. More... | |
| isMain () | |
| Returns true if this module is the main module ($this === $this->mMainModule), false otherwise. More... | |
| getParent () | |
| Get the parent of this module. More... | |
| lacksSameOriginSecurity () | |
| Returns true if the current request breaks the same-origin policy. More... | |
| getModulePath () | |
| Get the path to this module. More... | |
| getModuleFromPath ($path) | |
| Get a module from its module path. More... | |
| getResult () | |
| Get the result object. More... | |
| getErrorFormatter () | |
| Get the error formatter. More... | |
| getContinuationManager () | |
| Get the continuation manager. More... | |
| setContinuationManager ($manager) | |
| Set the continuation manager. More... | |
| dynamicParameterDocumentation () | |
| Indicate if the module supports dynamically-determined parameters that cannot be included in self::getAllowedParams(). More... | |
| encodeParamName ($paramName) | |
| This method mangles parameter name based on the prefix supplied to the constructor. More... | |
| extractRequestParams ($parseLimit=true) | |
| Using getAllowedParams(), this function makes an array of the values provided by the user, with key being the name of the variable, and value - validated value from user or default. More... | |
| requireOnlyOneParameter ($params, $required) | |
| Die if none or more than one of a certain set of parameters is set and not false. More... | |
| requireMaxOneParameter ($params, $required) | |
| Die if more than one of a certain set of parameters is set and not false. More... | |
| requireAtLeastOneParameter ($params, $required) | |
| Die if none of a certain set of parameters is set and not false. More... | |
| requirePostedParameters ($params, $prefix= 'prefix') | |
| Die if any of the specified parameters were found in the query part of the URL rather than the post body. More... | |
| getTitleOrPageId ($params, $load=false) | |
| Get a WikiPage object from a title or pageid param, if possible. More... | |
| validateToken ($token, array $params) | |
| Validate the supplied token. More... | |
| getWatchlistUser ($params) | |
| Gets the user for whom to get the watchlist. More... | |
| setWarning ($warning) | |
| Set warning section for this module. More... | |
| dieUsage ($description, $errorCode, $httpRespCode=0, $extradata=null) | |
| Throw a UsageException, which will (if uncaught) call the main module's error handler and die with an error message. More... | |
| dieBlocked (Block $block) | |
| Throw a UsageException, which will (if uncaught) call the main module's error handler and die with an error message including block info. More... | |
| getErrorFromStatus ($status, &$extraData=null) | |
| Get error (as code, string) from a Status object. More... | |
| dieStatus ($status) | |
| Throw a UsageException based on the errors in the Status object. More... | |
| static | dieReadOnly () |
| Helper function for readonly errors. More... | |
| dieUsageMsg ($error) | |
| Output the error message related to a certain array. More... | |
| dieUsageMsgOrDebug ($error) | |
| Will only set a warning instead of failing if the global $wgDebugAPI is set to true. More... | |
| parseMsg ($error) | |
| Return the error message related to a certain array. More... | |
| logFeatureUsage ($feature) | |
| Write logging information for API features to a debug log, for usage analysis. More... | |
| getFinalDescription () | |
| Get final module description, after hooks have had a chance to tweak it as needed. More... | |
| getFinalParams ($flags=0) | |
| Get final list of parameters, after hooks have had a chance to tweak it as needed. More... | |
| getFinalParamDescription () | |
| Get final parameter descriptions, after hooks have had a chance to tweak it as needed. More... | |
| modifyHelp (array &$help, array $options, array &$tocData) | |
| Called from ApiHelp before the pieces are joined together and returned. More... | |
| getModuleProfileName ($db=false) | |
| profileIn () | |
| profileOut () | |
| safeProfileOut () | |
| getProfileTime () | |
| profileDBIn () | |
| profileDBOut () | |
| getProfileDBTime () | |
| Public Member Functions inherited from ContextSource | |
| canUseWikiPage () | |
| Check whether a WikiPage object can be get with getWikiPage(). More... | |
| exportSession () | |
| Export the resolved user IP, HTTP headers, user ID, and session ID. More... | |
| getConfig () | |
| Get the Config object. More... | |
| getContext () | |
| Get the base IContextSource object. More... | |
| getLanguage () | |
| Get the Language object. More... | |
| getOutput () | |
| Get the OutputPage object. More... | |
| getRequest () | |
| Get the WebRequest object. More... | |
| getSkin () | |
| Get the Skin object. More... | |
| getStats () | |
| Get the Stats object. More... | |
| getTiming () | |
| Get the Timing object. More... | |
| getTitle () | |
| Get the Title object. More... | |
| getUser () | |
| Get the User object. More... | |
| getWikiPage () | |
| Get the WikiPage object. More... | |
| msg () | |
| Get a Message object with context set Parameters are the same as wfMessage() More... | |
| setContext (IContextSource $context) | |
| Set the IContextSource object. More... | |
Protected Member Functions | |
| getExamplesMessages () | |
| Protected Member Functions inherited from ApiQueryGeneratorBase | |
| getHelpFlags () | |
| getPageSet () | |
| Get the PageSet object to work on. More... | |
| setContinueEnumParameter ($paramName, $paramValue) | |
| Overridden to set the generator param if in generator mode. More... | |
| Protected Member Functions inherited from ApiQueryBase | |
| getDB () | |
| Get the Query database connection (read-only) More... | |
| getPageSet () | |
| Get the PageSet object to work on. More... | |
| resetQueryParams () | |
| Blank the internal arrays with query parameters. More... | |
| addTables ($tables, $alias=null) | |
| Add a set of tables to the internal array. More... | |
| addJoinConds ($join_conds) | |
| Add a set of JOIN conditions to the internal array. More... | |
| addFields ($value) | |
| Add a set of fields to select to the internal array. More... | |
| addFieldsIf ($value, $condition) | |
| Same as addFields(), but add the fields only if a condition is met. More... | |
| addWhere ($value) | |
| Add a set of WHERE clauses to the internal array. More... | |
| addWhereIf ($value, $condition) | |
| Same as addWhere(), but add the WHERE clauses only if a condition is met. More... | |
| addWhereFld ($field, $value) | |
| Equivalent to addWhere(array($field => $value)) More... | |
| addWhereRange ($field, $dir, $start, $end, $sort=true) | |
| Add a WHERE clause corresponding to a range, and an ORDER BY clause to sort in the right direction. More... | |
| addTimestampWhereRange ($field, $dir, $start, $end, $sort=true) | |
| Add a WHERE clause corresponding to a range, similar to addWhereRange, but converts $start and $end to database timestamps. More... | |
| addOption ($name, $value=null) | |
| Add an option such as LIMIT or USE INDEX. More... | |
| select ($method, $extraQuery=[], array &$hookData=null) | |
| Execute a SELECT query based on the values in the internal arrays. More... | |
| processRow ($row, array &$data, array &$hookData) | |
| Call the ApiQueryBaseProcessRow hook. More... | |
| addPageSubItems ($pageId, $data) | |
| Add a sub-element under the page element with the given page ID. More... | |
| addPageSubItem ($pageId, $item, $elemname=null) | |
| Same as addPageSubItems(), but one element of $data at a time. More... | |
| setContinueEnumParameter ($paramName, $paramValue) | |
| Set a query-continue value. More... | |
| Protected Member Functions inherited from ApiBase | |
| getExamplesMessages () | |
| Returns usage examples for this module. More... | |
| getAllowedParams () | |
| Returns an array of allowed parameters (parameter name) => (default value) or (parameter name) => (array with PARAM_* constants as keys) Don't call this function directly: use getFinalParams() to allow hooks to modify parameters as needed. More... | |
| getWebUITokenSalt (array $params) | |
| Fetch the salt used in the Web UI corresponding to this module. More... | |
| getDB () | |
| Gets a default replica DB connection object. More... | |
| getParameter ($paramName, $parseLimit=true) | |
| Get a value for the given parameter. More... | |
| getWatchlistValue ($watchlist, $titleObj, $userOption=null) | |
| Return true if we're to watch the page, false if not, null if no change. More... | |
| getParameterFromSettings ($paramName, $paramSettings, $parseLimit) | |
| Using the settings determine the value for the given parameter. More... | |
| handleParamNormalization ($paramName, $value, $rawValue) | |
| Handle when a parameter was Unicode-normalized. More... | |
| explodeMultiValue ($value, $limit) | |
| Split a multi-valued parameter string, like explode() More... | |
| parseMultiValue ($valueName, $value, $allowMultiple, $allowedValues) | |
| Return an array of values that were given in a 'a|b|c' notation, after it optionally validates them against the list allowed values. More... | |
| validateLimit ($paramName, &$value, $min, $max, $botMax=null, $enforceLimits=false) | |
| Validate the value against the minimum and user/bot maximum limits. More... | |
| validateTimestamp ($value, $encParamName) | |
| Validate and normalize of parameters of type 'timestamp'. More... | |
| setWatch ($watch, $titleObj, $userOption=null) | |
| Set a watch (or unwatch) based the based on a watchlist parameter. More... | |
| dieContinueUsageIf ($condition) | |
| Die with the $prefix. More... | |
| getDescriptionMessage () | |
| Return the description message. More... | |
| getHelpFlags () | |
| Generates the list of flags for the help screen and for action=paraminfo. More... | |
| getModuleSourceInfo () | |
| Returns information about the source of this module, if known. More... | |
| getDescription () | |
| Returns the description string for this module. More... | |
| getParamDescription () | |
| Returns an array of parameter descriptions. More... | |
| getExamples () | |
| Returns usage examples for this module. More... | |
| useTransactionalTimeLimit () | |
| Call wfTransactionalTimeLimit() if this request was POSTed. More... | |
Private Member Functions | |
| run ($resultPageSet=null) | |
Additional Inherited Members | |
| Static Public Member Functions inherited from ApiQueryBase | |
| static | addTitleInfo (&$arr, $title, $prefix= '') |
| Add information (title and namespace) about a Title object to a result array. More... | |
| Static Public Member Functions inherited from ApiBase | |
| static | truncateArray (&$arr, $limit) |
| Truncate an array to a certain length. More... | |
| static | makeMessage ($msg, IContextSource $context, array $params=null) |
| Create a Message from a string or array. More... | |
| Public Attributes inherited from ApiQueryBase | |
| $fields | |
| $join_conds | |
| $mDb | |
| $options | |
| $tables | |
| $where | |
| Public Attributes inherited from ApiBase | |
| string | $mModulePrefix |
| const | GET_VALUES_FOR_HELP = 1 |
| getAllowedParams() flag: When set, the result could take longer to generate, but should be more thorough. More... | |
| const | LIMIT_BIG1 = 500 |
| Fast query, standard limit. More... | |
| const | LIMIT_BIG2 = 5000 |
| Fast query, apihighlimits limit. More... | |
| const | LIMIT_SML1 = 50 |
| Slow query, standard limit. More... | |
| const | LIMIT_SML2 = 500 |
| Slow query, apihighlimits limit. More... | |
| const | PARAM_DFLT = 0 |
| (null|boolean|integer|string) Default value of the parameter. More... | |
| const | PARAM_ISMULTI = 1 |
| (boolean) Accept multiple pipe-separated values for this parameter (e.g. More... | |
| const | PARAM_TYPE = 2 |
| (string|string[]) Either an array of allowed value strings, or a string type as described below. More... | |
| const | PARAM_MAX = 3 |
| (integer) Max value allowed for the parameter, for PARAM_TYPE 'integer' and 'limit'. More... | |
| const | PARAM_MAX2 = 4 |
| (integer) Max value allowed for the parameter for users with the apihighlimits right, for PARAM_TYPE 'limit'. More... | |
| const | PARAM_MIN = 5 |
| (integer) Lowest value allowed for the parameter, for PARAM_TYPE 'integer' and 'limit'. More... | |
| const | PARAM_ALLOW_DUPLICATES = 6 |
| (boolean) Allow the same value to be set more than once when PARAM_ISMULTI is true? More... | |
| const | PARAM_DEPRECATED = 7 |
| (boolean) Is the parameter deprecated (will show a warning)? More... | |
| const | PARAM_REQUIRED = 8 |
| (boolean) Is the parameter required? More... | |
| const | PARAM_RANGE_ENFORCE = 9 |
| (boolean) For PARAM_TYPE 'integer', enforce PARAM_MIN and PARAM_MAX? More... | |
| const | PARAM_HELP_MSG = 10 |
| (string|array|Message) Specify an alternative i18n documentation message for this parameter. More... | |
| const | PARAM_HELP_MSG_APPEND = 11 |
| ((string|array|Message)[]) Specify additional i18n messages to append to the normal message for this parameter. More... | |
| const | PARAM_HELP_MSG_INFO = 12 |
| (array) Specify additional information tags for the parameter. More... | |
| const | PARAM_VALUE_LINKS = 13 |
| (string[]) When PARAM_TYPE is an array, this may be an array mapping those values to page titles which will be linked in the help. More... | |
| const | PARAM_HELP_MSG_PER_VALUE = 14 |
| ((string|array|Message)[]) When PARAM_TYPE is an array, this is an array mapping those values to $msg for ApiBase::makeMessage(). More... | |
| const | PARAM_SUBMODULE_MAP = 15 |
| (string[]) When PARAM_TYPE is 'submodule', map parameter values to submodule paths. More... | |
| const | PARAM_SUBMODULE_PARAM_PREFIX = 16 |
| (string) When PARAM_TYPE is 'submodule', used to indicate the 'g' prefix added by ApiQueryGeneratorBase (and similar if anything else ever does that). More... | |
| Static Public Attributes inherited from ApiBase | |
| static | $messageMap |
| Array that maps message keys to error messages. More... | |
| Static Protected Member Functions inherited from ApiBase | |
| static | dieDebug ($method, $message) |
| Internal code errors should be reported with this method. More... | |
Detailed Description
A query module to enumerate pages that use a particular prop.
- Since
- 1.21
Definition at line 33 of file ApiQueryPagesWithProp.php.
Constructor & Destructor Documentation
| ApiQueryPagesWithProp::__construct | ( | ApiQuery | $query, |
| $moduleName | |||
| ) |
Definition at line 35 of file ApiQueryPagesWithProp.php.
Member Function Documentation
| ApiQueryPagesWithProp::execute | ( | ) |
Definition at line 39 of file ApiQueryPagesWithProp.php.
References run().
| ApiQueryPagesWithProp::executeGenerator | ( | $resultPageSet | ) |
Definition at line 47 of file ApiQueryPagesWithProp.php.
References run().
| ApiQueryPagesWithProp::getAllowedParams | ( | ) |
Definition at line 130 of file ApiQueryPagesWithProp.php.
References ApiBase\LIMIT_BIG1, ApiBase\LIMIT_BIG2, ApiBase\PARAM_DFLT, ApiBase\PARAM_HELP_MSG, ApiBase\PARAM_HELP_MSG_PER_VALUE, ApiBase\PARAM_ISMULTI, ApiBase\PARAM_MAX, ApiBase\PARAM_MAX2, ApiBase\PARAM_MIN, ApiBase\PARAM_REQUIRED, and ApiBase\PARAM_TYPE.
| ApiQueryPagesWithProp::getCacheMode | ( | $params | ) |
Definition at line 43 of file ApiQueryPagesWithProp.php.
|
protected |
Definition at line 166 of file ApiQueryPagesWithProp.php.
| ApiQueryPagesWithProp::getHelpUrls | ( | ) |
Definition at line 175 of file ApiQueryPagesWithProp.php.
|
private |
- Parameters
-
ApiPageSet $resultPageSet
- Returns
- void
Definition at line 55 of file ApiQueryPagesWithProp.php.
References $count, $dir, $from, $limit, $params, $sort, $title, ApiQueryBase\addFields(), ApiQueryBase\addFieldsIf(), ApiQueryBase\addOption(), ApiQueryBase\addTables(), ApiQueryBase\addTitleInfo(), ApiQueryBase\addWhere(), ApiQueryBase\addWhereFld(), ApiQueryBase\addWhereRange(), as, ApiBase\dieContinueUsageIf(), ApiBase\extractRequestParams(), ApiBase\getModuleName(), ApiBase\getResult(), Title\makeTitle(), ApiResult\META_TYPE, ApiQueryBase\select(), and ApiQueryGeneratorBase\setContinueEnumParameter().
Referenced by execute(), and executeGenerator().
The documentation for this class was generated from the following file:
- includes/api/ApiQueryPagesWithProp.php
