README

基于 Laravel 12、PHP 8.2、MySQL 5.7、Laravel Sail 和 inova/nova-admin 的项目起始模板。

本地开发使用 Sail；生产环境继续使用 PHP-FPM、Nginx 与 Supervisor，不使用 Docker Compose。

本地 Docker 开发

要求：Docker Desktop（WSL2）或 Docker Engine 与 Docker Compose。

若本机尚未配置 sail 命令，先将下面的 alias 加入 shell 配置文件（如 ~/.bashrc）：

alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'

使用 Composer 创建项目：

composer create-project inova/laravel-nova-starter myhub
cd myhub

创建命令会安装依赖、生成 .env 与应用密钥；不会连接或迁移数据库。

默认访问地址为 http://127.0.0.1:8000，后台登录入口为 http://127.0.0.1:8000/admin/login。本地初始化后的后台账号固定为 nova，密码固定为 nova；这是 Starter 的开发环境约定，不需要另建管理员。

使用 Sail 初始化本地环境：

cp .env.docker.example .env
# 修改 COMPOSE_PROJECT_NAME、APP_NAME、APP_URL、APP_PORT、FORWARD_DB_PORT、DB_DATABASE 等本地参数
sail up -d
sail artisan key:generate
sail artisan migrate --seed

sail up -d 默认启动 Laravel 与 MySQL。需要异步任务时启动 queue profile；需要定时任务时启动 scheduled profile：

sail --profile queue up -d
sail --profile scheduled up -d

常用命令：

sail artisan migrate
sail artisan test
sail logs -f
sail down

MySQL 在容器内使用 mysql:3306，宿主机访问 127.0.0.1:${FORWARD_DB_PORT}，默认端口为 33061。 COMPOSE_PROJECT_NAME 决定 Docker 容器、网络和数据卷的名称前缀；使用小写项目标识，例如 myhub。

传统 LNMP 部署

生产服务器不要使用 .env.docker.example 或 compose.yaml：

composer install --no-dev --optimize-autoloader
cp .env.example .env
# 填写生产域名、APP_KEY、数据库、缓存、邮件和队列配置
php artisan key:generate
php artisan migrate --force
php artisan nova-admin:create-admin
php artisan optimize

生产 .env 应设置 APP_ENV=production、APP_DEBUG=false，将 DB_HOST 配置为实际数据库地址，并通过 NOVA_ADMIN_NAME、NOVA_ADMIN_EMAIL、NOVA_ADMIN_PASSWORD 覆盖默认管理员凭据。由 Supervisor 运行 php artisan queue:work，由 crontab 或 Supervisor 运行 php artisan schedule:work。

环境文件约定

.env.example：非 Docker 的本地开发配置模板；生产部署时以实际生产参数覆盖。
.env.docker.example：Sail 本地 Docker 配置模板。
.env：当前运行环境配置，不提交。

不要在应用业务代码中直接使用 env()；配置值应通过 config() 读取。

inova / laravel-nova-starter

Maintainers

Package info

Statistics

Security

README

本地 Docker 开发

传统 LNMP 部署

环境文件约定