README

为 ITS Laravel 应用程序搭建 UI 的软件包。快速运行命令，在基于 Laravel 的应用程序上设置 ITS 框架。

为什么？

此软件包有助于在 Docker 构建步骤中分离基于 Laravel 的应用程序。还包括最佳实践和重构。

要求

注意：请记住，如果使用不同的认证方案，请更新 API 或 Web 路由的 middleware。

安装和用法

• 运行 composer require uisits/ui
• 运行 php artisan its-ui:install

注意

此命令将所有占位符复制到您的基应用程序中。

发布后，您可以自由更新占位符。您还可以像以前一样安装其他所需的软件包。

本地设置

• 创建一个全新的 Laravel 应用程序，就像我们为所有项目所做的那样
• 在 /var/www/laravel/packages 下创建一个文件夹 packages ````
• 在 /var/www/laravel/packages 目录中创建一个名为 uisits 的文件夹，这是我们的软件包的供应商名称
• 进入此供应商名称文件夹（cd /var/www/laravel/packages/uisits）并运行 git clone git@github.com:uisits/ui.git
• 这将从 GitHub 复制软件包的所有文件。
• 要使用 7.x 进行工作，请运行 git checkout 7.x（这里 7.x 是 GitHub 上分支的名称）
• 同样，要使用 8.x 进行工作，请运行 git checkout .8x（这里 8.x 是 GitHub 上分支的名称）
• 为了在本地上使用此软件包，我们需要将其添加到我们的 Laravel 应用程序中。我们可以通过将以下内容添加到 /var/www/laravel/composer.json 中的 composer.json 文件来实现。

  "repositories": {
      "local": {
          "type": "path",
          "url": "./packages/uisits/ui"
      }
  },

  现在您的整个 composer.json 文件看起来像这样

  {
      "name": "laravel/laravel",
      "type": "project",
      "description": "The Laravel Framework.",
      "keywords": [
          "framework",
          "laravel"
      ],
      "license": "MIT",
      "repositories": {
          "local": {
              "type": "path",
              "url": "./packages/uisits/ui"
          }
      },
      "require": {
          "adldap2/adldap2-laravel": "^6.0",
          "fideloper/proxy": "^4.4",
          "fruitcake/laravel-cors": "^2.0",
          "laravel/framework": "^7.0",
          "laravel/passport": "^8.4",
          "laravel/tinker": "^2.0",
          "php": "^7.2.5|^8.0",
          "uabookstores/laravel-shibboleth": "3.1.1",
          "uisits/ui": "^7.0",
          "yajra/laravel-oci8": "^7.0"
      },
      "require-dev": {
          "barryvdh/laravel-debugbar": "^3.3",
          "facade/ignition": "^2.0",
          "fzaninotto/faker": "^1.4",
          "laravel/dusk": "^5.5",
          "mockery/mockery": "^1.0",
          "nunomaduro/collision": "^4.1",
          "phpunit/phpunit": "^8.5"
      },
      "config": {
          "optimize-autoloader": true,
          "preferred-install": "dist",
          "sort-packages": true
      },
      "extra": {
          "laravel": {
              "dont-discover": [
                  "laravel/dusk"
              ]
          }
      },
      "autoload": {
          "psr-4": {
              "App\\": "app/"
          },
          "classmap": [
              "database/seeds",
              "database/factories"
          ]
      },
      "autoload-dev": {
          "psr-4": {
              "Tests\\": "tests/"
          }
      },
      "minimum-stability": "dev",
      "prefer-stable": true,
      "scripts": {
          "post-autoload-dump": [
              "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
              "@php artisan package:discover --ansi"
          ],
          "post-root-package-install": [
              "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
          ],
          "post-create-project-cmd": [
              "@php artisan key:generate --ansi"
          ]
      }
  }

• 现在只需要运行 composer install uisits/ui。现在应从本地目录安装软件包。

注意：有时您可能需要运行 composer dump-autoload。

测试

• 创建一个 Docker 容器。
• 通过运行 cd .. && rm -rf laravel 删除 /var/www/laravel 中的当前 Laravel 应用程序
• 通过运行 composer create-project --prefer-dist laravel/laravel:^7.0 laravel 在 /var/www/ 中安装一个全新的 Laravel 应用程序
• 对于 Laravel 8，请运行 composer create-project --prefer-dist laravel/laravel blog。
• 现在按照软件包的安装步骤进行安装。
  • 运行 composer require uisits/ui
  • 运行 php artisan its-ui:install

有关版本要求，请参阅下表

问题和功能请求

• 请创建一个新问题并说明任何错误或功能请求。

由 UIS ITS 维护。