Question 1

Dockerの初回実行スクリプトが、'Your lock file does not contain a compatible set of packages' というエラーで失敗するのはなぜですか？

Accepted Answer

このエラーは、Dockerコンテナ（PHP 7.4）とパッケージ要件（PHP 8.1以上が必要）との間のPHPバージョンの不一致と、ロックファイルの制約が古くなっていることが原因で発生します。修正方法：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

Here's how to tackle both issues:

## Missing PHP autoload files

The error `Failed opening required '.../vendor/autoload.php'` means Composer dependencies were never installed or the `vendor/` directory is being hidden.

**Run Composer install** — either on the host (if Composer is installed and the project dir is volume-mounted into the container):

```bash
composer install
```

Or inside the PHP container (check the actual service name with `docker-compose ps` first):

```bash
docker-compose exec php bash
composer install
```

If Composer crashes with out-of-memory errors during install:

```bash
COMPOSER_MEMORY_LIMIT=-1 composer install
```

Also verify the container's PHP version satisfies the requirements in `composer.json` — a version mismatch will make the install fail partway, leaving `vendor/` incomplete.

## mailpit build failure

mailpit is distributed as a prebuilt image and shouldn't need a local build. Check the mailpit service in your `docker-compose.yml`:

```yaml
mailpit:
  image: axllent/mailpit:latest
  ports:
    - "8025:8025"
```

- If there's a `build:` directive pointing at a Dockerfile that doesn't exist, remove it and use the `image:` directive instead.
- Test registry connectivity by pulling manually: `docker pull axllent/mailpit:latest`
- If the pull fails, check your DNS/proxy settings for Docker (e.g., add `"dns": ["8.8.8.8"]` to `/etc/docker/daemon.json`, or configure proxy settings in `~/.docker/config.json`).
- Make sure you're on the latest version of the repository — older checkouts referenced mailhog (now deprecated), and mixed configs can reference files or images that no longer exist.

## Full clean rebuild

If things are still broken after the above:

```bash
docker-compose down
docker-compose build --no-cache
docker-compose up -d
docker-compose exec php composer install
```

Then watch the logs for remaining errors:

```bash
docker-compose logs -f
```

If the app still can't see `vendor/` after a successful install, check permissions — the web server user (typically `www-data`) needs read access, e.g. `chown -R www-data:www-data vendor` inside the container.

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 のオートローダーを再生成してください:

```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

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト