Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update and Add Type Descriptions in PHPDoc Comments #1502

Closed
wants to merge 3 commits into from

Conversation

nanato12
Copy link

Overview

There were some incorrect type descriptions and missing type descriptions in the PHPDoc comments within the stubs.

Benefit to End Users

When using static analysis tools such as PHPStan, there is no need to modify the generated files.

Reasons It Does Not Break Any Existing Features

PHPDoc has no effect on the execution of the code itself, so these changes will not impact existing functionality.

Detection with PHPStan

Detection results at level 9

 ------ --------------------------------------------------------------------------------------------------------------------- 
  Line   app/Actions/Jetstream/AddTeamMember.php                                                                              
 ------ --------------------------------------------------------------------------------------------------------------------- 
  59     Method App\Actions\Jetstream\AddTeamMember::rules() return type has no value type specified in iterable type array.  
         💡 See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                            
 ------ --------------------------------------------------------------------------------------------------------------------- 

 ------ ------------------------------------------------------------------------------------------------------------------------------- 
  Line   app/Actions/Jetstream/InviteTeamMember.php                                                                                     
 ------ -------------------------------------------------------------------------------------------------------------------------------                                                                                  
  60     Method App\Actions\Jetstream\InviteTeamMember::rules() return type has no value type specified in iterable type array.         
         💡 See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                                      
 ------ ------------------------------------------------------------------------------------------------------------------------------- 

------ ----------------------------------------------------------------------------------------------------------------------------------------------- 
  Line   app/Models/TeamInvitation.php                                                                                                                  
 ------ ----------------------------------------------------------------------------------------------------------------------------------------------- 
  24     Method App\Models\TeamInvitation::team() return type with generic class Illuminate\Database\Eloquent\Relations\BelongsTo does not specify its  
         types: TRelatedModel, TChildModel                                                                                                              
 ------ ----------------------------------------------------------------------------------------------------------------------------------------------- 

@taylorotwell
Copy link
Member

Thanks for your pull request to Laravel!

Unfortunately, I'm going to delay merging this code for now. To preserve our ability to adequately maintain the framework, we need to be very careful regarding the amount of code we include.

If possible, please consider releasing your code as a package so that the community can still take advantage of your contributions!

If you feel absolutely certain that this code corrects a bug in the framework, please "@" mention me in a follow-up comment with further explanation so that GitHub will send me a notification of your response.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants