Make WordPress Core

Changeset 42058


Ignore:
Timestamp:
10/31/2017 12:33:25 PM (9 years ago)
Author:
pento
Message:

Database: Restore numbered placeholders in wpdb::prepare().

[41496] removed support for numbered placeholders in queries send through wpdb::prepare(), which, despite being undocumented, were quite commonly used.

This change restores support for numbered placeholders (as well as a subset of placeholder formatting), while also adding extra checks to ensure the correct number of arguments are being passed to wpdb::prepare(), given the number of placeholders.

Merges [41662], [42056] to the 4.7 branch.
See #41925.

Location:
branches/4.7
Files:
9 edited

Legend:

Unmodified
Added
Removed
  • branches/4.7

  • branches/4.7/src/wp-includes/post.php

    r39629 r42058  
    42424242        $page_path = str_replace('%20', ' ', $page_path);
    42434243        $parts = explode( '/', trim( $page_path, '/' ) );
    4244         $parts = esc_sql( $parts );
    42454244        $parts = array_map( 'sanitize_title_for_query', $parts );
    4246 
    4247         $in_string = "'" . implode( "','", $parts ) . "'";
     4245        $escaped_parts = esc_sql( $parts );
     4246
     4247        $in_string = "'" . implode( "','", $escaped_parts ) . "'";
    42484248
    42494249        if ( is_array( $post_type ) ) {
  • branches/4.7/src/wp-includes/wp-db.php

    r41498 r42058  
    11691169                if ( $this->dbh ) {
    11701170                        if ( $this->use_mysqli ) {
    1171                                 return mysqli_real_escape_string( $this->dbh, $string );
     1171                                $escaped = mysqli_real_escape_string( $this->dbh, $string );
    11721172                        } else {
    1173                                 return mysql_real_escape_string( $string, $this->dbh );
    1174                         }
    1175                 }
    1176 
    1177                 $class = get_class( $this );
    1178                 if ( function_exists( '__' ) ) {
    1179                         /* translators: %s: database access abstraction class, usually wpdb or a class extending wpdb */
    1180                         _doing_it_wrong( $class, sprintf( __( '%s must set a database connection for use with escaping.' ), $class ), '3.6.0' );
     1173                                $escaped = mysql_real_escape_string( $string, $this->dbh );
     1174                        }
    11811175                } else {
    1182                         _doing_it_wrong( $class, sprintf( '%s must set a database connection for use with escaping.', $class ), '3.6.0' );
    1183                 }
    1184                 return addslashes( $string );
     1176                        $class = get_class( $this );
     1177                        if ( function_exists( '__' ) ) {
     1178                                /* translators: %s: database access abstraction class, usually wpdb or a class extending wpdb */
     1179                                _doing_it_wrong( $class, sprintf( __( '%s must set a database connection for use with escaping.' ), $class ), '3.6.0' );
     1180                        } else {
     1181                                _doing_it_wrong( $class, sprintf( '%s must set a database connection for use with escaping.', $class ), '3.6.0' );
     1182                        }
     1183                        $escaped = addslashes( $string );
     1184                }
     1185
     1186                return $this->add_placeholder_escape( $escaped );
    11851187        }
    11861188
     
    12581260         * Prepares a SQL query for safe execution. Uses sprintf()-like syntax.
    12591261         *
    1260          * The following directives can be used in the query format string:
     1262         * The following placeholders can be used in the query string:
    12611263         *   %d (integer)
    12621264         *   %f (float)
    12631265         *   %s (string)
    1264          *   %% (literal percentage sign - no argument needed)
    1265          *
    1266          * All of %d, %f, and %s are to be left unquoted in the query string and they need an argument passed for them.
    1267          * Literals (%) as parts of the query must be properly written as %%.
    1268          *
    1269          * This function only supports a small subset of the sprintf syntax; it only supports %d (integer), %f (float), and %s (string).
    1270          * Does not support sign, padding, alignment, width or precision specifiers.
    1271          * Does not support argument numbering/swapping.
    1272          *
    1273          * May be called like {@link https://secure.php.net/sprintf sprintf()} or like {@link https://secure.php.net/vsprintf vsprintf()}.
    1274          *
    1275          * Both %d and %s should be left unquoted in the query string.
    1276          *
    1277          *     $wpdb->prepare( "SELECT * FROM `table` WHERE `column` = %s AND `field` = %d", 'foo', 1337 );
     1266         *
     1267         * All placeholders MUST be left unquoted in the query string. A corresponding argument MUST be passed for each placeholder.
     1268         *
     1269         * For compatibility with old behavior, numbered or formatted string placeholders (eg, %1$s, %5s) will not have quotes
     1270         * added by this function, so should be passed with appropriate quotes around them for your usage.
     1271         *
     1272         * Literal percentage signs (%) in the query string must be written as %%. Percentage wildcards (for example,
     1273         * to use in LIKE syntax) must be passed via a substitution argument containing the complete LIKE string, these
     1274         * cannot be inserted directly in the query string. Also see {@see esc_like()}.
     1275         *
     1276         * Arguments may be passed as individual arguments to the method, or as a single array containing all arguments. A combination
     1277         * of the two is not supported.
     1278         *
     1279         * Examples:
     1280         *     $wpdb->prepare( "SELECT * FROM `table` WHERE `column` = %s AND `field` = %d OR `other_field` LIKE %s", array( 'foo', 1337, '%bar' ) );
    12781281         *     $wpdb->prepare( "SELECT DATE_FORMAT(`field`, '%%c') FROM `table` WHERE `column` = %s", 'foo' );
    12791282         *
     
    12821285         *
    12831286         * @param string      $query    Query statement with sprintf()-like placeholders
    1284          * @param array|mixed $args     The array of variables to substitute into the query's placeholders if being called like
    1285          *                              {@link https://secure.php.net/vsprintf vsprintf()}, or the first variable to substitute into the query's placeholders if
    1286          *                              being called like {@link https://secure.php.net/sprintf sprintf()}.
    1287          * @param mixed       $args,... further variables to substitute into the query's placeholders if being called like
    1288          *                              {@link https://secure.php.net/sprintf sprintf()}.
     1287         * @param array|mixed $args     The array of variables to substitute into the query's placeholders if being called with an array of arguments,
     1288         *                              or the first variable to substitute into the query's placeholders if being called with individual arguments.
     1289         * @param mixed       $args,... further variables to substitute into the query's placeholders if being called wih individual arguments.
    12891290         * @return string|void Sanitized query string, if there is a query to prepare.
    12901291         */
    12911292        public function prepare( $query, $args ) {
    1292                 if ( is_null( $query ) )
     1293                if ( is_null( $query ) ) {
    12931294                        return;
     1295                }
    12941296
    12951297                // This is not meant to be foolproof -- but it will catch obviously incorrect usage.
    12961298                if ( strpos( $query, '%' ) === false ) {
     1299                        wp_load_translations_early();
    12971300                        _doing_it_wrong( 'wpdb::prepare', sprintf( __( 'The query argument of %s must have a placeholder.' ), 'wpdb::prepare()' ), '3.9.0' );
    12981301                }
     
    13011304                array_shift( $args );
    13021305
    1303                 // If args were passed as an array (as in vsprintf), move them up
     1306                // If args were passed as an array (as in vsprintf), move them up.
     1307                $passed_as_array = false;
    13041308                if ( is_array( $args[0] ) && count( $args ) == 1 ) {
     1309                        $passed_as_array = true;
    13051310                        $args = $args[0];
    13061311                }
     
    13081313                foreach ( $args as $arg ) {
    13091314                        if ( ! is_scalar( $arg ) && ! is_null( $arg ) ) {
    1310                                 _doing_it_wrong( 'wpdb::prepare', sprintf( 'Unsupported value type (%s).', gettype( $arg ) ), '4.7.6' );
    1311                         }
    1312                 }
    1313 
    1314                 $query = str_replace( "'%s'", '%s', $query ); // in case someone mistakenly already singlequoted it
    1315                 $query = str_replace( '"%s"', '%s', $query ); // doublequote unquoting
    1316                 $query = preg_replace( '|(?<!%)%f|' , '%F', $query ); // Force floats to be locale unaware
    1317                 $query = preg_replace( '|(?<!%)%s|', "'%s'", $query ); // quote the strings, avoiding escaped strings like %%s
    1318                 $query = preg_replace( '/%(?:%|$|([^dsF]))/', '%%\\1', $query ); // escape any unescaped percents
     1315                                wp_load_translations_early();
     1316                                _doing_it_wrong( 'wpdb::prepare', sprintf( __( 'Unsupported value type (%s).' ), gettype( $arg ) ), '4.8.2' );
     1317                        }
     1318                }
     1319
     1320                /*
     1321                 * Specify the formatting allowed in a placeholder. The following are allowed:
     1322                 *
     1323                 * - Sign specifier. eg, $+d
     1324                 * - Numbered placeholders. eg, %1$s
     1325                 * - Padding specifier, including custom padding characters. eg, %05s, %'#5s
     1326                 * - Alignment specifier. eg, %05-s
     1327                 * - Precision specifier. eg, %.2f
     1328                 */
     1329                $allowed_format = '(?:[1-9][0-9]*[$])?[-+0-9]*(?: |0|\'.)?[-+0-9]*(?:\.[0-9]+)?';
     1330
     1331                /*
     1332                 * If a %s placeholder already has quotes around it, removing the existing quotes and re-inserting them
     1333                 * ensures the quotes are consistent.
     1334                 *
     1335                 * For backwards compatibility, this is only applied to %s, and not to placeholders like %1$s, which are frequently
     1336                 * used in the middle of longer strings, or as table name placeholders.
     1337                 */
     1338                $query = str_replace( "'%s'", '%s', $query ); // Strip any existing single quotes.
     1339                $query = str_replace( '"%s"', '%s', $query ); // Strip any existing double quotes.
     1340                $query = preg_replace( '/(?<!%)%s/', "'%s'", $query ); // Quote the strings, avoiding escaped strings like %%s.
     1341
     1342                $query = preg_replace( "/(?<!%)(%($allowed_format)?f)/" , '%\\2F', $query ); // Force floats to be locale unaware.
     1343
     1344                $query = preg_replace( "/%(?:%|$|(?!($allowed_format)?[sdF]))/", '%%\\1', $query ); // Escape any unescaped percents.
     1345
     1346                // Count the number of valid placeholders in the query.
     1347                $placeholders = preg_match_all( "/(^|[^%]|(%%)+)%($allowed_format)?[sdF]/", $query, $matches );
     1348
     1349                if ( count( $args ) !== $placeholders ) {
     1350                        if ( 1 === $placeholders && $passed_as_array ) {
     1351                                // If the passed query only expected one argument, but the wrong number of arguments were sent as an array, bail.
     1352                                wp_load_translations_early();
     1353                                _doing_it_wrong( 'wpdb::prepare', __( 'The query only expected one placeholder, but an array of multiple placeholders was sent.' ), '4.9.0' );
     1354
     1355                                return;
     1356                        } else {
     1357                                /*
     1358                                 * If we don't have the right number of placeholders, but they were passed as individual arguments,
     1359                                 * or we were expecting multiple arguments in an array, throw a warning.
     1360                                 */
     1361                                wp_load_translations_early();
     1362                                _doing_it_wrong( 'wpdb::prepare',
     1363                                        /* translators: 1: number of placeholders, 2: number of arguments passed */
     1364                                        sprintf( __( 'The query does not contain the correct number of placeholders (%1$d) for the number of arguments passed (%2$d).' ),
     1365                                                $placeholders,
     1366                                                count( $args ) ),
     1367                                        '4.8.3'
     1368                                );
     1369                        }
     1370                }
     1371
    13191372                array_walk( $args, array( $this, 'escape_by_ref' ) );
    1320                 return @vsprintf( $query, $args );
     1373                $query = @vsprintf( $query, $args );
     1374
     1375                return $this->add_placeholder_escape( $query );
    13211376        }
    13221377
     
    18941949                        $this->queries[] = array( $query, $this->timer_stop(), $this->get_caller() );
    18951950                }
     1951        }
     1952
     1953        /**
     1954         * Generates and returns a placeholder escape string for use in queries returned by ::prepare().
     1955         *
     1956         * @since 4.8.3
     1957         *
     1958         * @return string String to escape placeholders.
     1959         */
     1960        public function placeholder_escape() {
     1961                static $placeholder;
     1962
     1963                if ( ! $placeholder ) {
     1964                        // If ext/hash is not present, compat.php's hash_hmac() does not support sha256.
     1965                        $algo = function_exists( 'hash' ) ? 'sha256' : 'sha1';
     1966                        // Old WP installs may not have AUTH_SALT defined.
     1967                        $salt = defined( 'AUTH_SALT' ) ? AUTH_SALT : rand();
     1968
     1969                        $placeholder = '{' . hash_hmac( $algo, uniqid( $salt, true ), $salt ) . '}';
     1970                }
     1971
     1972                /*
     1973                 * Add the filter to remove the placeholder escaper. Uses priority 0, so that anything
     1974                 * else attached to this filter will recieve the query with the placeholder string removed.
     1975                 */
     1976                if ( ! has_filter( 'query', array( $this, 'remove_placeholder_escape' ) ) ) {
     1977                        add_filter( 'query', array( $this, 'remove_placeholder_escape' ), 0 );
     1978                }
     1979
     1980                return $placeholder;
     1981        }
     1982
     1983        /**
     1984         * Adds a placeholder escape string, to escape anything that resembles a printf() placeholder.
     1985         *
     1986         * @since 4.8.3
     1987         *
     1988         * @param string $query The query to escape.
     1989         * @return string The query with the placeholder escape string inserted where necessary.
     1990         */
     1991        public function add_placeholder_escape( $query ) {
     1992                /*
     1993                 * To prevent returning anything that even vaguely resembles a placeholder,
     1994                 * we clobber every % we can find.
     1995                 */
     1996                return str_replace( '%', $this->placeholder_escape(), $query );
     1997        }
     1998
     1999        /**
     2000         * Removes the placeholder escape strings from a query.
     2001         *
     2002         * @since 4.8.3
     2003         *
     2004         * @param string $query The query from which the placeholder will be removed.
     2005         * @return string The query with the placeholder removed.
     2006         */
     2007        public function remove_placeholder_escape( $query ) {
     2008                return str_replace( $this->placeholder_escape(), '%', $query );
    18962009        }
    18972010
  • branches/4.7/tests/phpunit/tests/comment/query.php

    r39274 r42058  
    12191219         */
    12201220        public function test_search_int_0_should_not_be_ignored() {
     1221                global $wpdb;
    12211222                $q = new WP_Comment_Query();
    12221223                $q->query( array(
    12231224                        'search' => 0,
    12241225                ) );
    1225                 $this->assertContains( "comment_author LIKE '%0%'", $q->request );
     1226                $this->assertContains( "comment_author LIKE '%0%'", $wpdb->remove_placeholder_escape( $q->request ) );
    12261227        }
    12271228
     
    12301231         */
    12311232        public function test_search_string_0_should_not_be_ignored() {
     1233                global $wpdb;
    12321234                $q = new WP_Comment_Query();
    12331235                $q->query( array(
    12341236                        'search' => '0',
    12351237                ) );
    1236                 $this->assertContains( "comment_author LIKE '%0%'", $q->request );
     1238                $this->assertContains( "comment_author LIKE '%0%'", $wpdb->remove_placeholder_escape( $q->request ) );
    12371239        }
    12381240
  • branches/4.7/tests/phpunit/tests/date/query.php

    r35242 r42058  
    513513         */
    514514        public function test_build_time_query_should_not_discard_hour_0() {
     515                global $wpdb;
    515516                $q = new WP_Date_Query( array() );
    516517
    517518                $found = $q->build_time_query( 'post_date', '=', 0, 10 );
    518519
    519                 $this->assertContains( '%H', $found );
     520                $this->assertContains( '%H', $wpdb->remove_placeholder_escape( $found ) );
    520521        }
    521522
     
    613614
    614615        public function test_build_time_query_hour_minute() {
     616                global $wpdb;
    615617                $q = new WP_Date_Query( array() );
    616618
     
    619621                // $compare value is floating point - use regex to account for
    620622                // varying precision on different PHP installations
    621                 $this->assertRegExp( "/DATE_FORMAT\( post_date, '%H\.%i' \) = 5\.150*/", $found );
     623                $this->assertRegExp( "/DATE_FORMAT\( post_date, '%H\.%i' \) = 5\.150*/", $wpdb->remove_placeholder_escape( $found ) );
    622624        }
    623625
    624626        public function test_build_time_query_hour_minute_second() {
     627                global $wpdb;
    625628                $q = new WP_Date_Query( array() );
    626629
     
    629632                // $compare value is floating point - use regex to account for
    630633                // varying precision on different PHP installations
    631                 $this->assertRegExp( "/DATE_FORMAT\( post_date, '%H\.%i%s' \) = 5\.15350*/", $found );
     634                $this->assertRegExp( "/DATE_FORMAT\( post_date, '%H\.%i%s' \) = 5\.15350*/", $wpdb->remove_placeholder_escape( $found ) );
    632635        }
    633636
    634637        public function test_build_time_query_minute_second() {
     638                global $wpdb;
    635639                $q = new WP_Date_Query( array() );
    636640
     
    639643                // $compare value is floating point - use regex to account for
    640644                // varying precision on different PHP installations
    641                 $this->assertRegExp( "/DATE_FORMAT\( post_date, '0\.%i%s' \) = 0\.15350*/", $found );
     645                $this->assertRegExp( "/DATE_FORMAT\( post_date, '0\.%i%s' \) = 0\.15350*/", $wpdb->remove_placeholder_escape( $found ) );
    642646        }
    643647
  • branches/4.7/tests/phpunit/tests/db.php

    r41498 r42058  
    271271                global $wpdb;
    272272                $sql = $wpdb->prepare( "UPDATE test_table SET string_column = '%%f is a float, %%d is an int %d, %%s is a string', field = %s", 3, '4' );
     273                $this->assertContains( $wpdb->placeholder_escape(), $sql );
     274
     275                $sql = $wpdb->remove_placeholder_escape( $sql );
    273276                $this->assertEquals( "UPDATE test_table SET string_column = '%f is a float, %d is an int 3, %s is a string', field = '4'", $sql );
    274277        }
     
    376379        }
    377380
    378         function test_prepare_vsprintf() {
    379                 global $wpdb;
     381    function test_prepare_vsprintf() {
     382                global $wpdb;
    380383
    381384                $prepared = $wpdb->prepare( "SELECT * FROM $wpdb->users WHERE id = %d AND user_login = %s", array( 1, "admin" ) );
     
    394397                $prepared = @$wpdb->prepare( "SELECT * FROM $wpdb->users WHERE id = %d AND user_login = %s", array( array( 1 ), "admin" ) );
    395398                $this->assertEquals( "SELECT * FROM $wpdb->users WHERE id = 0 AND user_login = 'admin'", $prepared );
    396         }
     399        }
     400
     401        /**
     402         * @ticket 42040
     403         * @dataProvider data_prepare_incorrect_arg_count
     404         * @expectedIncorrectUsage wpdb::prepare
     405         */
     406        public function test_prepare_incorrect_arg_count( $query, $args, $expected ) {
     407                global $wpdb;
     408
     409                // $query is the first argument to be passed to wpdb::prepare()
     410                array_unshift( $args, $query );
     411
     412                $prepared = @call_user_func_array( array( $wpdb, 'prepare' ), $args );
     413                $this->assertEquals( $expected, $prepared );
     414        }
     415
     416        public function data_prepare_incorrect_arg_count() {
     417                global $wpdb;
     418
     419                return array(
     420                        array(
     421                                "SELECT * FROM $wpdb->users WHERE id = %d AND user_login = %s",     // Query
     422                                array( 1, "admin", "extra-arg" ),                                   // ::prepare() args, to be passed via call_user_func_array
     423                                "SELECT * FROM $wpdb->users WHERE id = 1 AND user_login = 'admin'", // Expected output
     424                        ),
     425                        array(
     426                                "SELECT * FROM $wpdb->users WHERE id = %%%d AND user_login = %s",
     427                                array( 1 ),
     428                                false,
     429                        ),
     430                        array(
     431                                "SELECT * FROM $wpdb->users WHERE id = %d AND user_login = %s",
     432                                array( array( 1, "admin", "extra-arg" ) ),
     433                                "SELECT * FROM $wpdb->users WHERE id = 1 AND user_login = 'admin'",
     434                        ),
     435                        array(
     436                                "SELECT * FROM $wpdb->users WHERE id = %d AND %% AND user_login = %s",
     437                                array( 1, "admin", "extra-arg" ),
     438                                "SELECT * FROM $wpdb->users WHERE id = 1 AND {$wpdb->placeholder_escape()} AND user_login = 'admin'",
     439                        ),
     440                        array(
     441                                "SELECT * FROM $wpdb->users WHERE id = %%%d AND %F AND %f AND user_login = %s",
     442                                array( 1, 2.3, "4.5", "admin", "extra-arg" ),
     443                                "SELECT * FROM $wpdb->users WHERE id = {$wpdb->placeholder_escape()}1 AND 2.300000 AND 4.500000 AND user_login = 'admin'",
     444                        ),
     445                        array(
     446                                "SELECT * FROM $wpdb->users WHERE id = %d AND user_login = %s",
     447                                array( array( 1 ), "admin", "extra-arg" ),
     448                                "SELECT * FROM $wpdb->users WHERE id = 0 AND user_login = 'admin'",
     449                        ),
     450                        array(
     451                                "SELECT * FROM $wpdb->users WHERE id = %d and user_nicename = %s and user_status = %d and user_login = %s",
     452                                array( 1, "admin", 0 ),
     453                                '',
     454                        ),
     455                        array(
     456                                "SELECT * FROM $wpdb->users WHERE id = %d and user_nicename = %s and user_status = %d and user_login = %s",
     457                                array( array( 1, "admin", 0 ) ),
     458                                '',
     459                        ),
     460                        array(
     461                                "SELECT * FROM $wpdb->users WHERE id = %d and %% and user_login = %s and user_status = %d and user_login = %s",
     462                                array( 1, "admin", "extra-arg" ),
     463                                '',
     464                        ),
     465                );
     466        }
    397467
    398468        function test_db_version() {
     
    11191189
    11201190        /**
    1121          *
    1122          */
    1123         function test_prepare_with_unescaped_percents() {
    1124                 global $wpdb;
    1125 
    1126                 $sql = $wpdb->prepare( '%d %1$d %%% %', 1 );
    1127                 $this->assertEquals( '1 %1$d %% %', $sql );
     1191         * @dataProvider data_prepare_with_placeholders
     1192         */
     1193        function test_prepare_with_placeholders_and_individual_args( $sql, $values, $incorrect_usage, $expected) {
     1194                global $wpdb;
     1195
     1196                if ( $incorrect_usage ) {
     1197                        $this->setExpectedIncorrectUsage( 'wpdb::prepare' );
     1198                }
     1199
     1200                if ( ! is_array( $values ) ) {
     1201                        $values = array( $values );
     1202                }
     1203
     1204                array_unshift( $values, $sql );
     1205
     1206                $sql = call_user_func_array( array( $wpdb, 'prepare' ), $values );
     1207                $this->assertEquals( $expected, $sql );
     1208        }
     1209
     1210        /**
     1211         * @dataProvider data_prepare_with_placeholders
     1212         */
     1213        function test_prepare_with_placeholders_and_array_args( $sql, $values, $incorrect_usage, $expected) {
     1214                global $wpdb;
     1215
     1216                if ( $incorrect_usage ) {
     1217                        $this->setExpectedIncorrectUsage( 'wpdb::prepare' );
     1218                }
     1219
     1220                if ( ! is_array( $values ) ) {
     1221                        $values = array( $values );
     1222                }
     1223
     1224                $sql = call_user_func_array( array( $wpdb, 'prepare' ), array( $sql, $values ) );
     1225                $this->assertEquals( $expected, $sql );
     1226        }
     1227
     1228        function data_prepare_with_placeholders() {
     1229                global $wpdb;
     1230
     1231                return array(
     1232                        array(
     1233                                '%5s',   // SQL to prepare
     1234                                'foo',   // Value to insert in the SQL
     1235                                false,   // Whether to expect an incorrect usage error or not
     1236                                '  foo', // Expected output
     1237                        ),
     1238                        array(
     1239                                '%1$d %%% % %%1$d%% %%%1$d%%',
     1240                                1,
     1241                                true,
     1242                                "1 {$wpdb->placeholder_escape()}{$wpdb->placeholder_escape()} {$wpdb->placeholder_escape()} {$wpdb->placeholder_escape()}1\$d{$wpdb->placeholder_escape()} {$wpdb->placeholder_escape()}1{$wpdb->placeholder_escape()}",
     1243                        ),
     1244                        array(
     1245                                '%-5s',
     1246                                'foo',
     1247                                false,
     1248                                'foo  ',
     1249                        ),
     1250                        array(
     1251                                '%05s',
     1252                                'foo',
     1253                                false,
     1254                                '00foo',
     1255                        ),
     1256                        array(
     1257                                "%'#5s",
     1258                                'foo',
     1259                                false,
     1260                                '##foo',
     1261                        ),
     1262                        array(
     1263                                '%.3s',
     1264                                'foobar',
     1265                                false,
     1266                                'foo',
     1267                        ),
     1268                        array(
     1269                                '%.3f',
     1270                                5.123456,
     1271                                false,
     1272                                '5.123',
     1273                        ),
     1274                        array(
     1275                                '%.3f',
     1276                                5.12,
     1277                                false,
     1278                                '5.120',
     1279                        ),
     1280                        array(
     1281                                '%s',
     1282                                ' %s ',
     1283                                false,
     1284                                "' {$wpdb->placeholder_escape()}s '",
     1285                        ),
     1286                        array(
     1287                                '%1$s',
     1288                                ' %s ',
     1289                                false,
     1290                                " {$wpdb->placeholder_escape()}s ",
     1291                        ),
     1292                        array(
     1293                                '%1$s',
     1294                                ' %1$s ',
     1295                                false,
     1296                                " {$wpdb->placeholder_escape()}1\$s ",
     1297                        ),
     1298                        array(
     1299                                '%d %1$d %%% %',
     1300                                1,
     1301                                true,
     1302                                "1 1 {$wpdb->placeholder_escape()}{$wpdb->placeholder_escape()} {$wpdb->placeholder_escape()}",
     1303                        ),
     1304                        array(
     1305                                '%d %2$s',
     1306                                array( 1, 'hello' ),
     1307                                false,
     1308                                "1 hello",
     1309                        ),
     1310                        array(
     1311                                "'%s'",
     1312                                'hello',
     1313                                false,
     1314                                "'hello'",
     1315                        ),
     1316                        array(
     1317                                '"%s"',
     1318                                'hello',
     1319                                false,
     1320                                "'hello'",
     1321                        ),
     1322                        array(
     1323                                "%s '%1\$s'",
     1324                                'hello',
     1325                                true,
     1326                                "'hello' 'hello'",
     1327                        ),
     1328                        array(
     1329                                "%s '%1\$s'",
     1330                                'hello',
     1331                                true,
     1332                                "'hello' 'hello'",
     1333                        ),
     1334                        array(
     1335                                '%s "%1$s"',
     1336                                'hello',
     1337                                true,
     1338                                "'hello' \"hello\"",
     1339                        ),
     1340                        array(
     1341                                "%%s %%'%1\$s'",
     1342                                'hello',
     1343                                false,
     1344                                "{$wpdb->placeholder_escape()}s {$wpdb->placeholder_escape()}'hello'",
     1345                        ),
     1346                        array(
     1347                                '%%s %%"%1$s"',
     1348                                'hello',
     1349                                false,
     1350                                "{$wpdb->placeholder_escape()}s {$wpdb->placeholder_escape()}\"hello\"",
     1351                        ),
     1352                        array(
     1353                                '%s',
     1354                                ' %  s ',
     1355                                false,
     1356                                "' {$wpdb->placeholder_escape()}  s '",
     1357                        ),
     1358                        array(
     1359                                '%%f %%"%1$f"',
     1360                                3,
     1361                                false,
     1362                                "{$wpdb->placeholder_escape()}f {$wpdb->placeholder_escape()}\"3.000000\"",
     1363                        ),
     1364                        array(
     1365                                'WHERE second=\'%2$s\' AND first=\'%1$s\'',
     1366                                array( 'first arg', 'second arg' ),
     1367                                false,
     1368                                "WHERE second='second arg' AND first='first arg'",
     1369                        ),
     1370                        array(
     1371                                'WHERE second=%2$d AND first=%1$d',
     1372                                array( 1, 2 ),
     1373                                false,
     1374                                "WHERE second=2 AND first=1",
     1375                        ),
     1376                        array(
     1377                                "'%'%%s",
     1378                                'hello',
     1379                                true,
     1380                                "'{$wpdb->placeholder_escape()}'{$wpdb->placeholder_escape()}s",
     1381                        ),
     1382                        array(
     1383                                "'%'%%s%s",
     1384                                'hello',
     1385                                false,
     1386                                "'{$wpdb->placeholder_escape()}'{$wpdb->placeholder_escape()}s'hello'",
     1387                        ),
     1388                        array(
     1389                                "'%'%%s %s",
     1390                                'hello',
     1391                                false,
     1392                                "'{$wpdb->placeholder_escape()}'{$wpdb->placeholder_escape()}s 'hello'",
     1393                        ),
     1394                        array(
     1395                                "'%-'#5s' '%'#-+-5s'",
     1396                                array( 'hello', 'foo' ),
     1397                                false,
     1398                                "'hello' 'foo##'",
     1399                        ),
     1400                );
     1401        }
     1402
     1403        /**
     1404         * @dataProvider data_escape_and_prepare
     1405         */
     1406        function test_escape_and_prepare( $escape, $sql, $values, $incorrect_usage, $expected ) {
     1407                global $wpdb;
     1408
     1409                if ( $incorrect_usage ) {
     1410                        $this->setExpectedIncorrectUsage( 'wpdb::prepare' );
     1411                }
     1412
     1413                $escape = esc_sql( $escape );
     1414
     1415                $sql = str_replace( '{ESCAPE}', $escape, $sql );
     1416
     1417                $actual = $wpdb->prepare( $sql, $values );
     1418
     1419                $this->assertEquals( $expected, $actual );
     1420        }
     1421
     1422        function data_escape_and_prepare() {
     1423                global $wpdb;
     1424                return array(
     1425                        array(
     1426                                '%s',                                  // String to pass through esc_url()
     1427                                ' {ESCAPE} ',                          // Query to insert the output of esc_url() into, replacing "{ESCAPE}"
     1428                                'foo',                                 // Data to send to prepare()
     1429                                true,                                  // Whether to expect an incorrect usage error or not
     1430                                " {$wpdb->placeholder_escape()}s ",    // Expected output
     1431                        ),
     1432                        array(
     1433                                'foo%sbar',
     1434                                "SELECT * FROM bar WHERE foo='{ESCAPE}' OR baz=%s",
     1435                                array( ' SQLi -- -', 'pewpewpew' ),
     1436                                true,
     1437                                null,
     1438                        ),
     1439                        array(
     1440                                '%s',
     1441                                ' %s {ESCAPE} ',
     1442                                'foo',
     1443                                false,
     1444                                " 'foo' {$wpdb->placeholder_escape()}s ",
     1445                        ),
     1446                );
     1447        }
     1448
     1449        /**
     1450         * @expectedIncorrectUsage wpdb::prepare
     1451         */
     1452        function test_double_prepare() {
     1453                global $wpdb;
     1454
     1455                $part = $wpdb->prepare( ' AND meta_value = %s', ' %s ' );
     1456                $this->assertNotContains( '%s', $part );
     1457                $query = $wpdb->prepare( 'SELECT * FROM {$wpdb->postmeta} WHERE meta_key = %s $part', array( 'foo', 'bar' ) );
     1458                $this->assertNull( $query );
     1459        }
     1460
     1461        function test_prepare_numeric_placeholders_float_args() {
     1462                global $wpdb;
     1463
     1464                $actual = $wpdb->prepare(
     1465                        'WHERE second=%2$f AND first=%1$f',
     1466                        1.1,
     1467                        2.2
     1468                );
     1469
     1470                /* Floats can be right padded, need to assert differently */
     1471                $this->assertContains( ' first=1.1', $actual );
     1472                $this->assertContains( ' second=2.2', $actual );
     1473        }
     1474
     1475        function test_prepare_numeric_placeholders_float_array() {
     1476                global $wpdb;
     1477
     1478                $actual = $wpdb->prepare(
     1479                        'WHERE second=%2$f AND first=%1$f',
     1480                        array( 1.1, 2.2 )
     1481                );
     1482
     1483                /* Floats can be right padded, need to assert differently */
     1484                $this->assertContains( ' first=1.1', $actual );
     1485                $this->assertContains( ' second=2.2', $actual );
     1486        }
     1487
     1488        function test_query_unescapes_placeholders() {
     1489                global $wpdb;
     1490
     1491                $value = ' %s ';
     1492
     1493                $wpdb->query( "CREATE TABLE {$wpdb->prefix}test_placeholder( a VARCHAR(100) );" );
     1494                $sql = $wpdb->prepare( "INSERT INTO {$wpdb->prefix}test_placeholder VALUES(%s)", $value );
     1495                $wpdb->query( $sql );
     1496
     1497                $actual = $wpdb->get_var( "SELECT a FROM {$wpdb->prefix}test_placeholder" );
     1498
     1499                $wpdb->query( "DROP TABLE {$wpdb->prefix}test_placeholder" );
     1500
     1501                $this->assertNotContains( '%s', $sql );
     1502                $this->assertEquals( $value, $actual );
     1503        }
     1504
     1505        function test_esc_sql_with_unsupported_placeholder_type() {
     1506                global $wpdb;
     1507
     1508                $sql = $wpdb->prepare( ' %s %1$c ', 'foo' );
     1509                $sql = $wpdb->prepare( " $sql %s ", 'foo' );
     1510
     1511                $this->assertEquals( "  'foo' {$wpdb->placeholder_escape()}1\$c  'foo' ", $sql );
    11281512        }
    11291513}
  • branches/4.7/tests/phpunit/tests/rest-api/rest-posts-controller.php

    r40137 r42058  
    8585                $expected_clause = str_replace( '{posts}', $wpdb->posts, $pattern );
    8686                $this->assertCount( 1, $this->posts_clauses );
    87                 $this->assertEquals( $expected_clause, $this->posts_clauses[0][ $clause ] );
     87                $this->assertEquals( $expected_clause, $wpdb->remove_placeholder_escape( $this->posts_clauses[0][ $clause ] ) );
    8888        }
    8989
  • branches/4.7/tests/phpunit/tests/term/meta.php

    r37589 r42058  
    359359                register_taxonomy( 'wptests_tax', 'post' );
    360360                $t1 = wp_insert_term( 'Foo', 'wptests_tax' );
    361                 add_term_meta( $t1, 'foo', 'bar' );
     361                add_term_meta( $t1['term_id'], 'foo', 'bar' );
    362362
    363363                register_taxonomy( 'wptests_tax_2', 'post' );
  • branches/4.7/wp-tests-config-sample.php

    r38858 r42058  
    3939define( 'DB_COLLATE', '' );
    4040
     41/**#@+
     42 * Authentication Unique Keys and Salts.
     43 *
     44 * Change these to different unique phrases!
     45 * You can generate these using the {@link https://api.wordpress.org/secret-key/1.1/salt/ WordPress.org secret-key service}
     46 */
     47define('AUTH_KEY',         'put your unique phrase here');
     48define('SECURE_AUTH_KEY',  'put your unique phrase here');
     49define('LOGGED_IN_KEY',    'put your unique phrase here');
     50define('NONCE_KEY',        'put your unique phrase here');
     51define('AUTH_SALT',        'put your unique phrase here');
     52define('SECURE_AUTH_SALT', 'put your unique phrase here');
     53define('LOGGED_IN_SALT',   'put your unique phrase here');
     54define('NONCE_SALT',       'put your unique phrase here');
     55
    4156$table_prefix  = 'wptests_';   // Only numbers, letters, and underscores please!
    4257
Note: See TracChangeset for help on using the changeset viewer.