media_handle_upload() │ WP 2.5.0

Завантажує переданий у формі файл у папку завантажень WordPress та створює запис про файл у базі даних (додає файл до медіатеки WP).

Працює з глобальною змінною $_FILES , функції потрібно вказати індекс масиву $_FILES , який містить дані про файл, що завантажується і функція сама завантажить файл в папку завантажень WordPress і створить запис про вкладення в таблиці wp_posts в базі даних. У другому параметрі потрібно вказати id запису (поста), до якого завантажений медіафайл має бути прикріплений.

Для роботи цієї функції у фронті потрібно підключити файли:

require_once ABSPATH. 'wp-admin/includes/image.php';
require_once ABSPATH. 'wp-admin/includes/file.php';
require_once ABSPATH. 'wp-admin/includes/media.php';

Коли потрібно працювати з довільними даними файлу, а не з масовим $_FILES , використовуйте media_handle_sideload() .

Працює на основі:
wp_handle_upload() ,
wp_insert_attachment() ,
wp_update_attachment_metadata()

Хуків немає.

Повертає

int|WP_Error. ID створеного вкладення. WP_error, якщо завантаження не вдалося.

Використання

media_handle_upload( $file_id, $post_id, $post_data, $overrides );
$file_id
(рядок) (обов’язковий)
Індекс елемента масиву $_FILES, який містить дані про прийнятий файл (назва, тип, розмір, тимчасове розташування).
$post_id
(число) (обов’язковий)
ID посту, до якого буде прикріплено медіафайл. Якщо не потрібно, щоб файл був прикріплений до посту, вкажіть у параметрі
0 .
$post_data
(масив)
Дозволяє перезаписати дані вкладення. Тут вказуються дані які будуть записані в таблицю wp_posts для вкладення: post_parent, post_title, post_excerpt і т.д.


За замовчуванням: array() (за замовчуванням)
$overrides
(масив)
Дозволяє змінити поведінку
wp_handle_upload() , на основі якої працює поточна функція.


За замовчуванням: array( ‘test_form’ => false )

Приклади

0

#1 Форма завантаження файлу та його збереження

Для початку наведемо приклад коду форми із полем завантаження файлу. Імовірно код встановлено в лицьовій частині сайту:

<form id="featured_upload" method="post" action="#" enctype="multipart/form-data">
	<input type="file" name="my_image_upload" id="my_image_upload" multiple="false" />
	<input type="hidden" name="post_id" id="post_id" value="55" />
	<?php wp_nonce_field( 'my_image_upload', 'my_image_upload_nonce'); ?>
	<input id="submit_my_image_upload" name="submit_my_image_upload" type="submit" value="Upload" />
</form>

Тепер код для збереження файлу вкладення:

<?php
// Перевіримо захист nonce і що користувач може редагувати цей пост.
if (
	isset( $_POST['my_image_upload_nonce'], $_POST['post_id'] )
	&& wp_verify_nonce( $_POST['my_image_upload_nonce'], 'my_image_upload' )
	&& current_user_can( 'edit_post', $_POST['post_id'] )
) {
	// все ОК! Продовжуємо.
	// Ці файли мають бути підключені до лицьової частини (фронт-енде).
	require_once(ABSPATH. 'wp-admin/includes/image.php');
	require_once(ABSPATH. 'wp-admin/includes/file.php');
	require_once(ABSPATH. 'wp-admin/includes/media.php');

	// Дозволимо WordPress перехопити завантаження.
	// не забуваємо вказати атрибут name поля input - 'my_image_upload'
	$attachment_id = media_handle_upload( 'my_image_upload', $_POST['post_id'] );

	if ( is_wp_error( $attachment_id ) ) {
		echo "Помилка завантаження медіафайлу.";
	} else {
		echo "Медіафайл був успішно завантажений!";
	}

} else {
	echo "Перевірка не пройдена. Неможливо завантажити файл.";
}
?>
0

#2 Створення множинного завантаження файлів у WordPress

WordPress дозволяє завантажувати відразу кілька файлів навіть із можливістю drag-and-drop, в Адмін-панелі. Якщо вам потрібно додати таку можливість на зовнішню частину сайту, зробити це не так складно. Для цього припустимо, створимо шаблон сторінки (my-upload-page.php) та розмістимо на ньому форму:

<form action="" method="post" enctype="multipart/form-data" name="front_end_upload" >
	<label> Додайте всі файли тут: <input type="file" name="kv_multiple_attachments[]" multiple="multiple" > </label>
	<input type="submit" name="Завантажити" >
</form>

Ця форма надсилає дані на свою сторінку (action=””), тому в коді цього ж файлу (my-upload-page.php) шаблону потрібно розмістити обробник, див. приклад вище.

список змін

З версії 2.5.0Введено.

Код media_handle_upload() WP 6.0.2

