Laravel 代码质量保障：测试、静态分析与架构规范最佳实践

laravel-quality by leeovery/claude-laravel

116 周安装量

43 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/leeovery/claude-laravel --skill laravel-quality

代码质量 Laravel 测试

🇨🇳中文介绍

Laravel 质量

测试、静态分析与代码质量保障。

相关指南：

code-style.md - Laravel Pint 配置与编码风格
type-safety.md - 严格类型与类型提示
Testing - 全面的测试指南

质量技术栈

# composer.json scripts
{
    "test": "pest",
    "analyse": "phpstan analyse",
    "format": "pint",
    "quality": [
        "@analyse",
        "@test"
    ]
}

所有文件必须在顶部声明 declare(strict_types=1)。每次提交前运行质量检查。

架构测试 (Pest)

设置

tests/Pest.php

pest()->extend(Tests\TestCase::class)->in('Feature', 'Unit');

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

静态分析 (PHPStan)

composer require phpstan/phpstan --dev
composer require phpstan/phpstan-strict-rules --dev
composer require larastan/larastan --dev

includes:
    - vendor/larastan/larastan/extension.neon
    - vendor/phpstan/phpstan-strict-rules/rules.neon

parameters:
    level: 8
    paths:
        - app
        - tests
    excludePaths:
        - app/Providers/TelescopeServiceProvider.php
    checkMissingIterableValueType: true
    checkGenericClassInNonGenericObjectType: true
    reportUnmatchedIgnoredErrors: false

./vendor/bin/phpstan analyse

代码风格 (Laravel Pint)

composer require laravel/pint --dev

{
    "preset": "laravel",
    "rules": {
        "simplified_null_return": true,
        "no_unused_imports": true,
        "ordered_imports": {
            "sort_algorithm": "alpha"
        }
    }
}

./vendor/bin/pint
./vendor/bin/pint --test  # 仅检查

启用覆盖率 (Pest)

<coverage>
    <report>
        <html outputDirectory="coverage"/>
        <text outputFile="php://stdout"/>
    </report>
</coverage>

运行覆盖率测试

./vendor/bin/pest --coverage
./vendor/bin/pest --coverage --min=80  # 强制执行最低覆盖率

GitHub Actions 示例

.github/workflows/tests.yml

name: Tests

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v3

      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: 8.4
          extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite
          coverage: xdebug

      - name: Install Dependencies
        run: composer install --prefer-dist --no-interaction

      - name: Code Style
        run: ./vendor/bin/pint --test

      - name: Static Analysis
        run: ./vendor/bin/phpstan analyse

      - name: Run Tests
        run: ./vendor/bin/pest --coverage --min=80

composer require brainmaestro/composer-git-hooks --dev

{
    "extra": {
        "hooks": {
            "pre-commit": [
                "./vendor/bin/pint",
                "./vendor/bin/phpstan analyse",
                "./vendor/bin/pest"
            ]
        }
    },
    "scripts": {
        "post-install-cmd": "vendor/bin/cghooks add --ignore-lock",
        "post-update-cmd": "vendor/bin/cghooks update"
    }
}

需要跟踪的内容

测试覆盖率 - 目标 80% 以上
PHPStan 级别 - 级别 8 (最高)
架构测试通过率 - 100%
代码风格违规 - 0

每周 - 检查测试覆盖率趋势
每个 PR - 运行所有质量检查
每月 - 审查架构合规性
发布时 - 全面的质量审计

需要关注的常见问题

控制器中包含领域逻辑
使用作用域而非构建器
缺少严格类型声明
传递原始类型而非 DTO
作业/监听器中包含领域逻辑

缺少返回类型
缺少参数类型
缺少属性类型
未类型化的数组/集合

端点缺少功能测试
操作缺少单元测试
关键路径覆盖率低
脆弱的测试 (过多的模拟)

架构测试 - 自动化检查
PR 审查 - 手动验证
CI/CD 门控 - 阻止失败的构建
团队标准 - 文档 + 培训
结对编程 - 分享知识

