[5.x] PHP 8.4 Support

[duncanmcclean]

This pull request adds PHP 8.4 support.

Statamic itself is compatible with PHP 8.4, however, some packages we're using still need to be updated to support it, otherwise users may see deprecation notices.

• voku/portable-ascii: Update ASCII.php for PHP 8.4 compatibility voku/portable-ascii#105
• thecodingmachine/safe: [PHP 8.4] Fixes for implicit nullability deprecation thecodingmachine/safe#441
• rebing/graphql-laravel: Fixes for implicit nullability deprecation rebing/graphql-laravel#1152

[duncanmcclean]

When you run the test suite locally, you'll see a couple of deprecation warnings from Carbon:

Deprecated: Carbon\Traits\Date::getDaysFromStartOfWeek(): Implicitly marking parameter $weekStartsAt as nullable is deprecated, the explicit nullable type must be used instead in /Users/duncan/Code/Statamic/cms/vendor/nesbot/carbon/src/Carbon/Traits/Date.php on line 1394

Deprecated: Carbon\Traits\Date::setDaysFromStartOfWeek(): Implicitly marking parameter $weekStartsAt as nullable is deprecated, the explicit nullable type must be used instead in /Users/duncan/Code/Statamic/cms/vendor/nesbot/carbon/src/Carbon/Traits/Date.php on line 1412

Deprecated: Carbon\Traits\Date::utcOffset(): Implicitly marking parameter $minuteOffset as nullable is deprecated, the explicit nullable type must be used instead in /Users/duncan/Code/Statamic/cms/vendor/nesbot/carbon/src/Carbon/Traits/Date.php on line 1481

Deprecated: Carbon\Traits\Localization::locale(): Implicitly marking parameter $locale as nullable is deprecated, the explicit nullable type must be used instead in /Users/duncan/Code/Statamic/cms/vendor/nesbot/carbon/src/Carbon/Traits/Localization.php on line 447

Deprecated: Carbon\Traits\Test::setDefaultTimezone(): Implicitly marking parameter $date as nullable is deprecated, the explicit nullable type must be used instead in /Users/duncan/Code/Statamic/cms/vendor/nesbot/carbon/src/Carbon/Traits/Test.php on line 203

Deprecated: Return type of Carbon\Traits\Date::createFromTimestamp($timestamp, $tz = null) should either be compatible with DateTime::createFromTimestamp(int|float $timestamp): static, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /Users/duncan/Code/Statamic/cms/vendor/nesbot/carbon/src/Carbon/Traits/Timestamp.php on line 29

Deprecated: Carbon\CarbonTimeZone::toOffsetName(): Implicitly marking parameter $date as nullable is deprecated, the explicit nullable type must be used instead in /Users/duncan/Code/Statamic/cms/vendor/nesbot/carbon/src/Carbon/CarbonTimeZone.php on line 158

Deprecated: Carbon\CarbonTimeZone::toOffsetTimeZone(): Implicitly marking parameter $date as nullable is deprecated, the explicit nullable type must be used instead in /Users/duncan/Code/Statamic/cms/vendor/nesbot/carbon/src/Carbon/CarbonTimeZone.php on line 172

Deprecated: Carbon\CarbonTimeZone::toRegionName(): Implicitly marking parameter $date as nullable is deprecated, the explicit nullable type must be used instead in /Users/duncan/Code/Statamic/cms/vendor/nesbot/carbon/src/Carbon/CarbonTimeZone.php on line 188

Deprecated: Carbon\CarbonTimeZone::toRegionTimeZone(): Implicitly marking parameter $date as nullable is deprecated, the explicit nullable type must be used instead in /Users/duncan/Code/Statamic/cms/vendor/nesbot/carbon/src/Carbon/CarbonTimeZone.php on line 230

These deprecations have been addressed in Carbon 3, however upgrading to Carbon 3 would involve breaking changes.

We might have to live with the deprecation warnings for now until we can upgrade in Statamic 6.

[duncanmcclean]

If you have GraphQL enabled, you'll see a bunch of deprecation warnings from the thecodingmachine/safe package (which is used by graphql-laravel). I've subscribed to various PRs in that package, hoping one of them will get merged soon. 🤞

Unfortunatley, deprecation warnings prevent the Control Panel from working. 😬

[crynobone]

These deprecations have been addressed in Carbon 3, however upgrading to Carbon 3 would involve breaking changes.

You might want to manually require ^3.4 on CI for PHP 8.4 build, this solved the issue on laravel/framework

[jasonvarga]

Thank you!

[duncanmcclean]

Thanks, @crynobone!

[jasonvarga]

Ok so like Duncan said, we can't upgrade to Carbon v3 just yet since it would require breaking changes. We'll do it for Statamic v6.

In the mean time, you can get rid of the deprecation notices by doing this:

public/index.php

<?php

use Illuminate\Http\Request;

+error_reporting(E_ALL & ~E_DEPRECATED);

define('LARAVEL_START', microtime(true));

artisan and please

#!/usr/bin/env php
<?php

use Symfony\Component\Console\Input\ArgvInput;

+error_reporting(E_ALL & ~E_DEPRECATED);

define('LARAVEL_START', microtime(true));

Also, composer require shish/safe will get rid of the Safe\* deprecation warnings related to GraphQL usage. This is temporary until thecodingmachine/safe releases a real fix.

Or, just stick to PHP 8.3.