Create Task
Maniphest T413223

Migrate Wikimedia production from PHP 8.3 to PHP 8.5
Open, In Progress, MediumPublic
Actions

Description

T360995: Migrate Wikimedia production from PHP 8.1 to PHP 8.3 | [None yet]

Details about each step at https://wikitech.wikimedia.org/wiki/PHP_upgrade_process_for_MediaWiki

Preparation for MediaWiki (Jan–Mar 2026):

Preparation for WMF (Jul–Aug 2026):

  • SRE: Create Debian packages for PHP 8.5 and upload to apt.wikimedia.org. T432983 Aug 2026.
  • CI: Switch PHP 8.5 images in integration/config.git from sury.org to wikimedia.org and apply to Jenkins jobs. T433254 Aug 2026.
  • DX: Switch PHP 8.5 images in releng/dev-images.git from sury.org to wikimedia.org and apply update to MediaWiki-Docker. T413817 Aug 2026
  • SRE: Create production images for PHP 8.5 and add new flavour to MediaWiki deployments. T432988
  • SRE: Generate and deploy title-case mapping in MediaWiki configuration (wmf-config/UcfirstOverrides.php). T432985
  • SRE: Switch mw-debug/next to PHP 8.5 images, for public opt-in testing via WikimediaDebug. T432989
  • Beta Cluster: Switch to PHP 8.5, includes writing Puppet changes to support PHP 8.5 on baremetal.
  • SRE: Change Scap to use PHP 8.5 images when invoking maintenance scripts, and upgrade Scap in Beta Cluster and production. T432989
  • DX: Switch Catalyst/Patchdemo to PHP 8.5. T435368

Test (Aug–Sep 2026):

  • MW: Start monitoring and fixing deprecation warnings as found in Logstash.
  • QTE, MW, SRE: One week for validation and end-to-end testing via WikimediaDebug "next" and Beta Cluster.
  • SRE, MW: Benchmarking for PHP 8.5, check specific well-known workloads to identify regressions or suboptimal configurations. T435072
  • SRE, MW: Update the production parsoid testing environment to PHP 8.5 and work with Content Transform Team to validate its operation.

Rollout (Oct–Nov 2026):

  • SRE: Ramp up mw-api-ext and mw-web cluster (cookie-based).
  • SRE: Ramp up mw-api-int and mw-jobrunner.
  • SRE: Ramp up mw-api-ext and mw-web cluster (remaining).
  • SRE: Switch other mw-on-k8s server groups (mw-script, mw-cron, mw-experimental, mediawiki-dumps-legacy, etc.) and the deployment server.

Post-rollout (Nov–Dec 2026):

  • SRE: Turn down cookie-based routing and other "next" handling, validating that no workloads still run on the old PHP version (which would hard-fail at this point).
  • SRE: Remove emulation of old-PHP title-case mapping.

People on point

Beta cluster: TBD
CI: @Jdforrester-WMF
MW engineering: TBD
RelEng: @hashar
QTE: TBD
SRE: @Raine

Related Objects
Search...

