函数文档

sanitize_mime_type()

💡 云策文档标注

概述

sanitize_mime_type() 函数用于清理 MIME 类型字符串,移除非法字符,确保其格式安全。该函数通过正则表达式过滤输入,并提供一个过滤器钩子供开发者自定义处理。

关键要点

  • 函数接受一个字符串参数 $mime_type,返回清理后的 MIME 类型字符串。
  • 使用正则表达式 preg_replace('/[^-+*.a-zA-Z0-9/]/', '', $mime_type) 移除除字母、数字、斜杠、点、加号、减号和星号外的所有字符。
  • 提供 apply_filters('sanitize_mime_type', $sani_mime_type, $mime_type) 钩子,允许在清理后过滤 MIME 类型。
  • 函数自 WordPress 3.1.3 版本引入,属于核心功能的一部分。

代码示例

function sanitize_mime_type( $mime_type ) {
    $sani_mime_type = preg_replace( '/[^-+*.a-zA-Z0-9/]/', '', $mime_type );
    return apply_filters( 'sanitize_mime_type', $sani_mime_type, $mime_type );
}

📄 原文内容

Sanitizes a mime type

Parameters

$mime_typestringrequired
Mime type.

Return

string Sanitized mime type.

Source

function sanitize_mime_type( $mime_type ) {
	$sani_mime_type = preg_replace( '/[^-+*.a-zA-Z0-9/]/', '', $mime_type );
	/**
	 * Filters a mime type following sanitization.
	 *
	 * @since 3.1.3
	 *
	 * @param string $sani_mime_type The sanitized mime type.
	 * @param string $mime_type      The mime type prior to sanitization.
	 */
	return apply_filters( 'sanitize_mime_type', $sani_mime_type, $mime_type );
}

Hooks

apply_filters( ‘sanitize_mime_type’, string $sani_mime_type, string $mime_type )

Filters a mime type following sanitization.

Changelog

Version Description
3.1.3 Introduced.

User Contributed Notes