<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/features.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'features.remote-files.php',
    1 => 'Работа с удалёнными файлами',
    2 => 'Работа с удалёнными файлами',
  ),
  'up' => 
  array (
    0 => 'features.php',
    1 => 'Особенности',
  ),
  'prev' => 
  array (
    0 => 'features.file-upload.errors.seealso.php',
    1 => 'Смотрите также',
  ),
  'next' => 
  array (
    0 => 'features.connection-handling.php',
    1 => 'Работа с соединениями',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'features/remote-files.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="features.remote-files" class="chapter">
  <h1 class="title">Работа с удалёнными файлами</h1>


  <p class="para">
   В случае, если опция <strong class="option unknown">allow_url_fopen</strong> включена
   в конфигурационном файле <var class="filename">php.ini</var>, вы можете использовать
   URL-адреса <abbr title="Hypertext Transfer Protocol">HTTP</abbr> и <abbr title="File Transfer Protocol">FTP</abbr>
   в большинстве функций, принимающих в качестве
   параметра имя файла. Также вы можете использовать ссылки в операторах
   <span class="function"><a href="function.include.php" class="function">include</a></span>,
   <span class="function"><a href="function.include-once.php" class="function">include_once</a></span>,
   <span class="function"><a href="function.require.php" class="function">require</a></span> и
   <span class="function"><a href="function.require-once.php" class="function">require_once</a></span>
   (для корректной работы этих функций
   должна быть включена опция <strong class="option unknown">allow_url_include</strong>).
   Дополнительную информацию о поддерживаемых в PHP протоколах вы можете
   найти в <a href="wrappers.php" class="xref">Протоколы и обёртки</a>.
  </p>
  <p class="para">
   Например, вы можете использовать это для того, чтобы открыть файл на
   удалённом сервере, извлечь необходимые вам данные и использовать их
   в запросе к базе данных или же просто отобразить их в дизайне вашего сайта.
  </p>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Пример #1 Получение заголовка удалённой страницы</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$file </span><span style="color: #007700">= </span><span style="color: #0000BB">fopen </span><span style="color: #007700">(</span><span style="color: #DD0000">"http://www.example.com/"</span><span style="color: #007700">, </span><span style="color: #DD0000">"r"</span><span style="color: #007700">);<br />if (!</span><span style="color: #0000BB">$file</span><span style="color: #007700">) {<br />    echo </span><span style="color: #DD0000">"&lt;p&gt;Невозможно открыть удалённый файл.\n"</span><span style="color: #007700">;<br />    exit;<br />}<br />while (!</span><span style="color: #0000BB">feof </span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">)) {<br />    </span><span style="color: #0000BB">$line </span><span style="color: #007700">= </span><span style="color: #0000BB">fgets </span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">, </span><span style="color: #0000BB">1024</span><span style="color: #007700">);<br />    </span><span style="color: #FF8000">/* Сработает, только если заголовок и сопутствующие теги расположены в одной строке */<br />    </span><span style="color: #007700">if (</span><span style="color: #0000BB">preg_match </span><span style="color: #007700">(</span><span style="color: #DD0000">"@\&lt;title\&gt;(.*)\&lt;/title\&gt;@i"</span><span style="color: #007700">, </span><span style="color: #0000BB">$line</span><span style="color: #007700">, </span><span style="color: #0000BB">$out</span><span style="color: #007700">)) {<br />        </span><span style="color: #0000BB">$title </span><span style="color: #007700">= </span><span style="color: #0000BB">$out</span><span style="color: #007700">[</span><span style="color: #0000BB">1</span><span style="color: #007700">];<br />        break;<br />    }<br />}<br /></span><span style="color: #0000BB">fclose</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
  <p class="para">
   Вы также можете работать с удалёнными файлами, расположенными на FTP-сервере
   (подразумевается, что вы авторизовались с необходимыми для этого
   привилегиями). Таким образом вы можете только создавать новые файлы, но
   попытка перезаписать существующий файл при помощи функции <span class="function"><a href="function.fopen.php" class="function">fopen()</a></span>
   приведёт к ошибке.
  </p>
  <p class="para">
   Для того, чтобы авторизоваться под пользователем, отличным от &#039;anonymous&#039;,
   вам необходимо указать логин (и, возможно, пароль) в адресной строке, например
   так: &#039;<code class="literal">ftp://user:password@ftp.example.com/path/to/file</code>&#039;. (Вы можете
   использовать этот же синтаксис для доступа к удалённым файлам по <abbr title="Hypertext Transfer Protocol">HTTP</abbr>-протоколу,
   если необходима Basic-аутентификация.)
  </p>
  <p class="para">
   <div class="example" id="example-2">
    <p><strong>Пример #2 Сохранение данных на удалённом сервере</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$file </span><span style="color: #007700">= </span><span style="color: #0000BB">fopen </span><span style="color: #007700">(</span><span style="color: #DD0000">"ftp://ftp.example.com/incoming/outputfile"</span><span style="color: #007700">, </span><span style="color: #DD0000">"w"</span><span style="color: #007700">);<br />if (!</span><span style="color: #0000BB">$file</span><span style="color: #007700">) {<br />    echo </span><span style="color: #DD0000">"&lt;p&gt;Невозможно перезаписать удалённый файл.\n"</span><span style="color: #007700">;<br />    exit;<br />}<br /></span><span style="color: #FF8000">/* Запись данных. */<br /></span><span style="color: #0000BB">fwrite </span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">, </span><span style="color: #0000BB">$_SERVER</span><span style="color: #007700">[</span><span style="color: #DD0000">'HTTP_USER_AGENT'</span><span style="color: #007700">] . </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">fclose </span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
  <p class="para">
   <blockquote class="note"><p><strong class="note">Замечание</strong>: 
    <p class="para">
     Глядя на приведённый выше пример, у вас может возникнуть идея
     использовать эту технику для ведения удалённого лог-файла. К сожалению,
     это нереализуемо, поскольку попытка записи в уже существующий
     удалённый файл при помощи функции <span class="function"><a href="function.fopen.php" class="function">fopen()</a></span>
     приведёт к ошибке. В реализации распределённого логирования,
     возможно, вам поможет функция <span class="function"><a href="function.syslog.php" class="function">syslog()</a></span>.
    </p>
   </p></blockquote>
  </p>

 </div>
<?php manual_footer($setup); ?>