Q: Winter CMS가 SASS를 컴파일할 때 'parse error: failed at <?php'를 표시하는 이유는 무엇인가요?

알려진 문제로 인해 에디터가 SASS 파일에 '<?php'를 잘못 추가합니다. 영향을 받은 .scss 파일에서 파일 시스템을 통해 (Winter CMS 백엔드를 통하지 않고) 수동으로 '<?php' 태그를 제거하십시오. 제거 후, 정상적으로 에셋을 다시 컴파일하십시오.

Question 1

동적으로 추가된 테마 필드가 Winter CMS partials에 표시되지 않는 이유는 무엇인가요?

Accepted Answer

theme.yaml 파일의 form 섹션에 더미 필드 정의를 추가하세요. 예:
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 fatal error와 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`을 필요로 하는데, 이 패키지에는 기본 Composer 보안 감사에서 차단되는 4개의 공개된 보안 권고가 있습니다.

우회 방법:
1. 기존 프로젝트 업데이트의 경우: 보안 검사를 우회하고 호환되는 Winter Storm 릴리스를 설치하려면 웹 서버 사용자(예: Debian/Ubuntu의 경우 `www-data`)로 `--no-security-blocking` 플래그와 함께 업그레이드를 실행하세요:
```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 파일에서 파일 시스템을 통해 (Winter CMS 백엔드를 통하지 않고) 수동으로 '<?php' 태그를 제거하십시오. 제거 후, 정상적으로 에셋을 다시 컴파일하십시오.

Winter CMS

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트