com doc/tr: update for sync with English docs.: reference/exif/functions/exif-imagetype.xml reference/exif/functions/exif-tagname.xml
reference/exif/functions/exif-thumbnail.xml reference/exif/functions/read-exif-data.xml reference/fileinfo/functions/finfo-buffer.xml
reference/fileinfo/functions/finfo-close.xml reference/fileinfo/functions/finfo-file.xml reference/fileinfo/functions/finfo-open.xml
reference/fileinfo/functions/finfo-set-flags.xml
| From: | Nilgün Belma Bugüner | Date: | Sun, 28 Mar 2021 15:09:16 +0000 |
| Subject: | com doc/tr: update for sync with English docs.: reference/exif/functions/exif-imagetype.xml reference/exif/functions/exif-tagname.xml reference/exif/functions/exif-thumbnail.xml reference/exif/functions/read-exif-data.xml reference/fileinfo/functions/finfo-buffer.xml reference/fileinfo/functions/finfo-close.xml reference/fileinfo/functions/finfo-file.xml reference/fileinfo/functions/finfo-open.xml reference/fileinfo/functions/finfo-set-flags.xml |
||
| Groups: | php.doc.tr | ||
| Request: | Send a blank email to doc-tr+get-2637@lists.php.net to get a copy of this message | ||
Commit: 614c58dc2a337bbdf4bacd13d18f63f56fa3001f
Author: Nilgün Belma Bugüner <nilgun@php.net> Sun, 28 Mar 2021 18:09:16 +0300
Parents: b87267594a281f640cdfbe42aa7172eaf5a11baf
Branches: master
Link: http://git.php.net/?p=doc/tr.git;a=commitdiff;h=614c58dc2a337bbdf4bacd13d18f63f56fa3001f
Log:
update for sync with English docs.
Changed paths:
M reference/exif/functions/exif-imagetype.xml
M reference/exif/functions/exif-tagname.xml
M reference/exif/functions/exif-thumbnail.xml
M reference/exif/functions/read-exif-data.xml
M reference/fileinfo/functions/finfo-buffer.xml
M reference/fileinfo/functions/finfo-close.xml
M reference/fileinfo/functions/finfo-file.xml
M reference/fileinfo/functions/finfo-open.xml
M reference/fileinfo/functions/finfo-set-flags.xml
M reference/filesystem/functions/basename.xml
M reference/filesystem/functions/copy.xml
M reference/filesystem/functions/delete.xml
M reference/filesystem/functions/disk-total-space.xml
M reference/filesystem/functions/feof.xml
M reference/filesystem/functions/fgetss.xml
M reference/filesystem/functions/file.xml
M reference/filesystem/functions/fileatime.xml
M reference/filesystem/functions/filectime.xml
M reference/filesystem/functions/fileperms.xml
M reference/filesystem/functions/filetype.xml
M reference/filesystem/functions/fnmatch.xml
M reference/filesystem/functions/fread.xml
M reference/filesystem/functions/ftell..xml
M reference/filesystem/functions/ftruncate.xml
M reference/filesystem/functions/readfile.xml
M reference/filesystem/functions/readlink.xml
M reference/filesystem/functions/touch.xml
diff --git a/reference/exif/functions/exif-imagetype.xml b/reference/exif/functions/exif-imagetype.xml index 78e97839..cc16c509 100644 --- a/reference/exif/functions/exif-imagetype.xml +++ b/reference/exif/functions/exif-imagetype.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 02284193f1bbde106da56b7463c32d0511c46f8c Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/image.xml, last change in rev 1.81 --> <refentry xml:id="function.exif-imagetype" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -10,7 +10,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>exif_imagetype</methodname> + <type class="union"><type>int</type><type>false</type></type><methodname>exif_imagetype</methodname> <methodparam><type>string</type><parameter>dosya</parameter></methodparam> </methodsynopsis> <para> @@ -47,6 +47,15 @@ takdirde &false; döner. Dönüş değeri <function>getimagesize</function> ile aynıdır fakat <function>exif_imagetype</function> daha hızlıdır. </para> + <note> + <para> + Resim türünü belirlemek için dosyadan yeterince bayt okuyamazsa + <function>exif_imagetype</function> bir <constant>E_NOTICE</constant> + çıktılar ve &false; değeriyle döner. + <!-- If the function finds an incomplete PNG header then it may emit an + <constant>E_WARNING</constant> instead. - Is this worth including? --> + </para> + </note> </refsect1> <refsect1 role="changelog"> &reftitle.changelog; @@ -61,17 +70,11 @@ </thead> <tbody> <row> - <entry>4.3.2</entry> + <entry>7.1.0</entry> <entry> - <acronym>JPC</acronym>, <acronym>JP2</acronym>, - <acronym>JPX</acronym>, <acronym>JB2</acronym>, - <acronym>XBM</acronym> ve <acronym>WBMP</acronym> desteği eklendi. + WebP desteği eklendi. </entry> </row> - <row> - <entry>4.3.0</entry> - <entry><acronym>SWC</acronym> desteği eklendi.</entry> - </row> </tbody> </tgroup> </informaltable> @@ -159,6 +162,14 @@ <entry>16</entry> <entry><constant>IMAGETYPE_XBM</constant></entry> </row> + <row> + <entry>17</entry> + <entry><constant>IMAGETYPE_ICO</constant></entry> + </row> + <row> + <entry>18</entry> + <entry><constant>IMAGETYPE_WEBP</constant></entry> + </row> </tbody> </tgroup> </table> @@ -185,6 +196,7 @@ if (exif_imagetype('image.gif') != IMAGETYPE_GIF) { &reftitle.seealso; <para> <simplelist> + <member><function>image_type_to_mime_type</function></member> <member><function>getimagesize</function></member> </simplelist> </para> diff --git a/reference/exif/functions/exif-tagname.xml b/reference/exif/functions/exif-tagname.xml index 82257301..1c5918ea 100644 --- a/reference/exif/functions/exif-tagname.xml +++ b/reference/exif/functions/exif-tagname.xml @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> -<refentry xml:id="function.exif-tagname" xmlns="http://docbook.org/ns/docbook"> +<!-- EN-Revision: 02284193f1bbde106da56b7463c32d0511c46f8c Maintainer: nilgun Status: ready --> +<refentry xml:id="function.exif-tagname" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>exif_tagname</refname> <refpurpose>Bir indis için başlık ismini döndürür</refpurpose> @@ -9,12 +9,10 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>exif_tagname</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>exif_tagname</methodname> <methodparam><type>int</type><parameter>indis</parameter></methodparam> </methodsynopsis> - &warn.undocumented.func; - </refsect1> <refsect1 role="parameters"> &reftitle.parameters; @@ -24,7 +22,7 @@ <term><parameter>indis</parameter></term> <listitem> <para> - Resim indisi. + Bir Etiket Adının aranacağı Etiket Kimliği. </para> </listitem> </varlistentry> @@ -34,15 +32,40 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - <parameter>indis</parameter> tanımsızsa &false;, aksi takdirde başlık ismi - döner. + <parameter>indis</parameter> tanımlı bir Etiket Kimliği değilse &false;, + aksi takdirde başlık ismi döner. </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>- <function>exif_tagname</function> örneği</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo "256: ".exif_tagname(256).PHP_EOL; +echo "257: ".exif_tagname(257).PHP_EOL; +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +256: ImageWidth +257: ImageLength +]]> + </screen> + </example> + </para> + </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>exif_imagetype</function></member> + <member><link xlink:href="&url.exifspec;">EXIF Belirtimi</link></member> + <member><link xlink:href="&url.exiftags;">EXIF Etiketleri</link></member> </simplelist> </para> </refsect1> diff --git a/reference/exif/functions/exif-thumbnail.xml b/reference/exif/functions/exif-thumbnail.xml index 996a0d39..0f15bdea 100644 --- a/reference/exif/functions/exif-thumbnail.xml +++ b/reference/exif/functions/exif-thumbnail.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 417d45ec40e3c9dc4e6ca9cc3a0537925e58d77d Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/image.xml, last change in rev 1.78 --> <refentry xml:id="function.exif-thumbnail" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -10,15 +10,15 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>exif_thumbnail</methodname> - <methodparam><type>string</type><parameter>dosya</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter role="reference">genişlik</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter role="reference">yükseklik</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter role="reference">resim_türü</parameter></methodparam> + <type class="union"><type>string</type><type>false</type></type><methodname>exif_thumbnail</methodname> + <methodparam><type class="union"><type>resource</type><type>string</type></type><parameter>dosya</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">genişlik</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">yükseklik</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">resim_türü</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> - <function>exif_thumbnail</function> işlevi bir <acronym>TIFF</acronym> veya - <acronym>JPEG</acronym> resminin içinde gömülü küçük örneği döndürür. + <function>exif_thumbnail</function> işlevi bir resmin içinde gömülü küçük + örneği döndürür. </para> <para> Resimlerin küçük örneklerini bu işlev ile göndermek isterseniz MIME türü @@ -40,8 +40,8 @@ <term><parameter>dosya</parameter></term> <listitem> <para> - Okunacak resim dosyasının ismi Bu resmin içinde küçük bir örneği gömülü - olmalıdır. + Okunacak resim dosyasının yeri. Bu bir dosya yolu veya + <type>resource</type> türünde bir akım olmalıdır. </para> </listitem> </varlistentry> @@ -80,6 +80,30 @@ döndürür. </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>- <function>exif_thumbnail</function> örneği</title> + <programlisting role="php"> +<![CDATA[ +<?php +$resim = exif_thumbnail('/bir/yol/resim.jpg', $gen, $yks, $tür); + +if ($resim!==false) { + header('Content-type: ' .image_type_to_mime_type($tür)); + echo $resim; + exit; +} else { + // Resmin örneği yoksa, hataları burada ele alacağız + echo 'Resmin içinde küçük bir örneği yok'; +} +?> +]]> + </programlisting> + </example> + </para> + </refsect1> <refsect1 role="changelog"> &reftitle.changelog; <para> @@ -93,17 +117,10 @@ </thead> <tbody> <row> - <entry>4.3.0</entry> - <entry> - Belirtilmesi isteğe bağlı <parameter>genişlik</parameter>, - <parameter>yükseklik</parameter>ve <parameter>resim_türü</parameter> - değiştirgeleri eklendi. - </entry> - </row> - <row> - <entry>4.3.0</entry> + <entry>7.2.0</entry> <entry> - <acronym>TIFF</acronym> biçemli resim örnekleri döndürülebilir oldu. + <parameter>dosya</parameter> değiştirgesi artık yerel dosyalardan + başka akım özkaynaklarını da destekliyor. </entry> </row> </tbody> @@ -111,32 +128,15 @@ </informaltable> </para> </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title>- <function>exif_thumbnail</function> örneği</title> - <programlisting role="php"> -<![CDATA[ -<?php -if (array_key_exists('file', $_REQUEST)) { - $image = exif_thumbnail($_REQUEST['file'], $width, $height, $type); -} else { - $image = false; -} -if ($image!==false) { - header('Content-type: ' .image_type_to_mime_type($type)); - echo $image; - exit; -} else { - // Resmin örneği yoksa, hataları burada ele alacağız - echo 'Resmin içinde küçük bir örneği yok'; -} -?> -]]> - </programlisting> - </example> - </para> + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + <parameter>dosya</parameter> bu işeve bir akım aktarmak için kullanılırsa + akım aranabilir olmalıdır. İşlev döndükten sonra dosya tanıtıcısının + konumu değişmeyecektir. + </para> + </note> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; diff --git a/reference/exif/functions/read-exif-data.xml b/reference/exif/functions/read-exif-data.xml index e259c21c..e8bd0df1 100644 --- a/reference/exif/functions/read-exif-data.xml +++ b/reference/exif/functions/read-exif-data.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 227c9c797eb2ea920aa9b3fb8d46ef3ecec860ae Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/image.xml, last change in rev 1.78 --> <refentry xml:id="function.read-exif-data" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -9,12 +9,40 @@ </refpurpose> </refnamediv> + <refsynopsisdiv> + &warn.deprecated.alias-7-2-0.removed-8-0-0; + </refsynopsisdiv> + <refsect1 role="description"> &reftitle.description; <simpara> Bu işlev <function>exif_read_data</function> işlevinin takma adıdır. </simpara> </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 takma adın kullanımı artık önerilmiyor. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> </refentry> <!-- Keep this comment at the end of the file diff --git a/reference/fileinfo/functions/finfo-buffer.xml b/reference/fileinfo/functions/finfo-buffer.xml index c71a6291..b000bae5 100644 --- a/reference/fileinfo/functions/finfo-buffer.xml +++ b/reference/fileinfo/functions/finfo-buffer.xml @@ -1,30 +1,30 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 968bb98efdcc2a333899be3d1bdefec317d09170 Maintainer: nilgun Status: ready --> <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. --> <refentry xml:id="function.finfo-buffer" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>finfo_buffer</refname> + <refname>finfo::buffer</refname> <refpurpose>Bir dizge tamponu hakkında bilgi döndürür</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>finfo_buffer</methodname> + <para>&style.procedural;</para> + <methodsynopsis role="procedural"> + <type class="union"><type>string</type><type>false</type></type><methodname>finfo_buffer</methodname> <methodparam><type>resource</type><parameter>özkaynak</parameter></methodparam> - <methodparam><type>string</type><parameter>dizge</parameter><initializer>NULL</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer>FILEINFO_NONE</initializer></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>bağlam</parameter><initializer>NULL</initializer></methodparam> + <methodparam><type>string</type><parameter>string</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>FILEINFO_NONE</constant></initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>context</parameter><initializer>&null;</initializer></methodparam> + </methodsynopsis> + <para>&style.oop;</para> + <methodsynopsis role="oop"> + <modifier>public</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>finfo::buffer</methodname> + <methodparam><type>string</type><parameter>string</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>FILEINFO_NONE</constant></initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>context</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> - <classsynopsis> - <ooclass><classname>finfo</classname></ooclass> - <methodsynopsis> - <type>string</type><methodname>buffer</methodname> - <methodparam><type>string</type><parameter>dizge</parameter><initializer>NULL</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer>FILEINFO_NONE</initializer></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>bağlam</parameter><initializer>NULL</initializer></methodparam> - </methodsynopsis> - </classsynopsis> <para> Bu işlev bir dizge içindeki ikil veri hakkında bilgi edinmek için @@ -46,7 +46,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>dizge</parameter></term> + <term><parameter>string</parameter></term> <listitem> <para> İçeriği incelenecek dizge. @@ -54,7 +54,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>seçenekler</parameter></term> + <term><parameter>flags</parameter></term> <listitem> <para> <link linkend="fileinfo.constants">Fileinfo sabitleri</link>nden biri @@ -63,10 +63,10 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>bağlam</parameter></term> + <term><parameter>context</parameter></term> <listitem> <para> - Bağlamlar hakkında bilgi edinmek için <xref linkend="ref.stream"/> + Akımlar hakkında bilgi edinmek için <xref linkend="ref.stream"/> bölümüne bakınız. </para> </listitem> @@ -82,6 +82,28 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>context</parameter> artık &null; olabiliyor. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> diff --git a/reference/fileinfo/functions/finfo-close.xml b/reference/fileinfo/functions/finfo-close.xml index 2faa721c..8daffdb6 100644 --- a/reference/fileinfo/functions/finfo-close.xml +++ b/reference/fileinfo/functions/finfo-close.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 9ad9b79675b4006a819ec25d781922ed5472a94f Maintainer: nilgun Status: ready --> <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. --> <refentry xml:id="function.finfo-close" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -9,17 +9,10 @@ </refnamediv> <refsect1 role="description"> &reftitle.description; - <methodsynopsis> + <methodsynopsis role="procedural"> <type>bool</type><methodname>finfo_close</methodname> <methodparam><type>resource</type><parameter>özkaynak</parameter></methodparam> </methodsynopsis> - <classsynopsis> - <ooclass><classname>finfo</classname></ooclass> - <destructorsynopsis> - <methodname>__destruct</methodname> - <void/> - </destructorsynopsis> - </classsynopsis> <para> Bu işlev, <function>finfo_open</function> tarafından açılmış özkaynağı diff --git a/reference/fileinfo/functions/finfo-file.xml b/reference/fileinfo/functions/finfo-file.xml index 3142e206..489c16d5 100644 --- a/reference/fileinfo/functions/finfo-file.xml +++ b/reference/fileinfo/functions/finfo-file.xml @@ -1,30 +1,30 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 968bb98efdcc2a333899be3d1bdefec317d09170 Maintainer: nilgun Status: ready --> <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. --> <refentry xml:id="function.finfo-file" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>finfo_file</refname> + <refname>finfo::file</refname> <refpurpose>Bir dosya hakkında bilgi döndürür</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>finfo_file</methodname> + <para>&style.procedural;</para> + <methodsynopsis role="procedural"> + <type class="union"><type>string</type><type>false</type></type><methodname>finfo_file</methodname> <methodparam><type>resource</type><parameter>özkaynak</parameter></methodparam> - <methodparam><type>string</type><parameter>dosya_ismi</parameter><initializer>NULL</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer>FILEINFO_NONE</initializer></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>bağlam</parameter><initializer>NULL</initializer></methodparam> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>FILEINFO_NONE</constant></initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>context</parameter><initializer>&null;</initializer></methodparam> + </methodsynopsis> + <para>&style.oop;</para> + <methodsynopsis role="oop"> + <modifier>public</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>finfo::file</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>FILEINFO_NONE</constant></initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>context</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> - <classsynopsis> - <ooclass><classname>finfo</classname></ooclass> - <methodsynopsis> - <type>string</type><methodname>file</methodname> - <methodparam><type>string</type><parameter>dosya_ismi</parameter><initializer>NULL</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer>FILEINFO_NONE</initializer></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>bağlam</parameter><initializer>NULL</initializer></methodparam> - </methodsynopsis> - </classsynopsis> <para> Bu işlev bir dosya hakkında bilgi edinmek için kullanılır. @@ -45,7 +45,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>dosya_ismi</parameter></term> + <term><parameter>filename</parameter></term> <listitem> <para> Hakkında bilgi istenen dosya. @@ -53,7 +53,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>seçenekler</parameter></term> + <term><parameter>flags</parameter></term> <listitem> <para> <link linkend="fileinfo.constants">Fileinfo sabitleri</link>nden biri @@ -62,10 +62,10 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>bağlam</parameter></term> + <term><parameter>context</parameter></term> <listitem> <para> - Bağlamlar hakkında bilgi edinmek için <xref linkend="ref.stream"/> + Akımlar hakkında bilgi edinmek için <xref linkend="ref.stream"/> bölümüne bakınız. </para> </listitem> @@ -80,6 +80,28 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>context</parameter> artık &null; olabiliyor. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> diff --git a/reference/fileinfo/functions/finfo-open.xml b/reference/fileinfo/functions/finfo-open.xml index 8df1666a..47780e67 100644 --- a/reference/fileinfo/functions/finfo-open.xml +++ b/reference/fileinfo/functions/finfo-open.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 968bb98efdcc2a333899be3d1bdefec317d09170 Maintainer: nilgun Status: ready --> <refentry xml:id="function.finfo-open" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>finfo_open</refname> @@ -10,21 +10,18 @@ <refsect1 role="description"> &reftitle.description; - <para>Yordamsal kullanım</para> - <methodsynopsis> - <type>resource</type><methodname>finfo_open</methodname> - <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer>FILEINFO_NONE</initializer></methodparam> - <methodparam choice="opt"><type>string</type><parameter>sihir_dosyası</parameter><initializer>NULL</initializer></methodparam> + <para>&style.procedural;</para> + <methodsynopsis role="procedural"> + <type class="union"><type>resource</type><type>false</type></type><methodname>finfo_open</methodname> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>FILEINFO_NONE</constant></initializer></methodparam> + <methodparam choice="opt"><type>string</type><parameter>magic_database</parameter><initializer>""</initializer></methodparam> </methodsynopsis> - <para>Nesne yönelimli kullanım (kurucu):</para> - <classsynopsis> - <ooclass><classname>finfo</classname></ooclass> - <constructorsynopsis> - <methodname>__construct</methodname> - <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer>FILEINFO_NONE</initializer></methodparam> - <methodparam choice="opt"><type>string</type><parameter>sihirli_dosya</parameter><initializer>NULL</initializer></methodparam> - </constructorsynopsis> - </classsynopsis> + <para>&style.oop; (kurucu):</para> + <constructorsynopsis role="oop"> + <modifier>public</modifier> <methodname>finfo::__construct</methodname> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>FILEINFO_NONE</constant></initializer></methodparam> + <methodparam choice="opt"><type>string</type><parameter>magic_database</parameter><initializer>""</initializer></methodparam> + </constructorsynopsis> <para> Bu işlev bir sihir veritabanı açar ve özkaynağını döndürür. </para> @@ -35,7 +32,7 @@ <para> <variablelist> <varlistentry> - <term><parameter>seçenekler</parameter></term> + <term><parameter>flags</parameter></term> <listitem> <para> <link linkend="fileinfo.constants">Fileinfo sabitleri</link>nden biri @@ -44,11 +41,19 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>sihir_dosyası</parameter></term> + <term><parameter>magic_database</parameter></term> <listitem> <para> - Sihir veritabanının dosya ismi genellikle <filename>/bir/yol/magic.mime</filename> şeklindedir. Belirtilmezse <literal>MAGIC</literal> ortam değişkeninin değeri kullanılır. Bu değişken de atanmamışsa <filename>/usr/share/misc/magic</filename> dosyası öntanımlıdır. Gerek görülürse dosya uzantısı olarak <literal>.mime</literal> ve/veya <literal>.mgc</literal> kullanılabilir. + Sihir veritabanının dosya ismi genellikle + <filename>/bir/yol/magic.mime</filename> şeklindedir. Belirtilmezse + <literal>MAGIC</literal> ortam değişkeninin değeri kullanılır. Bu + değişken de atanmamışsa PHP paketinde gelen sihir veritabanı + kullanılır. </para> + <para> + &null; veya boş bir dizge atanması öntanımlı değerin kullanımına + eşdeğer olacaktır. + </para> </listitem> </varlistentry> </variablelist> @@ -58,11 +63,33 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Başarısızlık durumunda &false;, aksi takdirde sihir veritabanı özkaynağı - ile döner. + (Sadece yordamsal kullanımda) + Başarı durumunda sihir veritabanı özkaynağı,&return.falseforfailure;. </para> </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <warning> + <para> + Beklenen sihir veritabanı biçimi PHP 5.3.11 ve 5.4.1'de değişti. Bu + nedenle, dahili sihir veritabanı yükseltildi. Bu, çoğunlukla harici bir + sihir veritabanının kullanıldığı yerlerde kodu etkiler: daha eski bir + sihir dosyasının okunması artık başarısız olacaktır. Ayrıca, mime + türlerinin bazı metinsel gösterimleri de değişti, örneğin PHP için "PHP + script text" yerine "PHP script, ASCII text" metni dönüyor. + </para> + </warning> + <note> + <para> + Genellikle, (<parameter>magic_database</parameter> belirtmeyerek ve + <literal>MAGIC</literal> ortam değişkenini atanmayarak) PHP paketinde + gelen sihir veritabanını kullanmak, özellikle özel bir sihir veritabanına + ihtiyaç olmadıkça en iyi seçim olacaktır. + </para> + </note> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <example> @@ -73,11 +100,6 @@ // Bir açıklama değil MIME türü dönsün $finfo = new finfo(FILEINFO_MIME, "/usr/share/misc/magic"); -if (!$finfo) { - echo "Fileinfo veritabanı açılamadı"; - exit(); -} - /* Bir dosyanın MIME türünü öğrenelim */ $dosya = "/usr/local/birdosya.txt"; echo $finfo->file($dosya); diff --git a/reference/fileinfo/functions/finfo-set-flags.xml b/reference/fileinfo/functions/finfo-set-flags.xml index 9f36d3c2..1d074855 100644 --- a/reference/fileinfo/functions/finfo-set-flags.xml +++ b/reference/fileinfo/functions/finfo-set-flags.xml @@ -1,26 +1,26 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 968bb98efdcc2a333899be3d1bdefec317d09170 Maintainer: nilgun Status: ready --> <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. --> <refentry xml:id="function.finfo-set-flags" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>finfo_set_flags</refname> + <refname>finfo::set_flags</refname> <refpurpose>Libmagic yapılandırma seçeneklerini ayarlar</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; - <methodsynopsis> + <para>&style.procedural;</para> + <methodsynopsis role="procedural"> <type>bool</type><methodname>finfo_set_flags</methodname> <methodparam><type>resource</type><parameter>özkaynak</parameter></methodparam> - <methodparam><type>int</type><parameter>seçenekler</parameter></methodparam> + <methodparam><type>int</type><parameter>flags</parameter></methodparam> + </methodsynopsis> + <para>&style.oop;</para> + <methodsynopsis role="oop"> + <modifier>public</modifier> <type>bool</type><methodname>finfo::set_flags</methodname> + <methodparam><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> - <classsynopsis> - <ooclass><classname>finfo</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>set_flags</methodname> - <methodparam><type>int</type><parameter>seçenekler</parameter></methodparam> - </methodsynopsis> - </classsynopsis> <para> Bu işlevle çeşitli Fileinfo seçenekleri ayarlanır. Bu seçenekler ayrıca, @@ -42,7 +42,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>seçenekler</parameter></term> + <term><parameter>flags</parameter></term> <listitem> <para> <link linkend="fileinfo.constants">Fileinfo sabitleri</link>nden biri diff --git a/reference/filesystem/functions/basename.xml b/reference/filesystem/functions/basename.xml index 2559cd02..ca5e76e7 100644 --- a/reference/filesystem/functions/basename.xml +++ b/reference/filesystem/functions/basename.xml @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 88c1f8d6c9fecf352c5ce152a6f758ed013fc2c0 Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.basename"> <refnamediv> <refname>basename</refname> - <refpurpose>Dosya yolunun dosya ismi bileşenini döndürür</refpurpose> + <refpurpose>Dosya yolunun ucundaki dosya ismi bileşenini döndürür</refpurpose> </refnamediv> <refsect1 role="description"> @@ -12,11 +12,29 @@ <methodsynopsis> <type>string</type><methodname>basename</methodname> <methodparam><type>string</type><parameter>yol</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>uzantı</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>uzantı</parameter><initializer>""</initializer></methodparam> </methodsynopsis> <para> - Belirtilen dosya yolunun dosya ismi bileşenini döndürür. + Belirtilen dosya yolunun ucundaki dosya ismi bileşenini döndürür. </para> + <note> + <para> + <function>basename</function> safça girdi dizgesi üzerinde çalışır, + dosya sisteminden ve "<literal>..</literal>" gibi yol bileşenlerinden + haberi yoktur. + </para> + </note> + <caution> + <para> + <function>basename</function> yereli de bilmez, bundan dolayı çok baytlı + karakterler içeren dosya yollarından doğru bileşeni ayırabilmesi için + eşleşen yerelin <function>setlocale</function> işlevi kullanılarak + atanması gerekir. + Eğer <parameter>yol</parameter> geçerli yerel için geçersiz olan + karakterler içeriyorsa <function>basename</function> işlevinin davranışı + belirsizdir. + </para> + </caution> </refsect1> <refsect1 role="parameters"> @@ -40,7 +58,8 @@ <term><parameter>uzantı</parameter></term> <listitem> <para> - Dönen bileşenden kaldırılacak dosya uzantısı. + Dosya ismi <parameter>uzantı</parameter> içinde devam ediyorsa uzantı + ile birlikte bu da kesilir. </para> </listitem> </varlistentry> @@ -55,30 +74,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>4.1.0</entry> - <entry> - <parameter>uzantı</parameter> değiştirgesi eklendi. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="examples"> &reftitle.examples; <para> @@ -87,12 +82,26 @@ <programlisting role="php"> <![CDATA[ <?php -$yol = "/home/httpd/html/index.php"; -$dosya = basename($yol); // $dosya => "index.php" -$dosya = basename($yol, ".php"); // $dosya => "index" +echo "1) ".basename("/etc/sudoers.d", ".d").PHP_EOL; +echo "2) ".basename("/etc/sudoers.d").PHP_EOL; +echo "3) ".basename("/etc/passwd").PHP_EOL; +echo "4) ".basename("/etc/").PHP_EOL; +echo "5) ".basename(".").PHP_EOL; +echo "6) ".basename("/"); ?> ]]> </programlisting> + &example.outputs; + <screen> +<![CDATA[ +1) sudoers +2) sudoers.d +3) passwd +4) etc +5) . +6) +]]> + </screen> </example> </para> </refsect1> diff --git a/reference/filesystem/functions/copy.xml b/reference/filesystem/functions/copy.xml index 48d32991..56da847b 100644 --- a/reference/filesystem/functions/copy.xml +++ b/reference/filesystem/functions/copy.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 7f569e1f175adf1fbd0e462eba8d6bc82214c939 Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.copy"> <refnamediv> <refname>copy</refname> @@ -70,38 +70,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.3.0</entry> - <entry> - Bağlam desteği eklendi. - </entry> - </row> - <row> - <entry>4.3.0</entry> - <entry> - Eğer fopen sarmalayıcıları etkinse, hem <parameter>kaynak</parameter> - hem de <parameter>hedef</parameter> artık URL olabilmektedir. - Ayrıntılar için <function>fopen</function> işlevine bakınız. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="examples"> &reftitle.examples; <para> diff --git a/reference/filesystem/functions/delete.xml b/reference/filesystem/functions/delete.xml index 8cfa928b..e720afc9 100644 --- a/reference/filesystem/functions/delete.xml +++ b/reference/filesystem/functions/delete.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 9514f50e8909210419382868c321703037375191 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 9e64a0aefae20767685c024d7e20f27823b13621 Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.delete" role="noversion"> <refnamediv> <refname>delete</refname> @@ -11,8 +11,10 @@ <refsect1 role="description"> &reftitle.description; <para> - <function>unlink</function> veya <function>unset</function> işlevlerini - yanlış yerde arayanlar için yol gösterici bir sayfadır. + PHP dilinde "delete" ne bir anahtar sözcük ne de bir işlev ismidir. Bir + dosyayı silmek istiyorsanız, <function>unlink</function> işlevini deneyin. + Yerel etki alanındaki bir değişkeni silmek için <function>unset</function> + işlevine bakın. </para> </refsect1> diff --git a/reference/filesystem/functions/disk-total-space.xml b/reference/filesystem/functions/disk-total-space.xml index 905f7a19..f5ee5ec4 100644 --- a/reference/filesystem/functions/disk-total-space.xml +++ b/reference/filesystem/functions/disk-total-space.xml @@ -1,16 +1,16 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 3ce9368539aaacb6eba5c5049209f271ebf16e39 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.disk-total-space"> <refnamediv> <refname>disk_total_space</refname> - <refpurpose>Bir dizinin toplam boyunu döndürür</refpurpose> + <refpurpose>Bir disk bölümünün veya dosya sisteminin toplam boyutunu döndürür</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>float</type><methodname>disk_total_space</methodname> + <type class="union"><type>float</type><type>false</type></type><methodname>disk_total_space</methodname> <methodparam><type>string</type><parameter>dizin</parameter></methodparam> </methodsynopsis> <para> @@ -55,8 +55,8 @@ $df = disk_total_space("/"); // Windows üzerinde: -disk_total_space("C:"); -disk_total_space("D:"); +$df = disk_total_space("C:"); +$df = disk_total_space("D:"); ?> ]]> </programlisting> diff --git a/reference/filesystem/functions/feof.xml b/reference/filesystem/functions/feof.xml index 9f2d7d67..4a7316f3 100644 --- a/reference/filesystem/functions/feof.xml +++ b/reference/filesystem/functions/feof.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.feof"> <refnamediv> <refname>feof</refname> @@ -55,7 +55,7 @@ <warning> <para> Eğer belirtilen dosya tanıtıcısı geçersizse <function>feof</function> - başarısız olup &true; döndürceğinden sonsuz bir döngü oluşabilir. + başarısız olup &true; döndüreceğinden sonsuz bir döngü oluşabilir. </para> <example> <title>- Geçersiz dosya tanıtıcılı <function>feof</function> örneği diff --git a/reference/filesystem/functions/fgetss.xml b/reference/filesystem/functions/fgetss.xml index 12364c66..f3ad8e4e 100644 --- a/reference/filesystem/functions/fgetss.xml +++ b/reference/filesystem/functions/fgetss.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: nilgun Status: ready --> +<!-- EN-Revision: cb3e68d99d80a70feafc6f9a1b5f678e4d0522af Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fgetss"> <refnamediv> <refname>fgetss</refname> @@ -8,6 +8,10 @@ döndürür</refpurpose> </refnamediv> + <refsynopsisdiv> + &warn.deprecated.function-7-3-0.removed-8-0-0; + </refsynopsisdiv> + <refsect1 role="description"> &reftitle.description; <methodsynopsis> @@ -17,8 +21,11 @@ <methodparam choice="opt"><type>string</type><parameter>etiketler</parameter></methodparam> </methodsynopsis> <para> - Okunan metinden HTML ve PHP etiketlerini temizlemesi dışında - <function>fgets</function> işlevi ile aynıdır. + Okunan metinden &null; baytları, HTML ve PHP etiketlerini temizlemesi + dışında <function>fgets</function> işlevi ile aynıdır. İşlev, çağrıdan + çağrıya ayrıştırma durumunu korur, bu nedenle, + <function>fgets</function> dönüş değeriyle <function>strip_tags</function> + işlevin çağırmaya eşdeğer değildir. </para> </refsect1> @@ -45,7 +52,9 @@ <listitem> <para> Hangi etiketlerin ayıklanacağını bu isteğe bağlı değiştirge ile - belirtebilirsiniz. + belirtebilirsiniz. Ayrıntılar için <function>strip_tags</function> + işlevinin <parameter>ayıklanmayacaklar</parameter> değiştirgesinin + açıklamasına bakınız. </para> </listitem> </varlistentry> @@ -65,37 +74,8 @@ </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.0.0</entry> - <entry> - <parameter>uzunluk</parameter> değiştirgesi isteğe bağlı oldu. - </entry> - </row> - <row> - <entry>4.0.0</entry> - <entry> - <parameter>etiketler</parameter> değiştirgesi eklendi. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title>- Bir PHP dosyasının satır satır okunması</title> @@ -147,6 +127,8 @@ Text outside of the HTML block. <member><function>popen</function></member> <member><function>fsockopen</function></member> <member><function>strip_tags</function></member> + <member><methodname>SplFileObject::fgetss</methodname></member> + <member>The <link linkend="filters.string.strip_tags">string.strip_tags</link> süzgeci</member> </simplelist> </para> </refsect1> diff --git a/reference/filesystem/functions/file.xml b/reference/filesystem/functions/file.xml index 403e87cf..305b2207 100644 --- a/reference/filesystem/functions/file.xml +++ b/reference/filesystem/functions/file.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 --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.file"> <refnamediv> <refname>file</refname> @@ -63,7 +63,7 @@ </term> <listitem> <simpara> - Her dizi elemanının sonuna satırsonu karakteri eklenmez. + Dizi elemanlarının sonundaki satırsonu karakteri atlanır. </simpara> </listitem> </varlistentry> @@ -77,29 +77,6 @@ </simpara> </listitem> </varlistentry> - <varlistentry> - <term> - <constant>FILE_TEXT</constant> - </term> - <listitem> - <simpara> - İçerik UTF-8 kodlu döndürülür. Özel bir bağlam oluşturarark farklı - bir kodlama belirtebilirsiniz. Bu seçenek - <constant>FILE_BINARY</constant> ile birlikte kullanılamaz. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term> - <constant>FILE_BINARY</constant> - </term> - <listitem> - <simpara> - İçerik ikil veri olarak okunur. Bu öntanımlıdır ve - <constant>FILE_TEXT</constant> ile birlikte kullanılamaz. - </simpara> - </listitem> - </varlistentry> </variablelist> </para> </listitem> @@ -130,63 +107,17 @@ <note> <para> <constant>FILE_IGNORE_NEW_LINES</constant> sabiti kullanılmadığı sürece - dizinin her elemanı bir satırsonu karakteri içerecektir. Bu satırsonu - karakterlerinden kurtulmak isterseniz <function>rtrim</function> işlevini - kullanabilirsiniz. + dizinin her elemanı bir satırsonu karakteri içerecektir. </para> </note> ¬e.line-endings; </refsect1> <refsect1 role="changelog"> - &reftitle.changelog; + &reftitle.errors; <para> - <informaltable> - <tgroup cols="2"> - <thead> - <row> - <entry>&Version;</entry> - <entry>&Description;</entry> - </row> - </thead> - <tbody> - <row> - <entry>6.0.0</entry> - <entry> - <constant>FILE_TEXT</constant> ve <constant>FILE_BINARY</constant> - seçenekleri desteği eklendi. - <note> - <para> - <literal>İleriye uyumluluk</literal> adına, bu sabitler PHP 5.2.7'den - beri mevcuttur. - </para> - </note> - </entry> - </row> - <row> - <entry>5.0.0</entry> - <entry> - <parameter>bağlam</parameter> değiştirgesi eklendi. - </entry> - </row> - <row> - <entry>5.0.0</entry> - <entry> - PHP 5.0.0 öncesinde <parameter>seçenekler</parameter> değiştirgesi - sadece <link linkend="ini.include-path">include_path</link> - yönergesinde belirtilen yolları kapsardı ve daima 1 ile - etkinleştirilirdi. - </entry> - </row> - <row> - <entry>4.3.0</entry> - <entry> - <function>file</function> işlevi veriyi ikil kipte okur oldu. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> + Dosya mevcut değilse <constant>E_WARNING</constant> seviyesinde bir hata + çıktılanır. </para> </refsect1> diff --git a/reference/filesystem/functions/fileatime.xml b/reference/filesystem/functions/fileatime.xml index 4c7c0192..18c11d41 100644 --- a/reference/filesystem/functions/fileatime.xml +++ b/reference/filesystem/functions/fileatime.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fileatime"> <refnamediv> <refname>fileatime</refname> @@ -10,7 +10,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>fileatime</methodname> + <type class="union"><type>int</type><type>false</type></type><methodname>fileatime</methodname> <methodparam><type>string</type><parameter>dosyaismi</parameter></methodparam> </methodsynopsis> <simpara> @@ -65,6 +65,11 @@ if (file_exists($dosya)) { </para> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + &fs.emits.warning.on.failure; + </refsect1> + <refsect1 role="notes"> &reftitle.notes; <note> diff --git a/reference/filesystem/functions/filectime.xml b/reference/filesystem/functions/filectime.xml index f2eeee2e..e173788b 100644 --- a/reference/filesystem/functions/filectime.xml +++ b/reference/filesystem/functions/filectime.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.filectime"> <refnamediv> <refname>filectime</refname> @@ -11,7 +11,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>filectime</methodname> + <type class="union"><type>int</type><type>false</type></type><methodname>filectime</methodname> <methodparam><type>string</type><parameter>dosyaismi</parameter></methodparam> </methodsynopsis> <para> @@ -64,6 +64,11 @@ if (file_exists($dosya)) { </example> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + &fs.emits.warning.on.failure; + </refsect1> + <refsect1 role="notes"> &reftitle.notes; <note> diff --git a/reference/filesystem/functions/fileperms.xml b/reference/filesystem/functions/fileperms.xml index 8999fb1f..dafecabc 100644 --- a/reference/filesystem/functions/fileperms.xml +++ b/reference/filesystem/functions/fileperms.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 xmlns="http://docbook.org/ns/docbook" xml:id="function.fileperms"> <refnamediv> <refname>fileperms</refname> @@ -10,7 +10,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>fileperms</methodname> + <type class="union"><type>int</type><type>false</type></type><methodname>fileperms</methodname> <methodparam><type>string</type><parameter>dosyaismi</parameter></methodparam> </methodsynopsis> <para> @@ -37,7 +37,23 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Bir hata durumunda &false;, aksi takdirde dosyanın izinlerini döndürür. + Dosyanın izinlerini sayısal kip olarak döndürür. Bu kipin daha düşük + bitleri, <function>chmod</function> tarafından beklenen izinlerle aynıdır, + ancak çoğu platformda, dönüş değeri <parameter>dosyaismi</parameter> + olarak verilen dosya türü hakkında bilgi de içerir. Aşağıdaki örnekler, + Linux ve macOS dahil olmak üzere POSIX sistemlerinde belirli izinler ve + dosya türleri için dönüş değerinin nasıl sınanacağını göstermektedir. + </para> + <para> + Yerel dosyalara özgü dönüş değeri, C kütüphanesinin + <function>stat</function> işlevi tarafından döndürülen yapının + <literal>st_mode</literal> üyesinin değeridir. Tam olarak hangi bitlerin + atanacağı platformdan platforma değişebilir ve dönüş değerinin izin + verilmeyen bitlerinin ayrıştırılması gerekiyorsa özel platformunuzun + belgelerine bakmanız önerilir. + </para> + <para> + Başarısızlık durumunda &false; döner. </para> </refsect1> @@ -69,31 +85,31 @@ echo substr(sprintf('%o', fileperms('/etc/passwd')), -4); <?php $perms = fileperms('/etc/passwd'); -if (($perms & 0xC000) == 0xC000) { - // Soket - $info = 's'; -} elseif (($perms & 0xA000) == 0xA000) { - // Sembolik bağ - $info = 'l'; -} elseif (($perms & 0x8000) == 0x8000) { - // Sıradan dosya - $info = '-'; -} elseif (($perms & 0x6000) == 0x6000) { - // Blok aygıtı - $info = 'b'; -} elseif (($perms & 0x4000) == 0x4000) { - // Dizin - $info = 'd'; -} elseif (($perms & 0x2000) == 0x2000) { - // Karakter aygıtı - $info = 'c'; -} elseif (($perms & 0x1000) == 0x1000) { - // FIFO boru - $info = 'p'; -} else { - // Bilinmiyor - $info = 'u'; -} +switch ($perms & 0xF000) { + case 0xC000: // soket + $info = 's'; + break; + case 0xA000: // Sembolik bağ + $info = 'l'; + break; + case 0x8000: // Sıradan dosya + $info = 'r'; + break; + case 0x6000: // Blok aygıtı + $info = 'b'; + break; + case 0x4000: // Dizin + $info = 'd'; + break; + case 0x2000: // Karakter aygıtı + $info = 'c'; + break; + case 0x1000: // FIFO boru + $info = 'p'; + break; + default: // Bilinmiyor + $info = 'u'; + } // Kullanıcı $info .= (($perms & 0x0100) ? 'r' : '-'); @@ -136,6 +152,11 @@ echo $info; &tip.fopen-wrapper.stat; </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + &fs.emits.warning.on.failure; + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> diff --git a/reference/filesystem/functions/filetype.xml b/reference/filesystem/functions/filetype.xml index 2194917c..d269b0bd 100644 --- a/reference/filesystem/functions/filetype.xml +++ b/reference/filesystem/functions/filetype.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 xmlns="http://docbook.org/ns/docbook" xml:id="function.filetype"> <refnamediv> <refname>filetype</refname> @@ -10,7 +10,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>filetype</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>filetype</methodname> <methodparam><type>string</type><parameter>dosyaismi</parameter></methodparam> </methodsynopsis> <para> @@ -72,6 +72,11 @@ echo filetype('/etc/'); // dir &tip.fopen-wrapper.stat; </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + &fs.emits.warning.on.failure; + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> @@ -80,8 +85,9 @@ echo filetype('/etc/'); // dir <member><function>is_file</function></member> <member><function>is_link</function></member> <member><function>file_exists</function></member> - <member><function>stat</function></member> <member><function>mime_content_type</function></member> + <member><function>pathinfo</function></member> + <member><function>stat</function></member> </simplelist> </para> </refsect1> diff --git a/reference/filesystem/functions/fnmatch.xml b/reference/filesystem/functions/fnmatch.xml index ccc2895b..e2b6d2ec 100644 --- a/reference/filesystem/functions/fnmatch.xml +++ b/reference/filesystem/functions/fnmatch.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 605539d7711f94536e50a09d59b87eb36dceadf9 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fnmatch"> <refnamediv> <refname>fnmatch</refname> @@ -13,12 +13,12 @@ <methodsynopsis> <type>bool</type><methodname>fnmatch</methodname> <methodparam><type>string</type><parameter>kalıp</parameter></methodparam> - <methodparam><type>string</type><parameter>dizge</parameter></methodparam> + <methodparam><type>string</type><parameter>dosyaismi</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer>0</initializer></methodparam> </methodsynopsis> <para> <function>fnmatch</function> işlevi, belirtilen - <parameter>dizge</parameter>'nin belirtilen dosya kalıbı ile eşleşip + <parameter>dosyaismi</parameter>'nin belirtilen dosya kalıbı ile eşleşip eşleşmediğine bakar. </para> </refsect1> @@ -35,7 +35,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>dizge</parameter></term> + <term><parameter>dosyaismi</parameter></term> <listitem> <para> Sınanacak dizge. İşlev özellikle dosya isimleri için yararlı olsa da @@ -203,38 +203,17 @@ </para> </refsect1> - <refsect1 role="changelog"> - &reftitle.changelog; - <informaltable> - <tgroup cols="2"> - <thead> - <row> - <entry>&Version;</entry> - <entry>&Description;</entry> - </row> - </thead> - <tbody> - <row> - <entry>5.3.0</entry> - <entry> - İşlev Windows platformlarında da kullanılabilir oldu. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </refsect1> - <refsect1 role="examples"> &reftitle.examples; <para> <example> - <title>- Bir renk isminin bir kabuk dosya kalıbıyla eşleştirilmesi</title> + <title>- Bir renk isminin bir kabuk dosya kalıbıyla eşleştirilmesi + </title> <programlisting role="php"> <![CDATA[ <?php if (fnmatch("*gr[ae]y", $color)) { - echo "some form of gray ..."; + echo "grinin bir tonu ..."; } ?> ]]> @@ -247,7 +226,8 @@ if (fnmatch("*gr[ae]y", $color)) { &reftitle.notes; <warning> <para> - Bu işlev şimdilik POSIX uyumlu olmayan sistemlerde kullanılamamaktadır. + Bu işlev şimdilik POSIX uyumlu olmayan sistemlerde kullanılamamaktadır, + Windows hariç. </para> </warning> </refsect1> diff --git a/reference/filesystem/functions/fread.xml b/reference/filesystem/functions/fread.xml index 11c4f723..b4fd763a 100644 --- a/reference/filesystem/functions/fread.xml +++ b/reference/filesystem/functions/fread.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 xmlns="http://docbook.org/ns/docbook" xml:id="function.fread"> <refnamediv> <refname>fread</refname> @@ -10,7 +10,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>fread</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>fread</methodname> <methodparam><type>resource</type><parameter>dt</parameter></methodparam> <methodparam><type>int</type><parameter>uzunluk</parameter></methodparam> </methodsynopsis> @@ -32,12 +32,17 @@ </listitem> <listitem> <simpara> - Bir paket kullanılabilir hale gelince (ağ akımları için). + Bir paket kullanılabilir hale gelince veya + <link linkend="function.socket-set-timeout">soket zaman aşımı</link>na + uğrayınca (ağ akımları için). </simpara> </listitem> <listitem> <simpara> - 8192 bayt okununca (akım kullanıcı alanında açıldıktan sonra). + Eğer akım arabelleğe alınmışsa ve düz bir dosyaya ait değilse, en fazla + yığıt boyutuna (genellikle 8192) eşit sayıda bayta kadar bir okuma + yapılır; önceden arabelleğe alınan verilere bağlı olarak, döndürülen + verilerin boyutu yığıt boyutundan daha büyük olabilir. </simpara> </listitem> </itemizedlist> @@ -129,7 +134,6 @@ fclose($dt); <programlisting role="php"> <![CDATA[ <?php -// PHP 5 ve sonrası için $dt = fopen("http://www.example.com/", "rb"); $içerik = stream_get_contents($dt); fclose($dt); @@ -140,9 +144,14 @@ fclose($dt); <![CDATA[ <?php $dt = fopen("http://www.example.com/", "rb"); +if (FALSE === $dt) { + exit("URL'ye akım açılamadı"); +} + $içerik = ''; + while (!feof($dt)) { - $içerik .= fread($dt, 8192); + $içerik .= fread($dt, 8192); } fclose($dt); ?> @@ -186,6 +195,7 @@ fclose($dt); <member><function>fpassthru</function></member> <member><function>ftell</function></member> <member><function>rewind</function></member> + <member><function>unpack</function></member> </simplelist> </para> </refsect1> diff --git a/reference/filesystem/functions/ftell.xml b/reference/filesystem/functions/ftell.xml index 81182779..e670ea26 100644 --- a/reference/filesystem/functions/ftell.xml +++ b/reference/filesystem/functions/ftell.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 xmlns="http://docbook.org/ns/docbook" xml:id="function.ftell"> <refnamediv> <refname>ftell</refname> @@ -11,7 +11,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>ftell</methodname> + <type class="union"><type>int</type><type>false</type></type><methodname>ftell</methodname> <methodparam><type>resource</type><parameter>dt</parameter></methodparam> </methodsynopsis> <para> @@ -48,6 +48,7 @@ <para> Bir hata oluşursa &false; döner. </para> + &fs.file.32bit; </refsect1> <refsect1 role="examples"> diff --git a/reference/filesystem/functions/ftruncate.xml b/reference/filesystem/functions/ftruncate.xml index ff1524b0..bcb59278 100644 --- a/reference/filesystem/functions/ftruncate.xml +++ b/reference/filesystem/functions/ftruncate.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 --> <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.14 --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ftruncate"> <refnamediv> @@ -67,31 +67,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>PHP 4.3.3</entry> - <entry> - <function>ftruncate</function> işlevi bu sürümün öncesinde başarı - durumunda mantıksal &true; yerine tamsayı 1 döndürürdü. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="examples"> &reftitle.examples; <para> diff --git a/reference/filesystem/functions/readfile.xml b/reference/filesystem/functions/readfile.xml index 9f9fb17a..b2424260 100644 --- a/reference/filesystem/functions/readfile.xml +++ b/reference/filesystem/functions/readfile.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: nilgun Status: ready --> +<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readfile"> <refnamediv> <refname>readfile</refname> @@ -10,9 +10,9 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>readfile</methodname> + <type class="union"><type>int</type><type>false</type></type><methodname>readfile</methodname> <methodparam><type>string</type><parameter>dosyaismi</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>include_path_kullan</parameter><initializer>false</initializer></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>include_path_kullan</parameter><initializer>&false;</initializer></methodparam> <methodparam choice="opt"><type>resource</type><parameter>bağlan</parameter></methodparam> </methodsynopsis> <para> @@ -57,17 +57,21 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Bir hata oluşmuşsa &false; döner ve işlev @<function>readfile</function> - şeklinde çağrılmamışsa bir hata iletisi basılır. Herşey yolunda gitmişse - dosyadan okunan baytların sayısını döndürür. + Herşey yolunda gitmişse dosyadan okunan baytların + sayısı,&return.falseforfailure;. </para> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + &fs.emits.warning.on.failure; + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> <example> - <title><function>readfile</function> kullanarak dosya indirmeyi zorlamak + <title>- <function>readfile</function> kullanarak dosya indirmeyi zorlamak </title> <programlisting role="php"> <![CDATA[ @@ -77,14 +81,11 @@ $file = 'monkey.gif'; if (file_exists($file)) { header('Content-Description: File Transfer'); header('Content-Type: application/octet-stream'); - header('Content-Disposition: attachment; filename='.basename($file)); - header('Content-Transfer-Encoding: binary'); + header('Content-Disposition: attachment; filename="'.basename($file).'"'); header('Expires: 0'); - header('Cache-Control: must-revalidate, post-check=0, pre-check=0'); + header('Cache-Control: must-revalidate'); header('Pragma: public'); header('Content-Length: ' . filesize($file)); - ob_clean(); - flush(); readfile($file); exit; } @@ -93,6 +94,7 @@ if (file_exists($file)) { </programlisting> &example.outputs.similar; <mediaobject> + <alt>Aç / Kaydet penceresi</alt> <imageobject> <imagedata fileref="en/reference/filesystem/figures/readfile.png"/> </imageobject> @@ -103,7 +105,14 @@ if (file_exists($file)) { <refsect1 role="notes"> &reftitle.notes; - + <note> + <para> + <function>readfile</function> kendi başına büyük dosyalar gönderirken + bile herhangi bir bellek sorunu ortaya çıkmaz. Yetersiz bellek hatasıyla + karşılaşırsanız, <function>ob_get_level</function> kullanarak çıktı + tamponlamasının kapalı olduğundan emin olun. + </para> + </note> &tip.fopen-wrapper; ¬e.context-support; </refsect1> diff --git a/reference/filesystem/functions/readlink.xml b/reference/filesystem/functions/readlink.xml index 84592183..96ef7198 100644 --- a/reference/filesystem/functions/readlink.xml +++ b/reference/filesystem/functions/readlink.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 xmlns="http://docbook.org/ns/docbook" xml:id="function.readlink"> <refnamediv> <refname>readlink</refname> @@ -10,7 +10,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>readlink</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>readlink</methodname> <methodparam><type>string</type><parameter>yol</parameter></methodparam> </methodsynopsis> <para> @@ -39,29 +39,12 @@ <para> Hata durumunda &false; aksi takdirde sembolik bağın içeriğini döndürür. </para> - </refsect1> - - <refsect1 role="changelog"> - &reftitle.changelog; - <informaltable> - <tgroup cols="2"> - <thead> - <row> - <entry>&Version;</entry> - <entry>&Description;</entry> - </row> - </thead> - <tbody> - <row> - <entry>5.3.0</entry> - <entry> - İşlev Windows platformlarında da (Vista, Server 2008 ve üstü) - kullanılabilir oldu. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> + <note> + <simpara> + Windows hariç, <parameter>yol</parameter> bir sembolik bağ değilse işlev + başarısız olur, Windows üzerinde ise normalleştirilmiş yol döner. + </simpara> + </note> </refsect1> <refsect1 role="examples"> diff --git a/reference/filesystem/functions/touch.xml b/reference/filesystem/functions/touch.xml index 842f2eda..6e4dfda4 100644 --- a/reference/filesystem/functions/touch.xml +++ b/reference/filesystem/functions/touch.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 7f569e1f175adf1fbd0e462eba8d6bc82214c939 Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.touch"> <refnamediv> <refname>touch</refname> @@ -51,7 +51,8 @@ <para> Belirtilmişse dosyanın erişim zamanı <parameter>ezamanı</parameter> değerine ayarlanır. Aksi takdirde <parameter>zaman</parameter> değerine - ayarlanır. + ayarlanır. İki değitirge de mevcut değilse geçerli sistem zamanı + kullanılır. </para> </listitem> </varlistentry> @@ -66,30 +67,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.3.0</entry> - <entry> - Windows altında bir dizinin değişiklik zamanını ayarlamak mümkün oldu. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="examples"> &reftitle.examples; <para> @@ -99,9 +76,9 @@ <![CDATA[ <?php if (touch($dosyaismi)) { - echo "$dosyaismi için değişiklik zamanı şimdiye ayarlandı"; + echo $dosyaismi . ' için değişiklik zamanı şimdiye ayarlandı"; } else { - echo "$dosyaismi için değişiklik zamanı değiştirilemedi"; + echo $dosyaismi . ' için değişiklik zamanı değiştirilemedi"; } ?> ]]> @@ -114,19 +91,15 @@ if (touch($dosyaismi)) { <programlisting role="php"> <![CDATA[ <?php -/* - * Dosyanın değişiklik zamanını bir saat önceye ayarlayalım - */ +// Dosyanın değişiklik zamanını bir saat önceye ayarlayalım $zaman = time() - 3600; -/* Dosyaya erişelim */ +// Dosyaya dokunalım if(!touch('bir_dosya.txt', $zaman)) { echo 'Hoop, bir şeyler yanlış oldu...'; -} -else -{ - echo 'Dosyaya başarıyla erişildi'; +} else { + echo 'Dosyaya başarıyla dokunuldu'; } ?> ]]>
diff --git a/reference/exif/functions/exif-imagetype.xml b/reference/exif/functions/exif-imagetype.xml index 78e97839..cc16c509 100644 --- a/reference/exif/functions/exif-imagetype.xml +++ b/reference/exif/functions/exif-imagetype.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 02284193f1bbde106da56b7463c32d0511c46f8c Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/image.xml, last change in rev 1.81 --> <refentry xml:id="function.exif-imagetype" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -10,7 +10,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>exif_imagetype</methodname> + <type class="union"><type>int</type><type>false</type></type><methodname>exif_imagetype</methodname> <methodparam><type>string</type><parameter>dosya</parameter></methodparam> </methodsynopsis> <para> @@ -47,6 +47,15 @@ takdirde &false; döner. Dönüş değeri <function>getimagesize</function> ile aynıdır fakat <function>exif_imagetype</function> daha hızlıdır. </para> + <note> + <para> + Resim türünü belirlemek için dosyadan yeterince bayt okuyamazsa + <function>exif_imagetype</function> bir <constant>E_NOTICE</constant> + çıktılar ve &false; değeriyle döner. + <!-- If the function finds an incomplete PNG header then it may emit an + <constant>E_WARNING</constant> instead. - Is this worth including? --> + </para> + </note> </refsect1> <refsect1 role="changelog"> &reftitle.changelog; @@ -61,17 +70,11 @@ </thead> <tbody> <row> - <entry>4.3.2</entry> + <entry>7.1.0</entry> <entry> - <acronym>JPC</acronym>, <acronym>JP2</acronym>, - <acronym>JPX</acronym>, <acronym>JB2</acronym>, - <acronym>XBM</acronym> ve <acronym>WBMP</acronym> desteği eklendi. + WebP desteği eklendi. </entry> </row> - <row> - <entry>4.3.0</entry> - <entry><acronym>SWC</acronym> desteği eklendi.</entry> - </row> </tbody> </tgroup> </informaltable> @@ -159,6 +162,14 @@ <entry>16</entry> <entry><constant>IMAGETYPE_XBM</constant></entry> </row> + <row> + <entry>17</entry> + <entry><constant>IMAGETYPE_ICO</constant></entry> + </row> + <row> + <entry>18</entry> + <entry><constant>IMAGETYPE_WEBP</constant></entry> + </row> </tbody> </tgroup> </table> @@ -185,6 +196,7 @@ if (exif_imagetype('image.gif') != IMAGETYPE_GIF) { &reftitle.seealso; <para> <simplelist> + <member><function>image_type_to_mime_type</function></member> <member><function>getimagesize</function></member> </simplelist> </para> diff --git a/reference/exif/functions/exif-tagname.xml b/reference/exif/functions/exif-tagname.xml index 82257301..1c5918ea 100644 --- a/reference/exif/functions/exif-tagname.xml +++ b/reference/exif/functions/exif-tagname.xml @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> -<refentry xml:id="function.exif-tagname" xmlns="http://docbook.org/ns/docbook"> +<!-- EN-Revision: 02284193f1bbde106da56b7463c32d0511c46f8c Maintainer: nilgun Status: ready --> +<refentry xml:id="function.exif-tagname" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>exif_tagname</refname> <refpurpose>Bir indis için başlık ismini döndürür</refpurpose> @@ -9,12 +9,10 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>exif_tagname</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>exif_tagname</methodname> <methodparam><type>int</type><parameter>indis</parameter></methodparam> </methodsynopsis> - &warn.undocumented.func; - </refsect1> <refsect1 role="parameters"> &reftitle.parameters; @@ -24,7 +22,7 @@ <term><parameter>indis</parameter></term> <listitem> <para> - Resim indisi. + Bir Etiket Adının aranacağı Etiket Kimliği. </para> </listitem> </varlistentry> @@ -34,15 +32,40 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - <parameter>indis</parameter> tanımsızsa &false;, aksi takdirde başlık ismi - döner. + <parameter>indis</parameter> tanımlı bir Etiket Kimliği değilse &false;, + aksi takdirde başlık ismi döner. </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>- <function>exif_tagname</function> örneği</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo "256: ".exif_tagname(256).PHP_EOL; +echo "257: ".exif_tagname(257).PHP_EOL; +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +256: ImageWidth +257: ImageLength +]]> + </screen> + </example> + </para> + </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>exif_imagetype</function></member> + <member><link xlink:href="&url.exifspec;">EXIF Belirtimi</link></member> + <member><link xlink:href="&url.exiftags;">EXIF Etiketleri</link></member> </simplelist> </para> </refsect1> diff --git a/reference/exif/functions/exif-thumbnail.xml b/reference/exif/functions/exif-thumbnail.xml index 996a0d39..0f15bdea 100644 --- a/reference/exif/functions/exif-thumbnail.xml +++ b/reference/exif/functions/exif-thumbnail.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 417d45ec40e3c9dc4e6ca9cc3a0537925e58d77d Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/image.xml, last change in rev 1.78 --> <refentry xml:id="function.exif-thumbnail" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -10,15 +10,15 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>exif_thumbnail</methodname> - <methodparam><type>string</type><parameter>dosya</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter role="reference">genişlik</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter role="reference">yükseklik</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter role="reference">resim_türü</parameter></methodparam> + <type class="union"><type>string</type><type>false</type></type><methodname>exif_thumbnail</methodname> + <methodparam><type class="union"><type>resource</type><type>string</type></type><parameter>dosya</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">genişlik</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">yükseklik</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">resim_türü</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> - <function>exif_thumbnail</function> işlevi bir <acronym>TIFF</acronym> veya - <acronym>JPEG</acronym> resminin içinde gömülü küçük örneği döndürür. + <function>exif_thumbnail</function> işlevi bir resmin içinde gömülü küçük + örneği döndürür. </para> <para> Resimlerin küçük örneklerini bu işlev ile göndermek isterseniz MIME türü @@ -40,8 +40,8 @@ <term><parameter>dosya</parameter></term> <listitem> <para> - Okunacak resim dosyasının ismi Bu resmin içinde küçük bir örneği gömülü - olmalıdır. + Okunacak resim dosyasının yeri. Bu bir dosya yolu veya + <type>resource</type> türünde bir akım olmalıdır. </para> </listitem> </varlistentry> @@ -80,6 +80,30 @@ döndürür. </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>- <function>exif_thumbnail</function> örneği</title> + <programlisting role="php"> +<![CDATA[ +<?php +$resim = exif_thumbnail('/bir/yol/resim.jpg', $gen, $yks, $tür); + +if ($resim!==false) { + header('Content-type: ' .image_type_to_mime_type($tür)); + echo $resim; + exit; +} else { + // Resmin örneği yoksa, hataları burada ele alacağız + echo 'Resmin içinde küçük bir örneği yok'; +} +?> +]]> + </programlisting> + </example> + </para> + </refsect1> <refsect1 role="changelog"> &reftitle.changelog; <para> @@ -93,17 +117,10 @@ </thead> <tbody> <row> - <entry>4.3.0</entry> - <entry> - Belirtilmesi isteğe bağlı <parameter>genişlik</parameter>, - <parameter>yükseklik</parameter>ve <parameter>resim_türü</parameter> - değiştirgeleri eklendi. - </entry> - </row> - <row> - <entry>4.3.0</entry> + <entry>7.2.0</entry> <entry> - <acronym>TIFF</acronym> biçemli resim örnekleri döndürülebilir oldu. + <parameter>dosya</parameter> değiştirgesi artık yerel dosyalardan + başka akım özkaynaklarını da destekliyor. </entry> </row> </tbody> @@ -111,32 +128,15 @@ </informaltable> </para> </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title>- <function>exif_thumbnail</function> örneği</title> - <programlisting role="php"> -<![CDATA[ -<?php -if (array_key_exists('file', $_REQUEST)) { - $image = exif_thumbnail($_REQUEST['file'], $width, $height, $type); -} else { - $image = false; -} -if ($image!==false) { - header('Content-type: ' .image_type_to_mime_type($type)); - echo $image; - exit; -} else { - // Resmin örneği yoksa, hataları burada ele alacağız - echo 'Resmin içinde küçük bir örneği yok'; -} -?> -]]> - </programlisting> - </example> - </para> + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + <parameter>dosya</parameter> bu işeve bir akım aktarmak için kullanılırsa + akım aranabilir olmalıdır. İşlev döndükten sonra dosya tanıtıcısının + konumu değişmeyecektir. + </para> + </note> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; diff --git a/reference/exif/functions/read-exif-data.xml b/reference/exif/functions/read-exif-data.xml index e259c21c..e8bd0df1 100644 --- a/reference/exif/functions/read-exif-data.xml +++ b/reference/exif/functions/read-exif-data.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 227c9c797eb2ea920aa9b3fb8d46ef3ecec860ae Maintainer: nilgun Status: ready --> <!-- splitted from ./en/functions/image.xml, last change in rev 1.78 --> <refentry xml:id="function.read-exif-data" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -9,12 +9,40 @@ </refpurpose> </refnamediv> + <refsynopsisdiv> + &warn.deprecated.alias-7-2-0.removed-8-0-0; + </refsynopsisdiv> + <refsect1 role="description"> &reftitle.description; <simpara> Bu işlev <function>exif_read_data</function> işlevinin takma adıdır. </simpara> </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 takma adın kullanımı artık önerilmiyor. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> </refentry> <!-- Keep this comment at the end of the file diff --git a/reference/fileinfo/functions/finfo-buffer.xml b/reference/fileinfo/functions/finfo-buffer.xml index c71a6291..b000bae5 100644 --- a/reference/fileinfo/functions/finfo-buffer.xml +++ b/reference/fileinfo/functions/finfo-buffer.xml @@ -1,30 +1,30 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 968bb98efdcc2a333899be3d1bdefec317d09170 Maintainer: nilgun Status: ready --> <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. --> <refentry xml:id="function.finfo-buffer" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>finfo_buffer</refname> + <refname>finfo::buffer</refname> <refpurpose>Bir dizge tamponu hakkında bilgi döndürür</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>finfo_buffer</methodname> + <para>&style.procedural;</para> + <methodsynopsis role="procedural"> + <type class="union"><type>string</type><type>false</type></type><methodname>finfo_buffer</methodname> <methodparam><type>resource</type><parameter>özkaynak</parameter></methodparam> - <methodparam><type>string</type><parameter>dizge</parameter><initializer>NULL</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer>FILEINFO_NONE</initializer></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>bağlam</parameter><initializer>NULL</initializer></methodparam> + <methodparam><type>string</type><parameter>string</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>FILEINFO_NONE</constant></initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>context</parameter><initializer>&null;</initializer></methodparam> + </methodsynopsis> + <para>&style.oop;</para> + <methodsynopsis role="oop"> + <modifier>public</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>finfo::buffer</methodname> + <methodparam><type>string</type><parameter>string</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>FILEINFO_NONE</constant></initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>context</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> - <classsynopsis> - <ooclass><classname>finfo</classname></ooclass> - <methodsynopsis> - <type>string</type><methodname>buffer</methodname> - <methodparam><type>string</type><parameter>dizge</parameter><initializer>NULL</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer>FILEINFO_NONE</initializer></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>bağlam</parameter><initializer>NULL</initializer></methodparam> - </methodsynopsis> - </classsynopsis> <para> Bu işlev bir dizge içindeki ikil veri hakkında bilgi edinmek için @@ -46,7 +46,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>dizge</parameter></term> + <term><parameter>string</parameter></term> <listitem> <para> İçeriği incelenecek dizge. @@ -54,7 +54,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>seçenekler</parameter></term> + <term><parameter>flags</parameter></term> <listitem> <para> <link linkend="fileinfo.constants">Fileinfo sabitleri</link>nden biri @@ -63,10 +63,10 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>bağlam</parameter></term> + <term><parameter>context</parameter></term> <listitem> <para> - Bağlamlar hakkında bilgi edinmek için <xref linkend="ref.stream"/> + Akımlar hakkında bilgi edinmek için <xref linkend="ref.stream"/> bölümüne bakınız. </para> </listitem> @@ -82,6 +82,28 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>context</parameter> artık &null; olabiliyor. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> diff --git a/reference/fileinfo/functions/finfo-close.xml b/reference/fileinfo/functions/finfo-close.xml index 2faa721c..8daffdb6 100644 --- a/reference/fileinfo/functions/finfo-close.xml +++ b/reference/fileinfo/functions/finfo-close.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 9ad9b79675b4006a819ec25d781922ed5472a94f Maintainer: nilgun Status: ready --> <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. --> <refentry xml:id="function.finfo-close" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -9,17 +9,10 @@ </refnamediv> <refsect1 role="description"> &reftitle.description; - <methodsynopsis> + <methodsynopsis role="procedural"> <type>bool</type><methodname>finfo_close</methodname> <methodparam><type>resource</type><parameter>özkaynak</parameter></methodparam> </methodsynopsis> - <classsynopsis> - <ooclass><classname>finfo</classname></ooclass> - <destructorsynopsis> - <methodname>__destruct</methodname> - <void/> - </destructorsynopsis> - </classsynopsis> <para> Bu işlev, <function>finfo_open</function> tarafından açılmış özkaynağı diff --git a/reference/fileinfo/functions/finfo-file.xml b/reference/fileinfo/functions/finfo-file.xml index 3142e206..489c16d5 100644 --- a/reference/fileinfo/functions/finfo-file.xml +++ b/reference/fileinfo/functions/finfo-file.xml @@ -1,30 +1,30 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 968bb98efdcc2a333899be3d1bdefec317d09170 Maintainer: nilgun Status: ready --> <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. --> <refentry xml:id="function.finfo-file" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>finfo_file</refname> + <refname>finfo::file</refname> <refpurpose>Bir dosya hakkında bilgi döndürür</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>finfo_file</methodname> + <para>&style.procedural;</para> + <methodsynopsis role="procedural"> + <type class="union"><type>string</type><type>false</type></type><methodname>finfo_file</methodname> <methodparam><type>resource</type><parameter>özkaynak</parameter></methodparam> - <methodparam><type>string</type><parameter>dosya_ismi</parameter><initializer>NULL</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer>FILEINFO_NONE</initializer></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>bağlam</parameter><initializer>NULL</initializer></methodparam> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>FILEINFO_NONE</constant></initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>context</parameter><initializer>&null;</initializer></methodparam> + </methodsynopsis> + <para>&style.oop;</para> + <methodsynopsis role="oop"> + <modifier>public</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>finfo::file</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>FILEINFO_NONE</constant></initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>context</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> - <classsynopsis> - <ooclass><classname>finfo</classname></ooclass> - <methodsynopsis> - <type>string</type><methodname>file</methodname> - <methodparam><type>string</type><parameter>dosya_ismi</parameter><initializer>NULL</initializer></methodparam> - <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer>FILEINFO_NONE</initializer></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>bağlam</parameter><initializer>NULL</initializer></methodparam> - </methodsynopsis> - </classsynopsis> <para> Bu işlev bir dosya hakkında bilgi edinmek için kullanılır. @@ -45,7 +45,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>dosya_ismi</parameter></term> + <term><parameter>filename</parameter></term> <listitem> <para> Hakkında bilgi istenen dosya. @@ -53,7 +53,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>seçenekler</parameter></term> + <term><parameter>flags</parameter></term> <listitem> <para> <link linkend="fileinfo.constants">Fileinfo sabitleri</link>nden biri @@ -62,10 +62,10 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>bağlam</parameter></term> + <term><parameter>context</parameter></term> <listitem> <para> - Bağlamlar hakkında bilgi edinmek için <xref linkend="ref.stream"/> + Akımlar hakkında bilgi edinmek için <xref linkend="ref.stream"/> bölümüne bakınız. </para> </listitem> @@ -80,6 +80,28 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>context</parameter> artık &null; olabiliyor. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> diff --git a/reference/fileinfo/functions/finfo-open.xml b/reference/fileinfo/functions/finfo-open.xml index 8df1666a..47780e67 100644 --- a/reference/fileinfo/functions/finfo-open.xml +++ b/reference/fileinfo/functions/finfo-open.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 968bb98efdcc2a333899be3d1bdefec317d09170 Maintainer: nilgun Status: ready --> <refentry xml:id="function.finfo-open" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>finfo_open</refname> @@ -10,21 +10,18 @@ <refsect1 role="description"> &reftitle.description; - <para>Yordamsal kullanım</para> - <methodsynopsis> - <type>resource</type><methodname>finfo_open</methodname> - <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer>FILEINFO_NONE</initializer></methodparam> - <methodparam choice="opt"><type>string</type><parameter>sihir_dosyası</parameter><initializer>NULL</initializer></methodparam> + <para>&style.procedural;</para> + <methodsynopsis role="procedural"> + <type class="union"><type>resource</type><type>false</type></type><methodname>finfo_open</methodname> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>FILEINFO_NONE</constant></initializer></methodparam> + <methodparam choice="opt"><type>string</type><parameter>magic_database</parameter><initializer>""</initializer></methodparam> </methodsynopsis> - <para>Nesne yönelimli kullanım (kurucu):</para> - <classsynopsis> - <ooclass><classname>finfo</classname></ooclass> - <constructorsynopsis> - <methodname>__construct</methodname> - <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer>FILEINFO_NONE</initializer></methodparam> - <methodparam choice="opt"><type>string</type><parameter>sihirli_dosya</parameter><initializer>NULL</initializer></methodparam> - </constructorsynopsis> - </classsynopsis> + <para>&style.oop; (kurucu):</para> + <constructorsynopsis role="oop"> + <modifier>public</modifier> <methodname>finfo::__construct</methodname> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>FILEINFO_NONE</constant></initializer></methodparam> + <methodparam choice="opt"><type>string</type><parameter>magic_database</parameter><initializer>""</initializer></methodparam> + </constructorsynopsis> <para> Bu işlev bir sihir veritabanı açar ve özkaynağını döndürür. </para> @@ -35,7 +32,7 @@ <para> <variablelist> <varlistentry> - <term><parameter>seçenekler</parameter></term> + <term><parameter>flags</parameter></term> <listitem> <para> <link linkend="fileinfo.constants">Fileinfo sabitleri</link>nden biri @@ -44,11 +41,19 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>sihir_dosyası</parameter></term> + <term><parameter>magic_database</parameter></term> <listitem> <para> - Sihir veritabanının dosya ismi genellikle <filename>/bir/yol/magic.mime</filename> şeklindedir. Belirtilmezse <literal>MAGIC</literal> ortam değişkeninin değeri kullanılır. Bu değişken de atanmamışsa <filename>/usr/share/misc/magic</filename> dosyası öntanımlıdır. Gerek görülürse dosya uzantısı olarak <literal>.mime</literal> ve/veya <literal>.mgc</literal> kullanılabilir. + Sihir veritabanının dosya ismi genellikle + <filename>/bir/yol/magic.mime</filename> şeklindedir. Belirtilmezse + <literal>MAGIC</literal> ortam değişkeninin değeri kullanılır. Bu + değişken de atanmamışsa PHP paketinde gelen sihir veritabanı + kullanılır. </para> + <para> + &null; veya boş bir dizge atanması öntanımlı değerin kullanımına + eşdeğer olacaktır. + </para> </listitem> </varlistentry> </variablelist> @@ -58,11 +63,33 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Başarısızlık durumunda &false;, aksi takdirde sihir veritabanı özkaynağı - ile döner. + (Sadece yordamsal kullanımda) + Başarı durumunda sihir veritabanı özkaynağı,&return.falseforfailure;. </para> </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <warning> + <para> + Beklenen sihir veritabanı biçimi PHP 5.3.11 ve 5.4.1'de değişti. Bu + nedenle, dahili sihir veritabanı yükseltildi. Bu, çoğunlukla harici bir + sihir veritabanının kullanıldığı yerlerde kodu etkiler: daha eski bir + sihir dosyasının okunması artık başarısız olacaktır. Ayrıca, mime + türlerinin bazı metinsel gösterimleri de değişti, örneğin PHP için "PHP + script text" yerine "PHP script, ASCII text" metni dönüyor. + </para> + </warning> + <note> + <para> + Genellikle, (<parameter>magic_database</parameter> belirtmeyerek ve + <literal>MAGIC</literal> ortam değişkenini atanmayarak) PHP paketinde + gelen sihir veritabanını kullanmak, özellikle özel bir sihir veritabanına + ihtiyaç olmadıkça en iyi seçim olacaktır. + </para> + </note> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <example> @@ -73,11 +100,6 @@ // Bir açıklama değil MIME türü dönsün $finfo = new finfo(FILEINFO_MIME, "/usr/share/misc/magic"); -if (!$finfo) { - echo "Fileinfo veritabanı açılamadı"; - exit(); -} - /* Bir dosyanın MIME türünü öğrenelim */ $dosya = "/usr/local/birdosya.txt"; echo $finfo->file($dosya); diff --git a/reference/fileinfo/functions/finfo-set-flags.xml b/reference/fileinfo/functions/finfo-set-flags.xml index 9f36d3c2..1d074855 100644 --- a/reference/fileinfo/functions/finfo-set-flags.xml +++ b/reference/fileinfo/functions/finfo-set-flags.xml @@ -1,26 +1,26 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 968bb98efdcc2a333899be3d1bdefec317d09170 Maintainer: nilgun Status: ready --> <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. --> <refentry xml:id="function.finfo-set-flags" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>finfo_set_flags</refname> + <refname>finfo::set_flags</refname> <refpurpose>Libmagic yapılandırma seçeneklerini ayarlar</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; - <methodsynopsis> + <para>&style.procedural;</para> + <methodsynopsis role="procedural"> <type>bool</type><methodname>finfo_set_flags</methodname> <methodparam><type>resource</type><parameter>özkaynak</parameter></methodparam> - <methodparam><type>int</type><parameter>seçenekler</parameter></methodparam> + <methodparam><type>int</type><parameter>flags</parameter></methodparam> + </methodsynopsis> + <para>&style.oop;</para> + <methodsynopsis role="oop"> + <modifier>public</modifier> <type>bool</type><methodname>finfo::set_flags</methodname> + <methodparam><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> - <classsynopsis> - <ooclass><classname>finfo</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>set_flags</methodname> - <methodparam><type>int</type><parameter>seçenekler</parameter></methodparam> - </methodsynopsis> - </classsynopsis> <para> Bu işlevle çeşitli Fileinfo seçenekleri ayarlanır. Bu seçenekler ayrıca, @@ -42,7 +42,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>seçenekler</parameter></term> + <term><parameter>flags</parameter></term> <listitem> <para> <link linkend="fileinfo.constants">Fileinfo sabitleri</link>nden biri diff --git a/reference/filesystem/functions/basename.xml b/reference/filesystem/functions/basename.xml index 2559cd02..ca5e76e7 100644 --- a/reference/filesystem/functions/basename.xml +++ b/reference/filesystem/functions/basename.xml @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 88c1f8d6c9fecf352c5ce152a6f758ed013fc2c0 Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.basename"> <refnamediv> <refname>basename</refname> - <refpurpose>Dosya yolunun dosya ismi bileşenini döndürür</refpurpose> + <refpurpose>Dosya yolunun ucundaki dosya ismi bileşenini döndürür</refpurpose> </refnamediv> <refsect1 role="description"> @@ -12,11 +12,29 @@ <methodsynopsis> <type>string</type><methodname>basename</methodname> <methodparam><type>string</type><parameter>yol</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>uzantı</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>uzantı</parameter><initializer>""</initializer></methodparam> </methodsynopsis> <para> - Belirtilen dosya yolunun dosya ismi bileşenini döndürür. + Belirtilen dosya yolunun ucundaki dosya ismi bileşenini döndürür. </para> + <note> + <para> + <function>basename</function> safça girdi dizgesi üzerinde çalışır, + dosya sisteminden ve "<literal>..</literal>" gibi yol bileşenlerinden + haberi yoktur. + </para> + </note> + <caution> + <para> + <function>basename</function> yereli de bilmez, bundan dolayı çok baytlı + karakterler içeren dosya yollarından doğru bileşeni ayırabilmesi için + eşleşen yerelin <function>setlocale</function> işlevi kullanılarak + atanması gerekir. + Eğer <parameter>yol</parameter> geçerli yerel için geçersiz olan + karakterler içeriyorsa <function>basename</function> işlevinin davranışı + belirsizdir. + </para> + </caution> </refsect1> <refsect1 role="parameters"> @@ -40,7 +58,8 @@ <term><parameter>uzantı</parameter></term> <listitem> <para> - Dönen bileşenden kaldırılacak dosya uzantısı. + Dosya ismi <parameter>uzantı</parameter> içinde devam ediyorsa uzantı + ile birlikte bu da kesilir. </para> </listitem> </varlistentry> @@ -55,30 +74,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>4.1.0</entry> - <entry> - <parameter>uzantı</parameter> değiştirgesi eklendi. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="examples"> &reftitle.examples; <para> @@ -87,12 +82,26 @@ <programlisting role="php"> <![CDATA[ <?php -$yol = "/home/httpd/html/index.php"; -$dosya = basename($yol); // $dosya => "index.php" -$dosya = basename($yol, ".php"); // $dosya => "index" +echo "1) ".basename("/etc/sudoers.d", ".d").PHP_EOL; +echo "2) ".basename("/etc/sudoers.d").PHP_EOL; +echo "3) ".basename("/etc/passwd").PHP_EOL; +echo "4) ".basename("/etc/").PHP_EOL; +echo "5) ".basename(".").PHP_EOL; +echo "6) ".basename("/"); ?> ]]> </programlisting> + &example.outputs; + <screen> +<![CDATA[ +1) sudoers +2) sudoers.d +3) passwd +4) etc +5) . +6) +]]> + </screen> </example> </para> </refsect1> diff --git a/reference/filesystem/functions/copy.xml b/reference/filesystem/functions/copy.xml index 48d32991..56da847b 100644 --- a/reference/filesystem/functions/copy.xml +++ b/reference/filesystem/functions/copy.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 7f569e1f175adf1fbd0e462eba8d6bc82214c939 Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.copy"> <refnamediv> <refname>copy</refname> @@ -70,38 +70,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.3.0</entry> - <entry> - Bağlam desteği eklendi. - </entry> - </row> - <row> - <entry>4.3.0</entry> - <entry> - Eğer fopen sarmalayıcıları etkinse, hem <parameter>kaynak</parameter> - hem de <parameter>hedef</parameter> artık URL olabilmektedir. - Ayrıntılar için <function>fopen</function> işlevine bakınız. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="examples"> &reftitle.examples; <para> diff --git a/reference/filesystem/functions/delete.xml b/reference/filesystem/functions/delete.xml index 8cfa928b..e720afc9 100644 --- a/reference/filesystem/functions/delete.xml +++ b/reference/filesystem/functions/delete.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 9514f50e8909210419382868c321703037375191 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 9e64a0aefae20767685c024d7e20f27823b13621 Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.delete" role="noversion"> <refnamediv> <refname>delete</refname> @@ -11,8 +11,10 @@ <refsect1 role="description"> &reftitle.description; <para> - <function>unlink</function> veya <function>unset</function> işlevlerini - yanlış yerde arayanlar için yol gösterici bir sayfadır. + PHP dilinde "delete" ne bir anahtar sözcük ne de bir işlev ismidir. Bir + dosyayı silmek istiyorsanız, <function>unlink</function> işlevini deneyin. + Yerel etki alanındaki bir değişkeni silmek için <function>unset</function> + işlevine bakın. </para> </refsect1> diff --git a/reference/filesystem/functions/disk-total-space.xml b/reference/filesystem/functions/disk-total-space.xml index 905f7a19..f5ee5ec4 100644 --- a/reference/filesystem/functions/disk-total-space.xml +++ b/reference/filesystem/functions/disk-total-space.xml @@ -1,16 +1,16 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 3ce9368539aaacb6eba5c5049209f271ebf16e39 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.disk-total-space"> <refnamediv> <refname>disk_total_space</refname> - <refpurpose>Bir dizinin toplam boyunu döndürür</refpurpose> + <refpurpose>Bir disk bölümünün veya dosya sisteminin toplam boyutunu döndürür</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>float</type><methodname>disk_total_space</methodname> + <type class="union"><type>float</type><type>false</type></type><methodname>disk_total_space</methodname> <methodparam><type>string</type><parameter>dizin</parameter></methodparam> </methodsynopsis> <para> @@ -55,8 +55,8 @@ $df = disk_total_space("/"); // Windows üzerinde: -disk_total_space("C:"); -disk_total_space("D:"); +$df = disk_total_space("C:"); +$df = disk_total_space("D:"); ?> ]]> </programlisting> diff --git a/reference/filesystem/functions/feof.xml b/reference/filesystem/functions/feof.xml index 9f2d7d67..4a7316f3 100644 --- a/reference/filesystem/functions/feof.xml +++ b/reference/filesystem/functions/feof.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.feof"> <refnamediv> <refname>feof</refname> @@ -55,7 +55,7 @@ <warning> <para> Eğer belirtilen dosya tanıtıcısı geçersizse <function>feof</function> - başarısız olup &true; döndürceğinden sonsuz bir döngü oluşabilir. + başarısız olup &true; döndüreceğinden sonsuz bir döngü oluşabilir. </para> <example> <title>- Geçersiz dosya tanıtıcılı <function>feof</function> örneği diff --git a/reference/filesystem/functions/fgetss.xml b/reference/filesystem/functions/fgetss.xml index 12364c66..f3ad8e4e 100644 --- a/reference/filesystem/functions/fgetss.xml +++ b/reference/filesystem/functions/fgetss.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: nilgun Status: ready --> +<!-- EN-Revision: cb3e68d99d80a70feafc6f9a1b5f678e4d0522af Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fgetss"> <refnamediv> <refname>fgetss</refname> @@ -8,6 +8,10 @@ döndürür</refpurpose> </refnamediv> + <refsynopsisdiv> + &warn.deprecated.function-7-3-0.removed-8-0-0; + </refsynopsisdiv> + <refsect1 role="description"> &reftitle.description; <methodsynopsis> @@ -17,8 +21,11 @@ <methodparam choice="opt"><type>string</type><parameter>etiketler</parameter></methodparam> </methodsynopsis> <para> - Okunan metinden HTML ve PHP etiketlerini temizlemesi dışında - <function>fgets</function> işlevi ile aynıdır. + Okunan metinden &null; baytları, HTML ve PHP etiketlerini temizlemesi + dışında <function>fgets</function> işlevi ile aynıdır. İşlev, çağrıdan + çağrıya ayrıştırma durumunu korur, bu nedenle, + <function>fgets</function> dönüş değeriyle <function>strip_tags</function> + işlevin çağırmaya eşdeğer değildir. </para> </refsect1> @@ -45,7 +52,9 @@ <listitem> <para> Hangi etiketlerin ayıklanacağını bu isteğe bağlı değiştirge ile - belirtebilirsiniz. + belirtebilirsiniz. Ayrıntılar için <function>strip_tags</function> + işlevinin <parameter>ayıklanmayacaklar</parameter> değiştirgesinin + açıklamasına bakınız. </para> </listitem> </varlistentry> @@ -65,37 +74,8 @@ </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.0.0</entry> - <entry> - <parameter>uzunluk</parameter> değiştirgesi isteğe bağlı oldu. - </entry> - </row> - <row> - <entry>4.0.0</entry> - <entry> - <parameter>etiketler</parameter> değiştirgesi eklendi. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title>- Bir PHP dosyasının satır satır okunması</title> @@ -147,6 +127,8 @@ Text outside of the HTML block. <member><function>popen</function></member> <member><function>fsockopen</function></member> <member><function>strip_tags</function></member> + <member><methodname>SplFileObject::fgetss</methodname></member> + <member>The <link linkend="filters.string.strip_tags">string.strip_tags</link> süzgeci</member> </simplelist> </para> </refsect1> diff --git a/reference/filesystem/functions/file.xml b/reference/filesystem/functions/file.xml index 403e87cf..305b2207 100644 --- a/reference/filesystem/functions/file.xml +++ b/reference/filesystem/functions/file.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 --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.file"> <refnamediv> <refname>file</refname> @@ -63,7 +63,7 @@ </term> <listitem> <simpara> - Her dizi elemanının sonuna satırsonu karakteri eklenmez. + Dizi elemanlarının sonundaki satırsonu karakteri atlanır. </simpara> </listitem> </varlistentry> @@ -77,29 +77,6 @@ </simpara> </listitem> </varlistentry> - <varlistentry> - <term> - <constant>FILE_TEXT</constant> - </term> - <listitem> - <simpara> - İçerik UTF-8 kodlu döndürülür. Özel bir bağlam oluşturarark farklı - bir kodlama belirtebilirsiniz. Bu seçenek - <constant>FILE_BINARY</constant> ile birlikte kullanılamaz. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term> - <constant>FILE_BINARY</constant> - </term> - <listitem> - <simpara> - İçerik ikil veri olarak okunur. Bu öntanımlıdır ve - <constant>FILE_TEXT</constant> ile birlikte kullanılamaz. - </simpara> - </listitem> - </varlistentry> </variablelist> </para> </listitem> @@ -130,63 +107,17 @@ <note> <para> <constant>FILE_IGNORE_NEW_LINES</constant> sabiti kullanılmadığı sürece - dizinin her elemanı bir satırsonu karakteri içerecektir. Bu satırsonu - karakterlerinden kurtulmak isterseniz <function>rtrim</function> işlevini - kullanabilirsiniz. + dizinin her elemanı bir satırsonu karakteri içerecektir. </para> </note> ¬e.line-endings; </refsect1> <refsect1 role="changelog"> - &reftitle.changelog; + &reftitle.errors; <para> - <informaltable> - <tgroup cols="2"> - <thead> - <row> - <entry>&Version;</entry> - <entry>&Description;</entry> - </row> - </thead> - <tbody> - <row> - <entry>6.0.0</entry> - <entry> - <constant>FILE_TEXT</constant> ve <constant>FILE_BINARY</constant> - seçenekleri desteği eklendi. - <note> - <para> - <literal>İleriye uyumluluk</literal> adına, bu sabitler PHP 5.2.7'den - beri mevcuttur. - </para> - </note> - </entry> - </row> - <row> - <entry>5.0.0</entry> - <entry> - <parameter>bağlam</parameter> değiştirgesi eklendi. - </entry> - </row> - <row> - <entry>5.0.0</entry> - <entry> - PHP 5.0.0 öncesinde <parameter>seçenekler</parameter> değiştirgesi - sadece <link linkend="ini.include-path">include_path</link> - yönergesinde belirtilen yolları kapsardı ve daima 1 ile - etkinleştirilirdi. - </entry> - </row> - <row> - <entry>4.3.0</entry> - <entry> - <function>file</function> işlevi veriyi ikil kipte okur oldu. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> + Dosya mevcut değilse <constant>E_WARNING</constant> seviyesinde bir hata + çıktılanır. </para> </refsect1> diff --git a/reference/filesystem/functions/fileatime.xml b/reference/filesystem/functions/fileatime.xml index 4c7c0192..18c11d41 100644 --- a/reference/filesystem/functions/fileatime.xml +++ b/reference/filesystem/functions/fileatime.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fileatime"> <refnamediv> <refname>fileatime</refname> @@ -10,7 +10,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>fileatime</methodname> + <type class="union"><type>int</type><type>false</type></type><methodname>fileatime</methodname> <methodparam><type>string</type><parameter>dosyaismi</parameter></methodparam> </methodsynopsis> <simpara> @@ -65,6 +65,11 @@ if (file_exists($dosya)) { </para> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + &fs.emits.warning.on.failure; + </refsect1> + <refsect1 role="notes"> &reftitle.notes; <note> diff --git a/reference/filesystem/functions/filectime.xml b/reference/filesystem/functions/filectime.xml index f2eeee2e..e173788b 100644 --- a/reference/filesystem/functions/filectime.xml +++ b/reference/filesystem/functions/filectime.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.filectime"> <refnamediv> <refname>filectime</refname> @@ -11,7 +11,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>filectime</methodname> + <type class="union"><type>int</type><type>false</type></type><methodname>filectime</methodname> <methodparam><type>string</type><parameter>dosyaismi</parameter></methodparam> </methodsynopsis> <para> @@ -64,6 +64,11 @@ if (file_exists($dosya)) { </example> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + &fs.emits.warning.on.failure; + </refsect1> + <refsect1 role="notes"> &reftitle.notes; <note> diff --git a/reference/filesystem/functions/fileperms.xml b/reference/filesystem/functions/fileperms.xml index 8999fb1f..dafecabc 100644 --- a/reference/filesystem/functions/fileperms.xml +++ b/reference/filesystem/functions/fileperms.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 xmlns="http://docbook.org/ns/docbook" xml:id="function.fileperms"> <refnamediv> <refname>fileperms</refname> @@ -10,7 +10,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>fileperms</methodname> + <type class="union"><type>int</type><type>false</type></type><methodname>fileperms</methodname> <methodparam><type>string</type><parameter>dosyaismi</parameter></methodparam> </methodsynopsis> <para> @@ -37,7 +37,23 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Bir hata durumunda &false;, aksi takdirde dosyanın izinlerini döndürür. + Dosyanın izinlerini sayısal kip olarak döndürür. Bu kipin daha düşük + bitleri, <function>chmod</function> tarafından beklenen izinlerle aynıdır, + ancak çoğu platformda, dönüş değeri <parameter>dosyaismi</parameter> + olarak verilen dosya türü hakkında bilgi de içerir. Aşağıdaki örnekler, + Linux ve macOS dahil olmak üzere POSIX sistemlerinde belirli izinler ve + dosya türleri için dönüş değerinin nasıl sınanacağını göstermektedir. + </para> + <para> + Yerel dosyalara özgü dönüş değeri, C kütüphanesinin + <function>stat</function> işlevi tarafından döndürülen yapının + <literal>st_mode</literal> üyesinin değeridir. Tam olarak hangi bitlerin + atanacağı platformdan platforma değişebilir ve dönüş değerinin izin + verilmeyen bitlerinin ayrıştırılması gerekiyorsa özel platformunuzun + belgelerine bakmanız önerilir. + </para> + <para> + Başarısızlık durumunda &false; döner. </para> </refsect1> @@ -69,31 +85,31 @@ echo substr(sprintf('%o', fileperms('/etc/passwd')), -4); <?php $perms = fileperms('/etc/passwd'); -if (($perms & 0xC000) == 0xC000) { - // Soket - $info = 's'; -} elseif (($perms & 0xA000) == 0xA000) { - // Sembolik bağ - $info = 'l'; -} elseif (($perms & 0x8000) == 0x8000) { - // Sıradan dosya - $info = '-'; -} elseif (($perms & 0x6000) == 0x6000) { - // Blok aygıtı - $info = 'b'; -} elseif (($perms & 0x4000) == 0x4000) { - // Dizin - $info = 'd'; -} elseif (($perms & 0x2000) == 0x2000) { - // Karakter aygıtı - $info = 'c'; -} elseif (($perms & 0x1000) == 0x1000) { - // FIFO boru - $info = 'p'; -} else { - // Bilinmiyor - $info = 'u'; -} +switch ($perms & 0xF000) { + case 0xC000: // soket + $info = 's'; + break; + case 0xA000: // Sembolik bağ + $info = 'l'; + break; + case 0x8000: // Sıradan dosya + $info = 'r'; + break; + case 0x6000: // Blok aygıtı + $info = 'b'; + break; + case 0x4000: // Dizin + $info = 'd'; + break; + case 0x2000: // Karakter aygıtı + $info = 'c'; + break; + case 0x1000: // FIFO boru + $info = 'p'; + break; + default: // Bilinmiyor + $info = 'u'; + } // Kullanıcı $info .= (($perms & 0x0100) ? 'r' : '-'); @@ -136,6 +152,11 @@ echo $info; &tip.fopen-wrapper.stat; </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + &fs.emits.warning.on.failure; + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> diff --git a/reference/filesystem/functions/filetype.xml b/reference/filesystem/functions/filetype.xml index 2194917c..d269b0bd 100644 --- a/reference/filesystem/functions/filetype.xml +++ b/reference/filesystem/functions/filetype.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 xmlns="http://docbook.org/ns/docbook" xml:id="function.filetype"> <refnamediv> <refname>filetype</refname> @@ -10,7 +10,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>filetype</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>filetype</methodname> <methodparam><type>string</type><parameter>dosyaismi</parameter></methodparam> </methodsynopsis> <para> @@ -72,6 +72,11 @@ echo filetype('/etc/'); // dir &tip.fopen-wrapper.stat; </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + &fs.emits.warning.on.failure; + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> @@ -80,8 +85,9 @@ echo filetype('/etc/'); // dir <member><function>is_file</function></member> <member><function>is_link</function></member> <member><function>file_exists</function></member> - <member><function>stat</function></member> <member><function>mime_content_type</function></member> + <member><function>pathinfo</function></member> + <member><function>stat</function></member> </simplelist> </para> </refsect1> diff --git a/reference/filesystem/functions/fnmatch.xml b/reference/filesystem/functions/fnmatch.xml index ccc2895b..e2b6d2ec 100644 --- a/reference/filesystem/functions/fnmatch.xml +++ b/reference/filesystem/functions/fnmatch.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 605539d7711f94536e50a09d59b87eb36dceadf9 Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fnmatch"> <refnamediv> <refname>fnmatch</refname> @@ -13,12 +13,12 @@ <methodsynopsis> <type>bool</type><methodname>fnmatch</methodname> <methodparam><type>string</type><parameter>kalıp</parameter></methodparam> - <methodparam><type>string</type><parameter>dizge</parameter></methodparam> + <methodparam><type>string</type><parameter>dosyaismi</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>seçenekler</parameter><initializer>0</initializer></methodparam> </methodsynopsis> <para> <function>fnmatch</function> işlevi, belirtilen - <parameter>dizge</parameter>'nin belirtilen dosya kalıbı ile eşleşip + <parameter>dosyaismi</parameter>'nin belirtilen dosya kalıbı ile eşleşip eşleşmediğine bakar. </para> </refsect1> @@ -35,7 +35,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>dizge</parameter></term> + <term><parameter>dosyaismi</parameter></term> <listitem> <para> Sınanacak dizge. İşlev özellikle dosya isimleri için yararlı olsa da @@ -203,38 +203,17 @@ </para> </refsect1> - <refsect1 role="changelog"> - &reftitle.changelog; - <informaltable> - <tgroup cols="2"> - <thead> - <row> - <entry>&Version;</entry> - <entry>&Description;</entry> - </row> - </thead> - <tbody> - <row> - <entry>5.3.0</entry> - <entry> - İşlev Windows platformlarında da kullanılabilir oldu. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </refsect1> - <refsect1 role="examples"> &reftitle.examples; <para> <example> - <title>- Bir renk isminin bir kabuk dosya kalıbıyla eşleştirilmesi</title> + <title>- Bir renk isminin bir kabuk dosya kalıbıyla eşleştirilmesi + </title> <programlisting role="php"> <![CDATA[ <?php if (fnmatch("*gr[ae]y", $color)) { - echo "some form of gray ..."; + echo "grinin bir tonu ..."; } ?> ]]> @@ -247,7 +226,8 @@ if (fnmatch("*gr[ae]y", $color)) { &reftitle.notes; <warning> <para> - Bu işlev şimdilik POSIX uyumlu olmayan sistemlerde kullanılamamaktadır. + Bu işlev şimdilik POSIX uyumlu olmayan sistemlerde kullanılamamaktadır, + Windows hariç. </para> </warning> </refsect1> diff --git a/reference/filesystem/functions/fread.xml b/reference/filesystem/functions/fread.xml index 11c4f723..b4fd763a 100644 --- a/reference/filesystem/functions/fread.xml +++ b/reference/filesystem/functions/fread.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 xmlns="http://docbook.org/ns/docbook" xml:id="function.fread"> <refnamediv> <refname>fread</refname> @@ -10,7 +10,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>fread</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>fread</methodname> <methodparam><type>resource</type><parameter>dt</parameter></methodparam> <methodparam><type>int</type><parameter>uzunluk</parameter></methodparam> </methodsynopsis> @@ -32,12 +32,17 @@ </listitem> <listitem> <simpara> - Bir paket kullanılabilir hale gelince (ağ akımları için). + Bir paket kullanılabilir hale gelince veya + <link linkend="function.socket-set-timeout">soket zaman aşımı</link>na + uğrayınca (ağ akımları için). </simpara> </listitem> <listitem> <simpara> - 8192 bayt okununca (akım kullanıcı alanında açıldıktan sonra). + Eğer akım arabelleğe alınmışsa ve düz bir dosyaya ait değilse, en fazla + yığıt boyutuna (genellikle 8192) eşit sayıda bayta kadar bir okuma + yapılır; önceden arabelleğe alınan verilere bağlı olarak, döndürülen + verilerin boyutu yığıt boyutundan daha büyük olabilir. </simpara> </listitem> </itemizedlist> @@ -129,7 +134,6 @@ fclose($dt); <programlisting role="php"> <![CDATA[ <?php -// PHP 5 ve sonrası için $dt = fopen("http://www.example.com/", "rb"); $içerik = stream_get_contents($dt); fclose($dt); @@ -140,9 +144,14 @@ fclose($dt); <![CDATA[ <?php $dt = fopen("http://www.example.com/", "rb"); +if (FALSE === $dt) { + exit("URL'ye akım açılamadı"); +} + $içerik = ''; + while (!feof($dt)) { - $içerik .= fread($dt, 8192); + $içerik .= fread($dt, 8192); } fclose($dt); ?> @@ -186,6 +195,7 @@ fclose($dt); <member><function>fpassthru</function></member> <member><function>ftell</function></member> <member><function>rewind</function></member> + <member><function>unpack</function></member> </simplelist> </para> </refsect1> diff --git a/reference/filesystem/functions/ftell.xml b/reference/filesystem/functions/ftell.xml index 81182779..e670ea26 100644 --- a/reference/filesystem/functions/ftell.xml +++ b/reference/filesystem/functions/ftell.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 xmlns="http://docbook.org/ns/docbook" xml:id="function.ftell"> <refnamediv> <refname>ftell</refname> @@ -11,7 +11,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>ftell</methodname> + <type class="union"><type>int</type><type>false</type></type><methodname>ftell</methodname> <methodparam><type>resource</type><parameter>dt</parameter></methodparam> </methodsynopsis> <para> @@ -48,6 +48,7 @@ <para> Bir hata oluşursa &false; döner. </para> + &fs.file.32bit; </refsect1> <refsect1 role="examples"> diff --git a/reference/filesystem/functions/ftruncate.xml b/reference/filesystem/functions/ftruncate.xml index ff1524b0..bcb59278 100644 --- a/reference/filesystem/functions/ftruncate.xml +++ b/reference/filesystem/functions/ftruncate.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 --> <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.14 --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ftruncate"> <refnamediv> @@ -67,31 +67,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>PHP 4.3.3</entry> - <entry> - <function>ftruncate</function> işlevi bu sürümün öncesinde başarı - durumunda mantıksal &true; yerine tamsayı 1 döndürürdü. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="examples"> &reftitle.examples; <para> diff --git a/reference/filesystem/functions/readfile.xml b/reference/filesystem/functions/readfile.xml index 9f9fb17a..b2424260 100644 --- a/reference/filesystem/functions/readfile.xml +++ b/reference/filesystem/functions/readfile.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: nilgun Status: ready --> +<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readfile"> <refnamediv> <refname>readfile</refname> @@ -10,9 +10,9 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>readfile</methodname> + <type class="union"><type>int</type><type>false</type></type><methodname>readfile</methodname> <methodparam><type>string</type><parameter>dosyaismi</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>include_path_kullan</parameter><initializer>false</initializer></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>include_path_kullan</parameter><initializer>&false;</initializer></methodparam> <methodparam choice="opt"><type>resource</type><parameter>bağlan</parameter></methodparam> </methodsynopsis> <para> @@ -57,17 +57,21 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Bir hata oluşmuşsa &false; döner ve işlev @<function>readfile</function> - şeklinde çağrılmamışsa bir hata iletisi basılır. Herşey yolunda gitmişse - dosyadan okunan baytların sayısını döndürür. + Herşey yolunda gitmişse dosyadan okunan baytların + sayısı,&return.falseforfailure;. </para> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + &fs.emits.warning.on.failure; + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> <example> - <title><function>readfile</function> kullanarak dosya indirmeyi zorlamak + <title>- <function>readfile</function> kullanarak dosya indirmeyi zorlamak </title> <programlisting role="php"> <![CDATA[ @@ -77,14 +81,11 @@ $file = 'monkey.gif'; if (file_exists($file)) { header('Content-Description: File Transfer'); header('Content-Type: application/octet-stream'); - header('Content-Disposition: attachment; filename='.basename($file)); - header('Content-Transfer-Encoding: binary'); + header('Content-Disposition: attachment; filename="'.basename($file).'"'); header('Expires: 0'); - header('Cache-Control: must-revalidate, post-check=0, pre-check=0'); + header('Cache-Control: must-revalidate'); header('Pragma: public'); header('Content-Length: ' . filesize($file)); - ob_clean(); - flush(); readfile($file); exit; } @@ -93,6 +94,7 @@ if (file_exists($file)) { </programlisting> &example.outputs.similar; <mediaobject> + <alt>Aç / Kaydet penceresi</alt> <imageobject> <imagedata fileref="en/reference/filesystem/figures/readfile.png"/> </imageobject> @@ -103,7 +105,14 @@ if (file_exists($file)) { <refsect1 role="notes"> &reftitle.notes; - + <note> + <para> + <function>readfile</function> kendi başına büyük dosyalar gönderirken + bile herhangi bir bellek sorunu ortaya çıkmaz. Yetersiz bellek hatasıyla + karşılaşırsanız, <function>ob_get_level</function> kullanarak çıktı + tamponlamasının kapalı olduğundan emin olun. + </para> + </note> &tip.fopen-wrapper; ¬e.context-support; </refsect1> diff --git a/reference/filesystem/functions/readlink.xml b/reference/filesystem/functions/readlink.xml index 84592183..96ef7198 100644 --- a/reference/filesystem/functions/readlink.xml +++ b/reference/filesystem/functions/readlink.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 xmlns="http://docbook.org/ns/docbook" xml:id="function.readlink"> <refnamediv> <refname>readlink</refname> @@ -10,7 +10,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>readlink</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>readlink</methodname> <methodparam><type>string</type><parameter>yol</parameter></methodparam> </methodsynopsis> <para> @@ -39,29 +39,12 @@ <para> Hata durumunda &false; aksi takdirde sembolik bağın içeriğini döndürür. </para> - </refsect1> - - <refsect1 role="changelog"> - &reftitle.changelog; - <informaltable> - <tgroup cols="2"> - <thead> - <row> - <entry>&Version;</entry> - <entry>&Description;</entry> - </row> - </thead> - <tbody> - <row> - <entry>5.3.0</entry> - <entry> - İşlev Windows platformlarında da (Vista, Server 2008 ve üstü) - kullanılabilir oldu. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> + <note> + <simpara> + Windows hariç, <parameter>yol</parameter> bir sembolik bağ değilse işlev + başarısız olur, Windows üzerinde ise normalleştirilmiş yol döner. + </simpara> + </note> </refsect1> <refsect1 role="examples"> diff --git a/reference/filesystem/functions/touch.xml b/reference/filesystem/functions/touch.xml index 842f2eda..6e4dfda4 100644 --- a/reference/filesystem/functions/touch.xml +++ b/reference/filesystem/functions/touch.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: nilgun Status: ready --> +<!-- EN-Revision: 7f569e1f175adf1fbd0e462eba8d6bc82214c939 Maintainer: nilgun Status: ready --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.touch"> <refnamediv> <refname>touch</refname> @@ -51,7 +51,8 @@ <para> Belirtilmişse dosyanın erişim zamanı <parameter>ezamanı</parameter> değerine ayarlanır. Aksi takdirde <parameter>zaman</parameter> değerine - ayarlanır. + ayarlanır. İki değitirge de mevcut değilse geçerli sistem zamanı + kullanılır. </para> </listitem> </varlistentry> @@ -66,30 +67,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.3.0</entry> - <entry> - Windows altında bir dizinin değişiklik zamanını ayarlamak mümkün oldu. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="examples"> &reftitle.examples; <para> @@ -99,9 +76,9 @@ <![CDATA[ <?php if (touch($dosyaismi)) { - echo "$dosyaismi için değişiklik zamanı şimdiye ayarlandı"; + echo $dosyaismi . ' için değişiklik zamanı şimdiye ayarlandı"; } else { - echo "$dosyaismi için değişiklik zamanı değiştirilemedi"; + echo $dosyaismi . ' için değişiklik zamanı değiştirilemedi"; } ?> ]]> @@ -114,19 +91,15 @@ if (touch($dosyaismi)) { <programlisting role="php"> <![CDATA[ <?php -/* - * Dosyanın değişiklik zamanını bir saat önceye ayarlayalım - */ +// Dosyanın değişiklik zamanını bir saat önceye ayarlayalım $zaman = time() - 3600; -/* Dosyaya erişelim */ +// Dosyaya dokunalım if(!touch('bir_dosya.txt', $zaman)) { echo 'Hoop, bir şeyler yanlış oldu...'; -} -else -{ - echo 'Dosyaya başarıyla erişildi'; +} else { + echo 'Dosyaya başarıyla dokunuldu'; } ?> ]]>