Search…

X3 Photo Gallery Support Forums

Search…
 
User avatar
JMM
Experienced
Topic Author
Posts: 216
Joined: 02 Aug 2021, 11:18

Minimum required PHP extensions?

25 Mar 2026, 22:36

Hello, Karl,

Can you tell me what the minimum/recommended PHP extensions are for X3 to run, please?

A few hours ago, I upgraded my PHP, from v8.4.15 to v8.5.4.

I tested 1 of my X3 websites before upgrading all of my remaining X3 sites to v8.5.4, and I was able to access it fine.  After I upgraded all of my remaining X3 website as well, those too I was able to access fine.

Now, before I get to my problem, in case this is the cause of my problem, I cleaned up my php.ini file, and only enabled settings and extensions that I assumed that I needed.  So previously I was using extensions that I am no longer using at this time with v8.5.4.

After I accessed my X3 sites fine, I then successfully logged into Panel on a few of them and made a change to my "footer", then saved my changes.  Now I am no longer able to access those X3 sites that I made changes in Panel on.  All that happens when I try to access those sites, is I get a blank screen, with a continuously rotating circle.

I have backups from last night of all of my JSON files for each of my X3 sites, in case you feel that one of those files on my affected X3 sites could be the problem.

Most-like it is NOT a problem with the new PHP version that I am using, and instead a problem with one of more required PHP extensions that I have not yet enabled.

In case you can troubleshoot from your end with Developer Tools or some other method, the 2 sites that I made the changes to in Panel and that I am no longer able to access, are:

https://www.aurorawings.me/
https://x3.fusionwings.com/

Thank you in advance.

Regards,
John
 
User avatar
mjau-mjau
X3 Wizard
Posts: 14469
Joined: 30 Sep 2006, 03:37

Re: Minimum required PHP extensions?

26 Mar 2026, 00:52

Hi John,

I know exactly what the problem is, as I have diagnosed this exact issue several times through the years. In your currently non-working websites, if you click "view source" (from any browser), you will see that the source output simply stops somewhere in the middle. This is caused by missing mbstring extension, which I believe is used by TWIG to render templates.
https://www.php.net/manual/en/book.mbstring.php

I can see this is also noted on your diagnostics page:
https://www.aurorawings.me/?diagnostics

Image
 
User avatar
JMM
Experienced
Topic Author
Posts: 216
Joined: 02 Aug 2021, 11:18

Re: Minimum required PHP extensions?

26 Mar 2026, 07:34

mjau-mjau wrote: This is caused by missing mbstring extension, which I believe is used by TWIG to render templates.
That is exactly what the problem was.  Enabling that extension solved my problem.
Thanks for your prompt reply.