diff options
| author | Charles <sircharlesaze@gmail.com> | 2020-01-09 10:55:03 +0100 |
|---|---|---|
| committer | Charles <sircharlesaze@gmail.com> | 2020-01-09 13:09:38 +0100 |
| commit | 04d6d5ca99ebfd1cebb8ce06618fb3811fc1a8aa (patch) | |
| tree | 5c691241355c943a3c68ddb06b8cf8c60aa11319 /srcs/phpmyadmin/doc/html/faq.html | |
| parent | 7e0d85db834d6351ed85d01e5126ac31dc510b86 (diff) | |
| download | ft_server-04d6d5ca99ebfd1cebb8ce06618fb3811fc1a8aa.tar.gz ft_server-04d6d5ca99ebfd1cebb8ce06618fb3811fc1a8aa.tar.bz2 ft_server-04d6d5ca99ebfd1cebb8ce06618fb3811fc1a8aa.zip | |
phpmyadmin working
Diffstat (limited to 'srcs/phpmyadmin/doc/html/faq.html')
| -rw-r--r-- | srcs/phpmyadmin/doc/html/faq.html | 2045 |
1 files changed, 2045 insertions, 0 deletions
diff --git a/srcs/phpmyadmin/doc/html/faq.html b/srcs/phpmyadmin/doc/html/faq.html new file mode 100644 index 0000000..6e4fbd7 --- /dev/null +++ b/srcs/phpmyadmin/doc/html/faq.html @@ -0,0 +1,2045 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> + + +<html xmlns="http://www.w3.org/1999/xhtml"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + <title>FAQ - Frequently Asked Questions — phpMyAdmin 5.0.1 documentation</title> + + <link rel="stylesheet" href="_static/classic.css" type="text/css" /> + <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> + + <script type="text/javascript"> + var DOCUMENTATION_OPTIONS = { + URL_ROOT: './', + VERSION: '5.0.1', + COLLAPSE_INDEX: false, + FILE_SUFFIX: '.html', + HAS_SOURCE: true + }; + </script> + <script type="text/javascript" src="_static/jquery.js"></script> + <script type="text/javascript" src="_static/underscore.js"></script> + <script type="text/javascript" src="_static/doctools.js"></script> + <link rel="index" title="Index" href="genindex.html" /> + <link rel="search" title="Search" href="search.html" /> + <link rel="copyright" title="Copyright" href="copyright.html" /> + <link rel="top" title="phpMyAdmin 5.0.1 documentation" href="index.html" /> + <link rel="next" title="Developers Information" href="developers.html" /> + <link rel="prev" title="Other sources of information" href="other.html" /> + </head> + <body role="document"> + <div class="related" role="navigation" aria-label="related navigation"> + <h3>Navigation</h3> + <ul> + <li class="right" style="margin-right: 10px"> + <a href="genindex.html" title="General Index" + accesskey="I">index</a></li> + <li class="right" > + <a href="developers.html" title="Developers Information" + accesskey="N">next</a> |</li> + <li class="right" > + <a href="other.html" title="Other sources of information" + accesskey="P">previous</a> |</li> + <li class="nav-item nav-item-0"><a href="index.html">phpMyAdmin 5.0.1 documentation</a> »</li> + </ul> + </div> + + <div class="document"> + <div class="documentwrapper"> + <div class="bodywrapper"> + <div class="body" role="main"> + + <div class="section" id="faq-frequently-asked-questions"> +<span id="faq"></span><h1>FAQ - Frequently Asked Questions<a class="headerlink" href="#faq-frequently-asked-questions" title="Permalink to this headline">¶</a></h1> +<p>Please have a look at our <a class="reference external" href="https://www.phpmyadmin.net/docs/">Link section</a> on the official +phpMyAdmin homepage for in-depth coverage of phpMyAdmin’s features and +or interface.</p> +<div class="section" id="server"> +<span id="faqserver"></span><h2>Server<a class="headerlink" href="#server" title="Permalink to this headline">¶</a></h2> +<div class="section" id="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"> +<span id="faq1-1"></span><h3>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?<a class="headerlink" href="#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" title="Permalink to this headline">¶</a></h3> +<p>Try to set the <span class="target" id="index-0"></span><a class="reference internal" href="config.html#cfg_OBGzip"><code class="xref config config-option docutils literal"><span class="pre">$cfg['OBGzip']</span></code></a> directive to <code class="docutils literal"><span class="pre">false</span></code> in your +<code class="file docutils literal"><span class="pre">config.inc.php</span></code> file and the <code class="docutils literal"><span class="pre">zlib.output_compression</span></code> directive to +<code class="docutils literal"><span class="pre">Off</span></code> in your php configuration file.</p> +</div> +<div class="section" id="my-apache-server-crashes-when-using-phpmyadmin"> +<span id="faq1-2"></span><h3>1.2 My Apache server crashes when using phpMyAdmin.<a class="headerlink" href="#my-apache-server-crashes-when-using-phpmyadmin" title="Permalink to this headline">¶</a></h3> +<p>You should first try the latest versions of Apache (and possibly MySQL). If +your server keeps crashing, please ask for help in the various Apache support +groups.</p> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><a class="reference internal" href="#faq1-1"><span class="std std-ref">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?</span></a></p> +</div> +</div> +<div class="section" id="withdrawn"> +<span id="faq1-3"></span><h3>1.3 (withdrawn).<a class="headerlink" href="#withdrawn" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="using-phpmyadmin-on-iis-i-m-displayed-the-error-message-the-specified-cgi-application-misbehaved-by-not-returning-a-complete-set-of-http-headers"> +<span id="faq1-4"></span><h3>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 ...”.<a class="headerlink" href="#using-phpmyadmin-on-iis-i-m-displayed-the-error-message-the-specified-cgi-application-misbehaved-by-not-returning-a-complete-set-of-http-headers" title="Permalink to this headline">¶</a></h3> +<p>You just forgot to read the <em>install.txt</em> file from the PHP +distribution. Have a look at the last message in this <a class="reference external" href="https://bugs.php.net/bug.php?id=12061">PHP bug report #12061</a> from the official PHP bug +database.</p> +</div> +<div class="section" id="using-phpmyadmin-on-iis-i-m-facing-crashes-and-or-many-error-messages-with-the-http"> +<span id="faq1-5"></span><h3>1.5 Using phpMyAdmin on IIS, I’m facing crashes and/or many error messages with the HTTP.<a class="headerlink" href="#using-phpmyadmin-on-iis-i-m-facing-crashes-and-or-many-error-messages-with-the-http" title="Permalink to this headline">¶</a></h3> +<p>This is a known problem with the PHP <a class="reference internal" href="glossary.html#term-isapi"><span class="xref std std-term">ISAPI</span></a> filter: it’s not so stable. +Please use instead the cookie authentication mode.</p> +</div> +<div class="section" id="i-can-t-use-phpmyadmin-on-pws-nothing-is-displayed"> +<span id="faq1-6"></span><h3>1.6 I can’t use phpMyAdmin on PWS: nothing is displayed!<a class="headerlink" href="#i-can-t-use-phpmyadmin-on-pws-nothing-is-displayed" title="Permalink to this headline">¶</a></h3> +<p>This seems to be a PWS bug. Filippo Simoncini found a workaround (at +this time there is no better fix): remove or comment the <code class="docutils literal"><span class="pre">DOCTYPE</span></code> +declarations (2 lines) from the scripts <code class="file docutils literal"><span class="pre">libraries/Header.class.php</span></code> +and <code class="file docutils literal"><span class="pre">index.php</span></code>.</p> +</div> +<div class="section" id="how-can-i-gzip-a-dump-or-a-csv-export-it-does-not-seem-to-work"> +<span id="faq1-7"></span><h3>1.7 How can I gzip a dump or a CSV export? It does not seem to work.<a class="headerlink" href="#how-can-i-gzip-a-dump-or-a-csv-export-it-does-not-seem-to-work" title="Permalink to this headline">¶</a></h3> +<p>This feature is based on the <code class="docutils literal"><span class="pre">gzencode()</span></code> +PHP function to be more independent of the platform (Unix/Windows, +Safe Mode or not, and so on). So, you must have Zlib support +(<code class="docutils literal"><span class="pre">--with-zlib</span></code>).</p> +</div> +<div class="section" id="i-cannot-insert-a-text-file-in-a-table-and-i-get-an-error-about-safe-mode-being-in-effect"> +<span id="faq1-8"></span><h3>1.8 I cannot insert a text file in a table, and I get an error about safe mode being in effect.<a class="headerlink" href="#i-cannot-insert-a-text-file-in-a-table-and-i-get-an-error-about-safe-mode-being-in-effect" title="Permalink to this headline">¶</a></h3> +<p>Your uploaded file is saved by PHP in the “upload dir”, as defined in +<code class="file docutils literal"><span class="pre">php.ini</span></code> by the variable <code class="docutils literal"><span class="pre">upload_tmp_dir</span></code> (usually the system +default is <em>/tmp</em>). We recommend the following setup for Apache +servers running in safe mode, to enable uploads of files while being +reasonably secure:</p> +<ul class="simple"> +<li>create a separate directory for uploads: <strong class="command">mkdir /tmp/php</strong></li> +<li>give ownership to the Apache server’s user.group: <strong class="command">chown +apache.apache /tmp/php</strong></li> +<li>give proper permission: <strong class="command">chmod 600 /tmp/php</strong></li> +<li>put <code class="docutils literal"><span class="pre">upload_tmp_dir</span> <span class="pre">=</span> <span class="pre">/tmp/php</span></code> in <code class="file docutils literal"><span class="pre">php.ini</span></code></li> +<li>restart Apache</li> +</ul> +</div> +<div class="section" id="faq1-9"> +<span id="id1"></span><h3>1.9 (withdrawn).<a class="headerlink" href="#faq1-9" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="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"> +<span id="faq1-10"></span><h3>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.<a class="headerlink" href="#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" title="Permalink to this headline">¶</a></h3> +<p>As suggested by “Rob M” in the phpWizard forum, add this line to your +<em>httpd.conf</em>:</p> +<div class="highlight-apache"><div class="highlight"><pre><span></span><span class="nb">SetEnvIf</span> <span class="k">User</span>-Agent <span class="s2">".*MSIE.*"</span> nokeepalive ssl-unclean-shutdown +</pre></div> +</div> +<p>It seems to clear up many problems between Internet Explorer and SSL.</p> +</div> +<div class="section" id="i-get-an-open-basedir-restriction-while-uploading-a-file-from-the-import-tab"> +<span id="faq1-11"></span><h3>1.11 I get an ‘open_basedir restriction’ while uploading a file from the import tab.<a class="headerlink" href="#i-get-an-open-basedir-restriction-while-uploading-a-file-from-the-import-tab" title="Permalink to this headline">¶</a></h3> +<p>Since version 2.2.4, phpMyAdmin supports servers with open_basedir +restrictions. However you need to create temporary directory and configure it +as <span class="target" id="index-1"></span><a class="reference internal" href="config.html#cfg_TempDir"><code class="xref config config-option docutils literal"><span class="pre">$cfg['TempDir']</span></code></a>. The uploaded files will be moved there, +and after execution of your <a class="reference internal" href="glossary.html#term-sql"><span class="xref std std-term">SQL</span></a> commands, removed.</p> +</div> +<div class="section" id="i-have-lost-my-mysql-root-password-what-can-i-do"> +<span id="faq1-12"></span><h3>1.12 I have lost my MySQL root password, what can I do?<a class="headerlink" href="#i-have-lost-my-mysql-root-password-what-can-i-do" title="Permalink to this headline">¶</a></h3> +<p>phpMyAdmin does authenticate against MySQL server you’re using, so to recover +from phpMyAdmin password loss, you need to recover at MySQL level.</p> +<p>The MySQL manual explains how to <a class="reference external" href="https://dev.mysql.com/doc/refman/5.7/en/resetting-permissions.html">reset the permissions</a>.</p> +<p>If you are using MySQL server installed by your hosting provider, please +contact their support to recover the password for you.</p> +</div> +<div class="section" id="faq1-13"> +<span id="id2"></span><h3>1.13 (withdrawn).<a class="headerlink" href="#faq1-13" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="faq1-14"> +<span id="id3"></span><h3>1.14 (withdrawn).<a class="headerlink" href="#faq1-14" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="i-have-problems-with-mysql-user-column-names"> +<span id="faq1-15"></span><h3>1.15 I have problems with <em>mysql.user</em> column names.<a class="headerlink" href="#i-have-problems-with-mysql-user-column-names" title="Permalink to this headline">¶</a></h3> +<p>In previous MySQL versions, the <code class="docutils literal"><span class="pre">User</span></code> and <code class="docutils literal"><span class="pre">Password</span></code> columns were +named <code class="docutils literal"><span class="pre">user</span></code> and <code class="docutils literal"><span class="pre">password</span></code>. Please modify your column names to +align with current standards.</p> +</div> +<div class="section" id="i-cannot-upload-big-dump-files-memory-http-or-timeout-problems"> +<span id="faq1-16"></span><h3>1.16 I cannot upload big dump files (memory, HTTP or timeout problems).<a class="headerlink" href="#i-cannot-upload-big-dump-files-memory-http-or-timeout-problems" title="Permalink to this headline">¶</a></h3> +<p>Starting with version 2.7.0, the import engine has been re–written and +these problems should not occur. If possible, upgrade your phpMyAdmin +to the latest version to take advantage of the new import features.</p> +<p>The first things to check (or ask your host provider to check) are the values +of <code class="docutils literal"><span class="pre">max_execution_time</span></code>, <code class="docutils literal"><span class="pre">upload_max_filesize</span></code>, <code class="docutils literal"><span class="pre">memory_limit</span></code> and +<code class="docutils literal"><span class="pre">post_max_size</span></code> in the <code class="file docutils literal"><span class="pre">php.ini</span></code> configuration file. All of these +settings limit the maximum size of data that can be submitted and handled by +PHP. Please note that <code class="docutils literal"><span class="pre">post_max_size</span></code> needs to be larger than +<code class="docutils literal"><span class="pre">upload_max_filesize</span></code>. There exist several workarounds if your upload is too +big or your hosting provider is unwilling to change the settings:</p> +<ul> +<li><p class="first">Look at the <span class="target" id="index-2"></span><a class="reference internal" href="config.html#cfg_UploadDir"><code class="xref config config-option docutils literal"><span class="pre">$cfg['UploadDir']</span></code></a> feature. This allows one to upload a file to the server +via scp, FTP, or your favorite file transfer method. PhpMyAdmin is +then able to import the files from the temporary directory. More +information is available in the <a class="reference internal" href="config.html#config"><span class="std std-ref">Configuration</span></a> of this document.</p> +</li> +<li><p class="first">Using a utility (such as <a class="reference external" href="https://www.ozerov.de/bigdump/">BigDump</a>) to split the files before +uploading. We cannot support this or any third party applications, but +are aware of users having success with it.</p> +</li> +<li><p class="first">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:</p> +<div class="highlight-mysql"><div class="highlight"><pre><span></span><span class="n">source</span> <span class="n">filename</span><span class="p">.</span><span class="k">sql</span><span class="p">;</span> +</pre></div> +</div> +</li> +</ul> +</div> +<div class="section" id="which-database-versions-does-phpmyadmin-support"> +<span id="faq1-17"></span><h3>1.17 Which Database versions does phpMyAdmin support?<a class="headerlink" href="#which-database-versions-does-phpmyadmin-support" title="Permalink to this headline">¶</a></h3> +<p>For <a class="reference external" href="https://www.mysql.com/">MySQL</a>, versions 5.5 and newer are supported. +For older MySQL versions, our <a class="reference external" href="https://www.phpmyadmin.net/downloads/">Downloads</a> page offers older phpMyAdmin versions +(which may have become unsupported).</p> +<p>For <a class="reference external" href="https://mariadb.org/">MariaDB</a>, versions 5.5 and newer are supported.</p> +</div> +<div class="section" id="a-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"> +<span id="faq1-17a"></span><h3>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”<a class="headerlink" href="#a-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" title="Permalink to this headline">¶</a></h3> +<p>You tried to access MySQL with an old MySQL client library. The +version of your MySQL client library can be checked in your phpinfo() +output. In general, it should have at least the same minor version as +your server - as mentioned in <a class="reference internal" href="#faq1-17"><span class="std std-ref">1.17 Which Database versions does phpMyAdmin support?</span></a>. This problem is +generally caused by using MySQL version 4.1 or newer. MySQL changed +the authentication hash and your PHP is trying to use the old method. +The proper solution is to use the <a class="reference external" href="https://www.php.net/mysqli">mysqli extension</a> with the proper client library to match +your MySQL installation. More +information (and several workarounds) are located in the <a class="reference external" href="https://dev.mysql.com/doc/refman/5.7/en/common-errors.html">MySQL +Documentation</a>.</p> +</div> +<div class="section" id="faq1-18"> +<span id="id4"></span><h3>1.18 (withdrawn).<a class="headerlink" href="#faq1-18" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="i-can-t-run-the-display-relations-feature-because-the-script-seems-not-to-know-the-font-face-i-m-using"> +<span id="faq1-19"></span><h3>1.19 I can’t run the “display relations” feature because the script seems not to know the font face I’m using!<a class="headerlink" href="#i-can-t-run-the-display-relations-feature-because-the-script-seems-not-to-know-the-font-face-i-m-using" title="Permalink to this headline">¶</a></h3> +<p>The <a class="reference internal" href="glossary.html#term-tcpdf"><span class="xref std std-term">TCPDF</span></a> library we’re using for this feature requires some special +files to use font faces. Please refers to the <a class="reference external" href="https://tcpdf.org/">TCPDF manual</a> to build these files.</p> +</div> +<div class="section" id="i-receive-an-error-about-missing-mysqli-and-mysql-extensions"> +<span id="faqmysql"></span><h3>1.20 I receive an error about missing mysqli and mysql extensions.<a class="headerlink" href="#i-receive-an-error-about-missing-mysqli-and-mysql-extensions" title="Permalink to this headline">¶</a></h3> +<p>To connect to a MySQL server, PHP needs a set of MySQL functions +called “MySQL extension”. This extension may be part of the PHP +distribution (compiled-in), otherwise it needs to be loaded +dynamically. Its name is probably <em>mysqli.so</em> or <em>php_mysqli.dll</em>. +phpMyAdmin tried to load the extension but failed. Usually, the +problem is solved by installing a software package called “PHP-MySQL” +or something similar.</p> +<p>There are currently two interfaces PHP provides as MySQL extensions - <code class="docutils literal"><span class="pre">mysql</span></code> +and <code class="docutils literal"><span class="pre">mysqli</span></code>. The <code class="docutils literal"><span class="pre">mysqli</span></code> is tried first, because it’s the best one.</p> +<p>This problem can be also caused by wrong paths in the <code class="file docutils literal"><span class="pre">php.ini</span></code> or using +wrong <code class="file docutils literal"><span class="pre">php.ini</span></code>.</p> +<p>Make sure that the extension files do exist in the folder which the +<code class="docutils literal"><span class="pre">extension_dir</span></code> points to and that the corresponding lines in your +<code class="file docutils literal"><span class="pre">php.ini</span></code> are not commented out (you can use <code class="docutils literal"><span class="pre">phpinfo()</span></code> to check +current setup):</p> +<div class="highlight-ini"><div class="highlight"><pre><span></span><span class="k">[PHP]</span> + +<span class="c1">; Directory in which the loadable extensions (modules) reside.</span> +<span class="na">extension_dir</span> <span class="o">=</span> <span class="s">"C:/Apache2/modules/php/ext"</span> +</pre></div> +</div> +<p>The <code class="file docutils literal"><span class="pre">php.ini</span></code> can be loaded from several locations (especially on +Windows), so please check you’re updating the correct one. If using Apache, you +can tell it to use specific path for this file using <code class="docutils literal"><span class="pre">PHPIniDir</span></code> directive:</p> +<div class="highlight-apache"><div class="highlight"><pre><span></span><span class="nb">LoadFile</span> <span class="s2">"C:/php/php5ts.dll"</span> +<span class="nb">LoadModule</span> php5_module <span class="s2">"C:/php/php5apache2_2.dll"</span> +<span class="nt"><IfModule</span> <span class="s">php5_module</span><span class="nt">></span> + <span class="nb">PHPIniDir</span> <span class="s2">"C:/PHP"</span> + <span class="nt"><Location></span> + <span class="nb">AddType</span> text/html .php + <span class="nb">AddHandler</span> application/x-httpd-php .php + <span class="nt"></Location></span> +<span class="nt"></IfModule></span> +</pre></div> +</div> +<p>In some rare cases this problem can be also caused by other extensions loaded +in PHP which prevent MySQL extensions to be loaded. If anything else fails, you +can try commenting out extensions for other databses from <code class="file docutils literal"><span class="pre">php.ini</span></code>.</p> +</div> +<div class="section" id="i-am-running-the-cgi-version-of-php-under-unix-and-i-cannot-log-in-using-cookie-auth"> +<span id="faq1-21"></span><h3>1.21 I am running the CGI version of PHP under Unix, and I cannot log in using cookie auth.<a class="headerlink" href="#i-am-running-the-cgi-version-of-php-under-unix-and-i-cannot-log-in-using-cookie-auth" title="Permalink to this headline">¶</a></h3> +<p>In <code class="file docutils literal"><span class="pre">php.ini</span></code>, set <code class="docutils literal"><span class="pre">mysql.max_links</span></code> higher than 1.</p> +</div> +<div class="section" id="i-don-t-see-the-location-of-text-file-field-so-i-cannot-upload"> +<span id="faq1-22"></span><h3>1.22 I don’t see the “Location of text file” field, so I cannot upload.<a class="headerlink" href="#i-don-t-see-the-location-of-text-file-field-so-i-cannot-upload" title="Permalink to this headline">¶</a></h3> +<p>This is most likely because in <code class="file docutils literal"><span class="pre">php.ini</span></code>, your <code class="docutils literal"><span class="pre">file_uploads</span></code> +parameter is not set to “on”.</p> +</div> +<div class="section" id="i-m-running-mysql-on-a-win32-machine-each-time-i-create-a-new-table-the-table-and-column-names-are-changed-to-lowercase"> +<span id="faq1-23"></span><h3>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!<a class="headerlink" href="#i-m-running-mysql-on-a-win32-machine-each-time-i-create-a-new-table-the-table-and-column-names-are-changed-to-lowercase" title="Permalink to this headline">¶</a></h3> +<p>This happens because the MySQL directive <code class="docutils literal"><span class="pre">lower_case_table_names</span></code> +defaults to 1 (<code class="docutils literal"><span class="pre">ON</span></code>) in the Win32 version of MySQL. You can change +this behavior by simply changing the directive to 0 (<code class="docutils literal"><span class="pre">OFF</span></code>): Just +edit your <code class="docutils literal"><span class="pre">my.ini</span></code> file that should be located in your Windows +directory and add the following line to the group [mysqld]:</p> +<div class="highlight-ini"><div class="highlight"><pre><span></span><span class="na">set-variable</span> <span class="o">=</span> <span class="s">lower_case_table_names=0</span> +</pre></div> +</div> +<div class="admonition note"> +<p class="first admonition-title">Note</p> +<p class="last">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.</p> +</div> +<p>Next, save the file and restart the MySQL service. You can always +check the value of this directive using the query</p> +<div class="highlight-mysql"><div class="highlight"><pre><span></span><span class="k">SHOW</span> <span class="n">VARIABLES</span> <span class="k">LIKE</span> <span class="s1">'lower_case_table_names'</span><span class="p">;</span> +</pre></div> +</div> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><a class="reference external" href="https://dev.mysql.com/doc/refman/5.7/en/identifier-case-sensitivity.html">Identifier Case Sensitivity in the MySQL Reference Manual</a></p> +</div> +</div> +<div class="section" id="faq1-24"> +<span id="id5"></span><h3>1.24 (withdrawn).<a class="headerlink" href="#faq1-24" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="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"> +<span id="faq1-25"></span><h3>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.<a class="headerlink" href="#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" title="Permalink to this headline">¶</a></h3> +<p>A tip from Jose Fandos: put a comment on the following two lines in +httpd.conf, like this:</p> +<div class="highlight-apache"><div class="highlight"><pre><span></span><span class="c"># mod_gzip_item_include file \.php$</span> +<span class="c"># mod_gzip_item_include mime "application/x-httpd-php.*"</span> +</pre></div> +</div> +<p>as this version of mod_gzip on Apache (Windows) has problems handling +PHP scripts. Of course you have to restart Apache.</p> +</div> +<div class="section" id="i-just-installed-phpmyadmin-in-my-document-root-of-iis-but-i-get-the-error-no-input-file-specified-when-trying-to-run-phpmyadmin"> +<span id="faq1-26"></span><h3>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.<a class="headerlink" href="#i-just-installed-phpmyadmin-in-my-document-root-of-iis-but-i-get-the-error-no-input-file-specified-when-trying-to-run-phpmyadmin" title="Permalink to this headline">¶</a></h3> +<p>This is a permission problem. Right-click on the phpmyadmin folder and +choose properties. Under the tab Security, click on “Add” and select +the user “IUSR_machine” from the list. Now set his permissions and it +should work.</p> +</div> +<div class="section" id="i-get-empty-page-when-i-want-to-view-huge-page-eg-db-structure-php-with-plenty-of-tables"> +<span id="faq1-27"></span><h3>1.27 I get empty page when I want to view huge page (eg. db_structure.php with plenty of tables).<a class="headerlink" href="#i-get-empty-page-when-i-want-to-view-huge-page-eg-db-structure-php-with-plenty-of-tables" title="Permalink to this headline">¶</a></h3> +<p>This was caused by a <a class="reference external" href="https://bugs.php.net/bug.php?id=21079">PHP bug</a> that occur when +GZIP output buffering is enabled. If you turn off it (by +<span class="target" id="index-3"></span><a class="reference internal" href="config.html#cfg_OBGzip"><code class="xref config config-option docutils literal"><span class="pre">$cfg['OBGzip']</span></code></a> in <code class="file docutils literal"><span class="pre">config.inc.php</span></code>), it should work. +This bug will has been fixed in PHP 5.0.0.</p> +</div> +<div class="section" id="my-mysql-server-sometimes-refuses-queries-and-returns-the-message-errorcode-13-what-does-this-mean"> +<span id="faq1-28"></span><h3>1.28 My MySQL server sometimes refuses queries and returns the message ‘Errorcode: 13’. What does this mean?<a class="headerlink" href="#my-mysql-server-sometimes-refuses-queries-and-returns-the-message-errorcode-13-what-does-this-mean" title="Permalink to this headline">¶</a></h3> +<p>This can happen due to a MySQL bug when having database / table names +with upper case characters although <code class="docutils literal"><span class="pre">lower_case_table_names</span></code> 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.</p> +</div> +<div class="section" id="when-i-create-a-table-or-modify-a-column-i-get-an-error-and-the-columns-are-duplicated"> +<span id="faq1-29"></span><h3>1.29 When I create a table or modify a column, I get an error and the columns are duplicated.<a class="headerlink" href="#when-i-create-a-table-or-modify-a-column-i-get-an-error-and-the-columns-are-duplicated" title="Permalink to this headline">¶</a></h3> +<p>It is possible to configure Apache in such a way that PHP has problems +interpreting .php files.</p> +<p>The problems occur when two different (and conflicting) set of +directives are used:</p> +<div class="highlight-apache"><div class="highlight"><pre><span></span><span class="nb">SetOutputFilter</span> PHP +<span class="nb">SetInputFilter</span> PHP +</pre></div> +</div> +<p>and</p> +<div class="highlight-apache"><div class="highlight"><pre><span></span><span class="nb">AddType</span> application/x-httpd-php .php +</pre></div> +</div> +<p>In the case we saw, one set of directives was in +<code class="docutils literal"><span class="pre">/etc/httpd/conf/httpd.conf</span></code>, while the other set was in +<code class="docutils literal"><span class="pre">/etc/httpd/conf/addon-modules/php.conf</span></code>. The recommended way is +with <code class="docutils literal"><span class="pre">AddType</span></code>, so just comment out the first set of lines and +restart Apache:</p> +<div class="highlight-apache"><div class="highlight"><pre><span></span><span class="c">#SetOutputFilter PHP</span> +<span class="c">#SetInputFilter PHP</span> +</pre></div> +</div> +</div> +<div class="section" id="i-get-the-error-navigation-php-missing-hash"> +<span id="faq1-30"></span><h3>1.30 I get the error “navigation.php: Missing hash”.<a class="headerlink" href="#i-get-the-error-navigation-php-missing-hash" title="Permalink to this headline">¶</a></h3> +<p>This problem is known to happen when the server is running Turck +MMCache but upgrading MMCache to version 2.3.21 solves the problem.</p> +</div> +<div class="section" id="which-php-versions-does-phpmyadmin-support"> +<span id="faq1-31"></span><h3>1.31 Which PHP versions does phpMyAdmin support?<a class="headerlink" href="#which-php-versions-does-phpmyadmin-support" title="Permalink to this headline">¶</a></h3> +<p>Since release 4.5, phpMyAdmin supports only PHP 5.5 and newer. Since release +4.1 phpMyAdmin supports only PHP 5.3 and newer. For PHP 5.2 you can use 4.0.x +releases.</p> +<p>PHP 7 is supported since phpMyAdmin 4.6, PHP 7.1 is supported since 4.6.5, +PHP 7.2 is supported since 4.7.4.</p> +<p>HHVM is supported up to phpMyAdmin 4.8.</p> +<p>Since release 5.0, phpMyAdmin supports only PHP 7.1 and newer.</p> +</div> +<div class="section" id="can-i-use-http-authentication-with-iis"> +<span id="faq1-32"></span><h3>1.32 Can I use HTTP authentication with IIS?<a class="headerlink" href="#can-i-use-http-authentication-with-iis" title="Permalink to this headline">¶</a></h3> +<p>Yes. This procedure was tested with phpMyAdmin 2.6.1, PHP 4.3.9 in +<a class="reference internal" href="glossary.html#term-isapi"><span class="xref std std-term">ISAPI</span></a> mode under <a class="reference internal" href="glossary.html#term-iis"><span class="xref std std-term">IIS</span></a> 5.1.</p> +<ol class="arabic simple"> +<li>In your <code class="file docutils literal"><span class="pre">php.ini</span></code> file, set <code class="docutils literal"><span class="pre">cgi.rfc2616_headers</span> <span class="pre">=</span> <span class="pre">0</span></code></li> +<li>In <code class="docutils literal"><span class="pre">Web</span> <span class="pre">Site</span> <span class="pre">Properties</span> <span class="pre">-></span> <span class="pre">File/Directory</span> <span class="pre">Security</span> <span class="pre">-></span> <span class="pre">Anonymous</span> +<span class="pre">Access</span></code> dialog box, check the <code class="docutils literal"><span class="pre">Anonymous</span> <span class="pre">access</span></code> checkbox and +uncheck any other checkboxes (i.e. uncheck <code class="docutils literal"><span class="pre">Basic</span> <span class="pre">authentication</span></code>, +<code class="docutils literal"><span class="pre">Integrated</span> <span class="pre">Windows</span> <span class="pre">authentication</span></code>, and <code class="docutils literal"><span class="pre">Digest</span></code> if it’s +enabled.) Click <code class="docutils literal"><span class="pre">OK</span></code>.</li> +<li>In <code class="docutils literal"><span class="pre">Custom</span> <span class="pre">Errors</span></code>, select the range of <code class="docutils literal"><span class="pre">401;1</span></code> through <code class="docutils literal"><span class="pre">401;5</span></code> +and click the <code class="docutils literal"><span class="pre">Set</span> <span class="pre">to</span> <span class="pre">Default</span></code> button.</li> +</ol> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><span class="target" id="index-4"></span><a class="rfc reference external" href="https://tools.ietf.org/html/rfc2616.html"><strong>RFC 2616</strong></a></p> +</div> +</div> +<div class="section" id="faq1-33"> +<span id="id6"></span><h3>1.33 (withdrawn).<a class="headerlink" href="#faq1-33" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="can-i-directly-access-a-database-or-table-pages"> +<span id="faq1-34"></span><h3>1.34 Can I directly access a database or table pages?<a class="headerlink" href="#can-i-directly-access-a-database-or-table-pages" title="Permalink to this headline">¶</a></h3> +<p>Yes. Out of the box, you can use a <a class="reference internal" href="glossary.html#term-url"><span class="xref std std-term">URL</span></a> like +<code class="docutils literal"><span class="pre">http://server/phpMyAdmin/index.php?server=X&db=database&table=table&target=script</span></code>. +For <code class="docutils literal"><span class="pre">server</span></code> you can use the server number +which refers to the numeric host index (from <code class="docutils literal"><span class="pre">$i</span></code>) in +<code class="file docutils literal"><span class="pre">config.inc.php</span></code>. The table and script parts are optional.</p> +<p>If you want a URL like +<code class="docutils literal"><span class="pre">http://server/phpMyAdmin/database[/table][/script]</span></code>, you need to do some additional configuration. The following +lines apply only for the <a class="reference external" href="https://httpd.apache.org">Apache</a> web server. +First, make sure that you have enabled some features within the Apache global +configuration. You need <code class="docutils literal"><span class="pre">Options</span> <span class="pre">SymLinksIfOwnerMatch</span></code> and <code class="docutils literal"><span class="pre">AllowOverride</span> +<span class="pre">FileInfo</span></code> enabled for directory where phpMyAdmin is installed and you +need mod_rewrite to be enabled. Then you just need to create the +following <a class="reference internal" href="glossary.html#term-htaccess"><span class="xref std std-term">.htaccess</span></a> file in root folder of phpMyAdmin installation (don’t +forget to change directory name inside of it):</p> +<div class="highlight-apache"><div class="highlight"><pre><span></span><span class="nb">RewriteEngine</span> <span class="k">On</span> +<span class="nb">RewriteBase</span> <span class="sx">/path_to_phpMyAdmin</span> +<span class="nb">RewriteRule</span> ^([a-zA-Z0-9_]+)/([a-zA-Z0-9_]+)/([a-z_]+\.php)$ index.php?db=$1&table=$2&target=$3 [R] +<span class="nb">RewriteRule</span> ^([a-zA-Z0-9_]+)/([a-z_]+\.php)$ index.php?db=$1&target=$2 [R] +<span class="nb">RewriteRule</span> ^([a-zA-Z0-9_]+)/([a-zA-Z0-9_]+)$ index.php?db=$1&table=$2 [R] +<span class="nb">RewriteRule</span> ^([a-zA-Z0-9_]+)$ index.php?db=$1 [R] +</pre></div> +</div> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><a class="reference internal" href="#faq4-8"><span class="std std-ref">4.8 Which parameters can I use in the URL that starts phpMyAdmin?</span></a></p> +</div> +</div> +<div class="section" id="can-i-use-http-authentication-with-apache-cgi"> +<span id="faq1-35"></span><h3>1.35 Can I use HTTP authentication with Apache CGI?<a class="headerlink" href="#can-i-use-http-authentication-with-apache-cgi" title="Permalink to this headline">¶</a></h3> +<p>Yes. However you need to pass authentication variable to <a class="reference internal" href="glossary.html#term-cgi"><span class="xref std std-term">CGI</span></a> using +following rewrite rule:</p> +<div class="highlight-apache"><div class="highlight"><pre><span></span><span class="nb">RewriteEngine</span> <span class="k">On</span> +<span class="nb">RewriteRule</span> .* - [E=REMOTE_USER:%{HTTP:Authorization},L] +</pre></div> +</div> +</div> +<div class="section" id="i-get-an-error-500-internal-server-error"> +<span id="faq1-36"></span><h3>1.36 I get an error “500 Internal Server Error”.<a class="headerlink" href="#i-get-an-error-500-internal-server-error" title="Permalink to this headline">¶</a></h3> +<p>There can be many explanations to this and a look at your server’s +error log file might give a clue.</p> +</div> +<div class="section" id="i-run-phpmyadmin-on-cluster-of-different-machines-and-password-encryption-in-cookie-auth-doesn-t-work"> +<span id="faq1-37"></span><h3>1.37 I run phpMyAdmin on cluster of different machines and password encryption in cookie auth doesn’t work.<a class="headerlink" href="#i-run-phpmyadmin-on-cluster-of-different-machines-and-password-encryption-in-cookie-auth-doesn-t-work" title="Permalink to this headline">¶</a></h3> +<p>If your cluster consist of different architectures, PHP code used for +encryption/decryption won’t work correct. This is caused by use of +pack/unpack functions in code. Only solution is to use mcrypt +extension which works fine in this case.</p> +</div> +<div class="section" id="can-i-use-phpmyadmin-on-a-server-on-which-suhosin-is-enabled"> +<span id="faq1-38"></span><h3>1.38 Can I use phpMyAdmin on a server on which Suhosin is enabled?<a class="headerlink" href="#can-i-use-phpmyadmin-on-a-server-on-which-suhosin-is-enabled" title="Permalink to this headline">¶</a></h3> +<p>Yes but the default configuration values of Suhosin are known to cause +problems with some operations, for example editing a table with many +columns and no <a class="reference internal" href="glossary.html#term-primary-key"><span class="xref std std-term">primary key</span></a> or with textual <a class="reference internal" href="glossary.html#term-primary-key"><span class="xref std std-term">primary key</span></a>.</p> +<p>Suhosin configuration might lead to malfunction in some cases and it +can not be fully avoided as phpMyAdmin is kind of application which +needs to transfer big amounts of columns in single HTTP request, what +is something what Suhosin tries to prevent. Generally all +<code class="docutils literal"><span class="pre">suhosin.request.*</span></code>, <code class="docutils literal"><span class="pre">suhosin.post.*</span></code> and <code class="docutils literal"><span class="pre">suhosin.get.*</span></code> +directives can have negative effect on phpMyAdmin usability. You can +always find in your error logs which limit did cause dropping of +variable, so you can diagnose the problem and adjust matching +configuration variable.</p> +<p>The default values for most Suhosin configuration options will work in +most scenarios, however you might want to adjust at least following +parameters:</p> +<ul class="simple"> +<li><a class="reference external" href="https://suhosin.org/stories/configuration.html#suhosin-request-max-vars">suhosin.request.max_vars</a> should +be increased (eg. 2048)</li> +<li><a class="reference external" href="https://suhosin.org/stories/configuration.html#suhosin-post-max-vars">suhosin.post.max_vars</a> should be +increased (eg. 2048)</li> +<li><a class="reference external" href="https://suhosin.org/stories/configuration.html#suhosin-request-max-array-index-length">suhosin.request.max_array_index_length</a> +should be increased (eg. 256)</li> +<li><a class="reference external" href="https://suhosin.org/stories/configuration.html#suhosin-post-max-array-index-length">suhosin.post.max_array_index_length</a> +should be increased (eg. 256)</li> +<li><a class="reference external" href="https://suhosin.org/stories/configuration.html#suhosin-request-max-totalname-length">suhosin.request.max_totalname_length</a> +should be increased (eg. 8192)</li> +<li><a class="reference external" href="https://suhosin.org/stories/configuration.html#suhosin-post-max-totalname-length">suhosin.post.max_totalname_length</a> should be +increased (eg. 8192)</li> +<li><a class="reference external" href="https://suhosin.org/stories/configuration.html#suhosin-get-max-value-length">suhosin.get.max_value_length</a> +should be increased (eg. 1024)</li> +<li><a class="reference external" href="https://suhosin.org/stories/configuration.html#suhosin-sql-bailout-on-error">suhosin.sql.bailout_on_error</a> +needs to be disabled (the default)</li> +<li><a class="reference external" href="https://suhosin.org/stories/configuration.html#logging-configuration">suhosin.log.*</a> should not +include <a class="reference internal" href="glossary.html#term-sql"><span class="xref std std-term">SQL</span></a>, otherwise you get big +slowdown</li> +<li><a class="reference external" href="https://suhosin.org/stories/configuration.html#suhosin-sql-union">suhosin.sql.union</a> must be disabled (which is the default).</li> +<li><a class="reference external" href="https://suhosin.org/stories/configuration.html#suhosin-sql-multiselect">suhosin.sql.multiselect</a> must be disabled (which is the default).</li> +<li><a class="reference external" href="https://suhosin.org/stories/configuration.html#suhosin-sql-comment">suhosin.sql.comment</a> must be disabled (which is the default).</li> +</ul> +<p>To further improve security, we also recommend these modifications:</p> +<ul class="simple"> +<li><a class="reference external" href="https://suhosin.org/stories/configuration.html#suhosin-executor-include-max-traversal">suhosin.executor.include.max_traversal</a> should be +enabled as a mitigation against local file inclusion attacks. We suggest +setting this to 2 as <code class="docutils literal"><span class="pre">../</span></code> is used with the ReCaptcha library.</li> +<li><a class="reference external" href="https://suhosin.org/stories/configuration.html#suhosin-cookie-encrypt">suhosin.cookie.encrypt</a> should be enabled.</li> +<li><a class="reference external" href="https://suhosin.org/stories/configuration.html#suhosin-executor-disable-emodifier">suhosin.executor.disable_emodifier</a> should be enabled.</li> +</ul> +<p>You can also disable the warning using the <span class="target" id="index-5"></span><a class="reference internal" href="config.html#cfg_SuhosinDisableWarning"><code class="xref config config-option docutils literal"><span class="pre">$cfg['SuhosinDisableWarning']</span></code></a>.</p> +</div> +<div class="section" id="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"> +<span id="faq1-39"></span><h3>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?<a class="headerlink" href="#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" title="Permalink to this headline">¶</a></h3> +<p>This is caused by the fact that PHP scripts have no knowledge that the site is +using https. Depending on used webserver, you should configure it to let PHP +know about URL and scheme used to access it.</p> +<p>For example in Apache ensure that you have enabled <code class="docutils literal"><span class="pre">SSLOptions</span></code> and +<code class="docutils literal"><span class="pre">StdEnvVars</span></code> in the configuration.</p> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><<a class="reference external" href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html">https://httpd.apache.org/docs/2.4/mod/mod_ssl.html</a>></p> +</div> +</div> +<div class="section" id="when-accessing-phpmyadmin-via-an-apache-reverse-proxy-cookie-login-does-not-work"> +<span id="faq1-40"></span><h3>1.40 When accessing phpMyAdmin via an Apache reverse proxy, cookie login does not work.<a class="headerlink" href="#when-accessing-phpmyadmin-via-an-apache-reverse-proxy-cookie-login-does-not-work" title="Permalink to this headline">¶</a></h3> +<p>To be able to use cookie auth Apache must know that it has to rewrite +the set-cookie headers. Example from the Apache 2.2 documentation:</p> +<div class="highlight-apache"><div class="highlight"><pre><span></span><span class="nb">ProxyPass</span> <span class="sx">/mirror/foo/</span> http://backend.example.com/ +<span class="nb">ProxyPassReverse</span> <span class="sx">/mirror/foo/</span> http://backend.example.com/ +<span class="nb">ProxyPassReverseCookieDomain</span> backend.example.com public.example.com +<span class="nb">ProxyPassReverseCookiePath</span> / <span class="sx">/mirror/foo/</span> +</pre></div> +</div> +<p>Note: if the backend url looks like <code class="docutils literal"><span class="pre">http://server/~user/phpmyadmin</span></code>, the +tilde (~) must be url encoded as %7E in the ProxyPassReverse* lines. +This is not specific to phpmyadmin, it’s just the behavior of Apache.</p> +<div class="highlight-apache"><div class="highlight"><pre><span></span><span class="nb">ProxyPass</span> <span class="sx">/mirror/foo/</span> http://backend.example.com/~user/phpmyadmin +<span class="nb">ProxyPassReverse</span> <span class="sx">/mirror/foo/</span> http://backend.example.com/%7Euser/phpmyadmin +<span class="nb">ProxyPassReverseCookiePath</span> /%7Euser/phpmyadmin <span class="sx">/mirror/foo</span> +</pre></div> +</div> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><<a class="reference external" href="https://httpd.apache.org/docs/2.2/mod/mod_proxy.html">https://httpd.apache.org/docs/2.2/mod/mod_proxy.html</a>>, <span class="target" id="index-6"></span><a class="reference internal" href="config.html#cfg_PmaAbsoluteUri"><code class="xref config config-option docutils literal"><span class="pre">$cfg['PmaAbsoluteUri']</span></code></a></p> +</div> +</div> +<div class="section" id="when-i-view-a-database-and-ask-to-see-its-privileges-i-get-an-error-about-an-unknown-column"> +<span id="faq1-41"></span><h3>1.41 When I view a database and ask to see its privileges, I get an error about an unknown column.<a class="headerlink" href="#when-i-view-a-database-and-ask-to-see-its-privileges-i-get-an-error-about-an-unknown-column" title="Permalink to this headline">¶</a></h3> +<p>The MySQL server’s privilege tables are not up to date, you need to +run the <strong class="command">mysql_upgrade</strong> command on the server.</p> +</div> +<div class="section" id="how-can-i-prevent-robots-from-accessing-phpmyadmin"> +<span id="faq1-42"></span><h3>1.42 How can I prevent robots from accessing phpMyAdmin?<a class="headerlink" href="#how-can-i-prevent-robots-from-accessing-phpmyadmin" title="Permalink to this headline">¶</a></h3> +<p>You can add various rules to <a class="reference internal" href="glossary.html#term-htaccess"><span class="xref std std-term">.htaccess</span></a> to filter access based on user agent +field. This is quite easy to circumvent, but could prevent at least +some robots accessing your installation.</p> +<div class="highlight-apache"><div class="highlight"><pre><span></span><span class="nb">RewriteEngine</span> <span class="k">on</span> + +<span class="c"># Allow only GET and POST verbs</span> +<span class="nb">RewriteCond</span> %{REQUEST_METHOD} !^(GET|POST)$ [NC,OR] + +<span class="c"># Ban Typical Vulnerability Scanners and others</span> +<span class="c"># Kick out Script Kiddies</span> +<span class="nb">RewriteCond</span> %{HTTP_USER_AGENT} ^(java|curl|wget).* [NC,OR] +<span class="nb">RewriteCond</span> %{HTTP_USER_AGENT} ^.*(libwww-perl|curl|wget|python|nikto|wkito|pikto|scan|acunetix).* [NC,OR] +<span class="nb">RewriteCond</span> %{HTTP_USER_AGENT} ^.*(winhttp|HTTrack|clshttp|archiver|loader|email|harvest|extract|grab|miner).* [NC,OR] + +<span class="c"># Ban Search Engines, Crawlers to your administrative panel</span> +<span class="c"># No reasons to access from bots</span> +<span class="c"># Ultimately Better than the useless robots.txt</span> +<span class="c"># Did google respect robots.txt?</span> +<span class="c"># Try google: intitle:phpMyAdmin intext:"Welcome to phpMyAdmin *.*.*" intext:"Log in" -wiki -forum -forums -questions intext:"Cookies must be enabled"</span> +<span class="nb">RewriteCond</span> %{HTTP_USER_AGENT} ^.*(AdsBot-Google|ia_archiver|Scooter|Ask.Jeeves|Baiduspider|Exabot|FAST.Enterprise.Crawler|FAST-WebCrawler|www\.neomo\.de|Gigabot|Mediapartners-Google|Google.Desktop|Feedfetcher-Google|Googlebot|heise-IT-Markt-Crawler|heritrix|ibm.com\cs/crawler|ICCrawler|ichiro|MJ12bot|MetagerBot|msnbot-NewsBlogs|msnbot|msnbot-media|NG-Search|lucene.apache.org|NutchCVS|OmniExplorer_Bot|online.link.validator|psbot0|Seekbot|Sensis.Web.Crawler|SEO.search.Crawler|Seoma.\[SEO.Crawler\]|SEOsearch|Snappy|www.urltrends.com|www.tkl.iis.u-tokyo.ac.jp/~crawler|SynooBot|crawleradmin.t-info@telekom.de|TurnitinBot|voyager|W3.SiteSearch.Crawler|W3C-checklink|W3C_Validator|www.WISEnutbot.com|yacybot|Yahoo-MMCrawler|Yahoo\!.DE.Slurp|Yahoo\!.Slurp|YahooSeeker).* [NC] +<span class="nb">RewriteRule</span> .* - [F] +</pre></div> +</div> +</div> +<div class="section" id="why-can-t-i-display-the-structure-of-my-table-containing-hundreds-of-columns"> +<span id="faq1-43"></span><h3>1.43 Why can’t I display the structure of my table containing hundreds of columns?<a class="headerlink" href="#why-can-t-i-display-the-structure-of-my-table-containing-hundreds-of-columns" title="Permalink to this headline">¶</a></h3> +<p>Because your PHP’s <code class="docutils literal"><span class="pre">memory_limit</span></code> is too low; adjust it in <code class="file docutils literal"><span class="pre">php.ini</span></code>.</p> +</div> +<div class="section" id="how-can-i-reduce-the-installed-size-of-phpmyadmin-on-disk"> +<span id="faq1-44"></span><h3>1.44 How can I reduce the installed size of phpMyAdmin on disk?<a class="headerlink" href="#how-can-i-reduce-the-installed-size-of-phpmyadmin-on-disk" title="Permalink to this headline">¶</a></h3> +<p>Some users have requested to be able to reduce the size of the phpMyAdmin installation. +This is not recommended and could lead to confusion over missing features, but can be done. +A list of files and corresponding functionality which degrade gracefully when removed include:</p> +<ul class="simple"> +<li><code class="file docutils literal"><span class="pre">./vendor/tecnickcom/tcpdf</span></code> folder (exporting to PDF)</li> +<li><code class="file docutils literal"><span class="pre">./locale/</span></code> folder, or unused subfolders (interface translations)</li> +<li>Any unused themes in <code class="file docutils literal"><span class="pre">./themes/</span></code></li> +<li><code class="file docutils literal"><span class="pre">./js/vendor/jquery/src/</span></code> (included for licensing reasons)</li> +<li><code class="file docutils literal"><span class="pre">./js/line_counts.php</span></code> (removed in phpMyAdmin 4.8)</li> +<li><code class="file docutils literal"><span class="pre">./doc/</span></code> (documentation)</li> +<li><code class="file docutils literal"><span class="pre">./setup/</span></code> (setup script)</li> +<li><code class="file docutils literal"><span class="pre">./examples/</span></code></li> +<li><code class="file docutils literal"><span class="pre">./sql/</span></code> (SQL scripts to configure advanced functionality)</li> +<li><code class="file docutils literal"><span class="pre">./js/vendor/openlayers/</span></code> (GIS visualization)</li> +</ul> +</div> +<div class="section" id="i-get-an-error-message-about-unknown-authentication-method-caching-sha2-password-when-trying-to-log-in"> +<span id="faq1-45"></span><h3>1.45 I get an error message about unknown authentication method caching_sha2_password when trying to log in<a class="headerlink" href="#i-get-an-error-message-about-unknown-authentication-method-caching-sha2-password-when-trying-to-log-in" title="Permalink to this headline">¶</a></h3> +<p>When logging in using MySQL version 8 or newer, you may encounter an error message like this:</p> +<blockquote> +<div><p>mysqli_real_connect(): The server requested authentication method unknown to the client [caching_sha2_password]</p> +<p>mysqli_real_connect(): (HY000/2054): The server requested authentication method unknown to the client</p> +</div></blockquote> +<p>This error is because of a version compatibility problem between PHP and MySQL. The MySQL project introduced a new authentication +method (our tests show this began with version 8.0.11) however PHP did not include the ability to use that authentication method. +PHP reports that this was fixed in PHP version 7.4.</p> +<p>Users experiencing this are encouraged to upgrade their PHP installation, however a workaround exists. Your MySQL user account +can be set to use the older authentication with a command such as</p> +<div class="highlight-mysql"><div class="highlight"><pre><span></span><span class="k">ALTER</span> <span class="n">USER</span> <span class="s1">'root'</span><span class="o">@</span><span class="s1">'localhost'</span> <span class="n">IDENTIFIED</span> <span class="k">WITH</span> <span class="n">mysql_native_password</span> <span class="k">BY</span> <span class="s1">'PASSWORD'</span><span class="p">;</span> +</pre></div> +</div> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><<a class="reference external" href="https://github.com/phpmyadmin/phpmyadmin/issues/14220">https://github.com/phpmyadmin/phpmyadmin/issues/14220</a>>, <<a class="reference external" href="https://stackoverflow.com/questions/49948350/phpmyadmin-on-mysql-8-0">https://stackoverflow.com/questions/49948350/phpmyadmin-on-mysql-8-0</a>>, <<a class="reference external" href="https://bugs.php.net/bug.php?id=76243">https://bugs.php.net/bug.php?id=76243</a>></p> +</div> +</div> +</div> +<div class="section" id="configuration"> +<span id="faqconfig"></span><h2>Configuration<a class="headerlink" href="#configuration" title="Permalink to this headline">¶</a></h2> +<div class="section" id="the-error-message-warning-cannot-add-header-information-headers-already-sent-by-is-displayed-what-s-the-problem"> +<span id="faq2-1"></span><h3>2.1 The error message “Warning: Cannot add header information - headers already sent by ...” is displayed, what’s the problem?<a class="headerlink" href="#the-error-message-warning-cannot-add-header-information-headers-already-sent-by-is-displayed-what-s-the-problem" title="Permalink to this headline">¶</a></h3> +<p>Edit your <code class="file docutils literal"><span class="pre">config.inc.php</span></code> file and ensure there is nothing (I.E. no +blank lines, no spaces, no characters...) neither before the <code class="docutils literal"><span class="pre"><?php</span></code> tag at +the beginning, neither after the <code class="docutils literal"><span class="pre">?></span></code> tag at the end.</p> +</div> +<div class="section" id="phpmyadmin-can-t-connect-to-mysql-what-s-wrong"> +<span id="faq2-2"></span><h3>2.2 phpMyAdmin can’t connect to MySQL. What’s wrong?<a class="headerlink" href="#phpmyadmin-can-t-connect-to-mysql-what-s-wrong" title="Permalink to this headline">¶</a></h3> +<p>Either there is an error with your PHP setup or your username/password +is wrong. Try to make a small script which uses mysql_connect and see +if it works. If it doesn’t, it may be you haven’t even compiled MySQL +support into PHP.</p> +</div> +<div class="section" id="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"> +<span id="faq2-3"></span><h3>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?<a class="headerlink" href="#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" title="Permalink to this headline">¶</a></h3> +<p>The error message can also be: <span class="guilabel">Error #2002 - The server is not +responding (or the local MySQL server’s socket is not correctly configured)</span>.</p> +<p>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 <em>mysqladmin</em>. Type <code class="docutils literal"><span class="pre">./mysqladmin</span> <span class="pre">variables</span></code>, and +this should give you a bunch of info about your MySQL server, including the +socket (<em>/tmp/mysql.sock</em>, 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.</p> +<p>Then, you need to tell PHP to use this socket. You can do this for all PHP in +the <code class="file docutils literal"><span class="pre">php.ini</span></code> or for phpMyAdmin only in the <code class="file docutils literal"><span class="pre">config.inc.php</span></code>. For +example: <span class="target" id="index-7"></span><a class="reference internal" href="config.html#cfg_Servers_socket"><code class="xref config config-option docutils literal"><span class="pre">$cfg['Servers'][$i]['socket']</span></code></a> Please also make sure +that the permissions of this file allow to be readable by your webserver.</p> +<p>On my RedHat-Box the socket of MySQL is <em>/var/lib/mysql/mysql.sock</em>. +In your <code class="file docutils literal"><span class="pre">php.ini</span></code> you will find a line</p> +<div class="highlight-ini"><div class="highlight"><pre><span></span><span class="na">mysql.default_socket</span> <span class="o">=</span> <span class="s">/tmp/mysql.sock</span> +</pre></div> +</div> +<p>change it to</p> +<div class="highlight-ini"><div class="highlight"><pre><span></span><span class="na">mysql.default_socket</span> <span class="o">=</span> <span class="s">/var/lib/mysql/mysql.sock</span> +</pre></div> +</div> +<p>Then restart apache and it will work.</p> +<p>Have also a look at the <a class="reference external" href="https://dev.mysql.com/doc/refman/5.7/en/can-not-connect-to-server.html">corresponding section of the MySQL +documentation</a>.</p> +</div> +<div class="section" id="nothing-is-displayed-by-my-browser-when-i-try-to-run-phpmyadmin-what-can-i-do"> +<span id="faq2-4"></span><h3>2.4 Nothing is displayed by my browser when I try to run phpMyAdmin, what can I do?<a class="headerlink" href="#nothing-is-displayed-by-my-browser-when-i-try-to-run-phpmyadmin-what-can-i-do" title="Permalink to this headline">¶</a></h3> +<p>Try to set the <span class="target" id="index-8"></span><a class="reference internal" href="config.html#cfg_OBGzip"><code class="xref config config-option docutils literal"><span class="pre">$cfg['OBGzip']</span></code></a> directive to <code class="docutils literal"><span class="pre">false</span></code> in the phpMyAdmin configuration +file. It helps sometime. Also have a look at your PHP version number: +if it contains “b” or “alpha” it means you’re running a testing +version of PHP. That’s not a so good idea, please upgrade to a plain +revision.</p> +</div> +<div class="section" id="each-time-i-want-to-insert-or-change-a-row-or-drop-a-database-or-a-table-an-error-404-page-not-found-is-displayed-or-with-http-or-cookie-authentication-i-m-asked-to-log-in-again-what-s-wrong"> +<span id="faq2-5"></span><h3>2.5 Each time I want to insert or change a row or drop a database or a table, an error 404 (page not found) is displayed or, with HTTP or cookie authentication, I’m asked to log in again. What’s wrong?<a class="headerlink" href="#each-time-i-want-to-insert-or-change-a-row-or-drop-a-database-or-a-table-an-error-404-page-not-found-is-displayed-or-with-http-or-cookie-authentication-i-m-asked-to-log-in-again-what-s-wrong" title="Permalink to this headline">¶</a></h3> +<p>Check your webserver setup if it correctly fills in either PHP_SELF or REQUEST_URI variables.</p> +<p>If you are running phpMyAdmin behind reverse proxy, please set the +<span class="target" id="index-9"></span><a class="reference internal" href="config.html#cfg_PmaAbsoluteUri"><code class="xref config config-option docutils literal"><span class="pre">$cfg['PmaAbsoluteUri']</span></code></a> directive in the phpMyAdmin +configuration file to match your setup.</p> +</div> +<div class="section" id="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"> +<span id="faq2-6"></span><h3>2.6 I get an “Access denied for user: <a class="reference external" href="mailto:'root%40localhost">'root<span>@</span>localhost</a>‘ (Using password: YES)”-error when trying to access a MySQL-Server on a host which is port-forwarded for my localhost.<a class="headerlink" href="#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" title="Permalink to this headline">¶</a></h3> +<p>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 <strong class="command">mysql</strong> 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 +<a class="reference internal" href="glossary.html#term-tcp"><span class="xref std std-term">TCP</span></a> connection.</p> +</div> +<div class="section" id="using-and-creating-themes"> +<span id="faqthemes"></span><h3>2.7 Using and creating themes<a class="headerlink" href="#using-and-creating-themes" title="Permalink to this headline">¶</a></h3> +<p>See <a class="reference internal" href="themes.html#themes"><span class="std std-ref">Custom Themes</span></a>.</p> +</div> +<div class="section" id="i-get-missing-parameters-errors-what-can-i-do"> +<span id="faqmissingparameters"></span><h3>2.8 I get “Missing parameters” errors, what can I do?<a class="headerlink" href="#i-get-missing-parameters-errors-what-can-i-do" title="Permalink to this headline">¶</a></h3> +<p>Here are a few points to check:</p> +<ul class="simple"> +<li>In <code class="file docutils literal"><span class="pre">config.inc.php</span></code>, try to leave the <span class="target" id="index-10"></span><a class="reference internal" href="config.html#cfg_PmaAbsoluteUri"><code class="xref config config-option docutils literal"><span class="pre">$cfg['PmaAbsoluteUri']</span></code></a> directive empty. See also +<a class="reference internal" href="#faq4-7"><span class="std std-ref">4.7 Authentication window is displayed more than once, why?</span></a>.</li> +<li>Maybe you have a broken PHP installation or you need to upgrade your +Zend Optimizer. See <<a class="reference external" href="https://bugs.php.net/bug.php?id=31134">https://bugs.php.net/bug.php?id=31134</a>>.</li> +<li>If you are using Hardened PHP with the ini directive +<code class="docutils literal"><span class="pre">varfilter.max_request_variables</span></code> set to the default (200) or +another low value, you could get this error if your table has a high +number of columns. Adjust this setting accordingly. (Thanks to Klaus +Dorninger for the hint).</li> +<li>In the <code class="file docutils literal"><span class="pre">php.ini</span></code> directive <code class="docutils literal"><span class="pre">arg_separator.input</span></code>, a value of ”;” +will cause this error. Replace it with “&;”.</li> +<li>If you are using <a class="reference external" href="https://suhosin.org/stories/index.html">Suhosin</a>, you +might want to increase <a class="reference external" href="https://suhosin.org/stories/faq.html">request limits</a>.</li> +<li>The directory specified in the <code class="file docutils literal"><span class="pre">php.ini</span></code> directive +<code class="docutils literal"><span class="pre">session.save_path</span></code> does not exist or is read-only (this can be caused +by <a class="reference external" href="https://bugs.php.net/bug.php?id=39842">bug in the PHP installer</a>).</li> +</ul> +</div> +<div class="section" id="seeing-an-upload-progress-bar"> +<span id="faq2-9"></span><h3>2.9 Seeing an upload progress bar<a class="headerlink" href="#seeing-an-upload-progress-bar" title="Permalink to this headline">¶</a></h3> +<p>To be able to see a progress bar during your uploads, your server must +have the <a class="reference external" href="https://www.php.net/manual/en/book.apc.php">APC</a> extension, the +<a class="reference external" href="https://pecl.php.net/package/uploadprogress">uploadprogress</a> one, or +you must be running PHP 5.4.0 or higher. Moreover, the JSON extension +has to be enabled in your PHP.</p> +<p>If using APC, you must set <code class="docutils literal"><span class="pre">apc.rfc1867</span></code> to <code class="docutils literal"><span class="pre">on</span></code> in your <code class="file docutils literal"><span class="pre">php.ini</span></code>.</p> +<p>If using PHP 5.4.0 or higher, you must set +<code class="docutils literal"><span class="pre">session.upload_progress.enabled</span></code> to <code class="docutils literal"><span class="pre">1</span></code> in your <code class="file docutils literal"><span class="pre">php.ini</span></code>. However, +starting from phpMyAdmin version 4.0.4, session-based upload progress has +been temporarily deactivated due to its problematic behavior.</p> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><span class="target" id="index-11"></span><a class="rfc reference external" href="https://tools.ietf.org/html/rfc1867.html"><strong>RFC 1867</strong></a></p> +</div> +</div> +</div> +<div class="section" id="known-limitations"> +<span id="faqlimitations"></span><h2>Known limitations<a class="headerlink" href="#known-limitations" title="Permalink to this headline">¶</a></h2> +<div class="section" id="when-using-http-authentication-a-user-who-logged-out-can-not-log-in-again-in-with-the-same-nick"> +<span id="login-bug"></span><h3>3.1 When using HTTP authentication, a user who logged out can not log in again in with the same nick.<a class="headerlink" href="#when-using-http-authentication-a-user-who-logged-out-can-not-log-in-again-in-with-the-same-nick" title="Permalink to this headline">¶</a></h3> +<p>This is related to the authentication mechanism (protocol) used by +phpMyAdmin. To bypass this problem: just close all the opened browser +windows and then go back to phpMyAdmin. You should be able to log in +again.</p> +</div> +<div class="section" id="when-dumping-a-large-table-in-compressed-mode-i-get-a-memory-limit-error-or-a-time-limit-error"> +<span id="faq3-2"></span><h3>3.2 When dumping a large table in compressed mode, I get a memory limit error or a time limit error.<a class="headerlink" href="#when-dumping-a-large-table-in-compressed-mode-i-get-a-memory-limit-error-or-a-time-limit-error" title="Permalink to this headline">¶</a></h3> +<p>Compressed dumps are built in memory and because of this are limited +to php’s memory limit. For gzip/bzip2 exports this can be overcome +since 2.5.4 using <span class="target" id="index-12"></span><a class="reference internal" href="config.html#cfg_CompressOnFly"><code class="xref config config-option docutils literal"><span class="pre">$cfg['CompressOnFly']</span></code></a> (enabled by default). +zip exports can not be handled this way, so if you need zip files for larger +dump, you have to use another way.</p> +</div> +<div class="section" id="with-innodb-tables-i-lose-foreign-key-relationships-when-i-rename-a-table-or-a-column"> +<span id="faq3-3"></span><h3>3.3 With InnoDB tables, I lose foreign key relationships when I rename a table or a column.<a class="headerlink" href="#with-innodb-tables-i-lose-foreign-key-relationships-when-i-rename-a-table-or-a-column" title="Permalink to this headline">¶</a></h3> +<p>This is an InnoDB bug, see <<a class="reference external" href="https://bugs.mysql.com/bug.php?id=21704">https://bugs.mysql.com/bug.php?id=21704</a>>.</p> +</div> +<div class="section" id="i-am-unable-to-import-dumps-i-created-with-the-mysqldump-tool-bundled-with-the-mysql-server-distribution"> +<span id="faq3-4"></span><h3>3.4 I am unable to import dumps I created with the mysqldump tool bundled with the MySQL server distribution.<a class="headerlink" href="#i-am-unable-to-import-dumps-i-created-with-the-mysqldump-tool-bundled-with-the-mysql-server-distribution" title="Permalink to this headline">¶</a></h3> +<p>The problem is that older versions of <code class="docutils literal"><span class="pre">mysqldump</span></code> created invalid +comments like this:</p> +<div class="highlight-mysql"><div class="highlight"><pre><span></span><span class="c1">-- MySQL dump 8.22</span> +<span class="c1">--</span> +<span class="c1">-- Host: localhost Database: database</span> +<span class="o">-------------------------------------------------------</span><span class="c1">--</span> +<span class="c1">-- Server version 3.23.54</span> +</pre></div> +</div> +<p>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: <code class="docutils literal"><span class="pre">--</span> <span class="pre">-------------------------------------------------------</span></code> or +<code class="docutils literal"><span class="pre">#---------------------------------------------------------</span></code></p> +</div> +<div class="section" id="when-using-nested-folders-multiple-hierarchies-are-displayed-in-a-wrong-manner"> +<span id="faq3-5"></span><h3>3.5 When using nested folders, multiple hierarchies are displayed in a wrong manner.<a class="headerlink" href="#when-using-nested-folders-multiple-hierarchies-are-displayed-in-a-wrong-manner" title="Permalink to this headline">¶</a></h3> +<p>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.</p> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><span class="target" id="index-13"></span><a class="reference internal" href="config.html#cfg_NavigationTreeTableSeparator"><code class="xref config config-option docutils literal"><span class="pre">$cfg['NavigationTreeTableSeparator']</span></code></a></p> +</div> +</div> +<div class="section" id="faq3-6"> +<span id="id7"></span><h3>3.6 (withdrawn).<a class="headerlink" href="#faq3-6" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="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"> +<span id="faq3-7"></span><h3>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?<a class="headerlink" href="#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" title="Permalink to this headline">¶</a></h3> +<p>Your table neither have a <a class="reference internal" href="glossary.html#term-primary-key"><span class="xref std std-term">primary key</span></a> nor an <a class="reference internal" href="glossary.html#term-unique-key"><span class="xref std std-term">unique key</span></a>, so we must +use a long expression to identify this row. This causes problems to +parse_url function. The workaround is to create a <a class="reference internal" href="glossary.html#term-primary-key"><span class="xref std std-term">primary key</span></a> +or <a class="reference internal" href="glossary.html#term-unique-key"><span class="xref std std-term">unique key</span></a>.</p> +</div> +<div class="section" id="i-cannot-use-clickable-html-forms-in-columns-where-i-put-a-mime-transformation-onto"> +<span id="faq3-8"></span><h3>3.8 I cannot use (clickable) HTML-forms in columns where I put a MIME-Transformation onto!<a class="headerlink" href="#i-cannot-use-clickable-html-forms-in-columns-where-i-put-a-mime-transformation-onto" title="Permalink to this headline">¶</a></h3> +<p>Due to a surrounding form-container (for multi-row delete checkboxes), +no nested forms can be put inside the table where phpMyAdmin displays +the results. You can, however, use any form inside of a table if keep +the parent form-container with the target to tbl_row_delete.php and +just put your own input-elements inside. If you use a custom submit +input field, the form will submit itself to the displaying page again, +where you can validate the $HTTP_POST_VARS in a transformation. For +a tutorial on how to effectively use transformations, see our <a class="reference external" href="https://www.phpmyadmin.net/docs/">Link +section</a> on the +official phpMyAdmin-homepage.</p> +</div> +<div class="section" id="i-get-error-messages-when-using-sql-mode-ansi-for-the-mysql-server"> +<span id="faq3-9"></span><h3>3.9 I get error messages when using “–sql_mode=ANSI” for the MySQL server.<a class="headerlink" href="#i-get-error-messages-when-using-sql-mode-ansi-for-the-mysql-server" title="Permalink to this headline">¶</a></h3> +<p>When MySQL is running in ANSI-compatibility mode, there are some major +differences in how <a class="reference internal" href="glossary.html#term-sql"><span class="xref std std-term">SQL</span></a> is structured (see +<<a class="reference external" href="https://dev.mysql.com/doc/refman/5.7/en/sql-mode.html">https://dev.mysql.com/doc/refman/5.7/en/sql-mode.html</a>>). 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 phpMyAdmin operations into +invalid <a class="reference internal" href="glossary.html#term-sql"><span class="xref std std-term">SQL</span></a> statements. There is no +workaround to this behaviour. News to this item will be posted in <a class="reference external" href="https://github.com/phpmyadmin/phpmyadmin/issues/7383">issue +#7383</a>.</p> +</div> +<div class="section" id="homonyms-and-no-primary-key-when-the-results-of-a-select-display-more-that-one-column-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"> +<span id="faq3-10"></span><h3>3.10 Homonyms and no primary key: When the results of a SELECT display more that one column with the same value (for example <code class="docutils literal"><span class="pre">SELECT</span> <span class="pre">lastname</span> <span class="pre">from</span> <span class="pre">employees</span> <span class="pre">where</span> <span class="pre">firstname</span> <span class="pre">like</span> <span class="pre">'A%'</span></code> and two “Smith” values are displayed), if I click Edit I cannot be sure that I am editing the intended row.<a class="headerlink" href="#homonyms-and-no-primary-key-when-the-results-of-a-select-display-more-that-one-column-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" title="Permalink to this headline">¶</a></h3> +<p>Please make sure that your table has a <a class="reference internal" href="glossary.html#term-primary-key"><span class="xref std std-term">primary key</span></a>, so that phpMyAdmin +can use it for the Edit and Delete links.</p> +</div> +<div class="section" id="the-number-of-rows-for-innodb-tables-is-not-correct"> +<span id="faq3-11"></span><h3>3.11 The number of rows for InnoDB tables is not correct.<a class="headerlink" href="#the-number-of-rows-for-innodb-tables-is-not-correct" title="Permalink to this headline">¶</a></h3> +<p>phpMyAdmin uses a quick method to get the row count, and this method only +returns an approximate count in the case of InnoDB tables. See +<span class="target" id="index-14"></span><a class="reference internal" href="config.html#cfg_MaxExactCount"><code class="xref config config-option docutils literal"><span class="pre">$cfg['MaxExactCount']</span></code></a> 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.</p> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><span class="target" id="index-15"></span><a class="reference internal" href="config.html#cfg_MaxExactCount"><code class="xref config config-option docutils literal"><span class="pre">$cfg['MaxExactCount']</span></code></a></p> +</div> +</div> +<div class="section" id="faq3-12"> +<span id="id9"></span><h3>3.12 (withdrawn).<a class="headerlink" href="#faq3-12" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="i-get-an-error-when-entering-use-followed-by-a-db-name-containing-an-hyphen"> +<span id="faq3-13"></span><h3>3.13 I get an error when entering <code class="docutils literal"><span class="pre">USE</span></code> followed by a db name containing an hyphen.<a class="headerlink" href="#i-get-an-error-when-entering-use-followed-by-a-db-name-containing-an-hyphen" title="Permalink to this headline">¶</a></h3> +<p>The tests I have made with MySQL 5.1.49 shows that the API does not +accept this syntax for the USE command.</p> +</div> +<div class="section" id="i-am-not-able-to-browse-a-table-when-i-don-t-have-the-right-to-select-one-of-the-columns"> +<span id="faq3-14"></span><h3>3.14 I am not able to browse a table when I don’t have the right to SELECT one of the columns.<a class="headerlink" href="#i-am-not-able-to-browse-a-table-when-i-don-t-have-the-right-to-select-one-of-the-columns" title="Permalink to this headline">¶</a></h3> +<p>This has been a known limitation of phpMyAdmin since the beginning and +it’s not likely to be solved in the future.</p> +</div> +<div class="section" id="faq3-15"> +<span id="id10"></span><h3>3.15 (withdrawn).<a class="headerlink" href="#faq3-15" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="faq3-16"> +<span id="id11"></span><h3>3.16 (withdrawn).<a class="headerlink" href="#faq3-16" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="faq3-17"> +<span id="id12"></span><h3>3.17 (withdrawn).<a class="headerlink" href="#faq3-17" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="when-i-import-a-csv-file-that-contains-multiple-tables-they-are-lumped-together-into-a-single-table"> +<span id="faq3-18"></span><h3>3.18 When I import a CSV file that contains multiple tables, they are lumped together into a single table.<a class="headerlink" href="#when-i-import-a-csv-file-that-contains-multiple-tables-they-are-lumped-together-into-a-single-table" title="Permalink to this headline">¶</a></h3> +<p>There is no reliable way to differentiate tables in <a class="reference internal" href="glossary.html#term-csv"><span class="xref std std-term">CSV</span></a> format. For the +time being, you will have to break apart <a class="reference internal" href="glossary.html#term-csv"><span class="xref std std-term">CSV</span></a> files containing multiple +tables.</p> +</div> +<div class="section" id="when-i-import-a-file-and-have-phpmyadmin-determine-the-appropriate-data-structure-it-only-uses-int-decimal-and-varchar-types"> +<span id="faq3-19"></span><h3>3.19 When I import a file and have phpMyAdmin determine the appropriate data structure it only uses int, decimal, and varchar types.<a class="headerlink" href="#when-i-import-a-file-and-have-phpmyadmin-determine-the-appropriate-data-structure-it-only-uses-int-decimal-and-varchar-types" title="Permalink to this headline">¶</a></h3> +<p>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 phpMyAdmin 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.</p> +</div> +<div class="section" id="after-upgrading-some-bookmarks-are-gone-or-their-content-cannot-be-shown"> +<span id="faq3-20"></span><h3>3.20 After upgrading, some bookmarks are gone or their content cannot be shown.<a class="headerlink" href="#after-upgrading-some-bookmarks-are-gone-or-their-content-cannot-be-shown" title="Permalink to this headline">¶</a></h3> +<p>At some point, the character set used to store bookmark content has changed. +It’s better to recreate your bookmark from the newer phpMyAdmin version.</p> +</div> +<div class="section" id="i-am-unable-to-log-in-with-a-username-containing-unicode-characters-such-as-a"> +<span id="faq3-21"></span><h3>3.21 I am unable to log in with a username containing unicode characters such as á.<a class="headerlink" href="#i-am-unable-to-log-in-with-a-username-containing-unicode-characters-such-as-a" title="Permalink to this headline">¶</a></h3> +<p>This can happen if MySQL server is not configured to use utf-8 as default +charset. This is a limitation of how PHP and the MySQL server interact; there +is no way for PHP to set the charset before authenticating.</p> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><a class="reference external" href="https://github.com/phpmyadmin/phpmyadmin/issues/12232">phpMyAdmin issue 12232</a>, +<a class="reference external" href="https://www.php.net/manual/en/mysqli.real-connect.php#refsect1-mysqli.real-connect-notes">MySQL documentation note</a></p> +</div> +</div> +</div> +<div class="section" id="isps-multi-user-installations"> +<span id="faqmultiuser"></span><h2>ISPs, multi-user installations<a class="headerlink" href="#isps-multi-user-installations" title="Permalink to this headline">¶</a></h2> +<div class="section" id="i-m-an-isp-can-i-setup-one-central-copy-of-phpmyadmin-or-do-i-need-to-install-it-for-each-customer"> +<span id="faq4-1"></span><h3>4.1 I’m an ISP. Can I setup one central copy of phpMyAdmin or do I need to install it for each customer?<a class="headerlink" href="#i-m-an-isp-can-i-setup-one-central-copy-of-phpmyadmin-or-do-i-need-to-install-it-for-each-customer" title="Permalink to this headline">¶</a></h3> +<p>Since version 2.0.3, you can setup a central copy of phpMyAdmin for all your +users. The development of this feature was kindly sponsored by NetCologne GmbH. +This requires a properly setup MySQL user management and phpMyAdmin +<a class="reference internal" href="glossary.html#term-http"><span class="xref std std-term">HTTP</span></a> or cookie authentication.</p> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><a class="reference internal" href="setup.html#authentication-modes"><span class="std std-ref">Using authentication modes</span></a></p> +</div> +</div> +<div class="section" id="what-s-the-preferred-way-of-making-phpmyadmin-secure-against-evil-access"> +<span id="faq4-2"></span><h3>4.2 What’s the preferred way of making phpMyAdmin secure against evil access?<a class="headerlink" href="#what-s-the-preferred-way-of-making-phpmyadmin-secure-against-evil-access" title="Permalink to this headline">¶</a></h3> +<p>This depends on your system. If you’re running a server which cannot be +accessed by other people, it’s sufficient to use the directory protection +bundled with your webserver (with Apache you can use <a class="reference internal" href="glossary.html#term-htaccess"><span class="xref std std-term">.htaccess</span></a> files, +for example). If other people have telnet access to your server, you should use +phpMyAdmin’s <a class="reference internal" href="glossary.html#term-http"><span class="xref std std-term">HTTP</span></a> or cookie authentication features.</p> +<p>Suggestions:</p> +<ul class="simple"> +<li>Your <code class="file docutils literal"><span class="pre">config.inc.php</span></code> file should be <code class="docutils literal"><span class="pre">chmod</span> <span class="pre">660</span></code>.</li> +<li>All your phpMyAdmin files should be chown -R phpmy.apache, where phpmy +is a user whose password is only known to you, and apache is the group +under which Apache runs.</li> +<li>Follow security recommendations for PHP and your webserver.</li> +</ul> +</div> +<div class="section" id="i-get-errors-about-not-being-able-to-include-a-file-in-lang-or-in-libraries"> +<span id="faq4-3"></span><h3>4.3 I get errors about not being able to include a file in <em>/lang</em> or in <em>/libraries</em>.<a class="headerlink" href="#i-get-errors-about-not-being-able-to-include-a-file-in-lang-or-in-libraries" title="Permalink to this headline">¶</a></h3> +<p>Check <code class="file docutils literal"><span class="pre">php.ini</span></code>, or ask your sysadmin to check it. The +<code class="docutils literal"><span class="pre">include_path</span></code> must contain ”.” somewhere in it, and +<code class="docutils literal"><span class="pre">open_basedir</span></code>, if used, must contain ”.” and ”./lang” to allow +normal operation of phpMyAdmin.</p> +</div> +<div class="section" id="phpmyadmin-always-gives-access-denied-when-using-http-authentication"> +<span id="faq4-4"></span><h3>4.4 phpMyAdmin always gives “Access denied” when using HTTP authentication.<a class="headerlink" href="#phpmyadmin-always-gives-access-denied-when-using-http-authentication" title="Permalink to this headline">¶</a></h3> +<p>This could happen for several reasons:</p> +<ul class="simple"> +<li><span class="target" id="index-16"></span><a class="reference internal" href="config.html#cfg_Servers_controluser"><code class="xref config config-option docutils literal"><span class="pre">$cfg['Servers'][$i]['controluser']</span></code></a> and/or <span class="target" id="index-17"></span><a class="reference internal" href="config.html#cfg_Servers_controlpass"><code class="xref config config-option docutils literal"><span class="pre">$cfg['Servers'][$i]['controlpass']</span></code></a> are wrong.</li> +<li>The username/password you specify in the login dialog are invalid.</li> +<li>You have already setup a security mechanism for the phpMyAdmin- +directory, eg. a <a class="reference internal" href="glossary.html#term-htaccess"><span class="xref std std-term">.htaccess</span></a> file. This would interfere with phpMyAdmin’s +authentication, so remove it.</li> +</ul> +</div> +<div class="section" id="is-it-possible-to-let-users-create-their-own-databases"> +<span id="faq4-5"></span><h3>4.5 Is it possible to let users create their own databases?<a class="headerlink" href="#is-it-possible-to-let-users-create-their-own-databases" title="Permalink to this headline">¶</a></h3> +<p>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 <code class="docutils literal"><span class="pre">SELECT,</span> <span class="pre">INSERT,</span> <span class="pre">UPDATE,</span> +<span class="pre">DELETE,</span> <span class="pre">CREATE,</span> <span class="pre">DROP,</span> <span class="pre">INDEX,</span> <span class="pre">ALTER</span></code> would let a user create/manage +his/her database(s).</p> +</div> +<div class="section" id="how-can-i-use-the-host-based-authentication-additions"> +<span id="faq4-6"></span><h3>4.6 How can I use the Host-based authentication additions?<a class="headerlink" href="#how-can-i-use-the-host-based-authentication-additions" title="Permalink to this headline">¶</a></h3> +<p>If you have existing rules from an old <a class="reference internal" href="glossary.html#term-htaccess"><span class="xref std std-term">.htaccess</span></a> file, you can take them and +add a username between the <code class="docutils literal"><span class="pre">'deny'</span></code>/<code class="docutils literal"><span class="pre">'allow'</span></code> and <code class="docutils literal"><span class="pre">'from'</span></code> +strings. Using the username wildcard of <code class="docutils literal"><span class="pre">'%'</span></code> would be a major +benefit here if your installation is suited to using it. Then you can +just add those updated lines into the +<span class="target" id="index-18"></span><a class="reference internal" href="config.html#cfg_Servers_AllowDeny_rules"><code class="xref config config-option docutils literal"><span class="pre">$cfg['Servers'][$i]['AllowDeny']['rules']</span></code></a> array.</p> +<p>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 <a class="reference internal" href="glossary.html#term-ip"><span class="xref std std-term">IP</span></a> blocks.</p> +<div class="highlight-php"><div class="highlight"><pre><span></span><span class="c1">//block root from logging in except from the private networks</span> +<span class="nv">$cfg</span><span class="p">[</span><span class="s1">'Servers'</span><span class="p">][</span><span class="nv">$i</span><span class="p">][</span><span class="s1">'AllowDeny'</span><span class="p">][</span><span class="s1">'order'</span><span class="p">]</span> <span class="o">=</span> <span class="s1">'deny,allow'</span><span class="p">;</span> +<span class="nv">$cfg</span><span class="p">[</span><span class="s1">'Servers'</span><span class="p">][</span><span class="nv">$i</span><span class="p">][</span><span class="s1">'AllowDeny'</span><span class="p">][</span><span class="s1">'rules'</span><span class="p">]</span> <span class="o">=</span> <span class="k">array</span><span class="p">(</span> + <span class="s1">'deny root from all'</span><span class="p">,</span> + <span class="s1">'allow root from localhost'</span><span class="p">,</span> + <span class="s1">'allow root from 10.0.0.0/8'</span><span class="p">,</span> + <span class="s1">'allow root from 192.168.0.0/16'</span><span class="p">,</span> + <span class="s1">'allow root from 172.16.0.0/12'</span><span class="p">,</span> +<span class="p">);</span> +</pre></div> +</div> +</div> +<div class="section" id="authentication-window-is-displayed-more-than-once-why"> +<span id="faq4-7"></span><h3>4.7 Authentication window is displayed more than once, why?<a class="headerlink" href="#authentication-window-is-displayed-more-than-once-why" title="Permalink to this headline">¶</a></h3> +<p>This happens if you are using a <a class="reference internal" href="glossary.html#term-url"><span class="xref std std-term">URL</span></a> to start phpMyAdmin which is +different than the one set in your <span class="target" id="index-19"></span><a class="reference internal" href="config.html#cfg_PmaAbsoluteUri"><code class="xref config config-option docutils literal"><span class="pre">$cfg['PmaAbsoluteUri']</span></code></a>. For +example, a missing “www”, or entering with an <a class="reference internal" href="glossary.html#term-ip"><span class="xref std std-term">IP</span></a> address while a domain +name is defined in the config file.</p> +</div> +<div class="section" id="which-parameters-can-i-use-in-the-url-that-starts-phpmyadmin"> +<span id="faq4-8"></span><h3>4.8 Which parameters can I use in the URL that starts phpMyAdmin?<a class="headerlink" href="#which-parameters-can-i-use-in-the-url-that-starts-phpmyadmin" title="Permalink to this headline">¶</a></h3> +<p>When starting phpMyAdmin, you can use the <code class="docutils literal"><span class="pre">db</span></code> +and <code class="docutils literal"><span class="pre">server</span></code> parameters. This last one can contain +either the numeric host index (from <code class="docutils literal"><span class="pre">$i</span></code> of the configuration file) +or one of the host names present in the configuration file.</p> +<p>For example, to jump directly to a particular database, a URL can be constructed as +<code class="docutils literal"><span class="pre">https://example.com/phpmyadmin/?db=sakila</span></code>.</p> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><a class="reference internal" href="#faq1-34"><span class="std std-ref">1.34 Can I directly access a database or table pages?</span></a></p> +</div> +<div class="versionchanged"> +<p><span class="versionmodified">Changed in version 4.9.0: </span>Support for using the <code class="docutils literal"><span class="pre">pma_username</span></code> and <code class="docutils literal"><span class="pre">pma_password</span></code> parameters was removed +in phpMyAdmin 4.9.0 (see <a class="reference external" href="https://www.phpmyadmin.net/security/PMASA-2019-4/">PMASA-2019-4</a>).</p> +</div> +</div> +</div> +<div class="section" id="browsers-or-client-os"> +<span id="faqbrowsers"></span><h2>Browsers or client OS<a class="headerlink" href="#browsers-or-client-os" title="Permalink to this headline">¶</a></h2> +<div class="section" id="i-get-an-out-of-memory-error-and-my-controls-are-non-functional-when-trying-to-create-a-table-with-more-than-14-columns"> +<span id="faq5-1"></span><h3>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.<a class="headerlink" href="#i-get-an-out-of-memory-error-and-my-controls-are-non-functional-when-trying-to-create-a-table-with-more-than-14-columns" title="Permalink to this headline">¶</a></h3> +<p>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.</p> +</div> +<div class="section" id="with-xitami-2-5b4-phpmyadmin-won-t-process-form-fields"> +<span id="faq5-2"></span><h3>5.2 With Xitami 2.5b4, phpMyAdmin won’t process form fields.<a class="headerlink" href="#with-xitami-2-5b4-phpmyadmin-won-t-process-form-fields" title="Permalink to this headline">¶</a></h3> +<p>This is not a phpMyAdmin problem but a Xitami known bug: you’ll face +it with each script/website that use forms. Upgrade or downgrade your +Xitami server.</p> +</div> +<div class="section" id="i-have-problems-dumping-tables-with-konqueror-phpmyadmin-2-2-2"> +<span id="faq5-3"></span><h3>5.3 I have problems dumping tables with Konqueror (phpMyAdmin 2.2.2).<a class="headerlink" href="#i-have-problems-dumping-tables-with-konqueror-phpmyadmin-2-2-2" title="Permalink to this headline">¶</a></h3> +<p>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.</p> +</div> +<div class="section" id="i-can-t-use-the-cookie-authentication-mode-because-internet-explorer-never-stores-the-cookies"> +<span id="faq5-4"></span><h3>5.4 I can’t use the cookie authentication mode because Internet Explorer never stores the cookies.<a class="headerlink" href="#i-can-t-use-the-cookie-authentication-mode-because-internet-explorer-never-stores-the-cookies" title="Permalink to this headline">¶</a></h3> +<p>MS Internet Explorer seems to be really buggy about cookies, at least +till version 6.</p> +</div> +<div class="section" id="faq5-5"> +<span id="id13"></span><h3>5.5 (withdrawn).<a class="headerlink" href="#faq5-5" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="faq5-6"> +<span id="id14"></span><h3>5.6 (withdrawn).<a class="headerlink" href="#faq5-6" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="i-refresh-reload-my-browser-and-come-back-to-the-welcome-page"> +<span id="faq5-7"></span><h3>5.7 I refresh (reload) my browser, and come back to the welcome page.<a class="headerlink" href="#i-refresh-reload-my-browser-and-come-back-to-the-welcome-page" title="Permalink to this headline">¶</a></h3> +<p>Some browsers support right-clicking into the frame you want to +refresh, just do this in the right frame.</p> +</div> +<div class="section" id="with-mozilla-0-9-7-i-have-problems-sending-a-query-modified-in-the-query-box"> +<span id="faq5-8"></span><h3>5.8 With Mozilla 0.9.7 I have problems sending a query modified in the query box.<a class="headerlink" href="#with-mozilla-0-9-7-i-have-problems-sending-a-query-modified-in-the-query-box" title="Permalink to this headline">¶</a></h3> +<p>Looks like a Mozilla bug: 0.9.6 was OK. We will keep an eye on future +Mozilla versions.</p> +</div> +<div class="section" id="with-mozilla-0-9-to-1-0-and-netscape-7-0-pr1-i-can-t-type-a-whitespace-in-the-sql-query-edit-area-the-page-scrolls-down"> +<span id="faq5-9"></span><h3>5.9 With Mozilla 0.9.? to 1.0 and Netscape 7.0-PR1 I can’t type a whitespace in the SQL-Query edit area: the page scrolls down.<a class="headerlink" href="#with-mozilla-0-9-to-1-0-and-netscape-7-0-pr1-i-can-t-type-a-whitespace-in-the-sql-query-edit-area-the-page-scrolls-down" title="Permalink to this headline">¶</a></h3> +<p>This is a Mozilla bug (see bug #26882 at <a class="reference external" href="https://bugzilla.mozilla.org/">BugZilla</a>).</p> +</div> +<div class="section" id="faq5-10"> +<span id="id15"></span><h3>5.10 (withdrawn).<a class="headerlink" href="#faq5-10" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="extended-ascii-characters-like-german-umlauts-are-displayed-wrong"> +<span id="faq5-11"></span><h3>5.11 Extended-ASCII characters like German umlauts are displayed wrong.<a class="headerlink" href="#extended-ascii-characters-like-german-umlauts-are-displayed-wrong" title="Permalink to this headline">¶</a></h3> +<p>Please ensure that you have set your browser’s character set to the +one of the language file you have selected on phpMyAdmin’s start page. +Alternatively, you can try the auto detection mode that is supported +by the recent versions of the most browsers.</p> +</div> +<div class="section" id="mac-os-x-safari-browser-changes-special-characters-to"> +<span id="faq5-12"></span><h3>5.12 Mac OS X Safari browser changes special characters to ”?”.<a class="headerlink" href="#mac-os-x-safari-browser-changes-special-characters-to" title="Permalink to this headline">¶</a></h3> +<p>This issue has been reported by a <a class="reference internal" href="glossary.html#term-mac-os-x"><span class="xref std std-term">Mac OS X</span></a> user, who adds that Chimera, +Netscape and Mozilla do not have this problem.</p> +</div> +<div class="section" id="faq5-13"> +<span id="id16"></span><h3>5.13 (withdrawn)<a class="headerlink" href="#faq5-13" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="faq5-14"> +<span id="id17"></span><h3>5.14 (withdrawn)<a class="headerlink" href="#faq5-14" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="faq5-15"> +<span id="id18"></span><h3>5.15 (withdrawn)<a class="headerlink" href="#faq5-15" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="with-internet-explorer-i-get-access-is-denied-javascript-errors-or-i-cannot-make-phpmyadmin-work-under-windows"> +<span id="faq5-16"></span><h3>5.16 With Internet Explorer, I get “Access is denied” Javascript errors. Or I cannot make phpMyAdmin work under Windows.<a class="headerlink" href="#with-internet-explorer-i-get-access-is-denied-javascript-errors-or-i-cannot-make-phpmyadmin-work-under-windows" title="Permalink to this headline">¶</a></h3> +<p>Please check the following points:</p> +<ul class="simple"> +<li>Maybe you have defined your <span class="target" id="index-20"></span><a class="reference internal" href="config.html#cfg_PmaAbsoluteUri"><code class="xref config config-option docutils literal"><span class="pre">$cfg['PmaAbsoluteUri']</span></code></a> setting in +<code class="file docutils literal"><span class="pre">config.inc.php</span></code> to an <a class="reference internal" href="glossary.html#term-ip"><span class="xref std std-term">IP</span></a> address and you are starting phpMyAdmin +with a <a class="reference internal" href="glossary.html#term-url"><span class="xref std std-term">URL</span></a> containing a domain name, or the reverse situation.</li> +<li>Security settings in IE and/or Microsoft Security Center are too high, +thus blocking scripts execution.</li> +<li>The Windows Firewall is blocking Apache and MySQL. You must allow +<a class="reference internal" href="glossary.html#term-http"><span class="xref std std-term">HTTP</span></a> ports (80 or 443) and MySQL +port (usually 3306) in the “in” and “out” directions.</li> +</ul> +</div> +<div class="section" id="with-firefox-i-cannot-delete-rows-of-data-or-drop-a-database"> +<span id="faq5-17"></span><h3>5.17 With Firefox, I cannot delete rows of data or drop a database.<a class="headerlink" href="#with-firefox-i-cannot-delete-rows-of-data-or-drop-a-database" title="Permalink to this headline">¶</a></h3> +<p>Many users have confirmed that the Tabbrowser Extensions plugin they +installed in their Firefox is causing the problem.</p> +</div> +<div class="section" id="faq5-18"> +<span id="id19"></span><h3>5.18 (withdrawn)<a class="headerlink" href="#faq5-18" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="i-get-javascript-errors-in-my-browser"> +<span id="faq5-19"></span><h3>5.19 I get JavaScript errors in my browser.<a class="headerlink" href="#i-get-javascript-errors-in-my-browser" title="Permalink to this headline">¶</a></h3> +<p>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.</p> +</div> +<div class="section" id="i-get-errors-about-violating-content-security-policy"> +<span id="faq5-20"></span><h3>5.20 I get errors about violating Content Security Policy.<a class="headerlink" href="#i-get-errors-about-violating-content-security-policy" title="Permalink to this headline">¶</a></h3> +<p>If you see errors like:</p> +<div class="highlight-text"><div class="highlight"><pre><span></span>Refused to apply inline style because it violates the following Content Security Policy directive +</pre></div> +</div> +<p>This is usually caused by some software, which wrongly rewrites +<em class="mailheader">Content Security Policy</em> headers. Usually this is caused by +antivirus proxy or browser addons which are causing such errors.</p> +<p>If you see these errors, try disabling the HTTP proxy in antivirus or disable +the <em class="mailheader">Content Security Policy</em> rewriting in it. If that doesn’t +help, try disabling browser extensions.</p> +<p>Alternatively it can be also server configuration issue (if the webserver is +configured to emit <em class="mailheader">Content Security Policy</em> headers, they can +override the ones from phpMyAdmin).</p> +<p>Programs known to cause these kind of errors:</p> +<ul class="simple"> +<li>Kaspersky Internet Security</li> +</ul> +</div> +<div class="section" id="i-get-errors-about-potentially-unsafe-operation-when-browsing-table-or-executing-sql-query"> +<span id="faq5-21"></span><h3>5.21 I get errors about potentially unsafe operation when browsing table or executing SQL query.<a class="headerlink" href="#i-get-errors-about-potentially-unsafe-operation-when-browsing-table-or-executing-sql-query" title="Permalink to this headline">¶</a></h3> +<p>If you see errors like:</p> +<div class="highlight-text"><div class="highlight"><pre><span></span>A potentially unsafe operation has been detected in your request to this site. +</pre></div> +</div> +<p>This is usually caused by web application firewall doing requests filtering. It +tries to prevent SQL injection, however phpMyAdmin is tool designed to execute +SQL queries, thus it makes it unusable.</p> +<p>Please whitelist phpMyAdmin scripts from the web application firewall settings +or disable it completely for phpMyAdmin path.</p> +<p>Programs known to cause these kind of errors:</p> +<ul class="simple"> +<li>Wordfence Web Application Firewall</li> +</ul> +</div> +</div> +<div class="section" id="using-phpmyadmin"> +<span id="faqusing"></span><h2>Using phpMyAdmin<a class="headerlink" href="#using-phpmyadmin" title="Permalink to this headline">¶</a></h2> +<div class="section" id="i-can-t-insert-new-rows-into-a-table-i-can-t-create-a-table-mysql-brings-up-a-sql-error"> +<span id="faq6-1"></span><h3>6.1 I can’t insert new rows into a table / I can’t create a table - MySQL brings up a SQL error.<a class="headerlink" href="#i-can-t-insert-new-rows-into-a-table-i-can-t-create-a-table-mysql-brings-up-a-sql-error" title="Permalink to this headline">¶</a></h3> +<p>Examine the <a class="reference internal" href="glossary.html#term-sql"><span class="xref std std-term">SQL</span></a> error with care. +Often the problem is caused by specifying a wrong column-type. Common +errors include:</p> +<ul class="simple"> +<li>Using <code class="docutils literal"><span class="pre">VARCHAR</span></code> without a size argument</li> +<li>Using <code class="docutils literal"><span class="pre">TEXT</span></code> or <code class="docutils literal"><span class="pre">BLOB</span></code> with a size argument</li> +</ul> +<p>Also, look at the syntax chapter in the MySQL manual to confirm that +your syntax is correct.</p> +</div> +<div class="section" id="when-i-create-a-table-i-set-an-index-for-two-columns-and-phpmyadmin-generates-only-one-index-with-those-two-columns"> +<span id="faq6-2"></span><h3>6.2 When I create a table, I set an index for two columns and phpMyAdmin generates only one index with those two columns.<a class="headerlink" href="#when-i-create-a-table-i-set-an-index-for-two-columns-and-phpmyadmin-generates-only-one-index-with-those-two-columns" title="Permalink to this headline">¶</a></h3> +<p>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.</p> +</div> +<div class="section" id="how-can-i-insert-a-null-value-into-my-table"> +<span id="faq6-3"></span><h3>6.3 How can I insert a null value into my table?<a class="headerlink" href="#how-can-i-insert-a-null-value-into-my-table" title="Permalink to this headline">¶</a></h3> +<p>Since version 2.2.3, you have a checkbox for each column that can be +null. Before 2.2.3, you had to enter “null”, without the quotes, as +the column’s value. Since version 2.5.5, you have to use the checkbox +to get a real NULL value, so if you enter “NULL” this means you want a +literal NULL in the column, and not a NULL value (this works in PHP4).</p> +</div> +<div class="section" id="how-can-i-backup-my-database-or-table"> +<span id="faq6-4"></span><h3>6.4 How can I backup my database or table?<a class="headerlink" href="#how-can-i-backup-my-database-or-table" title="Permalink to this headline">¶</a></h3> +<p>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 <a class="reference internal" href="glossary.html#term-sql"><span class="xref std std-term">SQL</span></a> statements that can be +used to recreate your database/table. You will need to choose “Save as file”, +so that phpMyAdmin can transmit the resulting dump to your station. Depending +on your PHP configuration, you will see options to compress the dump. See also +the <span class="target" id="index-21"></span><a class="reference internal" href="config.html#cfg_ExecTimeLimit"><code class="xref config config-option docutils literal"><span class="pre">$cfg['ExecTimeLimit']</span></code></a> configuration variable. For +additional help on this subject, look for the word “dump” in this document.</p> +</div> +<div class="section" id="how-can-i-restore-upload-my-database-or-table-using-a-dump-how-can-i-run-a-sql-file"> +<span id="faq6-5"></span><h3>6.5 How can I restore (upload) my database or table using a dump? How can I run a ”.sql” file?<a class="headerlink" href="#how-can-i-restore-upload-my-database-or-table-using-a-dump-how-can-i-run-a-sql-file" title="Permalink to this headline">¶</a></h3> +<p>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 (or “<a class="reference internal" href="glossary.html#term-sql"><span class="xref std std-term">SQL</span></a>” if your phpMyAdmin +version is previous to 2.7.0). In the “Location of the text file” +section, type in the path to your dump filename, or use the Browse +button. Then click Go. With version 2.7.0, the import engine has been +re–written, if possible it is suggested that you upgrade to take +advantage of the new features. For additional help on this subject, +look for the word “upload” in this document.</p> +<p>Note: For errors while importing of dumps exported from older MySQL versions to newer MySQL versions, +please check <a class="reference internal" href="#faq6-41"><span class="std std-ref">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 ?</span></a>.</p> +</div> +<div class="section" id="how-can-i-use-the-relation-table-in-query-by-example"> +<span id="faq6-6"></span><h3>6.6 How can I use the relation table in Query-by-example?<a class="headerlink" href="#how-can-i-use-the-relation-table-in-query-by-example" title="Permalink to this headline">¶</a></h3> +<p>Here is an example with the tables persons, towns and countries, all +located in the database “mydb”. If you don’t have a <code class="docutils literal"><span class="pre">pma__relation</span></code> +table, create it as explained in the configuration section. Then +create the example tables:</p> +<div class="highlight-mysql"><div class="highlight"><pre><span></span><span class="k">CREATE</span> <span class="k">TABLE</span> <span class="nf">REL_countries</span> <span class="p">(</span> +<span class="n">country_code</span> <span class="kt">char</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="k">NOT</span> <span class="no">NULL</span> <span class="k">default</span> <span class="s1">''</span><span class="p">,</span> +<span class="n">description</span> <span class="kt">varchar</span><span class="p">(</span><span class="mi">10</span><span class="p">)</span> <span class="k">NOT</span> <span class="no">NULL</span> <span class="k">default</span> <span class="s1">''</span><span class="p">,</span> +<span class="k">PRIMARY</span> <span class="k">KEY</span> <span class="p">(</span><span class="n">country_code</span><span class="p">)</span> +<span class="p">)</span> <span class="kp">ENGINE</span><span class="o">=</span><span class="n">MyISAM</span><span class="p">;</span> + +<span class="k">INSERT</span> <span class="k">INTO</span> <span class="n">REL_countries</span> <span class="k">VALUES</span> <span class="p">(</span><span class="s1">'C'</span><span class="p">,</span> <span class="s1">'Canada'</span><span class="p">);</span> + +<span class="k">CREATE</span> <span class="k">TABLE</span> <span class="nf">REL_persons</span> <span class="p">(</span> +<span class="n">id</span> <span class="kt">tinyint</span><span class="p">(</span><span class="mi">4</span><span class="p">)</span> <span class="k">NOT</span> <span class="no">NULL</span> <span class="kp">auto_increment</span><span class="p">,</span> +<span class="n">person_name</span> <span class="kt">varchar</span><span class="p">(</span><span class="mi">32</span><span class="p">)</span> <span class="k">NOT</span> <span class="no">NULL</span> <span class="k">default</span> <span class="s1">''</span><span class="p">,</span> +<span class="n">town_code</span> <span class="kt">varchar</span><span class="p">(</span><span class="mi">5</span><span class="p">)</span> <span class="k">default</span> <span class="s1">'0'</span><span class="p">,</span> +<span class="n">country_code</span> <span class="kt">char</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="k">NOT</span> <span class="no">NULL</span> <span class="k">default</span> <span class="s1">''</span><span class="p">,</span> +<span class="k">PRIMARY</span> <span class="k">KEY</span> <span class="p">(</span><span class="n">id</span><span class="p">)</span> +<span class="p">)</span> <span class="kp">ENGINE</span><span class="o">=</span><span class="n">MyISAM</span><span class="p">;</span> + +<span class="k">INSERT</span> <span class="k">INTO</span> <span class="n">REL_persons</span> <span class="k">VALUES</span> <span class="p">(</span><span class="mi">11</span><span class="p">,</span> <span class="s1">'Marc'</span><span class="p">,</span> <span class="s1">'S'</span><span class="p">,</span> <span class="s1">'C'</span><span class="p">);</span> +<span class="k">INSERT</span> <span class="k">INTO</span> <span class="n">REL_persons</span> <span class="k">VALUES</span> <span class="p">(</span><span class="mi">15</span><span class="p">,</span> <span class="s1">'Paul'</span><span class="p">,</span> <span class="s1">'S'</span><span class="p">,</span> <span class="s1">'C'</span><span class="p">);</span> + +<span class="k">CREATE</span> <span class="k">TABLE</span> <span class="nf">REL_towns</span> <span class="p">(</span> +<span class="n">town_code</span> <span class="kt">varchar</span><span class="p">(</span><span class="mi">5</span><span class="p">)</span> <span class="k">NOT</span> <span class="no">NULL</span> <span class="k">default</span> <span class="s1">'0'</span><span class="p">,</span> +<span class="n">description</span> <span class="kt">varchar</span><span class="p">(</span><span class="mi">30</span><span class="p">)</span> <span class="k">NOT</span> <span class="no">NULL</span> <span class="k">default</span> <span class="s1">''</span><span class="p">,</span> +<span class="k">PRIMARY</span> <span class="k">KEY</span> <span class="p">(</span><span class="n">town_code</span><span class="p">)</span> +<span class="p">)</span> <span class="kp">ENGINE</span><span class="o">=</span><span class="n">MyISAM</span><span class="p">;</span> + +<span class="k">INSERT</span> <span class="k">INTO</span> <span class="n">REL_towns</span> <span class="k">VALUES</span> <span class="p">(</span><span class="s1">'S'</span><span class="p">,</span> <span class="s1">'Sherbrooke'</span><span class="p">);</span> +<span class="k">INSERT</span> <span class="k">INTO</span> <span class="n">REL_towns</span> <span class="k">VALUES</span> <span class="p">(</span><span class="s1">'M'</span><span class="p">,</span> <span class="s1">'Montréal'</span><span class="p">);</span> +</pre></div> +</div> +<p>To setup appropriate links and display information:</p> +<ul class="simple"> +<li>on table “REL_persons” click Structure, then Relation view</li> +<li>for “town_code”, choose from dropdowns, “mydb”, “REL_towns”, “code” +for foreign database, table and column respectively</li> +<li>for “country_code”, choose from dropdowns, “mydb”, “REL_countries”, +“country_code” for foreign database, table and column respectively</li> +<li>on table “REL_towns” click Structure, then Relation view</li> +<li>in “Choose column to display”, choose “description”</li> +<li>repeat the two previous steps for table “REL_countries”</li> +</ul> +<p>Then test like this:</p> +<ul class="simple"> +<li>Click on your db name in the navigation panel</li> +<li>Choose “Query”</li> +<li>Use tables: persons, towns, countries</li> +<li>Click “Update query”</li> +<li>In the columns row, choose persons.person_name and click the “Show” +tickbox</li> +<li>Do the same for towns.description and countries.descriptions in the +other 2 columns</li> +<li>Click “Update query” and you will see in the query box that the +correct joins have been generated</li> +<li>Click “Submit query”</li> +</ul> +</div> +<div class="section" id="how-can-i-use-the-display-column-feature"> +<span id="faqdisplay"></span><h3>6.7 How can I use the “display column” feature?<a class="headerlink" href="#how-can-i-use-the-display-column-feature" title="Permalink to this headline">¶</a></h3> +<p>Starting from the previous example, create the <code class="docutils literal"><span class="pre">pma__table_info</span></code> as +explained in the configuration section, then browse your persons +table, and move the mouse over a town code or country code. See also +<a class="reference internal" href="#faq6-21"><span class="std std-ref">6.21 In edit/insert mode, how can I see a list of possible values for a column, based on some foreign table?</span></a> for an additional feature that “display column” +enables: drop-down list of possible values.</p> +</div> +<div class="section" id="how-can-i-produce-a-pdf-schema-of-my-database"> +<span id="faqpdf"></span><h3>6.8 How can I produce a PDF schema of my database?<a class="headerlink" href="#how-can-i-produce-a-pdf-schema-of-my-database" title="Permalink to this headline">¶</a></h3> +<p>First the configuration variables “relation”, “table_coords” and +“pdf_pages” have to be filled in. Then you need to think about your +schema layout. Which tables will go on which pages?</p> +<ul class="simple"> +<li>Select your database in the navigation panel.</li> +<li>Choose “Operations” in the navigation bar at the top.</li> +<li>Choose “Edit <a class="reference internal" href="glossary.html#term-pdf"><span class="xref std std-term">PDF</span></a> Pages” near the +bottom of the page.</li> +<li>Enter a name for the first <a class="reference internal" href="glossary.html#term-pdf"><span class="xref std std-term">PDF</span></a> page +and click Go. If you like, you can use the “automatic layout,” which +will put all your linked tables onto the new page.</li> +<li>Select the name of the new page (making sure the Edit radio button is +selected) and click Go.</li> +<li>Select a table from the list, enter its coordinates and click Save. +Coordinates are relative; your diagram will be automatically scaled to +fit the page. When initially placing tables on the page, just pick any +coordinates – say, 50x50. After clicking Save, you can then use the +<a class="reference internal" href="#wysiwyg"><span class="std std-ref">6.28 How can I easily edit relational schema for export?</span></a> to position the element correctly.</li> +<li>When you’d like to look at your <a class="reference internal" href="glossary.html#term-pdf"><span class="xref std std-term">PDF</span></a>, first be sure to click the Save +button beneath the list of tables and coordinates, to save any changes you +made there. Then scroll all the way down, select the <a class="reference internal" href="glossary.html#term-pdf"><span class="xref std std-term">PDF</span></a> options you +want, and click Go.</li> +<li>Internet Explorer for Windows may suggest an incorrect filename when +you try to save a generated <a class="reference internal" href="glossary.html#term-pdf"><span class="xref std std-term">PDF</span></a>. +When saving a generated <a class="reference internal" href="glossary.html#term-pdf"><span class="xref std std-term">PDF</span></a>, be +sure that the filename ends in ”.pdf”, for example “schema.pdf”. +Browsers on other operating systems, and other browsers on Windows, do +not have this problem.</li> +</ul> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><a class="reference internal" href="relations.html#relations"><span class="std std-ref">Relations</span></a></p> +</div> +</div> +<div class="section" id="phpmyadmin-is-changing-the-type-of-one-of-my-columns"> +<span id="faq6-9"></span><h3>6.9 phpMyAdmin is changing the type of one of my columns!<a class="headerlink" href="#phpmyadmin-is-changing-the-type-of-one-of-my-columns" title="Permalink to this headline">¶</a></h3> +<p>No, it’s MySQL that is doing <a class="reference external" href="https://dev.mysql.com/doc/refman/5.7/en/silent-column-changes.html">silent column type changing</a>.</p> +</div> +<div class="section" id="when-creating-a-privilege-what-happens-with-underscores-in-the-database-name"> +<span id="underscore"></span><h3>6.10 When creating a privilege, what happens with underscores in the database name?<a class="headerlink" href="#when-creating-a-privilege-what-happens-with-underscores-in-the-database-name" title="Permalink to this headline">¶</a></h3> +<p>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.</p> +</div> +<div class="section" id="what-is-the-curious-symbol-o-in-the-statistics-pages"> +<span id="faq6-11"></span><h3>6.11 What is the curious symbol ø in the statistics pages?<a class="headerlink" href="#what-is-the-curious-symbol-o-in-the-statistics-pages" title="Permalink to this headline">¶</a></h3> +<p>It means “average”.</p> +</div> +<div class="section" id="i-want-to-understand-some-export-options"> +<span id="faqexport"></span><h3>6.12 I want to understand some Export options.<a class="headerlink" href="#i-want-to-understand-some-export-options" title="Permalink to this headline">¶</a></h3> +<p><strong>Structure:</strong></p> +<ul class="simple"> +<li>“Add DROP TABLE” will add a line telling MySQL to <a class="reference external" href="https://dev.mysql.com/doc/refman/5.7/en/drop-table.html">drop the table</a>, if it already +exists during the import. It does NOT drop the table after your +export, it only affects the import file.</li> +<li>“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.</li> +<li>“Add AUTO_INCREMENT value” ensures that AUTO_INCREMENT value (if +any) will be included in backup.</li> +<li>“Enclose table and column names with backquotes” ensures that column +and table names formed with special characters are protected.</li> +<li>“Add into comments” includes column comments, relations, and media (MIME) +types set in the pmadb in the dump as <a class="reference internal" href="glossary.html#term-sql"><span class="xref std std-term">SQL</span></a> comments +(<em>/* xxx */</em>).</li> +</ul> +<p><strong>Data:</strong></p> +<ul class="simple"> +<li>“Complete inserts” adds the column names on every INSERT command, for +better documentation (but resulting file is bigger).</li> +<li>“Extended inserts” provides a shorter dump file by using only once the +INSERT verb and the table name.</li> +<li>“Delayed inserts” are best explained in the <a class="reference external" href="https://dev.mysql.com/doc/refman/5.7/en/insert-delayed.html">MySQL manual - INSERT DELAYED Syntax</a>.</li> +<li>“Ignore inserts” treats errors as a warning instead. Again, more info +is provided in the <a class="reference external" href="https://dev.mysql.com/doc/refman/5.7/en/insert.html">MySQL manual - INSERT Syntax</a>, but basically with +this selected, invalid values are adjusted and inserted rather than +causing the entire statement to fail.</li> +</ul> +</div> +<div class="section" id="i-would-like-to-create-a-database-with-a-dot-in-its-name"> +<span id="faq6-13"></span><h3>6.13 I would like to create a database with a dot in its name.<a class="headerlink" href="#i-would-like-to-create-a-database-with-a-dot-in-its-name" title="Permalink to this headline">¶</a></h3> +<p>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.</p> +</div> +<div class="section" id="faqsqlvalidator"> +<span id="id20"></span><h3>6.14 (withdrawn).<a class="headerlink" href="#faqsqlvalidator" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="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"> +<span id="faq6-15"></span><h3>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”.<a class="headerlink" href="#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" title="Permalink to this headline">¶</a></h3> +<p>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.</p> +</div> +<div class="section" id="how-can-i-simply-move-in-page-with-plenty-editing-fields"> +<span id="faq6-16"></span><h3>6.16 How can I simply move in page with plenty editing fields?<a class="headerlink" href="#how-can-i-simply-move-in-page-with-plenty-editing-fields" title="Permalink to this headline">¶</a></h3> +<p>You can use <code class="kbd docutils literal"><span class="pre">Ctrl+arrows</span></code> (<code class="kbd docutils literal"><span class="pre">Option+Arrows</span></code> in Safari) for moving on +most pages with many editing fields (table structure changes, row editing, +etc.).</p> +</div> +<div class="section" id="transformations-i-can-t-enter-my-own-mimetype-what-is-this-feature-then-useful-for"> +<span id="faq6-17"></span><h3>6.17 Transformations: I can’t enter my own mimetype! What is this feature then useful for?<a class="headerlink" href="#transformations-i-can-t-enter-my-own-mimetype-what-is-this-feature-then-useful-for" title="Permalink to this headline">¶</a></h3> +<p>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.</p> +<p>Plus, you have a whole overview of available mimetypes. Who knows all those +mimetypes by heart so he/she can enter it at will?</p> +</div> +<div class="section" id="bookmarks-where-can-i-store-bookmarks-why-can-t-i-see-any-bookmarks-below-the-query-box-what-are-these-variables-for"> +<span id="faqbookmark"></span><h3>6.18 Bookmarks: Where can I store bookmarks? Why can’t I see any bookmarks below the query box? What are these variables for?<a class="headerlink" href="#bookmarks-where-can-i-store-bookmarks-why-can-t-i-see-any-bookmarks-below-the-query-box-what-are-these-variables-for" title="Permalink to this headline">¶</a></h3> +<p>You need to have configured the <a class="reference internal" href="setup.html#linked-tables"><span class="std std-ref">phpMyAdmin configuration storage</span></a> for using bookmarks +feature. Once you have done that, you can use bookmarks in the <span class="guilabel">SQL</span> tab.</p> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><a class="reference internal" href="bookmarks.html#bookmarks"><span class="std std-ref">Bookmarks</span></a></p> +</div> +</div> +<div class="section" id="how-can-i-create-simple-latex-document-to-include-exported-table"> +<span id="faq6-19"></span><h3>6.19 How can I create simple LATEX document to include exported table?<a class="headerlink" href="#how-can-i-create-simple-latex-document-to-include-exported-table" title="Permalink to this headline">¶</a></h3> +<p>You can simply include table in your LATEX documents, +minimal sample document should look like following one (assuming you +have table exported in file <code class="file docutils literal"><span class="pre">table.tex</span></code>):</p> +<div class="highlight-latex"><div class="highlight"><pre><span></span><span class="k">\documentclass</span><span class="nb">{</span>article<span class="nb">}</span> <span class="c">% or any class you want</span> +<span class="k">\usepackage</span><span class="nb">{</span>longtable<span class="nb">}</span> <span class="c">% for displaying table</span> +<span class="k">\begin</span><span class="nb">{</span>document<span class="nb">}</span> <span class="c">% start of document</span> +<span class="k">\include</span><span class="nb">{</span>table<span class="nb">}</span> <span class="c">% including exported table</span> +<span class="k">\end</span><span class="nb">{</span>document<span class="nb">}</span> <span class="c">% end of document</span> +</pre></div> +</div> +</div> +<div class="section" id="i-see-a-lot-of-databases-which-are-not-mine-and-cannot-access-them"> +<span id="faq6-20"></span><h3>6.20 I see a lot of databases which are not mine, and cannot access them.<a class="headerlink" href="#i-see-a-lot-of-databases-which-are-not-mine-and-cannot-access-them" title="Permalink to this headline">¶</a></h3> +<p>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.</p> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><<a class="reference external" href="https://bugs.mysql.com/bug.php?id=179">https://bugs.mysql.com/bug.php?id=179</a>></p> +</div> +</div> +<div class="section" id="in-edit-insert-mode-how-can-i-see-a-list-of-possible-values-for-a-column-based-on-some-foreign-table"> +<span id="faq6-21"></span><h3>6.21 In edit/insert mode, how can I see a list of possible values for a column, based on some foreign table?<a class="headerlink" href="#in-edit-insert-mode-how-can-i-see-a-list-of-possible-values-for-a-column-based-on-some-foreign-table" title="Permalink to this headline">¶</a></h3> +<p>You have to setup appropriate links between the tables, and also setup +the “display column” in the foreign table. See <a class="reference internal" href="#faq6-6"><span class="std std-ref">6.6 How can I use the relation table in Query-by-example?</span></a> 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 <span class="target" id="index-22"></span><a class="reference internal" href="config.html#cfg_ForeignKeyMaxLimit"><code class="xref config config-option docutils literal"><span class="pre">$cfg['ForeignKeyMaxLimit']</span></code></a>.</p> +</div> +<div class="section" id="bookmarks-can-i-execute-a-default-bookmark-automatically-when-entering-browse-mode-for-a-table"> +<span id="faq6-22"></span><h3>6.22 Bookmarks: Can I execute a default bookmark automatically when entering Browse mode for a table?<a class="headerlink" href="#bookmarks-can-i-execute-a-default-bookmark-automatically-when-entering-browse-mode-for-a-table" title="Permalink to this headline">¶</a></h3> +<p>Yes. If a bookmark has the same label as a table name and it’s not a +public bookmark, it will be executed.</p> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><a class="reference internal" href="bookmarks.html#bookmarks"><span class="std std-ref">Bookmarks</span></a></p> +</div> +</div> +<div class="section" id="export-i-heard-phpmyadmin-can-export-microsoft-excel-files"> +<span id="faq6-23"></span><h3>6.23 Export: I heard phpMyAdmin can export Microsoft Excel files?<a class="headerlink" href="#export-i-heard-phpmyadmin-can-export-microsoft-excel-files" title="Permalink to this headline">¶</a></h3> +<p>You can use <a class="reference internal" href="glossary.html#term-csv"><span class="xref std std-term">CSV</span></a> for Microsoft Excel, +which works out of the box.</p> +<div class="versionchanged"> +<p><span class="versionmodified">Changed in version 3.4.5: </span>Since phpMyAdmin 3.4.5 support for direct export to Microsoft Excel version +97 and newer was dropped.</p> +</div> +</div> +<div class="section" id="now-that-phpmyadmin-supports-native-mysql-4-1-x-column-comments-what-happens-to-my-column-comments-stored-in-pmadb"> +<span id="faq6-24"></span><h3>6.24 Now that phpMyAdmin supports native MySQL 4.1.x column comments, what happens to my column comments stored in pmadb?<a class="headerlink" href="#now-that-phpmyadmin-supports-native-mysql-4-1-x-column-comments-what-happens-to-my-column-comments-stored-in-pmadb" title="Permalink to this headline">¶</a></h3> +<p>Automatic migration of a table’s pmadb-style column comments to the +native ones is done whenever you enter Structure page for this table.</p> +</div> +<div class="section" id="faq6-25"> +<span id="id21"></span><h3>6.25 (withdrawn).<a class="headerlink" href="#faq6-25" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="how-can-i-select-a-range-of-rows"> +<span id="faq6-26"></span><h3>6.26 How can I select a range of rows?<a class="headerlink" href="#how-can-i-select-a-range-of-rows" title="Permalink to this headline">¶</a></h3> +<p>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.</p> +</div> +<div class="section" id="what-format-strings-can-i-use"> +<span id="faq6-27"></span><h3>6.27 What format strings can I use?<a class="headerlink" href="#what-format-strings-can-i-use" title="Permalink to this headline">¶</a></h3> +<p>In all places where phpMyAdmin accepts format strings, you can use +<code class="docutils literal"><span class="pre">@VARIABLE@</span></code> expansion and <a class="reference external" href="https://www.php.net/strftime">strftime</a> +format strings. 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:</p> +<dl class="docutils"> +<dt><code class="docutils literal"><span class="pre">@HTTP_HOST@</span></code></dt> +<dd>HTTP host that runs phpMyAdmin</dd> +<dt><code class="docutils literal"><span class="pre">@SERVER@</span></code></dt> +<dd>MySQL server name</dd> +<dt><code class="docutils literal"><span class="pre">@VERBOSE@</span></code></dt> +<dd>Verbose MySQL server name as defined in <span class="target" id="index-23"></span><a class="reference internal" href="config.html#cfg_Servers_verbose"><code class="xref config config-option docutils literal"><span class="pre">$cfg['Servers'][$i]['verbose']</span></code></a></dd> +<dt><code class="docutils literal"><span class="pre">@VSERVER@</span></code></dt> +<dd>Verbose MySQL server name if set, otherwise normal</dd> +<dt><code class="docutils literal"><span class="pre">@DATABASE@</span></code></dt> +<dd>Currently opened database</dd> +<dt><code class="docutils literal"><span class="pre">@TABLE@</span></code></dt> +<dd>Currently opened table</dd> +<dt><code class="docutils literal"><span class="pre">@COLUMNS@</span></code></dt> +<dd>Columns of the currently opened table</dd> +<dt><code class="docutils literal"><span class="pre">@PHPMYADMIN@</span></code></dt> +<dd>phpMyAdmin with version</dd> +</dl> +</div> +<div class="section" id="how-can-i-easily-edit-relational-schema-for-export"> +<span id="wysiwyg"></span><h3>6.28 How can I easily edit relational schema for export?<a class="headerlink" href="#how-can-i-easily-edit-relational-schema-for-export" title="Permalink to this headline">¶</a></h3> +<p>By clicking on the button ‘toggle scratchboard’ on the page where you +edit x/y coordinates of those elements you can activate a scratchboard +where all your elements are placed. By clicking on an element, you can +move them around in the pre-defined area and the x/y coordinates will +get updated dynamically. Likewise, when entering a new position +directly into the input field, the new position in the scratchboard +changes after your cursor leaves the input field.</p> +<p>You have to click on the ‘OK’-button below the tables to save the new +positions. If you want to place a new element, first add it to the +table of elements and then you can drag the new element around.</p> +<p>By changing the paper size and the orientation you can change the size +of the scratchboard as well. You can do so by just changing the +dropdown field below, and the scratchboard will resize automatically, +without interfering with the current placement of the elements.</p> +<p>If ever an element gets out of range you can either enlarge the paper +size or click on the ‘reset’ button to place all elements below each +other.</p> +</div> +<div class="section" id="why-can-t-i-get-a-chart-from-my-query-result-table"> +<span id="faq6-29"></span><h3>6.29 Why can’t I get a chart from my query result table?<a class="headerlink" href="#why-can-t-i-get-a-chart-from-my-query-result-table" title="Permalink to this headline">¶</a></h3> +<p>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 <a class="reference internal" href="charts.html#charts"><span class="std std-ref">Charts</span></a>.</p> +</div> +<div class="section" id="import-how-can-i-import-esri-shapefiles"> +<span id="faq6-30"></span><h3>6.30 Import: How can I import ESRI Shapefiles?<a class="headerlink" href="#import-how-can-i-import-esri-shapefiles" title="Permalink to this headline">¶</a></h3> +<p>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. To read data from .dbf file you need to have PHP +compiled with the dBase extension (–enable-dbase). Otherwise only +geometry data will be imported.</p> +<p>To upload these set of files you can use either of the following +methods:</p> +<p>Configure upload directory with <span class="target" id="index-24"></span><a class="reference internal" href="config.html#cfg_UploadDir"><code class="xref config config-option docutils literal"><span class="pre">$cfg['UploadDir']</span></code></a>, upload both .shp and .dbf files with +the same filename and chose the .shp file from the import page.</p> +<p>Create a zip archive with .shp and .dbf files and import it. For this +to work, you need to set <span class="target" id="index-25"></span><a class="reference internal" href="config.html#cfg_TempDir"><code class="xref config config-option docutils literal"><span class="pre">$cfg['TempDir']</span></code></a> to a place where the web server user can +write (for example <code class="docutils literal"><span class="pre">'./tmp'</span></code>).</p> +<p>To create the temporary directory on a UNIX-based system, you can do:</p> +<div class="highlight-sh"><div class="highlight"><pre><span></span><span class="nb">cd</span> phpMyAdmin +mkdir tmp +chmod o+rwx tmp +</pre></div> +</div> +</div> +<div class="section" id="how-do-i-create-a-relation-in-designer"> +<span id="faq6-31"></span><h3>6.31 How do I create a relation in designer?<a class="headerlink" href="#how-do-i-create-a-relation-in-designer" title="Permalink to this headline">¶</a></h3> +<p>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.</p> +</div> +<div class="section" id="how-can-i-use-the-zoom-search-feature"> +<span id="faq6-32"></span><h3>6.32 How can I use the zoom search feature?<a class="headerlink" href="#how-can-i-use-the-zoom-search-feature" title="Permalink to this headline">¶</a></h3> +<p>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 <span class="guilabel">Search</span> +tab. One of the sub-tabs in the <span class="guilabel">Table Search</span> page is +<span class="guilabel">Zoom Search</span>.</p> +<p>Consider the table REL_persons in <a class="reference internal" href="#faq6-6"><span class="std std-ref">6.6 How can I use the relation table in Query-by-example?</span></a> 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.</p> +<p>You can choose which field should be +displayed as label for each point. If a display column has been set +for the table (see <a class="reference internal" href="#faqdisplay"><span class="std std-ref">6.7 How can I use the “display column” feature?</span></a>), 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.</p> +<p>After the plot is generated, you can use the +mousewheel 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.</p> +</div> +<div class="section" id="when-browsing-a-table-how-can-i-copy-a-column-name"> +<span id="faq6-33"></span><h3>6.33 When browsing a table, how can I copy a column name?<a class="headerlink" href="#when-browsing-a-table-how-can-i-copy-a-column-name" title="Permalink to this headline">¶</a></h3> +<p>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.</p> +</div> +<div class="section" id="how-can-i-use-the-favorite-tables-feature"> +<span id="faq6-34"></span><h3>6.34 How can I use the Favorite Tables feature?<a class="headerlink" href="#how-can-i-use-the-favorite-tables-feature" title="Permalink to this headline">¶</a></h3> +<p>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 your browser’s local storage if you have not configured your +<cite>phpMyAdmin Configuration Storage</cite>. Otherwise these entries are stored in +<cite>phpMyAdmin Configuration Storage</cite>.</p> +<p>IMPORTANT: In absence of <cite>phpMyAdmin Configuration Storage</cite>, your Favorite +tables may be different in different browsers based on your different +selections in them.</p> +<p>To add a table to Favorite list simply click on the <cite>Gray</cite> star in front +of a table name in the list of tables of a Database and wait until it +turns to <cite>Yellow</cite>. +To remove a table from list, simply click on the <cite>Yellow</cite> star and +wait until it turns <cite>Gray</cite> again.</p> +<p>Using <span class="target" id="index-26"></span><a class="reference internal" href="config.html#cfg_NumFavoriteTables"><code class="xref config config-option docutils literal"><span class="pre">$cfg['NumFavoriteTables']</span></code></a> in your <code class="file docutils literal"><span class="pre">config.inc.php</span></code> +file, you can define the maximum number of favorite tables shown in the +navigation panel. Its default value is <cite>10</cite>.</p> +</div> +<div class="section" id="how-can-i-use-the-range-search-feature"> +<span id="faq6-35"></span><h3>6.35 How can I use the Range search feature?<a class="headerlink" href="#how-can-i-use-the-range-search-feature" title="Permalink to this headline">¶</a></h3> +<p>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 <cite>Search</cite> +tab.</p> +<p>To use this feature simply click on the <cite>BETWEEN</cite> or <cite>NOT BETWEEN</cite> 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 <cite>Minimum</cite> and <cite>Maximum</cite> +value for that column. Only the specified range of values will be included +in case of <cite>BETWEEN</cite> and excluded in case of <cite>NOT BETWEEN</cite> from the final results.</p> +<p>Note: The Range search feature will work only <cite>Numeric</cite> and <cite>Date</cite> data type columns.</p> +</div> +<div class="section" id="what-is-central-columns-and-how-can-i-use-this-feature"> +<span id="faq6-36"></span><h3>6.36 What is Central columns and how can I use this feature?<a class="headerlink" href="#what-is-central-columns-and-how-can-i-use-this-feature" title="Permalink to this headline">¶</a></h3> +<p>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.</p> +<p>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”.</p> +<p>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”.</p> +<p>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.</p> +</div> +<div class="section" id="how-can-i-use-improve-table-structure-feature"> +<span id="faq6-37"></span><h3>6.37 How can I use Improve Table structure feature?<a class="headerlink" href="#how-can-i-use-improve-table-structure-feature" title="Permalink to this headline">¶</a></h3> +<p>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.</p> +<p>Here is an example table which you can use to test all of the three First, Second and +Third Normal Form.</p> +<div class="highlight-mysql"><div class="highlight"><pre><span></span><span class="k">CREATE</span> <span class="k">TABLE</span> <span class="ss">`VetOffice`</span> <span class="p">(</span> + <span class="ss">`petName`</span> <span class="kt">varchar</span><span class="p">(</span><span class="mi">64</span><span class="p">)</span> <span class="k">NOT</span> <span class="no">NULL</span><span class="p">,</span> + <span class="ss">`petBreed`</span> <span class="kt">varchar</span><span class="p">(</span><span class="mi">64</span><span class="p">)</span> <span class="k">NOT</span> <span class="no">NULL</span><span class="p">,</span> + <span class="ss">`petType`</span> <span class="kt">varchar</span><span class="p">(</span><span class="mi">64</span><span class="p">)</span> <span class="k">NOT</span> <span class="no">NULL</span><span class="p">,</span> + <span class="ss">`petDOB`</span> <span class="kt">date</span> <span class="k">NOT</span> <span class="no">NULL</span><span class="p">,</span> + <span class="ss">`ownerLastName`</span> <span class="kt">varchar</span><span class="p">(</span><span class="mi">64</span><span class="p">)</span> <span class="k">NOT</span> <span class="no">NULL</span><span class="p">,</span> + <span class="ss">`ownerFirstName`</span> <span class="kt">varchar</span><span class="p">(</span><span class="mi">64</span><span class="p">)</span> <span class="k">NOT</span> <span class="no">NULL</span><span class="p">,</span> + <span class="ss">`ownerPhone1`</span> <span class="kt">int</span><span class="p">(</span><span class="mi">12</span><span class="p">)</span> <span class="k">NOT</span> <span class="no">NULL</span><span class="p">,</span> + <span class="ss">`ownerPhone2`</span> <span class="kt">int</span><span class="p">(</span><span class="mi">12</span><span class="p">)</span> <span class="k">NOT</span> <span class="no">NULL</span><span class="p">,</span> + <span class="ss">`ownerEmail`</span> <span class="kt">varchar</span><span class="p">(</span><span class="mi">64</span><span class="p">)</span> <span class="k">NOT</span> <span class="no">NULL</span><span class="p">,</span> +<span class="p">);</span> +</pre></div> +</div> +<p>The above table is not in First normal Form as no <a class="reference internal" href="glossary.html#term-primary-key"><span class="xref std std-term">primary key</span></a> exists. Primary key +is supposed to be (<cite>petName</cite>,`ownerLastName`,`ownerFirstName`) . If the <a class="reference internal" href="glossary.html#term-primary-key"><span class="xref std std-term">primary key</span></a> +is chosen as suggested the resultant table won’t be in Second as well as Third Normal +form as the following dependencies exists.</p> +<div class="highlight-mysql"><div class="highlight"><pre><span></span><span class="p">(</span><span class="n">OwnerLastName</span><span class="p">,</span> <span class="n">OwnerFirstName</span><span class="p">)</span> <span class="o">-></span> <span class="nf">OwnerEmail</span> +<span class="p">(</span><span class="n">OwnerLastName</span><span class="p">,</span> <span class="n">OwnerFirstName</span><span class="p">)</span> <span class="o">-></span> <span class="n">OwnerPhone</span> +<span class="n">PetBreed</span> <span class="o">-></span> <span class="n">PetType</span> +</pre></div> +</div> +<p>Which says, OwnerEmail depends on OwnerLastName and OwnerFirstName. +OwnerPhone depends on OwnerLastName and OwnerFirstName. +PetType depends on PetBreed.</p> +</div> +<div class="section" id="how-can-i-reassign-auto-incremented-values"> +<span id="faq6-38"></span><h3>6.38 How can I reassign auto-incremented values?<a class="headerlink" href="#how-can-i-reassign-auto-incremented-values" title="Permalink to this headline">¶</a></h3> +<p>Some users prefer their AUTO_INCREMENT values to be consecutive; this is not +always the case after row deletion.</p> +<p>Here are the steps to accomplish this. These are manual steps because they +involve a manual verification at one point.</p> +<ul class="simple"> +<li>Ensure that you have exclusive access to the table to rearrange</li> +<li>On your <a class="reference internal" href="glossary.html#term-primary-key"><span class="xref std std-term">primary key</span></a> column (i.e. id), remove the AUTO_INCREMENT setting</li> +<li>Delete your primary key in Structure > indexes</li> +<li>Create a new column future_id as primary key, AUTO_INCREMENT</li> +<li>Browse your table and verify that the new increments correspond to what +you’re expecting</li> +<li>Drop your old id column</li> +<li>Rename the future_id column to id</li> +<li>Move the new id column via Structure > Move columns</li> +</ul> +</div> +<div class="section" id="what-is-the-adjust-privileges-option-when-renaming-copying-or-moving-a-database-table-column-or-procedure"> +<span id="faq6-39"></span><h3>6.39 What is the “Adjust privileges” option when renaming, copying, or moving a database, table, column, or procedure?<a class="headerlink" href="#what-is-the-adjust-privileges-option-when-renaming-copying-or-moving-a-database-table-column-or-procedure" title="Permalink to this headline">¶</a></h3> +<p>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, phpMyAdmin will adjust the privilege +table so that users have the same privileges on the new items.</p> +<p>For example: A user <a class="reference external" href="mailto:'bob'%40'localhost">'bob'<span>@</span>'localhost</a>‘ has a ‘SELECT’ privilege on a +column named ‘id’. Now, if this column is renamed to ‘id_new’, MySQL, +on its own, would <strong>not</strong> adjust the column privileges to the new column name. +phpMyAdmin can make this adjustment for you automatically.</p> +<p>Notes:</p> +<ul class="simple"> +<li>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.</li> +<li>Similarly, while adjusting privileges for a table, the privileges of all +the columns inside the new table are also adjusted.</li> +<li>While adjusting privileges, the user performing the operation <strong>must</strong> have the following +privileges:<ul> +<li>SELECT, INSERT, UPDATE, DELETE privileges on following tables: +<cite>mysql</cite>.`db`, <cite>mysql</cite>.`columns_priv`, <cite>mysql</cite>.`tables_priv`, <cite>mysql</cite>.`procs_priv`</li> +<li>FLUSH privilege (GLOBAL)</li> +</ul> +</li> +</ul> +<p>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.</p> +</div> +<div class="section" id="i-see-bind-parameters-checkbox-in-the-sql-page-how-do-i-write-parameterized-sql-queries"> +<span id="faq6-40"></span><h3>6.40 I see “Bind parameters” checkbox in the “SQL” page. How do I write parameterized SQL queries?<a class="headerlink" href="#i-see-bind-parameters-checkbox-in-the-sql-page-how-do-i-write-parameterized-sql-queries" title="Permalink to this headline">¶</a></h3> +<p>From version 4.5, phpMyAdmin 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.</p> +</div> +<div class="section" id="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"> +<span id="faq6-41"></span><h3>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 ?<a class="headerlink" href="#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" title="Permalink to this headline">¶</a></h3> +<p>If you get errors like <em>#1031 - Table storage engine for ‘table_name’ doesn’t have this option</em> +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 +<a class="reference external" href="https://dev.mysql.com/doc/refman/5.7/en/innodb-parameters.html#sysvar_innodb_strict_mode">innodb_strict_mode</a> would define if this would be reported as a warning or as an error.</p> +<p>Since MySQL version 5.7.9, the default value for <cite>innodb_strict_mode</cite> is <cite>ON</cite> and thus would generate +an error when such a CREATE TABLE or ALTER TABLE statement is encountered.</p> +<p>There are two ways of preventing such errors while importing:</p> +<ul class="simple"> +<li>Change the value of <cite>innodb_strict_mode</cite> to <cite>OFF</cite> before starting the import and turn it <cite>ON</cite> after +the import is successfully completed.</li> +<li>This can be achieved in two ways:<ul> +<li>Go to ‘Variables’ page and edit the value of <cite>innodb_strict_mode</cite></li> +<li>Run the query : <cite>SET GLOBAL `innodb_strict_mode</cite> = ‘[value]’`</li> +</ul> +</li> +</ul> +<p>After the import is done, it is suggested that the value of <cite>innodb_strict_mode</cite> should be reset to the +original value.</p> +</div> +</div> +<div class="section" id="phpmyadmin-project"> +<span id="faqproject"></span><h2>phpMyAdmin project<a class="headerlink" href="#phpmyadmin-project" title="Permalink to this headline">¶</a></h2> +<div class="section" id="i-have-found-a-bug-how-do-i-inform-developers"> +<span id="faq7-1"></span><h3>7.1 I have found a bug. How do I inform developers?<a class="headerlink" href="#i-have-found-a-bug-how-do-i-inform-developers" title="Permalink to this headline">¶</a></h3> +<p>Our issues tracker is located at <<a class="reference external" href="https://github.com/phpmyadmin/phpmyadmin/issues">https://github.com/phpmyadmin/phpmyadmin/issues</a>>. +For security issues, please refer to the instructions at <<a class="reference external" href="https://www.phpmyadmin.net/security">https://www.phpmyadmin.net/security</a>> to email +the developers directly.</p> +</div> +<div class="section" id="i-want-to-translate-the-messages-to-a-new-language-or-upgrade-an-existing-language-where-do-i-start"> +<span id="faq7-2"></span><h3>7.2 I want to translate the messages to a new language or upgrade an existing language, where do I start?<a class="headerlink" href="#i-want-to-translate-the-messages-to-a-new-language-or-upgrade-an-existing-language-where-do-i-start" title="Permalink to this headline">¶</a></h3> +<p>Translations are very welcome and all you need to have are the +language skills. The easiest way is to use our <a class="reference external" href="https://hosted.weblate.org/projects/phpmyadmin/">online translation +service</a>. You can check +out all the possibilities to translate in the <a class="reference external" href="https://www.phpmyadmin.net/translate/">translate section on +our website</a>.</p> +</div> +<div class="section" id="i-would-like-to-help-out-with-the-development-of-phpmyadmin-how-should-i-proceed"> +<span id="faq7-3"></span><h3>7.3 I would like to help out with the development of phpMyAdmin. How should I proceed?<a class="headerlink" href="#i-would-like-to-help-out-with-the-development-of-phpmyadmin-how-should-i-proceed" title="Permalink to this headline">¶</a></h3> +<p>We welcome every contribution to the development of phpMyAdmin. You +can check out all the possibilities to contribute in the <a class="reference external" href="https://www.phpmyadmin.net/contribute/">contribute +section on our website</a>.</p> +<div class="admonition seealso"> +<p class="first admonition-title">See also</p> +<p class="last"><a class="reference internal" href="developers.html#developers"><span class="std std-ref">Developers Information</span></a></p> +</div> +</div> +</div> +<div class="section" id="security"> +<span id="faqsecurity"></span><h2>Security<a class="headerlink" href="#security" title="Permalink to this headline">¶</a></h2> +<div class="section" id="where-can-i-get-information-about-the-security-alerts-issued-for-phpmyadmin"> +<span id="faq8-1"></span><h3>8.1 Where can I get information about the security alerts issued for phpMyAdmin?<a class="headerlink" href="#where-can-i-get-information-about-the-security-alerts-issued-for-phpmyadmin" title="Permalink to this headline">¶</a></h3> +<p>Please refer to <<a class="reference external" href="https://www.phpmyadmin.net/security/">https://www.phpmyadmin.net/security/</a>>.</p> +</div> +<div class="section" id="how-can-i-protect-phpmyadmin-against-brute-force-attacks"> +<span id="faq8-2"></span><h3>8.2 How can I protect phpMyAdmin against brute force attacks?<a class="headerlink" href="#how-can-i-protect-phpmyadmin-against-brute-force-attacks" title="Permalink to this headline">¶</a></h3> +<p>If you use Apache web server, phpMyAdmin exports information about +authentication to the Apache environment and it can be used in Apache +logs. Currently there are two variables available:</p> +<dl class="docutils"> +<dt><code class="docutils literal"><span class="pre">userID</span></code></dt> +<dd>User name of currently active user (he does not have to be logged in).</dd> +<dt><code class="docutils literal"><span class="pre">userStatus</span></code></dt> +<dd>Status of currently active user, one of <code class="docutils literal"><span class="pre">ok</span></code> (user is logged in), +<code class="docutils literal"><span class="pre">mysql-denied</span></code> (MySQL denied user login), <code class="docutils literal"><span class="pre">allow-denied</span></code> (user denied +by allow/deny rules), <code class="docutils literal"><span class="pre">root-denied</span></code> (root is denied in configuration), +<code class="docutils literal"><span class="pre">empty-denied</span></code> (empty password is denied).</dd> +</dl> +<p><code class="docutils literal"><span class="pre">LogFormat</span></code> directive for Apache can look like following:</p> +<div class="highlight-apache"><div class="highlight"><pre><span></span><span class="nb">LogFormat</span> <span class="s2">"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %{userID}n %{userStatus}n"</span> pma_combined +</pre></div> +</div> +<p>You can then use any log analyzing tools to detect possible break-in +attempts.</p> +</div> +<div class="section" id="why-are-there-path-disclosures-when-directly-loading-certain-files"> +<span id="faq8-3"></span><h3>8.3 Why are there path disclosures when directly loading certain files?<a class="headerlink" href="#why-are-there-path-disclosures-when-directly-loading-certain-files" title="Permalink to this headline">¶</a></h3> +<p>This is a server configuration problem. Never enable <code class="docutils literal"><span class="pre">display_errors</span></code> on a production site.</p> +</div> +<div class="section" id="csv-files-exported-from-phpmyadmin-could-allow-a-formula-injection-attack"> +<span id="faq8-4"></span><h3>8.4 CSV files exported from phpMyAdmin could allow a formula injection attack.<a class="headerlink" href="#csv-files-exported-from-phpmyadmin-could-allow-a-formula-injection-attack" title="Permalink to this headline">¶</a></h3> +<p>It is possible to generate a <a class="reference internal" href="glossary.html#term-csv"><span class="xref std std-term">CSV</span></a> file that, when imported to a spreadsheet program such as Microsoft Excel, +could potentially allow the execution of arbitrary commands.</p> +<p>The CSV files generated by phpMyAdmin could potentially contain text that would be interpreted by a spreadsheet program as +a formula, but we do 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. We have discussed this at length and feel it is the responsibility of the +spreadsheet program to properly parse and sanitize such data on input instead.</p> +<p>Google also has a <a class="reference external" href="https://sites.google.com/site/bughunteruniversity/nonvuln/csv-excel-formula-injection">similar view</a>.</p> +</div> +</div> +<div class="section" id="synchronization"> +<span id="faqsynchronization"></span><h2>Synchronization<a class="headerlink" href="#synchronization" title="Permalink to this headline">¶</a></h2> +<div class="section" id="faq9-1"> +<span id="id22"></span><h3>9.1 (withdrawn).<a class="headerlink" href="#faq9-1" title="Permalink to this headline">¶</a></h3> +</div> +<div class="section" id="faq9-2"> +<span id="id23"></span><h3>9.2 (withdrawn).<a class="headerlink" href="#faq9-2" title="Permalink to this headline">¶</a></h3> +</div> +</div> +</div> + + + </div> + </div> + </div> + <div class="sphinxsidebar" role="navigation" aria-label="main navigation"> + <div class="sphinxsidebarwrapper"> + <h3><a href="index.html">Table Of Contents</a></h3> + <ul> +<li><a class="reference internal" href="#">FAQ - Frequently Asked Questions</a><ul> +<li><a class="reference internal" href="#server">Server</a><ul> +<li><a class="reference internal" href="#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">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?</a></li> +<li><a class="reference internal" href="#my-apache-server-crashes-when-using-phpmyadmin">1.2 My Apache server crashes when using phpMyAdmin.</a></li> +<li><a class="reference internal" href="#withdrawn">1.3 (withdrawn).</a></li> +<li><a class="reference internal" href="#using-phpmyadmin-on-iis-i-m-displayed-the-error-message-the-specified-cgi-application-misbehaved-by-not-returning-a-complete-set-of-http-headers">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 ...”.</a></li> +<li><a class="reference internal" href="#using-phpmyadmin-on-iis-i-m-facing-crashes-and-or-many-error-messages-with-the-http">1.5 Using phpMyAdmin on IIS, I’m facing crashes and/or many error messages with the HTTP.</a></li> +<li><a class="reference internal" href="#i-can-t-use-phpmyadmin-on-pws-nothing-is-displayed">1.6 I can’t use phpMyAdmin on PWS: nothing is displayed!</a></li> +<li><a class="reference internal" href="#how-can-i-gzip-a-dump-or-a-csv-export-it-does-not-seem-to-work">1.7 How can I gzip a dump or a CSV export? It does not seem to work.</a></li> +<li><a class="reference internal" href="#i-cannot-insert-a-text-file-in-a-table-and-i-get-an-error-about-safe-mode-being-in-effect">1.8 I cannot insert a text file in a table, and I get an error about safe mode being in effect.</a></li> +<li><a class="reference internal" href="#faq1-9">1.9 (withdrawn).</a></li> +<li><a class="reference internal" href="#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">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.</a></li> +<li><a class="reference internal" href="#i-get-an-open-basedir-restriction-while-uploading-a-file-from-the-import-tab">1.11 I get an ‘open_basedir restriction’ while uploading a file from the import tab.</a></li> +<li><a class="reference internal" href="#i-have-lost-my-mysql-root-password-what-can-i-do">1.12 I have lost my MySQL root password, what can I do?</a></li> +<li><a class="reference internal" href="#faq1-13">1.13 (withdrawn).</a></li> +<li><a class="reference internal" href="#faq1-14">1.14 (withdrawn).</a></li> +<li><a class="reference internal" href="#i-have-problems-with-mysql-user-column-names">1.15 I have problems with <em>mysql.user</em> column names.</a></li> +<li><a class="reference internal" href="#i-cannot-upload-big-dump-files-memory-http-or-timeout-problems">1.16 I cannot upload big dump files (memory, HTTP or timeout problems).</a></li> +<li><a class="reference internal" href="#which-database-versions-does-phpmyadmin-support">1.17 Which Database versions does phpMyAdmin support?</a></li> +<li><a class="reference internal" href="#a-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">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”</a></li> +<li><a class="reference internal" href="#faq1-18">1.18 (withdrawn).</a></li> +<li><a class="reference internal" href="#i-can-t-run-the-display-relations-feature-because-the-script-seems-not-to-know-the-font-face-i-m-using">1.19 I can’t run the “display relations” feature because the script seems not to know the font face I’m using!</a></li> +<li><a class="reference internal" href="#i-receive-an-error-about-missing-mysqli-and-mysql-extensions">1.20 I receive an error about missing mysqli and mysql extensions.</a></li> +<li><a class="reference internal" href="#i-am-running-the-cgi-version-of-php-under-unix-and-i-cannot-log-in-using-cookie-auth">1.21 I am running the CGI version of PHP under Unix, and I cannot log in using cookie auth.</a></li> +<li><a class="reference internal" href="#i-don-t-see-the-location-of-text-file-field-so-i-cannot-upload">1.22 I don’t see the “Location of text file” field, so I cannot upload.</a></li> +<li><a class="reference internal" href="#i-m-running-mysql-on-a-win32-machine-each-time-i-create-a-new-table-the-table-and-column-names-are-changed-to-lowercase">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!</a></li> +<li><a class="reference internal" href="#faq1-24">1.24 (withdrawn).</a></li> +<li><a class="reference internal" href="#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">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.</a></li> +<li><a class="reference internal" href="#i-just-installed-phpmyadmin-in-my-document-root-of-iis-but-i-get-the-error-no-input-file-specified-when-trying-to-run-phpmyadmin">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.</a></li> +<li><a class="reference internal" href="#i-get-empty-page-when-i-want-to-view-huge-page-eg-db-structure-php-with-plenty-of-tables">1.27 I get empty page when I want to view huge page (eg. db_structure.php with plenty of tables).</a></li> +<li><a class="reference internal" href="#my-mysql-server-sometimes-refuses-queries-and-returns-the-message-errorcode-13-what-does-this-mean">1.28 My MySQL server sometimes refuses queries and returns the message ‘Errorcode: 13’. What does this mean?</a></li> +<li><a class="reference internal" href="#when-i-create-a-table-or-modify-a-column-i-get-an-error-and-the-columns-are-duplicated">1.29 When I create a table or modify a column, I get an error and the columns are duplicated.</a></li> +<li><a class="reference internal" href="#i-get-the-error-navigation-php-missing-hash">1.30 I get the error “navigation.php: Missing hash”.</a></li> +<li><a class="reference internal" href="#which-php-versions-does-phpmyadmin-support">1.31 Which PHP versions does phpMyAdmin support?</a></li> +<li><a class="reference internal" href="#can-i-use-http-authentication-with-iis">1.32 Can I use HTTP authentication with IIS?</a></li> +<li><a class="reference internal" href="#faq1-33">1.33 (withdrawn).</a></li> +<li><a class="reference internal" href="#can-i-directly-access-a-database-or-table-pages">1.34 Can I directly access a database or table pages?</a></li> +<li><a class="reference internal" href="#can-i-use-http-authentication-with-apache-cgi">1.35 Can I use HTTP authentication with Apache CGI?</a></li> +<li><a class="reference internal" href="#i-get-an-error-500-internal-server-error">1.36 I get an error “500 Internal Server Error”.</a></li> +<li><a class="reference internal" href="#i-run-phpmyadmin-on-cluster-of-different-machines-and-password-encryption-in-cookie-auth-doesn-t-work">1.37 I run phpMyAdmin on cluster of different machines and password encryption in cookie auth doesn’t work.</a></li> +<li><a class="reference internal" href="#can-i-use-phpmyadmin-on-a-server-on-which-suhosin-is-enabled">1.38 Can I use phpMyAdmin on a server on which Suhosin is enabled?</a></li> +<li><a class="reference internal" href="#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">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?</a></li> +<li><a class="reference internal" href="#when-accessing-phpmyadmin-via-an-apache-reverse-proxy-cookie-login-does-not-work">1.40 When accessing phpMyAdmin via an Apache reverse proxy, cookie login does not work.</a></li> +<li><a class="reference internal" href="#when-i-view-a-database-and-ask-to-see-its-privileges-i-get-an-error-about-an-unknown-column">1.41 When I view a database and ask to see its privileges, I get an error about an unknown column.</a></li> +<li><a class="reference internal" href="#how-can-i-prevent-robots-from-accessing-phpmyadmin">1.42 How can I prevent robots from accessing phpMyAdmin?</a></li> +<li><a class="reference internal" href="#why-can-t-i-display-the-structure-of-my-table-containing-hundreds-of-columns">1.43 Why can’t I display the structure of my table containing hundreds of columns?</a></li> +<li><a class="reference internal" href="#how-can-i-reduce-the-installed-size-of-phpmyadmin-on-disk">1.44 How can I reduce the installed size of phpMyAdmin on disk?</a></li> +<li><a class="reference internal" href="#i-get-an-error-message-about-unknown-authentication-method-caching-sha2-password-when-trying-to-log-in">1.45 I get an error message about unknown authentication method caching_sha2_password when trying to log in</a></li> +</ul> +</li> +<li><a class="reference internal" href="#configuration">Configuration</a><ul> +<li><a class="reference internal" href="#the-error-message-warning-cannot-add-header-information-headers-already-sent-by-is-displayed-what-s-the-problem">2.1 The error message “Warning: Cannot add header information - headers already sent by ...” is displayed, what’s the problem?</a></li> +<li><a class="reference internal" href="#phpmyadmin-can-t-connect-to-mysql-what-s-wrong">2.2 phpMyAdmin can’t connect to MySQL. What’s wrong?</a></li> +<li><a class="reference internal" href="#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">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?</a></li> +<li><a class="reference internal" href="#nothing-is-displayed-by-my-browser-when-i-try-to-run-phpmyadmin-what-can-i-do">2.4 Nothing is displayed by my browser when I try to run phpMyAdmin, what can I do?</a></li> +<li><a class="reference internal" href="#each-time-i-want-to-insert-or-change-a-row-or-drop-a-database-or-a-table-an-error-404-page-not-found-is-displayed-or-with-http-or-cookie-authentication-i-m-asked-to-log-in-again-what-s-wrong">2.5 Each time I want to insert or change a row or drop a database or a table, an error 404 (page not found) is displayed or, with HTTP or cookie authentication, I’m asked to log in again. What’s wrong?</a></li> +<li><a class="reference internal" href="#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">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.</a></li> +<li><a class="reference internal" href="#using-and-creating-themes">2.7 Using and creating themes</a></li> +<li><a class="reference internal" href="#i-get-missing-parameters-errors-what-can-i-do">2.8 I get “Missing parameters” errors, what can I do?</a></li> +<li><a class="reference internal" href="#seeing-an-upload-progress-bar">2.9 Seeing an upload progress bar</a></li> +</ul> +</li> +<li><a class="reference internal" href="#known-limitations">Known limitations</a><ul> +<li><a class="reference internal" href="#when-using-http-authentication-a-user-who-logged-out-can-not-log-in-again-in-with-the-same-nick">3.1 When using HTTP authentication, a user who logged out can not log in again in with the same nick.</a></li> +<li><a class="reference internal" href="#when-dumping-a-large-table-in-compressed-mode-i-get-a-memory-limit-error-or-a-time-limit-error">3.2 When dumping a large table in compressed mode, I get a memory limit error or a time limit error.</a></li> +<li><a class="reference internal" href="#with-innodb-tables-i-lose-foreign-key-relationships-when-i-rename-a-table-or-a-column">3.3 With InnoDB tables, I lose foreign key relationships when I rename a table or a column.</a></li> +<li><a class="reference internal" href="#i-am-unable-to-import-dumps-i-created-with-the-mysqldump-tool-bundled-with-the-mysql-server-distribution">3.4 I am unable to import dumps I created with the mysqldump tool bundled with the MySQL server distribution.</a></li> +<li><a class="reference internal" href="#when-using-nested-folders-multiple-hierarchies-are-displayed-in-a-wrong-manner">3.5 When using nested folders, multiple hierarchies are displayed in a wrong manner.</a></li> +<li><a class="reference internal" href="#faq3-6">3.6 (withdrawn).</a></li> +<li><a class="reference internal" href="#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">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?</a></li> +<li><a class="reference internal" href="#i-cannot-use-clickable-html-forms-in-columns-where-i-put-a-mime-transformation-onto">3.8 I cannot use (clickable) HTML-forms in columns where I put a MIME-Transformation onto!</a></li> +<li><a class="reference internal" href="#i-get-error-messages-when-using-sql-mode-ansi-for-the-mysql-server">3.9 I get error messages when using “–sql_mode=ANSI” for the MySQL server.</a></li> +<li><a class="reference internal" href="#homonyms-and-no-primary-key-when-the-results-of-a-select-display-more-that-one-column-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.10 Homonyms and no primary key: When the results of a SELECT display more that one column with the same value (for example <code class="docutils literal"><span class="pre">SELECT</span> <span class="pre">lastname</span> <span class="pre">from</span> <span class="pre">employees</span> <span class="pre">where</span> <span class="pre">firstname</span> <span class="pre">like</span> <span class="pre">'A%'</span></code> and two “Smith” values are displayed), if I click Edit I cannot be sure that I am editing the intended row.</a></li> +<li><a class="reference internal" href="#the-number-of-rows-for-innodb-tables-is-not-correct">3.11 The number of rows for InnoDB tables is not correct.</a></li> +<li><a class="reference internal" href="#faq3-12">3.12 (withdrawn).</a></li> +<li><a class="reference internal" href="#i-get-an-error-when-entering-use-followed-by-a-db-name-containing-an-hyphen">3.13 I get an error when entering <code class="docutils literal"><span class="pre">USE</span></code> followed by a db name containing an hyphen.</a></li> +<li><a class="reference internal" href="#i-am-not-able-to-browse-a-table-when-i-don-t-have-the-right-to-select-one-of-the-columns">3.14 I am not able to browse a table when I don’t have the right to SELECT one of the columns.</a></li> +<li><a class="reference internal" href="#faq3-15">3.15 (withdrawn).</a></li> +<li><a class="reference internal" href="#faq3-16">3.16 (withdrawn).</a></li> +<li><a class="reference internal" href="#faq3-17">3.17 (withdrawn).</a></li> +<li><a class="reference internal" href="#when-i-import-a-csv-file-that-contains-multiple-tables-they-are-lumped-together-into-a-single-table">3.18 When I import a CSV file that contains multiple tables, they are lumped together into a single table.</a></li> +<li><a class="reference internal" href="#when-i-import-a-file-and-have-phpmyadmin-determine-the-appropriate-data-structure-it-only-uses-int-decimal-and-varchar-types">3.19 When I import a file and have phpMyAdmin determine the appropriate data structure it only uses int, decimal, and varchar types.</a></li> +<li><a class="reference internal" href="#after-upgrading-some-bookmarks-are-gone-or-their-content-cannot-be-shown">3.20 After upgrading, some bookmarks are gone or their content cannot be shown.</a></li> +<li><a class="reference internal" href="#i-am-unable-to-log-in-with-a-username-containing-unicode-characters-such-as-a">3.21 I am unable to log in with a username containing unicode characters such as á.</a></li> +</ul> +</li> +<li><a class="reference internal" href="#isps-multi-user-installations">ISPs, multi-user installations</a><ul> +<li><a class="reference internal" href="#i-m-an-isp-can-i-setup-one-central-copy-of-phpmyadmin-or-do-i-need-to-install-it-for-each-customer">4.1 I’m an ISP. Can I setup one central copy of phpMyAdmin or do I need to install it for each customer?</a></li> +<li><a class="reference internal" href="#what-s-the-preferred-way-of-making-phpmyadmin-secure-against-evil-access">4.2 What’s the preferred way of making phpMyAdmin secure against evil access?</a></li> +<li><a class="reference internal" href="#i-get-errors-about-not-being-able-to-include-a-file-in-lang-or-in-libraries">4.3 I get errors about not being able to include a file in <em>/lang</em> or in <em>/libraries</em>.</a></li> +<li><a class="reference internal" href="#phpmyadmin-always-gives-access-denied-when-using-http-authentication">4.4 phpMyAdmin always gives “Access denied” when using HTTP authentication.</a></li> +<li><a class="reference internal" href="#is-it-possible-to-let-users-create-their-own-databases">4.5 Is it possible to let users create their own databases?</a></li> +<li><a class="reference internal" href="#how-can-i-use-the-host-based-authentication-additions">4.6 How can I use the Host-based authentication additions?</a></li> +<li><a class="reference internal" href="#authentication-window-is-displayed-more-than-once-why">4.7 Authentication window is displayed more than once, why?</a></li> +<li><a class="reference internal" href="#which-parameters-can-i-use-in-the-url-that-starts-phpmyadmin">4.8 Which parameters can I use in the URL that starts phpMyAdmin?</a></li> +</ul> +</li> +<li><a class="reference internal" href="#browsers-or-client-os">Browsers or client OS</a><ul> +<li><a class="reference internal" href="#i-get-an-out-of-memory-error-and-my-controls-are-non-functional-when-trying-to-create-a-table-with-more-than-14-columns">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.</a></li> +<li><a class="reference internal" href="#with-xitami-2-5b4-phpmyadmin-won-t-process-form-fields">5.2 With Xitami 2.5b4, phpMyAdmin won’t process form fields.</a></li> +<li><a class="reference internal" href="#i-have-problems-dumping-tables-with-konqueror-phpmyadmin-2-2-2">5.3 I have problems dumping tables with Konqueror (phpMyAdmin 2.2.2).</a></li> +<li><a class="reference internal" href="#i-can-t-use-the-cookie-authentication-mode-because-internet-explorer-never-stores-the-cookies">5.4 I can’t use the cookie authentication mode because Internet Explorer never stores the cookies.</a></li> +<li><a class="reference internal" href="#faq5-5">5.5 (withdrawn).</a></li> +<li><a class="reference internal" href="#faq5-6">5.6 (withdrawn).</a></li> +<li><a class="reference internal" href="#i-refresh-reload-my-browser-and-come-back-to-the-welcome-page">5.7 I refresh (reload) my browser, and come back to the welcome page.</a></li> +<li><a class="reference internal" href="#with-mozilla-0-9-7-i-have-problems-sending-a-query-modified-in-the-query-box">5.8 With Mozilla 0.9.7 I have problems sending a query modified in the query box.</a></li> +<li><a class="reference internal" href="#with-mozilla-0-9-to-1-0-and-netscape-7-0-pr1-i-can-t-type-a-whitespace-in-the-sql-query-edit-area-the-page-scrolls-down">5.9 With Mozilla 0.9.? to 1.0 and Netscape 7.0-PR1 I can’t type a whitespace in the SQL-Query edit area: the page scrolls down.</a></li> +<li><a class="reference internal" href="#faq5-10">5.10 (withdrawn).</a></li> +<li><a class="reference internal" href="#extended-ascii-characters-like-german-umlauts-are-displayed-wrong">5.11 Extended-ASCII characters like German umlauts are displayed wrong.</a></li> +<li><a class="reference internal" href="#mac-os-x-safari-browser-changes-special-characters-to">5.12 Mac OS X Safari browser changes special characters to ”?”.</a></li> +<li><a class="reference internal" href="#faq5-13">5.13 (withdrawn)</a></li> +<li><a class="reference internal" href="#faq5-14">5.14 (withdrawn)</a></li> +<li><a class="reference internal" href="#faq5-15">5.15 (withdrawn)</a></li> +<li><a class="reference internal" href="#with-internet-explorer-i-get-access-is-denied-javascript-errors-or-i-cannot-make-phpmyadmin-work-under-windows">5.16 With Internet Explorer, I get “Access is denied” Javascript errors. Or I cannot make phpMyAdmin work under Windows.</a></li> +<li><a class="reference internal" href="#with-firefox-i-cannot-delete-rows-of-data-or-drop-a-database">5.17 With Firefox, I cannot delete rows of data or drop a database.</a></li> +<li><a class="reference internal" href="#faq5-18">5.18 (withdrawn)</a></li> +<li><a class="reference internal" href="#i-get-javascript-errors-in-my-browser">5.19 I get JavaScript errors in my browser.</a></li> +<li><a class="reference internal" href="#i-get-errors-about-violating-content-security-policy">5.20 I get errors about violating Content Security Policy.</a></li> +<li><a class="reference internal" href="#i-get-errors-about-potentially-unsafe-operation-when-browsing-table-or-executing-sql-query">5.21 I get errors about potentially unsafe operation when browsing table or executing SQL query.</a></li> +</ul> +</li> +<li><a class="reference internal" href="#using-phpmyadmin">Using phpMyAdmin</a><ul> +<li><a class="reference internal" href="#i-can-t-insert-new-rows-into-a-table-i-can-t-create-a-table-mysql-brings-up-a-sql-error">6.1 I can’t insert new rows into a table / I can’t create a table - MySQL brings up a SQL error.</a></li> +<li><a class="reference internal" href="#when-i-create-a-table-i-set-an-index-for-two-columns-and-phpmyadmin-generates-only-one-index-with-those-two-columns">6.2 When I create a table, I set an index for two columns and phpMyAdmin generates only one index with those two columns.</a></li> +<li><a class="reference internal" href="#how-can-i-insert-a-null-value-into-my-table">6.3 How can I insert a null value into my table?</a></li> +<li><a class="reference internal" href="#how-can-i-backup-my-database-or-table">6.4 How can I backup my database or table?</a></li> +<li><a class="reference internal" href="#how-can-i-restore-upload-my-database-or-table-using-a-dump-how-can-i-run-a-sql-file">6.5 How can I restore (upload) my database or table using a dump? How can I run a ”.sql” file?</a></li> +<li><a class="reference internal" href="#how-can-i-use-the-relation-table-in-query-by-example">6.6 How can I use the relation table in Query-by-example?</a></li> +<li><a class="reference internal" href="#how-can-i-use-the-display-column-feature">6.7 How can I use the “display column” feature?</a></li> +<li><a class="reference internal" href="#how-can-i-produce-a-pdf-schema-of-my-database">6.8 How can I produce a PDF schema of my database?</a></li> +<li><a class="reference internal" href="#phpmyadmin-is-changing-the-type-of-one-of-my-columns">6.9 phpMyAdmin is changing the type of one of my columns!</a></li> +<li><a class="reference internal" href="#when-creating-a-privilege-what-happens-with-underscores-in-the-database-name">6.10 When creating a privilege, what happens with underscores in the database name?</a></li> +<li><a class="reference internal" href="#what-is-the-curious-symbol-o-in-the-statistics-pages">6.11 What is the curious symbol ø in the statistics pages?</a></li> +<li><a class="reference internal" href="#i-want-to-understand-some-export-options">6.12 I want to understand some Export options.</a></li> +<li><a class="reference internal" href="#i-would-like-to-create-a-database-with-a-dot-in-its-name">6.13 I would like to create a database with a dot in its name.</a></li> +<li><a class="reference internal" href="#faqsqlvalidator">6.14 (withdrawn).</a></li> +<li><a class="reference internal" href="#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">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”.</a></li> +<li><a class="reference internal" href="#how-can-i-simply-move-in-page-with-plenty-editing-fields">6.16 How can I simply move in page with plenty editing fields?</a></li> +<li><a class="reference internal" href="#transformations-i-can-t-enter-my-own-mimetype-what-is-this-feature-then-useful-for">6.17 Transformations: I can’t enter my own mimetype! What is this feature then useful for?</a></li> +<li><a class="reference internal" href="#bookmarks-where-can-i-store-bookmarks-why-can-t-i-see-any-bookmarks-below-the-query-box-what-are-these-variables-for">6.18 Bookmarks: Where can I store bookmarks? Why can’t I see any bookmarks below the query box? What are these variables for?</a></li> +<li><a class="reference internal" href="#how-can-i-create-simple-latex-document-to-include-exported-table">6.19 How can I create simple LATEX document to include exported table?</a></li> +<li><a class="reference internal" href="#i-see-a-lot-of-databases-which-are-not-mine-and-cannot-access-them">6.20 I see a lot of databases which are not mine, and cannot access them.</a></li> +<li><a class="reference internal" href="#in-edit-insert-mode-how-can-i-see-a-list-of-possible-values-for-a-column-based-on-some-foreign-table">6.21 In edit/insert mode, how can I see a list of possible values for a column, based on some foreign table?</a></li> +<li><a class="reference internal" href="#bookmarks-can-i-execute-a-default-bookmark-automatically-when-entering-browse-mode-for-a-table">6.22 Bookmarks: Can I execute a default bookmark automatically when entering Browse mode for a table?</a></li> +<li><a class="reference internal" href="#export-i-heard-phpmyadmin-can-export-microsoft-excel-files">6.23 Export: I heard phpMyAdmin can export Microsoft Excel files?</a></li> +<li><a class="reference internal" href="#now-that-phpmyadmin-supports-native-mysql-4-1-x-column-comments-what-happens-to-my-column-comments-stored-in-pmadb">6.24 Now that phpMyAdmin supports native MySQL 4.1.x column comments, what happens to my column comments stored in pmadb?</a></li> +<li><a class="reference internal" href="#faq6-25">6.25 (withdrawn).</a></li> +<li><a class="reference internal" href="#how-can-i-select-a-range-of-rows">6.26 How can I select a range of rows?</a></li> +<li><a class="reference internal" href="#what-format-strings-can-i-use">6.27 What format strings can I use?</a></li> +<li><a class="reference internal" href="#how-can-i-easily-edit-relational-schema-for-export">6.28 How can I easily edit relational schema for export?</a></li> +<li><a class="reference internal" href="#why-can-t-i-get-a-chart-from-my-query-result-table">6.29 Why can’t I get a chart from my query result table?</a></li> +<li><a class="reference internal" href="#import-how-can-i-import-esri-shapefiles">6.30 Import: How can I import ESRI Shapefiles?</a></li> +<li><a class="reference internal" href="#how-do-i-create-a-relation-in-designer">6.31 How do I create a relation in designer?</a></li> +<li><a class="reference internal" href="#how-can-i-use-the-zoom-search-feature">6.32 How can I use the zoom search feature?</a></li> +<li><a class="reference internal" href="#when-browsing-a-table-how-can-i-copy-a-column-name">6.33 When browsing a table, how can I copy a column name?</a></li> +<li><a class="reference internal" href="#how-can-i-use-the-favorite-tables-feature">6.34 How can I use the Favorite Tables feature?</a></li> +<li><a class="reference internal" href="#how-can-i-use-the-range-search-feature">6.35 How can I use the Range search feature?</a></li> +<li><a class="reference internal" href="#what-is-central-columns-and-how-can-i-use-this-feature">6.36 What is Central columns and how can I use this feature?</a></li> +<li><a class="reference internal" href="#how-can-i-use-improve-table-structure-feature">6.37 How can I use Improve Table structure feature?</a></li> +<li><a class="reference internal" href="#how-can-i-reassign-auto-incremented-values">6.38 How can I reassign auto-incremented values?</a></li> +<li><a class="reference internal" href="#what-is-the-adjust-privileges-option-when-renaming-copying-or-moving-a-database-table-column-or-procedure">6.39 What is the “Adjust privileges” option when renaming, copying, or moving a database, table, column, or procedure?</a></li> +<li><a class="reference internal" href="#i-see-bind-parameters-checkbox-in-the-sql-page-how-do-i-write-parameterized-sql-queries">6.40 I see “Bind parameters” checkbox in the “SQL” page. How do I write parameterized SQL queries?</a></li> +<li><a class="reference internal" href="#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.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 ?</a></li> +</ul> +</li> +<li><a class="reference internal" href="#phpmyadmin-project">phpMyAdmin project</a><ul> +<li><a class="reference internal" href="#i-have-found-a-bug-how-do-i-inform-developers">7.1 I have found a bug. How do I inform developers?</a></li> +<li><a class="reference internal" href="#i-want-to-translate-the-messages-to-a-new-language-or-upgrade-an-existing-language-where-do-i-start">7.2 I want to translate the messages to a new language or upgrade an existing language, where do I start?</a></li> +<li><a class="reference internal" href="#i-would-like-to-help-out-with-the-development-of-phpmyadmin-how-should-i-proceed">7.3 I would like to help out with the development of phpMyAdmin. How should I proceed?</a></li> +</ul> +</li> +<li><a class="reference internal" href="#security">Security</a><ul> +<li><a class="reference internal" href="#where-can-i-get-information-about-the-security-alerts-issued-for-phpmyadmin">8.1 Where can I get information about the security alerts issued for phpMyAdmin?</a></li> +<li><a class="reference internal" href="#how-can-i-protect-phpmyadmin-against-brute-force-attacks">8.2 How can I protect phpMyAdmin against brute force attacks?</a></li> +<li><a class="reference internal" href="#why-are-there-path-disclosures-when-directly-loading-certain-files">8.3 Why are there path disclosures when directly loading certain files?</a></li> +<li><a class="reference internal" href="#csv-files-exported-from-phpmyadmin-could-allow-a-formula-injection-attack">8.4 CSV files exported from phpMyAdmin could allow a formula injection attack.</a></li> +</ul> +</li> +<li><a class="reference internal" href="#synchronization">Synchronization</a><ul> +<li><a class="reference internal" href="#faq9-1">9.1 (withdrawn).</a></li> +<li><a class="reference internal" href="#faq9-2">9.2 (withdrawn).</a></li> +</ul> +</li> +</ul> +</li> +</ul> + + <h4>Previous topic</h4> + <p class="topless"><a href="other.html" + title="previous chapter">Other sources of information</a></p> + <h4>Next topic</h4> + <p class="topless"><a href="developers.html" + title="next chapter">Developers Information</a></p> + <div role="note" aria-label="source link"> + <h3>This Page</h3> + <ul class="this-page-menu"> + <li><a href="_sources/faq.txt" + rel="nofollow">Show Source</a></li> + </ul> + </div> +<div id="searchbox" style="display: none" role="search"> + <h3>Quick search</h3> + <form class="search" action="search.html" method="get"> + <div><input type="text" name="q" /></div> + <div><input type="submit" value="Go" /></div> + <input type="hidden" name="check_keywords" value="yes" /> + <input type="hidden" name="area" value="default" /> + </form> +</div> +<script type="text/javascript">$('#searchbox').show(0);</script> + </div> + </div> + <div class="clearer"></div> + </div> + <div class="related" role="navigation" aria-label="related navigation"> + <h3>Navigation</h3> + <ul> + <li class="right" style="margin-right: 10px"> + <a href="genindex.html" title="General Index" + >index</a></li> + <li class="right" > + <a href="developers.html" title="Developers Information" + >next</a> |</li> + <li class="right" > + <a href="other.html" title="Other sources of information" + >previous</a> |</li> + <li class="nav-item nav-item-0"><a href="index.html">phpMyAdmin 5.0.1 documentation</a> »</li> + </ul> + </div> + <div class="footer" role="contentinfo"> + © <a href="copyright.html">Copyright</a> 2012 - 2018, The phpMyAdmin devel team. + Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.4.9. + </div> + </body> +</html>
\ No newline at end of file |