WordPress函数wp_insert_attachment详细用法教程解析

`wp_insert_attachment` 函数用于将附件（图像、音频、视频等）插入到 WordPress 网站中。该函数的详细用法解析如下：

1. 函数原型：

wp_insert_attachment( $attachment, $filename, $parent_id, $wp_error );

2. 参数说明：
- `$attachment`（必需）：一个关联数组，其中包含附件的详细信息。常见的键包括 `post_title`（附件标题）、`post_content`（附件描述）、`post_excerpt`（附件摘要）等。
- `$filename`（必需）：附件的本地文件路径。
- `$parent_id`（可选）：表示附件所属的父级帖子/页面的 ID。默认为 0，表示没有父级。
- `$wp_error`（可选）：是否返回 `WP_Error` 对象（true/false）。默认为 false，表示返回附件的 ID。

3. 返回值：
函数成功时，返回附件的 ID；失败时，返回 0 或一个 `WP_Error` 对象（如果 `$wp_error` 参数为 true）。

4. 示例用法：

$attachment = array(
'post_title' => '附件标题',
'post_content' => '附件描述',
'post_excerpt' => '附件摘要',
'post_mime_type' => 'image/jpeg' // 附件类型
);

$filename = '/path/to/image.jpg';
$parent_id = 0;
$wp_error = false;

$attachment_id = wp_insert_attachment( $attachment, $filename, $parent_id, $wp_error );

if ( ! is_wp_error( $attachment_id ) ) {
// 附件插入成功
} else {
// 附件插入失败
}

这是使用 `wp_insert_attachment` 函数将一个图像附件插入到 WordPress 网站中的简单示例。你可以根据自己的需求修改 `$attachment` 数组中的键值对，以适应不同类型的附件。