com doc/tr: update for sync with English docs.: language-snippets.ent reference/exec/functions/escapeshellarg.xml
reference/exec/functions/escapeshellcmd.xml reference/exec/functions/exec.xml reference/exec/functions/proc-close.xml
reference/exec/functions/proc-nice.xml reference/exec/functions/proc-open.xml reference/exec/functions/proc-terminate.xml
reference/exec/functions/shell-exec.xml reference/exec/functions/system.xml

From: Date: Sun, 28 Mar 2021 09:26:15 +0000
Subject: com doc/tr: update for sync with English docs.: language-snippets.ent reference/exec/functions/escapeshellarg.xml
reference/exec/functions/escapeshellcmd.xml reference/exec/functions/exec.xml reference/exec/functions/proc-close.xml
reference/exec/functions/proc-nice.xml reference/exec/functions/proc-open.xml reference/exec/functions/proc-terminate.xml
reference/exec/functions/shell-exec.xml reference/exec/functions/system.xml
Groups: php.doc.tr 
Request: Send a blank email to doc-tr+get-2636@lists.php.net to get a copy of this message
Commit: b87267594a281f640cdfbe42aa7172eaf5a11baf Author: Nilgün Belma Bugüner <nilgun@php.net> Sun, 28 Mar 2021 12:26:15 +0300 Parents: 1852dd3e4713732dc15944507163b25ed32593bd Branches: master Link: http://git.php.net/?p=doc/tr.git;a=commitdiff;h=b87267594a281f640cdfbe42aa7172eaf5a11baf Log: update for sync with English docs. Changed paths: M language-snippets.ent M reference/exec/functions/escapeshellarg.xml M reference/exec/functions/escapeshellcmd.xml M reference/exec/functions/exec.xml M reference/exec/functions/proc-close.xml M reference/exec/functions/proc-nice.xml M reference/exec/functions/proc-open.xml M reference/exec/functions/proc-terminate.xml M reference/exec/functions/shell-exec.xml M reference/exec/functions/system.xml

