安装

本指南将帮助你完成 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 — 配置无密码登录