【WordPress】PHPプログラムからサーバ上のファイルをメディアライブラリへ登録する方法

概要

media_handle_sideload関数を使用すると、既にWEBサーバ上にアップされているファイルをメディアライブラリに登録することができる。

media_handle_sideload関数

media_handle_sideload(連想配列, 投稿ID(省略可))
※連想配列はキーname, tmp_nameを持つ

media_handle_sideload() – Function | Developer.WordPress.org

Handles a side-loaded file in the same way as an uploaded file is handled by media_handle_upload() .

developer.wordpress.org

media_handle_sideload関数を使用するには、以下の3ファイルのインポートが必要。
require_once(ABSPATH . 'wp-admin/includes/image.php');
require_once(ABSPATH . 'wp-admin/includes/file.php');
require_once(ABSPATH . 'wp-admin/includes/media.php');

サンプル

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

$file = [
		'name' => 'hoge.jpg',
		'tmp_name' => '/home/hoge/hoge.jpg',
];
$attachmentId = media_handle_sideload($file);