137

I have just installed XAMPP on my Windows XP machine, and I get an error saying:

Connection for controluser as defined in your configuration failed.

Before I installed XAMPP, I had a MySQL database installed and it had a password. I changed and put the password in config.inc.php for MySQL, and I got this error:

<?php
if (!empty($_SERVER['HTTPS']) && ('on' == $_SERVER['HTTPS'])) {
    $uri = 'https://';
} else {
    $uri = 'http://';
}
$uri .= $_SERVER['HTTP_HOST'];
header('Location: '.$uri.'/xampp/');
exit;
?>

When I try to access index.php, it seems like something is wrong with the XAMPP installation. What can I do to fix this problem?

2
  • 22
    IMHO this sort of questions are pretty much common and lots of time is wasted to fix them.Also by "defined scope of problems", its debatable if we can put such questn under "soft. tool commonly used by programmers" or "is a practical, answerable problem that is unique to soft development".So I request the SO veterans to consider such post carefully before marking "off topic". SO's become a trusted, one stop destination to get ans to programming problem,from persons who have faced and solved it. So it'd be helpful for programer to get exact answer here than searching elswhere for such problem.
    – Dexter
    Sep 24, 2014 at 15:58
  • I found a solution from this. stackoverflow.com/a/54176422/4630590
    – manojm
    Oct 20, 2021 at 16:53

15 Answers 15

252
  1. Open phpMyAdmin in a browser and log in as root.
  2. Create a database called phpmyadmin
  3. Create a user called pma and set the "host" to the hostname or IP address of your web server (if the web server and MySQL are on the same box use localhost), make a note of the password, and grant the new user full control over the phpmyadmin database. It is recommended that this user does not have access to anything other than this database.
  4. Go to the phpMyAdmin installation directory, where you should find a sub-directory called sql.
  5. In sql you will find a file called create_tables.sql. Open it in a text editor.
  6. In phpMyAdmin, select the phpmyadmin database and click on the "SQL" tab.
  7. Copy/paste the entire text from create_tables.sql into the text box, and run the query.
  8. Open the config.inc.php file in the phpMyAdmin install directory, and add the following lines (or change the existing settings if they are already there):

    $cfg['Servers'][1]['pmadb'] = 'phpmyadmin';
    $cfg['Servers'][1]['controluser'] = 'pma';
    $cfg['Servers'][1]['controlpass'] = '<your password>';
    
    // Note: The list below may grow as PMA evolves and more control tables are added
    // Use your common sense! Don't just blindly copypasta, look at what it means!
    $cfg['Servers'][1]['bookmarktable'] = 'pma_bookmark';
    $cfg['Servers'][1]['relation'] = 'pma_relation';
    $cfg['Servers'][1]['userconfig'] = 'pma_userconfig';
    $cfg['Servers'][1]['table_info'] = 'pma_table_info';
    $cfg['Servers'][1]['column_info'] = 'pma_column_info';
    $cfg['Servers'][1]['history'] = 'pma_history';
    $cfg['Servers'][1]['recent'] = 'pma_recent';
    $cfg['Servers'][1]['table_uiprefs'] = 'pma_table_uiprefs';
    $cfg['Servers'][1]['tracking'] = 'pma_tracking';
    $cfg['Servers'][1]['table_coords'] = 'pma_table_coords';
    $cfg['Servers'][1]['pdf_pages'] = 'pma_pdf_pages';
    $cfg['Servers'][1]['designer_coords'] = 'pma_designer_coords';
    
  9. Save and close the file.

IMPORTANT - PMA loads the config on login, evaluates it and stores it into the session data so the message will not disappear until you do this:

  1. Log out of phpMyAdmin and log in again

Problem solved.

17
  • 3
    +1 for the "log out and log back in". I wasted five minutes not realising I had to do that.
    – Matthew G
    Jun 1, 2013 at 11:44
  • 14
    For some reason, my version of phpmyadmin is having the table names as "pma__bookmark" and so on with 2 "underscores". If anyone is having the same, then you should edit the "config.inc.php" accordingly. And BTW the config file is located in the "/etc/phpmyadmin" directory in Ubuntu
    – ajaybc
    Oct 24, 2013 at 6:17
  • 6
    On Ubuntu 14.04 the location for create_tables.sql is inside /usr/share/doc/phpmyadmin/examples/create_tables.sql.gz
    – karlingen
    Sep 16, 2014 at 14:22
  • 2
    i didn't find config.inc.php
    – GvSharma
    Feb 3, 2015 at 7:52
  • 5
    This is an excellent answer (the 100th + from me;)). However, I didn't find the examples directory where pointed in step 4. Instead it was here: /usr/share/doc/phpmyadmin/examples and there I found the compressed sql file: create_tables.sql.gz. Feb 4, 2015 at 13:08
