WP_Http_Encoding

17#[AllowDynamicProperties]18class WP_Http_Encoding {19 20	/**21	 * Compress raw string using the deflate format.22	 *23	 * Supports the RFC 1951 standard.24	 *25	 * @since 2.8.026	 *27	 * @param string $raw      String to compress.28	 * @param int    $level    Optional. Compression level, 9 is highest. Default 9.29	 * @param string $supports Optional, not used. When implemented it will choose30	 *                         the right compression based on what the server supports.31	 * @return string|false Compressed string on success, false on failure.32	 */33	public static function compress( $raw, $level = 9, $supports = null ) {34		return gzdeflate( $raw, $level );35	}36 37	/**38	 * Decompression of deflated string.39	 *40	 * Will attempt to decompress using the RFC 1950 standard, and if that fails41	 * then the RFC 1951 standard deflate will be attempted. Finally, the RFC42	 * 1952 standard gzip decode will be attempted. If all fail, then the43	 * original compressed string will be returned.44	 *45	 * @since 2.8.046	 *47	 * @param string $compressed String to decompress.48	 * @param int    $length     The optional length of the compressed data.49	 * @return string|false Decompressed string on success, false on failure.50	 */51	public static function decompress( $compressed, $length = null ) {52 53		if ( empty( $compressed ) ) {54			return $compressed;55		}56 57		$decompressed = @gzinflate( $compressed );58		if ( false !== $decompressed ) {59			return $decompressed;60		}61 62		$decompressed = self::compatible_gzinflate( $compressed );63		if ( false !== $decompressed ) {64			return $decompressed;65		}66 67		$decompressed = @gzuncompress( $compressed );68		if ( false !== $decompressed ) {69			return $decompressed;70		}71 72		if ( function_exists( 'gzdecode' ) ) {73			$decompressed = @gzdecode( $compressed );74 75			if ( false !== $decompressed ) {76				return $decompressed;77			}78		}79 80		return $compressed;81	}82 83	/**84	 * Decompression of deflated string while staying compatible with the majority of servers.85	 *86	 * Certain Servers will return deflated data with headers which PHP's gzinflate()87	 * function cannot handle out of the box. The following function has been created from88	 * various snippets on the gzinflate() PHP documentation.89	 *90	 * Warning: Magic numbers within. Due to the potential different formats that the compressed91	 * data may be returned in, some "magic offsets" are needed to ensure proper decompression92	 * takes place. For a simple pragmatic way to determine the magic offset in use, see:93	 * https://core.trac.wordpress.org/ticket/1827394	 *95	 * @since 2.8.196	 *