Skip to content

#63678 Warn when a user has reached 'max_questions' mysql parameter - #9223

Open
Meuh-42 wants to merge 3 commits into
WordPress:trunkfrom
Meuh-42:63678-fix-max_question
Open

Meuh-42 wants to merge 3 commits into
WordPress:trunkfrom
Meuh-42:63678-fix-max_question

Conversation

@Meuh-42

@Meuh-42 Meuh-42 commented Jul 9, 2025 •

Copy link
Copy Markdown

Wordpress redirect to wp-admin/install.php when a user is rate limited in mysql,

instead of catching and displaying a valid error message

Trac ticket: https://core.trac.wordpress.org/ticket/63678


This Pull Request is for code review only. Please keep all other discussion in the Trac ticket. Do not merge this Pull Request. See GitHub Pull Requests for Code Review in the Core Handbook for more details.

@github-actions

github-actions Bot commented Jul 9, 2025

Copy link
Copy Markdown

Hi @Meuh-42! 👋

Thank you for your contribution to WordPress! 💖

It looks like this is your first pull request to wordpress-develop. Here are a few things to be aware of that may help you out!

No one monitors this repository for new pull requests. Pull requests must be attached to a Trac ticket to be considered for inclusion in WordPress Core. To attach a pull request to a Trac ticket, please include the ticket's full URL in your pull request description.

Pull requests are never merged on GitHub. The WordPress codebase continues to be managed through the SVN repository that this GitHub repository mirrors. Please feel free to open pull requests to work on any contribution you are making.

More information about how GitHub pull requests can be used to contribute to WordPress can be found in the Core Handbook.

Please include automated tests. Including tests in your pull request is one way to help your patch be considered faster. To learn about WordPress' test suites, visit the Automated Testing page in the handbook.

If you have not had a chance, please review the Contribute with Code page in the WordPress Core Handbook.

The Developer Hub also documents the various coding standards that are followed:

Thank you,
The WordPress Project

@github-actions

github-actions Bot commented Jul 9, 2025 •

Copy link
Copy Markdown

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

Unlinked Accounts

The following contributors have not linked their GitHub and WordPress.org accounts: @fabien.bagard@ovhcloud.com.

Contributors, please read how to link your accounts to ensure your work is properly credited in WordPress releases.

Core Committers: Use this line as a base for the props when committing in SVN:

Props audrasjb, peterwilsoncc, mindctrl, anonymooo, johnbillion.

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

@github-actions

github-actions Bot commented Jul 9, 2025

Copy link
Copy Markdown

Test using WordPress Playground

The changes in this pull request can previewed and tested using a WordPress Playground instance.

WordPress Playground is an experimental project that creates a full WordPress instance entirely within the browser.

Some things to be aware of

  • The Plugin and Theme Directories cannot be accessed within Playground.
  • All changes will be lost when closing a tab with a Playground instance.
  • All changes will be lost when refreshing the page.
  • A fresh instance is created each time the link below is clicked.
  • Every time this pull request is updated, a new ZIP file containing all changes is created. If changes are not reflected in the Playground instance,
    it's possible that the most recent build failed, or has not completed. Check the list of workflow runs to be sure.

For more details about these limitations and more, check out the Limitations page in the WordPress Playground documentation.

Test this pull request with WordPress Playground.

@Meuh-42
Meuh-42 force-pushed the 63678-fix-max_question branch 2 times, most recently from 99960ac to e2d0541 Compare July 10, 2025 08:03
@Meuh-42

Meuh-42 commented Jul 10, 2025 •

Copy link
Copy Markdown
Author

WordPress redirect to wp-admin/install.php when a user is rate limited in MySQL.

What are the rate limit parameters in MySQL ?

A MySQL user can be created with a set of parameters to limit resources consumption:

  • MAX_QUERIES_PER_HOUR
  • MAX_UPDATES_PER_HOUR
  • MAX_CONNECTIONS_PER_HOUR
  • MAX_USER_CONNECTIONS

