Question 1

Leantime Docker imageをPostgreSQLに接続する際の「could not find driver」エラーを修正する方法

Accepted Answer

公式Leantime Dockerイメージ（v3.6.0以前）はPostgreSQL PDOドライバが不足しており、LEAN_DB_TYPE=postgresが設定されていると「PDOException: could not find driver」が発生します。回避策として、以下のドライバを使用してイメージを再ビルドしてください：
```dockerfile
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

この問題は、マーケットプレイス 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 由来のプロパティを null 許容に変更してください:

```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` など、すでに null 許容となっているフィールドは変更しないでください。

多層防御のために、`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 を持つシードデータ（管理者ユーザー、デモチケット）を挿入しますが、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

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト