Phpmyadmin

Johdanto

Suosittu ohjelma tietokannan käsittelyyn selaimen kautta. Asennetaan palvelimelle, joka voi olla esimerkiksi oma macOS-tietokone. Vaihtoehtoisena katso MySQL Workbench -ohjelma (sivulla PHP ja MySQL

Asennus

Asennus palvelimelle

(4/2017)

Vaihtoehto 1: Päivitys

1. Lataa uusin versio ohjelmasta ja siirrä palvelimelle ja pura. Purkautuu yhteen hakemistoon.
2. Vaihda mahdollisen olemassa olevan phpMyAdmin-hakemiston nimi toiseksi.
3. Kopioi config.sample.inc.php nimelle config.inc.php
4. Avaa vanha config.inc.php tiedosto ja siirrä sieltä tiedot uuteen config.inc.php-tiedostoon. Esimerkiksi
   1. $cfg['blowfish_secret'] = 'TÄHÄN SOTKU';
      1. https://codingweb.io/phpmyadmin-blowfish-secret-generator/?g=59035124817a6
   2. $i = 0;
   3. $i++;
   4. $cfg['Servers'][$i]['auth_type'] = 'cookie';
   5. $cfg['Servers'][$i]['host'] = 'tietokantanimi.palvelin.fi';
   6. $cfg['Servers'][$i]['compress'] = false;
   7. $cfg['Servers'][$i]['AllowNoPassword'] = false;
   8. $cfg['Export']['charset'] = 'utf-8';
   9. $cfg['UploadDir'] = ;
   10. $cfg['SaveDir'] = ;
5. Muuta config.inc.php tiedosto-oikeudeksi 440
6. Lisää .htaccess -tiedosto hakemistoon
   1. RewriteEngine On
   2. Jos saat virheilmoituksen, että php-versio on liian pieni Nebula-palvelimella sitä vi kasvattaa .htaccess-tiedostossa:
      1. suPHP_ConfigPath /opt/php56/etc/
      2. AddHandler x-httpd-php56 .php
7. Muuta .htaccess -tiedosto-oikeudeksi 644
8. Anna selaimessa http://palvelimesiosoite.fi/phpmyadminhakemistonnimi
   1. Syötä tietokannan käyttäjätunnus ja salasana
9. Etusivulla näkyy mahdollisia "virheitä".

Vaihtoehto 2

• Lataa uusin versio ohjelmasta ja siirrä palvelimelle ja pura. Purkautuu yhteen hakemistoon.
  • Vaihda mahdollisen olemassa olevan phpMyAdmin-hakemiston nimi toiseksi.
• Perusta tilapäinen hakemisto, jossa luodaan asetukset-tiedosto, jos sinulla ei ole ennestään sellaista. Voit tehdä myös ilman pääteohjemaa seuraavat komennot. Viimeinen antaa hakemistolle koko maailman luettavat oikeudet

cd phpmyadminhakemistonimi
mkdir config
chmod o+rw config  (eli 777)

• Kopioi hakemistoon malliasetustiedosto päähakemistosta

cp config.sample.inc.php config/config.inc.php
chmod o+w config/config.inc.php (eli 666)

• Anna selaimessa komento osoite.fi/phpmyadminhakemistonimi/setup
  • jos virheilmoitus ettet pääse hakemistoon, kts. .htaccess kohta Vinkkejä
• Syötä tietokannan osoite ja valitse http, jolloin selain kysyy tietokannan käyttäjätunnusta ja salasanaa kun avaat phpmyadmin-ohjelmaa. Jos valitset config, käyttäjätunnus ja salasana sijoitetaan asetustiedostoon ja pääset ilman tunnistautumista. Tämä helpottaa esimerkiksi kotikoneella, mutta ei ole suositeltavaa avoimessa internetissä!
• Siirrä tiedosto phpmyadminhakemistoon config-hakemistosta, anna tiukemmat oikeudet ja poista config-hakemisto

mv config/config.inc.php . 
chmod o-rw config.inc.php
rm -rf config

Asennus macOS Catalina (12/2021), Big Sur (3/2022)

1. Tee nyt, jos et tehnyt jo MySQL–asennuksen yhteydessä 2002 MySQL Socket error -korjausta. Ohje löytyy sivulta PHP ja MySQL.
2. Siirry phpMyAdmin sivustolle
3. Sivulla näet PHP ja MySQL versiovaatimukset. Tarkista päätteessä ne komennolla mysql -v ja php -v
4. Lataa viimeisin sopiva zip-versio joka on todennäköissti sivun ylimpänä. Valitsemalla all-languages saat suomenkielisen. Lataus alkaa automaattisesti hetken kuluttua.
5. Katso Finderissa sivupalkista talokuvakkeen kohdalta millä käyttäjänimellä olet kirjautunut ja käytä sitä seuraavassa.
6. Siirrä purettu hakemisto käyttäjänimesi Sites-hakemiston alihakemistoksi eli kohtaan Macintosh HD/Käyttäjät/käyttäjänimesi/Sites/ Sites-hakemisto luotiin Apache-asennuksessa sivulla PHP asennus.
7. Vahda hakemiston nimeksi phpmyadmin
8. Anna Pääteohjelmassa komento: mkdir ~/Sites/phpmyadmin/config
9. sekä komento: chmod o+w ~/Sites/phpmyadmin/config
10. Anna selaimen osoiterivillä: http://localhost/~käyttäjänimesi/phpmyadmin/setup/
    1. Valise Uusi palvelin
    2. Valitse välilehti Todennus (Authentication)
    3. Authentication type on cookie. Aseta Config-todennuksen root-käyttäjälle salasana kohtaan MySQL-tietokannan root-salasana. Käyttäjä on valmiiksi root Paina Tallenna.
    4. Palaat ensimmäiseen ruutuun. Voit asettaa myös muita vapaaehtoisia asetuksia
    5. Paina Download, joka muodostaa config.inc.php -tiedoston.
    6. Siirrä muodostunut config.inc.php -tiedosto hakemistosta /phpmyadmin/config tai tietokoneen Downloads -hakmistosta /phpmyadmin -hakemistoon ja poista config-hakemisto.
       1. Jos joskus päivität phpMyAdmin -ohjelman, voit käyttää tätä samaa config.inc.php -tiedostoa kopioimalla sen suoraan uuden version hakemistoon.
11. phpMyAdmin on käytettävissä osoitteessa: http://localhost/~tietokoneenkäyttäjänimi/phpmyadmin/
    1. Kirjaudu sisään root ja MySQL-salasanalla

• Asetussivun osoite on http://localhost/~tietokoneenkäyttäjänimi/phpmyadmin/setup/index.php

Virheilmoitus #2054

• mysqli::real_connect(): The server requested authentication method unknown to the client [caching_sha2_password]
• mysqli::real_connect(): (HY000/2054): The server requested authentication method unknown to the client

1. Anna pääte-ohjelmassa: /usr/local/mysql/bin/mysql -v -uroot -p
2. Syötä tietokannan root-salasana
3. Lisää Mysql>-riville: ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'rootsalasanatähän';
4. Poistu komennolla exit

Asennus Mac OS X Yosemite

Jos haluat käyttää MySQL-tietokantaa graafisen käyttöliittymän avulla, siihen yleisesti käytetty on phpMyAdmin. Se täytyy myös asentaa erikseen:

1. Tee nyt, jos et tehnyt jo MySQL asennuksen yhteydessä kohta Korjaa 2002 MySQL Socket virhe. Ohje löytyy sivulta PHP ja MySQL.
2. Siirry phpMyAdmin sivustolle
3. Sivulla näet PHP ja MySQL versiovaatimukset. Tarkista päätteessä ne komennolla mysql -v ja php -v
4. Lataa viimeisin sopiva zip-versio joka on todennäköissti sivun ylimpänä. Valitsemalla all-languages saat suomenkielisen. Lataus alkaa automaattisesti hetken kuluttua.
5. Siirrä purettu hakemisto käyttäjänimesi Sites-hakemiston alihakemistoksi eli kohtaan Macintosh HD/Käyttäjät/käyttäjänimesi/Sites/ Sites-hakemisto luotiin Apache-asennuksessa sivulla PHP asennus.
6. Vahda hakemiston nimeksi phpmyadmin
7. Anna Pääteohjelmassa komento: mkdir ~/Sites/phpmyadmin/config
8. sekä komento: chmod o+w ~/Sites/phpmyadmin/config
9. Anna selaimen osoiterivillä osoite: http://localhost/~käyttäjänimesi/phpmyadmin/setup/
   1. Valise Uusi palvelin
   2. Valitse välilehti Todennus
   3. Aseta Config-todennuksen salasana kohtaan MySQL-tietokannan juurisalasana. Käyttäjä on valmiiksi root Paina Tallenna.
   4. Palaat ensimmäiseen ruutuun. Voit asettaa myös muita vapaaehtoisia asetuksia, mutta tärkeintä on lopuksi painaa alhaalta Tallenna, joka muodostaa config.inc.php -tiedoston.
   5. Siirrä muodostunut config.inc.php -tiedosto hakemistosta /phpmyadmin/config hakemistoon yhden ylöspäin eli /phpmyadmin -hakemistoon ja poista config-hakemisto.
      1. Jos joskus päivität phpMyAdmin -ohjelman, voit käyttää tätä samaa config.inc.php -tiedostoa kopioimalla sen suoraan uuden version hakemistoon.
10. phpMyAdmin on käytettävissä osoitteessa: http://localhost/~käyttäjänimesi/phpmyadmin/
    1. Kirjaudu sisään root ja MySQL-salasanalla

Asennus Mac OS X Mavericks

Jos haluat käyttää MySQL-tietokantaa graafisen käyttöliittymän avulla, siihen yleisesti käytetty on phpMyAdmin. Se täytyy myös asentaa erikseen:

• Tee nyt, jos et tehnyt jo MySQL asennuksen yhteydessä kohta Korjaa 2002 MySQL Socket virhe
• Siirry phpMyAdmin sivustolle
• Sivulla näet PHP ja MySQL versiovaatimukset. Tarkista päätteessä ne komennolla mysql -v ja php -v
• Lataa viimeisin zip-versio joka on todennäköissti sivun ylimpänä. Valitsemalla all-languages saat suomenkielisen. Lataus alkaa automaattisesti hetken kuluttua.
• Siirrä purettu hakemisto käyttäjänimesi Sites-hakemiston alihakemistoksi eli kohtaan Macintosh HD/Käyttäjät/käyttäjänimesi/Sites/ Sites-hakemisto luotiin jo Apache-asennus kohdassa.
• Vahda hakemiston nimeksi phpmyadmin

Anna Pääteohjelmassa komento:   mkdir ~/Sites/phpmyadmin/config
Sekä komento:   chmod o+w ~/Sites/phpmyadmin/config

• Anna selaimen osoiterivillä osoite: http://localhost/~käyttäjänimesi/phpmyadmin/setup/
  • Valise Uusi palvelin
  • Valitse välilehti Todennus
  • Aseta Config-todennuksen salasana kohtaan MySQL-tietokannan juurisalasana. Käyttäjä on valmiiksi root Paina Tallenna.
  • Palaat ensimmäiseen ruutuun. Voit asettaa myös muita vapaaehtoisia asetuksia, mutta tärkeintä on lopuksi painaa alhaalta Tallenna, joka muodostaa config.inc.php -tiedoston.
  • Siirrä muodostunut config.inc.php -tiedosto hakemistosta /phpmyadmin/config hakemistoon yhden ylöspäin eli /phpmyadmin -hakemistoon ja poista config-hakemisto.
    • Jos joskus päivität phpMyAdmin -ohjelman, voit käyttää tätä samaa config.inc.php -tiedostoa kopioimalla sen suoraan uuden version hakemistoon.
• phpMyAdmin on käytettävissä osoitteessa: http://localhost/~käyttäjänimesi/phpmyadmin/
  • Kirjaudu sisään root ja MySQL-salasanalla

Asennus Mac OS X Lion

Huom! Apache Tomcatin kanssa nämä ohjeet eivät toimi. Lionissa on valmiina PHP, mutta se ei ole "päällä". Katso aiheesta oma otsikko.

• http://www.phpmyadmin.net Lataa viimeisin versio eli Latest stable version eli all-languages.tar.gz
• Pura tiedosto ja nimeä kansio uudestaan nimelle phpMyAdmin
• Siirrä kansio hakemistoon Käyttäjä/Sivustot/
• Siirry hakemistoon phpMyAdmin pääteohjelmalla
  • cd /Library/WebServer/Documents/phpMyAdmin
• Tee hakemisto komennolla mkdir config
• Anna uudelle hakemistolle oikeuksia chmod o+rw config
• Aseta Web-jako päälle Järjestelmäasetukset/Jako -kohdasta.
• Mene selaimeen ja anna osoiterivillä komento http://localhost/phpMyAdmin/setup
• Tee asetukset välilehdille kuten seuraavassa on neuvottu tietokannan osalta, johon haluat phpMyAdmin ohjelman yhdistää. Ja tarpeen mukaan muut asetukset. Ohjeita saa näppärästi painamalla pientä kysymysmerkkipainiketta tai infopainiketta.
  • Server hostname Localhost käytä isoa alkukirjainta L
  • Server socket. Vastaus tähän löytyy antamalla pääteohjelmassa /usr/local/mysql hakemistossa komennon ./bin/mysql root status ja katsomalla sieltä kohdasta socket hakemisto. Esimerkiksi /tmp/mysql.sock
  • Connection type socket tai tcp
  • PHP extension to use mysql
  • User for congif auth root
  • Password for config auth pääkäyttäjänsalasana
• Muista tallentaa lopuksi kohdasta Save
• Mene pääteohjelmaan ja anna phpMyAdmin hakemistossa seuraavat komennot:
  • Siirrä tekemäsi asetustiedosto config hakemistosta phpMyAdmin hakemistoon mv config/config.inc.php .
  • Anna sille tarvittavat oikeudet chmod o-rw config.inc.php
  • Tuhoa config hakemisto rm -rf config
• Mene selaimeen ja anna osoiteriville http://localhost/phpMyAdmin
  • Anna rootkäyttäjätunnus

Virheilmoitus #2002

Tarkoittaa että socket ei ole kunnossa. Saat sen kuntoon todennäköisesti asettamalla myös php.ini tiedostoon saman kuin phpMyAdmin asentaessasi kohtaan server socket

• • pääteohjelmassa kirjoita locate php.ini
  • vastaus on esimerkiksi /private/etc
  • cd /private/etc/
  • nano php.ini
  • Käytä ctrl-W hakutoimintoa etsimään kohta mysql.default_socket
  • lisää loppuun socket osoite, esimerkiksi /tmp/mysql.sock
  • tallenna ctrl-X ja Yes ja Enter
  • Sammuta Mysql ja käynnistä uudestaan.

Virheilmoitus #1045

Tarkoittaa että sinulla on vääriä asetuksia config.inc.php -tiedostossa jonka aikaisemmin teit.

• • Mene /MacintoshHD/Kirjasto/WebServer/Documents/phpMyAdmin
  • Avaa jossain tekstieditorissa config.inc.php ja katso että siellä on seuraavat rivit samalla tavoin
  • $cfg['PmaAbsoluteUri'] = 'localhost/phpmyadmin/';
  • $cfg['Servers'][$i]['host'] = 'Localhost';
  • $cfg['Servers'][$i]['extension'] = 'mysql';
  • $cfg['Servers'][$i]['socket'] = '/tmp/mysql.sock';
  • $cfg['Servers'][$i]['connect_type'] = 'socket';
  • $cfg['Servers'][$i]['compress'] = false;
  • $cfg['Servers'][$i]['auth_type'] = 'config';
  • $cfg['Servers'][$i]['user'] = 'root';
  • $cfg['Servers'][$i]['password'] = 'rootsalasanasitähän';

• Jos edellinen ei auta #1045 virheilmoitukseen, muita säätökeinoja "voi kokeilla", mutta phpMyAdmin päästi sisäänsä vasta kun ylläolevat oli säädetty kohdalleen
  • Jossain oli tällainen neuvo käyttäjien luomisesta tietokantaan. Se annetaan mysql> -komentoriville. GRANT ALL PRIVILEGES ON *.* TO username@localhost IDENTIFIED BY 'password' WITH GRANT OPTION ;

• Tai ehkä tämä on pakollinen, en tiedä:
  • Mene hakemistoon /usr/local/mysql/suport-files/
  • Valitse sopiva my- -alkuinen .cnf tiedosto
  • Kopioi kyseinen tiedosto etc-hakemistoon nimelle my.cnf komennolla cp my-small.cnf /etc/my.cnf

Käyttäjien lisääminen

Jos ei löydy kohtaa, josta lisätä käyttäjiä, se on mahdollisesti estetty palveluntarjoajan puolelta. Jos sinulla on cPanel käytettävissä palveluntarjoajasi puolelta, sen avulla voit lisätä käyttäjiä ja tietokantoja.

Tietokannan etuliitteen muuttaminen

Otetaan esimerkkitapaus, että rakennat uutta kotisivua vanhan julkaistuna olevan rinnalle, mutta sinulla on ainoastaan käytössä yksi tietokanta. Eri ohjelmien taulut erotellaan samassa tietokannassa etuliitteillä (prefix). Vapaavalintaiseen etuliitteeseen kannattaa loppuun lisätä lukemista helpottamaan alaviiva _ eli esim etuliite_

1. Tässä esimerkissä taulut ovat jo aikaisemmin nimetty: etuliite_
2. Vie -toiminnolla vie halutut taulut
3. Avaa viety tiedosto tekstieditoriin ja käytä etsi ja korvaa toimintoa niin että korvaat kaikki etuliite_ alkuiset uusietuliite_
4. Tuo -toiminnolla tuo taulut tietokantaan
5. Nyt sinulla on sekä vanhat taulut, joita olemassaolevat kotisivut käyttävät, sekä uudet taulut joita voit käyttää toisessa ohjelmassa.

Virheilmoituksia

• #1217 - Cannot delete or update a parent row: a foreign key constraint fails
  • Liekö tauluissa viittauksia toisiinsa niin ettei niiden tuhoaminen onnistu kuin tietyssä järjestyksessä.