labs64 / laravel-boilerplate
Laravel Boilerplate
Requires
- php: >=7.2.5
- albertcht/invisible-recaptcha: ^1.9
- arcanedev/log-viewer: ^7.0
- creativeorange/gravatar: ^1.0
- davejamesmiller/laravel-breadcrumbs: ^5.2
- fruitcake/laravel-cors: ^1.0
- kyslik/column-sortable: ^6.1
- labs64/netlicensingclient-php: ^2.4
- laravel/framework: ^7.0
- laravel/socialite: ^4.1
- laravel/tinker: ^2.0
- laravel/ui: ^2.0
- laravelcollective/html: ^6.1.0
Requires (Dev)
- barryvdh/laravel-debugbar: ^3.2
- barryvdh/laravel-ide-helper: ^2.6
- doctrine/dbal: ^2.9
- filp/whoops: ^2.3
- fzaninotto/faker: ^1.8
- mockery/mockery: ^1.3.1
- phpunit/phpunit: ^8.5
- spatie/phpunit-watcher: ^1.12
README
Laravel Boilerplate 项目
Laravel Boilerplate 提供了一种非常灵活和可扩展的方式来构建您的自定义 Laravel 应用程序。
目录
功能
- 带有 Gentelella Admin 主题 的管理仪表板
- 响应式布局
- Bootstrap 3
- Font Awesome
- Socialite 集成
- 不可见 reCAPTCHA
- 通过 NetLicensing 的会员计划和访问控制管理
- 支持 MySQL, SQLite, PostgreSQL 数据库
- AWS S3 支持
- 前端支持 Google Analytics
- 配置可以通过
analytics.php
和模板ga.blade.php
容易地进行
- 配置可以通过
- 通过电子邮件自动错误反馈
- 支持 i18n 和自动用户客户端语言识别
- 辅助类
ToJs
,通过 blade 指令@tojs
来简化 JavaScript 变量的工作 - 辅助类
Meta
,通过 blade 指令@meta
来简化元标签和属性的工作 - 用户和角色模型
- 添加了 Auth 控制器,允许通过电子邮件激活注册
- 导游 由 GuideChimp 👍
- 通过以下方式扩展 Auth 配置:
- 可以开启/关闭用户注册
- 设置默认用户角色
- 可以开启/关闭注册激活电子邮件
- 验证码配置
- 在用户模型中支持 Gravatar,并通过
gravatar.php
提供灵活配置 - 添加库日志查看器,允许在日志文件
laravel.log
中打印错误 - 添加库可排序,用于表格排序
- i18n:将
trans()
方法替换为__()
,以支持通过 JSON 资源进行国际化 - 使用社交服务(Google+、Facebook、Twitter)注册
- 存储最后的社会登录到用户会话
- 添加了 SocialLogin 事件
- 添加了对某些事件的监听器;例如,登录、注销、注册、SocialLogin
- 在用户账户确认时添加了通知
ConfirmEmail
- 添加了访问后端服务的策略
- 添加了用户、角色和用户角色的数据库种子器
- 改进了迁移
create_users_table.php
;添加了 active、confirm 和 deleted_at 字段以支持软删除 - JavaScript / CSS 压缩
- JavaScript / CSS 哈希
- 一些非常有用的辅助函数来简化您的工作 :)
主题演示
系统需求
为了能够运行 Laravel Boilerplate,您必须满足以下要求
- PHP >= 7.4
- PHP 扩展:BCMath、Ctype、Fileinfo、JSON、Mbstring、OpenSSL、PDO、Tokenizer、XML、cURL、Mcrypt、GD
- Node.js >= 8.x
- Composer >= 1.9.x
安装
- 使用详细的安装说明安装 Composer 这里
wget https://getcomposer.org.cn/composer.phar
chmod +x composer.phar
mv composer.phar /usr/local/bin/composer
- 使用详细的安装说明安装 Node.js 这里
yum install npm
- 克隆仓库
git clone https://github.com/Labs64/laravel-boilerplate.git
- 切换到工作目录
cd laravel-boilerplate
- 将
.env.example
复制到.env
并根据您的环境进行修改cp .env.example .env
- 安装 composer 依赖项
composer install --prefer-dist
- 可以使用以下命令生成应用程序密钥:
php artisan key:generate
- 执行以下命令以安装其他依赖项:
npm install
npm run dev
- 运行以下命令以在定义的数据库中创建表并填充种子数据:
php artisan migrate --seed
故障排除:
-
如果您遇到类似
PDOException
的错误,请尝试编辑您的.env
文件,将DB_HOST=127.0.0.1
更改为DB_HOST=localhost
或DB_HOST=mysql
(对于 docker-compose 环境)。 -
如果您遇到密码错误,请尝试以下命令:
# ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'root';
运行
启动 PHP 内置服务器:
php artisan serve --port=8080
或
php -S localhost:8080 -t public/
现在您可以通过 https://:8080 浏览网站 🙌
Docker:
这里有一个基于 Docker 的本地开发环境,它提供了一种非常灵活和可扩展的方式来构建您定制的 Laravel 应用程序。
内容概览:
该项目基于 docker-compose。默认情况下,以下容器被启动:laravel-env (基于 centos:7),mysql,nginx。额外的容器(phpmyadmin,mailhog)被外部化到 docker-compose.utils.yml
中。/var/www/laravel-boilerplate 目录是 Web 根目录,映射到 nginx 容器。您可以直接在 repo 中编辑配置文件,因为它们被映射到容器中的正确位置。
系统需求
为了能够运行 Laravel Boilerplate,您必须满足以下要求
运行
-
克隆仓库
git clone https://github.com/Labs64/laravel-boilerplate.git
-
将
.env.example
复制到.env
并根据您的环境进行修改(确保数据库主机设置为DB_HOST=mysql
)cp .env.example .env
-
启动环境
docker-compose up -d # to start base containers
或
docker-compose -f docker-compose.yml -f docker-compose.utils.yml up -d # to start base and utils containers
-
构建项目
docker exec laravel-boilerplate_laravel-env_1 ./dockerfiles/bin/prj-build.sh
或
docker-compose run --rm laravel-boilerplate_laravel-env_1 ./dockerfiles/bin/prj-build.sh
现在您可以通过 https://:80 浏览网站 🙌
- 停止环境
或docker-compose down
docker-compose -f docker-compose.yml -f docker-compose.utils.yml down
如何做 & 模块配置
有关模块配置和故障排除的信息,请查看项目的 wiki 页面。有关如何使用 Laravel 及其扩展的更详细说明,请查看完整的 Laravel 文档。
如何贡献
从 GitHub 上 fork 仓库,阅读 CONTRIBUTE 文件并进行一些更改。完成更改后,发送 pull request 并检查 CI 验证状态。谢谢!
贡献者和支持者:
感谢所有为这个项目做出贡献的 贡献者。您的帮助非常宝贵!
- Clever Kids 团队在项目结构方面提供了巨大的支持。
- GuideChimp - 为您的 Web 应用创建引导产品之旅的简单、轻量级、干净的库。
- PluginPass – WordPress PRO 插件/主题许可 - 轻松控制您的 WordPress 插件和主题的使用和货币化。
- @veerajongit - 一个包,每次代码或测试更改时都会自动进行测试。
- @rainerkent - 升级到 Laravel 6。
错误和反馈
有关错误、问题和支持,请使用 GitHub Issues。
许可
此模板是开源软件,许可协议为 MIT 许可证。