# request_filesystem_credentials

URL: https://chugunov.pro/api-wordpress/filters/request_filesystem_credentials/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: хук-фильтр.
Появился в версии: 2.5.0.

## Сигнатура

```php
apply_filters( 'request_filesystem_credentials', mixed $credentials, string $form_post, string $type, bool|WP_Error $error, string $context, array $extra_fields, bool $allow_relaxed_file_ownership )
```

## Описание

Возврат любого значения, кроме пустой строки, фактически прервёт вывод формы учётных данных файловой системы и вернёт это значение вместо неё.
Фильтр должен вернуть true, если учётные данные файловой системы не требуются, false — если они требуются, но не были предоставлены, или массив учётных данных, если они требуются и были предоставлены.

## Параметры

- `$credentials` `mixed` — обязательный. Учётные данные, возвращаемые вместо этого. По умолчанию пустая строка.
- `$form_post` `string` — обязательный. URL, на который отправляется форма.
- `$type` `string` — обязательный. Выбранный тип файловой системы.
- `$error` `bool|WP_Error` — обязательный. Не удалось ли текущему запросу установить соединение, либо объект ошибки.
- `$context` `string` — обязательный. Полный путь к каталогу, который проверяется на возможность записи.
- `$extra_fields` `array` — обязательный. Дополнительные поля POST.
- `$allow_relaxed_file_ownership` `bool` — обязательный. Разрешать ли запись для группы и всех пользователей.

## Фильтруемое значение

Учётные данные, возвращаемые вместо этого. По умолчанию пустая строка.

## Исходный код

Файл: `wp-admin/includes/file.php:2389`

```php
$req_cred = apply_filters( 'request_filesystem_credentials', '', $form_post, $type, $error, $context, $extra_fields, $allow_relaxed_file_ownership );
```

## История изменений

- 4.6.0 — The $context parameter default changed from false to an empty string.
- 2.5.0 — Introduced.

## Связанные

Используется в: [`request_filesystem_credentials`](https://chugunov.pro/api-wordpress/functions/request_filesystem_credentials/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/hooks/request_filesystem_credentials/
