com doc/tr: update for sync with English docs.: chapters/intro.xml language/basic-syntax.xml language/expressions.xml
[email protected] (Nilgün Belma Bugüner) Mon, 04 Jan 2021 14:29:54 +0000
| Newsgroups | php.doc.tr |
|---|---|
| Message-ID | <[email protected]> |
Commit: 4841b61534898f9591ebc61dacd1d88ce3f33d05 Author: Nilgün Belma Bugüner <[email protected]> Mon, 4 Jan 2021 17:29:54 +0300 Parents: 1f3b372cab33dda9ed4355ee6e8012992ca538a4 Branches: master Link: http://git.php.net/?p=doc/tr.git;a=commitdiff;h=4841b61534898f9591ebc61dacd1d88ce3f33d05 Log: update for sync with English docs. Changed paths: M chapters/intro.xml M language/basic-syntax.xml M language/expressions.xml
diff_4841b61534898f9591ebc61dacd1d88ce3f33d05.txt
(text/plain, 13.6 KB)
diff --git a/chapters/intro.xml b/chapters/intro.xml
index cce9c1f0..272a2b1b 100644
--- a/chapters/intro.xml
+++ b/chapters/intro.xml
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 9fba3a1b2936f17a99c0790c09241a234f7fadb7 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: f0b0e5bb633b40536bda7141b85674441a62aa95 Maintainer: nilgun Status: ready -->
<!-- CREDITS: tpug -->
<chapter xml:id="introduction" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Giriş</title>
@@ -21,8 +21,7 @@
<title>- Başlangıç olarak bir örnek</title>
<programlisting role="php">
<![CDATA[
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
- "http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE html>
<html>
<head>
<title>Örnek</title>
@@ -93,7 +92,7 @@
<simpara>
Sunucu-taraflı programlama. Bu PHP için en geleneksel ve en temel
olan alandır. Sunucu-taraflı programlama için üç şeye sahip olmanız
- gerekir. PHP çözümleyici (CGI ya da sunucu modülü), bir HTTP sunucusu
+ gerekir: PHP çözümleyici (CGI ya da sunucu modülü), bir HTTP sunucusu
ve bir tarayıcı. PHP programlamada deneyimliyseniz tüm bunları
evinizdeki makinede çalıştırabilirsiniz. <link
linkend="install">Yapılandırma ve Kurulum</link> bölümünden bununla
@@ -130,7 +129,7 @@
</para>
<para>
PHP bütün büyük işletim sistemlerinde, Linux, birçok Unix türevi (HP-UX,
- Solaris, OpenBSD vb.), Microsoft Windows, Mac OS X, RISC OS dahil olmak
+ Solaris, OpenBSD vb.), Microsoft Windows, MacOS, RISC OS dahil olmak
üzere çok çeşitli platformlarda <link linkend="install">çalışabilir</link>.
PHP benzer biçimde bugün yaygın biçimde kullanılan HTTP sunucularının büyük
kısmını destekler. Bunlara Apache, IIS ve daha birçok sunucuyu örnek
diff --git a/language/basic-syntax.xml b/language/basic-syntax.xml
index 25a1393d..4a1e221c 100644
--- a/language/basic-syntax.xml
+++ b/language/basic-syntax.xml
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 445962cfde047efd759cfc37006a5c5864864ef5 Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: a71742330defbc0edfbc6822b4f947bf437b2f70 Maintainer: nilgun Status: ready -->
<!-- CREDITS: tpug, sezer -->
<chapter xml:id="language.basic-syntax" xmlns="http://docbook.org/ns/docbook">
<title>Temel Sözdizimi</title>
@@ -14,6 +14,30 @@
çift açılış ve kapanış etiketinin dışındaki her şey PHP çözümleyicisi
tarafından gözardı edilir.
</para>
+
+ <para>
+ PHP daha açıklayıcı olan <code><?php echo</code> etiketine bir kısaltma olarak
+ <literal><?=</literal> kısa echo etiketini içerir.
+ </para>
+
+ <para>
+ <example>
+ <title>- PHP Açılış ve Kapanış Etiketleri</title>
+ <programlisting role="php">
+<![CDATA[
+1. <?php echo 'XHTML veya XML belgelerde PHP kodu sunmak isterseniz,
+ bu etiketleri kullanın'; ?>
+
+2. Kısa echo etiketi kullanabilirsiniz: <?= 'print this string' ?>.
+ <?php echo 'print this string' ?> koduna eşdeğerdir.
+
+3. <? echo 'bu kod kısa etiketler arasında olmakla birlikte sadece,'.
+ 'short_open_tag etkinse çalışır.'; ?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+
<para>
PHP ayrıca kısa başlangıç etiketine de <literal><?</literal> izin verir.
Bu sadece, PHP <option>--enable-short-tags</option> yapılandırma seçeneği ile
@@ -21,8 +45,18 @@
linkend="ini.short-open-tag">short_open_tag</link> kullanılarak
etkinleştirilebilir.
</para>
+
+ <para>
+ <note>
+ <para>
+ Kısa etiketler iptal edilebileceğinden uyumluluk adına sadece normal etiketlerin
+ (<code><?php ?></code> ve <code><?= ?></code>) kullanılması önerilir.
+ </para>
+ </note>
+ </para>
+
<para>
- Bir dosya saf PHP kodu ise, dosyanın sonunda PHP kapanış etiketini koymamak
+ Bir dosya sadece PHP kodu içeriyorsa, dosyanın sonunda PHP kapanış etiketini koymamak
tercih edilir. Yazılımcıdan herhangi bir çıktı gönderme isteği gelmezse PHP
betiğin bu noktasında çıktı tamponlamasını başlatacağından kapama etiketinden
sonra istenmeyen etkilere neden olabilecek boşluk veya yeni satırların
@@ -42,37 +76,8 @@ echo "İletişimin sonu";
</programlisting>
</informalexample>
</para>
- <para>
- <table>
- &reftitle.changelog;
- <tgroup cols="2">
- <thead>
- <row>
- <entry>&Version;</entry>
- <entry>&Description;</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>7.0.0</entry>
- <entry>
- <code><%</code>, <code>%></code>, <code><%=</code> ASP
- etiketleri ve <code><script language="php"></code> betik
- etiketi PHP'den kaldırıldıP.
- </entry>
- </row>
- <row>
- <entry>5.4.0</entry>
- <entry>
- <link linkend="ini.short-open-tag">short_open_tag</link> &php.ini;
- seçeneğine bakmaksızın <?= etiketi daima kullanılabilir oldu.
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- </para>
</sect1>
+
<sect1 xml:id="language.basic-syntax.phpmode">
<title>HTML'den Kaçmak</title>
<para>
@@ -122,109 +127,48 @@ echo "İletişimin sonu";
<function>print</function> ile görüntülemekten daha verimlidir.
</para>
<para>
- PHP 5'te, PHP'nin yapılandırılışına bağlı olarak kullanılabilecek beş
- farklı açılış ve kapanış etiketi çifti vardır. Bunlardan ikisi,
- <?php ?> ve <script language="php"> </script> her zaman
- kullanılabilir durumdadır. Ayrıca, bir de PHP 5.4.0 ve sonrasında
- kullanılabilen <code><?= ?></code> kısa echo etiketi vardır.
- </para>
- <para>
- Diğer ikisi, kısa etiketler ve <productname>ASP</productname> tarzı
- etiketlerdir. Bazı kişiler kısa etiketleri ve <productname>ASP</productname>
- tarzı etiketleri daha kullanışlı bulmaktadır, ancak bu ikisi daha az
- taşınabilir olduklarından genellikle tavsiye edilmemektedir.
<note>
<para>
- Bir diğer önemli nokta, PHP'yi XML ya da XHTML içine gömmek istiyorsanız
- standartlarla uyumlu kalabilmek için <?php ?> etiketlerini
- kullanmanız gerektiğidir.
+ PHP'yi XML ya da XHTML içine gömmek istiyorsanız standartlarla uyumlu
+ kalabilmek için normal PHP <code><?php ?></code> etiketlerini
+ kullanmalısınız.
</para>
</note>
</para>
+ </sect1>
+
+ <sect1 xml:id="language.basic-syntax.instruction-separation">
+ <title>Deyim Ayrımı</title>
<para>
- PHP 7'de <productname>ASP</productname> ve
- <code><script language="php"></code> etiketleri için destek
- kaldırılmıştır. Sonuç olarak, PHP kodunu yazarken azami uyumluluk için
- sadece <code><?php ?></code> ve <code><?= ?></code>
- etiketlerini kullanmanızı öneriyoruz.
+ C ya da Perl'de olduğu gibi, PHP de deyimlerin birbirlerinden her bir
+ deyimin sonuna konulacak noktalı virgülle ayrılmasını gerektirir. Bir PHP
+ kod bloğunun sonunda yer alan kapanış etiketi kendinden önceki deyim için
+ noktalı virgül işlevi görür; yani, bir PHP bloğunun son satırının sonuna
+ noktalı virgül koymak zorunda değilsiniz. Kapanış etiketi aynı zamanda
+ satırsonu karakterini de kendisi ekleyecektir.
</para>
+
<para>
<example>
- <title>- PHP Açılış ve Kapanış Etiketleri</title>
+ <title>- Sondaki satırsonu karakterini kapsayan kapanış etiketini gösteren örnek</title>
<programlisting role="php">
<![CDATA[
-1. <?php echo 'XHTML ya da XML belgeleri sunacaksanız,
- bu etiketleri kullanın'; ?>
-
-2. <?= 'bu metni basmak' ?> için kısa echo etiketini kullanabilirsiniz.
- PHP 5.4.0 ve sonrasında daima etkin olup
- <?php echo 'bu metni basmak' ?> ile eşdeğerdir.
-
-3. <? echo 'bu kod kısa etiketlerin içindedir, fakat sadece '.
- 'short_open_tag etkinse çalışır'; ?>
-
-4. <script language="php">
- echo 'bazı düzenleyiciler (FrontPage gibi) bu etiketlerin
- içindeki işlem yönergelerini sevmezler';
- </script>
-
-5. <% echo 'İsterseniz ASP tarzı etiketler kullanabilirsiniz'; %>
- <%= $değişken; %> etiketleri içindeki kod, <% echo $değişken; %>
- için bir kısayoldur. Bu son iki etiket çifti PHP 7.0.0'da kaldırılmıştır.
+Satırsonu karakteri yok
+<?= "Ama şimdi var" ?>
]]>
</programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+Some textSatırsonu karakteri yok
+Ama şimdi var
+]]>
+ </screen>
</example>
</para>
+
<para>
- Kısa etiketler (üçüncü örnek) yalnızca &php.ini; içersinde <link
- linkend="ini.short-open-tag">short_open_tag</link> yapılandırma
- yönergesiyle etkinleştirilmişlerse ya da PHP,
- <code>--enable-short-tags</code> derleme seçeneği ile
- yapılandırılmışsa kullanılabilirler.
- </para>
- <para>
- <productname>ASP</productname> tarzı etiketler (beşinci örnek) &php.ini;
- dosyasında <link linkend="ini.asp-tags">asp_tags</link> yapılandırma
- yönergesiyle etkinleştirilmişse kullanılabilir. Bunlar
- PHP 7.0.0'da kaldırılmıştır.
- </para>
- <para>
- <note>
- <para>
- Geliştirdiğiniz uygulamaları ya da kütüphaneleri başkalarına
- dağıtacaksanız ya da bu uygulamaları denetiminizde olmayan PHP
- sunucularına kuracaksanız kısa etiketleri kullanmaktan kaçınmalısınız,
- çünkü hedef sunucu kısa etiketleri desteklemiyor olabilir. Kodlarınızın
- taşınabilir ve yeniden dağıtılabilir olması için, alışkanlıkla kısa
- etiketleri kullanmadığınızdan emin olun.
- </para>
- </note>
- <note>
- <para>
- PHP 5.2 ve öncesinde, çözümleyici, bir dosya içindeki tek şey olarak
- <literal><?php</literal> başlangıç etiketine izin vermezdi.
- Açılş etiketinden sonra bir veya daha fazla boşluk karakteri olması
- durumunda PHP 5.3'ten itibaren izin verilmektedir.
- </para>
- </note>
- <note>
- <para>
- PHP 5.4 itibariyle, kısa echo etiketi <literal><?=</literal>
- <link linkend="ini.short-open-tag">short_open_tag</link> seçeneğine
- bakılmaksızın daima geçerlidir ve tanınmaktadır.
- </para>
- </note>
- </para>
- </sect1>
- <sect1 xml:id="language.basic-syntax.instruction-separation">
- <title>Deyim Ayrımı</title>
- <para>
- C ya da Perl'de olduğu gibi, PHP de deyimlerin birbirlerinden her bir
- deyimin sonuna konulacak noktalı virgülle ayrılmasını gerektirir. Bir PHP
- kod bloğunun sonunda yer alan kapanış etiketi kendinden önceki deyim için
- noktalı virgül işlevi görür; yani, bir PHP bloğunun son satırının sonuna
- noktalı virgül koymak zorunda değilsiniz. Kapanış etiketi aynı zamanda
- satırsonu karakterini de kendisi ekleyecektir.
+ PHP ayrıştırıcısına girme ve çıkma örnekleri:
<informalexample>
<programlisting role="php">
<![CDATA[
@@ -252,6 +196,7 @@ echo "İletişimin sonu";
</note>
</para>
</sect1>
+
<sect1 xml:id="language.basic-syntax.comments">
<title>Açıklamalar</title>
<para>
@@ -277,12 +222,7 @@ echo "İletişimin sonu";
<literal># ... ?></literal> kullanımından sonra gelecek HTML kodu
YAZDIRILACAKTIR: <code>?></code> etiketi PHP kipinden çıkılmasına ve
HTML kipine dönülmesini sağlar, <literal>//</literal> ya da
- <literal>#</literal> kullanımı bunu etkileyemez <link
- linkend="ini.asp-tags">asp_tags</link> yapılandırma yönergesi etkinse,
- asp tarzı <literal>// %></literal> ve <literal># %></literal>
- kullanımı da böyle çalışır. Bununla birlikte,
- <literal></script></literal> etiketi tek satırlık açıklama için
- böyle duruma yol açmaz.
+ <literal>#</literal> kullanımı bunu etkileyemez.
</simpara>
<para>
<informalexample>
diff --git a/language/expressions.xml b/language/expressions.xml
index 9f5c0d05..9b5927cf 100644
--- a/language/expressions.xml
+++ b/language/expressions.xml
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 5dba865d911a1d0aed3160abbb19be77fff560ca Maintainer: nilgun Status: ready -->
+<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: nilgun Status: ready -->
<!-- CREDITS: tpug, sezer -->
<chapter xml:id="language.expressions" xmlns="http://docbook.org/ns/docbook">
<title>İfadeler</title>
@@ -54,9 +54,9 @@ function foo ()
<para>
Elbette, PHP'deki değerlerin hep tamsayılar olması gerekmez, zaten
çoğunlukla değildirler. PHP dört çeşit sayıl değer destekler: Tamsayı
- (<type>integer</type>) değerler, kayan noktalı (<type>float</type>)
+ (<type>int</type>) değerler, kayan noktalı (<type>float</type>)
değerler, dizge (<type>string</type>) değerler ve mantıksal
- <type>boolean</type> değerler (sayıl değerler, dizilerin aksine daha
+ <type>bool</type> değerler (sayıl değerler, dizilerin aksine daha
küçük parçalara bölemeyeceğiniz değerlerdir). PHP ayrıca iki bileşik
(sayıl olmayan) tür destekler: Diziler ve nesneler. Bu değer türlerinden
her biri bir değişkene atanabilir ya da bir işlevden döndürülebilir.