Q: macOSではオートロードが正常に動作するのに、LinuxでWinter CMSプラグインの「Class not found」エラーが発生する場合の解決方法

これは、macOS が大文字と小文字を区別しないのに対し、Linux は大文字と小文字を区別するために発生します。Winter CMS のプラグインオートローダーは、一貫性のある PSR-4 のディレクトリ名の大文字小文字表記、または従来の小文字構造のいずれかをサポートしていますが、両者の混在はサポートしていません。 名前空間 `Aic\Account\Classes\DTO\OrderPallet` には、PSR-4 のパスを使用してください: ```text plugins/aic/account/Classes/DTO/OrderPallet.php ``` または、従来の小文字のパスを使用してください: ```text plugins/aic/account/classes/dto/OrderPallet.php ``` `classes/DTO/OrderPallet.php` のようなカスタムパスを維持する必要がある場合は、`composer.json` に明示的な PSR-4 マッピングを追加してください: ```json { "autoload": { "psr-4": { "Aic\\Account\\Classes\\": "classes/", "Aic\\Account\\": "" } } } ``` その後、次を実行してください: ```bash composer dump-autoload ```

Q: Winter CMSでSASSをコンパイルするときに 'parse error: failed at <?php' と表示されるのはなぜですか？

既知の問題により、エディタがSASSファイルに誤って'<?php'を追加します。影響を受けた.scssファイルから、ファイルシステム経由で手動で'<?php'タグを削除してください（Winter CMSバックエンド経由ではありません）。削除後、通常通りアセットを再コンパイルしてください。

Question 1

動的に追加されたテーマフィールドがWinter CMSのパーシャルに表示されないのはなぜですか？

Accepted Answer

theme.yamlファイルのformセクションにダミーのフィールド定義を追加してください。例：
```yaml
form:
  fields:
    dummy:
```
これにより、`cms.theme.extendFormConfig`イベントを介して追加されたフィールドがフロントエンドのパーシャルでアクセス可能になります。このバグ（theme.yamlにフィールドが存在しない場合に発生）は、コミット4655450a4b…で修正されました。恒久的な解決策として、最新のdev-developまたは次の安定版リリースにアップグレードしてください。

Question 2

Winter CMS の FormBuilder::select() エラー「Argument #2 ($list) must be of type array, Collection given」を修正する方法

Accepted Answer

この問題は、ドロップダウンフィールドの `get*Options()` メソッドが配列ではなく Laravel Collection を返した場合に、Winter CMS 1.2.10 で発生します。回避策として、返された Collection に対して `->toArray()` を呼び出してください：

```php
public function getAddressCountriesOptions()
{
    return collect(...)->toArray();
}
```

この問題は Winter CMS 1.2.11 で正式に修正されました。そのため、1.2.11 以降へのアップグレードが恒久的な解決策です。

Question 3

PHP 8.2/8.4 で Command::alert の致命的なエラーと enshrined/svg-sanitize のセキュリティブロックが原因で発生する Winter CMS 1.2 の Composer インストール/アップデート失敗の修正方法

Accepted Answer

根本原因:
1. Winter Storm のバージョン <1.2.14 には、新しい Illuminate Console 依存関係と互換性のない `alert()` メソッドシグネチャが含まれており、PHP 8.2/8.4 で致命的なエラーが発生します。
2. Winter Storm 1.2.14 以降では `enshrined/svg-sanitize ~0.16` が必要ですが、このパッケージには公開済みのセキュリティアドバイザリが 4 件あり、Composer のデフォルトのセキュリティ監査によってブロックされます。

回避策の手順:
1. 既存プロジェクトの更新の場合: Web サーバーユーザー(Debian/Ubuntu の場合は `www-data` など)として、`--no-security-blocking` フラグを付けてアップグレードを実行し、セキュリティチェックをバイパスして互換性のある Winter Storm リリースをインストールします:
```bash
sudo -u www-data composer require 'winter/storm:^1.2.14' -W --no-security-blocking
```
2. 新規の `composer create-project` インストールの場合: create コマンドにフラグを直接追加します:
```bash
sudo -u www-data composer create-project wintercms/winter example.com "dev-develop" --no-security-blocking
```
3. オプションの永続的なバイパス(本番環境では非推奨): 特定のアドバイザリを無視するか、安全でないパッケージのブロックを完全に無効にするには、`composer.json` の `config` セクションに以下を追加します:
```json
"config": {
  "audit": {
    "ignore": ["PKSA-8j6w-3kr7-s9xk", "PKSA-6j95-1jtb-x6wc", "PKSA-cbx2-m9db-bmzd", "PKSA-4g5g-4rkv-myqs"],
    "block-insecure": false
  }
}
```
4. オプションのキャッシュ権限の修正: Composer のキャッシュパスの所有権を更新して、「Cannot create cache directory」という警告を解決します:
```bash
sudo chown -R www-data:www-data /var/www/.cache/composer
```

セキュリティ警告: この回避策は、既知の脆弱性を持つ `enshrined/svg-sanitize` のバージョンをデプロイします。Winter CMS がパッチ適用済みで脆弱性のない依存関係のリリースを使用するアップデートを公開したら、バイパス設定を削除してください。

Question 4

macOSではオートロードが正常に動作するのに、LinuxでWinter CMSプラグインの「Class not found」エラーが発生する場合の解決方法

Accepted Answer

これは、macOS が大文字と小文字を区別しないのに対し、Linux は大文字と小文字を区別するために発生します。Winter CMS のプラグインオートローダーは、一貫性のある PSR-4 のディレクトリ名の大文字小文字表記、または従来の小文字構造のいずれかをサポートしていますが、両者の混在はサポートしていません。

名前空間 `Aic\Account\Classes\DTO\OrderPallet` には、PSR-4 のパスを使用してください:

```text
plugins/aic/account/Classes/DTO/OrderPallet.php
```

または、従来の小文字のパスを使用してください:

```text
plugins/aic/account/classes/dto/OrderPallet.php
```

`classes/DTO/OrderPallet.php` のようなカスタムパスを維持する必要がある場合は、`composer.json` に明示的な PSR-4 マッピングを追加してください:

```json
{
  "autoload": {
    "psr-4": {
      "Aic\Account\Classes\": "classes/",
      "Aic\Account\": ""
    }
  }
}
```

その後、次を実行してください:

```bash
composer dump-autoload
```

Question 5

Winter CMSでSASSをコンパイルするときに 'parse error: failed at <?php' と表示されるのはなぜですか？

Accepted Answer

既知の問題により、エディタがSASSファイルに誤って'<?php'を追加します。影響を受けた.scssファイルから、ファイルシステム経由で手動で'<?php'タグを削除してください（Winter CMSバックエンド経由ではありません）。削除後、通常通りアセットを再コンパイルしてください。

Winter CMS

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト