函数 wp_delete_attachment() 用于删除附件。

使用方法如下:

wp_delete_attachment( $attachment_id, $force_delete );

参数说明:
- $attachment_id(必填):要删除的附件的 ID。
- $force_delete(可选):是否强制删除附件。默认为 false,即将附件移动到回收站。若设为 true,则永久删除附件。

使用示例:

// 删除附件并移动到回收站
wp_delete_attachment( 123 );

// 强制删除附件
wp_delete_attachment( 456, true );

注意事项:
- 该函数只删除附件,不会删除附件对应的媒体文件或图像文件。如果需要删除媒体文件,可以使用函数 wp_delete_file()。
- 如果附件被其他内容使用,删除附件可能会导致这些内容无法访问到附件。所以在删除附件之前应该确认附件不再被使用。
- 若附件包含多个文件(如图像的不同尺寸),删除附件时只会删除主文件,其它文件会被保留。

总结:
函数 wp_delete_attachment() 用于删除 WordPress 网站中的附件。根据参数设置,可以将附件移动到回收站或永久删除附件。在使用该函数删除附件之前,应该确保附件不再被使用,并根据需要进行媒体文件的删除。