wp-admin/includes/media.php 
function media_handle_upload( $file_id, $post_id, $post_data = array(), $overrides = array( 'test_form' => false ) ) {
	$time = current_time( 'mysql');
	$post = get_post($post_id);

	if ($post) {
		// The post date doesn't usually matter for pages, so don't backdate цей upload.
		if ( 'page' !== $post->post_type && substr( $post->post_date, 0, 4 ) > 0 ) {
			$time = $post->post_date;
		}
	}

	$file = wp_handle_upload( $_FILES[ $file_id ], $overrides, $time );

	if ( isset( $file['error'] ) ) {
		return new WP_Error( 'upload_error', $file['error'] );
	}

	$name = $_FILES[ $file_id ]['name'];
	$ ext = pathinfo ($ name, PATHINFO_EXTENSION);
	$name = wp_basename($name, ".$ext");

	$url = $file['url'];
	$type = $file['type'];
	$file = $file['file'];
	$title = sanitize_text_field($name);
	$content = '';
	$excerpt = '';

	if ( preg_match( '#^audio#', $type ) ) {
		$meta = wp_read_audio_metadata( $file );

		if ( ! empty( $meta['title'] ) ) {
			$title = $meta['title'];
		}

		if ( ! empty( $title ) ) {

			if ( ! empty( $meta['album'] ) && ! empty( $meta['artist'] ) ) {
				/* translators: 1: Audio track title, 2: Album title, 3: Artist name. */
				$content.
			} elseif ( ! empty( $meta['album'] ) ) {
				/* translators: 1: Audio track title, 2: Album title. */
				$content .= sprintf( __( '"%1$s" від %2$s.' ), $title, $meta['album'] );
			} elseif ( ! empty( $meta['artist'] ) ) {
				/* translators: 1: Audio track title, 2: Artist name. */
				$content .= sprintf( __( '"%1$s" by %2$s.' ), $title, $meta['artist'] );
			} else {
				/* translators: %s: Audio track title. */
				$content .= sprintf( __( '"%s".' ), $title );
			}
		} elseif ( ! empty( $meta['album'] ) ) {

			if ( ! empty( $meta['artist'] ) ) {
				/* translators: 1: Audio album title, 2: Artist name. */
				$content .= sprintf( __( '%1$s by %2$s.' ), $meta['album'], $meta['artist'] );
			} else {
				$content .= $meta['album'] . '.';
			}
		} elseif ( ! empty( $meta['artist'] ) ) {

			$content .= $meta['artist'] . '.';

		}

		if ( ! empty( $meta['year'] ) ) {
			/* translators: Audio file track information. %d: Year of audio track release. */
			$content .= ' ' . sprintf( __( 'Released: %d.' ), $meta['year'] );
		}

		if ( ! empty( $meta['track_number'] ) ) {
			$track_number = explode('/', $meta['track_number']);

			if ( is_numeric( $track_number[0] ) ) {
				if ( isset( $track_number[1] ) && is_numeric( $track_number[1] ) ) {
					$content .= ' ' . sprintf(
						/* translators: Audio file track information. 1: Audio track number, 2: Total audio tracks. */
						__( 'Track %1$s of %2$s.' ),
						number_format_i18n( $track_number[0] ),
						number_format_i18n( $track_number[1] )
					);
				} else {
					$content .= ' ' . sprintf(
						/* translators: Audio file track information. %s: Audio track number. */
						__( 'Track %s.' ),
						number_format_i18n( $track_number[0] )
					);
				}
			}
		}

		if ( ! empty( $meta['genre'] ) ) {
			/* translators: Audio file genre information. %s: Audio genre name. */
			$content .= ' ' . sprintf( __( 'Genre: %s.' ), $meta['genre'] );
		}

		// Use image exif/iptc data for title та caption defaults if possible.
	} elseif ( 0 === strpos( $type, 'image/' ) ) {
		$ image_meta = wp_read_image_metadata ($ file);

		if ( $image_meta ) {
			if ( trim( $image_meta['title'] ) && ! is_numeric( sanitize_title( $image_meta['title'] ) ) ) {
				$title = $image_meta['title'];
			}

			if ( trim( $image_meta['caption'] ) ) {
				$excerpt = $image_meta['caption'];
			}
		}
	}

	// Construct the attachment array.
	$attachment = array_merge(
		array(
			'post_mime_type' => $type,
			'guid' => $url,
			'post_parent' => $post_id,
			'post_title' => $title,
			'post_content' => $content,
			'post_excerpt' => $excerpt,
		),
		$post_data
	);

	// Це повинно бути неправильно, як це необхідно, щоб отриматизаписи і існуючі дії.
	unset( $attachment['ID'] );

	// Save the data.
	$ attachment_id = wp_insert_attachment ($ attachment, $ file, $ post_id, true);

	if ( ! is_wp_error( $attachment_id ) ) {
		// Set a custom header with attachment_id.
		// За допомогою браузера/client до resume creating image sub-sizes after a PHP fatal error.
		if ( ! headers_sent() ) {
			header( 'X-WP-Upload-Attachment-ID: ' . $attachment_id );
		}

		/ / The image sub-sizes є створений при wp_generate_attachment_metadata().
		// Це негайно зменшується і може призвести до timeouts or out of memory errors.
		wp_update_attachment_metadata( $attachment_id, wp_generate_attachment_metadata( $attachment_id, $file ) );
	}

	return $attachment_id;
}

upload download (файлова система file завантаження)

Завантаження (download upload)

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *