Question 1

Docker 첫 실행 스크립트가 'Your lock file does not contain a compatible set of packages' 오류와 함께 실패하는 이유는 무엇인가요?

Accepted Answer

이 오류는 Docker 컨테이너(PHP 7.4)와 PHP 8.1 이상을 요구하는 패키지 요구 사항 간의 PHP 버전 불일치와, 오래된 lock 파일 제약 조건이 결합되어 발생합니다. 해결 방법: 1) Dockerfile 기본 이미지를 PHP 8.1+ 버전(예: php:8.1-fpm)으로 업데이트하고 컨테이너를 다시 빌드합니다. 2) 컨테이너를 시작한 후 'composer update --with-all-dependencies'를 실행하여 충돌하는 패키지 버전(예: specshaper/encrypt-bundle과 doctrine/orm)을 해결합니다. 여전히 문제가 발생하면 composer.json을 수동으로 편집하여 doctrine/common이나 기타 충돌하는 패키지의 호환 가능한 버전을 허용합니다. 이러한 단계는 환경을 현재 의존성 요구 사항에 맞춥니다. 프로젝트 v2.0에서는 셀프 호스팅이 간소화되어 이러한 레거시 충돌을 피할 수 있습니다.

Question 2

애플리케이션에 CSRF 토큰이 누락된 경우 CSRF 취약점을 어떻게 수정하나요?

Accepted Answer

사용자 세션에 연결된 예측 불가능한 CSRF 토큰을 추가합니다. 모든 상태 변경 요청(폼, AJAX)에 토큰을 포함시킵니다. 서버 측에서 작업을 처리하기 전에 토큰을 엄격하게 검증합니다. 기존 프레임워크 라이브러리(예: Spring Security, Django CSRF)를 사용하거나 수동으로 구현합니다: 로그인 시 높은 엔트로피의 토큰을 생성하고, 세션에 저장하며, 폼에 숨김 필드로 포함시키고, 제출 시 검증합니다.

Question 3

Personal Management System에서 저장 후 캘린더 일정이 UTC로 되돌아가는 문제를 해결하는 방법

Accepted Answer

이는 백엔드 또는 컨테이너 설정 문제가 아닌, 확인된 프론트엔드 버그입니다. 캘린더는 일정 생성 시 로컬 시간을 올바르게 표시하지만, `TuiCalendarService.ts`의 결함 있는 타임존 로직으로 인해 저장 후 프론트엔드가 UTC 형식의 날짜 데이터를 백엔드로 전송하게 됩니다. php-fpm 컨테이너의 `TZ` 환경 변수를 조정하거나 localtime 볼륨을 마운트해도 이 문제는 해결되지 않습니다.
임시 해결 방법: 일정을 생성할 때 로컬 타임존의 UTC 오프셋을 수동으로 더하세요 (예: Europe/Berlin 타임존의 경우 2시간 추가).
소스 코드 배포의 경우: `TuiCalendarService.ts`의 타임존 처리 로직을 수정한 후 `npm run build`를 실행하여 프론트엔드를 다시 빌드하세요. 이 버그는 공식 프론트엔드 리라이트에서 수정되었지만, 리라이트의 정식 안정 버전 출시는 아직 몇 달 남았습니다.

Question 4

Personal Management System에서 mailpit Docker 빌드 실패와 PHP autoload 파일 누락 문제를 어떻게 해결하나요?

Accepted Answer

로컬에서 빌드하는 대신 사전 빌드된 Mailpit 이미지를 사용하세요. `docker-compose.yml`의 `pms-mail` 서비스 구성을 다음으로 교체하세요:

```yaml
pms-mail:
  container_name: pms-mail
  hostname: pms-mail
  image: axllent/mailpit:latest
  restart: always
  tty: true
  ports:
    - "8082:8025"
    - "1025:1025"
  volumes:
    - pms-mailpit-db:/data
```

그런 다음 서비스를 시작하세요:

```bash
docker compose up -d pms-mail
```

nginx/PHP에서 autoload 파일이 누락되었다고 보고하는 경우, php-fpm 컨테이너 내부에서 Composer의 autoloader를 다시 생성하세요:

```bash
docker exec -it <php-fpm_container_name_or_id> sh
composer dump-autoload
exit
```

마지막으로 스택을 재시작하세요:

```bash
docker compose restart
```

이 해결 방법은 Ubuntu 20.04 및 24.04에서 새로 설치한 환경에 대해 보고되었습니다.

Personal Management System

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트