diff --git a/language-snippets.ent b/language-snippets.ent index 1146376d..34d53fd9 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -60,10 +60,10 @@ dosyaya ya da başka bir çıktı akımına yönlendirilmelidir. Aksi takdirde, uygulama sonlanana kadar PHP askıda kalacaktır.</para></note>'> <!ENTITY note.exec-bypass-shell '<note xmlns="http://docbook.org/ns/docbook"> -<para>Windows&apos;ta <function>exec</function> komut çalıştırmak için önce -cmd.exe çalıştırır. cmd.exe yerine harici bir uygulama çalıştırılmak istenirse -<function>proc_open</function> işlevi <parameter>kabuğu_atlat</parameter> -seçeneğiyle kullanılabilir.</para></note>'> +<para>Windows&apos;ta <function>exec</function> işlevi, komut çalıştırmak +için önce cmd.exe çalıştırır. cmd.exe yerine harici bir uygulama +çalıştırılmak istenirse <function>proc_open</function> işlevi +<literal>bypass_shell</literal> seçeneğiyle kullanılabilir.</para></note>'> <!ENTITY note.func-callback '<note xmlns="http://docbook.org/ns/docbook"> <simpara>Bir işlev ismi yerine, bir nesneye gönderim ve bir yöntem ismi diff --git a/reference/exec/functions/escapeshellarg.xml b/reference/exec/functions/escapeshellarg.xml index 6fc95de1..a20d645b 100644 --- a/reference/exec/functions/escapeshellarg.xml +++ b/reference/exec/functions/escapeshellarg.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 3e15d2894fb35432d2a111db36fe8ba8ebc62024 Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/exec.xml, last change in rev 1.8 --> <refentry xml:id="function.escapeshellarg" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -15,14 +15,20 @@ <methodparam><type>string</type><parameter>değiştirge</parameter></methodparam> </methodsynopsis> <para> - <function>escapeshellarg</function> işlevi, tek bir değiştirge olarak ele - alınmak üzere bir dizgeyi tek tırnaklarla sarmalar ve tek başına bulunan tek - tırnakları da önceler. Bu işlev kullanıcı girdisinden gelen kabuk işlevi - değiştirgelerini tek tek öncelemekte kullanılmalıdır. + <function>escapeshellarg</function> işlevi, bir dizgeyi kabuk işlevleri + tarafından güvenilir tek bir değiştirge olarak ele alınmasını sağlamak + için tek tırnaklarla sarmalar ve dizge içinde bulunan tek tırnakları da + önceler. Bu işlev kullanıcı girdisinden gelen bağımsız değiştirgeleri + kabuk işlevlerine aktarmadan evvel öncelemekte kullanılmalıdır. <function>exec</function>, <function>system</function> ve <link linkend="language.operators.execution">çalıştırma işleci</link>ne aktarılacak değiştirgeler bu işlemden geçirilmelidir. </para> + <para> + Windows'ta <function>escapeshellarg</function> bunun yerine yüzde + imlerini, ünlem imlerini (gecikmiş değişken ikamesi) ve çift tırnakları + boşluklarla değiştirir ve dizeyi çift tırnaklarla sarmalar. + </para> </refsect1> <refsect1 role="parameters"> diff --git a/reference/exec/functions/escapeshellcmd.xml b/reference/exec/functions/escapeshellcmd.xml index c79964a7..a1297ff9 100644 --- a/reference/exec/functions/escapeshellcmd.xml +++ b/reference/exec/functions/escapeshellcmd.xml @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 3e15d2894fb35432d2a111db36fe8ba8ebc62024 Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/exec.xml, last change in rev 1.2 --> <refentry xml:id="function.escapeshellcmd" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>escapeshellcmd</refname> - <refpurpose>Kabuk meta karakterlerini önceler</refpurpose> + <refpurpose>Kabuk özel karakterlerini önceler</refpurpose> </refnamediv> <refsect1 role="description"> @@ -17,19 +17,19 @@ <para> <function>escapeshellcmd</function> işlevi, içinde keyfi komutlar çalıştırarak bir kabuk komutunu kandırmak için kullanılabilecek bir - dizgenin içerdiği karakterleri önceler. Bu işlev, <function>exec</function> - veya <function>system</function> işlevlerine ya da <link - linkend="language.operators.execution">çalıştırma işlecine</link> - aktarılmadan önce kullanıcı girdisi olarak alınan veriyi öncelemek için - kullanılmalıdır. + dizgenin içerdiği karakterleri önceler. Bu işlev, + <function>exec</function> veya <function>system</function> işlevlerine + ya da <link linkend="language.operators.execution">çalıştırma + işlecine</link> aktarılmadan önce kullanıcı girdisi olarak alınan veriyi + öncelemek için kullanılmalıdır. </para> <para> Bir tersbölü çizgisi ile öncelenen karakterler şunlardır: - <literal>#&amp;;`|*?~&lt;&gt;^()[]{}$\</literal>, <literal>\x0A</literal> + <literal>&amp;#;`|*?~&lt;&gt;^()[]{}$\</literal>, <literal>\x0A</literal> ve <literal>\xFF</literal>. <literal>'</literal> ve <literal>"</literal> - karakterleri sadece çiftler halinde kullanılmışsa öncelenir. Windows'a tüm - bu karakterlere ek olarak <literal>%</literal> karakteri yerine bir boşluk - yerleştirilir. + karakterleri sadece çiftler halinde değilse öncelenir. Windows'a tüm + bu karakterlere ek olarak <literal>%</literal> ve <literal>!</literal> + imleri bir şapka imi (<literal>^</literal>) ile öncelenir. </para> </refsect1> @@ -64,14 +64,12 @@ <programlisting role="php"> <![CDATA[ <?php -$e = escapeshellcmd($userinput); +// Burada bilerek keyfi sayıda değiştirgeye izin veriyoruz. +$komut = './configure '.$_POST['configure_options']; -// $e boşluk içeriyorsa burada dikkate almayacağız -system("echo $e"); -$f = escapeshellcmd($filename); +$öncelenen_komut = escapeshellcmd($komut); -// ve burada tırnakları kullanıyoruz -system("touch \"/tmp/$f\"; ls -l \"/tmp/$f\""); +system($öncelenen_komut); ?> ]]> </programlisting> @@ -79,6 +77,17 @@ system("touch \"/tmp/$f\"; ls -l \"/tmp/$f\""); </para> </refsect1> + <refsect1 role="notes"> + <warning xmlns="http://docbook.org/ns/docbook"> + <para> + <function>escapeshellcmd</function> komut dizgesinin tamamı üzerinde + kullanılmalıdır. Buna rağmen saldırganın keyfi sayıda değiştirge + aktarmasına izin verir. Tek bir değiştirgeyi öncelemek için bu işlev + yerine <function>escapeshellarg</function> kullanılmalıdır. + </para> + </warning> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> diff --git a/reference/exec/functions/exec.xml b/reference/exec/functions/exec.xml index 04e5c967..6a440527 100644 --- a/reference/exec/functions/exec.xml +++ b/reference/exec/functions/exec.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: dec1f8445ab2af7fbafef012fb7907ab2cd349b5 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/exec.xml, last change in rev 1.2 --> <refentry xml:id="function.exec" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -11,10 +11,10 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>exec</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>exec</methodname> <methodparam><type>string</type><parameter>komut</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter role="reference">çıktı</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter role="reference">dönüş_değeri</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter role="reference">çıktı</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">sonuç</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> <function>exec</function> işlevi belirtilen <parameter>komut</parameter>'u çalıştırır. @@ -48,7 +48,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>dönüş_değeri</parameter></term> + <term><parameter>sonuç</parameter></term> <listitem> <para> <parameter>çıktı</parameter> değiştirgesinin yanında bir @@ -68,6 +68,9 @@ girmeden doğrudan geri aktarılsın isterseniz <function>passthru</function> işlevini kullanın. </para> + <para> + Başarısızlık durumunda &false; döner. + </para> <para> Çalıştırılan komutun çıktısını almak istiyorsanız <parameter>çıktı</parameter> değiştirgesini belirtmeyi unutmayın. @@ -84,10 +87,24 @@ <?php // php/httpd süreçlerinin sahibi olan kullanıcının ismini çıktılayalım // Tabii, whoami komutu olan bir sistemde. -echo exec('whoami'); +$output=null; +$retval=null; +exec('whoami', $output, $retval); +echo "$retval durum kodu ile döndü, çıktısı:\n"; +print_r($output); ?> ]]> </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +0 durum kodu ile döndü, çıktısı:: +Array +( + [0] => cmb +) +]]> + </screen> </example> </para> </refsect1> diff --git a/reference/exec/functions/proc-close.xml b/reference/exec/functions/proc-close.xml index d8972570..0032fbd5 100644 --- a/reference/exec/functions/proc-close.xml +++ b/reference/exec/functions/proc-close.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 350d95443aeb0ea8751d71f262aac56d3ad48f83 Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/exec.xml, last change in rev 1.28 --> <refentry xml:id='function.proc-close' xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -20,8 +20,8 @@ tarafından açılmış süreçleri kapatması dışında <function>pclose</function> işlevi gibidir. <function>proc_close</function> sürecin sonlanmasını bekler ve çıkış kodunu döndürür. Bu sürece açılan borular varsa, bir kısır döngü - oluşmaması için bu işlevi çağırmadan önce <function>fclose</function> ile - onları kapatmalısınız. Açık borular varken çocuk süreç çıkmayı reddedecektir. + oluşmaması için bu işlevi çağırmadan önce onları kapatmalısınız. Açık + borular varken çocuk süreç çıkmayı reddedecektir. </para> </refsect1> @@ -44,7 +44,8 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Sonlandırılan sürecin çıkış kodunu döndürür. + Sonlandırılan sürecin çıkış kodu veya bir hata durumunda + <literal>-1</literal> döner. </para> </refsect1> diff --git a/reference/exec/functions/proc-nice.xml b/reference/exec/functions/proc-nice.xml index 9183a81b..4ce68034 100644 --- a/reference/exec/functions/proc-nice.xml +++ b/reference/exec/functions/proc-nice.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: nilgun Status: ready --> <refentry xml:id='function.proc-nice' xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>proc_nice</refname> @@ -11,13 +11,13 @@ &reftitle.description; <methodsynopsis> <type>bool</type><methodname>proc_nice</methodname> - <methodparam><type>int</type><parameter>fark</parameter></methodparam> + <methodparam><type>int</type><parameter>öncelik</parameter></methodparam> </methodsynopsis> <para> <function>proc_nice</function> işlevi çalışan sürecin önceliğini - <parameter>fark</parameter> kadar değiştirir. Pozitif bir - <parameter>fark</parameter> sürecin önceliğini düşürürken negatif bir - <parameter>fark</parameter> önceliği arttıracaktır. + <parameter>öncelik</parameter> kadar değiştirir. Pozitif bir + <parameter>öncelik</parameter> sürecin önceliğini düşürürken negatif bir + <parameter>öncelik</parameter> önceliği arttıracaktır. </para> <para> <function>proc_nice</function> işlevinin <function>proc_open</function> ve @@ -30,11 +30,62 @@ <para> <variablelist> <varlistentry> - <term><parameter>fark</parameter></term> + <term><parameter>öncelik</parameter></term> <listitem> <para> - Önceliği değiştirecek fark. + Yeni öncelik değeri. </para> + <para> + Unix'te, <literal>-20</literal> gibi düşük bir değer yüksek öncelik + anlamına gelirken pozitif bir değer düşük öncelik demektir. + </para> + <para> + <parameter>öncelik</parameter> değiştirgesinin Windows üzerindeki + anlamları: + </para> + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry valign="top">Öncelik sınıfı</entry> + <entry valign="top">Olası değerler</entry> + </row> + </thead> + <tbody> + <row> + <entry valign="top">Yüksek öncelik</entry> + <entry valign="top"> + <parameter>öncelik</parameter> <literal>&lt; -9</literal> + </entry> + </row> + <row> + <entry valign="top">Normal üstü öncelik</entry> + <entry valign="top"> + <parameter>öncelik</parameter> <literal>&lt; -4</literal> + </entry> + </row> + <row> + <entry valign="top">Normal öncelik</entry> + <entry valign="top"> + <parameter>öncelik</parameter> <literal>&lt; 5</literal> &amp; + <parameter>öncelik</parameter> <literal>&gt; -5</literal> + </entry> + </row> + <row> + <entry valign="top">Normal altı öncelik</entry> + <entry valign="top"> + <parameter>öncelik</parameter> <literal>&gt; 5</literal> + </entry> + </row> + <row> + <entry valign="top">Bekletme önceliği</entry> + <entry valign="top"> + <parameter>öncelik</parameter> <literal>&gt; 9</literal> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </listitem> </varlistentry> </variablelist> @@ -50,6 +101,49 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>- Önceliği yükseltmek için <function>proc_nice</function> + kullanımı</title> + <programlisting role="php"> +<![CDATA[ +<?php +// yüksek öncelik +proc_nice(-20); +?> +]]> + </programlisting> + </example> + </para> + + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>7.2.0</entry> + <entry> + Bu işlev artık Windows üzerinde kullanılbiliyor. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="notes"> &reftitle.notes; <note> @@ -57,10 +151,17 @@ <para> <function>proc_nice</function> işlevi sadece sisteminiz 'nice' yeteneğine sahipse mevcut olacaktır. 'nice' bulunan sistemler: SVr4, SVID EXT, - AT&amp;T, X/OPEN, BSD 4.3. Yani, Windows'ta <function>proc_nice</function> - diye bir işlev yoktur. + AT&amp;T, X/OPEN, BSD 4.3. </para> </note> + <note> + <title>Windows için</title> + <para> + PHP evre güvenliği kullanılarak derlenmiş olsa bile + <function>proc_nice</function> <emphasis>geçerli</emphasis> süreç + önceliğini değiştirir. + </para> + </note> </refsect1> </refentry> diff --git a/reference/exec/functions/proc-open.xml b/reference/exec/functions/proc-open.xml index 816a74be..e927d784 100644 --- a/reference/exec/functions/proc-open.xml +++ b/reference/exec/functions/proc-open.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/exec.xml, last change in rev 1.28 --> <refentry xml:id='function.proc-open' xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -12,12 +12,12 @@ &reftitle.description; <methodsynopsis> <type>resource</type><methodname>proc_open</methodname> - <methodparam><type>string</type><parameter>komut</parameter></methodparam> + <methodparam><type>mixed</type><parameter>komut</parameter></methodparam> <methodparam><type>array</type><parameter>tanıtıcılar</parameter></methodparam> <methodparam><type>array</type><parameter role="reference">borular</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>dizin</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>ortam</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>seçenekler</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>dizin</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type>array</type><parameter>ortam</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type>array</type><parameter>seçenekler</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> <function>proc_open</function> işlevi, program çalıştırma konusunda daha @@ -30,11 +30,44 @@ <para> <variablelist> <varlistentry> - <term><parameter>cmd</parameter></term> + <term><parameter>komut</parameter></term> <listitem> <para> - Çalıştırılacak komut. + Bir dizge olarak çalıştırılacak komut. Özel karakterler uygun şekilde + öncelenmeli ve uygun tırnaklama uygulanmalıdır. </para> + <note> + <simpara> + <emphasis>Windows</emphasis> üzerinde, + <parameter>seçenekler</parameter> içinde + <literal>bypass_shell</literal> &true; olmadıkça + <parameter>komut</parameter> <emphasis>tırnaklı</emphasis> dizge + olarak (yani, tam olarak <function>proc_open</function> işlevine + belirtildiği gibi) <literal>/c</literal> seçeneğiyle + <command>cmd.exe</command>'ye aktarılır (aslında, + <literal>%ComSpec%</literal>). Bu <command>cmd.exe</command>'nin + <parameter>komut</parameter>'taki sarmalayıcı tırnakları kaldırmasına + sebep olur (ayrıntılar için <command>cmd.exe</command> belgelerine + bakın), bu da istenmeyen ve daha tehlikeli olabilecek bir davranışla + sonuçlanır, çünkü <command>cmd.exe</command> hata iletiler aktarılan + <parameter>komut</parameter>'u (parçalarını) içerebilir (aşağıya + bakınız). + </simpara> + </note> + <para> + PHP 7.4.0'dan beri, <parameter>komut</parameter> bir komut + değiştirgeleri dizisi olarak aktarılabilmektedir. Bu durumda süreç + doğrudan (kabuk üzerinden gitmeden) açılabilmekte ve gerekli + değiştirge öncelemesini PHP yapabilmektedir. + </para> + <note> + <para> + Windows üzerinde, dizi elemanlarının değiştirge öncelemesi, + çalıştırılan komutun komut satırı çözümlemesinin, VC çalışma + zamanında yapılan komut satırı değiştirgeleri ayrıştırılması + işlemiyle uyumlu olduğu varsayılır. + </para> + </note> </listitem> </varlistentry> <varlistentry> @@ -119,13 +152,17 @@ &true; belirtilirse <literal>cmd.exe</literal> kabuğu es geçilir. </member> <member> - <literal>context</literal>: Dosyaları açarken kullanılan - (<function>stream_context_create</function> ile oluşturulmuş) akım - bağlamı + <literal>blocking_pipes</literal> (sadece windows): &true; + atandığında boruların engellenmesi zorlanır. + </member> + <member> + <literal>create_process_group</literal> (sadece windows): &true; + atandığında <literal>CTRL</literal> olaylarının çocuk süreç + tarafından işlenmesini sağlar. </member> <member> - <literal>binary_pipes</literal>: Borular, normal olarak - <function>stream_encoding</function> ile değil ikil kipte açılır. + <literal>create_new_console</literal> (sadece windows): Ebeveynin + konsolunu miras almak yerine yeni sürece yeni bir konsol açılır. </member> </simplelist> </para> @@ -157,25 +194,24 @@ </thead> <tbody> <row> - <entry>6.0.0</entry> + <entry>7.4.4</entry> <entry> - <parameter>seçenekler</parameter> değiştirgesinin olası seçeneklerine - <literal>context</literal> ve <literal>binary_pipes</literal> - seçenekleri eklendi. + <parameter>seçenekler</parameter> değiştirgesine + <literal>create_new_console</literal> seçeneği eklendi. </entry> </row> <row> - <entry>5.2.1</entry> + <entry>7.4.0</entry> <entry> - <parameter>seçenekler</parameter> değiştirgesinin olası seçeneklerine - <literal>bypass_shell</literal> seçeneği eklendi. + <function>proc_open</function> artık <parameter>komut</parameter> + değiştirgesinde bir dizi de kabul edebiliyor. </entry> </row> <row> - <entry>5.0.0</entry> + <entry>7.4.0</entry> <entry> - <parameter>dizin</parameter>, <parameter>ortam</parameter> ve - <parameter>seçenekler</parameter> değiştirgeleri eklendi. + <parameter>seçenekler</parameter> değiştirgesine + <literal>create_process_group</literal> seçeneği eklendi. </entry> </row> </tbody> @@ -239,6 +275,41 @@ komut 0 değerini döndürdü </screen> </example> </para> + <para> + <example> + <title>- Windows üzerinde <function>proc_open</function> tuhaflığı + </title> + <simpara> + Aşağıdaki betiğin <filename>filename.txt</filename> üzerinde <literal>search</literal> dizgesini arayacağı ve sonucu basacağı umulurken biraz farklı davranır: + </simpara> + <programlisting role="php"> +<![CDATA[ +<?php +$tanıtıcılar = [STDIN, STDOUT, STDOUT]; +$komut = '"findstr" "search" "filename.txt"'; +$süreç = proc_open($komut, $tanıtıcılar, $borular); +proc_close($süreç); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +'findstr" "search" "filename.txt' is not recognized as an internal or external command, +operable program or batch file. +]]> + </screen> + <simpara> + Bu davranışın etrafından dolaşmak için komutu ek tırnaklarla sarmalamak + yeterlidir: + </simpara> + <programlisting role="php"> +<![CDATA[ +$cmd = '""findstr" "search" "filename.txt""'; +]]> + </programlisting> + </example> + </para> </refsect1> <refsect1 role="notes"> diff --git a/reference/exec/functions/proc-terminate.xml b/reference/exec/functions/proc-terminate.xml index 69447d85..14731c61 100644 --- a/reference/exec/functions/proc-terminate.xml +++ b/reference/exec/functions/proc-terminate.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 9af43469f46843451955b8926fe470a9f3d45034 Maintainer: nilgun Status: ready --> <refentry xml:id='function.proc-terminate' xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>proc_terminate</refname> @@ -60,30 +60,6 @@ </para> </refsect1> - <refsect1 role="changelog"> - &reftitle.changelog; - <para> - <informaltable> - <tgroup cols="2"> - <thead> - <row> - <entry>&Version;</entry> - <entry>&Description;</entry> - </row> - </thead> - <tbody> - <row> - <entry>5.2.2</entry> - <entry> - Önceki sürümler belirtilen süreç özkaynağını yok ederler. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="seealso"> &reftitle.seealso; <para> diff --git a/reference/exec/functions/shell-exec.xml b/reference/exec/functions/shell-exec.xml index 2f5025e5..9caee5f0 100644 --- a/reference/exec/functions/shell-exec.xml +++ b/reference/exec/functions/shell-exec.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: dec1f8445ab2af7fbafef012fb7907ab2cd349b5 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/exec.xml, last change in rev 1.2 --> <refentry xml:id='function.shell-exec' xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -21,8 +21,8 @@ </para> <note> <para> - Windows'ta, ilgili boru metin kipinde açıldığı için ikil çıktı için - işlevin başarısız olmasına sebep olur. Böyle durumlarda bu işlev yerine + Windows'ta, ilgili boru metin kipinde açıldığı için ikil çıktı için + işlevin başarısız olmasına sebep olur. Böyle durumlarda bu işlev yerine <function>popen</function> kullanabilirsiniz. </para> </note> @@ -47,14 +47,14 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Çalıştırılan komutun çıktısı bir dizge olarak döner. Komut çıktı + Çalıştırılan komutun çıktısı bir dizge olarak döner. Komut çıktı üretmezse veya hata oluşmuşsa &null; döner. </para> <note> <para> - Bu işlev, hem komutun çıktı üretmediği durumda hem de hata durumunda ayırt - etmeksizin &null; döndürür. Bu sebeple başarısızlık durumunu bu işlevle - saptamak mümkün değildir. Komutun çıkış durumuna erişmek gerekliyse bu + Bu işlev, hem komutun çıktı üretmediği durumda hem de hata durumunda ayırt + etmeksizin &null; döndürür. Bu sebeple başarısızlık durumunu bu işlevle + saptamak mümkün değildir. Komutun çıkış durumuna erişmek gerekliyse bu işlev yerine <function>exec</function> kullanılmalıdır. </para> </note> diff --git a/reference/exec/functions/system.xml b/reference/exec/functions/system.xml index 8eb6b7aa..8064a373 100644 --- a/reference/exec/functions/system.xml +++ b/reference/exec/functions/system.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: dec1f8445ab2af7fbafef012fb7907ab2cd349b5 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/exec.xml, last change in rev 1.24 --> <refentry xml:id="function.system" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -12,9 +12,9 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>system</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>system</methodname> <methodparam><type>string</type><parameter>komut</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter role="reference">dönüş_değeri</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">sonuç</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> <function>system</function> işlevi C dilindeki adaşı gibi verilen @@ -43,7 +43,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>dönüş_değeri</parameter></term> + <term><parameter>sonuç</parameter></term> <listitem> <para> Bu değiştirge belirtilmişse çalıştırılan komutun çıktısı bu değişkene
« previous php.doc.tr (#2636) next »