laravel-shift/blueprint
Enhance Blueprint Stubs with PHPDoc to Eliminate PHPStan Warnings
Aberta
#738 aberto em 11 de fev. de 2025
communityenhancementgood first issue
Métricas do repositório
- Stars
- (3.107 estrelas)
- Métricas de merge de PR
- (Mesclagem média 15h 29m) (7 fundiu PRs em 30d)
Description
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.