<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.22 $ -->
<!-- Purpose: database.vendors -->
<!-- Membership: bundled, external -->

 <reference id="ref.mysql">
  <title>MySQL Functions</title>
  <titleabbrev>MySQL</titleabbrev>

  <partintro>
   <section id="mysql.intro">
    &reftitle.intro;
    <para>
     These functions allow you to access MySQL database servers.
     More information about MySQL can be found at <ulink
     url="&url.mysql;">&url.mysql;</ulink>.
    </para>
    <para>
     Documentation for MySQL can be found at <ulink
     url="&url.mysql.docs;">&url.mysql.docs;</ulink>.
    </para>
   </section>

   <section id="mysql.requirements">
    &reftitle.required;
    <para>
     In order to have these functions available, you must compile PHP with
     MySQL support.
    </para>
   </section>
    
    &reference.mysql.configure;

    &reference.mysql.ini;

   <section id="mysql.resources">
   &reftitle.resources;
    <para>
     There are two resource types used in the MySQL module. The first one
     is the link identifier for a database connection, the second a resource
     which holds the result of a query.
    </para>
   </section>

   &reference.mysql.constants;
    
   <section id="mysql.notes">
   &reftitle.notes;
    <note>
     <para>
      Most MySQL functions accept <parameter>link_identifier</parameter> as
      the last optional parameter. If it is not provided, last opened
      connection is used. If it doesn't exist, connection is tried to
      establish with default parameters defined in &php.ini;. If it is not
      successful, functions return &false;.
     </para>
    </note>
   </section>

   <section id="mysql.examples">
   &reftitle.examples;
    <para>
     This simple example shows how to connect, execute a query, print
     resulting rows and disconnect from a MySQL database.
     <example>
      <title>MySQL extension overview example</title>
      <programlisting role="php">
<![CDATA[
<?php
// Connecting, selecting database
$link = mysql_connect('mysql_host', 'mysql_user', 'mysql_password')
    or die('Could not connect: ' . mysql_error());
echo 'Connected successfully';
mysql_select_db('my_database') or die('Could not select database');

// Performing SQL query
$query = 'SELECT * FROM my_table';
$result = mysql_query($query) or die('Query failed: ' . mysql_error());

// Printing results in HTML
echo "<table>\n";
while ($line = mysql_fetch_array($result, MYSQL_ASSOC)) {
    echo "\t<tr>\n";
    foreach ($line as $col_value) {
        echo "\t\t<td>$col_value</td>\n";
    }
    echo "\t</tr>\n";
}
echo "</table>\n";

// Free resultset
mysql_free_result($result);

// Closing connection
mysql_close($link);
?>
]]>
      </programlisting>
     </example>
    </para>
   </section>
  </partintro>

&reference.mysql.functions;

 </reference>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->