[5.8.16]: m230511_000000_field_layout_configs - Formie - Link Field - setName() deprecated

[wolispace]

What happened?

Description

Im trying to upgrade from
Craft 4.16.12 > 5.8.16
Formie 2.2.3 > 3.1.3
Link Field ^2.1 > ^3.0.0-beta

However I wonder if the "Link field" I see in the log below is the new Craft 5 Link field instead of
"sebastianlenz/linkfield": "^3.0.0-beta",

I upgrade my php and MariaDB without issue.

I update my composer.json and rebuild my composer lock but when the migrations run I fails:

*** applying m230511_000000_field_layout_configs
Exception: Formie fields’ name attribute has been deprecated. Use label instead. (/var/www/html/vendor/yiisoft/yii2/base/Component.php:180)

Looking in Formie's code we see it has been deprecated:
https://github.com/verbb/formie/blob/craft-5/src/base/Field.php

My console.log file shows:

2025-09-03 15:36:47 [console.WARNING] [craft\console\actions\ClearCacheAction::run] Error clearing cache Link field element cache: Formie fields’ `name` attribute has been deprecated. Use `label` instead. {"memory":7911104} 
2025-09-03 15:36:47 [console.ERROR] [application] Formie fields’ `name` attribute has been deprecated. Use `label` instead. {"memory":7687184} 
2025-09-03 15:36:48 [console.ERROR] [application] Formie fields’ `name` attribute has been deprecated. Use `label` instead. {"memory":7758120} 
2025-09-03 15:41:50 [console.ERROR] [application] Formie fields’ `name` attribute has been deprecated. Use `label` instead. {"memory":7726848} 

Steps to reproduce

1. Start on Craft and Formie versions listed above, and try to upgrade to Craft 5

Expected behavior

No errors relating to setName() or getName() as they have been deprecated.

Actual behavior

Errors and unable to upgrade to Craft 5

Craft CMS version

5.8.16

PHP version

8.2

Operating system and version

ddev

Database type and version

MariaDB 10.11

Image driver and version

No response

Installed plugins and versions

• "require": {
  "php": "^8.2.0",
  "craftcms/aws-s3": "^2.2.3",
  "craftcms/ckeditor": "^4.10.0",
  "craftcms/cms": "^5.0.0",
  "craftpulse/craft-colour-swatches": "^5.1.0",
  "jalendport/craft-lockout": "^3.0.0-beta.1",
  "nystudio107/craft-emptycoalesce": "^5.0.0",
  "nystudio107/craft-imageoptimize": "^5.0.7",
  "nystudio107/craft-minify": "^5.0.0",
  "nystudio107/craft-seomatic": "^5.1.16",
  "nystudio107/craft-vite": "^5.0.0",
  "ostark/craft-async-queue": "^4.0.0",
  "percipioglobal/craft-password-policy": "^5.0.3",
  "putyourlightson/craft-sherlock": "^5.2.0",
  "sebastianlenz/linkfield": "^3.0.0-beta",
  "spicyweb/craft-neo": "^5.4.5",
  "studioespresso/craft-date-range": "^5.0.0-beta.4",
  "topshelfcraft/wordsmith": "^5.0.0",
  "verbb/expanded-singles": "^3.0.3",
  "verbb/formie": "^3.1.3",
  "verbb/kint": "^4.0.2",
  "verbb/navigation": "^3.0.12",
  "vlucas/phpdotenv": "^v5.6.0"
  },

[linear]

CMS-1583 [5.8.16]: m230511_000000_field_layout_configs - Formie - Link Field - setName() deprecated

[brandonkelly]

Does the CLI output or logs show a stack trace for the deprecation warning? That should help reveal what exactly is calling the deprecated getName() method.

That said, deprecations don’t cause exceptions by default. Guessing you are setting 'throwExceptions' => true in config/app.php which would cause that behavior.

[wolispace]

Wow, thats such a simple fix.

Thanks!

Yes my config/app.php uses my .env, which had HARD_MODE=1

        'deprecator' => [
            'throwExceptions' => App::env('HARD_MODE') ?: false,
        ],

For completeness tho, here is the full stack trace including the second line I forgot to paste above that point to Field.php from Formie:

