WordPress 4.4

[autoinstalls/wordpress.git] / wp-includes / compat.php

diff --git a/wp-includes/compat.php b/wp-includes/compat.php
index 4317eb689b1416f187f66870a9a5b1a068666af2..24da0adc3e167f2a8ec3ffd61af902e2d68ae22f 100644 (file)
--- a/wp-includes/compat.php
+++ b/wp-includes/compat.php
@@ -20,6 +20,8 @@ if ( !function_exists('_') ) {
  * @since 4.2.2
  * @access private
  *
+ * @staticvar string $utf8_pcre
+ *
  * @param bool $set - Used for testing only
  *             null   : default - get PCRE/u capability
  *             false  : Used for testing - return false for future calls to this function
@@ -193,6 +195,12 @@ if ( !function_exists('json_encode') ) {
 }
 
 if ( !function_exists('json_decode') ) {
+       /**
+        * @global Services_JSON $wp_json
+        * @param string $string
+        * @param bool   $assoc_array
+        * @return object|array
+        */
        function json_decode( $string, $assoc_array = false ) {
                global $wp_json;
 
@@ -206,6 +214,11 @@ if ( !function_exists('json_decode') ) {
                        $res = _json_decode_object_helper( $res );
                return $res;
        }
+
+       /**
+        * @param object $data
+        * @return array
+        */
        function _json_decode_object_helper($data) {
                if ( is_object($data) )
                        $data = get_object_vars($data);
@@ -247,3 +260,80 @@ endif;
 if ( ! defined( 'JSON_PRETTY_PRINT' ) ) {
        define( 'JSON_PRETTY_PRINT', 128 );
 }
+
+if ( ! function_exists( 'json_last_error_msg' ) ) :
+       /**
+        * Retrieves the error string of the last json_encode() or json_decode() call.
+        *
+        * @since 4.4.0
+        *
+        * @internal This is a compatibility function for PHP <5.5
+        *
+        * @return bool|string Returns the error message on success, "No Error" if no error has occurred,
+        *                     or false on failure.
+        */
+       function json_last_error_msg() {
+               // See https://core.trac.wordpress.org/ticket/27799.
+               if ( ! function_exists( 'json_last_error' ) ) {
+                       return false;
+               }
+
+               $last_error_code = json_last_error();
+
+               // Just in case JSON_ERROR_NONE is not defined.
+               $error_code_none = defined( 'JSON_ERROR_NONE' ) ? JSON_ERROR_NONE : 0;
+
+               switch ( true ) {
+                       case $last_error_code === $error_code_none:
+                               return 'No error';
+
+                       case defined( 'JSON_ERROR_DEPTH' ) && JSON_ERROR_DEPTH === $last_error_code:
+                               return 'Maximum stack depth exceeded';
+
+                       case defined( 'JSON_ERROR_STATE_MISMATCH' ) && JSON_ERROR_STATE_MISMATCH === $last_error_code:
+                               return 'State mismatch (invalid or malformed JSON)';
+
+                       case defined( 'JSON_ERROR_CTRL_CHAR' ) && JSON_ERROR_CTRL_CHAR === $last_error_code:
+                               return 'Control character error, possibly incorrectly encoded';
+
+                       case defined( 'JSON_ERROR_SYNTAX' ) && JSON_ERROR_SYNTAX === $last_error_code:
+                               return 'Syntax error';
+
+                       case defined( 'JSON_ERROR_UTF8' ) && JSON_ERROR_UTF8 === $last_error_code:
+                               return 'Malformed UTF-8 characters, possibly incorrectly encoded';
+
+                       case defined( 'JSON_ERROR_RECURSION' ) && JSON_ERROR_RECURSION === $last_error_code:
+                               return 'Recursion detected';
+
+                       case defined( 'JSON_ERROR_INF_OR_NAN' ) && JSON_ERROR_INF_OR_NAN === $last_error_code:
+                               return 'Inf and NaN cannot be JSON encoded';
+
+                       case defined( 'JSON_ERROR_UNSUPPORTED_TYPE' ) && JSON_ERROR_UNSUPPORTED_TYPE === $last_error_code:
+                               return 'Type is not supported';
+
+                       default:
+                               return 'An unknown error occurred';
+               }
+       }
+endif;
+
+if ( ! interface_exists( 'JsonSerializable' ) ) {
+       define( 'WP_JSON_SERIALIZE_COMPATIBLE', true );
+       /**
+        * JsonSerializable interface.
+        *
+        * Compatibility shim for PHP <5.4
+        *
+     * @link http://php.net/jsonserializable
+        *
+        * @since 4.4.0
+        */
+       interface JsonSerializable {
+               public function jsonSerialize();
+       }
+}
+
+// random_int was introduced in PHP 7.0
+if ( ! function_exists( 'random_int' ) ) {
+       require ABSPATH . WPINC . '/random_compat/random.php';
+}