XenForo news

XenForo PHP Version Requirements: A 2.2 and 2.3 Checklist

XenForo posted a PSA about updating PHP. Here is a short checklist for 2.2 and 2.3 admins who run their own forum, with no guessed versions or dates.

D.C Style · 4 min read
Share on X
Illustration of a server with a checklist and a tag showing a version number
On this page

XenForo has a PSA (public service announcement) thread on its community called "PSA: Update your PHP immediately". If you run a XenForo 2.2 or 2.3 forum yourself, read it, check your PHP version, and plan an update. This post turns the XenForo PHP version requirements question into a short checklist.

Note:
We could not read the PSA text while writing this. So we do not name PHP versions, deadlines or affected releases. Read the original first: PSA: Update your PHP immediately.

What the XenForo PSA says about PHP

We can only tell you that the thread exists and that its title asks admins to update PHP. The details are in the thread itself. We will not repeat them from memory, because a wrong number could send you to the wrong version.

When you open the PSA, write down three things:

  1. Which PHP versions it says are a problem.
  2. Which PHP versions it says you should move to.
  3. Whether it asks you to update XenForo too.

Those answers tell you which PHP version to pick for XenForo, and they drive every step below.

Which XenForo versions are affected

This checklist is written for 2.2 and 2.3 admins. Whether the PSA covers both, and whether a XenForo update is needed first, is for the PSA to say. Compare it with your own version before you act.

If you are not sure what your forum runs, our guide to finding your XenForo, PHP and MySQL versions shows where to look.

How to check your PHP version

You need your current PHP version before you can compare it with the PSA. The guide above covers it. Your host's control panel may also show the PHP version, often in a PHP or software section.

Write the number down exactly as shown. Note your MySQL or MariaDB version too, so you have the full picture.

What to do before you update PHP for XenForo

Changing PHP changes the engine under your whole forum. A little prep keeps the risk low.

  1. Back up files and database. Make sure you can restore both.
  2. Read the PSA fully. Confirm the target PHP version.
  3. Check XenForo. If the PSA says to update XenForo first, do that first.
  4. Pick a quiet time. Leave a window when you can test.
  5. Plan a way back. Check whether your host lets you switch PHP versions back.
Tip:
If your host offers a staging copy, try the PHP change there first.

Check your add-ons against the new PHP version

Add-ons can break after a PHP change. Before you switch, list every add-on and check that each has a current version that supports your XenForo release. Each add-on page lists the XenForo version it needs. For example, Smart Mail Router needs XenForo 2.2 or later.

After the change, test the parts of your forum that talk to outside services. Send a test email and confirm it arrives. Upload a file and open it.

If you use Google Drive Attachments, it moves attachments to Google Drive, in direct or local cache mode. It needs XenForo 2.2.0 or later. Its admin dashboard has a test option for the Google connection, so you can check it after the PHP change.

What to do if your host can't offer the PHP version you need

Your host may not offer the PHP version you need. If it is not in your control panel, work through these steps:

  1. Ask support if the version is available, and when.
  2. Ask if a different plan or server has it.
  3. If not, plan a move to a host that does. Test the new server before you switch your domain.

What to do next

  1. Read the PSA on xenforo.com.
  2. Check your PHP and XenForo versions.
  3. Back up, then update PHP as the PSA directs.
  4. Test posting, attachments, email and your add-ons.

For more news like this, see our XenForo news category.

Sources