安裝

本指南將協助你完成 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 — 設定無密碼登入