mysql-connect.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 554db5a3a3ac77910d68349eefa37e2c9a9da628 Maintainer: mustafa Status: ready -->
<refentry xml:id="function.mysql-connect" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>mysql_connect</refname>
  <refpurpose>MySQL Sunucusuna bir bağlantı açar</refpurpose>
 </refnamediv>

 <refsynopsisdiv>
  <warning>
   &mysql.alternative.note;
   <simplelist role="alternatives">
    <member><function>mysqli_connect</function></member>
    <member><methodname>PDO::__construct</methodname></member>
   </simplelist>
  </warning>
 </refsynopsisdiv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>resource</type><type>false</type></type><methodname>mysql_connect</methodname>
   <methodparam choice="opt"><type>string</type><parameter>sunucu</parameter><initializer>ini_get("mysql.default_host")</initializer></methodparam>
   <methodparam choice="opt"><type>string</type><parameter>kullanıcı_adı</parameter><initializer>ini_get("mysql.default_user")</initializer></methodparam>
   <methodparam choice="opt"><type>string</type><parameter>parola</parameter><initializer>ini_get("mysql.default_password")</initializer></methodparam>
   <methodparam choice="opt"><type>bool</type><parameter>yeni_bağlantı</parameter><initializer>&false;</initializer></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>istemci_seçenekleri</parameter><initializer>0</initializer></methodparam>
  </methodsynopsis>
  <para>
   Bir MySQL sunucusuna bir bağlantı açar veya var olanı tekrar kullanır.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>sunucu</parameter></term>
     <listitem>
      <para>
       MySQL sunucusu. "konak_adı:port" biçiminde ayrıca bir de port
       içerebileceği gibi localhost için belirtildiğinde ":/bir/yol/soket"
       biçiminde yerel bir sokete bir yol da belirtebilir.
      </para>
      <para>
       Eğer <link linkend="ini.mysql.default-host">mysql.default_host</link>
       PHP yönergesi tanımsızsa (öntanımlı), öntanımlı değer
       'localhost:3306''dır. &sqlsafemode;'da bu bağımsız değişken önemsenmez ve her
       zaman 'localhost:3306' değeri kullanılır.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>kullanıcı_adı</parameter></term>
     <listitem>
      <para>
       Kullanıcı adı. Öntanımlı değer
       <link linkend="ini.mysql.default-user">mysql.default_user</link> ile
       tanımlanır. &sqlsafemode;'da, bu bağımsız değişken önemsenmez ve sunucu
       sürecinin sahibi olan kullanıcı kullanılır.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>parola</parameter></term>
     <listitem>
      <para>
       Parola. Öntanımlı değer
      <link linkend="ini.mysql.default-password">mysql.default_password</link>
       ile tanımlanır. &sqlsafemode;'da, bu bağımsız değişken önemsenmez ve boş
       parola kullanılır.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>yeni_bağlantı</parameter></term>
     <listitem>
      <para>
       Eğer <function>mysql_connect</function> aynı bağımsız değişkenlerle ikinci kez
       çağrılırsa, yeni bir bağlantı kurulmaz, zaten açık olan bağlantının
       belirteci döndürülür. <parameter>yeni_bağlantı</parameter>
       bağımsız değişkeni bu davranışı değiştirir ve
       <function>mysql_connect</function>, daha önce aynı bağımsız değişkenlerle
       çağrılmış olsa bile her zaman yeni bir bağlantı açar. &sqlsafemode;'da
       bu bağımsız değişken önemsenmez.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>istemci_seçenekleri</parameter></term>
     <listitem>
      <para>
       <parameter>istemci_seçenekleri</parameter> bağımsız değişkeni şu sabitlerin bir karışımı olabilir:
       128 (<literal>LOAD DATA LOCAL</literal> tutamağı etkin),
       <constant>MYSQL_CLIENT_SSL</constant>,
       <constant>MYSQL_CLIENT_COMPRESS</constant>,
       <constant>MYSQL_CLIENT_IGNORE_SPACE</constant> veya
       <constant>MYSQL_CLIENT_INTERACTIVE</constant>.
       Daha fazla bilgi için <xref linkend="mysql.client-flags" /> ile ilgili
       bölümü okuyun. &sqlsafemode;'da bu bağımsız değişken önemsenmez.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Başarı durumunda bir MySQL bağlantı belirteci döndürür, hata durumunda
   &false; döndürür.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>- <function>mysql_connect</function> örneği</title>
    <programlisting role="php">
