tpug Mon Dec 10 13:24:46 2001 EDT
Modified files:
/phpdoc/tr/features connection-handling.xml error-handling.xml
persistent-connections.xml remote-files.xml
Log:
some corrections by Alper
Index: phpdoc/tr/features/connection-handling.xml
diff -u phpdoc/tr/features/connection-handling.xml:1.1
phpdoc/tr/features/connection-handling.xml:1.2
--- phpdoc/tr/features/connection-handling.xml:1.1 Sun Dec 9 17:39:42 2001
+++ phpdoc/tr/features/connection-handling.xml Mon Dec 10 13:24:46 2001
@@ -1,81 +1,81 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<?xml version="1.0" encoding="iso-8859-9"?>
+<!-- $Revision: 1.2 $ -->
<chapter id="features.connection-handling">
- <!-- dirge: handling => isleme -->
- <title>Bağlantı İşleme</title>
+ <!-- dirge: handling => i�leme -->
+ <title>Ba�lant� ��leme</title>
- <note>
- <para>Burada yazanlar 3.0.7 ve sonrası s�r�mler i�in ge�erlidir.</para>
- </note>
-
- <para>
- PHP'nin i�inde bağlantı durumu muhafaza edilir. Olası
durumlar 3
- tanedir:
- <itemizedlist>
- <listitem><simpara>0 - NORMAL (normal)</simpara></listitem>
- <listitem><simpara>1 - ABORTED (iptal edilmiş)</simpara></listitem>
- <listitem><simpara>2 - TIMEOUT (zaman aşımına
uğramış)</simpara></listitem>
- </itemizedlist>
- </para>
-
- <simpara>
- PHP betiği normal olarak �alışırken NORMAL durumu
aktiftir. Eğer alıcı
- taraf bağlantıyı keserse ABORTED durumu anahtarı
aktifleştirilir. Alıcı
- tarafın bağlantıyı kesmesi genellikle uzak
kullanıcının STOP d�ğmesine
- basmasından kaynaklanır. Eğer PHP'ye bildirilen zaman
sınırına (bkz.
- <function>set_time_limit</function>) ulaşılırsa, TIMEOUT
durum anahtarı
- aktifleştirilir.
- </simpara>
-
- <simpara>
- Alıcının bağlantıyı kesmesi durumunda
PHP betiğinin �alışmasının durdurulup
- durdurulmayacağını se�ebilirsiniz. Bazı durumlarda
karşı taraftaki internet
- gezgini yolladığınız �ıktıyı
almıyor olsa bile PHP betiğinin normal olarak
- sonlanması kullanışlı olabilir. Ancak PHP'nin
�ntanımlı davranışı karşı
- taraftaki internet gezgini bağlantıyı kestiğinde
betiği sonlandırmaktır.
- Bu davranış ignore_user_abort php.ini direktifiyle
ayarlanabileceği gibi
- bunun Apache .conf karşılığı olan
php3_ignore_user_abort direktifiyle veya
- <function>ignore_user_abort</function> fonksiyonuyla da ayarlanabilir. Tek
- istisna <function>register_shutdown_function</function> fonksiyonu ile
- bir kapanış fonksiyonu tanımlamanızdır.
Tanımlı bir kapanış fonkiyonu
- varken, betiğiniz �ıktı yollamaya
�alıştığında PHP alıcının STOP
d�ğmesine
- bastığını algılayacak ve
tanımladığınız fonksiyonu
�ağıracaktır. Bu kapanış
- fonksiyonu ayrıca betiğiniz normal olarak
sonlandığında da �ağrılacağı
- i�in, sadece bağlantının kesilmesi durumunda
yapılmasını istediğiniz işler
- varsa <function>connection_aborted</function> fonksiyonunu
- kullanabilirsiniz. Bu fonksiyon bağlantı kesilmişse &true;
değerini
- d�nd�recektir.
- </simpara>
-
- <simpara>
- Betiğiniz ayrıca yerleşik betik s�re-�l�eri tarafından
da
- sonlandırılabilir. �ntanımlı zaman 30 saniyedir. Bu
değer
- max_execution_time php.ini direktifi veya bunun Apache .conf
karşılığı olan
- php3_max_execution_time direktifi ile ayarlanabileceği gibi
- <function>set_time_limit</function> fonksiyonuyla da ayarlanabilir.
- Belirlenen azami s�renin dolması durumunda betik
sonlandırılacak, ve
- yukarıdaki bağlantı kesilmesi durumunda olduğu gibi,
varsa, tanımlanmış
- kapanış fonksiyonu �ağrılacaktır. Bu
kapanış fonksiyonunun i�inde,
- �ağrılmasının sebebinin s�re dolması olup
olmadığını �ğrenmek isterseniz
- <function>connection_timeout</function> fonksiyonunu kullanabilirsiniz. Bu
- fonksiyon s�renin dolmuş olması durumunda &true; değerini
d�nd�recektir.
- </simpara>
-
- <simpara>
- Dikkat edilmesi gereken bir nokta hem ABORTED hem de TIMEOUT
durumlarının
- aynı anda aktif olabileceğidir. Bu, PHP'ye karşı
tarafın bağlantıyı
- sonlandırmasını g�zardı etmesini s�ylerseniz m�mk�n
olur. PHP'nin
- bağlantının kapandığını
anlamasına rağmen betik �alışmaya devam edecektir.
- S�re sınırı aşıldığında
betik sonlandırılır ve, varsa, kapanış fonksiyonu
- �ağrılır. Bu noktada <function>connection_timeout</function>
ve
- <function>connection_aborted</function> fonksiyonları &true; değerini
- d�nd�r�r. İki durumu aynı anda <function>connection_status</function>
- fonksiyonu ile kontrol edebilirsiniz. Bu fonksiyon aktif durumları i�eren
- bit alanını d�nd�r�r. �rneğin, iki durum da aktifse geriye
d�n�ş değeri
- olarak 3'� verecektir.
- </simpara>
-
- </chapter>
+ <note>
+ <para>Burada yazanlar 3.0.7 ve sonras� s�r�mler i�in ge�erlidir.</para>
+ </note>
+
+ <para>
+ PHP'nin i�inde ba�lant� durumu saklan�r. Olas� durumlar 3 tanedir:
+ <itemizedlist>
+ <listitem><simpara>0 - NORMAL (normal)</simpara></listitem>
+ <listitem><simpara>1 - ABORTED (iptal edilmi�)</simpara></listitem>
+ <listitem><simpara>2 - TIMEOUT (zaman a��m�na u�ram��)</simpara></listitem>
+ </itemizedlist>
+ </para>
+
+ <simpara>
+ PHP beti�i normal olarak �al���rken NORMAL durumu aktiftir. E�er al�c�
+ taraf ba�lant�y� keserse ABORTED durum anahtar� aktifle�tirilir. Al�c�
+ taraf�n ba�lant�y� kesmesi genellikle uzaktaki kullan�c�n�n STOP d��mesine
+ basmas�ndan kaynaklan�r. E�er PHP'ye bildirilen zaman s�n�r�na (bkz.
+ <function>set_time_limit</function>) ula��l�rsa, TIMOUT durum anahtar�
+ aktifle�tirilir.
+ </simpara>
+
+ <simpara>
+ <!-- dirge: return => d�nd�rmek -->
+ <!-- dirge: directive => direktif -->
+ Al�c�n�n ba�lant�y� kesmesi durumunda PHP beti�inin �al��mas�n�n durdurulup
+ durdurulmayaca��n� se�ebilirsiniz. Baz� durumlarda kar�� taraftaki internet
+ gezgini yollad���n�z ��kt�y� alm�yor olsa bile PHP beti�inin normal olarak
+ sonlanmas� kullan��l� olabilir. Ancak PHP'nin �ntan�ml� davran��� kar��
+ taraftaki internet gezgini ba�lant�y� kesti�inde beti�i sonland�rmakt�r.
+ Bu davran�� ignore_user_abort php.ini direktifiyle ayarlanabilece�i gibi
+ bunun Apache .conf kar��l��� olan php3_ignore_user_abort direktifiyle veya
+ <function>ignore_user_abort</function> fonksiyonuyla da ayarlanabilir. Tek
+ istisna <function>register_shutdown_function</function> fonksiyonu ile
+ bir kapan�� fonksiyonu tan�mlaman�zd�r. Tan�ml� bir kapan�� fonkiyonu
+ varken, beti�iniz ��kt� yollamaya �al��t���nda PHP al�c�n�n STOP d��mesine
+ bast���n� alg�layacak ve tan�mlad���n�z fonksiyonu �a��racakt�r. Bu kapan��
+ fonksiyonu ayr�ca beti�iniz normal olarak sonland���nda da �a�r�laca��
+ i�in, sadece ba�lant�n�n kesilmesi durumunda yap�lmas�n� istedi�iniz i�ler
+ varsa <function>connection_aborted</function> fonksiyonunu
+ kullanabilirsiniz. Bu fonksiyon e�er ba�lant� kesilmi�se &true; de�erini
+ d�nd�recektir.
+ </simpara>
+
+ <simpara>
+ Beti�iniz ayr�ca yerle�ik betik s�re-�l�eri taraf�ndan da
+ sonland�r�labilir. �ntan�ml� zaman 30 saniyedir. Bu de�er
+ max_execution_time php.ini direktifi veya bunun Apache .conf kar��l��� olan
+ php3_max_execution_time direktifi ile ayarlanabilece�i gibi
+ <function>set_time_limit</function> fonksiyonuyla da ayarlanabilir.
+ Belirlenen azami s�renin dolmas� durumunda betik sonland�r�lacak, ve
+ yukar�daki ba�lant� kesilmesi durumunda oldu�u gibi, varsa, tan�mlanm��
+ kapan�� fonksiyonu �a�r�lacakt�r. Bu kapan�� fonksiyonunun i�inde,
+ �a�r�lmas�n�n sebebinin s�re dolmas� olup olmad���n� ��renmek isterseniz
+ <function>connection_timeout</function> fonksiyonunu kullanabilirsiniz. Bu
+ fonksiyon s�renin dolmu� olmas� durumunda &true; de�erini d�nd�recektir.
+ </simpara>
+
+ <simpara>
+ Dikkat edilmesi gereken bir nokta hem ABORTED hem de TIMEOUT durumlar�n�n
+ ayn� anda aktif olabilece�idir. Bu, PHP'ye kar�� taraf�n ba�lant�y�
+ sonland�rmas�n� g�zard� etmesini s�ylerseniz m�mk�n olur. PHP'nin
+ ba�lant�n�n kapand���n� anlamas�na ra�men betik �al��maya devam edecektir.
+ S�re s�n�r� a��ld���nda betik sonland�r�l�r ve, varsa, kapan�� fonksiyonu
+ �a�r�l�r. Bu noktada <function>connection_timeout</function> ve
+ <function>connection_aborted</function> fonksiyonlar� &true; de�erini
+ d�nd�r�r. �ki durumu ayn� anda <function>connection_status</function>
+ fonksiyonu ile kontrol edebilirsiniz. Bu fonksiyon aktif durumlar� i�eren
+ bit alan�n� d�nd�r�r. �rne�in, iki durum da aktifse geriye d�n�� de�eri
+ olarak 3'� verecektir.
+ </simpara>
+</chapter>
<!-- Keep this comment at the end of the file
Local variables:
Index: phpdoc/tr/features/error-handling.xml
diff -u phpdoc/tr/features/error-handling.xml:1.1
phpdoc/tr/features/error-handling.xml:1.2
--- phpdoc/tr/features/error-handling.xml:1.1 Sun Dec 9 21:24:49 2001
+++ phpdoc/tr/features/error-handling.xml Mon Dec 10 13:24:46 2001
@@ -1,19 +1,19 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<chapter id="features.error-handling">
- <title>Hata �lemleri</title>
+ <title>Hata ��lemleri</title>
<para>
- PHP'de pek �ok uyarı �e�idi vardır. Bunlar:
+ PHP'de pek �ok uyar� �e�idi vard�r. Bunlar:
<table>
- <title>PHP uyarı �e�itleri</title>
+ <title>PHP uyar� �e�itleri</title>
<tgroup cols="4">
<thead>
<row>
- <entry>Değer</entry>
+ <entry>De�er</entry>
<entry>Sabit</entry>
- <entry>Tanım</entry>
+ <entry>Tan�m</entry>
<entry>Not</entry>
</row>
</thead>
@@ -21,40 +21,40 @@
<row>
<entry>1</entry>
<entry>E_ERROR</entry>
- <entry>hayati �alı�ma hataları</entry>
+ <entry>hayati �al��ma hatalar�</entry>
<entry></entry>
</row>
<row>
<entry>2</entry>
<entry>E_WARNING</entry>
- <entry>�alı�ma uyarıları (hayati olmayan hatalar)</entry>
+ <entry>�al��ma uyar�lar� (hayati olmayan hatalar)</entry>
<entry></entry>
</row>
<row>
<entry>4</entry>
<entry>E_PARSE</entry>
- <entry>derleme sırasında ayrı�tırma
hataları</entry>
+ <entry>derleme s�ras�nda ayr��t�rma hatalar�</entry>
<entry></entry>
</row>
<row>
<entry>8</entry>
<entry>E_NOTICE </entry>
<entry>
- �alı�ma sırasındaki bildirimler (uyarılardan daha
az �nemli)
+ �al��ma s�ras�ndaki bildirimler (uyar�lardan daha az �nemli)
</entry>
<entry></entry>
</row>
<row>
<entry>16</entry>
<entry>E_CORE_ERROR</entry>
- <entry>PHP'nin i� yapısıyla ilgili,
ba�latılmasını engelleyen hayati hatalar</entry>
+ <entry>PHP'nin i� yap�s�yla ilgili, ba�lat�lmas�n� engelleyen hayati
+hatalar</entry>
<entry>sadece PHP 4</entry>
</row>
<row>
<entry>32</entry>
<entry>E_CORE_WARNING</entry>
<entry>
- PHP'nin i� yapısıyla ilgili, ba�latılması ile
ilgili uyarılar (hayati olmayan
+ PHP'nin i� yap�s�yla ilgili, ba�lat�lmas� ile ilgili uyar�lar (hayati olmayan
hatalar)
</entry>
<entry>sadece PHP 4</entry>
@@ -62,37 +62,37 @@
<row>
<entry>64</entry>
<entry>E_COMPILE_ERROR</entry>
- <entry>hayati derleme hataları</entry>
+ <entry>hayati derleme hatalar�</entry>
<entry>Sadece PHP 4</entry>
</row>
<row>
<entry>128</entry>
<entry>E_COMPILE_WARNING</entry>
- <entry>derleme sırasındaki uyarılar (hayati olmayan
hatalar)</entry>
+ <entry>derleme s�ras�ndaki uyar�lar (hayati olmayan hatalar)</entry>
<entry>sadece PHP 4</entry>
</row>
<row>
<entry>256</entry>
<entry>E_USER_ERROR</entry>
- <entry>kullanıcının yarattığı hata
mesajı</entry>
+ <entry>kullan�c�n�n yaratt��� hata mesaj�</entry>
<entry>sadece PHP 4</entry>
</row>
<row>
<entry>512</entry>
<entry>E_USER_WARNING</entry>
- <entry>kullanıcının yarattığı
uyarı mesajı</entry>
+ <entry>kullan�c�n�n yaratt��� uyar� mesaj�</entry>
<entry>sadece PHP 4</entry>
</row>
<row>
<entry>1024</entry>
<entry>E_USER_NOTICE </entry>
- <entry>kullanıcının yarattığı
bildiri mesajı</entry>
+ <entry>kullan�c�n�n yaratt��� bildiri mesaj�</entry>
<entry>sadece PHP 4</entry>
</row>
<row>
<entry></entry>
<entry>E_ALL</entry>
- <entry>desteklendiği s�rece, yukarıdakilerin hepsi</entry>
+ <entry>desteklendikleri s�rece, yukar�dakilerin hepsi</entry>
<entry></entry>
</row>
</tbody>
@@ -101,82 +101,82 @@
</para>
<para>
- Yukarıdaki değerler (sayısal veya sembolik) hangi
hataların bildirileceğini
- belirleyen bit maskesini olu�tururken kullanılır. Bu değerleri
- birle�tirmeyi veya bazılarını maskelemeyi
- <link linkend="language.operators.bitwise">bit-tabanlı i�lemler</link> ile
+ Yukar�daki de�erler (say�sal veya sembolik) hangi hatalar�n bildirilece�ini
+ belirleyen bit maskesini olu�tururken kullan�l�r. Bu de�erleri
+ birle�tirmeyi veya baz�lar�n� maskelemeyi
+ <link linkend="language.operators.bitwise">bit-tabanl� i�lemler</link> ile
yapabilirsiniz. <filename>php.ini</filename> i�inde sadece '|', '~', '!' ve
- '&' i�lemlerinin anla�ılacağına, ve
<filename>php3.ini</filename>
- i�inde hi�birinin anla�ılmayacağına dikkat edin.
+ '&' i�lemlerinin anla��laca��na, ve <filename>php3.ini</filename>
+ i�inde hi�birinin anla��lmayaca��na dikkat edin.
</para>
<para>
- PHP 4'te �ntanımlı <link
- linkend="ini.error-reporting">error_reporting</link> değeri <literal>E_ALL
- & ~E_NOTICE</literal>'dir ve anlamı E-NOTICE-seviyesi
dı�ındaki t�m
- hataların ve uyarıların bildirilmesidir. PHP 3'de
�ntanımlı ayar
- <literal>(E_ERROR | E_WARNING | E_PARSE)</literal>'dır ve anlamı
�ncekiyle
- aynıdır. Fakat dikkat edin ki, PHP 3'�n <filename>php3.ini</filename>
- dosyasında sabitler desteklenmediğinden <link
- linkend="ini.error-reporting">error_reporting</link> ayarı sayısal
olmak
- durumundadır; az �nce belirtilen değer de <literal>7</literal>'ye
denk
+ PHP 4'te �ntan�ml� <link
+ linkend="ini.error-reporting">error_reporting</link> de�eri <literal>E_ALL
+ & ~E_NOTICE</literal>'dir ve anlam� E-NOTICE-seviyesi d���ndaki t�m
+ hatalar�n ve uyar�lar�n bildirilmesidir. PHP 3'de �ntan�ml� ayar
+ <literal>(E_ERROR | E_WARNING | E_PARSE)</literal>'d�r ve anlam� �ncekiyle
+ ayn�d�r. Fakat dikkat edin ki, PHP 3'�n <filename>php3.ini</filename>
+ dosyas�nda sabitler desteklenmedi�inden <link
+ linkend="ini.error-reporting">error_reporting</link> ayar� say�sal olmak
+ durumundad�r; az �nce belirtilen de�er de <literal>7</literal>'ye denk
gelir.
</para>
<para>
- Ba�langı� değeri ini dosyasında <link
- linkend="ini.error-reporting">error_reporting</link> direktifyle,
- Apache'nizin <filename>httpd.conf</filename> dosyasında php_error_reporting
- (PHP 3 i�in php3_error_reporting) direktifiyle, ve son olarak �alı�ma
- esnasında betik i�inden <function>error_reporting</function> fonksiyonuyla
+ Ba�lang�� de�eri ini dosyas�nda <link
+ linkend="ini.error-reporting">error_reporting</link> direktifiyle,
+ Apache'nizin <filename>httpd.conf</filename> dosyas�nda php_error_reporting
+ (PHP 3 i�in php3_error_reporting) direktifiyle, ve son olarak �al��ma
+ esnas�nda betik i�inden <function>error_reporting</function> fonksiyonuyla
belirlenebilir.
</para>
<warning>
<para>
- Sunucularınızı veya kodlarınızı PHP
3'ten PHP 4'e y�kseltirken bu ayarları
- ve <function>error_reporting</function> fonksiyonu
�ağrımlarını kontrol
- etmelisiniz yoksa istemeyerek yeni hata �e�itlerinin bildirimlerini
- kapatabilirsiniz, �zellikle E_COMPILE_ERROR. Bu hatanın ne ve nerede
- olduğuna dair hi� bir bilgi bırakmadan betiklerinizin tamamiyle bo�
+ Sunucular�n�z� veya kodlar�n�z� PHP 3'ten PHP 4'e g�ncellerken bu ayarlar�
+ ve <function>error_reporting</function> fonksiyonu �a�r�mlar�n� kontrol
+ etmelisiniz, yoksa istemeyerek yeni hata �e�itlerinin bildirimlerini
+ kapatabilirsiniz, �zellikle E_COMPILE_ERROR'u. Bu, hatan�n ne ve nerede
+ oldu�una dair hi� bir bilgi b�rakmadan betiklerinizin tamamiyle bo�
sayfalar �retmesine yola�abilir.
</para>
</warning>
<para>
- T�m <link linkend="language.expressions">PHP ifadeler</link> @ �n-ekiyle
- �ağrılabilir. Bu �n-ek, o ifade i�in hata bildirimini
kapatacaktır. Eğer
- b�yle bir ifade sırasında hata olu�ursa, ve <link
- linkend="ini.track-errors">track_errors</link> �zelliği aktifse, hata
- mesajını <literal>$php_errormsg</literal> genel deği�keninde
+ T�m <link linkend="language.expressions">PHP ifadeleri</link> @ �n-ekiyle
+ �a�r�labilir. Bu �n-ek, o ifade i�in hata bildirimini kapatacakt�r. E�er
+ b�yle bir ifade s�ras�nda hata olu�ursa, ve <link
+ linkend="ini.track-errors">track_errors</link> �zelli�i aktifse, hata
+ mesaj�n� <literal>$php_errormsg</literal> genel de�i�keninde
bulabilirsiniz.
</para>
<note>
<para>
<link linkend="language.operators.errorcontrol">@ hata-kontrol
- i�lemi</link> �n-eki ayrı�tırma hatalarını
kapatmayacaktır.
+ i�lemi</link> �n-eki, ayr��t�rma hatalar�n� kapatmayacakt�r.
</para>
</note>
<warning>
<para>
- Şu an i�in <link linkend="language.operators.errorcontrol">@
- hata-kontrol i�lemi</link> �n eki betik sonlandırılmasına
yol a�acak
- kritik hataların bile g�sterilmesini engelleyecektir. Diğer �eylerin
- dı�ında, bu demektir ki <link
+ �u an i�in <link linkend="language.operators.errorcontrol">@
+ hata-kontrol i�lemi</link> �n-eki betik sonland�r�lmas�na yol a�acak
+ kritik hatalar�n bile g�sterilmesini engelleyecektir. Di�er �eylerin
+ d���nda, bu demektir ki <link
linkend="language.operators.errorcontrol">@</link> �n-ekini belli
- fonksiyonlardan gelecek hataları bastırmak i�in
kullanırsanız, ve bu
- fonksiyonlar tanımlı değilse, betik nedeni belirtilmeden
- sonlandırılacaktır.
+ fonksiyonlardan gelecek hatalar� bast�rmak i�in kullan�rsan�z, ve bu
+ fonksiyonlar tan�ml� de�ilse, betik nedeni belirtilmeden
+ sonland�r�lacakt�r.
</para>
</warning>
<para>
- A�ağıda PHP'deki hata kontrol� i�lemlerinin
kullanımına ili�kin bir �rnek
- bulacaksınız. Burada bilgileri bir g�nl�kte (XML formatıyla)
saklayan ve
- programcıya kritik hatalarda e-mail yollayan bir hata i�leme fonksiyonu
tanımlıyoruz.
+ A�a��da PHP'deki hata kontrol� i�lemlerinin kullan�m�na ili�kin bir �rnek
+ bulacaks�n�z. Burada bilgileri XML format�nda bir g�nl�kte saklayan ve
+ programc�ya kritik hatalarda e-mail yollayan bir hata i�leme fonksiyonu
+tan�ml�yoruz.
<example>
- <title>Betik i�in hata i�lemenin kullanımı</title>
+ <title>Betik i�in hata i�lemenin kullan�m�</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -281,12 +281,12 @@
]]>
</programlisting>
</example>
- Bu <link linkend="ref.errorfunc">Hata �leme ve G�nl�k
fonksiyonları</link>
- hakkında basit bir �rnek.
+ Bu <link linkend="ref.errorfunc">Hata ��leme ve G�nl�k fonksiyonlar�</link>
+ hakk�nda basit bir �rnek.
</para>
<para>
- Ayrıca bkz. <function>error_reporting</function>,
+ Ayr�ca bkz. <function>error_reporting</function>,
<function>error_log</function>,
<function>set_error_handler</function>,
<function>restore_error_handler</function>,
Index: phpdoc/tr/features/persistent-connections.xml
diff -u phpdoc/tr/features/persistent-connections.xml:1.1
phpdoc/tr/features/persistent-connections.xml:1.2
--- phpdoc/tr/features/persistent-connections.xml:1.1 Sun Dec 9 21:24:49 2001
+++ phpdoc/tr/features/persistent-connections.xml Mon Dec 10 13:24:46 2001
@@ -1,117 +1,120 @@
<?xml version="1.0" encoding="iso-8859-9"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<chapter id="features.persistent-connections">
- <title>Kalıcı Veritabanı
Bağlantıları</title>
+ <title>Kal�c� Veritaban� Ba�lant�lar�</title>
<simpara>
- Kalıcı bağlantılar, betiğiniz
sonlandığında kapatılmayan SQL
bağlantılarına
- denir. Kalıcı bir bağlantı istendiğinde, PHP
daha �nceden tamamen aynı
- �zelliklerde başka bir kalıcı bağlantı
a�ılıp a�ılmadığına bakar (daha
- �nceden kalan) - ve eğer varsa, onu kullanır. Eğer yoksa,
yeni bağlantıyı
- yapar. 'Tamamen aynı' bağlantılar, aynı sunucuya,
aynı kullanıcı ismi ve
- şifreyle (gerekliyse) a�ılmış
bağlantılardır.
+ Kal�c� ba�lant�lar, beti�iniz sonland���nda kapat�lmayan SQL ba�lant�lar�na
+ denir. Kal�c� bir ba�lant� istendi�inde, PHP daha �nceden tamamen ayn�
+ �zelliklerde ba�ka bir kal�c� ba�lant� a��l�p a��lmad���na bakar (daha
+ �nceden kalan) - ve e�er varsa, onu kullan�r. E�er yoksa, yeni ba�lant�
+ kurar. 'Tamamen ayn�' ba�lant�lar, ayn� sunucuya, ayn� kullan�c� ismi ve
+ (gerekliyse) �ifreyle a��lm�� ba�lant�lard�r.
</simpara>
<simpara>
- HTTP sunucularının �alışma
mantığına aşina olmayanlar, kalıcı
bağlantıları
- ger�ekte olmadıkları şeyler sanabilirler. �zellikle,
aynı SQL bağlantısı
- �zerinde 'kullanıcı oturumları' <emphasis>a�mazlar</emphasis>,
- transaction'ları daha etkili bir şekilde yapmanızı
- <emphasis>sağlamazlar</emphasis> ve başka pek �ok şeyi
ger�ekleştirmezler.
- Konu hakkında daha a�ık olmak gerekirse, kalıcı
bağlantılar size kardeşleri
- kalıcı olmayan bağlantıların
sunmadığı hi� bir ek �zellik
+ HTTP sunucular�n�n �al��ma mant���na a�ina olmayanlar, kal�c� ba�lant�lar�
+ ger�ekte olmad�klar� �eyler sanabilirler. �zellikle, ayn� SQL ba�lant�s�
+ �zerinde 'kullan�c� oturumlar�' <emphasis>a�mazlar</emphasis>,
+ transaction'lar� daha etkili bir �ekilde yapman�z�
+ <emphasis>sa�lamazlar</emphasis> ve ba�ka pek �ok �eyi ger�ekle�tirmezler.
+ Konu hakk�nda daha a��k olmak gerekirse, kal�c� ba�lant�lar size karde�leri
+ kal�c� olmayan ba�lant�lar�n sunmad��� hi� bir ek �zellik
<emphasis>sunmazlar</emphasis>.
</simpara>
<simpara>
Neden?
</simpara>
<simpara>
- Bu daha �ok HTTP sunucularının �alışma
mantığıyla alakalı. Sunucunun
- PHP'yi kullanarak web sayfaları oluşturmasının ��
y�ntemi var.
+ Bu daha �ok HTTP sunucular�n�n �al��ma mant���yla alakal�. Sunucunun
+ PHP'yi kullanarak web sayfalar� olu�turmas�n�n �� y�ntemi var.
</simpara>
<simpara>
- <!-- dirge: wrapper => sargı -->
- İlk y�ntem PHP'yi CGI "sargısı" olarak kullanmak. Bu
şekilde �alıştığında,
- sunucuya gelen her sayfa isteği i�in ayrı bir PHP
yorumlayıcısı yaratılır
- ve yokedilir (PHP sayfaları i�in). İşlemler sonunda
yokedildikleri i�in,
- yarattıkları her kaynak (SQL sunucusuna bağlantılar
gibi) da onlarla
- birlikte yokolur. Bu durumda, kalıcı bağlantılar
kurmayı denemekle elinize
- hi�birşey ge�mez -- basit�e, kalıcı olamazlar.
- </simpara>
- <simpara>
- İkinci, ve en pop�ler, y�ntem PHP'yi �ok işlemli (multiprocess) bir
- sunucuda mod�l olarak kullanmak, şu an sadece Apache'de olduğu gibi.
�ok
- işlemli bir sunucu genellikle bir ana işlemden (parent) ve onun
kontrol�ndeki
- ger�ekte işlemleri yapan �ocuk işlemlerden (children) oluşur.
Ne zaman bir
- alıcıdan istek gelse, o anda başka bir isteğe cevap
vermeyen bir �ocuk
- işleme devredilir. Bu demektir ki, aynı alıcı ikinci
bir istek yolladığında,
- başka bir �ocuk işlem tarafından
karşılanabilir. Kalıcı bağlantıların
- sizin i�in burada yaptığı iş, her �ocuk işlemin
sadece ilk seferde SQL
- sunucusuna bağlanması. Başka bir sayfanın aynı
bağlantıya duyması durumunda
- �nceden yapılmış bağlantı
kullanılır.
- </simpara>
- <simpara>
- <!-- dirge: thread => iş par�acığı -->
- Son y�ntem PHP'yi �ok iş par�acıklı (multithreaded)
sunucularda eklenti
- olarak kullanmak. Şu anda PHP 4'�n Netscape FastTrack (iPlanet), Microsoft
- Internet Information Server (IIS), ve O'Reilly Website Pro gibi �ok iş
- par�acıklı sunucularda �alışmasını
sağlayan ISAPI, WSAIP, ve NSAPI
- (Windows'ta) i�in desteği var. Bu �alışma şekli az
�nce anlatılan �ok
- işlemli modelle aynı. SAPI desteğinin PHP 3'te
olmadığına dikkat edin.
+ <!-- dirge: wrapper => sarg� -->
+ �lk y�ntem PHP'yi CGI "sarg�s�" olarak kullanmak. Bu �ekilde �al��t���nda,
+ sunucuya gelen her sayfa iste�i i�in ayr� bir PHP yorumlay�c�s� yarat�l�r
+ ve yokedilir (PHP sayfalar� i�in). ��lemler sonunda yokedildikleri i�in,
+ yaratt�klar� her kaynak da (SQL sunucusuna ba�lant�lar gibi) onlarla
+ birlikte yokolur. Bu durumda, kal�c� ba�lant�lar kurmay� denemekle elinize
+ hi�bir�ey ge�mez -- basit�e, kal�c� olamazlar.
+ </simpara>
+ <simpara>
+ <!-- dirge: multiprocess => �ok i�lemli -->
+ �kinci, ve en pop�ler, y�ntem PHP'yi �ok i�lemli (multiprocess) bir
+ sunucuda mod�l olarak kullanmak, �u an sadece Apache'de oldu�u gibi. �ok
+ i�lemli bir sunucu genellikle bir ana i�lemden (parent) ve onun kontrol�ndeki
+ ger�ekte i�lemleri yapan �ocuk i�lemlerden (children) olu�ur. Ne zaman bir
+ al�c�dan istek gelse, istek o anda ba�ka bir iste�e cevap vermeyen bir �ocuk
+ i�leme devredilir. Bu demektir ki, ayn� al�c� ikinci bir istek yollad���nda,
+ ba�ka bir �ocuk i�lem taraf�ndan kar��lanabilir. Kal�c� ba�lant�lar�n
+ sizin i�in burada yapt��� i�, her �ocuk i�lemin sadece ilk seferde SQL
+ sunucusuna ba�lanmas�d�r. Ba�ka bir sayfan�n ayn� ba�lant�ya ihtiya� duymas�
+ durumunda �nceden kurulmu� ba�lant� kullan�l�r.
+ </simpara>
+ <simpara>
+ <!-- dirge: thread => i� par�ac��� -->
+ Son y�ntem PHP'yi �ok i� par�ac�kl� (multithreaded) sunucularda eklenti
+ olarak kullanmak. �u anda PHP 4'�n Netscape FastTrack (iPlanet), Microsoft
+ Internet Information Server (IIS), ve O'Reilly Website Pro gibi �ok i�
+ par�ac�kl� sunucularda �al��mas�n� sa�layan ISAPI, WSAIP, ve NSAPI
+ (Windows'ta) i�in deste�i var. Bu �al��ma �ekli az �nce anlat�lan �ok
+ i�lemli modelle ayn�. SAPI deste�inin PHP 3'te olmad���na dikkat edin.
</simpara>
<simpara>
- Eğer kalıcı bağlantıların ek �zellikleri
yoksa, neye yararlar?
+ E�er kal�c� ba�lant�lar�n ek �zellikleri yoksa, neye yararlar?
</simpara>
<simpara>
<!-- dige: efficiency => etkinlik -->
- Buradaki cevap olduk�a basit -- etkinlik. Kalıcı
bağlantılar, SQL
- sunucunuza yeni bağlantı a�mak performans a�ısından
hesaplı değilse
- �ok işe yararlar. Performans hesaplılığı pek
�ok şeye bağlıdır. �rneğin, ne
- t�r bir veritabanı olduğu, HTTP sunucusuyla aynı bilgisayarda
olup
- olmayışı, SQL sunucusunun
�alıştığı bilgisayarın işlem
yoğunluğu ve
- benzeri. Sonu� şu ki, yeni bağlantı performansı
d�şï¿½kse, kalıcı bağlantılar
- işe yarar. Her �ocuk işlemin her seferinde yeni
bağlantı a�ması yerine
- hayatı boyunca sadece bir kere bağlantı
yapmasını ve s�rekli onu kullanmasını
- sağlarlar. Bu demektir ki, kalıcı bağlantı a�an
her �ocuk işlemin SQL
- sunucusuna kendine ait kalıcı bir bağlantısı
olacaktır. �rneğin, 20 tane
- kalıcı bağlantı a�an betik
�alıştırmış farklı �ocuk işlem varsa,
SQL
- sunucusuna 20 tane bağlantı olacaktır, her �ocuk
işlemden bir tane.
- </simpara>
- <simpara>
- Ancak dikkat edin ki, bunun SQL sunucusunun bağlantı limiti
kalıcı
- bağlantılarla aşıldığında bir
takım g�t�r�ler olacaktır. Eğer veritabanı
- sunucunuz ayni anda 16 bağlantıya izin veriyorsa, ve yoğun
bir �alışma
- anında 17 �ocuk işlem kalıcı bağlantı
a�maya kalkarsa, bunlardan biri
- bağlantıyı a�amaz. Eğer betiklerinizde
bağlantıların kapanabilmesine olanak
- tanımayan hatalar varsa (kısır d�ng� gibi), 32
bağlantıya izin verecek bir
- veritabanı sunucusu �ok �abuk bir şekilde
kullanışsız hale gelir. Boş duran
- (idle) bağlantılarla nasıl ilgileneceğiniz konusunda
veritabanınızın
- d�k�manlarına başvurun.
+ Buradaki cevap olduk�a basit -- etkinlik. Kal�c� ba�lant�lar, SQL
+ sunucunuza yeni ba�lant� a�mak performans a��s�ndan hesapl� de�ilse
+ �ok i�e yararlar. Performans hesapl�l��� pek �ok �eye ba�l�d�r. �rne�in, ne
+ t�r bir veritaban� oldu�u, HTTP sunucusuyla ayn� bilgisayarda olup
+ olmay���, SQL sunucusunun �al��t��� bilgisayar�n i�lem yo�unlu�u ve
+ benzeri. Sonu� �u ki, yeni ba�lant� performans� d���kse, kal�c� ba�lant�lar
+ i�e yarar. Her �ocuk i�lemin her seferinde yeni ba�lant� a�mas� yerine
+ hayat� boyunca sadece bir kere ba�lant� yapmas�n� ve s�rekli onu kullanmas�n�
+ sa�larlar. Bu demektir ki, kal�c� ba�lant� a�an her �ocuk i�lemin kendisine
+ ait SQL sunucusuna kal�c� bir ba�lant�s� olacakt�r. �rne�in, 20 tane
+ kal�c� ba�lant� a�an betik �al��t�rm�� farkl� �ocuk i�lem varsa, SQL
+ sunucusuna, her �ocuk i�lemden bir tane olmak �zere, 20 tane ba�lant�
+ olacakt�r.
+ </simpara>
+ <simpara>
+ Ancak dikkat edin ki, SQL sunucusunun ba�lant� limiti kal�c� ba�lant�larla
+ a��ld���nda bunun bir tak�m g�t�r�leri olacakt�r. E�er veritaban�
+ sunucunuz ayni anda 16 ba�lant�ya izin veriyorsa, ve yo�un bir �al��ma
+ an�nda 17 �ocuk i�lem kal�c� ba�lant� a�maya kalkarsa, bunlardan biri
+ ba�lant�y� a�amaz. E�er betiklerinizde ba�lant�lar�n kapanabilmesine olanak
+ tan�mayan hatalar varsa (k�s�r d�ng�ler gibi), 32 ba�lant�ya izin veren bir
+ veritaban� sunucusu �ok �abuk bir �ekilde kullan�m d��� olur. Bo� duran
+ (idle) ba�lant�larla nas�l ilgilenece�iniz konusunda veritaban�n�z�n
+ d�k�manlar�na ba�vurun.
</simpara>
<warning>
<simpara>
- Kalıcı bağlantı kullanırken akılda
tutulması gereken birka� ek g�t�r� daha
- var. �rneğin kalıcı bir bağlantıyla bir tablo
kitlendiyse (LOCK), ve betik
- herhangi bir sebepten dolayı kilidi kaldıramıyorsa,
ardısıra gelen
- ve aynı bağlantıyı kullanacak betikler s�resiz olarak
bloke olacak, ve
- sizin ya HTTP sunucusunu ya da veritabanı sunucusunu baştan
�alıştırmanız
- gerekecektir. Başka bir g�t�r� transaction kullanırken
oluşabilir. Bir
- transaction bloğu, betiğin �alışma s�resi
bloğun �mr�nden kisaysa, bir
- sonraki betiğe taşınacaktır. İki durumda da
+ <!-- dirge: register => kaydetmek -->
+ Kal�c� ba�lant� kullan�rken ak�lda tutulmas� gereken birka� ek g�t�r� daha
+ var. �rne�in kal�c� bir ba�lant� �zerinden bir tablo kitlendiyse (LOCK),
+ ve betik herhangi bir sebepten dolay� kilidi kald�ram�yorsa, ard�s�ra gelen
+ ve ayn� ba�lant�y� kullanacak betikler s�resiz olarak bloke olacak, ve
+ sizin ya HTTP sunucusunu ya da veritaban� sunucusunu ba�tan �al��t�rman�z
+ gerekecektir. Ba�ka bir g�t�r� transaction kullan�rken olu�abilir. Bir
+ transaction blo�u, beti�in �al��ma s�resi blo�un �mr�nden kisaysa, bir
+ sonraki beti�e ta��nacakt�r. �ki durumda da
<function>register_shutdown_function</function> ile transaction'i geri
- alacak ya da tablo kilitlerini kaldıracak bir temizlik fonksiyonu
+ alacak ya da tablo kilitlerini kald�racak bir temizlik fonksiyonu
kaydedebilirsiniz. Daha iyisi, problemleri t�m�yle �nlemek i�in tablo
- kilitleri veya transaction kullanan betiklerde kalıcı
bağlantıları
- kullanmamak (başka yerlerde hala kullanabilirsiniz).
+ kilitleri veya transaction kullanan betiklerde kal�c� ba�lant�lar�
+ kullanmamakt�r (ba�ka yerlerde hala kullanabilirsiniz).
</simpara>
</warning>
<simpara>
- �nemli bir �zet. Kalıcı bağlantılar normal
bağlantılarla birebir
- eşlenebilecek şekilde tasarlandı. Bu demektir ki <emphasis>her
- zaman</emphasis> kalıcı bağlantıları normal
olanlarla değiştirebilirsiniz,
- ve bu betiklerin davranışlarını etkilemeyecektir.
Betiklerin etkinliklerini
- <emphasis>belki</emphasis> değiştirebilirler, fakat
davranışını
- değiştirmezler!
+ �nemli bir �zet. Kal�c� ba�lant�lar normal ba�lant�larla birebir
+ e�lenebilecek �ekilde tasarland�. Bu demektir ki <emphasis>her
+ zaman</emphasis> kal�c� ba�lant�lar� normal olanlarla de�i�tirebilirsiniz,
+ ve bu betiklerin davran��lar�n� etkilemeyecektir. Betiklerin etkinliklerini
+ <emphasis>belki</emphasis> de�i�tirebilirler, fakat davran���n�
+ de�i�tirmezler!
</simpara>
</chapter>
Index: phpdoc/tr/features/remote-files.xml
diff -u phpdoc/tr/features/remote-files.xml:1.1 phpdoc/tr/features/remote-files.xml:1.2
--- phpdoc/tr/features/remote-files.xml:1.1 Sun Dec 9 21:24:49 2001
+++ phpdoc/tr/features/remote-files.xml Mon Dec 10 13:24:46 2001
@@ -1,45 +1,46 @@
<?xml version="1.0" encoding="iso-8859-9"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<chapter id="features.remote-files">
- <title>Uzaktaki Dosyaları Kullanmak</title>
+ <title>Uzaktaki Dosyalar� Kullanmak</title>
+ <!-- dirge: remote file => uzak dosya -->
<para>
- "URL fopen wrapper" PHP derlenmeden �nce aktifleştirildiği
(ki,
- --disable-url-fopen-wrapper parametresini �zellikle vermediğinizde
+ "URL fopen wrapper" PHP derlenmeden �nce aktifle�tirildi�i (ki,
+ --disable-url-fopen-wrapper parametresini �zellikle vermedi�inizde
b�yledir) (4.0.3 �ncesi s�r�mler i�in) veya php.ini'de
- <parameter>allow_url_fopen</parameter> ayarına off değerini
vermediyseniz
+ <parameter>allow_url_fopen</parameter> ayar�na off de�erini vermedi�iniz
(yeni s�r�mler i�in) s�rece, HTTP ve FTP URL'lerini parametre olarak
- dosya ismi alan �oğu fonksiyonda, <function>require</function> ve
- <function>include</function> ifadeleri dahil, kullanabilirsiniz.
+ dosya ismi alan, <function>require</function> ve
+ <function>include</function> ifadeleri dahil, �o�u fonksiyonda kullanabilirsiniz.
</para>
<para>
<note>
<para>
- Uzak dosyaları Windows altında <function>include</function> ve
- <function>require</function> ifadelerinde kullanamazsınız.
+ Uzak dosyalar� Windows alt�nda <function>include</function> ve
+ <function>require</function> ifadelerinde kullanamazs�n�z.
</para>
</note>
</para>
<para>
- �rneğin, bunu uzaktaki bir HTTP sunucusunda olan bir dosyayı a�mak,
- �ıktısını ayıklamak ve elde edilen bilgiyi bir
veritabanı sorgusunda
- kullanmak, ya da basit�e web sitenizin geri kalanına uygun bir g�r�nt�de
+ �rne�in, bunu uzaktaki bir HTTP sunucusunda olan bir dosyay� a�mak,
+ ��kt�s�n� ay�klamak ve elde edilen bilgiyi bir veritaban� sorgusunda
+ kullanmak, ya da basit�e web sitenizin geri kalan�na uygun bir g�r�nt�de
g�stermek i�in kullanabilirsiniz.
</para>
<para>
<example>
- <title>Uzaktaki bir sayfanın başlığını
almak</title>
+ <title>Uzaktaki bir sayfan�n ba�l���n� almak</title>
<programlisting role="php">
<![CDATA[
<?php
$file = fopen ("http://www.php.net/", "r");
if (!$file) {
- echo "<p>Uzaktaki dosya a�ılamadı.\n";
+ echo "<p>Uzaktaki dosya a��lamad�.\n";
exit;
}
while (!feof ($file)) {
$line = fgets ($file, 1024);
- /* Bu sadece title etiketi ve i�eriği aynı satırdaysa
işe yarar */
+ /* Bu sadece title etiketi ve i�eri�i ayn� sat�rdaysa i�e yarar */
if (eregi ("<title>(.*)</title>", $line, $out)) {
$title = $out[1];
break;
@@ -52,12 +53,12 @@
</example>
</para>
<para>
- Ya da bunu, doğru erişim hakkına sahip bir
kullanıcıyla bağlandığınız
- ve �oktan dosya varolmadığı s�rece FTP ile uzaktaki dosyalara
yazmak
- i�in kullanabilirsiniz. 'anonymous' dışında bir
kullanıcı olarak bağlanmak
- i�in kullanıcıyı (ve muhtemelen parolayı) URL i�ine
yazmalısınız, �rneğin
- 'ftp://kullanıcı:[EMAIL PROTECTED]/yol/dosya' gibi.
(Aynı y�ntemi
- HTTP'de Basic Authentication'a ihtiya� duyan dosyalara erişmek i�in de
+ Ya da bunu, do�ru eri�im hakk�na sahip bir kullan�c�yla ba�land���n�z
+ ve �oktan dosya varolmad��� s�rece FTP ile uzaktaki dosyalara yazmak
+ i�in kullanabilirsiniz. 'anonymous' d���nda bir kullan�c� olarak ba�lanmak
+ i�in kullan�c�y� (ve muhtemelen parolay�) URL i�ine yazmal�s�n�z, �rne�in
+ 'ftp://kullan�c�:[EMAIL PROTECTED]/yol/dosya' gibi. (Ayn� y�ntemi
+ HTTP'de Basic Authentication'a ihtiya� duyan dosyalara eri�mek i�in de
kullanabilirsiniz.)
</para>
<para>
@@ -68,7 +69,7 @@
<?php
$file = fopen ("ftp://ftp.php.net/incoming/outputfile", "w");
if (!$file) {
- echo "<p>Yazmak �zere uzak dosya a�ılamadı\n";
+ echo "<p>Yazmak �zere uzak dosya a��lamad�\n";
exit;
}
/* Veriyi yaz */
@@ -82,11 +83,11 @@
<para>
<note>
<para>
- Yukarıdaki �rnekten, uzaktaki bir g�nl�ğe yazmak i�in nasıl
bir teknik
- kullanacağınız konusunda bir fikir
almışsınızdır, fakat �nceden
- belirtildiği gibi, URL fopen() sargılarıyla sadece yeni
dosyalara
- yazabilirsiniz. Bunun gibi dağıtılmış g�nl�k
tutmak isterseniz,
- <function>syslog</function>'s bir g�z atmalısınız.
+ Yukar�daki �rnekten, uzaktaki bir g�nl��e yazmak i�in nas�l bir teknik
+ kullanaca��n�z konusunda bir fikir alm��s�n�zd�r, fakat �nceden
+ belirtildi�i gibi, URL fopen() sarg�lar�yla sadece yeni dosyalara
+ yazabilirsiniz. Bunun gibi da��t�lm�� g�nl�k tutmak isterseniz,
+ <function>syslog</function>'a bir g�z atmal�s�n�z.
</para>
</note>
</para>