2016-04-11

Replaced content with "The list of current requirements is available at http://docs.phpmyadmin.net/en/latest/require.html You can find requirements for older versions still receiving security s..."

← Older revision

Revision as of 15:36, 11 April 2016

Line 1:

Line 1:



==A

Web

Server==

+

The

list

of current requirements is available at http://docs.phpmyadmin.net/en/latest/require.html



Since, phpMyAdmin's interface is based entirely in your browser, you'll need a web server (such as [[Apache]], [[IIS]]) to install phpMyAdmin's files into.



==PHP==



[[phpMyAdmin 3.1|phpMyAdmin 3.x]] : PHP 5.2.0 with the [http://www.php.net/~helly/php/ext/spl/ Standard PHP Library] (SPL) extension enabled



[[phpMyAdmin_2.11.9|phpMyAdmin

2.x]]

:

PHP

4.2.0

or

newer

+

You

can

find

requirements

for

older

versions

still receiving security support at http://phpmyadmin.net/downloads







* [[:php:session|Session support]]. Make sure that sessions are configured properly (see below) and <tt>session.cookie_secure</tt> is <tt>Off</tt> if you are not using a secure connection (i.e. "https")



* Either the [[mysql]] or [[mysqli]] extensions ([[FAQ 1.17|more details]])





<!-- Optional Components -->



* The [[mbstring]] extension



* [http://www.boutell.com/gd/ GD2] support [[:php:image|in PHP]] to display inline thumbnails of JPEGs ("image/jpeg: inline") with their original aspect ratio





* PHP 4.3.0 or newer is needed to use the "text/plain: external" MIME-based transformation





<!-- Other Gotchas -->



* If you are using the Hardened PHP Suhosin extension make sure to increase the values for <tt>suhosin.request|get|post.max_*</tt> see also [http://www.hardened-php.net/suhosin/configuration.html Suhosin Configuration] and [http://www.hardened-php.net/hphp/troubleshooting.html Hardened-PHP request limits]. You can examine some increased suhosin.x values on the [http://pma.cihar.com/trunk-config/phpinfo.php demo server] -> main page -> Show PHP information, e.g., suhosin.post.max_value_length and suhosin.request.max_value_length = 128000 . See also [[FAQ 1.38]]. Another such obstacle is "mod_security" on fedora boxes, error: "Method Not Implemented. GET ..."; a possible solution: http://forums.theplanet.com/index.php?showtopic=89327 .





* If any paths are defined in your php.ini like <tt>[[session.save_path]]</tt> or <tt>upload_tmp_dir</tt> make sure that they do exist and your os is able to write to them. Especially on a Windows system "/tmp" does not exist by default! Due to a broken WIN PHP 5.2 installer paths are definitely wrong in that version [http://bugs.php.net/bug.php?id=39842 bugs.php.net/bug.php?id=39842]. Using IIS as webserver you also need an user named "IUSR" or "IUSR_MACHINENAME" with r/w/modify rights granted on those folders.





* Not really a requirement but a strong suggestion: if you are using the <tt>[[auth_types#cookie|cookie]]</tt> authentication method, having the <tt>[[:php:mcrypt|mcrypt]]</tt> PHP extension on your web server accelerates not only the login phase but every other action that you do in phpMyAdmin





* On 64 bit systems the <tt>[[:php:mcrypt|mcrypt]]</tt> PHP extension is required for auth_type "cookie". The alternative blowfish routines only work on 32-bit systems at the moment (due to a PHP 5.2.0/1 bug, should be fixed in PHP 5.2.2 meanwhile). The same issue leads to the cryptic "#1045 access denied for user www-data.." messages on Ubuntu boxes.





* If you have weird random problems also check out whether apc or eaccelerator is the culprit. If the problem is with [http://php.net/apc APC] it's possible to prevent scripts in the phpMyAdmin directory from being cached with [http://nl.php.net/manual/en/apc.configuration.php#ini.apc.filters apc.filters]. For instance you can add something like this to your php.ini: apc.filters = "-/usr/share/phpmyadmin/.*"





==MySQL==



[[phpMyAdmin 3.1|phpMyAdmin 3.x]] : MySQL 5.0.1 or newer





[[phpMyAdmin_2.11.9|phpMyAdmin 2.x]] : MySQL 3.23.32 or newer ([[FAQ 1.17|details]])





MariaDB is also supported; at least versions 5.1 and 5.2 have been tested extensively.





==Web browser==



Any web browser with cookies enabled

Show more