WordPress.org
Get WordPress

Make WordPress Core

Changeset 60363

Timestamp:
06/29/2025 08:53:29 PM (3 months ago)
Author:
johnbillion
Message:

Docs: Documentation and i18n string improvements relating to MySQL and server requirements.

See #63166

Location:
trunk/src
Files:
6 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/wp-admin/install.php

    r59803 r60363  
    234234/**
    235235 * @global string   $wp_version              The WordPress version string.
    236  * @global string   $required_php_version    The required PHP version string.
     236 * @global string   $required_php_version    The minimum required PHP version string.
    237237 * @global string[] $required_php_extensions The names of required PHP extensions.
    238  * @global string   $required_mysql_version  The required MySQL version string.
     238 * @global string   $required_mysql_version  The minimum required MySQL version string.
    239239 * @global wpdb     $wpdb                    WordPress database abstraction object.
    240240 */

  • trunk/src/wp-admin/upgrade.php

    r59803 r60363  
    3838/**
    3939 * @global string   $wp_version              The WordPress version string.
    40  * @global string   $required_php_version    The required PHP version string.
     40 * @global string   $required_php_version    The minimum required PHP version string.
    4141 * @global string[] $required_php_extensions The names of required PHP extensions.
    42  * @global string   $required_mysql_version  The required MySQL version string.
     42 * @global string   $required_mysql_version  The minimum required MySQL version string.
    4343 * @global wpdb     $wpdb                    WordPress database abstraction object.
    4444 */

  • trunk/src/wp-includes/class-wpdb.php

    r60254 r60363  
    4444 * access to the WordPress database.
    4545 *
    46  * It is possible to replace this class with your own by setting the $wpdb global variable
     46 * It is possible to replace the global instance with your own by setting the $wpdb global variable
    4747 * in wp-content/db.php file to your class. The wpdb class will still be included, so you can
    4848 * extend it or simply use your own.
    … …  
    238238     *
    239239     * You can set this to have multiple WordPress installations in a single database.
    240      * The second reason is for possible security precautions.
    241240     *
    242241     * @since 2.5.0
    … …  
    942941     * Changes the current SQL mode, and ensures its WordPress compatibility.
    943942     *
    944      * If no modes are passed, it will ensure the current MySQL server modes are compatible.
     943     * If no modes are passed, it will ensure the current SQL server modes are compatible.
    945944     *
    946945     * @since 3.9.0
    … …  
    13701369
    13711370    /**
    1372      * Quotes an identifier for a MySQL database, e.g. table/field names.
     1371     * Quotes an identifier such as a table or field name.
    13731372     *
    13741373     * @since 6.2.0
    … …  
    14341433     *         "SELECT DATE_FORMAT(`field`, '%%c') FROM `table` WHERE `column` = %s",
    14351434     *         'foo'
     1435     *     );
     1436     *
     1437     *     $wpdb->prepare(
     1438     *         "SELECT * FROM %i WHERE %i = %s",
     1439     *         $table,
     1440     *         $field,
     1441     *         $value
    14361442     *     );
    14371443     *
    … …  
    19581964
    19591965        /*
    1960          * Set the MySQLi error reporting off because WordPress handles its own.
     1966         * Switch error reporting off because WordPress handles its own.
    19611967         * This is due to the default value change from `MYSQLI_REPORT_OFF`
    19621968         * to `MYSQLI_REPORT_ERROR|MYSQLI_REPORT_STRICT` in PHP 8.1.
    … …  
    21012107
    21022108        $host = ! empty( $matches['host'] ) ? $matches['host'] : '';
    2103         // MySQLi port cannot be a string; must be null or an integer.
     2109        // Port cannot be a string; must be null or an integer.
    21042110        $port = ! empty( $matches['port'] ) ? absint( $matches['port'] ) : null;
    21052111
    … …  
    22912297            $this->last_error = mysqli_error( $this->dbh );
    22922298        } else {
    2293             $this->last_error = __( 'Unable to retrieve the error message from MySQL' );
     2299            $this->last_error = __( 'Unable to retrieve the error message from the database server' );
    22942300        }
    22952301
    … …  
    34743480
    34753481    /**
    3476      * Checks if the query is accessing a collation considered safe on the current version of MySQL.
     3482     * Checks if the query is accessing a collation considered safe.
    34773483     *
    34783484     * @since 4.2.0
    … …  
    39883994
    39893995    /**
    3990      * Determines whether MySQL database is at least the required minimum version.
     3996     * Determines whether the database server is at least the required minimum version.
    39913997     *
    39923998     * @since 2.5.0
    39933999     *
    3994      * @global string $required_mysql_version The required MySQL version string.
     4000     * @global string $required_mysql_version The minimum required MySQL version string.
    39954001     * @return void|WP_Error
    39964002     */
    … …  
    40484054     * Capability sniffs for the database server and current version of WPDB.
    40494055     *
    4050      * Database sniffs are based on the version of MySQL the site is using.
     4056     * Database sniffs are based on the version of the database server in use.
    40514057     *
    40524058     * WPDB sniffs are added as new features are introduced to allow theme and plugin
    … …  
    41204126
    41214127    /**
    4122      * Retrieves the database server version.
     4128     * Retrieves the database server version number.
    41234129     *
    41244130     * @since 2.7.0
    … …  
    41314137
    41324138    /**
    4133      * Returns the version of the MySQL server.
     4139     * Returns the raw version string of the database server.
    41344140     *
    41354141     * @since 5.5.0
    41364142     *
    4137      * @return string Server version as a string.
     4143     * @return string Database server version as a string.
    41384144     */
    41394145    public function db_server_info() {

  • trunk/src/wp-includes/load.php

    r59803 r60363  
    140140
    141141/**
    142  * Checks for the required PHP version, and the mysqli extension or
    143  * a database drop-in.
     142 * Checks the server requirements.
     143 *
     144 *   - PHP version
     145 *   - PHP extensions
     146 *   - MySQL or MariaDB version (unless a database drop-in is present)
    144147 *
    145148 * Dies if requirements are not met.
    … …  
    148151 * @access private
    149152 *
    150  * @global string   $required_php_version    The required PHP version string.
     153 * @global string   $required_php_version    The minimum required PHP version string.
    151154 * @global string[] $required_php_extensions The names of required PHP extensions.
    152155 * @global string   $wp_version              The WordPress version string.

  • trunk/src/wp-includes/version.php

    r60093 r60363  
    3434
    3535/**
    36  * Holds the required PHP version.
     36 * Holds the minimum required PHP version.
    3737 *
    3838 * @global string $required_php_version
    … …  
    5151
    5252/**
    53  * Holds the required MySQL version.
     53 * Holds the minimum required MySQL version.
    5454 *
    5555 * @global string $required_mysql_version

  • trunk/src/wp-settings.php

    r59925 r60363  
    2626 * @global int      $wp_db_version           WordPress database version.
    2727 * @global string   $tinymce_version         TinyMCE version.
    28  * @global string   $required_php_version    The required PHP version string.
     28 * @global string   $required_php_version    The minimum required PHP version string.
    2929 * @global string[] $required_php_extensions The names of required PHP extensions.
    30  * @global string   $required_mysql_version  The required MySQL version string.
     30 * @global string   $required_mysql_version  The minimum required MySQL version string.
    3131 * @global string   $wp_local_package        Locale code of the package.
    3232 */
    … …  
    3636require ABSPATH . WPINC . '/load.php';
    3737
    38 // Check for the required PHP version and for the MySQL extension or a database drop-in.
     38// Check the server requirements.
    3939wp_check_php_mysql_versions();
    4040
Note: See TracChangeset for help on using the changeset viewer.