README

Laravel Starter Kit

安装

我们的入门套件需要10.0或更高版本的Laravel。

通过Composer安装包

composer require rockero-cz/laravel-starter-kit --with-all-dependencies

您可以通过发布配置文件来自定义安装命令：

php artisan vendor:publish --tag="starter-kit-config"

然后运行安装命令

php artisan starter-kit:install

功能

以下以简单列表和示例的形式描述了rockero-cz/laravel-starter-kit的所有功能。它们旨在加快项目启动速度。它可安装在任何类型的Laravel应用程序上。

Pest配置

入门套件通过发布预配置的TestCase、示例测试以及.env.testing文件来包括Pest的初始配置。

此外，它还生成一个ArchitectureTest.php文件，以保持代码库清洁和可持续。

test('globals')
    ->expect(['dd', 'dump', 'ray', 'env'])
    ->not->toBeUsed();

test('controllers')
    ->expect('App\Http\Controllers')
    ->not->toUse('Illuminate\Http\Request');

test('value objects')
    ->expect('App\ValueObjects')
    ->toUseNothing();

PHPStan配置

除了测试之外，它还使用带有自定义配置的PHPStan工具进行了静态分析，配置级别为7。

includes:
    - ./vendor/larastan/larastan/extension.neon

parameters:
    level: 7

    checkMissingIterableValueType: false
    checkGenericClassInNonGenericObjectType: false

    paths:
        - app/

Duster配置

对于代码风格检查和格式化，我们使用Tighten的Duster。Duster将多个工具（Pint、TLint、PHP_CodeSniffer和PHP CS Fixer）统一到一个强大的命令中。它还有助于我们遵循一些编码标准。

我们还添加了配置中的PHPStan，以便在单个命令中统一所有内容。

{
    "scripts": {
        "lint": {
            "phpstan": ["./vendor/bin/phpstan", "analyse"]
        },
        "fix": {
            "phpstan": ["./vendor/bin/phpstan", "analyse"]
        }
    }
}

GitHub Workflows CI

在安装入门套件期间，您将收到提示以添加GitHub Workflows的CI。

如果您选择继续，将自动生成包含测试和Duster的ci.yml文件。

为了允许github action提交来自duster和prettier的更改，您必须设置权限。

在github.com -> (您的项目) -> 设置 -> 操作 -> 通用 -> 工作流程权限中设置读取和写入权限

Prettier

在安装入门套件期间，您将收到提示以添加CI和项目中的Prettier。

安装准备.prettierrc，其中包含配置和命令php artisan prettier以在本地环境中修复您的代码。

您可以使用.prettierignore文件来忽略您想要忽略的任何文件或目录。这对于防止Prettier格式化您不希望格式化的文件或非代码文件非常有用。

占位符

发布Laravel的默认占位符，以便我们在项目中拥有统一的源代码。

它们也略有修改，以便使编程过程更加高效。

命令

由于我们遵循Action编程概念，入门套件提供了两个命令，这将使您更加高效。

Make action命令： php artisan make:action VerifyUserAction

class VerifyUserAction
{
    /**
     * Run the action.
     */
    public function run(): void
    {
        //
    }
}

Make class命令： php artisan make:class ShoppingCart

class ShoppingCart
{
    //
}

这两个命令都有一个--test选项，也可以创建匹配的测试。

测试

composer test

更改日志

有关最近更改的更多信息，请参阅CHANGELOG。

贡献

请参阅CONTRIBUTING获取详细信息。

安全漏洞

请查阅我们的安全策略，了解如何报告安全漏洞。

致谢

许可证

MIT许可证（MIT）。请参阅许可证文件获取更多信息。

rockero-cz / starter-kit

维护者

详细信息