labs64/laravel-boilerplate

Laravel Boilerplate

资助包维护!
www.paypal.me/labs64

安装: 63

依赖者: 0

建议者: 0

安全: 0

星标: 912

关注者: 57

分支: 327

开放问题: 2

类型:项目


README

Build Status Laravel Version PHP Badge Latest Stable Version Total Downloads License

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 哈希
  • 一些非常有用的辅助函数来简化您的工作 :)

主题演示

Gentelella Bootstrap Admin Template

Gentelella Admin 主题演示

系统需求

为了能够运行 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

安装

  1. 使用详细的安装说明安装 Composer 这里
    wget https://getcomposer.org.cn/composer.phar
    
    chmod +x composer.phar
    
    mv composer.phar /usr/local/bin/composer
    
  2. 使用详细的安装说明安装 Node.js 这里
    yum install npm
    
  3. 克隆仓库
    git clone https://github.com/Labs64/laravel-boilerplate.git
    
  4. 切换到工作目录
    cd laravel-boilerplate
    
  5. .env.example 复制到 .env 并根据您的环境进行修改
    cp .env.example .env
    
  6. 安装 composer 依赖项
    composer install --prefer-dist
    
  7. 可以使用以下命令生成应用程序密钥:
    php artisan key:generate
    
  8. 执行以下命令以安装其他依赖项:
    npm install
    
    npm run dev
    
  9. 运行以下命令以在定义的数据库中创建表并填充种子数据:
    php artisan migrate --seed
    

故障排除:

  • 如果您遇到类似 PDOException 的错误,请尝试编辑您的 .env 文件,将 DB_HOST=127.0.0.1 更改为 DB_HOST=localhostDB_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 Docker

系统需求

为了能够运行 Laravel Boilerplate,您必须满足以下要求

运行

  1. 克隆仓库

    git clone https://github.com/Labs64/laravel-boilerplate.git
    
  2. .env.example 复制到 .env 并根据您的环境进行修改(确保数据库主机设置为 DB_HOST=mysql

    cp .env.example .env
    
  3. 启动环境

    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
    
  4. 构建项目

    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 浏览网站 🙌

  1. 停止环境
    docker-compose down
    
    docker-compose -f docker-compose.yml -f docker-compose.utils.yml down
    

如何做 & 模块配置

有关模块配置和故障排除的信息,请查看项目的 wiki 页面。有关如何使用 Laravel 及其扩展的更详细说明,请查看完整的 Laravel 文档

如何贡献

从 GitHub 上 fork 仓库,阅读 CONTRIBUTE 文件并进行一些更改。完成更改后,发送 pull request 并检查 CI 验证状态。谢谢!

贡献者和支持者:

感谢所有为这个项目做出贡献的 贡献者。您的帮助非常宝贵!

错误和反馈

有关错误、问题和支持,请使用 GitHub Issues

许可

此模板是开源软件,许可协议为 MIT 许可证