🇺🇸English

Laravel Quality

Testing, static analysis, and code quality enforcement.

Related guides:

code-style.md - Laravel Pint configuration and coding style
type-safety.md - Strict types and type hints
Testing - Comprehensive testing guide

Quality Stack

# composer.json scripts
{
    "test": "pest",
    "analyse": "phpstan analyse",
    "format": "pint",
    "quality": [
        "@analyse",
        "@test"
    ]
}

All files must have declare(strict_types=1) at top. Run quality checks before every commit.

Architecture Tests (Pest)

Setup

tests/Pest.php

pest()->extend(Tests\TestCase::class)->in('Feature', 'Unit');

Core Architecture Tests

tests/Architecture/ActionsTest.php

<?php

declare(strict_types=1);

arch('actions are invokable')
    ->expect('App\Actions')
    ->toHaveMethod('__invoke');

arch('actions live in Actions namespace')
    ->expect('App\Actions')
    ->toBeClasses()
    ->toOnlyBeUsedIn('App\Actions', 'App\Http', 'App\Jobs', 'App\Listeners');

arch('actions do not use models directly')
    ->expect('App\Actions')
    ->not->toUse('Illuminate\Database\Eloquent\Model');

tests/Architecture/DataTest.php

<?php

declare(strict_types=1);

arch('data objects extend base Data class')
    ->expect('App\Data')
    ->toExtend('App\Data\Data')
    ->ignoring('App\Data\Data');

arch('data objects use constructor property promotion')
    ->expect('App\Data')
    ->toHaveConstructor();

tests/Architecture/StrictTypesTest.php

<?php

declare(strict_types=1);

arch('app files declare strict types')
    ->expect('App')
    ->toUseStrictTypes();

arch('test files declare strict types')
    ->expect('Tests')
    ->toUseStrictTypes();

tests/Architecture/ControllersTest.php

<?php

declare(strict_types=1);

arch('controllers do not use DB facade')
    ->expect('App\Http')
    ->not->toUse('Illuminate\Support\Facades\DB');

arch('controllers do not use models directly')
    ->expect('App\Http\Web\Controllers')
    ->not->toUse('App\Models');

tests/Architecture/NamingTest.php

<?php

declare(strict_types=1);

arch('actions end with Action suffix')
    ->expect('App\Actions')
    ->toHaveSuffix('Action');

arch('data objects end with Data suffix')
    ->expect('App\Data')
    ->toHaveSuffix('Data')
    ->ignoring('App\Data\Data', 'App\Data\Concerns');

arch('exceptions end with Exception suffix')
    ->expect('App\Exceptions')
    ->toHaveSuffix('Exception')
    ->ignoring('App\Exceptions\Concerns');

tests/Architecture/ModelsTest.php

<?php

declare(strict_types=1);

arch('models use custom query builders')
    ->expect('App\Models')
    ->toHaveMethod('newEloquentBuilder');

arch('models do not use local scopes')
    ->expect('App\Models')
    ->not->toHaveMethod('scope*');

Static Analysis (PHPStan)

Installation

composer require phpstan/phpstan --dev
composer require phpstan/phpstan-strict-rules --dev
composer require larastan/larastan --dev

Configuration

phpstan.neon

includes:
    - vendor/larastan/larastan/extension.neon
    - vendor/phpstan/phpstan-strict-rules/rules.neon

parameters:
    level: 8
    paths:
        - app
        - tests
    excludePaths:
        - app/Providers/TelescopeServiceProvider.php
    checkMissingIterableValueType: true
    checkGenericClassInNonGenericObjectType: true
    reportUnmatchedIgnoredErrors: false

Run

./vendor/bin/phpstan analyse

Code Style (Laravel Pint)

Installation

composer require laravel/pint --dev

Configuration

pint.json

{
    "preset": "laravel",
    "rules": {
        "simplified_null_return": true,
        "no_unused_imports": true,
        "ordered_imports": {
            "sort_algorithm": "alpha"
        }
    }
}

