tpug            Thu Jan 12 16:16:54 2006 UTC

  Modified files:              
    /phpdoc/en/chapters tutorial.xml 
  Log:
  
  
http://cvs.php.net/viewcvs.cgi/phpdoc/en/chapters/tutorial.xml?r1=1.40&r2=1.41&diff_format=u
Index: phpdoc/en/chapters/tutorial.xml
diff -u phpdoc/en/chapters/tutorial.xml:1.40 
phpdoc/en/chapters/tutorial.xml:1.41
--- phpdoc/en/chapters/tutorial.xml:1.40        Thu Jan 12 16:10:30 2006
+++ phpdoc/en/chapters/tutorial.xml     Thu Jan 12 16:16:54 2006
@@ -1,5 +1,5 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.40 $ -->
+<?xml version="1.0" encoding="iso-8859-9"?>
+<!-- $Revision: 1.41 $ -->
  <chapter id="tutorial">
   <title>A simple tutorial</title>
 
@@ -164,16 +164,6 @@
    <note>
     <title>A Note on Windows Notepad</title>
     <para>
-<<<<<<< tutorial.xml
-    PHP betiklerinizi Windows Not Defteri ile yazýyorsanýz, dosyalarýnýzýn 
.php uzantýsý
-    ile kaydedildiðinden emin olmalýsýnýz (Notepad birazdan bahsedeceðimiz 
önlemleri
-    almadýðýnýz takdirde dosyalarýn sonuna otomatik olarak .txt uzantýsý 
ekler).
-    Dosyayý kaydetmek istediðinizde, sizden dosyanýz için bir isim belirtmeniz 
istenecektir.
-    Dosya ismi olarak týrnak içinde (örn. "<filename>hello.php</filename>") 
yazýn.
-    Alternatif olarak, &apos;Kaydet&apos; iletiþim kutusunun içindeki 
&apos;Metin Belgeleri&apos; açýlýr menüsüne
-    týkladýktan sonra buradaki deðeri "Tüm Dosyalar" olarak deðiþtirin. Artýk 
dosya isminizi
-    týrnak iþareti kullanmadan yazabilirsiniz.
-=======
      If you are writing your PHP scripts using Windows Notepad, you will need
      to ensure that your files are saved with the .php extension. (Notepad adds
      a .txt extension to files automatically unless you take one of the
@@ -182,22 +172,21 @@
      (i.e. "<filename>hello.php</filename>").  Alternatively, you can click on 
the 
      'Text Documents' drop-down menu in the 'Save' dialog box and change the 
setting 
      to "All Files". You can then enter your filename without quotes.
->>>>>>> 1.39
     </para>
    </note>
   
    <para>
-   Artýk çalýþýr bir PHP betiðini baþarýyla yarattýðýnýza göre, PHP 
betiklerinin
-   en ünlüsünü yaratma zamaný geldi demektir! <function>Phpinfo</function>
-   fonksiyonunu çalýþtýracaðýz ve sisteminizle ve yapýlandýrmanýzla ilgili
-   <link linkend="language.variables.predefined">öntanýmlý deðiþkenler</link>,
-   yüklü PHP modülleri ve <link linkend="configuration">yapýlandýrma</link>
-   ayarlarý gibi konularda faydalý birçok bilgiye ulaþacaðýz. Bu önemli 
bilgiler için
-   biraz vakit ayýrmanýzý ve bunlarý incelemenizi öneririz.
+    Now that you have successfully created a working PHP script, it is
+    time to create the most famous PHP script!  Make a call to the
+    <function>phpinfo</function> function and you will see a lot of useful
+    information about your system and setup such as available
+    <link linkend="language.variables.predefined">predefined variables</link>, 
+    loaded PHP modules, and <link linkend="configuration">configuration</link>
+    settings. Take some time and review this important information.
    </para>
    <para>
     <example>
-     <title>PHP ile sistem bilgisine ulaþmak</title>
+     <title>Get system information from PHP</title>
      <programlisting role="php">
 <![CDATA[
 <?php phpinfo(); ?>
@@ -208,173 +197,187 @@
   </sect1>
 
   <sect1 id="tutorial.useful">
-   <title>Ýþe yarar bir þey</title>
+   <title>Something Useful</title>
    <para>
-   Þimdi daha iþe yarar bir þey yapalým. Kullanýcýnýzýn hangi tarayýcýyý
-   kullandýðýný tespit edelim. Bunun için, HHTP isteði ile birlikte 
kullanýcýnýzýn
-   tarayýcý tarafýndan gönderilen karakter dizisi (string) deðerini 
inceleyeceðiz.
-   Bu deðer bir <link linkend="language.variables">deðiþken</link> içinde
-   depolanmýþtýr. Deðiþkenler PHP&apos;de her zaman dolar iþareti ile baþlar.
-   Bizim þu an için ilgilendiðimiz deðiþken 
<varname>$_SERVER[&apos;HTTP_USER_AGENT&apos;]</varname>
-   deðiþkenidir.
+    Let us do something more useful now. We are going to check
+    what sort of browser the visitor is using.
+    For that, we check the user agent string the browser
+    sends as part of the HTTP request. This information is stored in a <link
+    linkend="language.variables">variable</link>. Variables always start
+    with a dollar-sign in PHP. The variable we are interested in right now 
+    is <varname>$_SERVER['HTTP_USER_AGENT']</varname>.
    </para>
    <note>
     <para>
-     <link linkend="reserved.variables.server">$_SERVER</link> özel saklanmýþ
-     bir PHP deðiþkenidir. Bu deðiþken tüm web sunucusu bilgilerini içerir. 
Autoglobal
-     (ya da superglobal - süper evrensel) olarak da bilinir. Kýlavuzdaki 
-     <link linkend="language.variables.superglobals">Superglobals</link>
-     bölümünden bu konu ile ilgili daha fazla bilgiye ulaþabilirsiniz. Bu özel 
deðiþkenler
-     PHP <ulink url="&url.php.release4.1.0;">4.1.0</ulink> sürümü ile birlikte
-     kullanýlmaya baþlanmýþtýr. Daha öncesinde, 
<varname>$HTTP_SERVER_VARS</varname>
-     gibi eski <varname>$HTTP_*_VARS</varname> dizileri (array) 
kullanýlmaktaydý.
-     Ömrünü doldurmuþ olsa da, bu eski tip deðiþkenler hala mevcuttur. (<link 
linkend="tutorial.oldcode">Eski kod</link>
-     bölümüne de bakýnýz.)
+     <link linkend="reserved.variables.server">$_SERVER</link> is a 
+     special reserved PHP variable that contains all web server information.
+     It is known as an autoglobal (or superglobal).  See the related manual 
page on
+     <link linkend="language.variables.superglobals">superglobals</link>
+     for more information.  These special variables were introduced in PHP 
+     <ulink url="&url.php.release4.1.0;">4.1.0</ulink>.  Before this time, we 
used
+     the older <varname>$HTTP_*_VARS</varname> arrays instead,
+     such as <varname>$HTTP_SERVER_VARS</varname>.  Although deprecated, 
+     these older variables still exist.  (See also the note on
+     <link linkend="tutorial.oldcode">old code</link>.)
     </para>
    </note>
    <para>
-   Bu deðiþkeni görüntülemek için yapmanýz gereken basitçe:
+    To display this variable, you can simply do:
    </para>
    <para>
     <example>
-    <title>Bir deðiþkeni yazdýrmak (Dizi öðesi)</title>
+    <title>Printing a variable (Array element)</title>
     <programlisting role="php">
 <![CDATA[
 <?php echo $_SERVER['HTTP_USER_AGENT']; ?>
 ]]>
     </programlisting>
     <para>
-    Bu betikten alýnabilecek kýsa sonuç:
+     A sample output of this script may be:
     </para>
     <screen role="html">
-       Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)
+Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)
     </screen>
    </example>
    </para>
    <para>
-   PHP&apos; birçok farklý deðiþken <link linkend="language.types">tipi</link>
-   mevcuttur. Yukardaki örnekte bir <link 
linkend="language.types.array">dizi</link>ye
-   ait bir öðeyi yazdýrdýk. Diziler çok kullanýþlý olabilirler.
-   </para>
-   <para>
-    <varname>$_SERVER</varname> size PHP tarafýndan otomatik olarak saðlanan
-    bir deðiþkendir. Kullaným kýlavuzunun 
-    <link linkend="reserved.variables">Rezerve Deðiþkenler</link> bölümünden
-    tümünün bir listesine ulaþabilirsiniz ya da önceki örnekte kullandýðýmýz
-    <function>phpinfo</function> fonksiyonu ile üretilen çýktýya bakarak bütün
-    listeye ulaþabilirsiniz.
-   </para>
-   <para>
-   PHP etiketinin içine birden çok PHP komutu koyabilir ve tek bir echo 
komutundan
-   daha fazlasýný yapan küçük kod bloklarý yaratabilirsiniz. Örneðin, Internet 
Explorer için
-   bir kontrol yapmak istiyorsanýz þunu yapabilirsiniz:
+    There are many <link linkend="language.types">types</link> of 
+    variables available in PHP.  In the above example we printed 
+    an <link linkend="language.types.array">Array</link> element.
+    Arrays can be very useful.
+   </para>
+   <para>
+    <varname>$_SERVER</varname> is just one variable that PHP automatically 
+    makes available to you. A list can be seen in the 
+    <link linkend="reserved.variables">Reserved Variables</link> section 
+    of the manual or you can get a complete list of them by looking at
+    the output of the <function>phpinfo</function> function used in the
+    example in the previous section.
+   </para>
+   <para>
+    You can put multiple PHP statements inside a PHP tag and create
+    little blocks of code that do more than just a single echo.
+    For example, if you want to check for Internet Explorer you
+    can do this:
    </para>
    <para>
     <example>
-     <title><link linkend="language.control-structures">Kontrol yapýlarý 
-     </link>nýn ve <link linkend="language.functions">fonksiyonlar</link>ýn 
kullanýmýna örnek</title>
+     <title>Example using <link linkend="language.control-structures">control 
+     structures</link> and <link 
linkend="language.functions">functions</link></title>
      <programlisting role="php">
 <![CDATA[
 <?php
 if (strpos($_SERVER['HTTP_USER_AGENT'], 'MSIE') !== FALSE) {
-    echo 'Internet Explorer kullanmaktasýnýz.<br />';
+    echo 'You are using Internet Explorer.<br />';
 }
 ?>
 ]]>
      </programlisting>
      <para>
-     Bu betikten alýnabilecek örnek sonuç:
+      A sample output of this script may be:
      </para>
      <screen role="html">
 <![CDATA[
-Internet Explorer kullanýyorsunuz.<br />
+You are using Internet Explorer.<br />
 ]]>
      </screen>
     </example>
    </para>
    <para>
-   Nurada birkaç yeni kavramý devreye soktuk. Bir <link 
linkend="control-structures.if">if</link>
-   komutumuz var. Eðer C dilinde kullanýlan temel sözdizimine aþinalýðýnýz 
varsa, bu kullaným
-   size tanýdýk gelecektir. Aksi takdirde, giriþ düzeyinde bir PHP kitabý 
almanýz ve ilk birkaç bölümünü
-   okumanýz ya da kýlavuzun <link linkend="langref">Dil Baþvuru Kaynaðý</link> 
bölümünü
-   okumanýz faydalý olacaktýr. PHP kitaplarýnýn bir listesine <ulink 
url="&url.php.books;">&url.php.books;</ulink>
-   adresinden ulaþabilirsiniz.
-   </para>
-   <para>
-   Ýkinci devreye aldýðýmýz kavram <function>strpos</function> fonksiyonu ile 
yaptýðýmýz çaðrý oldu.
-   <function>Strpos</function> fonksiyonu PHP içine yerleþik olan, bir 
karakter dizisini diðer karakter dizisinin
-   içinde aramayý saðlayan bir fonksiyondur. Kendi durumumuzda biz 
<varname>$_SERVER[&apos;HTTP_USER_AGENT&apos;]</varname>
-   (haystack - aramaya konu olan parça olarak da adlandýrýlýr) deðiþkeni 
içersinde <literal>&apos;MSIE&apos;</literal> (needle - aranan parça olarak da 
adlandýrýlýr)
-   parçasýný aratmaktayýz. Aranan parça, aramaya konu olan parça içinde 
bulunursa, fonksiyon aramaya konu olan parçanýn baþlangýç noktasýna
-   göreceli olarak aranan parçanýn bulunduðu noktanýn yerini döndürür. Aksi 
durumda, &false; döndürür. &false; döndürmezse, 
-   <link linkend="control-structures.if">if</link> komutunun sonucu &true; 
olarak deðerlendirilir ve {köþeli parantezler} içindeki kod çalýþtýrýlýr.
-   Aksi durumda kod çalýþtýrýlmaz. <link 
linkend="control-structures.if">If</link>, <link 
linkend="control-structures.else">else</link> gibi
-   kontrol yapýlarýnýn ve <function>strtoupper</function> ve 
<function>strlen</function> gibi fonksiyonlarýn kullanarak siz kendiniz de 
benzer
-   örnekler yaratabilirsiniz. Ýlgili her kýlavuz sayfasý ayný zamanda örnekler 
de içermektedir. Bu fonksiyonlarý nasýl kullanmanýz gerektiðinden
-   emin deðilseniz, kýlavuzdaki <link linkend="about.prototypes">bir fonksiyon 
tanýmý nasýl okunur</link> ve <link linkend="language.functions">PHP 
fonksiyonlarý</link>
-   bölümlerini okuyabilirsiniz.
+    Here we introduce a couple of new concepts. We have an 
+    <link linkend="control-structures.if">if</link> statement.
+    If you are familiar with the basic syntax used by the C
+    language, this should look logical to you. Otherwise, you
+    should probably pick up an introductory PHP book and read the first
+    couple of chapters, or read the <link linkend="langref">Language
+    Reference</link> part of the manual. You can find a list of PHP books
+    at <ulink url="&url.php.books;">&url.php.books;</ulink>.
+   </para>
+   <para>
+    The second concept we introduced was the <function>strpos</function>
+    function call. <function>strpos</function> is a function built into
+    PHP which searches a string for another string. In this case we are
+    looking for <literal>'MSIE'</literal> (so-called needle) inside
+    <varname>$_SERVER['HTTP_USER_AGENT']</varname> (so-called haystack).  If
+    the needle is found inside the haystack, the function returns the position
+    of the needle relative to the start of the haystack.  Otherwise, it
+    returns &false;.  If it does not return &false;, the <link
+    linkend="control-structures.if">if</link> expression evaluates to &true;
+    and the code within its {braces} is executed. Otherwise, the code is not
+    run. Feel free to create similar examples, 
+    with <link linkend="control-structures.if">if</link>, 
+    <link linkend="control-structures.else">else</link>, and other 
+    functions such as <function>strtoupper</function> and 
+    <function>strlen</function>.  Each related manual page contains examples 
+    too.  If you are unsure how to use functions, you will want to read both
+    the manual page on <link linkend="about.prototypes">how to read a
+    function definition</link> and the section about  
+    <link linkend="language.functions">PHP functions</link>.
    </para>
    <para>
-   Bunu bir adým öteye taþýyabilir ve bir PHP bloðunun tam ortasýndayken bile 
PHP kipine nasýl girip çýkabileceðimize bakabiliriz:
+    We can take this a step further and show how you can jump in and out
+    of PHP mode even in the middle of a PHP block:
    </para>
    <para>
     <example>
-     <title>HTML ve PHP kiplerini karýþtýrmak</title>
+     <title>Mixing both HTML and PHP modes</title>
      <programlisting role="php">
 <![CDATA[
 <?php
 if (strpos($_SERVER['HTTP_USER_AGENT'], 'MSIE') !== FALSE) {
 ?>
-<h3>strpos() false olmayan bir deðer döndürmelidir</h3>
-<p>Internet Explorer kullanmaktasýnýz</p>
+<h3>strpos() must have returned non-false</h3>
+<p>You are using Internet Explorer</p>
 <?php
 } else {
 ?>
-<h3>strpos() false döndürmelidir</h3>
-<p>Internet Explorer kullanmýyorsunuz</p>
+<h3>strpos() must have returned false</h3>
+<p>You are not using Internet Explorer</p>
 <?php
 }
 ?>
 ]]>
      </programlisting>
      <para>
-     Bu betikten elde edilebilecek örnek sonuç:
+      A sample output of this script may be:
      </para>
      <screen role="html">
 <![CDATA[
-<h3>strpos() false olmayan bir deðer döndürmelidir</h3>
-<p>Internet Explorer kullanýyorsunuz</p>
+<h3>strpos() must have returned non-false</h3>
+<p>You are using Internet Explorer</p>
 ]]>
      </screen>
     </example>
    </para>
    <para>
-   Bir çýktý üretmek için PHP echo komutunu kullanmak yerine, PHP kipinden
-   çýktýk ve sadece düz HTML gönderdik. Burada dikkat edilmesi gereken önemli
-   nokta, betiðin mantýksal akýþýnýn deðiþmiyor olmasýdýr. 
<function>Strpos</function>
-   fonksiyonundan edinilen sonuca göre HTML bloklarýndan yalnýzca biri 
görüntüleyiciye
-   gönderilmektedir. Baþka bir deyiþle, bu iþleyiþ <literal>MSIE</literal> 
deðiþkeninin
-   bulunup bulunmamasýna baðlýdýr.
+    Instead of using a PHP echo statement to output something, we jumped out
+    of PHP mode and just sent straight HTML. The important and powerful point
+    to note here is that the logical flow of the script remains intact. Only
+    one of the HTML blocks will end up getting sent to the viewer depending on
+    the result of <function>strpos</function>.  In other words, it depends on
+    whether the string <literal>MSIE</literal> was found or not.
    </para>
   </sect1>
    
   <sect1 id="tutorial.forms">
-   <title>Form Kullanýmý</title>
+   <title>Dealing with Forms</title>
    <para>
-   PHP&apos;nin en güçlü özelliklerinden biri HTML formlarýna yaklaþým 
biçimidir.
-   Bilinmesi gereken ilk önemli durum, form içindeki tüm elemanlar PHP 
tarafýndan
-   otomatik olarak kullanýlabilir olacaktýr. Bu konu ile ilgili kýlavuzdaki
-   <link linkend="language.variables.external">PHP&apos;nin dýþýndan gelen
-   deðiþkenler</link> bölümünü okuyabilirsiniz. Örnek bir HTML formu:
+    One of the most powerful features of PHP is the way it handles HTML
+    forms. The basic concept that is important to understand is that any
+    form element will automatically be available to your PHP 
+    scripts.  Please read the manual section on
+    <link linkend="language.variables.external">Variables from outside 
+    of PHP</link> for more information and examples on using forms 
+    with PHP.  Here is an example HTML form:
    </para>
    <para>
     <example>
-     <title>Örnek bir HTML formu</title>
+     <title>A simple HTML form</title>
      <programlisting role="html">
 <![CDATA[
 <form action="action.php" method="post">
- <p>Ýsminiz: <input type="text" name="isim" /></p>
- <p>Yaþýnýz: <input type="text" name="yas" /></p>
+ <p>Your name: <input type="text" name="name" /></p>
+ <p>Your age: <input type="text" name="age" /></p>
  <p><input type="submit" /></p>
 </form>
 ]]>
@@ -382,121 +385,118 @@
     </example>
    </para>
    <para>
-   Bu form ile ilgili özel hiçbir þey yoktur. Hiçbir özel etiket içermeyen düz 
bir
-   HTML formudur. Kullanýcý formu doldurup gönder tuþuna bastýðýnda, 
-   <filename>action.php</filename> sayfasý çaðrýlýr. Bu dosyaya aþaðýdakileri
-   yazabiliriz:
+    There is nothing special about this form. It is a straight HTML form
+    with no special tags of any kind. When the user fills in this form
+    and hits the submit button, the <filename>action.php</filename> page
+    is called. In this file you would write something like this:
    </para>
    <para>
     <example>
-     <title>Formdan veri yazdýrmak</title>
+     <title>Printing data from our form</title>
      <programlisting role="php">
 <![CDATA[
-Merhaba <?php echo $_POST['isim']; ?>.
-Siz <?php echo $_POST['yas']; ?> yaþýndasýnýz.
+Hi <?php echo $_POST['name']; ?>.
+You are <?php echo $_POST['age']; ?> years old.
 ]]>
      </programlisting>
      <para>
-     Bu betikten elde edilecek örnek çýktý:
+      A sample output of this script may be:
      </para>
      <screen role="html">
 <![CDATA[
-Merhaba Ahmet. Siz 22 yaþýndasýnýz.
+Hi Joe. You are 22 years old.
 ]]>
      </screen>
     </example>
    </para>
    <para>
-   Yapýlan iþ oldukça açýk. <varname>$_POST[&apos;isim&apos;]</varname> 
deðiþkeni
-   ve <varname>$_POST[&apos;yas&apos;]</varname> deðiþkeni PHP tarafýndan 
otomatik
-   olarak yaratýldý. Daha önce <varname>$_SERVER</varname> autoglobal
-   deðiþkenini kullanmýþtýk, yukarýda <link 
linkend="reserved.variables.post">$_POST</link>
-   autoglobal deðiþkenini tanýmýþ olduk. Bu deðiþken POST yöntemi ile 
gönderilen tüm
-   veriyi içermektedir. Formumuz için tanýmlý <emphasis>yöntem 
(method)</emphasis>in
-   POST olduðuna dikkat edin. <emphasis>GET</emphasis> yöntemini kullanmýþ 
olsaydýk,
-   form bilgilerimiz <link linkend="reserved.variables.get">$_GET</link> 
autoglobal
-   deðiþkenine tanýmlanmýþ olacaktý. Bunlarýn haricinde, istemciden gelen 
verinin hangi kaynaktan
-   geldiði sizin için önemli deðilse <link 
linkend="reserved.variables.request">$_REQUEST</link>
-   autoglobal deðiþkenini de kullanabilirsiniz. Bu deðiþken GET, POST ve 
COOKIE verilerinin
-   birleþiminden oluþur. Daha fazla bilgi için 
<function>import_request_variables</function>
-   fonksiyonunu inceleyebilirsiniz.
-   </para>
-   <para>
-   PHP içinde XForms öðelerini de kullanabilirsiniz, ancak baþlangýç aþamasýnda
-   çok iyi desteklenen HTML formlarý sizin iþinizi görecektir. XForms ile 
çalýþmak yeni baþlayanlar
-   için uygun olmasa da, ilginizi çekebilir. <link 
linkend="features.xforms">XForms ile elde edilen
-   verilerin iþlenmesi</link> ile ilgili metinden bu konu ile ilgili daha 
fazla bilgiye ulaþabilirsiniz.
+    It should be obvious what this does. There is nothing more to it.
+    The <varname>$_POST['name']</varname> and <varname>$_POST['age']</varname>
+    variables are automatically set for you by PHP.  Earlier we
+    used the <varname>$_SERVER</varname> autoglobal; above we just 
+    introduced the <link linkend="reserved.variables.post">$_POST</link>
+    autoglobal which contains all POST data.  Notice how the
+    <emphasis>method</emphasis> of our form is POST.  If we used the 
+    method <emphasis>GET</emphasis> then our form information would live in 
+    the <link linkend="reserved.variables.get">$_GET</link> autoglobal instead.
+    You may also use the <link 
linkend="reserved.variables.request">$_REQUEST</link>
+    autoglobal, if you do not care about the source of your request data. It 
+    contains the merged information of GET, POST and COOKIE data.  Also see 
the 
+    <function>import_request_variables</function> function.
+   </para>
+   <para>
+    You can also deal with XForms input in PHP, although you will find yourself
+    comfortable with the well supported HTML forms for quite some time.
+    While working with XForms is not for beginners, you might be interested
+    in them. We also have a <link linkend="features.xforms">short introduction
+    to handling data received from XForms</link> in our features section. 
    </para>
   </sect1>
 
   <sect1 id="tutorial.oldcode">
-   <title>PHP&apos;nin yeni sürümleri ile eski kod yapýsýný kullanmak</title>
+   <title>Using old code with new versions of PHP</title>
    <para>
-   PHP&apos; popüler bir betik dili olmasýyla birlikte, hazýr 
kullanabileceðiniz
-   kodlar üreten birçok kamuya açýk depo ve kütüphane oluþturuldu. PHP 
geliþtiricileri
-   geriye dönük uyumluluðu mümkün olduðunca korumaya çalýþtýlar, dolayýsýyla
-   eski bir PHP sürümü ile birlikte yazýlmýþ bir PHP kodu hiçbir deðiþiklik 
yapýlmasýna
-   gerek duyulmadan (ideal olarak) yeni PHP sürümleri ile çalýþabilir halde 
kaldý.
-   Ancak pratikte, bazý deðiþikliklerin yapýlmasý gerekebilir.
-    usually be needed.
+    Now that PHP has grown to be a popular scripting language, there are
+    a lot of public repositories and libraries containing code you can reuse.
+    The PHP developers have largely tried to preserve backwards compatibility, 
+    so a script written for an older version will run (ideally) without changes
+    in a newer version of PHP. In practice, some changes will usually be 
needed.
    </para>
    <para>
-   Eski kodlarý etkileyen yakýn geçmiþe ait iki önemli deðiþiklik aþaðýdaki 
gibidir:
+    Two of the most important recent changes that affect old code are:
     <itemizedlist>
      <listitem>
       <simpara>
-      Eski <varname>$HTTP_*_VARS</varname> tipi deðiþkenler ömürlerini
-      doldurdular (bu deðiþkenler bir fonksiyon ya da metod içersinde 
kullanýlmadan
-      önce tanýmlanmalýydýlar). Takip eden 
-       <link linkend="language.variables.superglobals">autoglobal 
dizileri</link>
-       PHP&apos;nin <ulink url="&url.php.release4.1.0;">4.1.0</ulink> sürümü 
ile
-       birlikte kullanýma açýlmýþtýr. 
-       Bunlar: <varname>$_GET</varname>, <varname>$_POST</varname>, 
+       The deprecation of the old <varname>$HTTP_*_VARS</varname> arrays
+       (which need to be indicated as global when used inside a function or
+       method).  The following 
+       <link linkend="language.variables.superglobals">autoglobal arrays</link>
+       were introduced in PHP <ulink 
url="&url.php.release4.1.0;">4.1.0</ulink>. 
+       They are: <varname>$_GET</varname>, <varname>$_POST</varname>, 
        <varname>$_COOKIE</varname>, <varname>$_SERVER</varname>, 
        <varname>$_FILES</varname>, <varname>$_ENV</varname>,
-       <varname>$_REQUEST</varname> ve <varname>$_SESSION</varname>
-       dizileridir. Daha eski, <varname>$HTTP_POST_VARS</varname> gibi
-       <varname>$HTTP_*_VARS</varname> dizileri, PHP 3&apos;teki ayný kullaným
-       biçimi ile mevcutturlar.
+       <varname>$_REQUEST</varname>, and <varname>$_SESSION</varname>.  The
+       older <varname>$HTTP_*_VARS</varname> arrays, such as
+       <varname>$HTTP_POST_VARS</varname>, still exist as they have since PHP 
3. 
        &avail.register-long-arrays;
       </simpara>
      </listitem>
      <listitem>
       <simpara>
-      Dýþ deðiþkenler artýk global kapsamda öntanýmlý olarak 
yaratýlmamaktadýrlar.
-      Baþka bir deyiþle, PHP
-       <ulink url="&url.php.release4.2.0;">4.2.0</ulink> sürümü ile birlikte 
&php.ini;
-       içersindeki bir PHP direktifi olan
-       <link linkend="ini.register-globals">register_globals</link>, öntanýmlý 
olarak
-       <emphasis>off (kapalý)</emphasis>hale getirildi. Bu deðerlere eriþim 
için
-       tercih edilen autoglobal dizi kullanýmý yönteminden yukarýda bahsettik. 
Eski
-       betikler, kitaplar ve eðitmenler bu direktifin açýk olduðu kabul 
edilerek yazýlmýþ olabilir.
-       Bu direktif açýk olduðunda, örneðin 
<literal>http://www.example.com/foo.php?id=42</literal>
-       URL&apos;sinden gelen bir istek ile otomatik olarak 
<varname>$id</varname>
-       deðiþkeni oluþturulur. Bu direktifin açýk ya da kapalý olduðuna 
bakýlmazsýzýn,
-       <varname>$_GET[&apos;id&apos;]</varname> deðiþkeni yaratýlýr.
-       </simpara>
+       External variables are no longer registered in the global scope by
+       default.  In other words, as of PHP
+       <ulink url="&url.php.release4.2.0;">4.2.0</ulink> the PHP directive 
+       <link linkend="ini.register-globals">register_globals</link> is 
+       <emphasis>off</emphasis> by default in &php.ini;. The preferred 
+       method of accessing these values is via the autoglobal arrays mentioned
+       above.  Older scripts, books, and tutorials may rely on this 
+       directive being on.  If it were on, for example, one could use 
+       <varname>$id</varname> from the URL 
+       <literal>http://www.example.com/foo.php?id=42</literal>.  Whether on 
+       or off, <varname>$_GET['id']</varname> is available.
+      </simpara>
      </listitem>
     </itemizedlist>
-    Bu deðiþiklikler ile ilgili daha fazla bilgi için,
-    <link linkend="language.variables.predefined">öntanýmlý deðiþkenler</link> 
bölümünden
-    ve buradaki diðer baðlantýlardan faydalanabilirsiniz.
+    For more details on these changes, see the section on 
+    <link linkend="language.variables.predefined">predefined variables</link>
+    and links therein.
    </para>
   </sect1>
   
   <sect1 id="tutorial.whatsnext">
-   <title>Sonraki adým nedir?</title>
+   <title>What's next?</title>
    <para>
-   Sahip olduðunuz yeni bilgilerle kýlavuzun birçok bölümünü anlayabilir
-   ve örnek arþivinde bulunan birçok betiði okuyabilir hale gelmiþ olmalýsýnýz.
-   <ulink url="&url.php.links;">&url.php.links;</ulink> baðlantýsýndan
-   inceleyebileceðiniz baþka örneklere ulaþabilirsiniz.
+    With your new knowledge you should be able to understand most of 
+    the manual and also the various example scripts available in the
+    example archives. You can also find other examples on the php.net
+    websites in the links section:
+    <ulink url="&url.php.links;">&url.php.links;</ulink>.
    </para>
    <para>
-   PHP ile neler yapabileceðiniz ile ilgili baþka sunumlara ulaþmak isterseniz,
-   <ulink url="&url.php.conf;">&url.php.conf;</ulink> ve
-   <ulink url="&url.php.talks;">&url.php.talks;</ulink>
-   adreslerindeki PHP Konferans Materyalleri Siteleri&apos;ni ziyaret 
edebilirsiniz.
+    To view various slide presentations that show more of what PHP can do, 
+    see the PHP Conference Material Sites: <ulink url="&url.php.conf;">
+    &url.php.conf;</ulink> and <ulink url="&url.php.talks;">&url.php.talks;
+    </ulink>
    </para>
   </sect1>
  </chapter>
@@ -521,4 +521,3 @@
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 -->
-

Reply via email to