LXXIX. MySQL

Funkcje te umożliwiają dostęp do serwerów baz danych MySQL. Więcej informacji o MySQL można znaleźć na stronie http://www.mysql.com/.

Dokumentacja do MySQL znajduje się pod adresem http://dev.mysql.com/doc/.

Wymagania

Aby funkcje były dostępne, należy skompilować PHP z obsługą MySQL.

Installation

Podając opcję konfiguracyjną --with-mysql umożliwiasz PHP dostęp do baz MySQL. Jeśli użyjesz jej bez podania ścieżki do MySQL, PHP wykorzysta własne biblioteki klienta. W PHP4 obsługa MySQL jest zawsze włączona, więc jeśli nie podasz tej opcji, PHP również użyje wbudowanych bibliotek. Użytkownicy, którzy uruchamiają inne aplikacje korzystające z MySQL (na przykład równocześnie PHP3 i PHP4 jako moduły apache, lub moduł auth-mysql) powinni zawsze podawać ścieżkę do MySQL: --with-mysql=/sciezka/do/mysql. To wymusi na PHP użycie bibliotek zainstalowanych przez MySQL, co pozwoli uniknąć konfliktów.

Ostrzeżenie

Jeśli to rozszerzenie używane jest razem z rozszerzeniem recode, mogą występować awarie i problemy ze startem PHP. Więcej informacji znajduje się w rozdziale dotyczącym rozszerzenia recode.

Konfiguracja

Zachowanie funkcji MySQL zależy od ustawień w pliku konfiguracyjnym php.ini.

Tabela 1. Opcje konfiguracyjne MySQL

Nazwa	Domyślnie	Zmiana
mysql.allow_persistent	"On"	PHP_INI_SYSTEM
mysql.max_persistent	"-1"	PHP_INI_SYSTEM
mysql.max_links	"-1"	PHP_INI_SYSTEM
mysql.default_port	NULL	PHP_INI_ALL
mysql.default_socket	NULL	PHP_INI_ALL
mysql.default_host	NULL	PHP_INI_ALL
mysql.default_user	NULL	PHP_INI_ALL
mysql.default_password	NULL	PHP_INI_ALL

Aby uzyskać więcej informacji na temat stałych PHP_INI_* zobacz ini_set().

Oto krótki opis poszczególnych opcji konfiguracyjnych:

mysql.allow_persistent boolean: Czy pozwalać na stałe połączenia z MySQL.
mysql.max_persistent integer: Maksymalna liczba stałych połączeń MySQL na każdy proces.
mysql.max_links integer: Maksymalna liczba połączeń MySQL na proces, włączając w to połączenia stałe.
mysql.default_port string: Domyślny numer portu TCP, który będzie użyty przy łączeniu się z serwerm baz danych, jeśli nie zostanie podany żaden inny. Jeśli nie będzie podany port domyślny, będzie on pobrany ze zmiennej środowiskowej MYSQL_TCP_PORT, wpisu mysql-tcp w pliku /etc/services lub podanej przy kompilacji opcji MYSQL_PORT, w tym właśnie porządku. Pod Win32 użyta będzie tylko stała MYSQL_PORT.
mysql.default_socket string: Domyślna nazwa gniazda, które będzie użyte do łączenia się z lokalnym serwerem baz danych, jeśli nie zostanie podana żadna inna nazwa.
mysql.default_host string: Domyślny serwer, który będzie używany przy łączeniu się z bazą danych, jeśli nie zostanie podany żaden inny. Nie dotyczy trybu bezpiecznego.
mysql.default_user string: Domyślna nazwa użytkownika, która będzie używana przy łączeniu się z Nie dotyczy trybu bezpiecznego.
mysql.default_password string: Domyślne hasło, które będzie użyte przy łączeniu się z serwerem baz danych, jeśli nie zostanie podane żadne inne. Nie dotyczy trybu bezpiecznego.

Rodzaje zasobów

Moduł MySQL wykorzystuje dwa rodzaje zasobów. Pierwszym jest identyfikator połączenia z bazą danych, drugim zaś zasób wyniku, przechowujący rezultat zapytania.

Predefiniowane stałe

Funkcja mysql_fetch_array() używa stałych dla różnych typów tablic wynikowych. Zdefiniowane są następujące stałe:

Tabela 2. Stałe pobierania MySQL

stała	znaczenie
MYSQL_ASSOC	Kolumny są zwracane jako tablica, której indeks stanowią nazwy pól.
MYSQL_BOTH	Kolumny są zwracane jako tablica, indeksowana zarówno nazwami pól, jak i numerycznie.
MYSQL_NUM	Kolumny są zwracane jako tablica indeksowana numerycznie. Indeks zaczyna się od 0 i wskazuje na pierwsze pole w wyniku.
MYSQL_STORE_RESULT	Wynik operacji MySQL jest buforowany.
MYSQL_USE_RESULT	Wynik operacji MySQL nie jest buforowany.

Przykłady

Ten prosty przykład demonstruje jak połączyć się, wykonać zapytanie, wyświetlić wyniki i rozłączyć się z bazą MySQL.

Przykład 1. Wykorzystanie funkcji MySQL


<?php

/* Łączenie i wybranie bazy */

$link = mysql_connect("localhost", "uzytkownik", "haslo")

    or die ("Nie można się połączyć");

print ("Połączenie nawiązane");

mysql_select_db ("baza") or die ("Nie mozna wybrać bazy danych");

    

/* Wysyłanie zapytania SQL */

$query = "SELECT * FROM tabela";

$result = mysql_query ($query) or die ("Zapytanie zakończone niepowodzeniem");



/* Wyświetlenie wyników w HTML */

print "<table>\n";

while ($line = mysql_fetch_array($result, MYSQL_ASSOC)) {

   print "\t<tr>\n";

   foreach ($line as $col_value) { 

       print "\t\t<td>$col_value</td>\n"; 

   }

   print "\t</tr>\n";

}

print "</table>\n";



/* Zwalnianie pamięci */

mysql_free_result($result); 



/* Rozłączanie */

mysql_close($link);

?>

Spis treści
mysql_affected_rows -- Zwraca ilość wierszy przetworzonych w poprzedniej operacji MySQL
mysql_change_user -- Zmienia użytkownika zalogowanego w aktywnym połączeniu
mysql_client_encoding -- Returns the name of the character set
mysql_close -- Zamyka połączenie z serwerem MySQL
mysql_connect -- Otwiera połączenie z serwerem MySQL
mysql_create_db -- Tworzy bazę MySQL
mysql_data_seek -- Przesuwa wewnętrzny wskaźnik wyniku
mysql_db_name -- Pobiera dane wynikowe
mysql_db_query -- Wysyła zapytanie do bazy MySQL
mysql_drop_db -- Usuwa bazę MySQL
mysql_errno -- Zwraca numer komunikatu błędu z ostatniej operacji MySQL
mysql_error -- Zwraca tekst komunikatu błędu z ostatniej operacji MySQL
mysql_escape_string -- Dodaje znaki unikowe na użytek mysql_query
mysql_fetch_array -- Zapisuje wiersz wyniku w tablicy asocjacyjnej, numerycznej lub w obu
mysql_fetch_assoc -- Zapisuje wiersz wyniku w tablicy asocjacyjnej
mysql_fetch_field -- Pobiera z wyniku informacje o kolumnie i zwraca jako obiekt
mysql_fetch_lengths -- Pobiera długość każdego pola w wierszu wyniku
mysql_fetch_object -- Zapisuje wiersz wyniku jako obiekt
mysql_fetch_row -- Zapisuje wiersz wyniku w tablicy wyliczeniowej
mysql_field_flags -- Pobiera flagi dla danego pola w wyniku
mysql_field_len -- Zwraca długość danego pola
mysql_field_name -- Podaje nazwę danego pola w wyniku
mysql_field_seek -- Przesuwa wskaźnik wyniku do wybranego pola
mysql_field_table -- Pobiera nazwę tabeli w której znajduje się dane pole
mysql_field_type -- Pobiera typ podanego pola
mysql_free_result -- Zwalnia pamięć zajmowaną przez wynik
mysql_get_client_info -- Pobiera informacje o kliencie MySQL
mysql_get_host_info -- Pobiera informacje o hoście MySQL
mysql_get_proto_info -- Pobiera informacje o protokole MySQL
mysql_get_server_info -- Pobiera informacje o serwerze MySQL
mysql_info -- Pobiera informacje o ostatnim zapytaniu
mysql_insert_id -- Podaje numer ID wygenerowany podczas ostatniej operacji INSERT
mysql_list_dbs -- Pobiera nazwy baz dostępnych na serwerze MySQL
mysql_list_fields -- Pobiera informacje o polach tabeli MySQL
mysql_list_processes -- Zwraca listę procesów MySQL
mysql_list_tables -- Pobiera listę tabel z bazy MySQL
mysql_num_fields -- Zwraca liczbę pól w wyniku
mysql_num_rows -- Zwraca liczbę wierszy w wyniku
mysql_pconnect -- Otwiera stałe połączenie z serwerem MySQL
mysql_ping -- Sprawdza połączenie z serwerem, lub nawiązuje połączenie, jeśli go nie było
mysql_query -- Wysyła zapytanie do serwera MySQL
mysql_real_escape_string -- Dodaje znaki unikowe dla potrzeb poleceń SQL, biorąc po uwagę zestaw znaków używany w połączeniu.
mysql_result -- Zwraca dane wynikowe
mysql_select_db -- Wybiera bazę MySQL
mysql_stat -- Pobiera aktualny stan systemu
mysql_tablename -- Zwraca nazwę tabeli
mysql_thread_id -- Zwraca id bieżącego wątku
mysql_unbuffered_query -- Wysyła zapytanie do serwera MySQL nie pobierając i buforując wyniku