https://dev.mysql.com/doc/refman/8.4/en/user-resources.html

Setting these values may help protect the database server under heavy load, help mitigate deny of service attacks.

How to reproduce ?

  1. Set up a WordPress
  2. As root in MySQL, run the following query: ALTER USER 'database_user'@'%' WITH MAX_QUERIES_PER_HOUR 1;
  3. Refresh page: We are now redirected to the installation page

Once the number of query per hour for the user has been reduced (or MAX_QUERIES_PER_HOUR set to a higher value / disabled), WordPress is reachable again.

Expectations

As this is a documented return code from MySQL, WordPress should display the correct error instead of redirecting to the installation page.

Also, as we are hitting a rate-limiting value, we should not try to retry queries (thus making it harder to go below the limited value) but die on-spot.

ratelimit

Comment thread src/wp-includes/class-wpdb.php Outdated
// User has reached 'max_questions' stop retrying
if ( 1226 === $mysql_errno ) {
$message = '<h1>' . __( 'Cannot connect to database' ) . "</h1>\n";
$message .= '<p>' . sprintf( $this->last_error );

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should this error include some kind of non-technical message, followed by the technical error message?

The average website visitor won't understand this message, but it will be helpful to site owners for debugging/support purposes.

image

@Meuh-42 Meuh-42 Jul 10, 2025 •

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What about something like the following ?

image

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah a clearer title and paragraph before the error message makes sense.

The paragraph before the error message could say "The database server could be connected to (which means your username and password is okay) but the query could not be performed.". That keeps it pretty close to the database selection error message.

For the last line, let's reuse this existing string too.

@Meuh-42 Meuh-42 Jul 11, 2025 •

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wanted to emphasis on the fact that all connection parameters are correct (even database name / connection port)
Same for last sentence, I tried to stay as close as possible to the existing messages to help translators, while being a bit more specific to this particular error message.

But your comments works pretty well as well.

I'm updating my PR

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

image

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As per today's 7.0 bug scrub:
@johnbillion are you fine with the current implementation? Can we process with this ticket?

@Meuh-42
Meuh-42 force-pushed the 63678-fix-max_question branch 2 times, most recently from eb6f8ad to 41035a0 Compare July 11, 2025 07:38
@johnbillion
johnbillion self-requested a review September 15, 2026 22:55

@peterwilsoncc peterwilsoncc left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is testing well, I've made a copy suggestion inline.

Comment on lines +2309 to +2311
$message = '<h1>' . __( 'Cannot query database' ) . "</h1>\n";
$message .= '<p>' . __( 'The database server could be connected to (which means username and password is okay) but the query could not be performed.' ) . '<br>';
$message .= sprintf( $this->last_error );

@peterwilsoncc peterwilsoncc Oct 7, 2026 •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This copy might be clearer for the first paragraph.

Suggested change
$message = '<h1>' . __( 'Cannot query database' ) . "</h1>\n";
$message .= '<p>' . __( 'The database server could be connected to (which means username and password is okay) but the query could not be performed.' ) . '<br>';
$message .= sprintf( $this->last_error );
$message = '<h1>' . __( 'Cannot query database' ) . "</h1>\n";
$message .= '<p>';
$message .= sprintf(
/* translators: %s The error message returned by the database. */
__( 'The database server could be connected to (which means username and password is okay) but the query could not be performed. The database returned the error: %s.' ),
'<code>' . htmlspecialchars( $this->last_error ) . '</code>'
);
$message .= '</p>';

}

// User has reached 'max_questions' stop retrying
if ( 1226 === $mysql_errno ) {

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
if ( 1226 === $mysql_errno ) {
if ( 1226 === $mysql_errno ) {
wp_load_translations_early();

I haven't tested this, but based on an AI-assisted investigation, it seems this could cause a fatal error (Call to undefined function __()) in some environments, such as multisite or SHORTINIT, because __() may be called before the l10n functions are loaded. For example, in multisite, ms-settings.php runs queries before l10n.php is loaded in wp-settings.php. Would this change be appropriate?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants