# Site black with PHP 8.1

**URL:** <https://forum.getkirby.com/t/site-black-with-php-8-1/30650>\
**Category:** Questions\
**Created:** [January 31, 2024, 4:34pm UTC](https://forum.getkirby.com/t/site-black-with-php-8-1/30650 "2024-01-31T16:34:14Z")\
**Posts on this page:** 10\
**Page:** 1

<div class="post-metadata">

**Author:** ![tobias93](https://avatars.discourse-cdn.com/v4/letter/t/898d66/32.png) [@tobias93](https://forum.getkirby.com/u/tobias93)\
**Post date:** [January 31, 2024, 4:34pm UTC](https://forum.getkirby.com/t/site-black-with-php-8-1/30650/1 "2024-01-31T16:34:14Z")

</div>

Hi,

I need to set the php version of my server from 8.0 to 8.1.  
But when I change that, the website turns black.

Is there something I need to be aware of or change in the kirby files?

Thank you in advance for any help!

---

<div class="post-metadata">

**Author:** ![texnixe](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/texnixe/32/5754_2.png) [@texnixe](https://forum.getkirby.com/u/texnixe)\
**Post date:** [January 31, 2024, 4:51pm UTC](https://forum.getkirby.com/t/site-black-with-php-8-1/30650/2 "2024-01-31T16:51:50Z")

</div>

What’s your Kirby version?

---

<div class="post-metadata">

**Author:** ![tobias93](https://avatars.discourse-cdn.com/v4/letter/t/898d66/32.png) [@tobias93](https://forum.getkirby.com/u/tobias93)\
**Post date:** [January 31, 2024, 5:02pm UTC](https://forum.getkirby.com/t/site-black-with-php-8-1/30650/3 "2024-01-31T17:02:13Z")

</div>

Not sure where to check this but my kirby/composer.json says

```auto
{
  "name": "getkirby/cms",
  "type": "kirby-cms",
  "description": "The Kirby 3 core",
  "keywords": [
    "kirby",
    "cms",
    "core"
  ],
  "homepage": "https://getkirby.com",
  "version": "3.5.7.1",
  ...

```

---

<div class="post-metadata">

**Author:** ![texnixe](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/texnixe/32/5754_2.png) [@texnixe](https://forum.getkirby.com/u/texnixe)\
**Post date:** [January 31, 2024, 5:14pm UTC](https://forum.getkirby.com/t/site-black-with-php-8-1/30650/4 "2024-01-31T17:14:29Z")

</div>

> [@tobias93](#):
>
> ` "version": "3.5.7.1",`

If that’s your version, then it doesn’t have support for PHP 8.1 yet, see PHP compatibility matrix here:

> **[Requirements](https://getkirby.com/docs/reference/system/requirements#php-version-support-history)**
>
> Kirby has a couple system requirements to work properly

So you have 2 options:

1. Do not update PHP and stick with PHP 8.0
2. Update your Kirby installation with a Kirby version that supports at least PHP 8.1 (at least 3.6.1)

Also keep in mind that if you update your Kirby install to a version that supports PHP 8.1, you need to be aware of breaking changes, that might also break your site.

---

<div class="post-metadata">

**Author:** ![tobias93](https://avatars.discourse-cdn.com/v4/letter/t/898d66/32.png) [@tobias93](https://forum.getkirby.com/u/tobias93)\
**Post date:** [January 31, 2024, 5:18pm UTC](https://forum.getkirby.com/t/site-black-with-php-8-1/30650/5 "2024-01-31T17:18:17Z")

</div>

Okay! What would I need to do to update the Kirby Version?

My page now also shows  
“Change the PHP version to 7.3, 7.4 or 8.0 (PHP 7.4 is recommended)” instead of black screen

---

<div class="post-metadata">

**Author:** ![texnixe](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/texnixe/32/5754_2.png) [@texnixe](https://forum.getkirby.com/u/texnixe)\
**Post date:** [January 31, 2024, 5:21pm UTC](https://forum.getkirby.com/t/site-black-with-php-8-1/30650/6 "2024-01-31T17:21:17Z")

</div>

> [@tobias93](#):
>
> Okay! What would I need to do to update the Kirby Version?

> **[Updates](https://getkirby.com/docs/guide/updates)**
>
> Keep your installations up to date and learn how to migrate from older Kirby versions.

Never update directly on the server without testing locally first.

If you are not experienced doing updates, you might want to get a developer to do this for you. See my comment above about breaking changes. 3.5.x to 3.6.x is an update to a major version.

---

<div class="post-metadata">

**Author:** ![texnixe](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/texnixe/32/5754_2.png) [@texnixe](https://forum.getkirby.com/u/texnixe)\
**Post date:** [January 31, 2024, 5:32pm UTC](https://forum.getkirby.com/t/site-black-with-php-8-1/30650/8 "2024-01-31T17:32:53Z")

</div>

> **[Tags · getkirby/kirby](https://github.com/getkirby/kirby/tags)**
>
> Kirby's core application folder. Contribute to getkirby/kirby development by creating an account on GitHub.

---

<div class="post-metadata">

**Author:** ![tobias93](https://avatars.discourse-cdn.com/v4/letter/t/898d66/32.png) [@tobias93](https://forum.getkirby.com/u/tobias93)\
**Post date:** [January 31, 2024, 5:36pm UTC](https://forum.getkirby.com/t/site-black-with-php-8-1/30650/9 "2024-01-31T17:36:48Z")

</div>

Thank you @texnixe, I will then try to upgrade to the highest version of Kirby 3.

Is there any way to see if anything is not working after upgrading or do I have to check the whole page manually? Or maybe a list of changes that happened between my version and the newest Version 3 ?

---

<div class="post-metadata">

**Author:** ![texnixe](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/texnixe/32/5754_2.png) [@texnixe](https://forum.getkirby.com/u/texnixe)\
**Post date:** [January 31, 2024, 5:42pm UTC](https://forum.getkirby.com/t/site-black-with-php-8-1/30650/10 "2024-01-31T17:42:07Z")

</div>

> [@tobias93](#):
>
> Or maybe a list of changes that happened between my version and the newest Version 3 ?

We have put together a list of all breaking changes since Kirby 3.0 here: [Breaking changes | Kirby CMS](https://getkirby.com/changelog)

Note that if you are using any plugins, you need to check if they are compatible as well.

You would have to go through the site manually, unless you use a tool that visits all your site links.

---

<div class="post-metadata">

**Author:** ![tobias93](https://avatars.discourse-cdn.com/v4/letter/t/898d66/32.png) [@tobias93](https://forum.getkirby.com/u/tobias93)\
**Post date:** [February 1, 2024, 9:26am UTC](https://forum.getkirby.com/t/site-black-with-php-8-1/30650/11 "2024-02-01T09:26:05Z")

</div>

Thank you @texnixe 🙂