136

If you got here and you are using Debian/Ubuntu (or any other dpkg based distro), execute the following command:

sudo dpkg-reconfigure phpmyadmin

The phpmyadmin package contains the script to perform this operation for you, all it needs is a user with permissions. sudo is not required if you're logged in as root, of course.

EDIT: It might be worth trying to drop the current phpmyadmin user.

13
  • 2
    This worked for me, I just had to reinstall the database it asked. Thanks. (Ubuntu 12.04)
    – ino
    Aug 15, 2013 at 23:17
  • 18
    I had to type "pma" instead of "phpmyadmin" for the control user during the configuration to make this work.
    – Hardell
    Dec 1, 2013 at 1:20
  • 2
    Dropping 'phpmyadmin' user first and running 'sudo dpkg-reconfigure phpmyadmin' after worked for me. Thanks!
    – B. Shea
    Nov 12, 2014 at 15:17
  • 1
    note: this will erase all configured servers, if any.
    – Raptor
    Aug 12, 2015 at 2:19
  • 1
    @DotKu, or is the config file at /etc/phpmyadmin/config-db.php that stores the name and password. And in that file I had to update to: $dbuser='pma'; and $dbpass='<my password>'; After a logout/login that finally got rid of the "Connection for controluser as defined in your configuration failed." error message. ... Oh, yes and before that I had to paste in the sql to create the tables. (This was another struggle, as there are multiple versions out there). ............. too bad this Q is closed or I'd enter another, more complete answer. Oct 4, 2016 at 15:59
25

Just comment out the whole "User for advanced features" and "Advanced phpMyAdmin features" code blocks in config.inc.php.

5
  • Any explanation for this? How and why does this work?
    – Huey
    Jan 22, 2016 at 22:14
  • 1
    @Ben : Sometimes that's all matters ;)
    – streak
    May 11, 2016 at 10:15
  • In which files.... This is so uninformative! But everybody understand so I feel stupid and unable to fix it lol double lose! Aug 9, 2016 at 10:45
  • 2
    That would be config.inc.php
    – Rocoty
    Aug 16, 2016 at 19:11
  • 1
    Not exist anything like User for advanced features" and "Advanced phpMyAdmin features inside phpmyadmin/config.inc.php
    – SAYE
    Apr 26, 2018 at 11:14
16

Have you recently changed your MySQL Server root password? If answer is YES, than this is the cause of the error / warning inside phpMyAdmin console. To fix the problem, simply edit your phpMyAdmin’s config-db.php file and setup the proper database password.

First answer is messing too much in my view and second answer did not work for me. So:

In Linux-based servers the file is usually located in:

/etc/phpmyadmin/config-db.php

or:

/etc/phpMyAdmin/config-db.php