StatusSubtypeAssignedTask
 In ProgressNoneT413223 Migrate Wikimedia production from PHP 8.3 to PHP 8.5
 ResolvedJdforrester-WMFT386108 Make PHP 8.4 voting on development (master) branch of MW ecosystem (core, vendor, extensions, skins, libraries) in CI
 ResolvedcscottT409283 Parsoid fails on PHP 8.4+ during MW installation with 'Error: Class "Wikimedia\Parsoid\DOM\HTMLDocument" not found'
 ResolvedJdforrester-WMFT415955 Ensure that all Wikimedia-deployed code passes PHP 8.4 CI
 ResolvedmatthiasmullieT415448 Test failures from MoveLeadParagraphTransformTest::testIdentifyInfoboxElement on PHP 8.4
 ResolvedUniversal_OmegaT417994 DiscussionTools CommentModifierTest::testAddReplyLink test failure on PHP 8.4
 ResolvedJdforrester-WMFT411814 Make PHP 8.5 voting on development (master) branch of MW ecosystem (core, vendor, extensions, skins, libraries) in CI
 ResolvedJdforrester-WMFT410414 Enable testing on PHP 8.5
 ResolvedJdforrester-WMFT410415 Missing PHP 8.5 packages at deb.sury.org
 ResolvedJdforrester-WMFT419070 Ensure that all Wikimedia-deployed code passes PHP 8.5 CI
 ResolvedneriahT419069 PHP 8.5 CI failure in CirrusSearch: "Using null as an array offset is deprecated, use an empty string instead"
 ResolvedneriahT419085 PHP 8.5 CI failure in Flow: "Using null as an array offset is deprecated, use an empty string instead"
 ResolvedJdforrester-WMFT419087 PHP 8.5 CI failure in GrowthExperiments: "Using null as an array offset is deprecated, use an empty string instead"
 ResolvedneriahT419086 PHP 8.5 CI failure in ImageSuggestions: "Using null as an array offset is deprecated, use an empty string instead"
 ResolvedJdforrester-WMFT419088 PHP 8.5 CI failure in Kartographer: "Using null as an array offset is deprecated, use an empty string instead"
 ResolvedneriahT419071 PHP 8.5 CI failure in ORES: "Using null as an array offset is deprecated, use an empty string instead"
 ResolvedneriahT419072 PHP 8.5 CI failure in SecurePoll: "Using null as an array offset is deprecated, use an empty string instead"
 ResolvedneriahT419068 PHP 8.5 CI failure in Translate: "Using null as an array offset is deprecated, use an empty string instead"
 ResolvedABreault-WMFT419090 PHP 8.5 CI failure in Parsoid: "Using null as an array offset is deprecated, use an empty string instead"
 ResolvedneriahT420260 PHP 8.5 CI failure in Wikibase: "Using null as an array offset is deprecated, use an empty string instead"
 ResolvedJdforrester-WMFT420261 PHP 8.5 CI failure in WikibaseCirrusSearch: "Increment on non-numeric string is deprecated, use str_increment() instead"
 ResolvedJdforrester-WMFT420262 PHP 8.5 CI failure in WikibaseMediaInfo: "Using null as an array offset is deprecated, use an empty string instead"
 ResolvedLucas_Werkmeister_WMDET423185 PHP 8.5 CI failure in Wikibase: additional null-as-array-offset/key deprecations
 ResolvedaudeT424259 ReadingLists tests are failing on Jenkins in `quibble-vendor-mysql-php85`
 ResolvedRaineT432983 [PHP 8.5] Create Debian packages for PHP 8.5
 In ProgressRaineT432985 [PHP 8.5] Generate and deploy title-case mapping in MediaWiki configuration (wmf-config/UcfirstOverrides.php)
 ResolvedRaineT432988 [PHP 8.5] Create production images for PHP 8.5 and add new flavour to MediaWiki deployments
 OpenRaineT432989 [PHP 8.5] Switch mw-debug/next and Scap to PHP 8.5 images
 OpenNoneT435072 [PHP 8.5] Benchmark APCu settings
 OpenNoneT435393 Beta Cluster: Switch to PHP 8.5, includes writing Puppet changes to support PHP 8.5 on baremetal

Event Timeline

Krinkle created this task.Dec 19 2025, 3:03 PM
Restricted Application added a subscriber: Aklapper. · View Herald TranscriptDec 19 2025, 3:03 PM
Krinkle renamed this task from Migrate Wikimedia production from PHP 8.4 to PHP 8.4 or PHP 8.5 to Migrate Wikimedia production from PHP 8.3 to PHP 8.4 or PHP 8.5.EditedDec 19 2025, 3:04 PM
Krinkle mentioned this in T360995: Migrate Wikimedia production from PHP 8.1 to PHP 8.3.
Krinkle added a subscriber: Novem_Linguae.
In T360995#11467234, @Novem_Linguae wrote:

