anisaronno/laravel-starter

适用于任何类型项目的完美 Laravel 入门项目。

安装: 17

依赖: 0

建议者: 0

安全: 0

星标: 5

关注者: 1

分支: 1

开放问题: 1

语言:Blade

类型:项目


README

欢迎来到 Laravel 入门项目!此仓库为 Laravel 11 版本提供快速启动设置,集成各种必备包和功能。它旨在简化您的 Laravel 应用程序开发过程。

目录

使用包

  • Laravel Breeze (仅用于身份验证后端代码)
  • Spatie 权限和滚动
  • Laravel Telescope (优雅的本地开发调试助手)
  • Laravel Pulse (应用程序性能监控)
  • Laravel Clockwork (请求监控)
  • Laravel Horizon (作业和队列管理)
  • Laravel Settings (应用程序设置的个人包)
  • Laravel Media Gallery (文件管理的个人包)
  • Laravel Activity Log (跟踪用户活动)
  • 本地和生产环境的美丽 Log Viewer
  • Laravel Sweet Alert
  • Laravel Pint 代码风格修复

仪表板模板

利用 admintoolkit-html 存储库作为我们的仪表板模板。探索这个开源管理模板以获取更多见解和详细信息。

我们感谢贡献者的宝贵贡献。

其他用途

特性

  • 使用 CRUD 设置角色和权限
  • 显示用户表和 CRUD 完成情况
  • 带有响应式侧边栏的仪表板模板
  • 使用深色模式和浅色模式
  • 显示用户通知
  • 显示用户活动日志
  • 中央媒体库
  • 使用 Editor JS 进行内容编写
  • 设置应用程序设置
  • 根据其位置设置用户时区和语言

入门指南

安装

  1. 使用 Composer 安装项目

    composer create-project anisaronno/laravel-starter
    
  2. 切换到存储库文件夹

    cd laravel-starter
    
  3. 为数据库和电子邮件设置环境变量。

  4. 运行数据库迁移

    php artisan migrate
    
  5. 运行数据库填充

    php artisan db:seed
    
  6. 运行作业

    php artisan horizon
    

    php artisan queue:work
    

    php artisan schedule:run
    
  7. 运行开发命令

    npm run dev
    

    进行前端构建

    npm run build
    
  8. 启动本地开发服务器

    php artisan serve
    

现在,在 https://:8000 访问服务器。

使用 Docker 启动

要使用Docker启动Laravel入门项目,您可以使用提供的docker-compose.yml文件。按照以下步骤操作:

  1. 请确保您的系统上已安装Docker。

  2. 在项目的根目录中创建一个docker-compose.yml文件,并包含以下内容:

version: '3'
services:
  # Define your services here (e.g., nginx, php, mysql, etc.)
  # Example services:
  nginx:
    image: nginx:alpine
    # Add your nginx configurations

  php:
    image: php:8.2-fpm
    # Add your PHP configurations

  # Add other necessary services as required.
  1. 根据项目的需求,在docker-compose.yml文件中定义所需的服务,如nginx、php、MySQL等。

  2. 配置好docker-compose.yml文件后,运行以下命令来启动服务:

docker-compose up -d
  1. 您可以在https://:8000或根据您的配置指定的端口访问您的Laravel应用程序。

通过 CI/CD 通过 FTP 部署

该项目利用持续集成/持续部署(CI/CD)通过FTP进行自动化部署,遵循GitFlow原则进行合并请求。

使用 GitFlow 进行合并请求

按照GitFlow原则管理合并请求

  • 功能分支:在单独的分支中开发新功能。
  • 拉取请求:向develop分支提交拉取请求以合并功能。
  • 合并到Master:将代码从develop合并到master,以便为生产准备代码。

FTP 部署流程

要部署您的项目

  1. 在GitHub设置中配置必要的环境变量

    • SERVER:您的FTP服务器地址。
    • USERNAME:您的FTP用户名。
    • PASSWORD:您的FTP密码。
  2. 在合并到master分支后,GitHub Actions会自动将部署到您指定的FTP服务器。

Laravel 自动更新器

Laravel自动更新功能简化了更新Laravel入门应用程序的过程,使得管理和部署更新变得轻松。以下是使用方法:

特性

  • 自动检查更新。
  • 使用简单的Artisan命令启动更新。

用法

  1. 检查更新:运行以下命令以检查可用的更新。

    php artisan update:check
  2. 启动更新:使用以下命令启动更新过程。

    php artisan update:initiate {version?}

    如果需要,将{version?}替换为特定的版本号;否则,将启动最新版本的更新。

错误处理

确保在更新过程中优雅地处理任何潜在的错误。实施日志记录以监控更新过程中出现的任何问题。

贡献指南

有关为该项目做出贡献的指南,请参阅贡献指南

许可证

此应用程序是开源软件,根据MIT许可证授权。