novatura/laravel

此包的最新版本(dev-main)没有提供许可证信息。

dev-main 2024-02-12 11:54 UTC

README

仓库跟踪

  • 前端脚手架(Breeze的定制实现)
  • 角色和权限脚手架
  • 模型日志脚手架
  • 用户历史脚手架
  • 错误中心脚手架
  • 仓库模式脚手架

使用方法

安装

composer require novatura/laravel

命令

脚手架

使用 Mantine UI 安装基本的登录/注册功能。

php artisan novatura:scaffold:install

制作 Inertia 页面

php artisan novatura:make:page {name}

本地开发

本地开发有点棘手,因为我们需要将此仓库挂载到沙盒/测试项目的 Docker 容器中。

以下步骤将引导您 创建一个新的 Laravel 项目将其挂载到其中

  1. 在其他位置创建一个新的 Laravel 项目,而不是在这个仓库中

    • laravel new sandbox && cd sandbox
    • composer require laravel/sail --dev
    • php artisan sail:install
      • 当提示时,选择 mysqlredismailpit
  2. 将此仓库作为包添加到您的 ./composer.json 的末尾

    {
        "repositories": [
            {
                "type": "path",
                "url": "/Users/{username}/code/novatura/laravel",
                "options": {
                    "symlink": false
                }
            }
        ]
    }

    这告诉 composer 在运行 composer install 时检查在线仓库和本地路径的包。

    我相信您可以用相对路径让它工作,我只是没这么做。绝对路径也可以正常工作。请确保将 {username} 更改为您的实际用户名。(现在可能是说我在 MacOS 上测试过这些操作的好时机)

  3. 安装包:composer require novatura/laravel @dev

    • 需要 @dev,没有它将无法工作。
    • 如果您收到找不到发布的错误,那是因为您忘记了 @dev
  4. 发布 sail 的 docker-compose.yml 文件:php artisan sail:publish

  5. 修改 ./docker-compose.yml 以挂载此仓库

    更改

    volumes:
        - '.:/var/www/html'

    volumes:
        - '.:/var/www/html'
        - '/Users/{username}/code/novatura/laravel:/var/www/html/vendor/novatura/laravel'

    如果您在设置 sail 时忘记了包括 Mailpit,请将其作为服务添加到 docker-compose.json

    mailpit:
        image: 'axllent/mailpit:latest'
        ports:
            - '${FORWARD_MAILPIT_PORT:-1025}:1025'
            - '${FORWARD_MAILPIT_DASHBOARD_PORT:-8025}:8025'
        networks:
            - sail
  6. 启动 sail:./vendor/bin/sail up

  7. 链接存储:./vendor/bin/sail artisan storage:link

  8. 在沙盒项目中创建一个 git 提交

    • 这样您就可以不断回滚到干净的起始状态了 😉

在此阶段,您可以使用我们的命令等,例如 php artisan novatura:scaffold:install

每次您想要测试一个命令或更改时,您都会想要重新安装包,以便将最新代码发送到 Docker 容器!

例如

composer require novatura/laravel @dev && php artisan novatura:scaffold:install

当 Sail 运行时,您可以通过在浏览器中访问 https://:8025 来访问所有外发邮件(Mailpit 仪表板)。