README

Laravel的框架。由TailwindCSS和Livewire提供支持。

可用组件列表

先决条件

由于此包依赖于几个第三方包，您需要在项目中安装和配置以下内容

安装

使用composer要求：composer require cauriland/foundation

用法

示例

Composer脚本

将这些脚本添加到 composer.json

"scripts": [
    "analyse": [
        "vendor/bin/phpstan analyse --configuration=vendor/cauriland/foundation/phpstan.neon --memory-limit=2G"
    ],
    "format": [
        "vendor/bin/php-cs-fixer fix --config=vendor/cauriland/foundation/.php-cs-fixer.php"
    ],
    "refactor": [
        "./vendor/bin/rector process --config=vendor/cauriland/foundation/rector.php"
    ],
    "test": [
        "./vendor/bin/pest"
    ],
    "test:fast": [
        "./vendor/bin/pest --parallel"
    ],
    "test:coverage": [
        "./vendor/bin/pest --coverage --min=100 --coverage-html=.coverage --coverage-clover=coverage.xml"
    ]
],

本地开发组件

此包包含大量前端组件，但本身不包含前端视图。因此，当您需要工作在此包上时，您需要依赖另一个项目的前端。通常，这可以通过将composer符号链接此包来完成，但在此情况下，还需要进行第二个步骤，以确保您可以运行 yarn watch、yarn prod 等。

我将详细说明，并以marketplace.io项目为例。假设marketplace.io和laravel-foundation git仓库都已安装在我们的本地开发机器上的/Users/my-user/projects/文件夹中。

步骤1 - Composer符号链接

在marketplace.io的composer.json文件中，“repositories”部分添加laravel-foundation路径

"repositories": [
    {
        "type": "path",
        "url": "../laravel-foundation"
    }
]

After that run composer require cauriland/foundation --ignore-platform-reqs -W. The laravel-foundation package is now symlinked and you can work in your IDE from within your laravel-foundation repo.

步骤2 - 符号链接node_modules

如果您在marketplace.io仓库中运行yarn watch，您将遇到大量错误，因为依赖项不足以知道它们在符号链接的目录中。

删除laravel-foundation上的node_modules目录。
通过运行ln -s /Users/my-user/projects/marketsquare.io/node_modules node_modules（在laravel-foundation仓库内部）将marketplace.io的node_modules目录符号链接到laravel-foundation。

现在，当您回到marketplace.io仓库时，您可以运行yarn watch。

完成后，别忘了取消符号链接。

将这些步骤转换为脚本

请注意:

这些脚本是为Mac用户编写的。如果您使用其他操作系统，您可能需要相应地进行调整。

unlink:foundation使用git命令恢复当前项目。

为了提高您的开发流程，您可以将这些步骤转换为脚本，并在命令行中直接使用它们，例如

$ link:foundation
$ unlink:foundation

您可以将它们复制/粘贴到您的.bashrc、.aliases或您设置的任何用于管理别名文件中。

在深入研究代码之前，让我解释一下您可以如何使用它们（跳到代码）。

对于这些示例，我们使用marketplace.io和laravel-foundation仓库，假设它们都安装在我们的本地开发机器上的同一文件夹中（/Users/my-user/projects）。

将当前项目符号链接到laravel-foundation

# move into marketsquare.io folder
$ cd /Users/my-user/projects/marketsquare.io

# symlink to laravel-foundation repo
$ link:foundation

就这样！

该脚本自动尝试猜测laravel-foundation仓库的位置，并将当前项目符号链接到它（在这种情况下为marketplace.io）。

如果当前项目和laravel-foundation仓库不在同一文件夹中，脚本将尝试回退一级（../../）并再次尝试。如果找不到laravel-foundation，脚本将退出并输出错误消息。

您始终可以通过传递参数来指定自定义路径

$ link:foundation 'Users/john/repos/laravel-foundation'

从您当前的项目中删除符号链接

# move into marketsquare.io folder
$ cd /Users/my-user/projects/marketsquare.io

# remove symlink
$ unlink:foundation

再说一遍，就这么简单！

脚本会查找 .symlink_foundation 临时文件（由 link:foundation 创建），该文件包含符号链接的路径。如果未找到，它会尝试猜测 laravel-foundation 仓库的位置，并从当前项目（在这种情况下为 marketsquare.io）中删除符号链接。