Run

./vendor/bin/pint
./vendor/bin/pint --test  # Check only

Test Coverage

Enable Coverage (Pest)

phpunit.xml

<coverage>
    <report>
        <html outputDirectory="coverage"/>
        <text outputFile="php://stdout"/>
    </report>
</coverage>

Run with Coverage

./vendor/bin/pest --coverage
./vendor/bin/pest --coverage --min=80  # Enforce minimum

CI/CD Checks

GitHub Actions Example

.github/workflows/tests.yml

name: Tests

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v3

      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: 8.4
          extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite
          coverage: xdebug

      - name: Install Dependencies
        run: composer install --prefer-dist --no-interaction

      - name: Code Style
        run: ./vendor/bin/pint --test

      - name: Static Analysis
        run: ./vendor/bin/phpstan analyse

      - name: Run Tests
        run: ./vendor/bin/pest --coverage --min=80

Pre-commit Hooks

Installation

composer require brainmaestro/composer-git-hooks --dev

Configuration

composer.json

{
    "extra": {
        "hooks": {
            "pre-commit": [
                "./vendor/bin/pint",
                "./vendor/bin/phpstan analyse",
                "./vendor/bin/pest"
            ]
        }
    },
    "scripts": {
        "post-install-cmd": "vendor/bin/cghooks add --ignore-lock",
        "post-update-cmd": "vendor/bin/cghooks update"
    }
}

Quality Metrics

What to Track

Test coverage - Aim for 80%+
PHPStan level - Level 8 (max)
Architecture test pass rate - 100%
Code style violations - 0

Regular Reviews

Weekly - Check test coverage trends
Per PR - Run all quality checks
Monthly - Review architecture compliance
Release - Full quality audit

Common Issues to Watch

Anti-patterns

Domain logic in controllers
Using scopes instead of builders
Missing strict types declaration
Passing primitives instead of DTOs
Jobs/Listeners with domain logic

Type Safety

Missing return types
Missing parameter types
Missing property types
Untyped arrays/collections

Testing

Missing feature tests for endpoints
Missing unit tests for actions
Low coverage on critical paths
Brittle tests (too many mocks)

Enforcement Strategy

Architecture tests - Automated checks
PR reviews - Manual verification
CI/CD gates - Block failing builds
Team standards - Document + training
Pair programming - Share knowledge

Weekly Installs

116

Repository

leeovery/claude-laravel

GitHub Stars

First Seen

Jan 24, 2026

Security Audits

Gen Agent Trust HubWarn SocketPass SnykPass

Installed on

opencode105

codex104

gemini-cli102

claude-code88

cursor86

github-copilot84

后端测试指南：API端点、业务逻辑与数据库测试最佳实践

11,800 周安装

Laravel 代码质量保障：测试、静态分析与架构规范最佳实践

🇨🇳中文介绍

Laravel 质量

质量技术栈

架构测试 (Pest)

设置

相关 Skills

核心架构测试

静态分析 (PHPStan)

安装

配置

运行

代码风格 (Laravel Pint)

安装

配置

运行

测试覆盖率

启用覆盖率 (Pest)

运行覆盖率测试

CI/CD 检查

GitHub Actions 示例

预提交钩子

安装

配置

质量指标

需要跟踪的内容

定期审查

需要关注的常见问题

反模式

类型安全

测试

执行策略

🇺🇸English

Laravel Quality

Quality Stack

Architecture Tests (Pest)

Setup

Core Architecture Tests

Static Analysis (PHPStan)

Installation

Configuration

Run

Code Style (Laravel Pint)

Installation

Configuration

Run

Test Coverage

Enable Coverage (Pest)

Run with Coverage

CI/CD Checks

GitHub Actions Example

Pre-commit Hooks

Installation

Configuration

Quality Metrics

What to Track

Regular Reviews

Common Issues to Watch

Anti-patterns

Type Safety

Testing

Enforcement Strategy

最新 Skills