laravel-shift/blueprint

Enhance Blueprint Stubs with PHPDoc to Eliminate PHPStan Warnings

Open

#738 建立於 2025年2月11日

在 GitHub 查看
 (1 留言) (0 反應) (0 負責人)PHP (295 fork)user submission
communityenhancementgood first issue

倉庫指標

Star
 (3,107 star)
PR 合併指標
 (30 天內沒有已合併 PR)

描述

Synopsis:

Blueprint generates stubs for models, controllers, and more, but without proper PHPDoc annotations, my IDE won’t stop nagging about missing or unclear types. Adding detailed annotations would improve type inference, reduce warnings, and make development smoother.

Proposed Syntax:

As an Example we can modify the stub: stubs/model.class.stub

<?php

namespace {{ namespace }};

{{ imports }}

class {{ class }} extends Model
{
    use HasFactory;
}

To:

<?php

namespace {{ namespace }};

{{ imports }}

class {{ class }} extends Model
{
    /** @use HasFactory<\Database\Factories\{{ class }}Factory> */
    use HasFactory;
}

Expected Behavior:

PHPStan would stop complaining about missing PHPDoc comments in generated files.
P.S. The above change did introduce another issue - SoftDeletes ended up in PHPDoc instead of being added as a trait.

貢獻者指南