knuckleswtf / knuckleswtf/scribe

Add support for downloading more than one file

Open
#1,038 0 comments 0 reactions 0 assignees View on GitHub
bug triage
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:**

Image

---

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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.