*** applying m230511_000000_field_layout_configs
Exception: Formie fields’ `name` attribute has been deprecated. Use `label` instead. (/var/www/html/vendor/yiisoft/yii2/base/Component.php:180)
#0 /var/www/html/vendor/verbb/formie/src/base/Field.php(1959): craft\services\Deprecator->log('verbb\\formie\\ba...', 'Formie fields\xE2\x80...')
#1 /var/www/html/vendor/yiisoft/yii2/base/Component.php(180): verbb\formie\base\Field->setName('Name')
#2 /var/www/html/vendor/craftcms/cms/src/helpers/App.php(1540): yii\base\Component->__set('name', 'Name')
#3 /var/www/html/vendor/craftcms/cms/src/base/Model.php(81): craft\helpers\App::configure(Object(verbb\formie\fields\Name), Array)
#4 /var/www/html/vendor/verbb/formie/src/base/Field.php(270): craft\base\Model->__construct(Array)
#5 /var/www/html/vendor/verbb/formie/src/fields/Name.php(114): verbb\formie\base\Field->__construct(Array)
#6 [internal function]: verbb\formie\fields\Name->__construct(Array)
#7 /var/www/html/vendor/yiisoft/yii2/di/Container.php(419): ReflectionClass->newInstanceArgs(Array)
#8 /var/www/html/vendor/yiisoft/yii2/di/Container.php(170): yii\di\Container->build('verbb\\formie\\fi...', Array, Array)
#9 /var/www/html/vendor/yiisoft/yii2/BaseYii.php(365): yii\di\Container->get('verbb\\formie\\fi...', Array, Array)
#10 /var/www/html/vendor/craftcms/cms/src/Craft.php(70): yii\BaseYii::createObject(Array, Array)
#11 /var/www/html/vendor/craftcms/cms/src/helpers/Component.php(143): Craft::createObject(Array)
#12 /var/www/html/vendor/craftcms/cms/src/services/Fields.php(417): craft\helpers\Component::createComponent(Array, 'craft\\base\\Fiel...')
#13 /var/www/html/vendor/craftcms/cms/src/services/Fields.php(444): craft\services\Fields->createField(Array)
#14 [internal function]: craft\services\Fields->craft\services\{closure}(Array, 30)
#15 /var/www/html/vendor/craftcms/cms/src/base/MemoizableArray.php(90): call_user_func(Object(Closure), Array, 30)
#16 /var/www/html/vendor/craftcms/cms/src/base/MemoizableArray.php(171): craft\base\MemoizableArray->normalizeByKey(30)
#17 /var/www/html/vendor/craftcms/cms/src/services/Fields.php(541): craft\base\MemoizableArray->firstWhere('uid', '7a3dfb48-e3f0-4...', true)
#18 /var/www/html/vendor/craftcms/cms/src/fieldlayoutelements/CustomField.php(240): craft\services\Fields->getFieldByUid('7a3dfb48-e3f0-4...')
#19 /var/www/html/vendor/craftcms/cms/src/fieldlayoutelements/CustomField.php(115): craft\fieldlayoutelements\CustomField->getField()
#20 /var/www/html/vendor/craftcms/cms/src/models/FieldLayout.php(430): craft\fieldlayoutelements\CustomField->attribute()
#21 /var/www/html/vendor/craftcms/cms/src/services/Fields.php(996): craft\models\FieldLayout->setTabs(Array)
#22 /var/www/html/vendor/craftcms/cms/src/services/Fields.php(923): craft\services\Fields->_legacyTabsByLayoutId(Object(craft\models\FieldLayout))
#23 /var/www/html/vendor/craftcms/cms/src/services/Fields.php(901): craft\services\Fields->_layoutFromConfig(Array)
#24 [internal function]: craft\services\Fields->craft\services\{closure}(Array, 14)
#25 /var/www/html/vendor/craftcms/cms/src/base/MemoizableArray.php(90): call_user_func(Object(Closure), Array, 14)
#26 /var/www/html/vendor/craftcms/cms/src/base/MemoizableArray.php(76): craft\base\MemoizableArray->normalizeByKey(14)
#27 [internal function]: craft\base\MemoizableArray->craft\base\{closure}(14)
#28 /var/www/html/vendor/craftcms/cms/src/base/MemoizableArray.php(76): array_map(Object(Closure), Array)
#29 /var/www/html/vendor/craftcms/cms/src/base/MemoizableArray.php(104): craft\base\MemoizableArray->normalize(Array)
#30 /var/www/html/vendor/craftcms/cms/src/services/Fields.php(1007): craft\base\MemoizableArray->all()
#31 /var/www/html/vendor/craftcms/cms/src/migrations/m230511_000000_field_layout_configs.php(25): craft\services\Fields->getAllLayouts()
#32 /var/www/html/vendor/craftcms/cms/src/db/Migration.php(50): craft\migrations\m230511_000000_field_layout_configs->safeUp()
#33 /var/www/html/vendor/yiisoft/yii2/console/controllers/BaseMigrateController.php(758): craft\db\Migration->up()
#34 /var/www/html/vendor/craftcms/cms/src/console/controllers/MigrateController.php(373): yii\console\controllers\BaseMigrateController->migrateUp('m230511_000000_...')
#35 [internal function]: craft\console\controllers\MigrateController->actionAll()
#36 /var/www/html/vendor/yiisoft/yii2/base/InlineAction.php(57): call_user_func_array(Array, Array)
#37 /var/www/html/vendor/yiisoft/yii2/base/Controller.php(178): yii\base\InlineAction->runWithParams(Array)
#38 /var/www/html/vendor/yiisoft/yii2/console/Controller.php(180): yii\base\Controller->runAction('all', Array)
#39 /var/www/html/vendor/craftcms/cms/src/console/controllers/MigrateController.php(192): yii\console\Controller->runAction('all', Array)
#40 /var/www/html/vendor/yiisoft/yii2/base/Module.php(552): craft\console\controllers\MigrateController->runAction('all', Array)
#41 /var/www/html/vendor/yiisoft/yii2/console/Application.php(180): yii\base\Module->runAction('migrate/all', Array)
#42 /var/www/html/vendor/craftcms/cms/src/console/Application.php(91): yii\console\Application->runAction('migrate/all', Array)
#43 /var/www/html/vendor/yiisoft/yii2/console/Application.php(147): craft\console\Application->runAction('migrate/all', Array)
#44 /var/www/html/vendor/craftcms/cms/src/console/Application.php(122): yii\console\Application->handleRequest(Object(craft\console\Request))
#45 /var/www/html/vendor/yiisoft/yii2/base/Application.php(384): craft\console\Application->handleRequest(Object(craft\console\Request))
#46 /var/www/html/craft(13): yii\base\Application->run()
#47 {main}
*** failed to apply m230511_000000_field_layout_configs (time: 0.096s)

