Question 1

Leantime Docker 이미지를 PostgreSQL에 연결할 때 'could not find driver' 오류를 수정하는 방법

Accepted Answer

공식 Leantime Docker 이미지(v3.6.0 및 이전 버전)에는 PostgreSQL PDO 드라이버가 없어서 LEAN_DB_TYPE=postgres로 설정 시 'PDOException: could not find driver' 오류가 발생합니다. 해결 방법으로, 다음 드라이버를 사용하여 이미지를 다시 빌드하십시오:
FROM leantime/leantime:3.6.0
USER root
RUN apk add --no-cache libpq libpq-dev && docker-php-ext-install pdo_pgsql && apk del libpq-dev
USER www-data
적절한 수정 사항은 PR #3447에 준비되어 있으며 v3.7.0+ 릴리스에 포함될 예정입니다. 현재로서는 사용자 정의 Dockerfile을 사용하거나 공식 업데이트를 기다리십시오.

Question 2

PHP 8에서 Leantime 플러그인 마켓플레이스 HTTP 500 오류 "Cannot assign null to property MarketplacePlugin::$excerpt"를 해결하는 방법

Accepted Answer

이 문제는 marketplace API 필드가 `null`일 수 있지만 `$excerpt`와 `$vendorId` 같은 프로퍼티가 null을 허용하지 않는 타입으로 선언되어 있기 때문에 PHP 8.0+ 환경의 Leantime 3.7.3에 영향을 미칩니다. 업스트림 수정은 PR #3356에 있으며, 관련된 `json_decode(null)` 방어 코드는 PR #3359에 있습니다. 해당 PR들이 포함된 릴리스가 제공되면 그 버전으로 업그레이드하세요.

3.7.3에서 즉시 적용 가능한 임시 해결 방법: `app/Domain/Plugins/Models/MarketplacePlugin.php`를 편집하여 API에서 가져오는 프로퍼티를 nullable로 변경하세요:

```php
public ?string $identifier = '';
public ?string $name = '';
public ?string $excerpt = '';
public ?string $description = '';
public ?string $imageUrl = '';
public ?string $vendorDisplayName = '';
public ?int    $vendorId = 0;
public ?string $vendorEmail = '';
public ?string $marketplaceUrl = '';
public ?string $type = 'marketplace';
public ?string $marketplaceId = '';
public ?string $version = '';
public ?string $icon = '';
```

`$startingPrice`, `$calculatedMonthlyPrice`, `$license`, `$rating`처럼 이미 nullable인 필드는 그대로 두세요.

심층 방어(defense in depth)를 위해 `app/Core/Support/Build.php::setValue()`에서 원시 할당 전에 null 처리를 추가하세요:

```php
$reflectionType = $property->getType();

if ($value === null && $reflectionType instanceof \ReflectionNamedType && !$reflectionType->allowsNull()) {
    $value = $reflectionType->getName() === 'int' ? 0 : '';
}

$property->$key = $value;
```

로그에 `json_decode(): Passing null to parameter #1`도 함께 표시되는 경우, PR #3359를 적용하거나 `app/Domain/Plugins/Hxcontrollers/Details.php`에서 API 응답을 검사하여 `null`이 `json_decode()`에 직접 전달되지 않도록 하세요.

패치 후 PHP-FPM을 재시작하세요(예: `sudo systemctl restart php8.4-fpm`). 또는 Docker 컨테이너를 재시작하세요.

Question 3

Leantime이 PostgreSQL에서 첫 번째 사용자 로그인 시 'duplicate key value violates unique constraint' 오류를 발생시키는 이유는 무엇인가요?

Accepted Answer

PostgreSQL에서 새로 설치한 후, 설치 프로그램이 명시적 ID로 시드 데이터(admin 사용자, 데모 티켓)를 삽입하지만 BIGSERIAL 시퀀스를 업데이트하지 않습니다. 새 사용자가 처음 로그인하면 다음 자동 생성 ID가 기존 행과 충돌합니다. 해결 방법: 각 테이블에 대해 SETVAL을 실행하여 수동으로 시퀀스를 현재 max(id)+1로 재동기화합니다. 예: SELECT setval(pg_get_serial_sequence('zp_user','id'), (SELECT MAX(id) FROM zp_user)); zp_clients, zp_projects, zp_canvas, zp_canvas_items, zp_relationuserproject, zp_tickets에 대해 반복합니다. 영구 수정은 PR #3447에서 준비 중입니다.

Leantime

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트