FAQ - Frequently Asked Questions
BetterMyAdmin keeps phpMyAdmin’s features and interface, so phpMyAdmin’s Link section (books, tutorials) is useful for in-depth coverage too. The questions below are phpMyAdmin’s, with their numbers; those about PHP or a web server are kept with a short answer saying why they do not apply to BetterMyAdmin.
Server
1.1 My server is crashing each time a specific action is required or phpMyAdmin sends a blank page or a page full of cryptic characters to my browser, what can I do?
BetterMyAdmin does not run on PHP or in a web server: it is a single Node.js process (or the Docker image) with its own HTTP server. The directives this answer was about ($cfg['OBGzip'] and
PHP’s zlib.output_compression) do not exist there.
If BetterMyAdmin shows a blank page, look at the server’s error output
(docker logs for the image) and at the browser’s JavaScript console (see
5.19 I get JavaScript errors in my browser.).
1.2 My Apache server crashes when using phpMyAdmin.
BetterMyAdmin does not run on PHP or in a web server: it is a single Node.js process (or the Docker image) with its own HTTP server. If you run Apache as a reverse proxy in front of it, a crash of Apache is not related to BetterMyAdmin.
1.3 (withdrawn).
1.4 Using phpMyAdmin on IIS, I’m displayed the error message: “The specified CGI application misbehaved by not returning a complete set of HTTP headers …”.
BetterMyAdmin does not run on PHP or in a web server: it is a single Node.js process (or the Docker image) with its own HTTP server. This IIS/CGI problem does not apply.
1.5 Using phpMyAdmin on IIS, I’m facing crashes and/or many error messages with the HTTP.
BetterMyAdmin does not run on PHP or in a web server: it is a single Node.js process (or the Docker image) with its own HTTP server. The PHP ISAPI filter is not involved.
1.6 I can’t use phpMyAdmin on PWS: nothing is displayed!
BetterMyAdmin does not run on PHP or in a web server: it is a single Node.js process (or the Docker image) with its own HTTP server. PWS is not involved, and the files named in this answer do not exist.
1.7 How can I gzip a dump or a CSV export? It does not seem to work.
Compression is built into BetterMyAdmin: zip and gzip exports need no extra
software and no PHP Zlib support. Check that $cfg['ZipDump']
and $cfg['GZipDump'] are not disabled.
1.8 I cannot insert a text file in a table, and I get an error about safe mode being in effect.
BetterMyAdmin does not run on PHP, so PHP’s safe mode and upload_tmp_dir
do not apply. An uploaded file is staged in a private bma-import
subdirectory of the system temporary directory (mode 0700), which needs no
setup.
1.9 (withdrawn).
1.10 I’m having troubles when uploading files with phpMyAdmin running on a secure server. My browser is Internet Explorer and I’m using the Apache server.
BetterMyAdmin does not run on PHP or in a web server: it is a single Node.js process (or the Docker image) with its own HTTP server. This Internet Explorer and Apache SSL workaround does not apply.
1.11 I get an ‘open_basedir restriction’ while uploading a file from the import tab.
BetterMyAdmin does not run on PHP, so there is no open_basedir restriction
and $cfg['TempDir'] is not needed for uploads: an uploaded file
is staged in a private subdirectory of the system temporary directory.
1.12 I have lost my MySQL root password, what can I do?
BetterMyAdmin does authenticate against MySQL server you’re using, so to recover from BetterMyAdmin password loss, you need to recover at MySQL level.
The MySQL manual explains how to reset the permissions.
If you are using MySQL server installed by your hosting provider, please contact their support to recover the password for you.
1.13 (withdrawn).
1.14 (withdrawn).
1.15 I have problems with mysql.user column names.
In previous MySQL versions, the User and Password columns were
named user and password. Please modify your column names to
align with current standards.
1.16 I cannot upload big dump files (memory, HTTP or timeout problems).
BetterMyAdmin reads imports in chunks and streams exports, so memory is not a concern, but some limits apply:
$cfg['MaxUploadSize']limits the size of an uploaded file (512 MiB by default; the Docker variableUPLOAD_LIMITsets it). It takes the place of PHP’supload_max_filesizeandpost_max_size, which do not exist in BetterMyAdmin.$cfg['ExecTimeLimit']limits how long an import runs (300 seconds by default;0for no limit; the Docker variableMAX_EXECUTION_TIMEsets it). With “Allow interruption”, an import that reaches the limit can be resumed.$cfg['Import']['MaxDecompressedSize']limits what a compressed file may decompress to (ten times the upload limit by default).A reverse proxy in front of BetterMyAdmin may have its own limit on the size of a request or on its duration.
There exist several workarounds if your upload is still too big:
Look at the
$cfg['UploadDir']feature. This allows one to upload a file to the server via scp, FTP, or your favorite file transfer method (or to mount it into the Docker container, seePMA_UPLOADDIR). BetterMyAdmin is then able to import the files from that directory, without the upload limit. More information is available in the Configuration of this document.Using a utility (such as BigDump) to split the files before uploading. We cannot support this or any third party applications, but are aware of users having success with it.
If you have shell (command line) access, use MySQL to import the files directly. You can do this by issuing the “source” command from within MySQL:
source filename.sql;
1.17 Which Database versions does BetterMyAdmin support?
For MySQL, versions 5.5 and newer are supported.
For MariaDB, versions 5.5 and newer are supported.
BetterMyAdmin is checked against MySQL 8.0 and 8.4 and MariaDB 10.11 and 11.4.
The minimum is $cfg['MysqlMinVersion'], as in phpMyAdmin.
1.17a I cannot connect to the MySQL server. It always returns the error message, “Client does not support authentication protocol requested by server; consider upgrading MySQL client”
BetterMyAdmin does not use PHP’s MySQL client library: it connects with the
mysql2 Node.js driver, which supports
the mysql_native_password, caching_sha2_password, sha256_password
and mysql_clear_password authentication methods. If the server asks for
another method, change the account to one of these. More information is
located in the MySQL Documentation.
1.18 (withdrawn).
1.19 I can’t run the “display relations” feature because the script seems not to know the font face I’m using!
phpMyAdmin’s TCPDF library needs special font files for this feature. BetterMyAdmin does not use TCPDF: its PDF export and PDF relational schema embed the DejaVu Sans font they ship with, which covers Latin, Greek, Cyrillic and many other scripts, so there are no font files to build (see 6.8 How can I produce a PDF schema of my database?).
1.20 I receive an error about missing mysqli and mysql extensions.
BetterMyAdmin does not run on PHP and needs no PHP MySQL extension: it connects with the built-in mysql2 Node.js driver.
1.22 I don’t see the “Location of text file” field, so I cannot upload.
BetterMyAdmin does not run on PHP, so PHP’s file_uploads setting does not
apply: uploads are always possible, limited by
$cfg['MaxUploadSize'].
1.23 I’m running MySQL on a Win32 machine. Each time I create a new table the table and column names are changed to lowercase!
This happens because the MySQL directive lower_case_table_names
defaults to 1 (ON) in the Win32 version of MySQL. You can change
this behavior by simply changing the directive to 0 (OFF): Just
edit your my.ini file that should be located in your Windows
directory and add the following line to the group [mysqld]:
set-variable = lower_case_table_names=0
Note
Forcing this variable to 0 with –lower-case-table-names=0 on a case-insensitive filesystem and access MyISAM tablenames using different lettercases, index corruption may result.
Next, save the file and restart the MySQL service. You can always check the value of this directive using the query
SHOW VARIABLES LIKE 'lower_case_table_names';
1.24 (withdrawn).
1.25 I am running Apache with mod_gzip-1.3.26.1a on Windows XP, and I get problems, such as undefined variables when I run a SQL query.
BetterMyAdmin does not run on PHP or in a web server: it is a single Node.js process (or the Docker image) with its own HTTP server. This Apache mod_gzip problem does not apply.
1.26 I just installed phpMyAdmin in my document root of IIS but I get the error “No input file specified” when trying to run phpMyAdmin.
BetterMyAdmin does not run on PHP or in a web server: it is a single Node.js process (or the Docker image) with its own HTTP server. There is no IIS document root to install it into.
1.27 I get empty page when I want to view huge page (eg. db_structure.php with plenty of tables).
This was caused by a PHP bug with GZIP output buffering. BetterMyAdmin does not
run on PHP and has no $cfg['OBGzip'], and the page named in the
question does not exist there.
1.28 My MySQL server sometimes refuses queries and returns the message ‘Errorcode: 13’. What does this mean?
This can happen due to a MySQL bug when having database / table names
with upper case characters although lower_case_table_names is
set to 1. To fix this, turn off this directive, convert all database
and table names to lower case and turn it on again. Alternatively,
there’s a bug-fix available starting with MySQL 3.23.56 /
4.0.11-gamma.
1.29 When I create a table or modify a column, I get an error and the columns are duplicated.
BetterMyAdmin does not run on PHP or in a web server: it is a single Node.js process (or the Docker image) with its own HTTP server. This Apache and PHP configuration problem does not apply.
1.31 Which PHP versions does phpMyAdmin support?
BetterMyAdmin does not run on PHP. It needs Node.js 22.5 or newer, or the Docker image, which brings its own Node.js (see Requirements).
1.32 Can I use HTTP authentication with IIS?
BetterMyAdmin does not run on PHP or in a web server: it is a single Node.js process (or the Docker image) with its own HTTP server. IIS is not involved. HTTP authentication works without extra setup (see HTTP authentication mode).
1.33 (withdrawn).
1.34 Can I directly access a database or table pages?
Yes. Every page of BetterMyAdmin has its own URL, which you can bookmark or link to, for example:
https://example.com/s/1/– the home page of server 1;https://example.com/s/1/db/sakila/– a database;https://example.com/s/1/db/sakila/t/actor/browse– a table’s Browse tab.
The number after /s/ is the server number (its position in the
$cfg['Servers'] list, from 1).
phpMyAdmin’s addresses keep working: index.php?route=/database/structure&db=sakila&server=1
and phpMyAdmin 4’s per-page scripts (db_structure.php?db=sakila) are
redirected to the BetterMyAdmin page they name. No rewrite rules are needed.
1.35 Can I use HTTP authentication with Apache CGI?
BetterMyAdmin does not run on PHP or in a web server: it is a single Node.js process (or the Docker image) with its own HTTP server. Apache’s CGI is not
involved. If a reverse proxy is in front of BetterMyAdmin, it must pass the
Authorization header through (see HTTP authentication mode).
1.36 I get an error “500 Internal Server Error”.
There can be many explanations to this and a look at BetterMyAdmin’s error
output (docker logs for the image) might give a clue. If a reverse proxy is
in front of BetterMyAdmin, its error log may tell more, for example when it
cannot reach BetterMyAdmin.
1.38 (withdrawn).
1.39 When I try to connect via https, I can log in, but then my connection is redirected back to http. What can cause this behavior?
This happens when BetterMyAdmin does not know that the site is accessed with
https, typically behind a reverse proxy that terminates TLS. Make the proxy
send an X-Forwarded-Proto: https header (and keep the Host header), or
set $cfg['PmaAbsoluteUri'] to the public https URL.
$cfg['ForceSSL'] additionally redirects plain HTTP requests to
https.
1.41 When I view a database and ask to see its privileges, I get an error about an unknown column.
The MySQL server’s privilege tables are not up to date, you need to run the mysql_upgrade command on the server.
1.42 How can I prevent robots from accessing BetterMyAdmin?
BetterMyAdmin sends an X-Robots-Tag: noindex, nofollow header with every
response, which keeps well-behaved search engines from indexing it. That
does not stop other robots: to keep them away, do not expose BetterMyAdmin to
the internet at all (it listens on 127.0.0.1 by default, see
$cfg['Listen']['host']), restrict access by IP address in
your firewall or reverse proxy, or require an authentication in front of it
(see Securing your BetterMyAdmin installation).
1.43 Why can’t I display the structure of my table containing hundreds of columns?
BetterMyAdmin does not run on PHP, so PHP’s memory_limit does not apply. If a
table with very many columns is slow to display, it is the browser that has to
render the page.
1.44 How can I reduce the installed size of phpMyAdmin on disk?
BetterMyAdmin is not installed from PHP files and composer packages: it is distributed as a Docker image, or built from a checkout with pnpm, and its features are not separate files you can remove. The Docker image is the smallest way to run it.
1.45 I get an error message about unknown authentication method caching_sha2_password when trying to log in
This error comes from PHP’s mysqli before PHP 7.4. BetterMyAdmin does not run
on PHP: its MySQL driver supports the caching_sha2_password authentication
method of MySQL 8.0 and newer, so this error does not occur and no workaround
is needed. If you changed an account to mysql_native_password for
phpMyAdmin, it keeps working with BetterMyAdmin.
1.46 Missing HTTP_HOST variable when using nginx with HTTP/3
BetterMyAdmin reads the host name from the Host header of each request (the
HTTP_HOST variable in phpMyAdmin’s messages). When the header is missing, for
example behind nginx with HTTP/3 enabled, several things break:
Two-factor authentication won’t work
Exported settings have no hostname in the filename (e.g.,
BetterMyAdmin-config-.json)The hostname is missing from the page title (empty
@HTTP_HOST@)
To fix this issue, make the reverse proxy pass the host on; with nginx, add
the following line to the location block that proxies to BetterMyAdmin:
proxy_set_header Host $host;
Configuration
2.1 The error message “Warning: Cannot add header information - headers already sent by …” is displayed, what’s the problem?
This is a PHP warning. BetterMyAdmin’s configuration file is data (JSON, YAML) or a JavaScript module, not PHP code, so it cannot occur. A configuration file that cannot be read stops the server at start with a message saying why.
2.2 BetterMyAdmin can’t connect to MySQL. What’s wrong?
Either the connection settings or your username/password is wrong. Check
$cfg['Servers'][$i]['host'] and
$cfg['Servers'][$i]['port'] (or PMA_HOST and
PMA_PORT) and that the MySQL server accepts connections from the host
BetterMyAdmin runs on. In a Docker container, localhost is the container
itself, not the machine running it: use the database container’s name (for
example db) or the machine’s address instead. The error message shown on
the login page says what failed (unless
$cfg['Servers'][$i]['hide_connection_errors'] is set).
2.3 The error message “Warning: MySQL Connection Failed: Can’t connect to local MySQL server through socket ‘/tmp/mysql.sock’ (111) …” is displayed. What can I do?
The error message can also be: Error #2002 - The server is not responding (or the local MySQL server’s socket is not correctly configured).
First, you need to determine what socket is being used by MySQL. To do this,
connect to your server and go to the MySQL bin directory. In this directory
there should be a file named mysqladmin. Type ./mysqladmin variables, and
this should give you a bunch of info about your MySQL server, including the
socket (/tmp/mysql.sock, for example). You can also ask your ISP for the
connection info or, if you’re hosting your own, connect from the ‘mysql’
command-line client and type ‘status’ to get the connection type and socket or
port number.
Then, you need to tell BetterMyAdmin to use this socket with
$cfg['Servers'][$i]['socket'] (or PMA_SOCKET with Docker).
Please also make sure that the permissions of this file allow it to be read by
the user running BetterMyAdmin; with Docker, the socket’s directory has to be
mounted into the container. On many Linux distributions the socket of MySQL is
/var/lib/mysql/mysql.sock or /run/mysqld/mysqld.sock.
Have also a look at the corresponding section of the MySQL documentation.
2.4 Nothing is displayed by my browser when I try to run BetterMyAdmin, what can I do?
Make sure that JavaScript is enabled in your browser: BetterMyAdmin’s
interface is a JavaScript application. Then look at the browser’s JavaScript
console (see 5.19 I get JavaScript errors in my browser.) and at BetterMyAdmin’s error output. When running
from a checkout, make sure the web application has been built
(pnpm build) before pnpm start.
2.6 I get an “Access denied for user: ‘root@localhost’ (Using password: YES)”-error when trying to access a MySQL-Server on a host which is port-forwarded for my localhost.
When you are using a port on your localhost, which you redirect via port-forwarding to another host, MySQL is not resolving the localhost as expected. Erik Wasser explains: The solution is: if your host is “localhost” MySQL (the command line tool mysql as well) always tries to use the socket connection for speeding up things. And that doesn’t work in this configuration with port forwarding. If you enter “127.0.0.1” as hostname, everything is right and MySQL uses the TCP connection.
2.7 Using and creating themes
See Custom Themes.
2.8 I get “Missing parameters” errors, what can I do?
Here are a few points to check:
In the configuration file, try to leave the
$cfg['PmaAbsoluteUri']directive empty. See also 4.7 Authentication window is displayed more than once, why?.A web application firewall or proxy between the browser and BetterMyAdmin may remove parameters from requests (see 5.21 I get errors about potentially unsafe operation when browsing table or executing SQL query.).
The PHP settings phpMyAdmin’s answer lists (Zend Optimizer, Hardened PHP’s
varfilter.max_request_variables, arg_separator.input,
session.save_path) do not exist in BetterMyAdmin.
2.9 Seeing an upload progress bar
There is nothing to set up: BetterMyAdmin shows the progress of an import
itself. PHP’s uploadprogress extension and session.upload_progress
settings, which phpMyAdmin’s progress bar needed, do not apply.
2.10 How to generate a string of random bytes
One way to generate a random string suitable for cryptographic use is the
crypto module of Node.js, which BetterMyAdmin already needs:
node -e "console.log(require('crypto').randomBytes(24).toString('base64'))"
or, with OpenSSL:
openssl rand -base64 24
Both print 32 characters made of 24 random bytes, something similar to:
sKpL0qkZ3m4J8Yw1n6eVb2rT9cXu5hDa
which can be used in the configuration file, for example for
$cfg['blowfish_secret']:
{ "blowfish_secret": "sKpL0qkZ3m4J8Yw1n6eVb2rT9cXu5hDa" }
Without a blowfish_secret, BetterMyAdmin generates one on the first start
and keeps it in $cfg['DataDir']. phpMyAdmin’s
sodium_hex2bin() form is PHP code and cannot be used in a configuration
file.
Known limitations
3.1 When using HTTP authentication, a user who logged out can not log in again in with the same nick.
This is related to the authentication mechanism (protocol) used by BetterMyAdmin. To bypass this problem: just close all the opened browser windows and then go back to BetterMyAdmin. You should be able to log in again.
3.2 When dumping a large table in compressed mode, I get a memory limit error or a time limit error.
This is a PHP limitation that BetterMyAdmin does not have: it streams every
export, compressed or not, in bounded memory, and an export has no time limit
($cfg['ExecTimeLimit'] applies to imports only). With
$cfg['CompressOnFly'], gzip output is compressed in chunks.
3.3 With InnoDB tables, I lose foreign key relationships when I rename a table or a column.
This is an InnoDB bug, see <https://bugs.mysql.com/bug.php?id=21704>.
3.4 I am unable to import dumps I created with the mysqldump tool bundled with the MySQL server distribution.
The problem is that older versions of mysqldump created invalid
comments like this:
-- MySQL dump 8.22
--
-- Host: localhost Database: database
---------------------------------------------------------
-- Server version 3.23.54
The invalid part of the code is the horizontal line made of dashes
that appears once in every dump created with mysqldump. If you want to
run your dump you have to turn it into valid MySQL. This means, you
have to add a whitespace after the first two dashes of the line or add
a # before it: -- ------------------------------------------------------- or
#---------------------------------------------------------
3.5 When using nested folders, multiple hierarchies are displayed in a wrong manner.
Please note that you should not use the separating string multiple times without any characters between them, or at the beginning/end of your table name. If you have to, think about using another TableSeparator or disabling that feature.
See also
3.6 (withdrawn).
3.7 I have table with many (100+) columns and when I try to browse table I get series of errors like “Warning: unable to parse url”. How can this be fixed?
This PHP warning cannot occur in BetterMyAdmin, which does not run on PHP and does not put the row identification into a URL. A primary key or unique key is still recommended, as it identifies the rows reliably (see 3.10 Homonyms and no primary key: When the results of a SELECT display more than one row with the same value (for example SELECT lastname from employees where firstname like 'A%' and two “Smith” values are displayed), if I click Edit I cannot be sure that I am editing the intended row.).
3.8 I cannot use (clickable) HTML-forms in columns where I put a MIME-Transformation onto!
The PHP workaround this answer gave (a form posting to tbl_row_delete.php)
does not apply to BetterMyAdmin. Transformation output is sanitized with
phpMyAdmin’s allow-list of HTML tags, which contains no form elements, so
forms cannot be used there.
3.9 I get error messages when using “–sql_mode=ANSI” for the MySQL server.
When MySQL is running in ANSI-compatibility mode, there are some major differences in how SQL is structured (see <https://dev.mysql.com/doc/refman/5.7/en/sql-mode.html>). Most important of all, the quote-character (”) is interpreted as an identifier quote character and not as a string quote character, which makes many internal BetterMyAdmin operations into invalid SQL statements. There is no workaround to this behaviour. News to this item will be posted in issue #7383.
3.10 Homonyms and no primary key: When the results of a SELECT display more than one row with the same value (for example SELECT lastname from employees where firstname like 'A%' and two “Smith” values are displayed), if I click Edit I cannot be sure that I am editing the intended row.
Please make sure that your table has a primary key, so that BetterMyAdmin can use it for the Edit and Delete links.
3.11 The number of rows for InnoDB tables is not correct.
BetterMyAdmin uses a quick method to get the row count, and this method only
returns an approximate count in the case of InnoDB tables. See
$cfg['MaxExactCount'] for a way to modify those results, but
this could have a serious impact on performance.
However, one can easily replace the approximate row count with exact count by
simply clicking on the approximate count. This can also be done for all tables
at once by clicking on the rows sum displayed at the bottom.
See also
3.12 (withdrawn).
3.13 I get an error when entering USE followed by a db name containing an hyphen.
The tests I have made with MySQL 5.1.49 shows that the API does not accept this syntax for the USE command.
3.14 I am not able to browse a table when I don’t have the right to SELECT one of the columns.
This has been a known limitation of phpMyAdmin since the beginning, which BetterMyAdmin shares, and it’s not likely to be solved in the future.
3.15 (withdrawn).
3.16 (withdrawn).
3.17 (withdrawn).
3.18 When I import a CSV file that contains multiple tables, they are lumped together into a single table.
There is no reliable way to differentiate tables in CSV format. For the time being, you will have to break apart CSV files containing multiple tables.
3.19 When I import a file and have BetterMyAdmin determine the appropriate data structure it only uses int, decimal, and varchar types.
Currently, the import type-detection system can only assign these MySQL types to columns. In future, more will likely be added but for the time being you will have to edit the structure to your liking post-import. Also, you should note the fact that BetterMyAdmin will use the size of the largest item in any given column as the column size for the appropriate type. If you know you will be adding larger items to that column then you should manually adjust the column sizes accordingly. This is done for the sake of efficiency.
3.20 After upgrading, some bookmarks are gone or their content cannot be shown.
At some point, the character set used to store bookmark content has changed. It’s better to recreate your bookmark from the newer BetterMyAdmin version.
3.21 I am unable to log in with a username containing unicode characters such as á.
This can happen if MySQL server is not configured to use utf-8 as default charset, as the user name is sent before the connection’s character set is set.
See also
ISPs, multi-user installations
4.1 I’m an ISP. Can I setup one central copy of BetterMyAdmin or do I need to install it for each customer?
You can setup a central copy of BetterMyAdmin for all your users. This requires a properly setup MySQL user management and BetterMyAdmin HTTP or cookie authentication.
See also
4.2 What’s the preferred way of making BetterMyAdmin secure against evil access?
This depends on your system. If you’re running a server which cannot be
accessed by other people, keeping BetterMyAdmin on 127.0.0.1 (the default
of $cfg['Listen']['host']) or behind a reverse proxy that asks
for a password may be enough. If other people can reach it, you should use
BetterMyAdmin’s HTTP or cookie authentication features.
Suggestions:
Your configuration file should be readable only by the user running BetterMyAdmin and by you (for example
chmod 640), and never world writable (see$cfg['CheckConfigurationPermissions']).Keep
$cfg['DataDir']private (BetterMyAdmin creates it with mode0700).Serve BetterMyAdmin over HTTPS and follow the recommendations in Securing your BetterMyAdmin installation.
4.3 I get errors about not being able to include a file in /lang or in /libraries.
BetterMyAdmin does not run on PHP, so PHP’s include_path and
open_basedir do not apply, and the directories named in the question do
not exist.
4.4 BetterMyAdmin always gives “Access denied” when using HTTP authentication.
This could happen for several reasons:
$cfg['Servers'][$i]['controluser']and/or$cfg['Servers'][$i]['controlpass']are wrong.The username/password you specify in the login dialog are invalid.
You have already setup another HTTP authentication in front of BetterMyAdmin, for example in a reverse proxy. Its credentials are sent in the same header and would interfere with BetterMyAdmin’s authentication, so remove it (or use cookie authentication).
Failed logins are rate limited: after too many of them, the account is locked out for a while (see
$cfg['LoginRateLimit']).
4.5 Is it possible to let users create their own databases?
Starting with 2.2.5, in the user management page, you can enter a
wildcard database name for a user (for example “joe%”), and put the
privileges you want. For example, adding SELECT, INSERT, UPDATE,
DELETE, CREATE, DROP, INDEX, ALTER would let a user create/manage
their database(s).
4.6 How can I use the Host-based authentication additions?
If you have existing rules from an old .htaccess file, you can take them and
add a username between the 'deny'/'allow' and 'from'
strings. Using the username wildcard of '%' would be a major
benefit here if your installation is suited to using it. Then you can
just add those updated lines into the
$cfg['Servers'][$i]['AllowDeny']['rules'] array.
If you want a pre-made sample, you can try this fragment. It stops the ‘root’ user from logging in from any networks other than the private network IP blocks.
{
"Servers": [{
"AllowDeny": {
"order": "deny,allow",
"rules": [
"deny root from all",
"allow root from localhost",
"allow root from 10.0.0.0/8",
"allow root from 192.168.0.0/16",
"allow root from 172.16.0.0/12"
]
}
}]
}
4.7 Authentication window is displayed more than once, why?
This happens if you are using a URL to start BetterMyAdmin which is
different than the one set in your $cfg['PmaAbsoluteUri']. For
example, a missing “www”, or entering with an IP address while a domain
name is defined in the config file.
4.8 Which parameters can I use in the URL that starts BetterMyAdmin?
Every page has its own URL (see 1.34 Can I directly access a database or table pages?), so you can start
BetterMyAdmin on any page. phpMyAdmin’s parameters work too: the db,
table and server parameters of a phpMyAdmin address (server being
the numeric host index from the configuration file) are redirected to the
matching page.
For example, to jump directly to a particular database, a URL can be
constructed as https://example.com/s/1/db/sakila/, or, phpMyAdmin’s way,
https://example.com/index.php?db=sakila.
Changed in version 4.9.0: Support for using the pma_username and pma_password parameters was removed
in phpMyAdmin 4.9.0 (see PMASA-2019-4).
Browsers or client OS
5.1 I get an out of memory error, and my controls are non-functional, when trying to create a table with more than 14 columns.
We could reproduce this problem only under Win98/98SE. Testing under WinNT4 or Win2K, we could easily create more than 60 columns. A workaround is to create a smaller number of columns, then come back to your table properties and add the other columns.
5.2 With Xitami 2.5b4, phpMyAdmin won’t process form fields.
BetterMyAdmin does not run on PHP or in a web server such as Xitami: it is a single Node.js process with its own HTTP server, so this Xitami bug does not apply.
5.3 I have problems dumping tables with Konqueror (phpMyAdmin 2.2.2).
With Konqueror 2.1.1: plain dumps, zip and gzip dumps work ok, except that the proposed file name for the dump is always ‘tbl_dump.php’. The bzip2 dumps don’t seem to work. With Konqueror 2.2.1: plain dumps work; zip dumps are placed into the user’s temporary directory, so they must be moved before closing Konqueror, or else they disappear. gzip dumps give an error message. Testing needs to be done for Konqueror 2.2.2.
5.5 (withdrawn).
5.6 (withdrawn).
5.7 I refresh (reload) my browser, and come back to the welcome page.
Some browsers support right-clicking into the frame you want to refresh, just do this in the right frame.
5.8 (withdrawn).
5.9 (withdrawn).
5.10 (withdrawn).
5.11 Extended-ASCII characters like German umlauts are displayed wrong.
Please ensure that you have set your browser’s character set to the one of the language file you have selected on BetterMyAdmin’s start page. Alternatively, you can try the auto detection mode that is supported by the recent versions of the most browsers.
5.12 Mac OS X Safari browser changes special characters to “?”.
This issue has been reported by a macOS user, who adds that Chimera, Netscape and Mozilla do not have this problem.
5.13 (withdrawn)
5.14 (withdrawn)
5.15 (withdrawn)
5.16 With Internet Explorer, I get “Access is denied” Javascript errors. Or I cannot make BetterMyAdmin work under Windows.
Please check the following points:
Maybe you have defined your
$cfg['PmaAbsoluteUri']setting in the configuration file to an IP address and you are starting BetterMyAdmin with a URL containing a domain name, or the reverse situation.Security settings in IE and/or Microsoft Security Center are too high, thus blocking scripts execution.
The Windows Firewall is blocking BetterMyAdmin and MySQL. You must allow BetterMyAdmin’s HTTP port (8080 by default) and the MySQL port (usually 3306) in the “in” and “out” directions.
5.17 With Firefox, I cannot delete rows of data or drop a database.
Many users have confirmed that the Tabbrowser Extensions plugin they installed in their Firefox is causing the problem.
5.18 (withdrawn)
5.19 I get JavaScript errors in my browser.
Issues have been reported with some combinations of browser extensions. To troubleshoot, disable all extensions then clear your browser cache to see if the problem goes away.
5.20 I get errors about violating Content Security Policy.
If you see errors like:
Refused to apply inline style because it violates the following Content Security Policy directive
This is usually caused by some software, which wrongly rewrites Content Security Policy headers. Usually this is caused by antivirus proxy or browser addons which are causing such errors.
If you see these errors, try disabling the HTTP proxy in antivirus or disable the Content Security Policy rewriting in it. If that doesn’t help, try disabling browser extensions.
Alternatively it can be also a reverse proxy configuration issue (if the proxy
is configured to emit Content Security Policy headers, they can
override the ones from BetterMyAdmin). To allow more sources, use
$cfg['CSPAllow'].
Programs known to cause these kind of errors:
Kaspersky Internet Security
5.21 I get errors about potentially unsafe operation when browsing table or executing SQL query.
If you see errors like:
A potentially unsafe operation has been detected in your request to this site.
This is usually caused by web application firewall doing requests filtering. It tries to prevent SQL injection, however BetterMyAdmin is tool designed to execute SQL queries, thus it makes it unusable.
Please allow BetterMyAdmin scripts from the web application firewall settings or disable it completely for BetterMyAdmin path.
Programs known to cause these kind of errors:
Wordfence Web Application Firewall
Using BetterMyAdmin
6.1 I can’t insert new rows into a table / I can’t create a table - MySQL brings up a SQL error.
Examine the SQL error with care. Often the problem is caused by specifying a wrong column-type. Common errors include:
Using
VARCHARwithout a size argumentUsing
TEXTorBLOBwith a size argument
Also, look at the syntax chapter in the MySQL manual to confirm that your syntax is correct.
6.2 When I create a table, I set an index for two columns and BetterMyAdmin generates only one index with those two columns.
This is the way to create a multi-columns index. If you want two indexes, create the first one when creating the table, save, then display the table properties and click the Index link to create the other index.
6.3 How can I insert a null value into my table?
You have a checkbox for each column that can be null. If you enter “NULL” in the field instead, this means you want a literal NULL text in the column, and not a NULL value.
6.4 How can I backup my database or table?
Click on a database or table name in the navigation panel, the properties will be displayed. Then on the menu, click “Export”, you can dump the structure, the data, or both. This will generate standard SQL statements that can be used to recreate your database/table. You will need to choose “Save as file”, so that BetterMyAdmin can transmit the resulting dump to your station. You can also compress the dump (zip or gzip). For additional help on this subject, look for the word “dump” in this document.
6.5 How can I restore (upload) my database or table using a dump? How can I run a “.sql” file?
Click on a database name in the navigation panel, the properties will be displayed. Select “Import” from the list of tabs in the right–hand frame. In the “Location of the text file” section, type in the path to your dump filename, or use the Browse button. Then click Go. For additional help on this subject, look for the word “upload” in this document.
Note: For errors while importing of dumps exported from older MySQL versions to newer MySQL versions, please check 6.41 I get import errors while importing the dumps exported from older MySQL versions (pre-5.7.6) into newer MySQL versions (5.7.7+), but they work fine when imported back on same older versions ?.
6.6 How can I use the relation table in Query-by-example?
Here is an example with the tables persons, towns and countries, all
located in the database “mydb”. If you don’t have a pma__relation
table, create it as explained in the configuration section. Then
create the example tables:
CREATE TABLE REL_countries (
country_code char(1) NOT NULL default '',
description varchar(10) NOT NULL default '',
PRIMARY KEY (country_code)
) ENGINE=MyISAM;
INSERT INTO REL_countries VALUES ('C', 'Canada');
CREATE TABLE REL_persons (
id tinyint(4) NOT NULL auto_increment,
person_name varchar(32) NOT NULL default '',
town_code varchar(5) default '0',
country_code char(1) NOT NULL default '',
PRIMARY KEY (id)
) ENGINE=MyISAM;
INSERT INTO REL_persons VALUES (11, 'Marc', 'S', 'C');
INSERT INTO REL_persons VALUES (15, 'Paul', 'S', 'C');
CREATE TABLE REL_towns (
town_code varchar(5) NOT NULL default '0',
description varchar(30) NOT NULL default '',
PRIMARY KEY (town_code)
) ENGINE=MyISAM;
INSERT INTO REL_towns VALUES ('S', 'Sherbrooke');
INSERT INTO REL_towns VALUES ('M', 'Montréal');
To setup appropriate links and display information:
on table “REL_persons” click Structure, then Relation view
for “town_code”, choose from dropdowns, “mydb”, “REL_towns”, “town_code” for foreign database, table and column respectively
for “country_code”, choose from dropdowns, “mydb”, “REL_countries”, “country_code” for foreign database, table and column respectively
on table “REL_towns” click Structure, then Relation view
in “Choose column to display”, choose “description”
repeat the two previous steps for table “REL_countries”
Then test like this:
Click on your db name in the navigation panel
Choose “Query”
Use tables: persons, towns, countries
Click “Update query”
In the columns row, choose persons.person_name and click the “Show” tickbox
Do the same for towns.description and countries.descriptions in the other 2 columns
Click “Update query” and you will see in the query box that the correct joins have been generated
Click “Submit query”
6.7 How can I use the “display column” feature?
Starting from the previous example, create the pma__table_info as
explained in the configuration section, then browse your persons
table, and move the mouse over a town code or country code. See also
6.21 In edit/insert mode, how can I see a list of possible values for a column, based on some foreign table? for an additional feature that “display column”
enables: drop-down list of possible values.
6.8 How can I produce a PDF schema of my database?
First the configuration variables “relation”, “table_coords” and “pdf_pages” have to be filled in.
Select your database in the navigation panel.
Choose “Designer” in the navigation bar at the top.
Move the tables the way you want them.
Choose “Export schema” in the left menu.
The export modal will open.
Select the type of export to PDF, you may adjust the other settings.
Submit the form and the file will start downloading.
See also
6.9 BetterMyAdmin is changing the type of one of my columns!
No, it’s MySQL that is doing silent column type changing.
6.10 When creating a privilege, what happens with underscores in the database name?
If you do not put a backslash before the underscore, this is a wildcard grant, and the underscore means “any character”. So, if the database name is “john_db”, the user would get rights to john1db, john2db … If you put a backslash before the underscore, it means that the database name will have a real underscore.
6.11 What is the curious symbol ø in the statistics pages?
It means “average”.
6.12 I want to understand some Export options.
Structure:
“Add DROP TABLE” will add a line telling MySQL to drop the table, if it already exists during the import. It does NOT drop the table after your export, it only affects the import file.
“If Not Exists” will only create the table if it doesn’t exist. Otherwise, you may get an error if the table name exists but has a different structure.
“Add AUTO_INCREMENT value” ensures that AUTO_INCREMENT value (if any) will be included in backup.
“Enclose table and column names with backquotes” ensures that column and table names formed with special characters are protected.
“Add into comments” includes column comments, relations, and media types set in the pmadb in the dump as SQL comments (/* xxx */).
Data:
“Complete inserts” adds the column names on every INSERT command, for better documentation (but resulting file is bigger).
“Extended inserts” provides a shorter dump file by using only once the INSERT verb and the table name.
“Delayed inserts” are best explained in the MySQL manual - INSERT DELAYED Syntax.
“Ignore inserts” treats errors as a warning instead. Again, more info is provided in the MySQL manual - INSERT Syntax, but basically with this selected, invalid values are adjusted and inserted rather than causing the entire statement to fail.
6.13 I would like to create a database with a dot in its name.
This is a bad idea, because in MySQL the syntax “database.table” is the normal way to reference a database and table name. Worse, MySQL will usually let you create a database with a dot, but then you cannot work with it, nor delete it.
6.14 (withdrawn).
6.15 I want to add a BLOB column and put an index on it, but MySQL says “BLOB column ‘…’ used in key specification without a key length”.
The right way to do this, is to create the column without any indexes, then display the table structure and use the “Create an index” dialog. On this page, you will be able to choose your BLOB column, and set a size to the index, which is the condition to create an index on a BLOB column.
6.16 How can I simply move in page with plenty editing fields?
You can use Ctrl+arrows (Option+Arrows in Safari) for moving on most pages with many editing fields (table structure changes, row editing, etc.).
6.17 Transformations: I can’t enter my own mimetype! What is this feature then useful for?
Defining mimetypes is of no use if you can’t put transformations on them. Otherwise you could just put a comment on the column. Because entering your own mimetype will cause serious syntax checking issues and validation, this introduces a high-risk false- user-input situation. Instead you have to initialize mimetypes using functions or empty mimetype definitions.
Plus, you have a whole overview of available mimetypes. Who knows all those mimetypes by heart so they can enter it at will?
6.18 Bookmarks: Where can I store bookmarks? Why can’t I see any bookmarks below the query box? What are these variables for?
You need to have configured the phpMyAdmin configuration storage for using bookmarks feature. Once you have done that, you can use bookmarks in the SQL tab.
See also
6.19 How can I create simple LATEX document to include exported table?
You can simply include table in your LATEX documents,
minimal sample document should look like following one (assuming you
have table exported in file table.tex):
\documentclass{article} % or any class you want
\usepackage{longtable} % for displaying table
\begin{document} % start of document
\include{table} % including exported table
\end{document} % end of document
6.20 I see a lot of databases which are not mine, and cannot access them.
You have one of these global privileges: CREATE TEMPORARY TABLES, SHOW DATABASES, LOCK TABLES. Those privileges also enable users to see all the database names. So if your users do not need those privileges, you can remove them and their databases list will shorten.
See also
6.21 In edit/insert mode, how can I see a list of possible values for a column, based on some foreign table?
You have to setup appropriate links between the tables, and also setup
the “display column” in the foreign table. See 6.6 How can I use the relation table in Query-by-example? for an
example. Then, if there are 100 values or less in the foreign table, a
drop-down list of values will be available. You will see two lists of
values, the first list containing the key and the display column, the
second list containing the display column and the key. The reason for
this is to be able to type the first letter of either the key or the
display column. For 100 values or more, a distinct window will appear,
to browse foreign key values and choose one. To change the default
limit of 100, see $cfg['ForeignKeyMaxLimit'].
6.22 Bookmarks: Can I execute a default bookmark automatically when entering Browse mode for a table?
Yes. If a bookmark has the same label as a table name and it’s not a public bookmark, it will be executed.
See also
6.23 Export: I heard BetterMyAdmin can export Microsoft Excel files?
You can use CSV for Microsoft Excel, which works out of the box.
Changed in version 3.4.5: Since phpMyAdmin 3.4.5 support for direct export to Microsoft Excel version 97 and newer was dropped.
6.24 Now that BetterMyAdmin supports native MySQL 4.1.x column comments, what happens to my column comments stored in pmadb?
Automatic migration of a table’s pmadb-style column comments to the native ones is done whenever you enter Structure page for this table.
6.25 (withdrawn).
6.26 How can I select a range of rows?
Click the first row of the range, hold the shift key and click the last row of the range. This works everywhere you see rows, for example in Browse mode or on the Structure page.
6.27 What format strings can I use?
In all places where BetterMyAdmin accepts format strings, you can use
@VARIABLE@ expansion and the strftime format strings phpMyAdmin
accepts (%Y, %m, %d, …). The expanded variables depend on a
context (for example, if you haven’t chosen a table, you can not get the table
name), but the following variables can be used:
@HTTP_HOST@HTTP host that runs BetterMyAdmin
@SERVER@MySQL server name
@VERBOSE@Verbose MySQL server name as defined in
$cfg['Servers'][$i]['verbose']@VSERVER@Verbose MySQL server name if set, otherwise normal
@DATABASE@Currently opened database
@TABLE@Currently opened table
@COLUMNS@Columns of the currently opened table
@PHPMYADMIN@BetterMyAdmin with version (the variable keeps its phpMyAdmin name)
6.28 (withdrawn).
6.29 Why can’t I get a chart from my query result table?
Not every table can be put to the chart. Only tables with one, two or three columns can be visualised as a chart. Moreover the table must be in a special format for chart script to understand it. Currently supported formats can be found in Charts.
6.30 Import: How can I import ESRI Shapefiles?
An ESRI Shapefile is actually a set of several files, where .shp file contains geometry data and .dbf file contains data related to those geometry data. BetterMyAdmin reads the .shp file only (phpMyAdmin reads the .dbf file only with PHP’s dBase extension), so only the geometry data is imported.
To upload these set of files you can use either of the following methods:
Configure upload directory with $cfg['UploadDir'], upload both .shp and .dbf files with
the same filename and chose the .shp file from the import page.
Create a zip archive with .shp and .dbf files and import it. No temporary directory needs to be configured for this.
6.31 How do I create a relation in designer?
To select relation, click: The display column is shown in pink. To set/unset a column as the display column, click the “Choose column to display” icon, then click on the appropriate column name.
6.32 How can I use the zoom search feature?
The Zoom search feature is an alternative to table search feature. It allows you to explore a table by representing its data in a scatter plot. You can locate this feature by selecting a table and clicking the Search tab. One of the sub-tabs in the Table Search page is Zoom Search.
Consider the table REL_persons in 6.6 How can I use the relation table in Query-by-example? for an example. To use zoom search, two columns need to be selected, for example, id and town_code. The id values will be represented on one axis and town_code values on the other axis. Each row will be represented as a point in a scatter plot based on its id and town_code. You can include two additional search criteria apart from the two fields to display.
You can choose which field should be displayed as label for each point. If a display column has been set for the table (see 6.7 How can I use the “display column” feature?), it is taken as the label unless you specify otherwise. You can also select the maximum number of rows you want to be displayed in the plot by specifing it in the ‘Max rows to plot’ field. Once you have decided over your criteria, click ‘Go’ to display the plot.
After the plot is generated, you can use the mouse wheel to zoom in and out of the plot. In addition, panning feature is enabled to navigate through the plot. You can zoom-in to a certain level of detail and use panning to locate your area of interest. Clicking on a point opens a dialogue box, displaying field values of the data row represented by the point. You can edit the values if required and click on submit to issue an update query. Basic instructions on how to use can be viewed by clicking the ‘How to use?’ link located just above the plot.
6.33 When browsing a table, how can I copy a column name?
Selecting the name of the column within the browse table header cell for copying is difficult, as the columns support reordering by dragging the header cells as well as sorting by clicking on the linked column name. To copy a column name, double-click on the empty area next to the column name, when the tooltip tells you to do so. This will show you an input box with the column name. You may right-click the column name within this input box to copy it to your clipboard.
6.34 How can I use the Favorite Tables feature?
Favorite Tables feature is very much similar to Recent Tables feature.
It allows you to add a shortcut for the frequently used tables of any
database in the navigation panel . You can easily navigate to any table
in the list by simply choosing it from the list. These tables are stored
in the phpMyAdmin Configuration Storage if you have configured it.
Otherwise BetterMyAdmin keeps them in its local metadata store in
$cfg['DataDir'] on the server.
To add a table to Favorite list simply click on the Gray star in front of a table name in the list of tables of a Database and wait until it turns to Yellow. To remove a table from list, simply click on the Yellow star and wait until it turns Gray again.
Using $cfg['NumFavoriteTables'] in your configuration
file, you can define the maximum number of favorite tables shown in the
navigation panel. Its default value is 10.
6.35 How can I use the Range search feature?
With the help of range search feature, one can specify a range of values for particular column(s) while performing search operation on a table from the Search tab.
To use this feature simply click on the BETWEEN or NOT BETWEEN operators from the operator select list in front of the column name. On choosing one of the above options, a dialog box will show up asking for the Minimum and Maximum value for that column. Only the specified range of values will be included in case of BETWEEN and excluded in case of NOT BETWEEN from the final results.
Note: The Range search feature will work only Numeric and Date data type columns.
6.36 What is Central columns and how can I use this feature?
As the name suggests, the Central columns feature enables to maintain a central list of columns per database to avoid similar name for the same data element and bring consistency of data type for the same data element. You can use the central list of columns to add an element to any table structure in that database which will save from writing similar column name and column definition.
To add a column to central list, go to table structure page, check the columns you want to include and then simply click on “Add to central columns”. If you want to add all unique columns from more than one table from a database then go to database structure page, check the tables you want to include and then select “Add columns to central list”.
To remove a column from central list, go to Table structure page, check the columns you want to remove and then simply click on “Remove from central columns”. If you want to remove all columns from more than one tables from a database then go to database structure page, check the tables you want to include and then select “Remove columns from central list”.
To view and manage the central list, select the database you want to manage central columns for then from the top menu click on “Central columns”. You will be taken to a page where you will have options to edit, delete or add new columns to central list.
6.37 How can I use Improve Table structure feature?
Improve table structure feature helps to bring the table structure upto Third Normal Form. A wizard is presented to user which asks questions about the elements during the various steps for normalization and a new structure is proposed accordingly to bring the table into the First/Second/Third Normal form. On startup of the wizard, user gets to select upto what normal form they want to normalize the table structure.
Here is an example table which you can use to test all of the three First, Second and Third Normal Form.
CREATE TABLE `VetOffice` (
`petName` varchar(64) NOT NULL,
`petBreed` varchar(64) NOT NULL,
`petType` varchar(64) NOT NULL,
`petDOB` date NOT NULL,
`ownerLastName` varchar(64) NOT NULL,
`ownerFirstName` varchar(64) NOT NULL,
`ownerPhone1` int(12) NOT NULL,
`ownerPhone2` int(12) NOT NULL,
`ownerEmail` varchar(64) NOT NULL,
);
The above table is not in First normal Form as no primary key exists. Primary key is supposed to be (petName,`ownerLastName`,`ownerFirstName`) . If the primary key is chosen as suggested the resultant table won’t be in Second as well as Third Normal form as the following dependencies exists.
(OwnerLastName, OwnerFirstName) -> OwnerEmail
(OwnerLastName, OwnerFirstName) -> OwnerPhone
PetBreed -> PetType
Which says, OwnerEmail depends on OwnerLastName and OwnerFirstName. OwnerPhone depends on OwnerLastName and OwnerFirstName. PetType depends on PetBreed.
6.38 How can I reassign auto-incremented values?
Some users prefer their AUTO_INCREMENT values to be consecutive; this is not always the case after row deletion.
Here are the steps to accomplish this. These are manual steps because they involve a manual verification at one point.
Ensure that you have exclusive access to the table to rearrange
On your primary key column (i.e. id), remove the AUTO_INCREMENT setting
Delete your primary key in Structure > indexes
Create a new column future_id as primary key, AUTO_INCREMENT
Browse your table and verify that the new increments correspond to what you’re expecting
Drop your old id column
Rename the future_id column to id
Move the new id column via Structure > Move columns
6.39 What is the “Adjust privileges” option when renaming, copying, or moving a database, table, column, or procedure?
When renaming/copying/moving a database/table/column/procedure, MySQL does not adjust the original privileges relating to these objects on its own. By selecting this option, BetterMyAdmin will adjust the privilege table so that users have the same privileges on the new items.
For example: A user ‘bob’@’localhost’ has a ‘SELECT’ privilege on a column named ‘id’. Now, if this column is renamed to ‘id_new’, MySQL, on its own, would not adjust the column privileges to the new column name. BetterMyAdmin can make this adjustment for you automatically.
Notes:
While adjusting privileges for a database, the privileges of all database-related elements (tables, columns and procedures) are also adjusted to the database’s new name.
Similarly, while adjusting privileges for a table, the privileges of all the columns inside the new table are also adjusted.
While adjusting privileges, the user performing the operation must have the following privileges:
SELECT, INSERT, UPDATE, DELETE privileges on following tables: mysql.`db`, mysql.`columns_priv`, mysql.`tables_priv`, mysql.`procs_priv`
FLUSH privilege (GLOBAL)
Thus, if you want to replicate the database/table/column/procedure as it is while renaming/copying/moving these objects, make sure you have checked this option.
6.40 I see “Bind parameters” checkbox in the “SQL” page. How do I write parameterized SQL queries?
BetterMyAdmin allows users to execute parameterized queries in the “SQL” page. Parameters should be prefixed with a colon(:) and when the “Bind parameters” checkbox is checked these parameters will be identified and input fields for these parameters will be presented. Values entered in these field will be substituted in the query before being executed.
6.41 I get import errors while importing the dumps exported from older MySQL versions (pre-5.7.6) into newer MySQL versions (5.7.7+), but they work fine when imported back on same older versions ?
If you get errors like #1031 - Table storage engine for ‘table_name’ doesn’t have this option while importing the dumps exported from pre-5.7.7 MySQL servers into new MySQL server versions 5.7.7+, it might be because ROW_FORMAT=FIXED is not supported with InnoDB tables. Moreover, the value of innodb_strict_mode would define if this would be reported as a warning or as an error.
Since MySQL version 5.7.9, the default value for innodb_strict_mode is ON and thus would generate an error when such a CREATE TABLE or ALTER TABLE statement is encountered.
There are two ways of preventing such errors while importing:
Change the value of innodb_strict_mode to OFF before starting the import and turn it ON after the import is successfully completed.
This can be achieved in two ways:
Go to ‘Variables’ page and edit the value of innodb_strict_mode
Run the query : SET GLOBAL `innodb_strict_mode = ‘[value]’`
After the import is done, it is suggested that the value of innodb_strict_mode should be reset to the original value.
BetterMyAdmin project
7.1 I have found a bug. How do I inform developers?
Our issues tracker is located at <https://github.com/cB-Sigma/better-myadmin/issues>. BetterMyAdmin aims to behave exactly like phpMyAdmin: a difference that is not listed in the parity exceptions is a bug too. For security issues, please see Reporting security issues.
7.2 I want to translate the messages to a new language or upgrade an existing language, where do I start?
BetterMyAdmin uses phpMyAdmin’s translations: they are imported into the application when it is built, so the same messages are translated. The easiest way to improve them is phpMyAdmin’s online translation service; see also the translate section of phpMyAdmin’s website. Your work then benefits both projects.
7.3 I would like to help out with the development of BetterMyAdmin. How should I proceed?
We welcome every contribution to the development of BetterMyAdmin. The repository has the development setup and the architecture documentation.
See also
Security
8.1 Where can I get information about the security alerts issued for BetterMyAdmin?
BetterMyAdmin’s security fixes are announced in its releases and its changelog. phpMyAdmin’s announcements (<https://www.phpmyadmin.net/security/>) concern phpMyAdmin’s code; one that describes a behaviour BetterMyAdmin shares may concern it too.
8.2 How can I protect BetterMyAdmin against brute force attacks?
BetterMyAdmin limits failed logins by default: five failures of one (IP
address, username) pair within 15 minutes lock that pair out for 5 minutes
($cfg['LoginRateLimit']). You can additionally enable a
captcha ($cfg['CaptchaLoginPublicKey']).
Authentication attempts are logged ($cfg['AuthLog'], with
$cfg['AuthLogSuccess'] for successful ones), to the server’s
error output or to a file, in phpMyAdmin’s format. The logged statuses are
ok (user is logged in), server-denied (database server denied user
login), allow-denied (user denied by allow/deny rules), root-denied
(root is denied in configuration), empty-denied (empty password is
denied) and no-activity (automatically logged out due to inactivity).
You can then use any log analyzing tools, such as fail2ban, to detect possible
break-in attempts.
phpMyAdmin’s userID and userStatus Apache environment variables do not
exist in BetterMyAdmin, which does not run in Apache.
8.3 Why are there path disclosures when directly loading certain files?
This is a PHP configuration problem (display_errors) that does not apply to
BetterMyAdmin: it does not run on PHP, and its error messages to the browser
never include stack traces or file paths (the details go to the server’s error
output).
8.4 CSV files exported from BetterMyAdmin could allow a formula injection attack.
It is possible to generate a CSV file that, when imported to a spreadsheet program such as Microsoft Excel, could potentially allow the execution of arbitrary commands.
The CSV files generated by phpMyAdmin could potentially contain text that would be interpreted by a spreadsheet program as a formula, but the phpMyAdmin team does not believe escaping those fields is the proper behavior. There is no means to properly escape and differentiate between a desired text output and a formula that should be escaped, and CSV is a text format where function definitions should not be interpreted anyway. They feel it is the responsibility of the spreadsheet program to properly parse and sanitize such data on input instead.
Google also has a similar view.
BetterMyAdmin produces the same files by default, and offers an option for
those who prefer escaping: with
$cfg['Export']['csv_escape_formulas'], cells starting with
=, +, - or @ are escaped in CSV and CSV for MS Excel exports.