[brandonkelly]

I’m not super familiar with Formie, but it looks like maybe your form just needs to be resaved, so its Name field stores a label value instead of name.

[wolispace]

Thanks for the suggestion, but I have just tried:

• re-enabling HARD_MODE
• restoring my database
• rebuilding everything
• then re-saving all forms in Formie.

Sadly it had the same problem during the migration.

Do you think this is something I should bring to the attention of the Formie devs?

[brandonkelly]

Sorry, to be clear, I meant you could resave the forms after upgrading. It looks like getName() was deprecated in Formie 3.0.0 (verbb/formie@02c9c0d) so I don’t think resaving them before upgrading to Craft 5 / Formie 3 is going to help.

You might want to report this on Formie’s repo though, as it looks like it wouldn’t be possible to upgrade to Formie 3 without having a deprecation warning get logged/thrown, which is awkward.

[engram-design]

Yeah, it's really down to how our detachment from Craft's fields is handled, and Craft bootstraps fields very early in the process of its app.

But, pretty sure we can use Craft::$app->getIsInMaintenanceMode() to not flag those deprecation warnings, right @brandonkelly ?

[brandonkelly]

@engram-design Go with Craft::$app->updates->getAreMigrationsPending() – that’s a bit more reliable than maintenance mode.

[engram-design]

@brandonkelly glad I asked, I knew there was a function around somewhere!