<![CDATA[
<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
    die('Bağlanamadı: ' . mysql_error());
}
echo 'Başarıyla bağlandı';
mysql_close($link);
?>
]]>
    </programlisting>
   </example>
  </para>
  <para>
   <example>
    <title>- <literal>konak_adı:port</literal> sözdizimini kullanan <function>mysql_connect</function> örneği</title>
    <programlisting role="php">
<![CDATA[
<?php
// 3307 portundan example.com'a bağlanıyoruz
$link = mysql_connect('example.com:3307', 'mysql_user', 'mysql_password');
if (!$link) {
    die('Bağlanamadı: ' . mysql_error());
}
echo 'Başarıyla bağlandı';
mysql_close($link);

// 3307 portundan localhost'a bağlanıyoruz
$link = mysql_connect('127.0.0.1:3307', 'mysql_user', 'mysql_password');
if (!$link) {
    die('Bağlanamadı: ' . mysql_error());
}
echo 'Başarıyla bağlandı';
mysql_close($link);
?>
]]>
    </programlisting>
   </example>
  </para>
  <para>
   <example>
    <title>- ":/bir/yol/soket" sözdizimini kullanan <function>mysql_connect</function> örneği</title>
    <programlisting role="php">
<![CDATA[
<?php
// localhost ve sokete, örneğin /tmp/mysql.sock, bağlanıyoruz

// 1. yol: localhost'u ihmal ederek
$link = mysql_connect(':/tmp/mysql', 'mysql_user', 'mysql_password');
if (!$link) {
    die('Bağlanamadı: ' . mysql_error());
}
echo 'Başarıyla bağlandı';
mysql_close($link);


// 2. yol: localhost ile
$link = mysql_connect('localhost:/tmp/mysql.sock', 'mysql_user', 'mysql_password');
if (!$link) {
    die('Bağlanamadı: ' . mysql_error());
}
echo 'Başarıyla bağlandı';
mysql_close($link);
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <para>
    Sunucu olarak &quot;localhost&quot; veya &quot;localhost:port&quot;
    belirttiğinizde, MySQL istemci kütüphanesi bunu geçersiz kılar ve yerel
    bir sokete (Windows'ta boru hattı (pipe) denir) bağlanmaya çalışır. TCP/IP
    kullanılmak istenirse, &quot;localhost&quot; yerine &quot;127.0.0.1&quot;
    kullanılır. Eğer MySQL istemci kütüphanesi yanlış bir yerel sokete
    bağlanmaya çalışırsa, doğru yolun  &php.ini; dosyasında
    <link linkend="ini.mysql.default-host">mysql.default_host</link>
    yönergesine atanması ve sunucu alanının boş bırakılması gerekir.
   </para>
  </note>
  <note>
   <para>
    Sunucuya bağlantı, eğer daha önceden <function>mysql_close</function>
    kullanılarak kapatılmadıysa, betiğin çalışması biter bitmez kapatılır.
   </para>
  </note>
  <note>
   <para>
    "Can't create TCP/IP socket (10106)" hatası genellikle
    <link linkend="ini.variables-order">variables_order</link> yapılandırma
    yönergesinin <literal>E</literal> harfini içermediği anlamına gelir.
    Windows'ta, ortam kopyalanmadıysa <literal>SYSTEMROOT</literal> ortam
    değişkeni kullanılamaz ve PHP Winsock'u yüklerken sorun yaşar.
   </para>
  </note>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>mysql_pconnect</function></member>
    <member><function>mysql_close</function></member>
   </simplelist>
  </para>
 </refsect1>
</refentry>

<!-- 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:"~/.phpdoc/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
-->