mirror of
https://github.com/php/doc-ru.git
synced 2025-08-16 18:22:04 +00:00
4b75cba4c9
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@172265 c90b9560-bf6c-de11-be94-00142212c4b1
113 lines
3.5 KiB
XML
113 lines
3.5 KiB
XML
<?xml version="1.0" encoding="windows-1251"?>
|
|
<!-- EN-Revision: 1.12 Maintainer: freespace Status: ready -->
|
|
<!-- $Revision: 1.1 $ -->
|
|
<!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
|
|
<refentry id="function.fwrite">
|
|
<refnamediv>
|
|
<refname>fwrite</refname>
|
|
<refpurpose>Áèíàðíî-áåçîïàñíàÿ çàïèñü â ôàéë</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Îïèñàíèå</title>
|
|
<methodsynopsis>
|
|
<type>int</type><methodname>fwrite</methodname>
|
|
<methodparam><type>resource</type><parameter>handle</parameter></methodparam>
|
|
<methodparam><type>string</type><parameter>string</parameter></methodparam>
|
|
<methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
|
|
</methodsynopsis>
|
|
<simpara>
|
|
<function>fwrite</function> çàïèñûâàåò ñîäåðæèìîå
|
|
<parameter>string</parameter> â ôàéëîâûé ïîòîê
|
|
<parameter>handle</parameter>. Åñëè ïåðåäàí àðãóìåíò
|
|
<parameter>length</parameter>, çàïèñü îñòàíîâèòñÿ ïîñëå òîãî,
|
|
êàê <parameter>length</parameter> áàéòîâ áóäóò çàïèñàíû èëè
|
|
áóäåò äîñòèãíóò êîíåö ñòðîêè <parameter>string</parameter>,
|
|
ñìîòðÿ ÷òî ïðîèçîéä¸ò ïåðâûì.
|
|
</simpara>
|
|
<simpara>
|
|
<function>fwrite</function> âîçâðàùàåò êîëè÷åñòâî çàïèñàííûõ áàéòîâ
|
|
èëè &false; â ñëó÷àå îøèáêè.
|
|
</simpara>
|
|
<simpara>
|
|
Îáðàòèòå âíèìàíèå, ÷òî åñëè àðãóìåíò <parameter>length</parameter>
|
|
óêàçàí, òî êîíôèãóðàöèîííàÿ îïöèÿ <link
|
|
linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>
|
|
áóäåò ïðîèãíîðèðîâàíà è ñòðîêà <parameter>string</parameter>
|
|
íå áóäåò î÷èùåíà îò ñëåøåé.
|
|
</simpara>
|
|
<note>
|
|
<para>
|
|
 ñèñòåìàõ, ðàçëè÷àþùèõ äâîè÷íûå è òåêñòîâûå ôàéëû (ê ïðèìåðó, Windows),
|
|
ôàéë äîëæåí áûòü îòêðûò èñïîëüçóÿ ôëàã 'b' â êîíöå àðãóìåíòà mode
|
|
ôóíêöèè <function>fopen</function>.
|
|
</para>
|
|
</note>
|
|
<para>
|
|
<example>
|
|
<title>Ïðîñòîé ïðèìåð èñïîëüçîâàíèÿ fwrite</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$filename = 'test.txt';
|
|
$somecontent = "Äîáàâèòü ýòî ê ôàéëó\n";
|
|
|
|
// Âíà÷àëå äàâàéòå óáåäèìñÿ, ÷òî ôàéë ñóùåñòâóåò è äîñòóïåí äëÿ çàïèñè.
|
|
if (is_writable($filename)) {
|
|
|
|
// Â íàøåì ïðèìåðå ìû îòêðûâàåì $filename â ðåæèìå "äîïèñàòü â êîíåö".
|
|
// Òàêèì îáðàçîì, ñìåùåíèå óñòàíîâëåíî â êîíåö ôàéëà è
|
|
// íàø $somecontent äîïèøåòñÿ â êîíåö ïðè èñïîëüçîâàíèè fwrite().
|
|
if (!$handle = fopen($filename, 'a')) {
|
|
echo "Íå ìîãó îòêðûòü ôàéë ($filename)";
|
|
exit;
|
|
}
|
|
|
|
// Çàïèñûâàåì $somecontent â íàø îòêðûòûé ôàéë.
|
|
if (fwrite($handle, $somecontent) === FALSE) {
|
|
echo "Íå ìîãó ïðîèçâåñòè çàïèñü â ôàéë ($filename)";
|
|
exit;
|
|
}
|
|
|
|
echo "Óðà! Çàïèñàëè ($somecontent) â ôàéë ($filename)";
|
|
|
|
fclose($handle);
|
|
|
|
} else {
|
|
echo "Ôàéë $filename íåäîñòóïåí äëÿ çàïèñè";
|
|
}
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</para>
|
|
<simpara>
|
|
Ñì. òàêæå îïèñàíèå ôóíêöèé <function>fread</function>,
|
|
<function>fopen</function>,
|
|
<function>fsockopen</function>,
|
|
<function>popen</function> è
|
|
<function>file_put_contents</function>.
|
|
</simpara>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
indent-tabs-mode:nil
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"../../../../manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
vim600: syn=xml fen fdm=syntax fdl=2 si
|
|
vim: et tw=78 syn=sgml
|
|
vi: ts=1 sw=1
|
|
-->
|