README

快速，使用 Laravel 和 Livewire 以及 RBAC 的 CRUD 模板。使用 Docker 进行本地开发和生产部署，基于 Bootstrap 优化了认证视图，很好地集成了 Select2 和 Flatpickr。

准备

如果您希望使用 SSL 进行本地开发（推荐），您需要在您的机器上安装 mkcert。安装完成后，接下来请将 mkcert 的本地 CA 安装到系统的信任存储中。

$ sudo mkcert -install

然后使用以下命令为本地开发生成 SSL 证书

$ mkcert local.dev '*.local.dev' localhost 127.0.0.1 ::1

安装

在安装之前，请确保已安装 Docker。然后简单地下载或克隆代码，并在项目文件夹中运行以下命令

# create from example file(s)
$ cp .env.example .env
$ cp ngrok.example.yml ngrok.yml

# setup NGROK_AUTHTOKEN in .env

# start the services
$ docker compose up -d

# spawn a shell in web container
$ docker compose exec web bash

# install dependencies
$ composer install && yarn install && yarn build

# set application key
$ php artisan key:generate

# initialize scout indices
$ php artisan scout:sync-index-settings

# prepare database
$ php artisan migrate --seed

# link public storage directory
$ php artisan storage:link

您可以通过浏览器在 https://web.local.dev/ 或 http://localhost:8000/ 访问项目。

要能够管理用户、角色等，您必须为用户创建或分配相关角色。您可以通过运行以下命令并交互式地提供用户信息来完成此操作

$ php artisan make:admin

附加信息

Traefik 要求您将主机名路由到本地机器。为此，请将以下行添加到您的 /etc/hosts 文件中

127.0.0.1 cdn.local.dev
127.0.0.1 mailcatcher.local.dev
127.0.0.1 meilisearch.local.dev
127.0.0.1 minio.local.dev
127.0.0.1 phpmyadmin.local.dev
127.0.0.1 redis-commander.local.dev
127.0.0.1 web.local.dev

该 Docker 设置还包括以下服务，以简化本地开发

• MailCatcher - 捕获所有发出的电子邮件，在 https://mailcatcher.local.dev/ 访问
• Meilisearch - 全文搜索引擎，在 https://meilisearch.local.dev/ 访问
• MinIO - 兼容 S3 的存储，在 https://minio.local.dev/ 访问
• phpMyAdmin - 用于管理 SQL 数据库，在 https://phpmyadmin.local.dev/ 访问
• Redis Commander - 用于管理 Redis 数据，在 https://redis-commander.local.dev/ 访问

以下可能需要一些额外的配置，以实现扩展功能。

文件上传

在上传文件之前，您可能需要使用 laravelapp 作为（用户名和密码）登录到 MinIO 控制台 https://minio.local.dev/，并创建一个名为 laravelapp 的存储桶。创建后，转到存储桶的设置，将其 访问策略 更改为 公共。

Ngrok

项目设置还包括 ngrok 服务。要获取活动隧道URL，请使用以下命令

# start the services
$ docker compose up -d

# show ngrok tunnel url
$ php artisan ngrok:discover

代码风格

项目使用 laravel/pint 来强制执行代码风格。要运行它并修复任何问题，请使用以下命令

$ docker run --rm -v .:/workspace syncloudsoftech/pinter

部署

您可以使用以下命令将项目部署到生产环境（使用 Docker）

# build production container
$ docker build -t laravelapp .

# push image to registry
$ docker push laravelapp