Question 1

farmOSアップグレード中にdrush updbで「Trait Drupal\farm_form\Traits\FarmFormProtectionTrait not found」を修正する方法は？

Accepted Answer

これは farmOS 3.5.1 から 4.0.0-beta3 へのアップグレードに影響します。キャッシュリビルドが GinContentFormBase を読み込むとき、farm_form モジュールはまだインストールされていません。GinContentFormBase は FarmFormProtectionTrait に依存しています。

回避策: 致命的エラー後に更新コマンドを再実行します。2回目の実行は正常に完了します:

cd /opt/drupal/web
vendor/bin/drush updb

missing-trait エラーで失敗する場合は、次を実行します:

vendor/bin/drush updb

恒久修正: PR #1063 を含む farmOS リリースを使用するか、アップグレード前にそのパッチを適用します。これは更新順序を変更し、farm_entity_update_11400() が実行される前に farm_ui_theme_update_11400() が farm_form をインストールするようにします。

Question 2

farmOS をインストールするときに、drupal/admin_toolbar やその他の drupal/* パッケージが見つからないという Composer エラーを修正するにはどうすればよいですか？

Accepted Answer

Drupal の contributed モジュールは Packagist ではホストされていません。Composer は Drupal のパッケージリポジトリを使用する必要があります。クローンした farmOS ディレクトリで、次を実行します:

composer config repositories.drupal composer https://packages.drupal.org/8
composer install

これにより、drupal/admin_toolbar、drupal/config_update、drupal/geofield、drupal/gin、およびその他の drupal/* 要件が解決可能になります。Docker 以外のデプロイメントでは、ディストリビューションリポジトリを直接クローンするのではなく、公式プロジェクトテンプレートを使用することを推奨します:

# farmOS 3.x
composer create-project farmos/project3 farmos

# farmOS 4.x
composer create-project farmos/project4 farmos

テンプレートはすでに Drupal Composer リポジトリを設定しています。

Question 3

How to fix PHPStan varTag.nativeType 'PHPDoc tag @var with type' errors in Drupal field formatters?

Accepted Answer

This appeared after PHPStan 2.1.44/2.1.45 because a `@var` annotation declares a concrete field item type, while iterating `FieldItemListInterface` natively yields a more generic `FieldItemInterface`.

Preferred fix: override `$items` to the concrete `FieldItemList` type and iterate its `getIterator()` method:

```php
/** @var \Drupal\Core\Field\FieldItemList $items */
/** @var \Drupal\Core\Field\Plugin\Field\FieldType\BooleanItem $item */
foreach ($items->getIterator() as $delta => $item) {
  // $item is now typed as BooleanItem.
}
```

Use the corresponding item class for other formatters, for example:

```php
/** @var \Drupal\Core\Field\Plugin\Field\FieldType\UriItem $item */
/** @var \Drupal\farm_inventory\Plugin\Field\FieldType\InventoryItem $item */
```

`getIterator()` is provided by `\Drupal\Core\TypedData\Plugin\DataType\ItemList`, which `FieldItemList` extends, but it is not declared on `FieldItemListInterface`.

A runtime-safe alternative is to remove the `@var` annotation and narrow with `instanceof`:

```php
foreach ($items as $delta => $item) {
  if (!($item instanceof \Drupal\Core\Field\Plugin\Field\FieldType\BooleanItem)) {
    continue;
  }
}
```

As a temporary suppression, add to `phpstan.neon`:

```yaml
parameters:
    ignoreErrors:
        - identifier: varTag.nativeType
          paths:
            - '*/field/*.php'
            - '*/inventory/*.php'
```

The permanent farmOS fix was commit `a46ae43117ff51d456819f982602a599843b1f13`.

Question 4

farmOS 3.x で Crop family taxonomy CSV をインポートする際の HTTP 500 'trim(): Argument #1 ($string) must be of type string, null given' エラーを修正する方法は？

Accepted Answer

このエラーは、farmOS 3.x の migration TermLookup プラグインのバグが原因です。このプラグインは、欠落または空の parent タクソノミー値を処理しません。恒久的な公式修正は farmOS 4.0.0-beta4 以降のリリースに含まれています。farmOS インストールをこのバージョン以降にアップグレードすると、問題を完全に解決できます。farmOS 3.x での回避策としては、すべての parent フィールド値を空のままにする場合でも、インポート CSV に必ず parent 列（parent ヘッダー行を含む）を含めてください。

Question 5

farmOS でどちらのアセットもファームに割り当てられていない場合に、「Assets must be in the same farm as their parents」をどう修正すればよいですか？

Accepted Answer

これは、Farm Organization モジュールが有効な farmOS 4.x におけるバリデーションのバグです。親/子アセットを保存するとき、バリデーションが 2 つの空の（null）farm 参照を不一致として誤って扱います。これは、バリデーションの条件式を修正し、テストカバレッジを追加することで farmOS PR #1061（https://github.com/farmOS/farmOS/pull/1061）で修正されました。farmOS をこの修正を含むリリースにアップグレードするか、PR のパッチを適用してから、Drupal キャッシュをクリアしてください。一時的な回避策として、サイトをバックアップし、vendor/bin/drush pm:uninstall farm_organization（または drush pmu farm_organization）でモジュールをアンインストールし、アセットを編集し、パッチ適用後に再インストールしてください。

farmOS

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト