knuckleswtf / knuckleswtf/scribe
Add support for downloading more than one file
- Dominant language
- PHP
- Stars
- 2.3k
- Forks
- 357
- PR merge metrics
- No merged PRs in 30d
Description
### Scribe version
5.5.0
### PHP version
8.4
### Laravel version
12.38
### Scribe config
```ruby
theme => "elements"
laravel.docs_url => "/api/docs"
auth.enabled => true
auth.name => "Authorization"
last_updated => "\u041f\u043e\u0441\u043b\u0435\u0434\u043d\u0438\u0435 \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u0438\u0435: {date:F j, Y}"
strategies.bodyParameters => added DenisKorbakov\LaravelDataScribe\LaravelDataBodyParam
```
### What happened?
When I specify the upload of an array of files, the documentation does not support this upload
**class request:**
```php
final class StoreDTO extends Data
{
/**
* @param ?array $files
*/
public function __construct(
public ?string $message,
public ?array $files,
) {
}
}
```
**documentation output:**
---
I expect to see a file input with the ability to select more than one file.
### Docs
- [x] I've checked [the docs](https://scribe.knuckles.wtf/laravel), the [troubleshooting guide](https://scribe.knuckles.wtf/laravel/troubleshooting), and [existing issues](https://github.com/knuckleswtf/scribe/issues?q=is%3Aissue+), but I didn't find a solution
Contributor guide
Research direction
Reproduce the issue with the StoreDTO example and the LaravelDataBodyParam bodyParameters strategy, then trace how the array of UploadedFile values becomes the documentation output. Done means the generated documentation shows a file input that allows selecting more than one file, while preserving the existing single-file behavior.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- laravel, php
- Domain
- api, documentation
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100