README

Laravel Starter (基于Laravel 11.x)

Laravel Starter是一个基于Laravel 11.x的简单起点项目。应用程序的许多常用功能，如认证、授权、用户和角色管理、应用后端、备份、日志查看器等，都包含在此处。它是模块化的，因此您可以以此项目为基础，构建自己的模块。模块可以在任何基于Laravel Starter的项目中使用。前端和后端完全分离，拥有独立的路由、控制器和主题。

请告诉我您的反馈和评论。

报告漏洞

如果您发现任何安全相关的问题，请通过nasir8891@gmail.com发送电子邮件给Nasir Khan Saikat，而不是使用问题跟踪器。

应用程序演示

请查看以下演示项目。这是一个直接安装的项目，没有任何修改。

演示URL: https://laravel.nasirkhn.com

您可以使用以下账户凭据访问应用程序后端。

User: super@admin.com
Pass: secret

User: user@user.com
Pass: secret

演示数据

如果您想在本地机器上使用附加的演示数据测试应用程序，可以使用以下命令。

php artisan laravel-starter:insert-demo-data

有一些选项可以截断posts、categories、tags和comments表，并插入新的演示数据。

--fresh选项将截断表，如果没有这个命令，将插入一组新数据。

php artisan laravel-starter:insert-demo-data --fresh

自定义命令

我们为项目创建了许多自定义命令。以下是命令列表及其简要用途。

创建新模块

要创建项目，请使用以下命令，您需要将MODULE_NAME替换为模块的名称。

php artisan module:build MODULE_NAME

您可能想使用--force选项来覆盖现有模块。如果使用此选项，它将用默认存根文件替换所有现有文件。

php artisan module:build MODULE_NAME --force

清除所有缓存

composer clear-all

这是一个清除包括配置、路由等所有缓存的快捷命令

代码风格修复

我们现在使用Laravel Pint来使代码风格保持与Laravel框架一样干净和一致。使用以下命令应用CS-Fix。

composer pint

角色-权限

有多个自定义命令可以添加和更新角色-权限。请阅读角色-权限维基页面，其中您将找到命令列表及其示例。

功能

Laravel Starter包含了一些几乎所有应用程序都常用的功能。它是一个模板项目，这意味着它的目的是以可用于其他项目的方式构建。

它是一个模块化应用程序，一些模块默认安装。它将有助于将其用作未来应用程序的起点。

管理员功能和公开视图完全分离，作为后端和前端命名空间。
主要功能作为模块开发。例如，帖子、评论和标签这样的模块与核心功能（如用户、角色、权限）分开。

核心功能

用户认证
社交登录
- 谷歌
- Facebook
- GitHub
- 现在以更简单的方式添加更多功能
带头像的用户资料
用户角色权限
动态菜单系统
语言切换器
在整个项目中启用本地化
后端主题
- Bootstrap 5, CoreUI
- Fontawesome 6
- 暗黑模式
前端主题
- Tailwind
- Fontawesome 6
- 暗黑模式
文章模块
- 帖子
- 分类
- 标签
- 评论
- 所见即所得编辑器
- 文件浏览器
应用程序设置
外部库
- Bootstrap 5
- Fontawesome 6
- CoreUI
- Tailwind
- Datatables
- Select2
- 日期时间选择器
备份（源、文件、数据库作为zip压缩文件）
日志查看器
通知
- 仪表板和详情视图

用户指南

安装

按照以下步骤安装和运行项目。您可以在安装Wiki中找到有关安装的更多详细信息。

打开终端并运行以下命令，这将下载并安装Laravel Starter并运行安装后的命令。

composer create-project nasirkhan/laravel-starter

默认数据库是sqlite，如果您想更改，请更新.env文件中的数据库设置
要从存储目录创建链接，请在项目根目录下运行以下命令

php artisan storage:link

如果您从Laravel Hard运行create-project命令，则网站可在http://laravel-starter.test访问。您可以为访问应用程序创建虚拟主机条目或从项目根目录运行php artisan serve并访问http://127.0.0.1:8000

创建新权限后，请使用以下命令更新缓存的权限。

php artisan cache:forget spatie.permission.cache

Docker和Laravel Sail

此项目配置了Laravel Sail (https://laravel.net.cn/docs/sail)。您在这里可以使用所有Docker功能。要使用Docker和Sail安装

克隆或下载存储库
转到项目目录并运行composer install
通过复制.env-sail创建.env文件。您可以使用以下命令执行此操作：cp .env-sail .env
在.env文件中更新数据库名称和凭证
运行命令sail up（考虑将此添加到您的别名：alias sail='[ -f sail ] && sh sail || sh vendor/bin/sail'）
运行命令sail artisan migrate --seed
链接存储目录：sail artisan storage:link
由于Sail已经启动，您只需访问https://:80