Example: (My File looked like this and I changed the user fromphpmyadmin to admin, the username I created for maintaining my database through phpmyadmin, and put in the appropriate password.

$dbuser='phpmyadmin';
$dbpass=''; // set current password between quotes ' '
$basepath='';
$dbname='phpmyadmin';
$dbserver='';
$dbport='';
$dbtype='mysql';

credits: http://tehnoblog.org/phpmyadmin-error-connection-for-controluser-as-defined-in-your-configuration-failed/

5

This worked for me with phpmyadmin under Ubuntu 16.04:

I edited /etc/phpmyadmin/config.inc.php and changed the following 2 lines:

$cfg['Servers'][$i]['controluser'] = 'root'; 
$cfg['Servers'][$i]['controlpass'] = 'thepasswordgiventoroot'; 
4

This worked for me with phpmyadmin under Ubuntu 16.04:

I edited /etc/phpmyadmin/config.inc.php and changed the following 2 lines:

$cfg['Servers'][$i]['controluser'] = 'pma'; 
$cfg['Servers'][$i]['controlpass'] = 'pass pma'; 
2
  • You saved my day. Thanks!
    – Prem Sagar
    Nov 11, 2021 at 7:46
  • you've gotta explain what's pma and pass pma
    – Xsmael
    Dec 22, 2021 at 19:16
3

On Ubunbtu.

Ben's message is close but it's not the root password that is the problem, the problem I found was I had created a password for the phpmyadmin database when I installed it. This password is not carried into the installation on ubuntu so the variable $dbpass=''; in the database settings file is empty and not the password you set.

  1. To check you have the right password at the command line login to mysql using the following command: mysql -u phpmyadmin -p try a blank password I found I got access denied, enter the command again using the password you set during installation. If it logs in you now know what the password is.
  2. Edit /etc/phpadmin/config-db.php and change $dbpass=''; to $dbpass='Your Password'; and save the file.
  3. Edit /etc/dbconfig-common/phpmyadmin.conf change dbc_dbpass=''; to dbc_dbpass='Your Password'; and save the file. Close your browser and reload you will now find the message has gone way.
2

"For me to make it work again I just deleted the files

ib_logfile0 and

ib_logfile1 .

from :

/Applications/MAMP/db/mysql56/ib_logfile0 "

On XAMPP its Xampp/xamppfiles/var/mysql

Got this from PHP Warning: mysqli_connect(): (HY000/2002): Connection refused

2

on ubuntu /etc/phpmyadmin/config-db.php

make sure the password matches your config.inc.php for the control user

also for the blowfish too short error

edit /var/lib/phpmyadmin/blowfish_secret.inc.php and make the key longer

0

The problem is that PhpMyAdmin control user (usually: pma) password does not match the mysql user: pma (same user) password.

To fix it, 1. Set the password you want for user pma here:

"C:\xampp\phpMyAdmin\config.inc.php"

$cfg['Servers'][$i]['controlpass'] = 'your_new_phpmyadmin_pass';

(should be like on line 32)

Then go to mysql, login as root, go to: (I used phpmyadmin to go here)

Database: mysql »Table: user

Edit the user: pma

Select "Password" from the function list (left column) and set "your_new_phpmyadmin_pass" on the right column and hit go.

Restart mysql server.

Now the message should disappear.

0

I just simply make changes on config.inc.php file. There is password in error in this link $cfg['Servers'][$i]['password'] = 'your password '; and now its perfectly worked .

3
  • please edit your question and add more details. This is of low quality. Dec 9, 2017 at 9:03
  • The above is the resolution , i haven't followed above steps. I just simply go to config.inc.php directory and open this file config.inc.php in notepad and the changed this line $cfg['Servers'][$i]['password'] = 'your password ' Dec 9, 2017 at 9:29
  • I saw the password is mentioned there is wrong and I put correct password again and saved it and run the phpmyadmin again and it running properly now Dec 9, 2017 at 9:31
0

on ubuntu 18.04 in etc/phpmyadmin/config.inc.php comment all the block

Optional: User for advanced features

0

on ubuntu, these steps worked for me...

1. sudo gedit /etc/phpmyadmin/config.inc.php.

2. uncomment[remove(/)]  following lines :-

    $cfg['Servers'][$i]['AllowNoPassword'] = TRUE;

3. comment[add(/)] following lines :-     

   //$cfg['Servers'][$i]['controluser'] = $dbuser;
   //$cfg['Servers'][$i]['controlpass'] = $dbpass;
0

So I deleted the phpmyadmin user accidently but not the table and the only and best answer that worked these days have been this one: https://stackoverflow.com/a/40632599/15821993

open the directory /etc/phpmyadmin/ in the terminal and use

sudo nano config-db.php

to open it as a root (other users have no access)

there you can find the username and password of the deleted user. If you want to change them you can do it to whatever you want and safe the file or you reuse them in the next step.

After you got this infos or changed the credentials: login to phpmyadmin console and create a new user for the db phpmyadmin with same username and password as in the file. Grant all rights to the user for this db only and you are done.

logout and login again at phpMyAdmin and all errors are gone.

-1

Having just installed the XAMPP today, I decided to use a different default port for mysql, which was horrible. Make sure to add these lines to the phpMyAdmin config.inc.php:

$cfg['Servers'][$i]['host'] = 'localhost';

$cfg['Servers'][$i]['port'] = 'port';`