インストール

このガイドでは、Doggy Framework のインストールと初期設定の完了を支援します。

前提条件

• PHP >= 8.2
• ext-ctype, ext-iconv
• PostgreSQL >= 14
• Composer >= 2.5

ディレクトリ構造

my-app/
├── Caddyfile              # FrankenPHP 配置（含 Mercure Hub、压缩、缓存）
├── config/
│   ├── bundles.php
│   ├── packages/          # 31 个 Bundle 配置文件
│   └── services.yaml
├── src/
│   ├── Annotation/        # Ef.php, EfGroup.php
│   ├── Entity/            # Organization, Platform, Security, Storage, System, Traits
│   ├── Controller/        # Admin, Api, Security
│   ├── Service/           # AI, Storage, Security, Task, Platform 等
│   └── ...
├── templates/             # 143 个 Twig 模板
└── public/                # 入口文件

環境依存のインストール

PostgreSQL

# macOS
brew install postgresql@14
brew services start postgresql@14

# Ubuntu/Debian
sudo apt install postgresql-14
sudo systemctl start postgresql

データベースの作成:

createdb app

Mercure Hub

Mercure Hub は FrankenPHP に内蔵されており、Caddyfile で設定するだけで利用でき、追加インストールは不要です。Mercure 設定 を参照してください。

アプリケーションの起動

アプリケーションはホストマシン上で FrankenPHP を通じて実行されます:

# 开发环境
symfony serve

# 生产环境（FrankenPHP Worker 模式）
cd my-app && php -d variables_order=EGPCS bin/runtime -vvv

FrankenPHP は Caddyfile から設定を自動的に読み取り、http://localhost:8000 で待ち受けます。

データベースの初期化

php bin/console doctrine:database:create
php bin/console doctrine:migrations:migrate
php bin/console doctrine:fixtures:load

基本データの初期化

# 初始化管理员账号（三员）
php bin/console app:init-officers

# 生成静态菜单
php bin/console app:ef:init-admin-menu

デフォルトアカウント

役割	ユーザー名	初期パスワード
システム管理者	admin	admin123
セキュリティ管理者	security	security123
監査管理者	auditor	auditor123

⚠️ 本番環境ではすべてのデフォルトパスワードを変更する必要があります。

アクセス

• アプリケーション: http://localhost:8000
• 管理画面: http://localhost:8000/admin
• ログイン: http://localhost:8000/login

次のステップ

• 動的モデル — @Ef アノテーションシステムについて
• 組織構造 — 企業の組織ツリーを構築
• WebAuthn — パスワードレスログインを設定