Hard deprecation of PageStateEvent, PageStateListener, PageRevisionUpdatedEvent, PageRevisionUpdatedListener

Alex Ghirelli via Wikitech-l <[email protected]> Wed, 18 Mar 2026 18:45:58 +0100
Newsgroups gmane.science.linguistics.wikipedia.technical
Message-ID <CAJzKR=7oETCj--J=T991LkOiG-ZTneGvCdd95qm2BqKeTkoHQQ@mail.gmail.com>
Hello,

Four class aliases under *MediaWiki\Page\Event*, previously soft-deprecated
in the *1.44 release*, are now hard-deprecated:

- *PageStateEvent* → use *PageRecordChangedEvent* directly instead
- *PageStateListener* → use *PageRecordChangedListener* directly instead
- *PageRevisionUpdatedEvent* → use *PageLatestRevisionChangedEvent* directly
instead
- *PageRevisionUpdatedListener* → use
*PageLatestRevisionChangedListener* directly
instead

Since these are PHP *class_alias() *declarations, they cannot emit
*wfDeprecated() *warnings at runtime. Per the Stable Interface Policy, this
email serves as the required announcement.

Removal could come in a few days. A search of known usages across
Wikimedia-hosted repositories is available here:

https://codesearch.wmcloud.org/things/?q=MediaWiki%5C%5C%5C%5C%3FPage%5C%5C%5C%5C%3FEvent%5C%5C%5C%5C%3F%28PageRevisionUpdatedEvent%7CPageStateEvent%7CPageStateListener%7CPageRevisionUpdatedListener%29&files=&excludeFiles=&repos=

Here the list of patches that manage these changes:
https://gerrit.wikimedia.org/r/q/PageRevisionUpdatedListener+is:open

If you maintain code using these names, please update it before then.

For background, see: https://phabricator.wikimedia.org/T417721

Thank you.

Alex Ghirelli
Senior Software Engineer

_______________________________________________
Wikitech-l mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://lists.wikimedia.org/postorius/lists/wikitech-l.lists.wikimedia.org/