Any thoughts yet on what version of PHP we should target next? 8.4 or 8.5? Picking this would let us create the next ticket in the series, since this one is close to wrapping up.

Not yet. I expect we'll decide this early next year in January as part of the MW 1.46 release (due May 2026). Right now, MediaWiki does not yet officially support either PHP 8.4 or PHP 8.5:

MediaWiki 1.46 will be released in May 2026 (https://www.mediawiki.org/wiki/Version_lifecycle). The next annual PHP upgrade will in Q1 (July-September).

If we add support for PHP 8.4 and PHP 8.5 in MW 1.46, I suggest we upgrade WMF straight there as well.

If we don't think that's feasible, or if we try but run into a problem we can't solve by July/August, then we may want to upgrade to PHP 8.4 first.

Novem_Linguae awarded a token.Dec 19 2025, 3:07 PM
LucasWerkmeister mentioned this in T410883: Support HTTP QUERY method as standard alternative to Promise-Non-Write-API-Action header.Dec 19 2025, 4:11 PM
A_smart_kitten subscribed.Dec 19 2025, 4:44 PM
SomeRandomDeveloper subscribed.Dec 19 2025, 8:58 PM
lcawte subscribed.Dec 30 2025, 12:25 AM
Jdforrester-WMF subscribed.Jan 5 2026, 5:29 PM
MSantos moved this task from Inbox, needs triage to MW Release Working Group on the MediaWiki-Engineering board.Jan 7 2026, 2:34 PM
MSantos subscribed.Jan 7 2026, 2:42 PM

I say we should aim for PHP 8.5. The reason for that is that with PHP 8.5, we are catching up with active support from PHP.

I understand that it might be a stretch to prepare it for the upgrade window (FY26-27 Q1), but it would be good to push for it and see which blockers are raised.

TehKittyCat subscribed.Jan 8 2026, 6:26 PM
Blake triaged this task as Medium priority.Jan 15 2026, 9:43 AM
Blake added a project: ServiceOps-Upgrades-Hardware.
Blake added a project: ServiceOps.Jan 15 2026, 11:47 AM
Blake moved this task from Inbox to Backlog on the ServiceOps board.Jan 15 2026, 12:05 PM
Krinkle renamed this task from Migrate Wikimedia production from PHP 8.3 to PHP 8.4 or PHP 8.5 to Migrate Wikimedia production from PHP 8.3 to PHP 8.5.Jan 26 2026, 3:07 PM
Krinkle added subtasks: T386108: Make PHP 8.4 voting on development (master) branch of MW ecosystem (core, vendor, extensions, skins, libraries) in CI, T411814: Make PHP 8.5 voting on development (master) branch of MW ecosystem (core, vendor, extensions, skins, libraries) in CI.
ArielGlenn subscribed.Jan 26 2026, 6:11 PM
Michael subscribed.Jan 26 2026, 7:18 PM
MLechvien-WMF removed a project: serviceops-deprecated.Feb 2 2026, 9:48 AM
Jdforrester-WMF closed subtask T386108: Make PHP 8.4 voting on development (master) branch of MW ecosystem (core, vendor, extensions, skins, libraries) in CI as Resolved.Mar 2 2026, 10:09 PM
A_smart_kitten mentioned this in T407430: Upgrade MediaWiki-Docker PHP images to PHP 8.5.Mar 4 2026, 1:13 PM
Krinkle updated the task description. (Show Details)Mar 4 2026, 3:37 PM
Krinkle updated the task description. (Show Details)
Jdforrester-WMF updated the task description. (Show Details)Mar 4 2026, 4:29 PM
Paladox subscribed.Mar 4 2026, 5:36 PM
Novem_Linguae updated the task description. (Show Details)Mar 4 2026, 9:24 PM
Jdforrester-WMF closed subtask T411814: Make PHP 8.5 voting on development (master) branch of MW ecosystem (core, vendor, extensions, skins, libraries) in CI as Resolved.Apr 23 2026, 4:38 PM
Jdforrester-WMF updated the task description. (Show Details)Apr 27 2026, 10:16 PM
MLechvien-WMF moved this task from Backlog to Scheduled (this Q) on the ServiceOps board.Jun 29 2026, 9:55 AM
MLechvien-WMF added subscribers: Raine, MLechvien-WMF.

@Raine to create subtasks for what needs to be done in Q1

Scott_French subscribed.Jul 20 2026, 9:14 PM
Raine created subtask T432983: [PHP 8.5] Create Debian packages for PHP 8.5.Thu, Jul 23, 3:46 PM
Raine created subtask T432985: [PHP 8.5] Generate and deploy title-case mapping in MediaWiki configuration (wmf-config/UcfirstOverrides.php).
Raine created subtask T432988: [PHP 8.5] Create production images for PHP 8.5 and add new flavour to MediaWiki deployments.Thu, Jul 23, 4:00 PM
Raine created subtask T432989: [PHP 8.5] Switch mw-debug/next and Scap to PHP 8.5 images.
Raine updated the task description. (Show Details)Thu, Jul 23, 4:22 PM
Raine changed the status of subtask T432983: [PHP 8.5] Create Debian packages for PHP 8.5 from Open to In Progress.Mon, Jul 27, 12:35 PM
Jdforrester-WMF updated the task description. (Show Details)Mon, Jul 27, 2:13 PM
Jdforrester-WMF updated the task description. (Show Details)Fri, Aug 14, 6:35 PM
Raine closed subtask T432983: [PHP 8.5] Create Debian packages for PHP 8.5 as Resolved.Mon, Aug 17, 11:28 AM
Raine created subtask T435072: [PHP 8.5] Benchmark APCu settings.Mon, Aug 17, 11:34 AM
Raine updated the task description. (Show Details)
Jdforrester-WMF updated the task description. (Show Details)Mon, Aug 17, 9:42 PM
Jdforrester-WMF updated the task description. (Show Details)Mon, Aug 17, 9:58 PM
Jdforrester-WMF updated the task description. (Show Details)
Raine changed the status of subtask T432988: [PHP 8.5] Create production images for PHP 8.5 and add new flavour to MediaWiki deployments from Open to In Progress.Tue, Aug 18, 12:27 PM
Raine updated the task description. (Show Details)Tue, Aug 18, 12:41 PM
Raine added a subscriber: hashar.
Jdforrester-WMF updated the task description. (Show Details)Tue, Aug 18, 5:14 PM
brennen changed the task status from Open to In Progress.Wed, Aug 19, 4:29 PM
brennen mentioned this in T435368: Migrate Patchdemo & Catalyst to PHP 8.5.
brennen added a project: User-brennen.
brennen updated the task description. (Show Details)
brennen moved this task from Backlog to Next on the User-brennen board.Wed, Aug 19, 4:54 PM
brennen moved this task from Next to Radar on the User-brennen board.
Raine changed the status of subtask T432985: [PHP 8.5] Generate and deploy title-case mapping in MediaWiki configuration (wmf-config/UcfirstOverrides.php) from Open to In Progress.Wed, Aug 19, 6:44 PM
Raine closed subtask T432988: [PHP 8.5] Create production images for PHP 8.5 and add new flavour to MediaWiki deployments as Resolved.Wed, Aug 19, 7:01 PM
Raine updated the task description. (Show Details)Wed, Aug 19, 7:22 PM
bd808 created subtask T435393: Beta Cluster: Switch to PHP 8.5, includes writing Puppet changes to support PHP 8.5 on baremetal.Wed, Aug 19, 7:30 PM
Content licensed under Creative Commons Attribution-ShareAlike (CC BY-SA) 4.0 unless otherwise noted; code licensed under GNU General Public License (GPL) 2.0 or later and other open source licenses. By using this site, you agree to the Terms of Use, Privacy Policy, and Code of Conduct. · Wikimedia Foundation · Privacy Policy · Code of Conduct · Terms of Use · Disclaimer · CC-BY-SA · GPL · Credits