User Contributed Notes


This is a small function I wrote to handle queries on a table.

It can query a table, order and sort, and supports inner joins.



This function also returns the result as a single row or all rows.



Enjoy : 



<?php

  /**

   * Selects Fields from a database/table.  

   * Also supports INNER JOINS, GROUP BY, ORDER BY.

   *

   * @Author : Jonathon Hibbard

   *

   * @param string $db_name         //Name of Database

   * @param string $table           //Name of Table

   * @param array $fields           //Field Names we want to select

   * @param array $inner            //Fields to be INNER JOINED

   * @param array $where            //WHERE fields.

   * @param string $group_by        //Field to group by.

   * @param string $order_by        //Field to order by

   * @param string $asc             //Asc or Desc order

   * @param string $return_array    //Defines $rst as an array or single row 

   * @return $rst                   //Returns the result

   *

   * @example : (1) getFields('mytool','master',

   *                          'array('master.master_id','master.fname_id'));

   *            (2) getFields('mytool','master',

   *                          'array('master.master_id','master.fname_id',

   *                          'fname.fname'), array(0=>array('mytool',

   *                          'fname','master','fname_id',)),

   *                          'master.default_value <> "", false);

   *            (3) getFields('mytool','master','master.master_id',NULL,

   *                          'master.fname_id = "3",NULL,NULL,NULL,false);

   */

  function getFields($db_name=NULL,$table=NULL,$fields=NULL,$inner=NULL, 

                     $where=NULL,$group_by=NULL,$order_by=NULL,$asc=NULL, 

                     $return_array=true) {

    $C_NAME = __CLASS__."::".__FUNCTION__;

    $sql = "SELECT ";

    is_array($fields) ? $sql .= implode(',',$fields) : $sql .= $fields;

    $sql .= " FROM ".$db_name.".".$table;

    if(!empty($inner)) {

      $total_inners = count($inner);

      for($i=0; $i<$total_inners; $i++)

        $sql .= " INNER JOIN ".$inner[$i][0].".".$inner[$i][1]." 

                  ON ".$inner[$i][1].".".$inner[$i][2]." = 

                     ".$inner[$i][3].".".$inner[$i][2];

    }

    if(!empty($where)) {

      is_array($where) ? $sql .= " WHERE ".implode(' AND ',$where)

                       : die("Fatal Error : Variable must be an array.  

                         Variable type is : ".gettype($where));

    }

    !empty($group_by) ? $sql .= " GROUP BY ".$group_by : '';

    !empty($order_by) ? $sql .= " ORDER BY ".$order_by : '';

    !empty($asc)      ? $sql .= " ".$asc : '';

    $sql .= " # Query resides in ".__FILE__."->".$C_NAME."

                on line ".__LINE__;

    if($return_array === true) {

      $rst = mysql_query($sql)

             or die("An Error Has Occurred!

                  \n MySQL Error Reports : ".mysql_error()."

                  \n The Error Occured in ".__FILE__." -> ".$C_NAME);

      $i=0;

      while($row = mysql_fetch_assoc($rst)) {

        $rowRst[] = $row[$fields[$i]];

        $i++;

      }

    } else {

      $rst = mysql_query($sql)

             or die("An Error Has Occurred! 

                  \n MySQL Error Reports : ".mysql_error()." 

                  \n The Error Occured in ".__FILE__." -> ".$C_NAME);

      $rowRst = mysql_fetch_assoc($rst);

    }

    return $rowRst;

  }

?>


[Editor's Note: In MySQL v5.0+, you can use the INFORMATION_SCHEMA tables to retrieve information on tables, views, databases and so on. --zak@php.net]





Here is a small function to parse a mysql creation table DDL. The function takes a string with the SQL code to create a table and returns the table name, table fields, table key fields and fields type, all in arrays (except by the name, obviously). The function requires that the primary key be named "id" and the foreign keys named "id...". All foreign key types are suposed to be int (or its variations, bigint, etc...). All those restrictions are easily modified to others needs.





Here is a example of a DDL code.





CREATE TABLE `telefones` (


  `id` int(11) NOT NULL auto_increment,


  `id_tipo_telefone` int(11) NOT NULL default '0',


  `numero` varchar(15) NOT NULL default '',


  `id_pessoa` int(11) NOT NULL default '0',


  PRIMARY KEY  (`id`),


  KEY `id_tipo_telefone` (`id_tipo_telefone`),


  KEY `id_pessoa` (`id_pessoa`),


  CONSTRAINT `0_775` FOREIGN KEY (`id_tipo_telefone`) REFERENCES `tipos_telefone` (`id`),


  CONSTRAINT `0_776` FOREIGN KEY (`id_pessoa`) REFERENCES `pessoas` (`id`)


) TYPE=InnoDB





that returns





$tbname = "telefones"


$fields = array("numero");


$kfields = array("id_tipo_telefone","id_pessoa");


$tipos = array("varchar");





Hope it helps...





<?php


function parseQuery($Q, &$tbname, &$fields, &$kfields, &$tipos) {





/** rules to a corect parse:


 *


 *     1 - primary key must be named "id"


 *     2 - foreign key must be named "id..." eg.: id_field


 *     3 - lowercase is recomended


 */





    $Q = str_replace(array(chr(10),chr(13))," ",$Q);


    $Q = str_replace(array("'","`")," ",$Q);





    preg_match("/([^(]*)\((.*)\)(.*)/",$Q,$A);





    $part1 = $A[1];


    $part2 = $A[2];


    $part3 = $A[3];





    preg_match("/(.*) ([a-zA-Z_]+)/",$part1,$A);





    $tbname = strtolower($A[2]);





    $temp = split(",",$part2);


    foreach ($temp as $t) {


        preg_match("/ *([a-zA-Z_]+) +([a-zA-Z_]+)(.*)/",$t,$A);


        $pcampo = strtolower($A[1]);


        $ptipo = strtolower($A[2]);


        if (!preg_match("/$pcampo/","primary key constraint id unique foreign") )  {


            if ( ($pcampo[0] == "i") && ($pcampo[1] == "d") )


                $kfields[] = $pcampo;


            else {


                $fields[] = $pcampo;


                $tipos[] = $ptipo;


            }


        }


    }


}


?>


Enabling MySQL with Windows Server 2003/IIS 6.0:

Find your php.ini file first, check phpinfo() to see where php is currently looking for php.ini. (i.e. Using the Windows installer for PHP 5.0.4, the php.ini file was placed in the C:\Windows dir.) I recommend, however, that you don't use the installer - go with full manual install.



Set the following in php.ini:

display_errors = on

error_reporting = E_ALL

This will make sure that you'll see any errors that arise during configuration. MAKE SURE TO CORRECT THESE WHEN YOU ARE DONE PLAYING WITH PHP.INI! Do not leave these settings like this on a production machine.



In php.ini set the following:

extension_dir = "pathtoextensions (ususally [yourpathtophp]\ext)"

extension=php_mysql.dll (make sure this is un-commented if its already in your php.ini)



In IIS, open Web Service Extensions, click "Add a new Web service extension..."

Type-in PHP for the extension name

Under required files:

Add  [yourpathtophp]\php5isapi.dll

Add  [yourpathtophp]\php5ts.dll

Click 'Apply' then click 'OK'



Create web sites like you normally would, but make sure they have executable permissions, not just script access. Under the "Home Directory" tab, click 'Configuration'. Scroll down the list at the top and see if you can find PHP. If you do, make sure the path to the executable for PHP is correct. If you don't find PHP in the list, click 'Add...', then browse to the correct executable, [yourpathtophp]\php5isapi.dll, and click OK. In the extension field, enter 'PHP'. Verbs should already be set to 'All verbs', leave it like that.



Create a test page with this code:

<? echo(phpinfo()); ?>

call it test.php, and place this file into the web site you just created. Browse to the page, with firefox preferably ;), and make sure that you have a MySql section with some MySql info in there. If not, then your paths are possibly screwed up, or you're still not editing the correct php.ini (again, look at the location that phpinfo() shows you, and just edit it there if you have to, then move it afterwards and re-config).



Hope this helps!


To count page hits, just put next code in a text file and include it in every one of your pages. It will log even different querystrings as different pages. (a MySQL database and table is needed first)



This can be a pretty good example of what you can do with PHP and MySQL. I made this script to log and show all hits in: http://www.venezolano.web.ve/



<?php

/************************

This needs a MySQL table you can create with this:



CREATE TABLE `stats_pagecounter` (

  `id` int(25) NOT NULL auto_increment,

  `page_name` varchar(255) NOT NULL default '',

  `page_hits` int(25) NOT NULL default '0',

  PRIMARY KEY  (`id`)

) TYPE=MyISAM; 



**************************

COUNTING STARTS

*************************/

function page_count($page) {

    $c_link        = mysql_connect('localhost', 'username', 'password')

        or die('counter CONNECT error: '.mysql_errno().', '.mysql_error());

    mysql_select_db('database_name');

    $c_query    = "SELECT * FROM stats_pagecounter

        WHERE (page_name = '$page')";

    $c_result    = mysql_query($c_query, $c_link) 

        or die('counter SELECT error: '.mysql_errno().', '.mysql_error());

    if (mysql_num_rows($c_result)) {

        $row=mysql_fetch_array($c_result,MYSQL_ASSOC);

        $pcounter = $row['page_hits']+1;

        $c_update = "UPDATE stats_pagecounter 

            SET page_hits = '$pcounter' WHERE page_name = '$page'";

        $c_hit = mysql_query($c_update, $c_link) 

            or die('counter UPDATE error: '.mysql_errno().', '.mysql_error());

    } else {

        $c_insert = "INSERT INTO stats_pagecounter

            VALUES ( '0', '$page', '1')";

        $c_page = mysql_query($c_insert, $c_link) 

            or die('counter INSERT error: '.mysql_errno().', '.mysql_error());

        $pcounter = 1;

    }

    mysql_free_result($c_result);

    mysql_close($c_link);

    return $pcounter;

}

$phpself_url = $_SERVER['SERVER_NAME'].

    $_SERVER['PHP_SELF'].'?'.

    $_SERVER['QUERY_STRING'];

$page_hits = page_count($phpself_url);

/************************

COUNTING ENDS

*************************/



/************************

Put next line in a page to show his page hits

(If you want to)

************************/

echo $page_hits;

?>