Making WordPress.org

Opened 5 months ago

Last modified 4 months ago

#2996 new task

Add wordpress.org information page about upgrading PHP

Reported by: flixos90 Owned by:
Milestone: Priority: normal
Component: General Keywords:


As discussed in today's and the recent PHP meetings, it would be helpful if wordpress.org provided a page with general information on why and how to upgrade PHP.

Such a page should highlight arguments focused on the user that indicate why such an upgrade is necessary. In addition it should also have a section on how to upgrade. The latter is especially tricky since we don't know how each host handles this. But a general information on where to ask and what to ask will certainly help.

In the future, core could have areas where it highlights that the current PHP version in use is outdated and link to that new page for more information. This ensures we can keep that page up to date without relying on a core release. However it should not be limited to core usage. It could also be used simply as information material to pass around.

It's important to highlight that this is page will need several discussions, most of which will probably happen in the weekly PHP meetings. For now it is here mostly for maintenance.

What we need is:

  • A solid page title and URL.
  • One or more sections with arguments on which problems an unsupported PHP version causes, in general and for WordPress specifically.
  • One or more sections on how to upgrade PHP.
  • Possibly something else: Maybe a list of popular plugins that require a higher PHP version? A list of popular hosts and more elaborate instructions? These and more things will need to be discussed.

Change History (7)

#1 @flixos90
5 months ago

@jdgrimes posted a great draft for something we could show to the users. It may go a bit too much into the direction of an immediate PHP requirement bump of WordPress than we wanna have for the general information page this should become, but I'd nevertheless like to share it here:

Did you know that WordPress has taken special care for years to support legacy versions of PHP, just for you? We know that site owners have enough to worry about already, and so we try to keep things simple by supporting a wide variety of environments right out of the box. However, as PHP 5.2 becomes an older and older technology, the maintenance burden on everyone to stay compatible with it increases, while the number of people who are using it continues to decrease. The time has finally come that we need to move on, for the good of our users. Newer technology like PHP 5.6 and PHP 7 offer many advantages, like improved performance and better security for your site, and making it possible for WordPress and plugins to use more-robust programming techniques. Dropping old technology sometimes causes growing pains (and even a bit of nostalgia), but it is just a part of the evolving web, and we've been working hard to make the transition as easy for you as possible.

This ticket was mentioned in Slack in #core-php by flixos90. View the logs.

5 months ago

This ticket was mentioned in Slack in #core-php by flixos90. View the logs.

4 months ago

#4 @vizkr
4 months ago

Do we actually want to include a how to upgrade section?

Or would this me more of contact your hosting provider kind of data once you bought into the why you need to have PHP upgraded?

#5 @mrahmadawais
4 months ago

I'd love to contribute to this project. Should the contributions be made on GitHub? @flixos90

#6 follow-up: @flixos90
4 months ago

@vizkr The format of that section is yet to be determined. In general yes, it most likely will be instructions on how to approach your hosting provider for this. But we could possibly also do something more advanced, like allowing a GET parameter to set a host and show relevant content for that host if available, which would make it much more intuitive and user-friendly.

@mrahmadawais Awesome! Yes, the current efforts should go into the GitHub repository as it's the easiest to manage. And since it hasn't been shared on this ticket yet, here it is: https://github.com/wp-core-php/servehappy

#7 in reply to: ↑ 6 @mrahmadawais
4 months ago

@flixos90 Great. I have already submitted a PR. Plan to do more as we make progress with this project.

Note: See TracTickets for help on using tickets.