Files
game/pma12111211/doc/doctrees/setup.doctree
T

1102 lines
145 KiB
Plaintext
Raw Normal View History

2022-12-19 22:22:19 +02:00
cdocutils.nodes
document
q)q}q(U nametypesq}q(XxamppqˆXred hat enterprise linuxqNX upgradingqˆX setup_scriptq ˆX
quick installq
NXsignon authentication modeq NXinstalling on windowsq NXusing setup scriptq
NXhttp://phpmyadmin.net/auth_keyqˆX
linked-tablesqˆX
quick_installqˆXfedoraqNXppa for michal ÄihaÅ™qˆX wikipediaqˆXauthentication_modesqˆXcookie authentication modeqNXgentooqNX setup scriptqˆXhttp authentication modeqNXopensuseqNXlinux distributionsqNXcookieqˆX*extra packages for enterprise linux (epel)qˆXubuntuqNXusing authentication modesqNX%securing your phpmyadmin installationqNXdebianq NXmanually creating the fileq!NX installationq"NXconfig authentication modeq#NXsetupq$ˆXswekey authentication modeq%NXenabledq&ˆX phpmyadmin configuration storageq'NXopensuse build serviceq(ˆXmain phpmyadmin directoryq)ˆXmandrivaq*NXupgrading from an older versionq+NXswekeyq,ˆuUsubstitution_defsq-}q.Uparse_messagesq/]q0Ucurrent_sourceq1NU
decorationq2NUautofootnote_startq3KUnameidsq4}q5(hUxamppq6hUred-hat-enterprise-linuxq7hU upgradingq8h U setup-scriptq9h
Uid1q:h Usignon-authentication-modeq;h Uinstalling-on-windowsq<h
Uusing-setup-scriptq=hUhttp-phpmyadmin-net-auth-keyq>hU
linked-tablesq?hU
quick-installq@hUfedoraqAhUppa-for-michal-ciharqBhU wikipediaqChUauthentication-modesqDhUcookie-authentication-modeqEhUgentooqFhUid2qGhUhttp-authentication-modeqHhUopensuseqIhUlinux-distributionsqJhUcookieqKhU(extra-packages-for-enterprise-linux-epelqLhUubuntuqMhUusing-authentication-modesqNhU%securing-your-phpmyadmin-installationqOh UdebianqPh!Umanually-creating-the-fileqQh"U installationqRh#Uconfig-authentication-modeqSh$UsetupqTh%Uswekey-authentication-modeqUh&UenabledqVh'U phpmyadmin-configuration-storageqWh(Uopensuse-build-serviceqXh)Umain-phpmyadmin-directoryqYh*UmandrivaqZh+Uupgrading-from-an-older-versionq[h,Uswekeyq\uUchildrenq]]q^(cdocutils.nodes
target
q_)q`}qa(U rawsourceqbX
.. _setup:qcUparentqdhUsourceqecdocutils.nodes
reprunicode
qfXN/usr/local/apache2/htdocs/phpmyadmin/release/phpMyAdmin-4.1.14.8/doc/setup.rstqg…qh}qibUtagnameqjUtargetqkU
attributesql}qm(Uidsqn]qoUbackrefsqp]qqUdupnamesqr]qsUclassesqt]quUnamesqv]qwUrefidqxhTuUlineqyKUdocumentqzhh]]q{ubcdocutils.nodes
section
q|)q}}q~(hbUhdhhehhUexpect_referenced_by_nameq}q€h$h`shjUsectionqhl}q(hr]qƒht]q„hp]q…hn]q†(hRhTehv]q‡(h"h$euhyKhzhUexpect_referenced_by_idqˆ}q‰hTh`sh]]qŠ(cdocutils.nodes
title
q)qŒ}q(hbX InstallationqŽhdh}hehhhjUtitleqhl}q(hr]qht]qhp]q“hn]q”hv]q•uhyKhzhh]]qcdocutils.nodes
Text
q—X Installationq˜…q™}qš(hbhŽhdhŒubaubcdocutils.nodes
paragraph
q)qœ}q(hbXïphpMyAdmin does not apply any special security methods to the MySQL
database server. It is still the system administrator's job to grant
permissions on the MySQL databases properly. phpMyAdmin's :guilabel:`Users`
page can be used for this.qžhdh}hehhhjU paragraphqŸhl}q (hr]q¡ht]q¢hp]q£hn]q¤hv]q¥uhyKhzhh]]q¦(h—XÃphpMyAdmin does not apply any special security methods to the MySQL
database server. It is still the system administrator's job to grant
permissions on the MySQL databases properly. phpMyAdmin's q§…q¨}q©(hbXÃphpMyAdmin does not apply any special security methods to the MySQL
database server. It is still the system administrator's job to grant
permissions on the MySQL databases properly. phpMyAdmin's qªhdhœubcdocutils.nodes
emphasis
q«)q¬}q­(hbUhl}q®(Urawtextq¯X:guilabel:`Users`q°hn]q±hp]q²hr]q³ht]q´Xguilabelqµahv]q¶uhdhœh]]q·h—XUsersq¸…q¹}qº(hbUhdh¬ubahjUemphasisq»ubh—X
page can be used for this.q¼…q½}q¾(hbX
page can be used for this.q¿hdhœubeubcdocutils.nodes
warning
qÀ)qÁ}qÂ(hbX=:term:`Mac` users should note that if you are on a version before
:term:`Mac OS X`, StuffIt unstuffs with :term:`Mac` formats. So you'll have
to resave as in BBEdit to Unix style ALL phpMyAdmin scripts before
uploading them to your server, as PHP seems not to like :term:`Mac`-style
end of lines character ("``\r``").qÃhdh}hehhhjUwarningqÄhl}qÅ(hr]qÆht]qÇhp]qÈhn]qÉhv]qÊuhyNhzhh]]qËh)qÌ}qÍ(hbX=:term:`Mac` users should note that if you are on a version before
:term:`Mac OS X`, StuffIt unstuffs with :term:`Mac` formats. So you'll have
to resave as in BBEdit to Unix style ALL phpMyAdmin scripts before
uploading them to your server, as PHP seems not to like :term:`Mac`-style
end of lines character ("``\r``").qÎhdhÁhehhhjhŸhl}qÏ(hr]qÐht]qÑhp]qÒhn]qÓhv]qÔuhyK
h]]qÕ(csphinx.addnodes
pending_xref
qÖ)q×}qØ(hbX :term:`Mac`qÙhdhÌhehhhjU pending_xrefqÚhl}qÛ(UreftypeqÜXtermqÝUrefwarnqÞˆU reftargetqßXmacqàU refdomainqáXstdqâhn]qãhp]qäU refexplicitqå‰hr]qæht]qçhv]qèUrefdocqéUsetupqêuhyK
h]]qëh«)qì}qí(hbhÙhl}qî(hr]qïht]qð(UxrefqñhâXstd-termqòehp]qóhn]qôhv]qõuhdh×h]]qöh—XMacq÷…qø}qù(hbUhdhìubahjh»ubaubh—X7 users should note that if you are on a version before
qú…qû}qü(hbX7 users should note that if you are on a version before
qýhdhÌubhÖ)qþ}qÿ(hbX:term:`Mac OS X`rhdhÌhehhhjhÚhl}r(UreftyperXtermrhÞˆhßXmac os xrU refdomainrXstdrhn]rhp]rU refexplicitr ‰hr]r
ht]r hv]r héhêuhyK
h]]r
h«)r}r(hbjhl}r(hr]rht]r(hñjXstd-termrehp]rhn]rhv]ruhdhþh]]rh—XMac OS Xrr}r(hbUhdjubahjh»ubaubh—X, StuffIt unstuffs with rr}r(hbX, StuffIt unstuffs with rhdhÌubhÖ)r}r (hbX :term:`Mac`r!hdhÌhehhhjhÚhl}r"(Ureftyper#Xtermr$hÞˆhßXmacr%U refdomainr&Xstdr'hn]r(hp]r)U refexplicitr*‰hr]r+ht]r,hv]r-héhêuhyK
h]]r.h«)r/}r0(hbj!hl}r1(hr]r2ht]r3(hñj'Xstd-termr4ehp]r5hn]r6hv]r7uhdjh]]r8h—XMacr9r:}r;(hbUhdj/ubahjh»ubaubh—X” formats. So you'll have
to resave as in BBEdit to Unix style ALL phpMyAdmin scripts before
uploading them to your server, as PHP seems not to like r<r=}r>(hbX” formats. So you'll have
to resave as in BBEdit to Unix style ALL phpMyAdmin scripts before
uploading them to your server, as PHP seems not to like r?hdhÌubhÖ)r@}rA(hbX :term:`Mac`rBhdhÌhehhhjhÚhl}rC(UreftyperDXtermrEhÞˆhßXmacrFU refdomainrGXstdrHhn]rIhp]rJU refexplicitrK‰hr]rLht]rMhv]rNhéhêuhyK
h]]rOh«)rP}rQ(hbjBhl}rR(hr]rSht]rT(hñjHXstd-termrUehp]rVhn]rWhv]rXuhdj@h]]rYh—XMacrZr[}r\(hbUhdjPubahjh»ubaubh—X -style
end of lines character ("r]r^}r_(hbX -style
end of lines character ("r`hdhÌubcdocutils.nodes
literal
ra)rb}rc(hbX``\r``rdhl}re(hr]rfht]rghp]rhhn]rihv]rjuhdhÌh]]rkh—X\rrlrm}rn(hbUhdjbubahjUliteralroubh—X").rprq}rr(hbX").rshdhÌubeubaubh|)rt}ru(hbUhdh}hehhhjhhl}rv(hr]rwht]rxhp]ryhn]rzhJahv]r{hauhyKhzhh]]r|(h)r}}r~(hbXLinux distributionsrhdjthehhhjhhl}r€(hr]rht]rhp]rƒhn]r„hv]r…uhyKhzhh]]r†h—XLinux distributionsr‡rˆ}r‰(hbjhdj}ubaubh)}r(hbXðphpMyAdmin is included in most Linux distributions. It is recommended to use
distribution packages when possible - they usually provide integration to your
distribution and you will automatically get security updates from your distribution.rŒhdjthehhhjhŸhl}r(hr]rŽht]rhp]rhn]rhv]ruhyKhzhh]]r“h—XðphpMyAdmin is included in most Linux distributions. It is recommended to use
distribution packages when possible - they usually provide integration to your
distribution and you will automatically get security updates from your distribution.r”r•}r(hbjŒhdjŠubaubh|)r—}r˜(hbUhdjthehhhjhhl}r™(hr]ršht]rhp]rœhn]rhPahv]ržh auhyKhzhh]]rŸ(h)r }r¡(hbXDebianr¢hdj—hehhhjhhl}r£(hr]r¤ht]r¥hp]r¦hn]r§hv]r¨uhyKhzhh]]r©h—XDebianrª}r¬(hbj¢hdj ubaubh)r­}r®(hbXÑDebian's package repositories include a phpMyAdmin package, but be aware that
the configuration file is maintained in ``/etc/phpmyadmin`` and may differ in
some ways from the official phpMyAdmin documentation.r¯hdj—hehhhjhŸhl}r°(hr]r±ht]r²hp]r³hn]r´hv]rµuhyKhzhh]]r¶(h—XvDebian's package repositories include a phpMyAdmin package, but be aware that
the configuration file is maintained in r·r¸}r¹(hbXvDebian's package repositories include a phpMyAdmin package, but be aware that
the configuration file is maintained in rºhdj­ubja)}r¼(hbX``/etc/phpmyadmin``r½hl}r¾(hr]r¿ht]rÀhp]rÁhn]rÂhv]rÃuhdj­h]]rÄh—X/etc/phpmyadminrÅ}rÇ(hbUhdj»ubahjjoubh—XH and may differ in
some ways from the official phpMyAdmin documentation.rÈ}rÊ(hbXH and may differ in
some ways from the official phpMyAdmin documentation.rËhdj­ubeubeubh|)}rÍ(hbUhdjthehhhjhhl}rÎ(hr]rÏht]rÐhp]rÑhn]rÒhIahv]rÓhauhyK#hzhh]]rÔ(h)}rÖ(hbXOpenSUSEr×hdjÌhehhhjhhl}rØ(hr]rÙht]rÚhp]rÛhn]rÜhv]rÝuhyK#hzhh]]rÞh—XOpenSUSErß}rá(hbj×hdjÕubaubh)}rã(hbXOpenSUSE already comes with phpMyAdmin package, just install packages from
the `openSUSE Build Service <http://software.opensuse.org/package/phpMyAdmin>`_.rähdjÌhehhhjhŸhl}rå(hr]ræht]rçhp]rèhn]réhv]rêuhyK%hzhh]]rë(h—XOOpenSUSE already comes with phpMyAdmin package, just install packages from
the rì}rî(hbXOOpenSUSE already comes with phpMyAdmin package, just install packages from
the rïhdjâubcdocutils.nodes
reference
)}rò(hbXK`openSUSE Build Service <http://software.opensuse.org/package/phpMyAdmin>`_róhl}rô(UnamerõXopenSUSE Build ServiceröUrefurir÷X/http://software.opensuse.org/package/phpMyAdminrøhn]rùhp]rúhr]rûht]rühv]rýuhdjâh]]rþh—XopenSUSE Build Servicerÿr}r(hbUhdjñubahjU referencerubh_)r}r(hbX2 <http://software.opensuse.org/package/phpMyAdmin>rU
referencedrKhdjâhjhkhl}r(Urefurirhn]r hXahp]r
hr]r ht]r hv]r
h(auh]]rubh—X.…r}r(hbX.hdjâubeubeubh|)r}r(hbUhdjthehhhjhhl}r(hr]rht]rhp]rhn]rhMahv]rhauhyK)hzhh]]r(h)r}r(hbXUbunturhdjhehhhjhhl}r(hr]rht]rhp]r hn]r!hv]r"uhyK)hzhh]]r#h—XUbuntur$r%}r&(hbjhdjubaubh)r'}r((hbX³Ubuntu ships phpMyAdmin package, however if you want to use recent version, you
can use packages from
`PPA for Michal ÄŒihaÅ™ <https://launchpad.net/~nijel/+archive/phpmyadmin>`_.r)hdjhehhhjhŸhl}r*(hr]r+ht]r,hp]r-hn]r.hv]r/uhyK+hzhh]]r0(h—XfUbuntu ships phpMyAdmin package, however if you want to use recent version, you
can use packages from
r1r2}r3(hbXfUbuntu ships phpMyAdmin package, however if you want to use recent version, you
can use packages from
r4hdj'ubjð)r5}r6(hbXL`PPA for Michal ÄŒihaÅ™ <https://launchpad.net/~nijel/+archive/phpmyadmin>`_r7hl}r8(Unamer9XPPA for Michal ÄŒihaÅ™r:X0https://launchpad.net/~nijel/+archive/phpmyadminr;hn]r<hp]r=hr]r>ht]r?hv]r@uhdj'h]]rAh—XPPA for Michal ÄŒihaÅ™rBrC}rD(hbUhdj5ubahjjubh_)rE}rF(hbX3 <https://launchpad.net/~nijel/+archive/phpmyadmin>rGjKhdj'hjhkhl}rH(UrefurirIj;hn]rJhBahp]rKhr]rLht]rMhv]rNhauh]]rOubh—X.…rP}rQ(hbX.hdj'ubeubeubh|)rR}rS(hbUhdjthehhhjhhl}rT(hr]rUht]rVhp]rWhn]rXhFahv]rYhauhyK0hzhh]]rZ(h)r[}r\(hbXGentoor]hdjRhehhhjhhl}r^(hr]r_ht]r`hp]rahn]rbhv]rcuhyK0hzhh]]rdh—XGentoorerf}rg(hbj]hdj[ubaubh)rh}ri(hbX¥Gentoo ships the phpMyAdmin package, both in a near stock configuration as well
as in a ``webapp-config`` configuration. Use ``emerge dev-db/phpmyadmin`` to
install.rjhdjRhehhhjhŸhl}rk(hr]rlht]rmhp]rnhn]rohv]rpuhyK2hzhh]]rq(h—XXGentoo ships the phpMyAdmin package, both in a near stock configuration as well
as in a rrrs}rt(hbXXGentoo ships the phpMyAdmin package, both in a near stock configuration as well
as in a ruhdjhubja)rv}rw(hbX``webapp-config``rxhl}ry(hr]rzht]r{hp]r|hn]r}hv]r~uhdjhh]]rh—X
webapp-configr€r}r(hbUhdjvubahjjoubh—X configuration. Use rƒr„}r…(hbX configuration. Use r†hdjhubja)r‡}rˆ(hbX``emerge dev-db/phpmyadmin``r‰hl}rŠ(hr]rht]rŒhp]rhn]rŽhv]ruhdjhh]]rh—Xemerge dev-db/phpmyadminrr}r“(hbUhdj‡ubahjjoubh—X to
install.r”r•}r(hbX to
install.r—hdjhubeubeubh|)r˜}r™(hbUhdjthehhhjhhl}rš(hr]rht]rœhp]rhn]ržhZahv]rŸh*auhyK7hzhh]]r (h)}r¢(hbXMandrivar£hdj˜hehhhjhhl}r¤(hr]r¥ht]r¦hp]r§hn]r¨hv]r©uhyK7hzhh]]rªh—XMandrivar«}r­(hbj£hdj¡ubaubh)}r¯(hbXtMandriva ships the phpMyAdmin package in their ``contrib`` branch and can be
installed via the usual Control Center.r°hdj˜hehhhjhŸhl}r±(hr]r²ht]r³hp]r´hn]rµhv]r¶uhyK9hzhh]]r·(h—X/Mandriva ships the phpMyAdmin package in their r¸}rº(hbX/Mandriva ships the phpMyAdmin package in their r»hdj®ubja)}r½(hbX ``contrib``r¾hl}r¿(hr]rÀht]rÁhp]rÂhn]rÃhv]rÄuhdj®h]]rÅh—XcontribrÆ}rÈ(hbUhdj¼ubahjjoubh—X: branch and can be
installed via the usual Control Center.rÉ}rË(hbX: branch and can be
installed via the usual Control Center.rÌhdj®ubeubeubh|)}rÎ(hbUhdjthehhhjhhl}rÏ(hr]rÐht]rÑhp]rÒhn]rÓhAahv]rÔhauhyK=hzhh]]rÕ(h)}r×(hbXFedorarØhdjÍhehhhjhhl}rÙ(hr]rÚht]rÛhp]rÜhn]rÝhv]rÞuhyK=hzhh]]rßh—XFedorarà}râ(hbjØhdjÖubaubh)}rä(hbX»Fedora ships the phpMyAdmin package, but be aware that the configuration file
is maintained in ``/etc/phpMyAdmin/`` and may differ in some ways from the
official phpMyAdmin documentation.råhdjÍhehhhjhŸhl}ræ(hr]rçht]rèhp]réhn]rêhv]rëuhyK?hzhh]]rì(h—X_Fedora ships the phpMyAdmin package, but be aware that the configuration file
is maintained in rí}rï(hbX_Fedora ships the phpMyAdmin package, but be aware that the configuration file
is maintained in rðhdjãubja)}rò(hbX``/etc/phpMyAdmin/``róhl}rô(hr]rõht]röhp]r÷hn]røhv]rùuhdjãh]]rúh—X/etc/phpMyAdmin/rû}rý(hbUhdjñubahjjoubh—XH and may differ in some ways from the
official phpMyAdmin documentation.rþrÿ}r(hbXH and may differ in some ways from the
official phpMyAdmin documentation.rhdjãubeubeubh|)r}r(hbUhdjthehhhjhhl}r(hr]rht]rhp]rhn]rh7ahv]r hauhyKDhzhh]]r
(h)r }r (hbXRed Hat Enterprise Linuxr
hdjhehhhjhhl}r(hr]rht]rhp]rhn]rhv]ruhyKDhzhh]]rh—XRed Hat Enterprise Linuxrr}r(hbj
hdj ubaubh)r}r(hbXµRed Hat Enterprise Linux itself and thus derivatives like CentOS don't
ship phpMyAdmin, but the Fedora-driven repository
`Extra Packages for Enterprise Linux (EPEL) <http://fedoraproject.org/wiki/EPEL>`_
is doing so, if it's
`enabled <http://fedoraproject.org/wiki/EPEL/FAQ#howtouse>`_.
But be aware that the configuration file is maintained in
``/etc/phpMyAdmin/`` and may differ in some ways from the
official phpMyAdmin documentation.rhdjhehhhjhŸhl}r(hr]rht]rhp]rhn]rhv]r uhyKFhzhh]]r!(h—XyRed Hat Enterprise Linux itself and thus derivatives like CentOS don't
ship phpMyAdmin, but the Fedora-driven repository
r"r#}r$(hbXyRed Hat Enterprise Linux itself and thus derivatives like CentOS don't
ship phpMyAdmin, but the Fedora-driven repository
r%hdjubjð)r&}r'(hbXR`Extra Packages for Enterprise Linux (EPEL) <http://fedoraproject.org/wiki/EPEL>`_r(hl}r)(Unamer*X*Extra Packages for Enterprise Linux (EPEL)r+X"http://fedoraproject.org/wiki/EPELr,hn]r-hp]r.hr]r/ht]r0hv]r1uhdjh]]r2h—X*Extra Packages for Enterprise Linux (EPEL)r3r4}r5(hbUhdj&ubahjjubh_)r6}r7(hbX% <http://fedoraproject.org/wiki/EPEL>r8jKhdjhjhkhl}r9(Urefurir:j,hn]r;hLahp]r<hr]r=ht]r>hv]r?hauh]]r@ubh—X
is doing so, if it's
rArB}rC(hbX
is doing so, if it's
rDhdjubjð)rE}rF(hbX<`enabled <http://fedoraproject.org/wiki/EPEL/FAQ#howtouse>`_rGhl}rH(UnamerIXenabledrJX/http://fedoraproject.org/wiki/EPEL/FAQ#howtouserKhn]rLhp]rMhr]rNht]rOhv]rPuhdjh]]rQh—XenabledrRrS}rT(hbUhdjEubahjjubh_)rU}rV(hbX2 <http://fedoraproject.org/wiki/EPEL/FAQ#howtouse>rWjKhdjhjhkhl}rX(UrefurirYjKhn]rZhVahp]r[hr]r\ht]r]hv]r^h&auh]]r_ubh—X<.
But be aware that the configuration file is maintained in
r`ra}rb(hbX<.
But be aware that the configuration file is maintained in
rchdjubja)rd}re(hbX``/etc/phpMyAdmin/``rfhl}rg(hr]rhht]rihp]rjhn]rkhv]rluhdjh]]rmh—X/etc/phpMyAdmin/rnro}rp(hbUhdjdubahjjoubh—XH and may differ in some ways from the
official phpMyAdmin documentation.rqrr}rs(hbXH and may differ in some ways from the
official phpMyAdmin documentation.rthdjubeubeubeubh|)ru}rv(hbUhdh}hehhhjhhl}rw(hr]rxht]ryhp]rzhn]r{h<ahv]r|h auhyKQhzhh]]r}(h)r~}r(hbXInstalling on Windowsr€hdjuhehhhjhhl}r(hr]rht]rƒhp]r„hn]r…hv]r†uhyKQhzhh]]r‡h—XInstalling on Windowsrˆr‰}rŠ(hbj€hdj~ubaubh)r}rŒ(hbXÊThe easiest way to get phpMyAdmin on Windows is using third party products
which include phpMyAdmin together with a database and web server such as
`XAMPP <http://www.apachefriends.org/en/xampp.html>`_.rhdjuhehhhjhŸhl}rŽ(hr]rht]rhp]rhn]rhv]r“uhyKShzhh]]r”(h—X”The easiest way to get phpMyAdmin on Windows is using third party products
which include phpMyAdmin together with a database and web server such as
r•r}r—(hbX”The easiest way to get phpMyAdmin on Windows is using third party products
which include phpMyAdmin together with a database and web server such as
r˜hdjubjð)r™}rš(hbX5`XAMPP <http://www.apachefriends.org/en/xampp.html>`_rhl}rœ(UnamerXXAMPPržX*http://www.apachefriends.org/en/xampp.htmlrŸhn]r hp]r¡hr]r¢ht]r£hv]r¤uhdjh]]r¥h—XXAMPPr¦}r¨(hbUhdj™ubahjjubh_)}rª(hbX- <http://www.apachefriends.org/en/xampp.html>r«jKhdjhjhkhl}r¬(Urefurir­hn]r®h6ahp]r¯hr]r°ht]r±hv]r²hauh]]r³ubh—X.…r´}rµ(hbX.hdjubeubh)}r·(hbXgYou can find more of such options at `Wikipedia <https://en.wikipedia.org/wiki/List_of_AMP_packages>`_.r¸hdjuhehhhjhŸhl}r¹(hr]rºht]r»hp]r¼hn]r½hv]r¾uhyKWhzhh]]r¿(h—X%You can find more of such options at rÀ}rÂ(hbX%You can find more of such options at rÃhdj¶ubjð)}rÅ(hbXA`Wikipedia <https://en.wikipedia.org/wiki/List_of_AMP_packages>`_rÆhl}rÇ(UnamerÈX WikipediarÉX2https://en.wikipedia.org/wiki/List_of_AMP_packagesrÊhn]rËhp]rÌhr]rÍht]rÎhv]rÏuhdj¶h]]rÐh—X WikipediarÑ}rÓ(hbUhdjÄubahjjubh_)}rÕ(hbX5 <https://en.wikipedia.org/wiki/List_of_AMP_packages>rÖjKhdj¶hjhkhl}r×(UrefurirØhn]rÙhCahp]rÚhr]rÛht]rÜhv]rÝhauh]]rÞubh—X.…}rà(hbX.hdj¶ubeubh_)}râ(hbX.. _quick_install:rãhdjuhehhhjhkhl}rä(hn]råhp]ræhr]rçht]rèhv]réhxh@uhyKZhzhh]]rêubeubh|)}rì(hbUhdh}hehhh}ríhshjhhl}rî(hr]rïht]rðhp]rñhn]rò(h@h:ehv]ró(h
heuhyK]hzhhˆ}rôh@jásh]]rõ(h)}r÷(hbX
Quick Installrøhdjëhehhhjhhl}rù(hr]rúht]rûhp]rühn]rýhv]rþuhyK]hzhh]]rÿh—X
Quick Installrr}r(hbjøhdjöubaubcdocutils.nodes
enumerated_list
r)r}r(hbUhdjëhehhhjUenumerated_listrhl}r(UsuffixrU.hn]r hp]r
hr]r Uprefixr Uht]r
hv]rUenumtyperUarabicruhyK_hzhh]]r(cdocutils.nodes
list_item
r)r}r(hbXøChoose an appropriate distribution kit from the phpmyadmin.net
Downloads page. Some kits contain only the English messages, others
contain all languages. We'll assume you chose a kit whose name
looks like ``phpMyAdmin-x.x.x -all-languages.tar.gz``.rhdjhehhhjU list_itemrhl}r(hr]rht]rhp]rhn]rhv]ruhyNhzhh]]rh)r}r(hbXøChoose an appropriate distribution kit from the phpmyadmin.net
Downloads page. Some kits contain only the English messages, others
contain all languages. We'll assume you chose a kit whose name
looks like ``phpMyAdmin-x.x.x -all-languages.tar.gz``.r hdjhehhhjhŸhl}r!(hr]r"ht]r#hp]r$hn]r%hv]r&uhyK_h]]r'(h—XÍChoose an appropriate distribution kit from the phpmyadmin.net
Downloads page. Some kits contain only the English messages, others
contain all languages. We'll assume you chose a kit whose name
looks like r(r)}r*(hbXÍChoose an appropriate distribution kit from the phpmyadmin.net
Downloads page. Some kits contain only the English messages, others
contain all languages. We'll assume you chose a kit whose name
looks like r+hdjubja)r,}r-(hbX*``phpMyAdmin-x.x.x -all-languages.tar.gz``r.hl}r/(hr]r0ht]r1hp]r2hn]r3hv]r4uhdjh]]r5h—X&phpMyAdmin-x.x.x -all-languages.tar.gzr6r7}r8(hbUhdj,ubahjjoubh—X.…r9}r:(hbX.hdjubeubaubj)r;}r<(hbX^Untar or unzip the distribution (be sure to unzip the subdirectories):
``tar -xzvf phpMyAdmin_x.x.x-all-languages.tar.gz`` in your
webserver's document root. If you don't have direct access to your
document root, put the files in a directory on your local machine,
and, after step 4, transfer the directory on your web server using,
for example, ftp.r=hdjhehhhjjhl}r>(hr]r?ht]r@hp]rAhn]rBhv]rCuhyNhzhh]]rDh)rE}rF(hbX^Untar or unzip the distribution (be sure to unzip the subdirectories):
``tar -xzvf phpMyAdmin_x.x.x-all-languages.tar.gz`` in your
webserver's document root. If you don't have direct access to your
document root, put the files in a directory on your local machine,
and, after step 4, transfer the directory on your web server using,
for example, ftp.rGhdj;hehhhjhŸhl}rH(hr]rIht]rJhp]rKhn]rLhv]rMuhyKch]]rN(h—XGUntar or unzip the distribution (be sure to unzip the subdirectories):
rOrP}rQ(hbXGUntar or unzip the distribution (be sure to unzip the subdirectories):
rRhdjEubja)rS}rT(hbX3``tar -xzvf phpMyAdmin_x.x.x-all-languages.tar.gz``rUhl}rV(hr]rWht]rXhp]rYhn]rZhv]r[uhdjEh]]r\h—X/tar -xzvf phpMyAdmin_x.x.x-all-languages.tar.gzr]r^}r_(hbUhdjSubahjjoubh—Xä in your
webserver's document root. If you don't have direct access to your
document root, put the files in a directory on your local machine,
and, after step 4, transfer the directory on your web server using,
for example, ftp.r`ra}rb(hbXä in your
webserver's document root. If you don't have direct access to your
document root, put the files in a directory on your local machine,
and, after step 4, transfer the directory on your web server using,
for example, ftp.rchdjEubeubaubj)rd}re(hbXíEnsure that all the scripts have the appropriate owner (if PHP is
running in safe mode, having some scripts with an owner different from
the owner of other scripts will be a problem). See :ref:`faq4_2` and
:ref:`faq1_26` for suggestions.rfhdjhehhhjjhl}rg(hr]rhht]rihp]rjhn]rkhv]rluhyNhzhh]]rmh)rn}ro(hbXíEnsure that all the scripts have the appropriate owner (if PHP is
running in safe mode, having some scripts with an owner different from
the owner of other scripts will be a problem). See :ref:`faq4_2` and
:ref:`faq1_26` for suggestions.rphdjdhehhhjhŸhl}rq(hr]rrht]rshp]rthn]ruhv]rvuhyKih]]rw(h—X¼Ensure that all the scripts have the appropriate owner (if PHP is
running in safe mode, having some scripts with an owner different from
the owner of other scripts will be a problem). See rxry}rz(hbX¼Ensure that all the scripts have the appropriate owner (if PHP is
running in safe mode, having some scripts with an owner different from
the owner of other scripts will be a problem). See r{hdjnubhÖ)r|}r}(hbX
:ref:`faq4_2`r~hdjnhehhhjhÚhl}r(Ureftyper€XrefrhÞˆhßXfaq4_2rU refdomainrƒXstdr„hn]r…hp]r†U refexplicitr‡‰hr]rˆht]r‰hv]rŠhéhêuhyKih]]rh«)}r(hbj~hl}rŽ(hr]rht]r(hñj„Xstd-refrehp]rhn]r“hv]r”uhdj|h]]r•h—Xfaq4_2rr—}r˜(hbUhdjŒubahjh»ubaubh—X and
r™}r(hbX and
hdjnubhÖ)r}rž(hbX:ref:`faq1_26`rŸhdjnhehhhjhÚhl}r (Ureftyper¡Xrefr¢hÞˆhßXfaq1_26r£U refdomainr¤Xstdr¥hn]r¦hp]r§U refexplicitr¨‰hr]r©ht]rªhv]r«héhêuhyKih]]r¬h«)r­}r®(hbjŸhl}r¯(hr]r°ht]r±(hñj¥Xstd-refr²ehp]r³hn]r´hv]rµuhdjh]]r¶h—Xfaq1_26r·r¸}r¹(hbUhdj­ubahjh»ubaubh—X for suggestions.rº}r¼(hbX for suggestions.r½hdjnubeubaubj)}r¿(hbXgNow you must configure your installation. There are two methods that
can be used. Traditionally, users have hand-edited a copy of
:file:`config.inc.php`, but now a wizard-style setup script is provided
for those who prefer a graphical installation. Creating a
:file:`config.inc.php` is still a quick way to get started and needed for
some advanced features.
hdjhehhhjjhl}rÁ(hr]rÂht]rÃhp]rÄhn]rÅhv]rÆuhyNhzhh]]rÇh)}rÉ(hbXeNow you must configure your installation. There are two methods that
can be used. Traditionally, users have hand-edited a copy of
:file:`config.inc.php`, but now a wizard-style setup script is provided
for those who prefer a graphical installation. Creating a
:file:`config.inc.php` is still a quick way to get started and needed for
some advanced features.rÊhdj¾hehhhjhŸhl}rË(hr]rÌht]rÍhp]rÎhn]rÏhv]rÐuhyKmh]]rÑ(h—XNow you must configure your installation. There are two methods that
can be used. Traditionally, users have hand-edited a copy of
}rÔ(hbXNow you must configure your installation. There are two methods that
can be used. Traditionally, users have hand-edited a copy of
hdjÈubja)}r×(hbUhl}rØ(hn]rÙhp]rÚhr]rÛht]rÜXfilerÝaUrolerÞhv]rßuhdjÈh]]ràh—Xconfig.inc.phprá}rã(hbXconfig.inc.phprähdjÖubahjjoubh—Xl, but now a wizard-style setup script is provided
for those who prefer a graphical installation. Creating a
}rç(hbXl, but now a wizard-style setup script is provided
for those who prefer a graphical installation. Creating a
hdjÈubja)}rê(hbUhl}rë(hn]rìhp]ríhr]rîht]rïXfilerðaUrolerñhv]ròuhdjÈh]]róh—Xconfig.inc.phprô}rö(hbXconfig.inc.phpr÷hdjéubahjjoubh—XK is still a quick way to get started and needed for
some advanced features.rø}rú(hbXK is still a quick way to get started and needed for
some advanced features.rûhdjÈubeubaubeubh|)}rý(hbUhdjëhehhhjhhl}rþ(hr]rÿht]rhp]rhn]rhQahv]rh!auhyKvhzhh]]r(h)r}r(hbXManually creating the filerhdjühehhhjhhl}r(hr]r ht]r
hp]r hn]r hv]r
uhyKvhzhh]]rh—XManually creating the filerr}r(hbjhdjubaubh)r}r(hbX[To manually create the file, simply use your text editor to create the
file :file:`config.inc.php` (you can copy :file:`config.sample.inc.php` to get
minimal configuration file) in the main (top-level) phpMyAdmin
directory (the one that contains :file:`index.php`). phpMyAdmin first
loads :file:`libraries/config.default.php` and then overrides those values
with anything found in :file:`config.inc.php`. If the default value is
okay for a particular setting, there is no need to include it in
:file:`config.inc.php`. You'll need a few directives to get going, a
simple configuration may look like this:rhdjühehhhjhŸhl}r(hr]rht]rhp]rhn]rhv]ruhyKxhzhh]]r(h—XLTo manually create the file, simply use your text editor to create the
file rr}r(hbXLTo manually create the file, simply use your text editor to create the
file rhdjubja)r }r!(hbUhl}r"(hn]r#hp]r$hr]r%ht]r&Xfiler'aUroler(j'hv]r)uhdjh]]r*h—Xconfig.inc.phpr+r,}r-(hbXconfig.inc.phpr.hdj ubahjjoubh—X (you can copy r/r0}r1(hbX (you can copy r2hdjubja)r3}r4(hbUhl}r5(hn]r6hp]r7hr]r8ht]r9Xfiler:aUroler;j:hv]r<uhdjh]]r=h—Xconfig.sample.inc.phpr>r?}r@(hbXconfig.sample.inc.phprAhdj3ubahjjoubh—Xh to get
minimal configuration file) in the main (top-level) phpMyAdmin
directory (the one that contains rBrC}rD(hbXh to get
minimal configuration file) in the main (top-level) phpMyAdmin
directory (the one that contains rEhdjubja)rF}rG(hbUhl}rH(hn]rIhp]rJhr]rKht]rLXfilerMaUrolerNjMhv]rOuhdjh]]rPh—X index.phprQrR}rS(hbX index.phprThdjFubahjjoubh—X). phpMyAdmin first
loads rUrV}rW(hbX). phpMyAdmin first
loads rXhdjubja)rY}rZ(hbUhl}r[(hn]r\hp]r]hr]r^ht]r_Xfiler`aUroleraj`hv]rbuhdjh]]rch—Xlibraries/config.default.phprdre}rf(hbXlibraries/config.default.phprghdjYubahjjoubh—X8 and then overrides those values
with anything found in rhri}rj(hbX8 and then overrides those values
with anything found in rkhdjubja)rl}rm(hbUhl}rn(hn]rohp]rphr]rqht]rrXfilersaUrolertjshv]ruuhdjh]]rvh—Xconfig.inc.phprwrx}ry(hbXconfig.inc.phprzhdjlubahjjoubh—X[. If the default value is
okay for a particular setting, there is no need to include it in
r{r|}r}(hbX[. If the default value is
okay for a particular setting, there is no need to include it in
r~hdjubja)r}r€(hbUhl}r(hn]rhp]rƒhr]r„ht]r…Xfiler†aUroler‡j†hv]rˆuhdjh]]r‰h—Xconfig.inc.phprŠr}rŒ(hbXconfig.inc.phprhdjubahjjoubh—XW. You'll need a few directives to get going, a
simple configuration may look like this:rŽr}r(hbXW. You'll need a few directives to get going, a
simple configuration may look like this:rhdjubeubcdocutils.nodes
literal_block
r)r“}r”(hbX˜<?php
$cfg['blowfish_secret'] = 'ba17c1ec07d65003'; // use here a value of your choice
$i=0;
$i++;
$cfg['Servers'][$i]['auth_type'] = 'cookie';
?>r•hdjühehhhjU
literal_blockrhl}r—(Ulinenosr˜‰Ulanguager™Xxml+phpršU xml:spacerUpreserverœhn]rhp]ržhr]rŸht]r hv]r¡uhyKhzhh]]r¢h—X˜<?php
$cfg['blowfish_secret'] = 'ba17c1ec07d65003'; // use here a value of your choice
$i=0;
$i++;
$cfg['Servers'][$i]['auth_type'] = 'cookie';
?>r£}r¥(hbUhdj“ubaubh)}r§(hbX;Or, if you prefer to not be prompted every time you log in:r¨hdjühehhhjhŸhl}r©(hr]rªht]r«hp]r¬hn]r­hv]r®uhyKhzhh]]r¯h—X;Or, if you prefer to not be prompted every time you log in:r°}r²(hbj¨hdj¦ubaubj)}r´(hbXÁ<?php
$i=0;
$i++;
$cfg['Servers'][$i]['user'] = 'root';
$cfg['Servers'][$i]['password'] = 'cbb74bc'; // use here your password
$cfg['Servers'][$i]['auth_type'] = 'config';
?>rµhdjühehhhjjhl}r¶(j˜‰j™Xxml+phpr·jhn]r¸hp]r¹hr]rºht]r»hv]r¼uhyKhzhh]]r½h—XÁ<?php
$i=0;
$i++;
$cfg['Servers'][$i]['user'] = 'root';
$cfg['Servers'][$i]['password'] = 'cbb74bc'; // use here your password
$cfg['Servers'][$i]['auth_type'] = 'config';
?>r¾r¿}rÀ(hbUhdj³ubaubh)}rÂ(hbX`For a full explanation of possible configuration values, see the
:ref:`config` of this document.rÃhdjühehhhjhŸhl}rÄ(hr]rÅht]rÆhp]rÇhn]rÈhv]rÉuhyKhzhh]]rÊ(h—XAFor a full explanation of possible configuration values, see the
}rÍ(hbXAFor a full explanation of possible configuration values, see the
hdjÁubhÖ)}rÐ(hbX
:ref:`config`rÑhdjÁhehhhjhÚhl}rÒ(UreftyperÓXrefrÔhÞˆhßXconfigrÕU refdomainrÖXstdr×hn]rØhp]rÙU refexplicitrÚ‰hr]rÛht]rÜhv]rÝhéhêuhyKh]]rÞh«)}rà(hbjÑhl}rá(hr]râht]rã(hñj×Xstd-refräehp]råhn]ræhv]rçuhdjÏh]]rèh—Xconfigré}rë(hbUhdjßubahjh»ubaubh—X of this document.rì}rî(hbX of this document.rïhdjÁubeubcsphinx.addnodes
index
)}rò(hbUhdjühehhhjUindexróhl}rô(hn]rõhp]röhr]r÷ht]røhv]rùUentriesrú]rû(UsinglerüX Setup scriptUindex-0rýUtrþaUinlinerÿ‰uhyKŸhzhh]]rubh_)r}r(hbUhdjühehhhjhkhl}r(hn]rhp]rhr]rht]rhv]rhxjýuhyKŸhzhh]]r ubh_)r
}r (hbX.. _setup_script:r hdjühehhh}r
hjhkhl}r(hn]rhp]rhr]rht]rhv]rhxh9uhyK hzhhˆ}rjsh]]rubeubh|)r}r(hbUhdjëhehhh}rh j
shjhhl}r(hr]rht]rhp]rhn]r(h=h9jýehv]r(h
h euhyK£hzhhˆ}r(jýjh9j
uh]]r (h)r!}r"(hbXUsing Setup scriptr#hdjhehhhjhhl}r$(hr]r%ht]r&hp]r'hn]r(hv]r)uhyK£hzhh]]r*h—XUsing Setup scriptr+r,}r-(hbj#hdj!ubaubh)r.}r/(hbXInstead of manually editing :file:`config.inc.php`, you can use the `Setup
Script <setup/>`_. First you must manually create a folder ``config``
in the phpMyAdmin directory. This is a security measure. On a
Linux/Unix system you can use the following commands:r0hdjhehhhjhŸhl}r1(hr]r2ht]r3hp]r4hn]r5hv]r6uhyK¥hzhh]]r7(h—XInstead of manually editing r8r9}r:(hbXInstead of manually editing r;hdj.ubja)r<}r=(hbUhl}r>(hn]r?hp]r@hr]rAht]rBXfilerCaUrolerDjChv]rEuhdj.h]]rFh—Xconfig.inc.phprGrH}rI(hbXconfig.inc.phprJhdj<ubahjjoubh—X, you can use the rKrL}rM(hbX, you can use the rNhdj.ubjð)rO}rP(hbX`Setup
Script <setup/>`_rQhl}rR(UnamerSX Setup ScriptrTXsetup/rUhn]rVhp]rWhr]rXht]rYhv]rZuhdj.h]]r[h—X Setup
Scriptr\r]}r^(hbUhdjOubahjjubh_)r_}r`(hbX <setup/>rajKhdj.hjhkhl}rb(UrefurircjUhn]rdhGahp]rehr]rfht]rghv]rhhauh]]riubh—X*. First you must manually create a folder rjrk}rl(hbX*. First you must manually create a folder rmhdj.ubja)rn}ro(hbX
``config``rphl}rq(hr]rrht]rshp]rthn]ruhv]rvuhdj.h]]rwh—Xconfigrxry}rz(hbUhdjnubahjjoubh—Xt
in the phpMyAdmin directory. This is a security measure. On a
Linux/Unix system you can use the following commands:r{r|}r}(hbXt
in the phpMyAdmin directory. This is a security measure. On a
Linux/Unix system you can use the following commands:r~hdj.ubeubj)r}r€(hbX˜cd phpMyAdmin
mkdir config # create directory for saving
chmod o+rw config # give it world writable permissionsrhdjhehhhjjhl}r(j˜‰j™Xshrƒjhn]r„hp]r…hr]r†ht]r‡hv]rˆuhyKªhzhh]]r‰h—X˜cd phpMyAdmin
mkdir config # create directory for saving
chmod o+rw config # give it world writable permissionsrŠr}rŒ(hbUhdjubaubh)r}rŽ(hbX:And to edit an existing configuration, copy it over first:rhdjhehhhjhŸhl}r(hr]rht]rhp]r“hn]r”hv]r•uhyK±hzhh]]rh—X:And to edit an existing configuration, copy it over first:r—r˜}r™(hbjhdjubaubj)}r(hbX•cp config.inc.php config/ # copy current configuration for editing
chmod o+w config/config.inc.php # give it world writable permissionsrœhdjhehhhjjhl}r(j˜‰j™Xshržjhn]rŸhp]r hr]r¡ht]r¢hv]r£uhyK³hzhh]]r¤h—X•cp config.inc.php config/ # copy current configuration for editing
chmod o+w config/config.inc.php # give it world writable permissionsr¥}r§(hbUhdjšubaubh)}r©(hbXOn other platforms, simply create the folder and ensure that your web
server has read and write access to it. :ref:`faq1_26` can help with
this.rªhdjhehhhjhŸhl}r«(hr]r¬ht]r­hp]r®hn]r¯hv]r°uhyK¹hzhh]]r±(h—XnOn other platforms, simply create the folder and ensure that your web
server has read and write access to it. r²}r´(hbXnOn other platforms, simply create the folder and ensure that your web
server has read and write access to it. rµhdj¨ubhÖ)}r·(hbX:ref:`faq1_26`r¸hdj¨hehhhjhÚhl}r¹(UreftyperºXrefr»hÞˆhßXfaq1_26r¼U refdomainr½Xstdr¾hn]r¿hp]rÀU refexplicitrÁ‰hr]rÂht]rÃhv]rÄhéhêuhyK¹h]]rÅh«)}rÇ(hbj¸hl}rÈ(hr]rÉht]rÊ(hñj¾Xstd-refrËehp]rÌhn]rÍhv]rÎuhdj¶h]]rÏh—Xfaq1_26rÐ}rÒ(hbUhdjÆubahjh»ubaubh—X can help with
this.rÓ}rÕ(hbX can help with
this.rÖhdj¨ubeubh)r×}rØ(hbX©Next, open ``setup/`` in your browser. If you have an existing configuration,
use the ``Load`` button to bring its content inside the setup panel.
Note that **changes are not saved to disk until explicitly choose ``Save``**
from the *Configuration* area of the screen. Normally the script saves the new
:file:`config.inc.php` to the ``config/`` directory, but if the webserver does
not have the proper permissions you may see the error "Cannot load or
save configuration." Ensure that the ``config/`` directory exists and
has the proper permissions - or use the ``Download`` link to save the
config file locally and upload it (via FTP or some similar means) to the
proper location.rÙhdjhehhhjhŸhl}rÚ(hr]rÛht]rÜhp]rÝhn]rÞhv]rßuhyK½hzhh]]rà(h—X Next, open rá}rã(hbX Next, open rähdj×ubja)}ræ(hbX
``setup/``rçhl}rè(hr]réht]rêhp]rëhn]rìhv]ríuhdj×h]]rîh—Xsetup/rï}rñ(hbUhdjåubahjjoubh—XA in your browser. If you have an existing configuration,
use the rò}rô(hbXA in your browser. If you have an existing configuration,
use the rõhdj×ubja)}r÷(hbX``Load``røhl}rù(hr]rúht]rûhp]rühn]rýhv]rþuhdj×h]]rÿh—XLoadrr}r(hbUhdjöubahjjoubh—X? button to bring its content inside the setup panel.
Note that rr}r(hbX? button to bring its content inside the setup panel.
Note that rhdj×ubcdocutils.nodes
strong
r)r}r (hbXB**changes are not saved to disk until explicitly choose ``Save``**r
hl}r (hr]r ht]r
hp]rhn]rhv]ruhdj×h]]rh—X>changes are not saved to disk until explicitly choose ``Save``rr}r(hbUhdjubahjUstrongrubh—X
from the rr}r(hbX
from the rhdj×ubh«)r}r(hbX*Configuration*rhl}r(hr]rht]rhp]r hn]r!hv]r"uhdj×h]]r#h—X
Configurationr$r%}r&(hbUhdjubahjh»ubh—X7 area of the screen. Normally the script saves the new
r'r(}r)(hbX7 area of the screen. Normally the script saves the new
r*hdj×ubja)r+}r,(hbUhl}r-(hn]r.hp]r/hr]r0ht]r1Xfiler2aUroler3j2hv]r4uhdj×h]]r5h—Xconfig.inc.phpr6r7}r8(hbXconfig.inc.phpr9hdj+ubahjjoubh—X to the r:r;}r<(hbX to the r=hdj×ubja)r>}r?(hbX ``config/``r@hl}rA(hr]rBht]rChp]rDhn]rEhv]rFuhdj×h]]rGh—Xconfig/rHrI}rJ(hbUhdj>ubahjjoubh—X directory, but if the webserver does
not have the proper permissions you may see the error "Cannot load or
save configuration." Ensure that the rKrL}rM(hbX directory, but if the webserver does
not have the proper permissions you may see the error "Cannot load or
save configuration." Ensure that the rNhdj×ubja)rO}rP(hbX ``config/``rQhl}rR(hr]rSht]rThp]rUhn]rVhv]rWuhdj×h]]rXh—Xconfig/rYrZ}r[(hbUhdjOubahjjoubh—X> directory exists and
has the proper permissions - or use the r\r]}r^(hbX> directory exists and
has the proper permissions - or use the r_hdj×ubja)r`}ra(hbX ``Download``rbhl}rc(hr]rdht]rehp]rfhn]rghv]rhuhdj×h]]rih—XDownloadrjrk}rl(hbUhdj`ubahjjoubh—Xk link to save the
config file locally and upload it (via FTP or some similar means) to the
proper location.rmrn}ro(hbXk link to save the
config file locally and upload it (via FTP or some similar means) to the
proper location.rphdj×ubeubh)rq}rr(hbXOnce the file has been saved, it must be moved out of the ``config/``
directory and the permissions must be reset, again as a security
measure:rshdjhehhhjhŸhl}rt(hr]ruht]rvhp]rwhn]rxhv]ryuhyKÈhzhh]]rz(h—X:Once the file has been saved, it must be moved out of the r{r|}r}(hbX:Once the file has been saved, it must be moved out of the r~hdjqubja)r}r€(hbX ``config/``rhl}r(hr]rƒht]r„hp]r…hn]r†hv]r‡uhdjqh]]rˆh—Xconfig/r‰}r(hbUhdjubahjjoubh—XJ
directory and the permissions must be reset, again as a security
measure:rŒr}rŽ(hbXJ
directory and the permissions must be reset, again as a security
measure:rhdjqubeubj)r}r(hbXÑmv config/config.inc.php . # move file to current directory
chmod o-rw config.inc.php # remove world read and write permissions
rm -rf config # remove not needed directoryrhdjhehhhjjhl}r“(j˜‰j™Xshr”jhn]r•hp]rhr]r—ht]r˜hv]r™uhyKÌhzhh]]ršh—XÑmv config/config.inc.php . # move file to current directory
chmod o-rw config.inc.php # remove world read and write permissions
rm -rf config # remove not needed directoryr}r(hbUhdjubaubh)}rŸ(hbXºNow the file is ready to be used. You can choose to review or edit the
file with your favorite editor, if you prefer to set some advanced
options which the setup script does not provide.r hdjhehhhjhŸhl}r¡(hr]r¢ht]r£hp]r¤hn]r¥hv]r¦uhyKÓhzhh]]r§h—XºNow the file is ready to be used. You can choose to review or edit the
file with your favorite editor, if you prefer to set some advanced
options which the setup script does not provide.r¨}rª(hbj hdjžubaubj)}r¬(hbUhdjhehhhjjhl}r­(jU.hn]r®hp]r¯hr]r°j Uht]r±hv]r²jjuhyK×hzhh]]r³(j)r´}rµ(hbXÑIf you are using the ``auth_type`` "config", it is suggested that you
protect the phpMyAdmin installation directory because using config
does not require a user to enter a password to access the phpMyAdmin
installation. Use of an alternate authentication method is
recommended, for example with HTTP–AUTH in a :term:`.htaccess` file or switch to using
``auth_type`` cookie or http. See the :ref:`faqmultiuser`
for additional information, especially :ref:`faq4_4`.r¶hdj«hehhhjjhl}r·(hr]r¸ht]r¹hp]rºhn]r»hv]r¼uhyNhzhh]]r½h)}r¿(hbXÑIf you are using the ``auth_type`` "config", it is suggested that you
protect the phpMyAdmin installation directory because using config
does not require a user to enter a password to access the phpMyAdmin
installation. Use of an alternate authentication method is
recommended, for example with HTTP–AUTH in a :term:`.htaccess` file or switch to using
``auth_type`` cookie or http. See the :ref:`faqmultiuser`
for additional information, especially :ref:`faq4_4`.rÀhdj´hehhhjhŸhl}rÁ(hr]rÂht]rÃhp]rÄhn]rÅhv]rÆuhyK×h]]rÇ(h—XIf you are using the rÈ}rÊ(hbXIf you are using the rËhdj¾ubja)}rÍ(hbX
``auth_type``rÎhl}rÏ(hr]rÐht]rÑhp]rÒhn]rÓhv]rÔuhdj¾h]]rÕh—X auth_typerÖr×}rØ(hbUhdjÌubahjjoubh—X "config", it is suggested that you
protect the phpMyAdmin installation directory because using config
does not require a user to enter a password to access the phpMyAdmin
installation. Use of an alternate authentication method is
recommended, for example with HTTP–AUTH in a rÙ}rÛ(hbX "config", it is suggested that you
protect the phpMyAdmin installation directory because using config
does not require a user to enter a password to access the phpMyAdmin
installation. Use of an alternate authentication method is
recommended, for example with HTTP–AUTH in a rÜhdj¾ubhÖ)}rÞ(hbX:term:`.htaccess`rßhdj¾hehhhjhÚhl}rà(UreftyperáXtermrâhÞˆhßX .htaccessrãU refdomainräXstdråhn]ræhp]rçU refexplicitrè‰hr]réht]rêhv]rëhéhêuhyK×h]]rìh«)}rî(hbjßhl}rï(hr]rðht]rñ(hñjåXstd-termròehp]róhn]rôhv]rõuhdjÝh]]röh—X .htaccessr÷}rù(hbUhdjíubahjh»ubaubh—X file or switch to using
}rü(hbX file or switch to using
hdj¾ubja)}rÿ(hbX
``auth_type``rhl}r(hr]rht]rhp]rhn]rhv]ruhdj¾h]]rh—X auth_typerr }r
(hbUhdjþubahjjoubh—X cookie or http. See the r r }r
(hbX cookie or http. See the rhdj¾ubhÖ)r}r(hbX:ref:`faqmultiuser`rhdj¾hehhhjhÚhl}r(UreftyperXrefrhÞˆhßX faqmultiuserrU refdomainrXstdrhn]rhp]rU refexplicitr‰hr]rht]rhv]rhéhêuhyK×h]]rh«)r}r (hbjhl}r!(hr]r"ht]r#(hñjXstd-refr$ehp]r%hn]r&hv]r'uhdjh]]r(h—X faqmultiuserr)r*}r+(hbUhdjubahjh»ubaubh—X(
for additional information, especially r,r-}r.(hbX(
for additional information, especially r/hdj¾ubhÖ)r0}r1(hbX
:ref:`faq4_4`r2hdj¾hehhhjhÚhl}r3(Ureftyper4Xrefr5hÞˆhßXfaq4_4r6U refdomainr7Xstdr8hn]r9hp]r:U refexplicitr;‰hr]r<ht]r=hv]r>héhêuhyK×h]]r?h«)r@}rA(hbj2hl}rB(hr]rCht]rD(hñj8Xstd-refrEehp]rFhn]rGhv]rHuhdj0h]]rIh—Xfaq4_4rJrK}rL(hbUhdj@ubahjh»ubaubh—X.…rM}rN(hbX.hdj¾ubeubaubj)rO}rP(hbXÌOpen the `main phpMyAdmin directory <index.php>`_ in your browser.
phpMyAdmin should now display a welcome screen and your databases, or
a login dialog if using :term:`HTTP` or
cookie authentication mode.rQhdj«hehhhjjhl}rR(hr]rSht]rThp]rUhn]rVhv]rWuhyNhzhh]]rXh)rY}rZ(hbXÌOpen the `main phpMyAdmin directory <index.php>`_ in your browser.
phpMyAdmin should now display a welcome screen and your databases, or
a login dialog if using :term:`HTTP` or
cookie authentication mode.r[hdjOhehhhjhŸhl}r\(hr]r]ht]r^hp]r_hn]r`hv]rauhyKÞh]]rb(h—X Open the rcrd}re(hbX Open the rfhdjYubjð)rg}rh(hbX(`main phpMyAdmin directory <index.php>`_rihl}rj(UnamerkXmain phpMyAdmin directoryrlX index.phprmhn]rnhp]rohr]rpht]rqhv]rruhdjYh]]rsh—Xmain phpMyAdmin directoryrtru}rv(hbUhdjgubahjjubh_)rw}rx(hbX <index.php>ryjKhdjYhjhkhl}rz(Urefurir{jmhn]r|hYahp]r}hr]r~ht]rhv]r€h)auh]]rubh—Xp in your browser.
phpMyAdmin should now display a welcome screen and your databases, or
a login dialog if using r}r„(hbXp in your browser.
phpMyAdmin should now display a welcome screen and your databases, or
a login dialog if using r…hdjYubhÖ)r†}r‡(hbX :term:`HTTP`rˆhdjYhehhhjhÚhl}r‰(UreftyperŠXtermrhÞˆhßXhttprŒU refdomainrXstdrŽhn]rhp]rU refexplicitr‰hr]rht]r“hv]r”héhêuhyKÞh]]r•h«)r}r—(hbjˆhl}r˜(hr]r™ht]rš(hñjŽXstd-termrehp]rœhn]rhv]ržuhdj†h]]rŸh—XHTTPr }r¢(hbUhdjubahjh»ubaubh—X or
cookie authentication mode.r£}r¥(hbX or
cookie authentication mode.r¦hdjYubeubaubj)}r¨(hbX|You should deny access to the ``./libraries`` and ``./setup/lib``
subfolders in your webserver configuration. For Apache you can use
supplied :term:`.htaccess` file in that folder, for other webservers, you should
configure this yourself. Such configuration prevents from possible
path exposure and cross side scripting vulnerabilities that might
happen to be found in that code.r©hdj«hehhhjjhl}rª(hr]r«ht]r¬hp]r­hn]r®hv]r¯uhyNhzhh]]r°h)}r²(hbX|You should deny access to the ``./libraries`` and ``./setup/lib``
subfolders in your webserver configuration. For Apache you can use
supplied :term:`.htaccess` file in that folder, for other webservers, you should
configure this yourself. Such configuration prevents from possible
path exposure and cross side scripting vulnerabilities that might
happen to be found in that code.r³hdj§hehhhjhŸhl}r´(hr]rµht]r¶hp]r·hn]r¸hv]r¹uhyKâh]]rº(h—XYou should deny access to the r»}r½(hbXYou should deny access to the r¾hdj±ubja)r¿}rÀ(hbX``./libraries``rÁhl}rÂ(hr]rÃht]rÄhp]rÅhn]rÆhv]rÇuhdj±h]]rÈh—X ./librariesrÉ}rË(hbUhdj¿ubahjjoubh—X and rÌ}rÎ(hbX and rÏhdj±ubja)}rÑ(hbX``./setup/lib``rÒhl}rÓ(hr]rÔht]rÕhp]rÖhn]r×hv]rØuhdj±h]]rÙh—X ./setup/librÚ}rÜ(hbUhdjÐubahjjoubh—XM
subfolders in your webserver configuration. For Apache you can use
supplied rÝ}rß(hbXM
subfolders in your webserver configuration. For Apache you can use
supplied ràhdj±ubhÖ)}râ(hbX:term:`.htaccess`rãhdj±hehhhjhÚhl}rä(UreftyperåXtermræhÞˆhßX .htaccessrçU refdomainrèXstdréhn]rêhp]rëU refexplicitrì‰hr]ríht]rîhv]rïhéhêuhyKâh]]rðh«)}rò(hbjãhl}ró(hr]rôht]rõ(hñjéXstd-termröehp]r÷hn]røhv]rùuhdjáh]]rúh—X .htaccessrû}rý(hbUhdjñubahjh»ubaubh—XÝ file in that folder, for other webservers, you should
configure this yourself. Such configuration prevents from possible
path exposure and cross side scripting vulnerabilities that might
happen to be found in that code.rþrÿ}r (hbXÝ file in that folder, for other webservers, you should
configure this yourself. Such configuration prevents from possible
path exposure and cross side scripting vulnerabilities that might
happen to be found in that code.r hdj±ubeubaubj)r }r (hbXIt is generally good idea to protect public phpMyAdmin installation
against access by robots as they usually can not do anything good
there. You can do this using ``robots.txt`` file in root of your
webserver or limit access by web server configuration, see
:ref:`faq1_42`.
r hdj«hehhhjjhl}r (hr]r ht]r hp]r hn]r hv]r
uhyNhzhh]]r h)r }r
(hbXIt is generally good idea to protect public phpMyAdmin installation
against access by robots as they usually can not do anything good
there. You can do this using ``robots.txt`` file in root of your
webserver or limit access by web server configuration, see
:ref:`faq1_42`.r hdj hehhhjhŸhl}r (hr]r ht]r hp]r hn]r hv]r uhyKèh]]r (h—X£It is generally good idea to protect public phpMyAdmin installation
against access by robots as they usually can not do anything good
there. You can do this using r r }r (hbX£It is generally good idea to protect public phpMyAdmin installation
against access by robots as they usually can not do anything good
there. You can do this using r hdj ubja)r }r (hbX``robots.txt``r hl}r (hr]r ht]r hp]r hn]r! hv]r" uhdj h]]r# h—X
robots.txtr$ r% }r& (hbUhdj ubahjjoubh—XQ file in root of your
webserver or limit access by web server configuration, see
r' r( }r) (hbXQ file in root of your
webserver or limit access by web server configuration, see
r* hdj ubhÖ)r+ }r, (hbX:ref:`faq1_42`r- hdj hehhhjhÚhl}r. (Ureftyper/ Xrefr0 hÞˆhßXfaq1_42r1 U refdomainr2 Xstdr3 hn]r4 hp]r5 U refexplicitr6 ‰hr]r7 ht]r8 hv]r9 héhêuhyKèh]]r: h«)r; }r< (hbj- hl}r= (hr]r> ht]r? (hñj3 Xstd-refr@ ehp]rA hn]rB hv]rC uhdj+ h]]rD h—Xfaq1_42rE rF }rG (hbUhdj; ubahjh»ubaubh—X.…rH }rI (hbX.hdj ubeubaubeubjð)rJ }rK (hbUhdjhehhhjjóhl}rL (hn]rM hp]rN hr]rO ht]rP hv]rQ ]rR ((jüXConfiguration storageUindex-1rS UtrT (jüX phpMyAdmin configuration storagejS UtrU (jüXpmadbjS UtrV ejÿ‰uhyKòhzhh]]rW ubh_)rX }rY (hbUhdjhehhhjhkhl}rZ (hn]r[ hp]r\ hr]r] ht]r^ hv]r_ hxjS uhyKòhzhh]]r` ubh_)ra }rb (hbX.. _linked-tables:rc hdjhehhh}rd hjhkhl}re (hn]rf hp]rg hr]rh ht]ri hv]rj hxh?uhyKóhzhhˆ}rk jS jX sh]]rl ubeubeubh|)rm }rn (hbUhdh}hehhh}ro hja shjhhl}rp (hr]rq ht]rr hp]rs hn]rt (hWh?jS ehv]ru (h'heuhyKöhzhhˆ}rv (jS jX h?ja uh]]rw (h)rx }ry (hbX phpMyAdmin configuration storagerz hdjm hehhhjhhl}r{ (hr]r| ht]r} hp]r~ hn]r hv]r€ uhyKöhzhh]]r h—X phpMyAdmin configuration storager }r„ (hbjz hdjx ubaubh)r… }r† (hbX˜For a whole set of new features (bookmarks, comments, :term:`SQL`-history,
tracking mechanism, :term:`PDF`-generation, column contents transformation,
etc.) you need to create a set of special tables. Those tables can be located
in your own database, or in a central database for a multi-user installation
(this database would then be accessed by the controluser, so no other user
should have rights to it).r‡ hdjm hehhhjhŸhl}rˆ (hr]r‰ ht]rŠ hp]r hn]rŒ hv]r uhyKøhzhh]]rŽ (h—X6For a whole set of new features (bookmarks, comments, r r }r (hbX6For a whole set of new features (bookmarks, comments, r hdj… ubhÖ)r“ }r” (hbX :term:`SQL`r• hdj… hehhhjhÚhl}r (Ureftyper— Xtermr˜ hÞˆhßXsqlr™ U refdomainrš Xstdr hn]rœ hp]r U refexplicitrž ‰hr]rŸ ht]r  hv]r¡ héhêuhyKøh]]r¢ h«)}r¤ (hbj• hl}r¥ (hr]r¦ ht]r§ (hñj Xstd-termr¨ ehp]r© hn]rª hv]r« uhdj“ h]]r¬ h—XSQLr­ }r¯ (hbUhdj£ ubahjh»ubaubh—X-history,
tracking mechanism, r° }r² (hbX-history,
tracking mechanism, r³ hdj… ubhÖ)r´ }rµ (hbX :term:`PDF`r¶ hdj… hehhhjhÚhl}r· (Ureftyper¸ Xtermr¹ hÞˆhßXpdfrº U refdomainr» Xstdr¼ hn]r½ hp]r¾ U refexplicitr¿ ‰hr]rÀ ht]rÁ hv]r héhêuhyKøh]]rà h«)}rÅ (hbj¶ hl}rÆ (hr]rÇ ht]rÈ (hñj¼ Xstd-termrÉ ehp]rÊ hn]rË hv]rÌ uhdj´ h]]rÍ h—XPDFrÎ }rÐ (hbUhdjÄ ubahjh»ubaubh—X.-generation, column contents transformation,
etc.) you need to create a set of special tables. Those tables can be located
in your own database, or in a central database for a multi-user installation
(this database would then be accessed by the controluser, so no other user
should have rights to it).rÑ }rÓ (hbX.-generation, column contents transformation,
etc.) you need to create a set of special tables. Those tables can be located
in your own database, or in a central database for a multi-user installation
(this database would then be accessed by the controluser, so no other user
should have rights to it).rÔ hdj… ubeubh)}rÖ (hbX¶Please look at your ``./examples/`` directory, where you should find a
file called *create\_tables.sql*. (If you are using a Windows server,
pay special attention to :ref:`faq1_23`).r× hdjm hehhhjhŸhl}rØ (hr]rÙ ht]rÚ hp]rÛ hn]rÜ hv]rÝ uhyKÿhzhh]]rÞ (h—XPlease look at your rß }rá (hbXPlease look at your râ hdjÕ ubja)}rä (hbX``./examples/``rå hl}ræ (hr]rç ht]rè hp]ré hn]rê hv]rë uhdjÕ h]]rì h—X ./examples/rí }rï (hbUhdjã ubahjjoubh—X0 directory, where you should find a
file called rð }rò (hbX0 directory, where you should find a
file called ró hdjÕ ubh«)}rõ (hbX*create\_tables.sql*rö hl}r÷ (hr]rø ht]rù hp]rú hn]rû hv]rü uhdjÕ h]]rý h—Xcreate_tables.sqlrþ rÿ }r
(hbUhdjô ubahjh»ubh—X?. (If you are using a Windows server,
pay special attention to r
r
}r
(hbX?. (If you are using a Windows server,
pay special attention to r
hdjÕ ubhÖ)r
}r
(hbX:ref:`faq1_23`r
hdjÕ hehhhjhÚhl}r
(Ureftyper
Xrefr
hÞˆhßXfaq1_23r
U refdomainr
Xstdr
hn]r
hp]r
U refexplicitr
‰hr]r
ht]r
hv]r
héhêuhyKÿh]]r
h«)r
}r
(hbj
hl}r
(hr]r
ht]r
(hñj
Xstd-refr
ehp]r
hn]r
hv]r
uhdj
h]]r
h—Xfaq1_23r
r
}r!
(hbUhdj
ubahjh»ubaubh—X).r"
r#
}r$
(hbX).r%
hdjÕ ubeubh)r&
}r'
(hbXÔIf you already had this infrastructure and upgraded to MySQL 4.1.2 or
newer, please use :file:`examples/upgrade_tables_mysql_4_1_2+.sql`
and then create new tables by importing
:file:`examples/create_tables.sql`.r(
hdjm hehhhjhŸhl}r)
(hr]r*
ht]r+
hp]r,
hn]r-
hv]r.
uhyMhzhh]]r/
(h—XXIf you already had this infrastructure and upgraded to MySQL 4.1.2 or
newer, please use r0
r1
}r2
(hbXXIf you already had this infrastructure and upgraded to MySQL 4.1.2 or
newer, please use r3
hdj&
ubja)r4
}r5
(hbUhl}r6
(hn]r7
hp]r8
hr]r9
ht]r:
Xfiler;
aUroler<
j;
hv]r=
uhdj&
h]]r>
h—X(examples/upgrade_tables_mysql_4_1_2+.sqlr?
r@
}rA
(hbX(examples/upgrade_tables_mysql_4_1_2+.sqlrB
hdj4
ubahjjoubh—X)
and then create new tables by importing
rC
rD
}rE
(hbX)
and then create new tables by importing
rF
hdj&
ubja)rG
}rH
(hbUhl}rI
(hn]rJ
hp]rK
hr]rL
ht]rM
XfilerN
aUrolerO
jN
hv]rP
uhdj&
h]]rQ
h—Xexamples/create_tables.sqlrR
rS
}rT
(hbXexamples/create_tables.sqlrU
hdjG
ubahjjoubh—X.…rV
}rW
(hbX.hdj&
ubeubh)rX
}rY
(hbXëYou can use your phpMyAdmin to create the tables for you. Please be
aware that you may need special (administrator) privileges to create
the database and tables, and that the script may need some tuning,
depending on the database name.rZ
hdjm hehhhjhŸhl}r[
(hr]r\
ht]r]
hp]r^
hn]r_
hv]r`
uhyMhzhh]]ra
h—XëYou can use your phpMyAdmin to create the tables for you. Please be
aware that you may need special (administrator) privileges to create
the database and tables, and that the script may need some tuning,
depending on the database name.rb
rc
}rd
(hbjZ
hdjX
ubaubh)re
}rf
(hbXKAfter having imported the :file:`examples/create_tables.sql` file, you
should specify the table names in your :file:`config.inc.php` file. The
directives used for that can be found in the :ref:`config`. You will also need to
have a controluser with the proper rights to those tables (see section
:ref:`authentication_modes` below).rg
hdjm hehhhjhŸhl}rh
(hr]ri
ht]rj
hp]rk
hn]rl
hv]rm
uhyM
hzhh]]rn
(h—XAfter having imported the ro
rp
}rq
(hbXAfter having imported the rr
hdje
ubja)rs
}rt
(hbUhl}ru
(hn]rv
hp]rw
hr]rx
ht]ry
Xfilerz
aUroler{
jz
hv]r|
uhdje
h]]r}
h—Xexamples/create_tables.sqlr~
r
}r€
(hbXexamples/create_tables.sqlr
hdjs
ubahjjoubh—X2 file, you
should specify the table names in your r
}r„
(hbX2 file, you
should specify the table names in your r…
hdje
ubja)r†
}r‡
(hbUhl}rˆ
(hn]r‰
hp]rŠ
hr]r
ht]rŒ
Xfiler
aUrolerŽ
j
hv]r
uhdje
h]]r
h—Xconfig.inc.phpr
r
}r“
(hbXconfig.inc.phpr”
hdj†
ubahjjoubh—X8 file. The
directives used for that can be found in the r•
r
}r—
(hbX8 file. The
directives used for that can be found in the r˜
hdje
ubhÖ)r™
}rš
(hbX
:ref:`config`r
hdje
hehhhjhÚhl}rœ
(Ureftyper
Xrefrž
hÞˆhßXconfigrŸ
U refdomainr 
Xstdr¡
hn]r¢
hp]r£
U refexplicitr¤
‰hr]r¥
ht]r¦
hv]r§
héhêuhyM
h]]r¨
h«)
}rª
(hbj
hl}r«
(hr]r¬
ht]r­
(hñj¡
Xstd-refr®
ehp]r¯
hn]r°
hv]r±
uhdj™
h]]r²
h—Xconfigr³
r´
}rµ
(hbUhdj©
ubahjh»ubaubh—X_. You will also need to
have a controluser with the proper rights to those tables (see section
}r¸
(hbX_. You will also need to
have a controluser with the proper rights to those tables (see section
hdje
ubhÖ)
}r»
(hbX:ref:`authentication_modes`r¼
hdje
hehhhjhÚhl}r½
(Ureftyper¾
Xrefr¿
hÞˆhßXauthentication_modesrÀ
U refdomainrÁ
XstdrÂ
hn]rÃ
hp]rÄ
U refexplicitrÅ
‰hr]rÆ
ht]rÇ
hv]rÈ
héhêuhyM
h]]rÉ
h«)
}rË
(hbj¼
hl}rÌ
(hr]rÍ
ht]rÎ
(hñjÂ
Xstd-refrÏ
ehp]rÐ
hn]rÑ
hv]rÒ
uhdjº
h]]rÓ
h—Xauthentication_modesrÔ
}rÖ
(hbUhdjÊ
ubahjh»ubaubh—X below).r×
}rÙ
(hbX below).rÚ
hdje
ubeubh_)
}rÜ
(hbX.. _upgrading:rÝ
hdjm hehhhjhkhl}rÞ
(hn]rß
hp]rà
hr]rá
ht]râ
hv]rã
hxh8uhyMhzhh]]rä
ubeubh|)
}ræ
(hbUhdh}hehhh}rç
h
shjhhl}rè
(hr]ré
ht]rê
hp]rë
hn]rì
(h[h8ehv]rí
(h+heuhyMhzhhˆ}rî
h8jÛ
sh]]rï
(h)
}rñ
(hbXUpgrading from an older versionrò
hdjå
hehhhjhhl}ró
(hr]rô
ht]rõ
hp]rö
hn]r÷
hv]rø
uhyMhzhh]]rù
h—XUpgrading from an older versionrú
}rü
(hbjò
hdjð
ubaubh)
}rþ
(hbX\Simply copy :file:`config.inc.php` from your previous installation into
the newly unpacked one. Configuration files from old versions may
require some tweaking as some options have been changed or removed.
For compatibility with PHP 6, remove a
``set_magic_quotes_runtime(0);`` statement that you might find near
the end of your configuration file.rÿ
hdjå
hehhhjhŸhl}r (hr]r ht]r hp]r hn]r hv]r uhyMhzhh]]r (h—X Simply copy r r }r (hbX Simply copy r
hdjý
ubja)r }r (hbUhl}r
(hn]r hp]r hr]r ht]r Xfiler aUroler j hv]r uhdjý
h]]r h—Xconfig.inc.phpr r }r (hbXconfig.inc.phpr hdj ubahjjoubh—XÓ from your previous installation into
the newly unpacked one. Configuration files from old versions may
require some tweaking as some options have been changed or removed.
For compatibility with PHP 6, remove a
r r }r (hbXÓ from your previous installation into
the newly unpacked one. Configuration files from old versions may
require some tweaking as some options have been changed or removed.
For compatibility with PHP 6, remove a
r hdjý
ubja)r }r (hbX ``set_magic_quotes_runtime(0);``r hl}r! (hr]r" ht]r# hp]r$ hn]r% hv]r& uhdjý
h]]r' h—Xset_magic_quotes_runtime(0);r( r) }r* (hbUhdj ubahjjoubh—XG statement that you might find near
the end of your configuration file.r+ r, }r- (hbXG statement that you might find near
the end of your configuration file.r. hdjý
ubeubh)r/ }r0 (hbX•You should **not** copy :file:`libraries/config.default.php` over
:file:`config.inc.php` because the default configuration file is version-
specific.r1 hdjå
hehhhjhŸhl}r2 (hr]r3 ht]r4 hp]r5 hn]r6 hv]r7 uhyMhzhh]]r8 (h—X You should r9 r: }r; (hbX You should r< hdj/ ubj)r= }r> (hbX**not**r? hl}r@ (hr]rA ht]rB hp]rC hn]rD hv]rE uhdj/ h]]rF h—XnotrG rH }rI (hbUhdj= ubahjjubh—X copy rJ rK }rL (hbX copy rM hdj/ ubja)rN }rO (hbUhl}rP (hn]rQ hp]rR hr]rS ht]rT XfilerU aUrolerV jU hv]rW uhdj/ h]]rX h—Xlibraries/config.default.phprY rZ }r[ (hbXlibraries/config.default.phpr\ hdjN ubahjjoubh—X over
r] r^ }r_ (hbX over
r` hdj/ ubja)ra }rb (hbUhl}rc (hn]rd hp]re hr]rf ht]rg Xfilerh aUroleri jh hv]rj uhdj/ h]]rk h—Xconfig.inc.phprl rm }rn (hbXconfig.inc.phpro hdja ubahjjoubh—X= because the default configuration file is version-
specific.rp rq }rr (hbX= because the default configuration file is version-
specific.rs hdj/ ubeubh)rt }ru (hbXõIf you have upgraded your MySQL server from a version previous to 4.1.2 to
version 5.x or newer and if you use the phpMyAdmin configuration storage, you
should run the :term:`SQL` script found in
:file:`examples/upgrade_tables_mysql_4_1_2+.sql`.rv hdjå
hehhhjhŸhl}rw (hr]rx ht]ry hp]rz hn]r{ hv]r| uhyM#hzhh]]r} (h—X¨If you have upgraded your MySQL server from a version previous to 4.1.2 to
version 5.x or newer and if you use the phpMyAdmin configuration storage, you
should run the r~ r }r€ (hbX¨If you have upgraded your MySQL server from a version previous to 4.1.2 to
version 5.x or newer and if you use the phpMyAdmin configuration storage, you
should run the r hdjt ubhÖ)r }rƒ (hbX :term:`SQL`r„ hdjt hehhhjhÚhl}r… (Ureftyper† Xtermr‡ hÞˆhßXsqlrˆ U refdomainr‰ XstdrŠ hn]r hp]rŒ U refexplicitr ‰hr]rŽ ht]r hv]r héhêuhyM#h]]r h«)r }r“ (hbj„ hl}r” (hr]r• ht]r (hñjŠ Xstd-termr— ehp]r˜ hn]r™ hv]rš uhdj h]]r h—XSQLrœ r }rž (hbUhdj ubahjh»ubaubh—X script found in
r  }r¡ (hbX script found in
hdjt ubja) }r¤ (hbUhl}r¥ (hn]r¦ hp]r§ hr]r¨ ht]r© Xfilerª aUroler« hv]r¬ uhdjt h]]r­ h—X(examples/upgrade_tables_mysql_4_1_2+.sqlr® }r° (hbX(examples/upgrade_tables_mysql_4_1_2+.sqlr± hdj£ ubahjjoubh—X.… }r³ (hbX.hdjt ubeubjð)r´ }rµ (hbUhdjå
hehhhjjóhl}r¶ (hn]r· hp]r¸ hr]r¹ ht]rº hv]r» ]r¼ (jüXAuthentication modeUindex-2r½ Utr¾ ajÿ‰uhyM)hzhh]]r¿ ubh_) }rÁ (hbUhdjå
hehhhjhkhl}r (hn]rà hp]rÄ hr]rÅ ht]rÆ hv]rÇ hxj½ uhyM)hzhh]]rÈ ubh_) }rÊ (hbX.. _authentication_modes:rË hdjå
hehhh}rÌ hjhkhl}rÍ (hn]rÎ hp]rÏ hr]rÐ ht]rÑ hv]rÒ hxhDuhyM*hzhhˆ}rÓ sh]]rÔ ubeubh|) }rÖ (hbUhdh}hehhh}r× h shjhhl}rØ (hr]rÙ ht]rÚ hp]rÛ hn]rÜ (hNhDj½ ehv]rÝ (hheuhyM-hzhhˆ}rÞ (hDjÉ uh]]rß (h) }rá (hbXUsing authentication modesrâ hdjÕ hehhhjhhl}rã (hr]rä ht]rå hp]ræ hn]rç hv]rè uhyM-hzhh]]ré h—XUsing authentication modesrê }rì (hbjâ hdjà ubaubh) }rî (hbXÞ:term:`HTTP` and cookie authentication modes are recommended in a **multi-user
environment** where you want to give users access to their own database and
don't want them to play around with others. Nevertheless be aware that MS
Internet Explorer seems to be really buggy about cookies, at least till version
6. Even in a **single-user environment**, you might prefer to use :term:`HTTP`
or cookie mode so that your user/password pair are not in clear in the
configuration file.rï hdjÕ hehhhjhŸhl}rð (hr]rñ ht]rò hp]ró hn]rô hv]rõ uhyM/hzhh]]rö (hÖ) }rø (hbX :term:`HTTP`rù hdjí hehhhjhÚhl}rú (Ureftyperû Xtermrü hÞˆhßXhttprý U refdomainrþ Xstdrÿ hn]r hp]r U refexplicitr ‰hr]r ht]r hv]r héhêuhyM/h]]r h«)r }r (hbjù hl}r (hr]r
ht]r (hñjÿ Xstd-termr ehp]r
hn]r hv]r uhdj÷ h]]r h—XHTTPr r }r (hbUhdj ubahjh»ubaubh—X6 and cookie authentication modes are recommended in a r r }r (hbX6 and cookie authentication modes are recommended in a r hdjí ubj)r }r (hbX**multi-user
environment**r hl}r (hr]r ht]r hp]r hn]r hv]r uhdjí h]]r! h—Xmulti-user
environmentr" r# }r$ (hbUhdj ubahjjubh—Xæ where you want to give users access to their own database and
don't want them to play around with others. Nevertheless be aware that MS
Internet Explorer seems to be really buggy about cookies, at least till version
6. Even in a r% r& }r' (hbXæ where you want to give users access to their own database and
don't want them to play around with others. Nevertheless be aware that MS
Internet Explorer seems to be really buggy about cookies, at least till version
6. Even in a r( hdjí ubj)r) }r* (hbX**single-user environment**r+ hl}r, (hr]r- ht]r. hp]r/ hn]r0 hv]r1 uhdjí h]]r2 h—Xsingle-user environmentr3 r4 }r5 (hbUhdj) ubahjjubh—X, you might prefer to use r6 r7 }r8 (hbX, you might prefer to use r9 hdjí ubhÖ)r: }r; (hbX :term:`HTTP`r< hdjí hehhhjhÚhl}r= (Ureftyper> Xtermr? hÞˆhßXhttpr@ U refdomainrA XstdrB hn]rC hp]rD U refexplicitrE ‰hr]rF ht]rG hv]rH héhêuhyM/h]]rI h«)rJ }rK (hbj< hl}rL (hr]rM ht]rN (hñjB Xstd-termrO ehp]rP hn]rQ hv]rR uhdj: h]]rS h—XHTTPrT rU }rV (hbUhdjJ ubahjh»ubaubh—X[
or cookie mode so that your user/password pair are not in clear in the
configuration file.rW rX }rY (hbX[
or cookie mode so that your user/password pair are not in clear in the
configuration file.rZ hdjí ubeubh)r[ }r\ (hbX³:term:`HTTP` and cookie authentication
modes are more secure: the MySQL login information does not need to be
set in the phpMyAdmin configuration file (except possibly for the
:config:option:`$cfg['Servers'][$i]['controluser']`).
However, keep in mind that the password travels in plain text, unless
you are using the HTTPS protocol. In cookie mode, the password is
stored, encrypted with the blowfish algorithm, in a temporary cookie.r] hdjÕ hehhhjhŸhl}r^ (hr]r_ ht]r` hp]ra hn]rb hv]rc uhyM7hzhh]]rd (hÖ)re }rf (hbX :term:`HTTP`rg hdj[ hehhhjhÚhl}rh (Ureftyperi Xtermrj hÞˆhßXhttprk U refdomainrl Xstdrm hn]rn hp]ro U refexplicitrp ‰hr]rq ht]rr hv]rs héhêuhyM7h]]rt h«)ru }rv (hbjg hl}rw (hr]rx ht]ry (hñjm Xstd-termrz ehp]r{ hn]r| hv]r} uhdje h]]r~ h—XHTTPr r€ }r (hbUhdju ubahjh»ubaubh—X¤ and cookie authentication
modes are more secure: the MySQL login information does not need to be
set in the phpMyAdmin configuration file (except possibly for the
r }r„ (hbX¤ and cookie authentication
modes are more secure: the MySQL login information does not need to be
set in the phpMyAdmin configuration file (except possibly for the
r… hdj[ ubjð)r† }r‡ (hbUhl}rˆ (hn]r‰ hp]rŠ hr]r ht]rŒ hv]r ]rŽ ((jüX"$cfg['Servers'][$i]['controluser']r Uindex-3r j tr (jüX8configuration option; $cfg['Servers'][$i]['controluser']j j tr euhdj[ h]]r“ hjjóubh_)r” }r• (hbUhl}r (hr]r— ht]r˜ hp]r™ hn]rš j ahv]r uhdj[ h]]rœ hjhkubhÖ)r }rž (hbX3:config:option:`$cfg['Servers'][$i]['controluser']`rŸ hdj[ hehhhjhÚhl}r  (Ureftyper¡ Xoptionr¢ hÞ‰hßj U refdomainr£ Xconfigr¤ hn]r¥ hp]r¦ U refexplicitr§ ‰hr]r¨ ht]r© hv]rª héhêuhyM7h]]r« ja) }r­ (hbjŸ hl}r® (hr]r¯ ht]r° (hñj¤ X
config-optionr± ehp]r² hn]r³ hv]r´ uhdj h]]rµ h—X"$cfg['Servers'][$i]['controluser']r¶ }r¸ (hbUhdj¬ ubahjjoubaubh—XÐ).
However, keep in mind that the password travels in plain text, unless
you are using the HTTPS protocol. In cookie mode, the password is
stored, encrypted with the blowfish algorithm, in a temporary cookie.r¹ }r» (hbXÐ).
However, keep in mind that the password travels in plain text, unless
you are using the HTTPS protocol. In cookie mode, the password is
stored, encrypted with the blowfish algorithm, in a temporary cookie.r¼ hdj[ ubeubcdocutils.nodes
comment
) }r¿ (hbXenote:
This section is only applicable if your MySQL server is running
with ``--skip-show-database``.rÀ hdjÕ hehhhjUcommentrÁ hl}r (jhn]rà hp]rÄ hr]rÅ ht]rÆ hv]rÇ uhyMChzhh]]rÈ h—Xenote:
This section is only applicable if your MySQL server is running
with ``--skip-show-database``.rÉ }rË (hbUhdj¾ ubaubh) }rÍ (hbX—For ':term:`HTTP`' and 'cookie' modes, phpMyAdmin needs a controluser that has
**only** the ``SELECT`` privilege on the *`mysql`.`user` (all columns except
`Password`)*, *`mysql`.`db` (all columns)*, *`mysql`.`host` (all columns)* and
*`mysql`.`tables\_priv` (all columns except `Grantor` and `Timestamp`)* tables.
You must specify the details for the controluser in the :file:`config.inc.php`
file under the :config:option:`$cfg['Servers'][$i]['controluser']` and
:config:option:`$cfg['Servers'][$i]['controlpass']` settings. The following
example assumes you want to use ``pma`` as the controluser and ``pmapass`` as
the controlpass, but **this is only an example: use something else in your
file!** Input these statements from the phpMyAdmin :term:`SQL` Query window or
mysql command–line client. Of course you have to replace ``localhost`` with the
webserver's host if it's not the same as the MySQL server's one.rÎ hdjÕ hehhhjhŸhl}rÏ (hr]rÐ ht]rÑ hp]rÒ hn]rÓ hv]rÔ uhyMDhzhh]]rÕ (h—XFor 'rÖ r× }rØ (hbXFor 'rÙ hdjÌ ubhÖ) }rÛ (hbX :term:`HTTP`rÜ hdjÌ hehhhjhÚhl}rÝ (UreftyperÞ Xtermrß hÞˆhßXhttprà U refdomainrá Xstdrâ hn]rã hp]rä U refexplicitrå ‰hr]ræ ht]rç hv]rè héhêuhyMDh]]ré h«) }rë (hbjÜ hl}rì (hr]rí ht]rî (hñjâ Xstd-termrï ehp]rð hn]rñ hv]rò uhdjÚ h]]ró h—XHTTPrô }rö (hbUhdjê ubahjh»ubaubh—X>' and 'cookie' modes, phpMyAdmin needs a controluser that has
}rù (hbX>' and 'cookie' modes, phpMyAdmin needs a controluser that has
hdjÌ ubj) }rü (hbX**only**rý hl}rþ (hr]rÿ ht]r
hp]r
hn]r
hv]r
uhdjÌ h]]r
h—Xonlyr
r
}r
(hbUhdjû ubahjjubh—X the r
r
}r
(hbX the r
hdjÌ ubja)r
}r
(hbX
``SELECT``r
hl}r
(hr]r
ht]r
hp]r
hn]r
hv]r
uhdjÌ h]]r
h—XSELECTr
r
}r
(hbUhdj
ubahjjoubh—X privilege on the r
r
}r
(hbX privilege on the r
hdjÌ ubh«)r
}r
(hbX0*`mysql`.`user` (all columns except
`Password`)*r
hl}r
(hr]r!
ht]r"
hp]r#
hn]r$
hv]r%
uhdjÌ h]]r&
h—X.`mysql`.`user` (all columns except
`Password`)r'
r(
}r)
(hbUhdj
ubahjh»ubh—X, r*
r+
}r,
(hbX, r-
hdjÌ ubh«)r.
}r/
(hbX*`mysql`.`db` (all columns)*r0
hl}r1
(hr]r2
ht]r3
hp]r4
hn]r5
hv]r6
uhdjÌ h]]r7
h—X`mysql`.`db` (all columns)r8
r9
}r:
(hbUhdj.
ubahjh»ubh—X, r;
r<
}r=
(hbX, r>
hdjÌ ubh«)r?
}r@
(hbX*`mysql`.`host` (all columns)*rA
hl}rB
(hr]rC
ht]rD
hp]rE
hn]rF
hv]rG
uhdjÌ h]]rH
h—X`mysql`.`host` (all columns)rI
rJ
}rK
(hbUhdj?
ubahjh»ubh—X and
rL
rM
}rN
(hbX and
rO
hdjÌ ubh«)rP
}rQ
(hbXG*`mysql`.`tables\_priv` (all columns except `Grantor` and `Timestamp`)*rR
hl}rS
(hr]rT
ht]rU
hp]rV
hn]rW
hv]rX
uhdjÌ h]]rY
h—XD`mysql`.`tables_priv` (all columns except `Grantor` and `Timestamp`)rZ
r[
}r\
(hbUhdjP
ubahjh»ubh—XA tables.
You must specify the details for the controluser in the r]
r^
}r_
(hbXA tables.
You must specify the details for the controluser in the r`
hdjÌ ubja)ra
}rb
(hbUhl}rc
(hn]rd
hp]re
hr]rf
ht]rg
Xfilerh
aUroleri
jh
hv]rj
uhdjÌ h]]rk
h—Xconfig.inc.phprl
rm
}rn
(hbXconfig.inc.phpro
hdja
ubahjjoubh—X
file under the rp
rq
}rr
(hbX
file under the rs
hdjÌ ubjð)rt
}ru
(hbUhl}rv
(hn]rw
hp]rx
hr]ry
ht]rz
hv]r{
]r|
((jüX"$cfg['Servers'][$i]['controluser']r}
Uindex-4r~
j}
tr
(jüX8configuration option; $cfg['Servers'][$i]['controluser']j~
j}
tr€
euhdjÌ h]]r
hjjóubh_)r
}rƒ
(hbUhl}r„
(hr]r…
ht]r†
hp]r‡
hn]rˆ
j~
ahv]r‰
uhdjÌ h]]rŠ
hjhkubhÖ)r
}rŒ
(hbX3:config:option:`$cfg['Servers'][$i]['controluser']`r
hdjÌ hehhhjhÚhl}rŽ
(Ureftyper
Xoptionr
hÞ‰hßj}
U refdomainr
Xconfigr
hn]r“
hp]r”
U refexplicitr•
‰hr]r
ht]r—
hv]r˜
héhêuhyMDh]]r™
ja)
}r
(hbj
hl}rœ
(hr]r
ht]rž
(hñj
X
config-optionrŸ
ehp]r 
hn]r¡
hv]r¢
uhdj
h]]r£
h—X"$cfg['Servers'][$i]['controluser']r¤
}r¦
(hbUhdjš
ubahjjoubaubh—X and
}r©
(hbX and
hdjÌ ubjð)
}r¬
(hbUhl}r­
(hn]r®
hp]r¯
hr]r°
ht]r±
hv]r²
]r³
((jüX"$cfg['Servers'][$i]['controlpass']r´
Uindex-5rµ
j´
tr¶
(jüX8configuration option; $cfg['Servers'][$i]['controlpass']jµ
j´
tr·
euhdjÌ h]]r¸
hjjóubh_)